@hypercli/gen 0.1.1

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

@@ -0,0 +1,151 @@
+/**
+ * Tool Registry System
+ *
+ * Centralized registry for managing tool factories and creating tool instances.
+ * Tools are created fresh for each use — no instance caching, since this is a
+ * short-lived CLI process where cache overhead exceeds any reuse benefit.
+ */
+import type { ToolType } from "#recipe-engine/types";
+import type { Tool } from "./base.js";
+import type { ToolFactory } from "./base.js";
+/**
+ * Tool registration metadata
+ */
+export interface ToolRegistration {
+    /** Tool type */
+    toolType: ToolType;
+    /** Tool name/identifier */
+    name: string;
+    /** Tool factory for creating instances */
+    factory: ToolFactory;
+    /** Tool version */
+    version?: string;
+    /** Tool description */
+    description?: string;
+    /** Tool category for organization */
+    category?: string;
+    /** Tool tags for searchability */
+    tags?: string[];
+    /** Whether this tool is enabled */
+    enabled: boolean;
+    /** Registration timestamp */
+    registeredAt: Date;
+    /** Tool metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Tool registry statistics
+ */
+export interface ToolRegistryStats {
+    /** Total number of registered tool types */
+    totalRegistrations: number;
+    /** Registry statistics by tool type */
+    byType: Record<ToolType, {
+        registrations: number;
+    }>;
+}
+/**
+ * Tool search criteria
+ */
+export interface ToolSearchCriteria {
+    /** Tool type filter */
+    type?: ToolType;
+    /** Name pattern (regex support) */
+    namePattern?: string;
+    /** Category filter */
+    category?: string;
+    /** Tag filters (all must match) */
+    tags?: string[];
+    /** Whether to include only enabled tools */
+    enabledOnly?: boolean;
+    /** Text search in description */
+    description?: string;
+}
+/**
+ * Tool resolution options
+ */
+export interface ToolResolutionOptions {
+    /** Tool instance options */
+    instanceOptions?: Record<string, any>;
+    /** Whether to validate the tool after creation */
+    validate?: boolean;
+}
+/**
+ * Centralized registry for managing tool factories
+ *
+ * The ToolRegistry provides a singleton pattern for tool registration,
+ * discovery, and instance creation.
+ */
+export declare class ToolRegistry {
+    private static instance;
+    private readonly registrations;
+    private readonly debug;
+    private constructor();
+    /**
+     * Get the singleton registry instance
+     */
+    static getInstance(): ToolRegistry;
+    /**
+     * Reset the singleton instance (primarily for testing)
+     */
+    static reset(): void;
+    /**
+     * Register a tool factory
+     */
+    register(toolType: ToolType, name: string, factory: ToolFactory, metadata?: Partial<ToolRegistration>): void;
+    /**
+     * Unregister a tool
+     */
+    unregister(toolType: ToolType, name: string): boolean;
+    /**
+     * Check if a tool is registered
+     */
+    isRegistered(toolType: ToolType, name: string): boolean;
+    /**
+     * Get tool registration information
+     */
+    getRegistration(toolType: ToolType, name: string): ToolRegistration | null;
+    /**
+     * Create a tool instance by type and name
+     */
+    resolve(toolType: ToolType, name: string, options?: ToolResolutionOptions): Promise<Tool>;
+    /**
+     * Release a tool instance (no-op — instances are not cached)
+     */
+    release(_toolType: ToolType, _name: string, _instance: Tool): void;
+    /**
+     * Search for tools based on criteria
+     */
+    search(criteria?: ToolSearchCriteria): ToolRegistration[];
+    /**
+     * Get all registered tools of a specific type
+     */
+    getByType(toolType: ToolType): ToolRegistration[];
+    /**
+     * Get all tool types with registrations
+     */
+    getRegisteredTypes(): ToolType[];
+    /**
+     * Get all categories
+     */
+    getCategories(): string[];
+    /**
+     * Get registry statistics
+     */
+    getStats(): ToolRegistryStats;
+    private getRegistrationKey;
+    private matchesCriteria;
+}
+/**
+ * Get the global tool registry instance
+ */
+export declare function getToolRegistry(): ToolRegistry;
+/**
+ * Register a tool factory with the global registry
+ */
+export declare function registerTool(toolType: ToolType, name: string, factory: ToolFactory, metadata?: Partial<ToolRegistration>): void;
+/**
+ * Resolve a tool instance from the global registry
+ */
+export declare function resolveTool(toolType: ToolType, name: string, options?: ToolResolutionOptions): Promise<Tool>;
+//# sourceMappingURL=registry.d.ts.map

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

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

package/dist/recipe-engine/tools/registry.js

@@ -0,0 +1,244 @@
+/**
+ * Tool Registry System
+ *
+ * Centralized registry for managing tool factories and creating tool instances.
+ * Tools are created fresh for each use — no instance caching, since this is a
+ * short-lived CLI process where cache overhead exceeds any reuse benefit.
+ */
+import { ErrorCode, ErrorHandler, HypergenError } from "@hypercli/core";
+import createDebug from "debug";
+/**
+ * Centralized registry for managing tool factories
+ *
+ * The ToolRegistry provides a singleton pattern for tool registration,
+ * discovery, and instance creation.
+ */
+export class ToolRegistry {
+    static instance = null;
+    registrations = new Map();
+    debug;
+    constructor() {
+        this.debug = createDebug("hyper:recipe:registry");
+        this.debug("Tool registry initialized");
+    }
+    /**
+     * Get the singleton registry instance
+     */
+    static getInstance() {
+        if (!ToolRegistry.instance) {
+            ToolRegistry.instance = new ToolRegistry();
+        }
+        return ToolRegistry.instance;
+    }
+    /**
+     * Reset the singleton instance (primarily for testing)
+     */
+    static reset() {
+        ToolRegistry.instance = null;
+    }
+    /**
+     * Register a tool factory
+     */
+    register(toolType, name, factory, metadata) {
+        const registrationKey = this.getRegistrationKey(toolType, name);
+        if (this.registrations.has(registrationKey)) {
+            this.debug("Overwriting existing tool registration: %s", registrationKey);
+        }
+        const registration = {
+            toolType,
+            name,
+            factory,
+            version: metadata?.version,
+            description: metadata?.description,
+            category: metadata?.category || "general",
+            tags: metadata?.tags || [],
+            enabled: metadata?.enabled ?? true,
+            registeredAt: new Date(),
+            metadata: metadata?.metadata,
+        };
+        // Validate factory configuration
+        try {
+            const validation = factory.validateConfig(metadata?.metadata || {});
+            if (!validation.isValid) {
+                throw ErrorHandler.createError(ErrorCode.VALIDATION_ERROR, `Tool factory validation failed: ${validation.errors.join(", ")}`, { toolType, toolName: name, errors: validation.errors });
+            }
+        }
+        catch (error) {
+            this.debug("Factory validation failed for %s: %s", registrationKey, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+        this.registrations.set(registrationKey, registration);
+        this.debug("Tool registered: %s (%s) - %s", name, toolType, registration.description || "no description");
+    }
+    /**
+     * Unregister a tool
+     */
+    unregister(toolType, name) {
+        const registrationKey = this.getRegistrationKey(toolType, name);
+        const removed = this.registrations.delete(registrationKey);
+        if (removed) {
+            this.debug("Tool unregistered: %s", registrationKey);
+        }
+        return removed;
+    }
+    /**
+     * Check if a tool is registered
+     */
+    isRegistered(toolType, name) {
+        const registrationKey = this.getRegistrationKey(toolType, name);
+        return this.registrations.has(registrationKey);
+    }
+    /**
+     * Get tool registration information
+     */
+    getRegistration(toolType, name) {
+        const registrationKey = this.getRegistrationKey(toolType, name);
+        return this.registrations.get(registrationKey) || null;
+    }
+    /**
+     * Create a tool instance by type and name
+     */
+    async resolve(toolType, name, options) {
+        const registrationKey = this.getRegistrationKey(toolType, name);
+        const registration = this.registrations.get(registrationKey);
+        if (!registration) {
+            throw ErrorHandler.createError(ErrorCode.ACTION_NOT_FOUND, `Tool not found: ${name} (${toolType})`, { toolType, toolName: name });
+        }
+        if (!registration.enabled) {
+            throw ErrorHandler.createError(ErrorCode.ACTION_EXECUTION_FAILED, `Tool is disabled: ${name} (${toolType})`, { toolType, toolName: name });
+        }
+        this.debug("Creating tool instance: %s", registrationKey);
+        try {
+            const instance = registration.factory.create(name, options?.instanceOptions);
+            this.debug("Tool instance created: %s", registrationKey);
+            return instance;
+        }
+        catch (error) {
+            this.debug("Failed to create tool instance: %s - %s", registrationKey, error instanceof Error ? error.message : String(error));
+            if (error instanceof HypergenError) {
+                throw error;
+            }
+            throw ErrorHandler.createError(ErrorCode.INTERNAL_ERROR, `Failed to create tool instance: ${error instanceof Error ? error.message : String(error)}`, { toolType, toolName: name });
+        }
+    }
+    /**
+     * Release a tool instance (no-op — instances are not cached)
+     */
+    release(_toolType, _name, _instance) {
+        // No-op: tools are created fresh each time, no cache to return to.
+    }
+    /**
+     * Search for tools based on criteria
+     */
+    search(criteria = {}) {
+        const results = [];
+        for (const registration of this.registrations.values()) {
+            if (this.matchesCriteria(registration, criteria)) {
+                results.push(registration);
+            }
+        }
+        results.sort((a, b) => a.name.localeCompare(b.name));
+        this.debug("Tool search returned %d results for criteria: %o", results.length, criteria);
+        return results;
+    }
+    /**
+     * Get all registered tools of a specific type
+     */
+    getByType(toolType) {
+        return this.search({ type: toolType, enabledOnly: false });
+    }
+    /**
+     * Get all tool types with registrations
+     */
+    getRegisteredTypes() {
+        const types = new Set();
+        for (const registration of this.registrations.values()) {
+            types.add(registration.toolType);
+        }
+        return Array.from(types).sort();
+    }
+    /**
+     * Get all categories
+     */
+    getCategories() {
+        const categories = new Set();
+        for (const registration of this.registrations.values()) {
+            if (registration.category) {
+                categories.add(registration.category);
+            }
+        }
+        return Array.from(categories).sort();
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const stats = {
+            totalRegistrations: this.registrations.size,
+            byType: {},
+        };
+        for (const registration of this.registrations.values()) {
+            const type = registration.toolType;
+            if (!stats.byType[type]) {
+                stats.byType[type] = { registrations: 0 };
+            }
+            stats.byType[type].registrations++;
+        }
+        return stats;
+    }
+    // Private helper methods
+    getRegistrationKey(toolType, name) {
+        return `${toolType}:${name}`;
+    }
+    matchesCriteria(registration, criteria) {
+        if (criteria.type && registration.toolType !== criteria.type) {
+            return false;
+        }
+        if (criteria.enabledOnly && !registration.enabled) {
+            return false;
+        }
+        if (criteria.namePattern) {
+            const regex = new RegExp(criteria.namePattern, "i");
+            if (!regex.test(registration.name)) {
+                return false;
+            }
+        }
+        if (criteria.category && registration.category !== criteria.category) {
+            return false;
+        }
+        if (criteria.tags && criteria.tags.length > 0) {
+            const registrationTags = registration.tags || [];
+            if (!criteria.tags.every((tag) => registrationTags.includes(tag))) {
+                return false;
+            }
+        }
+        if (criteria.description && registration.description) {
+            const regex = new RegExp(criteria.description, "i");
+            if (!regex.test(registration.description)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+/**
+ * Get the global tool registry instance
+ */
+export function getToolRegistry() {
+    return ToolRegistry.getInstance();
+}
+/**
+ * Register a tool factory with the global registry
+ */
+export function registerTool(toolType, name, factory, metadata) {
+    const registry = getToolRegistry();
+    registry.register(toolType, name, factory, metadata);
+}
+/**
+ * Resolve a tool instance from the global registry
+ */
+export async function resolveTool(toolType, name, options) {
+    const registry = getToolRegistry();
+    return await registry.resolve(toolType, name, options);
+}
+//# sourceMappingURL=registry.js.map

package/dist/recipe-engine/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/recipe-engine/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,WAAW,MAAM,OAAO,CAAC;AA0FhC;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,QAAQ,GAAwB,IAAI,CAAC;IAEnC,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpD,KAAK,CAAiC;IAEvD;QACC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC5B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACX,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ,CACP,QAAkB,EAClB,IAAY,EACZ,OAAoB,EACpB,QAAoC;QAEpC,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEhE,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,4CAA4C,EAAE,eAAe,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,YAAY,GAAqB;YACtC,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,OAAO,EAAE,QAAQ,EAAE,OAAO;YAC1B,WAAW,EAAE,QAAQ,EAAE,WAAW;YAClC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,SAAS;YACzC,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE;YAC1B,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI;YAClC,YAAY,EAAE,IAAI,IAAI,EAAE;YACxB,QAAQ,EAAE,QAAQ,EAAE,QAAQ;SAC5B,CAAC;QAEF,iCAAiC;QACjC,IAAI,CAAC;YACJ,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,mCAAmC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACjE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CACvD,CAAC;YACH,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CACT,sCAAsC,EACtC,eAAe,EACf,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD,CAAC;YACF,MAAM,KAAK,CAAC;QACb,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CACT,+BAA+B,EAC/B,IAAI,EACJ,QAAQ,EACR,YAAY,CAAC,WAAW,IAAI,gBAAgB,CAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAkB,EAAE,IAAY;QAC1C,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAE3D,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAAkB,EAAE,IAAY;QAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAkB,EAAE,IAAY;QAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,QAAkB,EAAE,IAAY,EAAE,OAA+B;QAC9E,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAE7D,IAAI,CAAC,YAAY,EAAE,CAAC;YACnB,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,gBAAgB,EAC1B,mBAAmB,IAAI,KAAK,QAAQ,GAAG,EACvC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC5B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,uBAAuB,EACjC,qBAAqB,IAAI,KAAK,QAAQ,GAAG,EACzC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC5B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,4BAA4B,EAAE,eAAe,CAAC,CAAC;QAE1D,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;YAE7E,IAAI,CAAC,KAAK,CAAC,2BAA2B,EAAE,eAAe,CAAC,CAAC;YACzD,OAAO,QAAQ,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,CACT,yCAAyC,EACzC,eAAe,EACf,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD,CAAC;YAEF,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACpC,MAAM,KAAK,CAAC;YACb,CAAC;YAED,MAAM,YAAY,CAAC,WAAW,CAC7B,SAAS,CAAC,cAAc,EACxB,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC3F,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAC5B,CAAC;QACH,CAAC;IACF,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAAmB,EAAE,KAAa,EAAE,SAAe;QAC1D,mEAAmE;IACpE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAA+B,EAAE;QACvC,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACF,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAErD,IAAI,CAAC,KAAK,CAAC,kDAAkD,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACzF,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAkB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,kBAAkB;QACjB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAY,CAAC;QAElC,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YACxD,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,aAAa;QACZ,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QAErC,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YACxD,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,MAAM,KAAK,GAAsB;YAChC,kBAAkB,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;YAC3C,MAAM,EAAE,EAAS;SACjB,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;YAC3C,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;IAED,yBAAyB;IAEjB,kBAAkB,CAAC,QAAkB,EAAE,IAAY;QAC1D,OAAO,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC9B,CAAC;IAEO,eAAe,CAAC,YAA8B,EAAE,QAA4B;QACnF,IAAI,QAAQ,CAAC,IAAI,IAAI,YAAY,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,CAAC,WAAW,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACnE,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,IAAI,QAAQ,CAAC,WAAW,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;;AAGF;;GAEG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC3B,QAAkB,EAClB,IAAY,EACZ,OAAoB,EACpB,QAAoC;IAEpC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,QAAkB,EAClB,IAAY,EACZ,OAA+B;IAE/B,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Sequence Tool Implementation for Recipe Step System
+ *
+ * This tool executes a list of recipe steps sequentially.
+ * It is a direct replacement for the generic GroupTool, offering
+ * clearer semantics for sequential execution.
+ */
+import type { SequenceStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class SequenceTool extends Tool<SequenceStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: SequenceStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: SequenceStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    private createResult;
+}
+export declare class SequenceToolFactory {
+    create(name?: string, options?: Record<string, any>): SequenceTool;
+    getToolType(): "sequence";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const sequenceToolFactory: SequenceToolFactory;
+//# sourceMappingURL=sequence-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/sequence-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAEX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5D,qBAAa,YAAa,SAAQ,IAAI,CAAC,YAAY,CAAC;gBACvC,IAAI,SAAkB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;cAIrD,UAAU,CACzB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC;cAsBhB,SAAS,CACxB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IA6CtB,OAAO,CAAC,YAAY;CAwCpB;AAED,qBAAa,mBAAmB;IAC/B,MAAM,CAAC,IAAI,SAAkB,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,YAAY;IAI/E,WAAW,IAAI,UAAU;IAIzB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB;CAQjE;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

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

@@ -0,0 +1,122 @@
+/**
+ * Sequence Tool Implementation for Recipe Step System
+ *
+ * This tool executes a list of recipe steps sequentially.
+ * It is a direct replacement for the generic GroupTool, offering
+ * clearer semantics for sequential execution.
+ */
+import { ErrorCode, ErrorHandler } from "@hypercli/core";
+import { StepExecutor } from "#recipe-engine/step-executor";
+import { Tool } from "./base.js";
+export class SequenceTool extends Tool {
+    constructor(name = "sequence-tool", options = {}) {
+        super("sequence", name, options);
+    }
+    async onValidate(step, context) {
+        const errors = [];
+        if (!step.steps || !Array.isArray(step.steps) || step.steps.length === 0) {
+            errors.push("Sequence steps must be a non-empty array");
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings: [],
+            suggestions: [],
+            estimatedExecutionTime: (step.steps?.length || 0) * 1000,
+            resourceRequirements: {
+                memory: 0,
+                disk: 0,
+                network: false,
+                processes: 0,
+            },
+        };
+    }
+    async onExecute(step, context, options) {
+        const startTime = new Date();
+        this.debug("Executing sequence step: %s with %d steps", step.name, step.steps.length);
+        try {
+            const executor = new StepExecutor(undefined, {
+                collectMetrics: false,
+                enableProgressTracking: false,
+            });
+            const results = await executor.executeSteps(step.steps, context, options);
+            const failed = results.filter((r) => r.status === "failed");
+            if (failed.length > 0 && !step.continueOnError && !options?.continueOnError) {
+                throw ErrorHandler.createError(ErrorCode.TEMPLATE_EXECUTION_ERROR, `Sequence execution failed: ${failed.map((f) => f.stepName).join(", ")}`, { template: step.name, cause: failed[0].error });
+            }
+            this.debug("Sequence execution completed");
+            return this.createResult(step, results, startTime, "completed");
+        }
+        catch (error) {
+            const endTime = new Date();
+            return {
+                status: "failed",
+                stepName: step.name,
+                toolType: "sequence",
+                startTime,
+                endTime,
+                duration: endTime.getTime() - startTime.getTime(),
+                retryCount: 0,
+                dependenciesSatisfied: true,
+                error: {
+                    message: error.message,
+                    code: error.code || "SEQUENCE_EXECUTION_ERROR",
+                    cause: error,
+                },
+            };
+        }
+    }
+    createResult(step, results, startTime, status) {
+        const endTime = new Date();
+        const filesCreated = [];
+        const filesModified = [];
+        const filesDeleted = [];
+        results.forEach((r) => {
+            if (r.filesCreated)
+                filesCreated.push(...r.filesCreated);
+            if (r.filesModified)
+                filesModified.push(...r.filesModified);
+            if (r.filesDeleted)
+                filesDeleted.push(...r.filesDeleted);
+        });
+        return {
+            status,
+            stepName: step.name,
+            toolType: "sequence",
+            startTime,
+            endTime,
+            duration: endTime.getTime() - startTime.getTime(),
+            retryCount: 0,
+            dependenciesSatisfied: true,
+            filesCreated,
+            filesModified,
+            filesDeleted,
+            toolResult: {
+                steps: results,
+            },
+            output: {
+                totalSteps: results.length,
+                completed: results.filter((r) => r.status === "completed").length,
+                failed: results.filter((r) => r.status === "failed").length,
+            },
+        };
+    }
+}
+export class SequenceToolFactory {
+    create(name = "sequence-tool", options = {}) {
+        return new SequenceTool(name, options);
+    }
+    getToolType() {
+        return "sequence";
+    }
+    validateConfig(config) {
+        return {
+            isValid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+    }
+}
+export const sequenceToolFactory = new SequenceToolFactory();
+//# sourceMappingURL=sequence-tool.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Shell Tool Implementation for Recipe Step System
+ *
+ * This tool executes shell commands as part of the recipe execution pipeline.
+ * It integrates with the existing shell operations in src/ops/shell.ts.
+ */
+import type { ShellStep, StepContext, StepExecutionOptions, StepResult } from "#recipe-engine/types";
+import { Tool, type ToolValidationResult } from "./base.js";
+export declare class ShellTool extends Tool<ShellStep> {
+    constructor(name?: string, options?: Record<string, any>);
+    protected onValidate(step: ShellStep, context: StepContext): Promise<ToolValidationResult>;
+    protected onExecute(step: ShellStep, context: StepContext, options?: StepExecutionOptions): Promise<StepResult>;
+    /**
+     * Build render context by merging step and recipe variables.
+     * This matches the pattern used in template-tool.ts for consistency.
+     */
+    private buildRenderContext;
+}
+export declare class ShellToolFactory {
+    create(name?: string, options?: Record<string, any>): ShellTool;
+    getToolType(): "shell";
+    validateConfig(config: Record<string, any>): ToolValidationResult;
+}
+export declare const shellToolFactory: ShellToolFactory;
+//# sourceMappingURL=shell-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell-tool.d.ts","sourceRoot":"","sources":["../../../src/recipe-engine/tools/shell-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5D,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;cA4BhF,SAAS,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC;IAiFtB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAmB1B;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;CASjE;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}