@trenchwork/erosolar 1.1.16

package/dist/core/hitl.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Human-in-the-Loop (HITL) System
+ * Pauses AI execution and prompts users for important decision paths
+ * This is the ONLY HITL system in the repository
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * Module-level event bus that fires when a HITL prompt opens or closes. Other
+ * subsystems subscribe to:
+ *   - pause their own run-timeouts so user think-time doesn't abort the agent
+ *     (see AgentController),
+ *   - hand the terminal off cleanly so the prompt and post-prompt I/O don't
+ *     fight (see UnifiedUIRenderer / interactiveShell).
+ *
+ * Always paired: every `prompt-open` is followed by exactly one `prompt-close`,
+ * including on timeout, Ctrl+C, custom-input, and shutdown paths.
+ */
+export declare const hitlEvents: EventEmitter<any>;
+export declare function isHITLPromptActive(): boolean;
+export interface DecisionOption {
+    id: string;
+    label: string;
+    description: string;
+    shortcut?: string;
+}
+export interface DecisionRequest {
+    id: string;
+    title: string;
+    description: string;
+    context: string;
+    options: DecisionOption[];
+    defaultOptionId?: string;
+    requiresExplicitChoice: boolean;
+    metadata?: Record<string, any>;
+}
+export interface DecisionResponse {
+    requestId: string;
+    selectedOptionId: string;
+    userInput?: string;
+    timestamp: Date;
+}
+export interface HITLConfig {
+    /**
+     * Whether to automatically pause execution for decisions
+     * If false, decisions will be logged but execution continues
+     */
+    autoPause: boolean;
+    /**
+     * Timeout in milliseconds before auto-proceeding with default
+     * 0 means no timeout (wait indefinitely)
+     */
+    timeoutMs: number;
+    /**
+     * Default option to choose if timeout occurs
+     */
+    timeoutDefaultOptionId?: string;
+    /**
+     * Log level: 'none' | 'minimal' | 'detailed'
+     */
+    logLevel: 'none' | 'minimal' | 'detailed';
+}
+export declare class HITLSystem {
+    private config;
+    private pendingDecisions;
+    private decisionHistory;
+    private rl?;
+    constructor(config?: Partial<HITLConfig>);
+    /**
+     * Request a human decision
+     * @returns Promise that resolves with the selected option ID
+     */
+    requestDecision(request: DecisionRequest): Promise<string>;
+    /**
+     * Present decision to user and wait for input using interactive arrow-key selection
+     */
+    private promptUserForDecision;
+    private cleanupReadline;
+    private getOptionLabel;
+    private logDecisionRequest;
+    private recordDecision;
+    /**
+     * Get decision history
+     */
+    getHistory(): DecisionResponse[];
+    /**
+     * Clear decision history
+     */
+    clearHistory(): void;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<HITLConfig>): void;
+}
+/**
+ * Get the global HITL instance
+ */
+export declare function getHITL(config?: Partial<HITLConfig>): HITLSystem;
+/**
+ * Helper function for common decision patterns
+ */
+export declare const hitl: {
+    /**
+     * Request a yes/no decision
+     */
+    askYesNo(title: string, description: string, context?: string, defaultYes?: boolean): Promise<boolean>;
+    /**
+     * Request selection from multiple options
+     */
+    selectOption(title: string, description: string, options: Array<{
+        id: string;
+        label: string;
+        description: string;
+    }>, context?: string, defaultOptionId?: string): Promise<string>;
+    /**
+     * Request approval for a risky operation
+     */
+    requestApproval(title: string, riskDescription: string, operationDetails: string): Promise<boolean>;
+};
+//# sourceMappingURL=hitl.d.ts.map

package/dist/core/hitl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../src/core/hitl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,mBAAqB,CAAC;AAK7C,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CAC3C;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,EAAE,CAAC,CAAqB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IASxC;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAoChE;;OAEG;YACW,qBAAqB;IA4LnC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,UAAU,IAAI,gBAAgB,EAAE;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;CAGhD;AAKD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAUhE;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;OAEG;oBACmB,MAAM,eAAe,MAAM,YAAW,MAAM,eAAmB,OAAO,GAAU,OAAO,CAAC,OAAO,CAAC;IA6BtH;;OAEG;wBACuB,MAAM,eAAe,MAAM,WAAW,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,YAAW,MAAM,oBAAyB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBzL;;OAEG;2BAC0B,MAAM,mBAAmB,MAAM,oBAAoB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ1G,CAAC"}

