@yeshwanthyk/runtime-effect 0.1.0

package/dist/hooks/runner.js

@@ -0,0 +1,426 @@
+/**
+ * Hook runner - executes hooks and manages event emission.
+ */
+import { spawn } from "node:child_process";
+import { Effect } from "effect";
+class HookHandlerError extends Error {
+    _tag = "HookHandlerError";
+    constructor(message) {
+        super(message);
+    }
+}
+/** No-op UI context for headless/ACP modes */
+const noOpUIContext = {
+    select: async () => undefined,
+    confirm: async () => false,
+    input: async () => undefined,
+    editor: async () => undefined,
+    notify: () => { },
+    custom: async () => undefined,
+    setEditorText: () => { },
+    getEditorText: () => "",
+};
+/** No-op session context for headless/ACP modes */
+const noOpSessionContext = {
+    summarize: async () => { },
+    toast: () => { },
+    getTokenUsage: () => undefined,
+    getContextLimit: () => undefined,
+    newSession: async () => ({ cancelled: true }),
+    getApiKey: async () => undefined,
+    complete: async () => ({ text: "", stopReason: "error" }),
+};
+/**
+ * Execute a command and return stdout/stderr/code.
+ */
+const execEffect = (command, args, cwd, options) => Effect.async((resume) => {
+    const proc = spawn(command, args, { cwd, shell: false });
+    let stdout = "";
+    let stderr = "";
+    let killed = false;
+    let completed = false;
+    let timeoutId;
+    const finish = (result) => {
+        if (completed)
+            return;
+        completed = true;
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        if (options?.signal)
+            options.signal.removeEventListener("abort", abortHandler);
+        resume(Effect.succeed(result));
+    };
+    const killProcess = () => {
+        if (!killed) {
+            killed = true;
+            proc.kill("SIGTERM");
+            setTimeout(() => {
+                if (!proc.killed)
+                    proc.kill("SIGKILL");
+            }, 5000);
+        }
+    };
+    const abortHandler = () => {
+        killProcess();
+    };
+    if (options?.signal) {
+        if (options.signal.aborted) {
+            abortHandler();
+        }
+        else {
+            options.signal.addEventListener("abort", abortHandler, { once: true });
+        }
+    }
+    if (options?.timeout && options.timeout > 0) {
+        timeoutId = setTimeout(() => {
+            killProcess();
+        }, options.timeout);
+    }
+    proc.stdout?.on("data", (data) => {
+        stdout += data.toString();
+    });
+    proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+    });
+    proc.on("close", (code) => {
+        finish({ stdout, stderr, code: code ?? 0, killed });
+    });
+    proc.on("error", () => {
+        finish({ stdout, stderr, code: 1, killed });
+    });
+    return Effect.sync(() => {
+        if (!completed) {
+            killProcess();
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (options?.signal)
+                options.signal.removeEventListener("abort", abortHandler);
+        }
+    });
+});
+/**
+ * HookRunner executes hooks and manages event emission.
+ */
+export class HookRunner {
+    hooks;
+    cwd;
+    configDir;
+    sessionManager;
+    uiContext;
+    sessionContext;
+    hasUI;
+    errorListeners = new Set();
+    sessionIdProvider;
+    modelProvider;
+    tokenUsage;
+    contextLimit;
+    sendUserMessageHandler = async () => { };
+    steerHandler = async () => { };
+    followUpHandler = async () => { };
+    isIdleHandler = () => true;
+    constructor(hooks, cwd, configDir, sessionManager) {
+        this.hooks = hooks;
+        this.cwd = cwd;
+        this.configDir = configDir;
+        this.sessionManager = sessionManager;
+        this.uiContext = noOpUIContext;
+        this.sessionContext = noOpSessionContext;
+        this.hasUI = false;
+        this.sessionIdProvider = () => null;
+        this.modelProvider = () => null;
+    }
+    /**
+     * Initialize the runner with handlers and context providers.
+     * Must be called before emitting events.
+     */
+    initialize(options) {
+        this.sessionIdProvider = options.getSessionId;
+        this.modelProvider = options.getModel;
+        this.uiContext = options.uiContext ?? noOpUIContext;
+        this.sessionContext = options.sessionContext ?? noOpSessionContext;
+        this.hasUI = options.hasUI ?? false;
+        this.sendUserMessageHandler = options.sendUserMessageHandler;
+        this.steerHandler = options.steerHandler;
+        this.followUpHandler = options.followUpHandler;
+        this.isIdleHandler = options.isIdleHandler;
+        for (const hook of this.hooks) {
+            hook.setSendHandler(options.sendHandler);
+            hook.setSendMessageHandler(options.sendMessageHandler);
+            hook.setSendUserMessageHandler(options.sendUserMessageHandler);
+            hook.setSteerHandler(options.steerHandler);
+            hook.setFollowUpHandler(options.followUpHandler);
+            hook.setIsIdleHandler(options.isIdleHandler);
+            hook.setAppendEntryHandler(options.appendEntryHandler);
+        }
+    }
+    /** Update token usage for context tracking */
+    updateTokenUsage(tokens, contextLimit) {
+        this.tokenUsage = tokens;
+        this.contextLimit = contextLimit;
+    }
+    /** Get the paths of all loaded hooks */
+    getHookPaths() {
+        return this.hooks.map((h) => h.path);
+    }
+    /**
+     * Set the send handler for all hooks' marvin.send().
+     * Call this when the app initializes.
+     */
+    setSendHandler(handler) {
+        for (const hook of this.hooks) {
+            hook.setSendHandler(handler);
+        }
+    }
+    /** Subscribe to hook errors */
+    onError(listener) {
+        this.errorListeners.add(listener);
+        return () => this.errorListeners.delete(listener);
+    }
+    emitError(error) {
+        for (const listener of this.errorListeners) {
+            listener(error);
+        }
+    }
+    async runHandlerEffect(hook, eventType, handler, options) {
+        const swallowErrors = options?.swallowErrors ?? true;
+        const effect = Effect.tryPromise({
+            try: handler,
+            catch: (error) => {
+                if (error instanceof HookHandlerError)
+                    return error;
+                if (error instanceof Error)
+                    return new HookHandlerError(error.message);
+                return new HookHandlerError(typeof error === "string" ? error : String(error));
+            },
+        });
+        try {
+            const value = await Effect.runPromise(effect);
+            return { ok: true, value };
+        }
+        catch (error) {
+            const errObj = error instanceof Error ? error : new Error(String(error));
+            this.emitError({ hookPath: hook.path, event: eventType, error: errObj.message });
+            if (swallowErrors) {
+                return { ok: false };
+            }
+            throw errObj;
+        }
+    }
+    /** Check if any hooks have handlers for the given event type */
+    hasHandlers(eventType) {
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get(eventType);
+            if (handlers && handlers.length > 0)
+                return true;
+        }
+        return false;
+    }
+    createContext() {
+        return {
+            exec: (command, args, options) => Effect.runPromise(execEffect(command, args, this.cwd, options)),
+            cwd: this.cwd,
+            configDir: this.configDir,
+            sessionId: this.sessionIdProvider(),
+            sessionManager: this.sessionManager,
+            model: this.modelProvider(),
+            ui: this.uiContext,
+            hasUI: this.hasUI,
+            session: {
+                ...this.sessionContext,
+                getTokenUsage: () => this.tokenUsage,
+                getContextLimit: () => this.contextLimit,
+            },
+            isIdle: () => this.isIdleHandler(),
+            steer: (text) => Promise.resolve(this.steerHandler(text)),
+            followUp: (text) => Promise.resolve(this.followUpHandler(text)),
+            sendUserMessage: (text, options) => Promise.resolve(this.sendUserMessageHandler(text, options)),
+        };
+    }
+    /**
+     * Emit a general event to all hooks.
+     * Errors are caught and reported, not propagated.
+     */
+    async emit(event) {
+        const ctx = this.createContext();
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get(event.type);
+            if (!handlers || handlers.length === 0)
+                continue;
+            for (const handler of handlers) {
+                await this.runHandlerEffect(hook, event.type, () => Promise.resolve(handler(event, ctx)));
+            }
+        }
+    }
+    /**
+     * Emit tool.execute.before event.
+     * If any hook blocks, returns the block result.
+     * If any hook errors, throws (fail-safe: block on error).
+     */
+    async emitToolExecuteBefore(event) {
+        const ctx = this.createContext();
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get("tool.execute.before");
+            if (!handlers || handlers.length === 0)
+                continue;
+            for (const handler of handlers) {
+                const { value } = await this.runHandlerEffect(hook, "tool.execute.before", () => Promise.resolve(handler(event, ctx)), { swallowErrors: false });
+                const result = value;
+                if (result?.block) {
+                    return result;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Emit tool.execute.after event.
+     * Returns the last non-undefined result (for chaining modifications).
+     */
+    async emitToolExecuteAfter(event) {
+        const ctx = this.createContext();
+        let result;
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get("tool.execute.after");
+            if (!handlers || handlers.length === 0)
+                continue;
+            for (const handler of handlers) {
+                const { value } = await this.runHandlerEffect(hook, "tool.execute.after", () => Promise.resolve(handler(event, ctx)));
+                const handlerResult = value;
+                if (handlerResult) {
+                    result = handlerResult;
+                    if (handlerResult.content)
+                        event.content = handlerResult.content;
+                    if (handlerResult.details !== undefined)
+                        event.details = handlerResult.details;
+                    if (handlerResult.isError !== undefined)
+                        event.isError = handlerResult.isError;
+                }
+            }
+        }
+        return result;
+    }
+    /** Get current session ID */
+    getSessionId() {
+        return this.sessionIdProvider();
+    }
+    /** Get current hook context */
+    getContext() {
+        return this.createContext();
+    }
+    /** Get message renderer for a custom type */
+    getMessageRenderer(customType) {
+        for (const hook of this.hooks) {
+            const renderer = hook.messageRenderers.get(customType);
+            if (renderer)
+                return renderer;
+        }
+        return undefined;
+    }
+    /** Get all registered commands */
+    getRegisteredCommands() {
+        const commands = [];
+        for (const hook of this.hooks) {
+            for (const cmd of hook.commands.values())
+                commands.push(cmd);
+        }
+        return commands;
+    }
+    /** Get a registered command by name */
+    getCommand(name) {
+        for (const hook of this.hooks) {
+            const cmd = hook.commands.get(name);
+            if (cmd)
+                return cmd;
+        }
+        return undefined;
+    }
+    /** Get all registered tools */
+    getRegisteredTools() {
+        const tools = [];
+        for (const hook of this.hooks) {
+            for (const tool of hook.tools.values())
+                tools.push(tool);
+        }
+        return tools;
+    }
+    /** Get a registered tool by name */
+    getTool(name) {
+        for (const hook of this.hooks) {
+            const tool = hook.tools.get(name);
+            if (tool)
+                return tool;
+        }
+        return undefined;
+    }
+    /** Transform messages through chat.messages.transform hooks */
+    async emitContext(messages) {
+        let current = messages.map((msg) => structuredClone(msg));
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get("chat.messages.transform");
+            if (!handlers || handlers.length === 0)
+                continue;
+            for (const handler of handlers) {
+                const event = { type: "chat.messages.transform", messages: current };
+                const { ok } = await this.runHandlerEffect(hook, "chat.messages.transform", () => Promise.resolve(handler(event, this.createContext())));
+                if (ok) {
+                    current = event.messages;
+                }
+            }
+        }
+        return current;
+    }
+    /** Emit chat.message event */
+    async emitChatMessage(input, output) {
+        await this.emit({ type: "chat.message", input, output });
+    }
+    /** Emit agent.before_start event and return first message result */
+    async emitBeforeAgentStart(prompt, images) {
+        let result;
+        for (const hook of this.hooks) {
+            const handlers = hook.handlers.get("agent.before_start");
+            if (!handlers || handlers.length === 0)
+                continue;
+            for (const handler of handlers) {
+                const event = images !== undefined ? { type: "agent.before_start", prompt, images } : { type: "agent.before_start", prompt };
+                const { value } = await this.runHandlerEffect(hook, "agent.before_start", () => Promise.resolve(handler(event, this.createContext())));
+                if (value?.message && !result)
+                    result = value;
+            }
+        }
+        return result;
+    }
+    /** Apply run config through chat/auth/model hooks */
+    async applyRunConfig(cfg, sessionId) {
+        const system = { systemPrompt: cfg.systemPrompt };
+        await this.emit({ type: "chat.system.transform", input: { sessionId, systemPrompt: cfg.systemPrompt }, output: system });
+        const params = { streamOptions: cfg.streamOptions ?? {} };
+        await this.emit({ type: "chat.params", input: { sessionId }, output: params });
+        const modelOutput = { model: cfg.model };
+        await this.emit({ type: "model.resolve", input: { sessionId, model: cfg.model }, output: modelOutput });
+        const auth = {};
+        await this.emit({ type: "auth.get", input: { sessionId, provider: modelOutput.model.provider, modelId: modelOutput.model.id }, output: auth });
+        const nextConfig = {
+            ...cfg,
+            systemPrompt: system.systemPrompt,
+            streamOptions: params.streamOptions,
+            model: modelOutput.model,
+        };
+        if (auth.apiKey !== undefined) {
+            nextConfig.apiKey = auth.apiKey;
+        }
+        if (auth.headers !== undefined) {
+            nextConfig.headers = auth.headers;
+        }
+        if (auth.baseUrl !== undefined) {
+            nextConfig.baseUrl = auth.baseUrl;
+        }
+        return nextConfig;
+    }
+}
+/**
+ * Create an empty hook runner (when no hooks are loaded).
+ */
+export function createEmptyRunner(cwd, configDir, sessionManager) {
+    return new HookRunner([], cwd, configDir, sessionManager);
+}
+//# sourceMappingURL=runner.js.map

