@av-pi-studio/protocol 0.0.114 → 0.0.116

package/fixtures/external-clients/daemon_status_update.json

@@ -0,0 +1,58 @@
+{
+  "type": "daemon_status_update",
+  "direction": "server_to_client",
+  "description": "Flat status push to subscribed sessions only, every 5 s; carries no requestId.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": [
+    "/message/payload/version",
+    "/message/payload/startedAt",
+    "/message/payload/uptimeMs",
+    "/message/payload/pid",
+    "/message/payload/nodeVersion",
+    "/message/payload/memory/rss",
+    "/message/payload/memory/heapUsed",
+    "/message/payload/memory/heapTotal",
+    "/message/payload/cpuPercent",
+    "/message/payload/eventLoopLagMs",
+    "/message/payload/agentsByStatus/idle",
+    "/message/payload/clients/0/clientId",
+    "/message/payload/clients/0/appVersion",
+    "/message/payload/clients/0/connectedAt",
+    "/message/payload/clients/0/remoteAddress"
+  ],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_update",
+      "payload": {
+        "version": "0.0.115",
+        "startedAt": 1767225600000,
+        "uptimeMs": 7520.5,
+        "pid": 4242,
+        "nodeVersion": "v24.0.0",
+        "memory": {
+          "rss": 172122112,
+          "heapUsed": 65642672,
+          "heapTotal": 115298304
+        },
+        "cpuPercent": 1.5,
+        "eventLoopLagMs": 0.5,
+        "agentsByStatus": {
+          "idle": 2
+        },
+        "clients": [
+          {
+            "clientId": "client-1",
+            "clientType": "cli",
+            "appVersion": "pistudiodashboard/0.1.0",
+            "connectedAt": 1767225600000,
+            "remoteAddress": "127.0.0.1",
+            "transport": "direct"
+          }
+        ]
+      }
+    }
+  }
+}

package/fixtures/external-clients/fetch_agent_timeline_request.json

@@ -0,0 +1,19 @@
+{
+  "type": "fetch_agent_timeline_request",
+  "direction": "client_to_server",
+  "description": "Page one agent's timeline (cursor omitted = from the start).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "fetch_agent_timeline_request",
+      "requestId": "req-1",
+      "agentId": "agent-1",
+      "direction": "after",
+      "limit": 100
+    }
+  }
+}

package/fixtures/external-clients/fetch_agent_timeline_response.json

@@ -0,0 +1,55 @@
+{
+  "type": "fetch_agent_timeline_response",
+  "direction": "server_to_client",
+  "description": "One page of timeline items (items hold one representative element).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": [
+    "/message/requestId",
+    "/message/agentId",
+    "/message/items/0/sourceSeq",
+    "/message/items/0/timestamp",
+    "/message/items/0/event/messageId",
+    "/message/seqStart",
+    "/message/seqEnd",
+    "/message/sourceSeqRanges/0/start",
+    "/message/sourceSeqRanges/0/end",
+    "/message/startCursor",
+    "/message/endCursor",
+    "/message/collapsed",
+    "/message/hasNewer"
+  ],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "fetch_agent_timeline_response",
+      "requestId": "req-1",
+      "agentId": "00000000-0000-4000-8000-000000000001",
+      "items": [
+        {
+          "kind": "other",
+          "sourceSeq": 0,
+          "timestamp": "2026-01-01T00:00:00.000Z",
+          "event": {
+            "kind": "user_message",
+            "messageId": "00000000-0000-4000-8000-000000000002",
+            "text": "hello"
+          }
+        }
+      ],
+      "seqStart": 0,
+      "seqEnd": 27,
+      "sourceSeqRanges": [
+        {
+          "start": 0,
+          "end": 27
+        }
+      ],
+      "collapsed": true,
+      "hasNewer": false,
+      "startCursor": "0",
+      "endCursor": "27"
+    }
+  }
+}

package/fixtures/external-clients/health.json

@@ -0,0 +1,16 @@
+{
+  "type": "health",
+  "direction": "http",
+  "description": "GET /api/health, unauthenticated: HTTP status, content type and body.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": [],
+  "frame": {
+    "status": 200,
+    "contentType": "application/json",
+    "body": {
+      "status": "ok"
+    }
+  }
+}

package/fixtures/external-clients/hello.json

@@ -0,0 +1,19 @@
+{
+  "type": "hello",
+  "direction": "client_to_server",
+  "description": "Handshake: the first frame on a connection. The daemon answers with the status.server_info frame.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/clientId"],
+  "frame": {
+    "type": "hello",
+    "clientId": "client-1",
+    "clientType": "cli",
+    "protocolVersion": 1,
+    "appVersion": "pistudiodashboard/0.1.0",
+    "capabilities": {
+      "reasoning_merge_enum": true
+    }
+  }
+}

package/fixtures/external-clients/interrupt_agent.json

