parasor 0.1.0

package/server/state/app-state.js

@@ -0,0 +1,335 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DEFAULT_DROP_SIZE_HARD_MAX_BYTES, DEFAULT_DROP_SIZE_MAX_BYTES, normalizeIdeCommands, normalizePaneCommands, normalizeWorktreeLocalFileAllowlist, } from "@parasor/shared";
+const EMPTY_STATE = {
+    version: 1,
+    projects: [],
+    projectStates: {},
+    sessions: [],
+    sessionRecords: [],
+    ideCommands: [],
+    paneCommands: [],
+    serviceConfig: {
+        preventIdleSleep: false,
+        portDetection: "all-interfaces",
+        dropSizeMaxBytes: DEFAULT_DROP_SIZE_MAX_BYTES,
+        dropSizeHardMaxBytes: DEFAULT_DROP_SIZE_HARD_MAX_BYTES,
+    },
+};
+function normalizePortDetection(value) {
+    // Legacy "all" mode (every loopback port, retired in local notify-mode cleanup) folds back to
+    // "all-interfaces" -- closer to the user's original intent than silently
+    // disabling notifications for someone who had explicitly opted in.
+    if (value === "all-interfaces" || value === "off")
+        return value;
+    return "all-interfaces";
+}
+/**
+ * Accept either missing fields or non-positive / non-finite junk. The
+ * hard cap also bounds the soft cap to guard a hand-edited state.json
+ * that set `dropSizeMaxBytes > dropSizeHardMaxBytes`.
+ */
+function normalizeDropCap(value, fallback, ceiling) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.min(value, ceiling);
+}
+/**
+ * Backfill fields added after v1 shipped. Existing state.json files
+ * predate these fields and would otherwise surface `undefined` to
+ * consumers that treat them as required.
+ */
+function migrate(raw) {
+    const serviceConfig = raw.serviceConfig ?? {};
+    const hardMax = normalizeDropCap(serviceConfig.dropSizeHardMaxBytes, DEFAULT_DROP_SIZE_HARD_MAX_BYTES, Number.POSITIVE_INFINITY);
+    const softMax = normalizeDropCap(serviceConfig.dropSizeMaxBytes, DEFAULT_DROP_SIZE_MAX_BYTES, hardMax);
+    return {
+        ...structuredClone(EMPTY_STATE),
+        ...raw,
+        projects: Array.isArray(raw.projects)
+            ? raw.projects.map((project) => {
+                const worktreeLocalFileAllowlist = normalizeWorktreeLocalFileAllowlist(project.worktreeLocalFileAllowlist);
+                return {
+                    ...project,
+                    ...(worktreeLocalFileAllowlist.length > 0 && {
+                        worktreeLocalFileAllowlist,
+                    }),
+                };
+            })
+            : [],
+        sessionRecords: Array.isArray(raw.sessionRecords) ? raw.sessionRecords : [],
+        ideCommands: normalizeIdeCommands(raw.ideCommands),
+        paneCommands: normalizePaneCommands(raw.paneCommands),
+        serviceConfig: {
+            preventIdleSleep: serviceConfig.preventIdleSleep ?? false,
+            portDetection: normalizePortDetection(serviceConfig.portDetection),
+            dropSizeMaxBytes: softMax,
+            dropSizeHardMaxBytes: hardMax,
+        },
+    };
+}
+export class AppStateReadOnlyError extends Error {
+    constructor() {
+        super("AppStateStore session domain is read-only in remote daemon mode (daemon owns sessions/sessionRecords); use internalMutate() for daemon-IPC reconciliation, or mutateProjects()/mutateServiceConfig()/mutatePaneCommands()/mutateIdeCommands() for server-owned domains");
+        this.name = "AppStateReadOnlyError";
+    }
+}
+export class AppStateStore {
+    state;
+    dir;
+    filePath;
+    tmpPath;
+    debounceMs;
+    timer = null;
+    destroyed = false;
+    /**
+     * Daemon-mode mirror guard.
+     * When true, only the **session domain** (`sessions`, `sessionRecords`)
+     * is read-only -- the daemon owns those writes. Project / projectStates
+     * / serviceConfig stay writable in both modes (the daemon never touches
+     * them; their only writer is the server). The daemon-IPC reconciler
+     * applies session-domain broadcasts via `internalMutate()` to bypass
+     * this guard. Default false (in-process mode owns all writes).
+     */
+    sessionsReadOnly = false;
+    /**
+     * daemon state ownership -- when set, write() routes the in-memory state through the
+     * delegate instead of writing state.json directly. The remote-mode
+     * server installs an IPC delegate so the daemon (sole file writer)
+     * persists the server-owned domains. Mirror updates (internalMutate)
+     * skip the delegate because they reflect domain the writer already
+     * persisted.
+     */
+    persistenceDelegate = null;
+    /**
+     * Tracks the most recent debounced-write promise. `flush()` awaits
+     * it BEFORE issuing its own write so a shutdown-time flush surfaces
+     * any in-flight failure (codex MED daemon state ownership/round 2). The promise resolves
+     * whether the underlying write succeeded or rejected -- failures are
+     * routed through `onPersistError` and then silenced here so awaiting
+     * never throws on a shutdown path.
+     */
+    lastWrite = Promise.resolve();
+    onPersistError;
+    constructor(opts = {}) {
+        const dir = opts.dir ?? join(homedir(), ".config", "parasor");
+        this.debounceMs = opts.debounceMs ?? 300;
+        this.filePath = join(dir, "state.json");
+        this.tmpPath = join(dir, "state.json.tmp");
+        this.onPersistError =
+            opts.onPersistError === undefined
+                ? (err) => console.error("AppStateStore: debounced persist failed (state.json may be stale):", err)
+                : (opts.onPersistError ?? (() => undefined));
+        mkdirSync(dir, { recursive: true });
+        this.dir = dir;
+        this.state = this.load();
+    }
+    /**
+     * Directory containing `state.json`. Used by the mode-marker subsystem
+     * so the cross-mode mutex collides on the
+     * same directory the store persists into, regardless of overrides.
+     */
+    getDir() {
+        return this.dir;
+    }
+    load() {
+        try {
+            const raw = readFileSync(this.filePath, "utf-8");
+            return migrate(JSON.parse(raw));
+        }
+        catch (err) {
+            if (isNodeError(err) && err.code === "ENOENT") {
+                return structuredClone(EMPTY_STATE);
+            }
+            // Corrupted -- rename and start fresh
+            const timestamp = Date.now();
+            try {
+                renameSync(this.filePath, `${this.filePath}.corrupted-${timestamp}`);
+            }
+            catch {
+                // ignore rename failure (file may not exist)
+            }
+            return structuredClone(EMPTY_STATE);
+        }
+    }
+    get() {
+        return this.state;
+    }
+    /**
+     * Server-owned domain: project records (`projects` array). Always
+     * writable, even in remote daemon mode -- the daemon never touches
+     * project records, so the server is unconditionally authoritative.
+     *
+     * The callback may also touch `projectStates` since both fields move
+     * together (project create/delete must keep the per-project state map
+     * in lock-step). Use `mutateProjectStates` for pure projectStates
+     * writes (panes, layout, focus) without project-record changes.
+     */
+    mutateProjects(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    /**
+     * Server-owned domain: per-project UI state (`projectStates`). Always
+     * writable. Pane layout, focus, file-tree state, etc. -- none of which
+     * the daemon knows about. `projects` and `sessions` are exposed
+     * read-only so reconciliation logic can compute orphan sets without
+     * being able to write into either domain.
+     */
+    mutateProjectStates(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    /**
+     * Server-owned domain: `serviceConfig`. Always writable. Daemon does
+     * not consume serviceConfig; only the server reads it.
+     */
+    mutateServiceConfig(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    /**
+     * Server-owned domain: terminal launcher commands. Always writable; the
+     * daemon only owns PTY sessions/sessionRecords.
+     */
+    mutatePaneCommands(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    mutateIdeCommands(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    /**
+     * Daemon-owned domain: `sessions` + `sessionRecords`. In remote mode
+     * the server is a mirror -- server-side writes throw to surface the
+     * ownership violation. The daemon-IPC reconciler uses `internalMutate`
+     * to apply broadcasts without tripping this guard. `projects` is
+     * exposed read-only for project-membership filters used during
+     * startup reconciliation.
+     */
+    mutateSessions(fn) {
+        if (this.destroyed)
+            return;
+        if (this.sessionsReadOnly) {
+            throw new AppStateReadOnlyError();
+        }
+        fn(this.state);
+        this.scheduleFlush();
+    }
+    /**
+     * Bypass the session-domain guard. Reserved for the daemon-IPC
+     * reconciler on the server side: SESSION_UPDATE / SESSION_LIST
+     * broadcasts apply here without tripping `mutateSessions`. In
+     * delegate mode the mutation is mirror-only -- the daemon already
+     * persisted these domains before broadcasting, so the server
+     * skips the IPC round-trip. Without a delegate (in-process / daemon
+     * itself), the call schedules a normal file flush so the local
+     * state.json stays coherent for UI reload.
+     */
+    internalMutate(fn) {
+        if (this.destroyed)
+            return;
+        fn(this.state);
+        if (!this.persistenceDelegate) {
+            this.scheduleFlush();
+        }
+    }
+    /**
+     * Toggle the  session-domain guard (narrowed by daemon state ownership). Idempotent.
+     * Called once at factory-time after the PtyHost mode is decided
+     * (in-process -> false, remote -> true) -- runtime flipping is not
+     * supported (by design).
+     */
+    setSessionsReadOnly(readOnly) {
+        this.sessionsReadOnly = readOnly;
+    }
+    isSessionsReadOnly() {
+        return this.sessionsReadOnly;
+    }
+    /**
+     * daemon state ownership -- install/uninstall the IPC persistence delegate. In remote
+     * mode the server installs the delegate after RemotePtyHost.connect
+     * succeeds. Idempotent; pass null to fall back to direct file writes
+     * (e.g. when host factory recreates an in-process host). Setting the
+     * delegate does not flush -- callers do that explicitly if the next
+     * snapshot needs to land on disk before further work.
+     */
+    setPersistenceDelegate(delegate) {
+        this.persistenceDelegate = delegate;
+    }
+    /**
+     * Force a flush *now* and await the underlying persistence (file
+     * write or IPC ACK). Used by shutdown paths that must observe IO
+     * errors before deciding whether to write the daemon-graceful
+     * marker. Synchronous in spirit (cancels the debounce timer); the
+     * Promise reflects the persist step.
+     */
+    async flush() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.destroyed)
+            return;
+        /*
+         * -- first drain any debounce-scheduled
+         * write that already fired, so the shutdown path observes its
+         * outcome (errors are surfaced through onPersistError; the
+         * Promise itself never rejects). Then perform a fresh synchronous-
+         * in-spirit write so the in-memory snapshot reaches disk / the
+         * IPC peer.
+         */
+        await this.lastWrite;
+        await this.write();
+    }
+    /** Cancel pending timer and ignore future mutate calls (for test teardown). */
+    destroy() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.destroyed = true;
+    }
+    scheduleFlush() {
+        if (this.timer !== null) {
+            clearTimeout(this.timer);
+        }
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            // Track the chain so flush() can await the latest in-flight
+            // write. -- route failures through
+            // onPersistError so a debounced delegate.persist() reject (IPC
+            // NACK / disk EIO) does not silently lose project / projectStates
+            // / serviceConfig changes. The catch returns void so awaiting
+            // lastWrite never rejects on shutdown paths.
+            this.lastWrite = this.write().catch((err) => {
+                this.onPersistError(err);
+            });
+        }, this.debounceMs);
+    }
+    async write() {
+        if (this.persistenceDelegate) {
+            await this.persistenceDelegate.persist(this.state);
+            return;
+        }
+        writeFileSync(this.tmpPath, JSON.stringify(this.state), "utf-8");
+        renameSync(this.tmpPath, this.filePath);
+    }
+}
+function isNodeError(err) {
+    return err instanceof Error && "code" in err;
+}
+//# sourceMappingURL=app-state.js.map

