@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/dist/schema/roll-runtime-protocol-v1.schema.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "urn:roll-agent:schema:runtime-protocol:1.4",
4
- "title": "Roll Runtime Protocol v1.4",
3
+ "$id": "urn:roll-agent:schema:runtime-protocol:1.5",
4
+ "title": "Roll Runtime Protocol v1.5",
5
5
  "description": "Bidirectional JSON-RPC requests, responses, and notifications for Roll Runtime Protocol.",
6
6
  "oneOf": [
7
7
  {
@@ -42,7 +42,7 @@
42
42
  "properties": {
43
43
  "protocolVersion": {
44
44
  "type": "string",
45
- "const": "1.4"
45
+ "const": "1.5"
46
46
  },
47
47
  "runtimeInstanceId": {
48
48
  "type": "string",
@@ -174,6 +174,84 @@
174
174
  },
175
175
  "display": {
176
176
  "$ref": "#/$defs/sharedSchema0"
177
+ },
178
+ "appOutput": {
179
+ "default": {
180
+ "status": "not_provided"
181
+ },
182
+ "readOnly": true,
183
+ "anyOf": [
184
+ {
185
+ "readOnly": true,
186
+ "type": "object",
187
+ "properties": {
188
+ "status": {
189
+ "type": "string",
190
+ "const": "rejected"
191
+ },
192
+ "reason": {
193
+ "type": "string",
194
+ "enum": [
195
+ "credential_field",
196
+ "credential_value"
197
+ ]
198
+ },
199
+ "field": {
200
+ "type": "string",
201
+ "maxLength": 64
202
+ }
203
+ },
204
+ "required": [
205
+ "status",
206
+ "reason"
207
+ ],
208
+ "additionalProperties": false
209
+ },
210
+ {
211
+ "type": "object",
212
+ "properties": {
213
+ "status": {
214
+ "type": "string",
215
+ "const": "available"
216
+ },
217
+ "schemaId": {
218
+ "type": "string",
219
+ "minLength": 1,
220
+ "maxLength": 256
221
+ },
222
+ "schemaVersion": {
223
+ "type": "integer",
224
+ "exclusiveMinimum": 0,
225
+ "maximum": 9007199254740991
226
+ }
227
+ },
228
+ "required": [
229
+ "status",
230
+ "schemaId",
231
+ "schemaVersion"
232
+ ],
233
+ "additionalProperties": false
234
+ },
235
+ {
236
+ "type": "object",
237
+ "properties": {
238
+ "status": {
239
+ "type": "string",
240
+ "enum": [
241
+ "not_provided",
242
+ "invalid",
243
+ "too_large",
244
+ "expired",
245
+ "denied"
246
+ ]
247
+ }
248
+ },
249
+ "required": [
250
+ "status"
251
+ ],
252
+ "additionalProperties": false
253
+ }
254
+ ]
177
255
  }
178
256
  },
179
257
  "required": [
@@ -181,7 +259,8 @@
181
259
  "toolCallId",
182
260
  "agentName",
183
261
  "toolName",
184
- "display"
262
+ "display",
263
+ "appOutput"
185
264
  ],
186
265
  "additionalProperties": false
187
266
  },
@@ -441,7 +520,7 @@
441
520
  "properties": {
442
521
  "protocolVersion": {
443
522
  "type": "string",
444
- "const": "1.4"
523
+ "const": "1.5"
445
524
  },
446
525
  "runtimeInstanceId": {
447
526
  "type": "string",
@@ -742,7 +821,7 @@
742
821
  "properties": {
743
822
  "protocolVersion": {
744
823
  "type": "string",
745
- "const": "1.4"
824
+ "const": "1.5"
746
825
  },
747
826
  "runtimeInstanceId": {
748
827
  "type": "string",
@@ -789,7 +868,8 @@
789
868
  "reasoning-summary",
790
869
  "operation-projection",
791
870
  "process-local-sequence",
792
- "attachments"
871
+ "attachments",
872
+ "app-output"
793
873
  ]
794
874
  }
795
875
  },
@@ -1246,6 +1326,81 @@
1246
1326
  },
1247
1327
  "display": {
1248
1328
  "$ref": "#/$defs/sharedSchema0"
1329
+ },
1330
+ "appOutput": {
1331
+ "readOnly": true,
1332
+ "anyOf": [
1333
+ {
1334
+ "readOnly": true,
1335
+ "type": "object",
1336
+ "properties": {
1337
+ "status": {
1338
+ "type": "string",
1339
+ "const": "rejected"
1340
+ },
1341
+ "reason": {
1342
+ "type": "string",
1343
+ "enum": [
1344
+ "credential_field",
1345
+ "credential_value"
1346
+ ]
1347
+ },
1348
+ "field": {
1349
+ "type": "string",
1350
+ "maxLength": 64
1351
+ }
1352
+ },
1353
+ "required": [
1354
+ "status",
1355
+ "reason"
1356
+ ],
1357
+ "additionalProperties": false
1358
+ },
1359
+ {
1360
+ "type": "object",
1361
+ "properties": {
1362
+ "status": {
1363
+ "type": "string",
1364
+ "const": "available"
1365
+ },
1366
+ "schemaId": {
1367
+ "type": "string",
1368
+ "minLength": 1,
1369
+ "maxLength": 256
1370
+ },
1371
+ "schemaVersion": {
1372
+ "type": "integer",
1373
+ "exclusiveMinimum": 0,
1374
+ "maximum": 9007199254740991
1375
+ }
1376
+ },
1377
+ "required": [
1378
+ "status",
1379
+ "schemaId",
1380
+ "schemaVersion"
1381
+ ],
1382
+ "additionalProperties": false
1383
+ },
1384
+ {
1385
+ "type": "object",
1386
+ "properties": {
1387
+ "status": {
1388
+ "type": "string",
1389
+ "enum": [
1390
+ "not_provided",
1391
+ "invalid",
1392
+ "too_large",
1393
+ "expired",
1394
+ "denied"
1395
+ ]
1396
+ }
1397
+ },
1398
+ "required": [
1399
+ "status"
1400
+ ],
1401
+ "additionalProperties": false
1402
+ }
1403
+ ]
1249
1404
  }
1250
1405
  },
