@relayflows/core 0.0.1 → 1.0.0

package/dist/run-summary-table.js

@@ -0,0 +1,132 @@
+function formatCurrency(value) {
+    return typeof value === 'number' ? `$${value.toFixed(2)}` : '--';
+}
+function formatTokens(report) {
+    if (!report?.tokens)
+        return '--';
+    const total = report.tokens.input + report.tokens.output + report.tokens.cacheRead;
+    return total.toLocaleString('en-US');
+}
+function formatBudgetValue(value) {
+    return typeof value === 'number' ? value.toLocaleString('en-US') : '--';
+}
+function formatBudget(status) {
+    if (!status)
+        return '--';
+    const rendered = `${formatBudgetValue(status.used)}/${formatBudgetValue(status.limit)}`;
+    return status.over ? `${rendered} [OVER]` : rendered;
+}
+function formatDuration(durationMs) {
+    if (typeof durationMs !== 'number' || !Number.isFinite(durationMs))
+        return '--';
+    if (durationMs < 1000)
+        return `${durationMs}ms`;
+    const totalSeconds = Math.round(durationMs / 1000);
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+function truncate(value, length) {
+    if (value.length <= length)
+        return value;
+    if (length <= 1)
+        return value.slice(0, length);
+    return `${value.slice(0, length - 1)}…`;
+}
+function pad(value, width, align = 'left') {
+    return align === 'right' ? value.padStart(width, ' ') : value.padEnd(width, ' ');
+}
+function formatErrors(outcome, report) {
+    const count = report?.errors.length ?? 0;
+    if (count === 0)
+        return outcome.status === 'failed' && outcome.error ? '1' : '--';
+    if (outcome.status === 'completed')
+        return `${count} (fixed)`;
+    return String(count);
+}
+export function formatRunSummaryTable(outcomes, reports, budgetData) {
+    // Only show the Cost column when at least one report has reliable cost data
+    // (currently only OpenCode populates cost; Claude and Codex return null)
+    const hasCost = Array.from(reports.values()).some((r) => typeof r.cost === 'number' && r.cost > 0);
+    const hasBudget = Boolean(budgetData);
+    const headers = hasCost
+        ? hasBudget
+            ? ['Step', 'Status', 'Model', 'Cost', 'Tokens', 'Budget', 'Duration', 'Errors']
+            : ['Step', 'Status', 'Model', 'Cost', 'Tokens', 'Duration', 'Errors']
+        : hasBudget
+            ? ['Step', 'Status', 'Model', 'Tokens', 'Budget', 'Duration', 'Errors']
+            : ['Step', 'Status', 'Model', 'Tokens', 'Duration', 'Errors'];
+    const widths = hasCost
+        ? hasBudget
+            ? [20, 6, 16, 8, 10, 18, 10, 10]
+            : [20, 6, 16, 8, 10, 10, 10]
+        : hasBudget
+            ? [20, 6, 16, 10, 18, 10, 10]
+            : [20, 6, 16, 10, 10, 10];
+    const lines = [];
+    lines.push(headers
+        .map((h, i) => {
+        const align = i <= 2 ? 'left' : 'right';
+        return pad(h, widths[i], align);
+    })
+        .join('  '));
+    let totalCost = 0;
+    let totalTokens = 0;
+    let totalDurationMs = 0;
+    for (const outcome of outcomes) {
+        const report = reports.get(outcome.name);
+        const reportDuration = report?.durationMs ?? outcome.durationMs;
+        const reportTokens = report?.tokens
+            ? report.tokens.input + report.tokens.output + report.tokens.cacheRead
+            : 0;
+        const budgetStatus = budgetData?.steps.get(outcome.name);
+        if (typeof report?.cost === 'number')
+            totalCost += report.cost;
+        totalTokens += reportTokens;
+        if (typeof reportDuration === 'number')
+            totalDurationMs += reportDuration;
+        const cols = [
+            pad(truncate(outcome.name, widths[0]), widths[0]),
+            pad(outcome.status === 'failed' ? 'FAIL' : outcome.status === 'completed' ? 'pass' : 'skip', widths[1]),
+            pad(truncate(report?.model ?? '--', widths[2]), widths[2]),
+        ];
+        if (hasCost)
+            cols.push(pad(formatCurrency(report?.cost), widths[3], 'right'));
+        const tokenIdx = hasCost ? 4 : 3;
+        cols.push(pad(formatTokens(report), widths[tokenIdx], 'right'));
+        if (hasBudget)
+            cols.push(pad(formatBudget(budgetStatus), widths[tokenIdx + 1], 'right'));
+        const durationIdx = hasBudget ? tokenIdx + 2 : tokenIdx + 1;
+        const errorsIdx = hasBudget ? tokenIdx + 3 : tokenIdx + 2;
+        cols.push(pad(formatDuration(reportDuration), widths[durationIdx], 'right'));
+        cols.push(pad(formatErrors(outcome, report), widths[errorsIdx], 'right'));
+        lines.push(cols.join('  '));
+        if (outcome.status === 'failed') {
+            const firstError = report?.errors[0];
+            if (firstError) {
+                lines.push(`  └─ Error [turn ${firstError.turn}] ${truncate(firstError.text, 120)}`);
+            }
+        }
+    }
+    const totalLabelWidth = widths[0] + widths[1] + widths[2] + 4;
+    lines.push('─'.repeat(lines[0].length));
+    const totalCols = [pad('Total', totalLabelWidth)];
+    if (hasCost)
+        totalCols.push(pad(formatCurrency(totalCost), widths[3], 'right'));
+    const tokenIdx = hasCost ? 4 : 3;
+    totalCols.push(pad(totalTokens > 0 ? totalTokens.toLocaleString('en-US') : '--', widths[tokenIdx], 'right'));
+    if (hasBudget) {
+        const workflowBudget = budgetData?.workflow;
+        const budgetTotal = workflowBudget && (workflowBudget.limit !== undefined || workflowBudget.used > 0)
+            ? `${formatBudgetValue(workflowBudget.used)}/${formatBudgetValue(workflowBudget.limit)}`
+            : '--';
+        totalCols.push(pad(budgetTotal, widths[tokenIdx + 1], 'right'));
+    }
+    const durationIdx = hasBudget ? tokenIdx + 2 : tokenIdx + 1;
+    const errorsIdx = hasBudget ? tokenIdx + 3 : tokenIdx + 2;
+    totalCols.push(pad(formatDuration(totalDurationMs), widths[durationIdx], 'right'));
+    totalCols.push(pad('', widths[errorsIdx], 'right'));
+    lines.push(totalCols.join('  '));
+    return lines.map((line) => `  ${line}`).join('\n');
+}
+//# sourceMappingURL=run-summary-table.js.map

package/dist/run-summary-table.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,45 @@
+import type { RuntimeSpawnOptions } from '@agent-relay/harness-driver';
+import type { DryRunReport, TrajectoryConfig, WorkflowRunRow } from './types.js';
+import { type WorkflowEventListener } from './runner.js';
+import type { VariableContext } from './template-resolver.js';
+/**
+ * Options for the `runWorkflow` convenience function.
+ */
+export interface RunWorkflowOptions {
+    /** Workflow name within the YAML file. Defaults to the first workflow. */
+    workflow?: string;
+    /** Template variable substitutions for {{variable}} placeholders. */
+    vars?: VariableContext;
+    /** Working directory. Defaults to process.cwd(). */
+    cwd?: string;
+    /** AgentRelay options (all optional — broker starts automatically). */
+    relay?: RuntimeSpawnOptions;
+    /** Progress callback for workflow events. */
+    onEvent?: WorkflowEventListener;
+    /** Override trajectory config. Set to false to disable trajectory recording. */
+    trajectories?: TrajectoryConfig | false;
+    /** Validate and show execution plan without running. */
+    dryRun?: boolean;
+    /** Resume a failed run by its ID instead of starting fresh. */
+    resume?: string;
+    /** Skip to a specific step (re-uses cached outputs from earlier steps). */
+    startFrom?: string;
+    /** Previous run ID whose cached step outputs are used with startFrom. */
+    previousRunId?: string;
+}
+/**
+ * Run a workflow from a relay.yaml file with zero configuration.
+ *
+ * @example
+ * ```typescript
+ * import { runWorkflow } from "@relayflows/core";
+ *
+ * const result = await runWorkflow("workflows/daytona-migration.yaml");
+ * console.log(result.status); // "completed" | "failed"
+ * ```
+ */
+export declare function runWorkflow(yamlPath: string, options: RunWorkflowOptions & {
+    dryRun: true;
+}): Promise<DryRunReport>;
+export declare function runWorkflow(yamlPath: string, options?: RunWorkflowOptions): Promise<WorkflowRunRow>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,gFAAgF;IAChF,YAAY,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;IACxC,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kBAAkB,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAC7C,OAAO,CAAC,YAAY,CAAC,CAAC;AACzB,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC"}

package/dist/run.js

@@ -0,0 +1,37 @@
+import { WorkflowRunner } from './runner.js';
+import { createDefaultEventLogger } from './default-logger.js';
+import { formatDryRunReport } from './dry-run-format.js';
+export async function runWorkflow(yamlPath, options = {}) {
+    const runner = new WorkflowRunner({
+        cwd: options.cwd,
+        relay: options.relay,
+    });
+    const config = await runner.parseYamlFile(yamlPath);
+    // Allow programmatic trajectory override
+    if (options.trajectories !== undefined) {
+        config.trajectories = options.trajectories;
+    }
+    // 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;
+    }
+    // Attach default console logger so callers get progress output without
+    // needing to wire up their own handler.
+    runner.on(createDefaultEventLogger('normal'));
+    if (options.onEvent) {
+        runner.on(options.onEvent);
+    }
+    // Resume a previous run if requested
+    const resumeRunId = options.resume ?? process.env.RESUME_RUN_ID;
+    if (resumeRunId) {
+        return runner.resume(resumeRunId, options.vars);
+    }
+    const startFrom = options.startFrom ?? process.env.START_FROM;
+    const previousRunId = options.previousRunId ?? process.env.PREVIOUS_RUN_ID;
+    const executeOptions = startFrom ? { startFrom, previousRunId } : undefined;
+    return runner.execute(config, options.workflow, options.vars, executeOptions);
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA6CzD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEpD,yCAAyC;IACzC,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC7C,CAAC;IAED,uEAAuE;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAEzD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE9C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAChE,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAC9D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3E,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5E,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AAChF,CAAC"}