JavaScript SDK

The JavaScript SDK is the main ACP product SDK for Node backends, platform integrations, internal tools, and agent-native products. It gives you both the high-level run() flow and first-class managers for the platform surfaces that teams actually operate.

JavaScript SDK

Use one typed Node and TypeScript client for threads, computers, web apps, functions, auth, databases, skills, and automation.

Install and initialize

The JavaScript SDK is designed to get you from API key to working ACP integration quickly. Start with one client instance and then decide whether you want the high-level run() path or the lower-level resource managers.

Use one ComputerAgentsClient per service or request context.

Set COMPUTER_AGENTS_API_KEY in the environment or pass apiKey explicitly.

Use run() for the fastest path and the managers when you need exact platform control.

Install the JavaScript SDK

Initialize the client

Core execution managers

The SDK exposes the operational ACP model directly. Threads run work, computers hold state, agents define reusable behavior, and files let you manage the workspace behind a run.

Use client.threads for explicit thread lifecycle and streaming.

Use client.computers for persistent execution environments and runtime config.

Use client.agents to define reusable model, instruction, and skill profiles.

Use client.files for environment workspace file operations.

Threads, computers, agents, and files

Product-shaped SDK managers

ACP now exposes first-class product managers on top of the generic resources layer. That means you can work with web apps, functions, auth, and runtimes directly instead of always setting kind manually.

Use client.webApps instead of a generic resources call for deployed app surfaces.

Use client.functions for backend handlers and invoke them directly from the SDK.

Use client.auth for auth modules plus user creation and sign-in flows.

Use client.databases for database CRUD plus collections and documents.

Create resources through first-class managers

Automation, scheduling, and orchestration

The SDK also covers ACP’s automation layer. You can create skills, schedules, triggers, and multi-agent orchestrations from the same client surface.

Use client.skills for custom skill publishing and updates.

Use client.schedules for recurring execution.

Use client.triggers for webhook, GitHub, Slack, and email automation.

Use client.orchestrations for agent-to-agent workflows.