feat: Add agent field to workflow steps for OpenCode --agent flag #47
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Enables workflow step definitions to specify which OpenCode agent configuration to use via the --agent flag. The infrastructure for --agent was already in place in the OpenCode executor layer, this change plumbs it through from workflows. Changes: - Add agent?: string to ModuleStep (workflow step config) - Add agent?: string to EngineRunOptions (engine interface) - Add agent?: string to ExecuteAgentOptions (runner interface) - Pass step.agent through executeStep() -> executeAgent() -> engine.run() The agent name flows: workflow.js step.agent -> executeStep() -> executeAgent() -> engine.run() -> runOpenCode() -> buildOpenCodeRunCommand() -> 'opencode run --agent <name>'
Adds server lifecycle management to enable workflow steps to share a single OpenCode server instance, avoiding MCP cold boot times between steps. New features: - startOpenCodeServer() - starts server on random port with health polling - attachToExternalServer() - connects to existing external server - checkServerHealth() / listServerAgents() - server introspection - --attach flag for opencode run command - --opencode-server / --opencode-attach CLI flags for codemachine start - Automatic server lifecycle in workflow execution (start, inject URLs, cleanup) Integration tests included for command building, server lifecycle, and external server attachment.
- Add project-first template resolution: check .codemachine/ before package templates - Support inline prompt field as alternative to promptPath in workflow steps - Fix empty memory content crashes in runner and trigger modules - Update ModuleStep type to make promptPath optional when prompt is provided - Update validator to accept either promptPath or prompt field
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR enhances OpenCode integration in CodeMachine with two major features:
1. Agent Field for Workflow Steps
Adds
agentfield to workflow step configuration, enabling steps to specify which OpenCode agent to use via the--agentflag.2. Consolidated Server Mode (Experimental)
Enables workflow steps to share a single OpenCode server instance, avoiding MCP cold boot times between steps.
New capabilities:
startOpenCodeServer()- starts server on random port with health pollingattachToExternalServer()- connects to existing external servercheckServerHealth()/listServerAgents()- server introspection--attachflag foropencode runcommand--opencode-server/--opencode-attachCLI flags forcodemachine startCLI Usage:
Files Changed
src/workflows/templates/types.tsagent,attach,opencodeServer,opencodeAttachfieldssrc/infra/engines/core/types.tsagent,attachtoEngineRunOptionssrc/agents/runner/runner.tsagent,attachtoExecuteAgentOptionssrc/infra/engines/providers/opencode/execution/server.tssrc/infra/engines/providers/opencode/execution/commands.tsattachoption,buildOpenCodeServeCommand()src/infra/engines/providers/opencode/execution/runner.tsattachoption passthroughsrc/workflows/execution/step.tsagentandattachtoexecuteAgent()src/workflows/execution/workflow.tssrc/cli/commands/start.command.ts--opencode-serverand--opencode-attachflagstests/integration/opencode/server.test.tsTesting