@openscout/protocol 0.2.98 → 0.2.102

package/src/runtime-catalog.generated.ts

@@ -2,7 +2,7 @@
 
 export const SCOUT_RUNTIME_CATALOG_DATA = {
   "schemaVersion": "openscout.runtime-catalog.v1",
-  "revision": "2026-09-05.1",
+  "revision": "2026-09-10.1",
   "harnesses": [
     {
       "id": "claude",
@@ -161,7 +161,7 @@ export const SCOUT_RUNTIME_CATALOG_DATA = {
         "high",
         "xhigh"
       ],
-      "defaultReasoningEffort": "medium",
+      "defaultReasoningEffort": "high",
       "models": [
         {
           "id": "grok-4.6",
@@ -177,14 +177,8 @@ export const SCOUT_RUNTIME_CATALOG_DATA = {
           "label": "Grok 4.5",
           "enabled": true,
           "family": "Grok",
-          "version": "4.5"
-        },
-        {
-          "id": "grok-4.3",
-          "label": "Grok 4.3",
-          "enabled": true,
-          "family": "Grok",
-          "version": "4.3"
+          "version": "4.5",
+          "contextWindowTokens": 500000
         }
       ]
     },
@@ -192,7 +186,13 @@ export const SCOUT_RUNTIME_CATALOG_DATA = {
       "id": "grok-acp",
       "label": "Grok",
       "enabled": true,
-      "reasoningEfforts": null,
+      "reasoningEfforts": [
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
+      "defaultReasoningEffort": "high",
       "models": [
         {
           "id": "grok-4.6",
@@ -208,14 +208,8 @@ export const SCOUT_RUNTIME_CATALOG_DATA = {
           "label": "Grok 4.5",
           "enabled": true,
           "family": "Grok",
-          "version": "4.5"
-        },
-        {
-          "id": "grok-4.3",
-          "label": "Grok 4.3",
-          "enabled": true,
-          "family": "Grok",
-          "version": "4.3"
+          "version": "4.5",
+          "contextWindowTokens": 500000
         }
       ]
     },

package/src/runtime-catalog.v1.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "openscout.runtime-catalog.v1",
-  "revision": "2026-09-05.1",
+  "revision": "2026-09-10.1",
   "harnesses": [
     {
       "id": "claude",
@@ -40,22 +40,21 @@
       "enabled": true,
       "listed": false,
       "reasoningEfforts": ["low", "medium", "high", "xhigh"],
-      "defaultReasoningEffort": "medium",
+      "defaultReasoningEffort": "high",
       "models": [
         { "id": "grok-4.6", "label": "Grok 4.6", "enabled": true, "default": true, "family": "Grok", "version": "4.6", "contextWindowTokens": 500000 },
-        { "id": "grok-4.5", "label": "Grok 4.5", "enabled": true, "family": "Grok", "version": "4.5" },
-        { "id": "grok-4.3", "label": "Grok 4.3", "enabled": true, "family": "Grok", "version": "4.3" }
+        { "id": "grok-4.5", "label": "Grok 4.5", "enabled": true, "family": "Grok", "version": "4.5", "contextWindowTokens": 500000 }
       ]
     },
     {
       "id": "grok-acp",
       "label": "Grok",
       "enabled": true,
-      "reasoningEfforts": null,
+      "reasoningEfforts": ["low", "medium", "high", "xhigh"],
+      "defaultReasoningEffort": "high",
       "models": [
         { "id": "grok-4.6", "label": "Grok 4.6", "enabled": true, "default": true, "family": "Grok", "version": "4.6", "contextWindowTokens": 500000 },
-        { "id": "grok-4.5", "label": "Grok 4.5", "enabled": true, "family": "Grok", "version": "4.5" },
-        { "id": "grok-4.3", "label": "Grok 4.3", "enabled": true, "family": "Grok", "version": "4.3" }
+        { "id": "grok-4.5", "label": "Grok 4.5", "enabled": true, "family": "Grok", "version": "4.5", "contextWindowTokens": 500000 }
       ]
     },
     { "id": "kimi", "label": "Kimi Code", "enabled": true, "reasoningEfforts": null, "models": [] },

package/src/scout-delivery.ts

@@ -63,6 +63,7 @@ export type ScoutOperatorSignal =
       replyExpectation: "required";
       /** What the agent is asking for. Never empty — that is the whole point. */
       question: string;
+      requestKind?: "permission";
       /** Optional discrete choices, when the answer is a selection. */
       options?: string[];
       /** Why the agent cannot continue without it. */

package/src/terminal-host-topology.ts

@@ -120,6 +120,21 @@ export type HerdrWorkspaceProjection = {
   tabs: HerdrTabProjection[];
 };
 
+/**
+ * Why a projection is not live.
+ *
+ * `not_running` is the ordinary case: no herdr server answers for this session,
+ * so its persisted layout is the honest thing to show.
+ *
+ * `unreadable` is the case worth naming. A herdr server for this session IS
+ * running, but it did not answer the topology commands — a protocol skew
+ * between the installed client and a long-lived server is the common cause,
+ * and a busy server or a timeout look the same from here. Collapsing that into
+ * `not_running` would state, of live work, that it is not running. The
+ * projection says which it is so a reader never has to guess.
+ */
+export type HerdrTopologyUnavailableReason = "not_running" | "unreadable";
+
 export type HerdrSessionTopology = {
   /** Herdr session name, e.g. "openscout". */
   session: string;
@@ -134,8 +149,23 @@ export type HerdrSessionTopology = {
    * projection is live.
    */
   savedAt?: number | null;
+  /**
+   * Why this projection is not live. Set only when `running` is false; absent
+   * on a live read. See {@link HerdrTopologyUnavailableReason}.
+   */
+  unavailable?: HerdrTopologyUnavailableReason | null;
 };
 
-export function emptyHerdrSessionTopology(session: string, running: boolean): HerdrSessionTopology {
-  return { session, running, workspaces: [], observedAt: Date.now() };
+export function emptyHerdrSessionTopology(
+  session: string,
+  running: boolean,
+  unavailable?: HerdrTopologyUnavailableReason | null,
+): HerdrSessionTopology {
+  return {
+    session,
+    running,
+    workspaces: [],
+    observedAt: Date.now(),
+    ...(running ? {} : { unavailable: unavailable ?? "not_running" }),
+  };
 }