package/server/state/app-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.js","sourceRoot":"","sources":["../../src/state/app-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAEL,gCAAgC,EAChC,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,mCAAmC,GAKpC,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,GAAa;IAC5B,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,EAAE;IACjB,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,EAAE;IAClB,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE;QACb,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,2BAA2B;QAC7C,oBAAoB,EAAE,gCAAgC;KACvD;CACF,CAAC;AAEF,SAAS,sBAAsB,CAAC,KAAc;IAC5C,8FAA8F;IAC9F,yEAAyE;IACzE,mEAAmE;IACnE,IAAI,KAAK,KAAK,gBAAgB,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,KAAc,EACd,QAAgB,EAChB,OAAe;IAEf,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,GAAsB;IACrC,MAAM,aAAa,GAA2B,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,gBAAgB,CAC9B,aAAa,CAAC,oBAAoB,EAClC,gCAAgC,EAChC,MAAM,CAAC,iBAAiB,CACzB,CAAC;IACF,MAAM,OAAO,GAAG,gBAAgB,CAC9B,aAAa,CAAC,gBAAgB,EAC9B,2BAA2B,EAC3B,OAAO,CACR,CAAC;IACF,OAAO;QACL,GAAG,eAAe,CAAC,WAAW,CAAC;QAC/B,GAAG,GAAG;QACN,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC3B,MAAM,0BAA0B,GAC9B,mCAAmC,CACjC,OAAO,CAAC,0BAA0B,CACnC,CAAC;gBACJ,OAAO;oBACL,GAAG,OAAO;oBACV,GAAG,CAAC,0BAA0B,CAAC,MAAM,GAAG,CAAC,IAAI;wBAC3C,0BAA0B;qBAC3B,CAAC;iBACH,CAAC;YACJ,CAAC,CAAC;YACJ,CAAC,CAAC,EAAE;QACN,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;QAC3E,WAAW,EAAE,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC;QAClD,YAAY,EAAE,qBAAqB,CAAC,GAAG,CAAC,YAAY,CAAC;QACrD,aAAa,EAAE;YACb,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,IAAI,KAAK;YACzD,aAAa,EAAE,sBAAsB,CAAC,aAAa,CAAC,aAAa,CAAC;YAClE,gBAAgB,EAAE,OAAO;YACzB,oBAAoB,EAAE,OAAO;SAC9B;KACF,CAAC;AACJ,CAAC;AA+DD,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,CACH,wQAAwQ,CACzQ,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IAChB,KAAK,CAAW;IACP,GAAG,CAAS;IACZ,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,UAAU,CAAS;IAC5B,KAAK,GAAyC,IAAI,CAAC;IACnD,SAAS,GAAG,KAAK,CAAC;IAC1B;;;;;;;;OAQG;IACK,gBAAgB,GAAG,KAAK,CAAC;IACjC;;;;;;;OAOG;IACK,mBAAmB,GAAuC,IAAI,CAAC;IACvE;;;;;;;OAOG;IACK,SAAS,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACpC,cAAc,CAAyB;IAExD,YAAY,OAA0B,EAAE;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc;YACjB,IAAI,CAAC,cAAc,KAAK,SAAS;gBAC/B,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CACN,OAAO,CAAC,KAAK,CACX,oEAAoE,EACpE,GAAG,CACJ;gBACL,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9C,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;YACtC,CAAC;YACD,sCAAsC;YACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,cAAc,SAAS,EAAE,CAAC,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;YACD,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAuC;QACpD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB,CAAC,EAA4C;QAC9D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,EAA4C;QAC9D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,EAA2C;QAC5D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,iBAAiB,CAAC,EAA0C;QAC1D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,EAAuC;QACpD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,IAAI,qBAAqB,EAAE,CAAC;QACpC,CAAC;QACD,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,EAA6B;QAC1C,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,QAAiB;QACnC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,sBAAsB,CAAC,QAA4C;QACjE,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B;;;;;;;WAOG;QACH,MAAM,IAAI,CAAC,SAAS,CAAC;QACrB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,+EAA+E;IAC/E,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,4DAA4D;YAC5D,mCAAmC;YACnC,+DAA+D;YAC/D,kEAAkE;YAClE,8DAA8D;YAC9D,6CAA6C;YAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC1C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,KAAK;QACjB,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC;AAC/C,CAAC"}

