agent-relay 3.2.6 → 3.2.7

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -102,7 +102,7 @@
     "typescript": "^5.7.3"
   },
   "dependencies": {
-    "@agent-relay/config": "3.2.6",
+    "@agent-relay/config": "3.2.7",
     "@relaycast/sdk": "^0.4.0",
     "@sinclair/typebox": "^0.34.48",
     "ws": "^8.18.3",

package/packages/sdk/src/workflows/builder.ts

@@ -367,8 +367,14 @@ export class WorkflowBuilder {
       runner.on(options.onEvent);
     }
 
-    const startFrom = this._startFrom ?? options.startFrom;
-    const previousRunId = this._previousRunId ?? options.previousRunId;
+    // Auto-detect RESUME_RUN_ID env var for resuming failed runs
+    const resumeRunId = process.env.RESUME_RUN_ID;
+    if (resumeRunId) {
+      return runner.resume(resumeRunId, options.vars);
+    }
+
+    const startFrom = this._startFrom ?? options.startFrom ?? process.env.START_FROM;
+    const previousRunId = this._previousRunId ?? options.previousRunId ?? process.env.PREVIOUS_RUN_ID;
     const executeOptions: WorkflowExecuteOptions | undefined = startFrom
       ? { startFrom, previousRunId }
       : undefined;

package/packages/sdk/src/workflows/run.ts

@@ -21,6 +21,12 @@ export interface RunWorkflowOptions {
   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;
 }
 
 /**
@@ -68,5 +74,15 @@ export async function runWorkflow(
     runner.on(options.onEvent);
   }
 
-  return runner.execute(config, options.workflow, options.vars);
+  // 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);
 }

package/packages/sdk/src/workflows/runner.ts

@@ -1834,6 +1834,7 @@ export class WorkflowRunner {
     };
 
     await this.db.insertRun(run);
+    this.persistRunIdHint(runId);
 
     // Build step rows
     const stepStates = new Map<string, StepState>();
@@ -1925,6 +1926,7 @@ export class WorkflowRunner {
     if (!run) {
       throw new Error(`Run "${runId}" not found`);
     }
+    this.persistRunIdHint(runId);
 
     if (run.status !== 'running' && run.status !== 'failed') {
       throw new Error(`Run "${runId}" is in status "${run.status}" and cannot be resumed`);
@@ -6116,6 +6118,17 @@ export class WorkflowRunner {
 
   // ── ID generation ─────────────────────────────────────────────────────
 
+  private persistRunIdHint(runId: string): void {
+    const target = process.env.AGENT_RELAY_RUN_ID_FILE?.trim();
+    if (!target) return;
+    try {
+      mkdirSync(path.dirname(target), { recursive: true });
+      writeFileSync(target, runId + '\n', 'utf8');
+    } catch {
+      // Ignore hint persistence failures.
+    }
+  }
+
   private generateId(): string {
     return randomBytes(12).toString('hex');
   }

package/packages/sdk-py/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-relay-sdk"
-version = "3.2.6"
+version = "3.2.7"
 description = "Python SDK for Agent Relay workflows"
 readme = "README.md"
 license = "Apache-2.0"

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "description": "Anonymous telemetry for Agent Relay usage analytics",
   "type": "module",
   "main": "dist/index.js",

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/trajectory",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "description": "Trajectory integration utilities (trail/PDERO) for Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "3.2.6"
+    "@agent-relay/config": "3.2.7"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "description": "User directory service for agent-relay (per-user credential storage)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/utils": "3.2.6"
+    "@agent-relay/utils": "3.2.7"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "3.2.6",
+  "version": "3.2.7",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -112,7 +112,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@agent-relay/config": "3.2.6",
+    "@agent-relay/config": "3.2.7",
     "compare-versions": "^6.1.1"
   },
   "publishConfig": {