Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 06:00 UTC
| 1 | --- |
| 2 | type: "troubleshooting" |
| 3 | title: "TypeScript Tool Schema Definitions" |
| 4 | description: "Public guidance for dangling JSON Schema references in older TypeScript SDK versions." |
| 5 | category: "sessions-and-execution" |
| 6 | visibility: "public" |
| 7 | timestamp: "2026-07-16T00:00:00Z" |
| 8 | tags: |
| 9 | - "typescript" |
| 10 | - "sdk" |
| 11 | - "json-schema" |
| 12 | --- |
| 13 | # TypeScript Tool Schema Definitions |
| 14 | |
| 15 | ## Upgrade when `$ref` is present but root `$defs` is missing |
| 16 | |
| 17 | Older `@composio/core` releases through 0.11.0 could preserve a nested `$ref` while stripping the root `$defs` or `definitions` block from raw tool schemas. Downstream schema parsers then see a dangling reference. |
| 18 | |
| 19 | The shared fix shipped in `@composio/core` 0.12.0. Upgrade core to 0.12.0 or later and use a compatible provider-package version. That release line is ESM-only and requires Node.js 22.22.3 or later, so confirm runtime and provider compatibility before upgrading. |
| 20 | |
| 21 | After upgrading, fetch the exact tool again and verify every internal `$ref` has a matching root definition. |