@apnex/network-adapter 0.1.2 → 0.1.5

package/dist/tool-manager/work-protocol/claimable-digest-tracker.js

@@ -0,0 +1,66 @@
+/**
+ * claimable-digest-tracker.ts — idea-353 W1 inbound wake (level-triggered,
+ * idle-gated, idempotent claimable-digest).
+ *
+ * The C1 work-queue is a pull model with no wake-on-ready signal: an idle
+ * eligible agent never learns that newly-claimable work appeared and sits
+ * unclaimed until someone manually nudges it (proven 3× in dogfood-1). This
+ * tracker is the **decision core** of the inbound wake — given the set of
+ * truly-claimable work ids for the agent's role (read via the stable
+ * `list_ready_work` contract) and whether the agent is idle, it decides whether
+ * to surface a digest ("N items claimable for your role").
+ *
+ * The design's ONE genuinely-new substrate is this **level-trigger / de-dup
+ * state** (the FR-22 storm-risk locus). The rules:
+ *
+ *   - **Idle-gated (AC4):** never surface while the agent is mid-task. A busy
+ *     tick neither emits NOR advances the baseline — so items that appeared
+ *     while the agent was working are surfaced on the FIRST idle tick, not
+ *     silently swallowed.
+ *   - **Level-triggered / idempotent (AC3):** emit ONLY on an upward edge —
+ *     0→N, or a genuinely-NEW claimable id appeared since the last surfaced
+ *     set. A steady N>0, a re-tick, or a Hub restart (the in-memory baseline
+ *     survives, since the adapter process does not restart) yields no new ids
+ *     → no emit. ID-keyed, not count-keyed, so a swap (one item claimed away,
+ *     another appearing at the same count) still edges.
+ *
+ * Pairs with the at-tick guard in the host: the tracker is only fed on a
+ * SUCCESSFUL `list_ready_work` read — a failed read (Hub mid-restart, agent not
+ * streaming) skips the tick entirely and leaves the baseline untouched, so a
+ * transient empty/aborted read cannot manufacture a false 0→N replay.
+ *
+ * Pure + synchronous: all I/O (the list_ready_work read, the host emit) lives
+ * in the host tick; this class holds only the de-dup state + the decision, so
+ * the storm-proof contract is unit-testable without a live Hub (AC3/AC4).
+ */
+export class ClaimableDigestTracker {
+    /** The claimable id set the agent was last woken about (the de-dup baseline). */
+    lastSurfaced = new Set();
+    /**
+     * Decide whether this tick should surface a claimable-digest wake.
+     * @param input current claimable ids + idle state for this tick.
+     */
+    reconcile(input) {
+        const count = input.claimableIds.length;
+        // AC4 idle-gate: never surface while mid-task, and do NOT advance the
+        // baseline — accumulate so the first idle tick surfaces what appeared
+        // while the agent was busy.
+        if (!input.isIdle) {
+            return { emit: false, count, newCount: 0 };
+        }
+        const newIds = input.claimableIds.filter((id) => !this.lastSurfaced.has(id));
+        // AC3 level-trigger: emit only on an upward edge (0→N or a new id). A
+        // steady set / re-tick / Hub-restart-replay yields no new ids → no emit.
+        const emit = count > 0 && newIds.length > 0;
+        // Advance the baseline to the current set on every IDLE pass (emit or not),
+        // so a claimed-away item doesn't wedge the de-dup and a later re-appearance
+        // re-edges correctly.
+        this.lastSurfaced = new Set(input.claimableIds);
+        return { emit, count, newCount: newIds.length };
+    }
+    /** Diagnostic/test accessor for the current de-dup baseline size. */
+    getSurfacedCount() {
+        return this.lastSurfaced.size;
+    }
+}
+//# sourceMappingURL=claimable-digest-tracker.js.map

