@roll-agent/protocol 0.3.0 → 0.4.1

package/fixtures/v1.2/invalid-duplicate-client-capability-method.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "id": "capability-rpc-2",
+  "method": "client.capabilities.set",
+  "params": {
+    "revision": 2,
+    "serverRequestMethods": ["approval.request", "approval.request"]
+  }
+}

package/fixtures/v1.2/invalid-legacy-approval-request.json

@@ -0,0 +1,15 @@
+{
+  "jsonrpc": "2.0",
+  "id": "approval-rpc-legacy",
+  "method": "approval.request",
+  "params": {
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "approval": {
+      "id": "00000000-0000-4000-8000-000000000005",
+      "turnId": "00000000-0000-4000-8000-000000000003",
+      "agentName": "browser-use-agent",
+      "toolName": "click",
+      "preview": {}
+    }
+  }
+}

package/fixtures/v1.2/invalid-legacy-server-request-cancel-notification.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.serverRequest.cancel",
+  "params": {
+    "serverRequestId": "approval-rpc-1",
+    "approvalId": "00000000-0000-4000-8000-000000000005",
+    "reason": "turn-cancelled"
+  }
+}

package/fixtures/v1.2/invalid-sensitive-approval-request.json

@@ -0,0 +1,19 @@
+{
+  "jsonrpc": "2.0",
+  "id": "approval-rpc-sensitive",
+  "method": "approval.request",
+  "params": {
+    "interactionId": "00000000-0000-4000-8000-000000000006",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "expiresAt": "2026-07-29T12:10:00.000Z",
+    "sensitivity": "secret",
+    "approval": {
+      "id": "00000000-0000-4000-8000-000000000005",
+      "turnId": "00000000-0000-4000-8000-000000000003",
+      "agentName": "browser-use-agent",
+      "toolName": "click",
+      "preview": {}
+    }
+  }
+}

package/fixtures/v1.2/invalid-sensitive-user-input-request.json

@@ -0,0 +1,20 @@
+{
+  "jsonrpc": "2.0",
+  "id": "user-input-rpc-secret",
+  "method": "userInput.request",
+  "params": {
+    "interactionId": "00000000-0000-4000-8000-000000000006",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "expiresAt": "2026-07-29T12:10:00.000Z",
+    "sensitivity": "secret",
+    "controls": [
+      {
+        "type": "text",
+        "id": "credential",
+        "label": "Credential",
+        "required": true
+      }
+    ]
+  }
+}

package/fixtures/v1.2/invalid-thread-snapshot-interaction-payload.json

@@ -0,0 +1,37 @@
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Unsafe interaction",
+      "createdAt": "2026-07-28T12:00:00.000Z",
+      "updatedAt": "2026-07-28T12:01:00.000Z",
+      "messageCount": 0
+    },
+    "messages": {
+      "items": [],
+      "nextBeforeSequence": null
+    },
+    "operations": {
+      "items": [],
+      "nextBeforeSequence": null
+    },
+    "pendingApprovals": [],
+    "pendingInteractions": [
+      {
+        "method": "approval.request",
+        "interactionId": "00000000-0000-4000-8000-000000000006",
+        "threadId": "00000000-0000-4000-8000-000000000002",
+        "turnId": "00000000-0000-4000-8000-000000000003",
+        "expiresAt": "2026-07-29T12:10:00.000Z",
+        "sensitivity": "normal",
+        "approvalId": "00000000-0000-4000-8000-000000000005",
+        "preview": {
+          "selector": "#submit"
+        }
+      }
+    ],
+    "transcriptCompleteness": "complete"
+  }
+}

package/fixtures/v1.2/invalid-user-input-request-response.json

@@ -0,0 +1,13 @@
+{
+  "jsonrpc": "2.0",
+  "id": "user-input-rpc-1",
+  "result": {
+    "status": "submitted",
+    "values": [
+      {
+        "id": "deployment-region",
+        "value": { "secret": "not-a-supported-value" }
+      }
+    ]
+  }
+}

