@flowajs/chat-service 0.0.1

package/dist/session.js

@@ -0,0 +1,245 @@
+/** Session management: creation, caching, and context building. */
+import { randomUUID } from "node:crypto";
+import nunjucks from "nunjucks";
+import { signSessionToken } from "./auth/jwt.js";
+import { loadQueryResult, loadAggregate, loadPaperMetadata, listEditDrafts, } from "./storage-keys.js";
+import { schemaForPrompt } from "./artifact.js";
+import { loadEditPromptTemplate } from "./prompts.js";
+import { buildBboxCache, artifactToYaml, addLineNumbers, } from "./yaml.js";
+/** In-memory session cache. Not the source of truth — rebuilt from storage on miss. */
+const sessions = new Map();
+let sweeper = null;
+function ensureSweeper() {
+    if (sweeper)
+        return;
+    sweeper = setInterval(() => {
+        const now = Date.now();
+        for (const [id, ctx] of sessions) {
+            if (ctx.expiresAt.getTime() < now)
+                sessions.delete(id);
+        }
+    }, 30 * 60 * 1000);
+    sweeper.unref();
+}
+export function getCachedSession(sessionId) {
+    return sessions.get(sessionId);
+}
+/** For tests / shutdown: clear the in-memory cache. */
+export function clearSessionCache() {
+    sessions.clear();
+    if (sweeper) {
+        clearInterval(sweeper);
+        sweeper = null;
+    }
+}
+/**
+ * Rebuild session context from JWT claims (after restart or cache eviction).
+ * Loads the latest draft from storage to restore artifact state. This loses
+ * session-specific position if another session has written newer versions
+ * in the meantime — acceptable for now.
+ */
+export async function rebuildSession(config, claims, expiresAt) {
+    ensureSweeper();
+    const category = claims.category;
+    const query = await loadQueryResult(config.storage, claims.variant_id);
+    if (!query) {
+        throw new Error(`No assessment data found for variant ${claims.variant_id}`);
+    }
+    const [aggregate, drafts, ...paperMetadataResults] = await Promise.all([
+        loadAggregate(config.storage, claims.variant_id),
+        listEditDrafts(config.storage, claims.variant_id, category),
+        ...query.dois.map((doi) => loadPaperMetadata(config.storage, doi)),
+    ]);
+    const paperMetadata = query.dois.map((doi, i) => ({
+        doi,
+        metadata: paperMetadataResults[i] ?? null,
+    }));
+    const paperIds = buildPaperIds(aggregate);
+    const latestDraft = drafts.length > 0 ? drafts[drafts.length - 1] : null;
+    let artifactJson;
+    let artifactVersion;
+    if (latestDraft) {
+        artifactJson = latestDraft.artifactText;
+        artifactVersion = latestDraft.version;
+    }
+    else {
+        artifactJson = extractArtifactFromAggregate(aggregate, category);
+        artifactVersion = 0;
+    }
+    const bboxCache = buildBboxCache(artifactJson);
+    const artifactYaml = artifactToYaml(artifactJson);
+    const session = {
+        id: claims.session_id,
+        variantId: claims.variant_id,
+        userId: claims.user_id,
+        paperIds,
+        systemPrompt: buildEditSystemPrompt({
+            papers: paperMetadata,
+            paperIds,
+            artifactYaml,
+            schema: config.schema,
+            promptDir: config.promptDir,
+        }),
+        expiresAt,
+        artifactYaml,
+        artifactVersion,
+        artifactDirty: false,
+        category,
+        aggregateCategories: extractAggregateCategories(aggregate),
+        bboxCache,
+    };
+    sessions.set(session.id, session);
+    return session;
+}
+// ---------------------------------------------------------------------------
+// Edit sessions
+// ---------------------------------------------------------------------------
+const promptEnv = new nunjucks.Environment(undefined, {
+    autoescape: false,
+    throwOnUndefined: true,
+});
+/**
+ * Create a new edit session bound to a specific artifact version. The caller
+ * passes the initial artifact JSON verbatim and the version number it came
+ * from — chat-service stores these as-is.
+ */
+export async function createEditSession(config, input) {
+    ensureSweeper();
+    const query = await loadQueryResult(config.storage, input.variantId);
+    if (!query) {
+        throw new Error(`No assessment data found for variant ${input.variantId}`);
+    }
+    const [aggregate, ...paperMetadataResults] = await Promise.all([
+        loadAggregate(config.storage, input.variantId),
+        ...query.dois.map((doi) => loadPaperMetadata(config.storage, doi)),
+    ]);
+    if (!aggregate) {
+        throw new Error(`No aggregate found for variant ${input.variantId}`);
+    }
+    const paperMetadata = query.dois.map((doi, i) => ({
+        doi,
+        metadata: paperMetadataResults[i] ?? null,
+    }));
+    const paperIds = buildPaperIds(aggregate);
+    const aggregateCategories = extractAggregateCategories(aggregate);
+    const bboxCache = buildBboxCache(input.initialArtifact);
+    const artifactYaml = artifactToYaml(input.initialArtifact);
+    const systemPrompt = buildEditSystemPrompt({
+        papers: paperMetadata,
+        paperIds,
+        artifactYaml,
+        schema: config.schema,
+        promptDir: config.promptDir,
+    });
+    const sessionId = randomUUID();
+    const claims = {
+        session_id: sessionId,
+        variant_id: input.variantId,
+        user_id: input.userId,
+        category: input.category,
+    };
+    const { token, expiresAt } = await signSessionToken(claims, {
+        secret: config.jwtSecret,
+        ttlSeconds: config.jwtTtlSeconds,
+    });
+    const session = {
+        id: sessionId,
+        variantId: input.variantId,
+        userId: input.userId,
+        paperIds,
+        systemPrompt,
+        expiresAt,
+        artifactYaml,
+        artifactVersion: input.initialVersion,
+        artifactDirty: false,
+        category: input.category,
+        aggregateCategories,
+        bboxCache,
+    };
+    sessions.set(sessionId, session);
+    return { session, token, expiresAt };
+}
+/** Extract the artifact JSON for a category from aggregation.json. */
+function extractArtifactFromAggregate(aggregate, category) {
+    if (typeof aggregate !== "object" ||
+        aggregate === null ||
+        !("results" in aggregate)) {
+        throw new Error("aggregation.json has no results");
+    }
+    const results = aggregate.results;
+    const result = results.find((r) => r.category === category);
+    if (!result) {
+        throw new Error(`Category ${category} not found in aggregation.json`);
+    }
+    return JSON.stringify(result, null, 2);
+}
+/** Extract all categories present in aggregation.json results. */
+function extractAggregateCategories(aggregate) {
+    if (typeof aggregate !== "object" ||
+        aggregate === null ||
+        !("results" in aggregate)) {
+        return [];
+    }
+    return aggregate.results.map((r) => r.category);
+}
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+export const CITATION_INSTRUCTIONS = `## Citations
+
+When referencing a finding from a paper, use inline Markdown citation links with a verbatim quote: \`[link text](#cite:paperId "verbatim quote")\`.
+
+- The **link text** is free-form — use a descriptive phrase or specific claim, whatever reads naturally.
+- The **title attribute** (in quotes after the href) must be a verbatim passage from the paper text — enough context to validate the claim (typically a sentence or key clause). The quote will be highlighted in the PDF for reviewers, so avoid quoting isolated values or single words that could match multiple locations — include surrounding context.
+- When re-citing a finding from a paper's extraction results (loaded via loadPaperExtracts), reuse the exact quote string from the extraction's citation — do not rephrase or shorten it.
+- When citing from a paper's full text (loaded via loadFullPaper or queryPapers), quote the relevant passage verbatim.
+- The href format \`#cite:paperId\` is required exactly — the application uses it to identify the paper.
+- Be generous with links: whenever a factual claim can be traced to a specific passage, link it.`;
+/** Extract paper ID → DOI mapping from the aggregate's paper_id_mapping. */
+function buildPaperIds(aggregate) {
+    const ids = {};
+    if (typeof aggregate === "object" &&
+        aggregate !== null &&
+        "paper_id_mapping" in aggregate) {
+        const mapping = aggregate.paper_id_mapping;
+        for (const [authorYear, entry] of Object.entries(mapping)) {
+            ids[authorYear] = entry.doi;
+        }
+    }
+    return ids;
+}
+function invertPaperIds(paperIds) {
+    const inverted = {};
+    for (const [id, doi] of Object.entries(paperIds)) {
+        inverted[doi] = id;
+    }
+    return inverted;
+}
+function buildPaperIndex(papers, paperIds) {
+    const doiToPaperId = invertPaperIds(paperIds);
+    return papers
+        .map((p) => {
+        const id = doiToPaperId[p.doi];
+        if (!id)
+            return null;
+        const m = p.metadata;
+        if (!m)
+            return `- **${id}** — metadata unavailable`;
+        const title = m.title ?? "Unknown title";
+        const abstract = m.abstract ?? "";
+        const pmid = m.pmid ? ` (PMID ${m.pmid})` : "";
+        return `- **${id}**${pmid}: ${title}\n  ${abstract}`;
+    })
+        .filter(Boolean)
+        .join("\n\n");
+}
+function buildEditSystemPrompt({ papers, paperIds, artifactYaml, schema, promptDir, }) {
+    const template = loadEditPromptTemplate(promptDir);
+    const paperIndex = buildPaperIndex(papers, paperIds);
+    return promptEnv.renderString(template, {
+        artifact_schema: schemaForPrompt(schema),
+        paper_index: paperIndex,
+        initial_artifact: addLineNumbers(artifactYaml),
+    });
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/storage/factory.d.ts

@@ -0,0 +1,28 @@
+import type { Storage } from "./interface.js";
+/**
+ * Discriminated config for the env-driven default `index.ts`. Each backend
+ * lives in its own module so the matching SDK (`@aws-sdk/client-s3` for
+ * `s3`, `@google-cloud/storage` for `gcs`) is loaded only when actually
+ * selected.
+ */
+export type StorageConfig = {
+    backend: "fs";
+    root: string;
+    prefix?: string;
+} | {
+    backend: "s3";
+    bucket: string;
+    prefix?: string;
+} | {
+    backend: "gcs";
+    bucket: string;
+    prefix?: string;
+};
+/**
+ * Construct a `Storage` from a typed config. The matching backend module is
+ * dynamic-imported, so a deployment that only uses `fs` never loads
+ * `@aws-sdk/client-s3`. If the peer SDK is missing at runtime, the
+ * dynamic import fails with a clear error naming the unresolvable package.
+ */
+export declare function createStorage(config: StorageConfig): Promise<Storage>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/storage/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CA2B3E"}

package/dist/storage/factory.js

@@ -0,0 +1,33 @@
+/**
+ * Construct a `Storage` from a typed config. The matching backend module is
+ * dynamic-imported, so a deployment that only uses `fs` never loads
+ * `@aws-sdk/client-s3`. If the peer SDK is missing at runtime, the
+ * dynamic import fails with a clear error naming the unresolvable package.
+ */
+export async function createStorage(config) {
+    if (config.backend === "fs") {
+        const { createFsStorage } = await import("./fs.js");
+        return createFsStorage({
+            root: config.root,
+            ...(config.prefix !== undefined ? { prefix: config.prefix } : {}),
+        });
+    }
+    if (config.backend === "s3") {
+        const { createS3Storage } = await import("./s3.js");
+        return createS3Storage({
+            bucket: config.bucket,
+            ...(config.prefix !== undefined ? { prefix: config.prefix } : {}),
+        });
+    }
+    if (config.backend === "gcs") {
+        const { createGcsStorage } = await import("./gcs.js");
+        return createGcsStorage({
+            bucket: config.bucket,
+            ...(config.prefix !== undefined ? { prefix: config.prefix } : {}),
+        });
+    }
+    // Exhaustiveness check — the discriminated union should cover every backend.
+    const _exhaustive = config;
+    throw new Error(`Unsupported storage backend: ${JSON.stringify(_exhaustive)}`);
+}
+//# sourceMappingURL=factory.js.map

package/dist/storage/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB;IACvD,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,eAAe,CAAC;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,eAAe,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACtD,OAAO,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,6EAA6E;IAC7E,MAAM,WAAW,GAAU,MAAM,CAAC;IAClC,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAC9D,CAAC;AACJ,CAAC"}

package/dist/storage/fs.d.ts

@@ -0,0 +1,14 @@
+import { type Storage } from "./interface.js";
+export interface FsStorageOptions {
+    /** Absolute root directory for all keys. Created on first write if missing. */
+    root: string;
+    /** Optional prefix prepended to every key (joined as a path segment). */
+    prefix?: string;
+}
+/**
+ * Local filesystem `Storage` backend. Atomic create-only via
+ * `O_CREAT|O_EXCL`. Concurrent calls to `writeIfAbsent` for the same key
+ * deterministically pick one winner; the loser sees `StorageConflictError`.
+ */
+export declare function createFsStorage(options: FsStorageOptions): Storage;
+//# sourceMappingURL=fs.d.ts.map

package/dist/storage/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/storage/fs.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CA2GlE"}

package/dist/storage/fs.js

@@ -0,0 +1,116 @@
+import { open, readFile, writeFile, mkdir, stat, readdir, } from "node:fs/promises";
+import { dirname, join, resolve, sep } from "node:path";
+import { StorageConflictError } from "./interface.js";
+/**
+ * Local filesystem `Storage` backend. Atomic create-only via
+ * `O_CREAT|O_EXCL`. Concurrent calls to `writeIfAbsent` for the same key
+ * deterministically pick one winner; the loser sees `StorageConflictError`.
+ */
+export function createFsStorage(options) {
+    const root = resolve(options.root);
+    const prefix = options.prefix ?? "";
+    function pathFor(key) {
+        const full = join(root, prefix, key);
+        const resolved = resolve(full);
+        // Reject path-traversal attempts (key="../.." etc.).
+        if (!resolved.startsWith(root + sep) && resolved !== root) {
+            throw new Error(`Path traversal rejected for key: ${key}`);
+        }
+        return resolved;
+    }
+    return {
+        prefix,
+        async read(key) {
+            try {
+                return await readFile(pathFor(key));
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    return null;
+                throw error;
+            }
+        },
+        async readText(key) {
+            const buf = await this.read(key);
+            return buf ? buf.toString("utf-8") : null;
+        },
+        async readJson(key) {
+            const text = await this.readText(key);
+            return text ? JSON.parse(text) : null;
+        },
+        async write(key, body) {
+            const path = pathFor(key);
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, body);
+        },
+        async writeJson(key, value) {
+            await this.write(key, JSON.stringify(value));
+        },
+        async writeIfAbsent(key, body) {
+            const path = pathFor(key);
+            await mkdir(dirname(path), { recursive: true });
+            let handle;
+            try {
+                // O_CREAT|O_EXCL: create only if not exists; EEXIST otherwise.
+                handle = await open(path, "wx");
+            }
+            catch (error) {
+                if (error.code === "EEXIST") {
+                    throw new StorageConflictError(key);
+                }
+                throw error;
+            }
+            try {
+                await handle.writeFile(body);
+            }
+            finally {
+                await handle.close();
+            }
+        },
+        async exists(key) {
+            try {
+                await stat(pathFor(key));
+                return true;
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    return false;
+                throw error;
+            }
+        },
+        async list(listPrefix) {
+            const base = pathFor(listPrefix);
+            const baseRoot = pathFor("");
+            const out = [];
+            async function walk(dir) {
+                let entries;
+                try {
+                    entries = await readdir(dir, { withFileTypes: true });
+                }
+                catch (error) {
+                    if (error.code === "ENOENT")
+                        return;
+                    throw error;
+                }
+                for (const entry of entries) {
+                    const full = join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        await walk(full);
+                    }
+                    else if (entry.isFile()) {
+                        // Return keys relative to the configured root (so list output is
+                        // symmetric with read/write keys).
+                        const rel = full
+                            .slice(baseRoot.length)
+                            .replace(/^[/\\]/, "")
+                            .replaceAll(sep, "/");
+                        out.push(rel);
+                    }
+                }
+            }
+            await walk(base);
+            return out.sort();
+        },
+    };
+}
+//# sourceMappingURL=fs.js.map

