Get the status and recent output of the specified repo's child agent in a Polygraph session from the configured Polygraph URL.
Use this to monitor progress of a delegated task; repo is required (no session-wide listing) — call once per repo you are watching. Repos can run multiple agents under named roles: pass role to inspect a specific agent; omitted = the default role's agent. The child's status field uses ACP lifecycle values: created, in-progress, input-required, permission-required, completed, failed, or cancelled. When status === 'permission-required', read pendingPermission (structured request from the child) and respond by calling allow_agent or deny_agent with the same role — unless your MCP client supports elicitation, in which case the dialog appears automatically. To monitor without sleeping, pass waitForTransitionMs (max 50000): the call then blocks up to that long and resolves immediately when a child's state changes, so poll by calling this tool in a loop with no sleeps in between.
Arguments
Section titled “Arguments”| Name | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | The Polygraph session ID, or a supported Polygraph app session URL. Supported URL paths are /s/<session-id> and /orgs/<org-id>/sessions/<session-id>. URL inputs are normalized to the session ID; the MCP always uses the current Polygraph API configuration. |
repo | string | yes | Repo name or ID whose child agent to check. Required — agent show always targets a single repo's child; there is no session-wide listing. |
role | string | no | Optional role identifying which of the repo's agents to target; omit for the default agent. |
tail | number | no | Number of output lines to return (default 50) |
waitForTransitionMs | number | no | Long-poll: block up to this many milliseconds (max 50000) until a watched child transitions out of a created/in-progress state, resolving immediately on the state change. Children already in a terminal, input-required, or permission-required state return immediately. Omitted or 0 = return current status immediately (previous behavior). To watch for completion, call this tool in a loop with waitForTransitionMs set and NO sleeps in between — each call blocks server-side until something changes or the timeout elapses. |