@yeshwanthyk/runtime-effect 0.1.0

package/dist/extensibility/custom-tools/loader.js

@@ -0,0 +1,219 @@
+/**
+ * Custom tool loader - discovers and loads TypeScript tool modules.
+ *
+ * Tools are loaded from:
+ *   - ~/.config/marvin/tools/*.ts (single-file tools)
+ *   - ~/.config/marvin/tools/<name>/index.ts (directory-based tools)
+ *
+ * Uses Bun's native import() which handles TypeScript directly.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { spawn } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { validateCustomTool, issueFromError } from "../validation.js";
+const createToolIssue = (path, message, severity = "error") => ({
+    kind: "tool",
+    severity,
+    path,
+    message,
+});
+const isCustomToolFactory = (value) => typeof value === "function";
+/**
+ * Execute a command and return stdout/stderr/code.
+ * Supports cancellation via AbortSignal and timeout.
+ */
+async function execCommand(command, args, cwd, options) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, args, {
+            cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let killed = false;
+        let timeoutId;
+        const killProcess = () => {
+            if (!killed) {
+                killed = true;
+                proc.kill("SIGTERM");
+                // Force kill after 5s if SIGTERM doesn't work
+                setTimeout(() => {
+                    if (!proc.killed) {
+                        proc.kill("SIGKILL");
+                    }
+                }, 5000);
+            }
+        };
+        // Handle abort signal
+        if (options?.signal) {
+            if (options.signal.aborted) {
+                killProcess();
+            }
+            else {
+                options.signal.addEventListener("abort", killProcess, { once: true });
+            }
+        }
+        // Handle timeout
+        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) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (options?.signal) {
+                options.signal.removeEventListener("abort", killProcess);
+            }
+            resolve({
+                stdout,
+                stderr,
+                code: code ?? 0,
+                killed,
+            });
+        });
+        proc.on("error", (err) => {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (options?.signal) {
+                options.signal.removeEventListener("abort", killProcess);
+            }
+            resolve({
+                stdout,
+                stderr: stderr || err.message,
+                code: 1,
+                killed,
+            });
+        });
+    });
+}
+/**
+ * Load a single tool module.
+ */
+async function loadTool(toolPath, api) {
+    const resolvedPath = resolve(toolPath);
+    try {
+        // Use file URL for import - Bun handles TS natively
+        const fileUrl = pathToFileURL(resolvedPath).href;
+        const module = await import(__rewriteRelativeImportExtension(fileUrl));
+        const factory = module.default;
+        if (!isCustomToolFactory(factory)) {
+            return { tools: null, error: "Tool must export a default function" };
+        }
+        // Call factory with API
+        const result = await factory(api);
+        // Handle single tool or array of tools
+        const toolsArray = Array.isArray(result) ? result : [result];
+        const loadedTools = toolsArray.map((tool) => ({
+            path: toolPath,
+            resolvedPath,
+            tool,
+        }));
+        return { tools: loadedTools, error: null };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { tools: null, error: `Failed to load tool: ${message}` };
+    }
+}
+/**
+ * Discover tool files from a directory.
+ * Finds both:
+ *   - tools/*.ts (single-file tools)
+ *   - tools/<name>/index.ts (directory-based tools with assets)
+ */
+function discoverToolsInDir(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const paths = [];
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() || entry.isSymbolicLink()) {
+                // Single-file tool: tools/name.ts
+                if (entry.name.endsWith(".ts")) {
+                    paths.push(join(dir, entry.name));
+                }
+            }
+            else if (entry.isDirectory()) {
+                // Directory-based tool: tools/name/index.ts
+                const indexPath = join(dir, entry.name, "index.ts");
+                if (existsSync(indexPath)) {
+                    paths.push(indexPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore read errors
+    }
+    return paths;
+}
+/**
+ * Discover and load tools from the config directory.
+ * Loads from ~/.config/marvin/tools/*.ts
+ *
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ * @param cwd - Current working directory for tool execution
+ * @param builtInToolNames - Names of built-in tools to check for conflicts
+ * @param sendRef - Ref for send handler (set by App after initialization)
+ */
+export async function loadCustomTools(configDir, cwd, builtInToolNames, sendRef, hasUI) {
+    const tools = [];
+    const issues = [];
+    const seenNames = new Set(builtInToolNames);
+    // Shared API object - all tools get the same instance
+    const api = {
+        cwd,
+        hasUI,
+        exec: (command, args, options) => execCommand(command, args, cwd, options),
+        send: (text) => sendRef.current(text),
+    };
+    const toolsDir = join(configDir, "tools");
+    const paths = discoverToolsInDir(toolsDir);
+    for (const toolPath of paths) {
+        const { tools: loadedTools, error } = await loadTool(toolPath, api);
+        if (error) {
+            issues.push(issueFromError("tool", toolPath, error));
+            continue;
+        }
+        if (loadedTools) {
+            for (const loadedTool of loadedTools) {
+                // Check for name conflicts
+                if (seenNames.has(loadedTool.tool.name)) {
+                    issues.push(createToolIssue(toolPath, `Tool name "${loadedTool.tool.name}" conflicts with existing tool`));
+                    continue;
+                }
+                seenNames.add(loadedTool.tool.name);
+                tools.push(loadedTool);
+                issues.push(...validateCustomTool(loadedTool.tool, toolPath));
+                if (typeof loadedTool.tool.execute !== "function") {
+                    issues.push(createToolIssue(toolPath, `Tool "${loadedTool.tool.name}" is missing an execute() function`));
+                }
+                if (!loadedTool.tool.parameters) {
+                    issues.push(createToolIssue(toolPath, `Tool "${loadedTool.tool.name}" does not export parameters schema`, "warning"));
+                }
+            }
+        }
+    }
+    return { tools, issues };
+}
+/**
+ * Get built-in tool names from an array of tools.
+ */
+//# sourceMappingURL=loader.js.map

package/dist/extensibility/custom-tools/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/extensibility/custom-tools/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;;;;;;;;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAWxC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,WAA+B,OAAO,EAAmB,EAAE,CAAC,CAAC;IACpH,IAAI,EAAE,MAAM;IACZ,QAAQ;IACR,IAAI;IACJ,OAAO;CACP,CAAC,CAAA;AAEF,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE,CAC1E,OAAO,KAAK,KAAK,UAAU,CAAA;AAE5B;;;GAGG;AACH,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW,EAAE,OAAqB;IAC7F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,GAAG;YACH,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACjC,CAAC,CAAA;QAEF,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,IAAI,SAAoD,CAAA;QAExD,MAAM,WAAW,GAAG,GAAG,EAAE;YACxB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,GAAG,IAAI,CAAA;gBACb,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACpB,8CAA8C;gBAC9C,UAAU,CAAC,GAAG,EAAE;oBACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;wBAClB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;oBACrB,CAAC;gBACF,CAAC,EAAE,IAAI,CAAC,CAAA;YACT,CAAC;QACF,CAAC,CAAA;QAED,sBAAsB;QACtB,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC5B,WAAW,EAAE,CAAA;YACd,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACtE,CAAC;QACF,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YAC7C,SAAS,GAAG,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QACrD,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC1B,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC1B,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAA;YACtC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YACzD,CAAC;YACD,OAAO,CAAC;gBACP,MAAM;gBACN,MAAM;gBACN,IAAI,EAAE,IAAI,IAAI,CAAC;gBACf,MAAM;aACN,CAAC,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAA;YACtC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;gBACrB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YACzD,CAAC;YACD,OAAO,CAAC;gBACP,MAAM;gBACN,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,OAAO;gBAC7B,IAAI,EAAE,CAAC;gBACP,MAAM;aACN,CAAC,CAAA;QACH,CAAC,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,QAAQ,CACtB,QAAgB,EAChB,GAAY;IAEZ,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAEtC,IAAI,CAAC;QACJ,oDAAoD;QACpD,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAA;QAChD,MAAM,MAAM,GAAG,MAAM,MAAM,kCAAC,OAAO,EAAC,CAAA;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAE9B,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAA;QACrE,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;QAEjC,uCAAuC;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QAE5D,MAAM,WAAW,GAAuB,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI,EAAE,QAAQ;YACd,YAAY;YACZ,IAAI;SACJ,CAAC,CAAC,CAAA;QAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAChE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAA;IACjE,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAA;IACV,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAEzD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC9C,kCAAkC;gBAClC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;gBAClC,CAAC;YACF,CAAC;iBAAM,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBAChC,4CAA4C;gBAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;gBACnD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACtB,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,qBAAqB;IACtB,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,SAAiB,EACjB,GAAW,EACX,gBAA0B,EAC1B,OAAgB,EAChB,KAAc;IAEd,MAAM,KAAK,GAAuB,EAAE,CAAA;IACpC,MAAM,MAAM,GAAsB,EAAE,CAAA;IACpC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAA;IAEnD,sDAAsD;IACtD,MAAM,GAAG,GAAY;QACpB,GAAG;QACH,KAAK;QACL,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,OAAqB,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC;QAC1G,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;KAC7C,CAAA;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IAE1C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QAEnE,IAAI,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;YACpD,SAAQ;QACT,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YACjB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACtC,2BAA2B;gBAC3B,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzC,MAAM,CAAC,IAAI,CACV,eAAe,CACd,QAAQ,EACR,cAAc,UAAU,CAAC,IAAI,CAAC,IAAI,gCAAgC,CAClE,CACD,CAAA;oBACD,SAAQ;gBACT,CAAC;gBAED,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;gBAEtB,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;gBAE7D,IAAI,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACnD,MAAM,CAAC,IAAI,CACV,eAAe,CACd,QAAQ,EACR,SAAS,UAAU,CAAC,IAAI,CAAC,IAAI,oCAAoC,CACjE,CACD,CAAA;gBACF,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;oBACjC,MAAM,CAAC,IAAI,CACV,eAAe,CACd,QAAQ,EACR,SAAS,UAAU,CAAC,IAAI,CAAC,IAAI,qCAAqC,EAClE,SAAS,CACT,CACD,CAAA;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AACzB,CAAC;AAED;;GAEG"}

package/dist/extensibility/custom-tools/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Custom tool types for user-defined tools.
+ */
+import type { AgentTool, AgentToolResult } from "@yeshwanthyk/ai";
+import type { JSX } from "solid-js";
+import type { ValidationIssue } from "../schema.js";
+import type { HookTheme } from "../../hooks/types.js";
+/**
+ * Options passed to custom tool result renderers.
+ */
+export interface RenderResultOptions {
+    expanded: boolean;
+    isPartial: boolean;
+}
+/**
+ * Session lifecycle event types for custom tools.
+ */
+export type SessionEvent = {
+    type: "session.start";
+    sessionId: string;
+} | {
+    type: "session.resume";
+    sessionId: string;
+} | {
+    type: "session.end";
+    sessionId: string;
+};
+/**
+ * Extended AgentTool with optional UI hooks for first-class rendering.
+ * Uses `any` for TParams to avoid TypeBox version constraint issues.
+ */
+export interface CustomAgentTool<TDetails = any> extends AgentTool<any, TDetails> {
+    /** Custom header/call rendering */
+    renderCall?: (args: any, theme: HookTheme) => JSX.Element;
+    /** Custom result rendering */
+    renderResult?: (result: AgentToolResult<TDetails>, opts: RenderResultOptions, theme: HookTheme) => JSX.Element;
+    /** Session lifecycle hook */
+    onSession?: (ev: SessionEvent) => void | Promise<void>;
+    /** Cleanup on app exit */
+    dispose?: () => void | Promise<void>;
+}
+/**
+ * Result from executing a command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Options for command execution.
+ */
+export interface ExecOptions {
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Ref for send handler - allows late binding of the send function.
+ */
+export type SendRef = {
+    current: (text: string) => void;
+};
+/**
+ * API provided to custom tool factories.
+ */
+export interface ToolAPI {
+    /** Current working directory */
+    cwd: string;
+    /** Whether running in interactive mode (TUI). False for headless/ACP modes. */
+    hasUI: boolean;
+    /** Execute a command */
+    exec: (command: string, args: string[], options?: ExecOptions) => Promise<ExecResult>;
+    /** Send a message to the agent (queued as user input) */
+    send: (text: string) => void;
+}
+/**
+ * Factory function that creates one or more tools.
+ * Default export from tool modules.
+ */
+export type CustomToolFactory = (api: ToolAPI) => CustomAgentTool | CustomAgentTool[] | Promise<CustomAgentTool | CustomAgentTool[]>;
+/**
+ * A loaded custom tool with its source path.
+ */
+export interface LoadedCustomTool {
+    /** Original file path */
+    path: string;
+    /** Resolved absolute path */
+    resolvedPath: string;
+    /** The loaded tool */
+    tool: CustomAgentTool;
+}
+/**
+ * Result of loading custom tools.
+ */
+export interface CustomToolsLoadResult {
+    tools: LoadedCustomTool[];
+    issues: ValidationIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extensibility/custom-tools/types.d.ts.map

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

package/dist/extensibility/custom-tools/types.js

@@ -0,0 +1,5 @@
+/**
+ * Custom tool types for user-defined tools.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensibility/custom-tools/types.js.map

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

package/dist/extensibility/index.d.ts

@@ -0,0 +1,36 @@
+import { Context, Layer } from "effect";
+import { HookRunner } from "../hooks/index.js";
+import { type LoadedCustomTool, type SendRef } from "./custom-tools/index.js";
+import type { ValidationIssue } from "./schema.js";
+import type { ReadonlySessionManager } from "../session-manager.js";
+import { type CustomCommandService } from "./custom-commands.js";
+export interface ExtensibilityLoadOptions {
+    configDir: string;
+    cwd: string;
+    sendRef: SendRef;
+    builtinToolNames: string[];
+    /** Whether running in interactive mode (TUI) */
+    hasUI: boolean;
+    /** Session manager for hook context */
+    sessionManager: ReadonlySessionManager;
+}
+export interface ExtensibilityLoadResult {
+    hookRunner: HookRunner;
+    customTools: LoadedCustomTool[];
+    validationIssues: ValidationIssue[];
+    hookCount: number;
+}
+export declare const loadExtensibility: (options: ExtensibilityLoadOptions) => Promise<ExtensibilityLoadResult>;
+export declare const attachHookErrorLogging: (hookRunner: HookRunner, log: (message: string) => void) => void;
+export interface ExtensibilityService extends ExtensibilityLoadResult {
+}
+export declare const ExtensibilityTag: Context.Tag<ExtensibilityService, ExtensibilityService>;
+export interface ExtensibilityLayerOptions {
+    sendRef: SendRef;
+    builtinToolNames: string[];
+    hasUI: boolean;
+    cwd?: string;
+    loader?: typeof loadExtensibility;
+}
+export declare const ExtensibilityLayer: (options: ExtensibilityLayerOptions) => Layer.Layer<ExtensibilityService, import("effect/Cause").UnknownException, import("../config.js").ConfigService | import("../session-manager.js").SessionManagerService | import("../instrumentation.js").InstrumentationService | CustomCommandService>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extensibility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAa,UAAU,EAAkB,MAAM,mBAAmB,CAAA;AACzE,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAInE,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAElF,MAAM,WAAW,wBAAwB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAA;IACd,uCAAuC;IACvC,cAAc,EAAE,sBAAsB,CAAA;CACtC;AAED,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,gBAAgB,EAAE,eAAe,EAAE,CAAA;IACnC,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,iBAAiB,GAC7B,SAAS,wBAAwB,KAC/B,OAAO,CAAC,uBAAuB,CAkBjC,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,YAAY,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,SAI5F,CAAA;AAED,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;CAAG;AAExE,eAAO,MAAM,gBAAgB,yDAAkF,CAAA;AAE/G,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,iBAAiB,CAAA;CACjC;AAED,eAAO,MAAM,kBAAkB,GAAI,SAAS,yBAAyB,6PAoEnE,CAAA"}

package/dist/extensibility/index.js

@@ -0,0 +1,79 @@
+import { Context, Effect, Layer } from "effect";
+import { loadHooks, HookRunner } from "../hooks/index.js";
+import { loadCustomTools, } from "./custom-tools/index.js";
+import { ConfigTag } from "../config.js";
+import { SessionManagerTag } from "../session-manager.js";
+import { InstrumentationTag } from "../instrumentation.js";
+import { CustomCommandTag } from "./custom-commands.js";
+export const loadExtensibility = async (options) => {
+    const { hooks, issues: hookIssues } = await loadHooks(options.configDir);
+    const hookRunner = new HookRunner(hooks, options.cwd, options.configDir, options.sessionManager);
+    const { tools: customTools, issues: toolIssues } = await loadCustomTools(options.configDir, options.cwd, options.builtinToolNames, options.sendRef, options.hasUI);
+    return {
+        hookRunner,
+        customTools,
+        validationIssues: [...hookIssues, ...toolIssues],
+        hookCount: hooks.length,
+    };
+};
+export const attachHookErrorLogging = (hookRunner, log) => {
+    hookRunner.onError((err) => {
+        log(`Hook error [${err.event}] ${err.hookPath}: ${err.error}`);
+    });
+};
+export const ExtensibilityTag = Context.GenericTag("runtime-effect/ExtensibilityService");
+export const ExtensibilityLayer = (options) => Layer.effect(ExtensibilityTag, Effect.gen(function* () {
+    const { config } = yield* ConfigTag;
+    const { sessionManager } = yield* SessionManagerTag;
+    const instrumentation = yield* InstrumentationTag;
+    const customCommands = yield* Effect.catchAll(CustomCommandTag, () => Effect.succeed(null));
+    const loader = options.loader ?? loadExtensibility;
+    const result = yield* Effect.tryPromise(() => loader({
+        configDir: config.configDir,
+        cwd: options.cwd ?? process.cwd(),
+        sendRef: options.sendRef,
+        builtinToolNames: options.builtinToolNames,
+        hasUI: options.hasUI,
+        sessionManager,
+    }));
+    result.hookRunner.onError((err) => {
+        const errorValue = err.error;
+        let errorMessage;
+        if (typeof errorValue === "object" && errorValue !== null && "message" in errorValue) {
+            const maybeMessage = errorValue.message;
+            errorMessage = maybeMessage !== undefined ? String(maybeMessage) : String(errorValue);
+        }
+        else {
+            errorMessage = String(errorValue);
+        }
+        instrumentation.record({
+            type: "hook:error",
+            hookPath: err.hookPath,
+            event: err.event,
+            error: errorMessage,
+        });
+    });
+    for (const issue of result.validationIssues) {
+        instrumentation.record({
+            type: "extensibility:validation-issue",
+            issue,
+        });
+    }
+    const commandCount = customCommands?.commands.size;
+    instrumentation.record({
+        type: "extensibility:loaded",
+        hooks: result.hookCount,
+        customTools: result.customTools.length,
+        ...(commandCount !== undefined ? { customCommands: commandCount } : {}),
+    });
+    instrumentation.record({
+        type: "extensibility:custom-tools-loaded",
+        count: result.customTools.length,
+        entries: result.customTools.map((tool) => ({
+            name: tool.tool.name,
+            path: tool.resolvedPath,
+        })),
+    });
+    return result;
+}));
+//# sourceMappingURL=index.js.map

package/dist/extensibility/index.js.map

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

package/dist/extensibility/schema.d.ts

@@ -0,0 +1,40 @@
+import type { Static } from "@sinclair/typebox";
+export declare const VALIDATION_KINDS: readonly ["hook", "tool", "command"];
+export type ValidationKind = (typeof VALIDATION_KINDS)[number];
+export declare const VALIDATION_SEVERITIES: readonly ["error", "warning"];
+export type ValidationSeverity = (typeof VALIDATION_SEVERITIES)[number];
+export declare const validationKindSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"hook">, import("@sinclair/typebox").TLiteral<"tool">, import("@sinclair/typebox").TLiteral<"command">]>;
+export declare const validationSeveritySchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"warning">]>;
+export interface ValidationIssue {
+    kind: ValidationKind;
+    severity: ValidationSeverity;
+    path: string;
+    message: string;
+    hint?: string;
+}
+export declare const validationIssueSchema: import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"hook">, import("@sinclair/typebox").TLiteral<"tool">, import("@sinclair/typebox").TLiteral<"command">]>;
+    severity: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"error">, import("@sinclair/typebox").TLiteral<"warning">]>;
+    path: import("@sinclair/typebox").TString;
+    message: import("@sinclair/typebox").TString;
+    hint: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const customCommandSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+    template: import("@sinclair/typebox").TString;
+}>;
+export type CustomCommandManifest = Static<typeof customCommandSchema>;
+export declare const customToolSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    label: import("@sinclair/typebox").TString;
+    description: import("@sinclair/typebox").TString;
+}>;
+export type CustomToolDescriptor = Static<typeof customToolSchema>;
+export declare const HOOK_EVENT_NAMES: readonly ["app.start", "session.start", "session.resume", "session.clear", "session.before_compact", "session.compact", "session.shutdown", "agent.before_start", "agent.start", "agent.end", "turn.start", "turn.end", "tool.execute.before", "tool.execute.after", "chat.message", "chat.messages.transform", "chat.system.transform", "chat.params", "auth.get", "model.resolve"];
+export declare const hookDescriptorSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+    events: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"app.start">, import("@sinclair/typebox").TLiteral<"session.start">, import("@sinclair/typebox").TLiteral<"session.resume">, import("@sinclair/typebox").TLiteral<"session.clear">, import("@sinclair/typebox").TLiteral<"session.before_compact">, import("@sinclair/typebox").TLiteral<"session.compact">, import("@sinclair/typebox").TLiteral<"session.shutdown">, import("@sinclair/typebox").TLiteral<"agent.before_start">, import("@sinclair/typebox").TLiteral<"agent.start">, import("@sinclair/typebox").TLiteral<"agent.end">, import("@sinclair/typebox").TLiteral<"turn.start">, import("@sinclair/typebox").TLiteral<"turn.end">, import("@sinclair/typebox").TLiteral<"tool.execute.before">, import("@sinclair/typebox").TLiteral<"tool.execute.after">, import("@sinclair/typebox").TLiteral<"chat.message">, import("@sinclair/typebox").TLiteral<"chat.messages.transform">, import("@sinclair/typebox").TLiteral<"chat.system.transform">, import("@sinclair/typebox").TLiteral<"chat.params">, import("@sinclair/typebox").TLiteral<"auth.get">, import("@sinclair/typebox").TLiteral<"model.resolve">]>>;
+}>;
+export type HookDescriptor = Static<typeof hookDescriptorSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/extensibility/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/extensibility/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,eAAO,MAAM,gBAAgB,sCAAuC,CAAA;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,eAAO,MAAM,qBAAqB,+BAAgC,CAAA;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,oBAAoB,mLAI/B,CAAA;AACF,eAAO,MAAM,wBAAwB,sIAA+D,CAAA;AAEpG,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAEtE,eAAO,MAAM,gBAAgB;;;;EAO5B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAElE,eAAO,MAAM,gBAAgB,sXAqBnB,CAAA;AAyBV,eAAO,MAAM,oBAAoB;;;EAG/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/extensibility/schema.js