package/dist/storage/fs.js.map

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

package/dist/storage/gcs.d.ts

@@ -0,0 +1,27 @@
+import { Storage as GcsStorageClient } from "@google-cloud/storage";
+import { type Storage } from "./interface.js";
+/**
+ * Env-driven form: chat-service constructs the GCS client with no
+ * explicit config; the SDK resolves credentials from Application Default
+ * Credentials (`GOOGLE_APPLICATION_CREDENTIALS`, gcloud user creds, GCE
+ * metadata server, etc.). For deployments needing custom client config
+ * (custom endpoint for emulators, programmatic credential injection,
+ * etc.), use the `{ client }` programmatic form below.
+ */
+export interface GcsStorageConfigOptions {
+    bucket: string;
+    prefix?: string;
+}
+/**
+ * Programmatic form: caller hands in a pre-built GCS `Storage` client.
+ * Use this when the deployment needs custom credential minting (Workload
+ * Identity Federation, custom token exchange, etc.) that the default
+ * chain does not cover.
+ */
+export interface GcsStorageClientOptions {
+    client: GcsStorageClient;
+    bucket: string;
+    prefix?: string;
+}
+export declare function createGcsStorage(options: GcsStorageConfigOptions | GcsStorageClientOptions): Storage;
+//# sourceMappingURL=gcs.d.ts.map

