@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, 03:37 UTC

next
md 1.3 KB

AGENTS.md

TypeScript provider guidance.

Scope

Provider packages adapt Composio tools and sessions to AI frameworks such as OpenAI, Anthropic, Google, LangChain, Mastra, Vercel, LlamaIndex, Cloudflare, Claude Agent SDK, and TypeSafe.

Skill Routing

Use typescript-providers for provider implementation and docs/examples. Use typescript-testing for package tests. Use cross-sdk-parity when a provider has a Python counterpart.

Commands

Run from the repository root:

pnpm create:provider <provider-name> [--agentic]
pnpm --filter @composio/<provider> test
pnpm --filter @composio/<provider> typecheck
pnpm build:packages

Rules

  • Keep provider-specific behavior inside the provider package.
  • Preserve framework-native tool shapes and naming conventions.
  • Tool schemas obtained through ToolSchema are normalized by core. Every provider that accepts a raw Tool must call deduplicateJsonSchemaRequiredArrays from @composio/core immediately before emitting a vendor JSON Schema, after any provider-specific schema transformations. A ToolSchema-normalized API tool needs no additional call unless it is transformed afterward.
  • Add tests that cover wrapping, execution handling, and version-specific compatibility.
  • Update examples or docs when provider setup or public usage changes.