@maudecode/talaria-web 0.0.0

package/dist/sessions/drafts.js

@@ -0,0 +1,117 @@
+/**
+ * Composer draft sidecars (Python `api/session_drafts.py`): tiny atomic files
+ * under `sessions/_drafts/<sid>.json` with a monotonic decimal revision.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteText } from '../fs/atomic.js';
+import { isSafeSessionId } from './session.js';
+const DRAFT_VERSION_KEY = '_draft_version';
+export class DraftVersionConflict extends Error {
+    currentDraft;
+    currentVersion;
+    constructor(currentDraft, currentVersion) {
+        super('Composer draft changed in another request');
+        this.currentDraft = currentDraft;
+        this.currentVersion = currentVersion;
+        this.name = 'DraftVersionConflict';
+    }
+}
+export function normalizeDraft(value) {
+    const draft = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+    return { text: typeof draft.text === 'string' ? draft.text : '', files: Array.isArray(draft.files) ? draft.files : [] };
+}
+/** Canonical decimal revision (ms wall time x 1000); throws on anything else. */
+export function normalizeDraftVersion(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'boolean')
+        throw new Error('Invalid draft_version');
+    const raw = typeof value === 'number' ? String(value) : value;
+    if (typeof raw !== 'string' || !/^[0-9]+$/.test(raw) || raw.length < 1 || raw.length > 20)
+        throw new Error('Invalid draft_version');
+    const text = raw.replace(/^0+(?=\d)/, '');
+    if (text === '0')
+        throw new Error('Invalid draft_version');
+    return text;
+}
+const cmp = (a, b) => (a.length !== b.length ? a.length - b.length : a < b ? -1 : a > b ? 1 : 0);
+const sameDraft = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+export class DraftStore {
+    sessionDir;
+    constructor(sessionDir) {
+        this.sessionDir = sessionDir;
+    }
+    dir() {
+        return join(this.sessionDir, '_drafts');
+    }
+    path(sid) {
+        if (!isSafeSessionId(sid))
+            throw new Error('Invalid session_id');
+        return join(this.dir(), `${sid}.json`);
+    }
+    exists(sid) {
+        return existsSync(this.path(sid));
+    }
+    readRecord(path, fallback) {
+        if (!existsSync(path))
+            return [normalizeDraft(fallback), null];
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        let version = null;
+        if (value && typeof value === 'object' && !Array.isArray(value) && value[DRAFT_VERSION_KEY] != null) {
+            version = normalizeDraftVersion(value[DRAFT_VERSION_KEY]);
+        }
+        return [normalizeDraft(value), version];
+    }
+    readState(sid, fallback) {
+        try {
+            return this.readRecord(this.path(sid), fallback);
+        }
+        catch {
+            return [normalizeDraft(fallback), null];
+        }
+    }
+    read(sid, fallback) {
+        return this.readState(sid, fallback)[0];
+    }
+    /** Persist a versioned draft; equal-version retries with identical payloads are accepted. */
+    write(sid, draft, version) {
+        const normalized = normalizeDraft(draft);
+        const normalizedVersion = normalizeDraftVersion(version);
+        const path = this.path(sid);
+        mkdirSync(this.dir(), { recursive: true });
+        let current;
+        try {
+            current = this.readRecord(path);
+        }
+        catch {
+            current = [normalizeDraft(null), null];
+        }
+        const [currentDraft, currentVersion] = current;
+        if (currentVersion !== null) {
+            if (normalizedVersion === null || cmp(normalizedVersion, currentVersion) < 0)
+                throw new DraftVersionConflict(currentDraft, currentVersion);
+            if (cmp(normalizedVersion, currentVersion) === 0) {
+                if (!sameDraft(normalized, currentDraft))
+                    throw new DraftVersionConflict(currentDraft, currentVersion);
+                return currentDraft;
+            }
+        }
+        const record = { ...normalized };
+        if (normalizedVersion !== null)
+            record[DRAFT_VERSION_KEY] = normalizedVersion;
+        atomicWriteText(path, JSON.stringify(record));
+        return normalized;
+    }
+    delete(sid) {
+        let path;
+        try {
+            path = this.path(sid);
+        }
+        catch {
+            return;
+        }
+        rmSync(path, { force: true });
+    }
+}
+//# sourceMappingURL=drafts.js.map