package/dist/hooks/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/hooks/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAyC/B,MAAM,gBAAiB,SAAQ,KAAK;IAC1B,IAAI,GAAG,kBAAkB,CAAA;IAClC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;IACf,CAAC;CACD;AAKD,8CAA8C;AAC9C,MAAM,aAAa,GAAkB;IACpC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAC7B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;IAC1B,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAC5B,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAC7B,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;IAChB,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAC7B,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE;CACvB,CAAA;AAED,mDAAmD;AACnD,MAAM,kBAAkB,GAAuB;IAC9C,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACzB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,aAAa,EAAE,GAAG,EAAE,CAAC,SAAS;IAC9B,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS;IAChC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7C,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;IAChC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;CACzD,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW,EAAE,OAAqB,EAAE,EAAE,CAC1F,MAAM,CAAC,KAAK,CAAa,CAAC,MAAM,EAAE,EAAE;IACnC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAExD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,SAAoD,CAAA;IAExD,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAE;QACrC,IAAI,SAAS;YAAE,OAAM;QACrB,SAAS,GAAG,IAAI,CAAA;QAChB,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAA;QACtC,IAAI,OAAO,EAAE,MAAM;YAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QAC9E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,MAAM,GAAG,IAAI,CAAA;YACb,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACpB,UAAU,CAAC,GAAG,EAAE;gBACf,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACvC,CAAC,EAAE,IAAI,CAAC,CAAA;QACT,CAAC;IACF,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,GAAG,EAAE;QACzB,WAAW,EAAE,CAAA;IACd,CAAC,CAAA;IAED,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,YAAY,EAAE,CAAA;QACf,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,CAAC;IACF,CAAC;IAED,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC7C,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,WAAW,EAAE,CAAA;QACd,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACvB,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,WAAW,EAAE,CAAA;YACb,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAA;YACtC,IAAI,OAAO,EAAE,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QAC/E,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA;AAEH;;GAEG;AACH,MAAM,OAAO,UAAU;IACd,KAAK,CAAc;IACnB,GAAG,CAAQ;IACX,SAAS,CAAQ;IACjB,cAAc,CAAwB;IACtC,SAAS,CAAe;IACxB,cAAc,CAAoB;IAClC,KAAK,CAAS;IACd,cAAc,GAAG,IAAI,GAAG,EAAqB,CAAA;IAC7C,iBAAiB,CAAqB;IACtC,aAAa,CAAyB;IACtC,UAAU,CAAwB;IAClC,YAAY,CAAoB;IAChC,sBAAsB,GAA2B,KAAK,IAAI,EAAE,GAAE,CAAC,CAAA;IAC/D,YAAY,GAAoB,KAAK,IAAI,EAAE,GAAE,CAAC,CAAA;IAC9C,eAAe,GAAoB,KAAK,IAAI,EAAE,GAAE,CAAC,CAAA;IACjD,aAAa,GAAkB,GAAG,EAAE,CAAC,IAAI,CAAA;IAEjD,YAAY,KAAmB,EAAE,GAAW,EAAE,SAAiB,EAAE,cAAsC;QACtG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;QACpC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAA;QAC9B,IAAI,CAAC,cAAc,GAAG,kBAAkB,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;QACnC,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAA;IAChC,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,OAaV;QACA,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAA;QAC7C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAA;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,aAAa,CAAA;QACnD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,kBAAkB,CAAA;QAClE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;QACnC,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAA;QAC5D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACxC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAA;QAC9C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;YACxC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;YACtD,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;YAC9D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;YAC1C,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;YAChD,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;YAC5C,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;QACvD,CAAC;IACF,CAAC;IAED,8CAA8C;IAC9C,gBAAgB,CAAC,MAAkB,EAAE,YAAoB;QACxD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAA;QACxB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IACjC,CAAC;IAED,wCAAwC;IACxC,YAAY;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAoB;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAC7B,CAAC;IACF,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,QAA2B;QAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAClD,CAAC;IAEO,SAAS,CAAC,KAAgB;QACjC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5C,QAAQ,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC7B,IAAgB,EAChB,SAAwB,EACxB,OAAyB,EACzB,OAAqC;QAErC,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,IAAI,CAAA;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;YAChC,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChB,IAAI,KAAK,YAAY,gBAAgB;oBAAE,OAAO,KAAK,CAAA;gBACnD,IAAI,KAAK,YAAY,KAAK;oBAAE,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBACtE,OAAO,IAAI,gBAAgB,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YAC/E,CAAC;SACD,CAAC,CAAA;QACF,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;YAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACxE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;YAChF,IAAI,aAAa,EAAE,CAAC;gBACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;YACrB,CAAC;YACD,MAAM,MAAM,CAAA;QACb,CAAC;IACF,CAAC;IAED,gEAAgE;IAChE,WAAW,CAAC,SAAwB;QACnC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YAC7C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAA;QACjD,CAAC;QACD,OAAO,KAAK,CAAA;IACb,CAAC;IAEO,aAAa;QACpB,OAAO;YACN,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,OAAqB,EAAE,EAAE,CAChE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAChE,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE;YACnC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE;YAC3B,EAAE,EAAE,IAAI,CAAC,SAAS;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE;gBACR,GAAG,IAAI,CAAC,cAAc;gBACtB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU;gBACpC,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY;aACxC;YACD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE;YAClC,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACjE,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACvE,eAAe,EAAE,CAAC,IAAY,EAAE,OAA4C,EAAE,EAAE,CAC/E,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SAC5D,CAAA;IACF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAgB;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QAEhC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAEhD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YAC1F,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CAAC,KAA6B;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QAEhC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;YACzD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAEhD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC5C,IAAI,EACJ,qBAAqB,EACrB,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAwC,CAAC,EACjF,EAAE,aAAa,EAAE,KAAK,EAAE,CACxB,CAAA;gBACD,MAAM,MAAM,GAAG,KAA4C,CAAA;gBAE3D,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;oBACnB,OAAO,MAAM,CAAA;gBACd,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAA;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CAAC,KAA4B;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QAChC,IAAI,MAA0C,CAAA;QAE9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;YACxD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAE/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC5C,IAAI,EACJ,oBAAoB,EACrB,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAuC,CAAC,CAC/E,CAAA;gBACD,MAAM,aAAa,GAAG,KAA2C,CAAA;gBAEjE,IAAI,aAAa,EAAE,CAAC;oBACpB,MAAM,GAAG,aAAa,CAAA;oBACtB,IAAI,aAAa,CAAC,OAAO;wBAAE,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAA;oBAChE,IAAI,aAAa,CAAC,OAAO,KAAK,SAAS;wBAAE,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAA;oBAC9E,IAAI,aAAa,CAAC,OAAO,KAAK,SAAS;wBAAE,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAA;gBAC/E,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,MAAM,CAAA;IACd,CAAC;IAED,6BAA6B;IAC7B,YAAY;QACX,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAA;IAChC,CAAC;IAED,+BAA+B;IAC/B,UAAU;QACT,OAAO,IAAI,CAAC,aAAa,EAAE,CAAA;IAC5B,CAAC;IAED,6CAA6C;IAC7C,kBAAkB,CAAC,UAAkB;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;YACtD,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAA;QAC9B,CAAC;QACD,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,kCAAkC;IAClC,qBAAqB;QACpB,MAAM,QAAQ,GAAwB,EAAE,CAAA;QACxC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;gBAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,uCAAuC;IACvC,UAAU,CAAC,IAAY;QACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnC,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAA;QACpB,CAAC;QACD,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,+BAA+B;IAC/B,kBAAkB;QACjB,MAAM,KAAK,GAAqB,EAAE,CAAA;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,KAAK,CAAA;IACb,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,IAAY;QACnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACjC,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAA;QACtB,CAAC;QACD,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,WAAW,CAAC,QAAmB;QACpC,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAA;QACzD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;YAC7D,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAChD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,KAAK,GAA+B,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;gBAChG,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACzC,IAAI,EACJ,yBAAyB,EACzB,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAC3D,CAAA;gBACD,IAAI,EAAE,EAAE,CAAC;oBACR,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAA;gBACzB,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,OAAO,CAAA;IACf,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,eAAe,CAAC,KAAgC,EAAE,MAAkC;QACzF,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,oBAAoB,CAAC,MAAc,EAAE,MAAuB;QACjE,IAAI,MAA0C,CAAA;QAC9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;YACxD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAChD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAChC,MAAM,KAAK,GACV,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAA;gBAC/G,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC5C,IAAI,EACJ,oBAAoB,EACpB,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,CAAuC,CAAC,CACjG,CAAA;gBACD,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,MAAM;oBAAE,MAAM,GAAG,KAAK,CAAA;YAC9C,CAAC;QACF,CAAC;QACD,OAAO,MAAM,CAAA;IACd,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,cAAc,CAAC,GAAmB,EAAE,SAAwB;QACjE,MAAM,MAAM,GAAuC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;QACrF,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAExH,MAAM,MAAM,GAA8B,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,CAAA;QACpF,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAE9E,MAAM,WAAW,GAAgC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QACrE,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;QAEvG,MAAM,IAAI,GAA2B,EAAE,CAAA;QACvC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAE9I,MAAM,UAAU,GAAmB;YAClC,GAAG,GAAG;YACN,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,KAAK,EAAE,WAAW,CAAC,KAAK;SACxB,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAClC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAClC,CAAC;QAED,OAAO,UAAU,CAAA;IAClB,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,SAAiB,EAAE,cAAsC;IACvG,OAAO,IAAI,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;AAC1D,CAAC"}

