main.js · part 119

60 text occurrences from desktop/Cursor.app/Contents/Resources/app/extensions/cursor-local-agent-runtime/dist/main.js, part 119. Every entry preserves the shipped literal and its saved verdict or selection reason.

File contents and all parts · All files

Run on any free worker in a self-hosted pool. Pool workers are claimed exclusively, so the subagent queues until one is free.

, or in the most recent <user_info_catalog_update> block on a later user turn

The available model slugs are listed in <available_subagent_models> in the initial user-info message${n}. 

The available model slugs are listed in this tool's description. 

An invalid slug fails the call with the allowed list — pick a listed slug or omit this parameter; never retry an invalid slug unchanged. 

Optional model slug for this agent. If provided, it must resolve to one of the available model slugs. ${o}${s}If omitted, the subagent uses the same model as the parent agent. Do not pass if resume field is set (prior model will be used). Use "inherit" unless the user explicitly requested another listed model.

Optional model slug for this agent. If provided, it must resolve to one of the available model slugs. ${o}${s}If omitted, the subagent uses the same model as the parent agent. Do not pass if resume field is set (prior model will be used). Only choose an explicit model when the user directly requests it.

prompt is required

The task for the agent to perform

Optional agent ID to resume from. If provided, sends a follow-up message to the agent after it has completed. Requests to a currently running asynchronous agent 

fail unless `interrupt` is true; set `interrupt` to true only when you intend to interrupt the running agent.

fail; wait for completion before resuming.

Optional agent ID to resume from. If provided, the agent will continue from the previous execution transcript.

${m} Use "${uCe}" to start a new agent with your own entire conversation history as a starting point (aka 'self-fork').

If true and `resume` targets a running async agent, interrupt the current run and send this prompt immediately. Only use when the user explicitly asks to interrupt or change what the running agent is doing.

Subagent type to use for this task. Must be one of: ${a.join(", ")}.

Subagent type to use for this task. Available types are listed in the initial user-info message${n}.

Optional array of file paths to images or videos to attach to the subagent. Files are read and attached to the subagent's context. Use to forward relevant media to any subagent (e.g. pass a user-attached image's saved file path so the subagent sees the actual image rather than a prose description).

Optional execution environment for the subagent. Use "local" (default) for normal local subagents, or "cloud" to run the subagent as a cloud agent (i.e. in its own separate worktree). ONLY set to cloud if the user explicitly requests a cloud subagent. DO NOT set to cloud if user does not request cloud. Cloud subagents will work on their own git branch on their own VM. After subagent completion, follow user instructions on whether to merge that branch into your own branch, check it out, or neither.

 If you mention an agent or subagent in your response, link it with the `[Name](id)` Don't use generic label such as `[agent]`, `[worker]`, or `[subagent]`.

 For cloud subagents, when the agent has edited code, link to `[Review](bc-id#changes)`, or, if you know the exact added and deleted line counts, `[Review +A −D](bc-id#changes)`, replacing A and D with those counts. Never write A or D literally. Use `[Try Live](bc-id#desktop)` only when the agent used computer use.

Base branch for the cloud subagent's branch to start from. Default is current branch. Uses remote version of branch; uncommitted or un-pushed branches will fail. Only specify this parameter if environment equals cloud.

Exact environment build id (e.g. bld-YYYYMMDD-<uuid>) for the cloud subagent's VM to boot from, instead of the environment's latest successful build. Use to test a specific environment build in an isolated cloud subagent. Only specify this parameter if environment equals cloud. The build must belong to the same team and environment; an invalid or inaccessible build fails the subagent.

Branch the subagent's own generated branch starts from. Defaults to the current branch. Uses the remote version, so uncommitted or unpushed work is not visible.

Exact environment build id (e.g. bld-YYYYMMDD-<uuid>) for the subagent's VM to boot from, instead of the environment's latest successful build. Must belong to the same team and environment; an invalid or inaccessible build fails the subagent.