package/server/state/project-manager.d.ts

@@ -0,0 +1,30 @@
+import { type Project, type Session } from "@parasor/shared";
+import type { AppStateStore } from "./app-state.js";
+export interface CreateProjectOpts {
+    path: string;
+    name?: string;
+}
+export interface UpdateProjectOpts {
+    name?: string;
+    pinned?: boolean;
+    readOnly?: boolean;
+    worktreeLocalFileAllowlist?: string[];
+}
+export declare class ProjectManager {
+    private readonly store;
+    constructor(store: AppStateStore);
+    create(opts: CreateProjectOpts): Project;
+    list(): Project[];
+    get(id: string): Project | undefined;
+    update(id: string, opts: UpdateProjectOpts): Project | undefined;
+    delete(id: string, force?: boolean): boolean;
+    getProjectSessions(projectId: string): Session[];
+    touchProject(id: string): void;
+    /**
+     * Apply a manual sort order via DnD reorder. `ids` must contain every
+     * existing project id exactly once. Assigns `order` = index for each.
+     * Returns the new project list, or `undefined` when the id set mismatches.
+     */
+    reorder(ids: string[]): Project[] | undefined;
+}
+//# sourceMappingURL=project-manager.d.ts.map

package/server/state/project-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-manager.d.ts","sourceRoot":"","sources":["../../src/state/project-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,aAAa;IAEjD,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO;IA8BxC,IAAI,IAAI,OAAO,EAAE;IAIjB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,GAAG,SAAS;IAsBhE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO;IAuB1C,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAIhD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAU9B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS;CAkB9C"}

