@roll-agent/protocol 0.9.0 → 0.11.0

package/dist/index.js

@@ -172,6 +172,7 @@ export function isRuntimeServerRequestMethodRequired(version, method) {
     return getRuntimeProtocolCapabilities(version).requiredServerRequestMethods.some((requiredMethod) => requiredMethod === method);
 }
 export const RUNTIME_METHODS = {
+    reasoningTextSubscribe: "reasoning.text.subscribe",
     operationResultGet: "operation.result.get",
     initialize: "initialize",
     clientCapabilitiesSet: "client.capabilities.set",
@@ -253,22 +254,29 @@ export const TOOL_OUTCOME_KINDS = [
     "cancelled",
     "tool_failed",
 ];
-export const threadIdSchema = z.string().uuid().brand();
-export const turnIdSchema = z.string().uuid().brand();
-export const approvalIdSchema = z.string().uuid().brand();
-export const interactionIdSchema = z.string().uuid().brand();
-export const runtimeInstanceIdSchema = z.string().uuid().brand();
-export const requestIdSchema = z.string().uuid().brand();
-export const streamIdSchema = z.string().uuid().brand();
-export const operationIdSchema = z.string().uuid().brand();
-export const runtimeEventIdSchema = z.string().uuid().brand();
-export const attachmentIdSchema = z.string().uuid().brand();
+// Wire formats are owned by Protocol: dependency upgrades must not broaden UUIDs or
+// reject timestamps that existing clients could send (including minute precision).
+export const uuidSchema = z
+    .string()
+    .check(z.stringFormat("uuid", /^([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)$/));
+export const timestampSchema = z
+    .string()
+    .check(z.stringFormat("datetime", /^(?:(?:\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})))$/));
+export const threadIdSchema = uuidSchema.clone().brand();
+export const turnIdSchema = uuidSchema.clone().brand();
+export const approvalIdSchema = uuidSchema.clone().brand();
+export const interactionIdSchema = uuidSchema.clone().brand();
+export const runtimeInstanceIdSchema = uuidSchema.clone().brand();
+export const requestIdSchema = uuidSchema.clone().brand();
+export const streamIdSchema = uuidSchema.clone().brand();
+export const operationIdSchema = uuidSchema.clone().brand();
+export const runtimeEventIdSchema = uuidSchema.clone().brand();
+export const attachmentIdSchema = uuidSchema.clone().brand();
 export const runtimeEventCursorSchema = z
     .string()
     .max(128)
     .regex(/^rte1:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}:(?:0|[1-9]\d*):[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/u)
     .brand();
-export const timestampSchema = z.string().datetime({ offset: true });
 export const jsonValueSchema = z.json();
 export const jsonRpcIdSchema = z.union([z.string(), z.number()]);
 export const runtimeProtocolVersionSchema = z.enum(SUPPORTED_RUNTIME_PROTOCOL_VERSIONS);
@@ -934,14 +942,8 @@ const recoveryThreadSummarySchema = z
     id: threadIdSchema,
     title: z.string().max(RUNTIME_V13_RECOVERY_SNAPSHOT_METADATA_MAX_CHARS).optional(),
     model: z.string().max(RUNTIME_V13_RECOVERY_SNAPSHOT_METADATA_MAX_CHARS).optional(),
-    createdAt: z
-        .string()
-        .max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS)
-        .datetime({ offset: true }),
-    updatedAt: z
-        .string()
-        .max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS)
-        .datetime({ offset: true }),
+    createdAt: timestampSchema.max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS),
+    updatedAt: timestampSchema.max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS),
     messageCount: z.number().int().nonnegative(),
 })
     .strict()
@@ -964,10 +966,7 @@ const recoveryActiveTurnSchema = z
     .object({
     id: turnIdSchema,
     status: z.enum(["running", "cancelling", "waiting-for-user"]),
-    startedAt: z
-        .string()
-        .max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS)
-        .datetime({ offset: true }),
+    startedAt: timestampSchema.max(RUNTIME_V13_RECOVERY_SNAPSHOT_TIMESTAMP_MAX_CHARS),
 })
     .strict()
     .readonly();
