claude-chrome-parallel 3.5.1 → 3.6.1

package/dist/orchestration/plan-executor.js

@@ -0,0 +1,284 @@
+"use strict";
+/**
+ * PlanExecutor - Executes compiled plans by chaining tool handlers internally.
+ *
+ * Bypasses per-step agent LLM round-trips by resolving and calling tool handlers
+ * directly from the MCP server's internal registry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanExecutor = void 0;
+/**
+ * Recursively substitute ${varName} templates in a value using the params map.
+ * Handles strings, objects, and arrays. Non-string primitives are returned as-is.
+ * Missing vars are left as-is (no crash).
+ */
+function substituteParams(value, params) {
+    if (typeof value === 'string') {
+        return value.replace(/\$\{([^}]+)\}/g, (match, varName) => {
+            const resolved = params[varName];
+            if (resolved === undefined)
+                return match;
+            if (typeof resolved === 'string')
+                return resolved;
+            return JSON.stringify(resolved);
+        });
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => substituteParams(item, params));
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = substituteParams(v, params);
+        }
+        return result;
+    }
+    return value;
+}
+/**
+ * Apply a timeout to a promise via Promise.race.
+ */
+function withTimeout(promise, timeoutMs, label) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout after ${timeoutMs}ms (${label})`)), timeoutMs)),
+    ]);
+}
+/**
+ * Extract result data from an MCPResult according to parseResult spec.
+ * Returns the extracted value (raw text, parsed JSON, or a specific field).
+ */
+function extractResult(mcpResult, parseResult) {
+    const content = mcpResult.content;
+    const text = content && content.length > 0 ? content[0].text ?? '' : '';
+    if (parseResult.format === 'text') {
+        return text;
+    }
+    // format === 'json'
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        parsed = text;
+    }
+    if (parseResult.extractField) {
+        const obj = parsed;
+        parsed = obj?.[parseResult.extractField];
+    }
+    return parsed;
+}
+/**
+ * Check whether an MCPResult represents an empty/no-data result.
+ */
+function isEmptyResult(mcpResult) {
+    if (mcpResult.isError)
+        return false; // errors are not "empty"
+    const content = mcpResult.content;
+    if (!content || content.length === 0)
+        return true;
+    const text = content[0].text ?? '';
+    if (text.trim() === '' || text.trim() === 'null' || text.trim() === '[]' || text.trim() === '{}') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validate final params against the plan's success criteria.
+ * Returns null if valid, or an error string describing the violation.
+ */
+function validateSuccessCriteria(criteria, params) {
+    if (criteria.minDataItems !== undefined) {
+        // Find the first array or object in params that could represent "data items"
+        let found = false;
+        for (const val of Object.values(params)) {
+            if (Array.isArray(val)) {
+                if (val.length < criteria.minDataItems) {
+                    return `minDataItems requirement not met: got ${val.length}, need ${criteria.minDataItems}`;
+                }
+                found = true;
+                break;
+            }
+            else if (val !== null && typeof val === 'object') {
+                const count = Object.keys(val).length;
+                if (count < criteria.minDataItems) {
+                    return `minDataItems requirement not met: got ${count}, need ${criteria.minDataItems}`;
+                }
+                found = true;
+                break;
+            }
+        }
+        if (!found && criteria.minDataItems > 0) {
+            return `minDataItems requirement not met: no collection found in params`;
+        }
+    }
+    if (criteria.requiredFields && criteria.requiredFields.length > 0) {
+        for (const field of criteria.requiredFields) {
+            if (!(field in params) || params[field] === undefined) {
+                return `Required field missing from params: ${field}`;
+            }
+        }
+    }
+    return null;
+}
+class PlanExecutor {
+    toolResolver;
+    constructor(toolResolver) {
+        this.toolResolver = toolResolver;
+    }
+    async execute(plan, sessionId, runtimeParams) {
+        const startTime = Date.now();
+        let stepsExecuted = 0;
+        // 1. Build params map: plan defaults first, runtime overrides on top
+        const params = {};
+        for (const [key, spec] of Object.entries(plan.parameters)) {
+            if (spec.default !== undefined) {
+                params[key] = spec.default;
+            }
+        }
+        Object.assign(params, runtimeParams);
+        const failure = (error) => ({
+            success: false,
+            planId: plan.id,
+            error,
+            durationMs: Date.now() - startTime,
+            stepsExecuted,
+            totalSteps: plan.steps.length,
+        });
+        // 2. Execute each step sequentially
+        for (const step of plan.steps) {
+            const stepLabel = `plan=${plan.id} step=${step.order} tool=${step.tool}`;
+            // a. Resolve handler
+            const handler = this.toolResolver(step.tool);
+            if (!handler) {
+                const msg = `No handler found for tool "${step.tool}" at ${stepLabel}`;
+                console.error(`[PlanExecutor] ${msg}`);
+                return failure(msg);
+            }
+            // b. Substitute template variables in args
+            const substitutedArgs = substituteParams(step.args, params);
+            // c. Call handler with timeout
+            let mcpResult;
+            try {
+                mcpResult = await withTimeout(handler(sessionId, substitutedArgs), step.timeout, stepLabel);
+                stepsExecuted++;
+            }
+            catch (err) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                console.error(`[PlanExecutor] Step failed at ${stepLabel}: ${errMsg}`);
+                // Check for a matching error handler
+                const conditionKey = `step${step.order}_error`;
+                const recovered = await this.tryRecovery(conditionKey, plan.errorHandlers, sessionId, params, stepsExecuted);
+                if (recovered !== null) {
+                    stepsExecuted = recovered.stepsExecuted;
+                    // Merge any params updates from recovery into our params
+                    Object.assign(params, recovered.params);
+                    continue;
+                }
+                return failure(`Step ${step.order} (${step.tool}) failed: ${errMsg}`);
+            }
+            // d. Check for error result
+            if (mcpResult.isError) {
+                const errMsg = mcpResult.content?.[0]?.text ?? 'Unknown tool error';
+                console.error(`[PlanExecutor] Tool returned error at ${stepLabel}: ${errMsg}`);
+                const conditionKey = `step${step.order}_error`;
+                const recovered = await this.tryRecovery(conditionKey, plan.errorHandlers, sessionId, params, stepsExecuted);
+                if (recovered !== null) {
+                    stepsExecuted = recovered.stepsExecuted;
+                    Object.assign(params, recovered.params);
+                    continue;
+                }
+                return failure(`Step ${step.order} (${step.tool}) returned error: ${errMsg}`);
+            }
+            // e. Check for empty result (before storing) — may trigger empty_result handler
+            if (isEmptyResult(mcpResult)) {
+                const conditionKey = `step${step.order}_empty_result`;
+                const recovered = await this.tryRecovery(conditionKey, plan.errorHandlers, sessionId, params, stepsExecuted);
+                if (recovered !== null) {
+                    stepsExecuted = recovered.stepsExecuted;
+                    Object.assign(params, recovered.params);
+                    continue;
+                }
+                // No handler for empty — treat as non-fatal, just skip storing
+            }
+            // f. Parse and store result if requested
+            if (step.parseResult && step.parseResult.storeAs) {
+                try {
+                    const extracted = extractResult(mcpResult, step.parseResult);
+                    params[step.parseResult.storeAs] = extracted;
+                }
+                catch (err) {
+                    console.error(`[PlanExecutor] Failed to extract result at ${stepLabel}: ${err instanceof Error ? err.message : String(err)}`);
+                    // Non-fatal: continue without storing
+                }
+            }
+        }
+        // 3. Validate success criteria
+        const criteriaError = validateSuccessCriteria(plan.successCriteria, params);
+        if (criteriaError) {
+            console.error(`[PlanExecutor] Success criteria failed for plan=${plan.id}: ${criteriaError}`);
+            return {
+                success: false,
+                planId: plan.id,
+                error: `Success criteria not met: ${criteriaError}`,
+                durationMs: Date.now() - startTime,
+                stepsExecuted,
+                totalSteps: plan.steps.length,
+            };
+        }
+        // 4. Return success with all collected params as data
+        return {
+            success: true,
+            planId: plan.id,
+            data: params,
+            durationMs: Date.now() - startTime,
+            stepsExecuted,
+            totalSteps: plan.steps.length,
+        };
+    }
+    /**
+     * Attempt to find and run a recovery handler for a given condition.
+     * Returns updated stepsExecuted + params snapshot on success, null if no handler.
+     */
+    async tryRecovery(conditionKey, errorHandlers, sessionId, params, currentStepsExecuted) {
+        const handler = errorHandlers.find((h) => h.condition === conditionKey);
+        if (!handler)
+            return null;
+        console.error(`[PlanExecutor] Running error handler "${handler.action}" for condition "${conditionKey}"`);
+        let stepsExecuted = currentStepsExecuted;
+        for (const step of handler.steps) {
+            const stepLabel = `recovery action=${handler.action} step=${step.order} tool=${step.tool}`;
+            const toolHandler = this.toolResolver(step.tool);
+            if (!toolHandler) {
+                console.error(`[PlanExecutor] Recovery: no handler for tool "${step.tool}" at ${stepLabel}`);
+                continue;
+            }
+            const substitutedArgs = substituteParams(step.args, params);
+            let mcpResult;
+            try {
+                mcpResult = await withTimeout(toolHandler(sessionId, substitutedArgs), step.timeout, stepLabel);
+                stepsExecuted++;
+            }
+            catch (err) {
+                console.error(`[PlanExecutor] Recovery step failed at ${stepLabel}: ${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            if (mcpResult.isError) {
+                console.error(`[PlanExecutor] Recovery step returned error at ${stepLabel}: ${mcpResult.content?.[0]?.text ?? 'unknown'}`);
+                continue;
+            }
+            if (step.parseResult && step.parseResult.storeAs) {
+                try {
+                    const extracted = extractResult(mcpResult, step.parseResult);
+                    params[step.parseResult.storeAs] = extracted;
+                }
+                catch (err) {
+                    console.error(`[PlanExecutor] Recovery: failed to extract result at ${stepLabel}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        return { stepsExecuted, params };
+    }
+}
+exports.PlanExecutor = PlanExecutor;
+//# sourceMappingURL=plan-executor.js.map

package/dist/orchestration/plan-executor.js.map

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

package/dist/orchestration/plan-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * PlanRegistry — Manages compiled plan storage, loading, matching, and stats tracking.
+ *
+ * Plans are stored at {basePath}/plan-registry.json (index) and
+ * {basePath}/plans/{planId}.json (individual plan files).
+ */
+import type { CompiledPlan, PlanEntry, TaskPattern } from '../types/plan-cache';
+export declare class PlanRegistry {
+    private basePath;
+    private registryPath;
+    private plansDir;
+    private data;
+    constructor(basePath?: string);
+    /**
+     * Load plan registry from disk.
+     */
+    load(): void;
+    /**
+     * Persist plan registry to disk.
+     */
+    save(): void;
+    /**
+     * Find the best matching plan entry for a given task and URL.
+     * Filters by urlPattern, taskKeywords, and confidence threshold.
+     * Returns the highest-confidence match, or null if none found.
+     */
+    matchTask(task: string, url: string): PlanEntry | null;
+    /**
+     * Load a compiled plan from disk by its registry entry.
+     */
+    loadPlan(entry: PlanEntry): CompiledPlan | null;
+    /**
+     * Update execution stats for a plan and recalculate confidence.
+     */
+    updateStats(planId: string, success: boolean, durationMs: number): void;
+    /**
+     * Register a new compiled plan with the given task pattern.
+     * Saves plan JSON to disk and adds entry to the registry.
+     */
+    registerPlan(plan: CompiledPlan, pattern: TaskPattern): PlanEntry;
+    /**
+     * Get all plan entries.
+     */
+    getEntries(): PlanEntry[];
+    /**
+     * Get a single plan entry by ID.
+     */
+    getEntry(planId: string): PlanEntry | null;
+}
+/**
+ * Get a singleton PlanRegistry instance.
+ * Pass basePath to create/replace the singleton with a new base path.
+ */
+export declare function getPlanRegistry(basePath?: string): PlanRegistry;
+//# sourceMappingURL=plan-registry.d.ts.map

package/dist/orchestration/plan-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-registry.d.ts","sourceRoot":"","sources":["../../src/orchestration/plan-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAET,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAO7B,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAmB;gBAEnB,QAAQ,GAAE,MAA0B;IAWhD;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgDtD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI;IAY/C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA+BvE;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS;IAyCjE;;OAEG;IACH,UAAU,IAAI,SAAS,EAAE;IAIzB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;CAI3C;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAQ/D"}

package/dist/orchestration/plan-registry.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * PlanRegistry — Manages compiled plan storage, loading, matching, and stats tracking.
+ *
+ * Plans are stored at {basePath}/plan-registry.json (index) and
+ * {basePath}/plans/{planId}.json (individual plan files).
+ */
+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.PlanRegistry = void 0;
+exports.getPlanRegistry = getPlanRegistry;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_BASE_PATH = '.chrome-parallel/plans/';
+const REGISTRY_FILENAME = 'plan-registry.json';
+const PLANS_SUBDIR = 'plans';
+const REGISTRY_VERSION = '1.0.0';
+class PlanRegistry {
+    basePath;
+    registryPath;
+    plansDir;
+    data;
+    constructor(basePath = DEFAULT_BASE_PATH) {
+        this.basePath = basePath;
+        this.registryPath = path.join(basePath, REGISTRY_FILENAME);
+        this.plansDir = path.join(basePath, PLANS_SUBDIR);
+        this.data = {
+            version: REGISTRY_VERSION,
+            plans: [],
+            updatedAt: Date.now(),
+        };
+    }
+    /**
+     * Load plan registry from disk.
+     */
+    load() {
+        try {
+            const raw = fs.readFileSync(this.registryPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.data = parsed;
+        }
+        catch {
+            // Best-effort — start with empty registry
+            this.data = {
+                version: REGISTRY_VERSION,
+                plans: [],
+                updatedAt: Date.now(),
+            };
+        }
+    }
+    /**
+     * Persist plan registry to disk.
+     */
+    save() {
+        try {
+            fs.mkdirSync(this.basePath, { recursive: true });
+            this.data.updatedAt = Date.now();
+            fs.writeFileSync(this.registryPath, JSON.stringify(this.data, null, 2));
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    /**
+     * Find the best matching plan entry for a given task and URL.
+     * Filters by urlPattern, taskKeywords, and confidence threshold.
+     * Returns the highest-confidence match, or null if none found.
+     */
+    matchTask(task, url) {
+        const taskLower = task.toLowerCase();
+        const candidates = this.data.plans.filter(entry => {
+            // Filter by confidence threshold
+            if (entry.confidence < entry.minConfidenceToUse) {
+                return false;
+            }
+            // Filter by urlPattern (if specified)
+            if (entry.pattern.urlPattern) {
+                try {
+                    const regex = new RegExp(entry.pattern.urlPattern);
+                    if (!regex.test(url)) {
+                        return false;
+                    }
+                }
+                catch {
+                    // Invalid regex — skip this entry
+                    return false;
+                }
+            }
+            // Filter by taskKeywords (all must be present, case-insensitive)
+            const allKeywordsMatch = entry.pattern.taskKeywords.every(kw => taskLower.includes(kw.toLowerCase()));
+            if (!allKeywordsMatch) {
+                return false;
+            }
+            return true;
+        });
+        if (candidates.length === 0) {
+            return null;
+        }
+        // Sort by confidence desc, then successCount desc
+        candidates.sort((a, b) => {
+            if (b.confidence !== a.confidence) {
+                return b.confidence - a.confidence;
+            }
+            return b.stats.successCount - a.stats.successCount;
+        });
+        return candidates[0];
+    }
+    /**
+     * Load a compiled plan from disk by its registry entry.
+     */
+    loadPlan(entry) {
+        try {
+            const planPath = path.isAbsolute(entry.planPath)
+                ? entry.planPath
+                : path.join(this.basePath, entry.planPath);
+            const raw = fs.readFileSync(planPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update execution stats for a plan and recalculate confidence.
+     */
+    updateStats(planId, success, durationMs) {
+        const entry = this.data.plans.find(p => p.id === planId);
+        if (!entry)
+            return;
+        const stats = entry.stats;
+        stats.totalExecutions++;
+        if (success) {
+            stats.successCount++;
+        }
+        else {
+            stats.failCount++;
+        }
+        // Rolling average for duration
+        if (stats.totalExecutions === 1) {
+            stats.avgDurationMs = durationMs;
+        }
+        else {
+            stats.avgDurationMs = Math.round((stats.avgDurationMs * (stats.totalExecutions - 1) + durationMs) /
+                stats.totalExecutions);
+        }
+        stats.lastUsed = Date.now();
+        // Recalculate confidence as success rate
+        entry.confidence = stats.totalExecutions > 0
+            ? stats.successCount / stats.totalExecutions
+            : 0;
+        this.save();
+    }
+    /**
+     * Register a new compiled plan with the given task pattern.
+     * Saves plan JSON to disk and adds entry to the registry.
+     */
+    registerPlan(plan, pattern) {
+        try {
+            fs.mkdirSync(this.plansDir, { recursive: true });
+        }
+        catch {
+            // Best-effort
+        }
+        const planFilename = `${plan.id}.json`;
+        const planPath = path.join(PLANS_SUBDIR, planFilename);
+        const planFullPath = path.join(this.plansDir, planFilename);
+        try {
+            fs.writeFileSync(planFullPath, JSON.stringify(plan, null, 2));
+        }
+        catch {
+            // Best-effort
+        }
+        // Remove existing entry with same ID (if any)
+        this.data.plans = this.data.plans.filter(p => p.id !== plan.id);
+        const entry = {
+            id: plan.id,
+            pattern,
+            planPath,
+            stats: {
+                totalExecutions: 0,
+                successCount: 0,
+                failCount: 0,
+                avgDurationMs: 0,
+                lastUsed: 0,
+            },
+            confidence: 0.5, // Initial neutral confidence
+            minConfidenceToUse: 0.3,
+        };
+        this.data.plans.push(entry);
+        this.save();
+        return entry;
+    }
+    /**
+     * Get all plan entries.
+     */
+    getEntries() {
+        return this.data.plans;
+    }
+    /**
+     * Get a single plan entry by ID.
+     */
+    getEntry(planId) {
+        return this.data.plans.find(p => p.id === planId) ?? null;
+    }
+}
+exports.PlanRegistry = PlanRegistry;
+// Singleton instance cache
+let _instance = null;
+let _instanceBasePath = null;
+/**
+ * Get a singleton PlanRegistry instance.
+ * Pass basePath to create/replace the singleton with a new base path.
+ */
+function getPlanRegistry(basePath) {
+    const resolvedPath = basePath ?? DEFAULT_BASE_PATH;
+    if (!_instance || _instanceBasePath !== resolvedPath) {
+        _instance = new PlanRegistry(resolvedPath);
+        _instanceBasePath = resolvedPath;
+        _instance.load();
+    }
+    return _instance;
+}
+//# sourceMappingURL=plan-registry.js.map

package/dist/orchestration/plan-registry.js.map

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

package/dist/orchestration/workflow-engine.d.ts

@@ -3,6 +3,7 @@
  * Manages worker lifecycle and result aggregation
  */
 import { OrchestrationState, WorkerState } from './state-manager';
+import { ToolEntry } from '../types/tool-manifest';
 export interface WorkflowStep {
     workerId: string;
     workerName: string;
@@ -147,10 +148,15 @@ export declare class WorkflowEngine {
      * Cleanup workflow resources
      */
     cleanupWorkflow(sessionId: string): Promise<void>;
+    /**
+     * Generate MCP tool documentation from a ToolEntry array.
+     * Groups tools by category and formats each tool with its parameters.
+     */
+    private generateToolDocs;
     /**
      * Generate worker agent prompt for Background Task
      */
-    generateWorkerPrompt(workerId: string, workerName: string, tabId: string, task: string, successCriteria: string): string;
+    generateWorkerPrompt(workerId: string, workerName: string, tabId: string, task: string, successCriteria: string, manifestTools?: ToolEntry[], targetUrl?: string): string;
 }
 export declare function getWorkflowEngine(): WorkflowEngine;
 //# sourceMappingURL=workflow-engine.d.ts.map

package/dist/orchestration/workflow-engine.d.ts.map

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