1251
1406
  "required": [
@@ -1256,7 +1411,8 @@
1256
1411
  "toolName",
1257
1412
  "createdAt",
1258
1413
  "outcome",
1259
- "display"
1414
+ "display",
1415
+ "appOutput"
1260
1416
  ],
1261
1417
  "additionalProperties": false
1262
1418
  }
@@ -2696,6 +2852,81 @@
2696
2852
  },
2697
2853
  "display": {
2698
2854
  "$ref": "#/$defs/sharedSchema0"
2855
+ },
2856
+ "appOutput": {
2857
+ "readOnly": true,
2858
+ "anyOf": [
2859
+ {
2860
+ "readOnly": true,
2861
+ "type": "object",
2862
+ "properties": {
2863
+ "status": {
2864
+ "type": "string",
2865
+ "const": "rejected"
2866
+ },
2867
+ "reason": {
2868
+ "type": "string",
2869
+ "enum": [
2870
+ "credential_field",
2871
+ "credential_value"
2872
+ ]
2873
+ },
2874
+ "field": {
2875
+ "type": "string",
2876
+ "maxLength": 64
2877
+ }
2878
+ },
2879
+ "required": [
2880
+ "status",
2881
+ "reason"
2882
+ ],
2883
+ "additionalProperties": false
2884
+ },
2885
+ {
2886
+ "type": "object",
2887
+ "properties": {
2888
+ "status": {
2889
+ "type": "string",
2890
+ "const": "available"
2891
+ },
2892
+ "schemaId": {
2893
+ "type": "string",
2894
+ "minLength": 1,
2895
+ "maxLength": 256
2896
+ },
2897
+ "schemaVersion": {
2898
+ "type": "integer",
2899
+ "exclusiveMinimum": 0,
2900
+ "maximum": 9007199254740991
2901
+ }
2902
+ },
2903
+ "required": [
2904
+ "status",
2905
+ "schemaId",
2906
+ "schemaVersion"
2907
+ ],
2908
+ "additionalProperties": false
2909
+ },
2910
+ {
2911
+ "type": "object",
2912
+ "properties": {
2913
+ "status": {
2914
+ "type": "string",
2915
+ "enum": [
2916
+ "not_provided",
2917
+ "invalid",
2918
+ "too_large",
2919
+ "expired",
2920
+ "denied"
2921
+ ]
2922
+ }
2923
+ },
2924
+ "required": [
2925
+ "status"
2926
+ ],
2927
+ "additionalProperties": false
2928
+ }
2929
+ ]
2699
2930
  }
