Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
AGENTS.md
TypeScript workspace guidance for AI agents.
Scope
ts/ contains the TypeScript SDK packages, examples, CLI, and runtime E2E tests.
Skill Routing
- Use
typescript-sdkfor@composio/core, shared TypeScript package behavior, generated SDK surfaces, and modifiers. - Use
typescript-providersfor packages underts/packages/providers/. - Use
typescript-testingfor Vitest, typecheck, package builds, examples, or runtime E2E test selection. - Use
cli-commandorcli-e2eforts/packages/cli/andts/e2e-tests/cli/. - Use
cli-releasefor first-party CLI beta builds, stable promotion, release verification, or recovery.
Commands
Run from the repository root:
pnpm build:packages
pnpm typecheck
pnpm lint:packages
pnpm test
pnpm test:e2e:node
pnpm test:e2e:deno
pnpm test:e2e:cloudflare
pnpm test:e2e:cli
Rules
- Do not edit
ts/vendor/; those submodules are read-only references. - Keep generated outputs owned by their generator.
- Add changesets only for changes to published TypeScript packages.
- Never add changesets for
@composio/clior@composio/cli-local-toolswhile.changeset/config.jsonignores them; record CLI notes ints/packages/cli/CHANGELOG.mdinstead. - Prefer focused package tests before broad workspace tests.
- Parse untyped or external data (API payloads, JSON,
unknown) at the boundary with schemas and let inferred types flow downstream: zod in SDK packages (@composio/core, providers, shared packages),effect/Schemaints/packages/cli/. Never hand-roll structural guards ('x' in obj/typeofchains) or cast parsed JSON withas.