package/dist/core/hitl.js

@@ -0,0 +1,387 @@
+/**
+ * Human-in-the-Loop (HITL) System
+ * Pauses AI execution and prompts users for important decision paths
+ * This is the ONLY HITL system in the repository
+ */
+import { stdin, stdout } from 'node:process';
+import * as readline from 'node:readline';
+import { EventEmitter } from 'node:events';
+import chalk from 'chalk';
+import { authorizedShutdown, isShutdownInProgress, onShutdown, installSignalHandlers } from './shutdown.js';
+/**
+ * Module-level event bus that fires when a HITL prompt opens or closes. Other
+ * subsystems subscribe to:
+ *   - pause their own run-timeouts so user think-time doesn't abort the agent
+ *     (see AgentController),
+ *   - hand the terminal off cleanly so the prompt and post-prompt I/O don't
+ *     fight (see UnifiedUIRenderer / interactiveShell).
+ *
+ * Always paired: every `prompt-open` is followed by exactly one `prompt-close`,
+ * including on timeout, Ctrl+C, custom-input, and shutdown paths.
+ */
+export const hitlEvents = new EventEmitter();
+hitlEvents.setMaxListeners(50);
+let activePromptCount = 0;
+export function isHITLPromptActive() {
+    return activePromptCount > 0;
+}
+export class HITLSystem {
+    config;
+    pendingDecisions = new Map();
+    decisionHistory = [];
+    rl;
+    constructor(config) {
+        this.config = {
+            autoPause: true,
+            timeoutMs: 0,
+            logLevel: 'detailed',
+            ...config
+        };
+    }
+    /**
+     * Request a human decision
+     * @returns Promise that resolves with the selected option ID
+     */
+    async requestDecision(request) {
+        // If request already has an ID, use it, otherwise generate one
+        const requestId = request.id || `DECISION-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        const fullRequest = {
+            ...request,
+            id: requestId
+        };
+        this.pendingDecisions.set(requestId, fullRequest);
+        if (this.config.logLevel !== 'none') {
+            this.logDecisionRequest(fullRequest);
+        }
+        // If auto-pause is disabled, return default or first option
+        if (!this.config.autoPause) {
+            const selectedOptionId = request.defaultOptionId || request.options[0]?.id;
+            if (selectedOptionId) {
+                const response = {
+                    requestId,
+                    selectedOptionId,
+                    timestamp: new Date()
+                };
+                this.recordDecision(response);
+                if (this.config.logLevel === 'detailed') {
+                    console.log(chalk.yellow(`⚠️  Auto-proceeding with option: ${this.getOptionLabel(request, selectedOptionId)}`));
+                }
+                return selectedOptionId;
+            }
+        }
+        // Show decision prompt to user
+        return this.promptUserForDecision(fullRequest);
+    }
+    /**
+     * Present decision to user and wait for input using interactive arrow-key selection
+     */
+    async promptUserForDecision(request) {
+        // Ensure signal handlers are installed for Ctrl+C fallback
+        installSignalHandlers();
+        // Check if shutdown is already in progress
+        if (isShutdownInProgress()) {
+            const defaultOption = request.defaultOptionId || request.options[0]?.id;
+            if (defaultOption)
+                return defaultOption;
+            throw new Error('Shutdown in progress');
+        }
+        // Build menu items: all options + "Enter your own" at the end
+        const menuItems = [
+            ...request.options.map(opt => ({ id: opt.id, label: opt.label, description: opt.description })),
+            { id: '__custom__', label: 'Enter your own', description: 'Type a custom plan, instruction, or alternative approach', isCustom: true }
+        ];
+        // Start selection on "Enter your own" (last item)
+        let selectedIndex = menuItems.length - 1;
+        return new Promise((resolve, _reject) => {
+            // Snapshot the terminal state *before* we touch it so we can restore
+            // exactly what the parent renderer had set up — UnifiedUIRenderer keeps
+            // raw mode ON and stdin flowing; clearing those breaks the next prompt.
+            const priorRawMode = stdin.isTTY ? Boolean(stdin.isRaw) : false;
+            const priorPaused = stdin.isPaused();
+            let cleanedUp = false;
+            const promptId = request.id;
+            activePromptCount += 1;
+            hitlEvents.emit('prompt-open', { id: promptId });
+            // Single funnel for every exit path so listeners and event counts stay
+            // consistent regardless of how the prompt resolves.
+            const cleanup = () => {
+                if (cleanedUp)
+                    return;
+                cleanedUp = true;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                unregisterCleanup();
+                try {
+                    stdin.removeListener('data', handleKeypress);
+                }
+                catch { /* ignore */ }
+                if (stdin.isTTY) {
+                    try {
+                        stdin.setRawMode(priorRawMode);
+                    }
+                    catch { /* ignore */ }
+                }
+                if (priorPaused) {
+                    try {
+                        stdin.pause();
+                    }
+                    catch { /* ignore */ }
+                }
+                this.cleanupReadline();
+                activePromptCount = Math.max(0, activePromptCount - 1);
+                hitlEvents.emit('prompt-close', { id: promptId });
+            };
+            // Register cleanup callback for graceful shutdown
+            const unregisterCleanup = onShutdown(() => { cleanup(); });
+            const timeoutId = this.config.timeoutMs > 0
+                ? setTimeout(() => {
+                    // Only honor the timeout if a default option was provided; without
+                    // one, the prompt is required to wait indefinitely.
+                    if (!this.config.timeoutDefaultOptionId)
+                        return;
+                    console.log(chalk.yellow(`\n⏰ Timeout - auto-selecting default option`));
+                    cleanup();
+                    resolve(this.config.timeoutDefaultOptionId);
+                }, this.config.timeoutMs)
+                : undefined;
+            // Render the menu
+            const renderMenu = () => {
+                // Clear screen and move cursor to top
+                stdout.write('\x1b[2J\x1b[H');
+                console.log(chalk.bold.cyan('╔═══════════════════════════════════════════════════════════╗'));
+                console.log(chalk.bold.cyan('║                  HUMAN DECISION REQUIRED                  ║'));
+                console.log(chalk.bold.cyan('╚═══════════════════════════════════════════════════════════╝\n'));
+                console.log(chalk.bold.white(`📋 ${request.title}`));
+                console.log(chalk.dim(request.description));
+                console.log('');
+                if (request.context) {
+                    console.log(chalk.blue('📝 Context:'));
+                    console.log(chalk.dim(request.context));
+                    console.log('');
+                }
+                console.log(chalk.bold.green('🔘 Use ↑↓ arrows to select, Enter to confirm:\n'));
+                menuItems.forEach((item, index) => {
+                    const isSelected = index === selectedIndex;
+                    const marker = isSelected ? chalk.bold.cyan('▸ ') : '  ';
+                    const labelStyle = isSelected ? chalk.bold.cyan : chalk.white;
+                    const descStyle = isSelected ? chalk.cyan : chalk.dim;
+                    console.log(`${marker}${labelStyle(item.label)}`);
+                    console.log(`  ${descStyle(item.description)}`);
+                    console.log('');
+                });
+                console.log(chalk.dim('Press Ctrl+C to cancel'));
+            };
+            // Handle custom input after selection. We tear down the raw-mode menu
+            // listener first, then hand stdin to a one-shot readline. The shared
+            // `cleanup()` is deferred until *after* the user submits, so the
+            // prompt-open/close pairing stays balanced.
+            const handleCustomInput = () => {
+                try {
+                    stdin.removeListener('data', handleKeypress);
+                }
+                catch { /* ignore */ }
+                if (stdin.isTTY) {
+                    try {
+                        stdin.setRawMode(false);
+                    }
+                    catch { /* ignore */ }
+                }
+                console.log(chalk.cyan('\n📝 Enter your custom plan or instruction:'));
+                const customRl = readline.createInterface({
+                    input: stdin,
+                    output: stdout,
+                    terminal: stdin.isTTY
+                });
+                customRl.question(chalk.bold.magenta('👉 Your input: '), (customInput) => {
+                    customRl.close();
+                    cleanup();
+                    if (customInput.trim()) {
+                        console.log(chalk.green(`\n✅ Using custom input: "${customInput.trim()}"`));
+                        const customOptionId = `custom-${Date.now()}`;
+                        const response = {
+                            requestId: request.id,
+                            selectedOptionId: customOptionId,
+                            userInput: customInput.trim(),
+                            timestamp: new Date()
+                        };
+                        this.recordDecision(response);
+                        resolve(customOptionId);
+                    }
+                    else {
+                        console.log(chalk.yellow('⚠️  Empty input, using first option'));
+                        resolve(request.options[0]?.id || '__custom__');
+                    }
+                });
+            };
+            // Take stdin into raw mode for arrow-key navigation. `cleanup()` will
+            // restore whatever state the parent renderer had.
+            if (stdin.isTTY) {
+                stdin.setRawMode(true);
+            }
+            stdin.resume();
+            const handleKeypress = (chunk) => {
+                const key = chunk.toString();
+                // Ctrl+C
+                if (key === '\x03') {
+                    cleanup();
+                    console.log(chalk.red('\n❌ Operation cancelled'));
+                    void authorizedShutdown(130);
+                    return;
+                }
+                // Enter key
+                if (key === '\r' || key === '\n') {
+                    const selectedItem = menuItems[selectedIndex];
+                    if (selectedItem?.isCustom) {
+                        // handleCustomInput defers cleanup() until after readline returns.
+                        handleCustomInput();
+                    }
+                    else if (selectedItem) {
+                        cleanup();
+                        console.log(chalk.green(`\n✅ Selected: ${selectedItem.label}`));
+                        resolve(selectedItem.id);
+                    }
+                    return;
+                }
+                // Arrow keys (escape sequences)
+                if (key === '\x1b[A' || key === 'k') {
+                    // Up arrow or k
+                    selectedIndex = Math.max(0, selectedIndex - 1);
+                    renderMenu();
+                }
+                else if (key === '\x1b[B' || key === 'j') {
+                    // Down arrow or j
+                    selectedIndex = Math.min(menuItems.length - 1, selectedIndex + 1);
+                    renderMenu();
+                }
+            };
+            stdin.on('data', handleKeypress);
+            // Initial render
+            renderMenu();
+        });
+    }
+    cleanupReadline() {
+        if (this.rl) {
+            this.rl.close();
+            this.rl = undefined;
+        }
+    }
+    getOptionLabel(request, optionId) {
+        const option = request.options.find(opt => opt.id === optionId);
+        return option ? option.label : optionId;
+    }
+    logDecisionRequest(request) {
+        if (this.config.logLevel === 'minimal') {
+            console.log(chalk.yellow(`⚠️  Decision required: ${request.title}`));
+            return;
+        }
+        console.log(chalk.yellow(`\n⚠️  Decision Point: ${request.title}`));
+        console.log(chalk.dim(`   ${request.description}`));
+        console.log(chalk.dim(`   Options: ${request.options.map(o => o.label).join(', ')}`));
+    }
+    recordDecision(response) {
+        this.decisionHistory.push(response);
+        this.pendingDecisions.delete(response.requestId);
+        // Log the decision
+        if (this.config.logLevel === 'detailed') {
+            const request = this.pendingDecisions.get(response.requestId);
+            const optionLabel = request ? this.getOptionLabel(request, response.selectedOptionId) : response.selectedOptionId;
+            console.log(chalk.green(`📝 Decision recorded: ${optionLabel}`));
+            if (response.userInput) {
+                console.log(chalk.dim(`   Custom input: ${response.userInput}`));
+            }
+        }
+    }
+    /**
+     * Get decision history
+     */
+    getHistory() {
+        return [...this.decisionHistory];
+    }
+    /**
+     * Clear decision history
+     */
+    clearHistory() {
+        this.decisionHistory = [];
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+// Singleton instance
+let hitlInstance = null;
+/**
+ * Get the global HITL instance
+ */
+export function getHITL(config) {
+    if (!hitlInstance) {
+        hitlInstance = new HITLSystem(config);
+    }
+    if (config) {
+        hitlInstance.updateConfig(config);
+    }
+    return hitlInstance;
+}
+/**
+ * Helper function for common decision patterns
+ */
+export const hitl = {
+    /**
+     * Request a yes/no decision
+     */
+    async askYesNo(title, description, context = '', defaultYes = true) {
+        const hitl = getHITL();
+        const decision = await hitl.requestDecision({
+            id: `yesno-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+            title,
+            description,
+            context,
+            options: [
+                {
+                    id: 'yes',
+                    label: 'Yes',
+                    description: 'Proceed with the suggested plan',
+                    shortcut: 'y'
+                },
+                {
+                    id: 'no',
+                    label: 'No',
+                    description: 'Do not proceed',
+                    shortcut: 'n'
+                }
+            ],
+            defaultOptionId: defaultYes ? 'yes' : 'no',
+            requiresExplicitChoice: true
+        });
+        return decision === 'yes';
+    },
+    /**
+     * Request selection from multiple options
+     */
+    async selectOption(title, description, options, context = '', defaultOptionId) {
+        const hitl = getHITL();
+        const decision = await hitl.requestDecision({
+            id: `select-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+            title,
+            description,
+            context,
+            options: options.map((opt, index) => ({
+                ...opt,
+                shortcut: String(index + 1)
+            })),
+            defaultOptionId,
+            requiresExplicitChoice: true
+        });
+        return decision;
+    },
+    /**
+     * Request approval for a risky operation
+     */
+    async requestApproval(title, riskDescription, operationDetails) {
+        return hitl.askYesNo(`APPROVAL REQUIRED: ${title}`, riskDescription, operationDetails, false // Default to "no" for safety
+        );
+    }
+};
+//# sourceMappingURL=hitl.js.map

package/dist/core/hitl.js.map

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

package/dist/core/hooks.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Hooks — Claude-Code-style shell-command hooks that fire around
+ * tool execution. Lets users customize agent behavior without
+ * editing source: run a linter after every Edit, log Bash commands,
+ * block dangerous tools, etc.
+ *
+ * Settings file (per Claude Code convention):
+ *   {
+ *     "hooks": {
+ *       "PreToolUse": [
+ *         { "matcher": "Bash", "hooks": [{ "type": "command", "command": "/path/to/script.sh" }] }
+ *       ],
+ *       "PostToolUse": [ ... ]
+ *     }
+ *   }
+ *
+ * Loaded from (in priority order):
+ *   1. <workingDir>/.erosolar/settings.json    (project-local)
+ *   2. ~/.erosolar/settings.json               (user-global)
+ *
+ * Both load — project-local extends user-global; matchers from both
+ * files fire if applicable.
+ *
+ * Hook contract: the command receives a JSON envelope on stdin,
+ * shape:
+ *   { event: 'PreToolUse'|'PostToolUse', toolName, toolArgs, toolResult? }
+ * The command exits 0 + writes a JSON response on stdout to either
+ * pass through or shape the result:
+ *   {}                            — pass through
+ *   { "decision": "block",
+ *     "reason": "string" }        — PreToolUse: block the tool call
+ *   { "appendToResult": "..." }   — PostToolUse: append text to the
+ *                                     model-visible tool result
+ *
+ * Hooks are best-effort: a hook that times out, errors, or returns
+ * malformed JSON is logged and skipped — never crashes the agent.
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Stop' | 'SessionStart';
+export interface HookCommand {
+    /** Always 'command' for now; reserved for future inline-JS hooks. */
+    type: 'command';
+    /** Shell command to invoke. Run via the user's default shell. */
+    command: string;
+    /** Per-hook timeout in ms. Default: 5000. Cap: 30000. */
+    timeoutMs?: number;
+}
+export interface HookMatcher {
+    /**
+     * For PreToolUse / PostToolUse: a tool-name regex (anchored). Use
+     * "*" or omit to match every tool. For other events: ignored.
+     */
+    matcher?: string;
+    hooks: HookCommand[];
+}
+export interface HooksConfig {
+    hooks?: Partial<Record<HookEvent, HookMatcher[]>>;
+}
+export interface PreToolUseInput {
+    event: 'PreToolUse';
+    toolName: string;
+    toolArgs: unknown;
+}
+export interface PostToolUseInput {
+    event: 'PostToolUse';
+    toolName: string;
+    toolArgs: unknown;
+    toolResult: unknown;
+}
+export interface PreToolUseDecision {
+    decision?: 'block';
+    reason?: string;
+}
+export interface PostToolUseDecision {
+    appendToResult?: string;
+}
+/**
+ * Read + merge settings from project-local + user-global locations.
+ * Returns an empty config if neither file exists. Malformed JSON is
+ * silently skipped (with a console.warn).
+ */
+export declare function loadHooksConfig(workingDir: string): HooksConfig;
+/**
+ * Run all PreToolUse hooks matching `toolName`. Returns the FIRST
+ * blocking decision encountered, or null if no hook blocks.
+ */
+export declare function runPreToolUseHooks(config: HooksConfig, toolName: string, toolArgs: unknown): Promise<PreToolUseDecision | null>;
+/**
+ * Run all PostToolUse hooks matching `toolName`. Concatenates any
+ * appendToResult strings (in matcher order) so multiple hooks can
+ * each contribute a note.
+ */
+export declare function runPostToolUseHooks(config: HooksConfig, toolName: string, toolArgs: unknown, toolResult: unknown): Promise<{
+    appendToResult: string;
+} | null>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/core/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAOH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,kBAAkB,GAAG,MAAM,GAAG,cAAc,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CA+B/D;AAyGD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAoBpC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqB5C"}