aimux-cli 0.1.0

package/dist/fast-control.js

@@ -0,0 +1,174 @@
+import { resolve as pathResolve } from "node:path";
+import { loadMetadataState } from "./metadata-store.js";
+import { compareLastUsed, getLastUsedAt, getRecentRankMap } from "./last-used.js";
+import { parseRecencyTimestamp } from "./recency.js";
+import { isDashboardWindowName, TmuxRuntimeManager, } from "./tmux-runtime-manager.js";
+import { compactSessionTitle } from "./statusline-model.js";
+import { listWorktrees } from "./worktree.js";
+export function navigationUrgencyScore(input) {
+    if (input.semantic) {
+        const semanticAttention = input.semantic.attention;
+        if (semanticAttention === "error")
+            return 5;
+        if (semanticAttention === "needs_input")
+            return 4;
+        if (semanticAttention === "blocked")
+            return 3;
+        if ((input.semantic.unseenCount ?? 0) > 0)
+            return 2;
+        if (input.semantic.activity === "done")
+            return 1;
+        return 0;
+    }
+    if (input.attention === "error")
+        return 5;
+    if (input.attention === "needs_input")
+        return 4;
+    if (input.attention === "blocked")
+        return 3;
+    if ((input.unseenCount ?? 0) > 0)
+        return 2;
+    if (input.activity === "done")
+        return 1;
+    return 0;
+}
+export function resolveScopedWorktreePath(projectRoot, currentPath) {
+    const fallback = pathResolve(currentPath || projectRoot);
+    const worktrees = listWorktrees(projectRoot)
+        .map((worktree) => pathResolve(worktree.path))
+        .sort((a, b) => b.length - a.length);
+    const match = worktrees.find((worktreePath) => fallback === worktreePath || fallback.startsWith(`${worktreePath}/`));
+    return match ?? fallback;
+}
+function resolveContextWorktreePath(context, tmux, managedWindows) {
+    const byWindowId = context.currentWindowId
+        ? managedWindows.find((entry) => entry.target.windowId === context.currentWindowId)
+        : undefined;
+    if (byWindowId?.metadata.worktreePath) {
+        return pathResolve(byWindowId.metadata.worktreePath);
+    }
+    const currentClientSession = context.currentClientSession?.trim();
+    if (currentClientSession) {
+        const currentClientWindow = tmux
+            .listWindows(currentClientSession)
+            .find((window) => window.active && !isDashboardWindowName(window.name));
+        if (currentClientWindow) {
+            const byActiveClientWindow = managedWindows.find((entry) => entry.target.windowId === currentClientWindow.id);
+            if (byActiveClientWindow?.metadata.worktreePath) {
+                return pathResolve(byActiveClientWindow.metadata.worktreePath);
+            }
+        }
+    }
+    return resolveScopedWorktreePath(context.projectRoot, context.currentPath);
+}
+function urgencyFor(projectRoot, sessionId) {
+    if (!sessionId)
+        return 0;
+    const derived = loadMetadataState(projectRoot).sessions[sessionId]?.derived;
+    return navigationUrgencyScore(derived ?? {});
+}
+export function listSwitchableAgentItems(context, tmux = new TmuxRuntimeManager()) {
+    const tmuxSession = tmux.getProjectSession(context.projectRoot);
+    const recentRankMap = getRecentRankMap(context.projectRoot, context.currentClientSession);
+    const managedWindows = tmux.listManagedWindows(tmuxSession.sessionName);
+    const scopedWorktreePath = resolveContextWorktreePath(context, tmux, managedWindows);
+    let managed = managedWindows
+        .filter(({ target, metadata }) => {
+        if (isDashboardWindowName(target.windowName))
+            return false;
+        const worktreePath = metadata.worktreePath || context.projectRoot;
+        return pathResolve(worktreePath) === scopedWorktreePath;
+    })
+        .sort((a, b) => {
+        const kindRank = a.metadata.kind === "service" ? 1 : 0;
+        const otherKindRank = b.metadata.kind === "service" ? 1 : 0;
+        if (kindRank !== otherKindRank)
+            return kindRank - otherKindRank;
+        return a.target.windowIndex - b.target.windowIndex;
+    })
+        .map((entry) => ({
+        ...entry,
+        id: entry.metadata.sessionId,
+        label: compactSessionTitle({
+            kind: entry.metadata.kind === "service" ? "service" : "agent",
+            tool: entry.metadata.command || entry.target.windowName,
+            label: entry.metadata.label,
+            role: entry.metadata.role,
+            id: entry.metadata.sessionId,
+        }),
+        urgency: urgencyFor(context.projectRoot, entry.metadata.sessionId),
+        activity: entry.target.windowIndex,
+        lastUsedAt: getLastUsedAt(context.projectRoot, entry.metadata.sessionId),
+        recentRank: recentRankMap.get(entry.metadata.sessionId) ?? Number.MAX_SAFE_INTEGER,
+    }));
+    const activityByWindowId = new Map(tmux.listWindows(tmuxSession.sessionName).map((window) => [window.id, window.activity ?? 0]));
+    managed = managed.map((entry) => ({
+        ...entry,
+        activity: activityByWindowId.get(entry.target.windowId) ?? 0,
+    }));
+    return managed;
+}
+export function resolveCurrentAgentIndex(items, context) {
+    const byId = context.currentWindowId
+        ? items.findIndex(({ target }) => target.windowId === context.currentWindowId)
+        : -1;
+    if (byId >= 0)
+        return byId;
+    return items.findIndex(({ target, metadata }) => target.windowName === context.currentWindow || metadata.label === context.currentWindow);
+}
+export function resolveNextAgent(context, tmux = new TmuxRuntimeManager()) {
+    const items = listSwitchableAgentItems(context, tmux);
+    if (items.length === 0)
+        return null;
+    const currentIndex = resolveCurrentAgentIndex(items, context);
+    const resolvedIndex = currentIndex >= 0 ? currentIndex : 0;
+    return items[(resolvedIndex + 1) % items.length] ?? null;
+}
+export function resolvePrevAgent(context, tmux = new TmuxRuntimeManager()) {
+    const items = listSwitchableAgentItems(context, tmux);
+    if (items.length === 0)
+        return null;
+    const currentIndex = resolveCurrentAgentIndex(items, context);
+    const resolvedIndex = currentIndex >= 0 ? currentIndex : 0;
+    return items[(resolvedIndex - 1 + items.length) % items.length] ?? null;
+}
+export function resolveAttentionAgent(context, tmux = new TmuxRuntimeManager()) {
+    const items = listSwitchableAgentItems(context, tmux)
+        .filter((entry) => entry.urgency > 0)
+        .sort((a, b) => b.urgency - a.urgency);
+    if (items.length === 0)
+        return null;
+    const nonCurrent = items.find(({ target, metadata }) => {
+        return (target.windowId !== context.currentWindowId &&
+            target.windowName !== context.currentWindow &&
+            metadata.label !== context.currentWindow);
+    });
+    return nonCurrent ?? items[0] ?? null;
+}
+export function serializeFastControlItem(item) {
+    return {
+        target: item.target,
+        id: item.metadata.sessionId,
+        metadata: item.metadata,
+        label: item.label,
+        urgency: item.urgency,
+        activity: item.activity,
+        lastUsedAt: item.lastUsedAt,
+        recentRank: item.recentRank,
+    };
+}
+export function listSwitchableAgentMenuItems(context, tmux = new TmuxRuntimeManager()) {
+    const recentRankMap = getRecentRankMap(context.projectRoot, context.currentClientSession);
+    return [...listSwitchableAgentItems(context, tmux)].sort((a, b) => {
+        const lastUsedDiff = compareLastUsed(a, b, recentRankMap);
+        if (lastUsedDiff !== 0)
+            return lastUsedDiff;
+        if ((parseRecencyTimestamp(b.lastUsedAt) ?? 0) !== (parseRecencyTimestamp(a.lastUsedAt) ?? 0)) {
+            return (parseRecencyTimestamp(b.lastUsedAt) ?? 0) - (parseRecencyTimestamp(a.lastUsedAt) ?? 0);
+        }
+        if (b.activity !== a.activity)
+            return b.activity - a.activity;
+        return a.target.windowIndex - b.target.windowIndex;
+    });
+}
+//# sourceMappingURL=fast-control.js.map

