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.

npm GitHub

JavaScript SDK

Use one typed Node and TypeScript client for threads, tasks, computers, web apps, functions, auth, databases, feedback, notifications, 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, tasks organize planned execution, 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.tasks for project tickets, comments, releases, sprints, and task-linked threads.

Use client.computers for persistent execution environments, runtime config, and compute profiles.

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

Use client.files for file operations, including folder downloads as zip archives.

Threads, computers, agents, and files

Tasks, review feedback, and permission decisions

Project work now has a dedicated SDK surface. Tasks can start multiple linked threads, thread turns can collect thumbs up/down or issue reports, and paused runtime permission requests can be decided without leaving your app.

Use client.tasks.startThread() when your UI wants to stream the new thread itself.

Use client.tasks.runThread() when a backend job should create and execute the task thread synchronously.

Use client.threads.setFeedback() and reportIssue() to collect structured review data for later analysis.

Use listPermissionRequests() and approvePermissionRequest() when a thread pauses for user approval.

Run planned task work in JavaScript

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, runtimes, databases, and notifications 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.

Use client.notifications for in-app product notifications and push tokens.

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.