cross-tool-flow

What problem does it solve?

It eliminates hard-to-maintain, code-based orchestration by letting you define multi-step cross-tool workflows in a reviewable YAML/JSON file and run them through the Dispatcher engine.

Core Features & Use Cases

• Declarative flow authoring: Define ordered steps, context inputs, and template-based parameter wiring using YAML or JSON.
• Multi-tool execution with guardrails: Enforce per-flow tool allowlists, required context schema, and HITL routing so sensitive drafting steps cannot bypass review.
• Operational triggers and runtime controls: Run flows via manual, Telegram command, cron, or webhook triggers with schema validation and max-runtime limits.
• Step dependency wiring: Consume prior step outputs via template variables such as {{step_id.output.field}} with dependency ordering.
• Use Case: Create a “research-and-summarise” workflow where Margot performs research and a Telegram drafting tool posts a reviewed digest to the original chat.

Quick Start

Add a new YAML flow file under Pi-Dev-Ops/flows with the required context_schema, steps, and tool_allowlist, then trigger it via the Dispatcher flow run endpoint using your context values.