@multiplayer-app/sandbox 0.0.31 → 0.0.33-beta.1

package/dist/lib/session-pages/resolve-session-account-id.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearSessionAccountIdCache = clearSessionAccountIdCache;
+exports.resolveSessionAccountId = resolveSessionAccountId;
+const context_1 = require("../../context");
+const SESSION_ACCOUNT_CACHE = new Map();
+function clearSessionAccountIdCache(sessionId) {
+    if (sessionId) {
+        SESSION_ACCOUNT_CACHE.delete(sessionId);
+        return;
+    }
+    SESSION_ACCOUNT_CACHE.clear();
+}
+async function resolveSessionAccountId(sessionId) {
+    var _a;
+    const cached = SESSION_ACCOUNT_CACHE.get(sessionId);
+    if (cached) {
+        return cached;
+    }
+    const chat = await (0, context_1.getBuilderApiRepositories)().chatRepository.findById(sessionId);
+    if (!chat) {
+        throw new Error(`Session chat not found: ${sessionId}`);
+    }
+    const accountId = (_a = chat.tenants) === null || _a === void 0 ? void 0 : _a.account;
+    if (!accountId) {
+        throw new Error(`Session ${sessionId} has no tenants.account`);
+    }
+    SESSION_ACCOUNT_CACHE.set(sessionId, accountId);
+    return accountId;
+}
+//# sourceMappingURL=resolve-session-account-id.js.map

package/dist/lib/session-pages/resolve-session-account-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session-account-id.js","sourceRoot":"","sources":["../../../src/lib/session-pages/resolve-session-account-id.ts"],"names":[],"mappings":";;AAIA,gEAMC;AAED,0DAkBC;AA9BD,2CAAyD;AAEzD,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAkB,CAAA;AAEvD,SAAgB,0BAA0B,CAAC,SAAkB;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACvC,OAAM;IACR,CAAC;IACD,qBAAqB,CAAC,KAAK,EAAE,CAAA;AAC/B,CAAC;AAEM,KAAK,UAAU,uBAAuB,CAAC,SAAiB;;IAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACnD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,mCAAyB,GAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACjF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,SAAS,GAAG,MAAC,IAAI,CAAC,OAA4C,0CAAE,OAAO,CAAA;IAC7E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,yBAAyB,CAAC,CAAA;IAChE,CAAC;IAED,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAC/C,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/lib/session-pages/write-binary-session-artifact.d.ts

@@ -0,0 +1,12 @@
+export interface BinarySessionArtifact {
+    path: string;
+    bytes: number;
+}
+/**
+ * Write a binary artifact (e.g. a generated image) directly into the session
+ * directory. Binary files bypass the Yjs text store: they are not
+ * collaboratively edited, and listSessionArtifacts / the artifact GET route
+ * pick them up straight from disk.
+ */
+export declare function writeBinarySessionArtifact(sessionId: string, artifactPath: string, data: Uint8Array): Promise<BinarySessionArtifact>;
+//# sourceMappingURL=write-binary-session-artifact.d.ts.map

package/dist/lib/session-pages/write-binary-session-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-binary-session-artifact.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/write-binary-session-artifact.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,qBAAqB,CAAC,CAMhC"}

package/dist/lib/session-pages/write-binary-session-artifact.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeBinarySessionArtifact = writeBinarySessionArtifact;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const paths_1 = require("./paths");
+/**
+ * Write a binary artifact (e.g. a generated image) directly into the session
+ * directory. Binary files bypass the Yjs text store: they are not
+ * collaboratively edited, and listSessionArtifacts / the artifact GET route
+ * pick them up straight from disk.
+ */
+async function writeBinarySessionArtifact(sessionId, artifactPath, data) {
+    const relativePath = (0, paths_1.normalizeArtifactPath)(artifactPath);
+    const absolutePath = (0, paths_1.resolveArtifactPath)(sessionId, relativePath);
+    await promises_1.default.mkdir(node_path_1.default.dirname(absolutePath), { recursive: true });
+    await promises_1.default.writeFile(absolutePath, Buffer.from(data));
+    return { path: relativePath, bytes: data.byteLength };
+}
+//# sourceMappingURL=write-binary-session-artifact.js.map

