@roll-agent/protocol 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/README.md +6 -5
  2. package/dist/app-output.d.ts +86 -0
  3. package/dist/app-output.js +178 -0
  4. package/dist/index.d.ts +4498 -761
  5. package/dist/index.js +222 -23
  6. package/dist/schema/roll-runtime-protocol-v1.5.schema.json +6871 -0
  7. package/dist/schema/roll-runtime-protocol-v1.schema.json +561 -11
  8. package/fixtures/v1.4/invalid-attachment-stage-sha256-request.json +14 -0
  9. package/fixtures/v1.4/invalid-turn-start-too-many-attachments-request.json +24 -0
  10. package/fixtures/v1.4/valid-attachment-chunk-request.json +12 -0
  11. package/fixtures/v1.4/valid-attachment-commit-request.json +10 -0
  12. package/fixtures/v1.4/valid-attachment-commit-response.json +16 -0
  13. package/fixtures/v1.4/valid-attachment-release-request.json +10 -0
  14. package/fixtures/v1.4/valid-attachment-stage-request.json +14 -0
  15. package/fixtures/v1.4/valid-attachment-stage-response.json +8 -0
  16. package/fixtures/v1.4/valid-initialize-response.json +34 -0
  17. package/fixtures/v1.4/valid-runtime-durable-event-notification.json +20 -0
  18. package/fixtures/v1.4/valid-thread-snapshot-attachment-part-response.json +44 -0
  19. package/fixtures/v1.4/valid-turn-start-with-attachments-request.json +14 -0
  20. package/fixtures/v1.5/invalid-operation-result-get-extra-request.json +12 -0
  21. package/fixtures/v1.5/valid-initialize-response.json +35 -0
  22. package/fixtures/v1.5/valid-operation-result-get-request.json +9 -0
  23. package/package.json +8 -2
