@rubytech/create-sitedesk-code 0.1.340

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

@@ -0,0 +1,291 @@
+// Spawn-metadata sidecar (Task 260). Disk is the only source of truth for
+// row metadata. The sidecar carries everything the manager learned at
+// `/spawn` time that the JSONL transcript itself does not record:
+// `senderId`, `role`, `channel`, `url`, `startedAt`, `permissionMode`,
+// `model`, `hidden`, `specialist`. The watcher reads it when building
+// rows; the http-server writes it on `/spawn`; url-capture updates the
+// `url` field once the `/remote-control` banner lands.
+//
+// Location: `<projectsDir>/<sessionId>.meta.json` for live rows;
+// `<projectsDir>/archive/<sessionId>.meta.json` for archived rows. The
+// pair (sidecar + JSONL) moves together on `/archive` and `/unarchive`.
+//
+// Atomic write: write to `<path>.tmp.<pid>.<ts>`, then `rename` to the
+// final path. POSIX guarantees rename atomicity on the same filesystem,
+// so a crash mid-write leaves the prior file (if any) intact; the tmp
+// file is the only leak, and a stale `.tmp.*` is harmless because the
+// watcher and route code only read the canonical path.
+//
+// Single-writer pattern. Write sites today: the spawn route (one
+// `writeSidecar` per `/spawn`), the `/rc-spawn` classification write
+// (one `writeSidecar`, gated write-once-if-absent — Tasks 721/724/798),
+// url-capture (one `updateSidecar({url})` per session), the Task 278
+// effective-mode tail (`updateSidecar({effectivePermissionMode})`), and
+// `appendBridgeId` (Task 550). One out-of-process writer also exists: the
+// Task 877 admin-webchat `adminUserId` backfill, a one-time idempotent boot
+// pass in `platform/ui` (`migrate-admin-webchat-sidecars.ts`) that read-modify-
+// writes the raw sidecar object — same atomic tmp+rename — to fill the
+// write-once-missed `adminUserId` on pre-865 admin-webchat sidecars. It runs at
+// UI boot, not concurrently with a live spawn of the same session, so it shares
+// the existing single-writer assumption. No concurrent writers race; a future
+// caller that adds another writer must reason about the read-modify-write window
+// in `updateSidecar`.
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+function shortId(sessionId) {
+    return sessionId.slice(0, 8);
+}
+/** 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 function readSidecar(path, logger) {
+    if (!existsSync(path)) {
+        logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=missing bytes=0`);
+        return { sidecar: null, outcome: 'missing', bytes: 0 };
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch {
+        logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=parse-failed bytes=0`);
+        return { sidecar: null, outcome: 'parse-failed', bytes: 0 };
+    }
+    const bytes = Buffer.byteLength(raw, 'utf8');
+    if (raw.length === 0) {
+        logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=parse-failed bytes=0`);
+        return { sidecar: null, outcome: 'parse-failed', bytes: 0 };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=parse-failed bytes=${bytes}`);
+        return { sidecar: null, outcome: 'parse-failed', bytes };
+    }
+    const sidecar = parseSidecar(parsed);
+    if (!sidecar) {
+        logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=parse-failed bytes=${bytes}`);
+        return { sidecar: null, outcome: 'parse-failed', bytes };
+    }
+    logger(`[session-sidecar] read sessionId=${basenameShort(path)} outcome=ok bytes=${bytes}`);
+    return { sidecar, outcome: 'ok', bytes };
+}
+/** 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 function writeSidecar(path, sidecar, logger) {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    const json = JSON.stringify(sidecar, null, 2);
+    const bytes = Buffer.byteLength(json, 'utf8');
+    try {
+        writeFileSync(tmp, json, 'utf8');
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        // Best-effort tmp cleanup; the throw still propagates.
+        try {
+            if (existsSync(tmp))
+                unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+    logger(`[session-sidecar] write sessionId=${basenameShort(path)} senderId=${shortId(sidecar.senderId)} role=${sidecar.role} channel=${sidecar.channel} bytes=${bytes} path=${path}`);
+}
+/** 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 function updateSidecar(path, patch, logger) {
+    const { sidecar } = readSidecar(path, logger);
+    if (!sidecar)
+        return false;
+    const next = { ...sidecar, ...patch };
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    const json = JSON.stringify(next, null, 2);
+    const bytes = Buffer.byteLength(json, 'utf8');
+    try {
+        writeFileSync(tmp, json, 'utf8');
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        try {
+            if (existsSync(tmp))
+                unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+    for (const [k, v] of Object.entries(patch)) {
+        const display = v === null ? 'null' : typeof v === 'string' ? v : String(v);
+        logger(`[session-sidecar] update sessionId=${basenameShort(path)} field=${k} value=${display} bytes=${bytes}`);
+    }
+    return true;
+}
+/** 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 function appendBridgeId(path, bridgeSuffix, logger) {
+    const { sidecar } = readSidecar(path, logger);
+    if (!sidecar)
+        return 'no-sidecar';
+    if (sidecar.bridgeIds.includes(bridgeSuffix))
+        return 'duplicate';
+    const next = { ...sidecar, bridgeIds: [...sidecar.bridgeIds, bridgeSuffix] };
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    const json = JSON.stringify(next, null, 2);
+    const bytes = Buffer.byteLength(json, 'utf8');
+    try {
+        writeFileSync(tmp, json, 'utf8');
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        try {
+            if (existsSync(tmp))
+                unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+    logger(`[session-sidecar] append-bridge sessionId=${basenameShort(path)} bridgeId=${bridgeSuffix} count=${next.bridgeIds.length} bytes=${bytes}`);
+    return 'ok';
+}
+const ROLES = ['admin', 'public'];
+const CHANNELS = ['browser', 'whatsapp', 'telegram', 'webchat', 'email'];
+function parseSidecar(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    if (typeof r.senderId !== 'string' || r.senderId.length === 0)
+        return null;
+    if (typeof r.role !== 'string' || !ROLES.includes(r.role))
+        return null;
+    if (typeof r.channel !== 'string' || !CHANNELS.includes(r.channel))
+        return null;
+    if (typeof r.startedAt !== 'string' || r.startedAt.length === 0)
+        return null;
+    if (typeof r.hidden !== 'boolean')
+        return null;
+    const url = r.url === null ? null : typeof r.url === 'string' ? r.url : undefined;
+    if (url === undefined)
+        return null;
+    const permissionMode = r.permissionMode === null ? null : typeof r.permissionMode === 'string' ? r.permissionMode : undefined;
+    if (permissionMode === undefined)
+        return null;
+    // Task 278 — `effectivePermissionMode` is optional on disk so pre-278
+    // sidecars (no key) load with null. Missing key, JSON null, and
+    // unparseable shape all collapse to null; the field is purely
+    // observational and a missing one is the pre-existing behaviour.
+    const effectivePermissionMode = r.effectivePermissionMode === undefined || r.effectivePermissionMode === null
+        ? null
+        : typeof r.effectivePermissionMode === 'string'
+            ? r.effectivePermissionMode
+            : null;
+    const model = r.model === null ? null : typeof r.model === 'string' ? r.model : undefined;
+    if (model === undefined)
+        return null;
+    const specialist = r.specialist === null ? null : typeof r.specialist === 'string' ? r.specialist : undefined;
+    if (specialist === undefined)
+        return null;
+    // Task 451 — `scopeUnitToken` is optional on disk so pre-451 sidecars
+    // (no key) load with null. Missing key, JSON null, and unparseable shape
+    // all collapse to null; boot-seed treats null as "no reattach hint" and
+    // falls through to the sessionId-direct path or orphan classification.
+    const scopeUnitToken = r.scopeUnitToken === undefined || r.scopeUnitToken === null
+        ? null
+        : typeof r.scopeUnitToken === 'string'
+            ? r.scopeUnitToken
+            : null;
+    // Task 550 — `bridgeIds` is optional on disk so pre-550 sidecars (no key)
+    // load with `[]`. Non-string entries are dropped silently; the file may
+    // have been hand-edited or pre-dates the strict-string contract.
+    const bridgeIds = Array.isArray(r.bridgeIds)
+        ? r.bridgeIds.filter((b) => typeof b === 'string' && b.length > 0)
+        : [];
+    // Task 863 — `personId` is optional on disk so pre-863 sidecars (no key)
+    // load with null. Missing key, JSON null, and unparseable shape all collapse
+    // to null; only public-webchat spawns ever carry a non-null value.
+    const personId = r.personId === undefined || r.personId === null
+        ? null
+        : typeof r.personId === 'string'
+            ? r.personId
+            : null;
+    // Task 865 — `adminUserId` is optional on disk so pre-865 sidecars (no key)
+    // load with null. Missing key, JSON null, and unparseable shape all collapse
+    // to null; only admin-webchat spawns ever carry a non-null value.
+    const adminUserId = r.adminUserId === undefined || r.adminUserId === null
+        ? null
+        : typeof r.adminUserId === 'string'
+            ? r.adminUserId
+            : null;
+    // Task 933 — `authenticatedName` is optional on disk so pre-933 sidecars (no
+    // key) load with null. Missing key, JSON null, and unparseable shape all
+    // collapse to null; only admin-webchat spawns that resolved a name carry one.
+    const authenticatedName = r.authenticatedName === undefined || r.authenticatedName === null
+        ? null
+        : typeof r.authenticatedName === 'string'
+            ? r.authenticatedName
+            : null;
+    // Task 884 — `visitorId` / `agentSlug` are optional on disk so pre-884
+    // sidecars (no key) load with null. Missing key, JSON null, and unparseable
+    // shape all collapse to null.
+    const visitorId = r.visitorId === undefined || r.visitorId === null
+        ? null
+        : typeof r.visitorId === 'string'
+            ? r.visitorId
+            : null;
+    const agentSlug = r.agentSlug === undefined || r.agentSlug === null
+        ? null
+        : typeof r.agentSlug === 'string'
+            ? r.agentSlug
+            : null;
+    // Task 983 — `accountId` optional on disk; pre-983 / non-rc-spawn sidecars
+    // load null and the reader treats null as the house account.
+    const accountId = r.accountId === undefined || r.accountId === null
+        ? null
+        : typeof r.accountId === 'string'
+            ? r.accountId
+            : null;
+    return {
+        senderId: r.senderId,
+        role: r.role,
+        channel: r.channel,
+        url,
+        startedAt: r.startedAt,
+        permissionMode,
+        effectivePermissionMode,
+        model,
+        hidden: r.hidden,
+        specialist,
+        scopeUnitToken,
+        bridgeIds,
+        personId,
+        adminUserId,
+        authenticatedName,
+        visitorId,
+        agentSlug,
+        accountId,
+    };
+}
+function basenameShort(path) {
+    const idx = path.lastIndexOf('/');
+    const name = idx === -1 ? path : path.slice(idx + 1);
+    const sid = name.replace(/\.meta\.json$/, '');
+    return shortId(sid);
+}
+//# sourceMappingURL=session-sidecar.js.map

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

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

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

@@ -0,0 +1,49 @@
+import type { PtyHandle, Role, Channel } from './types.js';
+export interface StoredSession {
+    /** Intrinsic Claude session id (UUID). Stable for the row's lifetime.
+     *  For `/resume` spawns this is the prior canonical id the operator
+     *  pressed Resume on. After Task 258's archive-restore at /resume,
+     *  claude --resume appends to the same canonical jsonl, so the
+     *  StoredSession.sessionId and the on-disk jsonl basename match by
+     *  construction. */
+    sessionId: string;
+    /** "session_<suffix>" form from the PID file. Stable, never null after
+     *  /spawn returns (the spawn promise resolves on PID-file event). */
+    bridgeSessionId: string;
+    /** Suffix-only convenience field (no "session_" prefix). */
+    bridgeSuffix: string;
+    pid: number;
+    /** URL from the `/remote-control` banner. Null until url-capture fires;
+     *  may stay null forever if the banner never lands. The UI tolerates
+     *  null. */
+    url: string | null;
+    startedAt: string;
+    senderId: string;
+    role: Role;
+    channel: Channel;
+    pty: PtyHandle;
+    exited: boolean;
+    /** Task 176 — flipped true when `releasePtyMasterFd` returns
+     *  `master-fd=closed` for this session. Both exit branches set this so
+     *  the second branch (whichever loses the race) can skip a redundant
+     *  `pty.destroy()` that would otherwise throw "socket already
+     *  destroyed" on real node-pty and turn the operator-request log
+     *  line's `master-fd=closed` into a false `master-fd=close-failed`.
+     *  When the first branch's destroy throws (rescued), this stays false
+     *  so the second branch retries — defense in depth. */
+    fdReleased: boolean;
+    hidden: boolean;
+    specialist: string | null;
+}
+export declare class SessionStore {
+    private readonly bySessionId;
+    add(s: StoredSession): void;
+    get(sessionId: string): StoredSession | undefined;
+    remove(sessionId: string): StoredSession | undefined;
+    listBySender(senderId: string, opts?: {
+        includeHidden?: boolean;
+    }): StoredSession[];
+    all(): StoredSession[];
+    size(): number;
+}
+//# sourceMappingURL=session-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,aAAa;IAC5B;;;;;wBAKoB;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB;yEACqE;IACrE,eAAe,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX;;gBAEY;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,SAAS,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf;;;;;;;2DAOuD;IACvD,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAE/D,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI;IAI3B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAOpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,aAAa,EAAE;IAWvF,GAAG,IAAI,aAAa,EAAE;IAItB,IAAI,IAAI,MAAM;CAGf"}

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