package/dist/fast-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-control.js","sourceRoot":"","sources":["../src/fast-control.ts"],"names":[],"mappings":"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"}

package/dist/hotkeys.d.ts

@@ -0,0 +1,44 @@
+export type HotkeyAction = {
+    type: "dashboard";
+} | {
+    type: "help";
+} | {
+    type: "focus";
+    index: number;
+} | {
+    type: "next";
+} | {
+    type: "prev";
+} | {
+    type: "create";
+} | {
+    type: "kill";
+} | {
+    type: "switcher";
+} | {
+    type: "worktree-create";
+} | {
+    type: "worktree-list";
+} | {
+    type: "review";
+} | {
+    type: "passthrough";
+    data: string;
+};
+export type ActionCallback = (action: HotkeyAction) => void;
+export declare class HotkeyHandler {
+    private waitingForAction;
+    private timeout;
+    private onAction;
+    constructor(onAction: ActionCallback);
+    /**
+     * Process raw stdin data. Returns any bytes that should be
+     * forwarded to the active PTY (non-hotkey data).
+     */
+    feed(data: Buffer): string | null;
+    private handleActionEvent;
+    private showLeaderIndicator;
+    private hideLeaderIndicator;
+    private clearTimeout;
+    destroy(): void;
+}

package/dist/hotkeys.js

