@windagency/valora 2.0.1

package/dist/executor/hook-execution.service.js

@@ -0,0 +1,371 @@
+/**
+ * Hook Execution Service
+ *
+ * Intercepts tool calls before (PreToolUse) and after (PostToolUse) execution,
+ * running user-configured shell commands that can validate, block, modify, or
+ * observe tool operations.
+ *
+ * Hooks are configured in data/hooks.default.json (built-in) or .valora/hooks.json (project-level override).
+ * Hook commands receive tool call info via stdin JSON and control execution
+ * via exit codes (0=allow, 2=deny for PreToolUse; PostToolUse is non-blocking).
+ */
+import { exec } from 'child_process';
+import { HOOKS_CONFIG_FILE } from '../config/constants.js';
+import { getConfigLoader } from '../config/loader.js';
+import fs from 'fs';
+import { getLogger } from '../output/logger.js';
+import { getPipelineEmitter } from '../output/pipeline-emitter.js';
+import path from 'path';
+import { formatErrorMessage } from '../utils/error-utils.js';
+import { getPackageDataDir } from '../utils/paths.js';
+import { checkReDoSRisk, safeRegexTest } from '../utils/safe-regex.js';
+const DEFAULT_HOOK_TIMEOUT_MS = 10_000;
+export class HookExecutionService {
+    hooksFileCache = null;
+    hooksFileMtime = 0;
+    logger = getLogger();
+    sessionId;
+    /**
+     * Fast check to skip processing when no hooks are configured.
+     * Returns false for zero-overhead path when hooks are not in use.
+     */
+    hasHooks(eventName) {
+        const config = this.getHooksConfig();
+        if (!config) {
+            return false;
+        }
+        const matchers = config[eventName];
+        return Array.isArray(matchers) && matchers.length > 0;
+    }
+    /**
+     * Set the session ID included in hook input payloads.
+     */
+    setSessionId(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /**
+     * Execute PreToolUse hooks for a tool call.
+     * Hooks can block execution (exit code 2) or modify tool input (exit code 0 with updatedInput).
+     * Hooks execute sequentially; first deny stops the chain.
+     */
+    async executePreToolUseHooks(toolCall) {
+        const result = {
+            allowed: true,
+            errors: [],
+            hooksExecuted: 0
+        };
+        const config = this.getHooksConfig();
+        if (!config?.PreToolUse) {
+            return result;
+        }
+        const matchingHooks = this.findMatchingHooks(toolCall.name, config.PreToolUse);
+        if (matchingHooks.length === 0) {
+            return result;
+        }
+        const input = this.buildHookInput('PreToolUse', toolCall);
+        const emitter = getPipelineEmitter();
+        for (const hook of matchingHooks) {
+            emitter.emitToolHookTriggered({
+                eventName: 'PreToolUse',
+                hookCommand: hook.command,
+                toolName: toolCall.name
+            });
+            const blocked = await this.runPreToolUseHook(hook, input, result, toolCall.name, emitter);
+            if (blocked) {
+                return result;
+            }
+        }
+        return result;
+    }
+    /**
+     * Run a single PreToolUse hook and apply its result.
+     * Returns true if the hook blocked execution (deny).
+     */
+    async runPreToolUseHook(hook, input, result, toolName, emitter) {
+        try {
+            const { exitCode, stderr, stdout } = await this.executeHookCommand(hook, input);
+            result.hooksExecuted++;
+            if (exitCode === 2) {
+                return this.handlePreToolUseDeny(stdout, stderr, result, toolName, emitter);
+            }
+            if (exitCode === 0) {
+                this.handlePreToolUseAllow(stdout, input, result);
+            }
+            else {
+                this.logger.warn(`PreToolUse hook exited with code ${exitCode}, allowing (fail-open)`, {
+                    command: hook.command,
+                    stderr: stderr.trim()
+                });
+                result.errors.push(`Hook "${hook.command}" exited with code ${exitCode}`);
+            }
+        }
+        catch (error) {
+            const errorMsg = formatErrorMessage(error);
+            this.logger.warn(`PreToolUse hook error, allowing (fail-open)`, {
+                command: hook.command,
+                error: errorMsg
+            });
+            result.errors.push(`Hook "${hook.command}" error: ${errorMsg}`);
+            result.hooksExecuted++;
+        }
+        return false;
+    }
+    /**
+     * Handle a PreToolUse hook deny (exit code 2).
+     */
+    handlePreToolUseDeny(stdout, stderr, result, toolName, emitter) {
+        const parsed = this.parseHookOutput(stdout);
+        const reason = parsed?.hookSpecificOutput?.permissionDecisionReason ?? (stderr.trim() || 'Blocked by PreToolUse hook');
+        result.allowed = false;
+        result.blockReason = reason;
+        emitter.emitToolHookBlocked({ reason, toolName });
+        return true;
+    }
+    /**
+     * Handle a PreToolUse hook allow (exit code 0), applying any updatedInput.
+     */
+    handlePreToolUseAllow(stdout, input, result) {
+        const parsed = this.parseHookOutput(stdout);
+        if (parsed?.hookSpecificOutput?.updatedInput) {
+            result.updatedArgs = {
+                ...result.updatedArgs,
+                ...parsed.hookSpecificOutput.updatedInput
+            };
+            input.tool_input = { ...input.tool_input, ...parsed.hookSpecificOutput.updatedInput };
+        }
+    }
+    /**
+     * Execute PostToolUse hooks for a tool call (non-blocking, informational only).
+     * Exit codes are logged but never block the pipeline.
+     * Async hooks fire-and-forget without awaiting completion.
+     */
+    async executePostToolUseHooks(toolCall, toolResult) {
+        const config = this.getHooksConfig();
+        if (!config?.PostToolUse) {
+            return;
+        }
+        const matchingHooks = this.findMatchingHooks(toolCall.name, config.PostToolUse);
+        if (matchingHooks.length === 0) {
+            return;
+        }
+        const input = this.buildHookInput('PostToolUse', toolCall, toolResult);
+        const emitter = getPipelineEmitter();
+        for (const hook of matchingHooks) {
+            emitter.emitToolHookTriggered({
+                eventName: 'PostToolUse',
+                hookCommand: hook.command,
+                toolName: toolCall.name
+            });
+            if (hook.async) {
+                // Fire-and-forget
+                this.executeHookCommand(hook, input)
+                    .then(({ exitCode }) => {
+                    emitter.emitToolHookPost({
+                        hookCommand: hook.command,
+                        success: exitCode === 0,
+                        toolName: toolCall.name
+                    });
+                })
+                    .catch((err) => {
+                    this.logger.warn('PostToolUse async hook error', {
+                        command: hook.command,
+                        error: formatErrorMessage(err)
+                    });
+                    emitter.emitToolHookPost({
+                        hookCommand: hook.command,
+                        success: false,
+                        toolName: toolCall.name
+                    });
+                });
+            }
+            else {
+                try {
+                    const { exitCode } = await this.executeHookCommand(hook, input);
+                    emitter.emitToolHookPost({
+                        hookCommand: hook.command,
+                        success: exitCode === 0,
+                        toolName: toolCall.name
+                    });
+                    if (exitCode !== 0) {
+                        this.logger.warn(`PostToolUse hook exited with code ${exitCode}`, {
+                            command: hook.command
+                        });
+                    }
+                }
+                catch (error) {
+                    this.logger.warn('PostToolUse hook error', {
+                        command: hook.command,
+                        error: formatErrorMessage(error)
+                    });
+                    emitter.emitToolHookPost({
+                        hookCommand: hook.command,
+                        success: false,
+                        toolName: toolCall.name
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Spawn a shell command, writing JSON to stdin.
+     * Returns the exit code, stdout, and stderr.
+     */
+    executeHookCommand(hook, input) {
+        const timeout = hook.timeout ?? DEFAULT_HOOK_TIMEOUT_MS;
+        const inputJson = JSON.stringify(input);
+        return new Promise((resolve, reject) => {
+            const child = exec(hook.command, { cwd: input.cwd, timeout }, (error, stdout, stderr) => {
+                if (error && 'killed' in error && error.killed) {
+                    // Timeout
+                    reject(new Error(`Hook command timed out after ${timeout}ms: ${hook.command}`));
+                    return;
+                }
+                // exec error with exit code is not a fatal error — the hook ran but exited non-zero
+                const exitCode = error?.code ?? 0;
+                resolve({
+                    exitCode: typeof exitCode === 'number' ? exitCode : 1,
+                    stderr: stderr ?? '',
+                    stdout: stdout ?? ''
+                });
+            });
+            // Write input JSON to stdin
+            if (child.stdin) {
+                child.stdin.on('error', () => {
+                    // Ignore EPIPE errors — the process may exit before reading stdin
+                });
+                child.stdin.write(inputJson);
+                child.stdin.end();
+            }
+        });
+    }
+    /**
+     * Test regex matchers against tool name and collect matching hook commands.
+     * Invalid regexes are skipped with a warning (graceful degradation).
+     */
+    findMatchingHooks(toolName, matchers) {
+        const hooks = [];
+        for (const matcher of matchers) {
+            try {
+                const risk = checkReDoSRisk(matcher.matcher);
+                if (!risk.safe) {
+                    this.logger.warn(`Skipping hook matcher with ReDoS risk: "${matcher.matcher}"`, {
+                        reason: risk.reason
+                    });
+                    continue;
+                }
+                const regex = new RegExp(matcher.matcher);
+                if (safeRegexTest(regex, toolName)) {
+                    hooks.push(...matcher.hooks);
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Invalid regex in hook matcher: "${matcher.matcher}"`, {
+                    error: formatErrorMessage(error)
+                });
+            }
+        }
+        return hooks;
+    }
+    /**
+     * Safely parse JSON output from a hook command's stdout.
+     * Returns null if stdout is empty or not valid JSON.
+     */
+    parseHookOutput(stdout) {
+        const trimmed = stdout.trim();
+        if (!trimmed) {
+            return null;
+        }
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load hooks from data/hooks.default.json with mtime-based caching.
+     * Returns null if the file doesn't exist or can't be parsed.
+     */
+    loadHooksFile() {
+        try {
+            const hooksPath = path.join(getPackageDataDir(), HOOKS_CONFIG_FILE);
+            const stat = fs.statSync(hooksPath);
+            const mtime = stat.mtimeMs;
+            if (this.hooksFileCache && mtime === this.hooksFileMtime) {
+                return this.hooksFileCache;
+            }
+            const content = fs.readFileSync(hooksPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            this.hooksFileCache = parsed;
+            this.hooksFileMtime = mtime;
+            return parsed;
+        }
+        catch {
+            // File missing or invalid — no hooks from hooks.json
+            return null;
+        }
+    }
+    /**
+     * Read hooks config, merging data/hooks.default.json (primary) with config.json (fallback).
+     * For each event name, hooks.json matchers come first; duplicates by matcher pattern
+     * are resolved in favour of hooks.json.
+     */
+    getHooksConfig() {
+        const hooksFromFile = this.loadHooksFile()?.hooks;
+        let hooksFromConfig;
+        try {
+            hooksFromConfig = getConfigLoader().get().hooks;
+        }
+        catch {
+            // Config not yet loaded
+        }
+        if (hooksFromFile && hooksFromConfig) {
+            return this.mergeHooksConfigs(hooksFromFile, hooksFromConfig);
+        }
+        return hooksFromFile ?? hooksFromConfig;
+    }
+    /**
+     * Merge two HooksConfig objects. Primary (hooks.json) takes priority;
+     * config.json matchers with the same pattern are skipped.
+     */
+    mergeHooksConfigs(primary, fallback) {
+        const merged = {};
+        const eventNames = new Set([...Object.keys(fallback), ...Object.keys(primary)]);
+        for (const eventName of eventNames) {
+            const primaryMatchers = primary[eventName] ?? [];
+            const fallbackMatchers = fallback[eventName] ?? [];
+            const primaryPatterns = new Set(primaryMatchers.map((m) => m.matcher));
+            const deduped = [...primaryMatchers, ...fallbackMatchers.filter((m) => !primaryPatterns.has(m.matcher))];
+            if (deduped.length > 0) {
+                merged[eventName] = deduped;
+            }
+        }
+        return Object.keys(merged).length > 0 ? merged : undefined;
+    }
+    /**
+     * Build the HookInput object sent to hook commands via stdin.
+     */
+    buildHookInput(eventName, toolCall, toolResult) {
+        const input = {
+            cwd: process.cwd(),
+            hook_event_name: eventName,
+            session_id: this.sessionId,
+            tool_input: (toolCall.arguments ?? {}),
+            tool_name: toolCall.name
+        };
+        if (toolResult !== undefined) {
+            input.tool_result = toolResult;
+        }
+        return input;
+    }
+}
+// Singleton instance
+let hookExecutionService = null;
+export function getHookExecutionService() {
+    hookExecutionService ??= new HookExecutionService();
+    return hookExecutionService;
+}
+export function setHookExecutionService(service) {
+    hookExecutionService = service;
+}
+//# sourceMappingURL=hook-execution.service.js.map

package/dist/executor/hook-execution.service.js.map

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

package/dist/executor/index.d.ts

@@ -0,0 +1,16 @@
+export * from './agent-loader.js';
+/**
+ * Central exports for executor
+ */
+export * from './command-loader.js';
+export * from './dry-run-cache.js';
+export * from './dry-run-strategy.js';
+export * from './escalation-detection.service.js';
+export * from './escalation-handler.service.js';
+export * from './execution-strategy.js';
+export * from './project-guidance-loader.js';
+export * from './prompt-loader.js';
+export * from './stage-output-cache.js';
+export * from './stage-validation.service.js';
+export * from './tool-execution.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/executor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC"}

package/dist/executor/index.js

@@ -0,0 +1,16 @@
+export * from './agent-loader.js';
+/**
+ * Central exports for executor
+ */
+export * from './command-loader.js';
+export * from './dry-run-cache.js';
+export * from './dry-run-strategy.js';
+export * from './escalation-detection.service.js';
+export * from './escalation-handler.service.js';
+export * from './execution-strategy.js';
+export * from './project-guidance-loader.js';
+export * from './prompt-loader.js';
+export * from './stage-output-cache.js';
+export * from './stage-validation.service.js';
+export * from './tool-execution.service.js';
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B;;GAEG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC"}

package/dist/executor/input-pre-resolver.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Input Pre-Resolver - Pre-resolves static stage inputs for performance optimisation
+ *
+ * This service analyses pipeline stages and pre-resolves inputs that don't depend
+ * on previous stage outputs ($STAGE_* variables). This allows:
+ * - File contents to be cached upfront
+ * - Reduce resolution time during stage execution
+ * - Early validation of input availability
+ */
+import type { PipelineStage } from '../types/command.types.js';
+import type { VariableResolutionService } from './variable-resolution.service.js';
+export interface PreResolvedInputs {
+    /** Map of stage key to pre-resolved inputs */
+    stages: Map<string, Record<string, unknown>>;
+    /** Map of file path to cached content */
+    fileCache: Map<string, string>;
+    /** Stages that have all inputs pre-resolved (no $STAGE_* dependencies) */
+    fullyResolvedStages: Set<string>;
+}
+/**
+ * Input Pre-Resolver Service
+ *
+ * Analyses pipeline stages and pre-resolves inputs that don't depend on
+ * previous stage outputs, improving pipeline execution performance.
+ */
+export declare class InputPreResolver {
+    private fileCache;
+    private preResolvedInputs;
+    /**
+     * Pre-resolve static inputs for all stages in a pipeline
+     *
+     * @param stages - Pipeline stages to analyse
+     * @param variableResolver - Variable resolver with current context
+     * @returns PreResolvedInputs containing cached inputs and file contents
+     */
+    preResolveStaticInputs(stages: PipelineStage[], variableResolver: VariableResolutionService): Promise<PreResolvedInputs>;
+    /**
+     * Get pre-resolved inputs for a stage if available
+     */
+    getPreResolvedInputs(stageKey: string): Record<string, unknown> | undefined;
+    /**
+     * Get cached file content if available
+     */
+    getCachedFileContent(filePath: string): string | undefined;
+    /**
+     * Check if inputs contain any $STAGE_* variable references
+     */
+    private hasStageReferences;
+    /**
+     * Enrich inputs by reading file contents for file path arguments
+     * Caches file contents for reuse
+     */
+    private enrichInputsWithFileContents;
+    /**
+     * Clear cached data
+     */
+    clear(): void;
+}
+export declare function getInputPreResolver(): InputPreResolver;
+export declare function resetInputPreResolver(): void;
+//# sourceMappingURL=input-pre-resolver.d.ts.map

package/dist/executor/input-pre-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-pre-resolver.d.ts","sourceRoot":"","sources":["../../src/executor/input-pre-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IACjC,8CAA8C;IAC9C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,yCAAyC;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,0EAA0E;IAC1E,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,iBAAiB,CAAmD;IAE5E;;;;;;OAMG;IACG,sBAAsB,CAC3B,MAAM,EAAE,aAAa,EAAE,EACvB,gBAAgB,EAAE,yBAAyB,GACzC,OAAO,CAAC,iBAAiB,CAAC;IA0D7B;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAI3E;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI1D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;;OAGG;YACW,4BAA4B;IA8C1C;;OAEG;IACH,KAAK,IAAI,IAAI;CAIb;AAOD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/executor/input-pre-resolver.js

@@ -0,0 +1,172 @@
+/**
+ * Input Pre-Resolver - Pre-resolves static stage inputs for performance optimisation
+ *
+ * This service analyses pipeline stages and pre-resolves inputs that don't depend
+ * on previous stage outputs ($STAGE_* variables). This allows:
+ * - File contents to be cached upfront
+ * - Reduce resolution time during stage execution
+ * - Early validation of input availability
+ */
+import { existsSync } from 'fs';
+import { getLogger } from '../output/logger.js';
+import { readFile } from '../utils/file-utils.js';
+/**
+ * Input Pre-Resolver Service
+ *
+ * Analyses pipeline stages and pre-resolves inputs that don't depend on
+ * previous stage outputs, improving pipeline execution performance.
+ */
+export class InputPreResolver {
+    fileCache = new Map();
+    preResolvedInputs = new Map();
+    /**
+     * Pre-resolve static inputs for all stages in a pipeline
+     *
+     * @param stages - Pipeline stages to analyse
+     * @param variableResolver - Variable resolver with current context
+     * @returns PreResolvedInputs containing cached inputs and file contents
+     */
+    async preResolveStaticInputs(stages, variableResolver) {
+        const logger = getLogger();
+        const fullyResolvedStages = new Set();
+        const startTime = Date.now();
+        logger.debug('Pre-resolving static inputs for pipeline', {
+            stageCount: stages.length
+        });
+        for (const stage of stages) {
+            const stageKey = `${stage.stage}_${stage.prompt}`;
+            if (!stage.inputs) {
+                // No inputs to resolve
+                fullyResolvedStages.add(stageKey);
+                continue;
+            }
+            // Check if inputs contain any $STAGE_* references
+            const hasStageRefs = this.hasStageReferences(stage.inputs);
+            if (!hasStageRefs) {
+                // All inputs are static ($ARG_*, $CONTEXT_*, $ENV_*, or literal values)
+                try {
+                    const resolvedInputs = variableResolver.resolve(stage.inputs);
+                    // Pre-read file contents for file path arguments
+                    const enrichedInputs = await this.enrichInputsWithFileContents(resolvedInputs);
+                    this.preResolvedInputs.set(stageKey, enrichedInputs);
+                    fullyResolvedStages.add(stageKey);
+                    logger.debug(`Pre-resolved inputs for stage: ${stageKey}`, {
+                        inputKeys: Object.keys(enrichedInputs)
+                    });
+                }
+                catch (error) {
+                    // Resolution failed, stage will resolve at execution time
+                    logger.debug(`Pre-resolution failed for stage ${stageKey}, will resolve at execution`, {
+                        error: error.message
+                    });
+                }
+            }
+        }
+        const duration = Date.now() - startTime;
+        logger.debug('Pre-resolution complete', {
+            durationMs: duration,
+            fullyResolvedCount: fullyResolvedStages.size,
+            totalStages: stages.length
+        });
+        return {
+            fileCache: this.fileCache,
+            fullyResolvedStages,
+            stages: this.preResolvedInputs
+        };
+    }
+    /**
+     * Get pre-resolved inputs for a stage if available
+     */
+    getPreResolvedInputs(stageKey) {
+        return this.preResolvedInputs.get(stageKey);
+    }
+    /**
+     * Get cached file content if available
+     */
+    getCachedFileContent(filePath) {
+        return this.fileCache.get(filePath);
+    }
+    /**
+     * Check if inputs contain any $STAGE_* variable references
+     */
+    hasStageReferences(inputs) {
+        const stagePattern = /\$STAGE_/;
+        const checkValue = (value) => {
+            if (typeof value === 'string') {
+                return stagePattern.test(value);
+            }
+            if (Array.isArray(value)) {
+                return value.some(checkValue);
+            }
+            if (typeof value === 'object' && value !== null) {
+                return Object.values(value).some(checkValue);
+            }
+            return false;
+        };
+        return Object.values(inputs).some(checkValue);
+    }
+    /**
+     * Enrich inputs by reading file contents for file path arguments
+     * Caches file contents for reuse
+     */
+    async enrichInputsWithFileContents(inputs) {
+        const logger = getLogger();
+        const enriched = {};
+        for (const [key, value] of Object.entries(inputs)) {
+            // Check if this is a file path argument (ends with _file, _file_arg, or _path)
+            const isFileArg = key.endsWith('_file') || key.endsWith('_file_arg') || key.endsWith('_path');
+            if (isFileArg && typeof value === 'string' && value.trim()) {
+                const filePath = value.trim();
+                // Check cache first
+                if (this.fileCache.has(filePath)) {
+                    enriched[key] = filePath;
+                    enriched[`${key}_content`] = this.fileCache.get(filePath);
+                    continue;
+                }
+                // Check if file exists
+                if (existsSync(filePath)) {
+                    try {
+                        const content = await readFile(filePath);
+                        this.fileCache.set(filePath, content);
+                        logger.debug(`Pre-cached file content: ${filePath} (${content.length} chars)`);
+                        // Include both the path and the content
+                        enriched[key] = filePath;
+                        enriched[`${key}_content`] = content;
+                    }
+                    catch (error) {
+                        logger.debug(`Failed to pre-read file: ${filePath}`, {
+                            error: error.message
+                        });
+                        enriched[key] = value;
+                    }
+                }
+                else {
+                    enriched[key] = value;
+                }
+            }
+            else {
+                enriched[key] = value;
+            }
+        }
+        return enriched;
+    }
+    /**
+     * Clear cached data
+     */
+    clear() {
+        this.fileCache.clear();
+        this.preResolvedInputs.clear();
+    }
+}
+/**
+ * Singleton instance for global access
+ */
+let inputPreResolverInstance = null;
+export function getInputPreResolver() {
+    inputPreResolverInstance ??= new InputPreResolver();
+    return inputPreResolverInstance;
+}
+export function resetInputPreResolver() {
+    inputPreResolverInstance = null;
+}
+//# sourceMappingURL=input-pre-resolver.js.map