@hypercli/gen 0.1.1

package/dist/recipe-engine/tools/patch-tool.js.map

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

package/dist/recipe-engine/tools/prompt-tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt Tool Implementation for Recipe Step System
+ *
+ * This tool enables interactive user prompts within recipe execution steps.
+ * It integrates with the interactive prompt system to collect user input
+ * and store it in execution context variables.
+ */
+import type { PromptStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class PromptTool extends Tool<PromptStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: PromptStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: PromptStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    private createResult;
+    private mapPromptType;
+    private mapOptions;
+    private createValidator;
+}
+export declare class PromptToolFactory {
+    create(name?: string, options?: Record<string, any>): PromptTool;
+    getToolType(): "prompt";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const promptToolFactory: PromptToolFactory;
+//# sourceMappingURL=prompt-tool.d.ts.map

package/dist/recipe-engine/tools/prompt-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/prompt-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAEX,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5D,qBAAa,UAAW,SAAQ,IAAI,CAAC,UAAU,CAAC;gBACnC,IAAI,SAAgB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAInD,UAAU,CACzB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;cA4BhB,SAAS,CACxB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA6DtB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,eAAe;CAYvB;AAED,qBAAa,iBAAiB;IAC7B,MAAM,CAAC,IAAI,SAAgB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,UAAU;IAI3E,WAAW,IAAI,QAAQ;IAIvB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAQjE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/recipe-engine/tools/prompt-tool.js

@@ -0,0 +1,162 @@
+/**
+ * Prompt Tool Implementation for Recipe Step System
+ *
+ * This tool enables interactive user prompts within recipe execution steps.
+ * It integrates with the interactive prompt system to collect user input
+ * and store it in execution context variables.
+ */
+import { performInteractivePrompting } from "#prompts/interactive-prompts";
+import { Tool } from "./base.js";
+export class PromptTool extends Tool {
+    constructor(name = "prompt-tool", options = {}) {
+        super("prompt", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        if (!step.variable) {
+            errors.push("Target variable name is required");
+        }
+        if (step.promptType === "select" || step.promptType === "multiselect") {
+            if (!step.options || (Array.isArray(step.options) && step.options.length === 0)) {
+                errors.push(`Options are required for ${step.promptType} prompt`);
+            }
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings: [],
+            suggestions: [],
+            estimatedExecutionTime: 0, // Interactive time depends on user
+            resourceRequirements: {
+                memory: 0,
+                disk: 0,
+                network: false,
+                processes: 0,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Executing prompt step: %s (variable: %s)", step.name, step.variable);
+        try {
+            // In non-interactive mode or dry-run, use default value if available
+            if (options?.dryRun || process.env.CI || process.env.INTERACTIVE === "false") {
+                const value = step.default;
+                this.debug("Using default value in non-interactive/dry-run mode: %o", value);
+                // Update context variables
+                context.variables[step.variable] = value;
+                return this.createResult(step, value, startTime, "completed");
+            }
+            // Convert step configuration to prompt configuration
+            const promptConfig = {
+                type: this.mapPromptType(step.promptType),
+                name: step.variable,
+                message: step.message || `Enter value for ${step.variable}`,
+                default: step.default,
+                choices: this.mapOptions(step.options),
+                validate: this.createValidator(step.validate),
+            };
+            // Execute prompt
+            // Logger in context is ActionLogger which has info/warn/error but not log
+            // We can adapt it or just pass undefined if logger shape doesn't match
+            const loggerAdapter = context.logger
+                ? { log: (msg) => context.logger?.info(msg) }
+                : undefined;
+            const result = await performInteractivePrompting([promptConfig], loggerAdapter);
+            const value = result[step.variable];
+            this.debug("Prompt completed, value: %o", value);
+            // Update context variables
+            context.variables[step.variable] = value;
+            return this.createResult(step, value, startTime, "completed");
+        }
+        catch (error) {
+            const endTime = new Date();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "prompt",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: "PROMPT_EXECUTION_ERROR",
+                    cause: error,
+                },
+            };
+        }
+    }
+    createResult(step, value, startTime, status) {
+        const endTime = new Date();
+        return {
+            status,
+            stepName: step.name,
+            toolType: "prompt",
+            startTime,
+            endTime,
+            duration: endTime.getTime() - startTime.getTime(),
+            retryCount: 0,
+            dependenciesSatisfied: true,
+            toolResult: {
+                variable: step.variable,
+                value,
+            },
+            output: {
+                variable: step.variable,
+                value,
+            },
+        };
+    }
+    mapPromptType(type) {
+        switch (type) {
+            case "select":
+                return "list";
+            case "multiselect":
+                return "multiselect"; // assuming supported by prompt tool, otherwise list
+            case "confirm":
+                return "confirm";
+            default:
+                return "input";
+        }
+    }
+    mapOptions(options) {
+        if (!options)
+            return undefined;
+        if (Array.isArray(options) && typeof options[0] === "string") {
+            return options;
+        }
+        // Extract values if objects
+        return options.map((o) => o.value);
+    }
+    createValidator(validate) {
+        if (!validate)
+            return undefined;
+        // Support regex pattern validation
+        if (validate.startsWith("/") && validate.endsWith("/")) {
+            const pattern = validate.slice(1, -1);
+            const regex = new RegExp(pattern);
+            return (input) => regex.test(String(input)) || "Invalid format";
+        }
+        return undefined;
+    }
+}
+export class PromptToolFactory {
+    create(name = "prompt-tool", options = {}) {
+        return new PromptTool(name, options);
+    }
+    getToolType() {
+        return "prompt";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const promptToolFactory = new PromptToolFactory();
+//# sourceMappingURL=prompt-tool.js.map

package/dist/recipe-engine/tools/prompt-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-tool.js","sourceRoot":"","sources":["../../../src/recipe-engine/tools/prompt-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAQ3E,OAAO,EAAE,IAAI,EAA6B,MAAM,WAAW,CAAC;AAE5D,MAAM,OAAO,UAAW,SAAQ,IAAgB;IAC/C,YAAY,IAAI,GAAG,aAAa,EAAE,UAA+B,EAAE;QAClE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IAES,KAAK,CAAC,UAAU,CACzB,IAAgB,EAChB,OAAoB;QAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;YACvE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjF,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,UAAU,SAAS,CAAC,CAAC;YACnE,CAAC;QACF,CAAC;QAED,OAAO;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,sBAAsB,EAAE,CAAC,EAAE,mCAAmC;YAC9D,oBAAoB,EAAE;gBACrB,MAAM,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,CAAC;aACZ;SACD,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS,CACxB,IAAgB,EAChB,OAAoB,EACpB,OAA8B;QAE9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,0CAA0C,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjF,IAAI,CAAC;YACJ,qEAAqE;YACrE,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;gBAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,yDAAyD,EAAE,KAAK,CAAC,CAAC;gBAE7E,2BAA2B;gBAC3B,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;gBAEzC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;YAC/D,CAAC;YAED,qDAAqD;YACrD,MAAM,YAAY,GAAG;gBACpB,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;gBACzC,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mBAAmB,IAAI,CAAC,QAAQ,EAAE;gBAC3D,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBACtC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;aAC7C,CAAC;YAEF,iBAAiB;YACjB,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM;gBACnC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;gBACrD,CAAC,CAAC,SAAS,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,CAAC;YAChF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEpC,IAAI,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YAEjD,2BAA2B;YAC3B,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YAEzC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;YAC3B,OAAO;gBACN,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ;gBAClB,SAAS;gBACT,OAAO;gBACP,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;gBACjD,UAAU,EAAE,CAAC;gBACb,qBAAqB,EAAE,IAAI;gBAC3B,KAAK,EAAE;oBACN,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,wBAAwB;oBAC9B,KAAK,EAAE,KAAK;iBACZ;aACD,CAAC;QACH,CAAC;IACF,CAAC;IAEO,YAAY,CACnB,IAAgB,EAChB,KAAU,EACV,SAAe,EACf,MAA+B;QAE/B,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC3B,OAAO;YACN,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,QAAQ;YAClB,SAAS;YACT,OAAO;YACP,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;YACjD,UAAU,EAAE,CAAC;YACb,qBAAqB,EAAE,IAAI;YAC3B,UAAU,EAAE;gBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;aACoB;YAC1B,MAAM,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;aACL;SACD,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAAY;QACjC,QAAQ,IAAI,EAAE,CAAC;YACd,KAAK,QAAQ;gBACZ,OAAO,MAAM,CAAC;YACf,KAAK,aAAa;gBACjB,OAAO,aAAa,CAAC,CAAC,oDAAoD;YAC3E,KAAK,SAAS;gBACb,OAAO,SAAS,CAAC;YAClB;gBACC,OAAO,OAAO,CAAC;QACjB,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,OAAyD;QAC3E,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC9D,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,4BAA4B;QAC5B,OAAQ,OAAgD,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IAEO,eAAe,CAAC,QAAiB;QACxC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAEhC,mCAAmC;QACnC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC;QACtE,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;CACD;AAED,MAAM,OAAO,iBAAiB;IAC7B,MAAM,CAAC,IAAI,GAAG,aAAa,EAAE,UAA+B,EAAE;QAC7D,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,WAAW;QACV,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,MAA2B;QACzC,OAAO;YACN,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;SACf,CAAC;IACH,CAAC;CACD;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/recipe-engine/tools/query-tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Query Tool Implementation for Recipe Step System
+ *
+ * Reads structured data files (JSON, YAML, TOML, .env) and evaluates
+ * dot-path checks or expressions against them. Results can be exported
+ * to recipe variables for use in subsequent steps.
+ */
+import type { QueryStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class QueryTool extends Tool<QueryStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: QueryStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: QueryStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+}
+export declare class QueryToolFactory {
+    create(name?: string, options?: Record<string, any>): QueryTool;
+    getToolType(): "query";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const queryToolFactory: QueryToolFactory;
+//# sourceMappingURL=query-tool.d.ts.map

package/dist/recipe-engine/tools/query-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/query-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEX,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAgG5D,qBAAa,SAAU,SAAQ,IAAI,CAAC,SAAS,CAAC;gBACjC,IAAI,SAAe,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAIlD,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;cAkDhF,SAAS,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;CA8FtB;AAED,qBAAa,gBAAgB;IAC5B,MAAM,CAAC,IAAI,SAAe,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,SAAS;IAIzE,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAQjE;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/recipe-engine/tools/query-tool.js

@@ -0,0 +1,249 @@
+/**
+ * Query Tool Implementation for Recipe Step System
+ *
+ * Reads structured data files (JSON, YAML, TOML, .env) and evaluates
+ * dot-path checks or expressions against them. Results can be exported
+ * to recipe variables for use in subsequent steps.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { Tool } from "./base.js";
+/**
+ * Auto-detect file format from extension
+ */
+function detectFormat(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    switch (ext) {
+        case ".json":
+            return "json";
+        case ".yml":
+        case ".yaml":
+            return "yaml";
+        case ".toml":
+            return "toml";
+        case ".env":
+            return "env";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Parse a .env file into a flat key-value record
+ */
+function parseEnvFile(content) {
+    const result = {};
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        // Strip surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Resolve a dot-path against an object.
+ * Supports keys with dots/special chars via bracket-like segments if needed,
+ * but the primary use case is simple dot-separated paths like "dependencies.drizzle-orm".
+ */
+function resolveDotPath(data, dotPath) {
+    const segments = dotPath.split(".");
+    let current = data;
+    for (const segment of segments) {
+        if (current === null || typeof current !== "object") {
+            return { exists: false, value: undefined };
+        }
+        if (!(segment in current)) {
+            return { exists: false, value: undefined };
+        }
+        current = current[segment];
+    }
+    return { exists: true, value: current };
+}
+/**
+ * Parse file content based on format
+ */
+async function parseFile(content, format) {
+    switch (format) {
+        case "json":
+            return JSON.parse(content);
+        case "yaml": {
+            const { parse } = await import("yaml");
+            return parse(content);
+        }
+        case "toml": {
+            // Use a dynamic import; TOML parsing is optional
+            try {
+                // @ts-ignore -- optional dependency, only needed for TOML files
+                const { parse } = await import("smol-toml");
+                return parse(content);
+            }
+            catch {
+                throw new Error('TOML parsing requires the "smol-toml" package. Install it with: bun add smol-toml');
+            }
+        }
+        case "env":
+            return parseEnvFile(content);
+        default:
+            throw new Error(`Unsupported format: ${format}`);
+    }
+}
+export class QueryTool extends Tool {
+    constructor(name = "query-tool", options = {}) {
+        super("query", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        const warnings = [];
+        const suggestions = [];
+        if (!step.file) {
+            errors.push("File path is required");
+        }
+        if (!step.checks && !step.expression) {
+            errors.push('Either "checks" or "expression" must be specified');
+        }
+        if (step.checks && step.expression) {
+            warnings.push('Both "checks" and "expression" are specified; both will be evaluated');
+        }
+        if (step.checks) {
+            for (let i = 0; i < step.checks.length; i++) {
+                const check = step.checks[i];
+                if (!check.path) {
+                    errors.push(`Check at index ${i} must have a "path"`);
+                }
+                if (!check.export && !check.exportExists) {
+                    warnings.push(`Check at index ${i} has no "export" or "exportExists" — result will be discarded`);
+                }
+            }
+        }
+        if (step.format && !["json", "yaml", "toml", "env"].includes(step.format)) {
+            errors.push(`Unsupported format: ${step.format}. Must be one of: json, yaml, toml, env`);
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+            suggestions,
+            estimatedExecutionTime: 100,
+            resourceRequirements: {
+                memory: 5 * 1024 * 1024,
+                disk: 0,
+                network: false,
+                processes: 0,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Querying file: %s", step.file);
+        try {
+            const filePath = path.resolve(context.projectRoot, step.file);
+            const format = step.format || detectFormat(step.file);
+            if (!format) {
+                throw new Error(`Cannot detect format for "${step.file}". Specify "format" explicitly.`);
+            }
+            if (!fs.existsSync(filePath)) {
+                throw new Error(`File not found: ${step.file}`);
+            }
+            const content = fs.readFileSync(filePath, "utf-8");
+            const data = await parseFile(content, format);
+            const queryResult = {
+                file: step.file,
+                format,
+            };
+            const outputVars = {};
+            // Evaluate checks
+            if (step.checks) {
+                queryResult.checks = [];
+                for (const check of step.checks) {
+                    const resolved = resolveDotPath(data, check.path);
+                    queryResult.checks.push({
+                        path: check.path,
+                        exists: resolved.exists,
+                        value: resolved.value,
+                    });
+                    if (check.export) {
+                        outputVars[check.export] = resolved.value;
+                    }
+                    if (check.exportExists) {
+                        outputVars[check.exportExists] =
+                            resolved.exists && resolved.value !== null && resolved.value !== false;
+                    }
+                }
+            }
+            // Evaluate expression
+            if (step.expression) {
+                try {
+                    const func = new Function("data", `return ${step.expression}`);
+                    queryResult.value = func(data);
+                    queryResult.expression = step.expression;
+                }
+                catch (err) {
+                    throw new Error(`Expression evaluation failed: ${err.message}`);
+                }
+            }
+            const endTime = new Date();
+            return {
+                status: "completed",
+                stepName: step.name,
+                toolType: "query",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                toolResult: queryResult,
+                output: Object.keys(outputVars).length > 0
+                    ? outputVars
+                    : queryResult.value !== undefined
+                        ? { value: queryResult.value }
+                        : undefined,
+            };
+        }
+        catch (error) {
+            const endTime = new Date();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "query",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: "QUERY_FAILED",
+                    cause: error,
+                },
+            };
+        }
+    }
+}
+export class QueryToolFactory {
+    create(name = "query-tool", options = {}) {
+        return new QueryTool(name, options);
+    }
+    getToolType() {
+        return "query";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const queryToolFactory = new QueryToolFactory();
+//# sourceMappingURL=query-tool.js.map

package/dist/recipe-engine/tools/query-tool.js.map

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

package/dist/recipe-engine/tools/recipe-tool.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Recipe Tool Implementation for Recipe Step System
+ *
+ * This tool handles recipe composition by loading and executing sub-recipes as
+ * orchestrated components. It replaces complex inheritance systems with simple
+ * execution-based composition, making recipe systems intuitive and powerful.
+ *
+ * Key Features:
+ * - Recipe discovery from multiple sources (local, npm, GitHub, URLs)
+ * - Variable inheritance and override patterns
+ * - Sub-recipe execution with proper context isolation
+ * - Result aggregation and error handling
+ * - Circular dependency detection
+ * - Recipe caching for performance
+ * - Variable mapping and transformation
+ */
+import { type RecipeStep, type StepContext, type StepExecutionOptions, type StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+/**
+ * Recipe Tool for processing recipe composition in the Recipe Step System
+ *
+ * This tool implements the core insight that composition is simpler than inheritance.
+ * Instead of complex configuration merging and template inheritance, recipes are
+ * executed as orchestrated steps that can call other recipes with clear variable
+ * passing patterns.
+ *
+ * Features:
+ * - Recipe source discovery (local files, npm packages)
+ * - Variable inheritance with clear override patterns
+ * - Sub-recipe execution with proper context management
+ * - Result aggregation from child recipes
+ * - Error handling and rollback for failed sub-recipes
+ * - Circular dependency detection with clear error messages
+ * - Recipe caching for performance optimization
+ * - Variable mapping and transformation support
+ */
+export declare class RecipeTool extends Tool<RecipeStep> {
+    private recipeCache;
+    private executionStack;
+    constructor(name?: string, options?: Record<string, any>);
+    /**
+     * Initialize the recipe tool
+     */
+    protected onInitialize(): Promise<void>;
+    /**
+     * Validate recipe step configuration
+     */
+    protected onValidate(step: RecipeStep, context: StepContext): Promise<ToolValidationResult>;
+    /**
+     * Execute the recipe tool
+     */
+    protected onExecute(step: RecipeStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    /**
+     * Tool-specific cleanup logic
+     */
+    protected onCleanup(): Promise<void>;
+    /**
+     * Resolve recipe identifier to configuration
+     */
+    private resolveRecipe;
+    /**
+     * Resolve local recipe file
+     */
+    private resolveLocalRecipe;
+    /**
+     * Resolve recipe from npm package
+     */
+    private resolveNpmRecipe;
+    /**
+     * Build sub-recipe context with variable inheritance
+     */
+    private buildSubRecipeContext;
+    /**
+     * Detect circular dependencies in recipe chain
+     */
+    private detectCircularDependencies;
+    /**
+     * Normalize steps to infer tool types from shorthands
+     */
+    private normalizeSteps;
+    /**
+     * Tool-specific cleanup logicipe configuration
+     */
+    private validateRecipeConfig;
+    /**
+     * Check if recipe identifier is a local path
+     */
+    private isLocalPath;
+    /**
+     * Check if recipe identifier is an npm package
+     */
+    private isNpmPackage;
+}
+/**
+ * Recipe Tool Factory
+ */
+export declare class RecipeToolFactory {
+    create(name?: string, options?: Record<string, any>): RecipeTool;
+    getToolType(): "recipe";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const recipeToolFactory: RecipeToolFactory;
+//# sourceMappingURL=recipe-tool.d.ts.map

package/dist/recipe-engine/tools/recipe-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/recipe-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAIN,KAAK,UAAU,EAEf,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAuD5D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,IAAI,CAAC,UAAU,CAAC;IAC/C,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,cAAc,CAAgB;gBAE1B,IAAI,SAAgB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;IAInE;;OAEG;cACsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtD;;OAEG;cACa,UAAU,CACzB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;IAkHhC;;OAEG;cACa,SAAS,CACxB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAiJtB;;OAEG;cACsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnD;;OAEG;YACW,aAAa;IA2D3B;;OAEG;YACW,kBAAkB;IA8ChC;;OAEG;YACW,gBAAgB;IA8B9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsD7B;;OAEG;YACW,0BAA0B;IAsBxC;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,YAAY;CAMpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC7B,MAAM,CAAC,IAAI,SAAgB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,UAAU;IAI3E,WAAW,IAAI,QAAQ;IAIvB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CA6BjE;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}