@rryando/arcs 3.10.0 → 4.0.0

package/dist/utils/session-store.js

@@ -0,0 +1,577 @@
+/**
+ * Session CRUD storage for ARCS projects.
+ *
+ * Tracks agent runtime sessions (opencode, claude-code) that are attached to a
+ * project. Unlike tasks/plans/knowledge these records are volatile runtime
+ * state: they carry no markdown mirror and never invalidate the graph cache.
+ */
+import { join } from "node:path";
+import { invalidSessionId, invalidSessionLink, itemNotFound, normalizedIdCollision, } from "./errors.js";
+import { withLock } from "./file-lock.js";
+import { readJsonSafe } from "./json.js";
+import { readPlanIndex } from "./plan-store.js";
+import { normalizeIdentifier } from "./slug.js";
+import { ensureDir, fileExists, nowISO, validateSessionLinkedNodeType, validateSessionRuntimeType, validateSessionStatus, writeJson, } from "./storage-utils.js";
+import { getTask } from "./task-store.js";
+export { SESSION_LINKED_NODE_TYPES, SESSION_RUNTIME_TYPES, SESSION_STATUSES, } from "./storage-utils.js";
+// ---------------------------------------------------------------------------
+// Origin
+// ---------------------------------------------------------------------------
+/**
+ * Where a session record came from — its provenance, not its state.
+ *
+ * - `observed` — a runtime session ARCS merely watches: a terminal `claude`
+ *   session announcing itself through the hook bridge, or an opencode session
+ *   discovered (or created) on a live opencode server. ARCS can nudge it, but
+ *   something outside ARCS drives it.
+ * - `arcs` — a record ARCS minted for itself (the headless oneshot/stable
+ *   threads). No terminal is attached, so nothing ever drains its message
+ *   queue; it is driven by headless runs only.
+ *
+ * Declared here rather than in storage-utils alongside the other session enums
+ * because origin is derived by this module (legacy promotion below) and every
+ * consumer already imports the session enums through this file.
+ */
+export const SESSION_ORIGINS = ["observed", "arcs"];
+// ---------------------------------------------------------------------------
+// Index helpers
+// ---------------------------------------------------------------------------
+/**
+ * Fills in `origin` for a record persisted before the field existed.
+ *
+ * Legacy ARCS-minted records are recognisable by the marker the run route used
+ * to write, `metadata.control === "arcs-owned"`; every other record was a
+ * session ARCS observed. Promotion happens on READ, so there is no migration
+ * script and no flag day: the derived value is persisted the next time the
+ * record is written through this store. A record created after this change
+ * always carries a real `origin`, so `metadata.control` can never influence it.
+ */
+function withDerivedOrigin(session) {
+    // Typed as required, but absent on disk for pre-origin records — and a
+    // hand-edited index could hold anything, so validate rather than trust.
+    const persisted = session.origin;
+    if (persisted !== undefined && SESSION_ORIGINS.includes(persisted)) {
+        return session;
+    }
+    return { ...session, origin: session.metadata?.control === "arcs-owned" ? "arcs" : "observed" };
+}
+export async function readSessionIndex(projectDir) {
+    const sessionsDir = join(projectDir, "sessions");
+    if (!(await fileExists(sessionsDir))) {
+        return { sessions: [] };
+    }
+    const indexPath = join(sessionsDir, "index.json");
+    const index = await readJsonSafe(indexPath);
+    if (!index || !Array.isArray(index.sessions)) {
+        return { sessions: [] };
+    }
+    // Every read path in this module funnels through here, so the promotion is
+    // applied exactly once — reads, writes and capability checks all agree.
+    return { sessions: index.sessions.map(withDerivedOrigin) };
+}
+/**
+ * Capability: may a message be handed to this session through `messageQueue`?
+ *
+ * Queued delivery only works when something drains the queue, and the only
+ * drainer is the Claude Code hook script running inside a real terminal
+ * session — an `observed` claude-code record. An `arcs`-origin thread has no
+ * terminal attached, so a message queued for it would sit there forever
+ * (that black hole is what the queue refusal on POST /message closes), and
+ * opencode records take live injection instead of ever queueing.
+ *
+ * Derived from `origin`, never from a metadata string.
+ */
+export function canQueue(session) {
+    return session.origin === "observed" && session.runtimeType === "claude-code";
+}
+// ---------------------------------------------------------------------------
+// Derived phase
+// ---------------------------------------------------------------------------
+/**
+ * What a session is doing right now, as a reader of the UI would say it.
+ *
+ * DERIVED, never stored: there is no `phase` field on `SessionMeta` and no way
+ * to write one through this module. A stored phase is a second source of truth
+ * that goes stale the instant a process dies without telling anyone — which is
+ * precisely the "stuck on running forever" failure this replaces.
+ */
+export const SESSION_PHASES = ["running", "idle", "failed", "ended"];
+/**
+ * Outcome vocabulary persisted on `metadata.run.outcome`. A superset of the
+ * runner's own `RunOutcome` ("success" | "error" | "timeout"): `interrupted` is
+ * never produced BY a run, it is written FOR a run whose process disappeared
+ * without ever settling — a restart's orphan. Declared here rather than
+ * imported from the web server because `utils/` must not depend on
+ * `web-server/`; claude-runner's union stays exactly what a child can return.
+ */
+export const SESSION_RUN_OUTCOMES = ["success", "error", "timeout", "interrupted"];
+/**
+ * How long a run claim's heartbeat counts as proof of life. Sized to the
+ * runner's default 10-minute run ceiling because nothing refreshes the
+ * heartbeat mid-run yet (see `SessionMeta.heartbeatAt`) — a shorter window
+ * would demote a perfectly healthy long run to `idle`.
+ */
+export const RUN_HEARTBEAT_TTL_MS = 10 * 60 * 1000;
+/**
+ * How long a runtime checkpoint counts as proof of life for an observed
+ * session. Deliberately shorter than the run TTL: checkpoints arrive at every
+ * prompt and every turn end, so a terminal that has produced neither in five
+ * minutes is waiting on a human, not working.
+ */
+export const CHECKPOINT_TTL_MS = 5 * 60 * 1000;
+/**
+ * The record's run claim, or `undefined` when it holds none. Validated rather
+ * than trusted: a hand-edited index can carry anything under this key.
+ */
+export function sessionRunClaim(session) {
+    const runId = session.currentRunId;
+    return typeof runId === "string" && runId !== "" ? runId : undefined;
+}
+/** Whether an ISO timestamp is within `ttlMs` of `now` (epoch ms). */
+function isFresh(timestamp, now, ttlMs) {
+    if (typeof timestamp !== "string" || timestamp === "")
+        return false;
+    const at = Date.parse(timestamp);
+    if (Number.isNaN(at))
+        return false;
+    // A future timestamp (clock skew between the hook script and the server)
+    // still counts as fresh — only age ever demotes.
+    return now - at <= ttlMs;
+}
+/**
+ * Derives a session's phase from its own persisted evidence, in one place.
+ *
+ * Precedence, strongest first:
+ *  1. a terminal `status` — `failed` is `failed`, `completed`/`disconnected`
+ *     are `ended`. Nothing observed later reopens a session that is over.
+ *  2. a run claim (`currentRunId`) — ARCS spawned a child for this record, so
+ *     its `heartbeatAt` is the freshest evidence there is. Stale means the
+ *     claim outlived its proof of life, which reads `idle`, not `failed`: the
+ *     run is settled by the reconciler, not guessed at here.
+ *  3. `lastCheckpointAt` — the only signal an observed terminal session emits.
+ *
+ * `metadata.run.outcome` is deliberately NOT an input. That field is run-level
+ * history (rendered next to the run), while phase answers "is this session live
+ * right now" — a run that failed an hour ago leaves the session idle and ready
+ * for the next one, not permanently `failed`.
+ *
+ * Pure: a record plus a clock, no I/O, no process probing. Liveness that needs
+ * the world (a pid, `claude agents`) belongs to the reconciler, which starts
+ * from this value and can only ever demote it.
+ *
+ * SHORTCUT: checkpoint freshness cannot tell `UserPromptSubmit` (turn started)
+ * from `Stop` (turn ended), so a session reads `running` for the TTL after its
+ * last turn; upgrade to a persisted checkpoint kind when the panel needs
+ * turn-level precision.
+ */
+export function deriveSessionPhase(session, options = {}) {
+    if (session.status === "failed")
+        return "failed";
+    if (session.status === "completed" || session.status === "disconnected")
+        return "ended";
+    const now = options.now ?? Date.now();
+    if (sessionRunClaim(session) !== undefined) {
+        const ttlMs = options.heartbeatTtlMs ?? RUN_HEARTBEAT_TTL_MS;
+        return isFresh(session.heartbeatAt, now, ttlMs) ? "running" : "idle";
+    }
+    const ttlMs = options.checkpointTtlMs ?? CHECKPOINT_TTL_MS;
+    return isFresh(session.lastCheckpointAt, now, ttlMs) ? "running" : "idle";
+}
+function sessionStoreLockPath(projectDir) {
+    return join(projectDir, "sessions", ".store");
+}
+async function writeSessionState(projectDir, index) {
+    const sessionsDir = join(projectDir, "sessions");
+    await ensureDir(sessionsDir);
+    await writeJson(join(sessionsDir, "index.json"), index);
+}
+function buildSession(input, normalizedId) {
+    const ts = nowISO(input.now);
+    return {
+        id: normalizedId,
+        normalizedId,
+        runtimeType: input.runtimeType,
+        runtimeSessionId: input.runtimeSessionId,
+        origin: input.origin ?? "observed",
+        status: input.status ?? "active",
+        startedAt: input.startedAt ?? ts,
+        ...(input.lastMessageAt && { lastMessageAt: input.lastMessageAt }),
+        updatedAt: ts,
+        ...(input.userEmail && { userEmail: input.userEmail }),
+        ...(input.metadata && { metadata: input.metadata }),
+    };
+}
+/**
+ * Validates a create/upsert payload and returns the canonical normalized id.
+ * Runtime session ids are opaque runtime-native strings, so the only structural
+ * requirement is that they normalize to a non-empty identifier.
+ */
+function validateCreateInput(input) {
+    validateSessionRuntimeType(input.runtimeType);
+    validateSessionStatus(input.status ?? "active");
+    const normalizedId = normalizeIdentifier(input.runtimeSessionId);
+    if (!normalizedId) {
+        throw invalidSessionId(input.runtimeSessionId);
+    }
+    return normalizedId;
+}
+/**
+ * Resolves a link target against the task/plan store and returns its canonical
+ * normalized id. Throws `ITEM_NOT_FOUND` when the target does not exist, so a
+ * session can never point at a task/plan that was never created (or was
+ * deleted). There is no cross-store validation helper to share here — the
+ * task/plan stores are the only source of truth for their own ids.
+ */
+async function resolveLinkedNodeId(projectDir, nodeType, nodeId) {
+    if (nodeType === "task") {
+        return (await getTask(projectDir, nodeId)).normalizedId;
+    }
+    const normalizedId = normalizeIdentifier(nodeId);
+    const { plans } = await readPlanIndex(projectDir);
+    const plan = plans.find((p) => p.normalizedId === normalizedId);
+    if (!plan) {
+        throw itemNotFound("plan", nodeId);
+    }
+    return plan.normalizedId;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+async function createSessionUnlocked(projectDir, input) {
+    const normalizedId = validateCreateInput(input);
+    const index = await readSessionIndex(projectDir);
+    if (index.sessions.some((s) => s.normalizedId === normalizedId)) {
+        throw normalizedIdCollision("session", input.runtimeSessionId, normalizedId);
+    }
+    const meta = buildSession(input, normalizedId);
+    index.sessions.push(meta);
+    await writeSessionState(projectDir, index);
+    return meta;
+}
+export async function createSession(projectDir, input) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => createSessionUnlocked(projectDir, input));
+}
+async function upsertSessionUnlocked(projectDir, input) {
+    const normalizedId = validateCreateInput(input);
+    const index = await readSessionIndex(projectDir);
+    const existingIndex = index.sessions.findIndex((s) => s.normalizedId === normalizedId);
+    if (existingIndex === -1) {
+        const meta = buildSession(input, normalizedId);
+        index.sessions.push(meta);
+        await writeSessionState(projectDir, index);
+        return meta;
+    }
+    const existing = index.sessions[existingIndex];
+    // `origin` is deliberately absent from this merge: it is provenance, so the
+    // creating writer fixes it for good. A hook observation must not demote an
+    // ARCS-owned thread (that would reopen the queue black hole), and an ARCS run
+    // claiming an existing record as its write-target must not erase the fact
+    // that a real terminal session is attached to it.
+    const merged = {
+        ...existing,
+        runtimeType: input.runtimeType,
+        runtimeSessionId: input.runtimeSessionId,
+        ...(input.status && { status: input.status }),
+        ...(input.startedAt && { startedAt: input.startedAt }),
+        ...(input.lastMessageAt && { lastMessageAt: input.lastMessageAt }),
+        ...(input.userEmail && { userEmail: input.userEmail }),
+        ...(input.metadata && { metadata: { ...existing.metadata, ...input.metadata } }),
+        updatedAt: nowISO(input.now),
+    };
+    index.sessions[existingIndex] = merged;
+    await writeSessionState(projectDir, index);
+    return merged;
+}
+/**
+ * Create-or-update by runtime session id. Used by runtime discovery bridges,
+ * which see the same session many times and must stay idempotent.
+ *
+ * Deliberately never touches `linkedNodeType`/`linkedNodeId`: discovery
+ * refreshes carry status/metadata only and must not silently unlink a session
+ * a human just linked. Linkage is `updateSession`-only.
+ */
+export async function upsertSession(projectDir, input) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => upsertSessionUnlocked(projectDir, input));
+}
+export async function listSessions(projectDir, filters) {
+    const index = await readSessionIndex(projectDir);
+    let sessions = index.sessions;
+    if (filters?.status) {
+        sessions = sessions.filter((s) => s.status === filters.status);
+    }
+    if (filters?.runtimeType) {
+        sessions = sessions.filter((s) => s.runtimeType === filters.runtimeType);
+    }
+    return sessions;
+}
+export async function getSession(projectDir, sessionId) {
+    const normalizedId = normalizeIdentifier(sessionId);
+    const index = await readSessionIndex(projectDir);
+    const session = index.sessions.find((s) => s.normalizedId === normalizedId);
+    if (!session) {
+        throw itemNotFound("session", sessionId);
+    }
+    return session;
+}
+async function updateSessionUnlocked(projectDir, input) {
+    if (input.status !== undefined) {
+        validateSessionStatus(input.status);
+    }
+    const normalizedId = normalizeIdentifier(input.id);
+    const index = await readSessionIndex(projectDir);
+    const sessionIndex = index.sessions.findIndex((s) => s.normalizedId === normalizedId);
+    if (sessionIndex === -1) {
+        throw itemNotFound("session", input.id);
+    }
+    const session = index.sessions[sessionIndex];
+    if (input.status !== undefined)
+        session.status = input.status;
+    if (input.lastMessageAt !== undefined) {
+        if (input.lastMessageAt === null || input.lastMessageAt === "") {
+            delete session.lastMessageAt;
+        }
+        else {
+            session.lastMessageAt = input.lastMessageAt;
+        }
+    }
+    if (input.lastCheckpointAt !== undefined) {
+        if (input.lastCheckpointAt === null || input.lastCheckpointAt === "") {
+            delete session.lastCheckpointAt;
+        }
+        else {
+            session.lastCheckpointAt = input.lastCheckpointAt;
+        }
+    }
+    if (input.userEmail !== undefined) {
+        if (input.userEmail === null || input.userEmail === "") {
+            delete session.userEmail;
+        }
+        else {
+            session.userEmail = input.userEmail;
+        }
+    }
+    if (input.metadata !== undefined) {
+        if (input.metadata === null) {
+            delete session.metadata;
+        }
+        else {
+            session.metadata = { ...session.metadata, ...input.metadata };
+        }
+    }
+    if (input.messageQueue !== undefined) {
+        if (input.messageQueue === null || input.messageQueue.length === 0) {
+            delete session.messageQueue;
+        }
+        else {
+            session.messageQueue = [...input.messageQueue];
+        }
+    }
+    if (input.linkedNodeType !== undefined || input.linkedNodeId !== undefined) {
+        const clearing = input.linkedNodeType === null || input.linkedNodeId === null || input.linkedNodeId === "";
+        if (clearing) {
+            // Unlinking is atomic: both halves go, never one without the other.
+            delete session.linkedNodeType;
+            delete session.linkedNodeId;
+        }
+        else {
+            const nodeType = input.linkedNodeType ?? session.linkedNodeType;
+            const nodeId = input.linkedNodeId ?? session.linkedNodeId;
+            if (!nodeType || !nodeId) {
+                throw invalidSessionLink("linkedNodeType and linkedNodeId must be set together");
+            }
+            validateSessionLinkedNodeType(nodeType);
+            session.linkedNodeId = await resolveLinkedNodeId(projectDir, nodeType, nodeId);
+            session.linkedNodeType = nodeType;
+        }
+    }
+    session.updatedAt = nowISO(input.now);
+    index.sessions[sessionIndex] = session;
+    await writeSessionState(projectDir, index);
+    return session;
+}
+export async function updateSession(projectDir, input) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => updateSessionUnlocked(projectDir, input));
+}
+function findSessionIndex(index, sessionId) {
+    const normalizedId = normalizeIdentifier(sessionId);
+    const position = index.sessions.findIndex((s) => s.normalizedId === normalizedId);
+    if (position === -1) {
+        throw itemNotFound("session", sessionId);
+    }
+    return position;
+}
+async function enqueueSessionMessageUnlocked(projectDir, sessionId, message) {
+    const index = await readSessionIndex(projectDir);
+    const position = findSessionIndex(index, sessionId);
+    const session = index.sessions[position];
+    session.messageQueue = [...(session.messageQueue ?? []), message];
+    session.updatedAt = nowISO();
+    index.sessions[position] = session;
+    await writeSessionState(projectDir, index);
+    return session;
+}
+/**
+ * Appends a message to a session's pending queue.
+ *
+ * Deliberately not part of `updateSession`: the generic path shallow-merges
+ * whatever the caller passes, which would let two concurrent senders read the
+ * same array and write back a queue missing one message. Append happens inside
+ * the store lock, so the read-modify-write is atomic.
+ *
+ * The message is stored verbatim — callers validate content (the route rejects
+ * empty strings before it gets here).
+ */
+export async function enqueueSessionMessage(projectDir, sessionId, message) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => enqueueSessionMessageUnlocked(projectDir, sessionId, message));
+}
+async function drainSessionMessageQueueUnlocked(projectDir, sessionId) {
+    const index = await readSessionIndex(projectDir);
+    const position = findSessionIndex(index, sessionId);
+    const session = index.sessions[position];
+    const drained = session.messageQueue ?? [];
+    if (drained.length === 0) {
+        // Nothing pending — the common case at a checkpoint. Skip the write so an
+        // idle session's index.json does not churn on every prompt.
+        return [];
+    }
+    delete session.messageQueue;
+    session.lastMessageAt = nowISO();
+    session.updatedAt = session.lastMessageAt;
+    index.sessions[position] = session;
+    await writeSessionState(projectDir, index);
+    return drained;
+}
+/**
+ * Reads and clears a session's pending queue in one lock acquisition.
+ *
+ * Read-then-clear must be atomic: a checkpoint that read the queue and cleared
+ * it in two calls would drop any message enqueued in between. Delivery is
+ * at-most-once — a consumer that crashes after draining loses the batch, which
+ * is the accepted trade for never replaying a message twice into a session.
+ */
+export async function drainSessionMessageQueue(projectDir, sessionId) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => drainSessionMessageQueueUnlocked(projectDir, sessionId));
+}
+/** Epoch ms for an ISO stamp, falling back to now for an unparsable override. */
+function epochMs(isoTimestamp) {
+    const parsed = Date.parse(isoTimestamp);
+    return Number.isNaN(parsed) ? Date.now() : parsed;
+}
+/** Existing `metadata.run` as a mergeable object — anything else reads empty. */
+function existingRunMetadata(session) {
+    const run = session.metadata?.run;
+    if (typeof run !== "object" || run === null || Array.isArray(run))
+        return {};
+    return run;
+}
+async function beginSessionRunUnlocked(projectDir, sessionId, input) {
+    const index = await readSessionIndex(projectDir);
+    const position = findSessionIndex(index, sessionId);
+    const session = index.sessions[position];
+    const ts = nowISO(input.now);
+    const pid = typeof input.pid === "number" && Number.isInteger(input.pid) && input.pid > 0
+        ? input.pid
+        : undefined;
+    session.currentRunId = input.runId;
+    if (pid === undefined)
+        delete session.currentRunPid;
+    else
+        session.currentRunPid = pid;
+    session.heartbeatAt = ts;
+    // A fresh claim REPLACES metadata.run rather than merging into it: one run
+    // object per record, so a live claim can never sit next to the previous run's
+    // outcome. Epoch ms here, matching every other metadata.run timestamp.
+    session.metadata = {
+        ...session.metadata,
+        run: { runId: input.runId, pid: pid ?? null, startedAt: epochMs(ts) },
+    };
+    session.updatedAt = ts;
+    index.sessions[position] = session;
+    await writeSessionState(projectDir, index);
+    return session;
+}
+/**
+ * Claims a session for a headless run: persists the run id, the child's pid and
+ * the first heartbeat, all of which survive the server process that made them.
+ *
+ * The claim is what makes a run recoverable. In-memory liveness (the runner's
+ * `liveRuns` map) dies with the server, so without a persisted claim a run
+ * interrupted by a restart would leave the session reading `running` forever
+ * with nothing left that could ever settle it.
+ */
+export async function beginSessionRun(projectDir, sessionId, input) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => beginSessionRunUnlocked(projectDir, sessionId, input));
+}
+async function settleSessionRunUnlocked(projectDir, sessionId, input) {
+    const index = await readSessionIndex(projectDir);
+    const position = findSessionIndex(index, sessionId);
+    const session = index.sessions[position];
+    const claim = sessionRunClaim(session);
+    // Either there is nothing to settle, or a newer run already owns the record.
+    // Both mean the caller is settling a run that is no longer current, so the
+    // record is left byte-identical — no write, no churn, no clobbered outcome.
+    if (claim === undefined)
+        return session;
+    if (input.runId !== undefined && input.runId !== claim)
+        return session;
+    const ts = nowISO(input.now);
+    const run = {
+        ...existingRunMetadata(session),
+        ...input.run,
+        outcome: input.outcome,
+        endedAt: input.endedAt ?? epochMs(ts),
+        ...(input.error !== undefined && { error: input.error }),
+    };
+    // The claim and its proof of life go together: a heartbeat left behind on a
+    // settled record would be evidence for a process that is no longer running.
+    delete session.currentRunId;
+    delete session.currentRunPid;
+    delete session.heartbeatAt;
+    session.metadata = { ...session.metadata, ...input.metadata, run };
+    session.updatedAt = ts;
+    index.sessions[position] = session;
+    await writeSessionState(projectDir, index);
+    return session;
+}
+/**
+ * Releases a session's run claim, records how the run ended on `metadata.run`,
+ * and applies whatever the settle repaired — in ONE lock acquisition.
+ *
+ * Read-modify-write has to be atomic: `metadata.run` is replaced wholesale by
+ * every writer, so settling through the generic `updateSession` would race the
+ * route's own write-back and could drop the run's pid/startedAt.
+ *
+ * Everything a settle concludes therefore goes in HERE rather than in a
+ * follow-up `updateSession`. The claim is the only thing serializing a run
+ * against the next one, and releasing it is the LAST thing this write does — so
+ * a conclusion left to a second write is both observable in the gap (the record
+ * reads settled while still carrying the state the run just disproved) and
+ * unguarded outside it: the `input.runId` check above holds only for the
+ * duration of this lock, and a newer run can claim the record the moment it is
+ * released.
+ */
+export async function settleSessionRun(projectDir, sessionId, input) {
+    await ensureDir(join(projectDir, "sessions"));
+    return withLock(sessionStoreLockPath(projectDir), () => settleSessionRunUnlocked(projectDir, sessionId, input));
+}
+async function deleteSessionUnlocked(projectDir, sessionId) {
+    const normalizedId = normalizeIdentifier(sessionId);
+    const index = await readSessionIndex(projectDir);
+    const session = index.sessions.find((s) => s.normalizedId === normalizedId);
+    if (!session) {
+        throw itemNotFound("session", sessionId);
+    }
+    index.sessions = index.sessions.filter((s) => s.normalizedId !== normalizedId);
+    await writeSessionState(projectDir, index);
+}
+export async function deleteSession(projectDir, sessionId) {
+    await ensureDir(join(projectDir, "sessions"));
+    await withLock(sessionStoreLockPath(projectDir), () => deleteSessionUnlocked(projectDir, sessionId));
+}
+//# sourceMappingURL=session-store.js.map