package/dist/tool-manager/work-protocol/claimable-digest-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimable-digest-tracker.js","sourceRoot":"","sources":["../../../src/tool-manager/work-protocol/claimable-digest-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAkBH,MAAM,OAAO,sBAAsB;IACjC,iFAAiF;IACzE,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC;;;OAGG;IACH,SAAS,CAAC,KAA2B;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;QAExC,sEAAsE;QACtE,sEAAsE;QACtE,4BAA4B;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAE5C,4EAA4E;QAC5E,4EAA4E;QAC5E,sBAAsB;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAEhD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAClD,CAAC;IAED,qEAAqE;IACrE,gBAAgB;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;IAChC,CAAC;CACF"}

package/dist/tool-manager/work-protocol/work-lease-tracker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * work-lease-tracker.ts — idea-353 W2 outbound stall-prompt state.
+ *
+ * The lease-escalation ladder (lease-TTL → sweeper → poison → thrash-quarantine,
+ * C1-R2) has no GENTLE first rung: a held item that stalls goes straight from
+ * "leased" to silently reaped. W2 adds that rung — prompt the holder to
+ * renew / block / abandon BEFORE the sweeper's hard reap. It's notification-
+ * shaping over the EXISTING verbs (renew_lease / block_work / abandon_work), not
+ * a new verb.
+ *
+ * The adapter holds no work-lease state of its own (all WorkItem/lease state is
+ * Hub-side, and there is no "my held work" query). Rather than add a Hub tool or
+ * a second per-tick round-trip, this tracker **observes the agent's own
+ * work-verb tool-call results** as they pass through the dispatcher and
+ * maintains a local map of held leases + their expiry. On the heartbeat tick the
+ * host asks which held leases are approaching expiry.
+ *
+ * Window model: each observe of a claim/renew/start result (re)opens a lease
+ * window `[windowStart=observe-time, expiresAt]` and clears the per-window
+ * prompt latch. A lease is "due" once the tick time crosses `thresholdFraction`
+ * of that window AND is still before `expiresAt` (the whole point is *before*
+ * the reap), and it has not already been prompted this window. A renew resets
+ * the window + latch, so a renewing holder is never re-pestered. Completing /
+ * abandoning / releasing / blocking the item drops it entirely.
+ *
+ * Scope (thin MVP): tracks leases this session observes. A lease claimed in a
+ * prior adapter process (pre-restart) is not tracked — named as deferred; the
+ * common stall (claim → heads-down → near-expiry without renew) is in-session.
+ *
+ * Pure: all parsing is synchronous off the already-unwrapped tool result; the
+ * host owns the tick clock + the emit. Unit-testable without a live Hub (AC2).
+ */
+export interface StallPrompt {
+    workId: string;
+    /** Ms remaining until the Hub sweeper may reap the lease. */
+    msUntilExpiry: number;
+}
+export declare class WorkLeaseTracker {
+    private leases;
+    /**
+     * Observe one of THIS agent's work-verb tool-call results as it passes
+     * through the dispatcher. Best-effort: an unrecognized verb or an
+     * unparseable result is a no-op.
+     */
+    observe(method: string, args: Record<string, unknown> | undefined, result: unknown, nowMs: number): void;
+    /**
+     * Held leases that have crossed `thresholdFraction` of their current window
+     * but not yet expired, and have not been prompted this window. The host
+     * emits a renew/block/abandon stall-prompt for each (then marks them).
+     *
+     * @param thresholdFraction window fraction at which to prompt (~0.5–0.75;
+     *   default 0.6 = 60% of the lease life elapsed).
+     */
+    dueForStallPrompt(nowMs: number, thresholdFraction?: number): StallPrompt[];
+    /** Latch a lease as prompted for its current window (call after emitting). */
+    markPrompted(workId: string): void;
+    /** Diagnostic/test accessor: number of currently-held tracked leases. */
+    size(): number;
+}

package/dist/tool-manager/work-protocol/work-lease-tracker.js

