@agents-tower/core 0.1.0

package/dist/services/snapshot-assembler.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assembleProjectSnapshot = assembleProjectSnapshot;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const app_settings_1 = require("../app-settings");
+const room_config_1 = require("../room-config");
+const project_identity_1 = require("../project-identity");
+const workload_policy_1 = require("../domain/workload-policy");
+const workspace_activity_1 = require("../domain/workspace-activity");
+const activity_summary_1 = require("../snapshot-lib/activity-summary");
+const project_paths_1 = require("../project-paths");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+function normalizeAgentRoomIds(agents, input) {
+    return agents.map((agent) => ({
+        ...agent,
+        roomId: (0, room_config_1.findRoomForPaths)(input.roomConfig, input.projectRoot, agent.paths)
+    }));
+}
+function aggregateEvents(snapshots) {
+    return snapshots
+        .flatMap((snapshot) => snapshot.events)
+        .filter((event) => {
+        const createdAtMs = Date.parse(event.createdAt);
+        return Number.isFinite(createdAtMs) && Date.now() - createdAtMs <= 2 * 60 * 1000;
+    })
+        .sort((left, right) => right.createdAt.localeCompare(left.createdAt));
+}
+function aggregateNotes(snapshots) {
+    return Array.from(new Set(snapshots.flatMap((snapshot) => snapshot.notes).filter(Boolean)));
+}
+function aggregateCloudTasks(snapshots) {
+    return snapshots.flatMap((snapshot) => snapshot.cloudTasks ?? []);
+}
+function parseGitStatusPath(line) {
+    const rawPath = line.slice(3).trim();
+    if (!rawPath) {
+        return null;
+    }
+    const renamedPath = rawPath.includes(" -> ") ? rawPath.split(" -> ").pop() : rawPath;
+    return renamedPath?.replace(/^"|"$/g, "") || null;
+}
+async function changedProjectPaths(projectRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["-C", projectRoot, "status", "--porcelain=v1", "--untracked-files=no"], { timeout: 750, maxBuffer: 256 * 1024 });
+        return stdout
+            .split(/\r?\n/)
+            .map((line) => parseGitStatusPath(line))
+            .filter((path) => Boolean(path))
+            .slice(0, 12);
+    }
+    catch {
+        return [];
+    }
+}
+const HOT_CHANGE_AGENT_DIAGNOSTIC_WINDOW_MS = 3 * 60 * 1000;
+function normalizePathForMatch(value) {
+    return typeof value === "string" ? value.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/\/$/g, "") : "";
+}
+function pathRelativeToProject(path, projectRoot) {
+    const normalizedPath = normalizePathForMatch(path);
+    const normalizedRoot = normalizePathForMatch(projectRoot);
+    if (!normalizedPath || !normalizedRoot) {
+        return normalizedPath;
+    }
+    const lowerPath = normalizedPath.toLowerCase();
+    const lowerRoot = normalizedRoot.toLowerCase();
+    if (lowerPath === lowerRoot) {
+        return "";
+    }
+    if (lowerPath.startsWith(`${lowerRoot}/`)) {
+        return normalizedPath.slice(normalizedRoot.length + 1);
+    }
+    return normalizedPath;
+}
+function pathsReferToSameFile(left, right, projectRoot) {
+    const leftRelative = pathRelativeToProject(left, projectRoot);
+    const rightRelative = pathRelativeToProject(right, projectRoot);
+    if (!leftRelative || !rightRelative) {
+        return false;
+    }
+    const leftLower = leftRelative.toLowerCase();
+    const rightLower = rightRelative.toLowerCase();
+    return leftLower === rightLower
+        || leftLower.endsWith(`/${rightLower}`)
+        || rightLower.endsWith(`/${leftLower}`);
+}
+function freshUnseatedHotChangeAgentDiagnostics(snapshot, now) {
+    const notes = [];
+    const hotChanges = snapshot.activity.hotChanges.filter((entry) => entry.agents.length === 0);
+    if (hotChanges.length === 0) {
+        return notes;
+    }
+    for (const hotChange of hotChanges) {
+        const matchingAgent = snapshot.agents.find((agent) => {
+            if (agent.source !== "local"
+                || agent.isCurrent
+                || agent.isOngoing
+                || agent.statusText === "active"
+                || agent.threadId === null) {
+                return false;
+            }
+            const updatedAtMs = Date.parse(agent.updatedAt);
+            if (!Number.isFinite(updatedAtMs) || now - updatedAtMs > HOT_CHANGE_AGENT_DIAGNOSTIC_WINDOW_MS) {
+                return false;
+            }
+            return agent.paths.some((path) => pathsReferToSameFile(path, hotChange.path, snapshot.projectRoot));
+        });
+        if (!matchingAgent) {
+            continue;
+        }
+        notes.push(`Hot change ${hotChange.label} has no agent attribution, but fresh local Codex thread ${matchingAgent.threadId} matches the path and is not current (status=${matchingAgent.statusText ?? "unknown"}, state=${matchingAgent.state}, ongoing=${matchingAgent.isOngoing}).`);
+        if (notes.length >= 3) {
+            break;
+        }
+    }
+    return notes;
+}
+async function assembleProjectSnapshot(input) {
+    const generatedAt = input.generatedAt ?? new Date().toISOString();
+    const projectRoot = input.projectRoot;
+    const appearanceSettings = (0, app_settings_1.describeStoredAppearanceSettings)();
+    const [projectIdentity, roomConfig] = await Promise.all([
+        (0, project_identity_1.resolveProjectIdentity)(projectRoot),
+        (0, room_config_1.loadRoomConfig)(projectRoot)
+    ]);
+    const now = input.currentnessNow ?? Date.now();
+    const projectLabel = projectIdentity?.worktreeName && projectIdentity.gitRoot
+        ? (0, project_paths_1.projectLabelFromRoot)(projectIdentity.gitRoot)
+        : (0, project_paths_1.projectLabelFromRoot)(projectRoot);
+    const events = aggregateEvents(input.adapterSnapshots);
+    const agents = normalizeAgentRoomIds(input.adapterSnapshots
+        .flatMap((snapshot) => snapshot.agents)
+        .map((agent) => ({
+        ...agent,
+        hatId: appearanceSettings.hatId
+    })), { projectRoot, roomConfig });
+    const agentsWithActivitySummary = (0, activity_summary_1.summarizeActivityByAgent)(agents, events, now);
+    const cloudTasks = aggregateCloudTasks(input.adapterSnapshots);
+    const rawEvents = input.adapterSnapshots.flatMap((snapshot) => snapshot.events);
+    const changedPaths = await changedProjectPaths(projectRoot);
+    const activity = (0, workspace_activity_1.buildWorkspaceActivitySnapshot)({
+        events: rawEvents,
+        agents: agentsWithActivitySummary,
+        generatedAt,
+        now,
+        changedPaths,
+        projectBranch: projectIdentity?.branch ?? null
+    });
+    const snapshot = (0, workload_policy_1.applyCurrentWorkloadState)({
+        projectRoot,
+        projectLabel,
+        projectIdentity,
+        generatedAt,
+        rooms: roomConfig,
+        agents: agentsWithActivitySummary,
+        cloudTasks,
+        events,
+        activity,
+        notes: aggregateNotes(input.adapterSnapshots)
+    }, now);
+    const diagnostics = freshUnseatedHotChangeAgentDiagnostics(snapshot, now);
+    return diagnostics.length > 0
+        ? { ...snapshot, notes: [...snapshot.notes, ...diagnostics] }
+        : snapshot;
+}
+//# sourceMappingURL=snapshot-assembler.js.map