package/dist/lib/session-pages/write-binary-session-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-binary-session-artifact.js","sourceRoot":"","sources":["../../../src/lib/session-pages/write-binary-session-artifact.ts"],"names":[],"mappings":";;;;;AAeA,gEAUC;AAzBD,gEAAiC;AACjC,0DAA4B;AAC5B,mCAAoE;AAOpE;;;;;GAKG;AACI,KAAK,UAAU,0BAA0B,CAC9C,SAAiB,EACjB,YAAoB,EACpB,IAAgB;IAEhB,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,YAAY,CAAC,CAAA;IACxD,MAAM,YAAY,GAAG,IAAA,2BAAmB,EAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IACjE,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/D,MAAM,kBAAE,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACnD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAA;AACvD,CAAC"}

package/dist/lib/session-pages/write-session-artifacts.d.ts

@@ -1,9 +1,8 @@
 export interface SessionArtifactFile {
     path: string;
     content: string;
-    /** For .html files: when true, content is a body/main fragment wrapped in a Pico template server-side. */
+    /** For .html files: when true, content is a body/main fragment wrapped in a Tailwind shell server-side. */
     fragment?: boolean;
-    /** Optional document title when publishing an HTML fragment. */
     title?: string;
 }
 export interface WriteSessionArtifactsInput {

package/dist/lib/session-pages/write-session-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-session-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,wBAAwB,EAAE,CAAA;CACtC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CA0BtC"}
+{"version":3,"file":"write-session-artifacts.d.ts","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,wBAAwB,EAAE,CAAA;CACtC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,CAsCtC"}

package/dist/lib/session-pages/write-session-artifacts.js

@@ -2,9 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeSessionArtifacts = writeSessionArtifacts;
 const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+const list_library_items_1 = require("../library/list-library-items");
 const html_artifact_template_1 = require("./html-artifact-template");
+const list_session_artifacts_1 = require("./list-session-artifacts");
 const paths_1 = require("./paths");
 async function writeSessionArtifacts(input) {
+    var _a, _b, _c, _d, _e;
     if (input.files.length === 0) {
         return { artifacts: [] };
     }
@@ -18,12 +21,20 @@ async function writeSessionArtifacts(input) {
                 title: file.title,
             })
             : file.content;
-        const published = await store.initializeFromContent(input.sessionId, relativePath, content);
+        // Upsert: create-only conflict is enforced by publishSessionArtifacts
+        // (cross-subagent). Self-revision after an audit repair must overwrite —
+        // initializeFromContent threw "File already exists" and forced update loops.
+        const published = await store.upsertFromContent(input.sessionId, relativePath, content);
         artifacts.push({
             path: published.path,
             bytes: published.bytes,
         });
     }
+    const allFiles = await (0, list_session_artifacts_1.listSessionArtifacts)(input.sessionId);
+    const previewPath = (_d = (_b = (_a = allFiles.find((file) => file.path === 'index.html')) === null || _a === void 0 ? void 0 : _a.path) !== null && _b !== void 0 ? _b : (_c = allFiles[0]) === null || _c === void 0 ? void 0 : _c.path) !== null && _d !== void 0 ? _d : (_e = artifacts[0]) === null || _e === void 0 ? void 0 : _e.path;
+    if (previewPath) {
+        await (0, list_library_items_1.markChatHasArtifacts)(input.sessionId, previewPath, allFiles.length);
+    }
     return {
         artifacts,
     };

package/dist/lib/session-pages/write-session-artifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-session-artifacts.js","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":";;AA2BA,sDA4BC;AAvDD,0FAAsF;AACtF,qEAAqE;AACrE,mCAA+C;AAyBxC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IAC1C,MAAM,SAAS,GAA+B,EAAE,CAAA;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,OAAO,GACX,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,IAAA,mDAA0B,EAAC,IAAI,CAAC,OAAO,EAAE;gBACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;QAClB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QAC3F,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,SAAS;KACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"write-session-artifacts.js","sourceRoot":"","sources":["../../../src/lib/session-pages/write-session-artifacts.ts"],"names":[],"mappings":";;AA4BA,sDAwCC;AApED,0FAAsF;AACtF,sEAAoE;AACpE,qEAAqE;AACrE,qEAA+D;AAC/D,mCAA+C;AAwBxC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;;IAEjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,uDAA0B,GAAE,CAAA;IAC1C,MAAM,SAAS,GAA+B,EAAE,CAAA;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,IAAA,6BAAqB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,OAAO,GACX,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC1C,CAAC,CAAC,IAAA,mDAA0B,EAAC,IAAI,CAAC,OAAO,EAAE;gBACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC;YACF,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;QAClB,sEAAsE;QACtE,yEAAyE;QACzE,6EAA6E;QAC7E,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA;QACvF,SAAS,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAA,6CAAoB,EAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC5D,MAAM,WAAW,GACf,MAAA,MAAA,MAAA,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,0CAAE,IAAI,mCACzD,MAAA,QAAQ,CAAC,CAAC,CAAC,0CAAE,IAAI,mCACjB,MAAA,SAAS,CAAC,CAAC,CAAC,0CAAE,IAAI,CAAA;IACpB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAA,yCAAoB,EAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC3E,CAAC;IAED,OAAO;QACL,SAAS;KACV,CAAA;AACH,CAAC"}

