agent-relay 2.3.13 → 2.3.14

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

@@ -125,18 +125,24 @@ export class WorkflowRunner {
   private async ensureRelaycastApiKey(channel: string): Promise<void> {
     if (process.env.RELAY_API_KEY) return;
 
-    // Check cached credentials
-    const cachePath = path.join(homedir(), '.agent-relay', 'relaycast.json');
-    if (existsSync(cachePath)) {
-      try {
-        const raw = await readFile(cachePath, 'utf-8');
-        const creds = JSON.parse(raw);
-        if (creds.api_key) {
-          process.env.RELAY_API_KEY = creds.api_key;
-          return;
+    // Check cached credentials — prefer per-project cache (written by the local
+    // relay daemon) over the legacy global cache so concurrent workflows from
+    // different repos never stomp each other's credentials.
+    const projectCachePath = path.join(this.cwd, '.agent-relay', 'relaycast.json');
+    const globalCachePath = path.join(homedir(), '.agent-relay', 'relaycast.json');
+
+    for (const cachePath of [projectCachePath, globalCachePath]) {
+      if (existsSync(cachePath)) {
+        try {
+          const raw = await readFile(cachePath, 'utf-8');
+          const creds = JSON.parse(raw);
+          if (creds.api_key) {
+            process.env.RELAY_API_KEY = creds.api_key;
+            return;
+          }
+        } catch {
+          // Cache corrupt — try next path
         }
-      } catch {
-        // Cache corrupt — fall through to auto-create
       }
     }
 
@@ -164,11 +170,12 @@ export class WorkflowRunner {
       throw new Error('Relaycast workspace response missing api_key');
     }
 
-    // Cache credentials for future runs
-    const cacheDir = path.dirname(cachePath);
+    // Cache credentials in the per-project directory so concurrent workflows
+    // from different repos each get their own workspace credentials.
+    const cacheDir = path.dirname(projectCachePath);
     await mkdir(cacheDir, { recursive: true, mode: 0o700 });
     await writeFile(
-      cachePath,
+      projectCachePath,
       JSON.stringify({
         workspace_id: workspaceId,
         api_key: apiKey,
@@ -494,7 +501,10 @@ export class WorkflowRunner {
       });
 
       // Create the dedicated workflow channel and join it
-      this.relaycastApi = new RelaycastApi({ agentName: 'WorkflowRunner' });
+      this.relaycastApi = new RelaycastApi({
+        agentName: 'WorkflowRunner',
+        cachePath: path.join(this.cwd, '.agent-relay', 'relaycast.json'),
+      });
       await this.relaycastApi.createChannel(channel, workflow.description);
       await this.relaycastApi.joinChannel(channel);
       this.postToChannel(
@@ -522,7 +532,6 @@ export class WorkflowRunner {
       if (allCompleted) {
         await this.updateRunStatus(runId, 'completed');
         this.emit({ type: 'run:completed', runId });
-        this.postToChannel(`Workflow **${workflow.name}** completed — all steps passed`);
 
         // Complete trajectory with summary
         const outcomes = this.collectOutcomes(stepStates, workflow.steps);
@@ -532,12 +541,17 @@ export class WorkflowRunner {
           learnings: this.trajectory.extractLearnings(outcomes),
           challenges: this.trajectory.extractChallenges(outcomes),
         });
+
+        // Post rich completion report to channel
+        this.postCompletionReport(workflow.name, outcomes, summary, confidence);
       } else {
         const failedStep = [...stepStates.values()].find((s) => s.row.status === 'failed');
         const errorMsg = failedStep?.row.error ?? 'One or more steps failed';
         await this.updateRunStatus(runId, 'failed', errorMsg);
         this.emit({ type: 'run:failed', runId, error: errorMsg });
-        this.postToChannel(`Workflow **${workflow.name}** failed: ${errorMsg}`);
+
+        const outcomes = this.collectOutcomes(stepStates, workflow.steps);
+        this.postFailureReport(workflow.name, outcomes, errorMsg);
 
         // Abandon trajectory on failure
         await this.trajectory.abandon(errorMsg);
@@ -549,7 +563,7 @@ export class WorkflowRunner {
 
       if (status === 'cancelled') {
         this.emit({ type: 'run:cancelled', runId });
-        this.postToChannel(`Workflow cancelled`);
+        this.postToChannel(`Workflow **${workflow.name}** cancelled`);
         await this.trajectory.abandon('Cancelled by user');
       } else {
         this.emit({ type: 'run:failed', runId, error: errorMsg });
@@ -632,7 +646,10 @@ export class WorkflowRunner {
       });
 
       // Ensure channel exists and join it for resumed runs
-      this.relaycastApi = new RelaycastApi({ agentName: 'WorkflowRunner' });
+      this.relaycastApi = new RelaycastApi({
+        agentName: 'WorkflowRunner',
+        cachePath: path.join(this.cwd, '.agent-relay', 'relaycast.json'),
+      });
       await this.relaycastApi.createChannel(resumeChannel);
       await this.relaycastApi.joinChannel(resumeChannel);
       this.postToChannel(
@@ -653,7 +670,6 @@ export class WorkflowRunner {
       if (allCompleted) {
         await this.updateRunStatus(runId, 'completed');
         this.emit({ type: 'run:completed', runId });
-        this.postToChannel(`Workflow **${workflow.name}** completed — all steps passed`);
 
         const outcomes = this.collectOutcomes(stepStates, workflow.steps);
         const summary = this.trajectory.buildRunSummary(outcomes);
@@ -662,12 +678,16 @@ export class WorkflowRunner {
           learnings: this.trajectory.extractLearnings(outcomes),
           challenges: this.trajectory.extractChallenges(outcomes),
         });
+
+        this.postCompletionReport(workflow.name, outcomes, summary, confidence);
       } else {
         const failedStep = [...stepStates.values()].find((s) => s.row.status === 'failed');
         const errorMsg = failedStep?.row.error ?? 'One or more steps failed';
         await this.updateRunStatus(runId, 'failed', errorMsg);
         this.emit({ type: 'run:failed', runId, error: errorMsg });
-        this.postToChannel(`Workflow **${workflow.name}** failed: ${errorMsg}`);
+
+        const outcomes = this.collectOutcomes(stepStates, workflow.steps);
+        this.postFailureReport(workflow.name, outcomes, errorMsg);
         await this.trajectory.abandon(errorMsg);
       }
     } catch (err) {
@@ -934,7 +954,7 @@ export class WorkflowRunner {
     const agentName = `${step.name}-${this.generateShortId()}`;
     const taskWithExit = step.task + '\n\n---\n' +
       'IMPORTANT: When you have fully completed this task, you MUST self-terminate by calling ' +
-      `the MCP tool: relay_release(name="${agentName}", reason="Task completed"). ` +
+      `the MCP tool: remove_agent(name="${agentName}", reason="Task completed"). ` +
       'Do not wait for further input — release yourself immediately after finishing.';
 
     const agentChannels = this.channel ? [this.channel] : agentDef.channels;
@@ -948,12 +968,18 @@ export class WorkflowRunner {
       idleThresholdSecs: agentDef.constraints?.idleThresholdSecs,
     });
 
-    // Register the spawned agent in Relaycast for observability
+    // Register the spawned agent in Relaycast for observability + start heartbeat
+    let stopHeartbeat: (() => void) | undefined;
     if (this.relaycastApi) {
-      await this.relaycastApi.registerExternalAgent(
+      const agentClient = await this.relaycastApi.registerExternalAgent(
         agent.name,
         `Workflow agent for step "${step.name}" (${agentDef.cli})`,
-      ).catch(() => {});
+      ).catch(() => null);
+
+      // Keep the agent online in the dashboard while it's working
+      if (agentClient) {
+        stopHeartbeat = this.relaycastApi.startHeartbeat(agentClient);
+      }
     }
 
     // Invite the spawned agent to the workflow channel
@@ -970,6 +996,9 @@ export class WorkflowRunner {
     // Wait for agent to exit (self-termination via /exit)
     const exitResult = await agent.waitForExit(timeoutMs);
 
+    // Stop heartbeat now that agent has exited
+    stopHeartbeat?.();
+
     if (exitResult === 'timeout') {
       // Safety net: check if the verification file exists before giving up.
       // The agent may have completed work but failed to /exit.
@@ -1132,6 +1161,64 @@ export class WorkflowRunner {
     });
   }
 
+  /** Post a rich completion report to the channel. */
+  private postCompletionReport(
+    workflowName: string,
+    outcomes: StepOutcome[],
+    summary: string,
+    confidence: number,
+  ): void {
+    const completed = outcomes.filter((o) => o.status === 'completed');
+    const skipped = outcomes.filter((o) => o.status === 'skipped');
+    const retried = outcomes.filter((o) => o.attempts > 1);
+
+    const lines: string[] = [
+      `## Workflow **${workflowName}** — Complete`,
+      '',
+      summary,
+      `Confidence: ${Math.round(confidence * 100)}%`,
+      '',
+      '### Steps',
+      ...completed.map((o) =>
+        `- **${o.name}** (${o.agent}) — passed${o.verificationPassed ? ' (verified)' : ''}${o.attempts > 1 ? ` after ${o.attempts} attempts` : ''}`,
+      ),
+      ...skipped.map((o) => `- **${o.name}** — skipped`),
+    ];
+
+    if (retried.length > 0) {
+      lines.push('', '### Retries');
+      for (const o of retried) {
+        lines.push(`- ${o.name}: ${o.attempts} attempts`);
+      }
+    }
+
+    this.postToChannel(lines.join('\n'));
+  }
+
+  /** Post a failure report to the channel. */
+  private postFailureReport(
+    workflowName: string,
+    outcomes: StepOutcome[],
+    errorMsg: string,
+  ): void {
+    const completed = outcomes.filter((o) => o.status === 'completed');
+    const failed = outcomes.filter((o) => o.status === 'failed');
+    const skipped = outcomes.filter((o) => o.status === 'skipped');
+
+    const lines: string[] = [
+      `## Workflow **${workflowName}** — Failed`,
+      '',
+      `${completed.length}/${outcomes.length} steps passed. Error: ${errorMsg}`,
+      '',
+      '### Steps',
+      ...completed.map((o) => `- **${o.name}** (${o.agent}) — passed`),
+      ...failed.map((o) => `- **${o.name}** (${o.agent}) — FAILED: ${o.error ?? 'unknown'}`),
+      ...skipped.map((o) => `- **${o.name}** — skipped`),
+    ];
+
+    this.postToChannel(lines.join('\n'));
+  }
+
   // ── Trajectory helpers ────────────────────────────────────────────────
 
   /** Analyze DAG structure for trajectory context. */

package/packages/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/config",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Shared configuration schemas and loaders for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -83,7 +83,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
+    "@agent-relay/protocol": "2.3.14",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.1"
   },

package/packages/continuity/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/continuity",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Session continuity manager for Relay (ledgers, handoffs, resume)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/memory": "2.3.13"
+    "@agent-relay/memory": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/daemon",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Relay daemon server - agent coordination and message routing",
   "type": "module",
   "main": "dist/index.js",
@@ -22,17 +22,17 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/config": "2.3.13",
-    "@agent-relay/storage": "2.3.13",
-    "@agent-relay/bridge": "2.3.13",
-    "@agent-relay/utils": "2.3.13",
-    "@agent-relay/policy": "2.3.13",
-    "@agent-relay/memory": "2.3.13",
-    "@agent-relay/resiliency": "2.3.13",
-    "@agent-relay/user-directory": "2.3.13",
-    "@agent-relay/wrapper": "2.3.13",
-    "@agent-relay/telemetry": "2.3.13",
+    "@agent-relay/protocol": "2.3.14",
+    "@agent-relay/config": "2.3.14",
+    "@agent-relay/storage": "2.3.14",
+    "@agent-relay/bridge": "2.3.14",
+    "@agent-relay/utils": "2.3.14",
+    "@agent-relay/policy": "2.3.14",
+    "@agent-relay/memory": "2.3.14",
+    "@agent-relay/resiliency": "2.3.14",
+    "@agent-relay/user-directory": "2.3.14",
+    "@agent-relay/wrapper": "2.3.14",
+    "@agent-relay/telemetry": "2.3.14",
     "ws": "^8.18.3",
     "pg": "^8.16.3",
     "uuid": "^10.0.0"

package/packages/hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/hooks",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Hook emitter, registry, and trajectory hooks for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -37,9 +37,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/config": "2.3.13",
-    "@agent-relay/trajectory": "2.3.13"
+    "@agent-relay/protocol": "2.3.14",
+    "@agent-relay/config": "2.3.14",
+    "@agent-relay/trajectory": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "MCP server for Agent Relay - native messaging tools for AI agents in Claude, Cursor, and VS Code",
   "author": "Agent Workforce Inc.",
   "license": "Apache-2.0",
@@ -47,15 +47,15 @@
     "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "dependencies": {
-    "@agent-relay/config": "2.3.13",
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/utils": "2.3.13",
+    "@agent-relay/config": "2.3.14",
+    "@agent-relay/protocol": "2.3.14",
+    "@agent-relay/utils": "2.3.14",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "smol-toml": "^1.6.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agent-relay/sdk": "2.3.13",
+    "@agent-relay/sdk": "2.3.14",
     "@types/node": "^22.19.3",
     "typescript": "^5.9.3",
     "vitest": "^2.1.9"

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/memory",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Semantic memory storage and retrieval system for agent-relay with multiple backend support",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/hooks": "2.3.13"
+    "@agent-relay/hooks": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Agent policy management with multi-level fallback (repo, local PRPM, cloud workspace)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.3.13"
+    "@agent-relay/config": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Wire protocol types and framing for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/resiliency/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/resiliency",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -60,8 +60,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/utils": "2.3.13"
+    "@agent-relay/protocol": "2.3.14",
+    "@agent-relay/utils": "2.3.14"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Agent spawning types and utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/state",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "Storage adapters and interfaces for Relay message/session persistence",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     }
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13"
+    "@agent-relay/protocol": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "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": "2.3.13",
+  "version": "2.3.14",
   "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": "2.3.13"
+    "@agent-relay/config": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "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/resiliency": "2.3.13"
+    "@agent-relay/resiliency": "2.3.14"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

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

package/packages/wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/wrapper",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "description": "CLI agent wrappers for Agent Relay - tmux, pty integration",
   "type": "module",
   "main": "dist/index.js",
@@ -30,10 +30,10 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/config": "2.3.13",
-    "@agent-relay/continuity": "2.3.13",
-    "@agent-relay/resiliency": "2.3.13",
+    "@agent-relay/protocol": "2.3.14",
+    "@agent-relay/config": "2.3.14",
+    "@agent-relay/continuity": "2.3.14",
+    "@agent-relay/resiliency": "2.3.14",
     "zod": "^3.23.8"
   },
   "devDependencies": {