@@ -0,0 +1,118 @@
+import { parseKeys, matchKey } from "./key-parser.js";
+import { debug } from "./debug.js";
+const TIMEOUT_MS = 1000;
+export class HotkeyHandler {
+    waitingForAction = false;
+    timeout = null;
+    onAction;
+    constructor(onAction) {
+        this.onAction = onAction;
+    }
+    /**
+     * Process raw stdin data. Returns any bytes that should be
+     * forwarded to the active PTY (non-hotkey data).
+     */
+    feed(data) {
+        const events = parseKeys(data);
+        debug(`hotkey feed: ${events.length} events, waiting=${this.waitingForAction}, bytes=${data.length}`, "hotkey");
+        if (events.length === 0)
+            return data.toString();
+        // If we're waiting for the action key after leader
+        if (this.waitingForAction) {
+            this.clearTimeout();
+            this.waitingForAction = false;
+            this.hideLeaderIndicator();
+            return this.handleActionEvent(events[0], data);
+        }
+        // Check if this is the leader key (Ctrl+A)
+        if (events.length === 1 && matchKey(events[0], "ctrl+a")) {
+            this.waitingForAction = true;
+            this.showLeaderIndicator();
+            this.timeout = setTimeout(() => {
+                this.waitingForAction = false;
+                this.hideLeaderIndicator();
+                // Timeout: forward the original data
+                this.onAction({ type: "passthrough", data: data.toString() });
+            }, TIMEOUT_MS);
+            return null;
+        }
+        // Regular data — pass through
+        return data.toString();
+    }
+    handleActionEvent(event, rawData) {
+        // Double Ctrl+A: send literal through
+        if (matchKey(event, "ctrl+a")) {
+            this.onAction({ type: "passthrough", data: rawData.toString() });
+            return null;
+        }
+        const key = event.name || event.char;
+        switch (key) {
+            case "d":
+                this.onAction({ type: "dashboard" });
+                return null;
+            case "?":
+                this.onAction({ type: "help" });
+                return null;
+            case "n":
+                this.onAction({ type: "next" });
+                return null;
+            case "p":
+                this.onAction({ type: "prev" });
+                return null;
+            case "c":
+                this.onAction({ type: "create" });
+                return null;
+            case "x":
+                this.onAction({ type: "kill" });
+                return null;
+            case "s":
+                this.onAction({ type: "switcher" });
+                return null;
+            case "w":
+                this.onAction({ type: "worktree-create" });
+                return null;
+            case "W":
+                this.onAction({ type: "worktree-list" });
+                return null;
+            case "v":
+                this.onAction({ type: "review" });
+                return null;
+            default:
+                // Check for digits 1-9
+                if (key >= "1" && key <= "9") {
+                    this.onAction({ type: "focus", index: parseInt(key) - 1 });
+                    return null;
+                }
+                // Unknown action key — forward raw data
+                this.onAction({ type: "passthrough", data: rawData.toString() });
+                return null;
+        }
+    }
+    showLeaderIndicator() {
+        // Save cursor, move to top-right, show indicator, restore cursor
+        const cols = process.stdout.columns ?? 80;
+        const label = " ^A → ? ";
+        const col = cols - label.length;
+        process.stdout.write(`\x1b7` + // save cursor
+            `\x1b[1;${col}H` + // move to top-right
+            `\x1b[7;33m${label}\x1b[0m` + // inverse yellow
+            `\x1b8`);
+    }
+    hideLeaderIndicator() {
+        // Save cursor, clear the indicator area, restore cursor
+        const cols = process.stdout.columns ?? 80;
+        const label = " ^A → ? ";
+        const col = cols - label.length;
+        process.stdout.write(`\x1b7` + `\x1b[1;${col}H` + `${" ".repeat(label.length)}` + `\x1b8`);
+    }
+    clearTimeout() {
+        if (this.timeout) {
+            clearTimeout(this.timeout);
+            this.timeout = null;
+        }
+    }
+    destroy() {
+        this.clearTimeout();
+    }
+}
+//# sourceMappingURL=hotkeys.js.map