2700
2931
  },
2701
2932
  "required": [
@@ -2706,7 +2937,8 @@
2706
2937
  "toolName",
2707
2938
  "createdAt",
2708
2939
  "outcome",
2709
- "display"
2940
+ "display",
2941
+ "appOutput"
2710
2942
  ],
2711
2943
  "additionalProperties": false
2712
2944
  }
@@ -4318,6 +4550,81 @@
4318
4550
  },
4319
4551
  "display": {
4320
4552
  "$ref": "#/$defs/sharedSchema0"
4553
+ },
4554
+ "appOutput": {
4555
+ "readOnly": true,
4556
+ "anyOf": [
4557
+ {
4558
+ "readOnly": true,
4559
+ "type": "object",
4560
+ "properties": {
4561
+ "status": {
4562
+ "type": "string",
4563
+ "const": "rejected"
4564
+ },
4565
+ "reason": {
4566
+ "type": "string",
4567
+ "enum": [
4568
+ "credential_field",
4569
+ "credential_value"
4570
+ ]
4571
+ },
4572
+ "field": {
4573
+ "type": "string",
4574
+ "maxLength": 64
4575
+ }
4576
+ },
4577
+ "required": [
4578
+ "status",
4579
+ "reason"
4580
+ ],
4581
+ "additionalProperties": false
4582
+ },
4583
+ {
4584
+ "type": "object",
4585
+ "properties": {
4586
+ "status": {
4587
+ "type": "string",
4588
+ "const": "available"
4589
+ },
4590
+ "schemaId": {
4591
+ "type": "string",
4592
+ "minLength": 1,
4593
+ "maxLength": 256
4594
+ },
4595
+ "schemaVersion": {
4596
+ "type": "integer",
4597
+ "exclusiveMinimum": 0,
4598
+ "maximum": 9007199254740991
4599
+ }
4600
+ },
4601
+ "required": [
4602
+ "status",
4603
+ "schemaId",
4604
+ "schemaVersion"
4605
+ ],
4606
+ "additionalProperties": false
4607
+ },
4608
+ {
4609
+ "type": "object",
4610
+ "properties": {
4611
+ "status": {
4612
+ "type": "string",
4613
+ "enum": [
4614
+ "not_provided",
4615
+ "invalid",
4616
+ "too_large",
4617
+ "expired",
4618
+ "denied"
4619
+ ]
4620
+ }
4621
+ },
4622
+ "required": [
4623
+ "status"
4624
+ ],
4625
+ "additionalProperties": false
4626
+ }
4627
+ ]
4321
4628
  }
4322
4629
  },
4323
4630
  "required": [
@@ -4328,7 +4635,8 @@
4328
4635
  "toolName",
4329
4636
  "createdAt",
4330
4637
  "outcome",
4331
- "display"
4638
+ "display",
4639
+ "appOutput"
4332
4640
  ],
4333
4641
  "additionalProperties": false
4334
4642
  },
@@ -4805,6 +5113,176 @@
4805
5113
  ],
4806
5114
  "additionalProperties": false
4807
5115
  },
