Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: centralize the 1,500+ apps/toolkits count (#5400)
> Written by an AI agent on behalf of @olearycrew, following their spec. @olearycrew has not reviewed it yet. ## Summary The docs advertised several catalog sizes, including `500+ apps`, `1000+ tools`, and `1,000+ apps`. Use the requested `1,500+` from one shared constant, and name what it counts consistently: - Marketing copy, including site descriptions and general product introductions, says **1,500+ apps**. - Technical documentation about the catalog says **1,500+ toolkits**. - **Tools** means the actions within an individual toolkit. It is never the name for the catalog count. This follows Brendan's request and wording rule. Designated reviewer: @jkomyno. Please review the full diff before merging. ## Changes - Set the existing `TOOLKIT_COUNT_LABEL` in `docs/lib/toolkit-count.ts` to `1,500+`, replacing the previously derived value. - Resolve `%TOOLKIT_COUNT%` through the existing Fumadocs build hooks and frontmatter schema. The same resolver covers raw Markdown readers, search records, and the generated docs-agent snapshot. No dependencies added. - Convert the agent's Markdown context to Eve's supported TypeScript instructions module so it imports the constant. Its resolved prompt is unchanged apart from the count. - Update the meta-tools generator and regenerate the overview and search-tool page from the checked-in API snapshot. The generated source keeps the placeholder, and the search-tool description uses our maintained copy instead of the outdated API claim. - Keep homepage copy, benefit descriptions, and general `llms` introductions in apps. Use toolkits in reference and meta-tool documentation. The custom-provider guide now says “call tools across 1,500+ toolkits”. - Replace Xero's cross-catalog “1000+ tools” claim with “schemas from every toolkit” in the editorial article, then regenerate the published page. - Record the terminology rule in `docs/AGENTS.md` and verify it in the existing count, metadata, and rendered-output tests. - Generate the agent snapshot in `pretest`, before static tests import it. This fixes the fresh-checkout `Cannot find module './docs-index'` error from the count test. - Include the connected-account troubleshooting guide in the Platform authentication sidebar. The navigation coverage assertion remains intact and now passes. - Extract rendered paragraph text with Bun's native `HTMLRewriter`, following the existing provider integration-test pattern. No hand-written HTML filtering or new dependency. Regression cases cover paragraph-like markup inside scripts and both script closing-tag forms. ## Type of change - [ ] Bug fix - [ ] New feature - [x] Refactor/Chore - [x] Documentation - [ ] Breaking change ## How Has This Been Tested? On the final revision, from `docs/`: - Reproduced the CI errors before the fix. With the ignored agent snapshot absent, the count test failed to import `./docs-index`. The navigation suite separately failed because `/docs/authentication/session-cant-find-account` was omitted from the Platform sidebar. - Removed the local generated snapshot, then ran the same `bun run test` command CI runs. The updated `pretest` generated it and the full static suite passed: **835 passed, 0 failed**. - `GITHUB_ACTIONS=true bun run build` passed, including production TypeScript checking. The flag selects the existing two-worker configuration. ```text ✓ Compiled successfully in 21.7s Finished TypeScript in 8.1s ... ✓ Generating static pages using 2 workers (2600/2600) in 15.0s ``` - Started the production server with `bun run start --hostname 127.0.0.1 --port 3047`, then ran `TEST_BASE_URL=http://127.0.0.1:3047 bun run test:integration`: **245 passed, 1 skipped, 0 failed**. The existing production-only fallback test requires `COMPOSIO_API_KEY`. The count tests now use the HTML parser to check actual paragraphs rather than a metadata or hydration match. - The new parser regression passes for both `</script>` and `</script >` and ignores fake paragraph markup inside script contents. - `bun run lint` passed with existing warnings. `bun run check:kb-semantic --allow-stale` passed with the expected stale-artifact warning and keyword fallback. The existing rebuild workflow owns the generated embeddings artifact. - `git diff --check` passed. The earlier root agent-guidance validation also passed; no guidance changed in this upkeep commit. Local tools: Bun 1.4.2 and Node 24.22.1. CI uses the repository pins. ## Screenshots (if applicable) Copy and metadata were checked in the built HTTP responses. No layout changes or browser screenshots. | Surface | Before on `origin/next` | Final built response | | --- | --- | --- | | Homepage and social-card copy | Derived count, mixed apps/tools wording | `1,500+ apps` | | OpenAI benefit description | `use 1000+ tools` | `use 1,500+ apps` | | `/reference` and `/reference.md` | `1000+ toolkits` | `1,500+ toolkits` | | Meta-tools overview | `500+ apps` | `1,500+ toolkits` | | Custom-provider guide | `call Composio's 1000+ tools` | `call tools across 1,500+ toolkits` | | Claude Code plugin description | `Act on 1,000+ apps` | `Act on 1,500+ apps` | ## Checklist - [x] I have read the Code of Conduct and this PR adheres to it - [ ] Human author has reviewed every line of the diff. The agent has reviewed it; full human review is pending. - [x] Any third-party docs links or promotional content follow the third-party links policy. No links added. - [x] Static tests, build, and production integration tests passed. See the one credential-dependent integration skip above. - [x] I updated documentation as needed - [x] I added tests for count resolution, generation, and rendered terminology - [x] Changeset is not applicable to this docs-only change ## Additional context ### Open scope question Historical entries remain unchanged as originally requested: `content/changelog/03-25-26-mcp-endpoint-removed.mdx`, `decisions/examples.md`, and `decisions/cookbooks-revamp-plan.md`. Confirm they should continue to describe their original point in time. The apps/toolkits/tools wording questions are resolved by Brendan's rule above. ### Generated snapshots Raw `public/data/meta-tools.json` retains the upstream API payload; rendered docs use the count-aware override. `kb/source/toolkits/xero/public.md` is the imported upstream snapshot; the editorial article owns the revised published prose. `kb/semantic-index.json` was not hand-edited. Its old content hashes fail validation after content changes, causing keyword fallback until rebuilt. The existing “Docs - Rebuild KB Semantic Artifact” workflow owns that rebuild after the PR's Docs - Tests run; the required API key is unavailable locally. ### ELI5 The catalog size was copied into many pages, so the numbers drifted apart. Pages now fill in one shared number and use “apps” for the product promise and “toolkits” when explaining the technical catalog. <details> <summary>Every touched file (47)</summary> - `docs/AGENTS.md` (updated). - `docs/agent/instructions/context.md` (removed; replaced by the TypeScript instructions module). - `docs/agent/instructions/context.ts` (added). - `docs/agent/lib/docs.ts` (updated). - `docs/app/layout.tsx` (updated). - `docs/app/llms-full.txt/route.ts` (updated). - `docs/app/llms-index.txt/route.ts` (updated). - `docs/app/llms.txt/route.ts` (updated). - `docs/components/home-features.tsx` (updated). - `docs/content/docs/claude-code-plugin.mdx` (updated). - `docs/content/docs/composio-connect.mdx` (updated). - `docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx` (updated). - `docs/content/docs/providers/anthropic.mdx` (updated). - `docs/content/docs/providers/autogen.mdx` (updated). - `docs/content/docs/providers/crewai.mdx` (updated). - `docs/content/docs/providers/custom-providers/index.mdx` (updated). - `docs/content/docs/providers/custom-providers/python.mdx` (updated). - `docs/content/docs/providers/custom-providers/typescript.mdx` (updated). - `docs/content/docs/providers/google.mdx` (updated). - `docs/content/docs/providers/langchain.mdx` (updated). - `docs/content/docs/providers/llamaindex.mdx` (updated). - `docs/content/docs/providers/mastra.mdx` (updated). - `docs/content/docs/providers/openai.mdx` (updated). - `docs/content/docs/providers/vercel.mdx` (updated). - `docs/content/docs/quickstart.mdx` (updated). - `docs/content/examples/general-agent-with-pi.mdx` (updated). - `docs/content/examples/harness-integration.mdx` (updated). - `docs/content/examples/imessage-agent.mdx` (updated). - `docs/content/examples/local-sandbox-pr-reviewer.mdx` (updated). - `docs/content/kb/guide/toolkits-xero.mdx` (updated). - `docs/content/reference/index.mdx` (updated). - `docs/content/reference/v3/index.mdx` (updated). - `docs/content/toolkits/meta-tools/index.mdx` (updated). - `docs/content/toolkits/meta-tools/search_tools.mdx` (updated). - `docs/kb/articles/toolkits-xero.md` (updated). - `docs/lib/home-navigation.ts` (updated). - `docs/lib/meta-tool-overrides.ts` (updated). - `docs/lib/search-index.ts` (updated). - `docs/lib/source.ts` (updated). - `docs/lib/toolkit-count.ts` (updated). - `docs/package.json` (updated). - `docs/scripts/build-agent-index.ts` (updated). - `docs/scripts/generate-meta-tools.ts` (updated). - `docs/source.config.ts` (updated). - `docs/tests/integration/toolkit-count.test.ts` (added). - `docs/tests/static/product-navigation.test.ts` (updated). - `docs/tests/static/toolkit-count.test.ts` (added). </details>