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, 07:15 UTC
| 1 | # @composio/llamaindex |
| 2 | |
| 3 | ## 0.11.2 |
| 4 | |
| 5 | ### Patch Changes |
| 6 | |
| 7 | - adf6b02: Show the model each tool's JSON Schema as is. The provider now builds the `FunctionTool` with the JSON Schema as its parameters and the Zod schema as its validator, instead of letting LlamaIndex render the Zod schema back to JSON Schema. Keywords such as `format: "binary"`, `contentEncoding`, `contentMediaType`, and `title` reach the model. Internal `$ref`s are still inlined first, and the values a tool accepts and rejects are unchanged. |
| 8 | |
| 9 | ## 0.11.1 |
| 10 | |
| 11 | ### Patch Changes |
| 12 | |
| 13 | - 20aaa95: Accept the upcoming core prerelease and the upstream versions already used to build and test providers. |
| 14 | |
| 15 | ## 0.11.0 |
| 16 | |
| 17 | ### Minor Changes |
| 18 | |
| 19 | - 9447932: Dereference internal $ref/$defs in tool input schemas before provider translation, so properties reachable only through a reference keep their types and validation instead of degrading to untyped (z.any) or being emitted as a dangling reference. |
| 20 | |
| 21 | This changes the JSON Schema these providers emit for $ref-using tools. Downstream snapshot tests on tool definitions will see diffs. Schemas the Composio API ships with a $ref but no $defs block (e.g. GMAIL_FETCH_EMAILS) degrade to a permissive object schema rather than throwing. The strict-structured-outputs path of @composio/openai-agents is unchanged — OpenAI supports $defs/$ref natively, including recursion. |
| 22 | |
| 23 | ## 0.10.2 |
| 24 | |
| 25 | ### Patch Changes |
| 26 | |
| 27 | - db7b576: Declare Node.js 22.22.3 as the minimum supported runtime for every published TypeScript package so package managers surface incompatible runtimes before users encounter ESM loading failures. |
| 28 | |
| 29 | ## 0.10.1 |
| 30 | |
| 31 | ### Patch Changes |
| 32 | |
| 33 | - fa933a6: Fix the `homepage` links in these packages' `package.json`. They pointed at `github.com/ComposioHQ/composio/tree/main/...`, but the default branch is `next` and no `main` branch exists, so every link 404'd on npm and in editor tooltips. They now point at `tree/next/...`. |
| 34 | |
| 35 | ## 0.10.0 |
| 36 | |
| 37 | ### Minor Changes |
| 38 | |
| 39 | - 025a657: Drop CommonJS entrypoints and publish the TypeScript SDK packages as ESM-only packages. This is a breaking change within the existing 0.x release line: consumers must use Node.js 22.22.3 or newer. CommonJS callers can only rely on Node's native `require(esm)` interop, and the SDK no longer ships custom CommonJS compatibility machinery or `.cjs` artifacts. |
| 40 | |
| 41 | ## 0.9.3 |
| 42 | |
| 43 | ### Patch Changes |
| 44 | |
| 45 | - ce4b213: fix(providers): normalize string tool-call arguments across all providers |
| 46 | |
| 47 | Models occasionally emit tool-call arguments as a JSON string instead of an |
| 48 | object (most visibly with `COMPOSIO_MULTI_EXECUTE_TOOL` on the Vercel AI SDK), |
| 49 | which broke downstream validation with errors like |
| 50 | `tool_use.input: Input should be a valid dictionary`. |
| 51 | |
| 52 | `@composio/core` now exposes a single `normalizeToolArguments` helper, and every |
| 53 | provider routes model-supplied arguments through it. Object payloads pass |
| 54 | through unchanged, JSON strings are parsed, empty/`null` payloads become `{}`, |
| 55 | and anything that cannot resolve to an object throws a typed |
| 56 | `ComposioInvalidToolArgumentsError` instead of a raw `SyntaxError` or a silently |
| 57 | forwarded malformed string. This replaces the inconsistent per-provider guards |
| 58 | that previously existed only in vercel, cloudflare and openai-agents. |
| 59 | |
| 60 | ## 0.9.2 |
| 61 | |
| 62 | ### Patch Changes |
| 63 | |
| 64 | - Updated dependencies [42ebff3] |
| 65 | - @composio/core@0.10.0 |
| 66 | |
| 67 | ## 0.9.1 |
| 68 | |
| 69 | ### Patch Changes |
| 70 | |
| 71 | - Updated dependencies [84a3a07] |
| 72 | - Updated dependencies [c358ffa] |
| 73 | - @composio/core@0.9.1 |
| 74 | |
| 75 | ## 0.9.0 |
| 76 | |
| 77 | ### Minor Changes |
| 78 | |
| 79 | - Bumped to align with `@composio/core@0.9.0` for the Tool Router release train. No public-API change in this provider package. |
| 80 | |
| 81 | ### Patch Changes |
| 82 | |
| 83 | - Updated dependencies [c9b6525] |
| 84 | - Updated dependencies [cc673b6] |
| 85 | - Updated dependencies [9f14971] |
| 86 | - Updated dependencies [81f8027] |
| 87 | - Updated dependencies [711a703] |
| 88 | - Updated dependencies [bccd32b] |
| 89 | - Updated dependencies [bccd32b] |
| 90 | - Updated dependencies [07c9bab] |
| 91 | - Updated dependencies [3ece424] |
| 92 | - @composio/core@0.9.0 |
| 93 | |
| 94 | ## 0.8.1 |
| 95 | |
| 96 | ### Patch Changes |
| 97 | |
| 98 | - Updated dependencies [6b986cd] |
| 99 | - Updated dependencies [1c3276b] |
| 100 | - @composio/core@0.8.1 |
| 101 | |
| 102 | ## 0.8.0 |
| 103 | |
| 104 | ### Minor Changes |
| 105 | |
| 106 | - Bumped to align with `@composio/core@0.8.0` for the file-upload allowlist release train. No public-API change in this package. |
| 107 | |
| 108 | ### Patch Changes |
| 109 | |
| 110 | - Updated dependencies [ebc9778] |
| 111 | - @composio/core@0.8.0 |
| 112 | |
| 113 | ## 0.6.11 |
| 114 | |
| 115 | ### Patch Changes |
| 116 | |
| 117 | - Updated dependencies [27ed0c9] |
| 118 | - @composio/core@0.6.11 |
| 119 | |
| 120 | ## 0.6.10 |
| 121 | |
| 122 | ### Patch Changes |
| 123 | |
| 124 | - Updated dependencies [670ecc9] |
| 125 | - @composio/core@0.6.10 |
| 126 | |
| 127 | ## 0.6.9 |
| 128 | |
| 129 | ### Patch Changes |
| 130 | |
| 131 | - Updated dependencies [5b5723a] |
| 132 | - @composio/core@0.6.9 |
| 133 | |
| 134 | ## 0.6.8 |
| 135 | |
| 136 | ### Patch Changes |
| 137 | |
| 138 | - Updated dependencies [2b19ae9] |
| 139 | - @composio/core@0.6.8 |
| 140 | |
| 141 | ## 0.6.7 |
| 142 | |
| 143 | ### Patch Changes |
| 144 | |
| 145 | - Updated dependencies [8dc5568] |
| 146 | - @composio/core@0.6.7 |
| 147 | |
| 148 | ## 0.6.6 |
| 149 | |
| 150 | ### Patch Changes |
| 151 | |
| 152 | - Updated dependencies [e1f6516] |
| 153 | - @composio/core@0.6.6 |
| 154 | |
| 155 | ## 0.6.5 |
| 156 | |
| 157 | ### Patch Changes |
| 158 | |
| 159 | - Updated dependencies [476d451] |
| 160 | - Updated dependencies |
| 161 | - @composio/core@0.6.5 |
| 162 | |
| 163 | ## 0.6.5-alpha.0 |
| 164 | |
| 165 | ### Patch Changes |
| 166 | |
| 167 | - Updated dependencies |
| 168 | - @composio/core@0.6.5-alpha.0 |
| 169 | |
| 170 | ## 0.6.4 |
| 171 | |
| 172 | ### Patch Changes |
| 173 | |
| 174 | - Updated dependencies [e3f1f6c] |
| 175 | - @composio/core@0.6.4 |
| 176 | |
| 177 | ## 0.6.3 |
| 178 | |
| 179 | ### Patch Changes |
| 180 | |
| 181 | - Updated dependencies [087385d] |
| 182 | - @composio/core@0.6.3 |
| 183 | |
| 184 | ## 0.6.2 |
| 185 | |
| 186 | ### Patch Changes |
| 187 | |
| 188 | - @composio/core@0.6.2 |
| 189 | |
| 190 | ## 0.6.1 |
| 191 | |
| 192 | ### Patch Changes |
| 193 | |
| 194 | - Updated dependencies [e746383] |
| 195 | - @composio/core@0.6.1 |
| 196 | |
| 197 | ## 0.6.0 |
| 198 | |
| 199 | ### Minor Changes |
| 200 | |
| 201 | - Breaking: Fixes for cloudflare support, webhook verification and other fixes |
| 202 | |
| 203 | ### Patch Changes |
| 204 | |
| 205 | - Updated dependencies |
| 206 | - @composio/core@0.6.0 |
| 207 | |
| 208 | ## 0.5.5 |
| 209 | |
| 210 | ### Patch Changes |
| 211 | |
| 212 | - Updated dependencies [b132aad] |
| 213 | - @composio/core@0.5.5 |
| 214 | |
| 215 | ## 0.5.4 |
| 216 | |
| 217 | ### Patch Changes |
| 218 | |
| 219 | - Updated dependencies [b3f5875] |
| 220 | - @composio/core@0.5.4 |
| 221 | |
| 222 | ## 0.5.3 |
| 223 | |
| 224 | ### Patch Changes |
| 225 | |
| 226 | - Updated dependencies [498505d] |
| 227 | - @composio/core@0.5.3 |
| 228 | |
| 229 | ## 0.5.2 |
| 230 | |
| 231 | ### Patch Changes |
| 232 | |
| 233 | - Updated dependencies [277f02b] |
| 234 | - @composio/core@0.5.2 |
| 235 | |
| 236 | ## 0.5.1 |
| 237 | |
| 238 | ### Patch Changes |
| 239 | |
| 240 | - Updated dependencies [3055048] |
| 241 | - @composio/core@0.5.1 |
| 242 | |
| 243 | ## 0.5.0 |
| 244 | |
| 245 | ### Minor Changes |
| 246 | |
| 247 | - d80f3e2: Bump core dependency to 0.5.0 |
| 248 | |
| 249 | ## 0.4.0 |
| 250 | |
| 251 | ### Minor Changes |
| 252 | |
| 253 | - c7e1217: Add support for dedicated tools for tool router |
| 254 | |
| 255 | ### Patch Changes |
| 256 | |
| 257 | - Updated dependencies [c7e1217] |
| 258 | - @composio/core@0.4.0 |
| 259 | |
| 260 | ## 0.3.4 |
| 261 | |
| 262 | ### Patch Changes |
| 263 | |
| 264 | - Updated dependencies [019f54f] |
| 265 | - @composio/core@0.3.4 |
| 266 | |
| 267 | ## 0.3.3 |
| 268 | |
| 269 | ### Patch Changes |
| 270 | |
| 271 | - Updated dependencies [a76b002] |
| 272 | - @composio/core@0.3.3 |
| 273 | |
| 274 | ## 0.3.2 |
| 275 | |
| 276 | ### Patch Changes |
| 277 | |
| 278 | - Updated dependencies [69cfede] |
| 279 | - @composio/core@0.3.2 |
| 280 | |
| 281 | ## 0.3.1 |
| 282 | |
| 283 | ### Patch Changes |
| 284 | |
| 285 | - Updated dependencies [73db5f5] |
| 286 | - @composio/core@0.3.1 |
| 287 | |
| 288 | ## 0.3.0 |
| 289 | |
| 290 | ### Patch Changes |
| 291 | |
| 292 | - Updated dependencies |
| 293 | - @composio/core@0.3.0 |
| 294 | |
| 295 | ## 0.2.7 |
| 296 | |
| 297 | ### Patch Changes |
| 298 | |
| 299 | - Updated dependencies [07551cd] |
| 300 | - Updated dependencies [9e002c5] |
| 301 | - Updated dependencies [f0e67c4] |
| 302 | - Updated dependencies [31521bd] |
| 303 | - Updated dependencies [9e002c5] |
| 304 | - @composio/core@0.2.7 |
| 305 | |
| 306 | ## 0.2.7-alpha.4 |
| 307 | |
| 308 | ### Patch Changes |
| 309 | |
| 310 | - Updated dependencies [07551cd] |
| 311 | - @composio/core@0.2.7-alpha.4 |
| 312 | |
| 313 | ## 0.2.7-alpha.3 |
| 314 | |
| 315 | ### Patch Changes |
| 316 | |
| 317 | - Updated dependencies [f0e67c4] |
| 318 | - @composio/core@0.2.7-alpha.3 |
| 319 | |
| 320 | ## 0.2.7-alpha.2 |
| 321 | |
| 322 | ### Patch Changes |
| 323 | |
| 324 | - Updated dependencies [31521bd] |
| 325 | - @composio/core@0.2.7-alpha.2 |
| 326 | |
| 327 | ## 0.2.7-alpha.1 |
| 328 | |
| 329 | ### Patch Changes |
| 330 | |
| 331 | - Updated dependencies |
| 332 | - @composio/core@0.2.7-alpha.1 |
| 333 | |
| 334 | ## 0.2.7-alpha.0 |
| 335 | |
| 336 | ### Patch Changes |
| 337 | |
| 338 | - Updated dependencies |
| 339 | - @composio/core@0.2.7-alpha.0 |
| 340 | |
| 341 | ## 0.2.6 |
| 342 | |
| 343 | ### Patch Changes |
| 344 | |
| 345 | - b5cc23f: Fix dangerously skip version check in non agentic providers, Throw error instead of process.exit when api key doesn't exist, bump zod-to-json-schema to 3.25.0, which supports "zod/3" |
| 346 | - Updated dependencies [b5cc23f] |
| 347 | - @composio/core@0.2.6 |
| 348 | |
| 349 | ## 0.2.5 |
| 350 | |
| 351 | ### Patch Changes |
| 352 | |
| 353 | - e2762f2: Fix non-agentic providers to work without specifying versions |
| 354 | - Updated dependencies [e2762f2] |
| 355 | - @composio/core@0.2.5 |
| 356 | |
| 357 | ## 0.2.4 |
| 358 | |
| 359 | ### Patch Changes |
| 360 | |
| 361 | - Updated dependencies [97c4138] |
| 362 | - @composio/core@0.2.4 |
| 363 | |
| 364 | ## 0.2.3 |
| 365 | |
| 366 | ### Patch Changes |
| 367 | |
| 368 | - Updated dependencies [f88ab99] |
| 369 | - @composio/core@0.2.3 |
| 370 | |
| 371 | ## 0.2.2 |
| 372 | |
| 373 | ### Patch Changes |
| 374 | |
| 375 | - cfc2c50: Update zod version to 4 |
| 376 | - Updated dependencies [cfc2c50] |
| 377 | - @composio/core@0.2.2 |
| 378 | |
| 379 | ## 0.2.1 |
| 380 | |
| 381 | ### Patch Changes |
| 382 | |
| 383 | - Updated dependencies [6135896] |
| 384 | - @composio/core@0.2.1 |
| 385 | |
| 386 | ## 0.2.0 |
| 387 | |
| 388 | ### Minor Changes |
| 389 | |
| 390 | - 157bf7b: ### Added |
| 391 | - **Version validation for manual tool execution**: Tools now require explicit toolkit version specification when executing manually to prevent unexpected behavior from `latest` version changes |
| 392 | - **New `dangerously_skip_version_check` parameter** (Python) / `dangerouslySkipVersionCheck` (TypeScript): Optional flag to bypass version validation (use with caution) |
| 393 | - **`ToolVersionRequiredError` exception** (Python): Raised when attempting to execute tools with `latest` version without skip flag, includes helpful error messages with 4 possible fixes |
| 394 | - **`ComposioToolVersionRequiredError` error** (TypeScript): Parallel implementation for TypeScript SDK with detailed error context and resolution suggestions |
| 395 | - **Comprehensive test coverage**: Added 19 new test methods in Python covering all tool execution scenarios including version resolution, error handling, modifiers, and environment variables |
| 396 | |
| 397 | ### Changed |
| 398 | - **Tool execution behavior**: Manual execution via `tools.execute()` now validates toolkit versions before API calls |
| 399 | - **Agentic provider flows**: Automatically set `dangerously_skip_version_check=True` internally to maintain backward compatibility for framework integrations |
| 400 | - **Instance-level version resolution**: Both `execute()` and `_execute_tool()` methods now consistently resolve versions from instance-level `toolkit_versions` configuration |
| 401 | - **Modifier support**: Added `dangerously_skip_version_check` to modifier parameter types for complete flow coverage |
| 402 | - **Test version format**: Updated all test files to use production date-based version format (`20251201_XX`) instead of semantic versioning |
| 403 | |
| 404 | ### Fixed |
| 405 | - **Consistent version handling**: Removed `toolkit_versions` parameter from `_execute_tool()` in favor of instance-level configuration, ensuring consistent version resolution across the SDK |
| 406 | - **Code formatting**: Applied ruff formatting to all modified Python files |
| 407 | - **Array parsing to ZodSchema**: Fixes in json-schema-to-zod to parse array without properties and with properties |
| 408 | |
| 409 | ### Migration Guide |
| 410 | |
| 411 | When manually executing tools, you must now specify toolkit versions: |
| 412 | |
| 413 | **Option 1: Pass explicit version parameter** |
| 414 | |
| 415 | ```python |
| 416 | tools.execute("GITHUB_CREATE_ISSUE", |
| 417 | arguments={...}, |
| 418 | version="20251201_01" |
| 419 | ) |
| 420 | ``` |
| 421 | |
| 422 | **Option 2: Configure at SDK initialization** |
| 423 | |
| 424 | ```python |
| 425 | tools = Tools(client, provider, |
| 426 | toolkit_versions={"github": "20251201_01"} |
| 427 | ) |
| 428 | ``` |
| 429 | |
| 430 | **Option 3: Use environment variables** |
| 431 | |
| 432 | ```bash |
| 433 | export COMPOSIO_TOOLKIT_VERSION_GITHUB=20251201_01 |
| 434 | ``` |
| 435 | |
| 436 | **Option 4: Skip validation (not recommended)** |
| 437 | |
| 438 | ```python |
| 439 | tools.execute("GITHUB_CREATE_ISSUE", |
| 440 | arguments={...}, |
| 441 | dangerously_skip_version_check=True |
| 442 | ) |
| 443 | ``` |
| 444 | |
| 445 | ### Developer Notes |
| 446 | - Agentic framework integrations (LangChain, CrewAI, etc.) are not affected as they automatically use the skip flag |
| 447 | - The `latest` version can still be used with the skip flag, but specific versions are strongly recommended |
| 448 | - Error messages include all available resolution options for better developer experience |
| 449 | |
| 450 | ### Patch Changes |
| 451 | |
| 452 | - Updated dependencies [157bf7b] |
| 453 | - @composio/core@0.2.0 |
| 454 | |
| 455 | ## 0.1.55 |
| 456 | |
| 457 | ### Patch Changes |
| 458 | |
| 459 | - Updated dependencies [8741165] |
| 460 | - @composio/core@0.1.55 |
| 461 | |
| 462 | ## 0.1.54 |
| 463 | |
| 464 | ### Patch Changes |
| 465 | |
| 466 | - Updated dependencies [e5b9db3] |
| 467 | - @composio/core@0.1.54 |
| 468 | |
| 469 | ## 0.1.53 |
| 470 | |
| 471 | ### Patch Changes |
| 472 | |
| 473 | - ea84142: Add Llamaindex provider for TS |