agent-relay 2.3.4 → 2.3.6

package/packages/sdk-ts/dist/workflows/runner.d.ts

@@ -0,0 +1,119 @@
+/**
+ * WorkflowRunner — parses relay.yaml, validates config, resolves templates,
+ * executes steps (sequential/parallel/DAG), runs verification checks,
+ * persists state to DB, and supports pause/resume/abort with retries.
+ */
+import type { RelayYamlConfig, WorkflowRunRow, WorkflowStepRow } from './types.js';
+import type { AgentRelayOptions } from '../relay.js';
+/** Minimal DB adapter so the runner is not coupled to a specific driver. */
+export interface WorkflowDb {
+    insertRun(run: WorkflowRunRow): Promise<void>;
+    updateRun(id: string, patch: Partial<WorkflowRunRow>): Promise<void>;
+    getRun(id: string): Promise<WorkflowRunRow | null>;
+    insertStep(step: WorkflowStepRow): Promise<void>;
+    updateStep(id: string, patch: Partial<WorkflowStepRow>): Promise<void>;
+    getStepsByRunId(runId: string): Promise<WorkflowStepRow[]>;
+}
+export type WorkflowEvent = {
+    type: 'run:started';
+    runId: string;
+} | {
+    type: 'run:completed';
+    runId: string;
+} | {
+    type: 'run:failed';
+    runId: string;
+    error: string;
+} | {
+    type: 'run:cancelled';
+    runId: string;
+} | {
+    type: 'step:started';
+    runId: string;
+    stepName: string;
+} | {
+    type: 'step:completed';
+    runId: string;
+    stepName: string;
+    output?: string;
+} | {
+    type: 'step:failed';
+    runId: string;
+    stepName: string;
+    error: string;
+} | {
+    type: 'step:skipped';
+    runId: string;
+    stepName: string;
+} | {
+    type: 'step:retrying';
+    runId: string;
+    stepName: string;
+    attempt: number;
+};
+export type WorkflowEventListener = (event: WorkflowEvent) => void;
+export interface WorkflowRunnerOptions {
+    db?: WorkflowDb;
+    workspaceId?: string;
+    relay?: AgentRelayOptions;
+    cwd?: string;
+    summaryDir?: string;
+}
+export interface VariableContext {
+    [key: string]: string | number | boolean | undefined;
+}
+export declare class WorkflowRunner {
+    private readonly db;
+    private readonly workspaceId;
+    private readonly relayOptions;
+    private readonly cwd;
+    private readonly summaryDir;
+    private relay?;
+    private abortController?;
+    private paused;
+    private pauseResolver?;
+    private listeners;
+    constructor(options?: WorkflowRunnerOptions);
+    on(listener: WorkflowEventListener): () => void;
+    private emit;
+    /** Parse a relay.yaml file from disk. */
+    parseYamlFile(filePath: string): Promise<RelayYamlConfig>;
+    /** Parse a relay.yaml string. */
+    parseYamlString(raw: string, source?: string): RelayYamlConfig;
+    /** Validate a config object against the RelayYamlConfig shape. */
+    validateConfig(config: unknown, source?: string): asserts config is RelayYamlConfig;
+    private validateWorkflow;
+    private detectCycles;
+    /** Resolve {{variable}} placeholders in all task strings. */
+    resolveVariables(config: RelayYamlConfig, vars: VariableContext): RelayYamlConfig;
+    private interpolate;
+    private resolveDotPath;
+    /** Build a nested context from completed step outputs for {{steps.X.output}} resolution. */
+    private buildStepOutputContext;
+    /** Interpolate step-output variables, silently skipping unresolved ones (they may be user vars). */
+    private interpolateStepTask;
+    /** Execute a named workflow from a validated config. */
+    execute(config: RelayYamlConfig, workflowName?: string, vars?: VariableContext): Promise<WorkflowRunRow>;
+    /** Resume a previously paused or partially completed run. */
+    resume(runId: string, vars?: VariableContext): Promise<WorkflowRunRow>;
+    /** Pause execution. Currently-running steps will finish but no new steps start. */
+    pause(): void;
+    /** Resume after a pause(). */
+    unpause(): void;
+    /** Abort the current run. Running agents are released. */
+    abort(): void;
+    private executeSteps;
+    private findReadySteps;
+    private executeStep;
+    private spawnAndWait;
+    private runVerification;
+    private updateRunStatus;
+    private markStepFailed;
+    private markDownstreamSkipped;
+    private checkAborted;
+    private waitIfPaused;
+    private delay;
+    private generateId;
+    private generateShortId;
+}
+//# sourceMappingURL=runner.d.ts.map

package/packages/sdk-ts/dist/workflows/runner.d.ts.map

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