package/dist/hooks/tool-wrapper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool wrapper - wraps tools with hook callbacks for interception.
+ */
+import type { AgentTool } from "@yeshwanthyk/ai";
+import type { HookRunner } from "./runner.js";
+/**
+ * Wrap a tool with hook callbacks.
+ * - Emits tool.execute.before event (can block or modify input)
+ * - Emits tool.execute.after event (can modify result, fires on errors too)
+ */
+export declare function wrapToolWithHooks<TDetails>(tool: AgentTool<any, TDetails>, hookRunner: HookRunner): AgentTool<any, TDetails>;
+/**
+ * Wrap all tools with hook callbacks.
+ */
+export declare function wrapToolsWithHooks(tools: AgentTool<any, any>[], hookRunner: HookRunner): AgentTool<any, any>[];
+//# sourceMappingURL=tool-wrapper.d.ts.map

package/dist/hooks/tool-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,QAAQ,EACzC,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,EAC9B,UAAU,EAAE,UAAU,GACpB,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAoE1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAC5B,UAAU,EAAE,UAAU,GACpB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAEvB"}

package/dist/hooks/tool-wrapper.js

@@ -0,0 +1,74 @@
+/**
+ * Tool wrapper - wraps tools with hook callbacks for interception.
+ */
+/**
+ * Wrap a tool with hook callbacks.
+ * - Emits tool.execute.before event (can block or modify input)
+ * - Emits tool.execute.after event (can modify result, fires on errors too)
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function wrapToolWithHooks(tool, hookRunner) {
+    return {
+        ...tool,
+        execute: async (toolCallId, params, signal, onUpdate) => {
+            const sessionId = hookRunner.getSessionId();
+            // Emit tool.execute.before - hooks can block or modify input
+            const beforeResult = await hookRunner.emitToolExecuteBefore({
+                type: "tool.execute.before",
+                sessionId,
+                toolName: tool.name,
+                toolCallId,
+                input: params,
+            });
+            if (beforeResult?.block) {
+                const reason = beforeResult.reason ?? "Tool execution was blocked by a hook";
+                throw new Error(reason);
+            }
+            // Use potentially modified input
+            const effectiveParams = beforeResult?.input ?? params;
+            try {
+                // Execute the actual tool
+                const result = await tool.execute(toolCallId, effectiveParams, signal, onUpdate);
+                // Emit tool.execute.after - hooks can modify the result
+                const afterResult = await hookRunner.emitToolExecuteAfter({
+                    type: "tool.execute.after",
+                    sessionId,
+                    toolName: tool.name,
+                    toolCallId,
+                    input: effectiveParams,
+                    content: result.content,
+                    details: result.details,
+                    isError: false,
+                });
+                if (afterResult) {
+                    return {
+                        content: afterResult.content ?? result.content,
+                        details: (afterResult.details ?? result.details),
+                    };
+                }
+                return result;
+            }
+            catch (err) {
+                // Emit tool.execute.after on errors too
+                await hookRunner.emitToolExecuteAfter({
+                    type: "tool.execute.after",
+                    sessionId,
+                    toolName: tool.name,
+                    toolCallId,
+                    input: effectiveParams,
+                    content: [{ type: "text", text: err instanceof Error ? err.message : String(err) }],
+                    details: undefined,
+                    isError: true,
+                });
+                throw err;
+            }
+        },
+    };
+}
+/**
+ * Wrap all tools with hook callbacks.
+ */
+export function wrapToolsWithHooks(tools, hookRunner) {
+    return tools.map((tool) => wrapToolWithHooks(tool, hookRunner));
+}
+//# sourceMappingURL=tool-wrapper.js.map

