daemon.cjs · part 317

60 text occurrences from desktop/Cursor.app/Contents/Resources/app/extensions/cursor-agent-host/dist/agent-host-daemon/dist/bin/daemon.cjs, part 317. Every entry preserves the shipped literal and its saved verdict or selection reason.

File contents and all parts · All files

Max sleep time to block before returning (in milliseconds). Required. Set to 0 for non-blocking status check. Must not exceed ${MAX_AWAIT_BLOCK_UNTIL_MS} (${maxAwaitMinutes} minutes).

Max sleep time to block before returning (in milliseconds). Defaults to ${defaultBlockUntilMs}ms. Set to 0 for non-blocking status check. Must not exceed ${MAX_AWAIT_BLOCK_UNTIL_MS} (${maxAwaitMinutes} minutes).

block_until_ms must be at most ${MAX_AWAIT_BLOCK_UNTIL_MS} (${maxAwaitMinutes} minutes)

Optional shell id to poll. If omitted, this tool sleeps for the full block_until_ms duration and then returns. Required when block_until_ms is 0.

Optional shell or subagent id to poll. If omitted, this tool sleeps for the full block_until_ms duration and then returns. Required when block_until_ms is 0.

Optional shell id to poll. If omitted, this tool sleeps for the full block_until_ms duration and then returns. Required when block_until_ms is 0.

Block until the regex matches stdout/stderr stream (or task completes). Matches anywhere in the shell output, not just new output. Will not match terminal file headers or footers, e.g. exit_code. Accepts JavaScript regex patterns (compiled with the multiline `m` flag). Not supported for awaiting subagents: you MUST leave this argument unset.

Block until the regex matches stdout/stderr stream (or task completes). Matches anywhere in the shell output, not just new output. Will not match terminal file headers or footers, e.g. exit_code. Accepts JavaScript regex patterns (compiled with the multiline `m` flag).

path must be a path to a terminal file

path must be a path to a terminal file

${value.slice(0, sideChars)}...${value.slice(-sideChars)}

timed out

aborted by the user

no running background subagent found

no background subagent found for id

Permission denied reading ${path53}

Read rejected for ${path53}

Invalid file: ${path53}

Read failed for ${path53}

Unknown read result for ${path53}

Unhandled read result case: ${_exhaustive}

task id

shell id

- Shell only guidance:
  - Waiting until a regex matches the output can be useful for e.g. known startup/status/error logs.
  - HARD STOPPING CONSTRAINT: Don't stop polling until (a) job terminates, (b) the command reaches a healthy steady state (only for non-terminating command, e.g. dev server/watcher), or (c) command is hung - follow guidance below.
  - Output file header has `pid` and `running_for_ms` (updated every 5000ms).
  - When finished, footer with `exit_code` and `elapsed_ms` appears (regex only matches the body, not header/footer).
  - If taking longer than expected and the command seems like it is hung (use judgment based on type of command), kill the process if safe to do so using the pid that appears in the header. If possible, try to fix the hang and proceed.

Poll a background ${enableSubagentAwaiting ? "shell or subagent" : "shell"} job. For work that does not have a ${idNoun}, you can omit the ${idArg} arg to sleep for the full `block_until_ms` duration (prefer this over sleeping in the shell, because it renders nicely to the user).

Monitor backgrounded jobs as follows:
- Never poll a task whose tool result says it was "manually backgrounded by the user".
- When you spawn a command directly into the background (`block_until_ms: 0`), check status immediately by reading the output file to confirm the command didn't fail to start.
- Poll repeatedly to monitor by using this tool between checks (set `block_until_ms` to control how long to wait). If the file gets large, read from the end of the file to capture the latest content.
- Pick your polling intervals using best guess/judgment based on any knowledge you have about the command and its expected runtime, and any output from monitoring the job. When no new output, exponential backoff is a good strategy (e.g. 2000ms, 4000ms, 8000ms, 16000ms...), using educated guess for min and max wait.${shellOnlyGuidance}

shell or subagent

shell or subagent

task id

shell id

When waiting further, avoid round 5-minute waits: prefer slices of 60–270s (keeps prompt cache warm) or 1200s+ (one cache miss buys a long wait).

- NEVER USE THIS TO POLL OR WAIT VACUOUSLY FOR A SUBAGENT LAUNCHED WITH THE ${taskToolName} TOOL — rely on the end-of-turn completion notification instead (it is delivered as soon as the subagent finishes; guessing a wait time is inefficient).

