$worker
cursor
v0.1.9Cursor as a login-backed, text-only LLM Router provider and coding-agent worker through official CLI ACP, with optional sdk.v1 Bridge sessions.
iiiverifiedinstall
$iii trigger compose::add worker=cursor@0.1.9
repoiii-hq/workers
exact versions are immutable; binary and bundle artifacts are digest-pinned.
agent-ready brief for v0.1.9
install + config + dependencies + readme + api reference, all in one place. fetch as agent-context.md for an llm to consume.
full markdown
the same content rendered as discrete blocks below is exposed as a single markdown document at
/workers/cursor.md?version=0.1.9. paste it into an llm prompt or pipe it through curl from a worker.install
install
$iii trigger compose::add worker=cursor@0.1.9
dependencies
readme
README.md
cursor
Use a normal Cursor login in two iii surfaces: a text-only LLM Router provider whose account models appear in the Console picker, and a coding-agent worker with durable local or cloud sessions. Local execution uses the official Cursor Agent CLI ACP. Cloud agent runs, or local agent runs explicitly configured for sdk-bridge, use Cursor's separately distributed sdk.v1 Bridge.
No Cursor API key is required for the provider or local agent path. Both reuse the login created by cursor-agent login.
Install
iii trigger compose::add worker=cursorInstall the official Cursor Agent CLI and authenticate it once outside the worker:
cursor-agent login
cursor-agent status --format jsonSome installations expose the official CLI only as ~/.local/bin/agent; use that absolute path for login when needed. The worker checks its configured agent_binary, ~/.local/bin/cursor-agent, ~/.local/bin/agent, and cursor-agent on PATH. It validates that the executable is Cursor before launching ACP, so an unrelated agent command is never selected from PATH. Set CURSOR_AGENT_BIN to an absolute path for any other installation.
Use the worker's redacted status function to confirm that the login is available without returning account details or credentials:
iii trigger cursor::auth::status --json '{}'LLM Router provider
On startup, the worker declares provider cursor and reconciles the ACP-selectable account catalog as cursor/* model IDs. The models then appear under Cursor in the Console model picker. Refresh explicitly with:
iii trigger provider::cursor::refresh_models --json '{}'The provider runs each request in Cursor ask mode inside a fresh empty temporary workspace and denies permission requests. Cursor exposes a coding-agent ACP rather than a raw chat-completions API, so this compatibility provider streams text and thinking but does not claim router tool calling, images, structured output, exact token limits, token usage, or per-token cost. Those catalog capabilities are marked unsupported instead of invented. Use cursor::run when Cursor should work directly on a repository.
Quickstart
Read the account-scoped model catalog, then run a direct coding-agent turn without CURSOR_API_KEY:
iii trigger cursor::models::list --json '{}'
iii trigger cursor::run --json '{
"runtime": "local",
"cwd": "/absolute/path/to/repository",
"model": "auto",
"prompt": "Summarize this repository and do not modify it."
}'The response includes the durable session_id, Cursor session ID, worker run ID, terminal result, status, and stop reason. Login-backed ACP does not report usage or cost, so those fields remain null. Reuse session_id for a follow-up. cursor::start returns immediately, while cursor::stop requests ACP cancellation.
The login-backed catalog comes from a fresh ACP session and includes only model IDs ACP accepts. The public auto ID maps to ACP's default model. Do not copy parameterized IDs from cursor-agent --list-models; that command exposes additional CLI-only IDs that ACP rejects. Use cursor::models::list for worker requests.
run::start_and_wait is the standard alias for cursor::run:
iii-acp --brain-fn cursor::run --brain-stop-fn cursor::stop --model auto --provider cursorACP forwards the editor cwd, maps cancellation to cursor::stop, and reports Cursor's top-level stop reason.
Configuration
The built-in cursor configuration defaults local execution to login-backed ACP. The API key and Bridge binary are optional unless cloud mode or the explicit Bridge backend is used:
local_backend: cli-acp
agent_binary: ${CURSOR_AGENT_BIN:}
api_key: ${CURSOR_API_KEY:}
bridge_binary: ${CURSOR_SDK_BRIDGE_BIN:}
workspace: .
startup_timeout_ms: 30000
shutdown_timeout_ms: 5000
rpc_timeout_ms: 60000
max_frame_bytes: 16777216
events_stream: agent::events
raw_events_stream: cursor::eventsLogin-backed local sessions run in Cursor's ask mode, and the worker cancels every permission request. Cursor ACP does not provide an enforceable per-request tool-list control, so explicit tools values, including tools: [], are rejected. Omit tools for CLI ACP. Start a new session when changing backend; legacy Bridge session IDs are never loaded as CLI ACP sessions.
Per-turn timeout_ms is supported only by login-backed cli-acp sessions. Local sdk-bridge sessions reject that field because the Bridge cannot safely cancel a timed-out Send until it has reported a run ID. Omit it and use cursor::stop while the owning Bridge process is still live. If a local Bridge Send becomes recovery-required before reporting a run ID, the worker reports that cancellation cannot be confirmed and never claims the upstream run was stopped.
Session creation and prompt ownership are claimed with state::compare-and-set, so overlapping worker processes cannot both dispatch one prompt. If a worker loses the CLI process after prompt dispatch has started, the durable session becomes recovery-required; the worker does not replay that prompt automatically.
SDK Bridge and cloud mode
Download the standalone cursor-sdk-bridge archive for release v1.0.28 from the official Cursor SDK Bridge releases, verify it against the release's SHA256SUMS.txt, and either put bin/cursor-sdk-bridge on PATH or set CURSOR_SDK_BRIDGE_BIN to its absolute path. The iii worker does not bundle or redistribute the Bridge binary or @cursor/sdk.
Set CURSOR_API_KEY for cloud runs or configure local_backend: sdk-bridge to retain the earlier local Bridge behavior. The worker reads the Bridge bearer token from its ready-line token file, accepts only a loopback HTTP endpoint, and never logs that token or the API key.
Select the Bridge catalog when choosing a model for a cloud run:
iii trigger cursor::models::list --json '{"backend":"sdk-bridge"}'Cloud sessions require at least one repository and default both work_on_current_branch and auto_create_pr to false. Creating or sending a cloud agent may incur Cursor charges. Usage and cost fields remain null when the Bridge does not report them.
The Bridge protocol is versioned independently. This worker targets the sdk.v1 contract shipped with Cursor SDK Bridge v1.0.28 and validates required capabilities during lazy startup. Model IDs are not hard-coded; cursor::models::list reads the catalog for the selected backend.
Read-only cursor::status, cursor::sessions::list, cursor::auth::status, and cursor::models::list are allowed by the default worker policy. cursor::run, cursor::start, cursor::stop, and cursor::usage remain approval-gated because they can spend money or mutate repositories. The internal configuration reload hook is denied outright.
api reference (json)
agent-api-reference.json
{
"functions": [
{
"description": "Check whether the official Cursor Agent CLI can reuse an existing cursor-agent login. Account details and credentials are never returned.",
"metadata": {},
"name": "cursor::auth::status",
"request_schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"authenticated": {
"type": "boolean"
},
"available": {
"type": "boolean"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"login_command": {
"const": "cursor-agent login",
"type": "string"
},
"status": {
"enum": [
"authenticated",
"partial",
"unauthenticated",
"unavailable"
],
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"available",
"authenticated",
"status",
"version",
"login_command",
"error"
],
"type": "object"
}
},
{
"description": "List the current account-scoped Cursor model catalog. Select sdk-bridge for the cloud/API-key catalog.",
"metadata": {},
"name": "cursor::models::list",
"request_schema": {
"additionalProperties": false,
"properties": {
"backend": {
"enum": [
"cli-acp",
"sdk-bridge"
],
"type": "string"
}
},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"models": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"display_name": {
"type": "string"
},
"id": {
"type": "string"
},
"parameters": {
"items": {
"additionalProperties": false,
"properties": {
"display_name": {
"type": "string"
},
"id": {
"type": "string"
},
"values": {
"items": {
"additionalProperties": false,
"properties": {
"display_name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"value",
"display_name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"display_name",
"values"
],
"type": "object"
},
"type": "array"
},
"variants": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"display_name": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"params": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"id",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"params",
"display_name",
"description",
"is_default"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"display_name",
"description",
"parameters",
"variants"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"models"
],
"type": "object"
}
},
{
"description": "Internal Cursor configuration reload hook.",
"metadata": {
"internal": true
},
"name": "cursor::on-config-change",
"request_schema": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
}
},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Run one Cursor coding-agent turn and wait for its terminal result. Local runs default to the login-backed Cursor CLI ACP; cloud runs use the separately installed sdk.v1 Bridge. The ACP-compatible shape requires cwd and model.",
"metadata": {},
"name": "cursor::run",
"request_schema": {
"anyOf": [
{
"oneOf": [
{
"additionalProperties": false,
"properties": {
"cwd": {
"minLength": 1,
"type": "string"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"runtime": {
"const": "local",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"timeout_ms": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"runtime",
"cwd",
"model"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"auto_create_pr": {
"type": "boolean"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"repositories": {
"items": {
"additionalProperties": false,
"properties": {
"pr_url": {
"format": "uri",
"type": "string"
},
"starting_ref": {
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"runtime": {
"const": "cloud",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"work_on_current_branch": {
"type": "boolean"
}
},
"required": [
"runtime"
],
"type": "object"
}
]
},
{
"additionalProperties": false,
"properties": {
"cwd": {
"minLength": 1,
"type": "string"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"provider": {
"const": "cursor",
"type": "string"
},
"runtime": {
"not": {}
},
"session_id": {
"minLength": 1,
"type": "string"
},
"system_prompt": {
"type": "string"
},
"timeout_ms": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"cwd",
"model"
],
"type": "object"
}
]
},
"response_schema": {
"additionalProperties": false,
"properties": {
"agent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"busy": {
"type": "boolean"
},
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"error_details": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"rate_limit": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"remaining": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reset_epoch_seconds": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"limit",
"remaining",
"reset_epoch_seconds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"retry_after_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"sdk_error_code": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "null"
}
]
},
"transport_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"transport_code",
"sdk_error_code",
"request_id",
"retry_after_seconds",
"rate_limit"
],
"type": "object"
},
{
"type": "null"
}
]
},
"is_error": {
"type": "boolean"
},
"recovery_required": {
"type": "boolean"
},
"result": {
"type": "string"
},
"run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"session_id": {
"type": "string"
},
"status": {
"type": "string"
},
"stop_reason": {
"anyOf": [
{
"enum": [
"end",
"length",
"aborted",
"error"
],
"type": "string"
},
{
"type": "null"
}
]
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"session_id",
"agent_id",
"run_id",
"result",
"status",
"stop_reason",
"is_error",
"usage",
"cost",
"busy",
"recovery_required",
"error",
"error_details"
],
"type": "object"
}
},
{
"description": "List durable iii-to-Cursor session mappings owned by this worker.",
"metadata": {},
"name": "cursor::sessions::list",
"request_schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"sessions": {
"items": {
"additionalProperties": false,
"properties": {
"active_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"active_turn": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"agent_created": {
"type": "boolean"
},
"agent_id": {
"type": "string"
},
"auto_create_pr": {
"type": "boolean"
},
"backend": {
"enum": [
"cli-acp",
"sdk-bridge"
],
"type": "string"
},
"cancel_requested": {
"type": "boolean"
},
"claim_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"claim_started_at_ms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"create_idempotency_key": {
"type": "string"
},
"last_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pending_prompt_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"repositories": {
"items": {
"additionalProperties": false,
"properties": {
"pr_url": {
"format": "uri",
"type": "string"
},
"starting_ref": {
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"runtime": {
"enum": [
"local",
"cloud"
],
"type": "string"
},
"send_idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"send_started": {
"type": "boolean"
},
"session_id": {
"type": "string"
},
"status": {
"enum": [
"working",
"done",
"error",
"cancelled",
"recovery-required"
],
"type": "string"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
},
"turns": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"updated_at_ms": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
},
"work_on_current_branch": {
"type": "boolean"
},
"workspace": {
"type": "string"
}
},
"required": [
"session_id",
"agent_id",
"runtime",
"workspace",
"name",
"model",
"tools",
"repositories",
"work_on_current_branch",
"auto_create_pr",
"status",
"agent_created",
"turns",
"active_turn",
"active_run_id",
"last_run_id",
"create_idempotency_key",
"send_idempotency_key",
"send_started",
"cancel_requested",
"claim_id",
"claim_started_at_ms",
"pending_prompt_sha256",
"usage",
"cost",
"updated_at_ms"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"sessions"
],
"type": "object"
}
},
{
"description": "Start a Cursor agent turn and return immediately. Watch agent::events with group_id equal to session_id.",
"metadata": {},
"name": "cursor::start",
"request_schema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"cwd": {
"minLength": 1,
"type": "string"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"runtime": {
"const": "local",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"timeout_ms": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"runtime",
"cwd",
"model"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"auto_create_pr": {
"type": "boolean"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"repositories": {
"items": {
"additionalProperties": false,
"properties": {
"pr_url": {
"format": "uri",
"type": "string"
},
"starting_ref": {
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"runtime": {
"const": "cloud",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"work_on_current_branch": {
"type": "boolean"
}
},
"required": [
"runtime"
],
"type": "object"
}
]
},
"response_schema": {
"additionalProperties": false,
"properties": {
"session_id": {
"type": "string"
},
"started": {
"type": "boolean"
}
},
"required": [
"session_id",
"started"
],
"type": "object"
}
},
{
"description": "Check the status of a Cursor session (local ACP or Bridge).",
"metadata": {},
"name": "cursor::status",
"request_schema": {
"additionalProperties": false,
"properties": {
"session_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"session_id"
],
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"agent": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agent_id": {
"type": "string"
},
"archived": {
"type": "boolean"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cwd": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"metadata": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"name": {
"type": "string"
},
"repositories": {
"items": {
"type": "string"
},
"type": "array"
},
"runtime": {
"anyOf": [
{
"enum": [
"local",
"cloud"
],
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"agent_id",
"name",
"summary",
"status",
"archived",
"created_at",
"last_modified",
"runtime",
"cwd",
"repositories",
"metadata"
],
"type": "object"
},
{
"type": "null"
}
]
},
"live": {
"type": "boolean"
},
"record": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"active_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"active_turn": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"agent_created": {
"type": "boolean"
},
"agent_id": {
"type": "string"
},
"auto_create_pr": {
"type": "boolean"
},
"backend": {
"enum": [
"cli-acp",
"sdk-bridge"
],
"type": "string"
},
"cancel_requested": {
"type": "boolean"
},
"claim_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"claim_started_at_ms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"create_idempotency_key": {
"type": "string"
},
"last_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"model": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"pending_prompt_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"repositories": {
"items": {
"additionalProperties": false,
"properties": {
"pr_url": {
"format": "uri",
"type": "string"
},
"starting_ref": {
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"runtime": {
"enum": [
"local",
"cloud"
],
"type": "string"
},
"send_idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"send_started": {
"type": "boolean"
},
"session_id": {
"type": "string"
},
"status": {
"enum": [
"working",
"done",
"error",
"cancelled",
"recovery-required"
],
"type": "string"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
},
"turns": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"updated_at_ms": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
},
"work_on_current_branch": {
"type": "boolean"
},
"workspace": {
"type": "string"
}
},
"required": [
"session_id",
"agent_id",
"runtime",
"workspace",
"name",
"model",
"tools",
"repositories",
"work_on_current_branch",
"auto_create_pr",
"status",
"agent_created",
"turns",
"active_turn",
"active_run_id",
"last_run_id",
"create_idempotency_key",
"send_idempotency_key",
"send_started",
"cancel_requested",
"claim_id",
"claim_started_at_ms",
"pending_prompt_sha256",
"usage",
"cost",
"updated_at_ms"
],
"type": "object"
},
{
"type": "null"
}
]
},
"remote_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"agent_id": {
"type": "string"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"duration_ms": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"model": {
"type": "string"
},
"result": {
"type": "string"
},
"run_id": {
"type": "string"
},
"status": {
"type": "string"
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"run_id",
"agent_id",
"status",
"result",
"model",
"duration_ms",
"created_at",
"usage"
],
"type": "object"
},
{
"type": "null"
}
]
},
"session_id": {
"type": "string"
}
},
"required": [
"session_id",
"live",
"record",
"agent",
"run",
"remote_error"
],
"type": "object"
}
},
{
"description": "Stop the active Cursor run for a session.",
"metadata": {},
"name": "cursor::stop",
"request_schema": {
"additionalProperties": false,
"properties": {
"session_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"session_id"
],
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"session_id": {
"type": "string"
},
"stopped": {
"type": "boolean"
}
},
"required": [
"session_id",
"stopped",
"reason"
],
"type": "object"
}
},
{
"description": "Read token usage and billed cost for a cloud Cursor session.",
"metadata": {},
"name": "cursor::usage",
"request_schema": {
"additionalProperties": false,
"properties": {
"run_id": {
"minLength": 1,
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"session_id"
],
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"agent_id": {
"type": "string"
},
"session_id": {
"type": "string"
},
"usage": {
"additionalProperties": false,
"properties": {
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"runs": {
"items": {
"additionalProperties": false,
"properties": {
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"run_id": {
"type": "string"
},
"usage": {
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
}
},
"required": [
"run_id",
"usage",
"cost"
],
"type": "object"
},
"type": "array"
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"usage",
"cost",
"runs"
],
"type": "object"
}
},
"required": [
"session_id",
"agent_id",
"usage"
],
"type": "object"
}
},
{
"description": "Cancel an in-flight Cursor ACP provider request.",
"metadata": {
"internal": true
},
"name": "provider::cursor::abort",
"request_schema": {
"additionalProperties": {},
"properties": {
"request_id": {
"type": "string"
}
},
"required": [
"request_id"
],
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"aborted": {
"type": "boolean"
}
},
"required": [
"aborted"
],
"type": "object"
}
},
{
"description": "Re-register the Cursor provider after an LLM Router restart.",
"metadata": {
"internal": true
},
"name": "provider::cursor::on_router_ready",
"request_schema": {
"additionalProperties": true,
"properties": {},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Refresh the login-backed Cursor model catalog and replace its LLM Router slice.",
"metadata": {
"internal": true
},
"name": "provider::cursor::refresh_models",
"request_schema": {
"additionalProperties": true,
"properties": {},
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"count"
],
"type": "object"
}
},
{
"description": "Stream a text-only Cursor completion through the official login-backed Cursor Agent ACP.",
"metadata": {
"internal": true
},
"name": "provider::cursor::stream",
"request_schema": {
"additionalProperties": {},
"properties": {
"max_output_tokens": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"messages": {
"items": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"model_meta": {},
"provider_options": {},
"resolution_key": {
"type": "string"
},
"response_format": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"session_id": {
"type": "string"
},
"system_prompt": {
"type": "string"
},
"thinking_level": {
"type": "string"
},
"tools": {
"items": {},
"type": "array"
},
"writer_ref": {
"additionalProperties": false,
"properties": {
"access_key": {
"type": "string"
},
"channel_id": {
"type": "string"
},
"direction": {
"const": "write",
"type": "string"
}
},
"required": [
"channel_id",
"access_key",
"direction"
],
"type": "object"
}
},
"required": [
"writer_ref",
"model",
"messages"
],
"type": "object"
},
"response_schema": {
"additionalProperties": false,
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
],
"type": "object"
}
},
{
"description": "Standard agent alias for cursor::run. Configure ACP with --brain-fn cursor::run when more than one agent worker is installed.",
"metadata": {},
"name": "run::start_and_wait",
"request_schema": {
"anyOf": [
{
"oneOf": [
{
"additionalProperties": false,
"properties": {
"cwd": {
"minLength": 1,
"type": "string"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"runtime": {
"const": "local",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"timeout_ms": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"runtime",
"cwd",
"model"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"auto_create_pr": {
"type": "boolean"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"name": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"repositories": {
"items": {
"additionalProperties": false,
"properties": {
"pr_url": {
"format": "uri",
"type": "string"
},
"starting_ref": {
"type": "string"
},
"url": {
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"runtime": {
"const": "cloud",
"type": "string"
},
"session_id": {
"minLength": 1,
"type": "string"
},
"work_on_current_branch": {
"type": "boolean"
}
},
"required": [
"runtime"
],
"type": "object"
}
]
},
{
"additionalProperties": false,
"properties": {
"cwd": {
"minLength": 1,
"type": "string"
},
"messages": {
"items": {
"additionalProperties": false,
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
]
},
"role": {
"type": "string"
}
},
"required": [
"role",
"content"
],
"type": "object"
},
"type": "array"
},
"model": {
"minLength": 1,
"type": "string"
},
"prompt": {
"type": "string"
},
"provider": {
"const": "cursor",
"type": "string"
},
"runtime": {
"not": {}
},
"session_id": {
"minLength": 1,
"type": "string"
},
"system_prompt": {
"type": "string"
},
"timeout_ms": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"cwd",
"model"
],
"type": "object"
}
]
},
"response_schema": {
"additionalProperties": false,
"properties": {
"agent_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"busy": {
"type": "boolean"
},
"cost": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"charged_cents": {
"minimum": 0,
"type": "number"
},
"raw_cost_cents": {
"minimum": 0,
"type": "number"
}
},
"required": [
"raw_cost_cents",
"charged_cents"
],
"type": "object"
},
{
"type": "null"
}
]
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"error_details": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"rate_limit": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"limit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"remaining": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reset_epoch_seconds": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"limit",
"remaining",
"reset_epoch_seconds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"retry_after_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"sdk_error_code": {
"anyOf": [
{
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
{
"type": "null"
}
]
},
"transport_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"transport_code",
"sdk_error_code",
"request_id",
"retry_after_seconds",
"rate_limit"
],
"type": "object"
},
{
"type": "null"
}
]
},
"is_error": {
"type": "boolean"
},
"recovery_required": {
"type": "boolean"
},
"result": {
"type": "string"
},
"run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"session_id": {
"type": "string"
},
"status": {
"type": "string"
},
"stop_reason": {
"anyOf": [
{
"enum": [
"end",
"length",
"aborted",
"error"
],
"type": "string"
},
{
"type": "null"
}
]
},
"usage": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"cache_read_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"cache_write_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"input_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"output_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"total_tokens": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"input_tokens",
"output_tokens",
"cache_read_tokens",
"cache_write_tokens",
"total_tokens"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"session_id",
"agent_id",
"run_id",
"result",
"status",
"stop_reason",
"is_error",
"usage",
"cost",
"busy",
"recovery_required",
"error",
"error_details"
],
"type": "object"
}
}
],
"triggers": []
}