@vinkius-core/mcp-fusion 2.6.0 → 2.8.0

package/dist/cli/fusion.d.ts

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { type PromptBuilderLike } from '../introspection/CapabilityLockfile.js';
+/**
+ * Step status for CLI progress reporting.
+ * @internal
+ */
+export type StepStatus = 'pending' | 'running' | 'done' | 'failed';
+/**
+ * A progress step emitted during CLI operations.
+ * @internal
+ */
+export interface ProgressStep {
+    /** Step identifier */
+    readonly id: string;
+    /** Human-readable label */
+    readonly label: string;
+    /** Current status */
+    readonly status: StepStatus;
+    /** Optional detail (e.g. "12 tools, 3 prompts") */
+    readonly detail?: string;
+    /** Duration in milliseconds (set when done/failed) */
+    readonly durationMs?: number;
+}
+/**
+ * Callback that receives progress updates.
+ * Default implementation writes to stderr like Composer / Yarn.
+ * @internal
+ */
+export type ProgressReporter = (step: ProgressStep) => void;
+/**
+ * Create the default pretty-print progress reporter.
+ * Output goes to stderr so it doesn't pollute piped stdout.
+ * @internal exported for testing
+ */
+export declare function createDefaultReporter(): ProgressReporter;
+/**
+ * A progress tracker that drives step-by-step progress reporting.
+ * @internal exported for testing
+ */
+export declare class ProgressTracker {
+    private readonly reporter;
+    private startTimes;
+    constructor(reporter?: ProgressReporter);
+    /** Mark a step as running */
+    start(id: string, label: string): void;
+    /** Mark a step as completed */
+    done(id: string, label: string, detail?: string): void;
+    /** Mark a step as failed */
+    fail(id: string, label: string, detail?: string): void;
+    private elapsed;
+}
+/** @internal exported for testing */
+export declare const MCP_FUSION_VERSION = "1.1.0";
+/** @internal exported for testing */
+export declare const HELP: string;
+/** @internal exported for testing */
+export interface CliArgs {
+    command: string;
+    check: boolean;
+    server: string | undefined;
+    name: string | undefined;
+    cwd: string;
+    help: boolean;
+}
+/** @internal exported for testing */
+export declare function parseArgs(argv: string[]): CliArgs;
+/**
+ * Duck-typed interface for objects that can provide tool builders.
+ * Supports both ToolRegistry and FusionInstance.
+ */
+/** @internal exported for testing */
+export interface RegistryLike {
+    getBuilders(): Iterable<import('../core/types.js').ToolBuilder<unknown>>;
+}
+/**
+ * Duck-typed interface for objects that can provide prompt builders.
+ * Supports PromptRegistry.
+ */
+/** @internal exported for testing */
+export interface PromptRegistryLike {
+    getBuilders?(): Iterable<PromptBuilderLike>;
+}
+/**
+ * Attempt to load and resolve a tool registry from a server entrypoint.
+ *
+ * Supports common export patterns:
+ * - `export const registry = new ToolRegistry()`
+ * - `export default { registry }`
+ * - `export const fusion = initFusion()`
+ *
+ * @internal
+ */
+/** @internal exported for testing */
+export declare function resolveRegistry(serverPath: string): Promise<{
+    registry: RegistryLike;
+    name: string;
+    promptRegistry?: PromptRegistryLike;
+}>;
+/** @internal exported for testing */
+export declare function commandLock(args: CliArgs, reporter?: ProgressReporter): Promise<void>;
+//# sourceMappingURL=fusion.d.ts.map

