@av-pi-studio/protocol 0.0.115 → 0.0.117

package/fixtures/external-clients/agent_ui_request.notify.json

@@ -0,0 +1,23 @@
+{
+  "type": "agent_ui_request",
+  "direction": "server_to_client",
+  "description": "Non-dialog notification (expectsResponse false); never answerable.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId", "/message/createdAt"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_request",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "method": "notify",
+      "expectsResponse": false,
+      "payload": {
+        "message": "Done"
+      },
+      "createdAt": 1767225600000
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_request.select.json

@@ -0,0 +1,24 @@
+{
+  "type": "agent_ui_request",
+  "direction": "server_to_client",
+  "description": "Answerable dialog: pick one option (expectsResponse true).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId", "/message/createdAt"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_request",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "method": "select",
+      "expectsResponse": true,
+      "payload": {
+        "title": "Pick one",
+        "options": ["a", "b"]
+      },
+      "createdAt": 1767225600000
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_request.setStatus.json

@@ -0,0 +1,24 @@
+{
+  "type": "agent_ui_request",
+  "direction": "server_to_client",
+  "description": "Retained surface update keyed by surfaceKey (expectsResponse false); last value wins.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId", "/message/createdAt"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_request",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "method": "setStatus",
+      "expectsResponse": false,
+      "payload": {
+        "statusText": "building"
+      },
+      "surfaceKey": "status:build",
+      "createdAt": 1767225600000
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_request.setStatus.removed.json

@@ -0,0 +1,23 @@
+{
+  "type": "agent_ui_request",
+  "direction": "server_to_client",
+  "description": "Clears a retained surface (removed: true, empty payload).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId", "/message/createdAt"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_request",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "method": "setStatus",
+      "expectsResponse": false,
+      "payload": {},
+      "surfaceKey": "status:build",
+      "removed": true,
+      "createdAt": 1767225600000
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_resolved.aborted.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_ui_resolved",
+  "direction": "server_to_client",
+  "description": "A dialog is no longer answerable (reason aborted).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_resolved",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "reason": "aborted"
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_resolved.answered.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_ui_resolved",
+  "direction": "server_to_client",
+  "description": "A dialog is no longer answerable (reason answered).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_resolved",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "reason": "answered"
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_resolved.cancelled.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_ui_resolved",
+  "direction": "server_to_client",
+  "description": "A dialog was cancelled (reason cancelled). Documented reason; no daemon code path emits it today.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_resolved",
+      "requestId": "req-1",
+      "agentId": "agent-1",
+      "reason": "cancelled"
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_resolved.timeout.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_ui_resolved",
+  "direction": "server_to_client",
+  "description": "A dialog is no longer answerable (reason timeout).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/agentId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_resolved",
+      "requestId": "00000000-0000-4000-8000-000000000001",
+      "agentId": "00000000-0000-4000-8000-000000000002",
+      "reason": "timeout"
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_respond_request.confirm.json

@@ -0,0 +1,20 @@
+{
+  "type": "agent_ui_respond_request",
+  "direction": "client_to_server",
+  "description": "Answer a pending confirm dialog.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/uiRequestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_respond_request",
+      "requestId": "req-1",
+      "uiRequestId": "ui-req-1",
+      "response": {
+        "confirmed": true
+      }
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_respond_request.select.json

@@ -0,0 +1,20 @@
+{
+  "type": "agent_ui_respond_request",
+  "direction": "client_to_server",
+  "description": "Answer a pending select dialog with the chosen option.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId", "/message/uiRequestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_respond_request",
+      "requestId": "req-1",
+      "uiRequestId": "ui-req-1",
+      "response": {
+        "value": "a"
+      }
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_respond_response.not_found.json

@@ -0,0 +1,20 @@
+{
+  "type": "agent_ui_respond_response",
+  "direction": "server_to_client",
+  "description": "The dialog id is unknown or already resolved.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_respond_response",
+      "payload": {
+        "ok": false,
+        "error": "not_found"
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/agent_ui_respond_response.ok.json

@@ -0,0 +1,19 @@
+{
+  "type": "agent_ui_respond_response",
+  "direction": "server_to_client",
+  "description": "The answer was accepted.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": "extensionUi",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_ui_respond_response",
+      "payload": {
+        "ok": true
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/agent_update.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_update",
+  "direction": "server_to_client",
+  "description": "Agent status/label/title change broadcast. A family of partial updates: only changed fields are present.",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/agentId", "/message/status"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_update",
+      "agentId": "00000000-0000-4000-8000-000000000001",
+      "status": "initializing",
+      "labels": {}
+    }
+  }
+}

package/fixtures/external-clients/agent_update.model.json

@@ -0,0 +1,18 @@
+{
+  "type": "agent_update",
+  "direction": "server_to_client",
+  "description": "Model change broadcast (emitted beyond the Zod schema: model, modelProvider, optional thinkingLevel).",
+  "since": "0.0.115",
+  "stage": 1,
+  "requiresFeature": null,
+  "volatile": ["/message/agentId", "/message/model", "/message/modelProvider"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "agent_update",
+      "agentId": "00000000-0000-4000-8000-000000000001",
+      "model": "mock-2",
+      "modelProvider": "mock"
+    }
+  }
+}

package/fixtures/external-clients/daemon_log_lines.json

@@ -0,0 +1,23 @@
+{
+  "type": "daemon_log_lines",
+  "direction": "server_to_client",
+  "description": "Flat log push to subscribed sessions only, flushed within ~100 ms; dropped is incremental; carries no requestId.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/lines/0/time", "/message/lines/0/level", "/message/lines/0/msg"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_log_lines",
+      "lines": [
+        {
+          "time": 1767225600000,
+          "level": "info",
+          "msg": "external fixture log line"
+        }
+      ],
+      "dropped": 0
+    }
+  }
+}

package/fixtures/external-clients/daemon_logs_subscribe_request.json

@@ -0,0 +1,18 @@
+{
+  "type": "daemon_logs_subscribe_request",
+  "direction": "client_to_server",
+  "description": "Subscribe this session to the daemon log tail at minLevel or above; tail asks for a backlog of up to that many newest lines.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_logs_subscribe_request",
+      "requestId": "req-1",
+      "minLevel": "info",
+      "tail": 1
+    }
+  }
+}

package/fixtures/external-clients/daemon_logs_subscribe_response.json

@@ -0,0 +1,34 @@
+{
+  "type": "daemon_logs_subscribe_response",
+  "direction": "server_to_client",
+  "description": "Subscription accepted: the level in force and the requested backlog (one representative line); dropped counts lines the rate cap discarded.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": [
+    "/message/requestId",
+    "/message/payload/lines/0/time",
+    "/message/payload/lines/0/level",
+    "/message/payload/lines/0/msg"
+  ],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_logs_subscribe_response",
+      "payload": {
+        "ok": true,
+        "minLevel": "info",
+        "effectiveLevel": "info",
+        "lines": [
+          {
+            "time": 1767225600000,
+            "level": "info",
+            "msg": "external fixture log line"
+          }
+        ],
+        "dropped": 0
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_logs_unsubscribe_request.json

@@ -0,0 +1,16 @@
+{
+  "type": "daemon_logs_unsubscribe_request",
+  "direction": "client_to_server",
+  "description": "Stop the log push for this session.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_logs_unsubscribe_request",
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_logs_unsubscribe_response.json

@@ -0,0 +1,19 @@
+{
+  "type": "daemon_logs_unsubscribe_response",
+  "direction": "server_to_client",
+  "description": "Log subscription removed.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_logs_unsubscribe_response",
+      "payload": {
+        "ok": true
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_request.json

@@ -0,0 +1,16 @@
+{
+  "type": "daemon_status_request",
+  "direction": "client_to_server",
+  "description": "One-shot daemon status snapshot request (read-only, authenticated sessions only).",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_request",
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_response.json

@@ -0,0 +1,60 @@
+{
+  "type": "daemon_status_response",
+  "direction": "server_to_client",
+  "description": "Process/version/memory/CPU/agent-count/connected-client snapshot (the clients array holds one representative element).",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": [
+    "/message/requestId",
+    "/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_response",
+      "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"
+          }
+        ]
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_subscribe_request.json

@@ -0,0 +1,16 @@
+{
+  "type": "daemon_status_subscribe_request",
+  "direction": "client_to_server",
+  "description": "Subscribe this session to a status push every intervalMs.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_subscribe_request",
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_subscribe_response.json

@@ -0,0 +1,64 @@
+{
+  "type": "daemon_status_subscribe_response",
+  "direction": "server_to_client",
+  "description": "Subscription accepted; carries the push interval and an immediate snapshot.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": [
+    "/message/requestId",
+    "/message/payload/status/version",
+    "/message/payload/status/startedAt",
+    "/message/payload/status/uptimeMs",
+    "/message/payload/status/pid",
+    "/message/payload/status/nodeVersion",
+    "/message/payload/status/memory/rss",
+    "/message/payload/status/memory/heapUsed",
+    "/message/payload/status/memory/heapTotal",
+    "/message/payload/status/cpuPercent",
+    "/message/payload/status/eventLoopLagMs",
+    "/message/payload/status/agentsByStatus/idle",
+    "/message/payload/status/clients/0/clientId",
+    "/message/payload/status/clients/0/appVersion",
+    "/message/payload/status/clients/0/connectedAt",
+    "/message/payload/status/clients/0/remoteAddress"
+  ],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_subscribe_response",
+      "payload": {
+        "ok": true,
+        "intervalMs": 5000,
+        "status": {
+          "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"
+            }
+          ]
+        }
+      },
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_unsubscribe_request.json

@@ -0,0 +1,16 @@
+{
+  "type": "daemon_status_unsubscribe_request",
+  "direction": "client_to_server",
+  "description": "Stop the status push for this session.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_unsubscribe_request",
+      "requestId": "req-1"
+    }
+  }
+}

package/fixtures/external-clients/daemon_status_unsubscribe_response.json

@@ -0,0 +1,19 @@
+{
+  "type": "daemon_status_unsubscribe_response",
+  "direction": "server_to_client",
+  "description": "Status subscription removed.",
+  "since": "0.0.115",
+  "stage": 2,
+  "requiresFeature": "daemonObservability",
+  "volatile": ["/message/requestId"],
+  "frame": {
+    "type": "session",
+    "message": {
+      "type": "daemon_status_unsubscribe_response",
+      "payload": {
+        "ok": true
+      },
+      "requestId": "req-1"
+    }
+  }
+}