@@ -0,0 +1,17 @@
+{
+  "type": "interrupt_agent",
+  "direction": "client_to_server",
+  "description": "Interrupt the agent's running turn.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "interrupt_agent",
+      "requestId": "req-1",
+      "agentId": "agent-1"
+    }
+  }
+}

package/fixtures/external-clients/interrupt_response.json

@@ -0,0 +1,18 @@
+{
+  "type": "interrupt_response",
+  "direction": "server_to_client",
+  "description": "Result of interrupt_agent (no Zod schema).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/agentId", "/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "interrupt_response",
+      "agentId": "00000000-0000-4000-8000-000000000001",
+      "ok": true,
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/list_agents_request.json

@@ -0,0 +1,16 @@
+{
+  "type": "list_agents_request",
+  "direction": "client_to_server",
+  "description": "List every known agent.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "list_agents_request",
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/list_agents_response.json

@@ -0,0 +1,39 @@
+{
+  "type": "list_agents_response",
+  "direction": "server_to_client",
+  "description": "Directory of agents. Built inline in the daemon bootstrap (no Zod schema).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": [
+    "/message/requestId",
+    "/message/agents/0/agentId",
+    "/message/agents/0/lastActivity",
+    "/message/agents/0/status",
+    "/message/agents/0/title",
+    "/message/agents/0/cwd",
+    "/message/agents/0/provider",
+    "/message/agents/0/model",
+    "/message/agents/0/thinkingLevel"
+  ],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "list_agents_response",
+      "requestId": "req-1",
+      "agents": [
+        {
+          "agentId": "00000000-0000-4000-8000-000000000001",
+          "status": "idle",
+          "title": "hello",
+          "cwd": "/tmp",
+          "labels": {},
+          "lastActivity": 1767225600000,
+          "provider": "mock",
+          "model": "mock-model",
+          "thinkingLevel": "off"
+        }
+      ]
+    }
+  }
+}

package/fixtures/external-clients/manifest.json

@@ -0,0 +1,321 @@
+{
+  "formatVersion": 1,
+  "messages": [
+    {
+      "file": "agent_archived.json",
+      "type": "agent_archived",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_deleted.json",
+      "type": "agent_deleted",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_session_stats_request.json",
+      "type": "agent_session_stats_request",
+      "direction": "client_to_server",
+      "response": "agent_session_stats_response.json"
+    },
+    {
+      "file": "agent_session_stats_response.json",
+      "type": "agent_session_stats_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_status.json",
+      "type": "agent_status",
+      "direction": "server_to_client",
+      "exception": "no daemon producer (schema only)"
+    },
+    {
+      "file": "agent_stream.assistant_message.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.compaction.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.error.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.reasoning.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.tool_call.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.tool_call.partial.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.turn_canceled.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.turn_completed.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.turn_failed.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.turn_started.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_stream.user_message.json",
+      "type": "agent_stream",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_timeline_reset.json",
+      "type": "agent_timeline_reset",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_list_request.json",
+      "type": "agent_ui_list_request",
+      "direction": "client_to_server",
+      "response": "agent_ui_list_response.json"
+    },
+    {
+      "file": "agent_ui_list_response.json",
+      "type": "agent_ui_list_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.confirm.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.editor.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.input.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.notify.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.select.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.setStatus.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_request.setStatus.removed.json",
+      "type": "agent_ui_request",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_resolved.aborted.json",
+      "type": "agent_ui_resolved",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_resolved.answered.json",
+      "type": "agent_ui_resolved",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_resolved.cancelled.json",
+      "type": "agent_ui_resolved",
+      "direction": "server_to_client",
+      "exception": "no daemon producer (open-string reason, schema only)"
+    },
+    {
+      "file": "agent_ui_resolved.timeout.json",
+      "type": "agent_ui_resolved",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_respond_request.confirm.json",
+      "type": "agent_ui_respond_request",
+      "direction": "client_to_server",
+      "response": "agent_ui_respond_response.ok.json"
+    },
+    {
+      "file": "agent_ui_respond_request.select.json",
+      "type": "agent_ui_respond_request",
+      "direction": "client_to_server",
+      "response": "agent_ui_respond_response.ok.json"
+    },
+    {
+      "file": "agent_ui_respond_response.not_found.json",
+      "type": "agent_ui_respond_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_ui_respond_response.ok.json",
+      "type": "agent_ui_respond_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_update.json",
+      "type": "agent_update",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "agent_update.model.json",
+      "type": "agent_update",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_log_lines.json",
+      "type": "daemon_log_lines",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_logs_subscribe_request.json",
+      "type": "daemon_logs_subscribe_request",
+      "direction": "client_to_server",
+      "response": "daemon_logs_subscribe_response.json"
+    },
+    {
+      "file": "daemon_logs_subscribe_response.json",
+      "type": "daemon_logs_subscribe_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_logs_unsubscribe_request.json",
+      "type": "daemon_logs_unsubscribe_request",
+      "direction": "client_to_server",
+      "response": "daemon_logs_unsubscribe_response.json"
+    },
+    {
+      "file": "daemon_logs_unsubscribe_response.json",
+      "type": "daemon_logs_unsubscribe_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_status_request.json",
+      "type": "daemon_status_request",
+      "direction": "client_to_server",
+      "response": "daemon_status_response.json"
+    },
+    {
+      "file": "daemon_status_response.json",
+      "type": "daemon_status_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_status_subscribe_request.json",
+      "type": "daemon_status_subscribe_request",
+      "direction": "client_to_server",
+      "response": "daemon_status_subscribe_response.json"
+    },
+    {
+      "file": "daemon_status_subscribe_response.json",
+      "type": "daemon_status_subscribe_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_status_unsubscribe_request.json",
+      "type": "daemon_status_unsubscribe_request",
+      "direction": "client_to_server",
+      "response": "daemon_status_unsubscribe_response.json"
+    },
+    {
+      "file": "daemon_status_unsubscribe_response.json",
+      "type": "daemon_status_unsubscribe_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "daemon_status_update.json",
+      "type": "daemon_status_update",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "fetch_agent_timeline_request.json",
+      "type": "fetch_agent_timeline_request",
+      "direction": "client_to_server",
+      "response": "fetch_agent_timeline_response.json"
+    },
+    {
+      "file": "fetch_agent_timeline_response.json",
+      "type": "fetch_agent_timeline_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "health.json",
+      "type": "health",
+      "direction": "http"
+    },
+    {
+      "file": "hello.json",
+      "type": "hello",
+      "direction": "client_to_server",
+      "response": "status.server_info.json"
+    },
+    {
+      "file": "interrupt_agent.json",
+      "type": "interrupt_agent",
+      "direction": "client_to_server",
+      "response": "interrupt_response.json"
+    },
+    {
+      "file": "interrupt_response.json",
+      "type": "interrupt_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "list_agents_request.json",
+      "type": "list_agents_request",
+      "direction": "client_to_server",
+      "response": "list_agents_response.json"
+    },
+    {
+      "file": "list_agents_response.json",
+      "type": "list_agents_response",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "ping.json",
+      "type": "ping",
+      "direction": "client_to_server",
+      "response": "pong.json"
+    },
+    {
+      "file": "pong.json",
+      "type": "pong",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "rpc_error.json",
+      "type": "rpc_error",
+      "direction": "server_to_client"
+    },
+    {
+      "file": "status.server_info.json",
+      "type": "status",
+      "direction": "server_to_client"
+    }
+  ]
+}

