@yeshwanthyk/runtime-effect 0.1.0

package/dist/hooks/loader.js

@@ -0,0 +1,170 @@
+/**
+ * Hook loader - discovers and loads TypeScript hook modules.
+ *
+ * Hooks are loaded from ~/.config/marvin/hooks/*.ts (non-recursive).
+ * 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 { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { validateHookDescriptor, issueFromError } from "../extensibility/validation.js";
+/**
+ * Create a HookAPI instance that collects handlers.
+ * Returns the API and functions to set handlers later.
+ */
+function createHookAPI(handlers) {
+    let sendHandler = () => { };
+    let sendMessageHandler = () => { };
+    let sendUserMessageHandler = () => { };
+    let steerHandler = () => { };
+    let followUpHandler = () => { };
+    let isIdleHandler = () => true;
+    let appendEntryHandler = () => { };
+    const messageRenderers = new Map();
+    const commands = new Map();
+    const tools = new Map();
+    const api = {
+        on(event, handler) {
+            const list = handlers.get(event) ?? [];
+            list.push(handler);
+            handlers.set(event, list);
+        },
+        send(text) {
+            sendHandler(text);
+        },
+        sendUserMessage(text, options) {
+            return Promise.resolve(sendUserMessageHandler(text, options));
+        },
+        steer(text) {
+            return Promise.resolve(steerHandler(text));
+        },
+        followUp(text) {
+            return Promise.resolve(followUpHandler(text));
+        },
+        isIdle() {
+            return isIdleHandler();
+        },
+        sendMessage(message, triggerTurn) {
+            sendMessageHandler(message, triggerTurn);
+        },
+        appendEntry(customType, data) {
+            appendEntryHandler(customType, data);
+        },
+        registerMessageRenderer(customType, renderer) {
+            messageRenderers.set(customType, renderer);
+        },
+        registerCommand(name, options) {
+            commands.set(name, { name, ...options });
+        },
+        registerTool(tool) {
+            tools.set(tool.name, tool);
+        },
+    };
+    return {
+        api,
+        messageRenderers,
+        commands,
+        tools,
+        setSendHandler: (handler) => { sendHandler = handler; },
+        setSendMessageHandler: (handler) => { sendMessageHandler = handler; },
+        setSendUserMessageHandler: (handler) => { sendUserMessageHandler = handler; },
+        setSteerHandler: (handler) => { steerHandler = handler; },
+        setFollowUpHandler: (handler) => { followUpHandler = handler; },
+        setIsIdleHandler: (handler) => { isIdleHandler = handler; },
+        setAppendEntryHandler: (handler) => { appendEntryHandler = handler; },
+    };
+}
+/**
+ * Load a single hook module.
+ */
+async function loadHook(hookPath) {
+    try {
+        // Use file URL for import - Bun handles TS natively
+        const fileUrl = pathToFileURL(hookPath).href;
+        const module = await import(__rewriteRelativeImportExtension(fileUrl));
+        const factory = module.default;
+        if (typeof factory !== "function") {
+            return { hook: null, error: "Hook must export a default function" };
+        }
+        // Create handlers map and API
+        const handlers = new Map();
+        const { api, messageRenderers, commands, tools, setSendHandler, setSendMessageHandler, setSendUserMessageHandler, setSteerHandler, setFollowUpHandler, setIsIdleHandler, setAppendEntryHandler, } = createHookAPI(handlers);
+        // Call factory to register handlers
+        await factory(api);
+        return {
+            hook: {
+                path: hookPath,
+                handlers,
+                messageRenderers,
+                commands,
+                tools,
+                setSendHandler,
+                setSendMessageHandler,
+                setSendUserMessageHandler,
+                setSteerHandler,
+                setFollowUpHandler,
+                setIsIdleHandler,
+                setAppendEntryHandler,
+            },
+            error: null,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { hook: null, error: `Failed to load hook: ${message}` };
+    }
+}
+/**
+ * Discover hook files from a directory.
+ * Returns all .ts files in the directory (non-recursive).
+ */
+function discoverHooksInDir(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        return entries
+            .filter((e) => (e.isFile() || e.isSymbolicLink()) && e.name.endsWith(".ts"))
+            .map((e) => join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover and load hooks from the config directory.
+ * Loads from ~/.config/marvin/hooks/*.ts
+ *
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ */
+export async function loadHooks(configDir) {
+    const hooks = [];
+    const issues = [];
+    const hooksDir = join(configDir, "hooks");
+    const paths = discoverHooksInDir(hooksDir);
+    for (const hookPath of paths) {
+        const { hook, error } = await loadHook(hookPath);
+        if (error) {
+            issues.push(issueFromError("hook", hookPath, error));
+            continue;
+        }
+        if (hook) {
+            hooks.push(hook);
+            issues.push(...validateHookDescriptor({
+                path: hook.path,
+                events: Array.from(hook.handlers.keys()),
+            }));
+        }
+    }
+    return { hooks, issues };
+}
+//# sourceMappingURL=loader.js.map

package/dist/hooks/loader.js.map

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

package/dist/hooks/message-transformer.d.ts

@@ -0,0 +1,16 @@
+import type { Message } from "@yeshwanthyk/ai";
+import type { HookRunner } from "./runner.js";
+interface MessageLike {
+    role: string;
+    content?: unknown;
+    timestamp?: number;
+}
+/**
+ * Transform app messages to LLM-compatible messages.
+ * - Converts hook messages to user messages
+ * - Handles attachments (images, documents)
+ * - Applies chat.messages.transform hook
+ */
+export declare function transformMessages(hookRunner: HookRunner, messages: MessageLike[]): Promise<Message[]>;
+export {};
+//# sourceMappingURL=message-transformer.d.ts.map

package/dist/hooks/message-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-transformer.d.ts","sourceRoot":"","sources":["../../src/hooks/message-transformer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAS7C,UAAU,WAAW;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,WAAW,EAAE,GACrB,OAAO,CAAC,OAAO,EAAE,CAAC,CA4CpB"}

package/dist/hooks/message-transformer.js

@@ -0,0 +1,46 @@
+/**
+ * Transform app messages to LLM-compatible messages.
+ * - Converts hook messages to user messages
+ * - Handles attachments (images, documents)
+ * - Applies chat.messages.transform hook
+ */
+export async function transformMessages(hookRunner, messages) {
+    const llmMessages = [];
+    for (const message of messages) {
+        if (message.role === "hookMessage") {
+            const hookMsg = message;
+            const content = typeof hookMsg.content === "string"
+                ? [{ type: "text", text: hookMsg.content }]
+                : hookMsg.content;
+            llmMessages.push({ role: "user", content, timestamp: hookMsg.timestamp });
+            continue;
+        }
+        if (message.role === "user") {
+            const userMessage = message;
+            const { attachments, ...rest } = userMessage;
+            if (!attachments || attachments.length === 0) {
+                llmMessages.push(rest);
+                continue;
+            }
+            const content = Array.isArray(rest.content)
+                ? [...rest.content]
+                : [{ type: "text", text: rest.content }];
+            for (const attachment of attachments) {
+                if (attachment.type === "image") {
+                    content.push({ type: "image", data: attachment.content, mimeType: attachment.mimeType });
+                }
+                else if (attachment.type === "document" && attachment.extractedText) {
+                    content.push({ type: "text", text: `\n\n[Document: ${attachment.fileName}]\n${attachment.extractedText}` });
+                }
+            }
+            llmMessages.push({ ...rest, content });
+            continue;
+        }
+        if (message.role === "assistant" || message.role === "toolResult") {
+            llmMessages.push(message);
+        }
+    }
+    // Apply hook transforms
+    return hookRunner.emitContext(llmMessages);
+}
+//# sourceMappingURL=message-transformer.js.map

package/dist/hooks/message-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-transformer.js","sourceRoot":"","sources":["../../src/hooks/message-transformer.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,UAAsB,EACtB,QAAuB;IAEvB,MAAM,WAAW,GAAc,EAAE,CAAA;IAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,OAA0B,CAAA;YAC1C,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;gBAClD,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;YAClB,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;YACzE,SAAQ;QACT,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,OAAqC,CAAA;YACzD,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAA;YAC5C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9C,WAAW,CAAC,IAAI,CAAC,IAAe,CAAC,CAAA;gBACjC,SAAQ;YACT,CAAC;YAED,MAAM,OAAO,GAAmC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC1E,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;gBACnB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAiB,EAAE,CAAC,CAAA;YAEnD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACtC,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;gBACzF,CAAC;qBAAM,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,aAAa,EAAE,CAAC;oBACvE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,UAAU,CAAC,QAAQ,MAAM,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;gBAC5G,CAAC;YACF,CAAC;YAED,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAa,CAAC,CAAA;YACjD,SAAQ;QACT,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnE,WAAW,CAAC,IAAI,CAAC,OAAkB,CAAC,CAAA;QACrC,CAAC;IACF,CAAC;IAED,wBAAwB;IACxB,OAAO,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;AAC3C,CAAC"}

package/dist/hooks/runner.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Hook runner - executes hooks and manages event emission.
+ */
+import type { AppendEntryHandler, DeliveryHandler, IsIdleHandler, LoadedHook, SendHandler, SendMessageHandler, SendUserMessageHandler } from "./loader.js";
+import type { BeforeAgentStartResult, ChatMessageEvent, HookError, HookEvent, HookEventContext, HookEventType, HookMessageRenderer, HookSessionContext, HookUIContext, RegisteredCommand, RegisteredTool, TokenUsage, ToolExecuteBeforeEvent, ToolExecuteBeforeResult, ToolExecuteAfterEvent, ToolExecuteAfterResult } from "./types.js";
+import type { AgentRunConfig } from "@yeshwanthyk/agent-core";
+import type { Api, ImageContent, Message, Model } from "@yeshwanthyk/ai";
+import type { ReadonlySessionManager } from "../session-manager.js";
+/** Listener for hook errors */
+export type HookErrorListener = (error: HookError) => void;
+/**
+ * HookRunner executes hooks and manages event emission.
+ */
+export declare class HookRunner {
+    private hooks;
+    private cwd;
+    private configDir;
+    private sessionManager;
+    private uiContext;
+    private sessionContext;
+    private hasUI;
+    private errorListeners;
+    private sessionIdProvider;
+    private modelProvider;
+    private tokenUsage;
+    private contextLimit;
+    private sendUserMessageHandler;
+    private steerHandler;
+    private followUpHandler;
+    private isIdleHandler;
+    constructor(hooks: LoadedHook[], cwd: string, configDir: string, sessionManager: ReadonlySessionManager);
+    /**
+     * Initialize the runner with handlers and context providers.
+     * Must be called before emitting events.
+     */
+    initialize(options: {
+        sendHandler: SendHandler;
+        sendMessageHandler: SendMessageHandler;
+        sendUserMessageHandler: SendUserMessageHandler;
+        steerHandler: DeliveryHandler;
+        followUpHandler: DeliveryHandler;
+        isIdleHandler: IsIdleHandler;
+        appendEntryHandler: AppendEntryHandler;
+        getSessionId: () => string | null;
+        getModel: () => Model<Api> | null;
+        uiContext?: HookUIContext;
+        sessionContext?: HookSessionContext;
+        hasUI?: boolean;
+    }): void;
+    /** Update token usage for context tracking */
+    updateTokenUsage(tokens: TokenUsage, contextLimit: number): void;
+    /** Get the paths of all loaded hooks */
+    getHookPaths(): string[];
+    /**
+     * Set the send handler for all hooks' marvin.send().
+     * Call this when the app initializes.
+     */
+    setSendHandler(handler: SendHandler): void;
+    /** Subscribe to hook errors */
+    onError(listener: HookErrorListener): () => void;
+    private emitError;
+    private runHandlerEffect;
+    /** Check if any hooks have handlers for the given event type */
+    hasHandlers(eventType: HookEventType): boolean;
+    private createContext;
+    /**
+     * Emit a general event to all hooks.
+     * Errors are caught and reported, not propagated.
+     */
+    emit(event: HookEvent): Promise<void>;
+    /**
+     * Emit tool.execute.before event.
+     * If any hook blocks, returns the block result.
+     * If any hook errors, throws (fail-safe: block on error).
+     */
+    emitToolExecuteBefore(event: ToolExecuteBeforeEvent): Promise<ToolExecuteBeforeResult | undefined>;
+    /**
+     * Emit tool.execute.after event.
+     * Returns the last non-undefined result (for chaining modifications).
+     */
+    emitToolExecuteAfter(event: ToolExecuteAfterEvent): Promise<ToolExecuteAfterResult | undefined>;
+    /** Get current session ID */
+    getSessionId(): string | null;
+    /** Get current hook context */
+    getContext(): HookEventContext;
+    /** Get message renderer for a custom type */
+    getMessageRenderer(customType: string): HookMessageRenderer | undefined;
+    /** Get all registered commands */
+    getRegisteredCommands(): RegisteredCommand[];
+    /** Get a registered command by name */
+    getCommand(name: string): RegisteredCommand | undefined;
+    /** Get all registered tools */
+    getRegisteredTools(): RegisteredTool[];
+    /** Get a registered tool by name */
+    getTool(name: string): RegisteredTool | undefined;
+    /** Transform messages through chat.messages.transform hooks */
+    emitContext(messages: Message[]): Promise<Message[]>;
+    /** Emit chat.message event */
+    emitChatMessage(input: ChatMessageEvent["input"], output: ChatMessageEvent["output"]): Promise<void>;
+    /** Emit agent.before_start event and return first message result */
+    emitBeforeAgentStart(prompt: string, images?: ImageContent[]): Promise<BeforeAgentStartResult | undefined>;
+    /** Apply run config through chat/auth/model hooks */
+    applyRunConfig(cfg: AgentRunConfig, sessionId: string | null): Promise<AgentRunConfig>;
+}
+/**
+ * Create an empty hook runner (when no hooks are loaded).
+ */
+export declare function createEmptyRunner(cwd: string, configDir: string, sessionManager: ReadonlySessionManager): HookRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/hooks/runner.d.ts.map

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