@@ -0,0 +1,52 @@
+// In-memory PTY-handle store. The canonical row index lives in the
+// fs-watcher; row state is derived from disk on demand (Task 258). This
+// store only tracks the live PTY handles the manager itself spawned —
+// they aren't on disk. Lookups by alternative identifiers (bridgeSuffix,
+// pid, bridgeSessionId) go through the watcher first to resolve to the
+// canonical sessionId; the store is then keyed solely on sessionId.
+//
+// Lifecycle:
+//   - pty-spawner awaits the PID-file CREATE event from the watcher
+//     before returning a /spawn response. The store row is registered at
+//     that point with sessionId known and bridgeSessionId carried from
+//     the PID file. By the time /spawn returns, sessionId is final.
+//   - URL capture continues in parallel; the row's `url` field is
+//     mutated in place when the URL banner fires (may arrive before or
+//     after the PID-file event; both orderings are safe).
+//   - The jsonl path is derived from sessionId + spawnCwd at every read
+//     site — never stored. Task 258 deleted the stored field.
+export class SessionStore {
+    bySessionId = new Map();
+    add(s) {
+        this.bySessionId.set(s.sessionId, s);
+    }
+    get(sessionId) {
+        return this.bySessionId.get(sessionId);
+    }
+    remove(sessionId) {
+        const s = this.bySessionId.get(sessionId);
+        if (!s)
+            return undefined;
+        this.bySessionId.delete(sessionId);
+        return s;
+    }
+    listBySender(senderId, opts = {}) {
+        const includeHidden = opts.includeHidden === true;
+        const out = [];
+        for (const s of this.bySessionId.values()) {
+            if (s.senderId !== senderId)
+                continue;
+            if (!includeHidden && s.hidden)
+                continue;
+            out.push(s);
+        }
+        return out;
+    }
+    all() {
+        return [...this.bySessionId.values()];
+    }
+    size() {
+        return this.bySessionId.size;
+    }
+}
+//# sourceMappingURL=session-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,wEAAwE;AACxE,sEAAsE;AACtE,yEAAyE;AACzE,uEAAuE;AACvE,oEAAoE;AACpE,EAAE;AACF,aAAa;AACb,oEAAoE;AACpE,yEAAyE;AACzE,uEAAuE;AACvE,oEAAoE;AACpE,kEAAkE;AAClE,uEAAuE;AACvE,0DAA0D;AAC1D,wEAAwE;AACxE,8DAA8D;AAyC9D,MAAM,OAAO,YAAY;IACN,WAAW,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE/D,GAAG,CAAC,CAAgB;QAClB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACxB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAClC,OAAO,CAAC,CAAA;IACV,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,OAAoC,EAAE;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAA;QACjD,MAAM,GAAG,GAAoB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAQ;YACrC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM;gBAAE,SAAQ;YACxC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACb,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC9B,CAAC;CACF"}

