agent-relay 3.1.19 → 3.1.20

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

@@ -182,7 +182,7 @@ export class WorkflowTrajectory {
       id,
       version: 1,
       task: {
-        title: `${workflowName} run #${this.runId.slice(0, 8)}`,
+        title: workflowName,
         source: { system: 'workflow-runner', id: this.runId },
       },
       status: 'active',
@@ -251,6 +251,9 @@ export class WorkflowTrajectory {
       await this.registerAgent(participants.reviewer, 'reviewer');
     }
 
+    this.closeCurrentChapter();
+    this.openChapter(`Execution: ${step.name}`, agent);
+
     // Capture the step's purpose: first non-empty sentence of the task
     const intent = step.task
       ? step.task
@@ -479,12 +482,29 @@ export class WorkflowTrajectory {
   }
 
   /** Abandon the trajectory. */
-  async abandon(reason: string): Promise<void> {
+  async abandon(
+    reason: string,
+    meta?: { summary?: string; confidence?: number; learnings?: string[]; challenges?: string[] }
+  ): Promise<void> {
     if (!this.enabled || !this.trajectory) return;
 
+    const elapsed = Date.now() - this.startTime;
+    const elapsedStr =
+      elapsed > 60_000 ? `${Math.round(elapsed / 60_000)} minutes` : `${Math.round(elapsed / 1_000)} seconds`;
+    const summary = meta?.summary ?? `Workflow abandoned: ${reason}`;
+
+    this.openRetrospective();
+    this.addEvent('reflection', `${summary} (abandoned after ${elapsedStr})`, 'high');
     this.addEvent('error', `Workflow abandoned: ${reason}`, 'high');
     this.trajectory.status = 'abandoned';
     this.trajectory.completedAt = new Date().toISOString();
+    this.trajectory.retrospective = {
+      summary,
+      approach: `${this.swarmPattern} workflow (${this.trajectory.agents.filter((a) => a.role !== 'workflow-runner').length} agents)`,
+      confidence: meta?.confidence ?? 0,
+      learnings: meta?.learnings,
+      challenges: meta?.challenges,
+    };
 
     this.closeCurrentChapter();
     await this.flush();

package/packages/sdk-py/pyproject.toml

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

package/packages/sdk-py/src/agent_relay/client.py

@@ -167,8 +167,16 @@ def _install_broker_binary() -> str:
         target_path.stat().st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH
     )
 
-    # macOS: re-sign to avoid Gatekeeper issues
+    # macOS: strip quarantine and re-sign to avoid Gatekeeper issues
     if platform.system() == "Darwin":
+        try:
+            subprocess.run(
+                ["xattr", "-d", "com.apple.quarantine", str(target_path)],
+                capture_output=True,
+                timeout=10,
+            )
+        except Exception:
+            pass  # Non-fatal — attribute may not exist
         try:
             subprocess.run(
                 ["codesign", "--force", "--sign", "-", str(target_path)],
@@ -557,6 +565,7 @@ class AgentRelayClient:
         idle_threshold_secs: Optional[int] = None,
         restart_policy: Optional[dict[str, Any]] = None,
         continue_from: Optional[str] = None,
+        skip_relay_prompt: Optional[bool] = None,
     ) -> dict[str, Any]:
         await self.start_client()
         built_args = _build_pty_args_with_model(cli, args or [], model)
@@ -585,6 +594,8 @@ class AgentRelayClient:
             request_payload["idle_threshold_secs"] = idle_threshold_secs
         if continue_from is not None:
             request_payload["continue_from"] = continue_from
+        if skip_relay_prompt is not None:
+            request_payload["skip_relay_prompt"] = skip_relay_prompt
         return await self._request_ok("spawn_agent", request_payload)
 
     async def spawn_headless(
@@ -595,6 +606,7 @@ class AgentRelayClient:
         args: Optional[list[str]] = None,
         channels: Optional[list[str]] = None,
         task: Optional[str] = None,
+        skip_relay_prompt: Optional[bool] = None,
     ) -> dict[str, Any]:
         await self.start_client()
         agent = AgentSpec(
@@ -607,6 +619,8 @@ class AgentRelayClient:
         request_payload: dict[str, Any] = {"agent": agent.to_dict()}
         if task is not None:
             request_payload["initial_task"] = task
+        if skip_relay_prompt is not None:
+            request_payload["skip_relay_prompt"] = skip_relay_prompt
         return await self._request_ok("spawn_agent", request_payload)
 
     async def spawn_provider(
@@ -626,6 +640,7 @@ class AgentRelayClient:
         idle_threshold_secs: Optional[int] = None,
         restart_policy: Optional[dict[str, Any]] = None,
         continue_from: Optional[str] = None,
+        skip_relay_prompt: Optional[bool] = None,
     ) -> dict[str, Any]:
         resolved_transport: AgentTransport = transport or (
             "headless" if provider == "opencode" else "pty"
@@ -645,6 +660,7 @@ class AgentRelayClient:
                 args=args,
                 channels=channels,
                 task=task,
+                skip_relay_prompt=skip_relay_prompt,
             )
 
         return await self.spawn_pty(
@@ -661,6 +677,7 @@ class AgentRelayClient:
             idle_threshold_secs=idle_threshold_secs,
             restart_policy=restart_policy,
             continue_from=continue_from,
+            skip_relay_prompt=skip_relay_prompt,
         )
 
     async def spawn_claude(self, **kwargs: Any) -> dict[str, Any]:

package/packages/sdk-py/src/agent_relay/relay.py

@@ -51,6 +51,7 @@ class SpawnOptions:
     shadow_mode: Optional[str] = None
     idle_threshold_secs: Optional[int] = None
     restart_policy: Optional[dict[str, Any]] = None
+    skip_relay_prompt: Optional[bool] = None
     on_start: LifecycleHook = None
     on_success: LifecycleHook = None
     on_error: LifecycleHook = None
@@ -304,6 +305,7 @@ class AgentSpawner:
         task: Optional[str] = None,
         model: Optional[str] = None,
         cwd: Optional[str] = None,
+        skip_relay_prompt: Optional[bool] = None,
         on_start: LifecycleHook = None,
         on_success: LifecycleHook = None,
         on_error: LifecycleHook = None,
@@ -332,6 +334,7 @@ class AgentSpawner:
                 task=task,
                 model=model,
                 cwd=cwd,
+                skip_relay_prompt=skip_relay_prompt,
             )
         except Exception as error:
             await self._relay._invoke_lifecycle_hook(
@@ -512,6 +515,7 @@ class AgentRelay:
                 shadow_mode=opts.shadow_mode,
                 idle_threshold_secs=opts.idle_threshold_secs,
                 restart_policy=opts.restart_policy,
+                skip_relay_prompt=opts.skip_relay_prompt,
             )
         except Exception as error:
             await self._invoke_lifecycle_hook(

package/packages/sdk-py/src/agent_relay/types.py

@@ -491,6 +491,8 @@ class StepCompletedEvent:
     run_id: str = ""
     step_name: str = ""
     output: str | None = None
+    exit_code: int | None = None
+    exit_signal: str | None = None
 
 
 @dataclass(frozen=True)
@@ -499,6 +501,8 @@ class StepFailedEvent:
     run_id: str = ""
     step_name: str = ""
     error: str = ""
+    exit_code: int | None = None
+    exit_signal: str | None = None
 
 
 @dataclass(frozen=True)

package/packages/telemetry/package.json

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

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "3.1.19",
+  "version": "3.1.20",
   "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.1.19"
+    "@agent-relay/utils": "3.1.20"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "3.1.19",
+  "version": "3.1.20",
   "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.1.19",
+    "@agent-relay/config": "3.1.20",
     "compare-versions": "^6.1.1"
   },
   "publishConfig": {