package/fixtures/external-clients/ping.json

@@ -0,0 +1,14 @@
+{
+  "type": "ping",
+  "direction": "client_to_server",
+  "description": "JSON liveness ping (top-level frame, not session-wrapped).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/requestId", "/clientSentAt"],
+  "frame": {
+    "type": "ping",
+    "requestId": "req-1",
+    "clientSentAt": 1767225600000
+  }
+}

package/fixtures/external-clients/pong.json

@@ -0,0 +1,16 @@
+{
+  "type": "pong",
+  "direction": "server_to_client",
+  "description": "JSON liveness reply (top-level frame). Timestamps are epoch milliseconds.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/requestId", "/clientSentAt", "/serverReceivedAt", "/serverSentAt"],
+  "frame": {
+    "type": "pong",
+    "requestId": "req-1",
+    "clientSentAt": 1767225600000,
+    "serverReceivedAt": 1767225600000,
+    "serverSentAt": 1767225600000
+  }
+}

package/fixtures/external-clients/rpc_error.json

@@ -0,0 +1,18 @@
+{
+  "type": "rpc_error",
+  "direction": "server_to_client",
+  "description": "Error reply to a request. code is unknown_message_type or handler_error.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "rpc_error",
+      "requestId": "req-1",
+      "code": "unknown_message_type",
+      "message": "no handler for scenario_no_such_type"
+    }
+  }
+}

package/fixtures/external-clients/status.server_info.json

@@ -0,0 +1,27 @@
+{
+  "type": "status",
+  "direction": "server_to_client",
+  "description": "Handshake reply: server identity, version and feature flags (a subset of flags is pinned; the daemon may add more).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/payload/serverId", "/payload/hostname", "/payload/version", "/payload/homeDir"],
+  "frame": {
+    "type": "status",
+    "payload": {
+      "status": "server_info",
+      "serverId": "00000000-0000-4000-8000-000000000001",
+      "hostname": "daemon-host",
+      "version": "0.0.115",
+      "homeDir": "/home/user",
+      "capabilities": {},
+      "features": {
+        "extensionUi": true,
+        "thinkingLevels": true,
+        "forkTimelineSync": true,
+        "compactionEvents": true,
+        "agentTodos": true
+      }
+    }
+  }
+}