opencode-command-hooks 0.1.0

package/dist/execution/shell.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shell command execution module for opencode-command-hooks
+ *
+ * Provides functions to execute shell commands using Bun's $ template literals
+ * with proper error handling, output capture, and truncation.
+ *
+ * Key features:
+ * - Execute single or multiple commands sequentially
+ * - Capture stdout, stderr, and exit codes
+ * - Truncate output to configurable limit (default: 30,000 chars, matching OpenCode)
+ * - Never throw errors - always return results
+ * - Support debug logging via OPENCODE_HOOKS_DEBUG
+ */
+import type { HookExecutionResult } from "../types/hooks.js";
+/**
+ * Execute a single shell command
+ *
+ * @param command - Shell command to execute
+ * @param options - Execution options
+ * @returns HookExecutionResult with command output and exit code
+ *
+ * @example
+ * ```typescript
+ * const result = await executeCommand("pnpm test")
+ * console.log(result.exitCode, result.stdout)
+ * ```
+ */
+export declare function executeCommand(command: string, options?: {
+    truncateOutput?: number;
+}): Promise<HookExecutionResult>;
+/**
+ * Execute multiple shell commands sequentially
+ *
+ * Commands run one after another, even if earlier commands fail.
+ * Each command's result is captured and returned separately.
+ *
+ * @param commands - Single command string or array of command strings
+ * @param hookId - Hook ID for tracking (included in results)
+ * @param options - Execution options
+ * @returns Array of HookExecutionResult, one per command
+ *
+ * @example
+ * ```typescript
+ * const results = await executeCommands(
+ *   ["pnpm lint", "pnpm test"],
+ *   "my-hook",
+ *   { truncateOutput: 2000 }
+ * )
+ * results.forEach(r => console.log(r.exitCode))
+ * ```
+ */
+export declare function executeCommands(commands: string | string[], hookId: string, options?: {
+    truncateOutput?: number;
+}): Promise<HookExecutionResult[]>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/execution/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/execution/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AA+B5D;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAuC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA+ChC"}

package/dist/execution/shell.js