package/dist/cli/fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../../src/cli/fusion.ts"],"names":[],"mappings":";AAuBA,OAAO,EAOH,KAAK,iBAAiB,EACzB,MAAM,wCAAwC,CAAC;AAMhD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;AAU5D;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAOxD;AAED;;;GAGG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,UAAU,CAA6B;gBAEnC,QAAQ,CAAC,EAAE,gBAAgB;IAIvC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAStD,4BAA4B;IAC5B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAStD,OAAO,CAAC,OAAO;CAMlB;AAMD,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,qCAAqC;AACrC,eAAO,MAAM,IAAI,QAiBT,CAAC;AAMT,qCAAqC;AACrC,MAAM,WAAW,OAAO;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA0CjD;AAMD;;;GAGG;AACH,qCAAqC;AACrC,MAAM,WAAW,YAAY;IACzB,WAAW,IAAI,QAAQ,CAAC,OAAO,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CAC5E;AAED;;;GAGG;AACH,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,qCAAqC;AACrC,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC,CA+DhJ;AAMD,qCAAqC;AACrC,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgF3F"}

package/dist/cli/fusion.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+/**
+ * MCP Fusion CLI — `fusion`
+ *
+ * Commands:
+ *
+ *   fusion lock [--server <entrypoint>] [--name <serverName>]
+ *       Generate or update `mcp-fusion.lock`.
+ *
+ *   fusion lock --check [--server <entrypoint>]
+ *       Verify the lockfile matches the current server.
+ *       Exits 0 if up-to-date, 1 if stale (CI gate).
+ *
+ * The lockfile captures the complete behavioral surface of your
+ * MCP Fusion server — tool contracts, cognitive guardrails,
+ * entitlements, and token economics — in a deterministic,
+ * git-diffable format.
+ *
+ * @module
+ */
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { compileContracts } from '../introspection/ToolContract.js';
+import { generateLockfile, writeLockfile, readLockfile, checkLockfile, serializeLockfile, LOCKFILE_NAME, } from '../introspection/CapabilityLockfile.js';
+/** Icon map for each step status */
+const STATUS_ICONS = {
+    pending: '○',
+    running: '◐',
+    done: '●',
+    failed: '✗',
+};
+/**
+ * Create the default pretty-print progress reporter.
+ * Output goes to stderr so it doesn't pollute piped stdout.
+ * @internal exported for testing
+ */
+export function createDefaultReporter() {
+    return (step) => {
+        const icon = STATUS_ICONS[step.status];
+        const timing = step.durationMs !== undefined ? ` (${step.durationMs}ms)` : '';
+        const detail = step.detail ? ` — ${step.detail}` : '';
+        process.stderr.write(`  ${icon} ${step.label}${detail}${timing}\n`);
+    };
+}
+/**
+ * A progress tracker that drives step-by-step progress reporting.
+ * @internal exported for testing
+ */
+export class ProgressTracker {
+    reporter;
+    startTimes = new Map();
+    constructor(reporter) {
+        this.reporter = reporter ?? createDefaultReporter();
+    }
+    /** Mark a step as running */
+    start(id, label) {
+        this.startTimes.set(id, Date.now());
+        this.reporter({ id, label, status: 'running' });
+    }
+    /** Mark a step as completed */
+    done(id, label, detail) {
+        const durationMs = this.elapsed(id);
+        this.reporter({
+            id, label, status: 'done',
+            ...(detail !== undefined ? { detail } : {}),
+            ...(durationMs !== undefined ? { durationMs } : {}),
+        });
+    }
+    /** Mark a step as failed */
+    fail(id, label, detail) {
+        const durationMs = this.elapsed(id);
+        this.reporter({
+            id, label, status: 'failed',
+            ...(detail !== undefined ? { detail } : {}),
+            ...(durationMs !== undefined ? { durationMs } : {}),
+        });
+    }
+    elapsed(id) {
+        const start = this.startTimes.get(id);
+        if (start === undefined)
+            return undefined;
+        this.startTimes.delete(id);
+        return Date.now() - start;
+    }
+}
+// ============================================================================
+// Constants
+// ============================================================================
+/** @internal exported for testing */
+export const MCP_FUSION_VERSION = '1.1.0';
+/** @internal exported for testing */
+export const HELP = `
+fusion — MCP Fusion Capability Lockfile CLI
+
+USAGE
+  fusion lock                         Generate or update ${LOCKFILE_NAME}
+  fusion lock --check                 Verify lockfile is up to date (CI gate)
+
+OPTIONS
+  --server, -s <path>     Path to server entrypoint (default: auto-discover)
+  --name, -n <name>       Server name for lockfile header
+  --cwd <dir>             Project root directory (default: process.cwd())
+  --help, -h              Show this help message
+
+EXAMPLES
+  fusion lock
+  fusion lock --check
+  fusion lock --server ./src/server.ts --name my-server
+`.trim();
+/** @internal exported for testing */
+export function parseArgs(argv) {
+    const args = argv.slice(2);
+    const result = {
+        command: '',
+        check: false,
+        server: undefined,
+        name: undefined,
+        cwd: process.cwd(),
+        help: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case 'lock':
+                result.command = 'lock';
+                break;
+            case '--check':
+                result.check = true;
+                break;
+            case '-s':
+            case '--server':
+                result.server = args[++i];
+                break;
+            case '-n':
+            case '--name':
+                result.name = args[++i];
+                break;
+            case '--cwd':
+                result.cwd = args[++i] ?? process.cwd();
+                break;
+            case '-h':
+            case '--help':
+                result.help = true;
+                break;
+            default:
+                if (!result.command)
+                    result.command = arg;
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Attempt to load and resolve a tool registry from a server entrypoint.
+ *
+ * Supports common export patterns:
+ * - `export const registry = new ToolRegistry()`
+ * - `export default { registry }`
+ * - `export const fusion = initFusion()`
+ *
+ * @internal
+ */
+/** @internal exported for testing */
+export async function resolveRegistry(serverPath) {
+    const absolutePath = resolve(serverPath);
+    const fileUrl = pathToFileURL(absolutePath).href;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const mod = await import(fileUrl);
+    /** Extract prompt registry from a module-like object */
+    function extractPrompts(obj) {
+        // Look for promptRegistry, prompts, or promptsRegistry
+        for (const key of ['promptRegistry', 'prompts', 'promptsRegistry']) {
+            const candidate = obj[key];
+            if (candidate && typeof candidate === 'object' && candidate !== null) {
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    // Strategy 1: Named `registry` export (ToolRegistry pattern)
+    if (mod.registry && typeof mod.registry.getBuilders === 'function') {
+        const pr = extractPrompts(mod);
+        return {
+            registry: mod.registry,
+            name: mod.serverName ?? 'mcp-fusion-server',
+            ...(pr ? { promptRegistry: pr } : {}),
+        };
+    }
+    // Strategy 2: Named `fusion` export (initFusion pattern)
+    if (mod.fusion && mod.fusion.registry && typeof mod.fusion.registry.getBuilders === 'function') {
+        const pr = extractPrompts(mod.fusion);
+        return {
+            registry: mod.fusion.registry,
+            name: mod.fusion.name ?? 'mcp-fusion-server',
+            ...(pr ? { promptRegistry: pr } : {}),
+        };
+    }
+    // Strategy 3: Default export with registry
+    if (mod.default) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
+        const def = mod.default;
+        if (def.registry && typeof def.registry.getBuilders === 'function') {
+            const pr = extractPrompts(def);
+            return {
+                registry: def.registry,
+                name: def.serverName ?? 'mcp-fusion-server',
+                ...(pr ? { promptRegistry: pr } : {}),
+            };
+        }
+        if (typeof def.getBuilders === 'function') {
+            return { registry: def, name: 'mcp-fusion-server' };
+        }
+    }
+    throw new Error(`Could not resolve a ToolRegistry from "${serverPath}".\n` +
+        `Expected one of:\n` +
+        `  export const registry = new ToolRegistry()  // named 'registry' with getBuilders()\n` +
+        `  export const fusion = initFusion()           // named 'fusion' with .registry\n` +
+        `  export default { registry }                  // default export with .registry`);
+}
+// ============================================================================
+// Commands
+// ============================================================================
+/** @internal exported for testing */
+export async function commandLock(args, reporter) {
+    const progress = new ProgressTracker(reporter);
+    if (!args.server) {
+        console.error('Error: --server <path> is required.\n');
+        console.error('Usage: fusion lock --server ./src/server.ts');
+        process.exit(1);
+    }
+    const mode = args.check ? 'Verifying' : 'Generating';
+    process.stderr.write(`\n  fusion lock — ${mode} ${LOCKFILE_NAME}\n\n`);
+    // Step 1: Resolve registry
+    progress.start('resolve', 'Resolving server entrypoint');
+    const { registry, name, promptRegistry } = await resolveRegistry(args.server);
+    const serverName = args.name ?? name;
+    progress.done('resolve', 'Resolving server entrypoint', serverName);
+    // Step 2: Compile tool contracts
+    progress.start('compile', 'Compiling tool contracts');
+    const builders = [...registry.getBuilders()];
+    const contracts = compileContracts(builders);
+    const toolCount = Object.keys(contracts).length;
+    progress.done('compile', 'Compiling tool contracts', `${toolCount} tool${toolCount !== 1 ? 's' : ''}`);
+    // Step 3: Discover prompts
+    progress.start('prompts', 'Discovering prompts');
+    const promptBuilders = [];
+    if (promptRegistry && typeof promptRegistry.getBuilders === 'function') {
+        promptBuilders.push(...promptRegistry.getBuilders());
+    }
+    const options = promptBuilders.length > 0 ? { prompts: promptBuilders } : undefined;
+    const promptCount = promptBuilders.length;
+    progress.done('prompts', 'Discovering prompts', `${promptCount} prompt${promptCount !== 1 ? 's' : ''}`);
+    if (args.check) {
+        // ── Check Mode ──
+        progress.start('read', 'Reading existing lockfile');
+        const existing = await readLockfile(args.cwd);
+        if (!existing) {
+            progress.fail('read', 'Reading existing lockfile', 'not found');
+            console.error(`\n✗ No ${LOCKFILE_NAME} found. Run \`fusion lock\` to generate.`);
+            process.exit(1);
+        }
+        progress.done('read', 'Reading existing lockfile');
+        progress.start('verify', 'Verifying integrity');
+        const result = checkLockfile(existing, contracts, options);
+        if (result.ok) {
+            progress.done('verify', 'Verifying integrity', 'up to date');
+            console.log(`\n✓ ${LOCKFILE_NAME} is up to date.`);
+            process.exit(0);
+        }
+        else {
+            progress.fail('verify', 'Verifying integrity', 'stale');
+            console.error(`\n✗ ${result.message}`);
+            if (result.added.length > 0)
+                console.error(`  + Tools added: ${result.added.join(', ')}`);
+            if (result.removed.length > 0)
+                console.error(`  - Tools removed: ${result.removed.join(', ')}`);
+            if (result.changed.length > 0)
+                console.error(`  ~ Tools changed: ${result.changed.join(', ')}`);
+            if (result.addedPrompts.length > 0)
+                console.error(`  + Prompts added: ${result.addedPrompts.join(', ')}`);
+            if (result.removedPrompts.length > 0)
+                console.error(`  - Prompts removed: ${result.removedPrompts.join(', ')}`);
+            if (result.changedPrompts.length > 0)
+                console.error(`  ~ Prompts changed: ${result.changedPrompts.join(', ')}`);
+            process.exit(1);
+        }
+    }
+    else {
+        // ── Generate Mode ──
+        progress.start('generate', 'Computing behavioral digests');
+        const lockfile = generateLockfile(serverName, contracts, MCP_FUSION_VERSION, options);
+        progress.done('generate', 'Computing behavioral digests');
+        progress.start('write', `Writing ${LOCKFILE_NAME}`);
+        await writeLockfile(lockfile, args.cwd);
+        progress.done('write', `Writing ${LOCKFILE_NAME}`);
+        const tc = Object.keys(lockfile.capabilities.tools).length;
+        const pc = Object.keys(lockfile.capabilities.prompts ?? {}).length;
+        const parts = [`${tc} tool${tc !== 1 ? 's' : ''}`];
+        if (pc > 0)
+            parts.push(`${pc} prompt${pc !== 1 ? 's' : ''}`);
+        console.log(`\n✓ ${LOCKFILE_NAME} generated (${parts.join(', ')}).`);
+        console.log(`  Integrity: ${lockfile.integrityDigest}`);
+    }
+}
+// ============================================================================
+// Entry Point
+// ============================================================================
+async function main() {
+    const args = parseArgs(process.argv);
+    if (args.help || !args.command) {
+        console.log(HELP);
+        process.exit(args.help ? 0 : 1);
+    }
+    switch (args.command) {
+        case 'lock':
+            await commandLock(args);
+            break;
+        default:
+            console.error(`Unknown command: "${args.command}"\n`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+/* c8 ignore next 6 — CLI entry-point guard */
+const isCLI = typeof process !== 'undefined' &&
+    process.argv[1]?.endsWith('fusion') || process.argv[1]?.endsWith('fusion.js');
+if (isCLI) {
+    main().catch((err) => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=fusion.js.map

package/dist/cli/fusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fusion.js","sourceRoot":"","sources":["../../src/cli/fusion.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,GAEhB,MAAM,wCAAwC,CAAC;AAoChD,oCAAoC;AACpC,MAAM,YAAY,GAA+B;IAC7C,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACjC,OAAO,CAAC,IAAkB,EAAQ,EAAE;QAChC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;IACxE,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,eAAe;IACP,QAAQ,CAAmB;IACpC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,YAAY,QAA2B;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,qBAAqB,EAAE,CAAC;IACxD,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,EAAU,EAAE,KAAa;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,EAAU,EAAE,KAAa,EAAE,MAAe;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC;YACV,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;YACzB,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACP,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,EAAU,EAAE,KAAa,EAAE,MAAe;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC;YACV,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ;YAC3B,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;IACP,CAAC;IAEO,OAAO,CAAC,EAAU;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAC9B,CAAC;CACJ;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;;;;2DAIuC,aAAa;;;;;;;;;;;;;CAavE,CAAC,IAAI,EAAE,CAAC;AAgBT,qCAAqC;AACrC,MAAM,UAAU,SAAS,CAAC,IAAc;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAY;QACpB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,EAAE,KAAK;KACd,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,QAAQ,GAAG,EAAE,CAAC;YACV,KAAK,MAAM;gBACP,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;gBACxB,MAAM;YACV,KAAK,SAAS;gBACV,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,UAAU;gBACX,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,MAAM;YACV,KAAK,OAAO;gBACR,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACxC,MAAM;YACV,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM;YACV;gBACI,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;gBAC1C,MAAM;QACd,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAwBD;;;;;;;;;GASG;AACH,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;IAEjD,mEAAmE;IACnE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAElC,wDAAwD;IACxD,SAAS,cAAc,CAAC,GAA4B;QAChD,uDAAuD;QACvD,KAAK,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACjE,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACnE,OAAO,SAA+B,CAAC;YAC3C,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,6DAA6D;IAC7D,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACjE,MAAM,EAAE,GAAG,cAAc,CAAC,GAA8B,CAAC,CAAC;QAC1D,OAAO;YACH,QAAQ,EAAE,GAAG,CAAC,QAAwB;YACtC,IAAI,EAAE,GAAG,CAAC,UAAU,IAAI,mBAAmB;YAC3C,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;IACN,CAAC;IAED,yDAAyD;IACzD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC7F,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,MAAiC,CAAC,CAAC;QACjE,OAAO;YACH,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAwB;YAC7C,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,mBAAmB;YAC5C,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;IACN,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACd,+GAA+G;QAC/G,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;QACxB,IAAI,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACjE,MAAM,EAAE,GAAG,cAAc,CAAC,GAA8B,CAAC,CAAC;YAC1D,OAAO;gBACH,QAAQ,EAAE,GAAG,CAAC,QAAwB;gBACtC,IAAI,EAAG,GAAG,CAAC,UAAqB,IAAI,mBAAmB;gBACvD,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,CAAC;QACN,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YACxC,OAAO,EAAE,QAAQ,EAAE,GAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;QACxE,CAAC;IACL,CAAC;IAED,MAAM,IAAI,KAAK,CACX,0CAA0C,UAAU,MAAM;QAC1D,oBAAoB;QACpB,wFAAwF;QACxF,mFAAmF;QACnF,iFAAiF,CACpF,CAAC;AACN,CAAC;AAED,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAa,EAAE,QAA2B;IACxE,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,IAAI,IAAI,aAAa,MAAM,CAAC,CAAC;IAEvE,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;IACzD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,6BAA6B,EAAE,UAAU,CAAC,CAAC;IAEpE,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,EAAE,GAAG,SAAS,QAAQ,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvG,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACjD,MAAM,cAAc,GAAwB,EAAE,CAAC;IAC/C,IAAI,cAAc,IAAI,OAAO,cAAc,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACrE,cAAc,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,WAAW,UAAU,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAExG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,mBAAmB;QACnB,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,2BAA2B,EAAE,WAAW,CAAC,CAAC;YAChE,OAAO,CAAC,KAAK,CAAC,UAAU,aAAa,0CAA0C,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;QAEnD,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,EAAE,YAAY,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,aAAa,iBAAiB,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1F,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChG,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1G,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChH,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,sBAAsB;QACtB,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACtF,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,8BAA8B,CAAC,CAAC;QAE1D,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,aAAa,EAAE,CAAC,CAAC;QACpD,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,aAAa,EAAE,CAAC,CAAC;QAEnD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACnE,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,EAAE,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,aAAa,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5D,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,MAAM;YACP,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACV;YACI,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;AACL,CAAC;AAED,8CAA8C;AAC9C,MAAM,KAAK,GACP,OAAO,OAAO,KAAK,WAAW;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;AAClF,IAAI,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/client/FusionClient.d.ts

@@ -50,6 +50,84 @@ export interface FusionTransport {
  * ```
  */
 export type RouterMap = Record<string, Record<string, unknown>>;
+/**
+ * Client-side middleware for request/response interception.
+ *
+ * Follows the same onion model as server-side middleware:
+ * each middleware wraps the next, forming a pipeline.
+ *
+ * Use cases: authentication injection, request logging,
+ * retry logic, timeout enforcement, response transformation.
+ *
+ * @example
+ * ```typescript
+ * const authMiddleware: ClientMiddleware = async (action, args, next) => {
+ *     const enrichedArgs = { ...args, _token: getToken() };
+ *     return next(action, enrichedArgs);
+ * };
+ *
+ * const retryMiddleware: ClientMiddleware = async (action, args, next) => {
+ *     for (let i = 0; i < 3; i++) {
+ *         const result = await next(action, args);
+ *         if (!result.isError) return result;
+ *     }
+ *     return next(action, args);
+ * };
+ * ```
+ */
+export type ClientMiddleware = (action: string, args: Record<string, unknown>, next: (action: string, args: Record<string, unknown>) => Promise<ToolResponse>) => Promise<ToolResponse>;
+/**
+ * Structured error parsed from a `<tool_error>` XML envelope.
+ *
+ * Provides typed access to self-healing fields so client code
+ * can programmatically react to server errors without regex parsing.
+ */
+export declare class FusionClientError extends Error {
+    /** Error code from the `code` attribute (e.g. `'NOT_FOUND'`). */
+    readonly code: string;
+    /** Recovery suggestion from `<recovery>` element. */
+    readonly recovery?: string | undefined;
+    /** Available actions from `<available_actions>` children. */
+    readonly availableActions: readonly string[];
+    /** Error severity from the `severity` attribute. */
+    readonly severity: string;
+    /** Raw ToolResponse that caused the error. */
+    readonly raw: ToolResponse;
+    constructor(message: string, code: string, raw: ToolResponse, options?: {
+        recovery?: string | undefined;
+        availableActions?: string[] | undefined;
+        severity?: string | undefined;
+    });
+}
+/**
+ * Options for creating a FusionClient.
+ */
+export interface FusionClientOptions {
+    /**
+     * Client-side middleware pipeline.
+     *
+     * Middleware execute in registration order (first = outermost).
+     * Each middleware can modify the request, response, or both.
+     *
+     * @example
+     * ```typescript
+     * const client = createFusionClient<AppRouter>(transport, {
+     *     middleware: [authMiddleware, loggingMiddleware],
+     * });
+     * ```
+     */
+    middleware?: ClientMiddleware[];
+    /**
+     * When `true`, `execute()` throws a {@link FusionClientError}
+     * for responses with `isError: true`.
+     *
+     * When `false` (default), error responses are returned normally
+     * and the caller must check `result.isError`.
+     *
+     * @default false
+     */
+    throwOnError?: boolean;
+}
 /**
  * Type-safe client that provides autocomplete and compile-time
  * validation for MCP tool calls.
@@ -65,6 +143,32 @@ export interface FusionClient<TRouter extends RouterMap> {
      * @returns The tool response
      */
     execute<TAction extends keyof TRouter & string>(action: TAction, args: TRouter[TAction]): Promise<ToolResponse>;
+    /**
+     * Execute multiple tool actions concurrently.
+     *
+     * All calls run in parallel via `Promise.all`.
+     * Use `{ sequential: true }` for ordered execution.
+     *
+     * @param calls - Array of `{ action, args }` objects
+     * @param options - Optional execution mode
+     * @returns Array of tool responses, one per call
+     *
+     * @example
+     * ```typescript
+     * const results = await client.executeBatch([
+     *     { action: 'projects.list', args: { workspace_id: 'ws_1' } },
+     *     { action: 'billing.balance', args: { account_id: 'acc_1' } },
+     * ]);
+     * ```
+     */
+    executeBatch<TActions extends ReadonlyArray<keyof TRouter & string>>(calls: {
+        [K in keyof TActions]: {
+            action: TActions[K];
+            args: TRouter[TActions[K] & keyof TRouter];
+        };
+    }, options?: {
+        sequential?: boolean | undefined;
+    } | undefined): Promise<ToolResponse[]>;
 }
 /**
  * Create a type-safe MCP client.
@@ -75,6 +179,7 @@ export interface FusionClient<TRouter extends RouterMap> {
  *
  * @typeParam TRouter - The router map (use `InferRouter<typeof registry>`)
  * @param transport - The MCP transport layer
+ * @param options - Client options (middleware, error handling)
  * @returns A typed {@link FusionClient}
  *
  * @example
@@ -92,6 +197,22 @@ export interface FusionClient<TRouter extends RouterMap> {
  * // TS error: missing required arg 'name'
  * await client.execute('projects.create', {});
  * ```
+ *
+ * @example
+ * ```typescript
+ * // With client middleware and throwOnError
+ * const client = createFusionClient<AppRouter>(transport, {
+ *     throwOnError: true,
+ *     middleware: [
+ *         async (action, args, next) => {
+ *             console.log(`[Client] calling ${action}`);
+ *             const result = await next(action, args);
+ *             console.log(`[Client] ${action} done`);
+ *             return result;
+ *         },
+ *     ],
+ * });
+ * ```
  */
-export declare function createFusionClient<TRouter extends RouterMap>(transport: FusionTransport): FusionClient<TRouter>;
+export declare function createFusionClient<TRouter extends RouterMap>(transport: FusionTransport, options?: FusionClientOptions): FusionClient<TRouter>;
 //# sourceMappingURL=FusionClient.d.ts.map

package/dist/client/FusionClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FusionClient.d.ts","sourceRoot":"","sources":["../../src/client/FusionClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAChF;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,SAAS;IACnD;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,SAAS,MAAM,OAAO,GAAG,MAAM,EAC1C,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GACvB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,SAAS,EACxD,SAAS,EAAE,eAAe,GAC3B,YAAY,CAAC,OAAO,CAAC,CAqBvB"}
+{"version":3,"file":"FusionClient.d.ts","sourceRoot":"","sources":["../../src/client/FusionClient.ts"],"names":[],"mappings":"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"}