package/dist/lib/session-plans/build-plan.d.ts

@@ -0,0 +1,74 @@
+export type BuildTaskStatus = 'pending' | 'in_progress' | 'done' | 'skipped';
+export interface BuildTask {
+    id: string;
+    title: string;
+    description: string;
+    status: BuildTaskStatus;
+    /** Artifact paths this task produced or edited. */
+    paths?: string[];
+    note?: string;
+}
+/** Non-blocking audit findings deferred to the consistency-pass task. */
+export interface OpenAdvisory {
+    path: string;
+    /** Full advisory lines as returned by publish (`path: [rule] message…`). */
+    findings: string[];
+    recordedAt: string;
+}
+export interface BuildPlan {
+    title: string;
+    /** Design contract for the whole session: accent hexes, font pairing,
+     * layout pack, signature, radius/density, atmosphere, anti-cliché.
+     * Injected into every artifact subagent. */
+    designBrief?: string;
+    createdAt: string;
+    updatedAt: string;
+    tasks: BuildTask[];
+    /** Quality advisories waiting for the mandatory consistency pass. */
+    openAdvisories?: OpenAdvisory[];
+}
+export declare const BUILD_PLAN_PATH = "plan.json";
+/**
+ * Layout packs the design brief may name. Keep in sync with designer.skill
+ * and extractDesignTokens.
+ */
+export declare const LAYOUT_PACKS: readonly ["product", "launch", "editorial", "magazine", "split-hero", "dark-terminal", "bento", "brutalist", "workspace", "story"];
+export type LayoutPack = (typeof LAYOUT_PACKS)[number];
+/** Matches a layout pack token in free-text briefs (longest names first). */
+export declare const LAYOUT_PACK_PATTERN: RegExp;
+/** Last task must be an explicit consistency/polish pass (enforced at create). */
+export declare function isConsistencyPassTask(task: {
+    title: string;
+    description: string;
+}): boolean;
+/**
+ * designBrief must be specific enough to build a DISTINCT product — accent,
+ * pack, fonts, atmosphere, signature, radius/density, anti-cliché.
+ * Vague briefs produce Inter/indigo template pages.
+ */
+export declare function assertDesignBriefQuality(brief: string): void;
+export declare function createBuildPlan(title: string, tasks: Array<{
+    title: string;
+    description: string;
+}>, now: string, designBrief?: string): BuildPlan;
+/** Merge publish advisories into the plan for the consistency pass to consume. */
+export declare function recordOpenAdvisories(plan: BuildPlan, advisories: string[], now: string): BuildPlan;
+/** Drop advisories for paths that were polished (or all when paths omitted). */
+export declare function clearOpenAdvisories(plan: BuildPlan, paths?: string[], now?: string): BuildPlan;
+export declare function parseBuildPlan(content: string): BuildPlan | null;
+export declare function serializeBuildPlan(plan: BuildPlan): string;
+export interface TaskUpdate {
+    taskId: string;
+    status: BuildTaskStatus;
+    paths?: string[];
+    note?: string;
+}
+/** Apply a task update; returns null when the task id is unknown. */
+export declare function applyTaskUpdate(plan: BuildPlan, update: TaskUpdate, now: string): BuildPlan | null;
+export declare function nextPendingTask(plan: BuildPlan): BuildTask | undefined;
+export declare function planProgress(plan: BuildPlan): {
+    done: number;
+    total: number;
+    remaining: number;
+};
+//# sourceMappingURL=build-plan.d.ts.map

package/dist/lib/session-plans/build-plan.d.ts.map

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