package/dist/storage/gcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/storage/gcs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,gBAAgB,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAAG,uBAAuB,GACzD,OAAO,CAaT"}

package/dist/storage/gcs.js

@@ -0,0 +1,81 @@
+import { Storage as GcsStorageClient } from "@google-cloud/storage";
+import { StorageConflictError } from "./interface.js";
+export function createGcsStorage(options) {
+    if ("client" in options) {
+        return makeStorage({
+            client: options.client,
+            bucket: options.bucket,
+            prefix: options.prefix ?? "",
+        });
+    }
+    return makeStorage({
+        client: new GcsStorageClient(),
+        bucket: options.bucket,
+        prefix: options.prefix ?? "",
+    });
+}
+function makeStorage({ client, bucket, prefix }) {
+    const bucketRef = client.bucket(bucket);
+    function fullKey(key) {
+        return prefix + key;
+    }
+    return {
+        prefix,
+        async read(key) {
+            try {
+                const [buffer] = await bucketRef.file(fullKey(key)).download();
+                return buffer;
+            }
+            catch (error) {
+                if (error.code === 404)
+                    return null;
+                throw error;
+            }
+        },
+        async readText(key) {
+            const buf = await this.read(key);
+            return buf ? buf.toString("utf-8") : null;
+        },
+        async readJson(key) {
+            const text = await this.readText(key);
+            return text ? JSON.parse(text) : null;
+        },
+        async write(key, body) {
+            await bucketRef.file(fullKey(key)).save(body);
+        },
+        async writeJson(key, value) {
+            await bucketRef.file(fullKey(key)).save(JSON.stringify(value), {
+                contentType: "application/json",
+            });
+        },
+        async writeIfAbsent(key, body) {
+            try {
+                // ifGenerationMatch:0 means "object must not exist"; on collision GCS
+                // returns 412 PreconditionFailed, which we translate below.
+                await bucketRef.file(fullKey(key)).save(body, {
+                    preconditionOpts: { ifGenerationMatch: 0 },
+                });
+            }
+            catch (error) {
+                if (error.code === 412) {
+                    throw new StorageConflictError(key);
+                }
+                throw error;
+            }
+        },
+        async exists(key) {
+            const [exists] = await bucketRef.file(fullKey(key)).exists();
+            return exists;
+        },
+        async list(listPrefix) {
+            // bucket.getFiles auto-paginates: for buckets > 1000 objects the SDK
+            // transparently issues subsequent pageToken requests internally and
+            // returns the accumulated list as a single-element tuple.
+            const [files] = await bucketRef.getFiles({
+                prefix: fullKey(listPrefix),
+            });
+            return files.map((f) => f.name.slice(prefix.length)).sort();
+        },
+    };
+}
+//# sourceMappingURL=gcs.js.map