Run on a dedicated cloud VM with its own clone and generated branch. After the subagent finishes, follow user instructions on whether to merge that branch, check it out, or neither.

Optional placement: where the subagent runs. Omit to run on this machine, which is almost always right. ONLY set this if the user explicitly asks for a cloud subagent or a specific machine.

Run the agent in the background (returns output_file path to check later).

Run the agent in the background. A background subagent cannot be polled or awaited; after spawning it, continue other work or end your turn, and its final result will be delivered to you automatically when it completes.

 Defaults true.

 If this is false, you will be blocked until the agent completes.

 If the user is currently in Multitask Mode, always set this parameter to True.

 When true, the background subagent will send a notification when it completes.

 When true, the background subagent will send a notification when it completes. That notification includes a user-visible summary portion; do not summarize or restate a completed background subagent's result unless the user asks, multiple background subagents need synthesis, or a background subagent reports a blocker requiring parent action outside of the user-visible high level summary.

This retired subagent type can only resume an existing child

subagent_type is required when creating a new subagent

cloud_base_branch may only be specified when environment equals cloud

cloud_requested_environment_build_id may only be specified when environment equals cloud

A short, user-friendly title for the subagent. This appears in the UI as the subagent's name. Make it concrete and distinct, consider recent titles to avoid reuse. For resumed subagents which you are prompting to work on a separate task, give an updated description based on the latest work the subagent is performing. (Do not rename if the subagent is continuing work on the same high-level task.)

  - If you want to read a specific file path, use the ${d}${p?` or ${p}`:""} tool instead of the ${u} tool, to find the match more quickly

 or ${p}

  - If you are searching for code within a specific file or set of 2-3 files, use the ${d} tool instead of the ${u} tool, to find the match more quickly

  - If you are searching for a specific class definition like "class Foo", use the ${p} tool instead, to find the match more quickly

- When the agent is done, it will return a single message back to you. Specify exactly what information the agent should return back in its final response to you.

- When the agent is done, it will return a single message back to you. Specify exactly what information the agent should return back in its final response to you. Background subagent completion messages already include a user-visible summary portion; do not summarize or restate a single background subagent's result by default. Respond only when the user asks, multiple background subagents need synthesis, or the background subagent reports a blocker requiring parent action outside of the user-visible high level summary.

- When the agent is done, it will return a single message back to you. Specify exactly what information the agent should return back in its final response to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.

- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. ${n||o?s?"This sends a follow-up message after the agent has completed, preserving existing context. If the agent is still running, the request fails unless `interrupt` is true. Set `interrupt` to true only when the user explicitly wants to interrupt the running agent.":"This sends a follow-up message after the agent has completed, preserving existing context. If the agent is still running, the request fails; wait for completion before resuming.":"When resumed, the agent continues with its full previous context preserved."}${l?` You can also set \`resume\` to "${uCe}" to fork the current parent agent into a new child subagent.`:""} When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.

This sends a follow-up message after the agent has completed, preserving existing context. If the agent is still running, the request fails unless `interrupt` is true. Set `interrupt` to true only when the user explicitly wants to interrupt the running agent.

This sends a follow-up message after the agent has completed, preserving existing context. If the agent is still running, the request fails; wait for completion before resuming.

When resumed, the agent continues with its full previous context preserved.

 You can also set `resume` to "${uCe}" to fork the current parent agent into a new child subagent.

Launch a new agent to handle complex, multi-step tasks autonomously.

The ${u} tool launches specialized subagents (subprocesses) that autonomously handle complex tasks. Each subagent_type has specific capabilities and tools available to it.

