From 76036e1d7bc0cf82b2c0e007969e0ef2ee678027 Mon Sep 17 00:00:00 2001 From: biswaroop1547 Date: Thu, 8 Oct 2026 17:25:33 +0200 Subject: [PATCH 01/18] docs: align Agents guides and API reference with current dev --- AGENTS.md | 8 +- README.md | 17 ++ components/diagrams.tsx | 8 +- content/docs/admin-panel.mdx | 2 +- content/docs/developers/agent-builder.mdx | 79 +++++-- content/docs/developers/agent-description.mdx | 76 ++++-- .../api-ref/agents-and-versions.mdx | 218 ++++-------------- .../developers/api-ref/authentication.mdx | 139 +++-------- .../developers/api-ref/files-and-projects.mdx | 36 +-- content/docs/developers/api-ref/meta.json | 1 + content/docs/developers/api-ref/runs.mdx | 10 +- content/docs/developers/api-ref/schedules.mdx | 14 +- content/docs/developers/api-ref/sharing.mdx | 55 +++++ .../api-ref/threads-and-messages.mdx | 173 +++----------- content/docs/developers/architecture.mdx | 62 +++-- .../context-isolation-in-threads.mdx | 8 - content/docs/developers/evaluations.mdx | 61 ----- .../export-import-and-share-agents.mdx | 53 ++++- content/docs/developers/inbox.mdx | 33 +++ content/docs/developers/meta.json | 15 +- .../developers/parent-and-child-threads.mdx | 8 - content/docs/developers/project-context.mdx | 51 ++-- content/docs/developers/schedules.mdx | 71 ++++-- .../docs/developers/threads-and-contexts.mdx | 92 +++----- content/docs/developers/user-preferences.mdx | 35 --- content/docs/developers/versions.mdx | 68 ------ content/docs/developers/webhooks.mdx | 120 ---------- content/docs/features/approvals.mdx | 117 +++------- content/docs/features/chat.mdx | 14 +- content/docs/features/mcp.mdx | 8 +- content/docs/features/memory.mdx | 16 +- content/docs/features/open-architecture.mdx | 26 +-- content/docs/going-deeper.mdx | 2 +- content/docs/index.mdx | 2 +- content/docs/integrations/github.mdx | 2 +- content/docs/integrations/gmail.mdx | 2 +- content/docs/integrations/slack.mdx | 2 +- content/docs/interface/composer.mdx | 19 +- content/docs/remote/telegram.mdx | 4 +- content/docs/resources/faq.mdx | 2 +- content/docs/resources/pricing.mdx | 6 +- content/docs/workflows/dev-bug-fix.mdx | 2 +- public/_redirects | 18 ++ 43 files changed, 683 insertions(+), 1072 deletions(-) create mode 100644 content/docs/developers/api-ref/sharing.mdx delete mode 100644 content/docs/developers/context-isolation-in-threads.mdx delete mode 100644 content/docs/developers/evaluations.mdx create mode 100644 content/docs/developers/inbox.mdx delete mode 100644 content/docs/developers/parent-and-child-threads.mdx delete mode 100644 content/docs/developers/user-preferences.mdx delete mode 100644 content/docs/developers/versions.mdx delete mode 100644 content/docs/developers/webhooks.mdx diff --git a/AGENTS.md b/AGENTS.md index 4d8593a..8886e9f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,7 +13,7 @@ The navigation keeps Home first, then sorts the top-level sections and the pages inside each section alphabetically: - **Administration** - `/admin-panel`. Browser-admin access, dashboards, governance records, runtime controls, and network policy. -- **Agents (Beta)** - `/developers/*`. Guides cover Agent setup, threads, context, projects, schedules, preferences, and webhooks. Architecture and the REST API reference live here too, with API pages under `/developers/api-ref/*`. +- **Agents (Beta)** - `/developers/*`. Guides cover creation and refinement, capabilities, the main conversation and delegated sessions, files and context, routines, Inbox, and sharing. Architecture and the beta client API reference live here too, with API pages under `/developers/api-ref/*`. - **App setup** - `/integrations/{github, gmail, google-calendar, slack}`. Per-app permissions and prompts, not feature pages. All of them connect through the Apps tab of the Add MCP dialog. - **Deployment models** - `/deployment-models`. Current availability and operating boundaries for Fluso Cloud, dedicated AWS VPC, planned Azure VNet, and scoped on-premises deployments. - **Features** - `/features/*`. Approvals and permissions, Apps and MCP servers, Chat, Confidential mode, Imports, Memory, Projects, Skills, and Tasks. @@ -42,7 +42,8 @@ Email, calendar, code, content, research are skills, not separate features. The ## Terminology - **Fluso** — the product. -- **Apps** / **MCP connections** — the connections to third-party apps. There is no separate connector system; "Plugins" is the sidebar item, and connections live under **Plugins → MCP**. Don't introduce "connector" in new copy except where the app itself still says "connector tools" (the approvals settings). +- **Apps** / **MCP connections** — the connections to third-party apps. There is no separate connector system; connections live under **Plugins → MCP**. Use **Connectors** when referring to the Agent editor's capability picker. +- **Agent** — saved setup and a continuing main conversation. **Manager** refines that one Agent; **sessions** are delegated conversations; **routines** are scheduled messages. Main conversations take saved setup changes on their next turn; existing delegated sessions retain their setup. - **Knowledge graph** — Fluso's persistent memory. Lowercase. - **Skills** — specialised capabilities that activate automatically. Built-in or custom (`SKILL.md`). - **Projects** — workspaces that scope context, files, and tasks. @@ -83,7 +84,8 @@ The docs follow Wikipedia's "Signs of AI writing" guide. The bans below aren't s ## Content boundaries - Never invent feature behaviour. If a capability isn't documented in source materials, leave it out. -- Always pair "Fluso can send X" with the approval safety note: drafts are shown for review. +- When describing external sends, explain how to request and review a draft and choose **Ask me first**. Do not claim every write requires approval: saved tool rules, connection settings, and the chat's mode determine that behavior. +- Verify Agent behavior against both current frontend and backend code. Do not restore removed Studio graphs, evaluations, version rollback, YAML transfer, webhook triggers, or thread-management toggles from historical release notes. - For product actions, point users to the macOS download at `https://fluso.ai/` and to support at `support@premai.io`. Don't link to `app.fluso.ai`. Fluso is a desktop app. ## Publishing release notes diff --git a/README.md b/README.md index 974e532..76a5a9d 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,23 @@ npm run start # serve the built out/ directory Writing rules and voice live in [AGENTS.md](AGENTS.md). +## Keeping the Agents guides current + +The October 8, 2026 refresh was checked against backend `dev` at [54df16716](https://github.com/premAI-io/premapp-backend/commit/54df16716fd37ddb1d48faff1b6f14bc05a8a6df) and frontend `dev` at [529cd9f6b](https://github.com/premAI-io/fluso-frontend/commit/529cd9f6b3b06d9cbb7c57acd6e52eb1da0e62df). These are development behavior, not a claim about production rollout. + +Check both sides when updating the guides: + +| Behavior | Backend source | Frontend source (under `apps/frontend/src/`) | +| --- | --- | --- | +| Setup, edits, capabilities, context | `agents/src/agent-library/{service,chat-binding}.ts`, `agents/src/context/assembler.ts`, `agents/prompts/agent-manager.md` | `features/agents/components/{agent-manager,agent-form,agent-capability-select}.tsx` | +| Sessions and queued work | `agents/src/hosted/{flusoctl,session-controller}.ts` | `features/agents/components/agent-sessions.tsx`, `features/chats/components/ChatMessagesPanel.tsx` | +| Routines and Inbox | `backend/aci/server/services/agent_schedules.py`, `backend/aci/server/routes/agent_runs.py` | `features/agents/components/agent-routines-page.tsx`, `app/(dashboard)/agents/inbox/page.tsx`, `stores/inbox-seen-store.ts` | +| Sharing and starting points | `backend/aci/server/{routes/agent_shares,services/agent_templates}.py`, `agents/src/agent-library/share-resources.ts` | `features/agents/components/{agent-share-dialog,agent-import-page}.tsx` | +| Availability and approvals | `backend/aci/common/db/crud/mcp_permission_modes.py`, `backend/aci/server/routes/mcp/permissions.py` | `lib/config.ts`, `features/mcp/lib/permission-mode.ts` | +| API contracts | `backend/aci/server/routes/`, `backend/aci/common/schemas/` | `features/agents/api/`, `lib/api/`, `app/auth/client/page.tsx` | + +Use source behavior over old release notes. Remove retired pages from navigation and add their replacements to `public/_redirects`, including markdown export URLs. Cloudflare Pages serves these redirects; Next's local dev server does not. + ## Deployment Pushes to `main` build and deploy via `.github/workflows/deploy.yml` (Cloudflare Pages, project `fluso-docs`). Requires the `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` repo secrets. diff --git a/components/diagrams.tsx b/components/diagrams.tsx index 2730caf..7bc4168 100644 --- a/components/diagrams.tsx +++ b/components/diagrams.tsx @@ -49,7 +49,7 @@ function ProjectMemory({ name }: { name: string }) {