package/fixtures/v1.2/valid-approval-request.json

@@ -0,0 +1,22 @@
+{
+  "jsonrpc": "2.0",
+  "id": "approval-rpc-2",
+  "method": "approval.request",
+  "params": {
+    "interactionId": "00000000-0000-4000-8000-000000000006",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "expiresAt": "2026-07-29T12:10:00.000Z",
+    "sensitivity": "normal",
+    "approval": {
+      "id": "00000000-0000-4000-8000-000000000005",
+      "turnId": "00000000-0000-4000-8000-000000000003",
+      "agentName": "browser-use-agent",
+      "toolName": "click",
+      "preview": {
+        "selector": "#submit"
+      },
+      "reason": "此操作会提交表单"
+    }
+  }
+}

package/fixtures/v1.2/valid-client-capabilities-set-request.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "id": "capability-rpc-1",
+  "method": "client.capabilities.set",
+  "params": {
+    "revision": 1,
+    "serverRequestMethods": ["future.request", "approval.request"]
+  }
+}

package/fixtures/v1.2/valid-client-capabilities-set-response.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": "capability-rpc-1",
+  "result": {
+    "revision": 1,
+    "acceptedServerRequestMethods": ["approval.request"]
+  }
+}

package/fixtures/v1.2/valid-server-request-cancel-notification.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.serverRequest.cancel",
+  "params": {
+    "interactionId": "00000000-0000-4000-8000-000000000006",
+    "reason": "turn-cancelled"
+  }
+}

package/fixtures/v1.2/valid-thread-snapshot-response.json

@@ -0,0 +1,42 @@
+{
+  "jsonrpc": "2.0",
+  "id": 2,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Golden thread",
+      "model": "fixture-model",
+      "createdAt": "2026-07-28T12:00:00.000Z",
+      "updatedAt": "2026-07-28T12:01:00.000Z",
+      "messageCount": 1
+    },
+    "messages": {
+      "items": [
+        {
+          "sequence": 0,
+          "role": "user",
+          "createdAt": "2026-07-28T12:00:00.000Z",
+          "parts": [{ "type": "text", "text": "hello" }]
+        }
+      ],
+      "nextBeforeSequence": null
+    },
+    "operations": {
+      "items": [],
+      "nextBeforeSequence": null
+    },
+    "pendingApprovals": [],
+    "pendingInteractions": [
+      {
+        "method": "approval.request",
+        "interactionId": "00000000-0000-4000-8000-000000000006",
+        "threadId": "00000000-0000-4000-8000-000000000002",
+        "turnId": "00000000-0000-4000-8000-000000000003",
+        "expiresAt": "2026-07-29T12:10:00.000Z",
+        "sensitivity": "normal",
+        "approvalId": "00000000-0000-4000-8000-000000000005"
+      }
+    ],
+    "transcriptCompleteness": "complete"
+  }
+}

package/fixtures/v1.2/valid-user-input-request-response.json

@@ -0,0 +1,11 @@
+{
+  "jsonrpc": "2.0",
+  "id": "user-input-rpc-1",
+  "result": {
+    "status": "submitted",
+    "values": [
+      { "id": "deployment-region", "value": "华东" },
+      { "id": "target-workspace", "value": "workspace-a" }
+    ]
+  }
+}

package/fixtures/v1.2/valid-user-input-request.json

@@ -0,0 +1,35 @@
+{
+  "jsonrpc": "2.0",
+  "id": "user-input-rpc-1",
+  "method": "userInput.request",
+  "params": {
+    "interactionId": "00000000-0000-4000-8000-000000000006",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "expiresAt": "2026-07-29T12:10:00.000Z",
+    "sensitivity": "normal",
+    "title": "部署配置",
+    "description": "请确认普通部署配置。",
+    "controls": [
+      {
+        "type": "text",
+        "id": "deployment-region",
+        "label": "部署区域",
+        "required": true,
+        "minLength": 2,
+        "maxLength": 20
+      },
+      {
+        "type": "choice",
+        "id": "target-workspace",
+        "label": "目标 Workspace",
+        "required": true,
+        "multiple": false,
+        "options": [
+          { "id": "workspace-a", "label": "Workspace A" },
+          { "id": "workspace-b", "label": "Workspace B" }
+        ]
+      }
+    ]
+  }
+}

