@a5c-ai/tools-adapter 5.1.1-staging.0ad6ac75ae4a

package/dist/dispatch.d.ts

@@ -0,0 +1,43 @@
+import type { ToolCallContext, ToolCallResult, ToolDescriptor, ToolDispatchPolicy, ToolDispatchRule, ToolExecutionPolicy, ToolExecutionLimits } from './types.js';
+import type { ToolHookBridge } from './hooks.js';
+import type { ToolRegistry } from './registry.js';
+export type ToolExecutor = (tool: ToolDescriptor, context: ToolCallContext) => Promise<unknown>;
+export interface ToolDispatcherOptions {
+    registry: ToolRegistry;
+    policy?: ToolDispatchPolicy;
+    executionPolicy?: ToolExecutionPolicy;
+    hooks?: ToolHookBridge;
+}
+/**
+ * Resolves a tool call to the correct server using policy rules,
+ * runs before/after hooks, and delegates actual execution to a
+ * caller-supplied executor.
+ */
+export declare class ToolDispatcher {
+    private readonly registry;
+    private readonly policy;
+    private readonly executionPolicy;
+    private readonly hooks;
+    constructor(options: ToolDispatcherOptions);
+    /** Set or replace the full dispatch policy. */
+    setPolicy(policy: ToolDispatchPolicy): void;
+    /** Add a single dispatch rule. */
+    addRule(rule: ToolDispatchRule): void;
+    /**
+     * Walk the policy rules (already sorted by priority) and return the
+     * first matching server id, falling back to the tool's own server
+     * field, then the policy default.
+     */
+    resolveServer(toolName: string): string | undefined;
+    getExecutionLimits(toolName: string): ToolExecutionLimits;
+    /**
+     * Full dispatch lifecycle:
+     *   1. Resolve descriptor + server
+     *   2. beforeToolUse hook
+     *   3. Execute via supplied executor
+     *   4. afterToolUse hook
+     *   5. Return result
+     */
+    dispatch(context: ToolCallContext, executor: ToolExecutor): Promise<ToolCallResult>;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAyBlD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;gBAEvC,OAAO,EAAE,qBAAqB;IAc1C,+CAA+C;IAC/C,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAK3C,kCAAkC;IAClC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAUrC;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgBnD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAazD;;;;;;;OAOG;IACG,QAAQ,CACZ,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC;CAqD3B"}

package/dist/dispatch.js

@@ -0,0 +1,157 @@
+import { ToolExecutionError, serializeToolError } from './types.js';
+/* ------------------------------------------------------------------ */
+/*  Minimal glob matcher (no external deps)                            */
+/* ------------------------------------------------------------------ */
+/**
+ * Convert a simple glob pattern (supporting `*` and `?`) into a RegExp.
+ *
+ * This intentionally does NOT support `**`, brace expansion, or
+ * character classes — tool names are flat identifiers, so `*` for
+ * "any chars" and `?` for "single char" is sufficient.
+ */
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Resolves a tool call to the correct server using policy rules,
+ * runs before/after hooks, and delegates actual execution to a
+ * caller-supplied executor.
+ */
+export class ToolDispatcher {
+    registry;
+    policy;
+    executionPolicy;
+    hooks;
+    constructor(options) {
+        this.registry = options.registry;
+        this.policy = options.policy ?? { rules: [] };
+        this.executionPolicy = options.executionPolicy ?? {
+            defaultTimeoutMs: 120_000,
+            defaultMaxOutputBytes: 50 * 1024 * 1024,
+        };
+        this.hooks = options.hooks;
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Policy helpers                                                   */
+    /* ---------------------------------------------------------------- */
+    /** Set or replace the full dispatch policy. */
+    setPolicy(policy) {
+        this.policy.rules = policy.rules;
+        this.policy.defaultServer = policy.defaultServer;
+    }
+    /** Add a single dispatch rule. */
+    addRule(rule) {
+        this.policy.rules.push(rule);
+        // Keep rules sorted by descending priority so resolution is stable.
+        this.policy.rules.sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Resolution                                                       */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Walk the policy rules (already sorted by priority) and return the
+     * first matching server id, falling back to the tool's own server
+     * field, then the policy default.
+     */
+    resolveServer(toolName) {
+        for (const rule of this.policy.rules) {
+            if (globToRegex(rule.match).test(toolName)) {
+                return rule.server;
+            }
+        }
+        // Fall back to the descriptor's own server association.
+        const descriptor = this.registry.get(toolName);
+        if (descriptor?.server) {
+            return descriptor.server;
+        }
+        return this.policy.defaultServer;
+    }
+    getExecutionLimits(toolName) {
+        const perTool = this.executionPolicy.perTool?.[toolName] ?? {};
+        return {
+            timeoutMs: perTool.timeoutMs ?? this.executionPolicy.defaultTimeoutMs,
+            maxOutputBytes: perTool.maxOutputBytes ?? this.executionPolicy.defaultMaxOutputBytes,
+            ...(perTool.maxEvents !== undefined ? { maxEvents: perTool.maxEvents } : {}),
+        };
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Dispatch                                                         */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Full dispatch lifecycle:
+     *   1. Resolve descriptor + server
+     *   2. beforeToolUse hook
+     *   3. Execute via supplied executor
+     *   4. afterToolUse hook
+     *   5. Return result
+     */
+    async dispatch(context, executor) {
+        const descriptor = this.registry.get(context.toolName);
+        if (!descriptor) {
+            return {
+                output: null,
+                durationMs: 0,
+                error: `Tool not found: ${context.toolName}`,
+            };
+        }
+        let effectiveContext = context;
+        // --- before hook ---
+        if (this.hooks) {
+            const hookResult = await this.hooks.beforeToolUse(context, descriptor);
+            if (hookResult?.decision === 'deny') {
+                return {
+                    output: null,
+                    durationMs: 0,
+                    error: hookResult.reason ?? 'Tool use denied by hook',
+                };
+            }
+            if (hookResult?.toolMutation) {
+                effectiveContext = {
+                    ...context,
+                    input: applyToolMutation(context.input, hookResult.toolMutation),
+                };
+            }
+        }
+        // --- execute ---
+        const start = Date.now();
+        let output;
+        let error;
+        try {
+            output = await executor(descriptor, effectiveContext);
+        }
+        catch (err) {
+            error = err instanceof ToolExecutionError
+                ? serializeToolError(err)
+                : err instanceof Error ? err.message : String(err);
+        }
+        const durationMs = Date.now() - start;
+        const result = { output, durationMs, error };
+        // --- after hook ---
+        if (this.hooks) {
+            await this.hooks.afterToolUse(effectiveContext, descriptor, result);
+        }
+        return result;
+    }
+}
+function applyToolMutation(input, mutation) {
+    if (mutation.mode === 'replace') {
+        return mutation.value;
+    }
+    if (input &&
+        typeof input === 'object' &&
+        !Array.isArray(input) &&
+        mutation.value &&
+        typeof mutation.value === 'object' &&
+        !Array.isArray(mutation.value)) {
+        return {
+            ...input,
+            ...mutation.value,
+        };
+    }
+    return mutation.value;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAapE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AACpC,CAAC;AAkBD;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,CAAe;IACvB,MAAM,CAAqB;IAC3B,eAAe,CAAsB;IACrC,KAAK,CAA6B;IAEnD,YAAY,OAA8B;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI;YAChD,gBAAgB,EAAE,OAAO;YACzB,qBAAqB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SACxC,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE,+CAA+C;IAC/C,SAAS,CAAC,MAA0B;QAClC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;IACnD,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,IAAsB;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,oEAAoE;QACpE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE;;;;OAIG;IACH,aAAa,CAAC,QAAgB;QAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3C,OAAO,IAAI,CAAC,MAAM,CAAC;YACrB,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,UAAU,EAAE,MAAM,EAAE,CAAC;YACvB,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACnC,CAAC;IAED,kBAAkB,CAAC,QAAgB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,gBAAgB;YACrE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,CAAC,qBAAqB;YACpF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAwB,EACxB,QAAsB;QAEtB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,CAAC;gBACb,KAAK,EAAE,mBAAmB,OAAO,CAAC,QAAQ,EAAE;aAC7C,CAAC;QACJ,CAAC;QAED,IAAI,gBAAgB,GAAG,OAAO,CAAC;QAE/B,sBAAsB;QACtB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACvE,IAAI,UAAU,EAAE,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACpC,OAAO;oBACL,MAAM,EAAE,IAAI;oBACZ,UAAU,EAAE,CAAC;oBACb,KAAK,EAAE,UAAU,CAAC,MAAM,IAAI,yBAAyB;iBACtD,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,EAAE,YAAY,EAAE,CAAC;gBAC7B,gBAAgB,GAAG;oBACjB,GAAG,OAAO;oBACV,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC;iBACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,MAAe,CAAC;QACpB,IAAI,KAA8B,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,KAAK,GAAG,GAAG,YAAY,kBAAkB;gBACvC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC;gBACzB,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,MAAM,GAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAE7D,qBAAqB;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,SAAS,iBAAiB,CACxB,KAAc,EACd,QAAuD;IAEvD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,KAAK,CAAC;IACxB,CAAC;IACD,IACE,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,QAAQ,CAAC,KAAK;QACd,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAClC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC9B,CAAC;QACD,OAAO;YACL,GAAI,KAAiC;YACrC,GAAI,QAAQ,CAAC,KAAiC;SAC/C,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Tool hook bridge implementations.
+ *
+ * The bridge contract keeps tools-adapter independent from a concrete hooks-adapter
+ * package instance while allowing callers to pass a hooks-adapter-compatible engine.
+ */
+import type { ToolCallContext, ToolCallResult, ToolDescriptor } from './types.js';
+export interface ToolHookResult {
+    decision?: 'allow' | 'deny' | 'ask' | 'continue' | 'noop';
+    reason?: string;
+    toolMutation?: {
+        mode: 'replace' | 'patch';
+        value: unknown;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface ToolHookBridge {
+    /**
+     * Invoked immediately before a tool is executed.
+     * Returning a result with `decision: 'deny'` will short-circuit
+     * execution and surface the denial reason to the caller.
+     */
+    beforeToolUse(context: ToolCallContext, descriptor: ToolDescriptor): Promise<ToolHookResult | undefined>;
+    /**
+     * Invoked immediately after a tool finishes (success or failure).
+     * The result is informational — the hook cannot retroactively
+     * block the call, but it can record telemetry, mutate state, etc.
+     */
+    afterToolUse(context: ToolCallContext, descriptor: ToolDescriptor, result: ToolCallResult): Promise<ToolHookResult | undefined>;
+}
+export interface HooksMuxLikeResult {
+    decision?: 'allow' | 'deny' | 'block' | 'retry' | 'ask' | 'defer' | 'continue' | 'noop';
+    reason?: string;
+    toolMutation?: {
+        mode: 'replace' | 'patch';
+        value: unknown;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface HooksMuxLikeEngineResult {
+    mergedResult?: HooksMuxLikeResult;
+    result?: HooksMuxLikeResult;
+}
+export interface HooksMuxLikeEngine {
+    processNormalizedEvent(event: HooksMuxToolEvent): Promise<HooksMuxLikeEngineResult> | HooksMuxLikeEngineResult;
+}
+export interface HooksMuxToolHookBridgeOptions {
+    engine: HooksMuxLikeEngine;
+    adapter?: string;
+    env?: {
+        input?: Record<string, string>;
+        persisted?: Record<string, string>;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface HooksMuxToolEvent {
+    version: 'a5c.hooks.v1';
+    adapter: string;
+    phase: 'tool.before' | 'tool.after';
+    rawEventName: 'PreToolUse' | 'PostToolUse';
+    supportLevel: 'native';
+    execution: {
+        sessionId: string | null;
+        nativeEventName: 'PreToolUse' | 'PostToolUse';
+        adapter: string;
+        toolName: string;
+        toolCallId?: string | null;
+        source?: string | null;
+        metadata: Record<string, unknown>;
+        persistedEnv: Record<string, string>;
+        contextVars: Record<string, string>;
+    };
+    payload: Record<string, unknown>;
+    env: {
+        input: Record<string, string>;
+        persisted: Record<string, string>;
+    };
+    raw: unknown;
+}
+/**
+ * A bridge that does nothing — hooks are allowed to be absent.
+ * Swap this out for a real hooks-adapter adapter when integrating.
+ */
+export declare class NoopToolHookBridge implements ToolHookBridge {
+    beforeToolUse(_context: ToolCallContext, _descriptor: ToolDescriptor): Promise<ToolHookResult | undefined>;
+    afterToolUse(_context: ToolCallContext, _descriptor: ToolDescriptor, _result: ToolCallResult): Promise<ToolHookResult | undefined>;
+}
+export declare class HooksMuxToolHookBridge implements ToolHookBridge {
+    private readonly engine;
+    private readonly adapter;
+    private readonly env;
+    private readonly metadata;
+    constructor(options: HooksMuxToolHookBridgeOptions);
+    beforeToolUse(context: ToolCallContext, descriptor: ToolDescriptor): Promise<ToolHookResult | undefined>;
+    afterToolUse(context: ToolCallContext, descriptor: ToolDescriptor, result: ToolCallResult): Promise<ToolHookResult | undefined>;
+    private processToolEvent;
+    private buildEvent;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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

package/dist/hooks.js

@@ -0,0 +1,110 @@
+/**
+ * Tool hook bridge implementations.
+ *
+ * The bridge contract keeps tools-adapter independent from a concrete hooks-adapter
+ * package instance while allowing callers to pass a hooks-adapter-compatible engine.
+ */
+/* ------------------------------------------------------------------ */
+/*  No-op implementation                                               */
+/* ------------------------------------------------------------------ */
+/**
+ * A bridge that does nothing — hooks are allowed to be absent.
+ * Swap this out for a real hooks-adapter adapter when integrating.
+ */
+export class NoopToolHookBridge {
+    async beforeToolUse(_context, _descriptor) {
+        return undefined;
+    }
+    async afterToolUse(_context, _descriptor, _result) {
+        return undefined;
+    }
+}
+export class HooksMuxToolHookBridge {
+    engine;
+    adapter;
+    env;
+    metadata;
+    constructor(options) {
+        this.engine = options.engine;
+        this.adapter = options.adapter ?? 'tools-adapter';
+        this.env = {
+            input: options.env?.input ?? {},
+            persisted: options.env?.persisted ?? {},
+        };
+        this.metadata = options.metadata ?? {};
+    }
+    async beforeToolUse(context, descriptor) {
+        return this.processToolEvent('tool.before', 'PreToolUse', context, descriptor);
+    }
+    async afterToolUse(context, descriptor, result) {
+        return this.processToolEvent('tool.after', 'PostToolUse', context, descriptor, result);
+    }
+    async processToolEvent(phase, rawEventName, context, descriptor, result) {
+        const event = this.buildEvent(phase, rawEventName, context, descriptor, result);
+        const engineResult = await this.engine.processNormalizedEvent(event);
+        return normalizeHookResult(engineResult.mergedResult ?? engineResult.result);
+    }
+    buildEvent(phase, rawEventName, context, descriptor, result) {
+        const payload = {
+            toolName: context.toolName,
+            input: context.input,
+            descriptor,
+            caller: context.caller,
+            runId: context.runId,
+            sessionId: context.sessionId,
+        };
+        if (result) {
+            payload.result = result;
+        }
+        return {
+            version: 'a5c.hooks.v1',
+            adapter: this.adapter,
+            phase,
+            rawEventName,
+            supportLevel: 'native',
+            execution: {
+                sessionId: context.sessionId ?? null,
+                nativeEventName: rawEventName,
+                adapter: this.adapter,
+                toolName: context.toolName,
+                toolCallId: context.runId ?? null,
+                source: descriptor.source,
+                metadata: {
+                    ...this.metadata,
+                    caller: context.caller,
+                    runId: context.runId,
+                    server: descriptor.server,
+                },
+                persistedEnv: this.env.persisted,
+                contextVars: {},
+            },
+            payload,
+            env: this.env,
+            raw: payload,
+        };
+    }
+}
+function normalizeHookResult(result) {
+    if (!result)
+        return undefined;
+    const decision = result.decision === 'block' ? 'deny' : result.decision;
+    if (decision !== 'allow' &&
+        decision !== 'deny' &&
+        decision !== 'ask' &&
+        decision !== 'continue' &&
+        decision !== 'noop' &&
+        decision !== undefined) {
+        return {
+            decision: 'deny',
+            reason: result.reason ?? `Unsupported tool hook decision: ${result.decision}`,
+            metadata: result.metadata,
+        };
+    }
+    return {
+        decision,
+        reason: result.reason,
+        toolMutation: result.toolMutation,
+        metadata: result.metadata,
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export type { ToolSource, ToolDescriptor, ToolServer, ToolDispatchRule, ToolDispatchPolicy, ToolCallContext, ToolCallResult, ToolApprovalPolicy, ToolCacheCapability, ToolCategory, ToolCostHint, ToolErrorCode, ToolExecutionLimits, ToolExecutionPolicy, ToolRateLimitHint, SerializedToolError, UnifiedToolEvent, UnifiedToolMetadata, } from './types.js';
+export { ToolExecutionError, serializeToolError } from './types.js';
+export { ToolRegistry } from './registry.js';
+export type { DeferredToolEntry, ResolvedToolEntry, SchemaLoader, ToolSchema, } from './registry.js';
+export { ToolDispatcher } from './dispatch.js';
+export type { ToolExecutor, ToolDispatcherOptions } from './dispatch.js';
+export { convertTools, toToolDescriptor, fromToolDescriptor, translateTools, } from './schema-translation.js';
+export type { NormalizedToolDefinition, CodecCapabilities } from './schema-translation.js';
+export { HooksMuxToolHookBridge, NoopToolHookBridge } from './hooks.js';
+export type { HooksMuxLikeEngine, HooksMuxLikeEngineResult, HooksMuxLikeResult, HooksMuxToolEvent, HooksMuxToolHookBridgeOptions, ToolHookBridge, ToolHookResult, } from './hooks.js';
+export { McpBridge } from './mcp-bridge.js';
+export type { McpTransport, McpServerConfig, McpToolDefinition } from './mcp-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,UAAU,GACX,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAMzE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM3F,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,6BAA6B,EAC7B,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/* ------------------------------------------------------------------ */
+/*  Types                                                              */
+/* ------------------------------------------------------------------ */
+export { ToolExecutionError, serializeToolError } from './types.js';
+/* ------------------------------------------------------------------ */
+/*  Registry                                                           */
+/* ------------------------------------------------------------------ */
+export { ToolRegistry } from './registry.js';
+/* ------------------------------------------------------------------ */
+/*  Dispatch                                                           */
+/* ------------------------------------------------------------------ */
+export { ToolDispatcher } from './dispatch.js';
+/* ------------------------------------------------------------------ */
+/*  Schema translation (re-exports from transport-adapter + adapters)      */
+/* ------------------------------------------------------------------ */
+export { convertTools, toToolDescriptor, fromToolDescriptor, translateTools, } from './schema-translation.js';
+/* ------------------------------------------------------------------ */
+/*  Hooks bridge                                                       */
+/* ------------------------------------------------------------------ */
+export { HooksMuxToolHookBridge, NoopToolHookBridge } from './hooks.js';
+/* ------------------------------------------------------------------ */
+/*  MCP bridge                                                         */
+/* ------------------------------------------------------------------ */
+export { McpBridge } from './mcp-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAsBxE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQ7C,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,wEAAwE;AACxE,6EAA6E;AAC7E,wEAAwE;AAExE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,yBAAyB,CAAC;AAGjC,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAWxE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/mcp-bridge.d.ts

@@ -0,0 +1,54 @@
+import type { ToolRegistry } from './registry.js';
+import type { ToolDescriptor } from './types.js';
+export type McpTransport = 'stdio' | 'sse' | 'http' | 'streamable-http';
+export interface McpServerConfig {
+    id: string;
+    name: string;
+    transport: McpTransport;
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+}
+export interface McpToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * Translates MCP tool definitions into ToolDescriptors and registers
+ * them in a ToolRegistry.
+ *
+ * This bridge is purely declarative — it does NOT start MCP processes
+ * or connect to servers.  Actual MCP execution is handled elsewhere
+ * (e.g. babysitter-sdk).
+ */
+export declare class McpBridge {
+    private readonly registry;
+    private readonly servers;
+    constructor(registry: ToolRegistry);
+    /**
+     * Register an MCP server and all of its advertised tools.
+     *
+     * Each tool is converted to a {@link ToolDescriptor} with
+     * `source: 'mcp'` and `server` set to the config's `id`, then
+     * inserted into the shared {@link ToolRegistry}.
+     */
+    registerServer(config: McpServerConfig, tools: McpToolDefinition[]): void;
+    /**
+     * Remove an MCP server and all tools that belong to it.
+     */
+    unregisterServer(serverId: string): void;
+    /** Return all currently-registered MCP server configs. */
+    listServers(): McpServerConfig[];
+    /** Return the tools currently registered for a specific server. */
+    getServerTools(serverId: string): ToolDescriptor[];
+    /**
+     * Convert a single MCP tool definition into a ToolDescriptor.
+     *
+     * The MCP `inputSchema` is stored as the descriptor's `parameters`
+     * field (both are JSON Schema objects).
+     */
+    static mcpToolToDescriptor(tool: McpToolDefinition, serverId: string): ToolDescriptor;
+}
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../src/mcp-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAMD;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAElD,QAAQ,EAAE,YAAY;IAQlC;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAiBzE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASxC,0DAA0D;IAC1D,WAAW,IAAI,eAAe,EAAE;IAIhC,mEAAmE;IACnE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAQlD;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,MAAM,GACf,cAAc;CAUlB"}

package/dist/mcp-bridge.js

@@ -0,0 +1,78 @@
+/* ------------------------------------------------------------------ */
+/*  McpBridge                                                          */
+/* ------------------------------------------------------------------ */
+/**
+ * Translates MCP tool definitions into ToolDescriptors and registers
+ * them in a ToolRegistry.
+ *
+ * This bridge is purely declarative — it does NOT start MCP processes
+ * or connect to servers.  Actual MCP execution is handled elsewhere
+ * (e.g. babysitter-sdk).
+ */
+export class McpBridge {
+    registry;
+    servers = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Server lifecycle                                                 */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Register an MCP server and all of its advertised tools.
+     *
+     * Each tool is converted to a {@link ToolDescriptor} with
+     * `source: 'mcp'` and `server` set to the config's `id`, then
+     * inserted into the shared {@link ToolRegistry}.
+     */
+    registerServer(config, tools) {
+        this.servers.set(config.id, config);
+        const descriptors = tools.map((t) => McpBridge.mcpToolToDescriptor(t, config.id));
+        // Use the registry's own server-level registration so the
+        // ToolServer entry is also tracked.
+        this.registry.registerServer({
+            id: config.id,
+            name: config.name,
+            type: 'mcp',
+            tools: descriptors,
+        });
+    }
+    /**
+     * Remove an MCP server and all tools that belong to it.
+     */
+    unregisterServer(serverId) {
+        this.servers.delete(serverId);
+        this.registry.unregisterServer(serverId, /* removeTools */ true);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Queries                                                          */
+    /* ---------------------------------------------------------------- */
+    /** Return all currently-registered MCP server configs. */
+    listServers() {
+        return [...this.servers.values()];
+    }
+    /** Return the tools currently registered for a specific server. */
+    getServerTools(serverId) {
+        return this.registry.listByServer(serverId);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Static conversion helper                                         */
+    /* ---------------------------------------------------------------- */
+    /**
+     * Convert a single MCP tool definition into a ToolDescriptor.
+     *
+     * The MCP `inputSchema` is stored as the descriptor's `parameters`
+     * field (both are JSON Schema objects).
+     */
+    static mcpToolToDescriptor(tool, serverId) {
+        return {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema,
+            source: 'mcp',
+            sourceQualifier: serverId,
+            server: serverId,
+        };
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/mcp-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.js","sourceRoot":"","sources":["../src/mcp-bridge.ts"],"names":[],"mappings":"AAyBA,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACH,QAAQ,CAAe;IACvB,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9D,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE;;;;;;OAMG;IACH,cAAc,CAAC,MAAuB,EAAE,KAA0B;QAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAEpC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,SAAS,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAC5C,CAAC;QAEF,0DAA0D;QAC1D,oCAAoC;QACpC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC3B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE,0DAA0D;IAC1D,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,mEAAmE;IACnE,cAAc,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IAEtE;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CACxB,IAAuB,EACvB,QAAgB;QAEhB,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,MAAM,EAAE,KAAK;YACb,eAAe,EAAE,QAAQ;YACzB,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;CACF"}