ap-prompt-agent

Prompt a Live Agent Session

When to use

You already have a running session (from ap-spawn-agent) and need to send it more instructions, redirect it mid-turn, change its model/effort/posture on the fly, or manage a backlog of prompts queued while it was busy.

MCP tool: agent_prompt

{
  "tool": "agent_prompt",
  "args": {
    "sessionId": "sess_5f9a3c38",
    "prompt": "Also add a changelog entry for the validation fix.",
    "interrupt": false
  }
}

By default, interrupt:false and a prompt sent while the session is mid-turn is queued (FIFO) and dispatched automatically once the current turn ends — fan-in bursts are delivered in order instead of rejected. Pass interrupt:true to cancel the in-flight turn and redirect the same session immediately instead of waiting for the queue:

{
  "tool": "agent_prompt",
  "args": {
    "sessionId": "sess_5f9a3c38",
    "prompt": "Stop — scope changed, only fix the email check, skip the password change.",
    "interrupt": true
  }
}

Prompt or message?

agent_prompt DRIVES a session (it's a delegation action). To talk to a tree neighbour — answer your child's blocker, send your parent a result — send a typed message instead: the daemon attests you as the sender, the recipient sees it as an <agentproto-message> block (never as the user), and it's routed by urgency.

{ "tool": "message_send", "args": { "to": "sess_5f9a3c38", "text": "Use branch main.", "kind": "report" } }
{ "tool": "message_reply", "args": { "replyTo": "msg_3f2a91c0", "text": "Approved — go ahead." } }
{ "tool": "message_parent", "args": { "message": "Tests pass, PR opened.", "kind": "done" } }

urgency	busy recipient gets it…
fyi	inbox only (no wake)
next-turn (default for report/done/notice)	as its own turn when the current one ends
steer (default for blocker/question)	injected into its running turn, if its agent supports steering (steering: true in session_list) — else next-turn
interrupt	cancels its turn — only if the operator allows it (defaults.messaging.agentInterrupt), else steer