package/payload/platform/services/claude-session-manager/dist/settings-permission-mode.d.ts

@@ -0,0 +1,12 @@
+import { type PermissionMode } from './pty-spawner.js';
+export declare function resolveSettingsPermissionMode(claudeConfigDir: string): PermissionMode;
+/** Settings.json `model` — the inception-model lever the binary reads when an
+ *  rc-spawn argv carries no `--model`. Null when absent/unparseable. Read fresh
+ *  per spawn; mirrors resolveSettingsPermissionMode so the argv lifeline reports
+ *  the model the session actually runs under. */
+export declare function resolveSettingsModel(claudeConfigDir: string): string | null;
+/** Settings.json `effortLevel`. Null when absent/unparseable or not a
+ *  settings-accepted level. Drives the read-only composer effort label and the
+ *  argv lifeline's effort field. */
+export declare function resolveSettingsEffort(claudeConfigDir: string): string | null;
+//# sourceMappingURL=settings-permission-mode.d.ts.map

package/payload/platform/services/claude-session-manager/dist/settings-permission-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-permission-mode.d.ts","sourceRoot":"","sources":["../src/settings-permission-mode.ts"],"names":[],"mappings":"AAaA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGxE,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAYrF;AAED;;;iDAGiD;AACjD,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED;;oCAEoC;AACpC,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5E"}

