@mcpmesh/sdk 2.8.1 → 3.0.0

package/dist/service-view.js

@@ -0,0 +1,210 @@
+/**
+ * Service views (RFC #1280) for the TypeScript SDK.
+ *
+ * Two related roles, mirroring the Java runtime (`@McpMeshService`) so the
+ * cross-runtime contract (integration suite uc37) holds identically:
+ *
+ *   1. CONSUMER VIEW — `mesh.serviceView({ methods, minAvailable? })` produces a
+ *      branded object that occupies ONE positional dependency slot in a tool's
+ *      `dependencies` array but expands into N ordinary dependency edges (one per
+ *      method, SORTED BY NAME for deterministic registration). At call time the
+ *      framework injects a facade whose methods delegate to each edge's own
+ *      resolved proxy — so different methods may bind different provider agents
+ *      and rebind independently as topology changes. There are NO wire or
+ *      registry changes: every method is an ordinary dependency edge.
+ *
+ *   2. PRODUCER SUGAR — `agent.addService("prefix", { ... })` publishes each
+ *      entry (name-sorted) as an ordinary mesh tool with capability
+ *      `prefix.<method>` through the existing `addTool` machinery.
+ *
+ * A service view is purely consumer-local: there is no group versioning and no
+ * interface-level availability summary. The optional `minAvailable` floor is a
+ * consumer-local circuit breaker with no wire effect.
+ */
+import { z } from "zod";
+import { normalizeDependency } from "./proxy.js";
+/**
+ * Reject any {@link ServiceView} in a dependency list for a surface that does
+ * NOT support the tool-parameter facade form (mesh.route, mesh.a2a.mount). A
+ * view there would normalize to a `capability: undefined` edge — a settle key
+ * that never resolves plus a nameless dependency shipped to the registry.
+ * Shared by every such call site so the error message + policy stay identical.
+ */
+export function assertNoServiceViewDeps(deps, surface) {
+    for (const dep of deps) {
+        if (isServiceView(dep)) {
+            throw new Error(`${surface} does not support mesh.serviceView(...) dependencies ` +
+                `(RFC #1280 service views are a tool-parameter surface). Declare the ` +
+                `individual capability deps directly, or use a service view inside ` +
+                `agent.addTool(...).`);
+        }
+    }
+}
+/**
+ * Segment-wise dotted capability-name grammar. Kept in lockstep with the Go
+ * registry validator's `capabilityNamePattern`
+ * (src/core/registry/validation.go: `^[a-zA-Z][a-zA-Z0-9_-]*(\.[a-zA-Z][a-zA-Z0-9_-]*)*$`)
+ * and the Python/Java runtimes. Applied to the PRODUCED capability names of
+ * `agent.addService` (the derived `prefix.method`) and `agent.addTool`
+ * (`capability ?? name`, #1293 item 6) — both validate before the name reaches
+ * the registry. Dependency capability names are deliberately left unvalidated
+ * (the registry remains their single authority).
+ */
+export const CAPABILITY_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]*(\.[a-zA-Z][a-zA-Z0-9_-]*)*$/;
+/**
+ * Brand symbol marking a `mesh.serviceView(...)` result so the dependency
+ * expander can detect a view slot structurally (config-over-reflection, the
+ * same precedent as `meshJobDepIndex`). `Symbol.for` keeps the brand stable
+ * across duplicate module instances.
+ */
+export const SERVICE_VIEW_BRAND = Symbol.for("@mcpmesh/sdk/service-view");
+/** Structural brand check — true for a `mesh.serviceView(...)` result. */
+export function isServiceView(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[SERVICE_VIEW_BRAND] === true);
+}
+/**
+ * Thrown by every facade call when a view is below its declared
+ * {@link ServiceViewSpec.minAvailable} floor. Carries the view label plus the
+ * current/total/floor counts so the failure is actionable. Mirrors Java's
+ * `MeshServiceUnavailableException`.
+ */
+export class MeshServiceUnavailableError extends Error {
+    service;
+    available;
+    total;
+    floor;
+    name = "MeshServiceUnavailableError";
+    constructor(
+    /** View label (spec.name or a derived owner:slot label). */
+    service, 
+    /** View methods currently resolving to a provider. */
+    available, 
+    /** Total dependency-bound view methods. */
+    total, 
+    /** The declared availability floor. */
+    floor) {
+        super(`Mesh service view unavailable (${service}): ${available}/${total} ` +
+            `method(s) resolved, below the declared minAvailable=${floor} floor`);
+        this.service = service;
+        this.available = available;
+        this.total = total;
+        this.floor = floor;
+    }
+}
+/**
+ * Construct a consumer service view. Validates the spec at construction time
+ * (empty methods map; blank capability; out-of-range `minAvailable`) so misuse
+ * fails loud before the agent talks to the registry.
+ */
+export function serviceView(spec) {
+    if (spec == null ||
+        typeof spec !== "object" ||
+        typeof spec.methods !== "object" ||
+        spec.methods === null ||
+        Array.isArray(spec.methods)) {
+        throw new Error("mesh.serviceView: `methods` must be an object mapping method names to " +
+            "capabilities.");
+    }
+    const keys = Object.keys(spec.methods);
+    if (keys.length === 0) {
+        throw new Error("mesh.serviceView: `methods` must declare at least one method (got an " +
+            "empty methods map).");
+    }
+    for (const key of keys) {
+        const m = spec.methods[key];
+        const capability = typeof m === "string" ? m : m?.capability;
+        if (typeof capability !== "string" || capability.trim() === "") {
+            throw new Error(`mesh.serviceView: method '${key}' has a blank capability.`);
+        }
+    }
+    const min = spec.minAvailable;
+    if (min !== undefined) {
+        if (!Number.isInteger(min) || min < 0) {
+            throw new Error(`mesh.serviceView: minAvailable must be an integer >= 0 (got ${min}).`);
+        }
+        if (min > keys.length) {
+            throw new Error(`mesh.serviceView: minAvailable=${min} exceeds the number of methods ` +
+                `(${keys.length}) — the floor can never be satisfied.`);
+        }
+    }
+    return {
+        [SERVICE_VIEW_BRAND]: true,
+        spec,
+    };
+}
+function normalizeViewMethod(m) {
+    if (typeof m === "string") {
+        return normalizeDependency(m);
+    }
+    return normalizeDependency({
+        capability: m.capability,
+        tags: m.tags,
+        version: m.version,
+        required: m.required,
+        expectedSchema: m.expectedSchema,
+        matchMode: m.matchMode,
+    });
+}
+/**
+ * Expand a tool's authored dependency list (a mix of {@link DependencySpec} and
+ * {@link ServiceView}) into the flat edge array + the positional slot layout.
+ *
+ * Layout contract (identical to the Java runtime — see uc37):
+ *   - non-view entries keep their exact slot↔edge pairing;
+ *   - a view entry contributes ONE slot at its array position but N edges,
+ *     expanded IN-PLACE (name-sorted) so the flat edge indices stay contiguous
+ *     and every downstream index consumer (settle keys, wire payload,
+ *     resolution events, required guard) sees ordinary edges.
+ *
+ * For a view-free list this returns `edges` byte-identical to
+ * `deps.map(normalizeDependency)` and `slots[i] = { kind: "dep", edgeIndex: i }`
+ * — zero behavior change.
+ */
+export function expandDependencies(deps, ownerLabel) {
+    const edges = [];
+    const slots = [];
+    deps.forEach((entry, slotIndex) => {
+        if (isServiceView(entry)) {
+            const spec = entry.spec;
+            // Object key order is insertion-based; MUST sort by name for a
+            // deterministic edge layout across runtimes.
+            const methodNames = Object.keys(spec.methods).sort();
+            const methods = [];
+            for (const method of methodNames) {
+                const edgeIndex = edges.length;
+                edges.push(normalizeViewMethod(spec.methods[method]));
+                methods.push({ method, edgeIndex });
+            }
+            slots.push({
+                kind: "view",
+                name: spec.name ?? `${ownerLabel}:view${slotIndex}`,
+                minAvailable: spec.minAvailable ?? 0,
+                methods,
+            });
+            return;
+        }
+        // Guard: an object without a `capability` in a dependencies array is almost
+        // certainly a producer-method object placed where a view/dep was expected
+        // (or a malformed spec). Fail loud rather than shipping a `capability:
+        // undefined` edge.
+        if (typeof entry === "object" &&
+            entry !== null &&
+            typeof entry.capability !== "string") {
+            throw new Error(`${ownerLabel}: dependency #${slotIndex} is an object without a ` +
+                `'capability' — expected a DependencySpec (string or { capability }) ` +
+                `or a mesh.serviceView(...). If this is a producer method, register ` +
+                `it with agent.addService(...).`);
+        }
+        const edgeIndex = edges.length;
+        edges.push(normalizeDependency(entry));
+        slots.push({ kind: "dep", edgeIndex });
+    });
+    return { edges, slots };
+}
+/** Permissive default schema for producer methods that declare no `parameters`. */
+export function defaultProducerParams() {
+    return z.object({}).passthrough();
+}
+//# sourceMappingURL=service-view.js.map

