@codemcp/workflows 6.3.1 → 6.5.0

package/packages/opencode-plugin/dist/plugin.js

@@ -0,0 +1,395 @@
+/**
+ * OpenCode Workflows Plugin
+ *
+ * Integrates workflows-core state management with OpenCode hooks to provide
+ * phase-aware development guidance and file edit restrictions.
+ *
+ * Hooks implemented:
+ * 1. chat.message - Add synthetic part with phase instructions after each user message
+ * 2. tool.execute.before - Block editing of certain files based on phase
+ * 3. experimental.session.compacting - Inject workflow state into compaction context
+ *
+ * Logs are sent via OpenCode SDK's client.app.log() API
+ */
+import { createProceedToPhaseTool } from './tool-handlers/proceed-to-phase.js';
+import { createConductReviewTool } from './tool-handlers/conduct-review.js';
+import { createResetDevelopmentTool } from './tool-handlers/reset-development.js';
+import { createStartDevelopmentTool } from './tool-handlers/start-development.js';
+import { createSetupProjectDocsTool } from './tool-handlers/setup-project-docs.js';
+import { createOpenCodeLogger, createOpenCodeLoggerFactory, } from './opencode-logger.js';
+import { PlanManager, InstructionGenerator } from '@codemcp/workflows-core';
+import { WhatsNextHandler, } from '@codemcp/workflows-server';
+import { createServerContext, initializeServerContext, } from './server-context.js';
+import { stripWhatsNextReferences } from './utils.js';
+/**
+ * Match a file path against a glob pattern.
+ * Supports patterns like:
+ *   - `**\/*`       → matches everything
+ *   - `**\/*.md`    → matches any .md file in any directory
+ *   - `**\/*.test.ts` → matches test files
+ */
+function matchGlobPattern(filePath, pattern) {
+    // Normalise to forward slashes
+    const normalised = filePath.replace(/\\/g, '/');
+    const baseName = normalised.split('/').pop() ?? '';
+    // `**/*` means "allow everything"
+    if (pattern === '**/*' || pattern === '*') {
+        return true;
+    }
+    // Convert glob pattern to a regex:
+    //   - Escape regex metacharacters except * and .
+    //   - `**/` at the start → match any path prefix (or empty)
+    //   - `**`  elsewhere    → match any sequence of characters incl. /
+    //   - `*`               → match any sequence of characters excl. /
+    //   - `.`               → literal dot
+    const regexSource = pattern
+        .replace(/\\/g, '/')
+        // Escape regex special chars (except * which we handle separately)
+        .replace(/[+?^${}()|[\]]/g, '\\$&')
+        // Literal dot
+        .replace(/\./g, '\\.')
+        // `**/` at the start → optional path prefix
+        .replace(/^\*\*\//, '(?:.+\\/)?')
+        // remaining `**` → any chars including /
+        .replace(/\*\*/g, '.*')
+        // remaining `*` → any chars except /
+        .replace(/\*/g, '[^/]*');
+    const regex = new RegExp(`^${regexSource}$`);
+    // Try matching against full normalised path and against basename
+    return regex.test(normalised) || regex.test(baseName);
+}
+/**
+ * Check if a file edit is allowed based on glob patterns
+ */
+function isFileAllowed(filePath, patterns) {
+    // If allowed patterns includes '**/*' or '*', all files are allowed
+    if (patterns.includes('**/*') || patterns.includes('*')) {
+        return true;
+    }
+    // Check if the file path matches any allowed glob pattern
+    return patterns.some(pattern => matchGlobPattern(filePath, pattern));
+}
+/**
+ * Main plugin export
+ */
+export const WorkflowsPlugin = async (input) => {
+    // Initialize logger using OpenCode SDK
+    const logger = createOpenCodeLogger(input.client);
+    const loggerFactory = createOpenCodeLoggerFactory(input.client);
+    logger.info('Plugin initializing', {
+        directory: input.directory,
+        worktree: input.worktree,
+    });
+    // Initialize workflows enabled state from environment variable
+    const envWorkflows = process.env.WORKFLOWS?.toLowerCase();
+    let workflowsEnabled = envWorkflows === 'off' ? false : true; // default: enabled
+    logger.info('Workflows state initialized', { workflowsEnabled });
+    // Initialize instruction generator
+    const planManager = new PlanManager();
+    const instructionGenerator = new InstructionGenerator();
+    // Cached ServerContext - created once, reused for all requests
+    // This avoids creating new WorkflowManager/PluginRegistry instances per request
+    let cachedServerContext = null;
+    let serverContextInitialized = false;
+    // Buffered instructions from tools (proceed_to_phase, start_development).
+    // Consumed and cleared by the next chat.message hook call.
+    let bufferedInstructions = null;
+    /**
+     * Set buffered instructions from a tool result.
+     * The next chat.message hook will use these instead of calling WhatsNextHandler.
+     */
+    function setBufferedInstructions(result) {
+        bufferedInstructions = {
+            phase: result.phase,
+            instructions: result.instructions,
+            planFilePath: result.plan_file_path,
+            allowedFilePatterns: result.allowed_file_patterns,
+        };
+    }
+    // Helper to get an initialized ServerContext for handler delegation
+    // Creates once, reuses for all subsequent calls
+    async function getServerContext() {
+        if (!cachedServerContext) {
+            cachedServerContext = createServerContext({
+                projectDir: input.directory,
+                planManager,
+                instructionGenerator,
+                loggerFactory,
+            });
+        }
+        if (!serverContextInitialized) {
+            await initializeServerContext(cachedServerContext);
+            serverContextInitialized = true;
+        }
+        return cachedServerContext;
+    }
+    // Log registered plugins at startup (once)
+    getServerContext()
+        .then(context => {
+        const pluginNames = context.pluginRegistry?.getPluginNames() ?? [];
+        if (pluginNames.length > 0) {
+            logger.info('Registered plugins', { plugins: pluginNames });
+        }
+        else {
+            logger.debug('No plugins registered');
+        }
+    })
+        .catch(() => {
+        // Ignore errors during startup plugin check
+    });
+    /**
+     * Read current workflow state from ConversationManager via shared ServerContext.
+     * Returns null if no active conversation exists.
+     */
+    async function getWorkflowState() {
+        try {
+            const serverContext = await getServerContext();
+            const context = await serverContext.conversationManager.getConversationContext();
+            const stateMachine = serverContext.workflowManager.loadWorkflowForProject(context.projectPath, context.workflowName);
+            const phaseState = stateMachine.states[context.currentPhase];
+            return {
+                phase: context.currentPhase,
+                phaseDescription: phaseState?.description ?? null,
+                allowedFilePatterns: phaseState?.allowed_file_patterns ?? ['**/*'],
+                workflowName: context.workflowName,
+            };
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    return {
+        /**
+         * Hook 1: chat.message
+         * Fires after user message is created but before LLM processes it.
+         * We add a synthetic part with phase instructions.
+         */
+        'chat.message': async (hookInput, output) => {
+            // Skip if workflows are disabled
+            if (!workflowsEnabled) {
+                logger.debug('chat.message: Workflows disabled, skipping hook');
+                return;
+            }
+            let result = null;
+            // If a tool (proceed_to_phase / start_development) buffered instructions,
+            // use those — they are authoritative and avoid potential staleness from
+            // re-querying WhatsNextHandler.
+            if (bufferedInstructions) {
+                logger.debug('chat.message: Using buffered instructions from tool call', { phase: bufferedInstructions.phase });
+                result = {
+                    phase: bufferedInstructions.phase,
+                    instructions: bufferedInstructions.instructions,
+                    plan_file_path: bufferedInstructions.planFilePath,
+                    allowed_file_patterns: bufferedInstructions.allowedFilePatterns,
+                };
+                // Consume the buffer — next call will fall through to WhatsNextHandler
+                bufferedInstructions = null;
+            }
+            else {
+                // No buffered instructions — query WhatsNextHandler (reads from disk)
+                try {
+                    const serverContext = await getServerContext();
+                    const handler = new WhatsNextHandler();
+                    const handlerResult = await handler.handle({}, serverContext);
+                    if (!handlerResult.success || !handlerResult.data) {
+                        logger.info('chat.message: No active workflow, injecting start prompt');
+                        output.parts.push({
+                            id: `prt_workflows_${Date.now()}`,
+                            sessionID: hookInput.sessionID,
+                            messageID: hookInput.messageID || output.message.id,
+                            type: 'text',
+                            text: `No Active Workflow Use the \`start_development\` tool to begin.`,
+                        });
+                        return;
+                    }
+                    result = handlerResult.data;
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    if (errorMessage.includes('CONVERSATION_NOT_FOUND')) {
+                        logger.info('chat.message: No active workflow, injecting start prompt');
+                        output.parts.push({
+                            id: `prt_workflows_${Date.now()}`,
+                            sessionID: hookInput.sessionID,
+                            messageID: hookInput.messageID || output.message.id,
+                            type: 'text',
+                            text: `No Active Workflow Use the \`start_development\` tool to begin.`,
+                        });
+                        return;
+                    }
+                    logger.error('chat.message: Error delegating to WhatsNextHandler', {
+                        error: errorMessage,
+                    });
+                    return;
+                }
+            }
+            logger.info('chat.message hook fired', {
+                sessionID: hookInput.sessionID,
+                phase: result.phase,
+            });
+            // Strip whats_next() references — plugin auto-injects instructions
+            const instructionText = stripWhatsNextReferences(result.instructions);
+            if (!instructionText.trim()) {
+                logger.info('chat.message: No instructions to inject');
+                return;
+            }
+            output.parts.push({
+                id: `prt_workflows_${Date.now()}`,
+                sessionID: hookInput.sessionID,
+                messageID: hookInput.messageID || output.message.id,
+                type: 'text',
+                text: instructionText,
+            });
+            logger.info('chat.message: injected phase instructions', {
+                phase: result.phase,
+                length: instructionText.length,
+                preview: instructionText.slice(0, 300),
+            });
+        },
+        /**
+         * Hook 2: tool.execute.before
+         * Fires before each tool execution. We block disallowed file edits based on phase.
+         */
+        'tool.execute.before': async (hookInput, output) => {
+            // Skip if workflows are disabled
+            if (!workflowsEnabled) {
+                logger.debug('tool.execute.before: Workflows disabled, skipping hook');
+                return;
+            }
+            const editTools = ['edit', 'write', 'patch', 'apply_patch', 'multiedit'];
+            if (!editTools.includes(hookInput.tool)) {
+                return;
+            }
+            // Read current workflow state from ConversationManager
+            const state = await getWorkflowState();
+            if (!state) {
+                // No active workflow — allow all edits
+                return;
+            }
+            logger.debug('tool.execute.before', {
+                tool: hookInput.tool,
+                phase: state.phase,
+            });
+            // Extract file path from tool args
+            const args = output.args;
+            const filePath = String(args?.filePath || args?.path || '');
+            if (!filePath) {
+                logger.warn('Edit tool called without filePath', {
+                    tool: hookInput.tool,
+                });
+                return;
+            }
+            if (!isFileAllowed(filePath, state.allowedFilePatterns)) {
+                const allowedList = state.allowedFilePatterns
+                    .map(p => `  • ${p}`)
+                    .join('\n');
+                const error = `BLOCKED: Cannot edit "${filePath}" in ${state.phase} phase.
+
+Current phase "${state.phase}" only allows editing:
+${allowedList}
+
+ACTION REQUIRED: Use transition_phase tool to move to a phase that allows editing this file type, OR focus on files matching the allowed patterns above.`;
+                logger.error('BLOCKING edit', {
+                    filePath,
+                    phase: state.phase,
+                    allowedPatterns: state.allowedFilePatterns,
+                });
+                throw new Error(error);
+            }
+        },
+        /**
+         * Hook 3: experimental.session.compacting
+         * Fires when session is being compacted. We provide minimal guidance on what
+         * to preserve and instruct the summary to end with phase continuation.
+         */
+        'experimental.session.compacting': async (hookInput, output) => {
+            // Skip if workflows are disabled
+            if (!workflowsEnabled) {
+                logger.debug('experimental.session.compacting: Workflows disabled, skipping hook');
+                return;
+            }
+            logger.debug('experimental.session.compacting hook fired', {
+                sessionID: hookInput.sessionID,
+            });
+            const state = await getWorkflowState();
+            if (!state) {
+                logger.debug('No active workflow - skipping compaction guidance');
+                return;
+            }
+            output.context.push('Preserve: user intents, key decisions, significant changes and the reasoning why they were made. Remove tool calls, intermediate thoughts, and minor details.');
+            output.context.push(`End summary with: "Continue ${state.phase} phase. ${state.phaseDescription || ''}"`);
+            logger.info('Injected compaction guidance', { phase: state.phase });
+        },
+        /**
+         * Hook 4: command.execute.before
+         * Intercept /workflow and /wf commands to toggle workflows enabled state
+         */
+        'command.execute.before': async (hookInput, output) => {
+            const cmd = hookInput.command.toLowerCase();
+            const args = (hookInput.arguments || '').toLowerCase().trim();
+            if (cmd === 'workflow' || cmd === 'wf') {
+                if (args === 'on') {
+                    workflowsEnabled = true;
+                    output.parts.push({
+                        id: `prt_workflows_toggle_${Date.now()}`,
+                        type: 'text',
+                        text: 'Workflows enabled for this session.',
+                    });
+                    logger.info('Workflows toggled via command', { workflowsEnabled });
+                }
+                else if (args === 'off') {
+                    workflowsEnabled = false;
+                    output.parts.push({
+                        id: `prt_workflows_toggle_${Date.now()}`,
+                        type: 'text',
+                        text: 'Workflows disabled for this session. Plugin will not inject instructions or enforce file restrictions.',
+                    });
+                    logger.info('Workflows toggled via command', { workflowsEnabled });
+                }
+                else {
+                    output.parts.push({
+                        id: `prt_workflows_toggle_${Date.now()}`,
+                        type: 'text',
+                        text: `Usage: /workflow on|off or /wf on|off\nCurrent state: ${workflowsEnabled ? 'enabled' : 'disabled'}`,
+                    });
+                }
+            }
+        },
+        /**
+         * Custom tools - matching MCP server tool names for consistency
+         */
+        tool: {
+            /**
+             * Tool: start_development
+             * Starts a new development workflow in the current project
+             */
+            start_development: createStartDevelopmentTool(input.directory, getServerContext, setBufferedInstructions),
+            /**
+             * Tool: proceed_to_phase
+             * Transitions to a new workflow phase
+             */
+            proceed_to_phase: createProceedToPhaseTool(getServerContext, setBufferedInstructions),
+            /**
+             * Tool: conduct_review
+             * Conducts a review before phase transition
+             */
+            conduct_review: createConductReviewTool(getServerContext),
+            /**
+             * Tool: reset_development
+             * Resets the current workflow and starts fresh
+             */
+            reset_development: createResetDevelopmentTool(input.directory, getServerContext),
+            /**
+             * Tool: setup_project_docs
+             * Creates project documentation artifacts
+             */
+            setup_project_docs: await createSetupProjectDocsTool(input.directory, getServerContext),
+        },
+    };
+};
+// Default export for opencode plugin loader
+export default {
+    id: 'workflows',
+    server: WorkflowsPlugin,
+};
+//# sourceMappingURL=plugin.js.map

package/packages/opencode-plugin/dist/plugin.js.map

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

package/packages/opencode-plugin/dist/server-context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ServerContext Builder for OpenCode Plugin
+ *
+ * Creates a ServerContext compatible with MCP server handlers,
+ * allowing the plugin to delegate to handler implementations.
+ */
+import type { ServerContext, HandlerResult } from '@codemcp/workflows-server';
+export type { ServerContext } from '@codemcp/workflows-server';
+import { type IPlanManager, type IInstructionGenerator, type LoggerFactory } from '@codemcp/workflows-core';
+export interface ServerContextOptions {
+    projectDir: string;
+    planManager: IPlanManager;
+    instructionGenerator: IInstructionGenerator;
+    /** Optional logger factory - if provided, handlers will use this instead of global createLogger */
+    loggerFactory?: LoggerFactory;
+}
+/**
+ * Creates a ServerContext that can be passed to MCP server handlers.
+ *
+ * The handlers expect certain components to be initialized and wired together.
+ * This function creates fresh instances for each request to ensure clean state.
+ */
+export declare function createServerContext(options: ServerContextOptions): ServerContext;
+/**
+ * Initialize async components of a ServerContext.
+ * Call this before using the context with handlers.
+ *
+ * Note: Workflow loading is done in createServerContext(), not here.
+ */
+export declare function initializeServerContext(context: ServerContext): Promise<void>;
+/**
+ * Convert MCP handler errors to user-friendly instructions.
+ * Returns null if the result is successful and has data.
+ */
+export declare function handleMcpError<T>(result: HandlerResult<T>): string | null;
+/**
+ * Unwrap MCP handler result data after error check.
+ * Call this only after handleMcpError returns null.
+ */
+export declare function unwrapResult<T>(result: HandlerResult<T>): T;

package/packages/opencode-plugin/dist/server-context.js

@@ -0,0 +1,96 @@
+/**
+ * ServerContext Builder for OpenCode Plugin
+ *
+ * Creates a ServerContext compatible with MCP server handlers,
+ * allowing the plugin to delegate to handler implementations.
+ */
+import { PluginRegistry, BeadsPlugin } from '@codemcp/workflows-server';
+import { ConversationManager, TransitionEngine, WorkflowManager, FileStorage, InteractionLogger, } from '@codemcp/workflows-core';
+import * as path from 'node:path';
+/**
+ * Creates a ServerContext that can be passed to MCP server handlers.
+ *
+ * The handlers expect certain components to be initialized and wired together.
+ * This function creates fresh instances for each request to ensure clean state.
+ */
+export function createServerContext(options) {
+    const { projectDir, planManager, instructionGenerator, loggerFactory } = options;
+    // Create workflow manager and load project workflows
+    const workflowManager = new WorkflowManager();
+    workflowManager.loadProjectWorkflows(projectDir);
+    // Create file storage — shared across ConversationManager and InteractionLogger
+    // so both operate on the same underlying persistence instance
+    const fileStorage = new FileStorage(path.join(projectDir, '.vibe', 'storage'));
+    const conversationManager = new ConversationManager(fileStorage, workflowManager, projectDir);
+    // InteractionLogger uses the same fileStorage so hasInteractions() works correctly.
+    // Without this, isFirstCallFromInitialState() always returns true on session resume,
+    // causing WhatsNextHandler to reset the phase to explore on every plugin load.
+    const interactionLogger = new InteractionLogger(fileStorage);
+    // Create transition engine
+    const transitionEngine = new TransitionEngine(projectDir);
+    transitionEngine.setConversationManager(conversationManager);
+    // Initialize plugin registry and register BeadsPlugin
+    // (PluginRegistry.registerPlugin checks isEnabled() internally)
+    // Pass loggerFactory so BeadsPlugin logs go through OpenCode SDK
+    const pluginRegistry = new PluginRegistry();
+    pluginRegistry.registerPlugin(new BeadsPlugin({ projectPath: projectDir, loggerFactory }));
+    return {
+        conversationManager,
+        transitionEngine,
+        planManager,
+        instructionGenerator,
+        workflowManager,
+        interactionLogger,
+        projectPath: projectDir,
+        pluginRegistry,
+        loggerFactory,
+    };
+}
+/**
+ * Initialize async components of a ServerContext.
+ * Call this before using the context with handlers.
+ *
+ * Note: Workflow loading is done in createServerContext(), not here.
+ */
+export async function initializeServerContext(context) {
+    // Initialize the file storage that the context's ConversationManager uses.
+    // initialize() creates the conversations directory if it doesn't exist.
+    // We access it via the conversationManager's database — but since it's not
+    // exposed, we create a fresh instance pointing to the same path and initialize it.
+    const fileStorage = new FileStorage(path.join(context.projectPath, '.vibe', 'storage'));
+    await fileStorage.initialize();
+}
+/**
+ * Convert MCP handler errors to user-friendly instructions.
+ * Returns null if the result is successful and has data.
+ */
+export function handleMcpError(result) {
+    if (result.success && result.data) {
+        return null;
+    }
+    const error = result.error || 'Unknown error';
+    // Extract actionable message from known error patterns
+    if (error.includes('CONVERSATION_NOT_FOUND')) {
+        return 'No active workflow. Use `start_workflow` to begin.';
+    }
+    if (error.includes('Invalid workflow:')) {
+        // Error already contains available workflows list
+        return error.replace(/^.*?Invalid workflow:/, 'Invalid workflow:');
+    }
+    if (error.includes('Available workflows:')) {
+        return error;
+    }
+    // Generic error - return as instruction
+    return `Error: ${error}`;
+}
+/**
+ * Unwrap MCP handler result data after error check.
+ * Call this only after handleMcpError returns null.
+ */
+export function unwrapResult(result) {
+    if (!result.data) {
+        throw new Error('No data in result');
+    }
+    return result.data;
+}
+//# sourceMappingURL=server-context.js.map

package/packages/opencode-plugin/dist/server-context.js.map

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

package/packages/opencode-plugin/dist/tool-handlers/conduct-review.d.ts

@@ -0,0 +1,3 @@
+import { type ServerContext } from '@codemcp/workflows-server';
+import type { ToolDefinition } from '../types.js';
+export declare function createConductReviewTool(getServerContext: () => Promise<ServerContext>): ToolDefinition;

package/packages/opencode-plugin/dist/tool-handlers/conduct-review.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { ConductReviewHandler, } from '@codemcp/workflows-server';
+import { tool } from './tool-helper.js';
+import { handleMcpError, unwrapResult } from '../server-context.js';
+import { createLogger } from '@codemcp/workflows-core';
+export function createConductReviewTool(getServerContext) {
+    return tool({
+        description: 'Conduct a review before phase transition. Args: target_phase',
+        args: {
+            target_phase: z.string().describe('Target phase after review'),
+        },
+        execute: async (args) => {
+            const { target_phase } = args;
+            const serverContext = await getServerContext();
+            const logger = serverContext.loggerFactory
+                ? serverContext.loggerFactory('conduct_review')
+                : createLogger('conduct_review');
+            logger.debug('conduct_review called', { targetPhase: target_phase });
+            try {
+                // Delegate to ConductReviewHandler
+                const handler = new ConductReviewHandler();
+                const result = await handler.handle({ target_phase }, serverContext);
+                // Handle errors gracefully
+                const errorMsg = handleMcpError(result);
+                if (errorMsg) {
+                    return errorMsg;
+                }
+                return unwrapResult(result).instructions;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return `Error: ${errorMessage}`;
+            }
+        },
+    });
+}
+//# sourceMappingURL=conduct-review.js.map

package/packages/opencode-plugin/dist/tool-handlers/conduct-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conduct-review.js","sourceRoot":"","sources":["../../src/tool-handlers/conduct-review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,uBAAuB,CACrC,gBAA8C;IAE9C,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,8DAA8D;QAC3E,IAAI,EAAE;YACJ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SAC/D;QACD,OAAO,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACpB,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;YAC9B,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;YAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,aAAa;gBACxC,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,gBAAgB,CAAC;gBAC/C,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;YAEnC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;YAErE,IAAI,CAAC;gBACH,mCAAmC;gBACnC,MAAM,OAAO,GAAG,IAAI,oBAAoB,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;gBAErE,2BAA2B;gBAC3B,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;gBACxC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,QAAQ,CAAC;gBAClB,CAAC;gBAED,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,OAAO,UAAU,YAAY,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/packages/opencode-plugin/dist/tool-handlers/proceed-to-phase.d.ts

@@ -0,0 +1,3 @@
+import { type ServerContext, type WhatsNextResult } from '@codemcp/workflows-server';
+import type { ToolDefinition } from '../types.js';
+export declare function createProceedToPhaseTool(getServerContext: () => Promise<ServerContext>, setBufferedInstructions: (result: WhatsNextResult) => void): ToolDefinition;