Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 473 lines 11.4 KB
Rendered Raw
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