@orbytautomation/engine 0.1.0

package/dist/adapters/AdapterRegistry.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Adapter Registry
+ *
+ * Central registry for managing and resolving adapters.
+ * Follows the registry pattern for pluggable execution.
+ *
+ * @module adapters
+ */
+import type { Adapter } from '@dev-ecosystem/core';
+import { OrbytError } from '../errors/OrbytError.js';
+/**
+ * Adapter not found error
+ */
+export declare class AdapterNotFoundError extends OrbytError {
+    constructor(action: string, availableAdapters: string[]);
+}
+/**
+ * Duplicate adapter error
+ */
+export declare class DuplicateAdapterError extends OrbytError {
+    constructor(adapterName: string);
+}
+/**
+ * Adapter Registry
+ *
+ * Manages the lifecycle and resolution of adapters.
+ * Engine uses this to find the right adapter for each workflow step.
+ */
+export declare class AdapterRegistry {
+    private adapters;
+    private initialized;
+    /**
+     * Register an adapter
+     *
+     * @param adapter - Adapter to register
+     * @throws {DuplicateAdapterError} If adapter name already registered
+     */
+    register(adapter: Adapter): void;
+    /**
+     * Register multiple adapters
+     *
+     * @param adapters - Array of adapters to register
+     */
+    registerAll(adapters: Adapter[]): void;
+    /**
+     * Unregister an adapter
+     *
+     * @param adapterName - Name of adapter to unregister
+     * @returns True if adapter was unregistered
+     */
+    unregister(adapterName: string): boolean;
+    /**
+     * Find adapter that supports an action
+     *
+     * @param action - Action name (e.g., 'http.request.get', 'cli.run')
+     * @returns Adapter instance
+     * @throws {AdapterNotFoundError} If no adapter supports the action
+     */
+    resolve(action: string): Adapter;
+    /**
+     * Check if an action is supported
+     *
+     * @param action - Action name to check
+     * @returns True if any adapter supports the action
+     */
+    supports(action: string): boolean;
+    /**
+     * Get adapter by name
+     *
+     * @param name - Adapter name
+     * @returns Adapter instance or undefined
+     */
+    get(name: string): Adapter | undefined;
+    /**
+     * Get all registered adapters
+     *
+     * @returns Array of all adapters
+     */
+    getAll(): Adapter[];
+    /**
+     * Get all adapter names
+     *
+     * @returns Array of adapter names
+     */
+    getNames(): string[];
+    /**
+     * Initialize an adapter (call its initialize() method if present)
+     *
+     * @param adapterName - Name of adapter to initialize
+     */
+    initialize(adapterName: string): Promise<void>;
+    /**
+     * Initialize all registered adapters
+     */
+    initializeAll(): Promise<void>;
+    /**
+     * Cleanup specific adapter
+     *
+     * @param adapterName - Name of adapter to cleanup
+     */
+    cleanup(adapterName: string): Promise<void>;
+    /**
+     * Cleanup all adapters
+     */
+    cleanupAll(): Promise<void>;
+    /**
+     * Clear all registered adapters
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        total: number;
+        initialized: number;
+        adapters: Array<{
+            name: string;
+            version: string;
+            supportedActions: string[];
+            isInitialized: boolean;
+        }>;
+    };
+}
+/**
+ * Global adapter registry instance (singleton pattern)
+ * Use this for convenience, or create your own instance for isolation
+ */
+export declare const globalAdapterRegistry: AdapterRegistry;
+//# sourceMappingURL=AdapterRegistry.d.ts.map

package/dist/adapters/AdapterRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.d.ts","sourceRoot":"","sources":["../../src/adapters/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE;CAYxD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,WAAW,EAAE,MAAM;CAWhC;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAA0B;IAE7C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQhC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtC;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAexC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAqBhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASjC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC;;;;OAIG;IACH,MAAM,IAAI,OAAO,EAAE;IAInB;;;;OAIG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;OAIG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;;;OAIG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;YAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;YAC3B,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC,CAAC;KACJ;CAYF;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iBAAwB,CAAC"}

package/dist/adapters/AdapterRegistry.js

@@ -0,0 +1,236 @@
+/**
+ * Adapter Registry
+ *
+ * Central registry for managing and resolving adapters.
+ * Follows the registry pattern for pluggable execution.
+ *
+ * @module adapters
+ */
+import { OrbytError } from '../errors/OrbytError.js';
+import { OrbytErrorCode, ErrorSeverity } from '../errors/ErrorCodes.js';
+/**
+ * Adapter not found error
+ */
+export class AdapterNotFoundError extends OrbytError {
+    constructor(action, availableAdapters) {
+        super({
+            code: OrbytErrorCode.VALIDATION_UNKNOWN_ADAPTER,
+            message: `No adapter found for action '${action}'`,
+            severity: ErrorSeverity.ERROR,
+            hint: `Available adapters: ${availableAdapters.join(', ')}. Check your workflow uses field or register the required adapter.`,
+            context: {
+                action,
+                availableAdapters,
+            },
+        });
+    }
+}
+/**
+ * Duplicate adapter error
+ */
+export class DuplicateAdapterError extends OrbytError {
+    constructor(adapterName) {
+        super({
+            code: OrbytErrorCode.VALIDATION_DUPLICATE_ID,
+            message: `Adapter '${adapterName}' is already registered`,
+            severity: ErrorSeverity.ERROR,
+            hint: 'Use a different adapter name or unregister the existing one first',
+            context: {
+                adapterName,
+            },
+        });
+    }
+}
+/**
+ * Adapter Registry
+ *
+ * Manages the lifecycle and resolution of adapters.
+ * Engine uses this to find the right adapter for each workflow step.
+ */
+export class AdapterRegistry {
+    adapters = new Map();
+    initialized = new Set();
+    /**
+     * Register an adapter
+     *
+     * @param adapter - Adapter to register
+     * @throws {DuplicateAdapterError} If adapter name already registered
+     */
+    register(adapter) {
+        if (this.adapters.has(adapter.name)) {
+            throw new DuplicateAdapterError(adapter.name);
+        }
+        this.adapters.set(adapter.name, adapter);
+    }
+    /**
+     * Register multiple adapters
+     *
+     * @param adapters - Array of adapters to register
+     */
+    registerAll(adapters) {
+        for (const adapter of adapters) {
+            this.register(adapter);
+        }
+    }
+    /**
+     * Unregister an adapter
+     *
+     * @param adapterName - Name of adapter to unregister
+     * @returns True if adapter was unregistered
+     */
+    unregister(adapterName) {
+        const adapter = this.adapters.get(adapterName);
+        if (adapter) {
+            // Cleanup if initialized
+            if (this.initialized.has(adapterName) && adapter.cleanup) {
+                adapter.cleanup().catch(err => {
+                    console.error(`Error cleaning up adapter ${adapterName}:`, err);
+                });
+            }
+            this.initialized.delete(adapterName);
+            return this.adapters.delete(adapterName);
+        }
+        return false;
+    }
+    /**
+     * Find adapter that supports an action
+     *
+     * @param action - Action name (e.g., 'http.request.get', 'cli.run')
+     * @returns Adapter instance
+     * @throws {AdapterNotFoundError} If no adapter supports the action
+     */
+    resolve(action) {
+        // Try to find adapter by exact name match first
+        const [namespace] = action.split('.');
+        const adapter = this.adapters.get(namespace);
+        if (adapter && adapter.supports(action)) {
+            return adapter;
+        }
+        // Search all adapters for support
+        for (const adapter of this.adapters.values()) {
+            if (adapter.supports(action)) {
+                return adapter;
+            }
+        }
+        // No adapter found - build helpful error
+        const availableAdapters = Array.from(this.adapters.keys());
+        throw new AdapterNotFoundError(action, availableAdapters);
+    }
+    /**
+     * Check if an action is supported
+     *
+     * @param action - Action name to check
+     * @returns True if any adapter supports the action
+     */
+    supports(action) {
+        try {
+            this.resolve(action);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get adapter by name
+     *
+     * @param name - Adapter name
+     * @returns Adapter instance or undefined
+     */
+    get(name) {
+        return this.adapters.get(name);
+    }
+    /**
+     * Get all registered adapters
+     *
+     * @returns Array of all adapters
+     */
+    getAll() {
+        return Array.from(this.adapters.values());
+    }
+    /**
+     * Get all adapter names
+     *
+     * @returns Array of adapter names
+     */
+    getNames() {
+        return Array.from(this.adapters.keys());
+    }
+    /**
+     * Initialize an adapter (call its initialize() method if present)
+     *
+     * @param adapterName - Name of adapter to initialize
+     */
+    async initialize(adapterName) {
+        const adapter = this.adapters.get(adapterName);
+        if (!adapter) {
+            throw new AdapterNotFoundError(adapterName, Array.from(this.adapters.keys()));
+        }
+        // Skip if already initialized
+        if (this.initialized.has(adapterName)) {
+            return;
+        }
+        // Call initialize if present
+        if (adapter.initialize) {
+            await adapter.initialize();
+        }
+        this.initialized.add(adapterName);
+    }
+    /**
+     * Initialize all registered adapters
+     */
+    async initializeAll() {
+        const initPromises = Array.from(this.adapters.keys()).map(name => this.initialize(name));
+        await Promise.all(initPromises);
+    }
+    /**
+     * Cleanup specific adapter
+     *
+     * @param adapterName - Name of adapter to cleanup
+     */
+    async cleanup(adapterName) {
+        const adapter = this.adapters.get(adapterName);
+        if (adapter && adapter.cleanup) {
+            await adapter.cleanup();
+        }
+        this.initialized.delete(adapterName);
+    }
+    /**
+     * Cleanup all adapters
+     */
+    async cleanupAll() {
+        const cleanupPromises = Array.from(this.adapters.values())
+            .filter(adapter => adapter.cleanup)
+            .map(adapter => adapter.cleanup());
+        await Promise.allSettled(cleanupPromises);
+        this.initialized.clear();
+    }
+    /**
+     * Clear all registered adapters
+     */
+    clear() {
+        this.adapters.clear();
+        this.initialized.clear();
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        return {
+            total: this.adapters.size,
+            initialized: this.initialized.size,
+            adapters: Array.from(this.adapters.values()).map(adapter => ({
+                name: adapter.name,
+                version: adapter.version,
+                supportedActions: adapter.supportedActions,
+                isInitialized: this.initialized.has(adapter.name),
+            })),
+        };
+    }
+}
+/**
+ * Global adapter registry instance (singleton pattern)
+ * Use this for convenience, or create your own instance for isolation
+ */
+export const globalAdapterRegistry = new AdapterRegistry();
+//# sourceMappingURL=AdapterRegistry.js.map

package/dist/adapters/AdapterRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterRegistry.js","sourceRoot":"","sources":["../../src/adapters/AdapterRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExE;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,MAAc,EAAE,iBAA2B;QACrD,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc,CAAC,0BAA0B;YAC/C,OAAO,EAAE,gCAAgC,MAAM,GAAG;YAClD,QAAQ,EAAE,aAAa,CAAC,KAAK;YAC7B,IAAI,EAAE,uBAAuB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,oEAAoE;YAC7H,OAAO,EAAE;gBACP,MAAM;gBACN,iBAAiB;aAClB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,WAAmB;QAC7B,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc,CAAC,uBAAuB;YAC5C,OAAO,EAAE,YAAY,WAAW,yBAAyB;YACzD,QAAQ,EAAE,aAAa,CAAC,KAAK;YAC7B,IAAI,EAAE,mEAAmE;YACzE,OAAO,EAAE;gBACP,WAAW;aACZ;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAC3C,WAAW,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE7C;;;;;OAKG;IACH,QAAQ,CAAC,OAAgB;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAmB;QAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,WAAmB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,yBAAyB;YACzB,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACzD,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;oBAC5B,OAAO,CAAC,KAAK,CAAC,6BAA6B,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;gBAClE,CAAC,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,MAAc;QACpB,gDAAgD;QAChD,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAAc;QACrB,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,WAAmB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,oBAAoB,CAC5B,WAAW,EACX,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACjC,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAC/D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CACtB,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;aACvD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;aAClC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAQ,EAAE,CAAC,CAAC;QAEtC,MAAM,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ;QAUN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAClC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC3D,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;aAClD,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/adapters/StepAdapter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StepAdapter.d.ts.map

package/dist/adapters/StepAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/StepAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/StepAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StepAdapter.js.map

package/dist/adapters/StepAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepAdapter.js","sourceRoot":"","sources":["../../src/adapters/StepAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/WorkflowAdapter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkflowAdapter.d.ts.map

package/dist/adapters/WorkflowAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/WorkflowAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/WorkflowAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkflowAdapter.js.map

package/dist/adapters/WorkflowAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowAdapter.js","sourceRoot":"","sources":["../../src/adapters/WorkflowAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/builtins/CLIAdapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI Adapter
+ *
+ * Executes CLI commands with structured argument handling.
+ * More structured than ShellAdapter for invoking external tools.
+ *
+ * Supported actions:
+ *   - cli.run - Execute CLI command with args
+ *   - cli.exec - Execute CLI command (alias)
+ *
+ * @module adapters/builtins
+ */
+import { BaseAdapter, type AdapterContext, type AdapterResult } from '@dev-ecosystem/core';
+/**
+ * CLI adapter for executing commands
+ */
+export declare class CLIAdapter extends BaseAdapter {
+    readonly name = "cli";
+    readonly version = "1.0.0";
+    readonly description = "CLI command execution adapter";
+    readonly supportedActions: string[];
+    readonly capabilities: {
+        actions: string[];
+        concurrent: boolean;
+        cacheable: boolean;
+        idempotent: boolean;
+        resources: {
+            filesystem: boolean;
+        };
+        cost: "low";
+    };
+    execute(action: string, input: Record<string, any>, context: AdapterContext): Promise<AdapterResult>;
+    /**
+     * Execute CLI command
+     */
+    private executeCLI;
+}
+//# sourceMappingURL=CLIAdapter.d.ts.map

package/dist/adapters/builtins/CLIAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/CLIAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAwB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAejH;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,mCAAmC;IACvD,QAAQ,CAAC,gBAAgB,WAAa;IACtC,QAAQ,CAAC,YAAY;;;;;;;;;MASnB;IAEI,OAAO,CACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IA4EzB;;OAEG;IACH,OAAO,CAAC,UAAU;CAuGnB"}

package/dist/adapters/builtins/CLIAdapter.js

@@ -0,0 +1,173 @@
+/**
+ * CLI Adapter
+ *
+ * Executes CLI commands with structured argument handling.
+ * More structured than ShellAdapter for invoking external tools.
+ *
+ * Supported actions:
+ *   - cli.run - Execute CLI command with args
+ *   - cli.exec - Execute CLI command (alias)
+ *
+ * @module adapters/builtins
+ */
+import { spawn } from 'child_process';
+import { BaseAdapter, AdapterResultBuilder } from '@dev-ecosystem/core';
+/**
+ * CLI adapter for executing commands
+ */
+export class CLIAdapter extends BaseAdapter {
+    name = 'cli';
+    version = '1.0.0';
+    description = 'CLI command execution adapter';
+    supportedActions = ['cli.*'];
+    capabilities = {
+        actions: ['cli.run', 'cli.exec'],
+        concurrent: true,
+        cacheable: false,
+        idempotent: false,
+        resources: {
+            filesystem: true,
+        },
+        cost: 'low',
+    };
+    async execute(action, input, context) {
+        this.validateInput(input, ['command']);
+        const command = input.command;
+        const args = input.args || [];
+        const cwd = input.cwd;
+        const env = { ...process.env, ...(input.env || {}) };
+        const timeout = input.timeout;
+        const stdin = input.stdin;
+        const throwOnError = this.getInput(input, 'throwOnError', true);
+        context.log(`Executing ${action}: ${command} ${args.join(' ')}`);
+        const startTime = Date.now();
+        try {
+            const result = await this.executeCLI(command, args, { cwd, env, timeout, stdin }, context);
+            const duration = Date.now() - startTime;
+            // Build result using new format
+            const builder = new AdapterResultBuilder()
+                .duration(duration)
+                .log(`Executed: ${command} ${args.join(' ')}`);
+            if (result.success) {
+                builder
+                    .success({
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                    exitCode: result.exitCode,
+                    command: result.command,
+                    args: result.args,
+                })
+                    .effect('process:executed');
+            }
+            else {
+                builder.failure({
+                    message: `CLI command failed with exit code ${result.exitCode}`,
+                    code: result.exitCode.toString(),
+                    details: {
+                        stdout: result.stdout,
+                        stderr: result.stderr,
+                        command: result.command,
+                        args: result.args,
+                    },
+                });
+                if (throwOnError) {
+                    const builtResult = builder.build();
+                    throw new Error(builtResult.error.message);
+                }
+            }
+            if (result.stderr) {
+                builder.log(result.stderr);
+            }
+            return builder.build();
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            return new AdapterResultBuilder()
+                .duration(duration)
+                .failure({
+                message: error.message,
+                stack: error.stack,
+            })
+                .log(`CLI execution error: ${error.message}`)
+                .build();
+        }
+    }
+    /**
+     * Execute CLI command
+     */
+    executeCLI(command, args, options, context) {
+        return new Promise((resolve, reject) => {
+            const startTime = Date.now();
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            // Spawn process
+            const child = spawn(command, args, {
+                cwd: options.cwd,
+                env: options.env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                windowsHide: true,
+            });
+            // Send stdin if provided
+            if (options.stdin && child.stdin) {
+                child.stdin.write(options.stdin);
+                child.stdin.end();
+            }
+            // Collect stdout
+            child.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            // Collect stderr
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            // Handle timeout
+            let timeoutHandle;
+            if (options.timeout) {
+                timeoutHandle = setTimeout(() => {
+                    timedOut = true;
+                    child.kill('SIGTERM');
+                    // Force kill after 5s
+                    setTimeout(() => {
+                        if (!child.killed) {
+                            child.kill('SIGKILL');
+                        }
+                    }, 5000);
+                }, options.timeout);
+            }
+            // Handle exit
+            child.on('exit', (code, _signal) => {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                const duration = Date.now() - startTime;
+                const exitCode = code ?? -1;
+                const result = {
+                    stdout,
+                    stderr,
+                    exitCode,
+                    command,
+                    args,
+                    duration,
+                    success: exitCode === 0 && !timedOut,
+                };
+                if (timedOut) {
+                    context.log(`CLI command timed out after ${options.timeout}ms`, 'error');
+                    reject(new Error(`Command timed out after ${options.timeout}ms`));
+                    return;
+                }
+                context.log(`CLI command completed with exit code ${exitCode} in ${duration}ms`);
+                resolve(result);
+            });
+            // Handle errors
+            child.on('error', (error) => {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                context.log(`CLI command error: ${error.message}`, 'error');
+                reject(error);
+            });
+        });
+    }
+}
+//# sourceMappingURL=CLIAdapter.js.map

package/dist/adapters/builtins/CLIAdapter.js.map

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