@smthrs/gateway 0.33.0 → 0.34.0

package/openapi.yaml

@@ -9018,7 +9018,7 @@ paths:
     post:
       operationId: getNodeDiff
       summary: "Get Node Diff"
-      description: "Fetch a node-level diff bundle for one iteration."
+      description: "Fetch a node-level diff bundle for one iteration. In-progress attempts return a live working-copy diff (`live: true`)."
       tags:
         - "Gateway RPC"
       security:
@@ -9508,7 +9508,7 @@ paths:
     post:
       operationId: getRunDiff
       summary: "Get Run Diff"
-      description: "Fetch the final base-to-terminal DiffBundle for a run. An oversized result is returned as an explicit marker."
+      description: "Fetch the base-to-terminal DiffBundle for a run. Non-terminal runs return a live working-copy diff (`live: true`). An oversized result is returned as an explicit marker."
       tags:
         - "Gateway RPC"
       security:
@@ -9583,7 +9583,7 @@ paths:
                     oneOf:
                       -
                         type: object
-                        description: "Final run DiffBundle."
+                        description: "Run DiffBundle (final, or live for a non-terminal run)."
                         properties:
                           seq:
                             type: integer
@@ -9620,6 +9620,9 @@ paths:
                                 - operation
                                 - diff
                               additionalProperties: false
+                          live:
+                            type: boolean
+                            description: "True when computed from the live working copy of a non-terminal run."
                         required:
                           - seq
                           - baseRef

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smthrs/gateway",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Stable Smithers Gateway RPC contracts, auth scopes, and deployment metadata",
   "type": "module",
   "sideEffects": false,
@@ -31,7 +31,7 @@
     "openapi.yaml"
   ],
   "dependencies": {
-    "@smthrs/protocol": "0.33.0"
+    "@smthrs/protocol": "0.34.0"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/rpc/index.js

@@ -1435,7 +1435,8 @@ export const GATEWAY_RPC_DEFINITIONS = [
     version: SMITHERS_API_VERSION,
     method: "getNodeDiff",
     title: "Get Node Diff",
-    description: "Fetch a node-level diff bundle for one iteration.",
+    description:
+      "Fetch a node-level diff bundle for one iteration. In-progress attempts return a live working-copy diff (`live: true`).",
     maturity: "stable",
     transport: "http+websocket",
     requiredScope: "run:read",
@@ -1460,7 +1461,7 @@ export const GATEWAY_RPC_DEFINITIONS = [
     method: "getRunDiff",
     title: "Get Run Diff",
     description:
-      "Fetch the final base-to-terminal DiffBundle for a run. An oversized result is returned as an explicit marker.",
+      "Fetch the base-to-terminal DiffBundle for a run. Non-terminal runs return a live working-copy diff (`live: true`). An oversized result is returned as an explicit marker.",
     maturity: "stable",
     transport: "http+websocket",
     requiredScope: "run:read",
@@ -1485,9 +1486,13 @@ export const GATEWAY_RPC_DEFINITIONS = [
               },
               "Changed files.",
             ),
+            live: {
+              type: "boolean",
+              description: "True when computed from the live working copy of a non-terminal run.",
+            },
           },
           ["seq", "baseRef", "patches"],
-          "Final run DiffBundle.",
+          "Run DiffBundle (final, or live for a non-terminal run).",
         ),
         objectSchema(
           {