package/dist/hooks/tool-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-wrapper.js","sourceRoot":"","sources":["../../src/hooks/tool-wrapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAChC,IAA8B,EAC9B,UAAsB;IAEtB,OAAO;QACN,GAAG,IAAI;QACP,OAAO,EAAE,KAAK,EACb,UAAkB,EAClB,MAAe,EACf,MAAoB,EACpB,QAA4C,EAC3C,EAAE;YACH,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,CAAA;YAE3C,6DAA6D;YAC7D,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,qBAAqB,CAAC;gBAC3D,IAAI,EAAE,qBAAqB;gBAC3B,SAAS;gBACT,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,UAAU;gBACV,KAAK,EAAE,MAAiC;aACxC,CAAC,CAAA;YAEF,IAAI,YAAY,EAAE,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,sCAAsC,CAAA;gBAC5E,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC;YAED,iCAAiC;YACjC,MAAM,eAAe,GAAG,YAAY,EAAE,KAAK,IAAI,MAAM,CAAA;YAErD,IAAI,CAAC;gBACJ,0BAA0B;gBAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;gBAEhF,wDAAwD;gBACxD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,oBAAoB,CAAC;oBACzD,IAAI,EAAE,oBAAoB;oBAC1B,SAAS;oBACT,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,UAAU;oBACV,KAAK,EAAE,eAA0C;oBACjD,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,KAAK;iBACd,CAAC,CAAA;gBAEF,IAAI,WAAW,EAAE,CAAC;oBACjB,OAAO;wBACN,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO;wBAC9C,OAAO,EAAE,CAAC,WAAW,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAa;qBAC5D,CAAA;gBACF,CAAC;gBAED,OAAO,MAAM,CAAA;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,wCAAwC;gBACxC,MAAM,UAAU,CAAC,oBAAoB,CAAC;oBACrC,IAAI,EAAE,oBAAoB;oBAC1B,SAAS;oBACT,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,UAAU;oBACV,KAAK,EAAE,eAA0C;oBACjD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnF,OAAO,EAAE,SAAqB;oBAC9B,OAAO,EAAE,IAAI;iBACb,CAAC,CAAA;gBACF,MAAM,GAAG,CAAA;YACV,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CACjC,KAA4B,EAC5B,UAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;AAChE,CAAC"}