package/dist/service-view.js.map

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

package/dist/settle.d.ts

@@ -109,6 +109,19 @@ export declare class SettleState {
     remainingMs(): number;
     isResolved(depKey: string): boolean;
     private waiterFor;
+    /**
+     * Shared wait plumbing for {@link waitFor} / {@link waitForAny}: log the
+     * settle cadence for each capability (INFO first time, DEBUG after), bump the
+     * diagnostic `waitCount`, and race every `depKeys` resolution waiter against
+     * ONE budget timer bounded by `remaining` — never a fixed sleep. Callers apply
+     * their own resolved-state filtering + early-return BEFORE calling this, so
+     * `depKeys` are the genuinely-still-pending keys and `remaining > 0`.
+     *
+     * On timeout the caller simply proceeds — the unresolved dep injects null
+     * exactly as today; the existing unresolved-dep handling covers the
+     * diagnostic (no double-logging here).
+     */
+    private raceWaiters;
     /**
      * Wait until `depKey` resolves or the remaining settle budget elapses.
      * Event-driven: the dependency's resolution promise is raced against a
@@ -121,6 +134,15 @@ export declare class SettleState {
      * regardless of how many deps are pending.
      */
     awaitPending(pending: PendingSettleDep[]): Promise<void>;
+    /**
+     * Wait until ANY of `pending` resolves or the remaining settle budget
+     * elapses. Unlike {@link awaitPending} (which blocks on each key in turn),
+     * this races every pending key's resolution promise against ONE budget timer,
+     * so a caller gated on a floor wakes the moment ANY qualifying dependency
+     * lands — never sleeping on an already-satisfied floor because it happened to
+     * be awaiting a still-pending sibling key (RFC #1280 minAvailable).
+     */
+    waitForAny(pending: PendingSettleDep[]): Promise<void>;
 }
 /** Get the process-wide settle state. */
 export declare function getSettleState(): SettleState;