package/dist/hotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotkeys.js","sourceRoot":"","sources":["../src/hotkeys.ts"],"names":[],"mappings":"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"}

package/dist/http-client.d.ts

@@ -0,0 +1,10 @@
+export interface HttpJsonResponse<T = any> {
+    status: number;
+    json: T;
+}
+export declare function requestJson<T = any>(urlString: string, options?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeoutMs?: number;
+}): Promise<HttpJsonResponse<T>>;

package/dist/http-client.js

@@ -0,0 +1,54 @@
+import http from "node:http";
+import https from "node:https";
+export async function requestJson(urlString, options = {}) {
+    const url = new URL(urlString);
+    const transport = url.protocol === "https:" ? https : http;
+    const bodyString = options.body === undefined
+        ? undefined
+        : typeof options.body === "string"
+            ? options.body
+            : JSON.stringify(options.body);
+    const headers = {
+        accept: "application/json",
+        ...(options.headers ?? {}),
+    };
+    if (bodyString !== undefined && headers["content-type"] === undefined) {
+        headers["content-type"] = "application/json";
+    }
+    if (bodyString !== undefined && headers["content-length"] === undefined) {
+        headers["content-length"] = Buffer.byteLength(bodyString).toString();
+    }
+    return await new Promise((resolve, reject) => {
+        const req = transport.request(url, {
+            method: options.method ?? (bodyString === undefined ? "GET" : "POST"),
+            headers,
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+            res.on("end", () => {
+                const raw = Buffer.concat(chunks).toString("utf8").trim();
+                let json;
+                try {
+                    json = raw ? JSON.parse(raw) : {};
+                }
+                catch (error) {
+                    reject(error);
+                    return;
+                }
+                resolve({
+                    status: res.statusCode ?? 0,
+                    json,
+                });
+            });
+        });
+        req.on("error", reject);
+        req.setTimeout(options.timeoutMs ?? 0, () => {
+            req.destroy(new Error(`request timed out after ${options.timeoutMs ?? 0}ms`));
+        });
+        if (bodyString !== undefined) {
+            req.write(bodyString);
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,YAAY,CAAC;AAO/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,UAKI,EAAE;IAEN,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3D,MAAM,UAAU,GACd,OAAO,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;YAChC,CAAC,CAAC,OAAO,CAAC,IAAI;YACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,kBAAkB;QAC1B,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;KAC3B,CAAC;IACF,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,CAAC,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IACvE,CAAC;IAED,OAAO,MAAM,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAChE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAC3B,GAAG,EACH;YACE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACrE,OAAO;SACR,EACD,CAAC,GAAG,EAAE,EAAE;YACN,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5F,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,IAAI,IAAO,CAAC;gBACZ,IAAI,CAAC;oBACH,IAAI,GAAG,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,CAAE,EAAQ,CAAC;gBAClD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC;oBACN,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;oBAC3B,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,GAAG,EAAE;YAC1C,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/instance-directory.d.ts

@@ -0,0 +1,32 @@
+import { type InstanceInfo, type InstanceSessionRef } from "./instance-registry.js";
+export interface SessionsFileEntry {
+    id: string;
+    tool: string;
+    status: string;
+    backendSessionId?: string;
+    worktreePath?: string;
+    instance?: string;
+}
+export interface InstanceDirectoryFns {
+    getRemoteInstances?: (ownInstanceId: string, cwd: string) => InstanceInfo[];
+    registerInstance?: (instanceId: string, cwd: string) => Promise<InstanceInfo[]>;
+    unregisterInstance?: (instanceId: string, cwd: string) => Promise<void>;
+    updateHeartbeat?: (instanceId: string, sessions: InstanceSessionRef[], cwd: string) => Promise<string[]>;
+    claimSession?: (sessionId: string, fromInstanceId: string, cwd: string) => Promise<InstanceSessionRef | undefined>;
+}
+export declare class InstanceDirectory {
+    private readonly fns;
+    constructor(fns?: InstanceDirectoryFns);
+    getRemoteInstancesSafe(ownInstanceId: string, cwd: string): InstanceInfo[];
+    registerInstance(instanceId: string, cwd: string): Promise<InstanceInfo[]>;
+    unregisterInstance(instanceId: string, cwd: string): Promise<void>;
+    getRemoteOwnedSessionKeys(ownInstanceId: string, cwd: string): Set<string>;
+    updateHeartbeat(instanceId: string, sessions: InstanceSessionRef[], cwd: string): Promise<string[]>;
+    reconcileHeartbeat(instanceId: string, sessions: InstanceSessionRef[], cwd: string, confirmedRegistered: Set<string>): Promise<{
+        claimedIds: string[];
+        confirmedIds: Set<string>;
+        skippedClaimDetection: boolean;
+    }>;
+    claimSession(sessionId: string, fromInstanceId: string, cwd: string): Promise<InstanceSessionRef | undefined>;
+    buildSessionsFileEntries(localSessions: InstanceSessionRef[], remoteInstances: InstanceInfo[]): SessionsFileEntry[];
+}

package/dist/instance-directory.js

@@ -0,0 +1,82 @@
+import { claimSession, getRemoteInstances, registerInstance, unregisterInstance, updateHeartbeat, } from "./instance-registry.js";
+import { getRemoteOwnedSessionKeys } from "./dashboard-session-registry.js";
+export class InstanceDirectory {
+    fns;
+    constructor(fns = {}) {
+        this.fns = fns;
+    }
+    getRemoteInstancesSafe(ownInstanceId, cwd) {
+        try {
+            return (this.fns.getRemoteInstances ?? getRemoteInstances)(ownInstanceId, cwd);
+        }
+        catch {
+            return [];
+        }
+    }
+    async registerInstance(instanceId, cwd) {
+        return (this.fns.registerInstance ?? registerInstance)(instanceId, cwd);
+    }
+    async unregisterInstance(instanceId, cwd) {
+        return (this.fns.unregisterInstance ?? unregisterInstance)(instanceId, cwd);
+    }
+    getRemoteOwnedSessionKeys(ownInstanceId, cwd) {
+        return getRemoteOwnedSessionKeys(this.getRemoteInstancesSafe(ownInstanceId, cwd));
+    }
+    async updateHeartbeat(instanceId, sessions, cwd) {
+        return (this.fns.updateHeartbeat ?? updateHeartbeat)(instanceId, sessions, cwd);
+    }
+    async reconcileHeartbeat(instanceId, sessions, cwd, confirmedRegistered) {
+        const previousIds = await this.updateHeartbeat(instanceId, sessions, cwd);
+        const nextConfirmed = new Set(confirmedRegistered);
+        const claimedIds = [];
+        let skippedClaimDetection = false;
+        if (previousIds.length > 0 || confirmedRegistered.size === 0) {
+            const previousSet = new Set(previousIds);
+            for (const id of confirmedRegistered) {
+                if (!previousSet.has(id)) {
+                    claimedIds.push(id);
+                    nextConfirmed.delete(id);
+                }
+            }
+        }
+        else if (confirmedRegistered.size > 0) {
+            skippedClaimDetection = true;
+        }
+        for (const session of sessions) {
+            nextConfirmed.add(session.id);
+        }
+        return {
+            claimedIds,
+            confirmedIds: nextConfirmed,
+            skippedClaimDetection,
+        };
+    }
+    async claimSession(sessionId, fromInstanceId, cwd) {
+        return (this.fns.claimSession ?? claimSession)(sessionId, fromInstanceId, cwd);
+    }
+    buildSessionsFileEntries(localSessions, remoteInstances) {
+        const data = localSessions.map((session) => ({
+            id: session.id,
+            tool: session.tool,
+            status: "running",
+            backendSessionId: session.backendSessionId,
+            worktreePath: session.worktreePath,
+        }));
+        for (const inst of remoteInstances) {
+            for (const session of inst.sessions) {
+                if (data.some((entry) => entry.id === session.id))
+                    continue;
+                data.push({
+                    id: session.id,
+                    tool: session.tool,
+                    status: "running",
+                    backendSessionId: session.backendSessionId,
+                    worktreePath: session.worktreePath,
+                    instance: `PID ${inst.pid}`,
+                });
+            }
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=instance-directory.js.map

package/dist/instance-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-directory.js","sourceRoot":"","sources":["../src/instance-directory.ts"],"names":[],"mappings":"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"}

package/dist/instance-registry.d.ts

@@ -0,0 +1,38 @@
+export interface InstanceSessionRef {
+    id: string;
+    tool: string;
+    backendSessionId?: string;
+    worktreePath?: string;
+}
+export interface InstanceInfo {
+    instanceId: string;
+    pid: number;
+    startedAt: string;
+    heartbeat: string;
+    cwd: string;
+    sessions: InstanceSessionRef[];
+}
+/**
+ * Register this instance in instances.json.
+ */
+export declare function registerInstance(instanceId: string, cwd: string): Promise<InstanceInfo[]>;
+/**
+ * Unregister this instance from instances.json.
+ */
+export declare function unregisterInstance(instanceId: string, cwd: string): Promise<void>;
+/**
+ * Update heartbeat timestamp and sessions list. Also prunes dead instances.
+ * Returns the session IDs that were in the registry BEFORE this update
+ * (so the caller can detect which were claimed by comparing against expectations).
+ */
+export declare function updateHeartbeat(instanceId: string, sessions: InstanceSessionRef[], cwd: string): Promise<string[]>;
+/**
+ * Get instances belonging to other aimux processes.
+ * Reads from all known instances.json files for cross-worktree visibility.
+ */
+export declare function getRemoteInstances(ownInstanceId: string, cwd: string): InstanceInfo[];
+/**
+ * Remove a session from another instance's entry (takeover step).
+ * Returns the claimed session ref, or undefined if not found.
+ */
+export declare function claimSession(sessionId: string, fromInstanceId: string, cwd: string): Promise<InstanceSessionRef | undefined>;