dsh-interconnect 0.11.24 → 0.15.0

package/lib/index.js

@@ -5,7 +5,7 @@ import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { remoteErrorOf } from "@deepseek-ai/dsh-typert-protocol";
 import { boundContextSummary, createUserMessage } from "@deepseek-ai/dsh-llm";
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/misc.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/misc.ts
 function isNullable(value) {
   return value === null || value === void 0;
 }
@@ -27,7 +27,7 @@ function pick(source, keys, forced) {
   return result;
 }
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/types.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/types.ts
 function is(type, value) {
   if (arguments.length === 1) return (value2) => is(type, value2);
   return type in globalThis && value instanceof globalThis[type] || Object.prototype.toString.call(value).slice(8, -1) === type;
@@ -136,7 +136,7 @@ function deepEqual(a, b, strict) {
   }) ?? Object.keys({ ...a, ...b }).every((key) => deepEqual(a[key], b[key], strict));
 }
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/time.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/time.ts
 var Time;
 ((Time2) => {
   Time2.millisecond = 1;
@@ -216,7 +216,7 @@ var Time;
   Time2.template = template;
 })(Time || (Time = {}));
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/schemastery/lib/index.mjs
+// ../dsh-wt-ic-merge/vendor/schemastery/lib/index.mjs
 var kSchema = Symbol.for("schemastery");
 var kValidationError = Symbol.for("ValidationError");
 globalThis.__schemastery_index__ ??= 0;
