Agent Workflow Builder — node-based procedural sequences bound to agents at hire time
The LLM drives intelligence inside each step; TitanX enforces step ordering, branching, completion criteria, and retry policy between steps.
Opt-in at every level. Agents without a workflow binding behave identically to pre-v2.6.0. Enable in Governance → Security → Agent Workflow Builder (default off).
Highlights
- 15 node handlers —
prompt.*,tool.git.*,sprint.*,condition,parallel.*,human.approve,memory.recall,acp.slash.invoke. - 7 builtin workflows seeded at boot — safe_commit, pr_triage, sprint_standup, lead_qualify, content_brief, research_digest, parallel_review.
- Interactive visual editor at
/agent-workflows— React Flow canvas with drag-to-reposition, drag-to-connect, click-to-edit, undo/redo (Cmd/Ctrl+Z), schema-aware parameter forms with Form/JSON toggle, keyboard delete, node palette, JSON import/export. - Per-turn dispatcher — walks the active-step frontier each turn; graph snapshot at run-start protects in-flight runs from mid-run edits.
- Parallel semantics —
parallel.fan_outspawns branches;parallel.joinwaits for all predecessors before activating. - Human-in-the-loop —
human.approvepauses the run; resume via IPC. - Hire-time binding — slot-level override in the Add Agent modal, supersedes any template
default_workflow_id. - Fleet publishing — master flips "Publish to fleet"; slaves auto-apply on the next config bundle poll.
- Dream Mode integration — every terminal run writes a
[workflow:<canonical>]-prefixed trajectory to reasoningBank;summarizeWorkflowFamilyaggregates into a non-LLM suggestion (LLM distillation prompt coming in v2.6.x). - Pluggable
GitExecutor— subprocess today, swappable with a dedicated git MCP adapter via onesetGitExecutor()call.
Data model
Migration v74 — additive, zero breaking changes:
- Extends
workflow_definitionswith 5 optional metadata columns. - New
workflow_bindings+agent_workflow_runstables. agent_gallery.default_workflow_id.- New
agent_workflowssecurity feature toggle (opt-in).
Tests
47 unit + 19 integration tests. prek matrix clean (TypeScript, Oxlint, Oxfmt, i18n, merge/case/EOF/trailing-ws).
Docs
Full feature guide at docs/feature/agent-workflows/README.md.
Supported platforms in this release
- macOS arm64 (Apple Silicon) — TitanX-2.6.0-mac-arm64.dmg / .zip
- macOS x64 (Intel) — TitanX-2.6.0-mac-x64.dmg / .zip
Windows + Linux builds to follow once the CI runner ABI issues are resolved.
Code signing
Ad-hoc signed (no notarization). On first launch, right-click the app → Open to bypass the Gatekeeper warning.