package/fixtures/v1.3/invalid-durable-delta-event-notification.json

@@ -0,0 +1,19 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.event",
+  "params": {
+    "protocolVersion": "1.3",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
+    "sequence": 10,
+    "timestamp": "2026-07-30T12:00:02.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "durability": "durable",
+    "eventId": "00000000-0000-4000-8000-000000000007",
+    "cursor": "rte1:00000000-0000-4000-8000-000000000008:0:00000000-0000-4000-8000-000000000007",
+    "event": {
+      "type": "message.delta",
+      "streamId": "00000000-0000-4000-8000-000000000004",
+      "delta": "unsafe to replay"
+    }
+  }
+}

package/fixtures/v1.3/invalid-ephemeral-completed-event-notification.json

@@ -0,0 +1,15 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.event",
+  "params": {
+    "protocolVersion": "1.3",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
+    "sequence": 11,
+    "timestamp": "2026-07-30T12:00:03.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "durability": "ephemeral",
+    "event": {
+      "type": "turn.completed"
+    }
+  }
+}

package/fixtures/v1.3/invalid-runtime-events-resume-cursor-request.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "id": 13,
+  "method": "runtime.events.resume",
+  "params": {
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "afterCursor": "00000000-0000-4000-8000-000000000007"
+  }
+}

package/fixtures/v1.3/invalid-thread-recovery-snapshot-response.json

@@ -0,0 +1,31 @@
+{
+  "jsonrpc": "2.0",
+  "id": 16,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Invalid recovery",
+      "model": "fixture-model",
+      "createdAt": "2026-07-30T12:00:00.000Z",
+      "updatedAt": "2026-07-30T12:00:00.000Z",
+      "messageCount": 1
+    },
+    "messages": {
+      "items": [
+        {
+          "sequence": 0,
+          "role": "assistant",
+          "createdAt": "2026-07-30T12:00:00.000Z",
+          "parts": [{ "type": "text", "text": "must not appear" }]
+        }
+      ],
+      "nextBeforeSequence": null
+    },
+    "operations": { "items": [], "nextBeforeSequence": null },
+    "pendingApprovals": [],
+    "pendingInteractions": [],
+    "transcriptCompleteness": "complete",
+    "eventCursor": null,
+    "recoveryProjection": true
+  }
+}

package/fixtures/v1.3/invalid-thread-recovery-snapshot-timestamp-response.json

@@ -0,0 +1,21 @@
+{
+  "jsonrpc": "2.0",
+  "id": 17,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Invalid recovery timestamp",
+      "model": "fixture-model",
+      "createdAt": "2026-07-30T12:00:00.1111111111111111111111111111111111111111111111111111111111111111Z",
+      "updatedAt": "2026-07-30T12:00:00.000Z",
+      "messageCount": 0
+    },
+    "messages": { "items": [], "nextBeforeSequence": null },
+    "operations": { "items": [], "nextBeforeSequence": null },
+    "pendingApprovals": [],
+    "pendingInteractions": [],
+    "transcriptCompleteness": "complete",
+    "eventCursor": null,
+    "recoveryProjection": true
+  }
+}

package/fixtures/v1.3/valid-runtime-durable-event-notification.json

@@ -0,0 +1,20 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.event",
+  "params": {
+    "protocolVersion": "1.3",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
+    "sequence": 8,
+    "timestamp": "2026-07-30T12:00:00.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "durability": "durable",
+    "eventId": "00000000-0000-4000-8000-000000000007",
+    "cursor": "rte1:00000000-0000-4000-8000-000000000008:0:00000000-0000-4000-8000-000000000007",
+    "event": {
+      "type": "message.completed",
+      "streamId": "00000000-0000-4000-8000-000000000004",
+      "text": "hello"
+    }
+  }
+}