@@ -0,0 +1,134 @@
+/**
+ * work-lease-tracker.ts — idea-353 W2 outbound stall-prompt state.
+ *
+ * The lease-escalation ladder (lease-TTL → sweeper → poison → thrash-quarantine,
+ * C1-R2) has no GENTLE first rung: a held item that stalls goes straight from
+ * "leased" to silently reaped. W2 adds that rung — prompt the holder to
+ * renew / block / abandon BEFORE the sweeper's hard reap. It's notification-
+ * shaping over the EXISTING verbs (renew_lease / block_work / abandon_work), not
+ * a new verb.
+ *
+ * The adapter holds no work-lease state of its own (all WorkItem/lease state is
+ * Hub-side, and there is no "my held work" query). Rather than add a Hub tool or
+ * a second per-tick round-trip, this tracker **observes the agent's own
+ * work-verb tool-call results** as they pass through the dispatcher and
+ * maintains a local map of held leases + their expiry. On the heartbeat tick the
+ * host asks which held leases are approaching expiry.
+ *
+ * Window model: each observe of a claim/renew/start result (re)opens a lease
+ * window `[windowStart=observe-time, expiresAt]` and clears the per-window
+ * prompt latch. A lease is "due" once the tick time crosses `thresholdFraction`
+ * of that window AND is still before `expiresAt` (the whole point is *before*
+ * the reap), and it has not already been prompted this window. A renew resets
+ * the window + latch, so a renewing holder is never re-pestered. Completing /
+ * abandoning / releasing / blocking the item drops it entirely.
+ *
+ * Scope (thin MVP): tracks leases this session observes. A lease claimed in a
+ * prior adapter process (pre-restart) is not tracked — named as deferred; the
+ * common stall (claim → heads-down → near-expiry without renew) is in-session.
+ *
+ * Pure: all parsing is synchronous off the already-unwrapped tool result; the
+ * host owns the tick clock + the emit. Unit-testable without a live Hub (AC2).
+ */
+/** The work-verbs whose results open/refresh a tracked lease window. */
+const LEASE_OPEN_VERBS = new Set(["claim_work", "renew_lease", "start_work"]);
+/** The work-verbs whose results retire a held lease (no longer the holder's stall). */
+const LEASE_CLOSE_VERBS = new Set([
+    "complete_work",
+    "abandon_work",
+    "release_work",
+    "block_work",
+]);
+/** A renew (or claim) reopens the window + clears the prompt latch; start_work
+ *  only refreshes the known expiry without resetting the window. */
+const WINDOW_RESET_VERBS = new Set(["claim_work", "renew_lease"]);
+/** Pull `{ workId, expiresAtMs }` out of an already-unwrapped work-verb result.
+ *  Tolerant: returns null on any shape that isn't a lease-bearing workItem. */
+function parseLease(result) {
+    const wi = result?.workItem;
+    if (!wi || typeof wi.id !== "string")
+        return null;
+    const expiresAt = wi.lease?.expiresAt;
+    if (typeof expiresAt !== "string")
+        return null;
+    const expiresAtMs = Date.parse(expiresAt);
+    if (Number.isNaN(expiresAtMs))
+        return null;
+    return { workId: wi.id, expiresAtMs };
+}
+/** Pull a workId for a CLOSE verb — prefer the result workItem, fall back to args. */
+function parseWorkId(result, args) {
+    const id = result?.workItem?.id;
+    if (typeof id === "string")
+        return id;
+    if (args && typeof args.workId === "string")
+        return args.workId;
+    return null;
+}
+export class WorkLeaseTracker {
+    leases = new Map();
+    /**
+     * Observe one of THIS agent's work-verb tool-call results as it passes
+     * through the dispatcher. Best-effort: an unrecognized verb or an
+     * unparseable result is a no-op.
+     */
+    observe(method, args, result, nowMs) {
+        if (LEASE_CLOSE_VERBS.has(method)) {
+            const workId = parseWorkId(result, args);
+            if (workId)
+                this.leases.delete(workId);
+            return;
+        }
+        if (!LEASE_OPEN_VERBS.has(method))
+            return;
+        const parsed = parseLease(result);
+        if (!parsed)
+            return;
+        const existing = this.leases.get(parsed.workId);
+        const resetWindow = WINDOW_RESET_VERBS.has(method) || !existing;
+        this.leases.set(parsed.workId, {
+            workId: parsed.workId,
+            // claim/renew reopen the window at observe-time; start_work keeps the
+            // existing window start (it does not extend the lease).
+            windowStartMs: resetWindow ? nowMs : existing.windowStartMs,
+            expiresAtMs: parsed.expiresAtMs,
+            prompted: resetWindow ? false : existing.prompted,
+        });
+    }
+    /**
+     * Held leases that have crossed `thresholdFraction` of their current window
+     * but not yet expired, and have not been prompted this window. The host
+     * emits a renew/block/abandon stall-prompt for each (then marks them).
+     *
+     * @param thresholdFraction window fraction at which to prompt (~0.5–0.75;
+     *   default 0.6 = 60% of the lease life elapsed).
+     */
+    dueForStallPrompt(nowMs, thresholdFraction = 0.6) {
+        const due = [];
+        for (const lease of this.leases.values()) {
+            if (lease.prompted)
+                continue;
+            const windowLen = lease.expiresAtMs - lease.windowStartMs;
+            if (windowLen <= 0)
+                continue;
+            const elapsed = nowMs - lease.windowStartMs;
+            // Prompt window: [thresholdFraction*windowLen, windowLen) — past the
+            // threshold but BEFORE expiry (the gentle rung is "before the reap").
+            if (elapsed >= thresholdFraction * windowLen && nowMs < lease.expiresAtMs) {
+                due.push({ workId: lease.workId, msUntilExpiry: lease.expiresAtMs - nowMs });
+            }
+        }
+        return due;
+    }
+    /** Latch a lease as prompted for its current window (call after emitting). */
+    markPrompted(workId) {
+        const lease = this.leases.get(workId);
+        if (lease)
+            lease.prompted = true;
+    }
+    /** Diagnostic/test accessor: number of currently-held tracked leases. */
+    size() {
+        return this.leases.size;
+    }
+}
+//# sourceMappingURL=work-lease-tracker.js.map

