toolpack-sdk 0.1.0-SNAPSHOT

package/dist/workflows/steps/step-executor.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepExecutor = void 0;
+const step_tracker_js_1 = require("./step-tracker.js");
+const STEP_EXECUTION_PROMPT = `
+You are executing step {stepNumber} of a plan.
+
+Plan summary: {planSummary}
+
+Current step: {stepDescription}
+
+Previous steps completed:
+{previousStepsResults}
+
+Execute this step now. Use the available tools as needed to accomplish this specific step.
+Make reasonable assumptions if any details are ambiguous - do NOT ask the user for clarification or additional input.
+Produce concrete results based on the information available.
+If you cannot complete this step, explain why.
+If you need to add additional steps to the plan, indicate that clearly in your response.
+
+IMPORTANT: Your response should be written as if you are directly answering the user.
+Do NOT mention steps, plans, workflow details, or internal process in your response.
+Do NOT say things like "Step 1 is complete" or "proceeding to the next step".
+Just provide the actual answer or result naturally.
+`;
+const DYNAMIC_STEPS_PROMPT = `
+Based on the result of the previous step, do we need to add any new steps to our plan before continuing?
+If YES, respond with a JSON object containing the new steps.
+If NO, respond with {"steps": []}.
+
+JSON Schema:
+{
+  "steps": [
+    { "description": "What to do", "expectedTools": [] }
+  ]
+}
+`;
+class StepExecutor {
+    client;
+    config;
+    constructor(client, config) {
+        this.client = client;
+        this.config = config;
+    }
+    /**
+     * Executes a single step of the plan using the full tool loop.
+     */
+    async executeStep(step, plan, baseRequest, providerName) {
+        const startTime = Date.now();
+        const stepRequest = this.buildStepRequest(step, plan, baseRequest);
+        try {
+            // Execute via AIClient (this runs the full semantic tool loop)
+            const response = await this.client.generate(stepRequest, providerName);
+            // Extract tools used from the raw raw response if available
+            // In a real implementation we might need to track tool usage via events, 
+            // but for now we look at the final response or assume it worked.
+            const uniqueTools = new Set();
+            if (response.tool_calls) {
+                response.tool_calls.forEach(tc => uniqueTools.add(tc.name));
+            }
+            return {
+                success: true,
+                output: response.content || 'Step completed successfully.',
+                toolsUsed: Array.from(uniqueTools),
+                duration: Date.now() - startTime,
+                response: response, // Store full response for metadata
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message || 'Unknown execution error',
+                duration: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Stream a single step execution, yielding chunks as they come.
+     */
+    async *streamStep(step, plan, baseRequest, providerName) {
+        const stepRequest = this.buildStepRequest(step, plan, baseRequest);
+        // Stream via AIClient
+        yield* this.client.stream(stepRequest, providerName);
+    }
+    /**
+     * 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.
+     */
+    buildStepRequest(step, plan, baseRequest) {
+        const previousResults = step_tracker_js_1.StepTracker.summarizeCompletedSteps(plan, step.id);
+        const systemPrompt = STEP_EXECUTION_PROMPT
+            .replace('{stepNumber}', step.number.toString())
+            .replace('{planSummary}', plan.summary)
+            .replace('{stepDescription}', step.description)
+            .replace('{previousStepsResults}', previousResults);
+        // Include full conversation history so the step executor understands the context
+        // of the current user request (like past interactions and facts).
+        const systemMessages = baseRequest.messages.filter(m => m.role === 'system');
+        const historyMessages = baseRequest.messages.filter(m => m.role !== 'system');
+        const userMessages = [...systemMessages, ...historyMessages];
+        // Build conversation with previous step results as assistant/user pairs
+        // This gives the AI actual conversation context showing work was already done
+        const conversationHistory = [];
+        for (const prevStep of plan.steps) {
+            if (prevStep.id === step.id)
+                break;
+            if (prevStep.status === 'completed' && prevStep.result?.output) {
+                // Truncate to keep context manageable
+                let output = prevStep.result.output;
+                if (output.length > 2000) {
+                    output = output.substring(0, 2000) + '\n... [truncated]';
+                }
+                conversationHistory.push({
+                    role: 'assistant',
+                    content: `[Step ${prevStep.number}: ${prevStep.description}]\n${output}`,
+                });
+                conversationHistory.push({
+                    role: 'user',
+                    content: `Step ${prevStep.number} is complete. Now proceed with the next step.`,
+                });
+            }
+        }
+        return {
+            ...baseRequest,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                ...userMessages,
+                ...conversationHistory,
+            ],
+            tool_choice: 'auto',
+        };
+    }
+    /**
+     * Optional: Check if the AI wants to add steps dynamically based on what just happened.
+     */
+    async checkForDynamicSteps(step, plan, baseRequest, providerName) {
+        if (!this.config?.allowDynamicSteps) {
+            return [];
+        }
+        const currentTotal = plan.steps.length;
+        const max = this.config.maxTotalSteps ?? 50;
+        if (currentTotal >= max) {
+            return []; // Reached limit
+        }
+        const prompt = DYNAMIC_STEPS_PROMPT;
+        // Use full conversation history for dynamic step check
+        const checkSystemMessages = baseRequest.messages.filter(m => m.role === 'system');
+        const checkHistoryMessages = baseRequest.messages.filter(m => m.role !== 'system');
+        const checkUserMessages = [...checkSystemMessages, ...checkHistoryMessages];
+        const checkRequest = {
+            ...baseRequest,
+            tool_choice: 'none', // Force text/JSON only
+            response_format: 'json_object',
+            messages: [
+                ...checkUserMessages,
+                { role: 'assistant', content: step.result?.output || '' },
+                { role: 'user', content: prompt }
+            ]
+        };
+        try {
+            const response = await this.client.generate(checkRequest, providerName);
+            const parsed = JSON.parse(response.content || '{"steps": []}');
+            if (Array.isArray(parsed.steps) && parsed.steps.length > 0) {
+                // Ensure we don't exceed maxTotalSteps
+                const allowedNew = max - currentTotal;
+                const toAdd = parsed.steps.slice(0, allowedNew);
+                // Filter out duplicate/similar steps to prevent infinite loops
+                const existingDescriptions = new Set(plan.steps.map(s => this.normalizeStepDescription(s.description)));
+                const filteredSteps = toAdd.filter((s) => {
+                    const normalized = this.normalizeStepDescription(s.description || '');
+                    if (existingDescriptions.has(normalized)) {
+                        return false; // Skip duplicate
+                    }
+                    existingDescriptions.add(normalized);
+                    return true;
+                });
+                if (filteredSteps.length === 0) {
+                    return []; // All proposed steps are duplicates
+                }
+                return filteredSteps.map((s, idx) => ({
+                    id: `step-${Date.now()}-dyn-${idx}`,
+                    number: 0, // Will be re-numbered by executor
+                    description: s.description || 'Dynamic step',
+                    expectedTools: s.expectedTools || [],
+                    dependsOn: [step.id], // Depends on the step that spawned it
+                    status: 'pending'
+                }));
+            }
+        }
+        catch (error) {
+            // Silently fail dynamic check, it's just an optimization
+        }
+        return [];
+    }
+    /**
+     * Normalize step description for duplicate detection.
+     * Strips common variations to catch semantically similar steps.
+     */
+    normalizeStepDescription(desc) {
+        return desc
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, '') // Remove punctuation
+            .replace(/\s+/g, ' ') // Normalize whitespace
+            .trim()
+            .split(' ')
+            .filter(w => w.length > 2) // Remove short words
+            .sort() // Sort words for order-independent matching
+            .join(' ');
+    }
+}
+exports.StepExecutor = StepExecutor;
+//# sourceMappingURL=step-executor.js.map

package/dist/workflows/steps/step-executor.js.map

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

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

@@ -0,0 +1,14 @@
+import { Plan } from '../planning/plan-types.js';
+import { WorkflowProgress } from '../workflow-types.js';
+export declare class StepTracker {
+    /**
+     * Compute current progress of the plan.
+     */
+    static getProgress(plan: Plan): WorkflowProgress;
+    /**
+     * Build a text summary of previously completed steps.
+     * Used to inject context into the prompt for the next step without overflowing the context window.
+     */
+    static summarizeCompletedSteps(plan: Plan, upToStepId: string): string;
+}
+//# sourceMappingURL=step-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-tracker.d.ts","sourceRoot":"","sources":["../../../src/workflows/steps/step-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAY,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,qBAAa,WAAW;IACpB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB;IAgChD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;CA+BzE"}

package/dist/workflows/steps/step-tracker.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepTracker = void 0;
+class StepTracker {
+    /**
+     * Compute current progress of the plan.
+     */
+    static getProgress(plan) {
+        const totalSteps = plan.steps.length;
+        // Find first non-completed step
+        let currentStepIdx = plan.steps.findIndex((s) => s.status !== 'completed' && s.status !== 'skipped');
+        if (currentStepIdx === -1) {
+            currentStepIdx = totalSteps; // All done
+        }
+        const percentage = totalSteps > 0
+            ? Math.round((currentStepIdx / totalSteps) * 100)
+            : 0;
+        const currentStep = plan.steps[currentStepIdx];
+        const currentStepDescription = currentStep ? currentStep.description : 'Done';
+        let status = 'executing';
+        if (plan.status === 'draft')
+            status = 'planning';
+        if (plan.status === 'approved')
+            status = 'executing';
+        if (plan.status === 'completed')
+            status = 'completed';
+        if (plan.status === 'failed' || plan.status === 'cancelled')
+            status = 'failed';
+        return {
+            planId: plan.id,
+            currentStep: Math.min(currentStepIdx + 1, totalSteps), // 1-indexed for display, capped at totalSteps
+            totalSteps,
+            percentage,
+            currentStepDescription,
+            status,
+        };
+    }
+    /**
+     * Build a text summary of previously completed steps.
+     * Used to inject context into the prompt for the next step without overflowing the context window.
+     */
+    static summarizeCompletedSteps(plan, upToStepId) {
+        const completed = [];
+        for (const step of plan.steps) {
+            if (step.id === upToStepId)
+                break;
+            if (step.status === 'completed' && step.result) {
+                const tools = step.result.toolsUsed?.length
+                    ? ` (Tools: ${step.result.toolsUsed.join(', ')})`
+                    : '';
+                // Truncate output to keep it reasonable
+                let output = step.result.output || 'No output';
+                if (output.length > 500) {
+                    output = output.substring(0, 500) + '... [truncated]';
+                }
+                completed.push(`Step ${step.number}: ${step.description}${tools}\nResult: ${output}`);
+            }
+            else if (step.status === 'failed') {
+                completed.push(`Step ${step.number}: ${step.description}\nFailed: ${step.result?.error || 'Unknown error'}`);
+            }
+            else if (step.status === 'skipped') {
+                completed.push(`Step ${step.number}: ${step.description}\nSkipped.`);
+            }
+        }
+        if (completed.length === 0) {
+            return 'No previous steps.';
+        }
+        return completed.join('\n\n');
+    }
+}
+exports.StepTracker = StepTracker;
+//# sourceMappingURL=step-tracker.js.map

package/dist/workflows/steps/step-tracker.js.map

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

package/dist/workflows/workflow-executor.d.ts

@@ -0,0 +1,95 @@
+import { EventEmitter } from 'events';
+import { AIClient } from '../client/index.js';
+import { CompletionRequest } from '../types/index.js';
+import { WorkflowConfig, WorkflowResult } from './workflow-types.js';
+export declare class WorkflowExecutor extends EventEmitter {
+    private client;
+    private config;
+    private planner;
+    private stepExecutor;
+    private pendingApprovals;
+    constructor(client: AIClient, config: WorkflowConfig);
+    /**
+     * Get the active configuration.
+     */
+    getConfig(): WorkflowConfig;
+    /**
+     * Update the configuration.
+     */
+    setConfig(config: WorkflowConfig): void;
+    /**
+     * Execute a request using the configured workflow.
+     */
+    execute(request: CompletionRequest, providerName?: string): Promise<WorkflowResult>;
+    /**
+     * Direct execution — current SDK behavior, wrapped in WorkflowResult.
+     */
+    private executeDirect;
+    /**
+     * Create a plan from the request.
+     */
+    private createPlan;
+    /**
+     * Execute plan step by step using the StepExecutor.
+     */
+    private executeStepByStep;
+    /**
+     * Planning without steps — execute plan as single generate call.
+     */
+    private executePlanDirect;
+    /**
+     * Emit a progress event using StepTracker.
+     */
+    private emitProgress;
+    /**
+     * Compute metrics for the plan.
+     */
+    private computeMetrics;
+    /**
+     * Summarize the entire plan execution.
+     */
+    private summarizePlanResult;
+    /**
+     * Extract the final output from the last completed step.
+     * Returns the actual AI response instead of a workflow summary.
+     */
+    private extractFinalOutput;
+    /**
+     * Extract the full response metadata from the last completed step.
+     */
+    private extractFinalResponse;
+    /**
+     * Create a dummy plan for internal representation when no plan is generated.
+     */
+    private createDummyPlan;
+    /**
+     * Execute a request using the configured workflow, yielding chunks as they come.
+     * This is the streaming equivalent of execute().
+     */
+    stream(request: CompletionRequest, providerName?: string): AsyncGenerator<import('../types/index.js').CompletionChunk>;
+    /**
+     * Direct streaming — proxy to AIClient.stream()
+     */
+    private streamDirect;
+    /**
+     * Stream plan execution step by step.
+     */
+    private streamStepByStep;
+    /**
+     * Stream plan execution as a single request (planning without steps).
+     */
+    private streamPlanDirect;
+    /**
+     * Wait for user approval of a plan.
+     */
+    private waitForApproval;
+    /**
+     * Approve a pending plan.
+     */
+    approvePlan(planId: string): void;
+    /**
+     * Reject a pending plan.
+     */
+    rejectPlan(planId: string): void;
+}
+//# sourceMappingURL=workflow-executor.d.ts.map

package/dist/workflows/workflow-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../src/workflows/workflow-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,qBAAqB,CAAC;AAMvF,qBAAa,gBAAiB,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAe;IAGnC,OAAO,CAAC,gBAAgB,CAAkD;gBAE9D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc;IAQpD;;OAEG;IACH,SAAS,IAAI,cAAc;IAI3B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAMvC;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyDzF;;OAEG;YACW,aAAa;IAmD3B;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,iBAAiB;IAkK/B;;OAEG;YACW,iBAAiB;IAuE/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA2BvB;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC;IAqE7H;;OAEG;YACY,YAAY;IAI3B;;OAEG;YACY,gBAAgB;IAyK/B;;OAEG;YACY,gBAAgB;IAsD/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAOnC"}