package/dist/services/snapshot-assembler.js.map

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

package/dist/services/thread-store.d.ts

@@ -0,0 +1,4 @@
+import { ProjectLiveMonitor, type ProjectLiveMonitorOptions } from "../live-monitor";
+export type CodexThreadStoreOptions = ProjectLiveMonitorOptions;
+export declare class CodexThreadStore extends ProjectLiveMonitor {
+}

package/dist/services/thread-store.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodexThreadStore = void 0;
+const live_monitor_1 = require("../live-monitor");
+class CodexThreadStore extends live_monitor_1.ProjectLiveMonitor {
+}
+exports.CodexThreadStore = CodexThreadStore;
+//# sourceMappingURL=thread-store.js.map

package/dist/services/thread-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-store.js","sourceRoot":"","sources":["../../src/services/thread-store.ts"],"names":[],"mappings":";;;AAAA,kDAAqF;AAIrF,MAAa,gBAAiB,SAAQ,iCAAkB;CAAG;AAA3D,4CAA2D"}

package/dist/snapshot-lib/activity-summary.d.ts

@@ -0,0 +1,3 @@
+import type { AgentActivitySummary, DashboardAgent, DashboardEvent } from "../types";
+export declare function summarizeAgentActivity(agent: DashboardAgent, events: DashboardEvent[], now?: number): AgentActivitySummary;
+export declare function summarizeActivityByAgent(agents: DashboardAgent[], events: DashboardEvent[], now?: number): DashboardAgent[];