package/dist/tool-manager/work-protocol/work-lease-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-lease-tracker.js","sourceRoot":"","sources":["../../../src/tool-manager/work-protocol/work-lease-tracker.ts"],"names":[],"mappings":"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"}

package/dist/wire/mcp-transport.d.ts

@@ -74,7 +74,7 @@ export declare class McpTransport implements ITransport {
     private totalReconnects;
     private consecutiveReconnects;
     private lastReconnectCause?;
-    private requestsInFlight;
+    private readonly slots;
     private reconnecting;
     private closed;
     constructor(config: TransportConfig);

package/dist/wire/mcp-transport.js

@@ -49,6 +49,7 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 import { LoggingMessageNotificationSchema } from "@modelcontextprotocol/sdk/types.js";
+import { SlotGate } from "./slot-gate.js";
 import { normalizeToILogger } from "../logger.js";
 /**
  * Wire-level reconnect backoff curve. Pure function so the invariant
@@ -64,6 +65,18 @@ export function computeReconnectBackoff(consecutiveReconnects, baseDelay, maxDel
     const exp = Math.min(Math.max(consecutiveReconnects, 0), 6);
     return Math.min(baseDelay * Math.pow(2, exp), maxDelay);
 }
+const DEFAULT_MAX_IN_FLIGHT = 8;
+/**
+ * bug-171: resolve the in-flight concurrency cap. Explicit config wins;
+ * otherwise `OIS_ADAPTER_MAX_INFLIGHT` env var (integer); otherwise
+ * {@link DEFAULT_MAX_IN_FLIGHT}. Floored at 1 (a cap of 0 would deadlock every
+ * request) so a malformed override can never wedge the wire.
+ */
+function resolveMaxInFlight(explicit) {
+    const fromEnv = parseInt(process.env.OIS_ADAPTER_MAX_INFLIGHT ?? "", 10);
+    const chosen = explicit ?? (Number.isFinite(fromEnv) ? fromEnv : DEFAULT_MAX_IN_FLIGHT);
+    return Math.max(1, Math.floor(chosen));
+}
 export class McpTransport {
     cfg;
     log;
@@ -83,7 +96,11 @@ export class McpTransport {
     totalReconnects = 0;
     consecutiveReconnects = 0;
     lastReconnectCause;
-    requestsInFlight = 0;
+    // bug-171: bounded-concurrency gate for `request()` — caps concurrent
+    // in-flight calls at `cfg.maxInFlight` so a parallel read burst cannot
+    // overwhelm + drop the single shared wire. Excess callers FIFO-queue for a
+    // slot. Constructed in the ctor once `cfg.maxInFlight` is resolved.
+    slots;
     // Re-entrancy guard: prevents overlapping reconnects.
     reconnecting = false;
     // True once `close()` was called — suppresses further reconnect attempts.
@@ -97,9 +114,11 @@ export class McpTransport {
             firstKeepaliveDeadline: config.firstKeepaliveDeadline ?? 60_000,
             sseWatchdogInterval: config.sseWatchdogInterval ?? 30_000,
             reconnectDelay: config.reconnectDelay ?? 5_000,
+            maxInFlight: resolveMaxInFlight(config.maxInFlight),
             getLastEventId: config.getLastEventId,
         };
         this.log = normalizeToILogger(config.logger, "McpTransport");
+        this.slots = new SlotGate(this.cfg.maxInFlight);
     }
     // ── ITransport: public surface ──────────────────────────────────────
     get wireState() {
@@ -139,11 +158,15 @@ export class McpTransport {
         }
     }
     async request(method, params) {
-        if (this._wireState !== "connected" || !this.client) {
-            throw new Error(`McpTransport.request: wire is ${this._wireState}`);
-        }
-        this.requestsInFlight++;
+        // bug-171: acquire a concurrency slot BEFORE the wire-state guard so the
+        // guard (and the call) run at slot-grant time, not enqueue time — a caller
+        // parked through a wire drop fails per-call here instead of NPE-ing on a
+        // torn-down client. The slot is always released in `finally`.
+        await this.slots.acquire();
         try {
+            if (this._wireState !== "connected" || !this.client) {
+                throw new Error(`McpTransport.request: wire is ${this._wireState}`);
+            }
             const result = await this.client.callTool({
                 name: method,
                 arguments: params,
@@ -160,7 +183,7 @@ export class McpTransport {
             return null;
         }
         finally {
-            this.requestsInFlight--;
+            this.slots.release();
         }
     }
     async listMethods() {
@@ -201,7 +224,8 @@ export class McpTransport {
             consecutiveReconnects: this.consecutiveReconnects,
             lastReconnectCause: this.lastReconnectCause,
             lastKeepaliveAt: this.lastKeepaliveAt || undefined,
-            requestsInFlight: this.requestsInFlight,
+            requestsInFlight: this.slots.inFlight,
+            requestsQueued: this.slots.queued,
         };
     }
     /**

package/dist/wire/mcp-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-transport.js","sourceRoot":"","sources":["../../src/wire/mcp-transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-transport.js","sourceRoot":"","sources":["../../src/wire/mcp-transport.ts"],"names":[],"mappings":"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"}

package/dist/wire/slot-gate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SlotGate — a minimal FIFO counting semaphore (bug-171).
+ *
+ * Bounds the number of concurrent in-flight `request()` calls over the single
+ * shared MCP wire. A broad parallel read burst (e.g. a verifier conformance
+ * sweep firing dozens of read-only Hub calls at once) could otherwise overwhelm
+ * the one connection and drop the whole transport (`-32000 Connection closed`),
+ * stranding the session behind reconnect backoff. The gate paces the burst:
+ * excess callers queue for a slot rather than all firing at once. Queued calls
+ * still complete — only their START is paced.
+ *
+ * Invariants:
+ *   - The held count NEVER exceeds `max` (a parked caller is handed the
+ *     releaser's slot directly — no decrement/re-increment window that could
+ *     momentarily admit one over the cap).
+ *   - Hand-off is FIFO (first parked, first resumed).
+ *   - `max` is floored at 1 by the caller (a cap of 0 would deadlock).
+ */
+export declare class SlotGate {
+    private readonly max;
+    private held;
+    private readonly waiters;
+    constructor(max: number);
+    /**
+     * Acquire a slot. Resolves immediately (incrementing the held count) while
+     * below `max`; otherwise parks until a holder {@link release}s a slot to it.
+     * Always pair with exactly one `release()` in a `finally`.
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release a slot. If a caller is parked, hand the slot directly to the next
+     * (FIFO) — the held count stays the same, so the cap is never momentarily
+     * exceeded. Otherwise decrement.
+     */
+    release(): void;
+    /** Slots currently held (in-flight). Never exceeds `max`. */
+    get inFlight(): number;
+    /** Callers currently parked waiting for a slot. */
+    get queued(): number;
+}

package/dist/wire/slot-gate.js

@@ -0,0 +1,61 @@
+/**
+ * SlotGate — a minimal FIFO counting semaphore (bug-171).
+ *
+ * Bounds the number of concurrent in-flight `request()` calls over the single
+ * shared MCP wire. A broad parallel read burst (e.g. a verifier conformance
+ * sweep firing dozens of read-only Hub calls at once) could otherwise overwhelm
+ * the one connection and drop the whole transport (`-32000 Connection closed`),
+ * stranding the session behind reconnect backoff. The gate paces the burst:
+ * excess callers queue for a slot rather than all firing at once. Queued calls
+ * still complete — only their START is paced.
+ *
+ * Invariants:
+ *   - The held count NEVER exceeds `max` (a parked caller is handed the
+ *     releaser's slot directly — no decrement/re-increment window that could
+ *     momentarily admit one over the cap).
+ *   - Hand-off is FIFO (first parked, first resumed).
+ *   - `max` is floored at 1 by the caller (a cap of 0 would deadlock).
+ */
+export class SlotGate {
+    max;
+    held = 0;
+    waiters = [];
+    constructor(max) {
+        this.max = max;
+    }
+    /**
+     * Acquire a slot. Resolves immediately (incrementing the held count) while
+     * below `max`; otherwise parks until a holder {@link release}s a slot to it.
+     * Always pair with exactly one `release()` in a `finally`.
+     */
+    async acquire() {
+        if (this.held < this.max) {
+            this.held++;
+            return;
+        }
+        await new Promise((resolve) => this.waiters.push(resolve));
+    }
+    /**
+     * Release a slot. If a caller is parked, hand the slot directly to the next
+     * (FIFO) — the held count stays the same, so the cap is never momentarily
+     * exceeded. Otherwise decrement.
+     */
+    release() {
+        const next = this.waiters.shift();
+        if (next) {
+            next();
+        }
+        else if (this.held > 0) {
+            this.held--;
+        }
+    }
+    /** Slots currently held (in-flight). Never exceeds `max`. */
+    get inFlight() {
+        return this.held;
+    }
+    /** Callers currently parked waiting for a slot. */
+    get queued() {
+        return this.waiters.length;
+    }
+}
+//# sourceMappingURL=slot-gate.js.map

package/dist/wire/slot-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-gate.js","sourceRoot":"","sources":["../../src/wire/slot-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,QAAQ;IAIU;IAHrB,IAAI,GAAG,CAAC,CAAC;IACA,OAAO,GAAsB,EAAE,CAAC;IAEjD,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAE5C;;;;OAIG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,mDAAmD;IACnD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;CACF"}

package/dist/wire/transport.d.ts

@@ -96,6 +96,18 @@ export interface TransportConfig {
     firstKeepaliveDeadline?: number;
     sseWatchdogInterval?: number;
     reconnectDelay?: number;
+    /**
+     * bug-171: maximum concurrent in-flight `request()` calls over the single
+     * shared wire. Excess callers QUEUE (FIFO) for a slot rather than all firing
+     * at once — a broad parallel read burst (e.g. a verifier conformance sweep)
+     * could otherwise overwhelm the one connection and drop the whole transport
+     * (`-32000 Connection closed`), stranding the session behind reconnect
+     * backoff. Queued calls still complete; only their start is paced. Normal
+     * single-agent flow (1–3 concurrent) never reaches the cap, so it is
+     * invisible there. Defaults to `OIS_ADAPTER_MAX_INFLIGHT` env var (parsed as
+     * integer), falling back to 8. Floored at 1.
+     */
+    maxInFlight?: number;
     /**
      * Logger injection. Preferred is `ILogger`; the string variant is a
      * Phase-2 migration aid so existing string-logger call sites can
@@ -127,6 +139,12 @@ export interface TransportMetrics {
     readonly lastReconnectCause?: WireReconnectCause;
     readonly lastKeepaliveAt?: number;
     readonly requestsInFlight: number;
+    /**
+     * bug-171: callers currently parked waiting for an in-flight slot (the
+     * concurrency cap is saturated). 0 in normal flow; a sustained positive
+     * value is the observable signal of a request burst being paced.
+     */
+    readonly requestsQueued: number;
 }
 export interface ITransport {
     /** Current coarse wire state. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apnex/network-adapter",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Universal MCP Network Adapter — L4/L7 transport for OIS agentic network",
   "type": "module",
   "main": "dist/index.js",
@@ -10,15 +10,17 @@
     "README.md"
   ],
   "scripts": {
+    "prebuild": "node ../../scripts/build/write-build-info.js",
     "build": "tsc",
+    "prepack": "node ../../scripts/build/write-build-info.js --assert",
     "dev": "tsc --watch",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "@apnex/cognitive-layer": "^0.1.2",
-    "@apnex/message-router": "^0.1.2"
+    "@apnex/cognitive-layer": "^0.1.3",
+    "@apnex/message-router": "^0.1.3"
   },
   "devDependencies": {
     "@types/express": "^5.0.6",
@@ -26,6 +28,7 @@
     "express": "^5.2.1",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
+    "ulidx": "^2.4.1",
     "vitest": "^4.1.4",
     "zod": "^4.3.6"
   }

package/dist/kernel/instance.d.ts

@@ -1,40 +0,0 @@
-/**
- * globalInstanceId bootstrap.
- *
- * Identity is decoupled from authentication: the Hub token grants *access*
- * and *role*; the globalInstanceId grants *identity*. This lets tokens be
- * rotated without orphaning Agent entities.
- *
- * Storage: ~/.ois/instance.json (owner-private, 0600). NOT workspace-local —
- * workspace scoping fails on multi-terminal, clone, and accidental git commit.
- *
- * First call generates a new UUID v4. Subsequent calls read it. If the file
- * is deleted or corrupted, a new UUID is generated → new fingerprint → Hub
- * creates a new Agent. The old Agent remains append-only with its queue
- * intact; use `migrate_agent_queue` to recover pending work.
- */
-export interface LoadInstanceOptions {
-    /** Override the default ~/.ois/instance.json location (for tests). */
-    instanceFile?: string;
-    /** Optional logger for diagnostics (regeneration on corruption, etc.). */
-    log?: (msg: string) => void;
-}
-/**
- * Load an existing globalInstanceId from disk or create a new one.
- * Returns the UUID (or the env-provided string override). Idempotent
- * across calls within a process.
- *
- * Precedence: `OIS_INSTANCE_ID` env var wins outright — used when the
- * operator wants a stable, human-meaningful identity (e.g. "greg" or
- * "kate") and is responsible for uniqueness themselves. Absent that,
- * falls back to the file-persisted UUID (original behaviour). The env
- * path does NOT touch the file, so the two schemes coexist cleanly:
- * toggling the env var off restores the file-derived UUID untouched.
- *
- * This is a pragmatic escape hatch that unblocks multi-agent
- * co-location on a single user account (two Claude instances on one
- * laptop). A richer design — separate agentName metadata plus an
- * agentId derived from multiple inputs — is queued for the Entity
- * Registry SSOT mission.
- */
-export declare function loadOrCreateGlobalInstanceId(opts?: LoadInstanceOptions): string;