package/dist/sessions/drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.js","sourceRoot":"","sources":["../../src/sessions/drafts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,MAAM,iBAAiB,GAAG,gBAAgB,CAAA;AAE1C,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACxB;IAA8B;IAAnD,YAAqB,YAAmB,EAAW,cAA6B;QAC9E,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAD/B,iBAAY,GAAZ,YAAY,CAAO;QAAW,mBAAc,GAAd,cAAc,CAAe;QAE9E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,KAAK,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAA;IACnH,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AACzH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACxE,MAAM,GAAG,GAAY,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACtE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IACnI,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACzC,IAAI,IAAI,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC1D,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACxH,MAAM,SAAS,GAAG,CAAC,CAAQ,EAAE,CAAQ,EAAW,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAE1F,MAAM,OAAO,UAAU;IACA;IAArB,YAAqB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IAAG,CAAC;IAE3C,GAAG;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAChE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACnC,CAAC;IAEO,UAAU,CAAC,IAAY,EAAE,QAAkB;QACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAA;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAA;QAC/D,IAAI,OAAO,GAAkB,IAAI,CAAA;QACjC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,KAAiC,CAAC,iBAAiB,CAAC,IAAI,IAAI,EAAE,CAAC;YACjI,OAAO,GAAG,qBAAqB,CAAE,KAAiC,CAAC,iBAAiB,CAAC,CAAC,CAAA;QACxF,CAAC;QACD,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,QAAkB;QACvC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAA;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,QAAkB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,6FAA6F;IAC7F,KAAK,CAAC,GAAW,EAAE,KAAc,EAAE,OAAiB;QAClD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;QACxC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAA;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC3B,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,IAAI,OAA+B,CAAA;QACnC,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;QACxC,CAAC;QACD,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,GAAG,OAAO,CAAA;QAC9C,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,iBAAiB,KAAK,IAAI,IAAI,GAAG,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,oBAAoB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;YAC1I,IAAI,GAAG,CAAC,iBAAiB,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC;oBAAE,MAAM,IAAI,oBAAoB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;gBACtG,OAAO,YAAY,CAAA;YACrB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,GAAG,UAAU,EAAE,CAAA;QACzD,IAAI,iBAAiB,KAAK,IAAI;YAAE,MAAM,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAA;QAC7E,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7C,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/B,CAAC;CACF"}

package/dist/sessions/events.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Session-list change bus (Python `api/session_events.py`): a version counter,
+ * a coalescing one-slot queue per subscriber, and synchronous listeners.
+ */
+export interface SessionsChangedEvent {
+    type: 'sessions_changed';
+    version: number;
+    reason: string;
+    profile?: string;
+    session_id?: string;
+}
+export type SessionEventsListener = (profile: string | null) => void;
+export declare class SessionEventBus {
+    private version;
+    private readonly subscribers;
+    private readonly listeners;
+    readonly isRootAlias: (profile: string) => boolean;
+    constructor(isRootAlias?: (profile: string) => boolean);
+    private payload;
+    /** Merge a pending event with an incoming one without dropping profile-relevant work. */
+    static coalesce(pending: SessionsChangedEvent | null, incoming: SessionsChangedEvent): SessionsChangedEvent;
+    publish(reason?: string, opts?: {
+        profile?: string | null;
+        sessionId?: string | null;
+    }): void;
+    addListener(listener: SessionEventsListener): () => void;
+    /** Subscribe with a one-slot queue; `next()` resolves with the coalesced pending event. */
+    subscribe(): {
+        next: (signal?: AbortSignal) => Promise<SessionsChangedEvent | null>;
+        close: () => void;
+    };
+}

package/dist/sessions/events.js

