toolpack-sdk 0.1.0-SNAPSHOT

package/dist/utils/runtime-config-loader.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRuntimeConfig = loadRuntimeConfig;
+exports.getRuntimeConfigStatus = getRuntimeConfigStatus;
+exports.initializeGlobalConfigIfFirstRun = initializeGlobalConfigIfFirstRun;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const home_config_js_1 = require("./home-config.js");
+const config_js_1 = require("../providers/config.js");
+/**
+ * Deep merges two objects. Arrays are overwritten.
+ */
+function deepMerge(target, source) {
+    if (!source)
+        return target;
+    if (!target)
+        return source;
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (source[key] instanceof Array) {
+            result[key] = source[key];
+        }
+        else if (source[key] instanceof Object && key in target) {
+            result[key] = deepMerge(target[key], source[key]);
+        }
+        else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+/**
+ * Loads a configuration file from the given path if it exists.
+ */
+function loadConfigFile(configPath) {
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Loads the runtime configuration by merging base, global, and local configurations.
+ * Priority: Workspace Local (.toolpack/config) > Global (~/.toolpack/config) > SDK Base (toolpack.config.json)
+ */
+function loadRuntimeConfig(workspacePath = process.cwd()) {
+    const basePath = path.join(workspacePath, 'toolpack.config.json');
+    const globalPath = (0, home_config_js_1.getGlobalConfigPath)();
+    const localPath = (0, home_config_js_1.getLocalConfigPath)(workspacePath);
+    const baseConfig = loadConfigFile(basePath) || {};
+    const globalConfig = loadConfigFile(globalPath) || {};
+    const localConfig = loadConfigFile(localPath) || {};
+    // Merge in order of priority: base -> global -> local
+    let merged = deepMerge(baseConfig, globalConfig);
+    merged = deepMerge(merged, localConfig);
+    return merged;
+}
+/**
+ * Helper to check the status of the configuration.
+ */
+function getRuntimeConfigStatus(workspacePath = process.cwd()) {
+    const basePath = path.join(workspacePath, 'toolpack.config.json');
+    const globalPath = (0, home_config_js_1.getGlobalConfigPath)();
+    const localPath = (0, home_config_js_1.getLocalConfigPath)(workspacePath);
+    const isFirstRun = !fs.existsSync(globalPath);
+    let activeConfigPath = null;
+    let configSource = 'default';
+    if (fs.existsSync(localPath)) {
+        activeConfigPath = localPath;
+        configSource = 'local';
+    }
+    else if (fs.existsSync(globalPath)) {
+        activeConfigPath = globalPath;
+        configSource = 'global';
+    }
+    else if (fs.existsSync(basePath)) {
+        activeConfigPath = basePath;
+        configSource = 'base';
+    }
+    return {
+        isFirstRun,
+        activeConfigPath,
+        configSource,
+    };
+}
+/**
+ * Initializes the global configuration if it doesn't exist.
+ * This is typically called on the first run of the CLI.
+ * It copies the build-time config (if found in the current directory) to the global config path.
+ */
+function initializeGlobalConfigIfFirstRun(workspacePath = process.cwd()) {
+    const globalPath = (0, home_config_js_1.getGlobalConfigPath)();
+    if (!fs.existsSync(globalPath)) {
+        (0, home_config_js_1.ensureGlobalConfigDir)();
+        // Try to find a template config in the workspace to copy from
+        let sourceConfigPath = null;
+        // 1. Try local workspace config (.toolpack/config/toolpack.config.json)
+        const localPath = (0, home_config_js_1.getLocalConfigPath)(workspacePath);
+        if (fs.existsSync(localPath)) {
+            sourceConfigPath = localPath;
+        }
+        // 2. Try SDK base config (toolpack.config.json in root)
+        else {
+            const basePath = path.join(workspacePath, 'toolpack.config.json');
+            if (fs.existsSync(basePath)) {
+                sourceConfigPath = basePath;
+            }
+            else {
+                // 3. Try discover (looks in cwd)
+                const discoveredPath = (0, config_js_1.discoverConfigPath)();
+                if (discoveredPath && fs.existsSync(discoveredPath)) {
+                    sourceConfigPath = discoveredPath;
+                }
+            }
+        }
+        let initialConfig = {};
+        if (sourceConfigPath) {
+            try {
+                const raw = fs.readFileSync(sourceConfigPath, 'utf-8');
+                initialConfig = JSON.parse(raw);
+            }
+            catch {
+                // Ignore errors reading source config, fall back to empty object
+            }
+        }
+        // Write to global path
+        fs.writeFileSync(globalPath, JSON.stringify(initialConfig, null, 4), 'utf-8');
+    }
+}
+//# sourceMappingURL=runtime-config-loader.js.map

package/dist/utils/runtime-config-loader.js.map

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

package/dist/workflows/index.d.ts

@@ -0,0 +1,6 @@
+export * from './workflow-types.js';
+export * from './planning/plan-types.js';
+export * from './planning/planner.js';
+export * from './steps/step-executor.js';
+export * from './workflow-executor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/dist/workflows/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./workflow-types.js"), exports);
+__exportStar(require("./planning/plan-types.js"), exports);
+__exportStar(require("./planning/planner.js"), exports);
+__exportStar(require("./steps/step-executor.js"), exports);
+__exportStar(require("./workflow-executor.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,2DAAyC;AACzC,wDAAsC;AACtC,2DAAyC;AACzC,yDAAuC"}

package/dist/workflows/planning/plan-types.d.ts

@@ -0,0 +1,50 @@
+import { CompletionResponse } from '../../types/index.js';
+export interface PlanStep {
+    /** Unique step ID */
+    id: string;
+    /** Step number (1-indexed) */
+    number: number;
+    /** Human-readable description */
+    description: string;
+    /** Expected tools to be used (optional, for validation) */
+    expectedTools?: string[];
+    /** Dependencies on other step IDs (must complete first) */
+    dependsOn?: string[];
+    /** Step status */
+    status: 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
+    /** Result after completion */
+    result?: {
+        success: boolean;
+        output?: string;
+        error?: string;
+        toolsUsed?: string[];
+        duration?: number;
+        response?: CompletionResponse;
+    };
+}
+export interface Plan {
+    /** Unique plan ID */
+    id: string;
+    /** Original user request */
+    request: string;
+    /** Plan summary/goal */
+    summary: string;
+    /** Ordered steps */
+    steps: PlanStep[];
+    /** Plan status */
+    status: 'draft' | 'approved' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+    /** Timestamps */
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    /** Raw response from the planning phase */
+    planningResponse?: CompletionResponse;
+    /** Metrics */
+    metrics?: {
+        totalDuration: number;
+        stepsCompleted: number;
+        stepsFailed: number;
+        retriesUsed: number;
+    };
+}
+//# sourceMappingURL=plan-types.d.ts.map

package/dist/workflows/planning/plan-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-types.d.ts","sourceRoot":"","sources":["../../../src/workflows/planning/plan-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACrB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,kBAAkB;IAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEvE,8BAA8B;IAC9B,MAAM,CAAC,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;KACjC,CAAC;CACL;AAED,MAAM,WAAW,IAAI;IACjB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAEhB,oBAAoB;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAElB,kBAAkB;IAClB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAEpF,iBAAiB;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IAEtC,cAAc;IACd,OAAO,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL"}

package/dist/workflows/planning/plan-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=plan-types.js.map

package/dist/workflows/planning/plan-types.js.map

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

package/dist/workflows/planning/planner.d.ts

@@ -0,0 +1,20 @@
+import { AIClient } from '../../client/index.js';
+import { CompletionRequest } from '../../types/index.js';
+import { Plan } from './plan-types.js';
+import { WorkflowConfig } from '../workflow-types.js';
+export declare class Planner {
+    private client;
+    private config?;
+    constructor(client: AIClient, config?: WorkflowConfig['planning']);
+    /**
+     * Create a detailed step-by-step plan from the user's request.
+     */
+    createPlan(request: CompletionRequest, providerName?: string): Promise<Plan>;
+    /**
+     * Create a lightweight implicit plan when steps are enabled but planning phase is skipped.
+     */
+    createImplicitPlan(request: CompletionRequest, providerName?: string): Promise<Plan>;
+    private parsePlan;
+    private createFallbackPlan;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/workflows/planning/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/workflows/planning/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAY,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA4BtD,qBAAa,OAAO;IAChB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAC,CAA6B;gBAEhC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC;IAKjE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlF;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1F,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,kBAAkB;CAsB7B"}

package/dist/workflows/planning/planner.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Planner = void 0;
+const DEFAULT_PLANNING_PROMPT = `
+You are a planning assistant. Given a user request, create a detailed step-by-step plan.
+
+Rules:
+1. Break the task into clear, actionable steps
+2. Each step should be independently executable WITHOUT requiring additional user input
+3. Order steps by dependencies (what must happen first)
+4. Be specific about what each step will accomplish
+5. Estimate which tools will be needed for each step
+6. If the user's request is ambiguous, make reasonable assumptions and proceed - do NOT create steps that ask for clarification
+7. Steps should produce concrete outputs, not ask questions or wait for user input
+8. ALWAYS include at least one step, even for simple questions. For simple factual questions, create a single step like "Provide the answer to [question]"
+9. The exact result MUST be valid JSON matching this schema:
+{
+  "summary": "Brief description of the overall goal",
+  "steps": [
+    {
+      "number": 1,
+      "description": "What this step does",
+      "expectedTools": ["tool.name"],
+      "dependsOn": []
+    }
+  ]
+}
+`;
+class Planner {
+    client;
+    config;
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Create a detailed step-by-step plan from the user's request.
+     */
+    async createPlan(request, providerName) {
+        const systemPrompt = this.config?.planningPrompt || DEFAULT_PLANNING_PROMPT;
+        // We use the AIClient to generate the plan, but WITHOUT tools available
+        // to force a JSON response instead of arbitrary tool calls.
+        // Include full conversation history so the planner understands context (like previous names).
+        const systemMessages = request.messages.filter(m => m.role === 'system');
+        const historyMessages = request.messages.filter(m => m.role !== 'system');
+        const planningMessages = [
+            { role: 'system', content: systemPrompt },
+            ...systemMessages,
+            ...historyMessages,
+        ];
+        const planningRequest = {
+            ...request,
+            tools: undefined,
+            tool_choice: 'none',
+            response_format: 'json_object',
+            messages: planningMessages,
+        };
+        try {
+            const response = await this.client.generate(planningRequest, providerName);
+            return this.parsePlan(response.content || '', request, response);
+        }
+        catch (error) {
+            return this.createFallbackPlan(request);
+        }
+    }
+    /**
+     * Create a lightweight implicit plan when steps are enabled but planning phase is skipped.
+     */
+    async createImplicitPlan(request, providerName) {
+        // Fallback or simplified logic can go here. For now, we reuse the robust createPlan logic
+        // but it could be optimized in the future.
+        return this.createPlan(request, providerName);
+    }
+    parsePlan(jsonString, originalRequest, planningResponse) {
+        try {
+            const parsed = JSON.parse(jsonString);
+            if (!parsed.summary || !Array.isArray(parsed.steps)) {
+                throw new Error('Invalid plan structure: missing summary or steps array');
+            }
+            const maxSteps = this.config?.maxSteps ?? 20;
+            const limitedSteps = parsed.steps.slice(0, maxSteps);
+            const steps = limitedSteps.map((s, i) => ({
+                id: `step-${Date.now()}-${i}`,
+                number: s.number || i + 1,
+                description: s.description || 'Unknown step',
+                expectedTools: s.expectedTools || [],
+                dependsOn: s.dependsOn || [],
+                status: 'pending',
+            }));
+            // Extract the original prompt as a summary of the request
+            const userText = originalRequest.messages
+                .filter(m => m.role === 'user')
+                .map(m => typeof m.content === 'string' ? m.content : '[Complex Object]')
+                .join('\\n');
+            return {
+                id: `plan-${Date.now()}`,
+                request: userText,
+                summary: parsed.summary,
+                steps,
+                status: 'draft',
+                createdAt: new Date(),
+                planningResponse,
+            };
+        }
+        catch (error) {
+            return this.createFallbackPlan(originalRequest);
+        }
+    }
+    createFallbackPlan(request) {
+        const userText = request.messages
+            .filter(m => m.role === 'user')
+            .map(m => typeof m.content === 'string' ? m.content : '[Complex Object]')
+            .join('\\n');
+        return {
+            id: `plan-${Date.now()}-fallback`,
+            request: userText,
+            summary: 'Fallback single-step plan due to generation failure',
+            steps: [{
+                    id: 'step-1',
+                    number: 1,
+                    description: 'Execute the user request',
+                    status: 'pending',
+                    expectedTools: [],
+                    dependsOn: [],
+                }],
+            status: 'draft',
+            createdAt: new Date(),
+        };
+    }
+}
+exports.Planner = Planner;
+//# sourceMappingURL=planner.js.map

package/dist/workflows/planning/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../../src/workflows/planning/planner.ts"],"names":[],"mappings":";;;AAKA,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwB/B,CAAC;AAEF,MAAa,OAAO;IACR,MAAM,CAAW;IACjB,MAAM,CAA8B;IAE5C,YAAY,MAAgB,EAAE,MAAmC;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAA0B,EAAE,YAAqB;QAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,IAAI,uBAAuB,CAAC;QAE5E,wEAAwE;QACxE,4DAA4D;QAC5D,8FAA8F;QAC9F,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACzE,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC1E,MAAM,gBAAgB,GAAG;YACrB,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,YAAY,EAAE;YAClD,GAAG,cAAc;YACjB,GAAG,eAAe;SACrB,CAAC;QAEF,MAAM,eAAe,GAAsB;YACvC,GAAG,OAAO;YACV,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,MAAM;YACnB,eAAe,EAAE,aAAa;YAC9B,QAAQ,EAAE,gBAAgB;SAC7B,CAAC;QAEF,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;YAC3E,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAA0B,EAAE,YAAqB;QACtE,0FAA0F;QAC1F,2CAA2C;QAC3C,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAEO,SAAS,CAAC,UAAkB,EAAE,eAAkC,EAAE,gBAAoE;QAC1I,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;YAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAErD,MAAM,KAAK,GAAe,YAAY,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC;gBAC/D,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;gBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC;gBACzB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,cAAc;gBAC5C,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,EAAE;gBACpC,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;gBAC5B,MAAM,EAAE,SAAS;aACpB,CAAC,CAAC,CAAC;YAEJ,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ;iBACpC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC;iBACxE,IAAI,CAAC,KAAK,CAAC,CAAC;YAEjB,OAAO;gBACH,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE;gBACxB,OAAO,EAAE,QAAQ;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK;gBACL,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,gBAAgB;aACnB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAEO,kBAAkB,CAAC,OAA0B;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC;aACxE,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjB,OAAO;YACH,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,WAAW;YACjC,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,qDAAqD;YAC9D,KAAK,EAAE,CAAC;oBACJ,EAAE,EAAE,QAAQ;oBACZ,MAAM,EAAE,CAAC;oBACT,WAAW,EAAE,0BAA0B;oBACvC,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,EAAE;oBACjB,SAAS,EAAE,EAAE;iBAChB,CAAC;YACF,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;IACN,CAAC;CACJ;AAjHD,0BAiHC"}

package/dist/workflows/steps/step-executor.d.ts

@@ -0,0 +1,32 @@
+import { AIClient } from '../../client/index.js';
+import { CompletionRequest } from '../../types/index.js';
+import { Plan, PlanStep } from '../planning/plan-types.js';
+import { WorkflowConfig } from '../workflow-types.js';
+export declare class StepExecutor {
+    private client;
+    private config?;
+    constructor(client: AIClient, config?: WorkflowConfig['steps']);
+    /**
+     * Executes a single step of the plan using the full tool loop.
+     */
+    executeStep(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): Promise<NonNullable<PlanStep['result']>>;
+    /**
+     * Stream a single step execution, yielding chunks as they come.
+     */
+    streamStep(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): AsyncGenerator<import('../../types/index.js').CompletionChunk>;
+    /**
+     * Build a context-aware request for a specific step, including previous step results
+     * as conversation history so the AI knows what work was already done.
+     */
+    private buildStepRequest;
+    /**
+     * Optional: Check if the AI wants to add steps dynamically based on what just happened.
+     */
+    checkForDynamicSteps(step: PlanStep, plan: Plan, baseRequest: CompletionRequest, providerName?: string): Promise<PlanStep[]>;
+    /**
+     * Normalize step description for duplicate detection.
+     * Strips common variations to catch semantically similar steps.
+     */
+    private normalizeStepDescription;
+}
+//# sourceMappingURL=step-executor.d.ts.map

package/dist/workflows/steps/step-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../../../src/workflows/steps/step-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAiB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsCtD,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAC,CAA0B;gBAE7B,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC;IAK9D;;OAEG;IACG,WAAW,CACb,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,iBAAiB,EAC9B,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAiC3C;;OAEG;IACI,UAAU,CACb,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,iBAAiB,EAC9B,YAAY,CAAC,EAAE,MAAM,GACtB,cAAc,CAAC,OAAO,sBAAsB,EAAE,eAAe,CAAC;IAOjE;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAiDxB;;OAEG;IACG,oBAAoB,CACtB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,iBAAiB,EAC9B,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuEtB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;CAWnC"}