Long-polls a perspective-design job (started by perspective_create, perspective_respond, or perspective_update) and returns either its terminal result or another "pending" envelope to keep polling.
Behavior:
- Read-only — observes a running design job. Safe to call repeatedly.
- Errors with "Unknown job_id" if no such job exists, or "job_id does not belong to a perspective design workflow" if the id is for a different kind of job. Workspace and perspective access are re-checked on every call.
- Each call blocks up to wait_ms (default 30s, min 1s, max 45s). On timeout, returns status "pending" with a progress_cursor — pass it back on the next call to skip already-seen progress events.
- Terminal status is "ready" (outline generated; share_url/direct_url/preview_url populated) or "needs_input" (follow_up_question populated). Failures surface as "Design job failed: ..." with the underlying message.
When to use this tool:
- Immediately after perspective_create / perspective_respond / perspective_update returns a job_id.
- Re-polling after a previous call returned status "pending" (pass the returned progress_cursor back).
When NOT to use this tool:
- You don't have a job_id yet — call perspective_create / perspective_respond / perspective_update first.
- Inspecting a finished perspective's config — use perspective_get.
Connector