Handoff — shareable agent result pages + human-in-the-loop approval gates

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}

{'type': 'object', 'required': ['gate_id'], 'properties': {'gate_id': {'type': 'string'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number'}}}

{'type': 'object', 'required': ['content'], 'properties': {'slug': {'type': 'string', 'description': 'Optional stable name for a page you intend to keep updating (e.g. "deploy-status", "nightly-report"). Re-publishing with the same slug updates that same page in place at the same URL. Perfect for a fresh-context agent that can\'t remember a generated id — just reuse the slug. Omit for a one-off page with a random id.'}, 'title': {'type': 'string', 'description': 'Page title (shown at top and in the browser tab).'}, 'format': {'enum': ['markdown', 'text'], 'type': 'string', 'description': 'How to render content. Default markdown.'}, 'content': {'type': 'string', 'description': 'The page body. Markdown is supported (headings, lists, links, code, bold/italic, blockquotes).'}}}

{'type': 'object', 'required': ['question'], 'properties': {'detail': {'type': 'string', 'description': 'Optional context shown under the question — a diff summary, what will happen, links. Markdown supported.'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The choices (2-6). Default ["approve","deny"].'}, 'question': {'type': 'string', 'description': 'The decision to put to the human, phrased as a clear question (e.g. "Deploy build 1a2b to production?").'}, 'notify_url': {'type': 'string', 'description': "Optional https webhook. Handoff POSTs a JSON payload to it when the gate is created ({event:'gate.created', gate_url, question, options, expires_at}) and again when a human answers or it auto-resolves ({event:'gate.answered', answer, status}). Point this at a push/notification channel so the human is alerted to the pending decision instead of you having to deliver the link yourself. Best-effort, https only."}, 'safe_default': {'type': 'string', 'description': 'Which option to auto-pick if no one answers before expiry. Default = the last/most-conservative option.'}, 'expires_in_seconds': {'type': 'number', 'description': 'How long the gate stays open before auto-resolving to safe_default. Default 86400 (24h), max 30 days.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'title': {'type': 'string'}, 'content': {'type': 'string'}}}