@nordbyte/nordrelay 0.6.0 → 0.8.0

package/dist/relay-runtime.js

@@ -1,5 +1,4 @@
 import { randomUUID } from "node:crypto";
-import path from "node:path";
 import { ensureOutDir } from "./artifacts.js";
 import { buildFileInstructions, outboxPath, stageFile, } from "./attachments.js";
 import { CODEX_AGENT_CAPABILITIES, agentLabel, agentReasoningLabel, agentReasoningOptions, isAgentId, } from "./agent.js";
@@ -10,6 +9,7 @@ import { createAgentSessionService, enabledAgents } from "./agent-factory.js";
 import { AuditLogStore } from "./audit-log.js";
 import { BotPreferencesStore } from "./bot-preferences.js";
 import { ChannelTurnService } from "./channel-turn-service.js";
+import { activeSessionSourceForContextKey, ChannelMirrorRegistry } from "./channel-mirror-registry.js";
 import { checkAuthStatus, startLogin as startCodexLogin, startLogout as startCodexLogout } from "./codex-auth.js";
 import { checkClaudeCodeAuthStatus, startClaudeCodeLogin, startClaudeCodeLogout } from "./claude-code-auth.js";
 import { listThreads as listCodexThreads } from "./codex-state.js";
@@ -25,21 +25,24 @@ import { RelayArtifactService } from "./relay-artifact-service.js";
 import { RelayExternalActivityMonitor } from "./relay-external-activity-monitor.js";
 import { RelayQueueService } from "./relay-queue-service.js";
 import { RuntimeSnapshotCache } from "./runtime-cache.js";
+import { activeSessionPriority, activityToUnifiedJob, agentUpdateStatusToUnified, cliHealthForAgent, dedupeJobs, hostLoginCommand, hostLogoutCommand, isPromptTerminalActivity, normalizeMimeType, promptActivityToUnifiedJob, shouldRefreshActiveSessions, taskToUnifiedJob, uploadFileDtos, versionCheckForAgent, } from "./relay-runtime-helpers.js";
 import { renderSessionInfoPlain, renderSessionUsageRows } from "./session-format.js";
 import { SessionLockStore } from "./session-locks.js";
 import { SessionRegistry } from "./session-registry.js";
+import { collectSlackDiagnostics } from "./slack-diagnostics.js";
+import { getSlackRateLimitMetrics } from "./slack-rate-limit.js";
 import { createSupportBundle } from "./support-bundle.js";
 import { transcribeAudio } from "./voice.js";
 import { WebActivityStore, WebChatStore, } from "./web-state.js";
-import { channelIdForContextKey } from "./context-key.js";
 import { evaluateWorkspacePolicy, filterAllowedWorkspaces } from "./workspace-policy.js";
