opencode-command-hooks 0.1.0

package/dist/executor.js

@@ -0,0 +1,314 @@
+/**
+ * Unified hook executor for opencode-command-hooks
+ *
+ * Consolidates the logic for executing hooks across all event types (tool.execute.before,
+ * tool.execute.after, session.start, session.idle, etc.). This module provides a single
+ * entry point for hook execution that handles:
+ *
+ * 1. Filtering hooks based on execution context (event type, tool name, agent, etc.)
+ * 2. Executing hook commands via shell
+ * 3. Capturing and formatting command output
+ * 4. Injecting results into sessions via OpenCode SDK
+ * 5. Graceful error handling with non-blocking semantics
+ *
+ * Non-blocking error semantics: Hook failures never prevent tool/session execution.
+ * Errors are logged and optionally injected into the session, but never thrown.
+ */
+import { executeCommands } from "./execution/shell.js";
+import { interpolateTemplate } from "./execution/template.js";
+import { logger } from "./logging.js";
+/**
+ * Format an error message for injection into the session
+ *
+ * Creates a user-friendly error message that explains what went wrong
+ * with the hook execution.
+ *
+ * @param hookId - Hook ID that failed
+ * @param error - Error message or object
+ * @returns Formatted error message
+ */
+function formatErrorMessage(hookId, error) {
+    const errorText = error instanceof Error ? error.message : String(error || "Unknown error");
+    return `[opencode-command-hooks] Hook "${hookId}" failed: ${errorText}`;
+}
+/**
+ * Show a toast notification to the user
+ *
+ * Uses client.tui.showToast() to display a toast notification with the
+ * provided title, message, variant, and duration.
+ *
+ * @param client - OpenCode SDK client
+ * @param title - Optional title for the toast (defaults to "OpenCode Command Hook")
+ * @param message - Message text for the toast
+ * @param variant - Visual variant (info, success, warning, error)
+ * @param duration - Optional duration in milliseconds
+ * @returns Promise that resolves when toast is shown
+ */
+async function showToast(client, title, message, variant = "info", duration) {
+    try {
+        const finalTitle = title || "OpenCode Command Hook";
+        logger.debug(`Showing toast: title="${finalTitle}", message="${message.substring(0, 50)}...", variant="${variant}", duration=${duration}`);
+        await client.tui.showToast({
+            body: {
+                title: finalTitle,
+                message,
+                variant,
+                duration,
+            },
+        });
+        logger.info(`[toast] ${finalTitle}: ${message}`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to show toast: ${errorMessage}`);
+        // Don't throw - this is non-blocking
+    }
+}
+/**
+ * Inject a message into a session using the OpenCode SDK
+ *
+ * Uses client.session.promptAsync() with noReply: true to inject context
+ * without triggering an AI response.
+ *
+ * @param client - OpenCode SDK client
+ * @param sessionId - Session ID to inject into
+ * @param message - Message text to inject
+ * @returns Promise that resolves when message is injected
+ */
+async function injectMessage(client, sessionId, message) {
+    try {
+        logger.debug(`Injecting message into session ${sessionId}`);
+        await client.session.promptAsync({
+            path: { id: sessionId },
+            body: {
+                noReply: true,
+                parts: [{ type: "text", text: message }],
+            },
+        });
+        logger.info(`[inject] Message injected into session ${sessionId}: ${message.substring(0, 100)}${message.length > 100 ? '...' : ''}`);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to inject message into session: ${errorMessage}`);
+        throw error;
+    }
+}
+/**
+ * Execute a single tool hook
+ *
+ * Runs the hook's commands, interpolates the template if configured,
+ * and injects the result into the session if configured.
+ *
+ * @param hook - The tool hook to execute
+ * @param context - Execution context (tool name, session ID, agent, etc.)
+ * @param client - OpenCode SDK client for message injection
+ * @returns Promise that resolves when hook execution is complete
+ */
+async function executeToolHook(hook, context, client) {
+    logger.debug(`Executing tool hook "${hook.id}" for tool "${context.tool}"`);
+    try {
+        // Execute the hook's commands
+        const results = await executeCommands(hook.run, hook.id);
+        logger.debug(`Hook "${hook.id}" executed ${results.length} command(s)`);
+        // If inject is configured, prepare and inject the message
+        if (hook.inject) {
+            // Use the last command's result for template interpolation
+            const lastResult = results[results.length - 1];
+            // Build template context
+            const templateContext = {
+                id: hook.id,
+                agent: context.agent,
+                tool: context.tool,
+                cmd: Array.isArray(hook.run) ? hook.run[0] : hook.run,
+                stdout: lastResult?.stdout,
+                stderr: lastResult?.stderr,
+                exitCode: lastResult?.exitCode,
+            };
+            // Interpolate template
+            const message = interpolateTemplate(hook.inject, templateContext);
+            // Inject into session
+            await injectMessage(client, context.sessionId, message);
+        }
+        // If toast is configured, interpolate and show toast notification
+        if (hook.toast) {
+            // Use the last command's result for template interpolation
+            const lastResult = results[results.length - 1];
+            // Build template context
+            const templateContext = {
+                id: hook.id,
+                agent: context.agent,
+                tool: context.tool,
+                cmd: Array.isArray(hook.run) ? hook.run[0] : hook.run,
+                stdout: lastResult?.stdout,
+                stderr: lastResult?.stderr,
+                exitCode: lastResult?.exitCode,
+            };
+            // Interpolate toast title and message templates
+            const toastTitle = hook.toast.title ? interpolateTemplate(hook.toast.title, templateContext) : undefined;
+            const toastMessage = interpolateTemplate(hook.toast.message, templateContext);
+            // Show toast notification
+            await showToast(client, toastTitle, toastMessage, hook.toast.variant || "info", hook.toast.duration);
+        }
+    }
+    catch (error) {
+        // Log the error but don't throw - this is non-blocking
+        const errorMessage = formatErrorMessage(hook.id, error);
+        logger.error(errorMessage);
+        // Optionally inject error message into session
+        try {
+            await injectMessage(client, context.sessionId, errorMessage);
+        }
+        catch (injectionError) {
+            // If error injection fails, just log it
+            const injectionErrorMsg = injectionError instanceof Error
+                ? injectionError.message
+                : String(injectionError);
+            logger.error(`Failed to inject error message for hook "${hook.id}": ${injectionErrorMsg}`);
+        }
+    }
+}
+/**
+ * Execute a single session hook
+ *
+ * Runs the hook's commands, interpolates the template if configured,
+ * and injects the result into the session if configured.
+ *
+ * @param hook - The session hook to execute
+ * @param context - Execution context (session ID, agent, etc.)
+ * @param client - OpenCode SDK client for message injection
+ * @returns Promise that resolves when hook execution is complete
+ */
+async function executeSessionHook(hook, context, client) {
+    logger.debug(`Executing session hook "${hook.id}"`);
+    try {
+        // Execute the hook's commands
+        const results = await executeCommands(hook.run, hook.id);
+        logger.debug(`Hook "${hook.id}" executed ${results.length} command(s)`);
+        // If inject is configured, prepare and inject the message
+        if (hook.inject) {
+            // Use the last command's result for template interpolation
+            const lastResult = results[results.length - 1];
+            // Build template context
+            const templateContext = {
+                id: hook.id,
+                agent: context.agent,
+                cmd: Array.isArray(hook.run) ? hook.run[0] : hook.run,
+                stdout: lastResult?.stdout,
+                stderr: lastResult?.stderr,
+                exitCode: lastResult?.exitCode,
+            };
+            // Interpolate template
+            const message = interpolateTemplate(hook.inject, templateContext);
+            // Inject into session
+            await injectMessage(client, context.sessionId, message);
+        }
+        // If toast is configured, interpolate and show toast notification
+        if (hook.toast) {
+            // Use the last command's result for template interpolation
+            const lastResult = results[results.length - 1];
+            // Build template context
+            const templateContext = {
+                id: hook.id,
+                agent: context.agent,
+                cmd: Array.isArray(hook.run) ? hook.run[0] : hook.run,
+                stdout: lastResult?.stdout,
+                stderr: lastResult?.stderr,
+                exitCode: lastResult?.exitCode,
+            };
+            // Interpolate toast title and message templates
+            const toastTitle = hook.toast.title ? interpolateTemplate(hook.toast.title, templateContext) : undefined;
+            const toastMessage = interpolateTemplate(hook.toast.message, templateContext);
+            // Show toast notification
+            await showToast(client, toastTitle, toastMessage, hook.toast.variant || "info", hook.toast.duration);
+        }
+    }
+    catch (error) {
+        // Log the error but don't throw - this is non-blocking
+        const errorMessage = formatErrorMessage(hook.id, error);
+        logger.error(errorMessage);
+        // Optionally inject error message into session
+        try {
+            await injectMessage(client, context.sessionId, errorMessage);
+        }
+        catch (injectionError) {
+            // If error injection fails, just log it
+            const injectionErrorMsg = injectionError instanceof Error
+                ? injectionError.message
+                : String(injectionError);
+            logger.error(`Failed to inject error message for hook "${hook.id}": ${injectionErrorMsg}`);
+        }
+    }
+}
+/**
+ * Check if a hook is a tool hook
+ *
+ * @param hook - Hook to check
+ * @returns true if the hook is a ToolHook
+ */
+function isToolHook(hook) {
+    return "when" in hook && "phase" in hook.when;
+}
+/**
+ * Execute a collection of hooks
+ *
+ * Main entry point for hook execution. Handles both tool and session hooks,
+ * executing each matched hook in sequence. Implements non-blocking error semantics:
+ * any errors during hook execution are logged and optionally injected into the
+ * session, but never prevent the tool/session from executing.
+ *
+ * This function consolidates the logic that was previously duplicated across
+ * individual event handlers (tool-before, tool-after, session-start, session-idle).
+ *
+ * @param hooks - Array of hooks to execute (can be tool or session hooks)
+ * @param context - Execution context with session ID, agent, tool name, etc.
+ * @param client - OpenCode SDK client for message injection
+ * @returns Promise that resolves when all hooks are processed
+ *
+ * @example
+ * ```typescript
+ * // Execute tool hooks for a tool.execute.before event
+ * await executeHooks(matchedToolHooks, {
+ *   sessionId: "session-123",
+ *   agent: "build",
+ *   tool: "task",
+ *   slashCommand: undefined,
+ *   callId: "call-456"
+ * }, client)
+ *
+ * // Execute session hooks for a session.start event
+ * await executeHooks(matchedSessionHooks, {
+ *   sessionId: "session-123",
+ *   agent: "build"
+ * }, client)
+ * ```
+ */
+export async function executeHooks(hooks, context, client) {
+    try {
+        logger.debug(`executeHooks called with ${hooks.length} hook(s) for session "${context.sessionId}"`);
+        // Execute each hook
+        for (const hook of hooks) {
+            try {
+                if (isToolHook(hook)) {
+                    await executeToolHook(hook, context, client);
+                }
+                else {
+                    await executeSessionHook(hook, context, client);
+                }
+            }
+            catch (error) {
+                // Catch errors from individual hook execution and continue
+                // (errors are already logged and injected by the hook execution functions)
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.error(`Unexpected error executing hook "${hook.id}": ${errorMessage}`);
+            }
+        }
+        logger.debug(`executeHooks completed for ${hooks.length} hook(s)`);
+    }
+    catch (error) {
+        // Catch-all for unexpected errors
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Unexpected error in executeHooks: ${errorMessage}`);
+        // Don't throw - this is non-blocking
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export { executeHooks } from "./executor.js";
+/**
+ * OpenCode Command Hooks Plugin
+ *
+ * Allows users to declaratively attach shell commands to agent/tool/slash-command
+ * lifecycle events via configuration in opencode.json or markdown frontmatter.
+ *
+ * Features:
+ * - Tool hooks (before/after tool execution)
+ * - Session hooks (on session lifecycle events)
+ * - Configuration via global config or per-agent/command markdown
+ * - Non-blocking error semantics
+ *
+ * Architecture:
+ * - Simplified event handlers that extract context and call executeHooks
+ * - No state tracking (pendingAfterEvents, completedAfterEvents removed)
+ * - Unified executor handles all hook matching and execution
+ */
+declare const plugin: Plugin;
+export default plugin;
+//# 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":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAUjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAiG5C;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,MAAM,EAAE,MAoWb,CAAA;AAED,eAAe,MAAM,CAAA"}