@roll-agent/relay-protocol 0.1.1 → 0.3.0

package/dist/schema/roll-relay-protocol-v1.schema.json

@@ -718,7 +718,7 @@
     }
   ],
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://roll-agent.dev/schemas/relay-protocol/1.0",
+  "$id": "urn:roll-agent:schema:relay-protocol:1.0",
   "title": "Roll Relay Protocol v1.0",
   "description": "Versioned Companion Relay frames shared by Browser, Cloud Relay and Companion.",
   "$defs": {

package/fixtures/control/v1.0/invalid-browser-session-trailing-whitespace.json

@@ -0,0 +1,4 @@
+{
+  "connectUrl": "wss://relay.example.test/v1/browser?ticket=single-use ",
+  "expiresAt": "2026-08-06T12:00:00.000Z"
+}

package/fixtures/control/v1.0/invalid-browser-session-uppercase-scheme.json

@@ -0,0 +1,4 @@
+{
+  "connectUrl": "WSS://relay.example.test/v1/browser?ticket=single-use",
+  "expiresAt": "2026-08-06T12:00:00.000Z"
+}

package/fixtures/control/v1.0/invalid-browser-session-url.json

@@ -0,0 +1,4 @@
+{
+  "connectUrl": "wss://not a valid url",
+  "expiresAt": "2026-08-06T12:00:00.000Z"
+}

package/fixtures/control/v1.0/invalid-browser-session-ws.json

@@ -0,0 +1,4 @@
+{
+  "connectUrl": "ws://relay.example.test/v1/browser?ticket=single-use",
+  "expiresAt": "2026-08-06T12:00:00.000Z"
+}

package/fixtures/control/v1.0/invalid-control-extra-field.json

@@ -0,0 +1,6 @@
+{
+  "type": "workspace.status",
+  "workspaceId": "00000000-0000-4000-8000-000000000302",
+  "status": "online",
+  "deviceId": "00000000-0000-4000-8000-000000000303"
+}

package/fixtures/control/v1.0/invalid-session-ready-wire-version.json

@@ -0,0 +1,8 @@
+{
+  "type": "session.ready",
+  "controlVersion": "1.0",
+  "relayProtocolVersion": "1.0",
+  "sessionId": "browser-session-301",
+  "workspaceId": "00000000-0000-4000-8000-000000000302",
+  "workspaceStatus": "online"
+}

package/fixtures/control/v1.0/manifest.json

@@ -0,0 +1,52 @@
+{
+  "controlVersion": "1.0",
+  "messages": [
+    {
+      "fixture": "valid-session-ready.json",
+      "valid": true,
+      "validFirstFrame": true
+    },
+    {
+      "fixture": "valid-workspace-status.json",
+      "valid": true,
+      "validFirstFrame": false
+    },
+    {
+      "fixture": "valid-session-error.json",
+      "valid": true,
+      "validFirstFrame": false
+    },
+    {
+      "fixture": "invalid-session-ready-wire-version.json",
+      "valid": false,
+      "validFirstFrame": false
+    },
+    {
+      "fixture": "invalid-control-extra-field.json",
+      "valid": false,
+      "validFirstFrame": false
+    }
+  ],
+  "sessions": [
+    {
+      "fixture": "valid-browser-session.json",
+      "valid": true
+    },
+    {
+      "fixture": "invalid-browser-session-ws.json",
+      "valid": false
+    },
+    {
+      "fixture": "invalid-browser-session-url.json",
+      "valid": false
+    },
+    {
+      "fixture": "invalid-browser-session-uppercase-scheme.json",
+      "valid": false
+    },
+    {
+      "fixture": "invalid-browser-session-trailing-whitespace.json",
+      "valid": false
+    }
+  ]
+}

package/fixtures/control/v1.0/valid-browser-session.json

@@ -0,0 +1,4 @@
+{
+  "connectUrl": "wss://relay.example.test/v1/browser?ticket=single-use",
+  "expiresAt": "2026-08-06T12:00:00.000Z"
+}

package/fixtures/control/v1.0/valid-session-error.json

@@ -0,0 +1,5 @@
+{
+  "type": "session.error",
+  "code": "CONTROLLER_CONFLICT",
+  "retryable": false
+}

package/fixtures/control/v1.0/valid-session-ready.json

@@ -0,0 +1,8 @@
+{
+  "type": "session.ready",
+  "controlVersion": "1.0",
+  "relayProtocolVersion": "1.1",
+  "sessionId": "browser-session-301",
+  "workspaceId": "00000000-0000-4000-8000-000000000302",
+  "workspaceStatus": "online"
+}

package/fixtures/control/v1.0/valid-workspace-status.json

@@ -0,0 +1,5 @@
+{
+  "type": "workspace.status",
+  "workspaceId": "00000000-0000-4000-8000-000000000302",
+  "status": "offline"
+}

package/fixtures/v1.1/invalid-approval-projection-raw-input-leak.json

@@ -0,0 +1,19 @@
+{
+  "type": "interaction.request",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 7,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "expiresAt": "2026-08-04T00:05:00.000Z",
+  "sensitivity": "normal",
+  "method": "approval.request",
+  "projection": {
+    "approvalId": "00000000-0000-4000-8000-000000000504",
+    "agentName": "workspace-agent",
+    "toolName": "deploy",
+    "input": {
+      "secret": "relay-security-sentinel"
+    }
+  }
+}

package/fixtures/v1.1/invalid-authentication-local-only.json

@@ -0,0 +1,12 @@
+{
+  "type": "interaction.request",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 10,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "expiresAt": "2026-08-04T00:05:00.000Z",
+  "sensitivity": "normal",
+  "method": "authentication.request",
+  "projection": {}
+}

package/fixtures/v1.1/invalid-file-picker-local-only.json

@@ -0,0 +1,12 @@
+{
+  "type": "interaction.request",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 11,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "expiresAt": "2026-08-04T00:05:00.000Z",
+  "sensitivity": "normal",
+  "method": "filePicker.request",
+  "projection": {}
+}

package/fixtures/v1.1/invalid-interaction-cancelled-reason-leak.json

@@ -0,0 +1,10 @@
+{
+  "type": "interaction.cancelled",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 13,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "method": "approval.request",
+  "reason": "relay-security-sentinel"
+}

package/fixtures/v1.1/invalid-interaction-resolved-result-leak.json

@@ -0,0 +1,18 @@
+{
+  "type": "interaction.resolved",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 12,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "method": "userInput.request",
+  "result": {
+    "status": "submitted",
+    "values": [
+      {
+        "id": "workspace",
+        "value": "relay-security-sentinel"
+      }
+    ]
+  }
+}

package/fixtures/v1.1/invalid-legacy-approval-candidate.json

@@ -0,0 +1,7 @@
+{
+  "type": "runtime.request",
+  "requestId": "00000000-0000-4000-8000-000000000505",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "method": "approval.candidate",
+  "params": {}
+}

package/fixtures/v1.1/invalid-legacy-approval-respond.json

@@ -0,0 +1,7 @@
+{
+  "type": "runtime.request",
+  "requestId": "00000000-0000-4000-8000-000000000505",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "method": "approval.respond",
+  "params": {}
+}

package/fixtures/v1.1/invalid-n-minus-one-device-connect.json

@@ -0,0 +1,6 @@
+{
+  "type": "device.connect",
+  "protocolVersion": "1.0",
+  "deviceId": "00000000-0000-4000-8000-000000000506",
+  "pairingToken": "pairing-token-with-sufficient-length"
+}

package/fixtures/v1.1/invalid-non-normal-sensitivity.json

@@ -0,0 +1,21 @@
+{
+  "type": "interaction.request",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 9,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "expiresAt": "2026-08-04T00:05:00.000Z",
+  "sensitivity": "secret",
+  "method": "userInput.request",
+  "projection": {
+    "controls": [
+      {
+        "id": "workspace",
+        "type": "text",
+        "label": "目标 Workspace",
+        "required": true
+      }
+    ]
+  }
+}

package/fixtures/v1.1/invalid-runtime-event-tool-input-leak.json

@@ -0,0 +1,22 @@
+{
+  "type": "runtime.event",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 14,
+  "event": {
+    "protocolVersion": "1.1",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000501",
+    "sequence": 14,
+    "timestamp": "2026-08-04T00:00:14.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000502",
+    "turnId": "00000000-0000-4000-8000-000000000503",
+    "event": {
+      "type": "tool.started",
+      "toolCallId": "tool-1",
+      "agentName": "workspace-agent",
+      "toolName": "deploy",
+      "input": {
+        "secret": "relay-security-sentinel"
+      }
+    }
+  }
+}

package/fixtures/v1.1/invalid-runtime-event-tool-output-leak.json

@@ -0,0 +1,21 @@
+{
+  "type": "runtime.event",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 15,
+  "event": {
+    "protocolVersion": "1.1",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000501",
+    "sequence": 15,
+    "timestamp": "2026-08-04T00:00:15.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000502",
+    "turnId": "00000000-0000-4000-8000-000000000503",
+    "event": {
+      "type": "tool.output",
+      "toolCallId": "tool-1",
+      "agentName": "workspace-agent",
+      "toolName": "deploy",
+      "stream": "stdout",
+      "delta": "relay-security-sentinel"
+    }
+  }
+}

package/fixtures/v1.1/invalid-user-input-projection-secret-leak.json

@@ -0,0 +1,22 @@
+{
+  "type": "interaction.request",
+  "workspaceId": "00000000-0000-4000-8000-000000000507",
+  "relaySequence": 8,
+  "interactionId": "00000000-0000-4000-8000-000000000511",
+  "threadId": "00000000-0000-4000-8000-000000000502",
+  "turnId": "00000000-0000-4000-8000-000000000503",
+  "expiresAt": "2026-08-04T00:05:00.000Z",
+  "sensitivity": "normal",
+  "method": "userInput.request",
+  "projection": {
+    "controls": [
+      {
+        "id": "workspace",
+        "type": "text",
+        "label": "目标 Workspace",
+        "required": true
+      }
+    ],
+    "secret": "relay-security-sentinel"
+  }
+}