package/dist/utils/session-store.js.map

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

package/dist/utils/storage-utils.d.ts

@@ -14,6 +14,17 @@ export declare const TASK_STATUSES: readonly ["backlog", "in_progress", "done",
 export type TaskStatus = (typeof TASK_STATUSES)[number];
 export declare const TASK_PRIORITIES: readonly ["critical", "high", "medium", "low"];
 export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+export declare const SESSION_STATUSES: readonly ["active", "idle", "completed", "failed", "disconnected"];
+export type SessionStatus = (typeof SESSION_STATUSES)[number];
+export declare const SESSION_RUNTIME_TYPES: readonly ["opencode", "claude-code"];
+export type SessionRuntimeType = (typeof SESSION_RUNTIME_TYPES)[number];
+/**
+ * DAG node kinds a session may be linked to. Linkage always keys on the
+ * task/plan normalized id — never on a diagram node id (T001…), which is
+ * regenerated by `arcs diagram sort-metadata`.
+ */
+export declare const SESSION_LINKED_NODE_TYPES: readonly ["task", "plan"];
+export type SessionLinkedNodeType = (typeof SESSION_LINKED_NODE_TYPES)[number];
 export interface FileRef {
     path: string;
     anchor?: string;
@@ -30,10 +41,30 @@ export declare function validatePlanStatus(status: string): asserts status is Pl
 export declare function validateKnowledgeKind(kind: string): asserts kind is KnowledgeKind;
 export declare function validateTaskStatus(status: string): asserts status is TaskStatus;
 export declare function validateTaskPriority(priority: string): asserts priority is TaskPriority;
+export declare function validateSessionStatus(status: string): asserts status is SessionStatus;
+export declare function validateSessionRuntimeType(runtimeType: string): asserts runtimeType is SessionRuntimeType;
+export declare function validateSessionLinkedNodeType(nodeType: string): asserts nodeType is SessionLinkedNodeType;
 /** A valid keyword is a non-empty, lowercase, alpha-numeric-or-dash string. */
 export declare function sanitizeKeywords(raw: string[]): string[];
 export declare function fileExists(path: string): Promise<boolean>;
 export declare function ensureDir(dir: string): Promise<void>;
+/**
+ * Durably replace a text file: fsync the staged file, rename atomically, then
+ * fsync the parent directory where supported.
+ */
+export declare function writeTextAtomic(filePath: string, content: string): Promise<void>;
+export interface FileMutation {
+    path: string;
+    /** null removes the file. */
+    content: string | null;
+}
+/**
+ * Best-effort multi-file transaction. Every file replacement is individually
+ * atomic/durable; if a later mutation fails, prior files are restored from
+ * their snapshots before the error is rethrown. Callers must hold the
+ * collection-level advisory lock for the whole operation.
+ */
+export declare function writeFilesTransaction(mutations: FileMutation[]): Promise<void>;
 export declare function writeJson(filePath: string, data: unknown): Promise<void>;
 export declare function nowISO(override?: string): string;
 /**