Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt

Use this file to discover all available pages before exploring further.

Blocks until an agent reaches a target lifecycle phase. Returns the agent’s full status when the phase is reached. Equivalent to murmur wait in the CLI. When phase is omitted, waits until the agent reaches any phase that needs attention (e.g. task-complete, idle, failed). When phase is specified, waits for that exact phase.

​
Parameters

NameTypeRequiredDescription
slugstringyesAgent task slug to wait on. Use an absolute path like /w/workspace/u/account/slug to target an agent outside your own path.
phasestringnoPhase to wait for (e.g. task-complete, running, idle). Defaults to any phase needing attention.
workspacestringnoWorkspace name. Overrides the session default.

​
Response

Returns the agent’s full status as a JSON object when the target phase is reached. The response format is identical to status.
FieldTypeDescription
agentIdobjectThe agent’s identity — tenant, account, workspace, slug path.
phasestringCurrent lifecycle phase (e.g. PHASE_TASK_COMPLETE).
vmobjectVM instance name, project, zone.
vmStoppedbooleantrue when the VM is stopped (sleeping).
versionstringThe murmur version running on the VM.
progressobjectLatest progress update — label, detail, timestamp.
outputobjectAgent output — response text, prs array, commits count, cost in USD.

​
Examples

​
Wait for any phase needing attention

{
  "slug": "fix-auth"
}
Response: 
{
  "agentId": {
    "tenant": {"provider": "PROVIDER_GITHUB_OAUTH", "org": "alice"},
    "ownerProvider": "PROVIDER_GITHUB_OAUTH",
    "account": "alice",
    "workspace": "backend",
    "agent": ["fix-auth"]
  },
  "phase": "PHASE_TASK_COMPLETE",
  "output": {"prs": [{"url": "https://github.com/org/repo/pull/42"}], "cost": 1.23}
}

​
Wait for a specific phase

{
  "slug": "fix-auth",
  "phase": "task-complete"
}

​
Wait on an agent in another workspace

{
  "slug": "/w/platform/u/alice/deploy-v2",
  "phase": "idle"
}

​
Errors

CodeMeaningWhat to do
NOT_FOUNDNo agent with that slug exists.Check the slug. Use ls to see running agents.
INVALID_ARGUMENTUnknown phase value.Check the phase string. Valid values: task-complete, running, idle, failed.
UNAUTHENTICATEDIdentity token is missing or expired.Check credentials.
  • murmur wait — equivalent CLI command
  • status — check agent state without blocking
  • spawn — create an agent
  • ls — list running agents
  • queue_add — send follow-up after wait completes