package/fixtures/v1.3/valid-runtime-ephemeral-event-notification.json

@@ -0,0 +1,18 @@
+{
+  "jsonrpc": "2.0",
+  "method": "runtime.event",
+  "params": {
+    "protocolVersion": "1.3",
+    "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
+    "sequence": 9,
+    "timestamp": "2026-07-30T12:00:01.000Z",
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "turnId": "00000000-0000-4000-8000-000000000003",
+    "durability": "ephemeral",
+    "event": {
+      "type": "message.delta",
+      "streamId": "00000000-0000-4000-8000-000000000004",
+      "delta": "hello"
+    }
+  }
+}

package/fixtures/v1.3/valid-runtime-events-resume-request.json

@@ -0,0 +1,9 @@
+{
+  "jsonrpc": "2.0",
+  "id": 12,
+  "method": "runtime.events.resume",
+  "params": {
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "afterCursor": null
+  }
+}

package/fixtures/v1.3/valid-runtime-events-resume-response.json

@@ -0,0 +1,8 @@
+{
+  "jsonrpc": "2.0",
+  "id": 12,
+  "result": {
+    "throughCursor": null,
+    "replayedCount": 0
+  }
+}

package/fixtures/v1.3/valid-thread-recovery-snapshot-request.json

@@ -0,0 +1,10 @@
+{
+  "jsonrpc": "2.0",
+  "id": 15,
+  "method": "thread.snapshot",
+  "params": {
+    "threadId": "00000000-0000-4000-8000-000000000002",
+    "limit": 1,
+    "recovery": true
+  }
+}

package/fixtures/v1.3/valid-thread-recovery-snapshot-response.json

@@ -0,0 +1,21 @@
+{
+  "jsonrpc": "2.0",
+  "id": 15,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Bounded recovery",
+      "model": "fixture-model",
+      "createdAt": "2026-07-30T12:00:00.000Z",
+      "updatedAt": "2026-07-30T12:00:00.000Z",
+      "messageCount": 42
+    },
+    "messages": { "items": [], "nextBeforeSequence": null },
+    "operations": { "items": [], "nextBeforeSequence": null },
+    "pendingApprovals": [],
+    "pendingInteractions": [],
+    "transcriptCompleteness": "complete",
+    "eventCursor": null,
+    "recoveryProjection": true
+  }
+}

package/fixtures/v1.3/valid-thread-snapshot-response.json

@@ -0,0 +1,20 @@
+{
+  "jsonrpc": "2.0",
+  "id": 14,
+  "result": {
+    "thread": {
+      "id": "00000000-0000-4000-8000-000000000002",
+      "title": "Empty durable log",
+      "model": "fixture-model",
+      "createdAt": "2026-07-30T12:00:00.000Z",
+      "updatedAt": "2026-07-30T12:00:00.000Z",
+      "messageCount": 0
+    },
+    "messages": { "items": [], "nextBeforeSequence": null },
+    "operations": { "items": [], "nextBeforeSequence": null },
+    "pendingApprovals": [],
+    "pendingInteractions": [],
+    "transcriptCompleteness": "complete",
+    "eventCursor": null
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/protocol",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -16,6 +16,11 @@
       "default": "./dist/index.js"
     },
     "./schema": "./dist/schema/roll-runtime-protocol-v1.schema.json",
+    "./schema/latest": "./dist/schema/roll-runtime-protocol-v1.schema.json",
+    "./schema/1.3": "./dist/schema/roll-runtime-protocol-v1.3.schema.json",
+    "./schema/1.2": "./dist/schema/roll-runtime-protocol-v1.2.schema.json",
+    "./schema/1.1": "./dist/schema/roll-runtime-protocol-v1.1.schema.json",
+    "./schema/1.0": "./dist/schema/roll-runtime-protocol-v1.0.schema.json",
     "./fixtures/*": "./fixtures/*"
   },
   "publishConfig": {