@rubytech/create-sitedesk-code 0.1.340

package/payload/platform/services/claude-session-manager/dist/reseat-ledger.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from './types.js';
+export interface ReseatMarker {
+    sourceSessionId: string;
+    forkSessionId: string;
+    at: number;
+}
+export declare function reseatMarkerPath(sessionsDir: string, sourceSessionId: string): string;
+export declare function writeReseatMarker(sessionsDir: string, sourceSessionId: string, forkSessionId: string, at: number, logger: Logger): void;
+export declare function readReseatMarker(sessionsDir: string, sourceSessionId: string): ReseatMarker | null;
+export declare function readAllReseatMarkers(sessionsDir: string, logger: Logger): ReseatMarker[];
+export declare function clearReseatMarker(sessionsDir: string, sourceSessionId: string, logger: Logger): void;
+export interface ReseatChainResult {
+    /** The id a resume should land on: the deepest fork whose JSONL exists, or the original id. */
+    target: string;
+    /** Forks visited from the source, in order (excludes the original id). */
+    hops: string[];
+    /** True when at least one marker was followed to an existing fork. */
+    redirected: boolean;
+    /** True when a marker existed for the source but its immediate fork JSONL is gone. */
+    stale: boolean;
+}
+/**
+ * Follow source -> fork -> fork2 ... while a marker exists and the next fork's
+ * JSONL exists. Returns the deepest existing fork as the redirect target.
+ * Cycle-guarded by a visited set and a hard depth cap.
+ */
+export declare function resolveReseatChain(sessionsDir: string, sourceSessionId: string, jsonlExists: (sessionId: string) => boolean, maxDepth?: number): ReseatChainResult;
+/**
+ * The inverse of resolveReseatChain. Given a fork id whose own JSONL does not
+ * exist yet (claude --fork-session flushes the copied history only at the
+ * fork's first turn), walk the ledger back to the nearest ancestor whose JSONL
+ * exists, so the resolver can serve that source transcript read-only until the
+ * fork materialises. Returns the source id, or null when forkSessionId is not a
+ * recorded fork or no ancestor has a JSONL. Cycle-guarded by a visited set and
+ * depth-capped, mirroring resolveReseatChain.
+ */
+export declare function resolveBridgeSource(sessionsDir: string, forkSessionId: string, jsonlExists: (sessionId: string) => boolean, maxDepth?: number): string | null;
+export interface ReseatReconcileResult {
+    scanned: number;
+    stopped: number;
+}
+/**
+ * Scan all markers; stop any source that is currently live and whose fork JSONL
+ * still exists (the fork is the real continuation). If a marked source is live
+ * but its fork JSONL is gone, the marker is stale — clear it and leave the
+ * source running (it is the only surviving copy).
+ */
+export declare function reseatReconcileTick(sessionsDir: string, isLive: (sessionId: string) => boolean, stop: (sourceSessionId: string, forkSessionId: string) => void | Promise<void>, jsonlExists: (sessionId: string) => boolean, logger: Logger): Promise<ReseatReconcileResult>;
+//# sourceMappingURL=reseat-ledger.d.ts.map

package/payload/platform/services/claude-session-manager/dist/reseat-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reseat-ledger.d.ts","sourceRoot":"","sources":["../src/reseat-ledger.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAKxC,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,EAAE,EAAE,MAAM,CAAA;CACX;AAcD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAErF;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,IAAI,CAQN;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAElG;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE,CAIxF;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQpG;AAED,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAA;IACd,0EAA0E;IAC1E,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;IACnB,sFAAsF;IACtF,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAC3C,QAAQ,GAAE,MAA+B,GACxC,iBAAiB,CAwBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAC3C,QAAQ,GAAE,MAA+B,GACxC,MAAM,GAAG,IAAI,CAiBf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EACtC,IAAI,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC9E,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,EAC3C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC,CAchC"}

package/payload/platform/services/claude-session-manager/dist/reseat-ledger.js