package/dist/lib/session-plans/build-plan.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAYOUT_PACK_PATTERN = exports.LAYOUT_PACKS = exports.BUILD_PLAN_PATH = void 0;
+exports.isConsistencyPassTask = isConsistencyPassTask;
+exports.assertDesignBriefQuality = assertDesignBriefQuality;
+exports.createBuildPlan = createBuildPlan;
+exports.recordOpenAdvisories = recordOpenAdvisories;
+exports.clearOpenAdvisories = clearOpenAdvisories;
+exports.parseBuildPlan = parseBuildPlan;
+exports.serializeBuildPlan = serializeBuildPlan;
+exports.applyTaskUpdate = applyTaskUpdate;
+exports.nextPendingTask = nextPendingTask;
+exports.planProgress = planProgress;
+exports.BUILD_PLAN_PATH = 'plan.json';
+/**
+ * Layout packs the design brief may name. Keep in sync with designer.skill
+ * and extractDesignTokens.
+ */
+exports.LAYOUT_PACKS = [
+    'product',
+    'launch',
+    'editorial',
+    'magazine',
+    'split-hero',
+    'dark-terminal',
+    'bento',
+    'brutalist',
+    'workspace',
+    'story',
+];
+/** Matches a layout pack token in free-text briefs (longest names first). */
+exports.LAYOUT_PACK_PATTERN = /\b(split-hero|dark-terminal|workspace|brutalist|magazine|editorial|product|launch|bento|story)\b/i;
+const SIGNATURE_PATTERN = /\bsignature\b/i;
+const RADIUS_OR_DENSITY_PATTERN = /\b(sharp|soft|pill|airy|comfortable|dense)\b/i;
+const ANTI_CLICHE_PATTERN = /\b(anti-?clich[eé]|must not|must NOT|avoid|not look like|no indigo|no centered|never Inter)\b/i;
+/** Last task must be an explicit consistency/polish pass (enforced at create). */
+function isConsistencyPassTask(task) {
+    return /\b(consistency|polish|qa|quality)\b/i.test(`${task.title} ${task.description}`);
+}
+/**
+ * designBrief must be specific enough to build a DISTINCT product — accent,
+ * pack, fonts, atmosphere, signature, radius/density, anti-cliché.
+ * Vague briefs produce Inter/indigo template pages.
+ */
+function assertDesignBriefQuality(brief) {
+    if (!/#[0-9a-fA-F]{3,8}\b/.test(brief)) {
+        throw new Error('designBrief must include an exact accent hex (e.g. #0EA5E9). Pick a topic-fit color — avoid default indigo.');
+    }
+    if (!exports.LAYOUT_PACK_PATTERN.test(brief)) {
+        throw new Error(`designBrief must name a layout pack: ${exports.LAYOUT_PACKS.join(' | ')}.`);
+    }
+    if (!/fonts\.googleapis\.com/i.test(brief) &&
+        !/\b(?:fonts?|typeface|typography)\b/i.test(brief)) {
+        throw new Error('designBrief must name a Google Font pairing (display + body), e.g. "Manrope + Source Sans 3".');
+    }
+    if (!/\b(?:atmosphere|wash|mesh|grain|glass|orb|blur|gradient|grid|noise|ink)\b/i.test(brief)) {
+        throw new Error('designBrief must include an atmosphere note (e.g. soft accent wash, hard grid, noise film) so pages are not flat.');
+    }
+    if (!SIGNATURE_PATTERN.test(brief)) {
+        throw new Error('designBrief must name a signature (layout/surface/motion), e.g. "signature: split + hard grid + scroll reveal".');
+    }
+    if (!RADIUS_OR_DENSITY_PATTERN.test(brief)) {
+        throw new Error('designBrief must set radius (sharp|soft|pill) and/or density (airy|comfortable|dense).');
+    }
+    if (!ANTI_CLICHE_PATTERN.test(brief)) {
+        throw new Error('designBrief must include an anti-cliché note (what this must NOT look like), e.g. "no centered blur-orb hero".');
+    }
+}
+function createBuildPlan(title, tasks, now, designBrief) {
+    return {
+        title,
+        ...(designBrief ? { designBrief } : {}),
+        createdAt: now,
+        updatedAt: now,
+        tasks: tasks.map((task, index) => ({
+            id: `t${index + 1}`,
+            title: task.title,
+            description: task.description,
+            status: 'pending',
+        })),
+        openAdvisories: [],
+    };
+}
+/** Merge publish advisories into the plan for the consistency pass to consume. */
+function recordOpenAdvisories(plan, advisories, now) {
+    var _a, _b, _c;
+    if (advisories.length === 0)
+        return plan;
+    const byPath = new Map();
+    for (const existing of (_a = plan.openAdvisories) !== null && _a !== void 0 ? _a : []) {
+        byPath.set(existing.path, [...existing.findings]);
+    }
+    for (const line of advisories) {
+        const path = (_b = line.split(':')[0]) === null || _b === void 0 ? void 0 : _b.trim();
+        if (!path)
+            continue;
+        const prev = (_c = byPath.get(path)) !== null && _c !== void 0 ? _c : [];
+        if (!prev.includes(line))
+            prev.push(line);
+        byPath.set(path, prev);
+    }
+    plan.openAdvisories = [...byPath.entries()].map(([path, findings]) => ({
+        path,
+        findings,
+        recordedAt: now,
+    }));
+    plan.updatedAt = now;
+    return plan;
+}
+/** Drop advisories for paths that were polished (or all when paths omitted). */
+function clearOpenAdvisories(plan, paths, now) {
+    var _a;
+    if (!((_a = plan.openAdvisories) === null || _a === void 0 ? void 0 : _a.length))
+        return plan;
+    if (!paths || paths.length === 0) {
+        plan.openAdvisories = [];
+    }
+    else {
+        const remove = new Set(paths.map((path) => path.replace(/^\.\//, '')));
+        plan.openAdvisories = plan.openAdvisories.filter((entry) => !remove.has(entry.path));
+    }
+    if (now)
+        plan.updatedAt = now;
+    return plan;
+}
+function parseBuildPlan(content) {
+    try {
+        const parsed = JSON.parse(content);
+        if (!parsed || !Array.isArray(parsed.tasks)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+function serializeBuildPlan(plan) {
+    return JSON.stringify(plan, null, 2);
+}
+/** Apply a task update; returns null when the task id is unknown. */
+function applyTaskUpdate(plan, update, now) {
+    var _a;
+    const task = plan.tasks.find((candidate) => candidate.id === update.taskId);
+    if (!task) {
+        return null;
+    }
+    task.status = update.status;
+    if (update.paths) {
+        task.paths = [...new Set([...((_a = task.paths) !== null && _a !== void 0 ? _a : []), ...update.paths])];
+    }
+    if (update.note !== undefined) {
+        task.note = update.note;
+    }
+    plan.updatedAt = now;
+    return plan;
+}
+function nextPendingTask(plan) {
+    return plan.tasks.find((task) => task.status === 'pending' || task.status === 'in_progress');
+}
+function planProgress(plan) {
+    const done = plan.tasks.filter((task) => task.status === 'done' || task.status === 'skipped').length;
+    return { done, total: plan.tasks.length, remaining: plan.tasks.length - done };
+}
+//# sourceMappingURL=build-plan.js.map

package/dist/lib/session-plans/build-plan.js.map

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

package/dist/lib/yjs-pending/flush-lock.d.ts

@@ -0,0 +1,6 @@
+import type { RedisClientType } from 'redis';
+export declare function flushLockKey(documentId: string): string;
+export declare function acquireFlushLock(redis: RedisClientType, documentId: string, ttlSeconds?: number): Promise<string | null>;
+export declare function releaseFlushLock(redis: RedisClientType, documentId: string, token: string): Promise<void>;
+export declare function withFlushLock<T>(redis: RedisClientType, documentId: string, fn: () => Promise<T>, ttlSeconds?: number): Promise<T | null>;
+//# sourceMappingURL=flush-lock.d.ts.map

package/dist/lib/yjs-pending/flush-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-lock.d.ts","sourceRoot":"","sources":["../../../src/lib/yjs-pending/flush-lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAS5C,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,SAAK,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,aAAa,CAAC,CAAC,EACnC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAK,GACd,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAUnB"}

package/dist/lib/yjs-pending/flush-lock.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flushLockKey = flushLockKey;
+exports.acquireFlushLock = acquireFlushLock;
+exports.releaseFlushLock = releaseFlushLock;
+exports.withFlushLock = withFlushLock;
+const node_crypto_1 = require("node:crypto");
+const UNLOCK_LUA = `
+if redis.call("get", KEYS[1]) == ARGV[1] then
+  return redis.call("del", KEYS[1])
+end
+return 0
+`;
+function flushLockKey(documentId) {
+    return `yjs:flush-lock:${documentId}`;
+}
+async function acquireFlushLock(redis, documentId, ttlSeconds = 30) {
+    const token = (0, node_crypto_1.randomUUID)();
+    const result = await redis.set(flushLockKey(documentId), token, {
+        NX: true,
+        EX: ttlSeconds,
+    });
+    return result === 'OK' ? token : null;
+}
+async function releaseFlushLock(redis, documentId, token) {
+    await redis.eval(UNLOCK_LUA, {
+        keys: [flushLockKey(documentId)],
+        arguments: [token],
+    });
+}
+async function withFlushLock(redis, documentId, fn, ttlSeconds = 30) {
+    const token = await acquireFlushLock(redis, documentId, ttlSeconds);
+    if (!token) {
+        return null;
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        await releaseFlushLock(redis, documentId, token);
+    }
+}
+//# sourceMappingURL=flush-lock.js.map

package/dist/lib/yjs-pending/flush-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-lock.js","sourceRoot":"","sources":["../../../src/lib/yjs-pending/flush-lock.ts"],"names":[],"mappings":";;AAUA,oCAEC;AAED,4CAWC;AAED,4CASC;AAED,sCAeC;AArDD,6CAAwC;AAGxC,MAAM,UAAU,GAAG;;;;;CAKlB,CAAA;AAED,SAAgB,YAAY,CAAC,UAAkB;IAC7C,OAAO,kBAAkB,UAAU,EAAE,CAAA;AACvC,CAAC;AAEM,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,UAAkB,EAClB,UAAU,GAAG,EAAE;IAEf,MAAM,KAAK,GAAG,IAAA,wBAAU,GAAE,CAAA;IAC1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE;QAC9D,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,UAAU;KACf,CAAC,CAAA;IACF,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA;AACvC,CAAC;AAEM,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,UAAkB,EAClB,KAAa;IAEb,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE;QAC3B,IAAI,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAChC,SAAS,EAAE,CAAC,KAAK,CAAC;KACnB,CAAC,CAAA;AACJ,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,KAAsB,EACtB,UAAkB,EAClB,EAAoB,EACpB,UAAU,GAAG,EAAE;IAEf,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;IACnE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;IAClD,CAAC;AACH,CAAC"}

package/dist/lib/yjs-pending/flush-worker.d.ts

@@ -0,0 +1,5 @@
+export declare function runYjsFlushTick(): Promise<void>;
+export declare function sweepExpiredNamedSnapshotsForPrefix(prefix: string): Promise<number>;
+export declare function startYjsFlushWorker(): void;
+export declare function stopYjsFlushWorker(): void;
+//# sourceMappingURL=flush-worker.d.ts.map

package/dist/lib/yjs-pending/flush-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-worker.d.ts","sourceRoot":"","sources":["../../../src/lib/yjs-pending/flush-worker.ts"],"names":[],"mappings":"AAyBA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAYrD;AAED,wBAAsB,mCAAmC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAczF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAU1C;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}

package/dist/lib/yjs-pending/flush-worker.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runYjsFlushTick = runYjsFlushTick;
+exports.sweepExpiredNamedSnapshotsForPrefix = sweepExpiredNamedSnapshotsForPrefix;
+exports.startYjsFlushWorker = startYjsFlushWorker;
+exports.stopYjsFlushWorker = stopYjsFlushWorker;
+const context_1 = require("../../context");
+const logger_1 = require("../../logger");
+const artifact_storage_paths_1 = require("../session-pages/artifact-storage-paths");
+const s3_object_store_1 = require("../object-storage/s3-object-store");
+const yjs_persistence_1 = require("./yjs-persistence");
+const SNAPSHOT_RETENTION_MS = 7 * 24 * 60 * 60 * 1000;
+const SNAPSHOT_SEGMENT = '.snapshot-';
+let flushTimer = null;
+function parseSnapshotTimestamp(key) {
+    const idx = key.lastIndexOf(SNAPSHOT_SEGMENT);
+    if (idx < 0) {
+        return null;
+    }
+    const stamp = key.slice(idx + SNAPSHOT_SEGMENT.length);
+    const match = /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z$/.exec(stamp);
+    if (!match) {
+        return null;
+    }
+    const ms = Date.parse(`${match[1]}T${match[2]}:${match[3]}:${match[4]}.${match[5]}Z`);
+    return Number.isFinite(ms) ? ms : null;
+}
+async function runYjsFlushTick() {
+    if (!(0, context_1.getSharedRedisClient)()) {
+        return;
+    }
+    const documentIds = await (0, context_1.getYjsPendingUpdatesRepository)().listDocumentIdsWithPending(100);
+    for (const documentId of documentIds) {
+        try {
+            await (0, yjs_persistence_1.flushDocumentToS3)(documentId);
+        }
+        catch (error) {
+            (0, logger_1.getBuilderApiLogger)().warn({ err: error, documentId }, 'Yjs S3 flush failed');
+        }
+    }
+}
+async function sweepExpiredNamedSnapshotsForPrefix(prefix) {
+    const cutoff = Date.now() - SNAPSHOT_RETENTION_MS;
+    let deleted = 0;
+    for (const { key } of await (0, s3_object_store_1.listKeysByPrefix)(prefix)) {
+        if (!(0, artifact_storage_paths_1.isArtifactSnapshotPath)(key.slice(prefix.length))) {
+            continue;
+        }
+        const ts = parseSnapshotTimestamp(key);
+        if (ts !== null && ts < cutoff) {
+            await (0, s3_object_store_1.deleteObject)(key);
+            deleted += 1;
+        }
+    }
+    return deleted;
+}
+function startYjsFlushWorker() {
+    var _a, _b, _c;
+    if (flushTimer) {
+        return;
+    }
+    const intervalMs = (_b = (_a = (0, context_1.getBuilderApiContext)().config.contentStorage) === null || _a === void 0 ? void 0 : _a.flushIntervalMs) !== null && _b !== void 0 ? _b : 5000;
+    flushTimer = setInterval(() => {
+        void runYjsFlushTick();
+    }, intervalMs);
+    (_c = flushTimer.unref) === null || _c === void 0 ? void 0 : _c.call(flushTimer);
+    (0, logger_1.getBuilderApiLogger)().info({ intervalMs }, 'Yjs S3 flush worker started');
+}
+function stopYjsFlushWorker() {
+    if (flushTimer) {
+        clearInterval(flushTimer);
+        flushTimer = null;
+    }
+}
+//# sourceMappingURL=flush-worker.js.map

package/dist/lib/yjs-pending/flush-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush-worker.js","sourceRoot":"","sources":["../../../src/lib/yjs-pending/flush-worker.ts"],"names":[],"mappings":";;AAyBA,0CAYC;AAED,kFAcC;AAED,kDAUC;AAED,gDAKC;AAxED,2CAA0G;AAC1G,yCAAkD;AAClD,oFAAgF;AAChF,uEAAkF;AAClF,uDAAqD;AAErD,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AACrD,MAAM,gBAAgB,GAAG,YAAY,CAAA;AAErC,IAAI,UAAU,GAA0C,IAAI,CAAA;AAE5D,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAA;IAC7C,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,wDAAwD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAClF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACrF,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACxC,CAAC;AAEM,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,IAAA,8BAAoB,GAAE,EAAE,CAAC;QAC5B,OAAM;IACR,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,IAAA,wCAA8B,GAAE,CAAC,0BAA0B,CAAC,GAAG,CAAC,CAAA;IAC1F,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,IAAA,mCAAiB,EAAC,UAAU,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,qBAAqB,CAAC,CAAA;QAC/E,CAAC;IACH,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,mCAAmC,CAAC,MAAc;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAA;IACjD,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,MAAM,IAAA,kCAAgB,EAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAA,+CAAsB,EAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtD,SAAQ;QACV,CAAC;QACD,MAAM,EAAE,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAA,8BAAY,EAAC,GAAG,CAAC,CAAA;YACvB,OAAO,IAAI,CAAC,CAAA;QACd,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAgB,mBAAmB;;IACjC,IAAI,UAAU,EAAE,CAAC;QACf,OAAM;IACR,CAAC;IACD,MAAM,UAAU,GAAG,MAAA,MAAA,IAAA,8BAAoB,GAAE,CAAC,MAAM,CAAC,cAAc,0CAAE,eAAe,mCAAI,IAAI,CAAA;IACxF,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,KAAK,eAAe,EAAE,CAAA;IACxB,CAAC,EAAE,UAAU,CAAC,CAAA;IACd,MAAA,UAAU,CAAC,KAAK,0DAAI,CAAA;IACpB,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,6BAA6B,CAAC,CAAA;AAC3E,CAAC;AAED,SAAgB,kBAAkB;IAChC,IAAI,UAAU,EAAE,CAAC;QACf,aAAa,CAAC,UAAU,CAAC,CAAA;QACzB,UAAU,GAAG,IAAI,CAAA;IACnB,CAAC;AACH,CAAC"}

package/dist/lib/yjs-pending/yjs-pending-updates-repository.d.ts

@@ -0,0 +1,22 @@
+export interface YjsPendingUpdate {
+    id: string;
+    documentId: string;
+    accountId: string;
+    update: Uint8Array;
+    createdAt: string;
+}
+export interface AppendYjsPendingUpdateInput {
+    documentId: string;
+    accountId: string;
+    update: Uint8Array;
+}
+export interface YjsPendingUpdatesRepository {
+    append(input: AppendYjsPendingUpdateInput): Promise<YjsPendingUpdate>;
+    listByDocumentId(documentId: string): Promise<YjsPendingUpdate[]>;
+    countByDocumentId(documentId: string): Promise<number>;
+    deleteByIds(ids: string[]): Promise<void>;
+    deleteByDocumentId(documentId: string): Promise<void>;
+    deleteByDocumentIdPrefix(documentIdPrefix: string): Promise<void>;
+    listDocumentIdsWithPending(limit?: number): Promise<string[]>;
+}
+//# sourceMappingURL=yjs-pending-updates-repository.d.ts.map

package/dist/lib/yjs-pending/yjs-pending-updates-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-pending-updates-repository.d.ts","sourceRoot":"","sources":["../../../src/lib/yjs-pending/yjs-pending-updates-repository.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACrE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACjE,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,0BAA0B,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAC9D"}

package/dist/lib/yjs-pending/yjs-pending-updates-repository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=yjs-pending-updates-repository.js.map

package/dist/lib/yjs-pending/yjs-pending-updates-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-pending-updates-repository.js","sourceRoot":"","sources":["../../../src/lib/yjs-pending/yjs-pending-updates-repository.ts"],"names":[],"mappings":""}

package/dist/lib/yjs-pending/yjs-persistence.d.ts

@@ -0,0 +1,23 @@
+import * as Y from 'yjs';
+export type ParsedDocumentTarget = {
+    kind: 'session-artifact';
+    sessionId: string;
+    artifactPath: string;
+} | {
+    kind: 'notebook';
+    accountId: string;
+    notebookId: string;
+};
+export declare function parseDocumentTarget(documentIdentifier: string): ParsedDocumentTarget | null;
+export declare function readCommittedYjsState(parsed: ParsedDocumentTarget): Promise<Uint8Array | null>;
+export declare function writeCommittedYjsState(parsed: ParsedDocumentTarget, state: Uint8Array): Promise<void>;
+export declare function writeCommittedContentSnapshot(parsed: ParsedDocumentTarget, content: string): Promise<void>;
+export declare function writeNamedSessionSnapshot(sessionId: string, artifactPath: string, content: string, at?: Date): Promise<string>;
+export declare function docTextContent(doc: Y.Doc): string;
+export declare function loadMergedState(documentIdentifier: string): Promise<Uint8Array | null>;
+export declare function hydrateEphemeralDoc(documentIdentifier: string): Promise<Y.Doc | null>;
+export declare function appendIncrementalUpdate(documentIdentifier: string, accountId: string, update: Uint8Array, options?: {
+    treatAsPossiblyFullState?: boolean;
+}): Promise<void>;
+export declare function flushDocumentToS3(documentIdentifier: string): Promise<boolean>;
+//# sourceMappingURL=yjs-persistence.d.ts.map

package/dist/lib/yjs-pending/yjs-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yjs-persistence.d.ts","sourceRoot":"","sources":["../../../src/lib/yjs-pending/yjs-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAuBxB,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/D,wBAAgB,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAc3F;AAQD,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQpG;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,EAAE,GAAE,IAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,MAAM,CAEjD;AAED,wBAAsB,eAAe,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoB5F;AAED,wBAAsB,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAmB3F;AAED,wBAAsB,uBAAuB,CAC3C,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,wBAAsB,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoDpF"}