5116
+ "operationResultGetParams": {
5117
+ "readOnly": true,
5118
+ "type": "object",
5119
+ "properties": {
5120
+ "threadId": {
5121
+ "type": "string",
5122
+ "format": "uuid",
5123
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
5124
+ },
5125
+ "operationId": {
5126
+ "type": "string",
5127
+ "format": "uuid",
5128
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
5129
+ }
5130
+ },
5131
+ "required": [
5132
+ "threadId",
5133
+ "operationId"
5134
+ ],
5135
+ "additionalProperties": false
5136
+ },
5137
+ "operationResultGetResult": {
5138
+ "readOnly": true,
5139
+ "type": "object",
5140
+ "properties": {
5141
+ "result": {
5142
+ "anyOf": [
5143
+ {
5144
+ "readOnly": true,
5145
+ "type": "object",
5146
+ "properties": {
5147
+ "threadId": {
5148
+ "type": "string",
5149
+ "format": "uuid",
5150
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
5151
+ },
5152
+ "operationId": {
5153
+ "type": "string",
5154
+ "format": "uuid",
5155
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
5156
+ },
5157
+ "agentName": {
5158
+ "type": "string",
5159
+ "minLength": 1
5160
+ },
5161
+ "toolName": {
5162
+ "type": "string",
5163
+ "minLength": 1
5164
+ },
5165
+ "createdAt": {
5166
+ "type": "string",
5167
+ "format": "date-time",
5168
+ "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-]\\d{2}:\\d{2})))$"
5169
+ },
5170
+ "output": {
5171
+ "readOnly": true,
5172
+ "anyOf": [
5173
+ {
5174
+ "readOnly": true,
5175
+ "type": "object",
5176
+ "properties": {
5177
+ "status": {
5178
+ "type": "string",
5179
+ "const": "rejected"
5180
+ },
5181
+ "reason": {
5182
+ "type": "string",
5183
+ "enum": [
5184
+ "credential_field",
5185
+ "credential_value"
5186
+ ]
5187
+ },
5188
+ "field": {
5189
+ "type": "string",
5190
+ "maxLength": 64
5191
+ }
5192
+ },
5193
+ "required": [
5194
+ "status",
5195
+ "reason"
5196
+ ],
5197
+ "additionalProperties": false
5198
+ },
5199
+ {
5200
+ "type": "object",
5201
+ "properties": {
5202
+ "status": {
5203
+ "type": "string",
5204
+ "const": "available"
5205
+ },
5206
+ "schemaId": {
5207
+ "type": "string",
5208
+ "minLength": 1,
5209
+ "maxLength": 256
5210
+ },
5211
+ "schemaVersion": {
5212
+ "type": "integer",
5213
+ "exclusiveMinimum": 0,
5214
+ "maximum": 9007199254740991
5215
+ },
5216
+ "remoteReadable": {
5217
+ "type": "boolean"
5218
+ },
5219
+ "data": {
5220
+ "type": "object",
5221
+ "propertyNames": {
5222
+ "type": "string"
5223
+ },
5224
+ "additionalProperties": {
5225
+ "$ref": "#/$defs/sharedSchema1"
5226
+ }
5227
+ },
5228
+ "fallbackText": {
5229
+ "type": "string",
5230
+ "maxLength": 4096
5231
+ }
5232
+ },
5233
+ "required": [
5234
+ "status",
5235
+ "schemaId",
5236
+ "schemaVersion",
5237
+ "remoteReadable",
5238
+ "data",
5239
+ "fallbackText"
5240
+ ],
5241
+ "additionalProperties": false
5242
+ },
5243
+ {
5244
+ "type": "object",
5245
+ "properties": {
5246
+ "status": {
5247
+ "type": "string",
5248
+ "enum": [
5249
+ "not_provided",
5250
+ "invalid",
5251
+ "too_large",
5252
+ "expired",
5253
+ "denied"
5254
+ ]
5255
+ }
5256
+ },
5257
+ "required": [
5258
+ "status"
5259
+ ],
5260
+ "additionalProperties": false
5261
+ }
5262
+ ]
5263
+ }
5264
+ },
5265
+ "required": [
5266
+ "threadId",
5267
+ "operationId",
5268
+ "agentName",
5269
+ "toolName",
5270
+ "createdAt",
5271
+ "output"
5272
+ ],
5273
+ "additionalProperties": false
5274
+ },
5275
+ {
5276
+ "type": "null"
5277
+ }
5278
+ ]
5279
+ }
5280
+ },
5281
+ "required": [
5282
+ "result"
5283
+ ],
5284
+ "additionalProperties": false
5285
+ },
4808
5286
  "approvalRequestParams": {
4809
5287
  "readOnly": true,
4810
5288
  "type": "object",
@@ -5339,6 +5817,37 @@
5339
5817
  }
