@devries-cameron20 / composio Mirror · read-only
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 21 lines 1007 Bytes
Rendered Raw
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.