package/dist/settle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAQjD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAmBhD;AAOD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB;;;;OAIG;IACH,SAAS,SAAK;IAEd;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtC;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqBlC;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA0BpD,kEAAkE;IAClE,SAAS,IAAI,OAAO;IAsBpB,sDAAsD;IACtD,WAAW,IAAI,MAAM;IAUrB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,OAAO,CAAC,SAAS;IAajB;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK/D;AAID,yCAAyC;AACzC,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAQjD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAmBhD;AAOD,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB;;;;OAIG;IACH,SAAS,SAAK;IAEd;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOtC;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqBlC;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA0BpD,kEAAkE;IAClE,SAAS,IAAI,OAAO;IAsBpB,sDAAsD;IACtD,WAAW,IAAI,MAAM;IAUrB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,OAAO,CAAC,SAAS;IAajB;;;;;;;;;;;OAWG;YACW,WAAW;IAmCzB;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D;;;;;;;OAOG;IACG,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAY7D;AAID,yCAAyC;AACzC,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,2EAA2E;AAC3E,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}

package/dist/settle.js

@@ -218,32 +218,36 @@ export class SettleState {
         return waiter;
     }
     /**
-     * Wait until `depKey` resolves or the remaining settle budget elapses.
-     * Event-driven: the dependency's resolution promise is raced against a
-     * timer bounded by the remaining window — never a fixed sleep.
+     * Shared wait plumbing for {@link waitFor} / {@link waitForAny}: log the
+     * settle cadence for each capability (INFO first time, DEBUG after), bump the
+     * diagnostic `waitCount`, and race every `depKeys` resolution waiter against
+     * ONE budget timer bounded by `remaining` — never a fixed sleep. Callers apply
+     * their own resolved-state filtering + early-return BEFORE calling this, so
+     * `depKeys` are the genuinely-still-pending keys and `remaining > 0`.
+     *
+     * On timeout the caller simply proceeds — the unresolved dep injects null
+     * exactly as today; the existing unresolved-dep handling covers the
+     * diagnostic (no double-logging here).
      */
