monomind 1.19.0 → 2.0.1

package/packages/@monomind/cli/dist/src/mcp-tools/workflow-tools.js

@@ -1,717 +0,0 @@
-/**
- * Workflow MCP Tools for CLI
- *
- * Tool definitions for workflow automation and orchestration.
- */
-import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { randomBytes } from 'node:crypto';
-import { getProjectCwd } from './types.js';
-const MAX_WORKFLOW_STORE_BYTES = 50 * 1024 * 1024; // 50 MB
-// Storage paths
-const STORAGE_DIR = '.monomind';
-const WORKFLOW_DIR = 'workflows';
-const WORKFLOW_FILE = 'store.json';
-function getWorkflowDir() {
-    return join(getProjectCwd(), STORAGE_DIR, WORKFLOW_DIR);
-}
-function getWorkflowPath() {
-    return join(getWorkflowDir(), WORKFLOW_FILE);
-}
-function ensureWorkflowDir() {
-    const dir = getWorkflowDir();
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-}
-function loadWorkflowStore() {
-    try {
-        const path = getWorkflowPath();
-        if (existsSync(path)) {
-            if (statSync(path).size > MAX_WORKFLOW_STORE_BYTES) {
-                return { workflows: {}, templates: {}, version: '3.0.0' };
-            }
-            const data = readFileSync(path, 'utf-8');
-            return JSON.parse(data);
-        }
-    }
-    catch {
-        // Return default store on error
-    }
-    return { workflows: {}, templates: {}, version: '3.0.0' };
-}
-function saveWorkflowStore(store) {
-    // Cap completed/failed/cancelled workflows so the file doesn't grow without
-    // bound. Each save serializes the entire store to disk; without eviction
-    // a long-running daemon would blow up to GBs of JSON.
-    const MAX_WORKFLOWS = 500;
-    const MAX_TEMPLATES = 200;
-    const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
-    const finished = Object.entries(store.workflows ?? {})
-        .filter(([, w]) => TERMINAL.has(w.status ?? ''))
-        .sort(([, a], [, b]) => {
-        const aw = a;
-        const bw = b;
-        return (aw.completedAt ?? aw.createdAt ?? '').localeCompare(bw.completedAt ?? bw.createdAt ?? '');
-    });
-    if (finished.length > MAX_WORKFLOWS) {
-        for (const [id] of finished.slice(0, finished.length - MAX_WORKFLOWS)) {
-            delete store.workflows[id];
-        }
-    }
-    const templates = Object.keys(store.templates ?? {});
-    if (templates.length > MAX_TEMPLATES) {
-        for (const id of templates.slice(0, templates.length - MAX_TEMPLATES)) {
-            delete store.templates[id];
-        }
-    }
-    ensureWorkflowDir();
-    const dest = getWorkflowPath();
-    const tmp = `${dest}.${process.pid}.${Date.now()}.tmp`;
-    writeFileSync(tmp, JSON.stringify(store, null, 2), 'utf-8');
-    renameSync(tmp, dest);
-}
-const FORBIDDEN_WORKFLOW_IDS = new Set(['__proto__', 'constructor', 'prototype']);
-export const workflowTools = [
-    {
-        name: 'workflow_run',
-        description: 'Create a swarm workflow stage record from a template (feature/bugfix/refactor/security). This tracks multi-agent orchestration stages — it does NOT execute a browser automation playbook. To run a playbook use `playbook_run`.',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                template: { type: 'string', description: 'Template name to run' },
-                file: { type: 'string', description: 'Workflow file path' },
-                task: { type: 'string', description: 'Task description' },
-                options: {
-                    type: 'object',
-                    description: 'Workflow options',
-                    properties: {
-                        parallel: { type: 'boolean', description: 'Run stages in parallel' },
-                        maxAgents: { type: 'number', description: 'Maximum agents to use' },
-                        timeout: { type: 'number', description: 'Timeout in seconds' },
-                        dryRun: { type: 'boolean', description: 'Validate without executing' },
-                    },
-                },
-            },
-        },
-        handler: async (input) => {
-            const store = loadWorkflowStore();
-            const template = input.template;
-            // Cap task description to prevent DoS via unbounded string stored in
-            // workflow record and serialised to disk.
-            const MAX_WORKFLOW_TASK_LEN = 16 * 1024;
-            const rawTask = input.task;
-            const task = typeof rawTask === 'string' && rawTask.length > MAX_WORKFLOW_TASK_LEN
-                ? rawTask.slice(0, MAX_WORKFLOW_TASK_LEN) : rawTask;
-            const options = input.options || {};
-            const dryRun = options.dryRun;
-            // Build workflow from template or inline
-            const workflowId = `workflow-${Date.now()}-${randomBytes(6).toString('hex')}`;
-            const stages = [];
-            // Generate stages based on template
-            const templateName = template || 'custom';
-            const stageNames = (() => {
-                switch (templateName) {
-                    case 'feature':
-                        return ['Research', 'Design', 'Implement', 'Test', 'Review'];
-                    case 'bugfix':
-                        return ['Investigate', 'Fix', 'Test', 'Review'];
-                    case 'refactor':
-                        return ['Analyze', 'Refactor', 'Test', 'Review'];
-                    case 'security':
-                        return ['Scan', 'Analyze', 'Report'];
-                    default:
-                        return ['Execute'];
-                }
-            })();
-            for (const name of stageNames) {
-                stages.push({
-                    name,
-                    status: dryRun ? 'validated' : 'pending',
-                    agents: [],
-                });
-            }
-            if (!dryRun) {
-                // Create and save the workflow
-                const steps = stageNames.map((name, i) => ({
-                    stepId: `step-${i + 1}`,
-                    name,
-                    type: 'task',
-                    config: { task: task || name },
-                    status: 'pending',
-                }));
-                const workflow = {
-                    workflowId,
-                    name: task || `${templateName} workflow`,
-                    description: task,
-                    steps,
-                    status: 'running',
-                    currentStep: 0,
-                    variables: { template: templateName, ...options },
-                    createdAt: new Date().toISOString(),
-                    startedAt: new Date().toISOString(),
-                };
-                store.workflows[workflowId] = workflow;
-                saveWorkflowStore(store);
-            }
-            return {
-                workflowId,
-                template: templateName,
-                status: dryRun ? 'validated' : 'running',
-                stages,
-                metrics: {
-                    totalStages: stages.length,
-                    completedStages: 0,
-                    agentsSpawned: 0,
-                    estimatedDuration: `${stages.length * 30}s`,
-                },
-            };
-        },
-    },
-    {
-        name: 'workflow_create',
-        description: 'Create a new workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Workflow name' },
-                description: { type: 'string', description: 'Workflow description' },
-                steps: {
-                    type: 'array',
-                    description: 'Workflow steps',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            name: { type: 'string' },
-                            type: { type: 'string', enum: ['task', 'condition', 'parallel', 'loop', 'wait'] },
-                            config: { type: 'object' },
-                        },
-                    },
-                },
-                variables: { type: 'object', description: 'Initial variables' },
-            },
-            required: ['name'],
-        },
-        handler: async (input) => {
-            const store = loadWorkflowStore();
-            const workflowId = `workflow-${Date.now()}-${randomBytes(6).toString('hex')}`;
-            // Cap string fields before storing to disk.
-            const MAX_WF_NAME_LEN = 512;
-            const MAX_WF_DESC_LEN = 16 * 1024;
-            const MAX_WF_STEPS = 500;
-            const rawWfName = input.name;
-            const wfName = typeof rawWfName === 'string' && rawWfName.length > MAX_WF_NAME_LEN
-                ? rawWfName.slice(0, MAX_WF_NAME_LEN) : rawWfName;
-            const rawWfDesc = input.description;
-            const wfDesc = typeof rawWfDesc === 'string' && rawWfDesc.length > MAX_WF_DESC_LEN
-                ? rawWfDesc.slice(0, MAX_WF_DESC_LEN) : rawWfDesc;
-            const rawSteps = input.steps || [];
-            const cappedSteps = rawSteps.slice(0, MAX_WF_STEPS);
-            const steps = cappedSteps.map((s, i) => ({
-                stepId: `step-${i + 1}`,
-                name: s.name || `Step ${i + 1}`,
-                type: s.type || 'task',
-                config: s.config || {},
-                status: 'pending',
-            }));
-            const workflow = {
-                workflowId,
-                name: wfName,
-                description: wfDesc,
-                steps,
-                status: steps.length > 0 ? 'ready' : 'draft',
-                currentStep: 0,
-                variables: input.variables || {},
-                createdAt: new Date().toISOString(),
-            };
-            store.workflows[workflowId] = workflow;
-            saveWorkflowStore(store);
-            return {
-                workflowId,
-                name: workflow.name,
-                status: workflow.status,
-                stepCount: steps.length,
-                createdAt: workflow.createdAt,
-            };
-        },
-    },
-    {
-        name: 'workflow_execute',
-        description: 'Execute a workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID to execute' },
-                variables: { type: 'object', description: 'Runtime variables to inject' },
-                startFromStep: { type: 'number', description: 'Step to start from (0-indexed)' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            // Object.hasOwn defends against bracket-access into Object.prototype
-            // members (toString, hasOwnProperty, etc.) — the FORBIDDEN_WORKFLOW_IDS
-            // blocklist alone misses these inherited names.
-            const workflow = Object.hasOwn(store.workflows, workflowId)
-                ? store.workflows[workflowId]
-                : undefined;
-            if (!workflow) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            if (workflow.status === 'running') {
-                return { workflowId, error: 'Workflow already running' };
-            }
-            // Inject runtime variables
-            if (input.variables) {
-                workflow.variables = { ...workflow.variables, ...input.variables };
-            }
-            workflow.status = 'running';
-            workflow.startedAt = new Date().toISOString();
-            workflow.currentStep = input.startFromStep || 0;
-            // Set steps to pending — actual execution requires agent assignment via task tools
-            const results = [];
-            for (let i = workflow.currentStep; i < workflow.steps.length; i++) {
-                const step = workflow.steps[i];
-                step.status = 'pending';
-                results.push({
-                    stepId: step.stepId,
-                    status: step.status,
-                    _note: 'Workflow execution tracks state. Actual step execution requires agent assignment via task tools.',
-                });
-            }
-            saveWorkflowStore(store);
-            return {
-                workflowId,
-                status: workflow.status,
-                totalSteps: results.length,
-                results,
-                startedAt: workflow.startedAt,
-                _note: 'Workflow is now running. Steps are in pending state and must be executed via task tools.',
-            };
-        },
-    },
-    {
-        name: 'workflow_status',
-        description: 'Get workflow status',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID' },
-                verbose: { type: 'boolean', description: 'Include step details' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            const workflow = Object.hasOwn(store.workflows, workflowId) ? store.workflows[workflowId] : undefined;
-            if (!workflow) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const completedSteps = workflow.steps.filter(s => s.status === 'completed').length;
-            const progress = workflow.steps.length > 0 ? (completedSteps / workflow.steps.length) * 100 : 0;
-            const status = {
-                workflowId: workflow.workflowId,
-                name: workflow.name,
-                status: workflow.status,
-                progress,
-                currentStep: workflow.currentStep,
-                totalSteps: workflow.steps.length,
-                completedSteps,
-                createdAt: workflow.createdAt,
-                startedAt: workflow.startedAt,
-                completedAt: workflow.completedAt,
-            };
-            if (input.verbose) {
-                return {
-                    ...status,
-                    description: workflow.description,
-                    variables: workflow.variables,
-                    steps: workflow.steps.map(s => ({
-                        stepId: s.stepId,
-                        name: s.name,
-                        type: s.type,
-                        status: s.status,
-                        startedAt: s.startedAt,
-                        completedAt: s.completedAt,
-                    })),
-                    error: workflow.error,
-                };
-            }
-            return status;
-        },
-    },
-    {
-        name: 'workflow_list',
-        description: 'List all workflows',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                status: { type: 'string', description: 'Filter by status' },
-                limit: { type: 'number', description: 'Max workflows to return' },
-            },
-        },
-        handler: async (input) => {
-            const store = loadWorkflowStore();
-            let workflows = Object.values(store.workflows);
-            // Apply filters
-            if (input.status) {
-                workflows = workflows.filter(w => w.status === input.status);
-            }
-            // Sort by creation date (newest first)
-            workflows.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
-            // Apply limit — cap to 1 000 to prevent returning the full (potentially
-            // large) in-memory workflow store in one response, which could cause OOM
-            // or excessive serialisation latency.
-            const MAX_WORKFLOW_LIMIT = 1_000;
-            const rawLimit = typeof input.limit === 'number' ? input.limit : 20;
-            const limit = Number.isFinite(rawLimit) && rawLimit > 0
-                ? Math.min(Math.floor(rawLimit), MAX_WORKFLOW_LIMIT)
-                : 20;
-            const totalCount = workflows.length;
-            workflows = workflows.slice(0, limit);
-            return {
-                workflows: workflows.map(w => ({
-                    workflowId: w.workflowId,
-                    name: w.name,
-                    status: w.status,
-                    stepCount: w.steps.length,
-                    createdAt: w.createdAt,
-                    completedAt: w.completedAt,
-                })),
-                total: totalCount,
-                filters: { status: input.status },
-            };
-        },
-    },
-    {
-        name: 'workflow_pause',
-        description: 'Pause a running workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            const workflow = Object.hasOwn(store.workflows, workflowId) ? store.workflows[workflowId] : undefined;
-            if (!workflow) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            if (workflow.status !== 'running') {
-                return { workflowId, error: 'Workflow not running' };
-            }
-            workflow.status = 'paused';
-            saveWorkflowStore(store);
-            return {
-                workflowId,
-                status: workflow.status,
-                pausedAt: new Date().toISOString(),
-                currentStep: workflow.currentStep,
-            };
-        },
-    },
-    {
-        name: 'workflow_resume',
-        description: 'Resume a paused workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            const workflow = Object.hasOwn(store.workflows, workflowId) ? store.workflows[workflowId] : undefined;
-            if (!workflow) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            if (workflow.status !== 'paused') {
-                return { workflowId, error: 'Workflow not paused' };
-            }
-            workflow.status = 'running';
-            saveWorkflowStore(store);
-            // Report current step states — do not auto-complete them
-            const stepStates = workflow.steps.map(step => ({
-                stepId: step.stepId,
-                name: step.name,
-                status: step.status,
-            }));
-            const remainingSteps = workflow.steps.length - workflow.currentStep;
-            return {
-                workflowId,
-                status: workflow.status,
-                resumed: true,
-                currentStep: workflow.currentStep,
-                remainingSteps,
-                steps: stepStates,
-                _note: 'Workflow resumed. Steps remain in their current state and must be executed via task tools.',
-            };
-        },
-    },
-    {
-        name: 'workflow_cancel',
-        description: 'Cancel a workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID' },
-                reason: { type: 'string', description: 'Cancellation reason' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            const workflow = Object.hasOwn(store.workflows, workflowId)
-                ? store.workflows[workflowId]
-                : undefined;
-            if (!workflow) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            if (workflow.status === 'completed' || workflow.status === 'failed' || workflow.status === 'cancelled') {
-                return { workflowId, error: 'Workflow already finished' };
-            }
-            workflow.status = 'cancelled';
-            workflow.error = input.reason || 'Cancelled by user';
-            workflow.completedAt = new Date().toISOString();
-            // Mark remaining steps as skipped
-            for (let i = workflow.currentStep; i < workflow.steps.length; i++) {
-                workflow.steps[i].status = 'skipped';
-            }
-            saveWorkflowStore(store);
-            return {
-                workflowId,
-                status: workflow.status,
-                cancelledAt: workflow.completedAt,
-                reason: workflow.error,
-                skippedSteps: workflow.steps.length - workflow.currentStep,
-            };
-        },
-    },
-    {
-        name: 'workflow_delete',
-        description: 'Delete a workflow',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: { type: 'string', description: 'Workflow ID' },
-            },
-            required: ['workflowId'],
-        },
-        handler: async (input) => {
-            const workflowId = input.workflowId;
-            if (!workflowId || typeof workflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const store = loadWorkflowStore();
-            if (!Object.hasOwn(store.workflows, workflowId)) {
-                return { workflowId, error: 'Workflow not found' };
-            }
-            const workflow = store.workflows[workflowId];
-            if (workflow.status === 'running') {
-                return { workflowId, error: 'Cannot delete running workflow' };
-            }
-            delete store.workflows[workflowId];
-            saveWorkflowStore(store);
-            return {
-                workflowId,
-                deleted: true,
-                deletedAt: new Date().toISOString(),
-            };
-        },
-    },
-    {
-        name: 'workflow_template',
-        description: 'Save workflow as template or create from template',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                action: { type: 'string', enum: ['save', 'create', 'list'], description: 'Template action' },
-                workflowId: { type: 'string', description: 'Workflow ID (for save)' },
-                templateId: { type: 'string', description: 'Template ID (for create)' },
-                templateName: { type: 'string', description: 'Template name (for save)' },
-                newName: { type: 'string', description: 'New workflow name (for create)' },
-            },
-            required: ['action'],
-        },
-        handler: async (input) => {
-            const store = loadWorkflowStore();
-            const action = input.action;
-            if (action === 'save') {
-                const rawWorkflowId = input.workflowId;
-                if (!rawWorkflowId || typeof rawWorkflowId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(rawWorkflowId) || !Object.hasOwn(store.workflows, rawWorkflowId)) {
-                    return { action, error: 'Workflow not found' };
-                }
-                const workflow = store.workflows[rawWorkflowId];
-                if (!workflow) {
-                    return { action, error: 'Workflow not found' };
-                }
-                const templateId = `template-${Date.now()}-${randomBytes(6).toString('hex')}`;
-                const template = {
-                    ...workflow,
-                    workflowId: templateId,
-                    name: input.templateName || `${workflow.name} Template`,
-                    status: 'draft',
-                    currentStep: 0,
-                    createdAt: new Date().toISOString(),
-                    startedAt: undefined,
-                    completedAt: undefined,
-                };
-                // Reset step statuses
-                template.steps = template.steps.map(s => ({
-                    ...s,
-                    status: 'pending',
-                    result: undefined,
-                    startedAt: undefined,
-                    completedAt: undefined,
-                }));
-                store.templates[templateId] = template;
-                saveWorkflowStore(store);
-                return {
-                    action,
-                    templateId,
-                    name: template.name,
-                    savedAt: new Date().toISOString(),
-                };
-            }
-            if (action === 'create') {
-                const rawTemplateId = input.templateId;
-                if (!rawTemplateId || typeof rawTemplateId !== 'string' || FORBIDDEN_WORKFLOW_IDS.has(rawTemplateId) || !Object.hasOwn(store.templates, rawTemplateId)) {
-                    return { action, error: 'Template not found' };
-                }
-                const template = store.templates[rawTemplateId];
-                if (!template) {
-                    return { action, error: 'Template not found' };
-                }
-                const workflowId = `workflow-${Date.now()}-${randomBytes(6).toString('hex')}`;
-                const workflow = {
-                    ...template,
-                    workflowId,
-                    name: input.newName || template.name.replace(' Template', ''),
-                    status: 'ready',
-                    createdAt: new Date().toISOString(),
-                    steps: template.steps.map(s => ({ ...s, status: 'pending', result: undefined })),
-                    variables: { ...template.variables },
-                };
-                store.workflows[workflowId] = workflow;
-                saveWorkflowStore(store);
-                return {
-                    action,
-                    workflowId,
-                    name: workflow.name,
-                    fromTemplate: input.templateId,
-                    createdAt: workflow.createdAt,
-                };
-            }
-            if (action === 'list') {
-                return {
-                    action,
-                    templates: Object.values(store.templates).map(t => ({
-                        templateId: t.workflowId,
-                        name: t.name,
-                        stepCount: t.steps.length,
-                        createdAt: t.createdAt,
-                    })),
-                    total: Object.keys(store.templates).length,
-                };
-            }
-            return { action, error: 'Unknown action' };
-        },
-    },
-    {
-        name: 'playbook_run',
-        description: 'Run a browser automation playbook (JSON file with browser/service/HTTP nodes) via @monoes/monobrowse. Executes the full playbook engine with all handlers: browser CDP nodes (browser.open, browser.click, etc.), service nodes (gmail, github, google_drive, google_sheets), and builtins (action.http, action.log, action.save_file, action.gemini_image).',
-        category: 'workflow',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                file: { type: 'string', description: 'Absolute or CWD-relative path to a playbook JSON file' },
-                params: {
-                    type: 'object',
-                    description: 'Key/value pairs substituted as {{params.key}} in playbook node configs',
-                    additionalProperties: { type: 'string' },
-                },
-                port: { type: 'number', description: 'CDP port for browser automation (default 9222)' },
-                timeoutSeconds: { type: 'number', description: 'Max run duration in seconds (default 300)' },
-            },
-            required: ['file'],
-        },
-        handler: async (input) => {
-            const filePath = input.file;
-            if (typeof filePath !== 'string' || !filePath)
-                throw new Error('playbook_run: file is required');
-            if (filePath.startsWith('-'))
-                throw new Error('playbook_run: file path must not start with "-"');
-            const { resolve } = await import('node:path');
-            const absPath = resolve(process.cwd(), filePath);
-            const timeoutMs = (input.timeoutSeconds ?? 300) * 1000;
-            const rawParams = input.params ?? {};
-            // Sanitize params — string values only
-            const params = Object.fromEntries(Object.entries(rawParams).map(([k, v]) => [k, String(v)]));
-            const { spawn } = await import('node:child_process');
-            const _args = ['run', '--file', absPath, '--json'];
-            for (const [k, v] of Object.entries(params))
-                _args.push('--param', `${k}=${v}`);
-            const env = { ...process.env };
-            if (input.port !== undefined)
-                env['CDP_PORT'] = String(input.port);
-            const record = await new Promise((resolve) => {
-                const child = spawn('monoes', _args, { env });
-                let stdout = '';
-                let stderr = '';
-                child.stdout?.on('data', (d) => { stdout += d; });
-                child.stderr?.on('data', (d) => { stderr += d; });
-                const _kill = setTimeout(() => { child.kill(); resolve({ status: 'timeout', error: `Timed out after ${timeoutMs}ms` }); }, timeoutMs);
-                child.on('close', (code) => {
-                    clearTimeout(_kill);
-                    if (code === 0) {
-                        try {
-                            resolve({ status: 'complete', output: JSON.parse(stdout) });
-                        }
-                        catch {
-                            resolve({ status: 'complete', output: stdout.trim() });
-                        }
-                    }
-                    else {
-                        resolve({ status: 'failed', error: (stderr.trim() || stdout.trim()) });
-                    }
-                });
-                child.on('error', (e) => { clearTimeout(_kill); resolve({ status: 'failed', error: e.message }); });
-            });
-            return record;
-        },
-    },
-];
-//# sourceMappingURL=workflow-tools.js.map