package/dist/snapshot-lib/activity-summary.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeAgentActivity = summarizeAgentActivity;
+exports.summarizeActivityByAgent = summarizeActivityByAgent;
+const node_path_1 = require("node:path");
+const text_1 = require("../utils/text");
+const HOT_FILE_WINDOW_MS = 2 * 60 * 1000;
+const RUNNING_COMMAND_WINDOW_MS = 5 * 60 * 1000;
+const LONG_RUNNING_COMMAND_MS = 30 * 1000;
+function eventTimeMs(event) {
+    const createdAtMs = Date.parse(event.createdAt);
+    return Number.isFinite(createdAtMs) ? createdAtMs : 0;
+}
+function isoFromMs(value) {
+    return new Date(value).toISOString();
+}
+function displayFileLabel(path, fallback) {
+    if (!path) {
+        return (0, text_1.shortenText)(fallback || "Files", 48);
+    }
+    return (0, text_1.shortenText)((0, node_path_1.basename)(path) || path, 48);
+}
+function summarizeHotFiles(events, now) {
+    const byPath = new Map();
+    for (const event of events) {
+        if (event.kind !== "fileChange") {
+            continue;
+        }
+        const createdAtMs = eventTimeMs(event);
+        if (createdAtMs <= 0 || now - createdAtMs > HOT_FILE_WINDOW_MS) {
+            continue;
+        }
+        const key = event.path || event.detail || event.title || "files";
+        const existing = byPath.get(key);
+        const linesAdded = typeof event.linesAdded === "number" && Number.isFinite(event.linesAdded)
+            ? event.linesAdded
+            : undefined;
+        const linesRemoved = typeof event.linesRemoved === "number" && Number.isFinite(event.linesRemoved)
+            ? event.linesRemoved
+            : undefined;
+        if (!existing) {
+            byPath.set(key, {
+                path: event.path,
+                label: displayFileLabel(event.path, event.detail || event.title),
+                action: event.action ?? "edited",
+                count: 1,
+                lastUpdatedAt: event.createdAt,
+                latestMs: createdAtMs,
+                linesAdded,
+                linesRemoved
+            });
+            continue;
+        }
+        existing.count += 1;
+        if (linesAdded !== undefined) {
+            existing.linesAdded = (existing.linesAdded ?? 0) + linesAdded;
+        }
+        if (linesRemoved !== undefined) {
+            existing.linesRemoved = (existing.linesRemoved ?? 0) + linesRemoved;
+        }
+        if (createdAtMs >= existing.latestMs) {
+            existing.path = event.path;
+            existing.label = displayFileLabel(event.path, event.detail || event.title);
+            existing.action = event.action ?? existing.action;
+            existing.lastUpdatedAt = event.createdAt;
+            existing.latestMs = createdAtMs;
+        }
+    }
+    return [...byPath.values()]
+        .sort((left, right) => right.count - left.count || right.latestMs - left.latestMs)
+        .slice(0, 3)
+        .map(({ latestMs: _latestMs, ...entry }) => entry);
+}
+function commandKey(event) {
+    return event.itemId || event.command || event.detail || event.title || event.id;
+}
+function summarizeRunningCommandFromEvents(events, now) {
+    const commandEvents = events
+        .filter((event) => event.kind === "command")
+        .filter((event) => {
+        const createdAtMs = eventTimeMs(event);
+        return createdAtMs > 0 && now - createdAtMs <= RUNNING_COMMAND_WINDOW_MS;
+    })
+        .sort((left, right) => eventTimeMs(left) - eventTimeMs(right));
+    if (commandEvents.length === 0) {
+        return null;
+    }
+    const groups = new Map();
+    for (const event of commandEvents) {
+        const key = commandKey(event);
+        groups.set(key, [...(groups.get(key) ?? []), event]);
+    }
+    const summaries = [...groups.values()]
+        .map((group) => {
+        const sorted = [...group].sort((left, right) => eventTimeMs(left) - eventTimeMs(right));
+        const last = sorted[sorted.length - 1];
+        if (!last) {
+            return null;
+        }
+        if (sorted.some((event) => event.phase === "completed" || event.phase === "failed" || event.phase === "interrupted")) {
+            return null;
+        }
+        const firstStarted = sorted.find((event) => event.phase === "started") ?? sorted[0];
+        const startedAtMs = eventTimeMs(firstStarted);
+        const updatedAtMs = eventTimeMs(last);
+        const command = last.command || last.detail || last.title;
+        if (!command) {
+            return null;
+        }
+        return {
+            command: (0, text_1.shortenText)(command, 140),
+            cwd: last.cwd ?? last.path,
+            startedAt: isoFromMs(startedAtMs),
+            updatedAt: isoFromMs(updatedAtMs),
+            elapsedMs: Math.max(0, now - startedAtMs),
+            isLongRunning: now - startedAtMs >= LONG_RUNNING_COMMAND_MS,
+            outputEvents: sorted.filter((event) => event.phase === "updated").length
+        };
+    })
+        .filter((entry) => Boolean(entry));
+    return summaries.sort((left, right) => Date.parse(right.updatedAt) - Date.parse(left.updatedAt))[0] ?? null;
+}
+function summarizeRunningCommandFromAgent(agent, now) {
+    if (agent.activityEvent?.type !== "commandExecution") {
+        return null;
+    }
+    if (agent.state !== "running" && agent.state !== "validating") {
+        return null;
+    }
+    const updatedAtMs = Date.parse(agent.updatedAt);
+    if (!Number.isFinite(updatedAtMs)) {
+        return null;
+    }
+    const command = agent.activityEvent.title || agent.detail;
+    return {
+        command: (0, text_1.shortenText)(command || "Command", 140),
+        cwd: agent.activityEvent.path ?? agent.cwd,
+        startedAt: isoFromMs(updatedAtMs),
+        updatedAt: isoFromMs(updatedAtMs),
+        elapsedMs: Math.max(0, now - updatedAtMs),
+        isLongRunning: now - updatedAtMs >= LONG_RUNNING_COMMAND_MS,
+        outputEvents: 0
+    };
+}
+function summarizeBlockers(agent, runningCommand) {
+    const blockers = [];
+    if (agent.needsUser?.kind === "approval") {
+        blockers.push({
+            kind: "approval",
+            title: agent.needsUser.networkApprovalContext ? "Network approval" : "Needs approval",
+            detail: (0, text_1.shortenText)(agent.needsUser.command || agent.needsUser.reason || agent.detail || "Approval required", 120),
+            since: agent.updatedAt
+        });
+    }
+    else if (agent.needsUser?.kind === "input") {
+        const questionCount = Array.isArray(agent.needsUser.questions) ? agent.needsUser.questions.length : 0;
+        blockers.push({
+            kind: "input",
+            title: "Needs input",
+            detail: (0, text_1.shortenText)(agent.needsUser.reason || (questionCount > 0 ? `${questionCount} question${questionCount === 1 ? "" : "s"}` : agent.detail || "Input required"), 120),
+            since: agent.updatedAt
+        });
+    }
+    else if (agent.state === "blocked") {
+        blockers.push({
+            kind: "failure",
+            title: "Blocked",
+            detail: (0, text_1.shortenText)(agent.detail || agent.statusText || "Blocked", 120),
+            since: agent.updatedAt
+        });
+    }
+    if (runningCommand?.isLongRunning) {
+        blockers.push({
+            kind: "longCommand",
+            title: (0, text_1.looksLikeValidationCommand)(runningCommand.command) ? "Long validation" : "Long command",
+            detail: runningCommand.command,
+            since: runningCommand.startedAt
+        });
+    }
+    return blockers.slice(0, 3);
+}
+function summarizeAgentActivity(agent, events, now = Date.now()) {
+    const hotFiles = summarizeHotFiles(events, now);
+    const runningCommand = summarizeRunningCommandFromEvents(events, now)
+        ?? summarizeRunningCommandFromAgent(agent, now);
+    const blockers = summarizeBlockers(agent, runningCommand);
+    const updatedAtValues = [
+        ...hotFiles.map((file) => Date.parse(file.lastUpdatedAt)),
+        runningCommand ? Date.parse(runningCommand.updatedAt) : 0,
+        ...blockers.map((blocker) => Date.parse(blocker.since))
+    ].filter((value) => Number.isFinite(value) && value > 0);
+    return {
+        hotFiles,
+        runningCommand,
+        blockers,
+        updatedAt: updatedAtValues.length > 0 ? isoFromMs(Math.max(...updatedAtValues)) : null
+    };
+}
+function summarizeActivityByAgent(agents, events, now = Date.now()) {
+    const eventsByThreadId = new Map();
+    for (const event of events) {
+        if (!event.threadId) {
+            continue;
+        }
+        eventsByThreadId.set(event.threadId, [...(eventsByThreadId.get(event.threadId) ?? []), event]);
+    }
+    return agents.map((agent) => {
+        const summary = summarizeAgentActivity(agent, agent.threadId ? eventsByThreadId.get(agent.threadId) ?? [] : [], now);
+        if (summary.hotFiles.length === 0
+            && !summary.runningCommand
+            && summary.blockers.length === 0) {
+            return agent;
+        }
+        return {
+            ...agent,
+            activitySummary: summary
+        };
+    });
+}
+//# sourceMappingURL=activity-summary.js.map