@@ -1016,7 +1015,7 @@ export const threadSnapshotV15Schema = z.union([
 /** Bounded Harness state only; no model-authored recovery notes or fact contents cross the wire. */
 export const contextRecoveryViewSchema = z
     .object({
-    checkpointId: z.string().uuid(),
+    checkpointId: uuidSchema.clone(),
     required: z.boolean(),
     unextracted: z.boolean(),
     requiredItemCount: z.number().int().nonnegative(),
@@ -1481,13 +1480,12 @@ const messageCompletedEventSchema = z
     .object({ type: z.literal("message.completed"), streamId: streamIdSchema, text: z.string() })
     .strict()
     .readonly();
+const reasoningDeltaFields = { reasoningId: z.string().min(1), delta: z.string() };
 const reasoningSummaryDeltaEventSchema = z
-    .object({
-    type: z.literal("reasoning.summary.delta"),
-    reasoningId: z.string().min(1),
-    delta: z.string(),
-})
-    .strict()
+    .strictObject({ type: z.literal("reasoning.summary.delta"), ...reasoningDeltaFields })
+    .readonly();
+const reasoningTextDeltaEventSchema = z
+    .strictObject({ type: z.literal("reasoning.text.delta"), ...reasoningDeltaFields })
     .readonly();
 const toolStartedEventSchema = z
     .object({
@@ -1622,9 +1620,13 @@ export const runtimeDurableEventV16Schema = z.discriminatedUnion("type", [
     ...runtimeDurableEventV15Schema.options,
     contextRecoveryChangedEventSchema,
 ]);
+export const runtimeEphemeralEventV16Schema = z.discriminatedUnion("type", [
+    ...runtimeEphemeralEventV13Schema.options,
+    reasoningTextDeltaEventSchema,
+]);
 export const runtimeEventV16Schema = z.union([
     runtimeDurableEventV16Schema,
-    runtimeEphemeralEventV13Schema,
+    runtimeEphemeralEventV16Schema,
 ]);
 /** Latest Runtime Protocol event payloads. */
 export const runtimeEventSchema = runtimeEventV16Schema;
@@ -1744,16 +1746,27 @@ export const runtimeEventEnvelopeV15Schema = z.discriminatedUnion("durability",
     runtimeEphemeralEventEnvelopeV15Schema,
 ]);
 /** Any currently supported Runtime Event envelope. */
-export const runtimeDurableEventEnvelopeV16Schema = runtimeDurableEventEnvelopeV15Schema.def.innerType
-    .extend({
+export const runtimeDurableEventEnvelopeV16Schema = z
+    .object({
     protocolVersion: z.literal("1.6"),
+    ...runtimeEventEnvelopeFields,
+    durability: z.literal("durable"),
+    eventId: runtimeEventIdSchema,
+    cursor: runtimeEventCursorSchema,
     event: runtimeDurableEventV16Schema,
 })
+    .strict()
+    .superRefine(validateRuntimeEventCapabilities)
     .readonly();
-export const runtimeEphemeralEventEnvelopeV16Schema = runtimeEphemeralEventEnvelopeV15Schema.def.innerType
-    .extend({
+export const runtimeEphemeralEventEnvelopeV16Schema = z
+    .object({
     protocolVersion: z.literal("1.6"),
+    ...runtimeEventEnvelopeFields,
+    durability: z.literal("ephemeral"),
+    event: runtimeEphemeralEventV16Schema,
 })
+    .strict()
+    .superRefine(validateRuntimeEventCapabilities)
     .readonly();
 export const runtimeEventEnvelopeV16Schema = z.discriminatedUnion("durability", [
     runtimeDurableEventEnvelopeV16Schema,
@@ -1952,6 +1965,10 @@ export const runtimeMethodSchemasV15 = {
 };
 export const runtimeMethodSchemasV16 = {
     ...runtimeMethodSchemasV15,
+    [RUNTIME_METHODS.reasoningTextSubscribe]: {
+        params: z.object({}).strict().readonly(),
+        result: z.object({ subscribed: z.boolean() }).strict().readonly(),
+    },
     [RUNTIME_METHODS.approvalPreview]: {
         params: approvalPreviewParamsSchema,
         result: approvalPreviewResultSchema,

package/dist/schema/roll-runtime-protocol-v1.6.schema.json

@@ -744,6 +744,29 @@
                     "delta"
                   ],
                   "additionalProperties": false
+                },
+                {
+                  "readOnly": true,
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "const": "reasoning.text.delta"
+                    },
+                    "reasoningId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "delta": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "reasoningId",
+                    "delta"
+                  ],
+                  "additionalProperties": false
                 }
               ]
             }
@@ -5483,6 +5506,25 @@
       ],
       "additionalProperties": false
     },
+    "reasoningTextSubscribeParams": {
+      "readOnly": true,
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "reasoningTextSubscribeResult": {
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "subscribed": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "subscribed"
+      ],
+      "additionalProperties": false
+    },
     "approvalPreviewParams": {
       "readOnly": true,
       "type": "object",
@@ -6602,6 +6644,30 @@
       ],
       "additionalProperties": false
     },
+    "reasoningTextSubscribeRequest": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "const": "2.0"
+        },
+        "id": {
+          "$ref": "#/$defs/jsonRpcId"
+        },
+        "method": {
+          "const": "reasoning.text.subscribe"
+        },
+        "params": {
+          "$ref": "#/$defs/reasoningTextSubscribeParams"
+        }
+      },
+      "required": [
+        "jsonrpc",
+        "id",
+        "method",
+        "params"
+      ],
+      "additionalProperties": false
+    },
     "approvalPreviewRequest": {
       "type": "object",
       "properties": {
@@ -6736,6 +6802,9 @@
         {
           "$ref": "#/$defs/operationResultGetRequest"
         },
+        {
+          "$ref": "#/$defs/reasoningTextSubscribeRequest"
+        },
         {
           "$ref": "#/$defs/approvalPreviewRequest"
         }
@@ -6862,6 +6931,9 @@
             {
               "$ref": "#/$defs/operationResultGetResult"
             },
+            {
+              "$ref": "#/$defs/reasoningTextSubscribeResult"
+            },
             {
               "$ref": "#/$defs/approvalPreviewResult"
             },
@@ -7147,6 +7219,17 @@
         "$ref": "#/$defs/operationResultGetRequest"
       }
     },
+    "reasoning.text.subscribe": {
+      "params": {
+        "$ref": "#/$defs/reasoningTextSubscribeParams"
+      },
+      "result": {
+        "$ref": "#/$defs/reasoningTextSubscribeResult"
+      },
+      "request": {
+        "$ref": "#/$defs/reasoningTextSubscribeRequest"
+      }
+    },
     "approval.preview": {
       "params": {
         "$ref": "#/$defs/approvalPreviewParams"

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

@@ -744,6 +744,29 @@
                     "delta"
                   ],
                   "additionalProperties": false
+                },
+                {
+                  "readOnly": true,
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "const": "reasoning.text.delta"
+                    },
+                    "reasoningId": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "delta": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "reasoningId",
+                    "delta"
+                  ],
+                  "additionalProperties": false
                 }
               ]
             }
