{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "urn:vibeke:api:vibeke/1", "title": "Vibeke control API", "description": "Generated from the schema registry in crates/vk-server/src/api_schema.rs. Methods are JSON-RPC 2.0 over newline-delimited JSON on the session socket; see x-transport.", "x-api": "vibeke/1", "x-transport": { "framing": "one JSON object per line (\\n); split on \\n only", "max_line_bytes": 16777216, "jsonrpc": "2.0", "socket": "$VIBEKE_RUNTIME_DIR//vibeke.sock (default session: default)", "handshake": "client.hello (optional; pane tokens go in params.token)" }, "$defs": { "AgentRun": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pane": { "type": "string" }, "harness": { "type": "string" }, "harness_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "integration": { "type": "string" }, "harness_session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "transcript_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "resume_argv": { "type": "array", "items": { "type": "string" } }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "execution": { "$ref": "#/$defs/Facet" }, "health": { "type": "string" }, "yolo": { "type": "boolean" }, "permission_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_tool": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "turns_completed": { "type": "integer" }, "done_rev": { "type": "integer" }, "started_at_ms": { "type": "integer" }, "ended_at_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "capabilities": { "type": "array", "items": { "type": "string" } }, "usage": { "$ref": "#/$defs/RunUsage" }, "rate_limit": { "anyOf": [ { "$ref": "#/$defs/RateLimitInfo" }, { "type": "null" } ] } }, "required": [ "id", "handle", "name", "pane", "harness", "harness_version", "integration", "harness_session_id", "transcript_path", "resume_argv", "cwd", "model", "task", "execution", "health", "yolo", "permission_mode", "last_message", "last_tool", "turns_completed", "done_rev", "started_at_ms", "ended_at_ms", "capabilities" ] }, "AgentState": { "type": "string", "enum": [ "starting", "working", "idle", "error", "rate_limited", "exited", "unknown" ] }, "AgentSummary": { "type": "object", "properties": { "working": { "type": "integer" }, "needs_input": { "type": "integer" }, "done": { "type": "integer" }, "idle": { "type": "integer" } }, "required": [ "working", "needs_input", "done", "idle" ] }, "Answer": { "type": "object", "properties": { "decision": { "anyOf": [ { "const": "allow" }, { "const": "allow_always" }, { "const": "deny" }, { "type": "string" }, { "type": "null" } ] }, "choices": { "type": "array", "items": {} }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "decision" ] }, "Appearance": { "type": "object", "properties": { "known": { "type": "boolean" }, "dark": { "type": "boolean" }, "mode": { "type": "string" }, "theme": { "type": "string" }, "source": { "type": "string" } }, "required": [ "known", "dark", "mode", "theme", "source" ] }, "BrowserPane": { "type": "object", "properties": { "url": { "type": "string" }, "machine": { "type": "string" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "history": { "type": "array", "items": { "type": "string" } }, "history_index": { "type": "integer" }, "title": { "type": "string" }, "watch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "device": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "url", "machine", "task", "preview", "source_pane", "history", "history_index", "title" ] }, "BrowserSession": { "type": "object", "properties": { "session": { "type": "string" }, "session_id": { "type": "string" }, "owner": { "anyOf": [ { "type": "object", "properties": { "pane": { "type": "string" }, "pane_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pane", "pane_handle", "run" ] }, { "type": "object", "properties": { "user": { "type": "string" } }, "required": [ "user" ] } ] }, "preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "created_ms": { "type": "integer" }, "viewport": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] }, "device": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "previews": { "type": "string", "enum": [ "own", "machine" ] }, "human_control": { "type": "boolean" }, "screencast": { "type": "boolean" }, "proxy_port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "machine": { "type": "string" }, "environment": { "type": "object", "properties": { "kind": { "type": "string" }, "machine": { "type": "string" }, "runner": { "type": "string" }, "browser": {}, "fresh_context": { "type": "boolean" }, "device": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "viewport": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] }, "dpr": { "type": "number" } }, "required": [ "kind", "machine", "runner", "browser", "fresh_context", "device", "viewport", "dpr" ] }, "status": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "final_url": { "type": "string" }, "title": { "type": "string" } }, "required": [ "session", "session_id", "owner", "preview", "url", "created_ms", "viewport", "device", "previews", "human_control", "screencast", "proxy_port", "machine", "environment" ] }, "ConfigDiagnostic": { "type": "object", "properties": { "line": { "type": "integer" }, "col": { "type": "integer" }, "message": { "type": "string" } }, "required": [ "line", "col", "message" ] }, "ConfigWarning": { "type": "object", "properties": { "key": { "type": "string" }, "line": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "col": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "message": { "type": "string" } }, "required": [ "key", "line", "col", "message" ] }, "Cursor": { "type": "object", "properties": { "machine_uuid": { "type": "string" }, "session_uuid": { "type": "string" }, "log_epoch": { "type": "string" }, "seq": { "type": "integer" } }, "required": [ "machine_uuid", "session_uuid", "log_epoch", "seq" ] }, "Event": { "type": "object", "properties": { "seq": { "type": "integer" }, "ts": { "type": "integer" }, "v": { "type": "integer" }, "tier": { "type": "string", "enum": [ "sync", "history" ] }, "type": { "type": "string" }, "subject": { "type": "object" }, "actor": { "type": "object" }, "data": {} }, "required": [ "seq", "ts", "v", "tier", "type", "subject", "actor", "data" ] }, "Facet": { "type": "object", "properties": { "value": { "type": "string" }, "since_ms": { "type": "integer" }, "source": { "type": "string" }, "confidence": { "type": "number" }, "detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "value", "since_ms", "source", "confidence", "detail" ] }, "FloatingPane": { "type": "object", "properties": { "pane": { "type": "string" }, "x": { "type": "number" }, "y": { "type": "number" }, "w": { "type": "number" }, "h": { "type": "number" }, "z": { "type": "integer" } }, "required": [ "pane", "x", "y", "w", "h", "z" ] }, "Group": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "name": { "type": "string" }, "parent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "collapsed": { "type": "boolean" }, "order": { "type": "number" }, "workspaces": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "handle", "name", "parent", "collapsed", "order", "workspaces" ] }, "Interaction": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "run": { "type": "string" }, "pane": { "type": "string" }, "kind": { "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" }, "body_md": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "action": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "questions": { "type": "array", "items": { "type": "object" } }, "plan_md": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "answer_channel": { "type": "string" }, "native_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" }, "confidence": { "type": "number" }, "answerable": { "type": "boolean" }, "gate": { "type": "boolean" }, "decision_rev": { "type": "integer" }, "delivery": { "type": "string" }, "delivery_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "answer": { "anyOf": [ { "$ref": "#/$defs/Answer" }, { "type": "null" } ] }, "answered_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "answer_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "opened_at_ms": { "type": "integer" }, "answered_at_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "id", "handle", "run", "pane", "kind", "status", "title", "body_md", "action", "questions", "plan_md", "answer_channel", "native_ref", "source", "confidence", "answerable", "gate", "decision_rev", "delivery", "delivery_error", "answer", "answered_by", "opened_at_ms", "answered_at_ms" ] }, "Isolation": { "type": "object", "properties": { "level": { "$ref": "#/$defs/IsolationLevel" }, "provider": { "type": "string" }, "network": { "type": "string" }, "yolo": { "type": "boolean" }, "scope": { "type": "string" }, "visible_roots": { "type": "array", "items": { "type": "string" } } }, "required": [ "level", "provider", "network", "yolo", "scope", "visible_roots" ] }, "IsolationLevel": { "type": "string", "enum": [ "host", "sandbox", "container", "vm" ] }, "LayoutNode": { "anyOf": [ { "type": "object", "properties": { "Leaf": { "type": "object", "properties": { "pane": { "type": "string" } }, "required": [ "pane" ] } }, "required": [ "Leaf" ] }, { "type": "object", "properties": { "Split": { "type": "object", "properties": { "dir": { "type": "string", "enum": [ "Horizontal", "Vertical" ] }, "children": { "type": "array", "items": {} } }, "required": [ "dir", "children" ] } }, "required": [ "Split" ] } ] }, "LayoutSpec": { "type": "object" }, "MaterializedFile": { "type": "object", "properties": { "path": { "type": "string" }, "outcome": { "type": "string", "enum": [ "copied", "linked", "cloned", "missing", "exists", "rejected", "failed" ] }, "method": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "path", "outcome" ] }, "Notification": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "type": "string" }, "body": { "type": "string" }, "urgency": { "type": "string" }, "created_at_ms": { "type": "integer" }, "read": { "type": "boolean" }, "channels": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "kind", "pane", "title", "body", "urgency", "created_at_ms", "read" ] }, "Pane": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "auto_title": { "type": "string" }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cols": { "type": "integer" }, "rows": { "type": "integer" }, "child_pid": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "fg_cmdline": { "type": "array", "items": { "type": "string" } }, "exited": { "type": "boolean" }, "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "unread": { "type": "boolean" }, "marked_unread": { "type": "boolean" }, "pinned": { "type": "boolean" }, "created_by": { "type": "string" }, "recovered": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "isolation": { "$ref": "#/$defs/Isolation" }, "browser": { "anyOf": [ { "$ref": "#/$defs/BrowserPane" }, { "type": "null" } ] } }, "required": [ "id", "handle", "tab", "workspace", "title", "auto_title", "cwd", "cols", "rows", "child_pid", "fg_cmdline", "exited", "exit_code", "unread", "marked_unread", "pinned", "created_by", "recovered" ] }, "PaneLive": { "type": "object", "properties": { "pane": { "type": "string" }, "progress": { "anyOf": [ { "type": "object", "properties": { "state": { "type": "string", "enum": [ "normal", "error", "indeterminate", "paused" ] }, "pct": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "state", "pct" ] }, { "type": "null" } ] }, "last_exit": { "anyOf": [ { "type": "object", "properties": { "code": { "type": "integer" }, "at_ms": { "type": "integer" } }, "required": [ "code", "at_ms" ] }, { "type": "null" } ] }, "user_vars": { "type": "array", "items": { "type": "array", "items": { "type": "string" } } } }, "required": [ "pane", "progress", "last_exit", "user_vars" ] }, "PolicyRule": { "type": "object" }, "PrLookup": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "pr", "no_pr", "unavailable" ] }, "pr": { "type": "object", "properties": { "number": { "type": "integer" }, "state": { "type": "string" }, "is_draft": { "type": "boolean" }, "review_decision": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checks": { "type": "string", "enum": [ "none", "pending", "passing", "failing" ] }, "url": { "type": "string" }, "label": { "type": "string" } }, "required": [ "number", "state", "is_draft", "review_decision", "checks", "url", "label" ] }, "reason": { "type": "string" } }, "required": [ "kind" ] }, "Preview": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "machine": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "port": { "type": "integer" }, "path": { "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "scheme": { "type": "string" }, "status": { "type": "string", "enum": [ "suggested", "declared", "up", "down", "gone" ] }, "source": { "type": "string", "enum": [ "declared", "listener", "output_url", "banner" ] }, "pid": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "first_seen_ms": { "type": "integer" }, "last_seen_ms": { "type": "integer" }, "pane_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "handle", "machine", "pane", "task", "port", "path", "label", "url", "scheme", "status", "source", "pid", "first_seen_ms", "last_seen_ms" ] }, "PreviewCa": { "type": "object", "properties": { "path": { "type": "string" }, "sha256": { "type": "string" }, "spki_sha256": { "type": "string" }, "trust": { "type": "string" } }, "required": [ "path", "sha256", "spki_sha256", "trust" ] }, "PreviewMirror": { "type": "object", "properties": { "machine": { "type": "string" }, "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "local_port": { "type": "integer" }, "addrs": { "type": "array", "items": { "type": "string" } }, "since_ms": { "type": "integer" }, "accepted": { "type": "integer" }, "rejected": { "type": "integer" }, "authenticated": { "type": "boolean" }, "peer_check": { "const": "same_user" } }, "required": [ "machine", "preview", "preview_handle", "local_port", "addrs", "since_ms", "accepted", "rejected", "authenticated", "peer_check" ] }, "RateLimitInfo": { "type": "object", "properties": { "limited": { "type": "boolean" }, "resets_at_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "used_percent": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "observed_at_ms": { "type": "integer" } }, "required": [ "limited", "resets_at_ms", "scope", "used_percent", "message", "observed_at_ms" ] }, "RpcError": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "$ref": "#/$defs/RpcErrorData" } }, "required": [ "code", "message", "data" ] }, "RpcErrorData": { "type": "object", "properties": { "kind": { "type": "string" }, "details": {}, "retryable": { "type": "boolean" } }, "required": [ "kind", "retryable" ] }, "RunUsage": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "cache_read_tokens": { "type": "integer" }, "cache_write_tokens": { "type": "integer" }, "cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" }, "updated_at_ms": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens", "cache_read_tokens", "cache_write_tokens", "cost_usd", "model", "source", "updated_at_ms" ] }, "ScreenshotMeta": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "workspace": { "type": "string" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "preview": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mime": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "ts": { "type": "integer" }, "blob": { "type": "string" }, "environment": { "type": "object" }, "code": { "type": "object" } }, "required": [ "id" ] }, "SessionEntry": { "type": "object", "properties": { "name": { "type": "string" }, "running": { "type": "boolean" }, "socket": { "type": "string" }, "state": { "type": "string" }, "current": { "type": "boolean" }, "pid": { "type": "integer" } }, "required": [ "name", "running", "socket", "state", "current" ] }, "Tab": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "workspace": { "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "number": { "type": "integer" }, "layout": { "$ref": "#/$defs/LayoutNode" }, "focused_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "zoomed_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "order": { "type": "number" }, "floating": { "type": "array", "items": { "$ref": "#/$defs/FloatingPane" } }, "floats_hidden": { "type": "boolean" } }, "required": [ "id", "handle", "workspace", "title", "number", "layout", "focused_pane", "zoomed_pane", "order" ] }, "Target": { "type": "string" }, "Task": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "title": { "type": "string" }, "slug": { "type": "string" }, "workspace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_root": { "type": "string" }, "worktree_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "base_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "port_range": { "anyOf": [ { "type": "array", "items": { "type": "integer" } }, { "type": "null" } ] }, "status": { "type": "string" }, "setup_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at_ms": { "type": "integer" }, "ownership": { "type": "string", "enum": [ "owned", "attached" ] }, "owner_machine": { "type": "string" }, "intent_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "rev": { "type": "integer" }, "review_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effort": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "isolation": { "$ref": "#/$defs/Isolation" }, "checkout": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rate_limit": { "anyOf": [ { "$ref": "#/$defs/RateLimitInfo" }, { "type": "null" } ] } }, "required": [ "id", "handle", "title", "slug", "workspace", "repo_root", "worktree_path", "branch", "base_ref", "port_range", "status", "setup_status", "created_at_ms" ] }, "Workspace": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "auto_name": { "type": "string" }, "root_path": { "type": "string" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "order": { "type": "number" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "handle", "name", "auto_name", "root_path", "task", "order", "branch" ] } }, "x-methods": { "adapter.delivery_ack": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Target" }, "idempotency_key": { "type": "string" }, "applied": { "type": "boolean" } }, "required": [ "interaction", "idempotency_key" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "adapter.gate": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "harness": { "type": "string" }, "event": { "type": "string" }, "payload": {}, "pid": { "type": "integer" } }, "required": [ "harness", "event" ] }, "result": { "type": "object", "properties": { "decision": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "interaction": { "$ref": "#/$defs/Target" }, "idempotency_key": { "type": "string" }, "mode": { "const": "observe" }, "resumed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "decision" ] } }, "adapter.report_self": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "pane_id": { "$ref": "#/$defs/Target" }, "source": { "type": "string", "default": "vibeke" }, "seq": { "type": "integer" }, "agent": { "type": "string" }, "harness": { "type": "string" }, "state": { "anyOf": [ { "const": "idle" }, { "const": "working" }, { "const": "blocked" }, { "const": "done" }, { "type": "string" } ] }, "message": { "type": "string" }, "resume_argv": { "type": "array", "items": { "type": "string" } } }, "required": [ "state" ] }, "result": { "type": "object", "properties": { "type": { "const": "ok" }, "dropped": { "const": "stale_seq" }, "applied": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "type" ] } }, "adapter.signal": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "harness": { "type": "string" }, "event": { "type": "string" }, "payload": {}, "pid": { "type": "integer" } }, "required": [ "harness", "event" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "agent.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" } }, "required": [ "target" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "pane": { "$ref": "#/$defs/Pane" }, "open_interactions": { "type": "array", "items": { "$ref": "#/$defs/Interaction" } }, "last_turn": {} }, "required": [ "run", "pane", "open_interactions" ] } }, "agent.harnesses": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "harnesses": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "display": { "type": "string" }, "version_detected": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "integration_installed": { "type": "boolean" }, "capabilities": { "type": "array", "items": { "type": "string" } } }, "required": [ "id" ] } } }, "required": [ "harnesses" ] } }, "agent.interrupt": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" } }, "required": [ "target" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "run" ] } }, "agent.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "state": { "type": "array", "items": { "$ref": "#/$defs/AgentState" } }, "harness": { "type": "string" } } }, "result": { "type": "object", "properties": { "runs": { "type": "array", "items": { "$ref": "#/$defs/AgentRun" } } }, "required": [ "runs" ] } }, "agent.manifests": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "manifests": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "source": { "type": "string" }, "family": { "type": "string" }, "transports": { "type": "array", "items": { "type": "string" } }, "validated_range": {}, "capabilities_unversioned": {}, "capabilities_unverified": {}, "detects": { "type": "boolean" }, "screen_rules": { "type": "boolean" }, "warnings": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "source", "family", "transports", "validated_range", "capabilities_unversioned", "capabilities_unverified", "detects", "screen_rules", "warnings" ] } }, "warnings": { "type": "array", "items": { "type": "string" } } }, "required": [ "manifests", "warnings" ] } }, "agent.manifests_reload": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "warnings": { "type": "array", "items": { "type": "string" } }, "manifests": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "source": { "type": "string" }, "family": { "type": "string" }, "transports": { "type": "array", "items": { "type": "string" } }, "validated_range": {}, "capabilities_unversioned": {}, "capabilities_unverified": {}, "detects": { "type": "boolean" }, "screen_rules": { "type": "boolean" }, "warnings": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "name", "source", "family", "transports", "validated_range", "capabilities_unversioned", "capabilities_unverified", "detects", "screen_rules", "warnings" ] } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "warnings", "manifests" ] } }, "agent.prompt": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" }, "text": { "type": "string" }, "images": { "type": "array", "items": { "type": "string" } }, "mode": { "type": "string", "enum": [ "send", "steer", "follow_up" ], "default": "send" }, "wait": { "type": "boolean" }, "until": { "type": "array", "items": { "type": "string" } }, "timeout_ms": { "type": "integer" } }, "required": [ "target", "text" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "turn": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "run" ] } }, "agent.read": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" }, "source": { "type": "string", "enum": [ "visible", "recent", "transcript" ], "default": "visible" }, "lines": { "type": "integer" }, "format": { "type": "string", "enum": [ "text", "ansi", "cells" ] } }, "required": [ "target" ] }, "result": { "type": "object", "properties": { "text": { "type": "string" }, "turns": { "type": "array", "items": {} }, "rows": { "type": "integer" }, "revision": { "type": "integer" }, "truncated": { "type": "boolean" } } } }, "agent.release": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" } }, "required": [ "target" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "agent.rename": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "target", "name" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "run" ] } }, "agent.report": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "state": { "type": "string" }, "harness": { "type": "string", "default": "claude" }, "message": { "type": "string" } }, "required": [ "state" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "agent.resumable": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "runs": { "type": "array", "items": { "$ref": "#/$defs/AgentRun" } } }, "required": [ "runs" ] } }, "agent.resume": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "run": { "$ref": "#/$defs/Target" }, "mode": { "type": "string" } }, "required": [ "run" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "run" ] } }, "agent.send_keys": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" }, "keys": { "type": "array", "items": { "type": "string" } } }, "required": [ "target", "keys" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "agent.spawn": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "harness": { "type": "string" }, "name": { "type": "string" }, "where": { "type": "object" }, "prompt": { "type": "string" }, "args": { "type": "array", "items": { "type": "string" } }, "focus": { "type": "boolean", "default": false } }, "required": [ "harness" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "run": { "$ref": "#/$defs/AgentRun" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "run" ] } }, "agent.start": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "harness": { "type": "string" }, "name": { "type": "string" }, "mode": { "type": "string", "enum": [ "tui", "headless" ], "default": "tui" }, "args": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "model": { "type": "string" }, "task": { "$ref": "#/$defs/Target" }, "ready_timeout_ms": { "type": "integer", "default": 30000 } }, "required": [ "harness" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "run" ] } }, "agent.wait": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "target": { "$ref": "#/$defs/Target" }, "until": { "type": "array", "items": { "type": "string" } }, "timeout_ms": { "type": "integer" } }, "required": [ "target" ] }, "result": { "type": "object", "properties": { "run": { "$ref": "#/$defs/AgentRun" }, "state": { "type": "string" }, "interaction": { "$ref": "#/$defs/Interaction" } }, "required": [ "run", "state" ] } }, "api.methods": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "methods": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "mutating": { "type": "boolean" }, "milestone": { "type": "string" }, "capability": { "type": "string" } }, "required": [ "name", "mutating" ] } } }, "required": [ "methods" ] } }, "api.schema": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "method": { "type": "string" } } }, "result": { "type": "object", "properties": { "schema": { "type": "object" } }, "required": [ "schema" ] } }, "assistant.cancel": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "request": { "type": "string" } }, "required": [ "request" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "request" ] } }, "assistant.confirm": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "request": { "type": "string" }, "preview_digest": { "type": "string" } }, "required": [ "request", "preview_digest" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "request" ] } }, "assistant.consent": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "connection": { "type": "string" }, "profile": { "type": "string" }, "classes": { "type": "array", "items": { "type": "string", "enum": [ "selected_text", "structured_state", "review_package", "screen" ] } }, "operations": { "type": "array", "items": { "type": "string" } }, "auto_send": { "type": "array", "items": { "type": "string" } } } }, "result": { "type": "object", "properties": { "consent": { "type": "object" }, "notice": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "consent", "notice" ] } }, "assistant.generate": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "operation": { "type": "string", "enum": [ "suggest_task_details", "review_summary", "pane_title", "briefing", "handoff", "effort_estimate" ] }, "profile": { "type": "string" }, "idempotency_key": { "type": "string" }, "retry_of": { "type": "string" }, "inputs": { "type": "object" }, "run": { "$ref": "#/$defs/Target" }, "turns": { "type": "array", "items": { "type": "integer" } }, "pane": { "$ref": "#/$defs/Target" }, "task": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" }, "include_screen": { "type": "boolean" } }, "required": [ "operation" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" }, "preview": { "type": "object", "properties": { "digest": { "type": "string" }, "system": { "type": "string" }, "user": { "type": "string" }, "model": { "type": "string" }, "adapter": { "type": "string" }, "endpoint_host": { "type": "string" }, "execution_machine": { "type": "string" }, "max_output_tokens": { "type": "integer" }, "bytes": { "type": "integer" }, "estimated_input_tokens": { "type": "integer" }, "estimated_max_cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "sources": { "type": "array", "items": { "type": "object" } }, "omitted": {}, "redactions": {}, "notice": { "type": "string" } }, "required": [ "digest" ] }, "requires_confirmation": { "type": "boolean" }, "confirm_with": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "request", "preview", "requires_confirmation" ] } }, "assistant.get": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "request": { "type": "string" } }, "required": [ "request" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" } }, "required": [ "request" ] } }, "assistant.list": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "state": { "type": "string" }, "limit": { "type": "integer" } } }, "result": { "type": "object", "properties": { "requests": { "type": "array", "items": { "type": "object" } } }, "required": [ "requests" ] } }, "assistant.providers": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "connections": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "adapter": { "type": "string" }, "endpoint": { "type": "string" }, "endpoint_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "credential": { "type": "string" }, "verified": { "type": "boolean" } }, "required": [ "id", "adapter", "endpoint", "credential", "verified" ] } }, "profiles": { "type": "array", "items": { "type": "object" } }, "default_profile": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "connections", "profiles" ] } }, "assistant.purge": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "request": { "type": "string" }, "workspace": { "$ref": "#/$defs/Target" }, "all": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "purged": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "purged" ] } }, "assistant.revoke": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "connection": { "type": "string" } } }, "result": { "type": "object", "properties": { "revoked": { "type": "integer" }, "cancelled_requests": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "revoked", "cancelled_requests" ] } }, "assistant.status": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "configured": { "type": "boolean" }, "config_problem": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "coordinator": { "type": "object", "properties": { "machine": { "type": "string" }, "session": { "type": "string" } }, "required": [ "machine", "session" ] }, "profile": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "limits": { "type": "object" }, "today": { "type": "object", "properties": { "utc_day": { "type": "integer" }, "used": {}, "reserved": {}, "remaining": {} }, "required": [ "utc_day", "used", "reserved", "remaining" ] } }, "required": [ "enabled", "configured" ] } }, "attention.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "budget_ms": { "type": "integer" }, "effort": { "type": "string", "enum": [ "quick", "minutes", "deep" ] } } }, "result": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] }, "class": { "anyOf": [ { "type": "integer" }, { "const": "finished_turns" } ] }, "title": { "type": "string" }, "subtitle": { "type": "string" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "interaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explanation": { "type": "string" }, "age_ms": { "type": "integer" }, "risk": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effort": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "effort_estimate": { "anyOf": [ { "type": "object", "properties": { "effort": { "type": "string" }, "source": { "const": "heuristic" } }, "required": [ "effort", "source" ] }, { "type": "null" } ] }, "blocks_tasks": { "type": "integer" }, "snoozed_until_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "woke_from_snooze": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "urgent": { "type": "boolean" } }, "required": [ "key", "class", "title", "subtitle", "task", "run", "pane", "interaction", "explanation", "age_ms", "risk", "effort", "effort_estimate", "blocks_tasks", "snoozed_until_ms", "woke_from_snooze", "urgent" ] } }, "coverage": { "type": "object", "properties": { "complete": { "type": "boolean" }, "notes": { "type": "array", "items": { "type": "string" } }, "scope": { "anyOf": [ { "const": "all" }, { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] } ] }, "excluded": { "type": "integer" } }, "required": [ "complete", "notes", "scope", "excluded" ] }, "five_minute": { "anyOf": [ { "type": "object", "properties": { "keys": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] } }, "omitted_count": { "type": "integer" }, "note": { "type": "string" }, "item_notes": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] }, "note": { "type": "string" } }, "required": [ "key", "note" ] } } }, "required": [ "keys", "omitted_count", "note", "item_notes" ] }, { "type": "null" } ] } }, "required": [ "items", "coverage", "five_minute" ] } }, "attention.update": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "key": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] }, "seen": { "type": "boolean" }, "item_rev": { "type": "integer" }, "snooze_until_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "pin": { "type": "boolean" } }, "required": [ "key" ] }, "result": { "type": "object", "properties": { "key": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] }, "seen": { "type": "boolean" }, "seen_rev": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "snoozed_until_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "pinned": { "type": "boolean" }, "warning": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "key", "seen", "seen_rev", "snoozed_until_ms", "pinned", "warning" ] } }, "blob.abort": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "upload_id": { "type": "string" } }, "required": [ "upload_id" ] }, "result": { "type": "object", "properties": { "aborted": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "aborted" ] } }, "blob.append": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "upload_id": { "type": "string" }, "offset": { "type": "integer" }, "data_b64": { "type": "string" } }, "required": [ "upload_id", "offset", "data_b64" ] }, "result": { "type": "object", "properties": { "offset": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "offset" ] } }, "blob.begin": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "name": { "type": "string" }, "size": { "type": "integer" }, "sha256": { "type": "string" } }, "required": [ "name", "size" ] }, "result": { "type": "object", "properties": { "upload_id": { "type": "string" }, "max_chunk": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "upload_id", "max_chunk" ] } }, "blob.commit": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "upload_id": { "type": "string" }, "stage": { "const": "browser" }, "unpack": { "const": "tar" } }, "required": [ "upload_id" ] }, "result": { "type": "object", "properties": { "hash": { "type": "string" }, "sha256": { "type": "string" }, "size": { "type": "integer" }, "path_on_machine": { "type": "string" }, "path": { "type": "string" }, "unpacked": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "hash", "sha256", "size", "path_on_machine", "path" ] } }, "blob.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "hash": { "type": "string" }, "range": { "type": "object", "properties": { "offset": { "type": "integer" }, "length": { "type": "integer" } } } }, "required": [ "hash" ] }, "result": { "type": "object", "properties": { "hash": { "type": "string" }, "mime": { "type": "string" }, "size": { "type": "integer" }, "offset": { "type": "integer" }, "length": { "type": "integer" }, "data_b64": { "type": "string" } }, "required": [ "hash", "mime", "size", "offset", "length", "data_b64" ] } }, "blob.put": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "mime": { "type": "string" }, "data_b64": { "type": "string" }, "path": { "type": "string" } }, "required": [ "mime" ] }, "result": { "type": "object", "properties": { "hash": { "type": "string" }, "size": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "hash", "size" ] } }, "blob.stat": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "hash": { "type": "string" } }, "required": [ "hash" ] }, "result": { "type": "object", "properties": { "hash": { "type": "string" }, "mime": { "type": "string" }, "size": { "type": "integer" }, "created_at": { "type": "integer" }, "refs": { "type": "integer" }, "path": { "type": "string" } }, "required": [ "hash", "mime", "size", "created_at", "refs", "path" ] } }, "browser.attach_screencast": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "delivery": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "poll": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "delivery", "width", "height", "poll" ] } }, "browser.click": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "selector": { "type": "string" }, "text": { "type": "string" }, "x": { "type": "number" }, "y": { "type": "number" }, "click_count": { "type": "integer", "default": 1 }, "timeout_ms": { "type": "integer", "default": 5000 } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "x": { "type": "number" }, "y": { "type": "number" }, "element": { "anyOf": [ { "type": "object", "properties": { "x": { "type": "number" }, "y": { "type": "number" }, "width": { "type": "number" }, "height": { "type": "number" }, "tag": { "type": "string" }, "text": { "type": "string" } }, "required": [ "x", "y", "width", "height", "tag", "text" ] }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "x", "y", "element" ] } }, "browser.close": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "closed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "closed" ] } }, "browser.command": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "cmd": { "type": "string", "enum": [ "back", "forward", "reload", "stop", "navigate", "screenshot", "text", "window", "pane" ] }, "url": { "type": "string" }, "hard": { "type": "boolean" }, "text": { "type": "string" } }, "required": [ "pane", "cmd" ] }, "result": { "anyOf": [ { "type": "object", "properties": { "pane": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] }, { "type": "object", "properties": { "pane": { "type": "string" }, "profile": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "profile" ] }, { "type": "object", "properties": { "opened_in": { "const": "window" }, "url": { "type": "string" }, "machine": { "type": "string" }, "profile": { "type": "string" }, "profile_dir": { "type": "string" }, "browser": { "type": "string" }, "browser_kind": { "type": "string" }, "pid": { "type": "integer" }, "reused": { "type": "boolean" }, "socks_port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "route": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "url", "machine", "profile", "profile_dir", "browser", "browser_kind", "pid", "reused", "socks_port", "route" ] }, { "type": "object", "properties": { "opened_in": { "const": "default_browser" }, "url": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "url" ] }, { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } ] } }, "browser.console": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "anyOf": [ { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "level": { "type": "string", "enum": [ "error", "warn", "warning", "all" ] }, "since_ms": { "type": "integer" }, "since": { "type": "string" }, "limit": { "type": "integer", "default": 200 } } }, { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "kind": { "type": "string", "enum": [ "all", "console", "network" ] }, "level": { "type": "string" }, "errors": { "type": "boolean" }, "failed": { "type": "boolean" }, "failed_only": { "type": "boolean" }, "after": { "type": "integer" }, "since_ms": { "type": "integer" }, "since": { "type": "string" }, "limit": { "type": "integer" } }, "required": [ "pane" ] } ] }, "result": { "anyOf": [ { "type": "object", "properties": { "session": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "ts": { "type": "integer" }, "level": { "type": "string" }, "text": { "type": "string" }, "source": { "type": "string" }, "url": {}, "line": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "ts", "level", "text", "source" ] } } }, "required": [ "session", "entries" ] }, { "type": "object", "properties": { "pane": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } }, "last_seq": { "type": "integer" }, "source": { "type": "string", "enum": [ "local", "relayed", "none" ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pane", "entries", "last_seq", "source", "url" ] } ] } }, "browser.detach_screencast": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "detached": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "detached" ] } }, "browser.diff": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "a": { "type": "string" }, "b": { "type": "string" }, "threshold": { "anyOf": [ { "type": "number" }, { "type": "string" } ], "default": 0.1 }, "force": { "type": "boolean" }, "inline": { "type": "boolean" } }, "required": [ "a", "b" ] }, "result": { "type": "object", "properties": { "a": { "type": "object" }, "b": { "type": "object" }, "threshold": { "type": "number" }, "channel_threshold": {}, "width": { "type": "integer" }, "height": { "type": "integer" }, "size_mismatch": { "type": "boolean" }, "a_size": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] }, "b_size": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] }, "changed_pixels": { "type": "integer" }, "total_pixels": { "type": "integer" }, "changed_ratio": { "type": "number" }, "regions": { "type": "array", "items": { "type": "object", "properties": { "x": { "type": "integer" }, "y": { "type": "integer" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "pixels": { "type": "integer" } }, "required": [ "x", "y", "width", "height", "pixels" ] } }, "regions_total": { "type": "integer" }, "forced": { "type": "boolean" }, "blob": { "type": "string" }, "path_on_machine": { "type": "string" }, "bytes": { "type": "integer" }, "data_b64": { "type": "string" }, "mime": { "type": "string" }, "inline_skipped": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "a", "b", "threshold", "channel_threshold", "width", "height", "size_mismatch", "a_size", "b_size", "changed_pixels", "total_pixels", "changed_ratio", "regions", "regions_total", "forced", "blob", "path_on_machine", "bytes" ] } }, "browser.dom": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "format": { "type": "string", "enum": [ "a11y", "accessibility", "text", "html" ], "default": "a11y" }, "max_bytes": { "type": "integer" }, "selector": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "url": { "type": "string" }, "format": { "type": "string" }, "content": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "session", "url", "format", "content", "truncated" ] } }, "browser.eval": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "expression": { "type": "string" }, "js": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "value": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "value" ] } }, "browser.install": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "confirm": { "type": "boolean" }, "version": { "type": "string" }, "url": { "type": "string" }, "sha256": { "type": "string" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "plan": { "type": "object", "properties": { "version": { "type": "string" }, "platform": { "type": "string" }, "url": { "type": "string" }, "sha256": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "checksum_known": { "type": "boolean" }, "dir": { "type": "string" }, "binary": { "type": "string" }, "installed": { "type": "boolean" } }, "required": [ "version", "platform", "url", "sha256", "checksum_known", "dir", "binary", "installed" ] }, "confirm_required": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "plan", "confirm_required" ] }, { "type": "object", "properties": { "installed": { "type": "boolean" }, "binary": { "type": "string" }, "plan": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "installed", "binary", "plan" ] } ] } }, "browser.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "type": "object" } }, "browser": { "type": "object" }, "machine": { "type": "string" } }, "required": [ "sessions", "browser", "machine" ] } }, "browser.navigate": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "url": { "type": "string" }, "path": { "type": "string" }, "wait": { "anyOf": [ { "const": "load" }, { "const": "domcontentloaded" }, { "const": "commit" }, { "const": "none" }, { "type": "string" } ], "default": "load" }, "timeout_ms": { "type": "integer", "default": 15000 } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "status": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "final_url": { "type": "string" }, "title": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "status", "final_url", "title" ] } }, "browser.network": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "anyOf": [ { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "failed_only": { "type": "boolean" }, "failed": { "type": "boolean" }, "since_ms": { "type": "integer" }, "since": { "type": "string" }, "limit": { "type": "integer", "default": 200 } } }, { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "kind": { "type": "string", "enum": [ "all", "console", "network" ] }, "level": { "type": "string" }, "errors": { "type": "boolean" }, "failed": { "type": "boolean" }, "failed_only": { "type": "boolean" }, "after": { "type": "integer" }, "since_ms": { "type": "integer" }, "since": { "type": "string" }, "limit": { "type": "integer" } }, "required": [ "pane" ] } ] }, "result": { "anyOf": [ { "type": "object", "properties": { "session": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "ts": { "type": "integer" }, "method": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "type": "string" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "mime": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "blocked_reason": { "type": "string" }, "blocked_by_policy": { "type": "string" }, "layer": { "type": "string" }, "duration_ms": { "type": "integer" } }, "required": [ "ts", "type" ] } } }, "required": [ "session", "entries" ] }, { "type": "object", "properties": { "pane": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object" } }, "last_seq": { "type": "integer" }, "source": { "type": "string", "enum": [ "local", "relayed", "none" ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pane", "entries", "last_seq", "source", "url" ] } ] } }, "browser.open": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "url": { "type": "string" }, "preview": { "type": "string" }, "machine": { "type": "string" }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" }, "w": { "type": "integer" }, "h": { "type": "integer" } } } ] }, "dpr": { "type": "number" }, "color_scheme": { "type": "string" }, "dark": { "type": "boolean" }, "wait": { "type": "string" }, "timeout_ms": { "type": "integer" } } }, "result": { "$ref": "#/$defs/BrowserSession" } }, "browser.pane.console": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "toggle": { "type": "boolean", "default": true }, "focus": { "type": "boolean", "default": false } } }, "result": { "anyOf": [ { "type": "object", "properties": { "closed": { "type": "string" }, "pane_handle": { "type": "string" }, "browser_pane": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "closed", "pane_handle", "browser_pane" ] }, { "type": "object", "properties": { "pane": { "type": "string" }, "pane_handle": { "type": "string" }, "browser_pane": { "type": "string" }, "existing": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "pane_handle", "browser_pane" ] } ] } }, "browser.pane.console_push": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "entries": { "type": "array", "items": { "type": "object" } } }, "required": [ "pane", "entries" ] }, "result": { "type": "object", "properties": { "pane": { "type": "string" }, "stored": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "stored" ] } }, "browser.pane.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "url": { "type": "string" }, "split": { "type": "string", "enum": [ "right", "down", "left", "up", "tab", "float" ], "default": "right" }, "pane": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] } ] }, "fit": { "type": "boolean" }, "focus": { "type": "boolean", "default": true }, "focus_client": { "type": "string" } } }, "result": { "type": "object", "properties": { "opened_in": { "const": "pane" }, "pane": { "type": "string" }, "pane_handle": { "type": "string" }, "tab": { "type": "string" }, "url": { "type": "string" }, "machine": { "type": "string" }, "source_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "pane", "pane_handle", "tab", "url", "machine", "source_pane" ] } }, "browser.pane.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "panes": { "type": "array", "items": { "type": "object", "properties": { "pane": { "type": "string" }, "handle": { "type": "string" }, "tab": { "type": "string" }, "browser": { "$ref": "#/$defs/BrowserPane" } }, "required": [ "pane", "handle", "tab", "browser" ] } } }, "required": [ "panes" ] } }, "browser.pane.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "browsers": { "type": "array", "items": { "type": "object", "properties": { "profile": { "type": "string" }, "dpr": { "type": "number" }, "pid": { "type": "integer" }, "targets": { "type": "integer" }, "up_ms": { "type": "integer" } }, "required": [ "profile", "dpr", "targets", "up_ms" ] } }, "targets": { "type": "array", "items": { "type": "object", "properties": { "pane": { "type": "string" }, "owner": { "type": "string" }, "url": { "type": "string" }, "title": { "type": "string" }, "profile": { "type": "string" }, "machine": { "type": "string" }, "route": { "type": "string" }, "running": { "type": "boolean" }, "screencast": { "type": "boolean" }, "viewers": { "type": "integer" }, "frames": { "type": "integer" }, "fps": { "type": "number" }, "decode_ms": { "type": "number" }, "css": { "type": "array", "items": { "type": "number" } }, "frame": { "type": "array", "items": { "type": "integer" } }, "history": {}, "error": { "type": "string" }, "pin": { "type": "object", "properties": { "device": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] }, "letterbox": { "type": "object", "properties": { "rect": { "type": "array", "items": { "type": "number" } }, "scale": { "type": "number" } }, "required": [ "rect", "scale" ] }, "console": { "type": "integer" }, "network": { "type": "integer" }, "clipboard": { "type": "object", "properties": { "forwarded": { "type": "integer" }, "blocked": { "type": "integer" } }, "required": [ "forwarded", "blocked" ] } }, "required": [ "pane", "owner", "profile", "machine", "route", "running", "screencast", "viewers", "frames", "fps", "decode_ms", "css", "history", "console", "network", "clipboard" ] } }, "windowed": { "type": "array", "items": { "type": "string" } }, "tiles_sent": { "type": "integer" }, "media_bytes": { "type": "integer" } }, "required": [ "browsers", "targets", "windowed", "tiles_sent", "media_bytes" ] } }, "browser.pane.update": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "url": { "type": "string" }, "title": { "type": "string" }, "history": { "type": "array", "items": { "type": "string" } }, "history_index": { "type": "integer" }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] } ] }, "fit": { "type": "boolean" } }, "required": [ "pane" ] }, "result": { "type": "object", "properties": { "pane": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "browser.press": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "key": { "type": "string" } }, "required": [ "key" ] }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "key": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "key" ] } }, "browser.release": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "human_control": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "human_control" ] } }, "browser.screencast_frame": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "after_seq": { "type": "integer" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "session": { "type": "string" }, "seq": { "type": "integer" }, "mime": { "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "received_ms": { "type": "integer" }, "data_b64": { "type": "string" } }, "required": [ "session", "seq", "mime", "width", "height", "received_ms", "data_b64" ] }, { "type": "object", "properties": { "session": { "type": "string" }, "seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "data_b64": { "type": "null" } }, "required": [ "session", "seq", "data_b64" ] } ] } }, "browser.screenshot": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "url": { "type": "string" }, "preview": { "type": "string" }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object" } ] }, "dpr": { "type": "number" }, "color_scheme": { "type": "string" }, "dark": { "type": "boolean" }, "full_page": { "type": "boolean" }, "selector": { "type": "string" }, "timeout_ms": { "type": "integer" }, "inline": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "session": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "handle": { "type": "string" }, "blob": { "type": "string" }, "path_on_machine": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "bytes": { "type": "integer" }, "binding": { "type": "string", "enum": [ "bound", "illustrative" ] }, "label": { "type": "string" }, "meta": { "$ref": "#/$defs/ScreenshotMeta" }, "data_b64": { "type": "string" }, "mime": { "type": "string" }, "inline_skipped": { "type": "string" }, "one_shot": { "type": "boolean" }, "opened_session": { "type": "string" }, "status": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "final_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "id", "handle", "blob", "path_on_machine", "width", "height", "bytes", "binding", "label", "meta" ] } }, "browser.session_close": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "closed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "closed" ] } }, "browser.session_open": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "url": { "type": "string" }, "preview": { "type": "string" }, "machine": { "type": "string" }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" }, "w": { "type": "integer" }, "h": { "type": "integer" } } } ] }, "dpr": { "type": "number" }, "color_scheme": { "type": "string" }, "dark": { "type": "boolean" }, "wait": { "type": "string" }, "timeout_ms": { "type": "integer" } } }, "result": { "$ref": "#/$defs/BrowserSession" } }, "browser.snapshot": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "format": { "type": "string", "enum": [ "a11y", "accessibility", "text", "html" ], "default": "a11y" }, "max_bytes": { "type": "integer" }, "selector": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "url": { "type": "string" }, "format": { "type": "string" }, "content": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "session", "url", "format", "content", "truncated" ] } }, "browser.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "anyOf": [ { "type": "object", "properties": { "running": { "const": true }, "pid": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "product": { "type": "string" }, "binary": { "type": "string" }, "kind": { "type": "string" }, "uptime_ms": { "type": "integer" }, "sessions": { "type": "integer" }, "denied": { "type": "integer" }, "profile_dir": { "type": "string" }, "idle_timeout_ms": { "type": "integer" } }, "required": [ "running", "pid", "product", "binary", "kind", "uptime_ms", "sessions", "denied", "profile_dir", "idle_timeout_ms" ] }, { "type": "object", "properties": { "running": { "const": false }, "sessions": { "type": "integer" }, "denied": { "type": "integer" }, "binary": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "profile_dir": { "type": "string" }, "idle_timeout_ms": { "type": "integer" } }, "required": [ "running", "sessions", "denied", "binary", "kind", "profile_dir", "idle_timeout_ms" ] } ] } }, "browser.take_over": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "human_control": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "human_control" ] } }, "browser.type": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "text": { "type": "string" }, "selector": { "type": "string" }, "clear": { "type": "boolean" }, "submit": { "type": "boolean" }, "timeout_ms": { "type": "integer" } }, "required": [ "text" ] }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "typed": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "typed" ] } }, "browser.wait": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "browser_session": { "type": "string" }, "target": { "type": "string" }, "for": { "type": "string", "default": "load" }, "timeout_ms": { "type": "integer", "default": 15000 } } }, "result": { "type": "object", "properties": { "session": { "type": "string" }, "waited": { "type": "string" } }, "required": [ "session", "waited" ] } }, "browser.watch": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "agent_pane": { "$ref": "#/$defs/Target" }, "pane": { "$ref": "#/$defs/Target" }, "split": { "type": "string", "enum": [ "right", "down", "left", "up", "tab", "float" ], "default": "right" }, "focus": { "type": "boolean", "default": true }, "focus_client": { "type": "string" } } }, "result": { "type": "object", "properties": { "opened_in": { "type": "string" }, "session": { "type": "string" }, "read_only": { "type": "boolean" }, "pane": { "type": "string" }, "pane_handle": { "type": "string" }, "tab": { "type": "string" }, "url": { "type": "string" }, "machine": { "type": "string" }, "source_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "session", "read_only", "pane", "pane_handle", "tab", "url", "machine", "source_pane" ] } }, "client.appearance": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "dark": { "type": "boolean" }, "source": { "anyOf": [ { "const": "osc11" }, { "const": "csi996" }, { "type": "string" } ] } }, "required": [ "dark" ] }, "result": { "type": "object", "properties": { "appearance": { "$ref": "#/$defs/Appearance" }, "colorfgbg": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "appearance", "colorfgbg" ] } }, "client.focus": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "url": { "type": "string" }, "raise": { "type": "boolean", "default": true } } }, "result": { "type": "object", "properties": { "pane": { "type": "string" }, "client": { "type": "string" }, "focused": { "type": "boolean" }, "raised": { "type": "boolean" }, "host": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "client", "focused", "raised", "host" ] } }, "client.hello": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "client": { "type": "string" }, "version": { "type": "string" }, "api": { "type": "string" }, "kind": { "anyOf": [ { "const": "tui" }, { "const": "cli" }, { "const": "plugin" }, { "const": "gateway" }, { "const": "agent" }, { "type": "string" } ] }, "token": { "type": "string" }, "host": { "type": "object", "properties": { "bundle_id": { "type": "string" }, "term_program": { "type": "string" } } } }, "required": [ "client", "version", "api", "kind" ] }, "result": { "type": "object", "properties": { "server_version": { "type": "string" }, "api": { "type": "string" }, "session": { "type": "string" }, "machine": { "type": "string" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "features": { "type": "array", "items": { "type": "string" } }, "client_id": { "type": "string" } }, "required": [ "server_version", "api", "session", "machine", "capabilities", "features" ] } }, "client.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "clients": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "client": { "type": "string" }, "version": { "type": "string" }, "attached_at": { "type": "integer" }, "peer": { "type": "object", "properties": { "uid": { "type": "integer" }, "pid": { "type": "integer" }, "machine": { "type": "string" } }, "required": [ "uid" ] }, "focused_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "kind", "attached_at", "focused_pane" ] } } }, "required": [ "clients" ] } }, "compat.herdr.call": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "method": { "type": "string" }, "params": { "type": "object" }, "as_plugin": { "type": "object", "properties": { "session": { "type": "string" }, "ticket": { "type": "string" } }, "required": [ "session", "ticket" ] } }, "required": [ "method" ] }, "result": { "anyOf": [ { "type": "object", "properties": { "result": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "result" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "error" ] } ] } }, "compat.invocation.verify": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "ticket": { "type": "string" } }, "required": [ "ticket" ] }, "result": { "type": "object", "properties": { "plugin_id": { "type": "string" }, "digest": { "type": "string" }, "grant_id": { "type": "string" }, "log_id": { "type": "string" }, "session": { "type": "string" }, "sandboxed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "plugin_id", "digest", "grant_id", "log_id", "session", "sandboxed" ] } }, "compat.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "baseline": { "type": "object", "properties": { "herdr": { "type": "string" }, "commit": { "type": "string" } }, "required": [ "herdr", "commit" ] }, "support": { "type": "string" }, "listener": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "path": { "type": "string" }, "live": { "type": "boolean" } }, "required": [ "enabled", "path", "live" ] }, "inventory": { "type": "object", "properties": { "implemented": { "type": "integer" }, "partial": { "type": "integer" }, "missing": { "type": "integer" } }, "required": [ "implemented", "partial", "missing" ] }, "brokers": { "type": "integer" }, "herdr_root": { "type": "string" }, "registry": { "type": "string" } }, "required": [ "baseline", "support", "listener", "inventory", "brokers", "herdr_root", "registry" ] } }, "compat.ui.state": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "window_title": { "type": "string" }, "popup": { "type": "object", "properties": { "pane": { "type": "string" }, "plugin_id": { "type": "string" }, "entrypoint_id": { "type": "string" } }, "required": [ "pane", "plugin_id", "entrypoint_id" ] }, "agent_views": { "type": "array", "items": { "type": "object", "properties": { "plugin_id": { "type": "string" }, "run": { "type": "string" }, "text": { "type": "string" }, "detail": { "type": "string" }, "tone": { "type": "string" }, "updated_ms": { "type": "integer" } }, "required": [ "plugin_id", "run", "text", "updated_ms" ] } } }, "required": [ "agent_views" ] } }, "config.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "key": { "type": "string" } } }, "result": { "type": "object", "properties": { "key": { "type": "string" }, "value": {}, "source": { "type": "string", "enum": [ "default", "user", "runtime" ] }, "path": { "type": "string" }, "overrides": { "type": "array", "items": { "type": "string" } }, "errors": { "type": "array", "items": { "$ref": "#/$defs/ConfigDiagnostic" } } }, "required": [ "value", "source", "path", "overrides", "errors" ] } }, "config.reload": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "changed": { "type": "array", "items": { "type": "string" } }, "errors": { "type": "array", "items": { "$ref": "#/$defs/ConfigDiagnostic" } }, "warnings": { "type": "array", "items": { "$ref": "#/$defs/ConfigWarning" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "changed", "errors" ] } }, "config.set": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "key": { "type": "string" }, "value": {}, "persist": { "type": "boolean", "default": false } }, "required": [ "key", "value" ] }, "result": { "type": "object", "properties": { "key": { "type": "string" }, "value": {}, "persisted": { "type": "boolean" }, "path": { "type": "string" }, "changed": { "type": "array", "items": { "type": "string" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "key", "value", "persisted", "path", "changed" ] } }, "config.validate": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "path": { "type": "string" } } }, "result": { "type": "object", "properties": { "path": { "type": "string" }, "valid": { "type": "boolean" }, "errors": { "type": "array", "items": { "$ref": "#/$defs/ConfigDiagnostic" } }, "warnings": { "type": "array", "items": { "$ref": "#/$defs/ConfigWarning" } } }, "required": [ "path", "valid", "errors", "warnings" ] } }, "desk.context": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "session": { "type": "string" }, "turns": { "anyOf": [ { "type": "array", "items": { "type": "integer" } }, { "type": "string" } ] }, "path": { "type": "string" }, "objective": { "type": "string" } }, "required": [ "session" ] }, "result": { "type": "object", "properties": { "package": { "type": "object" }, "text": { "type": "string" } }, "required": [ "package", "text" ] } }, "desk.forget": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "repo": { "type": "string" }, "workspace": { "$ref": "#/$defs/Target" }, "before": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] } } }, "result": { "type": "object", "properties": { "rows_deleted": { "type": "integer" }, "sessions_forgotten": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "rows_deleted", "sessions_forgotten" ] } }, "desk.index": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "budget": { "type": "integer" } } }, "result": { "type": "object", "properties": { "pass": { "type": "object", "properties": { "registered": { "type": "integer" }, "bytes": { "type": "integer" }, "rows": { "type": "integer" }, "purged": { "type": "integer" }, "reset": { "type": "integer" }, "pending": { "type": "integer" }, "errors": {} }, "required": [ "registered", "bytes", "rows", "purged", "reset", "pending", "errors" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pass" ] } }, "desk.open": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "turn": { "type": "integer" }, "path": { "type": "string" }, "focus": { "type": "boolean", "default": false } }, "required": [ "session" ] }, "result": { "type": "object", "properties": { "status": { "type": "string" }, "action": { "type": "string" }, "turn_items": {}, "focused": { "type": "boolean" }, "actions": { "type": "array", "items": { "type": "object" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "status", "action" ] } }, "desk.resume": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "session": { "type": "string" }, "mode": { "const": "native" }, "pane": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" } }, "required": [ "session" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "desk.search": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "text": { "type": "string" }, "repo": { "type": "string" }, "harness": { "type": "string" }, "since": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "until": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "session": { "type": "string" }, "limit": { "type": "integer", "default": 20 }, "sort": { "type": "string", "enum": [ "relevance", "recent" ] }, "fresh": { "type": "boolean", "default": true } }, "required": [ "text" ] }, "result": { "type": "object", "properties": { "hits": { "type": "array", "items": { "type": "object" } }, "index": { "type": "object" } }, "required": [ "hits", "index" ] } }, "desk.sessions": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "repo": { "type": "string" }, "harness": { "type": "string" }, "limit": { "type": "integer", "default": 50 } } }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "type": "object", "properties": { "session": { "type": "string" }, "harness": { "type": "string" }, "machine": { "type": "string" }, "repo": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workspace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "first_ts": { "type": "integer" }, "last_ts": { "type": "integer" }, "turns": { "type": "integer" }, "rows": { "type": "integer" }, "paths": {}, "status": { "type": "string" }, "live": {}, "resume": {} }, "required": [ "session", "harness" ] } } }, "required": [ "sessions" ] } }, "desk.status": { "mutating": false, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "db": { "type": "string" }, "selection": { "type": "object" }, "exclude": {}, "retention_days": { "type": "integer" }, "counts": { "type": "object" }, "sources": { "type": "array", "items": { "type": "object" } }, "last_pass": {} }, "required": [ "db", "selection", "exclude", "retention_days", "counts", "sources", "last_pass" ] } }, "draft.check": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "target_run": { "$ref": "#/$defs/Target" }, "draft": { "$ref": "#/$defs/Target" } }, "required": [ "target_run" ] }, "result": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" }, "harness": { "type": "string" }, "native_conversation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "send_path": { "type": "string", "enum": [ "prompt_input", "open_pane_only" ] }, "unsafe": {}, "follow_up": { "type": "string" }, "steer": { "type": "boolean" }, "hidden_attachments": {} }, "required": [ "run", "pane", "harness", "native_conversation_id", "send_path" ] } }, "draft.combine": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" } }, "title": { "type": "string" }, "separator": { "type": "string" }, "delete_sources": { "type": "boolean", "default": false } }, "required": [ "ids" ] }, "result": { "type": "object", "properties": { "draft": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "draft" ] } }, "draft.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "workspace", "task" ] }, "id": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "file", "screenshot" ] }, "path": { "type": "string" }, "blob": { "type": "string" }, "data_b64": { "type": "string" }, "name": { "type": "string" }, "label": { "type": "string" } }, "required": [ "kind" ] } }, "idempotency_key": { "type": "string" } }, "required": [ "text" ] }, "result": { "type": "object", "properties": { "draft": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "draft" ] } }, "draft.delete": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "draft": { "$ref": "#/$defs/Target" } }, "required": [ "draft" ] }, "result": { "type": "object", "properties": { "deleted": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "deleted" ] } }, "draft.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "draft": { "$ref": "#/$defs/Target" } }, "required": [ "draft" ] }, "result": { "type": "object", "properties": { "draft": { "type": "object" } }, "required": [ "draft" ] } }, "draft.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "scope": { "type": "string", "enum": [ "workspace", "task" ] }, "id": { "type": "string" }, "all": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "drafts": { "type": "array", "items": { "type": "object" } } }, "required": [ "drafts" ] } }, "draft.reconcile": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "draft": { "$ref": "#/$defs/Target" } }, "required": [ "draft" ] }, "result": { "type": "object", "properties": { "send": { "type": "object" }, "receipt": { "type": "object" }, "may_retry": { "type": "boolean" }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "send", "receipt", "may_retry", "note" ] } }, "draft.reorder": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "order": { "type": "array", "items": { "type": "string" } } }, "required": [ "order" ] }, "result": { "type": "object", "properties": { "drafts": { "type": "array", "items": { "type": "object" } }, "cursor": { "$ref": "#/$defs/Cursor" } } } }, "draft.send": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "draft": { "$ref": "#/$defs/Target" }, "target_run": { "$ref": "#/$defs/Target" }, "idempotency_key": { "type": "string" }, "include_notes": { "type": "boolean", "default": false }, "keep": { "type": "boolean", "default": false }, "retry_despite_unknown": { "type": "boolean" } }, "required": [ "draft", "target_run", "idempotency_key" ] }, "result": { "type": "object", "properties": { "draft": { "type": "object" }, "send": { "type": "object" }, "send_path": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "draft", "send", "send_path" ] } }, "draft.update": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "draft": { "$ref": "#/$defs/Target" }, "text": { "type": "string" }, "title": { "type": "string" }, "attachments": { "type": "array", "items": {} }, "add_attachment": { "type": "object" }, "remove_attachment": { "type": "integer" }, "expected_rev": { "type": "integer" } }, "required": [ "draft" ] }, "result": { "type": "object", "properties": { "draft": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "draft" ] } }, "events.read": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "after": { "anyOf": [ { "$ref": "#/$defs/Cursor" }, { "type": "integer" } ] }, "before": { "anyOf": [ { "$ref": "#/$defs/Cursor" }, { "type": "integer" } ] }, "types": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "string" } ] }, "subjects": { "type": "object" }, "limit": { "type": "integer", "default": 500 } } }, "result": { "type": "object", "properties": { "events": { "type": "array", "items": { "$ref": "#/$defs/Event" } }, "next": { "$ref": "#/$defs/Cursor" } }, "required": [ "events", "next" ] } }, "events.subscribe": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "after": { "anyOf": [ { "$ref": "#/$defs/Cursor" }, { "type": "integer" } ] }, "types": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "string" } ] }, "subjects": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "tab": { "$ref": "#/$defs/Target" }, "pane": { "$ref": "#/$defs/Target" }, "run": { "$ref": "#/$defs/Target" }, "task": { "$ref": "#/$defs/Target" } } }, "include_snapshot": { "type": "boolean", "default": false }, "machine": { "type": "string" } } }, "result": { "type": "object", "properties": { "subscription_id": { "type": "string" }, "at": { "$ref": "#/$defs/Cursor" } }, "required": [ "subscription_id", "at" ] } }, "events.unsubscribe": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "subscription_id": { "type": "string" } }, "required": [ "subscription_id" ] }, "result": { "type": "object", "properties": { "unsubscribed": { "type": "boolean" } }, "required": [ "unsubscribed" ] } }, "events.wait": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "types": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "string" } ] }, "subjects": { "type": "object" }, "after": { "anyOf": [ { "$ref": "#/$defs/Cursor" }, { "type": "integer" } ] }, "timeout_ms": { "type": "integer", "default": 60000 } } }, "result": { "type": "object", "properties": { "event": { "$ref": "#/$defs/Event" } }, "required": [ "event" ] } }, "fs.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "path": { "type": "string", "default": "" } } }, "result": { "type": "object", "properties": { "path": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "file", "dir", "symlink", "other" ] }, "size": { "type": "integer" }, "ignored": { "type": "boolean" }, "secret": { "type": "boolean" } }, "required": [ "name", "kind", "ignored", "secret" ] } }, "truncated": { "type": "boolean" } }, "required": [ "path", "entries", "truncated" ] } }, "fs.read": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "path": { "type": "string" } }, "required": [ "path" ] }, "result": { "type": "object", "properties": { "path": { "type": "string" }, "text": { "type": "string" }, "binary": { "type": "boolean" }, "truncated": { "type": "boolean" }, "size": { "type": "integer" }, "secret": { "type": "boolean" } }, "required": [ "path", "binary", "truncated", "size", "secret" ] } }, "git.diff": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "path": { "type": "string" }, "file": { "type": "string" }, "staged": { "type": "boolean" } }, "required": [ "file" ] }, "result": { "type": "object", "properties": { "file": { "type": "string" }, "diff": { "type": "string" }, "truncated": { "type": "boolean" }, "binary": { "type": "boolean" }, "untracked": { "type": "boolean" }, "secret": { "type": "boolean" } }, "required": [ "file", "diff", "truncated", "binary", "untracked" ] } }, "git.log": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "path": { "type": "string" }, "base": { "type": "string" }, "limit": { "type": "integer", "default": 50 } } }, "result": { "type": "object", "properties": { "commits": { "type": "array", "items": { "type": "object", "properties": { "sha": { "type": "string" }, "short": { "type": "string" }, "author": { "type": "string" }, "ts": { "type": "integer" }, "subject": { "type": "string" } }, "required": [ "sha", "short", "author", "ts", "subject" ] } }, "truncated": { "type": "boolean" } }, "required": [ "commits", "truncated" ] } }, "git.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "path": { "type": "string" } } }, "result": { "type": "object", "properties": { "repo_root": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "upstream": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ahead": { "type": "integer" }, "behind": { "type": "integer" }, "clean": { "type": "boolean" }, "truncated": { "type": "boolean" }, "files": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "orig_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "x": { "type": "string" }, "y": { "type": "string" }, "kind": { "type": "string" }, "staged": { "type": "boolean" }, "adds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "dels": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "binary": { "type": "boolean" }, "secret": { "type": "boolean" } }, "required": [ "path", "x", "y", "kind", "staged", "binary", "secret" ] } } }, "required": [ "repo_root", "ahead", "behind", "clean", "truncated", "files" ] } }, "group.add": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" }, "index": { "type": "integer" } }, "required": [ "group" ] }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "group": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace", "group" ] } }, "group.collapse": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" }, "collapsed": { "type": "boolean" } }, "required": [ "group" ] }, "result": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Group" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "group" ] } }, "group.create": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "name": { "type": "string" }, "parent": { "$ref": "#/$defs/Target" } }, "required": [ "name" ] }, "result": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Group" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "group" ] } }, "group.delete": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" } }, "required": [ "group" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "group.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "groups": { "type": "array", "items": { "$ref": "#/$defs/Group" } }, "ungrouped": { "type": "array", "items": { "type": "string" } } }, "required": [ "groups", "ungrouped" ] } }, "group.move": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" }, "parent": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "null" } ] }, "index": { "type": "integer" }, "delta": { "type": "integer" } }, "required": [ "group" ] }, "result": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Group" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "group" ] } }, "group.remove": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "index": { "type": "integer" } } }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "group": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace", "group" ] } }, "group.rename": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" }, "name": { "type": "string" } }, "required": [ "group", "name" ] }, "result": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Group" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "group" ] } }, "image.upload": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "mime": { "type": "string" }, "data_b64": { "type": "string" }, "path_on_client": { "type": "string" } }, "required": [ "pane", "mime" ] }, "result": { "type": "object", "properties": { "path_on_machine": { "type": "string" }, "blob": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "path_on_machine" ] } }, "interaction.answer": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Target" }, "decision": { "type": "string", "enum": [ "allow", "allow_always", "deny" ] }, "choices": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "text": { "type": "string" }, "scope": { "type": "string", "enum": [ "once", "session", "rule" ] }, "rule": { "$ref": "#/$defs/PolicyRule" }, "idempotency_key": { "type": "string" }, "actor": { "type": "string" }, "expected_decision_rev": { "type": "integer" } }, "required": [ "interaction" ] }, "result": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Interaction" }, "delivery": { "type": "object", "properties": { "state": { "type": "string" }, "channel": { "anyOf": [ { "const": "native" }, { "const": "keystrokes" }, { "const": "none" }, { "type": "string" } ] } }, "required": [ "state" ] }, "duplicate": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "interaction", "delivery" ] } }, "interaction.cancel": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Target" } }, "required": [ "interaction" ] }, "result": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Interaction" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "interaction" ] } }, "interaction.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Target" } }, "required": [ "interaction" ] }, "result": { "type": "object", "properties": { "interaction": { "$ref": "#/$defs/Interaction" } }, "required": [ "interaction" ] } }, "interaction.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "status": { "anyOf": [ { "const": "open" }, { "type": "string" } ] }, "run": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" }, "kind": { "type": "string" } } }, "result": { "type": "object", "properties": { "interactions": { "type": "array", "items": { "$ref": "#/$defs/Interaction" } } }, "required": [ "interactions" ] } }, "layout.apply": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "layout": { "anyOf": [ { "$ref": "#/$defs/LayoutSpec" }, { "type": "string" } ] }, "workspace": { "$ref": "#/$defs/Target" }, "new_workspace": { "type": "object", "properties": { "cwd": { "type": "string" }, "name": { "type": "string" } }, "required": [ "cwd" ] } }, "required": [ "layout" ] }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "tabs": { "type": "array", "items": { "$ref": "#/$defs/Tab" } }, "panes": { "type": "array", "items": { "$ref": "#/$defs/Pane" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace", "tabs", "panes" ] } }, "layout.export": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "layout": { "$ref": "#/$defs/LayoutSpec" } }, "required": [ "layout" ] } }, "layout.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "name": { "type": "string" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "layouts": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tabs": { "type": "integer" }, "panes": { "type": "integer" }, "valid": { "type": "boolean" } }, "required": [ "name", "tabs", "panes", "valid" ] } } }, "required": [ "layouts" ] }, { "type": "object", "properties": { "layout": { "$ref": "#/$defs/LayoutSpec" } }, "required": [ "layout" ] } ] } }, "layout.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "name": { "type": "string" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "layouts": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tabs": { "type": "integer" }, "panes": { "type": "integer" }, "valid": { "type": "boolean" } }, "required": [ "name", "tabs", "panes", "valid" ] } } }, "required": [ "layouts" ] }, { "type": "object", "properties": { "layout": { "$ref": "#/$defs/LayoutSpec" } }, "required": [ "layout" ] } ] } }, "notes.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "notes": { "type": "object", "properties": { "workspace": { "type": "string" }, "text": { "type": "string" }, "rev": { "type": "integer" } }, "required": [ "workspace", "text", "rev" ] } }, "required": [ "notes" ] } }, "notes.set": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "text": { "type": "string" }, "expected_rev": { "type": "integer" } }, "required": [ "text" ] }, "result": { "type": "object", "properties": { "notes": { "type": "object", "properties": { "workspace": { "type": "string" }, "text": { "type": "string" }, "rev": { "type": "integer" } }, "required": [ "workspace", "text", "rev" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "notes" ] } }, "notification.config": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "channels": { "type": "array", "items": { "type": "string" } }, "rules": {}, "native": { "type": "object" }, "hosts": {} }, "required": [ "channels", "rules" ] } }, "notification.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "unread_only": { "type": "boolean", "default": true }, "limit": { "type": "integer" } } }, "result": { "type": "object", "properties": { "notifications": { "type": "array", "items": { "$ref": "#/$defs/Notification" } } }, "required": [ "notifications" ] } }, "notification.read": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "notification": { "$ref": "#/$defs/Target" }, "all": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "notification.send": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "title": { "type": "string" }, "body": { "type": "string" }, "urgency": { "type": "string", "default": "normal" }, "subject": { "type": "string" }, "sound": { "type": "boolean" } }, "required": [ "title" ] }, "result": { "type": "object", "properties": { "notification": { "$ref": "#/$defs/Notification" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "notification" ] } }, "pane.can_see_paths": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "paths": { "type": "array", "items": { "type": "string" } } } }, "result": { "type": "object", "properties": { "visible": { "type": "array", "items": { "type": "boolean" } } }, "required": [ "visible" ] } }, "pane.close": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "force": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "pane.current": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" } }, "required": [ "pane" ] } }, "pane.embed": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "target": { "$ref": "#/$defs/Target" }, "direction": { "type": "string", "enum": [ "right", "down", "left", "up" ], "default": "right" }, "ratio": { "type": "number" } }, "required": [ "pane" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "tab": { "$ref": "#/$defs/Tab" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "tab" ] } }, "pane.equalize": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "layout": { "$ref": "#/$defs/LayoutSpec" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "layout" ] } }, "pane.float": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "tab": { "$ref": "#/$defs/Target" }, "rect": { "type": "object", "properties": { "x": { "type": "number" }, "y": { "type": "number" }, "w": { "type": "number" }, "h": { "type": "number" } } }, "cwd": { "type": "string" }, "command": { "type": "array", "items": { "type": "string" } }, "focus": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.focus": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "client": { "type": "string" } }, "required": [ "pane" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "run": { "anyOf": [ { "$ref": "#/$defs/AgentRun" }, { "type": "null" } ] }, "open_interactions": { "type": "array", "items": { "$ref": "#/$defs/Interaction" } }, "live": { "anyOf": [ { "$ref": "#/$defs/PaneLive" }, { "type": "null" } ] } }, "required": [ "pane" ] } }, "pane.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "tab": { "$ref": "#/$defs/Target" }, "has_agent": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "panes": { "type": "array", "items": { "$ref": "#/$defs/Pane" } } }, "required": [ "panes" ] } }, "pane.mark_seen": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.mark_unread": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.move": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "to": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" }, "new_tab_in": { "$ref": "#/$defs/Target" } } }, "direction": { "type": "string", "enum": [ "right", "down", "left", "up" ], "default": "right" }, "anchor": { "$ref": "#/$defs/Target" }, "position": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "direction": { "type": "string" } } }, "focus": { "type": "boolean", "default": false } }, "required": [ "to" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "tab": { "$ref": "#/$defs/Tab" }, "previous_pane_handle": { "type": "string" }, "source_tab_closed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane", "tab", "previous_pane_handle", "source_tab_closed" ] } }, "pane.pin": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "pinned": { "type": "boolean" } }, "required": [ "pinned" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.read": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "source": { "type": "string", "enum": [ "visible", "recent", "recent_unwrapped", "scrollback", "detection", "last-command" ], "default": "visible" }, "lines": { "type": "integer", "default": 200 }, "from_line": { "type": "integer" }, "format": { "type": "string", "enum": [ "text", "ansi", "cells" ], "default": "text" }, "include_cursor": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "text": { "type": "string" }, "cells": {}, "rows": { "type": "integer" }, "revision": { "type": "integer" }, "truncated": { "type": "boolean" }, "scroll": {}, "cursor": {}, "running": { "type": "boolean" }, "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "prompt_line": { "type": "integer" } } } }, "pane.rename": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title" ] }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.report_agent": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "pane_id": { "$ref": "#/$defs/Target" }, "source": { "type": "string", "default": "herdr" }, "seq": { "type": "integer" }, "agent": { "type": "string" }, "harness": { "type": "string" }, "state": { "anyOf": [ { "const": "idle" }, { "const": "working" }, { "const": "blocked" }, { "const": "done" }, { "type": "string" } ] }, "message": { "type": "string" }, "resume_argv": { "type": "array", "items": { "type": "string" } } }, "required": [ "state" ] }, "result": { "type": "object", "properties": { "type": { "const": "ok" }, "dropped": { "const": "stale_seq" }, "applied": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "type" ] } }, "pane.report_agent_session": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "pane_id": { "$ref": "#/$defs/Target" }, "source": { "type": "string", "default": "herdr" }, "seq": { "type": "integer" }, "agent": { "type": "string" }, "harness": { "type": "string" }, "agent_session_id": { "type": "string" }, "agent_session_path": { "type": "string" }, "session_start_source": { "type": "string" } } }, "result": { "type": "object", "properties": { "type": { "const": "ok" }, "dropped": { "const": "stale_seq" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "type" ] } }, "pane.resize": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "direction": { "type": "string", "enum": [ "right", "down", "left", "up" ] }, "cells": { "type": "integer" }, "percent": { "type": "number" } }, "required": [ "direction" ] }, "result": { "type": "object", "properties": { "layout": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "layout" ] } }, "pane.run": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "command": { "type": "string" }, "wait": { "type": "boolean" }, "timeout_ms": { "type": "integer" } }, "required": [ "command" ] }, "result": { "type": "object", "properties": { "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "output_tail": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } } } }, "pane.screenshot": { "mutating": false, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "format": { "type": "string", "enum": [ "text", "ansi", "html", "png", "svg" ], "default": "ansi" }, "source": { "type": "string", "enum": [ "visible", "recent" ], "default": "visible" }, "lines": { "type": "integer", "default": 200 }, "include_cursor": { "type": "boolean" }, "inline": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "blob": { "type": "object", "properties": { "hash": { "type": "string" }, "size": { "type": "integer" }, "mime": { "type": "string" }, "path": { "type": "string" } }, "required": [ "hash", "size", "mime", "path" ] }, "format": { "type": "string" }, "source": { "type": "string" }, "cols": { "type": "integer" }, "rows": { "type": "integer" }, "lines": { "type": "integer" }, "revision": { "type": "integer" }, "cursor": { "type": "object", "properties": { "row": { "type": "integer" }, "col": { "type": "integer" }, "visible": { "type": "boolean" } }, "required": [ "row", "col", "visible" ] }, "data": { "type": "string" } }, "required": [ "blob", "format", "source", "cols", "rows", "lines", "revision" ] } }, "pane.scroll": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "to": { "type": "string", "enum": [ "bottom", "top", "line" ] }, "line": { "type": "integer" }, "delta": { "type": "integer" }, "client": { "type": "string" } } }, "result": { "type": "object", "properties": { "scroll": { "type": "object", "properties": { "offset": { "type": "integer" }, "total": { "type": "integer" }, "at_bottom": { "type": "boolean" } }, "required": [ "offset", "total", "at_bottom" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "scroll" ] } }, "pane.send_bytes": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "data_b64": { "type": "string" } }, "required": [ "data_b64" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "pane.send_keys": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "keys": { "type": "array", "items": { "type": "string" } } }, "required": [ "keys" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "pane.send_text": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "text": { "type": "string" }, "paste": { "type": "string", "enum": [ "auto", "bracketed", "raw" ], "default": "auto" } }, "required": [ "text" ] }, "result": { "type": "object", "properties": { "bytes": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "bytes" ] } }, "pane.split": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "direction": { "type": "string", "enum": [ "right", "down", "left", "up" ], "default": "right" }, "ratio": { "type": "number", "default": 0.5 }, "cwd": { "type": "string" }, "command": { "type": "array", "items": { "type": "string" } }, "env": { "type": "object", "additionalProperties": { "type": "string" } }, "focus": { "type": "boolean", "default": false }, "title": { "type": "string" } } }, "result": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "pane" ] } }, "pane.wait_idle": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "quiet_ms": { "type": "integer", "default": 2000 }, "timeout_ms": { "type": "integer" } } }, "result": { "type": "object", "properties": { "revision": { "type": "integer" } }, "required": [ "revision" ] } }, "pane.wait_output": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "match": { "type": "string" }, "regex": { "type": "string" }, "source": { "type": "string" }, "timeout_ms": { "type": "integer" }, "since_revision": { "type": "integer" } } }, "result": { "type": "object", "properties": { "matched": { "type": "string" }, "line": {}, "revision": { "type": "integer" } }, "required": [ "matched", "line", "revision" ] } }, "pane.zoom": { "mutating": true, "scope": "pane", "pane_scope": "own_target", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "zoomed": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Tab" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tab" ] } }, "paste.translated": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "files": { "type": "array", "items": { "type": "object", "properties": { "blob": { "type": "string" }, "bytes": { "type": "integer" }, "local_name": { "type": "string" }, "dir": { "type": "boolean" } }, "required": [ "blob" ] } }, "target_namespace": { "type": "string" } }, "required": [ "files" ] }, "result": { "type": "object", "properties": { "recorded": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "recorded" ] } }, "plugin.action.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "plugin": { "type": "string" } } }, "result": { "type": "object", "properties": { "actions": { "type": "array", "items": { "type": "object", "properties": { "plugin_id": { "type": "string" }, "action_id": { "type": "string" }, "qualified_id": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "contexts": {}, "available": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "plugin_id", "action_id", "qualified_id", "title", "contexts", "available", "status" ] } }, "keybindings": { "type": "array", "items": { "type": "object", "properties": { "plugin_id": { "type": "string" }, "key": { "type": "string" }, "action": { "type": "string" }, "description": { "type": "string" }, "installed": { "type": "boolean" }, "reason": { "type": "string" }, "conflicts_with": {} }, "required": [ "plugin_id", "key", "action", "installed" ] } } }, "required": [ "actions", "keybindings" ] } }, "plugin.action.run": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "anyOf": [ { "type": "object", "properties": { "plugin": { "type": "string" }, "action": { "type": "string" }, "source": { "type": "string", "enum": [ "palette", "keybinding" ] }, "context": { "type": "object", "properties": { "pane_id": { "$ref": "#/$defs/Target" }, "pane": { "$ref": "#/$defs/Target" }, "tab_id": { "$ref": "#/$defs/Target" }, "tab": { "$ref": "#/$defs/Target" }, "workspace_id": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" } } }, "pane_id": { "$ref": "#/$defs/Target" }, "tab_id": { "$ref": "#/$defs/Target" }, "workspace_id": { "$ref": "#/$defs/Target" } }, "required": [ "plugin", "action" ] }, { "type": "object", "properties": { "action": { "type": "string" }, "source": { "type": "string", "enum": [ "palette", "keybinding" ] }, "context": { "type": "object" } }, "required": [ "action" ] } ] }, "result": { "type": "object", "properties": { "log": { "type": "object", "properties": { "log_id": { "type": "string" }, "plugin_id": { "type": "string" }, "action_id": { "type": "string" }, "event": { "type": "string" }, "entrypoint_id": { "type": "string" }, "source": { "type": "string" }, "command": {}, "long_lived": { "type": "boolean" }, "isolation": { "type": "string", "enum": [ "sandbox", "host" ] }, "status": { "type": "string" }, "started_unix_ms": { "type": "integer" }, "finished_unix_ms": { "type": "integer" }, "started_at": { "type": "integer" }, "finished_at": { "type": "integer" }, "exit_code": { "type": "integer" }, "stdout": { "type": "string" }, "stderr": { "type": "string" }, "context": { "type": "object" } }, "required": [ "log_id", "plugin_id", "source", "command", "long_lived", "isolation", "status", "started_unix_ms", "started_at", "stdout", "stderr", "context" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "log" ] } }, "plugin.link.open": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "plugin": { "type": "string" }, "handler": { "type": "string" }, "url": { "type": "string" }, "context": { "type": "object", "properties": { "pane_id": { "$ref": "#/$defs/Target" }, "tab_id": { "$ref": "#/$defs/Target" }, "workspace_id": { "$ref": "#/$defs/Target" } } }, "pane_id": { "$ref": "#/$defs/Target" }, "tab_id": { "$ref": "#/$defs/Target" }, "workspace_id": { "$ref": "#/$defs/Target" } }, "required": [ "plugin", "handler", "url" ] }, "result": { "type": "object", "properties": { "log": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "log" ] } }, "plugin.link_handler.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "handlers": { "type": "array", "items": { "type": "object", "properties": { "plugin_id": { "type": "string" }, "handler_id": { "type": "string" }, "title": { "type": "string" }, "pattern": { "type": "string" }, "action_id": { "type": "string" }, "available": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "plugin_id", "handler_id", "pattern", "available", "status" ] } } }, "required": [ "handlers" ] } }, "plugin.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "plugins": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "version": { "type": "string" }, "enabled": { "type": "boolean" }, "kind": { "anyOf": [ { "const": "actions" }, { "const": "process" }, { "type": "string" } ] }, "capabilities": {}, "status": {} }, "required": [ "id", "enabled" ] } } }, "required": [ "plugins" ] } }, "plugin.log.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "plugin": { "type": "string" }, "limit": { "type": "integer" } } }, "result": { "type": "object", "properties": { "logs": { "type": "array", "items": { "type": "object" } } }, "required": [ "logs" ] } }, "plugin.registry.notify": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "ok": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "ok" ] } }, "plugin.surface.close": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" } }, "required": [ "pane" ] }, "result": { "type": "object", "properties": { "closed": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "closed" ] } }, "preview.declare": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "port": { "anyOf": [ { "type": "integer" }, { "type": "string" } ] }, "path": { "type": "string", "default": "/" }, "scheme": { "type": "string", "enum": [ "http", "https" ], "default": "http" }, "label": { "type": "string" }, "pane": { "$ref": "#/$defs/Target" }, "task": { "$ref": "#/$defs/Target" }, "tls_origin": { "type": "boolean" } }, "required": [ "port" ] }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "preview" ] } }, "preview.dismiss": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "preview.forget": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "preview.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "preview.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "machine": { "type": "string" }, "task": { "$ref": "#/$defs/Target" }, "pane": { "$ref": "#/$defs/Target" }, "status": { "type": "string", "enum": [ "suggested", "declared", "up", "down", "gone", "all" ] }, "all": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "previews": { "type": "array", "items": { "$ref": "#/$defs/Preview" } }, "machine": { "type": "string" } }, "required": [ "previews" ] } }, "preview.mirror": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "machine": { "type": "string" }, "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "local_port": { "type": "integer" }, "addrs": { "type": "array", "items": { "type": "string" } }, "since_ms": { "type": "integer" }, "accepted": { "type": "integer" }, "rejected": { "type": "integer" }, "authenticated": { "type": "boolean" }, "peer_check": { "const": "same_user" }, "warning": { "type": "string" }, "url": { "type": "string" }, "already": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "machine", "preview", "preview_handle", "local_port", "addrs", "since_ms", "accepted", "rejected", "authenticated", "peer_check", "warning" ] } }, "preview.open": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "url": { "type": "string" }, "machine": { "type": "string" }, "mode": { "type": "string", "enum": [ "pane", "window", "proxy" ] }, "window": { "type": "boolean" }, "proxy": { "type": "boolean" }, "split": { "type": "string", "enum": [ "right", "down", "left", "up", "tab", "float" ] }, "pane": { "$ref": "#/$defs/Target" }, "focus": { "type": "boolean", "default": true }, "device": { "type": "string" }, "viewport": { "anyOf": [ { "type": "string" }, { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } }, "required": [ "width", "height" ] } ] }, "profile": { "type": "string" }, "no_open": { "type": "boolean", "default": false }, "open": { "type": "boolean" }, "tls_origin": { "type": "boolean" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "opened_in": { "const": "pane" }, "pane": { "type": "string" }, "pane_handle": { "type": "string" }, "tab": { "type": "string" }, "url": { "type": "string" }, "machine": { "type": "string" }, "source_pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "pane", "pane_handle", "tab", "url", "machine", "source_pane" ] }, { "type": "object", "properties": { "opened_in": { "const": "window" }, "url": { "type": "string" }, "machine": { "type": "string" }, "profile": { "type": "string" }, "profile_dir": { "type": "string" }, "browser": { "type": "string" }, "browser_kind": { "type": "string" }, "pid": { "type": "integer" }, "reused": { "type": "boolean" }, "socks_port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "route": { "type": "string", "enum": [ "none", "loopback", "remote" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "url", "machine", "profile", "profile_dir", "browser", "browser_kind", "pid", "reused", "socks_port", "route" ] }, { "type": "object", "properties": { "opened_in": { "const": "default_browser" }, "url": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "url" ] }, { "type": "object", "properties": { "opened_in": { "const": "proxy" }, "url": { "type": "string" }, "proxy_url": { "type": "string" }, "host": { "type": "string" }, "proxy_port": { "type": "integer" }, "machine": { "type": "string" }, "preview": { "type": "string" }, "opened": { "type": "boolean" }, "token_ttl_s": { "type": "integer" }, "session_ttl_s": { "type": "integer" }, "tls_origin": { "type": "boolean" }, "remote_url": { "type": "string" }, "caveats": { "type": "string" }, "ca": { "$ref": "#/$defs/PreviewCa" }, "open_url": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "opened_in", "url", "proxy_url", "host", "proxy_port", "machine", "preview", "opened", "token_ttl_s", "session_ttl_s", "tls_origin", "remote_url", "caveats" ] } ] } }, "preview.profile": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "list", "reset" ], "default": "list" }, "profile": { "type": "string" }, "machine": { "type": "string" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "profiles": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "running": { "type": "boolean" }, "pid": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "machine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "route": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bytes": { "type": "integer" } }, "required": [ "name", "path", "running", "pid", "machine", "route", "bytes" ] } }, "root": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "profiles", "root" ] }, { "type": "object", "properties": { "profile": { "type": "string" }, "removed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "profile", "removed" ] } ] } }, "preview.profile.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "profiles": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "running": { "type": "boolean" }, "pid": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "machine": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "route": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "bytes": { "type": "integer" } }, "required": [ "name", "path", "running", "pid", "machine", "route", "bytes" ] } }, "root": { "type": "string" } }, "required": [ "profiles", "root" ] } }, "preview.profile.reset": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "profile": { "type": "string" }, "machine": { "type": "string" } } }, "result": { "type": "object", "properties": { "profile": { "type": "string" }, "removed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "profile", "removed" ] } }, "preview.promote": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "preview" ] } }, "preview.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "socks_port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "browsers": { "type": "array", "items": { "type": "object", "properties": { "profile": { "type": "string" }, "machine": { "type": "string" }, "route": { "type": "string" }, "pid": { "type": "integer" }, "running": { "type": "boolean" } }, "required": [ "profile", "machine", "route", "pid", "running" ] } }, "links": { "type": "array", "items": { "type": "object", "properties": { "machine": { "type": "string" }, "connected": { "type": "boolean" }, "bytes_in": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "bytes_out": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "rtt_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] } }, "required": [ "machine", "connected", "bytes_in", "bytes_out", "rtt_ms" ] } }, "accepted": { "type": "integer" }, "rejected": { "type": "integer" }, "proxy": { "anyOf": [ { "type": "object", "properties": { "port": { "type": "integer" }, "tls": { "type": "boolean" }, "routes": { "type": "array", "items": { "type": "object", "properties": { "host": { "type": "string" }, "machine": { "type": "string" }, "preview": { "type": "string" }, "handle": { "type": "string" }, "port": { "type": "integer" }, "scheme": { "type": "string", "enum": [ "http", "https" ] }, "tls": { "type": "boolean" } }, "required": [ "host", "machine", "preview", "handle", "port", "scheme", "tls" ] } }, "stats": { "type": "object", "properties": { "requests": { "type": "integer" }, "denied": { "type": "integer" }, "websockets": { "type": "integer" } }, "required": [ "requests", "denied", "websockets" ] } }, "required": [ "port", "tls", "routes", "stats" ] }, { "type": "null" } ] }, "mirrors": { "type": "array", "items": { "$ref": "#/$defs/PreviewMirror" } } }, "required": [ "socks_port", "browsers", "links", "accepted", "rejected", "proxy", "mirrors" ] } }, "preview.unmirror": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "preview": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "integer" } ] }, "port": { "type": "integer" }, "machine": { "type": "string" } } }, "result": { "type": "object", "properties": { "local_port": { "type": "integer" }, "machine": { "type": "string" }, "preview": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "local_port", "machine", "preview" ] } }, "preview.url": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Target" }, "machine": { "type": "string" } }, "required": [ "preview" ] }, "result": { "type": "object", "properties": { "remote_url": { "type": "string" }, "profile_url": { "type": "string" }, "proxy_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "remote_url", "profile_url", "proxy_url" ] } }, "sandbox.allow": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "host": { "type": "string" } }, "required": [ "task", "host" ] }, "result": { "type": "object", "properties": { "task": { "type": "string" }, "allowed": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "allowed" ] } }, "sandbox.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "sandboxes": { "type": "array", "items": { "type": "object", "properties": { "sandbox": { "type": "string" }, "task": { "type": "string" }, "checkout": { "type": "string" }, "level": { "type": "string" }, "provider": { "type": "string" }, "network": {}, "yolo": { "type": "boolean" }, "proxy_port": { "type": "integer" }, "task_allow": {}, "credentials": {}, "container": { "type": "object", "properties": { "container": { "type": "string" }, "state": { "type": "string" }, "image": {}, "code": {}, "workdir": {}, "clone": { "type": "object", "properties": { "branch": { "type": "string" }, "base": { "type": "string" } }, "required": [ "branch", "base" ] }, "devcontainer": {}, "warnings": {}, "in_box_vibeke": {} }, "required": [ "container", "state", "image", "code", "workdir", "devcontainer", "warnings", "in_box_vibeke" ] } }, "required": [ "sandbox", "level", "network", "yolo", "credentials" ] } } }, "required": [ "sandboxes" ] } }, "sandbox.remove": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "force": { "type": "boolean", "default": false } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "container": { "type": "string" }, "action": { "type": "string" }, "sync": {}, "leftovers": {}, "error": { "type": "string" }, "unsynced_kept": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "container", "action", "sync", "leftovers", "unsynced_kept" ] } }, "sandbox.start": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "state": { "type": "string" }, "created": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "state", "created" ] } }, "sandbox.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "levels": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string" }, "available": { "type": "boolean" }, "detail": {}, "hint": { "type": "string" } }, "required": [ "level", "available" ] } }, "config": { "type": "object" }, "container": { "type": "object", "properties": { "runtime": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "docker_sandboxes": { "anyOf": [ { "type": "object", "properties": { "plugin": {}, "note": { "type": "string" } }, "required": [ "plugin", "note" ] }, { "type": "null" } ] }, "vibeke_linux": {}, "vibeke_linux_hint": { "type": "string" } }, "required": [ "vibeke_linux", "vibeke_linux_hint" ] } }, "required": [ "levels", "config", "container" ] } }, "sandbox.stop": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "state": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "state" ] } }, "screenshot.delete": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "id": { "type": "string" }, "force": { "type": "boolean" } }, "required": [ "id" ] }, "result": { "type": "object", "properties": { "id": { "type": "string" }, "handle": { "type": "string" }, "deleted": { "type": "boolean" }, "blob_removed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "id", "handle", "deleted", "blob_removed" ] } }, "screenshot.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ] }, "result": { "$ref": "#/$defs/ScreenshotMeta" } }, "screenshot.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "preview": { "$ref": "#/$defs/Target" }, "run": { "$ref": "#/$defs/Target" }, "since": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "since_ms": { "type": "integer" }, "limit": { "type": "integer", "default": 50 } } }, "result": { "type": "object", "properties": { "screenshots": { "type": "array", "items": { "$ref": "#/$defs/ScreenshotMeta" } }, "count": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "screenshots", "count", "total" ] } }, "screenshot.open": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ] }, "result": { "$ref": "#/$defs/ScreenshotMeta" } }, "scrollback.forget": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "workspace": { "$ref": "#/$defs/Target" }, "before": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "all": { "type": "boolean" }, "dry_run": { "type": "boolean", "default": false }, "plan": { "type": "string" } } }, "result": { "type": "object", "properties": { "scope": {}, "pane_ids": { "type": "array", "items": { "type": "string" } }, "plan": {}, "dry_run": { "type": "boolean" }, "panes": { "type": "integer" }, "segments_deleted": { "type": "integer" }, "bytes_deleted": { "type": "integer" }, "fts_rows_deleted": { "type": "integer" }, "archive_panes_dropped": { "type": "integer" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "scope", "pane_ids", "plan", "dry_run" ] } }, "search.query": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "q": { "type": "string" }, "scope": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "pane": { "$ref": "#/$defs/Target" }, "run": { "$ref": "#/$defs/Target" } } }, "sources": { "type": "array", "items": { "type": "string", "enum": [ "scrollback", "transcript", "events" ] } }, "limit": { "type": "integer", "default": 50 }, "regex": { "type": "boolean", "default": false } }, "required": [ "q" ] }, "result": { "type": "object", "properties": { "hits": { "type": "array", "items": { "type": "object", "properties": { "pane": { "type": "string" }, "run": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "source": { "type": "string" }, "line": {}, "text": { "type": "string" }, "ts": { "type": "integer" }, "context": {} }, "required": [ "source", "text" ] } } }, "required": [ "hits" ] } }, "server.reload_config": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object" }, "result": { "type": "object", "properties": { "changed": { "type": "array", "items": { "type": "string" } }, "errors": { "type": "array", "items": { "$ref": "#/$defs/ConfigDiagnostic" } }, "warnings": { "type": "array", "items": { "$ref": "#/$defs/ConfigWarning" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "changed", "errors" ] } }, "server.restart": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "binary": { "type": "string" } } }, "result": { "type": "object", "properties": { "new_pid": { "type": "integer" }, "binary": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "new_pid", "binary" ] } }, "server.status": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "pid": { "type": "integer" }, "version": { "type": "string" }, "uptime_ms": { "type": "integer" }, "session": { "type": "string" }, "machine": { "type": "string" }, "panes": { "type": "integer" }, "holders": { "type": "object", "properties": { "live": { "type": "integer" }, "orphaned": { "type": "integer" } }, "required": [ "live" ] }, "clients": { "type": "integer" }, "event_seq": { "type": "integer" }, "socket": { "type": "string" }, "degraded": {}, "preview": { "type": "object" }, "timers": { "type": "object" }, "db_size": { "type": "integer" }, "rss": { "type": "integer" } }, "required": [ "pid", "version", "uptime_ms", "session", "machine", "panes", "holders", "clients", "event_seq" ] } }, "server.stop": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "kill_panes": { "type": "boolean", "default": false } } }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "session.create": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ] }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/SessionEntry" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session" ] } }, "session.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "sessions": { "type": "array", "items": { "$ref": "#/$defs/SessionEntry" } } }, "required": [ "sessions" ] } }, "session.rename": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "name": { "type": "string" }, "new_name": { "type": "string" } }, "required": [ "name", "new_name" ] }, "result": { "type": "object", "properties": { "session": { "$ref": "#/$defs/SessionEntry" }, "previous_name": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "previous_name" ] } }, "session.snapshot": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "include": { "type": "array", "items": { "anyOf": [ { "const": "workspaces" }, { "const": "tabs" }, { "const": "panes" }, { "const": "runs" }, { "const": "interactions" }, { "const": "tasks" }, { "const": "previews" }, { "const": "layouts" }, { "const": "machines" }, { "const": "groups" }, { "type": "string" } ] } } } }, "result": { "type": "object", "properties": { "at_seq": { "type": "integer" }, "workspaces": { "type": "array", "items": { "$ref": "#/$defs/Workspace" } }, "groups": { "type": "array", "items": { "$ref": "#/$defs/Group" } }, "tabs": { "type": "array", "items": { "$ref": "#/$defs/Tab" } }, "panes": { "type": "array", "items": { "$ref": "#/$defs/Pane" } }, "runs": { "type": "array", "items": { "$ref": "#/$defs/AgentRun" } }, "interactions": { "type": "array", "items": { "$ref": "#/$defs/Interaction" } }, "tasks": { "type": "array", "items": { "$ref": "#/$defs/Task" } }, "previews": { "type": "array", "items": { "$ref": "#/$defs/Preview" } }, "layouts": { "type": "array", "items": {} }, "focused": { "type": "object", "additionalProperties": { "type": "object", "properties": { "workspace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tab": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "workspace", "tab", "pane" ] } } }, "required": [ "at_seq" ] } }, "session.stop": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "name": { "type": "string" }, "kill_panes": { "type": "boolean", "default": false } }, "required": [ "name" ] }, "result": { "type": "object", "properties": { "session": { "type": "object" }, "stopped": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "session", "stopped" ] } }, "status.segments": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "pane": { "$ref": "#/$defs/Target" }, "client": { "type": "string" } } }, "result": { "type": "object", "properties": { "segments": { "type": "object" }, "focus": {}, "appearance": { "$ref": "#/$defs/Appearance" }, "client_side": { "type": "array", "items": { "type": "string" } } }, "required": [ "segments", "focus", "appearance", "client_side" ] } }, "tab.close": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "force": { "type": "boolean" } }, "required": [ "tab" ] }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "tab.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "cwd": { "type": "string" }, "title": { "type": "string" }, "focus": { "type": "boolean", "default": false }, "command": { "type": "array", "items": { "type": "string" } }, "layout": { "$ref": "#/$defs/LayoutSpec" } } }, "result": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Tab" }, "root_pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tab", "root_pane" ] } }, "tab.floats": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "visible": { "type": "boolean" } } }, "result": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Tab" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tab" ] } }, "tab.focus": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "client": { "type": "string" } }, "required": [ "tab" ] }, "result": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Tab" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tab" ] } }, "tab.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "tabs": { "type": "array", "items": { "$ref": "#/$defs/Tab" } } }, "required": [ "tabs" ] } }, "tab.move": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "index": { "type": "integer" }, "workspace": { "$ref": "#/$defs/Target" } }, "required": [ "tab", "index" ] }, "result": { "type": "object", "properties": { "tabs": { "type": "array", "items": { "$ref": "#/$defs/Tab" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tabs" ] } }, "tab.rename": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Target" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "tab", "title" ] }, "result": { "type": "object", "properties": { "tab": { "$ref": "#/$defs/Tab" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "tab" ] } }, "task.check.authorize": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "check": { "type": "string" }, "subject": { "type": "string" }, "subject_id": { "type": "string" }, "definition_digest": { "type": "string" }, "idempotency_key": { "type": "string" } }, "required": [ "task", "check", "subject" ] }, "result": { "type": "object", "properties": { "grant": { "type": "object" }, "definition": { "type": "object" }, "provenance": {}, "subject": { "type": "string" }, "head_sha": { "type": "string" }, "confirmation_label": { "type": "string" }, "execution": { "type": "object", "properties": { "machine": {}, "runner": { "const": "host" }, "checkout": { "type": "string" } }, "required": [ "machine", "runner", "checkout" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "grant", "definition", "provenance", "subject", "head_sha", "confirmation_label", "execution" ] } }, "task.check.cancel": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "check_run": { "type": "string" } }, "required": [ "check_run" ] }, "result": { "type": "object", "properties": { "check_run": { "type": "object" }, "cancelling": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "check_run", "cancelling" ] } }, "task.check.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "check_run": { "type": "string" } }, "required": [ "check_run" ] }, "result": { "type": "object", "properties": { "check_run": { "type": "object" }, "definition": { "type": "object" }, "task": { "$ref": "#/$defs/Target" }, "log_tail": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "check_run", "definition", "task", "log_tail" ] } }, "task.check.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject": { "type": "string" }, "subject_id": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "checks": { "type": "array", "items": { "type": "object" } }, "confirmation_label": { "type": "string" } }, "required": [ "task", "subject", "checks", "confirmation_label" ] } }, "task.check.run": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "check": { "type": "string" }, "subject": { "type": "string" }, "subject_id": { "type": "string" }, "definition_digest": { "type": "string" }, "idempotency_key": { "type": "string" }, "authorize": { "type": "boolean" } }, "required": [ "task", "check", "subject" ] }, "result": { "type": "object", "properties": { "check_run": { "type": "object" }, "definition": { "type": "object" }, "provenance": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "check_run", "definition", "provenance" ] } }, "task.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "title": { "type": "string" }, "repo": { "type": "string" }, "base": { "type": "string" }, "isolation": { "type": "string", "enum": [ "worktree", "none", "auto" ] }, "slug": { "type": "string" }, "branch": { "type": "string" }, "agents": { "type": "array", "items": { "type": "object", "properties": { "harness": { "type": "string" }, "name": { "type": "string" }, "prompt": { "type": "string" } }, "required": [ "harness" ] } }, "setup": { "type": "boolean", "default": true }, "ports": { "type": "integer" }, "group": { "$ref": "#/$defs/Target" }, "root": { "type": "string" }, "branch_template": { "type": "string" }, "fetch": { "type": "boolean" }, "dry_run": { "type": "boolean", "default": false } }, "required": [ "title", "repo" ] }, "result": { "anyOf": [ { "type": "object", "properties": { "task": { "$ref": "#/$defs/Task" }, "workspace": { "$ref": "#/$defs/Workspace" }, "panes": { "type": "array", "items": { "$ref": "#/$defs/Pane" } }, "runs": { "type": "array", "items": { "$ref": "#/$defs/AgentRun" } }, "copied": { "type": "array", "items": { "type": "string" } }, "files": { "type": "array", "items": { "$ref": "#/$defs/MaterializedFile" } }, "deps": {}, "setup": { "type": "object", "properties": { "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "agents_pending": { "type": "boolean" }, "commands": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "command": { "type": "string" } }, "required": [ "source", "command" ] } } }, "required": [ "pane", "status", "agents_pending", "commands" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "workspace", "panes", "runs" ] }, { "type": "object", "properties": { "dry_run": { "const": true }, "title": { "type": "string" }, "repo_root": { "type": "string" }, "slug": { "type": "string" }, "plan": { "type": "object" }, "agents": {}, "setup": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "dry_run", "title", "repo_root", "slug", "plan", "agents", "setup" ] } ] } }, "task.dependency.add": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "depends_on": { "$ref": "#/$defs/Target" }, "kind": { "type": "string", "enum": [ "blocks", "related" ], "default": "blocks" }, "idempotency_key": { "type": "string" } }, "required": [ "task", "depends_on" ] }, "result": { "type": "object", "properties": { "edge": { "type": "object" }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "edge", "note" ] } }, "task.dependency.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } } }, "result": { "anyOf": [ { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "dependencies": { "type": "object", "properties": { "depends_on": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "edge": { "type": "object" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "edge", "title" ] }, { "type": "object", "properties": { "hidden": { "const": true }, "title": { "type": "string" }, "edge": { "type": "object", "properties": { "kind": { "type": "string" } }, "required": [ "kind" ] } }, "required": [ "hidden", "title", "edge" ] } ] } }, "dependents": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "edge": { "type": "object" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "edge", "title" ] }, { "type": "object", "properties": { "hidden": { "const": true }, "title": { "type": "string" }, "edge": { "type": "object", "properties": { "kind": { "type": "string" } }, "required": [ "kind" ] } }, "required": [ "hidden", "title", "edge" ] } ] } }, "blocks_open_tasks": { "type": "integer" }, "note": { "type": "string" } }, "required": [ "depends_on", "dependents", "blocks_open_tasks", "note" ] } }, "required": [ "task", "dependencies" ] }, { "type": "object", "properties": { "edges": { "type": "array", "items": { "type": "object" } } }, "required": [ "edges" ] } ] } }, "task.dependency.remove": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "anyOf": [ { "type": "object", "properties": { "edge": { "type": "string" } }, "required": [ "edge" ] }, { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "depends_on": { "$ref": "#/$defs/Target" }, "kind": { "type": "string", "enum": [ "blocks", "related" ] }, "idempotency_key": { "type": "string" } }, "required": [ "task", "depends_on" ] } ] }, "result": { "type": "object", "properties": { "removed": { "type": "array", "items": { "type": "object" } }, "removed_by": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "removed", "removed_by" ] } }, "task.effort.estimate": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "effort": { "type": "object", "properties": { "set": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "heuristic": {}, "note": { "type": "string" } }, "required": [ "set", "heuristic", "note" ] }, "model_estimate": { "type": "object", "properties": { "method": { "type": "string" }, "params": { "type": "object" }, "note": { "type": "string" } }, "required": [ "method", "params", "note" ] } }, "required": [ "task", "effort", "model_estimate" ] } }, "task.finish": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "remove_worktree": { "anyOf": [ { "const": "ask" }, { "type": "boolean" } ], "default": false }, "force": { "type": "boolean", "default": false }, "archive": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Task" }, "job": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task" ] } }, "task.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Task" }, "branch_status": { "anyOf": [ { "type": "object", "properties": { "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ahead": { "type": "integer" }, "behind": { "type": "integer" }, "dirty_files": { "type": "integer" }, "upstream": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "compared_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "branch", "ahead", "behind", "dirty_files", "upstream", "compared_to" ] }, { "type": "null" } ] }, "pr": { "anyOf": [ { "$ref": "#/$defs/PrLookup" }, { "type": "null" } ] } }, "required": [ "task", "branch_status" ] } }, "task.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "status": { "type": "string" }, "repo": { "type": "string" } } }, "result": { "type": "object", "properties": { "tasks": { "type": "array", "items": { "$ref": "#/$defs/Task" } } }, "required": [ "tasks" ] } }, "task.park": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Task" }, "stopped": { "type": "array", "items": { "type": "object", "properties": { "run": { "type": "string" }, "handle": { "type": "string" }, "pane": { "type": "string" }, "harness": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pane_closed": { "type": "boolean" }, "resumable": { "type": "boolean" } }, "required": [ "run", "handle", "pane", "harness", "name", "pane_closed", "resumable" ] } }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "stopped" ] } }, "task.pr": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "refresh": { "type": "boolean", "default": false } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "type": "string" }, "pr": { "$ref": "#/$defs/PrLookup" } }, "required": [ "task", "pr" ] } }, "task.reconcile": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "repo": { "type": "string" } } }, "result": { "type": "object", "properties": { "reports": { "type": "array", "items": { "type": "object", "properties": { "repo": { "type": "string" }, "missing": { "type": "array", "items": { "type": "object", "properties": { "task_id": { "type": "string" }, "path": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "task_id", "path", "reason" ] } }, "branch_moved": { "type": "array", "items": { "type": "object", "properties": { "task_id": { "type": "string" }, "path": { "type": "string" }, "expected": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actual": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "task_id", "path", "expected", "actual" ] } }, "orphans": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "kind": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "path", "kind", "branch" ] } } }, "required": [ "repo", "missing", "branch_moved", "orphans" ] } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "reports" ] } }, "task.resume": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Task" }, "resumed": { "type": "array", "items": { "$ref": "#/$defs/AgentRun" } }, "skipped": { "type": "array", "items": { "type": "object", "properties": { "run": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "run", "reason" ] } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "resumed", "skipped" ] } }, "task.review.accept": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject_id": { "type": "string" }, "intent_revision": { "type": "integer" }, "expected_intent_revision": { "type": "integer" }, "package_revision": { "type": "integer" }, "expected_package_revision": { "type": "integer" }, "exceptions": { "type": "array", "items": { "type": "object", "properties": { "criterion": { "type": "string" }, "criterion_id": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "criterion" ] } }, "idempotency_key": { "type": "string" } }, "required": [ "task", "subject_id", "intent_revision" ] }, "result": { "type": "object", "properties": { "acceptance": { "type": "object" }, "label": { "type": "string" }, "label_text": { "type": "string" }, "task": { "$ref": "#/$defs/Task" }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "acceptance", "label", "label_text", "task", "note" ] } }, "task.review.candidates": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "current": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "candidates": { "type": "array", "items": { "type": "object" } }, "inspect_only": {}, "no_end_candidate": {}, "review_base": {}, "warnings": { "type": "array", "items": { "type": "string" } } }, "required": [ "task", "current", "candidates", "inspect_only", "no_end_candidate", "review_base", "warnings" ] } }, "task.review.diff": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject": { "type": "string" }, "path": { "type": "string" }, "max_bytes": { "type": "integer" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject": { "type": "string" }, "base_sha": { "type": "string" }, "head_sha": { "type": "string" }, "content_sha": { "type": "string" }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "diff": { "type": "string" }, "truncated": { "type": "boolean" }, "total_bytes": { "type": "integer" }, "max_bytes": { "type": "integer" } }, "required": [ "task", "subject", "base_sha", "head_sha", "content_sha", "path", "diff", "truncated", "total_bytes", "max_bytes" ] } }, "task.review.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "subject": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "task_title": { "type": "string" }, "package_revision": { "type": "integer" }, "revision": { "type": "integer" }, "intent_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "intent": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "subject": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "subject_current": { "type": "boolean" }, "accept_capable": { "type": "boolean" }, "candidates": { "type": "array", "items": { "type": "object" } }, "inspect_only": {}, "no_end_candidate": {}, "review_base": {}, "baseline": {}, "warnings": { "type": "array", "items": { "type": "string" } }, "diff_stat": {}, "sources_verified": { "type": "boolean" }, "historical_only": { "type": "boolean" }, "observed_commands": { "type": "array", "items": { "type": "object" } }, "claims": { "type": "array", "items": { "type": "object" } }, "observed": { "type": "array", "items": { "type": "object" } }, "screenshots": { "type": "array", "items": { "$ref": "#/$defs/ScreenshotMeta" } }, "checks": { "type": "array", "items": { "type": "object" } }, "check_runs": { "type": "array", "items": { "type": "object" } }, "assessment": { "type": "object" }, "criteria": { "type": "array", "items": { "type": "object" } }, "blockers": {}, "label": { "type": "string" }, "label_text": { "type": "string" }, "readiness": { "type": "object", "properties": { "label": { "type": "string" }, "label_text": { "type": "string" } }, "required": [ "label", "label_text" ] }, "acceptance": { "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "acceptance_history": { "type": "array", "items": { "type": "object" } }, "live": { "type": "object" }, "mappings_confirmed": {}, "review_notes": { "type": "array", "items": { "type": "object" } }, "reviewer_runs": { "type": "array", "items": { "type": "object" } }, "dependencies": { "type": "object" }, "effort": { "type": "object", "properties": { "set": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "heuristic": {}, "note": { "type": "string" } }, "required": [ "set", "heuristic", "note" ] }, "snapshot": { "type": "object", "properties": { "available": { "type": "boolean" }, "method": { "type": "string" }, "note": { "type": "string" } }, "required": [ "available", "method", "note" ] }, "actions": { "type": "object", "properties": { "accept": { "type": "object", "properties": { "available": { "type": "boolean" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "requires_exceptions": {} }, "required": [ "available", "reason", "requires_exceptions" ] } }, "required": [ "accept" ] } }, "required": [ "task", "task_title", "package_revision", "revision", "intent_revision", "intent", "subject", "subject_current", "accept_capable", "candidates", "inspect_only", "no_end_candidate", "review_base", "baseline", "warnings", "diff_stat", "sources_verified", "historical_only", "observed_commands", "claims", "observed", "screenshots", "checks", "check_runs", "assessment", "criteria", "blockers", "label", "label_text", "readiness", "acceptance", "acceptance_history", "live", "mappings_confirmed", "review_notes", "reviewer_runs", "dependencies", "effort", "snapshot", "actions" ] } }, "task.review.note.classify": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "note": { "type": "string" }, "classification": { "type": "string", "enum": [ "blocking", "not_blocking", "dismissed" ] }, "reason": { "type": "string" }, "idempotency_key": { "type": "string" } }, "required": [ "note", "classification" ] }, "result": { "type": "object", "properties": { "note": { "type": "object" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "note" ] } }, "task.review.notes": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "notes": { "type": "array", "items": { "type": "object" } }, "reviewer_runs": { "type": "array", "items": { "type": "object" } } }, "required": [ "task", "notes", "reviewer_runs" ] } }, "task.review.request_reviewer": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "harness": { "type": "string", "default": "claude" }, "subject": { "type": "string" }, "expected_subject": { "type": "string" }, "prompt": { "type": "string" }, "idempotency_key": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" }, "prompt": { "type": "string" }, "prompt_digest": { "type": "string" }, "harness": { "type": "string" }, "subject": { "type": "string" }, "requires_confirmation": { "const": true }, "label": { "type": "string" }, "uses_provider": { "type": "string" }, "confirm_with": { "type": "object", "properties": { "method": { "type": "string" }, "params": { "type": "object", "properties": { "request": { "type": "string" }, "prompt_digest": { "type": "string" } }, "required": [ "request", "prompt_digest" ] } }, "required": [ "method", "params" ] }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "request", "prompt", "prompt_digest", "harness", "subject", "requires_confirmation", "label", "uses_provider", "confirm_with" ] } }, "task.review.snapshot": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "idempotency_key": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "subject": { "type": "object" }, "snapshot": { "type": "object" }, "label": { "type": "string" }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "subject", "snapshot", "label", "note" ] } }, "task.review.snapshot.gc": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "anyOf": [ { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "include_unrecorded": { "type": "boolean", "default": false }, "dry_run": { "type": "boolean", "default": false } }, "required": [ "task" ] }, { "type": "object", "properties": { "repo": { "type": "string" }, "include_unrecorded": { "type": "boolean", "default": false }, "dry_run": { "type": "boolean", "default": false } }, "required": [ "repo" ] } ] }, "result": { "type": "object", "properties": { "repo": { "type": "string" }, "task": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "null" } ] }, "dry_run": { "type": "boolean" }, "removed": { "type": "array", "items": { "type": "object" } }, "kept": { "type": "array", "items": { "type": "object" } }, "unrecorded": { "type": "array", "items": { "type": "object" } }, "note": { "type": "string" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "repo", "task", "dry_run", "removed", "kept", "unrecorded", "note" ] } }, "task.review.start_reviewer": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "request": { "type": "string" }, "prompt_digest": { "type": "string" }, "pane": { "$ref": "#/$defs/Target" }, "split_of": { "$ref": "#/$defs/Target" }, "direction": { "type": "string", "default": "right" }, "idempotency_key": { "type": "string" } }, "required": [ "request", "prompt_digest" ] }, "result": { "type": "object", "properties": { "request": { "type": "object" }, "run": { "$ref": "#/$defs/Target" }, "binding": { "type": "object" }, "note": { "type": "string" }, "replayed": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "request", "run", "binding" ] } }, "task.setup": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "setup_script": { "type": "string" } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "type": "string" }, "started": { "type": "boolean" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "setup_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commands": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "command": { "type": "string" } }, "required": [ "source", "command" ] } }, "needs_trust": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "started", "pane", "setup_status", "commands", "needs_trust" ] } }, "task.sync": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "task": { "$ref": "#/$defs/Target" }, "direction": { "type": "string", "enum": [ "pull", "push", "both" ], "default": "pull" }, "force": { "type": "boolean", "default": false } }, "required": [ "task" ] }, "result": { "type": "object", "properties": { "task": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "null" } ] }, "synced": { "type": "array", "items": { "type": "object", "properties": { "direction": { "type": "string" }, "status": { "type": "string" }, "commits": {}, "from": {}, "to": {}, "ref": {} }, "required": [ "direction", "status", "commits", "from", "to", "ref" ] } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "task", "synced" ] } }, "theme.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object" }, "result": { "type": "object", "properties": { "appearance": { "$ref": "#/$defs/Appearance" }, "colorfgbg": { "type": "string" }, "reports": {} }, "required": [ "appearance", "colorfgbg" ] } }, "theme.set_mode": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "mode": { "anyOf": [ { "const": "auto" }, { "const": "light" }, { "const": "dark" }, { "type": "null" } ] } }, "required": [ "mode" ] }, "result": { "type": "object", "properties": { "appearance": { "$ref": "#/$defs/Appearance" }, "colorfgbg": { "type": "string" }, "reports": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "appearance", "colorfgbg" ] } }, "workspace.close": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "force": { "type": "boolean", "default": false } } }, "result": { "type": "object", "properties": { "cursor": { "$ref": "#/$defs/Cursor" } } } }, "workspace.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "cwd": { "type": "string" }, "name": { "type": "string" }, "group": { "$ref": "#/$defs/Target" }, "focus": { "type": "boolean", "default": false }, "layout": { "$ref": "#/$defs/LayoutSpec" }, "command": { "type": "array", "items": { "type": "string" } } } }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "tab": { "$ref": "#/$defs/Tab" }, "root_pane": { "$ref": "#/$defs/Pane" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace", "tab", "root_pane" ] } }, "workspace.focus": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "client": { "type": "string" } }, "required": [ "workspace" ] }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace" ] } }, "workspace.get": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" } }, "required": [ "workspace" ] } }, "workspace.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "group": { "$ref": "#/$defs/Target" } } }, "result": { "type": "object", "properties": { "workspaces": { "type": "array", "items": { "$ref": "#/$defs/Workspace" } } }, "required": [ "workspaces" ] } }, "workspace.move": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "group": { "anyOf": [ { "$ref": "#/$defs/Target" }, { "type": "null" } ] }, "index": { "type": "integer" }, "delta": { "type": "integer" } }, "required": [ "workspace" ] }, "result": { "type": "object", "properties": { "workspaces": { "type": "array", "items": { "$ref": "#/$defs/Workspace" } }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspaces" ] } }, "workspace.rename": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Target" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ] }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace" ] } }, "worktree.create": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "repo": { "type": "string" }, "cwd": { "type": "string" }, "branch": { "type": "string" }, "path": { "type": "string" }, "base": { "type": "string" }, "open": { "type": "boolean" }, "focus": { "type": "boolean", "default": false } }, "required": [ "branch" ] }, "result": { "type": "object", "properties": { "worktree": {}, "workspace": { "$ref": "#/$defs/Workspace" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "worktree" ] } }, "worktree.list": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "repo": { "type": "string" }, "cwd": { "type": "string" } } }, "result": { "type": "object", "properties": { "worktrees": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "head": { "type": "string" }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workspace": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "locked": { "type": "boolean" }, "prunable": { "type": "boolean" } }, "required": [ "path", "branch", "head", "locked", "prunable" ] } } }, "required": [ "worktrees" ] } }, "worktree.open": { "mutating": true, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "path": { "type": "string" }, "focus": { "type": "boolean", "default": false } }, "required": [ "path" ] }, "result": { "type": "object", "properties": { "workspace": { "$ref": "#/$defs/Workspace" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "workspace" ] } }, "worktree.remove": { "mutating": true, "scope": "full", "pane_scope": "forbidden", "params": { "type": "object", "properties": { "path": { "type": "string" }, "force": { "type": "boolean", "default": false }, "dry_run": { "type": "boolean", "default": false } }, "required": [ "path" ] }, "result": { "anyOf": [ { "type": "object", "properties": { "job": {}, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "job" ] }, { "type": "object", "properties": { "dry_run": { "const": true }, "path": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "dirty_files": { "type": "integer" }, "unpushed_commits": { "type": "integer" }, "would_remove": { "type": "boolean" }, "force": { "type": "boolean" }, "cursor": { "$ref": "#/$defs/Cursor" } }, "required": [ "dry_run", "path", "branch", "dirty_files", "unpushed_commits", "would_remove", "force" ] } ] } }, "worktree.repo_root": { "mutating": false, "scope": "pane", "pane_scope": "open", "params": { "type": "object", "properties": { "cwd": { "type": "string" } }, "required": [ "cwd" ] }, "result": { "type": "object", "properties": { "repo_root": { "type": "string" }, "vcs": { "type": "string" } }, "required": [ "repo_root", "vcs" ] } } }, "x-events": { "adapter.disagreement": { "subject": { "type": "object", "properties": { "run": { "type": "string" } }, "required": [ "run" ] }, "data": { "type": "object", "properties": { "facet": { "type": "string" }, "structured": { "type": "string" }, "other": { "type": "string" } }, "required": [ "facet", "structured", "other" ] } }, "adapter.health_changed": { "subject": { "type": "object", "properties": { "run": { "type": "string" } }, "required": [ "run" ] }, "data": { "type": "object", "properties": { "to": { "type": "string" }, "from": { "type": "string" }, "transport": { "type": "string" } }, "required": [ "to" ] } }, "agent.detected": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "harness": { "type": "string" }, "via": { "type": "string" }, "argv0": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "harness", "via" ] } }, "agent.exited": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" }, "harness": { "type": "string" } }, "required": [ "reason", "harness" ] } }, "agent.file_changed": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "path": { "type": "string" }, "op": { "type": "string" } }, "required": [ "path", "op" ] } }, "agent.harness_version_unvalidated": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "harness": { "type": "string" }, "version": {} }, "required": [ "harness", "version" ] } }, "agent.identified": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "harness_session_id": {}, "transcript_path": {} } } }, "agent.named": { "subject": { "type": "object", "properties": { "run": { "type": "string" } }, "required": [ "run" ] }, "data": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ] } }, "agent.rate_limited": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "resets_at_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "resets_at_ms", "message" ] } }, "agent.resume_handle": { "subject": { "type": "object", "properties": { "run": { "type": "string" } }, "required": [ "run" ] }, "data": { "type": "object", "properties": { "argv": { "type": "array", "items": { "type": "string" } } }, "required": [ "argv" ] } }, "agent.session_ended": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ] } }, "agent.started": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "harness": { "type": "string" }, "via": { "type": "string" } }, "required": [ "harness" ] } }, "agent.state_changed": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "facet": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "source": { "type": "string" }, "confidence": { "type": "number" } }, "required": [ "facet", "to" ] } }, "agent.turn_completed": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "stop_reason": {}, "usage": {} } } }, "agent.turn_started": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": {} }, "agent.usage": { "subject": { "type": "object", "properties": { "run": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "run", "pane" ] }, "data": { "type": "object", "properties": { "input": { "type": "integer" }, "output": { "type": "integer" }, "cache_read": { "type": "integer" }, "cache_write": { "type": "integer" }, "cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "source": { "type": "string" } }, "required": [ "input", "output", "cache_read", "cache_write", "cost_usd", "source" ] } }, "assistant.consent_granted": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } } }, "data": {} }, "assistant.consent_revoked": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "grants": { "type": "integer" }, "cancelled": { "type": "integer" } }, "required": [ "grants", "cancelled" ] } }, "assistant.purged": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "count": { "type": "integer" }, "reason": { "type": "string" } }, "required": [ "count", "reason" ] } }, "assistant.request_finished": { "subject": { "type": "object", "properties": { "assistant_request": { "type": "string" } }, "required": [ "assistant_request" ] }, "data": {} }, "attention.preference_changed": { "subject": { "type": "object", "properties": { "key": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" } }, "required": [ "kind", "id" ] } }, "required": [ "key" ] }, "data": { "type": "object", "properties": { "seen": { "type": "boolean" }, "snoozed_until_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "pinned": { "type": "boolean" } }, "required": [ "seen", "snoozed_until_ms", "pinned" ] } }, "browser.navigated": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [ "url" ] } }, "browser.viewport_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "device": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "viewport": {} }, "required": [ "device", "viewport" ] } }, "check.authorized": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "check": { "type": "string" } }, "required": [ "task", "check" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "definition_digest": { "type": "string" }, "trust": {} }, "required": [ "subject", "definition_digest", "trust" ] } }, "check.queued": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "check": { "type": "string" }, "check_run": { "type": "string" } }, "required": [ "task", "check", "check_run" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "head": { "type": "string" } }, "required": [ "subject", "head" ] } }, "check.started": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "check": { "type": "string" }, "check_run": { "type": "string" } }, "required": [ "task", "check", "check_run" ] }, "data": { "type": "object" } }, "client.action": { "subject": { "type": "object", "properties": { "method": { "type": "string" }, "pane": {}, "target": {} }, "required": [ "method", "pane", "target" ] }, "data": {} }, "client.attached": { "subject": { "type": "object", "properties": { "client": { "type": "string" } }, "required": [ "client" ] }, "data": { "type": "object", "properties": { "kind": { "type": "string" }, "remote": { "type": "boolean" } }, "required": [ "kind", "remote" ] } }, "client.confirm_requested": { "subject": { "type": "object", "properties": { "confirm": { "type": "string" } }, "required": [ "confirm" ] }, "data": { "type": "object", "properties": { "title": { "type": "string" }, "body": {}, "options": {}, "timeout_ms": { "type": "integer" }, "from": { "type": "string" } }, "required": [ "title", "body", "options", "timeout_ms", "from" ] } }, "client.confirm_resolved": { "subject": { "type": "object", "properties": { "confirm": { "type": "string" } }, "required": [ "confirm" ] }, "data": { "type": "object", "properties": { "choice": {}, "timed_out": { "type": "boolean" } }, "required": [ "choice", "timed_out" ] } }, "client.detached": { "subject": { "type": "object", "properties": { "client": { "type": "string" } }, "required": [ "client" ] }, "data": { "type": "object", "properties": { "kind": { "type": "string" }, "remote": { "type": "boolean" } }, "required": [ "kind", "remote" ] } }, "client.devices_changed": { "subject": { "type": "object", "properties": { "client": { "type": "string" } }, "required": [ "client" ] }, "data": { "type": "object", "properties": { "devices": { "type": "integer" } }, "required": [ "devices" ] } }, "client.window_title_changed": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title" ] } }, "desk.forgotten": { "subject": { "type": "object", "properties": { "scope": {} }, "required": [ "scope" ] }, "data": { "type": "object", "properties": { "rows": { "type": "integer" }, "sessions": { "type": "integer" } }, "required": [ "rows", "sessions" ] } }, "draft.created": { "subject": { "type": "object", "properties": { "draft": { "type": "string" } } }, "data": {} }, "draft.deleted": { "subject": { "type": "object", "properties": { "draft": { "type": "string" } } }, "data": { "type": "object", "properties": { "rev": { "type": "integer" } }, "required": [ "rev" ] } }, "draft.delivery_unknown": { "subject": { "type": "object", "properties": { "draft": { "type": "string" } } }, "data": {} }, "draft.reordered": { "subject": { "type": "object", "properties": { "scope": { "type": "string" }, "scope_id": { "type": "string" }, "workspace": {} }, "required": [ "scope", "scope_id", "workspace" ] }, "data": { "type": "object", "properties": { "count": { "type": "integer" } }, "required": [ "count" ] } }, "draft.sending": { "subject": { "type": "object", "properties": { "draft": { "type": "string" } } }, "data": { "type": "object", "properties": { "send": { "type": "string" }, "run": { "type": "string" }, "include_notes": { "type": "boolean" }, "bytes": { "type": "integer" } }, "required": [ "send", "run", "include_notes", "bytes" ] } }, "draft.updated": { "subject": { "type": "object", "properties": { "draft": { "type": "string" } } }, "data": {} }, "group.closed": { "subject": { "type": "object", "properties": { "group": { "type": "string" } }, "required": [ "group" ] }, "data": { "type": "object" } }, "group.collapsed": { "subject": { "type": "object", "properties": { "group": { "type": "string" } }, "required": [ "group" ] }, "data": { "type": "object", "properties": { "collapsed": { "type": "boolean" } }, "required": [ "collapsed" ] } }, "group.created": { "subject": { "type": "object", "properties": { "group": { "type": "string" } }, "required": [ "group" ] }, "data": { "type": "object", "properties": { "name": { "type": "string" }, "parent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "parent" ] } }, "group.moved": { "subject": { "type": "object", "properties": { "group": { "type": "string" } }, "required": [ "group" ] }, "data": { "type": "object", "properties": { "parent": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "index": { "type": "integer" } }, "required": [ "parent", "index" ] } }, "group.renamed": { "subject": { "type": "object", "properties": { "group": { "type": "string" } }, "required": [ "group" ] }, "data": { "type": "object", "properties": { "name": { "type": "string" } }, "required": [ "name" ] } }, "interaction.cancelled": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "interaction", "pane" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ] } }, "interaction.decided": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" }, "run": { "type": "string" } }, "required": [ "interaction", "pane", "run" ] }, "data": { "type": "object", "properties": { "rev": { "type": "integer" }, "by": { "type": "string" }, "decision": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "channel": { "type": "string" } }, "required": [ "rev", "by", "decision" ] } }, "interaction.delivery_unknown": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "interaction", "pane" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" } }, "required": [ "reason" ] } }, "interaction.expired": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "interaction" ] }, "data": {} }, "interaction.opened": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" }, "run": { "type": "string" } } }, "data": {} }, "interaction.updated": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" }, "pane": { "type": "string" } }, "required": [ "interaction", "pane" ] }, "data": { "type": "object", "properties": { "gate": { "type": "boolean" }, "reason": { "type": "string" } } } }, "layout.applied": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tabs": { "type": "integer" }, "panes": { "type": "integer" }, "new_workspace": {} }, "required": [ "name", "tabs", "panes", "new_workspace" ] } }, "notes.updated": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "rev": { "type": "integer" }, "bytes": { "type": "integer" } }, "required": [ "rev", "bytes" ] } }, "notification.created": { "subject": { "type": "object", "properties": { "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "title": { "type": "string" }, "body": { "type": "string" }, "urgency": { "type": "string" } }, "required": [ "id", "kind", "title", "body", "urgency" ] } }, "pane.closed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" } } } }, "pane.created": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object" } }, "pane.cwd_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "cwd" ] } }, "pane.exited": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "signal": {}, "reason": { "type": "string" }, "respawn_error": { "type": "string" } } } }, "pane.focused": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "client": { "type": "string" } } } }, "pane.input_unconfirmed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "run": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "input_id": { "type": "string" }, "reason": { "type": "string" }, "preview_chars": { "type": "integer" } }, "required": [ "input_id" ] } }, "pane.isolation_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "level": { "type": "string" }, "scope": { "type": "string" }, "network": { "type": "string" } }, "required": [ "level", "scope", "network" ] } }, "pane.marked_unread": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "marked": { "type": "boolean" } }, "required": [ "marked" ] } }, "pane.moved": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "from_tab_id": { "type": "string" }, "to_tab_id": { "type": "string" } }, "required": [ "from_tab_id", "to_tab_id" ] } }, "pane.output_matched": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "matched": {}, "revision": {} }, "required": [ "matched", "revision" ] } }, "pane.pinned": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "pinned": { "type": "boolean" } }, "required": [ "pinned" ] } }, "pane.process_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "fg_cmdline": { "type": "array", "items": { "type": "string" } } }, "required": [ "fg_cmdline" ] } }, "pane.recovered": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "method": { "type": "string" } }, "required": [ "method" ] } }, "pane.scroll_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "offset": { "type": "integer" }, "total": { "type": "integer" }, "client": { "type": "string" } }, "required": [ "offset", "total" ] } }, "pane.scroll_requested": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "offset": { "type": "integer" }, "total": { "type": "integer" }, "client": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "offset", "total", "client" ] } }, "pane.seen": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object" } }, "pane.title_changed": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title" ] } }, "paste.translated": { "subject": { "type": "object", "properties": { "pane": { "type": "string" }, "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "blob": { "type": "string" }, "bytes": { "type": "integer" }, "local_name": { "type": "string" }, "dir": { "type": "boolean" } }, "required": [ "blob", "bytes", "local_name", "dir" ] } }, "target_namespace": { "type": "string" } }, "required": [ "files", "target_namespace" ] } }, "policy.repo_trusted": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "repo": { "type": "string" }, "digest": { "type": "string" }, "devcontainer_digest": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repo", "digest" ] } }, "policy.rule_matched": { "subject": { "type": "object", "properties": { "interaction": { "type": "string" } }, "required": [ "interaction" ] }, "data": { "type": "object", "properties": { "effect": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "effect" ] } }, "preview.console_error": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_id": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_id", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "count": { "type": "integer" }, "source": { "type": "string" }, "text": { "type": "string" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "line": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "session": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "count", "source", "text", "url", "line", "session" ] } }, "preview.declared": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_handle", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "preview.discovered": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_handle", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "preview.down": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_handle", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "preview.gone": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_handle", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "preview.mirrored": { "subject": { "type": "object", "properties": { "machine": { "type": "string" }, "preview": { "type": "string" }, "preview_handle": { "type": "string" } }, "required": [ "machine", "preview", "preview_handle" ] }, "data": { "type": "object", "properties": { "local_port": { "type": "integer" }, "url": { "type": "string" }, "warning": { "type": "string" } }, "required": [ "local_port", "url", "warning" ] } }, "preview.opened": { "subject": { "type": "object", "properties": { "machine": { "type": "string" }, "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } }, "data": { "type": "object", "properties": { "url": { "type": "string" }, "opened_in": { "anyOf": [ { "const": "pane" }, { "const": "window" }, { "const": "proxy" }, { "type": "string" } ] }, "profile": { "type": "string" }, "browser": { "type": "string" }, "tls_origin": { "type": "boolean" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "url", "opened_in" ] } }, "preview.unmirrored": { "subject": { "type": "object", "properties": { "machine": { "type": "string" }, "preview": { "type": "string" }, "preview_handle": { "type": "string" } }, "required": [ "machine", "preview", "preview_handle" ] }, "data": { "type": "object", "properties": { "local_port": { "type": "integer" } }, "required": [ "local_port" ] } }, "preview.up": { "subject": { "type": "object", "properties": { "preview": { "type": "string" }, "preview_handle": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "machine": { "type": "string" } }, "required": [ "preview", "preview_handle", "pane", "task", "machine" ] }, "data": { "type": "object", "properties": { "preview": { "$ref": "#/$defs/Preview" } }, "required": [ "preview" ] } }, "review.accepted": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": {} }, "review.candidate_created": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "head": { "type": "string" }, "source": { "type": "string" } }, "required": [ "subject", "head", "source" ] } }, "review.end_candidate_pinned": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "binding": { "type": "string" }, "run": { "type": "string" } }, "required": [ "task", "binding", "run" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "head": { "type": "string" }, "note": {} }, "required": [ "subject", "head", "note" ] } }, "review.invalidated": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "acceptance": { "type": "string" } }, "required": [ "task", "acceptance" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "reasons": {} }, "required": [ "subject", "reasons" ] } }, "review.label_changed": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "from": {}, "to": {} }, "required": [ "from", "to" ] } }, "review.note_classified": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "note": { "type": "string" } }, "required": [ "task", "note" ] }, "data": {} }, "review.notes_recorded": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "run": { "type": "string" }, "binding": { "type": "string" } }, "required": [ "task", "run", "binding" ] }, "data": { "type": "object", "properties": { "turn": {}, "count": { "type": "integer" }, "subject": {}, "open_concerns": {} }, "required": [ "turn", "count", "subject", "open_concerns" ] } }, "review.reviewer_requested": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "request": { "type": "string" } }, "required": [ "task", "request" ] }, "data": {} }, "review.reviewer_started": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "request": { "type": "string" }, "run": { "type": "string" } }, "required": [ "task", "request", "run" ] }, "data": { "type": "object", "properties": { "subject": { "type": "string" }, "harness": { "type": "string" }, "binding": { "type": "string" }, "prompt_digest": { "type": "string" } }, "required": [ "subject", "harness", "binding", "prompt_digest" ] } }, "review.reviewer_unknown": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "request": { "type": "string" } }, "required": [ "task", "request" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" }, "subject": { "type": "string" } }, "required": [ "reason", "subject" ] } }, "review.snapshot_created": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "subject": { "type": "string" } }, "required": [ "task", "subject" ] }, "data": { "type": "object", "properties": { "head": { "type": "string" }, "content": { "type": "string" }, "ref": { "type": "string" }, "attempts": {} }, "required": [ "head", "content", "ref", "attempts" ] } }, "review.snapshot_refs_removed": { "subject": { "type": "object", "properties": { "repo": { "type": "string" }, "task": {} }, "required": [ "repo", "task" ] }, "data": {} }, "sandbox.created": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "sandbox": { "type": "string" } }, "required": [ "task", "sandbox" ] }, "data": { "type": "object", "properties": { "level": { "type": "string" }, "provider": { "type": "string" }, "network": { "type": "string" }, "yolo": { "type": "boolean" }, "proxy_port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "credentials": {} }, "required": [ "level", "provider", "network", "yolo" ] } }, "screenshot.captured": { "subject": { "type": "object", "properties": { "machine": { "type": "string" } } }, "data": {} }, "screenshot.deleted": { "subject": { "type": "object", "properties": { "machine": { "type": "string" } }, "required": [ "machine" ] }, "data": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "string" } } }, "required": [ "ids" ] } }, "scrollback.forgotten": { "subject": { "type": "object", "properties": { "scope": {} }, "required": [ "scope" ] }, "data": { "type": "object", "properties": { "panes": { "type": "integer" }, "segments": { "type": "integer" }, "bytes": { "type": "integer" }, "fts_rows": { "type": "integer" }, "panes_dropped": { "type": "integer" } }, "required": [ "panes", "segments", "bytes", "fts_rows", "panes_dropped" ] } }, "security.rate_limited": { "subject": { "type": "object", "properties": { "pane": { "type": "string" } }, "required": [ "pane" ] }, "data": { "type": "object", "properties": { "method": { "type": "string" }, "limit": { "type": "string", "enum": [ "requests", "spawn", "depth", "descendants" ] } }, "required": [ "method", "limit" ] } }, "session.config_rejected": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "errors": { "type": "array", "items": { "$ref": "#/$defs/ConfigDiagnostic" } }, "source": { "const": "watch" } }, "required": [ "errors", "source" ] } }, "session.config_reloaded": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "changed_keys": { "type": "array", "items": { "type": "string" } }, "new_panes_only": { "type": "array", "items": { "type": "string" } }, "source": { "type": "string", "enum": [ "watch", "api", "set", "set_persist" ] } }, "required": [ "changed_keys", "new_panes_only", "source" ] } }, "session.server_restarted": { "subject": { "type": "object" }, "data": { "type": "object", "properties": { "recovered_panes": { "type": "integer" }, "pid": { "type": "integer" }, "prev_pid": { "type": "integer" } } } }, "tab.closed": { "subject": { "type": "object", "properties": { "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "tab", "workspace" ] }, "data": { "type": "object" } }, "tab.created": { "subject": { "type": "object", "properties": { "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "tab", "workspace" ] }, "data": { "type": "object", "properties": { "number": { "type": "integer" } }, "required": [ "number" ] } }, "tab.layout_changed": { "subject": { "type": "object", "properties": { "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "tab" ] }, "data": { "type": "object", "properties": { "floated": { "type": "string" } } } }, "tab.moved": { "subject": { "type": "object", "properties": { "tab": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "tab", "workspace" ] }, "data": { "type": "object", "properties": { "index": { "type": "integer" } }, "required": [ "index" ] } }, "tab.renamed": { "subject": { "type": "object", "properties": { "tab": { "type": "string" } }, "required": [ "tab" ] }, "data": { "type": "object", "properties": { "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title" ] } }, "task.agents_withheld": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "reason": { "type": "string" }, "hint": { "type": "string" } }, "required": [ "reason", "hint" ] } }, "task.binding_changed": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "run": { "type": "string" }, "binding": { "type": "string" } }, "required": [ "task", "run", "binding" ] }, "data": { "type": "object", "properties": { "state": { "type": "string" }, "reason": { "type": "string" }, "offers": { "type": "array", "items": { "type": "string" } } }, "required": [ "state" ] } }, "task.branch_changed": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "path": { "type": "string" }, "expected": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actual": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "path", "expected", "actual" ] } }, "task.created": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "workspace": { "type": "string" } }, "required": [ "task", "workspace" ] }, "data": { "type": "object", "properties": { "title": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "title", "branch", "path" ] } }, "task.dependency_changed": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "depends_on": { "type": "string" }, "edge": { "type": "string" } }, "required": [ "task", "depends_on", "edge" ] }, "data": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "added", "removed" ] }, "kind": { "type": "string" } }, "required": [ "action", "kind" ] } }, "task.files_materialized": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "files": { "type": "array", "items": { "$ref": "#/$defs/MaterializedFile" } }, "deps": {} }, "required": [ "files", "deps" ] } }, "task.finished": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "status": { "type": "string" }, "attached": { "type": "boolean" }, "reviewed": {} }, "required": [ "status", "attached", "reviewed" ] } }, "task.intent_updated": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "revision": { "type": "integer" }, "previous": {} }, "required": [ "revision", "previous" ] } }, "task.message_delivery_unknown": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "message": { "type": "string" } }, "required": [ "task", "message" ] }, "data": { "type": "object", "properties": { "detail": {} }, "required": [ "detail" ] } }, "task.message_prepared": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "message": { "type": "string" } }, "required": [ "task", "message" ] }, "data": { "type": "object", "properties": { "run": { "type": "string" } }, "required": [ "run" ] } }, "task.message_sending": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "message": { "type": "string" } }, "required": [ "task", "message" ] }, "data": { "type": "object" } }, "task.missing": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "path": { "type": "string" }, "reason": { "type": "string" }, "hint": { "type": "string" } }, "required": [ "path", "reason", "hint" ] } }, "task.parked": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "runs": { "type": "integer" }, "attached": { "type": "boolean" } }, "required": [ "runs" ] } }, "task.recovered": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "path" ] } }, "task.resumed": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "runs": { "type": "integer" }, "skipped": { "type": "integer" } }, "required": [ "runs", "skipped" ] } }, "task.setup_failed": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "status": { "type": "string" }, "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "duration_ms": { "type": "integer" }, "log": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "status" ] } }, "task.setup_finished": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "status": { "type": "string" }, "exit_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "duration_ms": { "type": "integer" }, "log": { "type": "string" }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "status" ] } }, "task.setup_started": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "commands": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "command": { "type": "string" } }, "required": [ "source", "command" ] } }, "pane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "commands", "pane" ] } }, "task.setup_untrusted": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "repo": { "type": "string" }, "digest": { "type": "string" }, "script": { "type": "string" }, "hint": { "type": "string" }, "commands": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "command": { "type": "string" } }, "required": [ "source", "command" ] } } }, "required": [ "repo", "digest", "script", "hint" ] } }, "task.status_changed": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "status": { "type": "string" } }, "required": [ "status" ] } }, "task.tracked": { "subject": { "type": "object", "properties": { "task": { "type": "string" }, "run": { "type": "string" } }, "required": [ "task", "run" ] }, "data": { "type": "object", "properties": { "intent_revision": { "type": "integer" }, "binding": { "type": "string" }, "start_turn": {} }, "required": [ "intent_revision", "binding", "start_turn" ] } }, "task.updated": { "subject": { "type": "object", "properties": { "task": { "type": "string" } }, "required": [ "task" ] }, "data": { "type": "object", "properties": { "priority": {}, "effort": {}, "effort_source": { "type": "string" } } } }, "theme.changed": { "subject": { "type": "object" }, "data": {} }, "workspace.closed": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object" } }, "workspace.created": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "cwd": { "type": "string" } } } }, "workspace.moved": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "group": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } } } }, "workspace.renamed": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ] } }, "worktree.created": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } } }, "data": {} }, "worktree.opened": { "subject": { "type": "object", "properties": { "workspace": { "type": "string" } }, "required": [ "workspace" ] }, "data": { "type": "object", "properties": { "path": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo_root": { "type": "string" }, "created_workspace": {} }, "required": [ "path", "branch", "repo_root" ] } }, "worktree.orphan_found": { "subject": { "type": "object", "properties": { "repo": { "type": "string" } }, "required": [ "repo" ] }, "data": { "type": "object", "properties": { "path": { "type": "string" }, "kind": { "type": "string" }, "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hint": { "type": "string" } }, "required": [ "path", "kind", "branch", "hint" ] } }, "worktree.removed": { "subject": { "type": "object", "properties": { "path": { "type": "string" }, "task": { "type": "string" } }, "required": [ "path" ] }, "data": { "type": "object", "properties": { "job": { "type": "string" }, "state": { "type": "string" } }, "required": [ "state" ] } } }, "x-notifications": { "events.event": { "params": { "type": "object", "properties": { "subscription_id": { "type": "string" }, "event": { "$ref": "#/$defs/Event" } }, "required": [ "subscription_id", "event" ] } }, "events.overflow": { "params": { "type": "object", "properties": { "subscription_id": { "type": "string" }, "resume_from": { "$ref": "#/$defs/Cursor" } }, "required": [ "subscription_id", "resume_from" ] } } }, "x-errors": [ { "kind": "parse_error", "code": -32700, "retryable": false, "details": null }, { "kind": "invalid_request", "code": -32600, "retryable": false, "details": null }, { "kind": "method_not_found", "code": -32601, "retryable": false, "details": null }, { "kind": "invalid_params", "code": -32602, "retryable": false, "details": null }, { "kind": "not_found", "code": -32001, "retryable": false, "details": { "type": "object", "properties": { "object": { "type": "string" }, "id": { "type": "string" } } } }, { "kind": "ambiguous_target", "code": -32002, "retryable": false, "details": null }, { "kind": "permission_denied", "code": -32003, "retryable": false, "details": { "type": "object", "properties": { "scope": { "type": "string" } } } }, { "kind": "conflict", "code": -32004, "retryable": false, "details": { "type": "object", "properties": { "reason": { "type": "string" } } } }, { "kind": "timeout", "code": -32005, "retryable": false, "details": { "type": "object", "properties": { "last_state": {} } } }, { "kind": "stalled", "code": -32006, "retryable": false, "details": null }, { "kind": "unsupported", "code": -32007, "retryable": false, "details": { "type": "object", "properties": { "fallback": {} } } }, { "kind": "remote_unavailable", "code": -32008, "retryable": true, "details": null }, { "kind": "rate_limited", "code": -32009, "retryable": true, "details": null }, { "kind": "truncated", "code": -32010, "retryable": false, "details": { "type": "object", "properties": { "earliest_seq": { "type": "integer" } } } }, { "kind": "invalid_key", "code": -32011, "retryable": false, "details": { "type": "object", "properties": { "key": { "type": "string" } } } }, { "kind": "untrusted", "code": -32012, "retryable": false, "details": null }, { "kind": "storage_unavailable", "code": -32013, "retryable": false, "details": null }, { "kind": "internal", "code": -32050, "retryable": false, "details": { "type": "object", "properties": { "trace_id": { "type": "string" } } } } ] }