-const WEB_CONTEXT_KEY = "web:dashboard";
+export const WEB_CONTEXT_KEY = "web:dashboard";
 const ACTIVE_CODEX_DISCOVERY_LIMIT = 200;
 const ACTIVE_ACTIVITY_TTL_MS = 6 * 60 * 60 * 1000;
 const MAX_WEB_SESSION_PAGE_SIZE = 50;
 const MAX_CHAT_HISTORY = 250;
 export class RelayRuntime {
     config;
+    contextKey;
     registry;
     promptStore;
     chatStore;
@@ -50,6 +53,7 @@ export class RelayRuntime {
     queueService;
     jobStore;
     artifactService;
+    mirrorRegistry;
     externalActivityMonitor;
     cache = new RuntimeSnapshotCache();
     turnService;
@@ -57,25 +61,29 @@ export class RelayRuntime {
     agentUpdateActors = new Map();
     agentUpdateStates = new Map();
     externalMonitor;
+    activeSessionsBroadcastTimer = null;
+    activeSessionsLastBroadcastAt = 0;
     draining = false;
     currentTurnId = null;
     accumulatedText = "";
     currentTurnStartedAt = 0;
     currentProgress = null;
-    constructor(config) {
+    constructor(config, options = {}) {
         this.config = config;
+        this.contextKey = options.contextKey ?? WEB_CONTEXT_KEY;
         this.registry = new SessionRegistry(config, {
-            fileName: "web-contexts.json",
-            sqliteKey: "web-contexts",
+            fileName: options.registryFileName ?? "web-contexts.json",
+            sqliteKey: options.registrySqliteKey ?? "web-contexts",
         });
         this.promptStore = new PromptStore(config.workspace, config.stateBackend);
         this.chatStore = new WebChatStore(config.workspace, config.stateBackend, MAX_CHAT_HISTORY);
         this.activityStore = new WebActivityStore(config.workspace, config.stateBackend, config.auditMaxEvents);
         this.auditStore = new AuditLogStore(config.workspace, config.stateBackend, config.auditMaxEvents);
         this.lockStore = new SessionLockStore(config.workspace, config.stateBackend);
-        this.queueService = new RelayQueueService(this.promptStore, WEB_CONTEXT_KEY);
+        this.queueService = new RelayQueueService(this.promptStore, this.contextKey);
         this.jobStore = new UnifiedJobStore(config.workspace, config.stateBackend, config.unifiedJobMaxItems);
         this.artifactService = new RelayArtifactService(config);
+        this.mirrorRegistry = new ChannelMirrorRegistry(config, this.promptStore);
         this.agentUpdates = new AgentUpdateManager({
             onUpdate: (job) => {
                 this.broadcast({ type: "agent_update", job });
@@ -103,7 +111,7 @@ export class RelayRuntime {
         }
         this.turnService = new ChannelTurnService({
             source: "web",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             chatStore: this.chatStore,
             artifactService: this.artifactService,
             checkAuth: (info) => this.checkAgentAuth(info),
@@ -136,6 +144,7 @@ export class RelayRuntime {
         this.subscribers.add(callback);
         void this.snapshot().then((data) => callback({ type: "snapshot", data })).catch(() => { });
         void this.chatHistory().then((messages) => callback({ type: "chat_history", messages })).catch(() => { });
+        void this.activeSessions().then((active) => callback({ type: "active_sessions_update", active })).catch(() => { });
         callback({ type: "activity_update", events: this.activity({ limit: 50 }) });
         return () => this.subscribers.delete(callback);
     }
@@ -205,7 +214,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "update",
             detail: update.summary,
@@ -242,7 +251,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             agentId,
             actor,
             description: `${operation} ${agentId}`,
@@ -268,7 +277,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             agentId: job.agentId,
             actor,
             description: `delete update log ${id}`,
@@ -323,6 +332,11 @@ export class RelayRuntime {
                     queuePaused: this.queueService.isPaused(),
                     externalMirror: this.externalActivityMonitor.snapshot(),
                     agentDiagnostics: getAgentDiagnostics(session, this.config),
+                    slackDiagnostics: await collectSlackDiagnostics({
+                        config: this.config,
+                        timeoutMs: 2_500,
+                        rateLimit: getSlackRateLimitMetrics(),
+                    }),
                 },
             };
         });
@@ -566,8 +580,8 @@ export class RelayRuntime {
         if (this.currentProgress?.status === "running") {
             addActiveSession({
                 ...this.currentProgress,
-                contextKey: WEB_CONTEXT_KEY,
-                sourceContextKey: WEB_CONTEXT_KEY,
+                contextKey: this.contextKey,
+                sourceContextKey: this.contextKey,
                 source: "web",
                 status: "running",
                 queueLength: this.queueService.length(),
@@ -581,7 +595,7 @@ export class RelayRuntime {
             addActiveSession(active);
         }
         for (const meta of knownContexts) {
-            if (meta.contextKey === WEB_CONTEXT_KEY && this.currentProgress?.status === "running") {
+            if (meta.contextKey === this.contextKey && this.currentProgress?.status === "running") {
                 continue;
             }
             const active = this.externalActiveSession(meta, knownContexts, preferences);
@@ -631,7 +645,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "export diagnostics bundle",
             detail: bundle.path,
@@ -643,7 +657,7 @@ export class RelayRuntime {
     }
     lockWebSession(ownerName = "Web dashboard", actor) {
         const label = ownerName || actor?.label || "Web dashboard";
-        const lock = this.lockStore.set(WEB_CONTEXT_KEY, {
+        const lock = this.lockStore.set(this.contextKey, {
             userId: actor?.id ?? "web",
             label,
             channel: "web",
@@ -660,7 +674,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "lock_updated",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "lock",
             detail: `locked by ${label}`,
@@ -668,7 +682,7 @@ export class RelayRuntime {
         return lock;
     }
     unlockWebSession(actor) {
-        const removed = this.lockStore.clear(WEB_CONTEXT_KEY);
+        const removed = this.lockStore.clear(this.contextKey);
         this.appendActivity({
             source: "web",
             status: "info",
@@ -681,7 +695,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "lock_updated",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "unlock",
             detail: removed ? "unlocked" : "no lock",
@@ -788,7 +802,7 @@ export class RelayRuntime {
             this.appendAudit({
                 action: "command",
                 status: result.success ? "ok" : "failed",
-                contextKey: WEB_CONTEXT_KEY,
+                contextKey: this.contextKey,
                 agentId: info.agentId,
                 threadId: info.threadId,
                 workspace: info.workspace,
@@ -851,7 +865,7 @@ export class RelayRuntime {
             this.appendAudit({
                 action: "command",
                 status: result.success ? "ok" : "failed",
-                contextKey: WEB_CONTEXT_KEY,
+                contextKey: this.contextKey,
                 agentId: info.agentId,
                 threadId: info.threadId,
                 workspace: info.workspace,
@@ -902,7 +916,7 @@ export class RelayRuntime {
         return { removed, messages };
     }
     activity(options = {}) {
-        const currentInfo = this.registry.get(WEB_CONTEXT_KEY)?.getInfo();
+        const currentInfo = this.registry.get(this.contextKey)?.getInfo();
         return this.activityStore.list(options).map((event) => this.enrichActivityEvent(event, currentInfo));
     }
     async retry(actor) {
@@ -913,7 +927,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "retry",
             detail: cached.description,
@@ -943,7 +957,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             agentId: result.info.agentId,
             threadId: result.info.threadId,
             workspace: result.info.workspace,
@@ -1018,7 +1032,7 @@ export class RelayRuntime {
         if (!enabledAgents(this.config).includes(agentId)) {
             throw new Error(`Agent is not enabled: ${agentId}`);
         }
-        const session = await this.registry.switchAgent(WEB_CONTEXT_KEY, agentId);
+        const session = await this.registry.switchAgent(this.contextKey, agentId);
         this.updateSession(session);
         const info = this.publicInfo(session);
         this.appendActivity({
@@ -1034,7 +1048,7 @@ export class RelayRuntime {
         return this.publicInfo(session);
     }
     async newSession(options = {}, actor) {
-        const session = options.agentId ? await this.registry.switchAgent(WEB_CONTEXT_KEY, options.agentId) : await this.getSession(true);
+        const session = options.agentId ? await this.registry.switchAgent(this.contextKey, options.agentId) : await this.getSession(true);
         this.ensureIdle(session);
         if (options.reasoningEffort) {
             const reasoningOptions = agentReasoningOptions(session.getInfo().agentId);
@@ -1273,7 +1287,7 @@ export class RelayRuntime {
             this.appendAudit({
                 action: "prompt_queued",
                 status: "ok",
-                contextKey: WEB_CONTEXT_KEY,
+                contextKey: this.contextKey,
                 agentId: info.agentId,
                 threadId: info.threadId,
                 workspace: info.workspace,
@@ -1318,7 +1332,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "queue_updated",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: id ? `${action}: ${id}` : action,
         });
@@ -1394,7 +1408,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: `clear ${target} log`,
             detail: result.filePath,
@@ -1416,7 +1430,7 @@ export class RelayRuntime {
         this.appendAudit({
             action: "command",
             status: "ok",
-            contextKey: WEB_CONTEXT_KEY,
+            contextKey: this.contextKey,
             actor,
             description: "restart connector",
         });
@@ -1431,7 +1445,7 @@ export class RelayRuntime {
         this.subscribers.clear();
     }
     async getSession(deferThreadStart) {
-        return this.registry.getOrCreate(WEB_CONTEXT_KEY, { deferThreadStart });
+        return this.registry.getOrCreate(this.contextKey, { deferThreadStart });
     }
     async cached(key, producer) {
         return (await this.cache.get(key, this.config.dashboardCacheTtlMs, producer)).value;
@@ -1455,10 +1469,10 @@ export class RelayRuntime {
         finally {
             sharedRegistry.disposeAll();
         }
-        const current = this.registry.get(WEB_CONTEXT_KEY)?.getInfo();
+        const current = this.registry.get(this.contextKey)?.getInfo();
         if (current) {
             add({
-                contextKey: WEB_CONTEXT_KEY,
+                contextKey: this.contextKey,
                 agentId: current.agentId,
                 threadId: current.threadId,
                 workspace: current.workspace,
@@ -1524,7 +1538,12 @@ export class RelayRuntime {
             return [];
         }
         const active = [];
+        const nowMs = Date.now();
+        const staleAfterMs = this.config.codexExternalBusyStaleMs;
         for (const thread of listCodexThreads(ACTIVE_CODEX_DISCOVERY_LIMIT)) {
+            if (staleAfterMs > 0 && nowMs - thread.updatedAt.getTime() > staleAfterMs) {
+                continue;
+            }
             const meta = {
                 contextKey: `cli:codex:${thread.id}`,
                 agentId: "codex",
@@ -1553,6 +1572,12 @@ export class RelayRuntime {
         if (!capabilities.externalActivity) {
             return null;
         }
+        if (agentId === "codex" &&
+            meta.updatedAt &&
+            this.config.codexExternalBusyStaleMs > 0 &&
+            Date.now() - meta.updatedAt > this.config.codexExternalBusyStaleMs) {
+            return null;
+        }
         const snapshot = getExternalSnapshotForSession(this.sessionStubForMetadata(meta, agentId, capabilities), this.config, {
             maxEvents: 8,
         });
@@ -1563,8 +1588,8 @@ export class RelayRuntime {
         const updatedAt = snapshot.activity.updatedAt?.toISOString() ?? new Date().toISOString();
         const startedMs = Date.parse(startedAt);
         const sourceContextKey = `cli:${snapshot.agentId}:${snapshot.threadId}`;
-        const mirrorChannels = this.activeMirrorChannels(snapshot.agentId, snapshot.threadId, knownContexts, preferences);
-        const queueLength = mirrorChannels.reduce((sum, mirror) => sum + mirror.queueLength, this.promptStore.list(sourceContextKey).length);
+        const mirrorChannels = this.mirrorRegistry.activeMirrorsForThread(snapshot.agentId, snapshot.threadId, knownContexts, preferences);
+        const queueLength = this.mirrorRegistry.queueLengthForExternalSource(sourceContextKey, mirrorChannels);
         const mirrorDetail = mirrorChannels.length > 0
             ? `Mirroring: ${mirrorChannels.map((mirror) => `${mirror.source} ${mirror.mode}`).join(", ")}`
             : "Mirroring: none";
@@ -1585,42 +1610,11 @@ export class RelayRuntime {
             updatedAt,
             durationMs: Number.isFinite(startedMs) ? Math.max(0, Date.now() - startedMs) : 0,
             queueLength,
-            queuePaused: mirrorChannels.some((mirror) => mirror.queuePaused) || this.promptStore.isPaused(sourceContextKey),
+            queuePaused: this.mirrorRegistry.queuePausedForExternalSource(sourceContextKey, mirrorChannels),
             mirrorChannels,
             detail: `${mirrorDetail} | ${snapshot.sourceLabel}: ${snapshot.sourcePath}`,
         };
     }
-    activeMirrorChannels(agentId, threadId, knownContexts, preferences) {
-        const mirrors = [];
-        const seen = new Set();
-        for (const meta of knownContexts) {
-            const metaAgentId = meta.agentId ?? this.config.defaultAgent ?? "codex";
-            if (meta.threadId !== threadId || metaAgentId !== agentId) {
-                continue;
-            }
-            const source = activeSessionSourceForContext(meta.contextKey);
-            if (source !== "telegram" && source !== "discord") {
-                continue;
-            }
-            const mode = this.effectiveMirrorMode(meta.contextKey, source, preferences);
-            if (mode === "off" || seen.has(meta.contextKey)) {
-                continue;
-            }
-            seen.add(meta.contextKey);
-            mirrors.push({
-                source,
-                contextKey: meta.contextKey,
-                mode,
-                queueLength: this.promptStore.list(meta.contextKey).length,
-                queuePaused: this.promptStore.isPaused(meta.contextKey),
-            });
-        }
-        return mirrors;
-    }
-    effectiveMirrorMode(contextKey, source, preferences) {
-        const configured = source === "telegram" ? this.config.telegramMirrorMode : this.config.discordMirrorMode;
-        return preferences.get(contextKey).mirrorMode ?? configured;
-    }
     sessionStubForMetadata(meta, agentId, capabilities) {
         const info = {
             agentId,
@@ -1785,7 +1779,7 @@ export class RelayRuntime {
         }
     }
     updateSession(session) {
-        this.registry.updateMetadata(WEB_CONTEXT_KEY, session);
+        this.registry.updateMetadata(this.contextKey, session);
         this.broadcast({ type: "session_update", session: this.publicInfo(session) });
     }
     recordActivity(input) {
@@ -1891,6 +1885,23 @@ export class RelayRuntime {
                 this.subscribers.delete(subscriber);
             }
         }
+        if (shouldRefreshActiveSessions(event)) {
+            this.scheduleActiveSessionsBroadcast();
+        }
+    }
+    scheduleActiveSessionsBroadcast() {
+        if (this.activeSessionsBroadcastTimer) {
+            return;
+        }
+        const delayMs = Math.max(0, 1_000 - (Date.now() - this.activeSessionsLastBroadcastAt));
+        this.activeSessionsBroadcastTimer = setTimeout(() => {
+            this.activeSessionsBroadcastTimer = null;
+            this.activeSessionsLastBroadcastAt = Date.now();
+            void this.activeSessions()
+                .then((active) => this.broadcast({ type: "active_sessions_update", active }))
+                .catch(() => { });
+        }, delayMs);
+        this.activeSessionsBroadcastTimer.unref?.();
     }
     publicInfo(session) {
         const info = session.getInfo();
@@ -1903,209 +1914,3 @@ export class RelayRuntime {
         };
     }
 }
-function cliHealthForAgent(agentId, health) {
-    if (agentId === "pi") {
-        return { path: health.piCliPath, label: health.piCli, version: health.piCliVersion };
-    }
-    if (agentId === "hermes") {
-        return { path: health.hermesCliPath, label: health.hermesCli, version: health.hermesCliVersion };
-    }
-    if (agentId === "openclaw") {
-        return { path: health.openClawCliPath, label: health.openClawCli, version: health.openClawCliVersion };
-    }
-    if (agentId === "claude-code") {
-        return { path: health.claudeCodeCliPath, label: health.claudeCodeCli, version: health.claudeCodeCliVersion };
-    }
-    return { path: health.codexCliPath, label: health.codexCli, version: health.codexCliVersion };
-}
-function versionCheckForAgent(agentId, versions) {
-    if (agentId === "pi")
-        return versions.pi;
-    if (agentId === "hermes")
-        return versions.hermes;
-    if (agentId === "openclaw")
-        return versions.openclaw;
-    if (agentId === "claude-code")
-        return versions.claudeCode;
-    return versions.codex;
-}
-function hostLoginCommand(info, config) {
-    if (info.agentId === "hermes") {
-        return `${config.hermesCliPath ?? "hermes"} login --no-browser`;
-    }
-    if (info.agentId === "claude-code") {
-        return `${config.claudeCodeCliPath ?? "claude"} auth login`;
-    }
-    if (info.agentId === "pi") {
-        return `${config.piCliPath ?? "pi"} auth login`;
-    }
-    if (info.agentId === "openclaw") {
-        return `${config.openClawCliPath ?? "openclaw"} login`;
-    }
-    return "codex login --device-auth";
-}
-function hostLogoutCommand(info, config) {
-    if (info.agentId === "hermes") {
-        return `${config.hermesCliPath ?? "hermes"} logout`;
-    }
-    if (info.agentId === "claude-code") {
-        return `${config.claudeCodeCliPath ?? "claude"} auth logout`;
-    }
-    if (info.agentId === "pi") {
-        return `${config.piCliPath ?? "pi"} auth logout`;
-    }
-    if (info.agentId === "openclaw") {
-        return `${config.openClawCliPath ?? "openclaw"} logout`;
-    }
-    return "codex logout";
-}
-function activeSessionSourceForContext(contextKey) {
-    const channelId = channelIdForContextKey(contextKey);
-    if (channelId === "telegram") {
-        return "telegram";
-    }
-    if (channelId === "discord") {
-        return "discord";
-    }
-    if (channelId === "web") {
-        return "web";
-    }
-    return "cli";
-}
-function activeSessionPriority(session) {
-    if (session.status === "running") {
-        return 3;
-    }
-    return session.contextKey.startsWith("cli:") ? 1 : 2;
-}
-function isPromptTerminalActivity(event) {
-    return event.status === "completed" ||
-        event.status === "failed" ||
-        event.status === "aborted" ||
-        event.type === "prompt_completed" ||
-        event.type === "prompt_failed" ||
-        event.type === "prompt_aborted";
-}
-function taskToUnifiedJob(id, kind, title, task, options) {
-    return {
-        id,
-        kind,
-        title,
-        status: task.status,
-        source: task.source,
-        agentId: task.agentId,
-        agentLabel: task.agentLabel,
-        threadId: task.threadId,
-        workspace: task.workspace,
-        startedAt: task.startedAt,
-        updatedAt: task.updatedAt,
-        durationMs: task.durationMs,
-        summary: task.prompt || task.detail,
-        logTail: task.currentTool || task.lastTool ? `Current tool: ${task.currentTool ?? "-"}\nLast tool: ${task.lastTool ?? "-"}` : undefined,
-        ...options,
-    };
-}
-function activityToUnifiedJob(event, kind, title, options) {
-    return {
-        id: `${kind}:${event.id}`,
-        kind,
-        title,
-        status: event.status,
-        source: event.source,
-        agentId: event.agentId,
-        threadId: event.threadId,
-        workspace: event.workspace,
-        owner: event.actor,
-        startedAt: event.timestamp,
-        updatedAt: event.timestamp,
-        finishedAt: event.timestamp,
-        durationMs: event.durationMs,
-        summary: event.prompt || event.detail,
-        logPath: event.detail,
-        logTail: event.detail,
-        ...options,
-    };
-}
-function promptActivityToUnifiedJob(event) {
-    const status = event.status === "info" ? "completed" : event.status;
-    const sourceLabel = event.source === "web"
-        ? "WebUI"
-        : event.source === "telegram"
-            ? "Telegram"
-            : event.source === "discord"
-                ? "Discord"
-                : "CLI";
-    const promptKey = event.threadId ?? event.contextKey ?? event.id;
-    return {
-        id: `prompt:${event.source}:${promptKey}:${event.id}`,
-        kind: event.source === "cli" ? "external-turn" : "web-turn",
-        title: `${sourceLabel} prompt`,
-        status,
-        source: event.source,
-        agentId: event.agentId,
-        threadId: event.threadId,
-        workspace: event.workspace,
-        owner: event.actor,
-        startedAt: event.timestamp,
-        updatedAt: event.timestamp,
-        finishedAt: status === "running" || status === "queued" ? undefined : event.timestamp,
-        durationMs: event.durationMs,
-        summary: event.prompt || event.detail,
-        logTail: event.detail,
-        canCancel: status === "running" && event.source === "web",
-        canRetry: status !== "running",
-        canReadLog: Boolean(event.detail || event.prompt),
-    };
-}
-function agentUpdateStatusToUnified(status) {
-    if (status === "cancelled")
-        return "aborted";
-    if (status === "running")
-        return "running";
-    if (status === "completed")
-        return "completed";
-    return "failed";
-}
-function dedupeJobs(jobs) {
-    const seen = new Set();
-    return jobs.filter((job) => {
-        if (seen.has(job.id)) {
-            return false;
-        }
-        seen.add(job.id);
-        return true;
-    });
-}
-function normalizeMimeType(value, name) {
-    const configured = value?.trim();
-    if (configured) {
-        return configured;
-    }
-    const extension = path.extname(name).toLowerCase();
-    if ([".jpg", ".jpeg"].includes(extension))
-        return "image/jpeg";
-    if (extension === ".png")
-        return "image/png";
-    if (extension === ".gif")
-        return "image/gif";
-    if (extension === ".webp")
-        return "image/webp";
-    if (extension === ".mp3")
-        return "audio/mpeg";
-    if (extension === ".wav")
-        return "audio/wav";
-    if (extension === ".ogg" || extension === ".oga")
-        return "audio/ogg";
-    if (extension === ".m4a")
-        return "audio/mp4";
-    if (extension === ".webm")
-        return "audio/webm";
-    return "application/octet-stream";
-}
-function uploadFileDtos(files) {
-    return files.map((file) => ({
-        name: file.safeName,
-        mimeType: file.mimeType,
-        sizeBytes: file.sizeBytes,
-    }));
-}