@vauban-org/agent-sdk 0.17.4 → 1.2.0

package/dist/mesh/delegate.js

@@ -0,0 +1,172 @@
+/**
+ * src/mesh/delegate.ts
+ *
+ * `mesh.delegate()` — intent-based dispatch to the best available agent.
+ *
+ * @experimental — sprint-585. Public API may change before v1.x freeze.
+ *
+ * Replaces manual `withCompute()` boilerplate with a one-liner:
+ *
+ *     const r = await meshDelegate({ need: "summarize the spec" }, dispatcher);
+ *
+ * Responsibilities:
+ *   1. Classify need → AgentKind (via dispatcher.classify or injected hint).
+ *   2. Apply capability attenuation if a parent token is present.
+ *   3. Forward to dispatcher with budget/deadline guards.
+ *   4. Build a delegation chain link for audit.
+ *
+ * Streaming (`onChunk`) is a best-effort surface — the dispatcher must opt-in
+ * by exposing a `dispatchStream` (not part of base contract). When unavailable,
+ * the final result is delivered as a single chunk after completion.
+ */
+import { attenuateScope, buildToken, } from "./attenuation.js";
+import { DefaultMeshDispatcher } from "./dispatcher.js";
+// ─── Defaults ────────────────────────────────────────────────────────────────
+const DEFAULT_DEADLINE_MS = 30_000;
+const DEFAULT_MAX_COST_EUR = 0.01;
+const SELF_ID = "mesh:caller";
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function stringifyContext(ctx) {
+    if (ctx === undefined)
+        return undefined;
+    if (typeof ctx === "string")
+        return ctx;
+    try {
+        return JSON.stringify(ctx);
+    }
+    catch {
+        return String(ctx);
+    }
+}
+function isDispatcherWithClassify(d) {
+    return typeof d.classify === "function";
+}
+function generateChildId() {
+    // Tiny non-cryptographic id — child-id is for audit, not auth.
+    // Production: replace with ULID/UUID from caller env.
+    return `mesh-child-${Date.now().toString(36)}-${Math.floor(Math.random() * 1e6).toString(36)}`;
+}
+/**
+ * Compute child scope from parent token + caller-requested capabilities.
+ * Returns the issued child token (parented to caller's parentId) and the
+ * effective MeshCapabilityScope (post-intersection).
+ */
+function issueChildToken(parentToken, requestedCapabilities, requestedBudgetEur, childId) {
+    const parentScope = {
+        actions: parentToken.scope,
+        budgetEur: parentToken.budgetEur,
+        expiresAt: parentToken.expiresAt ? new Date(parentToken.expiresAt) : undefined,
+    };
+    const requestedScope = {
+        actions: requestedCapabilities ?? parentToken.scope,
+        budgetEur: requestedBudgetEur,
+    };
+    const childScope = attenuateScope(parentScope, requestedScope);
+    const token = buildToken(childScope, childId);
+    return { token, scope: childScope };
+}
+// ─── Errors ──────────────────────────────────────────────────────────────────
+export class DelegateAttenuationError extends Error {
+    name = "DelegateAttenuationError";
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Delegate a need to the best available agent.
+ *
+ * Routing priority (when `kind` not pre-set):
+ *  1. Dispatcher's `classify(need)` hook if present.
+ *  2. Heuristic — see `defaultClassifier`.
+ *
+ * Capability attenuation:
+ *  - If `parentToken` is provided, child scope = parent ∩ requested.
+ *  - Empty intersection raises {@link DelegateAttenuationError}.
+ *
+ * Budget guards:
+ *  - When `parentToken.budgetEur < max_cost_eur`, the effective max is parent's.
+ *  - Negative budget or deadline → RangeError.
+ */
+export async function meshDelegate(options, dispatcher) {
+    if (!options || typeof options.need !== "string" || options.need.length === 0) {
+        throw new TypeError("meshDelegate: `need` is required and must be a non-empty string");
+    }
+    if (!dispatcher || typeof dispatcher.dispatch !== "function") {
+        throw new TypeError("meshDelegate: `dispatcher` must implement MeshDispatcher");
+    }
+    const deadlineMs = options.deadline_ms ?? DEFAULT_DEADLINE_MS;
+    if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {
+        throw new RangeError(`meshDelegate: deadline_ms must be > 0, got ${deadlineMs}`);
+    }
+    let maxCostEur = options.max_cost_eur ?? DEFAULT_MAX_COST_EUR;
+    if (!Number.isFinite(maxCostEur) || maxCostEur < 0) {
+        throw new RangeError(`meshDelegate: max_cost_eur must be ≥ 0, got ${maxCostEur}`);
+    }
+    // ── 1. Classify ──────────────────────────────────────────────────────────
+    const kind = options.kind ??
+        (isDispatcherWithClassify(dispatcher) ? dispatcher.classify(options.need) : "llm-router");
+    // ── 2. Attenuation (if parent token given) ───────────────────────────────
+    const childId = options.childId ?? generateChildId();
+    let childToken;
+    let effectiveScope;
+    if (options.parentToken) {
+        const issued = issueChildToken(options.parentToken, options.capabilities, maxCostEur, childId);
+        if (issued.scope.actions.length === 0 && (options.capabilities?.length ?? 0) > 0) {
+            throw new DelegateAttenuationError("meshDelegate: requested capabilities are not granted by parent scope");
+        }
+        childToken = issued.token;
+        effectiveScope = issued.scope.actions;
+        // Enforce parent budget cap.
+        maxCostEur = Math.min(maxCostEur, issued.scope.budgetEur);
+    }
+    else if (options.capabilities) {
+        effectiveScope = options.capabilities;
+    }
+    // ── 3. Dispatch ──────────────────────────────────────────────────────────
+    const intent = {
+        kind,
+        need: options.need,
+        context: stringifyContext(options.context),
+        deadline_ms: deadlineMs,
+        max_cost_eur: maxCostEur,
+        toolName: options.toolName,
+        toolArgs: options.toolArgs,
+    };
+    const dispatched = await dispatcher.dispatch(intent);
+    // ── 4. Audit chain ───────────────────────────────────────────────────────
+    const parentIdForLink = options.parentToken?.parentId ?? SELF_ID;
+    const link = {
+        from: parentIdForLink,
+        to: childId,
+        scope: effectiveScope ?? [],
+        budget: maxCostEur,
+    };
+    // ── 5. Stream (best-effort, single-shot when streaming not supported) ────
+    if (options.onChunk) {
+        options.onChunk({ text: dispatched.output, done: true, agentKind: kind });
+    }
+    const result = {
+        output: dispatched.output,
+        agentKind: kind,
+        delegationChain: [link],
+        costEur: dispatched.costEur,
+        durationMs: dispatched.durationMs,
+        truncated: dispatched.truncated,
+        childToken,
+    };
+    return result;
+}
+/**
+ * Factory variant — binds a dispatcher so callers can call `delegate(opts)`
+ * without re-passing the dispatcher every time.
+ *
+ * Useful for DI in long-lived services.
+ */
+export function createMeshDelegate(dispatcher) {
+    return (options) => meshDelegate(options, dispatcher);
+}
+/**
+ * Re-export DefaultMeshDispatcher as a convenience so callers can do:
+ *
+ *     import { meshDelegate, DefaultMeshDispatcher } from "@vauban-org/agent-sdk";
+ */
+export { DefaultMeshDispatcher };
+//# sourceMappingURL=delegate.js.map

package/dist/mesh/delegate.js.map

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

package/dist/mesh/dispatcher.d.ts

@@ -0,0 +1,119 @@
+/**
+ * src/mesh/dispatcher.ts
+ *
+ * Mesh dispatcher — routes a {@link DispatchIntent} to a concrete executor
+ * (LLM, OODA, MCP tool, plugin, fallback) and returns a uniform result shape.
+ *
+ * @experimental — sprint-585. Public API may change before v1.x freeze.
+ *
+ * The dispatcher knows NOTHING about budget tokens or capability attenuation —
+ * those concerns live in `delegate.ts`. Keep this module narrowly scoped to
+ * "given an intent kind, run the right executor".
+ *
+ * Default classifier is a heuristic (no LLM call). Callers may inject their own.
+ */
+import type { MeshAgentKind } from "./types.js";
+export interface DispatchIntent {
+    /** Resolved kind — caller (or default classifier) decided which executor to use. */
+    readonly kind: MeshAgentKind;
+    /** Natural-language need. */
+    readonly need: string;
+    /** Optional context (structured data stringified, or free text). */
+    readonly context?: string;
+    /** Wall-clock deadline in ms. */
+    readonly deadline_ms?: number;
+    /** Max cost in EUR. */
+    readonly max_cost_eur?: number;
+    /** Optional MCP tool name (only used when kind === "mcp-tool"). */
+    readonly toolName?: string;
+    /** Opaque MCP tool args (only used when kind === "mcp-tool"). */
+    readonly toolArgs?: unknown;
+}
+export interface DispatchResult {
+    readonly output: string;
+    readonly costEur: number;
+    readonly durationMs: number;
+    /** True if the executor stopped on deadline before producing a final answer. */
+    readonly truncated: boolean;
+}
+export interface MeshDispatcher {
+    dispatch(intent: DispatchIntent): Promise<DispatchResult>;
+}
+/**
+ * Default heuristic classifier — zero LLM cost.
+ *
+ *  - OODA when need contains an OODA hint OR has ≥ 3 sentence-terminating marks.
+ *  - MCP-tool when need contains an MCP hint and is short (< 80 chars).
+ *  - LLM-router otherwise.
+ *
+ * Note: callers wanting LLM-based classification should inject a custom
+ * `classifier` via {@link DispatcherConfig}.
+ */
+export declare function defaultClassifier(need: string): MeshAgentKind;
+export interface DispatcherConfig {
+    /** Override the default heuristic classifier. */
+    readonly classifier?: (need: string) => MeshAgentKind;
+    /**
+     * Executor for `kind === "llm-router"`.
+     * Must respect `deadline_ms` (caller-provided).
+     */
+    readonly llmExecutor?: (prompt: string, deadlineMs: number) => Promise<string>;
+    /**
+     * Executor for `kind === "ooda"`. Receives need + optional context.
+     * Must respect `deadline_ms` (passed via 3rd arg).
+     */
+    readonly oodaExecutor?: (need: string, context: string | undefined, deadlineMs: number) => Promise<string>;
+    /**
+     * Registry of MCP tools. Keyed by tool name; values are pre-bound async fns.
+     */
+    readonly mcpTools?: Readonly<Record<string, (args: unknown) => Promise<string>>>;
+    /**
+     * Optional plugin executor (last-resort, kind === "plugin").
+     */
+    readonly pluginExecutor?: (need: string, context: string | undefined) => Promise<string>;
+    /**
+     * Fallback executor when no other kind matches. Default: echoes need.
+     */
+    readonly fallbackExecutor?: (intent: DispatchIntent) => Promise<string>;
+    /**
+     * Cost model in EUR per millisecond. Default 0 (free-tier accounting).
+     * Production: inject a model that consults `tracking/provider-usage`.
+     */
+    readonly costPerMs?: number;
+}
+/**
+ * Default dispatcher — composes injected executors into a uniform
+ * "intent → result" pipeline, including deadline enforcement and cost
+ * accounting.
+ *
+ * Concurrency notes:
+ *  - Uses `AbortController` + `setTimeout` to enforce `deadline_ms`.
+ *  - On deadline trip, returns `truncated: true` and the executor must respect
+ *    the abort signal it received via Promise.race.
+ */
+export declare class DefaultMeshDispatcher implements MeshDispatcher {
+    private readonly classifier;
+    private readonly llm;
+    private readonly ooda;
+    private readonly mcpTools;
+    private readonly plugin;
+    private readonly fallback;
+    private readonly costPerMs;
+    constructor(config?: DispatcherConfig);
+    /** Classify a need without dispatching — exposed for callers that pre-route. */
+    classify(need: string): MeshAgentKind;
+    dispatch(intent: DispatchIntent): Promise<DispatchResult>;
+    private executorFor;
+    private runWithDeadline;
+}
+export declare class DeadlineExceededError extends Error {
+    readonly name = "MeshDeadlineExceededError";
+    readonly partial?: string;
+    constructor(deadlineMs: number, partial?: string);
+}
+export declare class MeshDispatchError extends Error {
+    readonly name = "MeshDispatchError";
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/mesh/dispatcher.d.ts.map

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

package/dist/mesh/dispatcher.js

@@ -0,0 +1,207 @@
+/**
+ * src/mesh/dispatcher.ts
+ *
+ * Mesh dispatcher — routes a {@link DispatchIntent} to a concrete executor
+ * (LLM, OODA, MCP tool, plugin, fallback) and returns a uniform result shape.
+ *
+ * @experimental — sprint-585. Public API may change before v1.x freeze.
+ *
+ * The dispatcher knows NOTHING about budget tokens or capability attenuation —
+ * those concerns live in `delegate.ts`. Keep this module narrowly scoped to
+ * "given an intent kind, run the right executor".
+ *
+ * Default classifier is a heuristic (no LLM call). Callers may inject their own.
+ */
+// ─── Classifier (heuristic, no LLM) ──────────────────────────────────────────
+/**
+ * Tokens that suggest a long-running observation/audit loop → OODA.
+ * Order-stable, lowercase, word-boundary matched in {@link defaultClassifier}.
+ */
+const OODA_HINTS = [
+    "scan",
+    "audit",
+    "monitor",
+    "watch",
+    "step by step",
+    "analyze then",
+    "investigate",
+    "diagnose",
+    "post-mortem",
+];
+/**
+ * Tokens that suggest a single tool call → MCP tool dispatch.
+ */
+const MCP_HINTS = [
+    "get price",
+    "fetch",
+    "call api",
+    "lookup",
+    "read contract",
+    "check balance",
+    "get_",
+];
+/**
+ * Default heuristic classifier — zero LLM cost.
+ *
+ *  - OODA when need contains an OODA hint OR has ≥ 3 sentence-terminating marks.
+ *  - MCP-tool when need contains an MCP hint and is short (< 80 chars).
+ *  - LLM-router otherwise.
+ *
+ * Note: callers wanting LLM-based classification should inject a custom
+ * `classifier` via {@link DispatcherConfig}.
+ */
+export function defaultClassifier(need) {
+    const n = need.toLowerCase().trim();
+    if (n.length === 0)
+        return "llm-router";
+    for (const hint of OODA_HINTS) {
+        if (n.includes(hint))
+            return "ooda";
+    }
+    // 3+ sentence terminators = multi-step instruction → OODA.
+    const terminators = (n.match(/[.!?]/g) ?? []).length;
+    if (terminators >= 3)
+        return "ooda";
+    if (n.length < 80) {
+        for (const hint of MCP_HINTS) {
+            if (n.includes(hint))
+                return "mcp-tool";
+        }
+    }
+    return "llm-router";
+}
+const DEFAULT_DEADLINE_MS = 30_000;
+/**
+ * Default dispatcher — composes injected executors into a uniform
+ * "intent → result" pipeline, including deadline enforcement and cost
+ * accounting.
+ *
+ * Concurrency notes:
+ *  - Uses `AbortController` + `setTimeout` to enforce `deadline_ms`.
+ *  - On deadline trip, returns `truncated: true` and the executor must respect
+ *    the abort signal it received via Promise.race.
+ */
+export class DefaultMeshDispatcher {
+    classifier;
+    llm;
+    ooda;
+    mcpTools;
+    plugin;
+    fallback;
+    costPerMs;
+    constructor(config = {}) {
+        this.classifier = config.classifier ?? defaultClassifier;
+        this.llm =
+            config.llmExecutor ?? (async (prompt) => `[llm-router stub] ${prompt.slice(0, 200)}`);
+        this.ooda = config.oodaExecutor ?? (async (need) => `[ooda stub] ${need.slice(0, 200)}`);
+        this.mcpTools = config.mcpTools ?? {};
+        this.plugin = config.pluginExecutor ?? (async (need) => `[plugin stub] ${need.slice(0, 200)}`);
+        this.fallback = config.fallbackExecutor ?? (async (i) => `[fallback] ${i.need.slice(0, 200)}`);
+        this.costPerMs = config.costPerMs ?? 0;
+    }
+    /** Classify a need without dispatching — exposed for callers that pre-route. */
+    classify(need) {
+        return this.classifier(need);
+    }
+    async dispatch(intent) {
+        const deadlineMs = intent.deadline_ms ?? DEFAULT_DEADLINE_MS;
+        if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {
+            throw new RangeError(`DefaultMeshDispatcher.dispatch: deadline_ms must be > 0, got ${deadlineMs}`);
+        }
+        const maxCost = intent.max_cost_eur ?? Number.POSITIVE_INFINITY;
+        if (maxCost < 0) {
+            throw new RangeError(`DefaultMeshDispatcher.dispatch: max_cost_eur must be ≥ 0, got ${maxCost}`);
+        }
+        const start = performance.now();
+        const exec = this.executorFor(intent);
+        let truncated = false;
+        let output;
+        try {
+            output = await this.runWithDeadline(exec, deadlineMs);
+        }
+        catch (err) {
+            if (err instanceof DeadlineExceededError) {
+                truncated = true;
+                output = err.partial ?? "";
+            }
+            else {
+                throw err;
+            }
+        }
+        const durationMs = performance.now() - start;
+        const costEur = Math.min(maxCost, durationMs * this.costPerMs);
+        return { output, costEur, durationMs, truncated };
+    }
+    // ─── internals ─────────────────────────────────────────────────────────────
+    executorFor(intent) {
+        const deadlineMs = intent.deadline_ms ?? DEFAULT_DEADLINE_MS;
+        switch (intent.kind) {
+            case "llm-router": {
+                const prompt = intent.context
+                    ? `${intent.need}\n\n[context]\n${intent.context}`
+                    : intent.need;
+                return () => this.llm(prompt, deadlineMs);
+            }
+            case "ooda":
+                return () => this.ooda(intent.need, intent.context, deadlineMs);
+            case "mcp-tool": {
+                const name = intent.toolName;
+                if (!name) {
+                    return async () => {
+                        throw new MeshDispatchError("mcp-tool intent missing toolName", "MCP_TOOL_NAME_MISSING");
+                    };
+                }
+                const tool = this.mcpTools[name];
+                if (!tool) {
+                    return async () => {
+                        throw new MeshDispatchError(`mcp-tool "${name}" not registered`, "MCP_TOOL_NOT_FOUND");
+                    };
+                }
+                return () => tool(intent.toolArgs);
+            }
+            case "plugin":
+                return () => this.plugin(intent.need, intent.context);
+            case "fallback":
+                return () => this.fallback(intent);
+            default: {
+                const _exhaustive = intent.kind;
+                return async () => {
+                    throw new MeshDispatchError(`Unknown intent kind: ${String(_exhaustive)}`, "UNKNOWN_KIND");
+                };
+            }
+        }
+    }
+    async runWithDeadline(exec, deadlineMs) {
+        let timeoutHandle;
+        const timeout = new Promise((_, reject) => {
+            timeoutHandle = setTimeout(() => {
+                reject(new DeadlineExceededError(deadlineMs));
+            }, deadlineMs);
+        });
+        try {
+            return await Promise.race([exec(), timeout]);
+        }
+        finally {
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+        }
+    }
+}
+// ─── Errors ──────────────────────────────────────────────────────────────────
+export class DeadlineExceededError extends Error {
+    name = "MeshDeadlineExceededError";
+    partial;
+    constructor(deadlineMs, partial) {
+        super(`mesh.dispatch: deadline ${deadlineMs}ms exceeded`);
+        this.partial = partial;
+    }
+}
+export class MeshDispatchError extends Error {
+    name = "MeshDispatchError";
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/mesh/dispatcher.js.map

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

package/dist/mesh/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * src/mesh/index.ts
+ *
+ * Public barrel for the mesh.delegate() surface (sprint-585).
+ *
+ * @experimental — API may change before v1.x freeze.
+ */
+export { attenuateScope, buildToken, parseToken, scopeAllows, type AttenuatedToken, type CapabilityScope, type MeshCapabilityScope, } from "./attenuation.js";
+export { DefaultMeshDispatcher, DeadlineExceededError as MeshDeadlineExceededError, MeshDispatchError, defaultClassifier, type DispatchIntent, type DispatchResult, type DispatcherConfig, type MeshDispatcher, } from "./dispatcher.js";
+export { DelegateAttenuationError, createMeshDelegate, meshDelegate, type DelegateChunk, type DelegateOptions, type DelegateResult, } from "./delegate.js";
+export type { DelegationLink, MeshAgentKind } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mesh/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,IAAI,yBAAyB,EAClD,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/mesh/index.js

@@ -0,0 +1,11 @@
+/**
+ * src/mesh/index.ts
+ *
+ * Public barrel for the mesh.delegate() surface (sprint-585).
+ *
+ * @experimental — API may change before v1.x freeze.
+ */
+export { attenuateScope, buildToken, parseToken, scopeAllows, } from "./attenuation.js";
+export { DefaultMeshDispatcher, DeadlineExceededError as MeshDeadlineExceededError, MeshDispatchError, defaultClassifier, } from "./dispatcher.js";
+export { DelegateAttenuationError, createMeshDelegate, meshDelegate, } from "./delegate.js";
+//# sourceMappingURL=index.js.map

package/dist/mesh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,qBAAqB,IAAI,yBAAyB,EAClD,iBAAiB,EACjB,iBAAiB,GAKlB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,YAAY,GAIb,MAAM,eAAe,CAAC"}

package/dist/mesh/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * src/mesh/types.ts
+ *
+ * Shared types for mesh.delegate() and dispatcher.
+ *
+ * @experimental — sprint-585. Renamed from "AgentKind" to "MeshAgentKind" to
+ * avoid clash with `registry/agent-capability.ts::AgentKind` (which uses
+ * uppercase enum values ARCHITECT/BUILDER/...).
+ */
+/**
+ * Kind of executor selected by the dispatcher.
+ *  - `"ooda"`          : long-running Observe→Orient→Decide→Act loop
+ *  - `"llm-router"`    : single LLM call (single-shot or BoN-MAV)
+ *  - `"mcp-tool"`      : direct MCP tool invocation
+ *  - `"plugin"`        : in-process plugin executor
+ *  - `"fallback"`      : last-resort echo / static handler
+ */
+export type MeshAgentKind = "ooda" | "llm-router" | "mcp-tool" | "plugin" | "fallback";
+/** One step of the delegation chain (audit trail for capability narrowing). */
+export interface DelegationLink {
+    /** Parent / delegator agent identifier. */
+    readonly from: string;
+    /** Child / delegatee agent identifier. */
+    readonly to: string;
+    /** Scope handed down (subset of parent's scope). */
+    readonly scope: ReadonlyArray<string>;
+    /** Budget handed down in EUR. */
+    readonly budget: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mesh/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEvF,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/mesh/types.js

@@ -0,0 +1,11 @@
+/**
+ * src/mesh/types.ts
+ *
+ * Shared types for mesh.delegate() and dispatcher.
+ *
+ * @experimental — sprint-585. Renamed from "AgentKind" to "MeshAgentKind" to
+ * avoid clash with `registry/agent-capability.ts::AgentKind` (which uses
+ * uppercase enum values ARCHITECT/BUILDER/...).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mesh/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}