- Subagents: never wait on a subagent with ${toolName}. Subagents are always notify-on-completion — multitask on independent work (or respond to the user if there is nothing else productive to do) and wait to be woken up. The only valid use of ${toolName} on a subagent is a non-blocking status check (`block_until_ms: 0`); never use it to block on the subagent finishing.

- Shell: only poll with ${toolName} when the command requires close monitoring. Close monitoring means a long-running job that can silently hang, degrade, or need a course correction before it completes — e.g. training runs, eval runs, deployments, long builds, datagen pipelines, DB migrations, large data transfers. For fire-and-forget commands (tests, installs, dev servers/watchers, short scripts, etc.) the completion notification is enough — start them, keep working, and only poll with ${toolName} later if you end up blocked on the result.
- Shell sanity check (regardless of close monitoring): when you spawn a command directly into the background (`block_until_ms: 0`), do a single status check by reading the output file to confirm the command didn't fail to start. This is a one-shot smoke check, not a polling loop.
- Shell close-monitoring guidance (only applies in the close-monitoring case above):
  - HARD STOPPING CONSTRAINT: once you've decided to actively poll, don't stop until (a) the job terminates, (b) the command reaches a healthy steady state (only for non-terminating commands, e.g. dev server/watcher), or (c) the command is hung — follow the hang guidance below.
  - Waiting until a regex matches the output can be useful for e.g. known startup/status/error logs.
  - Size `block_until_ms` to the command's expected runtime. ${promptCacheTTLWaitGuidance}
  - Output file header has `pid` and `running_for_ms` (updated every 5000ms).
  - When finished, footer with `exit_code` and `elapsed_ms` appears (regex only matches the body, not header/footer).
  - If the command is taking longer than expected and appears hung (use judgment based on command type), kill the process if safe to do so using the pid in the header. If possible, fix the hang and proceed.

 Subagents are never a candidate for close monitoring.

 (shell jobs only — never wait on a subagent)

Prefer NOT to poll reflexively with ${toolName}. Multitask on independent work while backgrounded jobs run, or finish your turn and rely on the end-of-turn completion notification. Poll with ${toolName} only when one of the following is true:
- Your very next step is blocked on this specific job's result and you have no other productive work to do${blockedBulletScope}, OR
- The task requires close monitoring (see shell guidance below).${closeMonitoringClause}

Prefer NOT to poll reflexively with ${toolName}. Multitask on independent work while backgrounded jobs run, or finish your turn and rely on the end-of-turn completion notification.

Check or poll a backgrounded ${jobNoun} job. For work that does not have a ${idNoun}, you can omit the ${idArg} arg to sleep for the full `block_until_ms` duration (prefer this over sleeping in the shell, because it renders nicely to the user). At the end of your turn, you will be notified about any unawaited jobs that completed. If you think a job completed (e.g. because you killed it), observe it with ${toolName} to skip the notification, because stale notifications can confuse the user.${positivePollBlock}
- Never poll a task whose tool result says it was "manually backgrounded by the user".${neverPollSubagentBullet}${subagentRule}${shellGuidance}

When waiting further, avoid round 1-minute waits: prefer slices of up to ${ttlSeconds - 30}s (keeps prompt cache warm) or ${ttlSeconds * 4}s+ (one cache miss buys a long wait).

When waiting further, avoid round ${ttlMinutes}-minute waits: prefer slices of 60–${ttlSeconds - 30}s (keeps prompt cache warm) or ${ttlSeconds * 4}s+ (one cache miss buys a long wait).

When waiting further, avoid waiting ${formatHoursForPrompt(ttlMinutes)}h or more: prefer slices of 60s-${ttlMinutes - 1}m (keeps prompt cache warm). Size slices based on expected progress; when progress is unclear, exponential backoff is useful.

When waiting further, size slices based on expected progress. When progress is unclear, exponential backoff is useful.

use strict

Object expected.

Symbol.asyncDispose is not defined.

Symbol.dispose is not defined.

Object not disposable.

An error was suppressed during disposal.

Set this to true if you are waiting for subagent(s) to complete. Remember you should NOT be doing this and instead end your turn or do parallel work.

You should NOT wait for subagents to complete. End your turn instead; completions are queued, or do parallel work.

Must pass a task id or wait for a nonzero duration.

Regex awaiting is not available for subagents. Run Await without regex, or await a shell task id instead.

Awaiting subagent tasks requires a non-empty conversationId in the agent context

Awaiting subagent ids is not available in this environment (subagent executor resource is not registered).

Unknown legacy subagent await result

Unhandled legacy subagent result case: ${_exhaustive}

Subagent not found

Failed to await subagent task

Unknown subagent await result

Unhandled subagent await result case: ${_exhaustive}