This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to next, this PR will be updated. # Releases ## @composio/core@0.15.0 ### Minor Changes -1503786: Replace the loose JSON Schema property type with a recursive, type-safe definition. `JSONSchemaProperty` (re-exported from `@composio/core` and reachable through `Tool.input_parameters` / `Tool.output_parameters`) is now a concrete recursive interface instead of effectively `any`. Runtime behavior is unchanged, but consumer code that indexed into it without narrowing (for example `schema.properties.foo.type` or `schema.default.someField`) may see new type errors: `properties` entries are now possibly `undefined` and `default` / `enum` values are `unknown`. Narrow with optional chaining or explicit type guards when upgrading. ### Patch Changes -2ac6ad3: Bound the background npm version check so registry outages cannot leave the request pending indefinitely. -5105612: Match sensitive upload path segments using the target filesystem's actual case sensitivity so case-insensitive mounts cannot bypass the denylist without over-blocking distinct paths on case-sensitive mounts. -051c8c5: Redact secrets that appear inside JSON payloads in telemetry error text. The key/value rule required the separator to follow the key name directly, so a serialized body such as `{"api_key": "..."}` — the shape error messages usually carry — was sent unredacted. -e5c9ada: Refresh the OpenAI runtime dependency to version 7. -ecd0861: Release unread response bodies on the paths the SDK knowingly abandons: cancel every intermediate redirect body in `ssrfSafeFetch`, and the response body before throwing on `!response.ok` in both URL-upload call sites, instead of leaving them for the garbage collector to reclaim. -2a6a051: Remove the unused internal `isNewerVersion` helper. - Updated dependencies [1503786] - @composio/json-schema-to-zod@0.2.2 ## @composio/openai@0.11.0 ### Minor Changes -e5c9ada: Add support for OpenAI versions 6 and 7. ## @composio/experimental@0.2.2 ### Patch Changes -4ceaede: Refresh the TypeBox runtime dependency. ## @composio/json-schema-to-zod@0.2.2 ### Patch Changes -1503786: Model the parser-supported `min`, `max`, and `example` JSON Schema extensions in the exported recursive schema type. ## @composio/slim@0.15.0 ### Patch Changes -e5c9ada: Refresh the OpenAI runtime dependency to version 7. - Updated dependencies [1503786] - @composio/json-schema-to-zod@0.2.2 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Composio TypeScript workspace
This directory contains the TypeScript half of the Composio SDK monorepo: the core SDK, provider adapters, the CLI, examples, and end-to-end tests. For an overview of Composio itself, start at the root README and docs.composio.dev.
If you just want to use the SDK:
npm install @composio/core
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
const session = await composio.create('user_123');
const tools = await session.tools();
See the @composio/core README and the quickstart for the full flow, including provider setup for your agent framework.
Packages
Published packages:
| Package | Description |
|---|---|
@composio/core |
The Composio SDK. Ships its TypeScript source and SDK docs so installed copies are inspectable by coding agents. |
@composio/slim |
Same API as @composio/core without the packaged source and docs; smaller install. |
composio CLI |
Standalone CLI binary: search, execute, and script tools from your shell. |
@composio/* providers |
Adapters that format Composio tools for agent frameworks (OpenAI, Anthropic, Vercel AI SDK, LangChain, and more). See the provider table. |
@composio/experimental |
Experimental integrations, currently the Pi provider. |
@composio/json-schema-to-zod |
JSON Schema to Zod conversion. |
Internal (unpublished) packages: cli-keyring and cli-local-tools support the CLI; ts-builders generates TypeScript source.
Layout
ts/
packages/ Published and internal packages (see above)
examples/ Runnable examples per feature and framework
e2e-tests/ Runtime E2E tests (Node, Deno, Cloudflare Workers, CLI)
docs/ Workspace SDK docs: API notes and internal guides
scripts/ Build, validation, and scaffolding scripts
vendor/ Read-only reference submodules; do not edit
Development
Commands run from the repository root. Install the pinned toolchain first:
mise install
pnpm install
Build and verify:
pnpm build:packages # build all TS packages
pnpm typecheck # typecheck all TS packages
pnpm lint:packages # oxlint over ts/packages
pnpm test # package unit tests plus example validation
Runtime E2E suites (require credentials):
pnpm test:e2e:node
pnpm test:e2e:deno
pnpm test:e2e:cloudflare
pnpm test:e2e:cli
Scaffolding:
pnpm create:provider <name> [--agentic] # new provider package
pnpm create:example <name> # new example under ts/examples
Changesets are required for changes to published packages; see the contribution guidelines.