@mcpmesh/sdk 2.8.2 → 3.0.1

package/dist/service-view.d.ts

@@ -0,0 +1,245 @@
+/**
+ * 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 type { DependencySpec, NormalizedDependency, TagSpec, MeshToolDef } from "./types.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 declare function assertNoServiceViewDeps(deps: ReadonlyArray<unknown>, surface: string): void;
+/**
+ * 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 declare const CAPABILITY_NAME_PATTERN: RegExp;
+/**
+ * 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 declare const SERVICE_VIEW_BRAND: unique symbol;
+/** A single view method — a capability string shorthand or a full selector. */
+export type ServiceViewMethodSpec = string | {
+    /** Capability this method binds. */
+    capability: string;
+    /** Tags for filtering (supports OR alternatives via nested arrays). */
+    tags?: TagSpec[];
+    /** Version constraint (e.g. ">=2.0.0"). */
+    version?: string;
+    /** Issue #1249 opt-in strictness for this edge (default soft-fail). */
+    required?: boolean;
+    /**
+     * Issue #547: optional Zod schema describing the expected provider
+     * response for this method edge (parity with Java `@Selector` schema
+     * matching). Passed through `normalizeDependency` exactly like an ordinary
+     * object dependency, so the registry filters providers by canonical hash.
+     */
+    expectedSchema?: z.ZodType<unknown>;
+    /** Issue #547: schema match mode (defaults to "subset" when expectedSchema set). */
+    matchMode?: "subset" | "strict";
+};
+/**
+ * A consumer service-view specification. `methods` maps facade method names to
+ * their capability binding; the injected facade exposes exactly these keys.
+ */
+export interface ServiceViewSpec {
+    /** Facade method name → capability binding. At least one entry required. */
+    methods: Record<string, ServiceViewMethodSpec>;
+    /**
+     * Optional availability floor. When fewer than `minAvailable` of the view's
+     * methods currently resolve, EVERY facade call throws
+     * {@link MeshServiceUnavailableError} — a consumer-local circuit breaker with
+     * no wire effect. Default 0 = no floor (each method soft/hard-fails per its
+     * own `required` flag).
+     */
+    minAvailable?: number;
+    /** Optional label surfaced in floor-breach errors and logs. */
+    name?: string;
+}
+/**
+ * A single facade method. Signature mirrors {@link import("./types.js").McpMeshTool}'s
+ * callable form so a view method is a drop-in for a directly-injected proxy.
+ */
+export type MeshServiceFacadeMethod = (args?: Record<string, unknown>, options?: {
+    headers?: Record<string, string>;
+}) => Promise<unknown>;
+/**
+ * The injected facade type inferred from a {@link ServiceView} (or a bare
+ * {@link ServiceViewSpec}). Each spec method key becomes a callable facade
+ * method.
+ *
+ * **How to type the view slot in `execute`:** leave the positional parameters
+ * un-annotated (they infer as the injected `McpMeshTool | MeshJob | null`
+ * union) and narrow the view slot with a cast at point of use. A direct
+ * parameter annotation (`media: MeshServiceFacade<typeof Media>`) does NOT
+ * compile under `strictFunctionTypes`: `execute`'s dependency parameters are
+ * checked contravariantly, so any type narrower than the full injected union —
+ * including a plain `McpMeshTool | null` — is rejected. This is why the cast
+ * idiom is the canonical form (it also matches how ordinary `McpMeshTool` deps
+ * are consumed):
+ *
+ * ```ts
+ * import { mesh, type MeshServiceFacade } from "@mcpmesh/sdk";
+ *
+ * const Media = mesh.serviceView({ methods: { caption: "media.caption" } });
+ *
+ * agent.addTool({
+ *   name: "process",
+ *   parameters: z.object({ text: z.string() }),
+ *   dependencies: ["audit_log", Media],
+ *   execute: async (args, auditLog, media) => {
+ *     const svc = media as MeshServiceFacade<typeof Media>;
+ *     return await svc.caption({ text: args.text });
+ *   },
+ * });
+ * ```
+ */
+export type MeshServiceFacade<V> = V extends ServiceView<infer S> ? {
+    [K in keyof S["methods"]]: MeshServiceFacadeMethod;
+} : V extends ServiceViewSpec ? {
+    [K in keyof V["methods"]]: MeshServiceFacadeMethod;
+} : never;
+/**
+ * A branded service-view value produced by {@link serviceView}. Placed in a
+ * tool's `dependencies` array where it occupies one positional slot.
+ */
+export interface ServiceView<S extends ServiceViewSpec = ServiceViewSpec> {
+    readonly [SERVICE_VIEW_BRAND]: true;
+    readonly spec: S;
+}
+/** Structural brand check — true for a `mesh.serviceView(...)` result. */
+export declare function isServiceView(value: unknown): value is ServiceView;
+/**
+ * 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 declare class MeshServiceUnavailableError extends Error {
+    /** View label (spec.name or a derived owner:slot label). */
+    readonly service: string;
+    /** View methods currently resolving to a provider. */
+    readonly available: number;
+    /** Total dependency-bound view methods. */
+    readonly total: number;
+    /** The declared availability floor. */
+    readonly floor: number;
+    readonly name = "MeshServiceUnavailableError";
+    constructor(
+    /** View label (spec.name or a derived owner:slot label). */
+    service: string, 
+    /** View methods currently resolving to a provider. */
+    available: number, 
+    /** Total dependency-bound view methods. */
+    total: number, 
+    /** The declared availability floor. */
+    floor: number);
+}
+/**
+ * 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 declare function serviceView<S extends ServiceViewSpec>(spec: S): ServiceView<S>;
+/** One view method's flat-edge placement within the expanded dependency list. */
+export interface ViewMethodEdge {
+    /** Facade method name (spec key). */
+    method: string;
+    /** Index into the flat edge array (settle-key / resolvedDeps / wire index). */
+    edgeIndex: number;
+}
+/**
+ * One positional dependency slot after expansion. A `dep` slot maps to exactly
+ * one edge; a `view` slot collapses N edges into a single facade argument. The
+ * disjoint edge ranges are tracked here (mirrors Java's index-range mapping).
+ */
+export type DepSlot = {
+    kind: "dep";
+    edgeIndex: number;
+} | {
+    kind: "view";
+    name: string;
+    minAvailable: number;
+    methods: ViewMethodEdge[];
+};
+/** Result of expanding a mixed `(DependencySpec | ServiceView)[]` list. */
+export interface ExpandedDeps {
+    /**
+     * Flat dependency edges in wire/settle/resolve order. This is what ships to
+     * the registry, what settle keys index (`owner:dep_<edgeIndex>`), what
+     * `dependency_available` events address, and what `resolvedDeps` keys — one
+     * entry per edge, view methods expanded IN-PLACE at the view's array position
+     * in NAME-SORTED order.
+     */
+    edges: NormalizedDependency[];
+    /**
+     * Positional execute slots (one per authored `dependencies` entry). A view
+     * entry is ONE slot spanning a contiguous edge range; a non-view entry is one
+     * slot mapping to one edge. For a view-free list `slots[i].edgeIndex === i`.
+     */
+    slots: DepSlot[];
+}
+/**
+ * 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 declare function expandDependencies(deps: ReadonlyArray<DependencySpec | ServiceView>, ownerLabel: string): ExpandedDeps;
+/**
+ * A producer method for `agent.addService`. Either a bare execute function
+ * (shorthand) or an object carrying `execute` plus any `addTool` passthrough
+ * (tags/version/description/parameters/dependencies/...). `name` and
+ * `capability` are DERIVED (`prefix.<method>`) and must not be supplied.
+ */
+export type ServiceProducerMethod = ((...args: never[]) => Promise<unknown> | unknown) | ServiceProducerMethodObject;
+/** Object form of a {@link ServiceProducerMethod}. */
+export type ServiceProducerMethodObject = Omit<Partial<MeshToolDef>, "name" | "capability" | "execute" | "parameters"> & {
+    /** Method implementation (positional deps injected after args, as usual). */
+    execute: MeshToolDef["execute"];
+    /** Optional Zod input schema. Defaults to a permissive passthrough object. */
+    parameters?: z.ZodType;
+};
+/** Permissive default schema for producer methods that declare no `parameters`. */
+export declare function defaultProducerParams(): z.ZodType;
+//# sourceMappingURL=service-view.d.ts.map