package/dist/storage/gcs.js.map

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

package/dist/storage/interface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Thin storage abstraction. Five operations cover everything chat-service
+ * needs: read / write / writeIfAbsent / exists / list. Different backends
+ * (local FS, S3-compatible) implement the same surface; chat-service code
+ * never reaches past this.
+ *
+ * `writeIfAbsent` is atomic create-only — required by the edit-draft
+ * version-increment-on-collision loop in `storage-keys.ts`. Each backend
+ * implements it with its native primitive (POSIX `O_CREAT|O_EXCL`,
+ * S3 `IfNoneMatch: '*'`).
+ */
+export interface Storage {
+    /** Optional prefix prepended to every key. */
+    readonly prefix: string;
+    read(key: string): Promise<Buffer | null>;
+    readText(key: string): Promise<string | null>;
+    readJson<T>(key: string): Promise<T | null>;
+    write(key: string, body: Buffer | string): Promise<void>;
+    writeJson(key: string, value: unknown): Promise<void>;
+    /** Atomic create-only write. Throws `StorageConflictError` on collision. */
+    writeIfAbsent(key: string, body: Buffer | string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    list(prefix: string): Promise<string[]>;
+}
+/**
+ * Thrown by `Storage.writeIfAbsent` when an object already exists at the
+ * target key. Callers (e.g. `writeEditDraft`) catch this and retry with an
+ * incremented version number.
+ */
+export declare class StorageConflictError extends Error {
+    constructor(key: string);
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/storage/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAO;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,4EAA4E;IAC5E,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,GAAG,EAAE,MAAM;CAIxB"}

package/dist/storage/interface.js

@@ -0,0 +1,12 @@
+/**
+ * Thrown by `Storage.writeIfAbsent` when an object already exists at the
+ * target key. Callers (e.g. `writeEditDraft`) catch this and retry with an
+ * incremented version number.
+ */
+export class StorageConflictError extends Error {
+    constructor(key) {
+        super(`Object already exists at key: ${key}`);
+        this.name = "StorageConflictError";
+    }
+}
+//# sourceMappingURL=interface.js.map

package/dist/storage/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,GAAW;QACrB,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}