package/dist/snapshot-lib/activity-summary.js.map

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

package/dist/snapshot-lib/dashboard-builder.d.ts

@@ -0,0 +1,21 @@
+import { ProjectSnapshotCoordinator } from "../services/project-snapshot-coordinator";
+import type { AgentGoalState, CloudTask, DashboardSnapshot, NeedsUserState, SnapshotOptions, CodexThread, DashboardEvent } from "../types";
+export declare function filterProjectCloudTasks(tasks: CloudTask[], projectRoot: string): CloudTask[];
+export declare function buildDashboardSnapshotFromState(input: {
+    projectRoot: string;
+    threads: CodexThread[];
+    cloudTasks?: CloudTask[];
+    events?: DashboardEvent[];
+    notes?: string[];
+    needsUserByThreadId?: Map<string, NeedsUserState>;
+    goalsByThreadId?: Map<string, AgentGoalState>;
+    subscribedThreadIds?: Set<string>;
+    stoppedAtByThreadId?: Map<string, number>;
+    ongoingThreadIds?: Set<string>;
+}): Promise<DashboardSnapshot>;
+export declare function createProjectSnapshotCoordinator(options: {
+    projectRoot: string;
+    localLimit?: number;
+    includeManagedCloud?: boolean;
+}): Promise<ProjectSnapshotCoordinator>;
+export declare function buildDashboardSnapshot(options: SnapshotOptions): Promise<DashboardSnapshot>;

