@devries-cameron20 / composio-1 / commits / a7634a322
Fork 0

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: fix remaining broken links and validate dynamic toolkit pages

- Fix /toolkits/introduction → /toolkits in troubleshooting pages - Remove broken relative links to source files in cookbooks - Remove unnecessary "See Authenticating Users" link in errors.mdx - Add dynamic toolkit slug validation from toolkits.json to link checker Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmithamallesh committed Feb 17, 2026 at 20:16 UTC a7634a32234bc13e3bc12c403a65d3eb80cd7ce0
6 files changed +12 -25
docs/content/cookbooks/fast-api.mdx
-10
@@ -199,8 +199,6 @@ A Composio client dependency.
199 """
200 ```
201
202 -Check [dependencies](./simple_gmail_agent/server/dependencies.py) module for more details.
203 -
202 ### Invoke agent via FastAPI
203
204 When invoking an agent, make sure you validate the `user_id`.
@@ -265,18 +263,10 @@ def _run_gmail_agent(
263 return result
264 ```
265
268 -<Callout>
269 -Check [server](./simple_gmail_agent/server/) module for service implementation
270 -</Callout>
271 -
266 ## Putting everything together
267
268 So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a FastAPI service. Now let's run the service.
269
276 -<Callout>
277 -Before proceeding, check the [code](./simple_gmail_agent/server/api.py) for utility endpoints not discussed in the cookbook
278 -</Callout>
279 -
270
271 1. Clone the repository
272 ```bash
docs/content/cookbooks/hono.mdx
-10
@@ -215,8 +215,6 @@ export function provideComposioClient(): Composio<OpenAIProvider> {
215 export type ComposioClient = Composio<OpenAIProvider>;
216 ```
217
218 -Check [config/composio.ts](./src/config/composio.ts) module for more details.
219 -
218 ### Invoke agent via Hono
219
220 When invoking an agent, make sure you validate the `user_id`.
@@ -290,18 +288,10 @@ app.post("/agent", async (c) => {
288 });
289 ```
290
293 -<Callout>
294 - Check [src/api.ts](./src/api.ts) module for service implementation
295 -</Callout>
296 -
291 ## Putting everything together
292
293 So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a Hono service. Now let's run the service.
294
301 -<Callout>
302 - Before proceeding, check the [code](./src/api.ts) for utility endpoints not discussed in the cookbook
303 -</Callout>
304 -
295 1. Clone the repository
296 ```bash
297 git clone git@github.com:composiohq/composio-hono
docs/content/docs/troubleshooting/sdks.mdx
+1 -1
@@ -48,7 +48,7 @@ Check current version:
48 ## Common issues
49
50 - **Type errors or parameter confusion**: Search [DeepWiki](https://deepwiki.com/ComposioHQ/composio) or use the Ask AI assistant
51 -- **Tool-specific issues**: Check the [specific tool's documentation](/docs/tools-and-toolkits)
51 +- **Tool-specific issues**: Check the [specific tool's documentation](/toolkits)
52 - **Bug reporting**: Create a [GitHub issue](https://github.com/ComposioHQ/composio/issues/new?labels=bug) with debug logs and reproduction steps
53
54 ## Getting help
docs/content/docs/troubleshooting/tools.mdx
+1 -1
@@ -33,7 +33,7 @@ Verify the connected account has necessary permissions:
33
34 ## Tool not working
35
36 -- Check [tool-specific documentation](/docs/tools-and-toolkits) for requirements
36 +- Check [tool-specific documentation](/toolkits) for requirements
37 - Verify the connected account is active and properly authenticated
38 - Test with the latest SDK version
39
docs/content/reference/errors.mdx
+1 -1
@@ -68,7 +68,7 @@ Errors that occur when fetching or executing tools.
68 | Error | Cause |
69 |-------|-------|
70 | Tool not found | The tool slug doesn't exist. Tool slugs are case-sensitive and use `SCREAMING_SNAKE_CASE`. |
71 -| No connected account | The user hasn't connected to this toolkit yet. See [Authenticating Users](/docs/authenticating-users/manually-authenticating). |
71 +| No connected account | The user hasn't connected to this toolkit yet. |
72 | Tool execution failed | The external service returned an error. Check tool parameters and user permissions. |
73
74 <Callout>
docs/scripts/validate-links.ts
+9 -2
@@ -86,13 +86,20 @@ async function buildPopulateEntries(src: AnySource) {
86 );
87 }
88
89 +async function getDynamicToolkitEntries() {
90 + const raw = await readFile('public/data/toolkits.json', 'utf-8');
91 + const toolkits: { slug: string }[] = JSON.parse(raw);
92 + return toolkits.map((t) => ({ value: { slug: [t.slug] }, hashes: [] as string[] }));
93 +}
94 +
95 async function checkLinks() {
96 const referenceSource = await getReferenceSource();
91 - const [docsEntries, refEntries, cookbookEntries, toolkitEntries] = await Promise.all([
97 + const [docsEntries, refEntries, cookbookEntries, toolkitEntries, dynamicToolkitEntries] = await Promise.all([
98 buildPopulateEntries(source),
99 buildPopulateEntries(referenceSource),
100 buildPopulateEntries(cookbooksSource),
101 buildPopulateEntries(toolkitsSource),
102 + getDynamicToolkitEntries(),
103 ]);
104
105 const scanned = await scanURLs({
@@ -102,7 +109,7 @@ async function checkLinks() {
109 '(home)/docs/[[...slug]]': docsEntries,
110 '(home)/reference/[[...slug]]': refEntries,
111 '(home)/cookbooks/[[...slug]]': cookbookEntries,
105 - '(home)/toolkits/[[...slug]]': toolkitEntries,
112 + '(home)/toolkits/[[...slug]]': [...toolkitEntries, ...dynamicToolkitEntries],
113 },
114 });
115