opencode-command-hooks 0.1.0

package/dist/index.js

@@ -0,0 +1,359 @@
+import { createLogger, setGlobalLogger, logger } from "./logging.js";
+import { executeHooks } from "./executor.js";
+import { loadGlobalConfig } from "./config/global.js";
+import { loadAgentConfig } from "./config/agent.js";
+import { mergeConfigs } from "./config/merge.js";
+// Export unified executor
+export { executeHooks } from "./executor.js";
+/**
+ * Helper to extract string values from event properties
+ */
+function normalizeString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+const TOOL_ARGS_TTL_MS = 5 * 60 * 1000;
+const toolCallArgsCache = new Map();
+function storeToolArgs(callId, args) {
+    if (!callId || !args)
+        return;
+    const existing = toolCallArgsCache.get(callId);
+    if (existing?.cleanup) {
+        clearTimeout(existing.cleanup);
+    }
+    const cleanup = setTimeout(() => {
+        toolCallArgsCache.delete(callId);
+    }, TOOL_ARGS_TTL_MS);
+    toolCallArgsCache.set(callId, { args, cleanup });
+}
+function getToolArgs(callId) {
+    if (!callId)
+        return undefined;
+    return toolCallArgsCache.get(callId)?.args;
+}
+function deleteToolArgs(callId) {
+    if (!callId)
+        return;
+    const entry = toolCallArgsCache.get(callId);
+    if (entry?.cleanup) {
+        clearTimeout(entry.cleanup);
+    }
+    toolCallArgsCache.delete(callId);
+}
+/**
+ * Check if a value matches a pattern (string, array of strings, or wildcard)
+ */
+function matches(pattern, value) {
+    if (!pattern)
+        return true; // Omitted pattern matches all
+    if (pattern === "*")
+        return true; // Wildcard matches all
+    if (Array.isArray(pattern))
+        return value ? pattern.includes(value) : false;
+    return value === pattern;
+}
+/**
+ * Filter session hooks that match the given criteria
+ */
+function filterSessionHooks(hooks, criteria) {
+    return hooks.filter((hook) => {
+        if (hook.when.event !== criteria.event)
+            return false;
+        return matches(hook.when.agent, criteria.agent);
+    });
+}
+/**
+ * Filter tool hooks that match the given criteria
+ */
+function filterToolHooks(hooks, criteria) {
+    return hooks.filter((hook) => {
+        if (hook.when.phase !== criteria.phase)
+            return false;
+        if (!matches(hook.when.tool, criteria.toolName))
+            return false;
+        if (!matches(hook.when.callingAgent, criteria.callingAgent))
+            return false;
+        if (!matches(hook.when.slashCommand, criteria.slashCommand))
+            return false;
+        // Match tool args if specified in the hook
+        if (hook.when.toolArgs && criteria.toolArgs) {
+            for (const [key, expectedValue] of Object.entries(hook.when.toolArgs)) {
+                const actualValue = criteria.toolArgs[key];
+                if (!matches(expectedValue, actualValue)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    });
+}
+/**
+ * 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
+ */
+const plugin = async ({ client }) => {
+    const clientLogger = createLogger(client);
+    setGlobalLogger(clientLogger);
+    try {
+        logger.info("Initializing OpenCode Command Hooks plugin...");
+        const hooks = {
+            /**
+             * Config hook for plugin initialization
+             * Called by OpenCode during plugin initialization to provide configuration.
+             * We don't need to do anything with this config as we load our configuration
+             * from .opencode/command-hooks.jsonc, but we need to implement this hook
+             * to prevent OpenCode from throwing an error when it tries to call it.
+             */
+            config: async (_input) => {
+                void _input;
+                logger.debug("Config hook called");
+                // No-op for now - we load config from .opencode/command-hooks.jsonc
+                // This hook is called by OpenCode during plugin initialization
+            },
+            /**
+             * Event hook for session lifecycle events
+             * Supports: session.start, session.idle, tool.result
+             *
+             * Note: The Plugin type from @opencode-ai/plugin may not include session.start
+             * in its event type union, but it is documented as a supported event in the
+             * OpenCode SDK. We use a type assertion to allow this event type.
+             */
+            event: async ({ event }) => {
+                // Handle session.start event
+                if (event.type === "session.start") {
+                    logger.debug("Received session.start event");
+                    const sessionId = normalizeString(event.properties?.sessionID);
+                    const agent = normalizeString(event.properties?.agent);
+                    if (!sessionId) {
+                        logger.debug("session.start event missing sessionID");
+                        return;
+                    }
+                    try {
+                        // Load config
+                        const globalConfig = await loadGlobalConfig();
+                        const markdownConfig = { tool: [], session: [] };
+                        const { config: mergedConfig } = mergeConfigs(globalConfig, markdownConfig);
+                        // Filter session hooks for session.start
+                        const matchedHooks = filterSessionHooks(mergedConfig.session || [], {
+                            event: "session.start",
+                            agent,
+                        });
+                        logger.debug(`Matched ${matchedHooks.length} hook(s) for session.start`);
+                        // Build execution context
+                        const context = {
+                            sessionId,
+                            agent: agent || "unknown",
+                        };
+                        // Execute hooks
+                        await executeHooks(matchedHooks, context, client);
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        logger.error(`Error handling session.start event: ${errorMessage}`);
+                    }
+                }
+                // Handle session.idle event
+                if (event.type === "session.idle") {
+                    logger.debug("Received session.idle event");
+                    const sessionId = normalizeString(event.properties?.sessionID);
+                    const agent = normalizeString(event.properties?.agent);
+                    if (!sessionId) {
+                        logger.debug("session.idle event missing sessionID");
+                        return;
+                    }
+                    try {
+                        // Load config
+                        const globalConfig = await loadGlobalConfig();
+                        const markdownConfig = { tool: [], session: [] };
+                        const { config: mergedConfig } = mergeConfigs(globalConfig, markdownConfig);
+                        // Filter session hooks for session.idle
+                        const matchedHooks = filterSessionHooks(mergedConfig.session || [], {
+                            event: "session.idle",
+                            agent,
+                        });
+                        logger.debug(`Matched ${matchedHooks.length} hook(s) for session.idle`);
+                        // Build execution context
+                        const context = {
+                            sessionId,
+                            agent: agent || "unknown",
+                        };
+                        // Execute hooks
+                        await executeHooks(matchedHooks, context, client);
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        logger.error(`Error handling session.idle event: ${errorMessage}`);
+                    }
+                }
+                // Handle tool.result event (fires when tool finishes)
+                if (event.type === "tool.result") {
+                    logger.debug("Received tool.result event");
+                    const toolName = normalizeString(event.properties?.name ?? event.properties?.tool);
+                    const sessionId = normalizeString(event.properties?.sessionID ?? event.properties?.sessionId);
+                    const agent = normalizeString(event.properties?.agent);
+                    const callId = normalizeString(event.properties?.callID ?? event.properties?.callId);
+                    const storedToolArgs = getToolArgs(callId);
+                    if (!sessionId || !toolName) {
+                        logger.debug("tool.result event missing sessionID or tool name");
+                        return;
+                    }
+                    try {
+                        // Load global config
+                        const globalConfig = await loadGlobalConfig();
+                        // Load agent-specific config if this is a task tool with subagent_type
+                        let agentConfig = { tool: [], session: [] };
+                        if (toolName === "task" && storedToolArgs) {
+                            const subagentType = normalizeString(storedToolArgs.subagent_type);
+                            if (subagentType) {
+                                logger.debug(`Detected task tool call with subagent_type: ${subagentType}`);
+                                agentConfig = await loadAgentConfig(subagentType);
+                            }
+                        }
+                        const { config: mergedConfig } = mergeConfigs(globalConfig, agentConfig);
+                        // Filter tool hooks for after phase
+                        const matchedHooks = filterToolHooks(mergedConfig.tool || [], {
+                            phase: "after",
+                            toolName,
+                            callingAgent: agent,
+                            slashCommand: normalizeString(event.properties?.slashCommand),
+                            toolArgs: storedToolArgs,
+                        });
+                        logger.debug(`Matched ${matchedHooks.length} hook(s) for tool.result (after phase)`);
+                        // Build execution context
+                        const context = {
+                            sessionId,
+                            agent: agent || "unknown",
+                            tool: toolName,
+                            callId,
+                            toolArgs: storedToolArgs,
+                        };
+                        // Execute hooks
+                        await executeHooks(matchedHooks, context, client);
+                        deleteToolArgs(callId);
+                    }
+                    catch (error) {
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        logger.error(`Error handling tool.result event: ${errorMessage}`);
+                    }
+                }
+            },
+            /**
+             * Tool execution before hook
+             * Runs before a tool is executed
+             */
+            "tool.execute.before": async (input, output) => {
+                logger.debug(`Received tool.execute.before for tool: ${input.tool}`);
+                try {
+                    // Load global config
+                    const globalConfig = await loadGlobalConfig();
+                    // Load agent-specific config if this is a task tool with subagent_type
+                    let agentConfig = { tool: [], session: [] };
+                    let subagentType;
+                    if (input.tool === "task") {
+                        subagentType = normalizeString(output.args.subagent_type) || undefined;
+                        if (subagentType) {
+                            logger.debug(`Detected task tool call with subagent_type: ${subagentType}`);
+                            agentConfig = await loadAgentConfig(subagentType);
+                        }
+                    }
+                    const { config: mergedConfig } = mergeConfigs(globalConfig, agentConfig);
+                    // Filter tool hooks for before phase
+                    const matchedHooks = filterToolHooks(mergedConfig.tool || [], {
+                        phase: "before",
+                        toolName: input.tool,
+                        callingAgent: subagentType,
+                        slashCommand: undefined,
+                        toolArgs: output.args,
+                    });
+                    logger.debug(`Matched ${matchedHooks.length} hook(s) for tool.execute.before`);
+                    // Build execution context
+                    const context = {
+                        sessionId: input.sessionID,
+                        agent: subagentType || "unknown",
+                        tool: input.tool,
+                        callId: input.callID,
+                        toolArgs: output.args,
+                    };
+                    storeToolArgs(input.callID, output.args);
+                    // Execute hooks
+                    await executeHooks(matchedHooks, context, client);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    logger.error(`Error handling tool.execute.before: ${errorMessage}`);
+                }
+            },
+            /**
+             * Tool execution after hook
+             * Runs after a tool completes (only if output is present - sync tools)
+             */
+            "tool.execute.after": async (input, toolOutput) => {
+                logger.debug(`Received tool.execute.after for tool: ${input.tool}`);
+                // Only process if output is present (sync tools)
+                if (!toolOutput) {
+                    logger.debug(`Skipping tool.execute.after for ${input.tool}: no output (async tool)`);
+                    return;
+                }
+                const storedToolArgs = getToolArgs(input.callID);
+                try {
+                    // Load global config
+                    const globalConfig = await loadGlobalConfig();
+                    // Load agent-specific config if this is a task tool with subagent_type
+                    let agentConfig = { tool: [], session: [] };
+                    let subagentType;
+                    if (input.tool === "task" && storedToolArgs) {
+                        subagentType = normalizeString(storedToolArgs.subagent_type) || undefined;
+                        if (subagentType) {
+                            logger.debug(`Detected task tool call with subagent_type: ${subagentType}`);
+                            agentConfig = await loadAgentConfig(subagentType);
+                        }
+                    }
+                    const { config: mergedConfig } = mergeConfigs(globalConfig, agentConfig);
+                    // Filter tool hooks for after phase
+                    const matchedHooks = filterToolHooks(mergedConfig.tool || [], {
+                        phase: "after",
+                        toolName: input.tool,
+                        callingAgent: subagentType,
+                        slashCommand: undefined,
+                        toolArgs: storedToolArgs,
+                    });
+                    logger.debug(`Matched ${matchedHooks.length} hook(s) for tool.execute.after`);
+                    // Build execution context
+                    const context = {
+                        sessionId: input.sessionID,
+                        agent: subagentType || "unknown",
+                        tool: input.tool,
+                        callId: input.callID,
+                        toolArgs: storedToolArgs,
+                    };
+                    // Execute hooks
+                    await executeHooks(matchedHooks, context, client);
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    logger.error(`Error handling tool.execute.after: ${errorMessage}`);
+                }
+            },
+        };
+        logger.info(`Plugin returning hooks: ${Object.keys(hooks).join(", ")}`);
+        return hooks;
+    }
+    catch (error) {
+        logger.error(`Error in plugin initialization: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,24 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
+export type LogLevel = "debug" | "info" | "error";
+/**
+ * Creates a logger that uses OpenCode's SDK logging.
+ * Logs are written to ~/.local/share/opencode/log/
+ */
+export declare function createLogger(client: OpencodeClient): {
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    error: (message: string) => void;
+};
+export type Logger = ReturnType<typeof createLogger>;
+/**
+ * Set the global logger instance.
+ * Called once during plugin initialization with the SDK client.
+ */
+export declare function setGlobalLogger(newLogger: Logger): void;
+/**
+ * Proxy logger that always delegates to the current global logger.
+ * This allows modules to import `logger` at load time, and it will
+ * correctly use the real logger once it's initialized.
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AAEjD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc;qBAiB9B,MAAM;oBACP,MAAM;qBACL,MAAM;EAE1B;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;AAYpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,MAUV,CAAA"}

package/dist/logging.js

@@ -0,0 +1,57 @@
+/**
+ * Creates a logger that uses OpenCode's SDK logging.
+ * Logs are written to ~/.local/share/opencode/log/
+ */
+export function createLogger(client) {
+    const log = (level, message) => {
+        if (client?.app?.log) {
+            client.app.log({
+                body: {
+                    service: "opencode-command-hooks",
+                    level,
+                    message,
+                },
+            }).catch((error) => {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.error(`[opencode-command-hooks] Failed to log: ${errorMessage}`);
+            });
+        }
+    };
+    return {
+        debug: (message) => log("debug", message),
+        info: (message) => log("info", message),
+        error: (message) => log("error", message),
+    };
+}
+// Internal global logger state
+let globalLogger = null;
+// No-op logger for when no client is available
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    error: () => { },
+};
+/**
+ * Set the global logger instance.
+ * Called once during plugin initialization with the SDK client.
+ */
+export function setGlobalLogger(newLogger) {
+    globalLogger = newLogger;
+}
+/**
+ * Proxy logger that always delegates to the current global logger.
+ * This allows modules to import `logger` at load time, and it will
+ * correctly use the real logger once it's initialized.
+ */
+export const logger = {
+    get debug() {
+        return (globalLogger ?? noopLogger).debug;
+    },
+    get info() {
+        return (globalLogger ?? noopLogger).info;
+    },
+    get error() {
+        return (globalLogger ?? noopLogger).error;
+    },
+};
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,GAAG,GAAG,CAAC,KAAe,EAAE,OAAe,EAAQ,EAAE;QACrD,IAAI,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;gBACb,IAAI,EAAE;oBACJ,OAAO,EAAE,wBAAwB;oBACjC,KAAK;oBACL,OAAO;iBACR;aACF,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACjB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC3E,OAAO,CAAC,KAAK,CAAC,2CAA2C,YAAY,EAAE,CAAC,CAAA;YAC1E,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;QACjD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;QAC/C,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;KAClD,CAAA;AACH,CAAC;AAID,+BAA+B;AAC/B,IAAI,YAAY,GAAkB,IAAI,CAAA;AAEtC,+CAA+C;AAC/C,MAAM,UAAU,GAAW;IACzB,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,YAAY,GAAG,SAAS,CAAA;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,IAAI,KAAK;QACP,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC,KAAK,CAAA;IAC3C,CAAC;IACD,IAAI,IAAI;QACN,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC,IAAI,CAAA;IAC1C,CAAC;IACD,IAAI,KAAK;QACP,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC,KAAK,CAAA;IAC3C,CAAC;CACQ,CAAA"}