@relayflows/core 0.0.1 → 1.0.1

package/dist/builder.js

@@ -0,0 +1,430 @@
+import path from 'node:path';
+import { stringify as stringifyYaml } from 'yaml';
+import { JsonFileWorkflowDb } from './file-db.js';
+import { WorkflowRunner } from './runner.js';
+import { formatDryRunReport } from './dry-run-format.js';
+import { createDefaultEventLogger } from './default-logger.js';
+import { runInCloud } from './cloud-runner.js';
+// ── WorkflowBuilder ─────────────────────────────────────────────────────────
+/**
+ * Fluent builder for constructing workflow configurations programmatically.
+ *
+ * @example
+ * ```typescript
+ * import { workflow } from "@relayflows/core";
+ *
+ * const result = await workflow("my-workflow")
+ *   .pattern("dag")
+ *   .agent("worker", { cli: "claude", role: "Backend engineer" })
+ *   .step("build", { agent: "worker", task: "Build the project" })
+ *   .step("test", { agent: "worker", task: "Run tests", dependsOn: ["build"] })
+ *   .run();
+ * ```
+ */
+export class WorkflowBuilder {
+    _name;
+    _description;
+    _pattern = 'dag';
+    _maxConcurrency;
+    _timeoutMs;
+    _channel;
+    _idleNudge;
+    _paths;
+    _agents = [];
+    _steps = [];
+    _errorHandling;
+    _coordination;
+    _state;
+    _trajectories;
+    _startFrom;
+    _previousRunId;
+    constructor(name) {
+        this._name = name;
+    }
+    /** Set workflow description. */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /** Set swarm pattern (default: "dag"). */
+    pattern(p) {
+        this._pattern = p;
+        return this;
+    }
+    /** Set maximum concurrent agents. */
+    maxConcurrency(n) {
+        this._maxConcurrency = n;
+        return this;
+    }
+    /** Set global timeout in milliseconds. */
+    timeout(ms) {
+        this._timeoutMs = ms;
+        return this;
+    }
+    /** Set the relay channel for agent communication. */
+    channel(ch) {
+        const CHANNEL_RE = /^[a-z0-9][a-z0-9-]*$/;
+        if (!CHANNEL_RE.test(ch)) {
+            throw new Error(`Invalid channel name "${ch}". Channel names must be lowercase alphanumeric and hyphens, starting with a letter or number. ` +
+                `Fix: use .toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '')`);
+        }
+        this._channel = ch;
+        return this;
+    }
+    /** Configure idle agent detection and nudging for interactive agents. */
+    idleNudge(config) {
+        this._idleNudge = config;
+        return this;
+    }
+    /** Set workflow coordination settings (barriers, voting threshold, consensus strategy). */
+    coordination(config) {
+        this._coordination = config;
+        return this;
+    }
+    /** Configure shared workflow state backend settings. */
+    state(config) {
+        this._state = config;
+        return this;
+    }
+    /** Configure trajectory recording, or pass `false` to disable it. */
+    trajectories(config) {
+        this._trajectories = config;
+        return this;
+    }
+    /** Start execution from a specific step, skipping all predecessor steps. */
+    startFrom(stepName) {
+        this._startFrom = stepName;
+        return this;
+    }
+    /** Set the previous run ID whose cached step outputs should be used with startFrom. */
+    previousRunId(id) {
+        this._previousRunId = id;
+        return this;
+    }
+    /**
+     * Declare named paths to additional directories the workflow needs.
+     *
+     * For multi-repo cloud workflows (relay#774, cloud#302), each entry is
+     * tarballed by the CLI at submit time and mounted at
+     * `/home/daytona/workspace/{name}/` in the sandbox. Locally, the runner
+     * resolves `path` relative to the workflow file's parent directory and
+     * agents reference each entry by its declared `name`.
+     *
+     * Calling this is a no-op for the runtime — the runner doesn't need
+     * `paths` to execute steps. The CLI and the cloud bootstrap consume
+     * it. Declaring via the builder keeps single-source-of-truth for tools
+     * that walk the built config (e.g. dashboards, dry-run reports).
+     */
+    paths(paths) {
+        if (!Array.isArray(paths)) {
+            throw new Error('.paths() expects an array of PathDefinition objects');
+        }
+        const seen = new Set();
+        for (const p of paths) {
+            if (!p || typeof p.name !== 'string' || typeof p.path !== 'string') {
+                throw new Error('.paths() entries must each have string `name` and `path` fields');
+            }
+            if (seen.has(p.name)) {
+                throw new Error(`.paths() got duplicate entry name "${p.name}"`);
+            }
+            seen.add(p.name);
+        }
+        this._paths = paths.map((p) => ({ ...p }));
+        return this;
+    }
+    /** Add an agent definition. */
+    agent(name, options) {
+        const def = {
+            name,
+            cli: options.cli,
+        };
+        if (options.role !== undefined)
+            def.role = options.role;
+        if (options.task !== undefined)
+            def.task = options.task;
+        if (options.channels !== undefined)
+            def.channels = options.channels;
+        if (options.preset !== undefined)
+            def.preset = options.preset;
+        if (options.interactive !== undefined)
+            def.interactive = options.interactive;
+        if (options.skills !== undefined)
+            def.skills = options.skills;
+        if (options.model !== undefined ||
+            options.maxTokens !== undefined ||
+            options.timeoutMs !== undefined ||
+            options.retries !== undefined ||
+            options.idleThresholdSecs !== undefined) {
+            def.constraints = {};
+            if (options.model !== undefined)
+                def.constraints.model = options.model;
+            if (options.maxTokens !== undefined)
+                def.constraints.maxTokens = options.maxTokens;
+            if (options.timeoutMs !== undefined)
+                def.constraints.timeoutMs = options.timeoutMs;
+            if (options.retries !== undefined)
+                def.constraints.retries = options.retries;
+            if (options.idleThresholdSecs !== undefined)
+                def.constraints.idleThresholdSecs = options.idleThresholdSecs;
+        }
+        this._agents.push(def);
+        return this;
+    }
+    /** Add a workflow step (agent or deterministic). */
+    step(name, options) {
+        const step = { name };
+        if ('type' in options && options.type === 'deterministic') {
+            if (!options.command) {
+                throw new Error('deterministic steps must have a command');
+            }
+            if ('agent' in options || 'task' in options) {
+                throw new Error('deterministic steps must not have agent or task');
+            }
+            step.type = 'deterministic';
+            step.command = options.command;
+            if (options.cwd !== undefined)
+                step.cwd = options.cwd;
+            if (options.captureOutput !== undefined)
+                step.captureOutput = options.captureOutput;
+            if (options.failOnError !== undefined)
+                step.failOnError = options.failOnError;
+            if (options.dependsOn !== undefined)
+                step.dependsOn = options.dependsOn;
+            if (options.verification !== undefined)
+                step.verification = options.verification;
+            if (options.timeoutMs !== undefined)
+                step.timeoutMs = options.timeoutMs;
+        }
+        else if ('type' in options && options.type === 'worktree') {
+            if ('agent' in options || 'task' in options) {
+                throw new Error('worktree steps must not have agent or task');
+            }
+            step.type = 'worktree';
+            step.branch = options.branch;
+            if (options.baseBranch !== undefined)
+                step.baseBranch = options.baseBranch;
+            if (options.path !== undefined)
+                step.path = options.path;
+            if (options.createBranch !== undefined)
+                step.createBranch = options.createBranch;
+            if (options.dependsOn !== undefined)
+                step.dependsOn = options.dependsOn;
+            if (options.timeoutMs !== undefined)
+                step.timeoutMs = options.timeoutMs;
+        }
+        else {
+            // Agent step
+            const agentOpts = options;
+            if (!agentOpts.agent || !agentOpts.task) {
+                throw new Error('Agent steps must have both agent and task');
+            }
+            step.agent = agentOpts.agent;
+            step.task = agentOpts.task;
+            if (agentOpts.cwd !== undefined)
+                step.cwd = agentOpts.cwd;
+            if (agentOpts.dependsOn !== undefined)
+                step.dependsOn = agentOpts.dependsOn;
+            if (agentOpts.verification !== undefined)
+                step.verification = agentOpts.verification;
+            if (agentOpts.timeoutMs !== undefined)
+                step.timeoutMs = agentOpts.timeoutMs;
+            if (agentOpts.retries !== undefined)
+                step.retries = agentOpts.retries;
+        }
+        this._steps.push(step);
+        return this;
+    }
+    /** Set error handling strategy. */
+    onError(strategy, options) {
+        this._errorHandling = { strategy };
+        if (options?.maxRetries !== undefined)
+            this._errorHandling.maxRetries = options.maxRetries;
+        if (options?.retryDelayMs !== undefined)
+            this._errorHandling.retryDelayMs = options.retryDelayMs;
+        if (options?.notifyChannel !== undefined)
+            this._errorHandling.notifyChannel = options.notifyChannel;
+        if (options?.repairAgent !== undefined)
+            this._errorHandling.repairAgent = options.repairAgent;
+        if (options?.repairRetries !== undefined)
+            this._errorHandling.repairRetries = options.repairRetries;
+        return this;
+    }
+    /**
+     * Opt into the product reliability contract: repairable workflow failures get
+     * routed through an agent and retried before the workflow is allowed to fail.
+     */
+    repairable(options = {}) {
+        return this.onError('retry', {
+            maxRetries: options.maxRetries ?? options.repairRetries ?? 2,
+            retryDelayMs: options.retryDelayMs ?? 1000,
+            notifyChannel: options.notifyChannel,
+            repairAgent: options.repairAgent,
+            repairRetries: options.repairRetries ?? options.maxRetries ?? 2,
+        });
+    }
+    /** Alias for `.repairable()` for workflow authors who think in product terms. */
+    reliable(options = {}) {
+        return this.repairable(options);
+    }
+    validateBuilderState() {
+        const hasAgentSteps = this._steps.some((s) => s.type !== 'deterministic' && s.type !== 'worktree');
+        if (hasAgentSteps && this._agents.length === 0) {
+            throw new Error('Workflow must have at least one agent when using agent steps');
+        }
+        if (this._steps.length === 0) {
+            throw new Error('Workflow must have at least one step');
+        }
+        const agentNames = new Set(this._agents.map((agent) => agent.name));
+        for (const step of this._steps) {
+            const diagnosticAgent = step.verification?.diagnosticAgent;
+            if (!diagnosticAgent)
+                continue;
+            if (!agentNames.has(diagnosticAgent)) {
+                throw new Error(`Step "${step.name}" references unknown diagnosticAgent "${diagnosticAgent}"`);
+            }
+            if (step.retries === undefined || step.retries === 0) {
+                console.warn(`Step "${step.name}": diagnosticAgent configured but no retries — diagnostic will never run`);
+            }
+        }
+    }
+    /** Build and return the RelayYamlConfig object. */
+    toConfig() {
+        this.validateBuilderState();
+        const wfDef = {
+            name: `${this._name}-workflow`,
+            steps: [...this._steps],
+        };
+        const config = {
+            version: '1.0',
+            name: this._name,
+            swarm: {
+                pattern: this._pattern,
+            },
+            agents: [...this._agents],
+            workflows: [wfDef],
+        };
+        if (this._description !== undefined)
+            config.description = this._description;
+        if (this._paths !== undefined && this._paths.length > 0) {
+            config.paths = this._paths.map((p) => ({ ...p }));
+        }
+        if (this._maxConcurrency !== undefined)
+            config.swarm.maxConcurrency = this._maxConcurrency;
+        if (this._timeoutMs !== undefined)
+            config.swarm.timeoutMs = this._timeoutMs;
+        if (this._channel !== undefined)
+            config.swarm.channel = this._channel;
+        if (this._idleNudge !== undefined)
+            config.swarm.idleNudge = this._idleNudge;
+        config.errorHandling = this._errorHandling ?? {
+            strategy: 'retry',
+            maxRetries: 2,
+            retryDelayMs: 1000,
+            repairRetries: 2,
+        };
+        if (this._coordination !== undefined)
+            config.coordination = this._coordination;
+        if (this._state !== undefined)
+            config.state = this._state;
+        if (this._trajectories !== undefined)
+            config.trajectories = this._trajectories;
+        return config;
+    }
+    /** Serialize the config to a YAML string. */
+    toYaml() {
+        return stringifyYaml(this.toConfig());
+    }
+    async run(options = {}) {
+        const config = this.toConfig();
+        const runnerCwd = options.cwd ?? process.cwd();
+        const dbPath = path.join(runnerCwd, '.agent-relay', 'workflow-runs.jsonl');
+        const db = new JsonFileWorkflowDb(dbPath);
+        const runner = new WorkflowRunner({
+            cwd: options.cwd,
+            relay: options.relay,
+            executor: options.executor,
+            envSecrets: options.envSecrets,
+            db,
+        });
+        // Auto-detect DRY_RUN env var so existing scripts get dry-run for free
+        const isDryRun = options.dryRun ?? !!process.env.DRY_RUN;
+        if (isDryRun) {
+            const report = runner.dryRun(config, options.workflow, options.vars);
+            console.log(formatDryRunReport(report));
+            return report;
+        }
+        // Cloud execution path — submit to remote API and poll for completion
+        if (options.cloud) {
+            const cloudApiUrl = options.cloudApiUrl ?? process.env.CLOUD_API_URL;
+            const cloudApiToken = options.cloudApiToken ?? process.env.CLOUD_API_TOKEN;
+            if (!cloudApiUrl)
+                throw new Error('cloud: true requires cloudApiUrl or CLOUD_API_URL env var');
+            if (!cloudApiToken)
+                throw new Error('cloud: true requires cloudApiToken or CLOUD_API_TOKEN env var');
+            return runInCloud(config, {
+                cloudApiUrl,
+                cloudApiToken,
+                envSecrets: options.envSecrets,
+                pollIntervalMs: options.cloudPollIntervalMs,
+                timeoutMs: this._timeoutMs,
+                onStatusChange: options.onCloudStatusChange,
+            });
+        }
+        // Wire up default console logger unless explicitly disabled
+        // renderer: "listr" owns the terminal — skip console logger to avoid garbled output
+        // renderer: false implies no output at all
+        const logLevel = options.renderer === 'listr' || options.renderer === false ? false : (options.logLevel ?? 'normal');
+        if (logLevel !== false) {
+            runner.on(createDefaultEventLogger(logLevel));
+        }
+        // Wire up user-provided event handler (additive — does not replace the default logger)
+        if (options.onEvent) {
+            runner.on(options.onEvent);
+        }
+        // Auto-detect RESUME_RUN_ID env var for resuming failed runs
+        const resumeRunId = process.env.RESUME_RUN_ID;
+        const startFrom = this._startFrom ?? options.startFrom ?? process.env.START_FROM;
+        const previousRunId = this._previousRunId ?? options.previousRunId ?? process.env.PREVIOUS_RUN_ID;
+        const executeOptions = startFrom
+            ? { startFrom, previousRunId }
+            : undefined;
+        // If listr renderer requested, wire it up and run concurrently
+        // Must be set up BEFORE the resume check so resume runs also get event output
+        if (options.renderer === 'listr') {
+            const { createWorkflowRenderer } = await import('./listr-renderer.js');
+            const renderer = createWorkflowRenderer();
+            runner.on(renderer.onEvent);
+            const runPromise = resumeRunId
+                ? runner.resume(resumeRunId, options.vars, config)
+                : runner.execute(config, options.workflow, options.vars, executeOptions);
+            try {
+                const [result] = await Promise.all([runPromise, renderer.start()]);
+                return result;
+            }
+            finally {
+                renderer.unmount();
+            }
+        }
+        if (resumeRunId) {
+            return runner.resume(resumeRunId, options.vars, config);
+        }
+        return runner.execute(config, options.workflow, options.vars, executeOptions);
+    }
+}
+// ── Entry point ─────────────────────────────────────────────────────────────
+/**
+ * Create a new workflow builder.
+ *
+ * @example
+ * ```typescript
+ * const result = await workflow("my-task")
+ *   .pattern("fan-out")
+ *   .agent("worker", { cli: "claude" })
+ *   .step("do-work", { agent: "worker", task: "Build the feature" })
+ *   .run();
+ * ```
+ */
+export function workflow(name) {
+    return new WorkflowBuilder(name);
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

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

package/dist/builtin-templates/bug-fix.yaml

@@ -0,0 +1,139 @@
+version: '1.0'
+name: bug-fix
+description: 'Blueprint-style bug investigation and remediation with validation gates.'
+swarm:
+  pattern: hub-spoke
+  maxConcurrency: 2
+  timeoutMs: 2700000
+  channel: swarm-bug-fix
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Coordinates debugging and release decisions'
+    permissions: { access: full }
+  - name: investigator
+    cli: codex
+    role: 'Reproduces and scopes the defect'
+    permissions: { access: readonly }
+    interactive: false
+  - name: fixer
+    cli: codex
+    role: 'Implements and tests the fix'
+    permissions: { access: readwrite }
+    interactive: false
+  - name: verifier
+    cli: claude
+    role: 'Validates risk, regressions, and completion'
+    permissions: { access: readonly }
+workflows:
+  - name: bug-remediation
+    description: 'Investigate root cause, patch safely, and verify no regressions.'
+    onError: retry
+    preflight:
+      - command: git status --porcelain
+        failIf: non-empty
+        description: 'Ensure working directory is clean'
+      - command: npm test 2>/dev/null || echo "baseline"
+        description: 'Capture baseline test state'
+    steps:
+      # Agent: Investigate root cause
+      - name: investigate
+        type: agent
+        agent: investigator
+        task: |
+          Reproduce the issue, identify root cause, and provide a fix strategy:
+          {{task}}
+        verification:
+          type: output_contains
+          value: ROOT_CAUSE_IDENTIFIED
+
+      # Deterministic: Create fix branch
+      - name: create-branch
+        type: deterministic
+        dependsOn: [investigate]
+        command: git checkout -b fix/{{branch-name}}
+
+      # Agent: Implement the fix
+      - name: patch
+        type: agent
+        agent: fixer
+        dependsOn: [create-branch]
+        task: |
+          Implement the fix based on the investigation report:
+          {{steps.investigate.output}}
+        retries: 2
+        verification:
+          type: output_contains
+          value: PATCH_APPLIED
+
+      # Deterministic: Run tests
+      - name: test
+        type: deterministic
+        dependsOn: [patch]
+        command: npm test
+
+      # Agent: Fix test failures if any (with iteration limit)
+      - name: fix-if-broken
+        type: agent
+        agent: fixer
+        dependsOn: [test]
+        task: |
+          Review test results. If tests failed, fix them. If all passed, output TESTS_PASSED.
+          Test output: {{steps.test.output}}
+        maxIterations: 2
+        verification:
+          type: output_contains
+          value: TESTS_PASSED
+
+      # Deterministic: Commit
+      - name: commit
+        type: deterministic
+        dependsOn: [fix-if-broken]
+        command: 'git add -A && git commit -m "fix: {{steps.investigate.output | first-line}}"'
+
+      # Agent: Verify no regressions
+      - name: regression-check
+        type: agent
+        agent: verifier
+        dependsOn: [commit]
+        task: |
+          Validate the patch for correctness and regression risk:
+          {{steps.patch.output}}
+        verification:
+          type: output_contains
+          value: VERIFICATION_COMPLETE
+
+      # Deterministic: Push to remote
+      - name: push
+        type: deterministic
+        dependsOn: [regression-check]
+        command: git push origin fix/{{branch-name}}
+
+      # Agent: Closeout
+      - name: closeout
+        type: agent
+        agent: lead
+        dependsOn: [push]
+        task: |
+          Prepare final incident summary, residual risk, and deployment notes.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: fix-ready
+      waitFor: [investigate, patch, regression-check]
+      timeoutMs: 600000
+state:
+  backend: memory
+  ttlMs: 43200000
+  namespace: bug-fix
+errorHandling:
+  strategy: retry
+  maxRetries: 3
+  retryDelayMs: 3000
+  notifyChannel: swarm-bug-fix