5340
5818
  ]
5341
5819
  },
5820
+ "sharedSchema1": {
5821
+ "anyOf": [
5822
+ {
5823
+ "type": "string"
5824
+ },
5825
+ {
5826
+ "type": "number"
5827
+ },
5828
+ {
5829
+ "type": "boolean"
5830
+ },
5831
+ {
5832
+ "type": "null"
5833
+ },
5834
+ {
5835
+ "type": "array",
5836
+ "items": {
5837
+ "$ref": "#/$defs/sharedSchema1"
5838
+ }
5839
+ },
5840
+ {
5841
+ "type": "object",
5842
+ "propertyNames": {
5843
+ "type": "string"
5844
+ },
5845
+ "additionalProperties": {
5846
+ "$ref": "#/$defs/sharedSchema1"
5847
+ }
5848
+ }
5849
+ ]
5850
+ },
5342
5851
  "initializeRequest": {
5343
5852
  "type": "object",
5344
5853
  "properties": {
@@ -5795,6 +6304,30 @@
5795
6304
  ],
5796
6305
  "additionalProperties": false
5797
6306
  },
6307
+ "operationResultGetRequest": {
6308
+ "type": "object",
6309
+ "properties": {
6310
+ "jsonrpc": {
6311
+ "const": "2.0"
6312
+ },
6313
+ "id": {
6314
+ "$ref": "#/$defs/jsonRpcId"
6315
+ },
6316
+ "method": {
6317
+ "const": "operation.result.get"
6318
+ },
6319
+ "params": {
6320
+ "$ref": "#/$defs/operationResultGetParams"
6321
+ }
6322
+ },
6323
+ "required": [
6324
+ "jsonrpc",
6325
+ "id",
6326
+ "method",
6327
+ "params"
6328
+ ],
6329
+ "additionalProperties": false
6330
+ },
5798
6331
  "approvalRequestServerRequest": {
5799
6332
  "type": "object",
5800
6333
  "properties": {
@@ -5901,6 +6434,9 @@
5901
6434
  },
5902
6435
  {
5903
6436
  "$ref": "#/$defs/attachmentReleaseRequest"
6437
+ },
6438
+ {
6439
+ "$ref": "#/$defs/operationResultGetRequest"
5904
6440
  }
5905
6441
  ]
5906
6442
  },
@@ -6022,6 +6558,9 @@
6022
6558
  {
6023
6559
  "$ref": "#/$defs/attachmentReleaseResult"
6024
6560
  },
6561
+ {
6562
+ "$ref": "#/$defs/operationResultGetResult"
6563
+ },
6025
6564
  {
6026
6565
  "$ref": "#/$defs/approvalRequestResult"
6027
6566
  },
@@ -6082,7 +6621,7 @@
6082
6621
  "additionalProperties": false
6083
6622
  }
6084
6623
  },
6085
- "x-roll-protocol-version": "1.4",
6624
+ "x-roll-protocol-version": "1.5",
6086
6625
  "x-roll-methods": {
6087
6626
  "initialize": {
6088
6627
  "params": {
@@ -6292,6 +6831,17 @@
6292
6831
  "request": {
6293
6832
  "$ref": "#/$defs/attachmentReleaseRequest"
6294
6833
  }
6834
+ },
6835
+ "operation.result.get": {
6836
+ "params": {
6837
+ "$ref": "#/$defs/operationResultGetParams"
6838
+ },
6839
+ "result": {
6840
+ "$ref": "#/$defs/operationResultGetResult"
6841
+ },
6842
+ "request": {
6843
+ "$ref": "#/$defs/operationResultGetRequest"
6844
+ }
6295
6845
  }
6296
6846
  },
6297
6847
  "x-roll-server-request-methods": {