package/dist/service-view.d.ts.map

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

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAA4B,EAC5B,OAAe;IAEf,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,uDAAuD;gBAC/D,sEAAsE;gBACtE,oEAAoE;gBACpE,qBAAqB,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,qDAAqD,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkB,MAAM,CAAC,GAAG,CACzD,2BAA2B,CAC5B,CAAC;AAmGF,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAsC,CAAC,kBAAkB,CAAC,KAAK,IAAI,CACrE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAKlC;IAEA;IAEA;IAEA;IAVT,IAAI,GAAG,6BAA6B,CAAC;IAE9C;IACE,4DAA4D;IAC5C,OAAe;IAC/B,sDAAsD;IACtC,SAAiB;IACjC,2CAA2C;IAC3B,KAAa;IAC7B,uCAAuC;IACvB,KAAa;QAE7B,KAAK,CACH,kCAAkC,OAAO,MAAM,SAAS,IAAI,KAAK,GAAG;YAClE,uDAAuD,KAAK,QAAQ,CACvE,CAAC;QAXc,YAAO,GAAP,OAAO,CAAQ;QAEf,cAAS,GAAT,SAAS,CAAQ;QAEjB,UAAK,GAAL,KAAK,CAAQ;QAEb,UAAK,GAAL,KAAK,CAAQ;IAM/B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAA4B,IAAO;IAC5D,IACE,IAAI,IAAI,IAAI;QACZ,OAAO,IAAI,KAAK,QAAQ;QACxB,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAChC,IAAI,CAAC,OAAO,KAAK,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wEAAwE;YACtE,eAAe,CAClB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,qBAAqB,CACxB,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC;QAC7D,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/D,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,2BAA2B,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,+DAA+D,GAAG,IAAI,CACvE,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,kCAAkC,GAAG,iCAAiC;gBACpE,IAAI,IAAI,CAAC,MAAM,uCAAuC,CACzD,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,CAAC,kBAAkB,CAAC,EAAE,IAAI;QAC1B,IAAI;KACa,CAAC;AACtB,CAAC;AA0CD,SAAS,mBAAmB,CAAC,CAAwB;IACnD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,mBAAmB,CAAC;QACzB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAiD,EACjD,UAAkB;IAElB,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,+DAA+D;YAC/D,6CAA6C;YAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,OAAO,GAAqB,EAAE,CAAC;YACrC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG,UAAU,QAAQ,SAAS,EAAE;gBACnD,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC;gBACpC,OAAO;aACR,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,4EAA4E;QAC5E,0EAA0E;QAC1E,uEAAuE;QACvE,mBAAmB;QACnB,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,OAAQ,KAAkC,CAAC,UAAU,KAAK,QAAQ,EAClE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,iBAAiB,SAAS,0BAA0B;gBAC/D,sEAAsE;gBACtE,qEAAqE;gBACrE,gCAAgC,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAuB,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAuBD,mFAAmF;AACnF,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC"}

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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"}