agent-relay-orchestrator 0.12.1 → 0.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-orchestrator",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "Agent Relay orchestrator — manages agent lifecycle across hosts",
   "type": "module",
   "bin": {

package/src/api.ts

@@ -5,7 +5,7 @@ import { proxyArtifactRequest } from "./artifact-proxy";
 import type { OrchestratorConfig } from "./config";
 import type { ProviderProbeCache } from "./provider-probe";
 import type { RelayClient } from "./relay";
-import { captureSession, captureTerminal, createTerminalGuest, listSessions, sendTerminalInput, resizeTerminal, stopTerminalGuest } from "./spawn";
+import { captureSession, captureSessionMirror, captureTerminal, createTerminalGuest, listSessions, sendTerminalInput, resizeTerminal, stopTerminalGuest } from "./spawn";
 import { acquireTerminalStream, type TerminalStreamHandle, type TerminalStreamSubscriber } from "./terminal-stream";
 import { VERSION, runtimeMetadata } from "./version";
 import { previewWorkspaceMerge, probeWorkspace, workspaceDiff, workspaceGitState } from "./workspace-probe";
@@ -545,6 +545,11 @@ export function startApiServer(config: OrchestratorConfig, probeCache: ProviderP
         try {
           const session = decodeURIComponent(logMatch[1]!);
           const lines = Number(url.searchParams.get("lines") || "100");
+          // ?stream=mirror returns the clean session-mirror diagnostics log instead
+          // of the provider's ANSI TUI capture.
+          if (url.searchParams.get("stream") === "mirror") {
+            return json(captureSessionMirror(session, config, Number.isFinite(lines) ? lines : 200));
+          }
           return json(captureSession(session, config, Number.isFinite(lines) ? lines : 100, {
             raw: url.searchParams.get("raw") === "1",
           }));

package/src/spawn.ts

@@ -1,6 +1,6 @@
 import { chmodSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { isAbsolute, join, relative, resolve } from "node:path";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { artifactProxyBaseUrl } from "./artifact-proxy";
 import type { OrchestratorConfig } from "./config";
 import type { ManagedAgentReport, ManagedSessionExitDiagnostics } from "./relay";
@@ -951,6 +951,39 @@ export function captureSession(
   };
 }
 
+// Mirrors the runner's safeLogName so the orchestrator resolves the same filename.
+function safeMirrorLogName(value: string): string {
+  return value.replace(/[^a-zA-Z0-9_.-]+/g, "_").slice(0, 180);
+}
+
+// Read the clean, ANSI-free session-mirror diagnostics log for a managed agent.
+// Accepts either the tmux session name or the agent id; the mirror log is keyed by
+// agent id. Returns the same shape as captureSession so the proxy is uniform.
+export function captureSessionMirror(
+  name: string,
+  _config: OrchestratorConfig,
+  lines = 200,
+): { session: string; lines: string[]; running: boolean; mirror: true } {
+  const records = loadState();
+  const record = records.find((r) => r.name === name) ?? records.find((r) => r.agentId === name);
+  const agentId = record?.agentId ?? name;
+  const running = record ? isSessionRecordAlive(record) : false;
+  // The mirror log lives in the same directory as the provider log (both written
+  // by the same user on this host). Derive from the record's logFile when known so
+  // it tracks any per-session log relocation.
+  const logDir = record?.logFile ? dirname(record.logFile) : LOG_DIR;
+  const mirrorPath = join(logDir, `session-mirror-${safeMirrorLogName(agentId)}.log`);
+  let content: string;
+  try {
+    content = readFileSync(mirrorPath, "utf8");
+  } catch {
+    return { session: name, lines: [], running, mirror: true };
+  }
+  const allLines = content.split(/\r?\n/).filter(Boolean);
+  const safeLines = Math.min(Math.max(lines, 1), 2000);
+  return { session: name, lines: allLines.slice(-safeLines), running, mirror: true };
+}
+
 export function captureTerminal(name: string, config: OrchestratorConfig): TerminalSnapshot {
   if (!name.startsWith(`${config.tmuxPrefix}-`)) throw new Error("session is not managed by this orchestrator");