@@ -820,12 +820,8 @@ defineMethod("transform", [
 
 // src/interconnect/index.ts
 import WebSocket, { WebSocketServer } from "ws";
-function isSessionOwnedBySubagent(ctx, session, agent) {
-  if (session.header.origin === "subagent") return true;
-  const parentId = session.header.parentSession;
-  if (parentId === void 0 || agent === void 0) return false;
-  const parent = ctx.agents.get(parentId);
-  return parent !== void 0 && ctx.agents.isOwnedBy(agent.id, parent);
+function isSessionOwnedBySubagent(session) {
+  return session.header.origin === "subagent";
 }
 function assertNever(value) {
   throw new Error(`interconnect: unhandled variant ${JSON.stringify(value)}`);
@@ -836,6 +832,7 @@ var DEFAULT_INSTANCE_ID = "dsh";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
 var LINK_HANDSHAKE_TIMEOUT_MS = 1e4;
 var LINK_CHANNEL = "/interconnect/link";
+var SELF_PEER_ORIGIN = "self";
 var MAX_INSTANCE_ID_CHARS = 256;
 var MAX_REQUEST_ID_CHARS = 256;
 var MAX_LISTED_SESSIONS = 100;
@@ -963,11 +960,19 @@ var InterconnectService = class extends Service {
     this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.delivery = config.delivery ?? "followup";
     this.allowResume = config.allowResume ?? true;
-    for (const origin of Object.values(config.peers ?? {})) {
+    for (const [peerInstanceId, origin] of Object.entries(config.peers ?? {})) {
+      if (origin === SELF_PEER_ORIGIN) {
+        if (peerInstanceId !== this.instanceId) {
+          throw new Error(
+            `interconnect: peer "${peerInstanceId}" is configured as self, but this instance announces "${this.instanceId}"; key a self peer by the instanceId`
+          );
+        }
+        continue;
+      }
       linkUrl(trimBase(origin));
     }
     for (const [peerInstanceId, origin] of Object.entries(config.peers ?? {})) {
-      this.link(peerInstanceId, origin);
+      this.link(peerInstanceId, origin === SELF_PEER_ORIGIN ? () => this.selfOrigin() : origin);
     }
     const upgrade = {
       path: LINK_CHANNEL,
@@ -1108,7 +1113,7 @@ var InterconnectService = class extends Service {
    * Returns the peer identity when reachable, or undefined when the link is
    * not up or no answer arrives.
    * @param instanceId - the peer's `instanceId` as configured under {@link Config.peers}.
-   * @returns the peer's identity, or undefined when the link is not up or no answer arrives.
+   * @returns the peer's identity, or undefined when there is no usable answer.
    */
   async ping(instanceId) {
     return this.queryRequest(instanceId, { kind: "ping" });
@@ -1122,16 +1127,33 @@ var InterconnectService = class extends Service {
   async list(instanceId) {
     return this.queryRequest(instanceId, { kind: "list" });
   }
+  /**
+   * The peers this instance configures, each with the current state of the link
+   * it dials, in configuration order. This is how a caller tells an id this
+   * instance cannot reach at all (`peer-not-configured`) from one whose link is
+   * merely down (`unreachable`), which the bare `undefined` of `ping`/`list`
+   * cannot express. A configured peer whose link is `down` is still a valid
+   * target: its reconnect runs on its own backoff, so it may answer later.
+   * @returns one row per configured peer.
+   */
+  peers() {
+    return [...this.linkStates].map(([instanceId, state]) => ({
+      instanceId,
+      origin: state.peer,
+      link: state.writable() ? "up" : "down"
+    }));
+  }
   /**
    * Send a `msg` frame over the live link to a peer and resolve with its
-   * correlated `msg-result`. Undefined when the peer has no live link here
-   * (not configured, or the link is down) — sends can only address configured+
-   * connected peers by design — and a `message-too-large` result when the
-   * encoded frame would not fit the link.
+   * correlated `msg-result`. A `peer-not-configured` result when this instance
+   * configures no route for that id, undefined when the route exists but its
+   * link is down, and a `message-too-large` result when the encoded frame would
+   * not fit the link.
    */
   async msgRequest(instanceId, kind, payload) {
     const state = this.linkStates.get(instanceId);
-    if (state === void 0 || !state.writable()) return void 0;
+    if (state === void 0) return { delivered: false, instance: instanceId, reason: "peer-not-configured" };
+    if (!state.writable()) return void 0;
     const reqId = `m${++this.reqIdCounter}-${randomUUID()}`;
     const frame = {
       type: "msg",
@@ -1193,7 +1215,8 @@ var InterconnectService = class extends Service {
    * `Config.peers` entry; the resulting state owns reconnection for the life of
    * the service fiber.
    * @param instanceId - the peer's `instanceId`.
-   * @param origin - receiver origin this instance dials, e.g. `http://127.0.0.1:13080`.
+   * @param origin - receiver origin this instance dials (e.g.
+   *   `http://127.0.0.1:13080`), or a resolver for a `self` route.
    */
   link(instanceId, origin) {
     const state = new LinkState(
@@ -1203,11 +1226,28 @@ var InterconnectService = class extends Service {
       this.ctx.logger,
       () => this.resolveToken(),
       instanceId,
-      trimBase(origin)
+      typeof origin === "string" ? trimBase(origin) : origin
     );
     this.linkStates.set(instanceId, state);
     state.dial();
   }
+  /**
+   * The origin of this instance's own host webserver, or undefined while no
+   * listening port exists. Read on every dial rather than cached: the
+   * webserver may activate after this service, its port is assigned only in
+   * its listen callback (`--port 0` picks a fresh one per start), and a
+   * replacement webserver would move it again. Loopback is used regardless of
+   * the bind host: a server bound to `0.0.0.0` also accepts `127.0.0.1`, while
+   * `0.0.0.0` itself is a bind address, not a dialable origin.
+   * @returns `http://127.0.0.1:<port>`, or undefined without a listening server.
+   */
+  selfOrigin() {
+    const server = this.ctx.get("webServer");
+    if (server === void 0) return void 0;
+    const port = server.port;
+    if (typeof port !== "number" || port <= 0) return void 0;
+    return `http://127.0.0.1:${String(port)}`;
+  }
   /** Push one serialized lifecycle fact out to every linked peer over WS. */
   fanout(notification) {
     this.broadcast(notification);
@@ -1342,7 +1382,7 @@ var InterconnectService = class extends Service {
    * @returns the bounded listing.
    */
   listSessions(rowBudgetBytes) {
-    const reachable = this.ctx.agents.list().filter((agent) => !isSessionOwnedBySubagent(this.ctx, agent.session, agent));
+    const reachable = this.ctx.agents.list().filter((agent) => !isSessionOwnedBySubagent(agent.session));
     const sessions = [];
     let used = 0;
     for (const agent of reachable.slice(0, MAX_LISTED_SESSIONS)) {
@@ -1369,7 +1409,8 @@ var InterconnectService = class extends Service {
     let title;
     try {
       const snapshot = this.ctx.get("sessionProjections")?.snapshot(agent.session);
-      const value = snapshot?.values.title;
+      const values = snapshot?.values;
+      const value = values?.title;
       if (typeof value === "string" && value !== "") title = value;
     } catch {
       title = void 0;
@@ -1427,7 +1468,7 @@ var InterconnectService = class extends Service {
       }
       agent = woken.agent;
     }
-    if (isSessionOwnedBySubagent(this.ctx, agent.session, agent)) {
+    if (isSessionOwnedBySubagent(agent.session)) {
       return { delivered: false, instance: this.instanceId, reason: "session-owned-by-subagent" };
     }
     const sender = (() => {
@@ -1636,24 +1677,40 @@ var LinkState = class {
     this.logger = logger;
     this.resolveToken = resolveToken;
     this.instanceId = instanceId;
-    this.peer = origin;
+    this.origin = origin;
   }
   dialed;
   closed = false;
   retry = 0;
   reconnectTimer;
   warnedNoToken = false;
-  /** Receiver origin this link dials. */
-  peer;
+  warnedNoOrigin = false;
   instanceId;
+  origin;
+  /** The origin this link dials now; for an unresolved `self` route, the sentinel is shown. */
+  get peer() {
+    return typeof this.origin === "string" ? this.origin : this.origin() ?? SELF_PEER_ORIGIN;
+  }
   /** Open the socket; reconnect is scheduled by the close handler. */
   dial() {
     if (this.closed) return;
+    const origin = typeof this.origin === "string" ? this.origin : this.origin();
+    if (origin === void 0) {
+      if (this.retry >= 1 && !this.warnedNoOrigin) {
+        this.warnedNoOrigin = true;
+        this.logger.warn(
+          `interconnect: peer ${this.instanceId} is configured as self but this instance has no listening webServer port yet; the link stays down and retries`
+        );
+      }
+      this.scheduleReconnect();
+      return;
+    }
+    this.warnedNoOrigin = false;
     let url;
     try {
-      url = linkUrl(this.peer);
+      url = linkUrl(origin);
     } catch {
-      this.logger.warn(`interconnect: invalid peer origin ${this.peer}; link to ${this.instanceId} stays down`);
+      this.logger.warn(`interconnect: invalid peer origin ${origin}; link to ${this.instanceId} stays down`);
       return;
     }
     void this.resolveToken().then((token) => {

package/lib/interconnect/index.js

@@ -5,7 +5,7 @@ import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { remoteErrorOf } from "@deepseek-ai/dsh-typert-protocol";
 import { boundContextSummary, createUserMessage } from "@deepseek-ai/dsh-llm";
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/misc.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/misc.ts
 function isNullable(value) {
   return value === null || value === void 0;
 }
@@ -27,7 +27,7 @@ function pick(source, keys, forced) {
   return result;
 }
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/types.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/types.ts
 function is(type, value) {
   if (arguments.length === 1) return (value2) => is(type, value2);
   return type in globalThis && value instanceof globalThis[type] || Object.prototype.toString.call(value).slice(8, -1) === type;
@@ -136,7 +136,7 @@ function deepEqual(a, b, strict) {
   }) ?? Object.keys({ ...a, ...b }).every((key) => deepEqual(a[key], b[key], strict));
 }
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/cosmokit/src/time.ts
+// ../dsh-wt-ic-merge/vendor/cosmokit/src/time.ts
 var Time;
 ((Time2) => {
   Time2.millisecond = 1;
@@ -216,7 +216,7 @@ var Time;
   Time2.template = template;
 })(Time || (Time = {}));
 
-// ../.dsh/source/staging-20260807T143236Z/vendor/schemastery/lib/index.mjs
+// ../dsh-wt-ic-merge/vendor/schemastery/lib/index.mjs
 var kSchema = Symbol.for("schemastery");
 var kValidationError = Symbol.for("ValidationError");
 globalThis.__schemastery_index__ ??= 0;
@@ -820,12 +820,8 @@ defineMethod("transform", [
 
 // src/interconnect/index.ts
 import WebSocket, { WebSocketServer } from "ws";
-function isSessionOwnedBySubagent(ctx, session, agent) {
-  if (session.header.origin === "subagent") return true;
-  const parentId = session.header.parentSession;
-  if (parentId === void 0 || agent === void 0) return false;
-  const parent = ctx.agents.get(parentId);
-  return parent !== void 0 && ctx.agents.isOwnedBy(agent.id, parent);
+function isSessionOwnedBySubagent(session) {
+  return session.header.origin === "subagent";
 }
 function assertNever(value) {
   throw new Error(`interconnect: unhandled variant ${JSON.stringify(value)}`);
@@ -836,6 +832,7 @@ var DEFAULT_INSTANCE_ID = "dsh";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
 var LINK_HANDSHAKE_TIMEOUT_MS = 1e4;
 var LINK_CHANNEL = "/interconnect/link";
+var SELF_PEER_ORIGIN = "self";
 var MAX_INSTANCE_ID_CHARS = 256;
 var MAX_REQUEST_ID_CHARS = 256;
 var MAX_LISTED_SESSIONS = 100;
@@ -963,11 +960,19 @@ var InterconnectService = class extends Service {
     this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.delivery = config.delivery ?? "followup";
     this.allowResume = config.allowResume ?? true;
-    for (const origin of Object.values(config.peers ?? {})) {
+    for (const [peerInstanceId, origin] of Object.entries(config.peers ?? {})) {
+      if (origin === SELF_PEER_ORIGIN) {
+        if (peerInstanceId !== this.instanceId) {
+          throw new Error(
+            `interconnect: peer "${peerInstanceId}" is configured as self, but this instance announces "${this.instanceId}"; key a self peer by the instanceId`
+          );
+        }
+        continue;
+      }
       linkUrl(trimBase(origin));
     }
     for (const [peerInstanceId, origin] of Object.entries(config.peers ?? {})) {
-      this.link(peerInstanceId, origin);
+      this.link(peerInstanceId, origin === SELF_PEER_ORIGIN ? () => this.selfOrigin() : origin);
     }
     const upgrade = {
       path: LINK_CHANNEL,
@@ -1108,7 +1113,7 @@ var InterconnectService = class extends Service {
    * Returns the peer identity when reachable, or undefined when the link is
    * not up or no answer arrives.
    * @param instanceId - the peer's `instanceId` as configured under {@link Config.peers}.
-   * @returns the peer's identity, or undefined when the link is not up or no answer arrives.
+   * @returns the peer's identity, or undefined when there is no usable answer.
    */
   async ping(instanceId) {
     return this.queryRequest(instanceId, { kind: "ping" });
@@ -1122,16 +1127,33 @@ var InterconnectService = class extends Service {
   async list(instanceId) {
     return this.queryRequest(instanceId, { kind: "list" });
   }
+  /**
+   * The peers this instance configures, each with the current state of the link
+   * it dials, in configuration order. This is how a caller tells an id this
+   * instance cannot reach at all (`peer-not-configured`) from one whose link is
+   * merely down (`unreachable`), which the bare `undefined` of `ping`/`list`
+   * cannot express. A configured peer whose link is `down` is still a valid
+   * target: its reconnect runs on its own backoff, so it may answer later.
+   * @returns one row per configured peer.
+   */
+  peers() {
+    return [...this.linkStates].map(([instanceId, state]) => ({
+      instanceId,
+      origin: state.peer,
+      link: state.writable() ? "up" : "down"
+    }));
+  }
   /**
    * Send a `msg` frame over the live link to a peer and resolve with its
-   * correlated `msg-result`. Undefined when the peer has no live link here
-   * (not configured, or the link is down) — sends can only address configured+
-   * connected peers by design — and a `message-too-large` result when the
-   * encoded frame would not fit the link.
+   * correlated `msg-result`. A `peer-not-configured` result when this instance
+   * configures no route for that id, undefined when the route exists but its
+   * link is down, and a `message-too-large` result when the encoded frame would
+   * not fit the link.
    */
   async msgRequest(instanceId, kind, payload) {
     const state = this.linkStates.get(instanceId);
-    if (state === void 0 || !state.writable()) return void 0;
+    if (state === void 0) return { delivered: false, instance: instanceId, reason: "peer-not-configured" };
+    if (!state.writable()) return void 0;
     const reqId = `m${++this.reqIdCounter}-${randomUUID()}`;
     const frame = {
       type: "msg",
@@ -1193,7 +1215,8 @@ var InterconnectService = class extends Service {
    * `Config.peers` entry; the resulting state owns reconnection for the life of
    * the service fiber.
    * @param instanceId - the peer's `instanceId`.
-   * @param origin - receiver origin this instance dials, e.g. `http://127.0.0.1:13080`.
+   * @param origin - receiver origin this instance dials (e.g.
+   *   `http://127.0.0.1:13080`), or a resolver for a `self` route.
    */
   link(instanceId, origin) {
     const state = new LinkState(
@@ -1203,11 +1226,28 @@ var InterconnectService = class extends Service {
       this.ctx.logger,
       () => this.resolveToken(),
       instanceId,
-      trimBase(origin)
+      typeof origin === "string" ? trimBase(origin) : origin
     );
     this.linkStates.set(instanceId, state);
     state.dial();
   }
+  /**
+   * The origin of this instance's own host webserver, or undefined while no
+   * listening port exists. Read on every dial rather than cached: the
+   * webserver may activate after this service, its port is assigned only in
+   * its listen callback (`--port 0` picks a fresh one per start), and a
+   * replacement webserver would move it again. Loopback is used regardless of
+   * the bind host: a server bound to `0.0.0.0` also accepts `127.0.0.1`, while
+   * `0.0.0.0` itself is a bind address, not a dialable origin.
+   * @returns `http://127.0.0.1:<port>`, or undefined without a listening server.
+   */
+  selfOrigin() {
+    const server = this.ctx.get("webServer");
+    if (server === void 0) return void 0;
+    const port = server.port;
+    if (typeof port !== "number" || port <= 0) return void 0;
+    return `http://127.0.0.1:${String(port)}`;
+  }
   /** Push one serialized lifecycle fact out to every linked peer over WS. */
   fanout(notification) {
     this.broadcast(notification);
@@ -1342,7 +1382,7 @@ var InterconnectService = class extends Service {
    * @returns the bounded listing.
    */
   listSessions(rowBudgetBytes) {
-    const reachable = this.ctx.agents.list().filter((agent) => !isSessionOwnedBySubagent(this.ctx, agent.session, agent));
+    const reachable = this.ctx.agents.list().filter((agent) => !isSessionOwnedBySubagent(agent.session));
     const sessions = [];
     let used = 0;
     for (const agent of reachable.slice(0, MAX_LISTED_SESSIONS)) {
@@ -1369,7 +1409,8 @@ var InterconnectService = class extends Service {
     let title;
     try {
       const snapshot = this.ctx.get("sessionProjections")?.snapshot(agent.session);
-      const value = snapshot?.values.title;
+      const values = snapshot?.values;
+      const value = values?.title;
       if (typeof value === "string" && value !== "") title = value;
     } catch {
       title = void 0;
@@ -1427,7 +1468,7 @@ var InterconnectService = class extends Service {
       }
       agent = woken.agent;
     }
-    if (isSessionOwnedBySubagent(this.ctx, agent.session, agent)) {
+    if (isSessionOwnedBySubagent(agent.session)) {
       return { delivered: false, instance: this.instanceId, reason: "session-owned-by-subagent" };
     }
     const sender = (() => {
@@ -1636,24 +1677,40 @@ var LinkState = class {
     this.logger = logger;
     this.resolveToken = resolveToken;
     this.instanceId = instanceId;
-    this.peer = origin;
+    this.origin = origin;
   }
   dialed;
   closed = false;
   retry = 0;
   reconnectTimer;
   warnedNoToken = false;
-  /** Receiver origin this link dials. */
-  peer;
+  warnedNoOrigin = false;
   instanceId;
+  origin;
+  /** The origin this link dials now; for an unresolved `self` route, the sentinel is shown. */
+  get peer() {
+    return typeof this.origin === "string" ? this.origin : this.origin() ?? SELF_PEER_ORIGIN;
+  }
   /** Open the socket; reconnect is scheduled by the close handler. */
   dial() {
     if (this.closed) return;
+    const origin = typeof this.origin === "string" ? this.origin : this.origin();
+    if (origin === void 0) {
+      if (this.retry >= 1 && !this.warnedNoOrigin) {
+        this.warnedNoOrigin = true;
+        this.logger.warn(
+          `interconnect: peer ${this.instanceId} is configured as self but this instance has no listening webServer port yet; the link stays down and retries`
+        );
+      }
+      this.scheduleReconnect();
+      return;
+    }
+    this.warnedNoOrigin = false;
     let url;
     try {
-      url = linkUrl(this.peer);
+      url = linkUrl(origin);
     } catch {
-      this.logger.warn(`interconnect: invalid peer origin ${this.peer}; link to ${this.instanceId} stays down`);
+      this.logger.warn(`interconnect: invalid peer origin ${origin}; link to ${this.instanceId} stays down`);
       return;
     }
     void this.resolveToken().then((token) => {