When using the ${u} tool, you must specify a subagent_type parameter to select which agent type to use.${t?`\n${m?`\nVERY IMPORTANT: When broadly exploring the codebase to gather context for a large task, it is recommended that you use the ${u} tool with subagent_type="${jpe}" instead of running search commands directly.\n`:""}\nIf the query is a narrow or specific question, you should NOT use the ${u} and instead address the query directly using the other tools available to you.\n\nExamples:\n- user: "Where is the ClientError class defined?" assistant: [Uses Grep directly - this is a needle query for a specific class]\n- user: "Run this query using my database API" assistant: [Calls the MCP directly - this is not a broad exploration task]\n- user: "What is the codebase structure?" assistant: [Uses the ${u} tool with subagent_type="${jpe}"]\n\nIf it is possible to explore different areas of the codebase in parallel, you should launch multiple agents concurrently.`:""}

When NOT to use the ${u} tool:
- Simple, single or few-step tasks that can be performed by a single agent (using parallel or sequential tool calls) -- just call the tools directly instead.
${f.length>0?`- For example:\n${f}`:""}

Usage notes:
- Always include a short description (3-5 words) summarizing what the agent will do
- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses.
${g}${y}
${c?a?"- If you mention an agent or subagent in your response, link it with the `[Name](id)` Don't use generic label such as `[agent]`, `[worker]`, or `[subagent]`. For cloud subagents, when the agent has edited code, link to `[Review](bc-id#changes)`, or, if you know the exact added and deleted line counts, `[Review +A −D](bc-id#changes)`, replacing A and D with those counts. Never write A or D literally. Use `[Try Live](bc-id#desktop)` only when the agent used computer use.\n":"- In user-facing responses, you may link to agents and subagents with markdown chat links in the `[label](id)` format, using the agent ID as the link target. Do not print raw agent IDs separately.\n":""}- When using the ${u} tool, the subagent invocation does not have access to the user's message or prior assistant steps. Therefore, you should provide a highly detailed task description with all necessary context for the agent to perform its task autonomously.
- The subagent's outputs should generally be trusted
- Clearly tell the subagent which tasks you want it to perform, since it is not aware of the user's intent or your prior assistant steps (tool calls, thinking, or messages).
- If the subagent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
- If the user specifies that they want you to run subagents "in parallel", you MUST send a single message with multiple ${u} tool use content blocks. For example, if you need to launch both a code-reviewer subagent and a test-runner subagent in parallel, send a single message with both tool calls.
- Avoid delegating the full query to the ${u} tool and returning the result. In these cases, you should address the query using the other tools available to you.

${m?`\nVERY IMPORTANT: When broadly exploring the codebase to gather context for a large task, it is recommended that you use the ${u} tool with subagent_type="${jpe}" instead of running search commands directly.\n`:""}
If the query is a narrow or specific question, you should NOT use the ${u} and instead address the query directly using the other tools available to you.

Examples:
- user: "Where is the ClientError class defined?" assistant: [Uses Grep directly - this is a needle query for a specific class]
- user: "Run this query using my database API" assistant: [Calls the MCP directly - this is not a broad exploration task]
- user: "What is the codebase structure?" assistant: [Uses the ${u} tool with subagent_type="${jpe}"]

If it is possible to explore different areas of the codebase in parallel, you should launch multiple agents concurrently.

VERY IMPORTANT: When broadly exploring the codebase to gather context for a large task, it is recommended that you use the ${u} tool with subagent_type="${jpe}" instead of running search commands directly.

- For example:
${f}

- If you mention an agent or subagent in your response, link it with the `[Name](id)` Don't use generic label such as `[agent]`, `[worker]`, or `[subagent]`. For cloud subagents, when the agent has edited code, link to `[Review](bc-id#changes)`, or, if you know the exact added and deleted line counts, `[Review +A −D](bc-id#changes)`, replacing A and D with those counts. Never write A or D literally. Use `[Try Live](bc-id#desktop)` only when the agent used computer use.

- In user-facing responses, you may link to agents and subagents with markdown chat links in the `[label](id)` format, using the agent ID as the link target. Do not print raw agent IDs separately.

 (Auto-resumes most recent agent of this type; `resume` arg is ignored)

 (Auto-resumes most recent agent; `resume` arg is ignored)

- ${r}: ${o}