package/payload/platform/services/claude-session-manager/dist/settings-permission-mode.js

@@ -0,0 +1,57 @@
+// Task 798 — settings-resolved permission mode for /rc-spawn.
+//
+// /rc-spawn composes its claude argv with NO `--permission-mode` flag and a
+// `--settings` JSON carrying only the two skip-prompt keys, so the binary
+// resolves its mode from the settings chain: `permissions.defaultMode` in
+// CLAUDE_CONFIG_DIR/settings.json (the brand seed ships
+// `bypassPermissions`, Task 583), else 'default'. This helper mirrors that
+// resolution so the classification sidecar records the mode the session
+// actually runs under, never a fabricated operator choice. Read fresh per
+// spawn — the operator can edit settings.json between spawns.
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { PERMISSION_MODES } from './pty-spawner.js';
+import { isEffortLevel } from '../../../lib/models/dist/index.js';
+export function resolveSettingsPermissionMode(claudeConfigDir) {
+    try {
+        const raw = readFileSync(join(claudeConfigDir, 'settings.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        const mode = parsed?.permissions?.defaultMode;
+        if (typeof mode === 'string' && PERMISSION_MODES.includes(mode)) {
+            return mode;
+        }
+    }
+    catch {
+        // Missing or unparsable settings.json — the binary resolves to 'default'.
+    }
+    return 'default';
+}
+/** Settings.json `model` — the inception-model lever the binary reads when an
+ *  rc-spawn argv carries no `--model`. Null when absent/unparseable. Read fresh
+ *  per spawn; mirrors resolveSettingsPermissionMode so the argv lifeline reports
+ *  the model the session actually runs under. */
+export function resolveSettingsModel(claudeConfigDir) {
+    try {
+        const raw = readFileSync(join(claudeConfigDir, 'settings.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.model === 'string' && parsed.model.length > 0 ? parsed.model : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Settings.json `effortLevel`. Null when absent/unparseable or not a
+ *  settings-accepted level. Drives the read-only composer effort label and the
+ *  argv lifeline's effort field. */
+export function resolveSettingsEffort(claudeConfigDir) {
+    try {
+        const raw = readFileSync(join(claudeConfigDir, 'settings.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        const v = typeof parsed.effortLevel === 'string' ? parsed.effortLevel : '';
+        return isEffortLevel(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=settings-permission-mode.js.map

package/payload/platform/services/claude-session-manager/dist/settings-permission-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-permission-mode.js","sourceRoot":"","sources":["../src/settings-permission-mode.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,wDAAwD;AACxD,2EAA2E;AAC3E,wEAAwE;AACxE,0EAA0E;AAC1E,8DAA8D;AAE9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAEjE,MAAM,UAAU,6BAA6B,CAAC,eAAuB;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgD,CAAA;QAC7E,MAAM,IAAI,GAAG,MAAM,EAAE,WAAW,EAAE,WAAW,CAAA;QAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvF,OAAO,IAAsB,CAAA;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;IAC5E,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;iDAGiD;AACjD,MAAM,UAAU,oBAAoB,CAAC,eAAuB;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAA;QACrD,OAAO,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;oCAEoC;AACpC,MAAM,UAAU,qBAAqB,CAAC,eAAuB;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8B,CAAA;QAC3D,MAAM,CAAC,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1E,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,45 @@
+/** Why `readAll` skipped a file that matched the suffix.
+ *  `'unreadable'` — the file could not be read or did not parse as JSON.
+ *  `'invalid'`    — it parsed but failed the store's `validate`. */
+export type SidecarSkipReason = 'unreadable' | 'invalid';
+export type WriteResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: unknown;
+};
+export type ClearResult = {
+    ok: true;
+    removed: boolean;
+} | {
+    ok: false;
+    error: unknown;
+};
+export interface SidecarStore<T> {
+    /** `<sessionsDir>/<id><suffix>`. */
+    pathFor(sessionsDir: string, id: string): string;
+    /** Atomic write of `record` as JSON (no indentation): create the dir, write a
+     *  `<path>.tmp.<pid>` sibling, then rename it onto the canonical path. On
+     *  failure the tmp file is removed best-effort and the caught error is
+     *  returned rather than thrown — the caller owns the success/failure log. */
+    write(sessionsDir: string, id: string, record: T): WriteResult;
+    /** Read + parse + validate one record. Null when the file is absent,
+     *  unreadable, not JSON, or fails `validate`. */
+    read(sessionsDir: string, id: string): T | null;
+    /** Every valid record in `sessionsDir`. Files not matching the suffix are
+     *  ignored. A matching file that is unreadable/not-JSON fires
+     *  `onSkip(name, 'unreadable')`; one that parses but fails `validate` fires
+     *  `onSkip(name, 'invalid')`. A missing directory yields `[]`. */
+    readAll(sessionsDir: string, onSkip?: (fileName: string, reason: SidecarSkipReason) => void): T[];
+    /** `existsSync` + `unlink`. `{ ok: true, removed: false }` when the file was
+     *  already absent; `{ ok: false, error }` when the unlink throws. */
+    clear(sessionsDir: string, id: string): ClearResult;
+}
+export declare function createSidecarStore<T>(config: {
+    /** Filename suffix including the dot(s), e.g. `'.scope.json'`. */
+    suffix: string;
+    /** Parse-validate one decoded JSON value into a record, or null if it does
+     *  not match the store's shape. */
+    validate: (raw: unknown) => T | null;
+}): SidecarStore<T>;
+//# sourceMappingURL=sidecar-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-store.d.ts","sourceRoot":"","sources":["../src/sidecar-store.ts"],"names":[],"mappings":"AAgBA;;oEAEoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AACtE,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAExF,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,oCAAoC;IACpC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IAChD;;;iFAG6E;IAC7E,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,WAAW,CAAA;IAC9D;qDACiD;IACjD,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAA;IAC/C;;;sEAGkE;IAClE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,CAAC,EAAE,CAAA;IACjG;yEACqE;IACrE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CAAA;CACpD;AAMD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE;IAC5C,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAA;IACd;uCACmC;IACnC,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAA;CACrC,GAAG,YAAY,CAAC,CAAC,CAAC,CA8FlB"}