@@ -0,0 +1,75 @@
+import { Type } from "@sinclair/typebox";
+export const VALIDATION_KINDS = ["hook", "tool", "command"];
+export const VALIDATION_SEVERITIES = ["error", "warning"];
+export const validationKindSchema = Type.Union([
+    Type.Literal("hook"),
+    Type.Literal("tool"),
+    Type.Literal("command"),
+]);
+export const validationSeveritySchema = Type.Union([Type.Literal("error"), Type.Literal("warning")]);
+export const validationIssueSchema = Type.Object({
+    kind: validationKindSchema,
+    severity: validationSeveritySchema,
+    path: Type.String({ minLength: 1 }),
+    message: Type.String({ minLength: 1 }),
+    hint: Type.Optional(Type.String({ minLength: 1 })),
+});
+export const customCommandSchema = Type.Object({
+    name: Type.String({ pattern: "^[A-Za-z0-9][A-Za-z0-9_-]*$", minLength: 1 }),
+    description: Type.String({ minLength: 1 }),
+    template: Type.String({ minLength: 1 }),
+});
+export const customToolSchema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    label: Type.String({ minLength: 1 }),
+    description: Type.String({ minLength: 1 }),
+}, { additionalProperties: true });
+export const HOOK_EVENT_NAMES = [
+    "app.start",
+    "session.start",
+    "session.resume",
+    "session.clear",
+    "session.before_compact",
+    "session.compact",
+    "session.shutdown",
+    "agent.before_start",
+    "agent.start",
+    "agent.end",
+    "turn.start",
+    "turn.end",
+    "tool.execute.before",
+    "tool.execute.after",
+    "chat.message",
+    "chat.messages.transform",
+    "chat.system.transform",
+    "chat.params",
+    "auth.get",
+    "model.resolve",
+];
+const hookEventLiteralSchema = Type.Union([
+    Type.Literal("app.start"),
+    Type.Literal("session.start"),
+    Type.Literal("session.resume"),
+    Type.Literal("session.clear"),
+    Type.Literal("session.before_compact"),
+    Type.Literal("session.compact"),
+    Type.Literal("session.shutdown"),
+    Type.Literal("agent.before_start"),
+    Type.Literal("agent.start"),
+    Type.Literal("agent.end"),
+    Type.Literal("turn.start"),
+    Type.Literal("turn.end"),
+    Type.Literal("tool.execute.before"),
+    Type.Literal("tool.execute.after"),
+    Type.Literal("chat.message"),
+    Type.Literal("chat.messages.transform"),
+    Type.Literal("chat.system.transform"),
+    Type.Literal("chat.params"),
+    Type.Literal("auth.get"),
+    Type.Literal("model.resolve"),
+]);
+export const hookDescriptorSchema = Type.Object({
+    path: Type.String({ minLength: 1 }),
+    events: Type.Array(hookEventLiteralSchema, { default: [] }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/extensibility/schema.js.map

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

package/dist/extensibility/validation.d.ts

@@ -0,0 +1,11 @@
+import { type CustomCommandManifest, type HookDescriptor, type ValidationIssue, type ValidationKind, type ValidationSeverity } from "./schema.js";
+export declare const issueFromError: (kind: ValidationKind, path: string, error: unknown, options?: {
+    hint?: string;
+    severity?: ValidationSeverity;
+}) => ValidationIssue;
+export declare const validateCustomCommand: (manifest: CustomCommandManifest, path: string) => ValidationIssue[];
+export declare const validateCustomTool: (descriptor: unknown, path: string) => ValidationIssue[];
+export declare const validateHookDescriptor: (descriptor: HookDescriptor) => ValidationIssue[];
+export declare const formatValidationIssue: (issue: ValidationIssue) => string;
+export declare const hasBlockingIssues: (issues: ValidationIssue[]) => boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/extensibility/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/extensibility/validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAIN,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,MAAM,aAAa,CAAA;AAkCpB,eAAO,MAAM,cAAc,GAC1B,MAAM,cAAc,EACpB,MAAM,MAAM,EACZ,OAAO,OAAO,EACd,UAAU;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAAE,KACxD,eAoBF,CAAA;AAYD,eAAO,MAAM,qBAAqB,GAAI,UAAU,qBAAqB,EAAE,MAAM,MAAM,KAAG,eAAe,EAEpG,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,YAAY,OAAO,EAAE,MAAM,MAAM,KAAG,eAAe,EAErF,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,YAAY,cAAc,KAAG,eAAe,EAMlF,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAO,eAAe,KAAG,MAI9D,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,QAAQ,eAAe,EAAE,KAAG,OACX,CAAA"}