package/dist/snapshot-lib/dashboard-builder.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterProjectCloudTasks = filterProjectCloudTasks;
+exports.buildDashboardSnapshotFromState = buildDashboardSnapshotFromState;
+exports.createProjectSnapshotCoordinator = createProjectSnapshotCoordinator;
+exports.buildDashboardSnapshot = buildDashboardSnapshot;
+const node_path_1 = require("node:path");
+const app_server_1 = require("../app-server");
+const codex_thread_query_1 = require("../codex-thread-query");
+const snapshot_assembler_1 = require("../services/snapshot-assembler");
+const project_snapshot_coordinator_1 = require("../services/project-snapshot-coordinator");
+const DEFAULT_LOCAL_THREAD_LIMIT = 24;
+function filterProjectCloudTasks(tasks, projectRoot) {
+    return tasks.filter((task) => {
+        const label = task.environmentLabel?.toLowerCase();
+        if (!label) {
+            return false;
+        }
+        return label.includes((0, node_path_1.basename)(projectRoot).toLowerCase());
+    });
+}
+async function buildLocalAgents(projectRoot, localLimit, notes, readThreads = true) {
+    try {
+        return await (0, app_server_1.withAppServerClient)(async (client) => {
+            const query = await (0, codex_thread_query_1.listCodexProjectThreadCandidates)({
+                client,
+                projectRoot,
+                localLimit
+            });
+            if (query.usedUnscopedFallback) {
+                notes.push("Local Codex cwd filter returned no project threads; used unscoped Windows path fallback.");
+            }
+            const threads = query.trackedThreads;
+            if (!readThreads) {
+                return threads;
+            }
+            return Promise.all(threads.map(async (thread) => mergeListedThreadMetadata(await (0, codex_thread_query_1.readCodexThreadWithTimeout)(client, thread.id).catch(() => thread), thread)));
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        notes.push(`Local Codex app-server unavailable: ${message}`);
+        return [];
+    }
+}
+function mergeListedThreadMetadata(thread, listedThread) {
+    return {
+        ...thread,
+        status: listedThread.status,
+        updatedAt: Math.max(thread.updatedAt, listedThread.updatedAt),
+        path: listedThread.path ?? thread.path
+    };
+}
+async function buildDashboardSnapshotFromState(input) {
+    const coordinator = await createProjectSnapshotCoordinator({
+        projectRoot: input.projectRoot,
+        includeManagedCloud: input.cloudTasks === undefined
+    });
+    try {
+        const snapshot = await coordinator.buildSnapshot(input);
+        if (!snapshot) {
+            throw new Error("One-shot snapshot build was superseded unexpectedly.");
+        }
+        return snapshot;
+    }
+    finally {
+        await coordinator.dispose();
+    }
+}
+async function createProjectSnapshotCoordinator(options) {
+    const [{ buildCodexLocalAdapterSnapshotFromState }, { cloudTasksToAgents, codexCloudAdapter }, { claudeAdapter }, { cursorCloudAdapter }, { cursorLocalAdapter }, { hermesAdapter }, { openClawAdapter }, { presenceAdapter }] = await Promise.all([
+        Promise.resolve().then(() => __importStar(require("../adapters/codex-local"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/codex-cloud"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/claude"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/cursor-cloud"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/cursor-local"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/hermes"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/openclaw"))),
+        Promise.resolve().then(() => __importStar(require("../adapters/presence")))
+    ]);
+    const staticSourceContexts = {
+        projectRoot: options.projectRoot,
+        localLimit: options.localLimit ?? DEFAULT_LOCAL_THREAD_LIMIT,
+        readThreads: true
+    };
+    const secondarySources = [
+        options.includeManagedCloud ? codexCloudAdapter.createSource(staticSourceContexts) : null,
+        claudeAdapter.createSource(staticSourceContexts),
+        cursorLocalAdapter.createSource(staticSourceContexts),
+        cursorCloudAdapter.createSource(staticSourceContexts),
+        hermesAdapter.createSource(staticSourceContexts),
+        openClawAdapter.createSource(staticSourceContexts),
+        presenceAdapter.createSource(staticSourceContexts)
+    ].filter((source) => source !== null);
+    return new project_snapshot_coordinator_1.ProjectSnapshotCoordinator(options.projectRoot, {
+        secondarySources,
+        buildLocalSnapshot: buildCodexLocalAdapterSnapshotFromState,
+        cloudTasksToAgents,
+        assemble: snapshot_assembler_1.assembleProjectSnapshot
+    });
+}
+async function buildDashboardSnapshot(options) {
+    const notes = [];
+    const threads = await buildLocalAgents(options.projectRoot, options.localLimit ?? DEFAULT_LOCAL_THREAD_LIMIT, notes, options.readThreads !== false);
+    const initialCloudTasks = options.includeCloud === false ? [] : undefined;
+    return buildDashboardSnapshotFromState({
+        projectRoot: options.projectRoot,
+        threads,
+        cloudTasks: initialCloudTasks,
+        notes
+    });
+}
+//# sourceMappingURL=dashboard-builder.js.map

package/dist/snapshot-lib/dashboard-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-builder.js","sourceRoot":"","sources":["../../src/snapshot-lib/dashboard-builder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,0DAQC;AA6CD,0EAyBC;AAED,4EA8CC;AAED,wDAiBC;AAtKD,yCAAqC;AAErC,8CAAoD;AACpD,8DAG+B;AAC/B,uEAAyE;AACzE,2FAAsF;AAWtF,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC,SAAgB,uBAAuB,CAAC,KAAkB,EAAE,WAAmB;IAC7E,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAA,oBAAQ,EAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,WAAmB,EACnB,UAAkB,EAClB,KAAe,EACf,WAAW,GAAG,IAAI;IAElB,IAAI,CAAC;QACH,OAAO,MAAM,IAAA,gCAAmB,EAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAChD,MAAM,KAAK,GAAG,MAAM,IAAA,qDAAgC,EAAC;gBACnD,MAAM;gBACN,WAAW;gBACX,UAAU;aACX,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,0FAA0F,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAC9C,yBAAyB,CACvB,MAAM,IAAA,+CAA0B,EAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EACvE,MAAM,CACP,CACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAmB,EAAE,YAAyB;IAC/E,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC;QAC7D,IAAI,EAAE,YAAY,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;KACvC,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,+BAA+B,CAAC,KAWrD;IACC,MAAM,WAAW,GAAG,MAAM,gCAAgC,CAAC;QACzD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,mBAAmB,EAAE,KAAK,CAAC,UAAU,KAAK,SAAS;KACpD,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,gCAAgC,CAAC,OAItD;IACC,MAAM,CACJ,EAAE,uCAAuC,EAAE,EAC3C,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,EACzC,EAAE,aAAa,EAAE,EACjB,EAAE,kBAAkB,EAAE,EACtB,EAAE,kBAAkB,EAAE,EACtB,EAAE,aAAa,EAAE,EACjB,EAAE,eAAe,EAAE,EACnB,EAAE,eAAe,EAAE,CACpB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;0DACb,yBAAyB;0DACzB,yBAAyB;0DACzB,oBAAoB;0DACpB,0BAA0B;0DAC1B,0BAA0B;0DAC1B,oBAAoB;0DACpB,sBAAsB;0DACtB,sBAAsB;KAC9B,CAAC,CAAC;IAEH,MAAM,oBAAoB,GAAG;QAC3B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,0BAA0B;QAC5D,WAAW,EAAE,IAAI;KAClB,CAAC;IACF,MAAM,gBAAgB,GAAG;QACvB,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,IAAI;QACzF,aAAa,CAAC,YAAY,CAAC,oBAAoB,CAAC;QAChD,kBAAkB,CAAC,YAAY,CAAC,oBAAoB,CAAC;QACrD,kBAAkB,CAAC,YAAY,CAAC,oBAAoB,CAAC;QACrD,aAAa,CAAC,YAAY,CAAC,oBAAoB,CAAC;QAChD,eAAe,CAAC,YAAY,CAAC,oBAAoB,CAAC;QAClD,eAAe,CAAC,YAAY,CAAC,oBAAoB,CAAC;KACnD,CAAC,MAAM,CAAC,CAAC,MAAM,EAAwC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IAE5E,OAAO,IAAI,yDAA0B,CAAC,OAAO,CAAC,WAAW,EAAE;QACzD,gBAAgB;QAChB,kBAAkB,EAAE,uCAAuC;QAC3D,kBAAkB;QAClB,QAAQ,EAAE,4CAAuB;KAClC,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,OAAwB;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,UAAU,IAAI,0BAA0B,EAChD,KAAK,EACL,OAAO,CAAC,WAAW,KAAK,KAAK,CAC9B,CAAC;IACF,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,OAAO,+BAA+B,CAAC;QACrC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO;QACP,UAAU,EAAE,iBAAiB;QAC7B,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/snapshot-lib/thread-summary.d.ts

@@ -0,0 +1,27 @@
+import type { AgentActivityEvent, ActivityState, CodexThread, DashboardEvent } from "../types";
+export declare function formatGoalCommandLabel(value: string): string;
+export declare function pickThreadLabel(thread: CodexThread): string;
+export declare function latestAgentMessageForThread(thread: CodexThread): string | null;
+export declare function syncSummaryWithLatestThreadMessage(thread: CodexThread, summary: ReturnType<typeof summariseThread>, recentEvents?: DashboardEvent[]): {
+    latestMessage: string | null;
+    summary: ReturnType<typeof summariseThread>;
+};
+export declare function parseThreadSourceMeta(thread: CodexThread): {
+    sourceKind: string;
+    parentThreadId: string | null;
+    depth: number;
+    agentNickname: string | null;
+    agentRole: string | null;
+};
+export declare function parentThreadIdForThread(thread: CodexThread): string | null;
+export declare function isStaleActiveSubagentThread(thread: CodexThread, nowMs?: number): boolean;
+export declare function inferThreadAgentRole(thread: CodexThread, sourceKind: string): string | null;
+export declare function isOngoingThread(thread: CodexThread): boolean;
+export declare function summariseThread(thread: CodexThread): {
+    state: ActivityState;
+    detail: string;
+    paths: string[];
+    activityEvent: AgentActivityEvent | null;
+};
+export declare function buildActivityEventFromDashboardEvent(event: DashboardEvent): AgentActivityEvent | null;
+export declare function applyRecentActivityEvent(thread: CodexThread, summary: ReturnType<typeof summariseThread>, recentEvents: DashboardEvent[]): ReturnType<typeof summariseThread>;