opencode-command-hooks 0.1.0

package/dist/types/hooks.d.ts

@@ -0,0 +1,635 @@
+/**
+ * Type definitions for command hooks configuration
+ * Supports tool hooks and session hooks with flexible matching and injection
+ *
+ * Hooks allow users to declaratively attach shell commands to agent/tool/slash-command
+ * lifecycle events. They can be defined in:
+ * - Global config in opencode.json/.opencode.jsonc
+ * - Per-agent YAML frontmatter in agent markdown
+ * - Per-slash-command YAML frontmatter in command markdown
+ */
+/**
+ * Simplified agent hooks configuration for markdown frontmatter
+ *
+ * This is the new, simplified schema for defining hooks in agent markdown files.
+ * It's much more concise than the full CommandHooksConfig format.
+ *
+ * @example
+ * ```yaml
+ * hooks:
+ *   before:
+ *     - run: "echo 'Starting...'"
+ *   after:
+ *     - run: ["npm run typecheck", "npm run lint"]
+ *       inject: "Validation results:\n{stdout}"
+ * ```
+ */
+export interface AgentHooks {
+    /**
+     * Hooks that run before agent execution
+     * Optional; omit if no before hooks needed
+     */
+    before?: AgentHookEntry[];
+    /**
+     * Hooks that run after agent execution
+     * Optional; omit if no after hooks needed
+     */
+    after?: AgentHookEntry[];
+}
+/**
+ * Single hook entry in the simplified agent hooks format
+ *
+ * @example
+ * ```yaml
+ * - run: "npm run typecheck"
+ *   inject: "Typecheck results:\n{stdout}"
+ *   toast:
+ *     message: "Typecheck {exitCode, select, 0 {passed} other {failed}}"
+ *     variant: "success"
+ * ```
+ */
+export interface AgentHookEntry {
+    /**
+     * Shell command(s) to execute when this hook runs.
+     * - Single string: executed as-is
+     * - Array of strings: executed sequentially
+     *
+     * Required field - hook must have a run command.
+     */
+    run: string | string[];
+    /**
+     * Optional template for injecting hook results into the session.
+     * Supports the same placeholder substitution as ToolHook.inject.
+     *
+     * @example
+     * ```yaml
+     * inject: "Results:\n{stdout}"
+     * ```
+     */
+    inject?: string;
+    /**
+     * Optional toast notification to display after the hook runs.
+     * Supports template placeholder substitution.
+     *
+     * @example
+     * ```yaml
+     * toast:
+     *   message: "Tests {exitCode, select, 0 {passed} other {failed}}"
+     *   variant: "success"
+     *   duration: 3000
+     * ```
+     */
+    toast?: {
+        /**
+         * Optional title for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        title?: string;
+        /**
+         * Required message for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        message: string;
+        /**
+         * Visual variant/style for the toast.
+         * - "info": informational message (default)
+         * - "success": success message
+         * - "warning": warning message
+         * - "error": error message
+         */
+        variant?: "info" | "success" | "warning" | "error";
+        /**
+         * Duration in milliseconds for which the toast should be displayed.
+         * If omitted, uses the default duration.
+         */
+        duration?: number;
+    };
+}
+/**
+ * Tool hook configuration
+ *
+ * Runs shell command(s) before or after a tool execution. Hooks can be filtered
+ * by tool name, calling agent, and slash command context. Results can optionally
+ * be injected into the session as messages.
+ *
+  * @example
+  * ```json
+  * {
+  *   "id": "global-tests-after-task",
+  *   "when": {
+  *     "phase": "after",
+  *     "tool": ["task"],
+  *     "callingAgent": ["*"]
+  *   },
+  *   "run": ["pnpm test --runInBand"],
+  *   "inject": {
+  *     "template": "Tests after {tool}: exit {exitCode}\n```sh\n{stdout}\n```"
+  *   }
+  * }
+  * ```
+  */
+export interface ToolHook {
+    /**
+     * Unique identifier for this hook within its scope (global or per-entity).
+     * Used for error reporting and logging.
+     * Must be unique within the same config source (global or markdown file).
+     */
+    id: string;
+    /**
+     * Matching conditions that determine when this hook should run.
+     * All specified conditions must match for the hook to execute.
+     */
+    when: ToolHookWhen;
+    /**
+     * Shell command(s) to execute when this hook matches.
+     * - Single string: executed as-is
+     * - Array of strings: executed sequentially, even if earlier commands fail
+     *
+     * Commands are executed via Bun's shell API ($) with proper error handling.
+     * Non-zero exit codes do not block subsequent commands or normal tool execution.
+     */
+    run: string | string[];
+    /**
+      * Optional template string for injecting hook results into the calling session.
+      * If omitted, the hook still runs but output is only logged.
+      *
+      * Supports placeholder substitution with the following variables:
+      * - {id}: hook ID
+      * - {agent}: agent name (if available)
+      * - {tool}: tool name (for tool hooks)
+      * - {cmd}: command string that was executed
+      * - {stdout}: captured standard output (truncated to limit)
+      * - {stderr}: captured standard error (truncated to limit)
+      * - {exitCode}: command exit code (integer)
+      *
+      * Placeholders for unavailable values are replaced with empty string.
+      */
+    inject?: string;
+    /**
+     * Optional toast notification to display to the user.
+    * Supports template placeholder substitution like the inject template.
+    * If omitted, no toast is displayed.
+    *
+    * @example
+    * ```json
+    * {
+    *   "title": "Lint Complete",
+    *   "message": "Exit code: {exitCode}",
+    *   "variant": "success",
+    *   "duration": 3000
+    * }
+    * ```
+    */
+    toast?: {
+        /**
+         * Optional title for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        title?: string;
+        /**
+         * Required message for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        message: string;
+        /**
+         * Visual variant/style for the toast.
+         * - "info": informational message (default)
+         * - "success": success message
+         * - "warning": warning message
+         * - "error": error message
+         */
+        variant?: "info" | "success" | "warning" | "error";
+        /**
+         * Duration in milliseconds for which the toast should be displayed.
+         * If omitted, uses the default duration.
+         */
+        duration?: number;
+    };
+}
+/**
+ * Matching conditions for tool hooks
+ *
+ * Determines when a tool hook should execute. All specified conditions must match.
+ * Omitted fields default to matching all values (wildcard behavior).
+ */
+export interface ToolHookWhen {
+    /**
+     * Execution phase: "before" or "after" tool execution.
+     * - "before": runs before the tool is invoked
+     * - "after": runs after the tool completes (regardless of success/failure)
+     */
+    phase: "before" | "after";
+    /**
+     * Tool name(s) to match.
+     * - Omitted or "*": matches all tools
+     * - Array of strings: matches if tool name is in the array
+     * - Single string: matches if tool name equals the string
+     *
+     * Examples: "task", ["bash", "write"], "*"
+     */
+    tool?: string | string[];
+    /**
+     * Calling agent name(s) to match.
+     * - Omitted: defaults to "*" in global config, "this agent" in markdown
+     * - "*": matches any agent
+     * - Array of strings: matches if agent name is in the array
+     * - Single string: matches if agent name equals the string
+     *
+     * When defined in agent markdown, omitting this field means the hook
+     * applies only to that agent (implicit scoping).
+     */
+    callingAgent?: string | string[];
+    /**
+     * Slash command name(s) to match (optional).
+     * Only applies when the tool invocation is associated with a slash command.
+     * - Omitted: matches tool calls regardless of slash command context
+     * - "*": matches any slash command
+     * - Array of strings: matches if slash command name is in the array
+     * - Single string: matches if slash command name equals the string
+     *
+     * Note: Slash command detection may not be available for all tool types.
+     */
+    slashCommand?: string | string[];
+    /**
+     * Tool argument filters (optional, only available in tool.execute.before).
+     * Match based on the tool's input arguments.
+     * Useful for filtering task tool calls by subagentType.
+     *
+     * Example: { "subagentType": "validator" } matches only task calls with subagentType="validator"
+     * Example: { "subagentType": ["validator", "reviewer"] } matches multiple values
+     */
+    toolArgs?: Record<string, string | string[]>;
+}
+/**
+ * Session hook configuration
+ *
+ * Runs shell command(s) on session lifecycle events (start, idle, end).
+ * Can be filtered by agent name. Results can optionally be injected into
+ * the session as messages.
+ *
+  * @example
+  * ```json
+  * {
+  *   "id": "global-bootstrap",
+  *   "when": {
+  *     "event": "session.start",
+  *     "agent": ["build", "validator", "*"]
+  *   },
+  *   "run": ["git status --short"],
+  *   "inject": {
+  *     "template": "Repo status for {agent}:\n```sh\n{stdout}\n```"
+  *   }
+  * }
+  * ```
+  */
+export interface SessionHook {
+    /**
+     * Unique identifier for this hook within its scope (global or per-entity).
+     * Used for error reporting and logging.
+     * Must be unique within the same config source (global or markdown file).
+     */
+    id: string;
+    /**
+     * Matching conditions that determine when this hook should run.
+     * All specified conditions must match for the hook to execute.
+     */
+    when: SessionHookWhen;
+    /**
+     * Shell command(s) to execute when this hook matches.
+     * - Single string: executed as-is
+     * - Array of strings: executed sequentially, even if earlier commands fail
+     *
+     * Commands are executed via Bun's shell API ($) with proper error handling.
+     * Non-zero exit codes do not block subsequent commands or normal session flow.
+     */
+    run: string | string[];
+    /**
+     * Optional template string for injecting hook results into the calling session.
+     * If omitted, the hook still runs but output is only logged.
+     *
+     * Supports placeholder substitution with the following variables:
+     * - {id}: hook ID
+     * - {agent}: agent name (if available)
+     * - {cmd}: command string that was executed
+     * - {stdout}: captured standard output (truncated to limit)
+     * - {stderr}: captured standard error (truncated to limit)
+     * - {exitCode}: command exit code (integer)
+     *
+     * Placeholders for unavailable values are replaced with empty string.
+     */
+    inject?: string;
+    /**
+     * Optional toast notification to display to the user.
+    * Supports template placeholder substitution like the inject template.
+    * If omitted, no toast is displayed.
+    *
+    * @example
+    * ```json
+    * {
+    *   "title": "Session Started",
+    *   "message": "Agent {agent} is ready",
+    *   "variant": "info",
+    *   "duration": 2000
+    * }
+    * ```
+    */
+    toast?: {
+        /**
+         * Optional title for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        title?: string;
+        /**
+         * Required message for the toast notification.
+         * Supports template placeholder substitution.
+         */
+        message: string;
+        /**
+         * Visual variant/style for the toast.
+         * - "info": informational message (default)
+         * - "success": success message
+         * - "warning": warning message
+         * - "error": error message
+         */
+        variant?: "info" | "success" | "warning" | "error";
+        /**
+         * Duration in milliseconds for which the toast should be displayed.
+         * If omitted, uses the default duration.
+         */
+        duration?: number;
+    };
+}
+/**
+ * Matching conditions for session hooks
+ *
+ * Determines when a session hook should execute. All specified conditions must match.
+ * Omitted fields default to matching all values (wildcard behavior).
+ */
+export interface SessionHookWhen {
+    /**
+     * Session lifecycle event type.
+     * - "session.start": fires when session is ready to receive pre-context
+     * - "session.idle": fires after agent turn completes (for after-turn hooks)
+     * - "session.end": fires when session ends
+     */
+    event: "session.start" | "session.idle" | "session.end";
+    /**
+     * Agent name(s) to match.
+     * - Omitted: defaults to "*" in global config, "this agent" in markdown
+     * - "*": matches any agent
+     * - Array of strings: matches if agent name is in the array
+     * - Single string: matches if agent name equals the string
+     *
+     * When defined in agent markdown, omitting this field means the hook
+     * applies only to that agent (implicit scoping).
+     */
+    agent?: string | string[];
+}
+/**
+ * Top-level command hooks configuration
+ *
+ * This is the root configuration object that appears in opencode.json/.opencode.jsonc
+ * under the "command_hooks" key, or in YAML frontmatter of agent/slash-command markdown.
+ *
+ * @example
+ * In opencode.json:
+ * ```json
+ * {
+ *   "command_hooks": {
+ *     "tool": [...],
+ *     "session": [...]
+ *   }
+ * }
+ * ```
+ *
+ * In agent markdown frontmatter:
+ * ```yaml
+ * ---
+ * command_hooks:
+ *   tool: [...]
+ *   session: [...]
+ * ---
+ * ```
+ */
+export interface CommandHooksConfig {
+    /**
+     * Array of tool execution hooks.
+     * Hooks run before or after tool calls based on matching conditions.
+     * Optional; omit if no tool hooks are needed.
+     */
+    tool?: ToolHook[];
+    /**
+     * Array of session lifecycle hooks.
+     * Hooks run on session events (start, idle, end) based on matching conditions.
+     * Optional; omit if no session hooks are needed.
+     */
+    session?: SessionHook[];
+}
+/**
+ * Result of executing a single hook command
+ *
+ * Captures the outcome of running a hook's shell command(s), including
+ * output, exit code, and any errors that occurred.
+ */
+export interface HookExecutionResult {
+    /**
+     * ID of the hook that was executed
+     */
+    hookId: string;
+    /**
+     * Whether the hook executed successfully (exit code 0)
+     */
+    success: boolean;
+    /**
+     * Exit code from the last command in the hook's run array
+     * - 0: success
+     * - non-zero: command failed
+     * - undefined: command did not execute (e.g., binary not found)
+     */
+    exitCode?: number;
+    /**
+     * Captured standard output from the command(s).
+     * Truncated to the configured limit (default 4096 chars).
+     * May be empty if command produced no output.
+     */
+    stdout?: string;
+    /**
+     * Captured standard error from the command(s).
+     * Truncated to the configured limit (default 4096 chars).
+     * May be empty if command produced no error output.
+     */
+    stderr?: string;
+    /**
+     * Error message if the hook failed to execute.
+     * Examples:
+     * - "Command not found: pnpm"
+     * - "Timeout executing hook"
+     * - "Failed to inject message into session"
+     */
+    error?: string;
+}
+/**
+ * Context object for template placeholder substitution
+ *
+ * When injecting hook results into a session, the template string is processed
+ * with placeholder substitution using values from this context. All fields are
+ * optional as not all contexts have all values available.
+ *
+ * @example
+ * ```typescript
+ * const context: TemplateContext = {
+ *   id: "tests-after-task",
+ *   agent: "build",
+ *   tool: "task",
+ *   cmd: "pnpm test --runInBand",
+ *   stdout: "✓ All tests passed",
+ *   stderr: "",
+ *   exitCode: 0
+ * }
+ *
+ * const template = "Hook {id} for {tool} completed: exit {exitCode}"
+ * // Result: "Hook tests-after-task for task completed: exit 0"
+ * ```
+ */
+export interface TemplateContext {
+    /**
+     * Hook ID (always available)
+     */
+    id: string;
+    /**
+     * Agent name (available for tool hooks and session hooks)
+     * May be undefined if agent context is not available
+     */
+    agent?: string;
+    /**
+     * Tool name (available for tool hooks only)
+     * May be undefined for session hooks
+     */
+    tool?: string;
+    /**
+     * Command string that was executed (available when hook runs)
+     * May be undefined if command execution failed before running
+     */
+    cmd?: string;
+    /**
+     * Captured standard output from command execution
+     * Truncated to configured limit (default 4096 chars)
+     * May be undefined or empty if command produced no output
+     */
+    stdout?: string;
+    /**
+     * Captured standard error from command execution
+     * Truncated to configured limit (default 4096 chars)
+     * May be undefined or empty if command produced no error output
+     */
+    stderr?: string;
+    /**
+     * Exit code from command execution
+     * - 0: success
+     * - non-zero: command failed
+     * May be undefined if command did not execute
+     */
+    exitCode?: number;
+    /**
+     * Additional context fields for future expansion
+     * Examples: subagentSummary, taskResult, etc.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Normalized representation of a hook's matching conditions
+ *
+ * Converts flexible input formats (string | string[]) into consistent
+ * array format for easier matching logic.
+ */
+export interface NormalizedToolHookWhen {
+    phase: "before" | "after";
+    tool: string[];
+    callingAgent: string[];
+    slashCommand: string[];
+}
+/**
+ * Normalized representation of session hook matching conditions
+ */
+export interface NormalizedSessionHookWhen {
+    event: "session.start" | "session.idle" | "session.end";
+    agent: string[];
+}
+/**
+ * Hook validation error
+ *
+ * Represents a validation error found in hook configuration.
+ * Used for reporting configuration issues without blocking execution.
+ */
+export interface HookValidationError {
+    /**
+     * Hook ID (if available; may be undefined if id field is missing)
+     */
+    hookId?: string;
+    /**
+     * Type of validation error
+     */
+    type: "missing_id" | "missing_when" | "missing_run" | "invalid_phase" | "invalid_event" | "invalid_injection_target" | "invalid_injection_as" | "duplicate_id" | "unknown";
+    /**
+     * Human-readable error message
+     */
+    message: string;
+    /**
+     * Severity level
+     */
+    severity: "error" | "warning";
+}
+/**
+ * Loaded and merged hooks for a specific context
+ *
+ * Represents the final set of hooks that apply to a given agent/session/tool call,
+ * after merging global and entity-specific hooks with proper precedence.
+ */
+export interface MergedHooksContext {
+    /**
+     * Tool hooks that apply to this context
+     */
+    toolHooks: ToolHook[];
+    /**
+     * Session hooks that apply to this context
+     */
+    sessionHooks: SessionHook[];
+    /**
+     * Validation errors found during loading/merging
+     * Hooks with errors are included but marked for error reporting
+     */
+    validationErrors: HookValidationError[];
+}
+/**
+ * Hook execution context
+ *
+ * Information about the current execution context that hooks may need
+ */
+export interface HookExecutionContext {
+    /**
+     * Current session ID
+     */
+    sessionId: string;
+    /**
+     * Current agent name
+     */
+    agent: string;
+    /**
+     * Tool name (for tool hooks)
+     */
+    tool?: string;
+    /**
+     * Slash command name (if applicable)
+     */
+    slashCommand?: string;
+    /**
+     * Tool call ID provided by OpenCode (if available)
+     */
+    callId?: string;
+    /**
+     * Tool arguments (available for tool.execute.before hooks)
+     * For task tool, this includes: description, prompt, subagentType
+     */
+    toolArgs?: Record<string, unknown>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IAEzB;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEtB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE;QACN;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QAEd;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAA;QAEf;;;;;;WAMG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;QAElD;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAMD;;;;;;;;;;;;;;;;;;;;;;IAsBI;AACJ,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;;OAGG;IACH,IAAI,EAAE,YAAY,CAAA;IAEjB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEtB;;;;;;;;;;;;;;QAcI;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEb;;;;;;;;;;;;;;MAcE;IACH,KAAK,CAAC,EAAE;QACN;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QAEd;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAA;QAEf;;;;;;WAMG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;QAElD;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACH;AAEH;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IAEzB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAExB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEhC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEhC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;CAC7C;AAMD;;;;;;;;;;;;;;;;;;;;;IAqBI;AACJ,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;;OAGG;IACH,IAAI,EAAE,eAAe,CAAA;IAEpB;;;;;;;OAOG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEtB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEZ;;;;;;;;;;;;;;MAcE;IACH,KAAK,CAAC,EAAE;QACN;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QAEd;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAA;QAEf;;;;;;WAMG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;QAElD;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACH;AAEH;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,aAAa,CAAA;IAEvD;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC1B;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAA;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IACzB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,aAAa,CAAA;IACvD,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,IAAI,EACA,YAAY,GACZ,cAAc,GACd,aAAa,GACb,eAAe,GACf,eAAe,GACf,0BAA0B,GAC1B,sBAAsB,GACtB,cAAc,GACd,SAAS,CAAA;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAA;IAErB;;OAEG;IACH,YAAY,EAAE,WAAW,EAAE,CAAA;IAE3B;;;OAGG;IACH,gBAAgB,EAAE,mBAAmB,EAAE,CAAA;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC"}

package/dist/types/hooks.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for command hooks configuration
+ * Supports tool hooks and session hooks with flexible matching and injection
+ *
+ * Hooks allow users to declaratively attach shell commands to agent/tool/slash-command
+ * lifecycle events. They can be defined in:
+ * - Global config in opencode.json/.opencode.jsonc
+ * - Per-agent YAML frontmatter in agent markdown
+ * - Per-slash-command YAML frontmatter in command markdown
+ */
+export {};
+//# sourceMappingURL=hooks.js.map

package/dist/types/hooks.js.map

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