@@ -0,0 +1,148 @@
+// Task 896 — per-source re-seat marker.
+//
+// A model re-seat forks the open admin-webchat session onto a fresh id and
+// stops the source's live PTY, but nothing recorded that the source was
+// re-seated, so a later resume of the source id spawned a second live process
+// alongside the fork. This marker records source -> fork so the resume path can
+// redirect to the fork instead of spawning, and a reconcile sweep can stop a
+// source that became live anyway.
+//
+// Location mirrors scope-record.ts: <configDir>/sessions/<sourceId>.reseated.json.
+// The pid-file regex (^[0-9]+\.json$) and scope-record (\.scope\.json$) never
+// match <uuid>.reseated.json, so the three sidecars share the dir without
+// collision.
+//
+// Task 902 — the file mechanics (path, atomic write, scan, clear) live in the
+// shared `sidecar-store` helper; this module owns the marker shape, the
+// `[reseat-ledger]` log lines, and the chain/reconcile logic below.
+import { createSidecarStore } from './sidecar-store.js';
+const RESEAT_CHAIN_MAX_DEPTH = 16;
+const store = createSidecarStore({
+    suffix: '.reseated.json',
+    validate: (raw) => {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const r = raw;
+        if (typeof r.sourceSessionId === 'string' && typeof r.forkSessionId === 'string' && typeof r.at === 'number') {
+            return { sourceSessionId: r.sourceSessionId, forkSessionId: r.forkSessionId, at: r.at };
+        }
+        return null;
+    },
+});
+export function reseatMarkerPath(sessionsDir, sourceSessionId) {
+    return store.pathFor(sessionsDir, sourceSessionId);
+}
+export function writeReseatMarker(sessionsDir, sourceSessionId, forkSessionId, at, logger) {
+    const res = store.write(sessionsDir, sourceSessionId, { sourceSessionId, forkSessionId, at });
+    if (res.ok) {
+        logger(`[reseat-ledger] write source=${sourceSessionId.slice(0, 8)} fork=${forkSessionId.slice(0, 8)}`);
+    }
+    else {
+        const err = res.error;
+        logger(`[reseat-ledger] write-failed source=${sourceSessionId.slice(0, 8)} err=${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function readReseatMarker(sessionsDir, sourceSessionId) {
+    return store.read(sessionsDir, sourceSessionId);
+}
+export function readAllReseatMarkers(sessionsDir, logger) {
+    // A marker file that is unreadable OR fails the shape check is skipped and
+    // logged, matching the pre-902 readReseatMarker-returns-null behaviour.
+    return store.readAll(sessionsDir, (name) => logger(`[reseat-ledger] skip-unreadable file=${name}`));
+}
+export function clearReseatMarker(sessionsDir, sourceSessionId, logger) {
+    const res = store.clear(sessionsDir, sourceSessionId);
+    if (!res.ok) {
+        const err = res.error;
+        logger(`[reseat-ledger] clear-failed source=${sourceSessionId.slice(0, 8)} err=${err instanceof Error ? err.message : String(err)}`);
+    }
+    else if (res.removed) {
+        logger(`[reseat-ledger] clear source=${sourceSessionId.slice(0, 8)}`);
+    }
+}
+/**
+ * Follow source -> fork -> fork2 ... while a marker exists and the next fork's
+ * JSONL exists. Returns the deepest existing fork as the redirect target.
+ * Cycle-guarded by a visited set and a hard depth cap.
+ */
+export function resolveReseatChain(sessionsDir, sourceSessionId, jsonlExists, maxDepth = RESEAT_CHAIN_MAX_DEPTH) {
+    const hops = [];
+    const visited = new Set([sourceSessionId]);
+    let current = sourceSessionId;
+    let target = sourceSessionId;
+    let redirected = false;
+    let stale = false;
+    for (let depth = 0; depth < maxDepth; depth++) {
+        const marker = readReseatMarker(sessionsDir, current);
+        if (!marker)
+            break;
+        const fork = marker.forkSessionId;
+        if (visited.has(fork))
+            break;
+        visited.add(fork);
+        if (jsonlExists(fork)) {
+            hops.push(fork);
+            target = fork;
+            redirected = true;
+            current = fork;
+            continue;
+        }
+        if (current === sourceSessionId)
+            stale = true;
+        break;
+    }
+    return { target, hops, redirected, stale };
+}
+/**
+ * The inverse of resolveReseatChain. Given a fork id whose own JSONL does not
+ * exist yet (claude --fork-session flushes the copied history only at the
+ * fork's first turn), walk the ledger back to the nearest ancestor whose JSONL
+ * exists, so the resolver can serve that source transcript read-only until the
+ * fork materialises. Returns the source id, or null when forkSessionId is not a
+ * recorded fork or no ancestor has a JSONL. Cycle-guarded by a visited set and
+ * depth-capped, mirroring resolveReseatChain.
+ */
+export function resolveBridgeSource(sessionsDir, forkSessionId, jsonlExists, maxDepth = RESEAT_CHAIN_MAX_DEPTH) {
+    // Markers are keyed by source; build the fork -> source inverse once.
+    const sourceOf = new Map();
+    for (const m of readAllReseatMarkers(sessionsDir, () => { })) {
+        sourceOf.set(m.forkSessionId, m.sourceSessionId);
+    }
+    const visited = new Set([forkSessionId]);
+    let current = forkSessionId;
+    for (let depth = 0; depth < maxDepth; depth++) {
+        const source = sourceOf.get(current);
+        if (source === undefined)
+            return null; // not a recorded fork / end of chain
+        if (visited.has(source))
+            return null; // cycle guard
+        visited.add(source);
+        if (jsonlExists(source))
+            return source; // nearest ancestor with a JSONL
+        current = source;
+    }
+    return null;
+}
+/**
+ * Scan all markers; stop any source that is currently live and whose fork JSONL
+ * still exists (the fork is the real continuation). If a marked source is live
+ * but its fork JSONL is gone, the marker is stale — clear it and leave the
+ * source running (it is the only surviving copy).
+ */
+export async function reseatReconcileTick(sessionsDir, isLive, stop, jsonlExists, logger) {
+    const markers = readAllReseatMarkers(sessionsDir, logger);
+    let stopped = 0;
+    for (const m of markers) {
+        if (!isLive(m.sourceSessionId))
+            continue;
+        if (!jsonlExists(m.forkSessionId)) {
+            clearReseatMarker(sessionsDir, m.sourceSessionId, logger);
+            continue;
+        }
+        await stop(m.sourceSessionId, m.forkSessionId);
+        logger(`[reseat-reconcile] op=stop source=${m.sourceSessionId.slice(0, 8)} fork=${m.forkSessionId.slice(0, 8)}`);
+        stopped++;
+    }
+    return { scanned: markers.length, stopped };
+}
+//# sourceMappingURL=reseat-ledger.js.map

package/payload/platform/services/claude-session-manager/dist/reseat-ledger.js.map

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

package/payload/platform/services/claude-session-manager/dist/scope-record.d.ts

@@ -0,0 +1,11 @@
+type Logger = (line: string) => void;
+export interface ScopeRecord {
+    sessionId: string;
+    scopeUnitToken: string;
+}
+export declare function scopeRecordPath(sessionsDir: string, sessionId: string): string;
+export declare function writeScopeRecord(sessionsDir: string, sessionId: string, scopeUnitToken: string, logger: Logger): void;
+export declare function readAllScopeRecords(sessionsDir: string, logger: Logger): ScopeRecord[];
+export declare function removeScopeRecord(sessionsDir: string, sessionId: string, logger: Logger): void;
+export {};
+//# sourceMappingURL=scope-record.d.ts.map

package/payload/platform/services/claude-session-manager/dist/scope-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-record.d.ts","sourceRoot":"","sources":["../src/scope-record.ts"],"names":[],"mappings":"AAoBA,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACvB;AAeD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,CAQN;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAMtF;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ9F"}

package/payload/platform/services/claude-session-manager/dist/scope-record.js

@@ -0,0 +1,63 @@
+// Task 702 — per-session reattach record.
+//
+// `/rc-spawn` runs its scope under a random unit token `rc-resume-<uuid>` and
+// writes no sidecar, so boot-seed had no way to map a surviving scope back to
+// its sessionId and orphan-killed live admin sessions on every manager restart.
+// This record supplies exactly that mapping. Boot-seed applies it onto the
+// row's `scopeUnitToken` (the same field a `/spawn` sidecar carries) and
+// reattaches via the existing token path, with a MainPID liveness fallback.
+//
+// Location: `<configDir>/sessions/<sessionId>.scope.json`. The `sessions/` dir
+// is the same dir boot-seed already scans for pid files; the pid-file name
+// regex (`^[0-9]+\.json$`) never matches a `<uuid>.scope.json`, so there is no
+// collision.
+//
+// Task 902 — the file mechanics (path, atomic write, scan, clear) live in the
+// shared `sidecar-store` helper; this module owns only the record shape and the
+// `[scope-record]` log lines.
+import { createSidecarStore } from './sidecar-store.js';
+const store = createSidecarStore({
+    suffix: '.scope.json',
+    validate: (raw) => {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const sid = raw.sessionId;
+        const tok = raw.scopeUnitToken;
+        if (typeof sid === 'string' && sid.length > 0 && typeof tok === 'string' && tok.length > 0) {
+            return { sessionId: sid, scopeUnitToken: tok };
+        }
+        return null;
+    },
+});
+export function scopeRecordPath(sessionsDir, sessionId) {
+    return store.pathFor(sessionsDir, sessionId);
+}
+export function writeScopeRecord(sessionsDir, sessionId, scopeUnitToken, logger) {
+    const res = store.write(sessionsDir, sessionId, { sessionId, scopeUnitToken });
+    if (res.ok) {
+        logger(`[scope-record] write sessionId=${sessionId.slice(0, 8)} unitToken=${scopeUnitToken}`);
+    }
+    else {
+        const err = res.error;
+        logger(`[scope-record] write-failed sessionId=${sessionId.slice(0, 8)} err=${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export function readAllScopeRecords(sessionsDir, logger) {
+    // Only JSON-unreadable files log; a parsed-but-wrong-shape file is skipped
+    // silently, matching the pre-902 inline scan.
+    return store.readAll(sessionsDir, (name, reason) => {
+        if (reason === 'unreadable')
+            logger(`[scope-record] parse-failed file=${name}`);
+    });
+}
+export function removeScopeRecord(sessionsDir, sessionId, logger) {
+    const res = store.clear(sessionsDir, sessionId);
+    if (!res.ok) {
+        const err = res.error;
+        logger(`[scope-record] remove-failed sessionId=${sessionId.slice(0, 8)} err=${err instanceof Error ? err.message : String(err)}`);
+    }
+    else if (res.removed) {
+        logger(`[scope-record] remove sessionId=${sessionId.slice(0, 8)}`);
+    }
+}
+//# sourceMappingURL=scope-record.js.map

package/payload/platform/services/claude-session-manager/dist/scope-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-record.js","sourceRoot":"","sources":["../src/scope-record.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,2EAA2E;AAC3E,yEAAyE;AACzE,4EAA4E;AAC5E,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,aAAa;AACb,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8BAA8B;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AASvD,MAAM,KAAK,GAAG,kBAAkB,CAAc;IAC5C,MAAM,EAAE,aAAa;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;QAChB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAChD,MAAM,GAAG,GAAI,GAA+B,CAAC,SAAS,CAAA;QACtD,MAAM,GAAG,GAAI,GAAoC,CAAC,cAAc,CAAA;QAChE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3F,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,CAAA;QAChD,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,SAAiB;IACpE,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,WAAmB,EACnB,SAAiB,EACjB,cAAsB,EACtB,MAAc;IAEd,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAA;IAC9E,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACX,MAAM,CAAC,kCAAkC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,cAAc,EAAE,CAAC,CAAA;IAC/F,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAA;QACrB,MAAM,CAAC,yCAAyC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAClI,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,MAAc;IACrE,2EAA2E;IAC3E,8CAA8C;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QACjD,IAAI,MAAM,KAAK,YAAY;YAAE,MAAM,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB,EAAE,SAAiB,EAAE,MAAc;IACtF,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAA;QACrB,MAAM,CAAC,0CAA0C,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACnI,CAAC;SAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,mCAAmC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACpE,CAAC;AACH,CAAC"}

package/payload/platform/services/claude-session-manager/dist/session-sidecar.d.ts

@@ -0,0 +1,130 @@
+import type { Logger, Role, Channel } from './types.js';
+export interface SessionSidecar {
+    senderId: string;
+    role: Role;
+    channel: Channel;
+    /** Operator-facing iframe URL from the `/remote-control is active` banner.
+     *  Null until url-capture matches; may stay null forever on headless
+     *  spawns (no banner) and on archived rows whose live PTY exited before
+     *  the URL landed. */
+    url: string | null;
+    /** ISO 8601 timestamp from `/spawn`. */
+    startedAt: string;
+    /** Permission mode recorded at spawn time. For `/spawn` this is the
+     *  operator's spawn-request choice; for `/rc-spawn` (Task 798) it is the
+     *  settings-resolved mode the session actually runs under
+     *  (`permissions.defaultMode`, else 'default') — rc-spawn argv carries no
+     *  `--permission-mode` and its request has no mode field. Null on
+     *  sessions spawned before Task 798. The binary's observed runtime mode
+     *  lives in `effectivePermissionMode` below. */
+    permissionMode: string | null;
+    /** Task 278 — binary's actual runtime permission mode, as observed via
+     *  the `--debug=auto-mode` capture in `<sessionId>.permission-mode.log`.
+     *  Null at spawn until the first `[auto-mode] verifyAutoModeGateAccess`
+     *  line resolves. Stays null forever on non-auto spawns (no signal
+     *  source for `acceptEdits` / `plan` / `bypassPermissions` on 2.1.150).
+     *  When non-null and `!== permissionMode`, the SessionMetadataPane
+     *  renders a downgrade warning. */
+    effectivePermissionMode: string | null;
+    /** Spawn-requested model (e.g. 'claude-opus-4-7'). Null when not set.
+     *  Note: the wire's `model` field continues to derive from the JSONL
+     *  tail's last assistant turn — this sidecar field records the SPAWN
+     *  REQUEST, not the running model, and exists for self-diagnosis. */
+    model: string | null;
+    /** Hidden spawn — operator sidebar suppresses the row. Known at /spawn
+     *  body parse; never changes for a row's lifetime. */
+    hidden: boolean;
+    /** Specialist agent name from `/spawn` body or resolved agent at PTY
+     *  ready. Null for operator (non-specialist) spawns. */
+    specialist: string | null;
+    /** Task 451 — the systemd transient scope unit token under which this
+     *  PTY runs (unit name is `claude-session-<token>.scope`). Persisted on
+     *  disk so boot-seed can reattach a surviving scope to its row after
+     *  manager restart, even for fresh spawns where the unit token is a
+     *  random UUID that does not match claude's intrinsic sessionId. Null
+     *  on pre-Task-451 sidecars and on any non-scope spawn path. */
+    scopeUnitToken: string | null;
+    /** Task 550 — composer bridge ULIDs (suffix only, no "session_" prefix)
+     *  that have been bound to this conversation across its lifetime. Every
+     *  `/rc-spawn` resume against an existing JSONL learns a new bridge ULID
+     *  from the PID file once claude registers with the composer; the
+     *  http-server appends it here so a future composer-URL → row lookup is
+     *  a direct match. Defaults to `[]` on pre-Task-550 sidecars (missing
+     *  key). Append-only, duplicates suppressed. */
+    bridgeIds: string[];
+    /** Task 863 — public-webchat visitor identity (Neo4j Person elementId)
+     *  captured at `/spawn` from the AccessSession. Null for every non-public
+     *  spawn and for sessions spawned before Task 863 (missing key). The admin
+     *  Sessions panel reads it back to render the visitor's display name. */
+    personId: string | null;
+    /** Task 865 — admin-webchat author identity: the authenticated admin's
+     *  `AdminUser.userId`, threaded from the PIN session at webchat spawn. Null
+     *  for every non-admin-webchat session and for pre-865 sidecars (missing
+     *  key). Distinct from `personId`: the admin is resolved by the
+     *  `AdminUser.userId` property (loadAdminUserName), the public visitor by
+     *  Neo4j elementId. Mutually exclusive with `personId` per row (admin vs
+     *  public role). */
+    adminUserId: string | null;
+    /** Task 933 — the resolved authenticated-admin display name, persisted so the
+     *  manager (which holds no Neo4j driver) can inject the identity segment on a
+     *  caller-driven channel resume, where the request body carries no
+     *  `authenticatedName`. Written/refreshed from the rc-spawn body whenever it
+     *  carries one. Null for non-admin-webchat sessions and for pre-933 sidecars
+     *  (missing key); a null here on an admin-webchat resume yields the explicit
+     *  not-resolvable identity form. */
+    authenticatedName: string | null;
+    /** Task 884 — open-mode public-webchat visitor identity (the `maxy_visitor`
+     *  cookie UUID). Null for gated/admin spawns and for pre-884 sidecars. The
+     *  public reader matches it as the open-mode ownership anchor (the open twin
+     *  of `personId`). */
+    visitorId: string | null;
+    /** Task 884 — the resolved public agent slug for this session. Stamped on
+     *  every public webchat spawn so the open-mode reader can scope a visitor's
+     *  session resolution per agent (one shared `maxy_visitor` cookie spans all
+     *  open agents on the site). Null for non-public spawns and pre-884 sidecars. */
+    agentSlug: string | null;
+    /** Task 983 — the account this session is scoped to (ACCOUNT_ID at spawn). The
+     *  admin shell's account switcher filters the session list by it. Optional on
+     *  disk: pre-983 sidecars (no key) and non-rc-spawn paths load null, which the
+     *  reader treats as the house account. */
+    accountId?: string | null;
+}
+export interface SidecarReadOutcome {
+    sidecar: SessionSidecar | null;
+    /** Why `sidecar` is null when null. Lets callers and the watcher's
+     *  boot-seed log line distinguish "no sidecar on disk" from "sidecar
+     *  unparseable" — both yield null fields on the row, but the latter
+     *  signals a write defect worth investigating. */
+    outcome: 'ok' | 'missing' | 'parse-failed';
+    /** File size in bytes when present; 0 otherwise. */
+    bytes: number;
+}
+/** Read a sidecar from disk. Returns `outcome: 'missing'` when the file
+ *  is absent; `outcome: 'parse-failed'` when it exists but cannot be
+ *  parsed as the expected shape. The caller (watcher row builder) stamps
+ *  null fields on the row in both cases and the boot-seed log line
+ *  surfaces the mismatch. */
+export declare function readSidecar(path: string, logger: Logger): SidecarReadOutcome;
+/** Write a sidecar atomically: tmp file in the same directory, then
+ *  rename. Throws if the directory cannot be created or the rename
+ *  fails — the spawn route translates this to a loud 500 rather than
+ *  launching a metadata-less PTY. */
+export declare function writeSidecar(path: string, sidecar: SessionSidecar, logger: Logger): void;
+/** Read-modify-write update. Returns true when the field was written;
+ *  false when the sidecar is missing or unparseable (caller may choose
+ *  to log; we don't write a fresh sidecar from a partial update because
+ *  the other fields would be invented). Single-writer assumption applies
+ *  — concurrent updates may race and lose the latest value. */
+export declare function updateSidecar(path: string, patch: Partial<SessionSidecar>, logger: Logger): boolean;
+/** Task 550 — append a bridge ULID suffix to `bridgeIds` on the sidecar.
+ *  Read-modify-write; the atomic rename pattern matches the rest of this
+ *  module. Returns `'ok'` when written, `'duplicate'` when the suffix was
+ *  already present (no write performed), and `'no-sidecar'` when the
+ *  sidecar is missing or unparseable (caller logs and skips — legacy
+ *  rows without a sidecar are out of scope per the task brief).
+ *  Single-writer assumption is shared with url-capture's updateSidecar:
+ *  both are read-modify-write and could race, but they touch disjoint
+ *  fields, so the rename-loses-write window is the existing limitation
+ *  rather than a new one. */
+export declare function appendBridgeId(path: string, bridgeSuffix: string, logger: Logger): 'ok' | 'duplicate' | 'no-sidecar';
+//# sourceMappingURL=session-sidecar.d.ts.map

package/payload/platform/services/claude-session-manager/dist/session-sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-sidecar.d.ts","sourceRoot":"","sources":["../src/session-sidecar.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB;;;0BAGsB;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;oDAMgD;IAChD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;;;;;uCAMmC;IACnC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC;;;yEAGqE;IACrE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;0DACsD;IACtD,MAAM,EAAE,OAAO,CAAA;IACf;4DACwD;IACxD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;oEAKgE;IAChE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B;;;;;;oDAMgD;IAChD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;;6EAGyE;IACzE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;;;;wBAMoB;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;;;;;wCAMoC;IACpC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;;0BAGsB;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;qFAGiF;IACjF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;;;8CAG0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9B;;;sDAGkD;IAClD,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,cAAc,CAAA;IAC1C,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;CACd;AAMD;;;;6BAI6B;AAC7B,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CA+B5E;AAED;;;qCAGqC;AACrC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAiBxF;AAED;;;;+DAI+D;AAC/D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAmBT;AAED;;;;;;;;;6BAS6B;AAC7B,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,IAAI,GAAG,WAAW,GAAG,YAAY,CAmBnC"}