@@ -0,0 +1,80 @@
+export class SessionEventBus {
+    version = 0;
+    subscribers = new Set();
+    listeners = new Set();
+    isRootAlias;
+    constructor(isRootAlias = (p) => p === 'default') {
+        this.isRootAlias = isRootAlias;
+    }
+    payload(reason, profile, sessionId) {
+        this.version += 1;
+        const payload = { type: 'sessions_changed', version: this.version, reason };
+        const normalizedProfile = (profile ?? '').trim();
+        if (normalizedProfile && !this.isRootAlias(normalizedProfile))
+            payload.profile = normalizedProfile;
+        const normalizedSid = (sessionId ?? '').trim();
+        if (normalizedSid)
+            payload.session_id = normalizedSid;
+        return payload;
+    }
+    /** Merge a pending event with an incoming one without dropping profile-relevant work. */
+    static coalesce(pending, incoming) {
+        if (!pending)
+            return incoming;
+        if ((pending.profile ?? null) === (incoming.profile ?? null)) {
+            if ((pending.session_id ?? null) === (incoming.session_id ?? null))
+                return incoming;
+            const merged = { ...incoming };
+            Reflect.deleteProperty(merged, 'session_id');
+            return merged;
+        }
+        const merged = { ...incoming };
+        Reflect.deleteProperty(merged, 'profile');
+        Reflect.deleteProperty(merged, 'session_id');
+        return merged;
+    }
+    publish(reason = 'session_changed', opts = {}) {
+        const payload = this.payload(reason, opts.profile ?? null, opts.sessionId ?? null);
+        for (const sub of this.subscribers) {
+            sub.pending = SessionEventBus.coalesce(sub.pending, payload);
+            const wake = sub.wake;
+            sub.wake = null;
+            wake?.();
+        }
+        for (const listener of this.listeners) {
+            try {
+                listener(opts.profile ?? null);
+            }
+            catch { /* listener failures never break publishers */ }
+        }
+    }
+    addListener(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    /** Subscribe with a one-slot queue; `next()` resolves with the coalesced pending event. */
+    subscribe() {
+        const sub = { pending: null, wake: null };
+        this.subscribers.add(sub);
+        return {
+            next: (signal) => new Promise((resolve) => {
+                const take = () => { const p = sub.pending; sub.pending = null; resolve(p); };
+                if (sub.pending) {
+                    take();
+                    return;
+                }
+                if (signal?.aborted) {
+                    resolve(null);
+                    return;
+                }
+                sub.wake = take;
+                signal?.addEventListener('abort', () => { if (sub.wake === take) {
+                    sub.wake = null;
+                    resolve(null);
+                } }, { once: true });
+            }),
+            close: () => { this.subscribers.delete(sub); },
+        };
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/sessions/events.js.map

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

package/dist/sessions/export.d.ts

@@ -0,0 +1,4 @@
+export declare function paletteToCss(palette: unknown): string;
+export declare function renderSessionHtml(session: Record<string, unknown>, theme?: string, palette?: unknown): string;
+/** Python `json.dumps(obj, ensure_ascii=False, indent=2)`. */
+export declare function pythonPrettyJson(value: unknown): string;

package/dist/sessions/export.js

@@ -0,0 +1,186 @@
+/** Session export: JSON (Python `json.dumps(indent=2)`) and a self-contained HTML transcript (`api/session_export_html.py`). */
+import { escapeHtml, renderMarkdown } from '../text/markdown.js';
+import { str } from '../util.js';
+const ROLE_LABELS = { user: ['You', 'role-user'], assistant: ['Assistant', 'role-assistant'], system: ['System', 'role-system'], tool: ['Tool', 'role-tool'] };
+const CSS = `
+:root{--bg:#FEFCF7;--panel:#F3EEE3;--panel2:#FAF7F0;--border:#E0D8C8;
+--text:#1A1610;--muted:#5C5344;--accent:#B8860B;--user:#0288A8;--assistant:#3D8B40;
+--code-bg:#F5F0E5;--code-border:#E0D8C8;--code-text:#8b4513;
+--badge-user-bg:rgba(2,136,168,.12);--badge-user-text:#0288A8;
+--badge-assistant-bg:rgba(61,139,64,.12);--badge-assistant-text:#3D8B40;
+--badge-system-bg:rgba(92,83,68,.14);--badge-system-text:#5C5344;
+--badge-tool-bg:rgba(184,134,11,.14);--badge-tool-text:#8B6508;
+--row-stripe:rgba(0,0,0,.02);--subtle:rgba(0,0,0,.02);}
+:root.dark{--bg:#0D0D1A;--panel:#1A1A2E;--panel2:#141425;--border:#2A2A45;
+--text:#FFF8DC;--muted:#C0C0C0;--accent:#FFD700;--user:#4DD0E1;--assistant:#4CAF50;
+--code-bg:#1A1A2E;--code-border:#2A2A45;--code-text:#f0c27f;
+--badge-user-bg:rgba(77,208,225,.16);--badge-user-text:#4DD0E1;
+--badge-assistant-bg:rgba(76,175,80,.16);--badge-assistant-text:#56d364;
+--badge-system-bg:rgba(192,192,192,.16);--badge-system-text:#C0C0C0;
+--badge-tool-bg:rgba(255,191,0,.16);--badge-tool-text:#FFBF00;
+--row-stripe:rgba(255,255,255,.025);--subtle:rgba(255,255,255,.02);}
+*{box-sizing:border-box}
+html{-webkit-text-size-adjust:100%}
+body{margin:0;background:var(--bg);color:var(--text);
+font:15px/1.65 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",Roboto,Helvetica,Arial,sans-serif;}
+.wrap{max-width:860px;margin:0 auto;padding:32px 20px 80px;}
+header.doc-head{border-bottom:1px solid var(--border);padding-bottom:20px;margin-bottom:28px;}
+header.doc-head h1{margin:0 0 10px;font-size:24px;font-weight:650;}
+.meta{color:var(--muted);font-size:13px;line-height:1.9;}
+.meta b{color:var(--text);font-weight:600;}
+.msg{margin:0 0 22px;border:1px solid var(--border);border-radius:12px;overflow:hidden;background:var(--panel);}
+.msg-head{display:flex;align-items:center;gap:10px;padding:10px 16px;background:var(--panel2);
+border-bottom:1px solid var(--border);font-size:13px;}
+.badge{font-weight:650;padding:2px 10px;border-radius:999px;font-size:12px;letter-spacing:.2px;}
+.role-user .badge{background:var(--badge-user-bg);color:var(--badge-user-text);}
+.role-assistant .badge{background:var(--badge-assistant-bg);color:var(--badge-assistant-text);}
+.role-system .badge{background:var(--badge-system-bg);color:var(--badge-system-text);}
+.role-tool .badge{background:var(--badge-tool-bg);color:var(--badge-tool-text);}
+.ts{color:var(--muted);margin-left:auto;font-size:12px;}
+.msg-body{padding:4px 18px 8px;}
+.msg-body>:first-child{margin-top:8px}.msg-body>:last-child{margin-bottom:8px}
+.msg-body p{margin:10px 0;}
+.msg-body h1,.msg-body h2,.msg-body h3,.msg-body h4{margin:18px 0 10px;line-height:1.3;font-weight:640;}
+.msg-body h1{font-size:21px}.msg-body h2{font-size:18px}.msg-body h3{font-size:16px}
+.msg-body a{color:var(--accent);text-decoration:none}.msg-body a:hover{text-decoration:underline}
+.msg-body ul,.msg-body ol{padding-left:24px;margin:10px 0;}
+.msg-body li{margin:4px 0;}
+.msg-body code{background:var(--code-bg);border:1px solid var(--code-border);border-radius:5px;color:var(--code-text);
+padding:.15em .4em;font-size:.88em;font-family:"SFMono-Regular",Consolas,"Liberation Mono",Menlo,monospace;}
+.msg-body pre{background:var(--code-bg);border:1px solid var(--code-border);border-radius:10px;
+padding:14px 16px;overflow:auto;margin:12px 0;}
+.msg-body pre code{background:none;border:0;padding:0;color:var(--text);font-size:13px;line-height:1.55;}
+.msg-body blockquote{border-left:3px solid var(--border);margin:12px 0;padding:2px 16px;color:var(--muted);}
+.msg-body table{border-collapse:collapse;margin:14px 0;width:100%;font-size:14px;display:block;overflow-x:auto;}
+.msg-body th,.msg-body td{border:1px solid var(--border);padding:8px 12px;text-align:left;}
+.msg-body th{background:var(--panel2);font-weight:640;}
+.msg-body tr:nth-child(even) td{background:var(--row-stripe);}
+.msg-body img{max-width:100%;border-radius:8px;}
+.msg-body hr{border:0;border-top:1px solid var(--border);margin:18px 0;}
+details.reasoning{margin:6px 0 4px;border:1px dashed var(--border);border-radius:8px;background:var(--subtle);}
+details.reasoning summary{cursor:pointer;padding:8px 14px;color:var(--muted);font-size:13px;user-select:none;}
+details.reasoning[open] summary{border-bottom:1px solid var(--border);}
+details.reasoning .reasoning-body{padding:4px 16px 10px;color:var(--muted);font-size:13.5px;}
+footer.doc-foot{margin-top:36px;padding-top:18px;border-top:1px solid var(--border);
+color:var(--muted);font-size:12px;text-align:center;}
+`;
+function neutralizeRemoteImages(rendered) {
+    if (!rendered.includes('<img'))
+        return rendered;
+    return rendered.replace(/<img\b[^>]*>/gi, (tag) => {
+        const src = (/src\s*=\s*"([^"]*)"/.exec(tag) ?? /src\s*=\s*'([^']*)'/.exec(tag))?.[1] ?? '';
+        if (src.startsWith('data:'))
+            return tag;
+        return `<code>[image: ${src ? escapeHtml(src) : 'image'}]</code>`;
+    });
+}
+function contentToText(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        const parts = [];
+        for (const c of content) {
+            if (c && typeof c === 'object' && !Array.isArray(c)) {
+                const part = c;
+                if (part.type === 'text' || 'text' in part)
+                    parts.push(str(part.text));
+                else if (part.type === 'image_url' || part.type === 'image') {
+                    let url = '';
+                    if (part.image_url && typeof part.image_url === 'object')
+                        url = str(part.image_url.url);
+                    url = url || str(part.url);
+                    if (url)
+                        parts.push(url.startsWith('data:') ? `![image](${url})` : `\`[image: ${url}]\``);
+                }
+                else
+                    parts.push(`\`[${str(part.type) || 'content'}]\``);
+            }
+            else
+                parts.push(str(c));
+        }
+        return parts.filter(Boolean).join('\n\n');
+    }
+    return str(content);
+}
+function fmtTs(t) {
+    const n = Number(t);
+    if (!Number.isFinite(n) || t === null || t === undefined || t === '')
+        return '';
+    const d = new Date(n * 1000);
+    if (Number.isNaN(d.getTime()))
+        return '';
+    const p = (v) => String(v).padStart(2, '0');
+    return `${String(d.getFullYear())}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+export function paletteToCss(palette) {
+    if (!palette || typeof palette !== 'object' || Array.isArray(palette))
+        return '';
+    const decls = [];
+    for (const [rawName, rawVal] of Object.entries(palette)) {
+        const name = rawName.trim().replace(/^-+/, '');
+        if (!name || !/^[A-Za-z0-9-]+$/.test(name))
+            continue;
+        const val = str(rawVal).trim();
+        if (!val || !/^[#A-Za-z0-9.,%()\-\s]+$/.test(val) || val.length > 120 || /expression\s*\(/i.test(val))
+            continue;
+        decls.push(`--${name}:${val};`);
+    }
+    return decls.length ? `:root,:root.dark{${decls.join('')}}` : '';
+}
+export function renderSessionHtml(session, theme = 'dark', palette = null) {
+    const htmlClass = theme.toLowerCase() !== 'light' ? ' class="dark"' : '';
+    const paletteCss = paletteToCss(palette);
+    const title = (str(session.title) || 'Hermes Conversation').trim();
+    const sid = str(session.session_id);
+    const model = str(session.model);
+    const provider = str(session.model_provider);
+    const created = fmtTs(session.created_at);
+    const updated = fmtTs(session.updated_at);
+    const messages = Array.isArray(session.messages) ? session.messages : [];
+    const visible = messages.filter((m) => Boolean(m) && typeof m === 'object' && !Array.isArray(m) && m.role !== 'system');
+    const blocks = visible.map((m) => {
+        const role = str(m.role);
+        const [label, cls] = ROLE_LABELS[role] ?? [role || '?', 'role-system'];
+        const ts = fmtTs(m.timestamp);
+        const tsHtml = ts ? `<span class="ts">${escapeHtml(ts)}</span>` : '';
+        const bodyHtml = neutralizeRemoteImages(renderMarkdown(contentToText(m.content)));
+        const reasoning = m.reasoning;
+        const reasoningHtml = typeof reasoning === 'string' && reasoning.trim() ? `<details class="reasoning"><summary>💭 Reasoning</summary><div class="reasoning-body">${neutralizeRemoteImages(renderMarkdown(reasoning))}</div></details>` : '';
+        return `<section class="msg ${cls}"><div class="msg-head"><span class="badge">${escapeHtml(label)}</span>${tsHtml}</div><div class="msg-body">${reasoningHtml}${bodyHtml}</div></section>`;
+    });
+    const meta = [];
+    if (sid)
+        meta.push(`<div>Session: <b>${escapeHtml(sid)}</b></div>`);
+    if (model)
+        meta.push(`<div>Model: <b>${escapeHtml(model)}</b>${provider ? ` · ${escapeHtml(provider)}` : ''}</div>`);
+    if (created || updated)
+        meta.push(`<div>Created: <b>${escapeHtml(created)}</b> · Updated: <b>${escapeHtml(updated)}</b></div>`);
+    meta.push(`<div>Messages: <b>${String(visible.length)}</b></div>`);
+    const exported = fmtTs(Date.now() / 1000);
+    return `<!DOCTYPE html>
+<html lang="en"${htmlClass}>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>${CSS}${paletteCss}</style>
+</head>
+<body>
+<div class="wrap">
+<header class="doc-head">
+<h1>${escapeHtml(title)}</h1>
+<div class="meta">${meta.join('')}</div>
+</header>
+<main>
+${blocks.join('')}
+</main>
+<footer class="doc-foot">Exported from Hermes WebUI on ${exported}</footer>
+</div>
+</body>
+</html>`;
+}
+/** Python `json.dumps(obj, ensure_ascii=False, indent=2)`. */
+export function pythonPrettyJson(value) {
+    return JSON.stringify(value, null, 2);
+}
+//# sourceMappingURL=export.js.map

package/dist/sessions/export.js.map

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

package/dist/sessions/gateway-watcher.d.ts

@@ -0,0 +1,58 @@
+import { type Dict } from './state-db.js';
+export declare const GATEWAY_POLL_INTERVAL_S = 5;
+export interface GatewaySessionsEvent {
+    type: 'sessions_changed';
+    sessions: Dict[];
+}
+export interface GatewaySubscriber {
+    /** Resolves with the next event, or null when the watcher stopped or this subscriber was dropped as a slow consumer. */
+    next: (signal?: AbortSignal) => Promise<GatewaySessionsEvent | null>;
+    close: () => void;
+}
+export declare function snapshotHash(sessions: Dict[]): string;
+/** Python `_get_agent_sessions_from_db`: the watcher's lightweight projection (null when the read failed). */
+export declare function agentSessionsFromDb(dbPath: string, onError?: (reason: string, error: unknown) => void): Dict[] | null;
+export declare class GatewayWatcher {
+    readonly profileName: string;
+    readonly hermesHome: string;
+    private readonly opts;
+    readonly stateDbPath: string;
+    private readonly subscribers;
+    private timer;
+    private running;
+    private stopping;
+    private lastHash;
+    private lastCheapFp;
+    private lastFullProjectionAt;
+    private lastErrorLogAt;
+    constructor(profileName: string, hermesHome: string, opts: {
+        now: () => number;
+        log: (line: string) => void;
+        pollIntervalMs?: number;
+    });
+    isAlive(): boolean;
+    hasSubscribers(): boolean;
+    start(): void;
+    stop(): void;
+    subscribe(): GatewaySubscriber;
+    private push;
+    private notify;
+    private warnFailure;
+    /** One change-detection pass; returns true when the projection ran. */
+    pollOnce(now?: number): boolean;
+}
+/** Python module-level watcher registry keyed by profile home. */
+export declare class GatewayWatcherRegistry {
+    private readonly deps;
+    private readonly watchers;
+    constructor(deps: {
+        profileHome: (profile: string) => string;
+        now: () => number;
+        log: (line: string) => void;
+        pollIntervalMs?: number;
+    });
+    get(profile: string): GatewayWatcher;
+    /** Python `restart_watcher_for_profile`: swap atomically; idle watchers for other homes are reaped. */
+    restartForProfile(profile: string): GatewayWatcher;
+    stopAll(): void;
+}