@@ -0,0 +1,187 @@
+/**
+ * Shell command execution module for opencode-command-hooks
+ *
+ * Provides functions to execute shell commands using Bun's $ template literals
+ * with proper error handling, output capture, and truncation.
+ *
+ * Key features:
+ * - Execute single or multiple commands sequentially
+ * - Capture stdout, stderr, and exit codes
+ * - Truncate output to configurable limit (default: 30,000 chars, matching OpenCode)
+ * - Never throw errors - always return results
+ * - Support debug logging via OPENCODE_HOOKS_DEBUG
+ */
+import { logger } from "../logging.js";
+const DEFAULT_TRUNCATE_LIMIT = 30000;
+/**
+ * Check if debug logging is enabled
+ */
+function isDebugEnabled() {
+    return process.env.OPENCODE_HOOKS_DEBUG === "1" || process.env.OPENCODE_HOOKS_DEBUG === "true";
+}
+/**
+ * Truncate text to a maximum length, matching OpenCode's bash tool behavior
+ */
+function truncateText(text, limit) {
+    if (!text)
+        return "";
+    if (text.length <= limit)
+        return text;
+    const truncated = text.slice(0, limit);
+    const metadata = [
+        "",
+        "",
+        "<bash_metadata>",
+        `bash tool truncated output as it exceeded ${limit} char limit`,
+        "</bash_metadata>"
+    ].join("\n");
+    return truncated + metadata;
+}
+/**
+ * Execute a single shell command
+ *
+ * @param command - Shell command to execute
+ * @param options - Execution options
+ * @returns HookExecutionResult with command output and exit code
+ *
+ * @example
+ * ```typescript
+ * const result = await executeCommand("pnpm test")
+ * console.log(result.exitCode, result.stdout)
+ * ```
+ */
+export async function executeCommand(command, options) {
+    const truncateLimit = options?.truncateOutput ?? DEFAULT_TRUNCATE_LIMIT;
+    const hookId = "command"; // Will be set by caller
+    if (isDebugEnabled()) {
+        logger.debug(`Executing command: ${command}`);
+    }
+    try {
+        // Execute command using Bun's $ template literal with nothrow to prevent throwing on non-zero exit
+        // We need to use dynamic template literal evaluation
+        const result = await executeShellCommand(command);
+        const stdout = truncateText(result.stdout, truncateLimit);
+        const stderr = truncateText(result.stderr, truncateLimit);
+        const exitCode = result.exitCode ?? 0;
+        const success = exitCode === 0;
+        if (isDebugEnabled()) {
+            logger.debug(`Command completed: exit ${exitCode}, stdout length: ${stdout.length}, stderr length: ${stderr.length}`);
+        }
+        return {
+            hookId,
+            success,
+            exitCode,
+            stdout,
+            stderr,
+        };
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        logger.error(`Failed to execute command: ${errorMessage}`);
+        return {
+            hookId,
+            success: false,
+            error: errorMessage,
+        };
+    }
+}
+/**
+ * Execute multiple shell commands sequentially
+ *
+ * Commands run one after another, even if earlier commands fail.
+ * Each command's result is captured and returned separately.
+ *
+ * @param commands - Single command string or array of command strings
+ * @param hookId - Hook ID for tracking (included in results)
+ * @param options - Execution options
+ * @returns Array of HookExecutionResult, one per command
+ *
+ * @example
+ * ```typescript
+ * const results = await executeCommands(
+ *   ["pnpm lint", "pnpm test"],
+ *   "my-hook",
+ *   { truncateOutput: 2000 }
+ * )
+ * results.forEach(r => console.log(r.exitCode))
+ * ```
+ */
+export async function executeCommands(commands, hookId, options) {
+    const truncateLimit = options?.truncateOutput ?? DEFAULT_TRUNCATE_LIMIT;
+    const commandArray = Array.isArray(commands) ? commands : [commands];
+    if (isDebugEnabled()) {
+        logger.debug(`Executing ${commandArray.length} command(s) for hook "${hookId}"`);
+    }
+    const results = [];
+    for (const command of commandArray) {
+        try {
+            if (isDebugEnabled()) {
+                logger.debug(`[${hookId}] Executing: ${command}`);
+            }
+            const result = await executeShellCommand(command);
+            const stdout = truncateText(result.stdout, truncateLimit);
+            const stderr = truncateText(result.stderr, truncateLimit);
+            const exitCode = result.exitCode ?? 0;
+            const success = exitCode === 0;
+            if (isDebugEnabled()) {
+                logger.debug(`[${hookId}] Command completed: exit ${exitCode}, stdout length: ${stdout.length}, stderr length: ${stderr.length}`);
+            }
+            results.push({
+                hookId,
+                success,
+                exitCode,
+                stdout,
+                stderr,
+            });
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            logger.error(`[${hookId}] Failed to execute command: ${errorMessage}`);
+            results.push({
+                hookId,
+                success: false,
+                error: errorMessage,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Internal helper to execute a shell command using Bun's $ API
+ *
+ * This function handles the actual shell execution with proper error handling.
+ * Uses Bun's $ template literal with .nothrow() to prevent throwing on non-zero
+ * exit codes and .quiet() to capture output without printing to console.
+ *
+ * @param command - Shell command to execute
+ * @returns Object with stdout, stderr, and exitCode
+ */
+async function executeShellCommand(command) {
+    try {
+        // Use Bun's $ template literal to execute the command
+        // The nothrow() method prevents throwing on non-zero exit codes
+        // The quiet() method suppresses output and returns Buffers
+        const result = await Bun.$ `sh -c ${command}`.nothrow().quiet();
+        // Extract stdout and stderr as text
+        // result.stdout and result.stderr are Buffers, convert to string
+        const stdout = result.stdout instanceof Buffer ? result.stdout.toString() : String(result.stdout);
+        const stderr = result.stderr instanceof Buffer ? result.stderr.toString() : String(result.stderr);
+        const exitCode = result.exitCode ?? 0;
+        return {
+            stdout,
+            stderr,
+            exitCode,
+        };
+    }
+    catch (error) {
+        // If Bun shell execution fails unexpectedly, return error details
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Unexpected error executing command: ${errorMessage}`);
+        return {
+            stdout: "",
+            stderr: errorMessage,
+            exitCode: 1,
+        };
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/execution/shell.js.map

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

package/dist/execution/template.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Template interpolation module for opencode-command-hooks
+ *
+ * Provides functions to replace placeholders in template strings with values
+ * from hook execution context. Supports graceful handling of missing values
+ * and multi-line templates.
+ *
+ * Supported placeholders:
+ * - {id} - hook ID
+ * - {agent} - agent name (if available)
+ * - {tool} - tool name (if available)
+ * - {cmd} - command string (if available)
+ * - {stdout} - command stdout (if available)
+ * - {stderr} - command stderr (if available)
+ * - {exitCode} - command exit code (if available)
+ */
+import type { TemplateContext } from "../types/hooks.js";
+/**
+ * Interpolate a template string by replacing placeholders with context values
+ *
+ * Replaces the following placeholders:
+ * - {id} - hook ID (required, always available)
+ * - {agent} - agent name (optional)
+ * - {tool} - tool name (optional)
+ * - {cmd} - command string (optional)
+ * - {stdout} - command stdout (optional)
+ * - {stderr} - command stderr (optional)
+ * - {exitCode} - command exit code (optional)
+ *
+ * Missing values are replaced with empty strings. The function never throws
+ * and always returns a valid string.
+ *
+ * @param template - Template string with placeholders
+ * @param context - TemplateContext with values for substitution
+ * @returns Interpolated string with placeholders replaced
+ *
+ * @example
+ * ```typescript
+ * const context: TemplateContext = {
+ *   id: "tests-after-task",
+ *   agent: "build",
+ *   tool: "task",
+ *   cmd: "pnpm test",
+ *   stdout: "✓ All tests passed",
+ *   stderr: "",
+ *   exitCode: 0
+ * }
+ *
+ * const template = "Hook {id} for {tool} completed: exit {exitCode}\n```\n{stdout}\n```"
+ * const result = interpolateTemplate(template, context)
+ * // Result: "Hook tests-after-task for task completed: exit 0\n```\n✓ All tests passed\n```"
+ * ```
+ */
+export declare function interpolateTemplate(template: string | undefined, context: TemplateContext): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/execution/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/execution/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA2BxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAmClG"}

package/dist/execution/template.js

@@ -0,0 +1,106 @@
+/**
+ * Template interpolation module for opencode-command-hooks
+ *
+ * Provides functions to replace placeholders in template strings with values
+ * from hook execution context. Supports graceful handling of missing values
+ * and multi-line templates.
+ *
+ * Supported placeholders:
+ * - {id} - hook ID
+ * - {agent} - agent name (if available)
+ * - {tool} - tool name (if available)
+ * - {cmd} - command string (if available)
+ * - {stdout} - command stdout (if available)
+ * - {stderr} - command stderr (if available)
+ * - {exitCode} - command exit code (if available)
+ */
+import { logger } from "../logging.js";
+/**
+ * Check if debug logging is enabled
+ */
+function isDebugEnabled() {
+    return process.env.OPENCODE_HOOKS_DEBUG === "1" || process.env.OPENCODE_HOOKS_DEBUG === "true";
+}
+/**
+ * Replace a placeholder in a template string with a value
+ *
+ * @param template - The template string
+ * @param placeholder - The placeholder name (without braces, e.g., "id", "stdout")
+ * @param value - The value to replace with (undefined becomes empty string)
+ * @returns The template with the placeholder replaced
+ */
+function replacePlaceholder(template, placeholder, value) {
+    // Convert value to string, handling undefined/null
+    const stringValue = value === undefined || value === null ? "" : String(value);
+    // Create regex to match {placeholder} globally
+    const regex = new RegExp(`\\{${placeholder}\\}`, "g");
+    return template.replace(regex, stringValue);
+}
+/**
+ * Interpolate a template string by replacing placeholders with context values
+ *
+ * Replaces the following placeholders:
+ * - {id} - hook ID (required, always available)
+ * - {agent} - agent name (optional)
+ * - {tool} - tool name (optional)
+ * - {cmd} - command string (optional)
+ * - {stdout} - command stdout (optional)
+ * - {stderr} - command stderr (optional)
+ * - {exitCode} - command exit code (optional)
+ *
+ * Missing values are replaced with empty strings. The function never throws
+ * and always returns a valid string.
+ *
+ * @param template - Template string with placeholders
+ * @param context - TemplateContext with values for substitution
+ * @returns Interpolated string with placeholders replaced
+ *
+ * @example
+ * ```typescript
+ * const context: TemplateContext = {
+ *   id: "tests-after-task",
+ *   agent: "build",
+ *   tool: "task",
+ *   cmd: "pnpm test",
+ *   stdout: "✓ All tests passed",
+ *   stderr: "",
+ *   exitCode: 0
+ * }
+ *
+ * const template = "Hook {id} for {tool} completed: exit {exitCode}\n```\n{stdout}\n```"
+ * const result = interpolateTemplate(template, context)
+ * // Result: "Hook tests-after-task for task completed: exit 0\n```\n✓ All tests passed\n```"
+ * ```
+ */
+export function interpolateTemplate(template, context) {
+    // Handle null/undefined template
+    if (!template) {
+        return "";
+    }
+    if (isDebugEnabled()) {
+        logger.debug(`Interpolating template with context: ${JSON.stringify({
+            id: context.id,
+            agent: context.agent,
+            tool: context.tool,
+            cmd: context.cmd ? `${context.cmd.substring(0, 50)}...` : undefined,
+            stdout: context.stdout ? `${context.stdout.substring(0, 50)}...` : undefined,
+            stderr: context.stderr ? `${context.stderr.substring(0, 50)}...` : undefined,
+            exitCode: context.exitCode,
+        })}`);
+    }
+    let result = template;
+    // Replace all placeholders
+    // Order doesn't matter since each placeholder is unique
+    result = replacePlaceholder(result, "id", context.id);
+    result = replacePlaceholder(result, "agent", context.agent);
+    result = replacePlaceholder(result, "tool", context.tool);
+    result = replacePlaceholder(result, "cmd", context.cmd);
+    result = replacePlaceholder(result, "stdout", context.stdout);
+    result = replacePlaceholder(result, "stderr", context.stderr);
+    result = replacePlaceholder(result, "exitCode", context.exitCode);
+    if (isDebugEnabled()) {
+        logger.debug(`Template interpolation complete, result length: ${result.length}`);
+    }
+    return result;
+}
+//# sourceMappingURL=template.js.map

package/dist/execution/template.js.map

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

package/dist/executor.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 type { OpencodeClient } from "@opencode-ai/sdk";
+import type { ToolHook, SessionHook, HookExecutionContext } from "./types/hooks.js";
+/**
+ * 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 declare function executeHooks(hooks: (ToolHook | SessionHook)[], context: HookExecutionContext, client: OpencodeClient): Promise<void>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EACT,QAAQ,EACR,WAAW,EAEX,oBAAoB,EACtB,MAAM,kBAAkB,CAAA;AAqTzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,YAAY,CAC/B,KAAK,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,EACjC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAmCf"}