package/fixtures/v1.4/invalid-attachment-stage-sha256-request.json ADDED
@@ -0,0 +1,14 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 26,
4
+ "method": "attachment.stage",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b1",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "fileName": "diagram.png",
9
+ "mediaType": "image/png",
10
+ "bytes": 2048,
11
+ "sha256": "not-a-sha256",
12
+ "source": "chunks"
13
+ }
14
+ }
package/fixtures/v1.4/invalid-turn-start-too-many-attachments-request.json ADDED
@@ -0,0 +1,24 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 25,
4
+ "method": "turn.start",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b5",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "turnId": "00000000-0000-4000-8000-000000000003",
9
+ "input": {
10
+ "text": "too many",
11
+ "attachments": [
12
+ "00000000-0000-4000-8000-0000000000a1",
13
+ "00000000-0000-4000-8000-0000000000a2",
14
+ "00000000-0000-4000-8000-0000000000a3",
15
+ "00000000-0000-4000-8000-0000000000a4",
16
+ "00000000-0000-4000-8000-0000000000a5",
17
+ "00000000-0000-4000-8000-0000000000a6",
18
+ "00000000-0000-4000-8000-0000000000a7",
19
+ "00000000-0000-4000-8000-0000000000a8",
20
+ "00000000-0000-4000-8000-0000000000a9"
21
+ ]
22
+ }
23
+ }
24
+ }
package/fixtures/v1.4/valid-attachment-chunk-request.json ADDED
@@ -0,0 +1,12 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 21,
4
+ "method": "attachment.chunk",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b2",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "attachmentId": "00000000-0000-4000-8000-0000000000a1",
9
+ "sequence": 0,
10
+ "dataBase64": "iVBORw0KGgo="
11
+ }
12
+ }
package/fixtures/v1.4/valid-attachment-commit-request.json ADDED
@@ -0,0 +1,10 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 22,
4
+ "method": "attachment.commit",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b3",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "attachmentId": "00000000-0000-4000-8000-0000000000a1"
9
+ }
10
+ }
package/fixtures/v1.4/valid-attachment-commit-response.json ADDED
@@ -0,0 +1,16 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 22,
4
+ "result": {
5
+ "descriptor": {
6
+ "attachmentId": "00000000-0000-4000-8000-0000000000a1",
7
+ "fileName": "diagram.png",
8
+ "displayName": "diagram.png",
9
+ "mediaType": "image/png",
10
+ "bytes": 2048,
11
+ "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
12
+ "source": "chunks",
13
+ "createdAt": "2026-08-21T12:00:00.000Z"
14
+ }
15
+ }
16
+ }
package/fixtures/v1.4/valid-attachment-release-request.json ADDED
@@ -0,0 +1,10 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 23,
4
+ "method": "attachment.release",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b4",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "attachmentId": "00000000-0000-4000-8000-0000000000a1"
9
+ }
10
+ }
package/fixtures/v1.4/valid-attachment-stage-request.json ADDED
@@ -0,0 +1,14 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 20,
4
+ "method": "attachment.stage",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b1",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "fileName": "diagram.png",
9
+ "mediaType": "image/png",
10
+ "bytes": 2048,
11
+ "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
12
+ "source": "chunks"
13
+ }
14
+ }
package/fixtures/v1.4/valid-attachment-stage-response.json ADDED
@@ -0,0 +1,8 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 20,
4
+ "result": {
5
+ "attachmentId": "00000000-0000-4000-8000-0000000000a1",
6
+ "state": "staged"
7
+ }
8
+ }
package/fixtures/v1.4/valid-initialize-response.json ADDED
@@ -0,0 +1,34 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 1,
4
+ "result": {
5
+ "protocolVersion": "1.4",
6
+ "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
7
+ "server": {
8
+ "name": "roll-runtime",
9
+ "version": "0.18.0",
10
+ "runtimeVersion": "0.18.0"
11
+ },
12
+ "features": [
13
+ "thread-management",
14
+ "snapshots",
15
+ "turns",
16
+ "approvals",
17
+ "tool-streaming",
18
+ "reasoning-summary",
19
+ "operation-projection",
20
+ "process-local-sequence",
21
+ "attachments"
22
+ ],
23
+ "limits": {
24
+ "maxFrameBytes": 4194304,
25
+ "maxPageSize": 500,
26
+ "eventReplay": true,
27
+ "idempotencyCacheEntries": 10000,
28
+ "maxAttachmentBytes": 16777216,
29
+ "maxAttachmentChunkBytes": 2097152,
30
+ "maxTurnAttachments": 8,
31
+ "maxStagedAttachments": 16
32
+ }
33
+ }
34
+ }
package/fixtures/v1.4/valid-runtime-durable-event-notification.json ADDED
@@ -0,0 +1,20 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "method": "runtime.event",
4
+ "params": {
5
+ "protocolVersion": "1.4",
6
+ "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
7
+ "sequence": 8,
8
+ "timestamp": "2026-07-30T12:00:00.000Z",
9
+ "threadId": "00000000-0000-4000-8000-000000000002",
10
+ "turnId": "00000000-0000-4000-8000-000000000003",
11
+ "durability": "durable",
12
+ "eventId": "00000000-0000-4000-8000-000000000007",
13
+ "cursor": "rte1:00000000-0000-4000-8000-000000000008:0:00000000-0000-4000-8000-000000000007",
14
+ "event": {
15
+ "type": "message.completed",
16
+ "streamId": "00000000-0000-4000-8000-000000000004",
17
+ "text": "hello"
18
+ }
19
+ }
20
+ }
package/fixtures/v1.4/valid-thread-snapshot-attachment-part-response.json ADDED
@@ -0,0 +1,44 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 27,
4
+ "result": {
5
+ "thread": {
6
+ "id": "00000000-0000-4000-8000-000000000002",
7
+ "title": "Attachment transcript",
8
+ "model": "fixture-model",
9
+ "createdAt": "2026-08-21T12:00:00.000Z",
10
+ "updatedAt": "2026-08-21T12:00:00.000Z",
11
+ "messageCount": 1
12
+ },
13
+ "messages": {
14
+ "items": [
15
+ {
16
+ "sequence": 0,
17
+ "role": "user",
18
+ "createdAt": "2026-08-21T12:00:00.000Z",
19
+ "parts": [
20
+ {
21
+ "type": "text",
22
+ "text": "看看这张图"
23
+ },
24
+ {
25
+ "type": "attachment",
26
+ "mediaType": "image/png",
27
+ "bytes": 2048,
28
+ "displayName": "diagram.png"
29
+ }
30
+ ]
31
+ }
32
+ ],
33
+ "nextBeforeSequence": null
34
+ },
35
+ "operations": {
36
+ "items": [],
37
+ "nextBeforeSequence": null
38
+ },
39
+ "pendingApprovals": [],
40
+ "pendingInteractions": [],
41
+ "transcriptCompleteness": "complete",
42
+ "eventCursor": null
43
+ }
44
+ }
package/fixtures/v1.4/valid-turn-start-with-attachments-request.json ADDED
@@ -0,0 +1,14 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 24,
4
+ "method": "turn.start",
5
+ "params": {
6
+ "requestId": "00000000-0000-4000-8000-0000000000b5",
7
+ "threadId": "00000000-0000-4000-8000-000000000002",
8
+ "turnId": "00000000-0000-4000-8000-000000000003",
9
+ "input": {
10
+ "text": "",
11
+ "attachments": ["00000000-0000-4000-8000-0000000000a1"]
12
+ }
13
+ }
14
+ }
package/fixtures/v1.5/invalid-operation-result-get-extra-request.json ADDED
@@ -0,0 +1,12 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 2,
4
+ "method": "operation.result.get",
5
+ "params": {
6
+ "threadId": "00000000-0000-4000-8000-000000000002",
7
+ "operationId": "00000000-0000-4000-8000-000000000003",
8
+ "data": {
9
+ "unexpected": true
10
+ }
11
+ }
12
+ }
package/fixtures/v1.5/valid-initialize-response.json ADDED
@@ -0,0 +1,35 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 1,
4
+ "result": {
5
+ "protocolVersion": "1.5",
6
+ "runtimeInstanceId": "00000000-0000-4000-8000-000000000001",
7
+ "server": {
8
+ "name": "roll-runtime",
9
+ "version": "0.18.0",
10
+ "runtimeVersion": "0.18.0"
11
+ },
12
+ "features": [
13
+ "thread-management",
14
+ "snapshots",
15
+ "turns",
16
+ "approvals",
17
+ "tool-streaming",
18
+ "reasoning-summary",
19
+ "operation-projection",
20
+ "process-local-sequence",
21
+ "attachments",
22
+ "app-output"
23
+ ],
24
+ "limits": {
25
+ "maxFrameBytes": 4194304,
26
+ "maxPageSize": 500,
27
+ "eventReplay": true,
28
+ "idempotencyCacheEntries": 10000,
29
+ "maxAttachmentBytes": 16777216,
30
+ "maxAttachmentChunkBytes": 2097152,
31
+ "maxTurnAttachments": 8,
32
+ "maxStagedAttachments": 16
33
+ }
34
+ }
35
+ }
package/fixtures/v1.5/valid-operation-result-get-request.json ADDED
@@ -0,0 +1,9 @@
1
+ {
2
+ "jsonrpc": "2.0",
3
+ "id": 2,
4
+ "method": "operation.result.get",
5
+ "params": {
6
+ "threadId": "00000000-0000-4000-8000-000000000002",
7
+ "operationId": "00000000-0000-4000-8000-000000000003"
8
+ }
9
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@roll-agent/protocol",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "type": "module",
5
5
  "repository": {
6
6
  "type": "git",
@@ -17,11 +17,17 @@
17
17
  },
18
18
  "./schema": "./dist/schema/roll-runtime-protocol-v1.schema.json",
19
19
  "./schema/latest": "./dist/schema/roll-runtime-protocol-v1.schema.json",
20
+ "./schema/1.4": "./dist/schema/roll-runtime-protocol-v1.4.schema.json",
20
21
  "./schema/1.3": "./dist/schema/roll-runtime-protocol-v1.3.schema.json",
21
22
  "./schema/1.2": "./dist/schema/roll-runtime-protocol-v1.2.schema.json",
22
23
  "./schema/1.1": "./dist/schema/roll-runtime-protocol-v1.1.schema.json",
23
24
  "./schema/1.0": "./dist/schema/roll-runtime-protocol-v1.0.schema.json",
24
- "./fixtures/*": "./fixtures/*"
25
+ "./fixtures/*": "./fixtures/*",
26
+ "./app-output": {
27
+ "types": "./dist/app-output.d.ts",
28
+ "default": "./dist/app-output.js"
29
+ },
30
+ "./schema/1.5": "./dist/schema/roll-runtime-protocol-v1.5.schema.json"
25
31
  },
26
32
  "publishConfig": {
27
33
  "access": "public"