@@ -5483,6 +5506,25 @@
       ],
       "additionalProperties": false
     },
+    "reasoningTextSubscribeParams": {
+      "readOnly": true,
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "reasoningTextSubscribeResult": {
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "subscribed": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "subscribed"
+      ],
+      "additionalProperties": false
+    },
     "approvalPreviewParams": {
       "readOnly": true,
       "type": "object",
@@ -6602,6 +6644,30 @@
       ],
       "additionalProperties": false
     },
+    "reasoningTextSubscribeRequest": {
+      "type": "object",
+      "properties": {
+        "jsonrpc": {
+          "const": "2.0"
+        },
+        "id": {
+          "$ref": "#/$defs/jsonRpcId"
+        },
+        "method": {
+          "const": "reasoning.text.subscribe"
+        },
+        "params": {
+          "$ref": "#/$defs/reasoningTextSubscribeParams"
+        }
+      },
+      "required": [
+        "jsonrpc",
+        "id",
+        "method",
+        "params"
+      ],
+      "additionalProperties": false
+    },
     "approvalPreviewRequest": {
       "type": "object",
       "properties": {
@@ -6736,6 +6802,9 @@
         {
           "$ref": "#/$defs/operationResultGetRequest"
         },
+        {
+          "$ref": "#/$defs/reasoningTextSubscribeRequest"
+        },
         {
           "$ref": "#/$defs/approvalPreviewRequest"
         }
@@ -6862,6 +6931,9 @@
             {
               "$ref": "#/$defs/operationResultGetResult"
             },
+            {
+              "$ref": "#/$defs/reasoningTextSubscribeResult"
+            },
             {
               "$ref": "#/$defs/approvalPreviewResult"
             },
@@ -7147,6 +7219,17 @@
         "$ref": "#/$defs/operationResultGetRequest"
       }
     },
+    "reasoning.text.subscribe": {
+      "params": {
+        "$ref": "#/$defs/reasoningTextSubscribeParams"
+      },
+      "result": {
+        "$ref": "#/$defs/reasoningTextSubscribeResult"
+      },
+      "request": {
+        "$ref": "#/$defs/reasoningTextSubscribeRequest"
+      }
+    },
     "approval.preview": {
       "params": {
         "$ref": "#/$defs/approvalPreviewParams"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/protocol",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -42,7 +42,7 @@
     "fixtures"
   ],
   "dependencies": {
-    "zod": "3.25.76"
+    "zod": "4.6.6"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",