package/server/state/project-manager.js

@@ -0,0 +1,128 @@
+import { randomUUID } from "node:crypto";
+import { basename } from "node:path";
+import { normalizeWorktreeLocalFileAllowlist, } from "@parasor/shared";
+import { expandUserHome } from "../lib/path.js";
+export class ProjectManager {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    create(opts) {
+        const path = expandUserHome(opts.path);
+        const existing = this.store.get().projects.find((p) => p.path === path);
+        if (existing)
+            return existing;
+        const now = Date.now();
+        const project = {
+            id: randomUUID(),
+            name: opts.name ?? basename(path),
+            path,
+            createdAt: now,
+            lastAccessedAt: now,
+        };
+        this.store.mutateProjects((s) => {
+            s.projects.push(project);
+            s.projectStates[project.id] = {
+                projectId: project.id,
+                layout: null,
+                worktrees: [],
+                openFiles: [],
+                lastFocusedPaneId: null,
+                focusedPaneId: null,
+                lastAccessedAt: now,
+            };
+        });
+        return project;
+    }
+    list() {
+        return [...this.store.get().projects];
+    }
+    get(id) {
+        return this.store.get().projects.find((p) => p.id === id);
+    }
+    update(id, opts) {
+        let result;
+        this.store.mutateProjects((s) => {
+            const idx = s.projects.findIndex((p) => p.id === id);
+            if (idx === -1)
+                return;
+            const project = s.projects[idx];
+            if (opts.name !== undefined)
+                project.name = opts.name;
+            if (opts.pinned !== undefined)
+                project.pinned = opts.pinned;
+            if (opts.readOnly !== undefined)
+                project.readOnly = opts.readOnly;
+            if (opts.worktreeLocalFileAllowlist !== undefined) {
+                project.worktreeLocalFileAllowlist =
+                    normalizeWorktreeLocalFileAllowlist(opts.worktreeLocalFileAllowlist);
+            }
+            result = project;
+        });
+        return result;
+    }
+    delete(id, force = false) {
+        const project = this.get(id);
+        if (!project)
+            return false;
+        if (project.pinned && !force)
+            return false;
+        this.store.mutateProjects((s) => {
+            s.projects = s.projects.filter((p) => p.id !== id);
+            delete s.projectStates[id];
+        });
+        /*
+         * daemon state ownership -- orphan-session cleanup is cross-domain (sessions are
+         * daemon-owned in remote mode). Use internalMutate so the call
+         * succeeds in both modes: in-process flushes the filtered list,
+         * remote applies mirror-only (daemon's own SESSION_LIST broadcast
+         * is the source of truth there).
+         */
+        this.store.internalMutate((s) => {
+            s.sessions = s.sessions.filter((sess) => sess.projectId !== id);
+        });
+        return true;
+    }
+    getProjectSessions(projectId) {
+        return this.store.get().sessions.filter((s) => s.projectId === projectId);
+    }
+    touchProject(id) {
+        const now = Date.now();
+        this.store.mutateProjects((s) => {
+            const project = s.projects.find((p) => p.id === id);
+            if (project)
+                project.lastAccessedAt = now;
+            const ps = s.projectStates[id];
+            if (ps)
+                ps.lastAccessedAt = now;
+        });
+    }
+    /**
+     * Apply a manual sort order via DnD reorder. `ids` must contain every
+     * existing project id exactly once. Assigns `order` = index for each.
+     * Returns the new project list, or `undefined` when the id set mismatches.
+     */
+    reorder(ids) {
+        const current = this.store.get().projects;
+        if (ids.length !== current.length)
+            return undefined;
+        const idSet = new Set(ids);
+        if (idSet.size !== ids.length)
+            return undefined;
+        for (const p of current)
+            if (!idSet.has(p.id))
+                return undefined;
+        let result = [];
+        this.store.mutateProjects((s) => {
+            const byId = new Map(s.projects.map((p) => [p.id, p]));
+            ids.forEach((id, idx) => {
+                const project = byId.get(id);
+                if (project)
+                    project.order = idx;
+            });
+            result = [...s.projects];
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=project-manager.js.map

package/server/state/project-manager.js.map

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

package/server/state/server-notices.d.ts

@@ -0,0 +1,12 @@
+import type { ServerNotice, ServerNoticeKind } from "@parasor/shared";
+export declare class ServerNoticesStore {
+    private byKind;
+    recordDaemonAutoRestarted(detail: {
+        serverProtocolVersion?: string;
+        daemonProtocolVersion?: string;
+    }): void;
+    list(): ServerNotice[];
+    has(kind: ServerNoticeKind): boolean;
+    dismiss(kind: ServerNoticeKind): boolean;
+}
+//# sourceMappingURL=server-notices.d.ts.map

package/server/state/server-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-notices.d.ts","sourceRoot":"","sources":["../../src/state/server-notices.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA6C;IAE3D,yBAAyB,CAAC,MAAM,EAAE;QAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,GAAG,IAAI;IASR,IAAI,IAAI,YAAY,EAAE;IAItB,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAIpC,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;CAGzC"}

package/server/state/server-notices.js

@@ -0,0 +1,32 @@
+/*
+ * daemon protocol mismatch recovery -- in-memory store for server-lifetime notices surfaced to the web
+ * UI. Currently records `daemon-auto-restarted` events from the
+ * createPtyHost recovery path so the web banner can explain why the
+ * session list is empty after a daemon-protocol upgrade.
+ *
+ * Lifecycle: instance lives on the running server only; notices are not
+ * persisted across server restarts. Web dismisses per-kind via
+ * `DELETE /api/notices/:kind`. Re-occurrence (a second auto-restart in
+ * the same lifetime) overwrites -- at most one entry per kind.
+ */
+export class ServerNoticesStore {
+    byKind = new Map();
+    recordDaemonAutoRestarted(detail) {
+        this.byKind.set("daemon-auto-restarted", {
+            kind: "daemon-auto-restarted",
+            occurredAt: new Date().toISOString(),
+            serverProtocolVersion: detail.serverProtocolVersion,
+            daemonProtocolVersion: detail.daemonProtocolVersion,
+        });
+    }
+    list() {
+        return [...this.byKind.values()];
+    }
+    has(kind) {
+        return this.byKind.has(kind);
+    }
+    dismiss(kind) {
+        return this.byKind.delete(kind);
+    }
+}
+//# sourceMappingURL=server-notices.js.map

package/server/state/server-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-notices.js","sourceRoot":"","sources":["../../src/state/server-notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE3D,yBAAyB,CAAC,MAGzB;QACC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,uBAAuB,EAAE;YACvC,IAAI,EAAE,uBAAuB;YAC7B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;YACnD,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;SACpD,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,IAAsB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,IAAsB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/server/state/worktree-cache.d.ts

@@ -0,0 +1,25 @@
+import type { Worktree } from "@parasor/shared";
+/**
+ * In-memory cache of per-project worktrees, kept in sync by the
+ * runtime broadcast wrapper. Used to keep `EventBus.addClient` fully
+ * synchronous so the snapshot/seq capture stays atomic with the
+ * broadcast stream.
+ */
+export declare class WorktreeCache {
+    private cache;
+    get(): Record<string, Worktree[]>;
+    setAll(initial: Record<string, Worktree[]>): void;
+    setProject(projectId: string, worktrees: Worktree[]): void;
+    removeProject(projectId: string): void;
+    /**
+     * Idempotent upsert by `path`. A snapshot+broadcast race (cache primed
+     * AFTER worktree-created fires) must not double-count, but a re-broadcast
+     * carrying refreshed counters (ahead/behind/dirtyCount) MUST update the
+     * cached entry -- otherwise a worktree-created emitted before counter
+     * enrichment finishes leaves the entry stuck at 0 forever (no other
+     * code path updates this cache).
+     */
+    appendWorktree(projectId: string, worktree: Worktree): void;
+    removeWorktree(projectId: string, worktreePath: string): void;
+}
+//# sourceMappingURL=worktree-cache.d.ts.map

package/server/state/worktree-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-cache.d.ts","sourceRoot":"","sources":["../../src/state/worktree-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAkC;IAE/C,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAIjC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAIjD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAI1D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAMtC;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAY3D,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;CAO9D"}

package/server/state/worktree-cache.js

@@ -0,0 +1,53 @@
+/**
+ * In-memory cache of per-project worktrees, kept in sync by the
+ * runtime broadcast wrapper. Used to keep `EventBus.addClient` fully
+ * synchronous so the snapshot/seq capture stays atomic with the
+ * broadcast stream.
+ */
+export class WorktreeCache {
+    cache = {};
+    get() {
+        return this.cache;
+    }
+    setAll(initial) {
+        this.cache = { ...initial };
+    }
+    setProject(projectId, worktrees) {
+        this.cache = { ...this.cache, [projectId]: worktrees };
+    }
+    removeProject(projectId) {
+        if (!(projectId in this.cache))
+            return;
+        const { [projectId]: _drop, ...rest } = this.cache;
+        this.cache = rest;
+    }
+    /**
+     * Idempotent upsert by `path`. A snapshot+broadcast race (cache primed
+     * AFTER worktree-created fires) must not double-count, but a re-broadcast
+     * carrying refreshed counters (ahead/behind/dirtyCount) MUST update the
+     * cached entry -- otherwise a worktree-created emitted before counter
+     * enrichment finishes leaves the entry stuck at 0 forever (no other
+     * code path updates this cache).
+     */
+    appendWorktree(projectId, worktree) {
+        const list = this.cache[projectId] ?? [];
+        const idx = list.findIndex((w) => w.path === worktree.path);
+        if (idx === -1) {
+            this.cache = { ...this.cache, [projectId]: [...list, worktree] };
+            return;
+        }
+        const next = [...list];
+        next[idx] = { ...list[idx], ...worktree };
+        this.cache = { ...this.cache, [projectId]: next };
+    }
+    removeWorktree(projectId, worktreePath) {
+        const list = this.cache[projectId];
+        if (!list)
+            return;
+        const next = list.filter((w) => w.path !== worktreePath);
+        if (next.length === list.length)
+            return;
+        this.cache = { ...this.cache, [projectId]: next };
+    }
+}
+//# sourceMappingURL=worktree-cache.js.map

package/server/state/worktree-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-cache.js","sourceRoot":"","sources":["../../src/state/worktree-cache.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,KAAK,GAA+B,EAAE,CAAC;IAE/C,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,OAAmC;QACxC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,SAAqB;QACjD,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACzD,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QACvC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,SAAiB,EAAE,QAAkB;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,cAAc,CAAC,SAAiB,EAAE,YAAoB;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO;QACxC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;CACF"}