@openscout/protocol 0.2.98 → 0.2.104

package/src/mesh.ts

@@ -89,6 +89,14 @@ export interface NodeDefinition {
   advertiseScope: AdvertiseScope;
   brokerUrl?: string;
   webUrl?: string;
+  /**
+   * The node's named web doorway (e.g. `m1.scout.local`), matching the edge's
+   * advertisedHost. `*.scout.local` names resolve to 127.0.0.1 on every LAN
+   * machine; the local edge recognizes them as peer doorways and proxies to
+   * this node's reachable route, so the name is a stable way to open a peer's
+   * Scout regardless of its current address.
+   */
+  webHost?: string;
   meshEntrypoints?: NodeMeshEntrypoint[];
   tailnetName?: string;
   capabilities?: string[];

package/src/runtime-catalog-contract.ts

@@ -2,7 +2,7 @@ import type { AgentHarness } from "./actors.js";
 
 /** Harness ids Scout can select for a new execution session. */
 export const SCOUT_LAUNCHABLE_HARNESSES = [
-  "claude", "codex", "grok", "grok-acp", "kimi", "flue", "cursor", "opencode", "pi",
+  "claude", "codex", "grok", "grok-acp", "kimi", "flue", "cursor", "opencode", "pi", "devin",
 ] as const satisfies readonly AgentHarness[];
 
 export type ScoutLaunchableHarness = typeof SCOUT_LAUNCHABLE_HARNESSES[number];

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-14.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
         }
       ]
     },
@@ -318,6 +312,39 @@ export const SCOUT_RUNTIME_CATALOG_DATA = {
       "enabled": true,
       "reasoningEfforts": null,
       "models": []
+    },
+    {
+      "id": "devin",
+      "label": "Devin",
+      "enabled": true,
+      "reasoningEfforts": null,
+      "models": [
+        {
+          "id": "swe-2-high",
+          "label": "SWE-2 High",
+          "enabled": true,
+          "default": true,
+          "family": "SWE",
+          "version": "2 High",
+          "contextWindowTokens": 262000
+        },
+        {
+          "id": "swe-2-medium",
+          "label": "SWE-2 Medium",
+          "enabled": true,
+          "family": "SWE",
+          "version": "2 Medium",
+          "contextWindowTokens": 262000
+        },
+        {
+          "id": "swe-2-max",
+          "label": "SWE-2 Max",
+          "enabled": true,
+          "family": "SWE",
+          "version": "2 Max",
+          "contextWindowTokens": 262000
+        }
+      ]
     }
   ]
 } as const;

package/src/runtime-catalog.v1.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "openscout.runtime-catalog.v1",
-  "revision": "2026-09-05.1",
+  "revision": "2026-09-14.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": [] },
@@ -78,6 +77,17 @@
         { "id": "opencode/laguna-s-2.1-free", "label": "Laguna S 2.1 (free)", "enabled": true, "family": "Laguna", "version": "S 2.1 Free" }
       ]
     },
-    { "id": "pi", "label": "Pi", "enabled": true, "reasoningEfforts": null, "models": [] }
+    { "id": "pi", "label": "Pi", "enabled": true, "reasoningEfforts": null, "models": [] },
+    {
+      "id": "devin",
+      "label": "Devin",
+      "enabled": true,
+      "reasoningEfforts": null,
+      "models": [
+        { "id": "swe-2-high", "label": "SWE-2 High", "enabled": true, "default": true, "family": "SWE", "version": "2 High", "contextWindowTokens": 262000 },
+        { "id": "swe-2-medium", "label": "SWE-2 Medium", "enabled": true, "family": "SWE", "version": "2 Medium", "contextWindowTokens": 262000 },
+        { "id": "swe-2-max", "label": "SWE-2 Max", "enabled": true, "family": "SWE", "version": "2 Max", "contextWindowTokens": 262000 }
+      ]
+    }
   ]
 }

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" }),
+  };
 }

package/src/transports.ts

@@ -5,6 +5,11 @@ import type { InvocationRequest } from "./invocations.js";
 import type { NodeDefinition } from "./mesh.js";
 import type { MessageRecord } from "./messages.js";
 import type { CollaborationEvent, CollaborationRecord } from "./collaboration.js";
+import type {
+  ChannelInviteRedemptionRequest,
+  ChannelInviteRoute,
+  ChannelInviteInvitee,
+} from "./channel-invites.js";
 
 export interface SubscriptionRequest {
   actorId: ScoutId;
@@ -77,6 +82,46 @@ export interface CollaborationEventAppendCommand {
   event: CollaborationEvent;
 }
 
+/**
+ * Invitation writes are broker commands rather than conversation upserts so
+ * the read-modify-write of a channel's invitation set happens inside the
+ * broker's serialized command queue. Two operators minting an invitation at
+ * the same instant must not clobber each other's record.
+ */
+export interface ChannelInviteCreateCommand {
+  kind: "channel.invite.create";
+  channelId: ScoutId;
+  inviteId: ScoutId;
+  /** Digest only. The raw token never crosses this boundary. */
+  tokenHash: string;
+  tokenHint: string;
+  createdByActorId: ScoutId;
+  createdAt: number;
+  expiresAt: number | null;
+  maxRedemptions: number | null;
+  route: ChannelInviteRoute;
+  invitee?: ChannelInviteInvitee;
+  metadata?: MetadataMap;
+}
+
+export interface ChannelInviteRevokeCommand {
+  kind: "channel.invite.revoke";
+  channelId: ScoutId;
+  inviteId: ScoutId;
+  revokedByActorId: ScoutId;
+  revokedAt: number;
+}
+
+export interface ChannelInviteRedeemCommand {
+  kind: "channel.invite.redeem";
+  channelId: ScoutId;
+  /** Digest of the presented token; the broker matches, never the caller. */
+  tokenHash: string;
+  redemptionId: ScoutId;
+  redeemedAt: number;
+  request: ChannelInviteRedemptionRequest;
+}
+
 export type ControlCommand =
   | NodeUpsertCommand
   | ActorUpsertCommand
@@ -86,6 +131,9 @@ export type ControlCommand =
   | BindingUpsertCommand
   | CollaborationUpsertCommand
   | CollaborationEventAppendCommand
+  | ChannelInviteCreateCommand
+  | ChannelInviteRevokeCommand
+  | ChannelInviteRedeemCommand
   | PostMessageCommand
   | InvokeAgentCommand
   | EnsureAwakeCommand