aimux-cli 0.1.18 → 0.1.20

package/dist/metadata-server.d.ts

@@ -1,6 +1,7 @@
 import { type SessionAlertDisplayContext } from "./alert-display.js";
 import { type MessageKind } from "./threads.js";
 import { type TaskLifecycleResult } from "./orchestration-actions.js";
+import type { LaunchOverride } from "./shell-args.js";
 import type { ParsedAgentOutput } from "./agent-output-parser.js";
 import { ProjectEventBus } from "./project-events.js";
 interface MetadataServerOptions {
@@ -204,7 +205,7 @@ interface MetadataServerOptions {
             sessionId?: string;
             worktreePath?: string;
             open?: boolean;
-            extraArgs?: string[];
+            launchOverride?: LaunchOverride;
         }) => Promise<{
             sessionId: string;
         }> | {
@@ -242,7 +243,7 @@ interface MetadataServerOptions {
             instruction?: string;
             worktreePath?: string;
             open?: boolean;
-            extraArgs?: string[];
+            launchOverride?: LaunchOverride;
         }) => Promise<{
             sessionId: string;
             threadId: string;
@@ -297,6 +298,16 @@ interface MetadataServerOptions {
             status: "graveyard";
             previousStatus: "running" | "offline";
         };
+        recordBackendSessionId?: (input: {
+            sessionId: string;
+            backendSessionId: string;
+        }) => Promise<{
+            sessionId: string;
+            backendSessionId: string;
+        }> | {
+            sessionId: string;
+            backendSessionId: string;
+        };
         sendAgentInput?: (input: {
             sessionId: string;
             text: string;

package/dist/metadata-server.js

@@ -3,6 +3,7 @@ import { createHash, randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { getDashboardClientUiStatePath, getPlansDir, getProjectId, getProjectStateDir } from "./paths.js";
+import { writeJsonAtomic } from "./atomic-write.js";
 import { updateSessionMetadata, clearSessionLogs, saveMetadataEndpoint, loadMetadataState, } from "./metadata-store.js";
 import { contextualizeAlertInput, mergeDisplayContext, metadataDisplayContext, } from "./alert-display.js";
 import { notifyAlert } from "./notify.js";
@@ -16,7 +17,7 @@ import { readAllTasks, readTask } from "./tasks.js";
 import { buildWorkflowEntries } from "./workflow.js";
 import { markLastUsed } from "./last-used.js";
 import { formatRelativeRecency } from "./recency.js";
-import { getAttachment, getAttachmentContent } from "./attachment-store.js";
+import { createUploadedAttachment, getAttachment, getAttachmentContent, getAttachmentRecord, } from "./attachment-store.js";
 import { ProjectEventBus } from "./project-events.js";
 import { getProjectServiceManifest } from "./project-service-manifest.js";
 import { applyShellStateTransition } from "./shell-state.js";
@@ -78,7 +79,7 @@ function persistDashboardClientPreference(clientSession, update) {
     }
     catch { }
     update(snapshot);
-    writeFileSync(path, JSON.stringify(snapshot, null, 2) + "\n");
+    writeJsonAtomic(path, snapshot);
 }
 function persistDashboardReturnSelection(tmux, projectRoot, currentClientSession, currentWindowId) {
     persistDashboardClientPreference(currentClientSession, (snapshot) => {
@@ -177,6 +178,16 @@ function sendBytes(res, status, body, mimeType) {
     res.setHeader("connection", "close");
     res.end(body);
 }
+function formatAgentInputWithAttachments(text, attachments) {
+    const trimmedText = text.trim();
+    if (attachments.length === 0)
+        return text;
+    const body = trimmedText || "Please review the attached image file(s).";
+    const attachmentLines = attachments.map((attachment) => {
+        return `- ${attachment.filename} (${attachment.mimeType}, ${attachment.sizeBytes} bytes): ${attachment.contentPath}`;
+    });
+    return `${body}\n\nAttached image files:\n${attachmentLines.join("\n")}`;
+}
 function sendSseEvent(res, event, data) {
     res.write(`event: ${event}\n`);
     res.write(`data: ${JSON.stringify(data)}\n\n`);
@@ -1937,6 +1948,17 @@ export class MetadataServer {
                 send(res, 200, { ok: true, ...result });
                 return;
             }
+            if (req.method === "POST" && url.pathname === "/agents/record-backend-session") {
+                const body = (await readJson(req));
+                if (!this.options.lifecycle?.recordBackendSessionId) {
+                    send(res, 501, { ok: false, error: "backend session recording not supported by this service" });
+                    return;
+                }
+                const result = await this.options.lifecycle.recordBackendSessionId(body);
+                this.options.onChange?.();
+                send(res, 200, { ok: true, ...result });
+                return;
+            }
             if (req.method === "POST" && url.pathname === "/agents/interrupt") {
                 const body = (await readJson(req));
                 if (!this.options.lifecycle?.interruptAgent) {
@@ -1989,19 +2011,53 @@ export class MetadataServer {
                     return;
                 }
                 const text = typeof body.text === "string" ? body.text : "";
-                if (!text.trim()) {
+                const attachmentIds = Array.isArray(body.attachmentIds)
+                    ? body.attachmentIds
+                        .filter((id) => typeof id === "string")
+                        .map((id) => id.trim())
+                        .filter(Boolean)
+                    : [];
+                if (!text.trim() && attachmentIds.length === 0) {
                     send(res, 400, { ok: false, error: "text is required" });
                     return;
                 }
+                const attachments = attachmentIds.map((id) => getAttachmentRecord(id));
+                const missingAttachmentId = attachmentIds.find((_, index) => attachments[index] === null);
+                if (missingAttachmentId) {
+                    send(res, 400, { ok: false, error: `attachment not found: ${missingAttachmentId}` });
+                    return;
+                }
                 if (!this.options.lifecycle?.sendAgentInput) {
                     send(res, 501, { ok: false, error: "agent input not supported by this service" });
                     return;
                 }
-                const result = await this.options.lifecycle.sendAgentInput({ sessionId, text });
+                const formattedText = formatAgentInputWithAttachments(text, attachments.filter((entry) => !!entry));
+                const result = await this.options.lifecycle.sendAgentInput({ sessionId, text: formattedText });
                 this.options.onChange?.();
                 send(res, 200, { ok: true, ...result });
                 return;
             }
+            if (req.method === "POST" && url.pathname === "/attachments") {
+                const body = (await readJson(req));
+                if (typeof body.filename !== "string" ||
+                    typeof body.mimeType !== "string" ||
+                    typeof body.dataBase64 !== "string") {
+                    send(res, 400, { ok: false, error: "filename, mimeType, and dataBase64 are required" });
+                    return;
+                }
+                try {
+                    const attachment = createUploadedAttachment({
+                        filename: body.filename,
+                        mimeType: body.mimeType,
+                        dataBase64: body.dataBase64,
+                    });
+                    send(res, 200, { ok: true, attachment });
+                }
+                catch (error) {
+                    send(res, 400, { ok: false, error: error instanceof Error ? error.message : "invalid attachment" });
+                }
+                return;
+            }
             const attachmentContentMatch = url.pathname.match(/^\/attachments\/([^/]+)\/content$/);
             if (req.method === "GET" && attachmentContentMatch) {
                 const content = getAttachmentContent(decodeURIComponent(attachmentContentMatch[1] || ""));
@@ -2254,4 +2310,3 @@ export class MetadataServer {
         send(res, 404, { ok: false, error: "not found" });
     }
 }
-//# sourceMappingURL=metadata-server.js.map

package/dist/metadata-store.js

@@ -1,6 +1,6 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { writeJsonAtomic } from "./atomic-write.js";
+import { quarantineCorruptFile, writeJsonAtomic, writeTextAtomic } from "./atomic-write.js";
 import { getProjectStateDir, getProjectStateDirFor } from "./paths.js";
 function ensureParent(path) {
     mkdirSync(dirname(path), { recursive: true });
@@ -21,6 +21,7 @@ function loadJson(path, fallback) {
         return JSON.parse(readFileSync(path, "utf-8"));
     }
     catch {
+        quarantineCorruptFile(path);
         return fallback;
     }
 }
@@ -94,7 +95,7 @@ export function saveMetadataEndpoint(endpoint, projectRoot) {
     saveJson(endpointPathFor(projectRoot), endpoint);
     const textPath = endpointTextPathFor(projectRoot);
     ensureParent(textPath);
-    writeFileSync(textPath, `http://${endpoint.host}:${endpoint.port}\n`);
+    writeTextAtomic(textPath, `http://${endpoint.host}:${endpoint.port}\n`);
 }
 export function removeMetadataEndpoint(projectRoot) {
     try {
@@ -110,4 +111,3 @@ export function removeMetadataEndpoint(projectRoot) {
     }
     catch { }
 }
-//# sourceMappingURL=metadata-store.js.map

package/dist/mobile-push-bridge.d.ts

@@ -0,0 +1,8 @@
+import type { AlertEvent } from "./project-events.js";
+/**
+ * Forwards an alert that already passed desktop notification gating to the
+ * daemon, which relays it to the owner's mobile devices. Fire-and-forget: the
+ * daemon owns the single relay connection, so the project service hands off and
+ * never blocks the alert path on push delivery.
+ */
+export declare function forwardAlertToMobilePush(event: AlertEvent): void;

package/dist/mobile-push-bridge.js

@@ -0,0 +1,22 @@
+import { requestDaemonJson } from "./daemon.js";
+/**
+ * Forwards an alert that already passed desktop notification gating to the
+ * daemon, which relays it to the owner's mobile devices. Fire-and-forget: the
+ * daemon owns the single relay connection, so the project service hands off and
+ * never blocks the alert path on push delivery.
+ */
+export function forwardAlertToMobilePush(event) {
+    void requestDaemonJson("/internal/push", {
+        method: "POST",
+        body: JSON.stringify({
+            title: event.title || "aimux",
+            body: event.message || event.sessionId || event.kind,
+            kind: event.kind,
+            sessionId: event.sessionId,
+            projectId: event.projectId,
+            projectRoot: process.cwd(),
+            dedupeKey: event.dedupeKey,
+        }),
+        headers: { "content-type": "application/json" },
+    }).catch(() => { });
+}

package/dist/mobile-push-throttle.d.ts

@@ -0,0 +1,23 @@
+export interface ThrottleInput {
+    dedupeKey?: string;
+    sessionId?: string;
+    kind?: string;
+    title?: string;
+    body?: string;
+}
+/**
+ * In-memory guard for outbound mobile pushes. Collapses identical alerts
+ * re-emitted within a TTL window (chatty idle/needs_input polling) and caps the
+ * push rate per session so one runaway agent cannot flood the device.
+ */
+export declare class MobilePushThrottle {
+    private readonly dedupeTtlMs;
+    private readonly sessionLimit;
+    private readonly sessionWindowMs;
+    private readonly now;
+    private readonly lastByKey;
+    private readonly sessionHits;
+    constructor(dedupeTtlMs?: number, sessionLimit?: number, sessionWindowMs?: number, now?: () => number);
+    allow(input: ThrottleInput): boolean;
+    private prune;
+}

package/dist/mobile-push-throttle.js

@@ -0,0 +1,53 @@
+const DEDUPE_TTL_MS = 60_000;
+const SESSION_WINDOW_MS = 60_000;
+const SESSION_LIMIT = 5;
+/**
+ * In-memory guard for outbound mobile pushes. Collapses identical alerts
+ * re-emitted within a TTL window (chatty idle/needs_input polling) and caps the
+ * push rate per session so one runaway agent cannot flood the device.
+ */
+export class MobilePushThrottle {
+    dedupeTtlMs;
+    sessionLimit;
+    sessionWindowMs;
+    now;
+    lastByKey = new Map();
+    sessionHits = new Map();
+    constructor(dedupeTtlMs = DEDUPE_TTL_MS, sessionLimit = SESSION_LIMIT, sessionWindowMs = SESSION_WINDOW_MS, now = () => Date.now()) {
+        this.dedupeTtlMs = dedupeTtlMs;
+        this.sessionLimit = sessionLimit;
+        this.sessionWindowMs = sessionWindowMs;
+        this.now = now;
+    }
+    allow(input) {
+        const ts = this.now();
+        this.prune(ts);
+        const key = input.dedupeKey?.trim() || [input.sessionId, input.kind, input.title, input.body].map((p) => p ?? "").join("|");
+        const last = this.lastByKey.get(key);
+        if (last !== undefined && ts - last < this.dedupeTtlMs)
+            return false;
+        const session = input.sessionId?.trim() || "_global";
+        const hits = (this.sessionHits.get(session) ?? []).filter((t) => ts - t < this.sessionWindowMs);
+        if (hits.length >= this.sessionLimit) {
+            this.sessionHits.set(session, hits);
+            return false;
+        }
+        hits.push(ts);
+        this.sessionHits.set(session, hits);
+        this.lastByKey.set(key, ts);
+        return true;
+    }
+    prune(ts) {
+        for (const [key, t] of this.lastByKey) {
+            if (ts - t >= this.dedupeTtlMs)
+                this.lastByKey.delete(key);
+        }
+        for (const [session, hits] of this.sessionHits) {
+            const fresh = hits.filter((t) => ts - t < this.sessionWindowMs);
+            if (fresh.length === 0)
+                this.sessionHits.delete(session);
+            else
+                this.sessionHits.set(session, fresh);
+        }
+    }
+}

package/dist/multiplexer/agent-io-methods.js

@@ -150,4 +150,3 @@ export const agentIoMethods = {
         return readAgentOutputImpl(this, sessionId, startLine);
     },
 };
-//# sourceMappingURL=agent-io-methods.js.map

package/dist/multiplexer/archives.js

@@ -384,4 +384,3 @@ export function openPlanInEditor(host, path) {
         host.renderDashboardErrorOverlay();
     }
 }
-//# sourceMappingURL=archives.js.map

package/dist/multiplexer/dashboard-actions-methods.js

@@ -184,4 +184,3 @@ export const dashboardActionMethods = {
         handleToolOptionsKeyImpl(this, data);
     },
 };
-//# sourceMappingURL=dashboard-actions-methods.js.map

package/dist/multiplexer/dashboard-control.js

@@ -673,4 +673,3 @@ export function handleOrchestrationRoutePickerKey(host, data) {
         showOrchestrationInput(host, mode, target);
     }
 }
-//# sourceMappingURL=dashboard-control.js.map

package/dist/multiplexer/dashboard-interaction.js

@@ -870,4 +870,3 @@ export const dashboardInteractionMethods = {
         this.renderDashboard();
     },
 };
-//# sourceMappingURL=dashboard-interaction.js.map

package/dist/multiplexer/dashboard-model.js

@@ -819,7 +819,7 @@ export async function startProjectServices(host) {
                 targetSessionId: input.sessionId,
                 targetWorktreePath: input.worktreePath,
                 open: input.open ?? false,
-                extraArgs: input.extraArgs,
+                launchOverride: input.launchOverride,
             }), input.sessionId
                 ? buildMetadataPendingSessionSeed({
                     sessionId: input.sessionId,
@@ -862,7 +862,7 @@ export async function startProjectServices(host) {
                 instruction: input.instruction,
                 targetWorktreePath: input.worktreePath,
                 open: input.open ?? false,
-                extraArgs: input.extraArgs,
+                launchOverride: input.launchOverride,
             }), input.targetSessionId
                 ? buildMetadataPendingSessionSeed({
                     sessionId: input.targetSessionId,
@@ -876,6 +876,7 @@ export async function startProjectServices(host) {
             renameAgent: (input) => host.renameAgent(input.sessionId, input.label),
             migrateAgent: (input) => withMetadataSessionPending(host, input.sessionId, "migrating", () => host.migrateAgent(input.sessionId, input.worktreePath), findDashboardSessionSeed(host, input.sessionId)),
             killAgent: (input) => withMetadataSessionPending(host, input.sessionId, "graveyarding", () => host.sendAgentToGraveyard(input.sessionId), findDashboardSessionSeed(host, input.sessionId)),
+            recordBackendSessionId: (input) => host.recordSessionBackendSessionId(input.sessionId, input.backendSessionId),
             sendAgentInput: (input) => host.sendAgentInput(input.sessionId, input.text),
             readAgentOutput: (input) => host.readAgentOutput(input.sessionId, input.startLine),
         },
@@ -935,4 +936,3 @@ async function ensureDashboardControlPlane(host) {
         host.dashboardServiceRecovery = null;
     }
 }
-//# sourceMappingURL=dashboard-model.js.map

package/dist/multiplexer/dashboard-ops.d.ts

@@ -1,12 +1,13 @@
 import type { DashboardService, DashboardSession } from "../dashboard/index.js";
 import type { PendingServiceActionKind, PendingSessionActionKind } from "../pending-actions.js";
+import type { LaunchOverride } from "../shell-args.js";
 type DashboardOpsHost = any;
 export declare function runDashboardOperation<T>(host: DashboardOpsHost, title: string, lines: string[], work: () => Promise<T> | T, errorTitle?: string): Promise<T | undefined>;
 export declare function spawnDashboardAgentWithFeedback(host: DashboardOpsHost, input: {
     sessionId: string;
     tool: string;
     worktreePath?: string;
-    extraArgs?: string[];
+    launchOverride?: LaunchOverride;
 }): Promise<void>;
 export declare function forkDashboardAgentWithFeedback(host: DashboardOpsHost, input: {
     sourceSessionId: string;
@@ -14,7 +15,7 @@ export declare function forkDashboardAgentWithFeedback(host: DashboardOpsHost, i
     tool: string;
     instruction?: string;
     worktreePath?: string;
-    extraArgs?: string[];
+    launchOverride?: LaunchOverride;
 }): Promise<void>;
 export declare function setPendingDashboardSessionAction(host: DashboardOpsHost, sessionId: string, kind: PendingSessionActionKind | null, opts?: {
     sessionSeed?: DashboardSession;

package/dist/multiplexer/dashboard-ops.js

@@ -300,7 +300,7 @@ export async function spawnDashboardAgentWithFeedback(host, input) {
                 tool: input.tool,
                 sessionId: input.sessionId,
                 worktreePath: input.worktreePath,
-                extraArgs: input.extraArgs,
+                launchOverride: input.launchOverride,
                 open: false,
             }, { timeoutMs: 10_000 });
         },
@@ -330,7 +330,7 @@ export async function forkDashboardAgentWithFeedback(host, input) {
                 tool: input.tool,
                 instruction: input.instruction,
                 worktreePath: input.worktreePath,
-                extraArgs: input.extraArgs,
+                launchOverride: input.launchOverride,
                 open: false,
             }, { timeoutMs: 10_000 });
         },
@@ -778,4 +778,3 @@ export async function migrateSessionWithFeedback(host, session, targetPath, targ
         errorTitle: `Failed to migrate "${label}"`,
     });
 }
-//# sourceMappingURL=dashboard-ops.js.map

package/dist/multiplexer/dashboard-state-methods.js

@@ -225,4 +225,3 @@ export const dashboardStateMethods = {
         await startProjectServicesImpl(this);
     },
 };
-//# sourceMappingURL=dashboard-state-methods.js.map

package/dist/multiplexer/dashboard-tail-methods.d.ts

@@ -3,6 +3,7 @@ import type { Multiplexer, SessionState } from "./index.js";
 import { dashboardSessionActionDeps as dashboardSessionActionDepsImpl } from "./dashboard-ops.js";
 import type { PendingServiceActionKind, PendingSessionActionKind } from "../pending-actions.js";
 import type { SessionRuntime } from "../session-runtime.js";
+import type { LaunchOverride } from "../shell-args.js";
 export type DashboardTailMethods = {
     forkAgent(this: Multiplexer, opts: {
         sourceSessionId: string;
@@ -11,7 +12,7 @@ export type DashboardTailMethods = {
         instruction?: string;
         targetWorktreePath?: string;
         open?: boolean;
-        extraArgs?: string[];
+        launchOverride?: LaunchOverride;
     }): Promise<{
         sessionId: string;
         threadId: string;
@@ -21,7 +22,7 @@ export type DashboardTailMethods = {
         targetSessionId?: string;
         targetWorktreePath?: string;
         open?: boolean;
-        extraArgs?: string[];
+        launchOverride?: LaunchOverride;
     }): Promise<{
         sessionId: string;
     }>;

package/dist/multiplexer/dashboard-tail-methods.js

@@ -55,7 +55,7 @@ function refreshLifecycleViews(host) {
 }
 export const dashboardTailMethods = {
     async forkAgent(opts) {
-        const result = await this.forkSessionFromSource(opts.sourceSessionId, opts.targetToolConfigKey, opts.targetSessionId, opts.instruction, opts.targetWorktreePath, opts.extraArgs ?? []);
+        const result = await this.forkSessionFromSource(opts.sourceSessionId, opts.targetToolConfigKey, opts.targetSessionId, opts.instruction, opts.targetWorktreePath, opts.launchOverride);
         if (!result) {
             throw new Error(`Unable to fork agent "${opts.sourceSessionId}"`);
         }
@@ -71,7 +71,7 @@ export const dashboardTailMethods = {
             throw new Error(`Unknown tool config: ${opts.toolConfigKey}`);
         }
         const sessionId = opts.targetSessionId ?? this.generateDashboardSessionId?.(tool.command);
-        const transport = this.createSession(tool.command, [...tool.args, ...(opts.extraArgs ?? [])], tool.preambleFlag, opts.toolConfigKey, undefined, tool.sessionIdFlag, opts.targetWorktreePath, undefined, sessionId, !opts.open);
+        const transport = this.createSession(opts.launchOverride?.command ?? tool.command, opts.launchOverride?.args ?? tool.args, tool.preambleFlag, opts.toolConfigKey, undefined, tool.sessionIdFlag, opts.targetWorktreePath, undefined, sessionId, !opts.open, false, undefined, opts.launchOverride?.env);
         if (opts.open) {
             this.openLiveTmuxWindowForEntry({ id: transport.id });
         }
@@ -378,4 +378,3 @@ export const dashboardTailMethods = {
         return orderDashboardSessionsByVisualWorktree(allDash, worktreePaths, mainRepoPath);
     },
 };
-//# sourceMappingURL=dashboard-tail-methods.js.map

package/dist/multiplexer/dashboard-view-methods.js

@@ -2,6 +2,7 @@ import { closeNotificationPanel as closeNotificationPanelImpl, handleNotificatio
 import { beginWorktreeRemoval as beginWorktreeRemovalImpl, finishWorktreeRemoval as finishWorktreeRemovalImpl, handleWorktreeInputKey as handleWorktreeInputKeyImpl, handleWorktreeRemoveConfirmKey as handleWorktreeRemoveConfirmKeyImpl, handleWorktreeListKey as handleWorktreeListKeyImpl, renderWorktreeInput as renderWorktreeInputImpl, renderWorktreeList as renderWorktreeListImpl, renderWorktreeRemoveConfirm as renderWorktreeRemoveConfirmImpl, showWorktreeCreatePrompt as showWorktreeCreatePromptImpl, showWorktreeList as showWorktreeListImpl, } from "./worktrees.js";
 import { createService as createServiceImpl, removeOfflineService as removeOfflineServiceImpl, resumeOfflineService as resumeOfflineServiceImpl, resumeOfflineServiceById as resumeOfflineServiceByIdImpl, serviceLabelForCommand as serviceLabelForCommandImpl, stopService as stopServiceImpl, } from "./services.js";
 import { derivedStatusLabel } from "../dashboard/index.js";
+import { isDevelopmentRuntime } from "../connection-targets.js";
 import { selectDashboardTeammates } from "../dashboard/session-registry.js";
 import { hasRuntimeEvidence, isAttachableDashboardSessionEntry } from "../dashboard/runtime-evidence.js";
 export const dashboardViewMethods = {
@@ -113,6 +114,7 @@ export const dashboardViewMethods = {
                 selectedServiceId: selectedService,
                 selectedTeammates: selectDashboardTeammates(dashTeammates, selectedSessionEntry),
                 runtimeLabel: "tmux",
+                isDevRuntime: isDevelopmentRuntime(),
                 mainCheckout: mainCheckoutInfo,
                 operationFailures: this.dashboardOperationFailuresCache ?? [],
                 worktreeRemoval: this.worktreeRemovalJob
@@ -214,4 +216,3 @@ export const dashboardViewMethods = {
         handleWorktreeListKeyImpl(this, data);
     },
 };
-//# sourceMappingURL=dashboard-view-methods.js.map

package/dist/multiplexer/graveyard-view-model.js

@@ -221,4 +221,3 @@ function compareRecencyOrCreated(left, leftLastUsedAt, right, rightLastUsedAt) {
     const rightCreated = parseRecencyTimestamp(right.createdAt) ?? 0;
     return rightCreated - leftCreated || left.id.localeCompare(right.id);
 }
-//# sourceMappingURL=graveyard-view-model.js.map

package/dist/multiplexer/index.d.ts

@@ -185,7 +185,7 @@ export declare class Multiplexer {
      * Starts fresh sessions but with context from the previous conversation.
      */
     restoreSessions(toolFilter?: string): Promise<number>;
-    createSession(command: string, args: string[], preambleFlag?: string[], toolConfigKey?: string, extraPreamble?: string, sessionIdFlag?: string[], worktreePath?: string, backendSessionIdOverride?: string, sessionIdOverride?: string, detachedInTmux?: boolean, suppressStartupPreamble?: boolean, team?: SessionTeamMetadata): SessionTransport;
+    createSession(command: string, args: string[], preambleFlag?: string[], toolConfigKey?: string, extraPreamble?: string, sessionIdFlag?: string[], worktreePath?: string, backendSessionIdOverride?: string, sessionIdOverride?: string, detachedInTmux?: boolean, suppressStartupPreamble?: boolean, team?: SessionTeamMetadata, launchEnv?: Record<string, string>): SessionTransport;
     recordSessionBackendSessionId(sessionId: string, backendSessionId: string): {
         sessionId: string;
         backendSessionId: string;

package/dist/multiplexer/index.js

@@ -317,8 +317,8 @@ export class Multiplexer {
     async restoreSessions(toolFilter) {
         return restoreSessionsImpl(this, toolFilter);
     }
-    createSession(command, args, preambleFlag, toolConfigKey, extraPreamble, sessionIdFlag, worktreePath, backendSessionIdOverride, sessionIdOverride, detachedInTmux = false, suppressStartupPreamble = false, team) {
-        return createSessionImpl(this, command, args, preambleFlag, toolConfigKey, extraPreamble, sessionIdFlag, worktreePath, backendSessionIdOverride, sessionIdOverride, detachedInTmux, suppressStartupPreamble, team);
+    createSession(command, args, preambleFlag, toolConfigKey, extraPreamble, sessionIdFlag, worktreePath, backendSessionIdOverride, sessionIdOverride, detachedInTmux = false, suppressStartupPreamble = false, team, launchEnv) {
+        return createSessionImpl(this, command, args, preambleFlag, toolConfigKey, extraPreamble, sessionIdFlag, worktreePath, backendSessionIdOverride, sessionIdOverride, detachedInTmux, suppressStartupPreamble, team, launchEnv);
     }
     recordSessionBackendSessionId(sessionId, backendSessionId) {
         return runtimeLifecycleMethods.recordSessionBackendSessionId.call(this, sessionId, backendSessionId);
@@ -348,7 +348,7 @@ export class Multiplexer {
     handleAction(action) {
         handleActionImpl(this, action);
     }
-    async forkSessionFromSource(sourceSessionId, targetToolConfigKey, requestedTargetSessionId, instruction, targetWorktreePath, extraArgs = []) {
+    async forkSessionFromSource(sourceSessionId, targetToolConfigKey, requestedTargetSessionId, instruction, targetWorktreePath, launchOverride) {
         const sourceSession = this.sessions.find((session) => session.id === sourceSessionId);
         if (!sourceSession) {
             this.showDashboardError("Cannot fork missing session", [`Source session ${sourceSessionId} not found.`]);
@@ -402,7 +402,7 @@ export class Multiplexer {
         ]
             .filter(Boolean)
             .join("\n\n");
-        const transport = this.createSession(toolCfg.command, [...toolCfg.args, ...extraArgs], toolCfg.preambleFlag, targetToolConfigKey, extraPreamble, toolCfg.sessionIdFlag, targetWorktree, undefined, targetSessionId, !toolCfg.preambleFlag);
+        const transport = this.createSession(launchOverride?.command ?? toolCfg.command, launchOverride?.args ?? toolCfg.args, toolCfg.preambleFlag, targetToolConfigKey, extraPreamble, toolCfg.sessionIdFlag, targetWorktree, undefined, targetSessionId, !toolCfg.preambleFlag, false, undefined, launchOverride?.env);
         this.agentTracker.emit(sourceSessionId, {
             kind: "status",
             message: `Forked ${targetSessionId} from this session`,
@@ -460,4 +460,3 @@ export class Multiplexer {
     }
 }
 Object.assign(Multiplexer.prototype, dashboardInteractionMethods, dashboardViewMethods, dashboardActionMethods, dashboardTailMethods, persistenceMethods, dashboardStateMethods, agentIoMethods, runtimeLifecycleMethods);
-//# sourceMappingURL=index.js.map

package/dist/multiplexer/navigation.js

@@ -225,4 +225,3 @@ export function handleMigratePickerKey(host, data) {
         host.focusSession(host.activeIndex);
     }
 }
-//# sourceMappingURL=navigation.js.map

package/dist/multiplexer/notifications.js

@@ -361,4 +361,3 @@ export function handleNotificationsKey(host, data) {
         void openSelectedNotification(host);
     }
 }
-//# sourceMappingURL=notifications.js.map

package/dist/multiplexer/persistence-methods.js

@@ -5,6 +5,7 @@ import { addDashboardOperationFailure, clearDashboardOperationFailures, listDash
 import { composeDashboardWorktreeGroups } from "./dashboard-model.js";
 import { loadDaemonInfo } from "../daemon.js";
 import { getProjectStateDir, getStatePath } from "../paths.js";
+import { writeJsonAtomic } from "../atomic-write.js";
 import { loadMetadataState } from "../metadata-store.js";
 import { createRuntimeExchangeStore } from "../runtime-core/exchange-store.js";
 import { renderCurrentDashboardView as renderCurrentDashboardViewImpl } from "./runtime-state.js";
@@ -855,7 +856,7 @@ function removePersistedServicesForWorktree(path) {
         const nextServices = (state.services ?? []).filter((service) => service.worktreePath !== path);
         if (nextServices.length === (state.services ?? []).length)
             return;
-        writeFileSync(statePath, JSON.stringify({ ...state, services: nextServices }, null, 2) + "\n");
+        writeJsonAtomic(statePath, { ...state, services: nextServices });
     }
     catch { }
 }
@@ -874,4 +875,3 @@ function markLifecycleUsed(host, itemId) {
     }
     catch { }
 }
-//# sourceMappingURL=persistence-methods.js.map

package/dist/multiplexer/runtime-lifecycle-methods.js

@@ -4,6 +4,7 @@ import { join } from "node:path";
 import { closeDebug, debug } from "../debug.js";
 import { loadConfig } from "../config.js";
 import { getStatePath } from "../paths.js";
+import { quarantineCorruptFile, writeJsonAtomic } from "../atomic-write.js";
 import { buildAimuxAgentInstructions } from "../session-bootstrap.js";
 import { listTopologySessionStates, saveRuntimeTopologySessions } from "../runtime-core/topology-sessions.js";
 import { adjustAfterRemove as adjustAfterRemoveImpl, buildLiveServiceStates as buildLiveServiceStatesImpl, evictZombieSession as evictZombieSessionImpl, graveyardSession as graveyardSessionImpl, isSessionRuntimeLive as isSessionRuntimeLiveImpl, loadOfflineServices as loadOfflineServicesImpl, loadOfflineTopologySessions as loadOfflineTopologySessionsImpl, restoreTmuxSessionsFromTopology as restoreTmuxSessionsFromTopologyImpl, recordSessionBackendSessionId as recordSessionBackendSessionIdImpl, resumeOfflineSession as resumeOfflineSessionImpl, startHeartbeat as startHeartbeatImpl, startProjectServiceRefresh as startProjectServiceRefreshImpl, startStatusRefresh as startStatusRefreshImpl, stopHeartbeat as stopHeartbeatImpl, stopProjectServiceRefresh as stopProjectServiceRefreshImpl, stopSessionToOffline as stopSessionToOfflineImpl, stopStatusRefresh as stopStatusRefreshImpl, syncSessionsFromTopology as syncSessionsFromTopologyImpl, } from "./runtime-state.js";
@@ -92,6 +93,7 @@ export function loadStateStatic() {
         };
     }
     catch {
+        quarantineCorruptFile(statePath);
         return null;
     }
 }
@@ -261,7 +263,9 @@ export const runtimeLifecycleMethods = {
                 });
                 mergedServices = [...otherServices, ...myServices];
             }
-            catch { }
+            catch {
+                quarantineCorruptFile(statePath);
+            }
         }
         saveRuntimeTopologySessions({ sessions: mergedSessions });
         unpreservedExitedIds.clear();
@@ -270,7 +274,7 @@ export const runtimeLifecycleMethods = {
             cwd: process.cwd(),
             services: mergedServices,
         };
-        writeFileSync(statePath, JSON.stringify(state, null, 2) + "\n");
+        writeJsonAtomic(statePath, state);
         this.invalidateDesktopStateSnapshot();
     },
     teardown() {
@@ -324,4 +328,3 @@ export const runtimeLifecycleMethods = {
         process.exit(0);
     },
 };
-//# sourceMappingURL=runtime-lifecycle-methods.js.map