-    async waitFor(depKey, capability) {
-        const remaining = this.remainingMs();
-        if (remaining <= 0 || this.resolved.has(depKey)) {
-            return;
-        }
-        const waiter = this.waiterFor(depKey);
+    async raceWaiters(depKeys, capabilities, remaining) {
         const remainingSecs = (remaining / 1000).toFixed(1);
-        const message = `waiting up to ${remainingSecs}s for dependency '${capability}' to settle`;
-        if (!this.loggedWaits.has(capability)) {
-            // One INFO line per capability per process; later waits at DEBUG
-            // (matches the Python/Java log cadence).
-            this.loggedWaits.add(capability);
-            console.log(message);
-        }
-        else {
-            console.debug(message);
+        for (const capability of capabilities) {
+            const message = `waiting up to ${remainingSecs}s for dependency '${capability}' to settle`;
+            if (!this.loggedWaits.has(capability)) {
+                // One INFO line per capability per process; later waits at DEBUG
+                // (matches the Python/Java log cadence).
+                this.loggedWaits.add(capability);
+                console.log(message);
+            }
+            else {
+                console.debug(message);
+            }
         }
         this.waitCount++;
         let timer;
         try {
             await Promise.race([
-                waiter.promise,
+                ...depKeys.map((k) => this.waiterFor(k).promise),
                 new Promise((resolve) => {
                     timer = setTimeout(resolve, remaining);
                     // Never keep the process alive just for a settle timer.
@@ -256,9 +260,18 @@ export class SettleState {
                 clearTimeout(timer);
             }
         }
-        // On timeout we simply proceed — the unresolved dep injects null
-        // exactly as today; the existing unresolved-dep handling covers the
-        // diagnostic (no double-logging here).
+    }
+    /**
+     * Wait until `depKey` resolves or the remaining settle budget elapses.
+     * Event-driven: the dependency's resolution promise is raced against a
+     * timer bounded by the remaining window — never a fixed sleep.
+     */
+    async waitFor(depKey, capability) {
+        const remaining = this.remainingMs();
+        if (remaining <= 0 || this.resolved.has(depKey)) {
+            return;
+        }
+        await this.raceWaiters([depKey], [capability], remaining);
     }
     /**
      * Await every pending dependency in turn. The per-wait budget is the
@@ -270,6 +283,22 @@ export class SettleState {
             await this.waitFor(depKey, capability);
         }
     }
+    /**
+     * Wait until ANY of `pending` resolves or the remaining settle budget
+     * elapses. Unlike {@link awaitPending} (which blocks on each key in turn),
+     * this races every pending key's resolution promise against ONE budget timer,
+     * so a caller gated on a floor wakes the moment ANY qualifying dependency
+     * lands — never sleeping on an already-satisfied floor because it happened to
+     * be awaiting a still-pending sibling key (RFC #1280 minAvailable).
+     */
+    async waitForAny(pending) {
+        const remaining = this.remainingMs();
+        const unresolved = pending.filter((p) => !this.resolved.has(p.depKey));
+        if (remaining <= 0 || unresolved.length === 0) {
+            return;
+        }
+        await this.raceWaiters(unresolved.map((p) => p.depKey), unresolved.map((p) => p.capability), remaining);
+    }
 }
 let settleState = new SettleState();
 /** Get the process-wide settle state. */

package/dist/settle.js.map

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

package/dist/superseded.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Typed supersession signal (issue #1278).
+ *
+ * A provider tool that detects it is being called by a SUPERSEDED executor —
+ * the app compares the calling job's epoch via {@link callingJob} (issue
+ * #1263) against its own live epoch — rejects the call by throwing
+ * {@link MeshSupersededError}. That crosses the wire as the reserved app
+ * envelope `{"error":"claim_superseded"}` (plus an optional `"detail"`
+ * string), and the CALLING side's injected proxy recognizes the envelope and
+ * re-throws {@link MeshSupersededError}. A superseded caller then unwinds with
+ * one `catch (e) { if (e instanceof MeshSupersededError) ... }` instead of
+ * string-matching `claim_superseded` after every mutating call.
+ *
+ * The framework does NOT auto-detect supersession — the app decides (full
+ * control); the framework provides the typed class plus the emit/recognize
+ * plumbing. This is the structural parallel of the `dependency_unavailable`
+ * refusal (issue #1273): both throw a `UserError` whose message is a reserved
+ * JSON envelope, so the contract (not the carrier) drives classification.
+ */
+import { UserError } from "fastmcp";
+/**
+ * Reserved marker string for the supersession envelope. This is the SAME
+ * canonical marker the job path already uses on the wire (Rust
+ * `task_backend.rs` `CLAIM_SUPERSEDED_REASON` / Go `ent_service_jobs.go`),
+ * reused verbatim so a superseded signal is one string end-to-end.
+ */
+export declare const CLAIM_SUPERSEDED_MARKER = "claim_superseded";
+/**
+ * Thrown by a provider tool to reject a call from a superseded executor.
+ *
+ * Extends fastmcp's {@link UserError} — the same error primitive the
+ * `dependency_unavailable` refusal uses (agent.ts) — so throwing it from a
+ * `@mesh.tool` handler auto-emits an `isError` tool result whose text is the
+ * reserved envelope, through the EXISTING fastmcp UserError path (fastmcp maps
+ * a thrown `UserError` to `{content:[{text: error.message}], isError:true}`,
+ * so no provider wrapper change is needed).
+ *
+ * The serialized message (`err.message`) is
+ * `{"error":"claim_superseded","detail":<detail>}` — the `detail` key is
+ * omitted entirely when no detail is supplied.
+ *
+ * Provider usage:
+ * ```ts
+ * const cj = callingJob();
+ * if (cj && cj.claimEpoch != null && cj.claimEpoch < myLiveEpoch) {
+ *   throw new MeshSupersededError(`stale epoch ${cj.claimEpoch}`);
+ * }
+ * ```
+ *
+ * `if (e instanceof MeshSupersededError)` is the specific catch this enables;
+ * because it IS a `UserError`, `if (e instanceof UserError)` still catches it
+ * too.
+ */
+export declare class MeshSupersededError extends UserError {
+    readonly detail?: string;
+    constructor(detail?: string);
+}
+/**
+ * Return a {@link MeshSupersededError} if `text` is the reserved supersession
+ * envelope, else `null`.
+ *
+ * Defensive parse for the consumer recognize path: a non-JSON body, a JSON
+ * body that is not a plain object, or one whose `error` field is not exactly
+ * the reserved marker all return `null` so the caller falls through to its
+ * existing generic error handling. Only the exact reserved marker is
+ * classified — a `dependency_unavailable` (or any other) envelope is left
+ * alone.
+ */
+export declare function parseSupersededEnvelope(text: string): MeshSupersededError | null;
+//# sourceMappingURL=superseded.d.ts.map

package/dist/superseded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superseded.d.ts","sourceRoot":"","sources":["../src/superseded.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,CAAC,EAAE,MAAM;CAW5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,GACX,mBAAmB,GAAG,IAAI,CAsB5B"}

package/dist/superseded.js

@@ -0,0 +1,99 @@
+/**
+ * Typed supersession signal (issue #1278).
+ *
+ * A provider tool that detects it is being called by a SUPERSEDED executor —
+ * the app compares the calling job's epoch via {@link callingJob} (issue
+ * #1263) against its own live epoch — rejects the call by throwing
+ * {@link MeshSupersededError}. That crosses the wire as the reserved app
+ * envelope `{"error":"claim_superseded"}` (plus an optional `"detail"`
+ * string), and the CALLING side's injected proxy recognizes the envelope and
+ * re-throws {@link MeshSupersededError}. A superseded caller then unwinds with
+ * one `catch (e) { if (e instanceof MeshSupersededError) ... }` instead of
+ * string-matching `claim_superseded` after every mutating call.
+ *
+ * The framework does NOT auto-detect supersession — the app decides (full
+ * control); the framework provides the typed class plus the emit/recognize
+ * plumbing. This is the structural parallel of the `dependency_unavailable`
+ * refusal (issue #1273): both throw a `UserError` whose message is a reserved
+ * JSON envelope, so the contract (not the carrier) drives classification.
+ */
+import { UserError } from "fastmcp";
+/**
+ * Reserved marker string for the supersession envelope. This is the SAME
+ * canonical marker the job path already uses on the wire (Rust
+ * `task_backend.rs` `CLAIM_SUPERSEDED_REASON` / Go `ent_service_jobs.go`),
+ * reused verbatim so a superseded signal is one string end-to-end.
+ */
+export const CLAIM_SUPERSEDED_MARKER = "claim_superseded";
+/**
+ * Thrown by a provider tool to reject a call from a superseded executor.
+ *
+ * Extends fastmcp's {@link UserError} — the same error primitive the
+ * `dependency_unavailable` refusal uses (agent.ts) — so throwing it from a
+ * `@mesh.tool` handler auto-emits an `isError` tool result whose text is the
+ * reserved envelope, through the EXISTING fastmcp UserError path (fastmcp maps
+ * a thrown `UserError` to `{content:[{text: error.message}], isError:true}`,
+ * so no provider wrapper change is needed).
+ *
+ * The serialized message (`err.message`) is
+ * `{"error":"claim_superseded","detail":<detail>}` — the `detail` key is
+ * omitted entirely when no detail is supplied.
+ *
+ * Provider usage:
+ * ```ts
+ * const cj = callingJob();
+ * if (cj && cj.claimEpoch != null && cj.claimEpoch < myLiveEpoch) {
+ *   throw new MeshSupersededError(`stale epoch ${cj.claimEpoch}`);
+ * }
+ * ```
+ *
+ * `if (e instanceof MeshSupersededError)` is the specific catch this enables;
+ * because it IS a `UserError`, `if (e instanceof UserError)` still catches it
+ * too.
+ */
+export class MeshSupersededError extends UserError {
+    detail;
+    constructor(detail) {
+        const envelope = {
+            error: CLAIM_SUPERSEDED_MARKER,
+        };
+        if (detail !== undefined) {
+            envelope.detail = detail;
+        }
+        super(JSON.stringify(envelope));
+        this.name = "MeshSupersededError";
+        this.detail = detail;
+    }
+}
+/**
+ * Return a {@link MeshSupersededError} if `text` is the reserved supersession
+ * envelope, else `null`.
+ *
+ * Defensive parse for the consumer recognize path: a non-JSON body, a JSON
+ * body that is not a plain object, or one whose `error` field is not exactly
+ * the reserved marker all return `null` so the caller falls through to its
+ * existing generic error handling. Only the exact reserved marker is
+ * classified — a `dependency_unavailable` (or any other) envelope is left
+ * alone.
+ */
+export function parseSupersededEnvelope(text) {
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (payload === null ||
+        typeof payload !== "object" ||
+        Array.isArray(payload)) {
+        return null;
+    }
+    const obj = payload;
+    if (obj.error !== CLAIM_SUPERSEDED_MARKER) {
+        return null;
+    }
+    const detail = obj.detail;
+    return new MeshSupersededError(typeof detail === "string" ? detail : undefined);
+}
+//# sourceMappingURL=superseded.js.map

package/dist/superseded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"superseded.js","sourceRoot":"","sources":["../src/superseded.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACvC,MAAM,CAAU;IAEzB,YAAY,MAAe;QACzB,MAAM,QAAQ,GAAuC;YACnD,KAAK,EAAE,uBAAuB;SAC/B,CAAC;QACF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY;IAEZ,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,OAAO,KAAK,IAAI;QAChB,OAAO,OAAO,KAAK,QAAQ;QAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,OAAkC,CAAC;IAC/C,IAAI,GAAG,CAAC,KAAK,KAAK,uBAAuB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,OAAO,IAAI,mBAAmB,CAC5B,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAChD,CAAC;AACJ,CAAC"}

package/dist/tool-worker-entry.js

@@ -20,6 +20,7 @@
 import { parentPort, workerData, isMainThread } from "node:worker_threads";
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
+import { serializeError } from "./worker-error-serde.js";
 if (isMainThread) {
     throw new Error("tool-worker-entry.js must be loaded inside a worker thread");
 }
@@ -89,18 +90,6 @@ async function bootstrap() {
     });
     parentPort.postMessage({ kind: "ready" });
 }
-function serializeError(err) {
-    if (!(err instanceof Error)) {
-        return { name: "Error", message: String(err) };
-    }
-    const out = { name: err.name, message: err.message, stack: err.stack };
-    const errAny = err;
-    if (errAny.code !== undefined)
-        out.code = errAny.code;
-    if (errAny.cause !== undefined)
-        out.cause = serializeError(errAny.cause);
-    return out;
-}
 function handleMessage(msg, tools, createProxy, runWithTraceContext, runWithPropagatedHeaders) {
     if (!msg || typeof msg !== "object")
         return;

package/dist/tool-worker-entry.js.map

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

package/dist/tool-worker-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-worker-pool.d.ts","sourceRoot":"","sources":["../src/tool-worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AA4MD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCzE;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,UAAU,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhE"}
+{"version":3,"file":"tool-worker-pool.d.ts","sourceRoot":"","sources":["../src/tool-worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAwLD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCzE;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,UAAU,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhE"}