muonroi-cli 1.2.0

package/dist/headless/output.test.js

@@ -0,0 +1,178 @@
+import { describe, expect, it } from "vitest";
+import { createHeadlessJsonlEmitter, isHeadlessOutputFormat, renderHeadlessChunk, renderHeadlessPrelude, } from "./output";
+function toolCall(name) {
+    return {
+        id: "tc-1",
+        type: "function",
+        function: {
+            name,
+            arguments: "{}",
+        },
+    };
+}
+function expectSessionAndTimestamp(e, sessionId) {
+    if (sessionId !== undefined) {
+        expect(e.sessionID).toBe(sessionId);
+    }
+    else {
+        expect(e.sessionID).toBeUndefined();
+    }
+    expect(typeof e.timestamp).toBe("number");
+}
+describe("headless output helpers", () => {
+    it("recognizes supported output formats", () => {
+        expect(isHeadlessOutputFormat("text")).toBe(true);
+        expect(isHeadlessOutputFormat("json")).toBe(true);
+        expect(isHeadlessOutputFormat("xml")).toBe(false);
+    });
+    it("renders the text prelude with session metadata", () => {
+        expect(renderHeadlessPrelude("text", "session-123")).toEqual({
+            stdout: "\u001b[36m⏳ Processing...\u001b[0m\n",
+            stderr: "\u001b[2mSession: session-123\u001b[0m\n",
+        });
+    });
+    it("suppresses the prelude in json mode", () => {
+        expect(renderHeadlessPrelude("json", "session-123")).toEqual({});
+    });
+    it("renders tool calls for text mode", () => {
+        const chunk = {
+            type: "tool_calls",
+            toolCalls: [toolCall("bash"), toolCall("read_file")],
+        };
+        expect(renderHeadlessChunk(chunk)).toEqual({
+            stderr: "\u001b[33m▸ bash\u001b[0m\n\u001b[33m▸ read_file\u001b[0m\n",
+        });
+    });
+    it("renders tool results for text mode", () => {
+        const chunk = {
+            type: "tool_result",
+            toolCall: toolCall("bash"),
+            toolResult: {
+                success: false,
+                output: "failed",
+            },
+        };
+        expect(renderHeadlessChunk(chunk)).toEqual({
+            stderr: "\u001b[31m✗ bash\u001b[0m\n",
+        });
+    });
+    it("renders generated media paths in text mode tool results", () => {
+        const chunk = {
+            type: "tool_result",
+            toolCall: toolCall("generate_image"),
+            toolResult: {
+                success: true,
+                output: "Generated 1 image.",
+                media: [{ kind: "image", path: "/tmp/generated.png", url: "https://example.com/generated.png" }],
+            },
+        };
+        expect(renderHeadlessChunk(chunk)).toEqual({
+            stderr: "\u001b[32m▸ generate_image\u001b[0m\n  /tmp/generated.png (https://example.com/generated.png)\n",
+        });
+    });
+    it("emits semantic JSONL for a single step with text and tool (json emitter)", () => {
+        const sessionId = "jsonl-test-session";
+        const tc = toolCall("bash");
+        const { observer, consumeChunk, flush } = createHeadlessJsonlEmitter(sessionId);
+        let combined = "";
+        observer.onStepStart?.({ stepNumber: 1, timestamp: 100 });
+        combined += consumeChunk({ type: "content", content: "hello" }).stdout ?? "";
+        observer.onToolStart?.({ toolCall: tc, timestamp: 110 });
+        combined +=
+            consumeChunk({
+                type: "tool_calls",
+                toolCalls: [tc],
+            }).stdout ?? "";
+        observer.onToolFinish?.({
+            toolCall: tc,
+            toolResult: { success: true, output: "ok" },
+            timestamp: 130,
+        });
+        combined +=
+            consumeChunk({
+                type: "tool_result",
+                toolCall: tc,
+                toolResult: { success: true, output: "ok" },
+            }).stdout ?? "";
+        observer.onStepFinish?.({
+            stepNumber: 1,
+            timestamp: 200,
+            finishReason: "stop",
+            usage: { inputTokens: 1, outputTokens: 2, totalTokens: 3 },
+        });
+        combined += flush().stdout ?? "";
+        const events = combined
+            .trim()
+            .split("\n")
+            .map((l) => JSON.parse(l));
+        expect(events.map((e) => e.type)).toEqual(["step_start", "text", "tool_use", "step_finish"]);
+        expectSessionAndTimestamp(events[0], sessionId);
+        expect(events[0]).toMatchObject({ type: "step_start", stepNumber: 1, timestamp: 100 });
+        expectSessionAndTimestamp(events[1], sessionId);
+        expect(events[1]).toMatchObject({ type: "text", stepNumber: 1, text: "hello" });
+        expectSessionAndTimestamp(events[2], sessionId);
+        expect(events[2]).toMatchObject({
+            type: "tool_use",
+            stepNumber: 1,
+            timestamp: 130,
+            timing: { startedAt: 110, finishedAt: 130, durationMs: 20 },
+        });
+        expectSessionAndTimestamp(events[3], sessionId);
+        expect(events[3]).toMatchObject({
+            type: "step_finish",
+            stepNumber: 1,
+            finishReason: "stop",
+            usage: { inputTokens: 1, outputTokens: 2, totalTokens: 3 },
+            timestamp: 200,
+        });
+    });
+    it("does not emit empty text events at step_finish when tools already flushed assistant text", () => {
+        const sessionId = "sess-2";
+        const tc = toolCall("bash");
+        const { observer, consumeChunk, flush } = createHeadlessJsonlEmitter(sessionId);
+        let combined = "";
+        observer.onStepStart?.({ stepNumber: 0, timestamp: 1 });
+        combined += consumeChunk({ type: "content", content: "x" }).stdout ?? "";
+        observer.onToolStart?.({ toolCall: tc, timestamp: 5 });
+        combined += consumeChunk({ type: "tool_calls", toolCalls: [tc] }).stdout ?? "";
+        observer.onToolFinish?.({
+            toolCall: tc,
+            toolResult: { success: true, output: "y" },
+            timestamp: 8,
+        });
+        combined +=
+            consumeChunk({
+                type: "tool_result",
+                toolCall: tc,
+                toolResult: { success: true, output: "y" },
+            }).stdout ?? "";
+        observer.onStepFinish?.({
+            stepNumber: 0,
+            timestamp: 2,
+            finishReason: "tool-calls",
+            usage: {},
+        });
+        combined += flush().stdout ?? "";
+        const events = combined
+            .trim()
+            .split("\n")
+            .map((l) => JSON.parse(l));
+        expect(events.filter((e) => e.type === "text").every((e) => e.text.length > 0)).toBe(true);
+        expect(events.map((e) => e.type)).toEqual(["step_start", "text", "tool_use", "step_finish"]);
+        for (const e of events) {
+            expectSessionAndTimestamp(e, sessionId);
+        }
+    });
+    it("emits error events from stream chunks", () => {
+        const sessionId = "err-session";
+        const { consumeChunk } = createHeadlessJsonlEmitter(sessionId);
+        const w = consumeChunk({ type: "error", content: "boom" });
+        const parsed = JSON.parse(w.stdout?.trim() ?? "{}");
+        expect(parsed).toMatchObject({
+            type: "error",
+            message: "boom",
+        });
+        expectSessionAndTimestamp(parsed, sessionId);
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/headless/output.test.js.map

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

package/dist/hooks/config.d.ts

@@ -0,0 +1,18 @@
+import type { HookCommand, HookEvent, HooksConfig } from "./types.js";
+/**
+ * Load hooks config from user settings (~/.muonroi-cli/user-settings.json) only.
+ *
+ * Project-level .muonroi-cli/settings.json hooks are intentionally excluded because
+ * that file is repo-committed — a malicious repository could execute arbitrary
+ * unsandboxed commands on a developer's machine via hook definitions.
+ * Hooks run on the host (outside any sandbox) so they must be user-configured.
+ */
+export declare function loadHooksConfig(): HooksConfig;
+/**
+ * Get hooks that match a given event and optional match value.
+ *
+ * For events that have a matcher field (e.g. PreToolUse matches on tool_name),
+ * only matchers whose `matcher` string matches `matchValue` are included,
+ * plus matchers with no `matcher` (which match everything).
+ */
+export declare function getMatchingHooks(config: HooksConfig, event: HookEvent, matchValue?: string): HookCommand[];

package/dist/hooks/config.js

@@ -0,0 +1,39 @@
+import { loadUserSettings } from "../utils/settings.js";
+/**
+ * Load hooks config from user settings (~/.muonroi-cli/user-settings.json) only.
+ *
+ * Project-level .muonroi-cli/settings.json hooks are intentionally excluded because
+ * that file is repo-committed — a malicious repository could execute arbitrary
+ * unsandboxed commands on a developer's machine via hook definitions.
+ * Hooks run on the host (outside any sandbox) so they must be user-configured.
+ */
+export function loadHooksConfig() {
+    return loadUserSettings().hooks ?? {};
+}
+/**
+ * Get hooks that match a given event and optional match value.
+ *
+ * For events that have a matcher field (e.g. PreToolUse matches on tool_name),
+ * only matchers whose `matcher` string matches `matchValue` are included,
+ * plus matchers with no `matcher` (which match everything).
+ */
+export function getMatchingHooks(config, event, matchValue) {
+    const matchers = config[event];
+    if (!matchers || matchers.length === 0)
+        return [];
+    const matched = [];
+    for (const entry of matchers) {
+        if (matchesPattern(entry, matchValue)) {
+            matched.push(...entry.hooks);
+        }
+    }
+    return matched;
+}
+function matchesPattern(entry, matchValue) {
+    if (!entry.matcher)
+        return true;
+    if (!matchValue)
+        return false;
+    return matchValue === entry.matcher;
+}
+//# sourceMappingURL=config.js.map

package/dist/hooks/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/hooks/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,KAAgB,EAAE,UAAmB;IACzF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElD,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB,EAAE,UAAmB;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,UAAU,KAAK,KAAK,CAAC,OAAO,CAAC;AACtC,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Hook dispatcher — routes PreToolUse / PostToolUse events through the
+ * Experience Engine HTTP client at localhost:8082.
+ *
+ * Plan 00.06: src/hooks/executor.ts (shell-spawn approach) has been deleted.
+ * This module is the new dispatcher. It preserves the original public function
+ * signatures so call sites in the orchestrator do not change.
+ *
+ * Shell-spawn was:
+ *   spawn("sh", ["-c", hook.command], ...)  — broken on Windows without WSL.
+ * HTTP client is:
+ *   POST http://localhost:8082/api/intercept  — cross-platform, safe, auditable.
+ *
+ * Architecture: EE is optional. If EE is not running, all intercepts fall back
+ * to { decision: "allow" } so the TUI is never blocked by a missing EE process.
+ */
+export { getMatchingHooks, loadHooksConfig } from "./config.js";
+export type { AggregatedHookResult, BaseHookInput, CommandHook, HookCommand, HookEvent, HookInput, HookMatcher, HookOutput, HookResult, HooksConfig, PostToolUseFailureHookInput, PostToolUseHookInput, PreToolUseHookInput, } from "./types.js";
+export { getMatchQuery, HOOK_EVENTS, isHookEvent } from "./types.js";
+import type { AggregatedHookResult, HookInput } from "./types.js";
+/** Reset hook module state — for test teardown only. */
+export declare function resetHookState(): void;
+/**
+ * Dispatch a hook event to the EE HTTP client.
+ *
+ * - PreToolUse:  blocking intercept call → may return decision:block
+ * - PostToolUse: fire-and-forget posttool call
+ * - All other events: allow by default (Phase 1 EE-02+ extends this)
+ *
+ * Swallows all errors so hooks never crash the orchestrator.
+ */
+export declare function executeEventHooks(input: HookInput, cwd: string, _signal?: AbortSignal): Promise<AggregatedHookResult>;
+/**
+ * Fire PreToolUse hooks. Returns the aggregated result which may block execution.
+ */
+export declare function executePreToolHooks(toolName: string, toolInput: Record<string, unknown>, cwd: string, sessionId?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+/**
+ * Fire PostToolUse hooks after a successful tool execution.
+ */
+export declare function executePostToolHooks(toolName: string, toolInput: Record<string, unknown>, toolOutput: Record<string, unknown>, cwd: string, sessionId?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+/**
+ * Fire PostToolUseFailure hooks after a tool execution fails.
+ */
+export declare function executePostToolFailureHooks(toolName: string, toolInput: Record<string, unknown>, error: string, cwd: string, sessionId?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;

package/dist/hooks/index.js

@@ -0,0 +1,187 @@
+/**
+ * Hook dispatcher — routes PreToolUse / PostToolUse events through the
+ * Experience Engine HTTP client at localhost:8082.
+ *
+ * Plan 00.06: src/hooks/executor.ts (shell-spawn approach) has been deleted.
+ * This module is the new dispatcher. It preserves the original public function
+ * signatures so call sites in the orchestrator do not change.
+ *
+ * Shell-spawn was:
+ *   spawn("sh", ["-c", hook.command], ...)  — broken on Windows without WSL.
+ * HTTP client is:
+ *   POST http://localhost:8082/api/intercept  — cross-platform, safe, auditable.
+ *
+ * Architecture: EE is optional. If EE is not running, all intercepts fall back
+ * to { decision: "allow" } so the TUI is never blocked by a missing EE process.
+ */
+// Re-export type-only items that callers may import from this module
+export { getMatchingHooks, loadHooksConfig } from "./config.js";
+export { getMatchQuery, HOOK_EVENTS, isHookEvent } from "./types.js";
+import { interceptWithDefaults } from "../ee/intercept.js";
+import { getTenantId } from "../ee/tenant.js";
+import { posttool } from "../ee/posttool.js";
+import { reconcilePromptStale } from "../ee/prompt-stale.js";
+import { buildScope } from "../ee/scope.js";
+// Cached scope for posttool calls (computed once at first use)
+let _cachedScope = null;
+// Latch: stores the last PreToolUse warning response so PostToolUse can build judgeCtx.
+// Follows the _cachedScope module-level variable pattern.
+let _lastWarningResponse = null;
+/** Reset hook module state — for test teardown only. */
+export function resetHookState() {
+    _lastWarningResponse = null;
+    _cachedScope = null;
+}
+function emptyResult() {
+    return {
+        blocked: false,
+        blockingErrors: [],
+        preventContinuation: false,
+        additionalContexts: [],
+        results: [],
+    };
+}
+/**
+ * Dispatch a hook event to the EE HTTP client.
+ *
+ * - PreToolUse:  blocking intercept call → may return decision:block
+ * - PostToolUse: fire-and-forget posttool call
+ * - All other events: allow by default (Phase 1 EE-02+ extends this)
+ *
+ * Swallows all errors so hooks never crash the orchestrator.
+ */
+export async function executeEventHooks(input, cwd, _signal) {
+    try {
+        if (input.hook_event_name === "PreToolUse") {
+            const r = await interceptWithDefaults({
+                toolName: input.tool_name,
+                toolInput: input.tool_input,
+                cwd,
+            });
+            // Thread the warning response to PostToolUse via module-level latch
+            _lastWarningResponse = r;
+            if (r.decision === "block") {
+                return {
+                    blocked: true,
+                    blockingErrors: [{ command: "ee:intercept", stderr: r.reason ?? "ee-blocked" }],
+                    preventContinuation: true,
+                    stopReason: r.reason ?? "ee-blocked",
+                    additionalContexts: r.suggestions ?? [],
+                    decision: "block",
+                    results: [],
+                };
+            }
+            return {
+                blocked: false,
+                blockingErrors: [],
+                preventContinuation: false,
+                additionalContexts: r.suggestions ?? [],
+                decision: "approve",
+                results: [],
+            };
+        }
+        if (input.hook_event_name === "PostToolUse") {
+            if (!_cachedScope)
+                _cachedScope = await buildScope({ cwd });
+            const judgeCtx = {
+                warningResponse: _lastWarningResponse,
+                toolName: input.tool_name,
+                outcome: { success: true },
+                cwdMatchedAtPretool: _lastWarningResponse !== null,
+                diffPresent: false,
+                tenantId: getTenantId(),
+            };
+            _lastWarningResponse = null; // reset after use — prevents cross-turn contamination
+            await posttool({
+                toolName: input.tool_name,
+                toolInput: input.tool_input,
+                outcome: {
+                    // PostToolUse always means success — failure goes to PostToolUseFailure
+                    success: true,
+                },
+                cwd,
+                tenantId: getTenantId(),
+                scope: _cachedScope,
+            }, judgeCtx);
+            // STALE-02/STALE-03: fire-and-forget per-turn prompt-stale reconciliation
+            reconcilePromptStale(cwd); // void — does not block (B-4)
+            return emptyResult();
+        }
+        if (input.hook_event_name === "PostToolUseFailure") {
+            const failInput = input;
+            if (!_cachedScope)
+                _cachedScope = await buildScope({ cwd });
+            const judgeCtx = {
+                warningResponse: _lastWarningResponse,
+                toolName: failInput.tool_name,
+                outcome: { success: false, error: failInput.error },
+                cwdMatchedAtPretool: _lastWarningResponse !== null,
+                diffPresent: false,
+                tenantId: getTenantId(),
+            };
+            _lastWarningResponse = null; // reset after use — prevents cross-turn contamination
+            await posttool({
+                toolName: failInput.tool_name,
+                toolInput: failInput.tool_input,
+                outcome: {
+                    success: false,
+                    error: failInput.error,
+                },
+                cwd,
+                tenantId: getTenantId(),
+                scope: _cachedScope,
+            }, judgeCtx);
+            // STALE-02/STALE-03: fire-and-forget per-turn prompt-stale reconciliation
+            reconcilePromptStale(cwd); // void — does not block (B-4)
+            return emptyResult();
+        }
+        // All other event names: allow by default (Phase 1 EE-02+ extends coverage)
+        return emptyResult();
+    }
+    catch {
+        // EE errors must never crash the orchestrator
+        return emptyResult();
+    }
+}
+/**
+ * Fire PreToolUse hooks. Returns the aggregated result which may block execution.
+ */
+export async function executePreToolHooks(toolName, toolInput, cwd, sessionId, signal) {
+    const input = {
+        hook_event_name: "PreToolUse",
+        tool_name: toolName,
+        tool_input: toolInput,
+        session_id: sessionId,
+        cwd,
+    };
+    return executeEventHooks(input, cwd, signal);
+}
+/**
+ * Fire PostToolUse hooks after a successful tool execution.
+ */
+export async function executePostToolHooks(toolName, toolInput, toolOutput, cwd, sessionId, signal) {
+    const input = {
+        hook_event_name: "PostToolUse",
+        tool_name: toolName,
+        tool_input: toolInput,
+        tool_output: toolOutput,
+        session_id: sessionId,
+        cwd,
+    };
+    return executeEventHooks(input, cwd, signal);
+}
+/**
+ * Fire PostToolUseFailure hooks after a tool execution fails.
+ */
+export async function executePostToolFailureHooks(toolName, toolInput, error, cwd, sessionId, signal) {
+    const input = {
+        hook_event_name: "PostToolUseFailure",
+        tool_name: toolName,
+        tool_input: toolInput,
+        error,
+        session_id: sessionId,
+        cwd,
+    };
+    return executeEventHooks(input, cwd, signal);
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

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

package/dist/hooks/types.d.ts

@@ -0,0 +1,130 @@
+export declare const HOOK_EVENTS: readonly ["PreToolUse", "PostToolUse", "PostToolUseFailure", "UserPromptSubmit", "SessionStart", "SessionEnd", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "TaskCreated", "TaskCompleted", "PreCompact", "PostCompact", "Notification", "InstructionsLoaded", "CwdChanged"];
+export type HookEvent = (typeof HOOK_EVENTS)[number];
+export declare function isHookEvent(value: string): value is HookEvent;
+export interface BaseHookInput {
+    hook_event_name: HookEvent;
+    session_id?: string;
+    cwd: string;
+}
+export interface PreToolUseHookInput extends BaseHookInput {
+    hook_event_name: "PreToolUse";
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+}
+export interface PostToolUseHookInput extends BaseHookInput {
+    hook_event_name: "PostToolUse";
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+    tool_output: Record<string, unknown>;
+}
+export interface PostToolUseFailureHookInput extends BaseHookInput {
+    hook_event_name: "PostToolUseFailure";
+    tool_name: string;
+    tool_input: Record<string, unknown>;
+    error: string;
+}
+export interface UserPromptSubmitHookInput extends BaseHookInput {
+    hook_event_name: "UserPromptSubmit";
+    user_prompt: string;
+}
+export interface SessionStartHookInput extends BaseHookInput {
+    hook_event_name: "SessionStart";
+    source: "startup" | "resume" | "clear";
+}
+export interface SessionEndHookInput extends BaseHookInput {
+    hook_event_name: "SessionEnd";
+}
+export interface StopHookInput extends BaseHookInput {
+    hook_event_name: "Stop";
+}
+export interface StopFailureHookInput extends BaseHookInput {
+    hook_event_name: "StopFailure";
+    error: string;
+}
+export interface SubagentStartHookInput extends BaseHookInput {
+    hook_event_name: "SubagentStart";
+    agent_type: string;
+    description: string;
+}
+export interface SubagentStopHookInput extends BaseHookInput {
+    hook_event_name: "SubagentStop";
+    agent_type: string;
+    description: string;
+    success: boolean;
+}
+export interface TaskCreatedHookInput extends BaseHookInput {
+    hook_event_name: "TaskCreated";
+    agent_type: string;
+    description: string;
+}
+export interface TaskCompletedHookInput extends BaseHookInput {
+    hook_event_name: "TaskCompleted";
+    agent_type: string;
+    description: string;
+    success: boolean;
+}
+export interface PreCompactHookInput extends BaseHookInput {
+    hook_event_name: "PreCompact";
+    trigger: "auto" | "manual";
+}
+export interface PostCompactHookInput extends BaseHookInput {
+    hook_event_name: "PostCompact";
+    trigger: "auto" | "manual";
+}
+export interface NotificationHookInput extends BaseHookInput {
+    hook_event_name: "Notification";
+    message: string;
+}
+export interface InstructionsLoadedHookInput extends BaseHookInput {
+    hook_event_name: "InstructionsLoaded";
+    files_loaded: number;
+}
+export interface CwdChangedHookInput extends BaseHookInput {
+    hook_event_name: "CwdChanged";
+    old_cwd: string;
+    new_cwd: string;
+}
+export type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | UserPromptSubmitHookInput | SessionStartHookInput | SessionEndHookInput | StopHookInput | StopFailureHookInput | SubagentStartHookInput | SubagentStopHookInput | TaskCreatedHookInput | TaskCompletedHookInput | PreCompactHookInput | PostCompactHookInput | NotificationHookInput | InstructionsLoadedHookInput | CwdChangedHookInput;
+export interface HookOutput {
+    continue?: boolean;
+    stopReason?: string;
+    decision?: "approve" | "block";
+    reason?: string;
+    additionalContext?: string;
+}
+export type HookOutcome = "success" | "blocking" | "non_blocking_error" | "cancelled";
+export interface HookResult {
+    outcome: HookOutcome;
+    output?: HookOutput;
+    stderr?: string;
+    exitCode: number | null;
+    command: string;
+}
+export interface AggregatedHookResult {
+    blocked: boolean;
+    blockingErrors: Array<{
+        command: string;
+        stderr: string;
+    }>;
+    preventContinuation: boolean;
+    stopReason?: string;
+    additionalContexts: string[];
+    decision?: "approve" | "block";
+    results: HookResult[];
+}
+export interface CommandHook {
+    type: "command";
+    command: string;
+    timeout?: number;
+}
+export type HookCommand = CommandHook;
+export interface HookMatcher {
+    matcher?: string;
+    hooks: HookCommand[];
+}
+export type HooksConfig = Partial<Record<HookEvent, HookMatcher[]>>;
+/**
+ * Returns the matcher query field for a given hook event input,
+ * used to filter matchers by their `matcher` string.
+ */
+export declare function getMatchQuery(input: HookInput): string | undefined;