@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/ai-service/context-flush-scheduler.js.map

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

package/dist/ai-service/context-flush.d.ts

@@ -0,0 +1,36 @@
+import type { Logger } from "../util/logger.js";
+import { ContextFlushScheduler } from "./context-flush-scheduler.js";
+import type { ContextId } from "./llm/context-v2/types.js";
+/** The slice of AiService the context-flush pipeline reads. */
+export interface ContextFlushAiService {
+    getContextId(): ContextId | null;
+    getClarkJwt(): string | undefined;
+    readonly appRootDirPath: string;
+    readonly isAiFileUploadEnabled: boolean;
+    readonly superblocksBaseUrl: string;
+    on(event: "contextPersisted", listener: () => void): void;
+}
+/** The slice of SyncService the context-flush pipeline reads. */
+export interface ContextFlushSyncService {
+    readonly applicationId: string;
+    readonly branchName: string;
+    readonly lastCommitId: string | undefined;
+}
+/**
+ * Keeps the Bucketeer copy of the conversation fresh during a long
+ * generation. Each persist is a complete-turn boundary, so flush on a
+ * debounced cadence instead of only at generation end. The upload is a
+ * full replace, so a clear (new chat) is naturally safe.
+ *
+ * Subscribes to the AI service's `contextPersisted` events and returns the
+ * scheduler so callers can `flushNow()` on hard boundaries and `dispose()`
+ * on shutdown.
+ */
+export declare function wireContextFlush({ aiService, syncService, logger, debounceMs, maxWaitMs, }: {
+    aiService: ContextFlushAiService;
+    syncService: ContextFlushSyncService;
+    logger: Logger;
+    debounceMs: number;
+    maxWaitMs: number;
+}): ContextFlushScheduler;
+//# sourceMappingURL=context-flush.d.ts.map

package/dist/ai-service/context-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-flush.d.ts","sourceRoot":"","sources":["../../src/ai-service/context-flush.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,YAAY,IAAI,SAAS,GAAG,IAAI,CAAC;IACjC,WAAW,IAAI,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAGpC,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC3D;AAED,iEAAiE;AACjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,WAAW,EACX,MAAM,EACN,UAAU,EACV,SAAS,GACV,EAAE;IACD,SAAS,EAAE,qBAAqB,CAAC;IACjC,WAAW,EAAE,uBAAuB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,qBAAqB,CA0ExB"}

package/dist/ai-service/context-flush.js

@@ -0,0 +1,90 @@
+import { getErrorMeta } from "../util/logger.js";
+import { ContextFlushScheduler } from "./context-flush-scheduler.js";
+import { uploadContextToBucketeer } from "./context-upload.js";
+/**
+ * Keeps the Bucketeer copy of the conversation fresh during a long
+ * generation. Each persist is a complete-turn boundary, so flush on a
+ * debounced cadence instead of only at generation end. The upload is a
+ * full replace, so a clear (new chat) is naturally safe.
+ *
+ * Subscribes to the AI service's `contextPersisted` events and returns the
+ * scheduler so callers can `flushNow()` on hard boundaries and `dispose()`
+ * on shutdown.
+ */
+export function wireContextFlush({ aiService, syncService, logger, debounceMs, maxWaitMs, }) {
+    let contextPersistCount = 0;
+    // Resolves true when an upload happened (the scheduler then records the
+    // version as flushed) and false when the flush was skipped because
+    // credentials are not ready yet, so the same content is retried on the
+    // next persist instead of being recorded as flushed and dropped.
+    const uploadContextNow = async () => {
+        const contextId = aiService.getContextId();
+        const jwt = aiService.getClarkJwt();
+        const commitId = syncService.lastCommitId;
+        if (!contextId || !jwt || !commitId) {
+            // Expected early in a session before the first commit; log so a
+            // run of skips is observable, but return false so it is retried.
+            logger.debug("[file-sync] context flush skipped: credentials not ready", {
+                applicationId: syncService.applicationId,
+                branchName: syncService.branchName,
+                hasContextId: !!contextId,
+                hasJwt: !!jwt,
+                hasCommitId: !!commitId,
+            });
+            return false;
+        }
+        try {
+            const { rawContextBytes, fileCount } = await uploadContextToBucketeer({
+                applicationId: syncService.applicationId,
+                commitId,
+                branchName: syncService.branchName,
+                appRootDirPath: aiService.appRootDirPath,
+                useServerUpload: aiService.isAiFileUploadEnabled,
+                superblocksBaseUrl: aiService.superblocksBaseUrl,
+                logger,
+                jwt,
+            });
+            // Upload-volume telemetry: sizes the Phase 2 delta-upload decision.
+            logger.info("[file-sync] context flushed to Bucketeer", {
+                applicationId: syncService.applicationId,
+                branchName: syncService.branchName,
+                commitId,
+                rawContextBytes,
+                fileCount,
+            });
+            // Only count this as flushed when files actually went to Bucketeer.
+            // A fileCount=0 result means the upload was a no-op (no context on
+            // disk yet); returning false leaves the version unrecorded so the
+            // next persist retries instead of skipping as already-flushed.
+            return fileCount > 0;
+        }
+        catch (error) {
+            // Log with correlation fields so a failed upload can be tied back
+            // to a specific session. Return false (not throw) so the scheduler
+            // retries this content on the next persist without double-logging.
+            logger.warn("[file-sync] context flush failed", {
+                applicationId: syncService.applicationId,
+                branchName: syncService.branchName,
+                commitId,
+                userId: contextId.userId,
+                ...getErrorMeta(error),
+            });
+            return false;
+        }
+    };
+    const scheduler = new ContextFlushScheduler({
+        flush: uploadContextNow,
+        // Persist count is a cheap "did the context change" signal: it advances
+        // on every persist, so an unchanged context is never re-uploaded.
+        version: () => contextPersistCount,
+        debounceMs,
+        maxWaitMs,
+        logger,
+    });
+    aiService.on("contextPersisted", () => {
+        contextPersistCount++;
+        scheduler.requestFlush();
+    });
+    return scheduler;
+}
+//# sourceMappingURL=context-flush.js.map

package/dist/ai-service/context-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-flush.js","sourceRoot":"","sources":["../../src/ai-service/context-flush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAsB/D;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,SAAS,EACT,WAAW,EACX,MAAM,EACN,UAAU,EACV,SAAS,GAOV;IACC,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAC5B,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,gBAAgB,GAAG,KAAK,IAAsB,EAAE;QACpD,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC;QAC1C,IAAI,CAAC,SAAS,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,gEAAgE;YAChE,iEAAiE;YACjE,MAAM,CAAC,KAAK,CAAC,0DAA0D,EAAE;gBACvE,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,YAAY,EAAE,CAAC,CAAC,SAAS;gBACzB,MAAM,EAAE,CAAC,CAAC,GAAG;gBACb,WAAW,EAAE,CAAC,CAAC,QAAQ;aACxB,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,MAAM,wBAAwB,CAAC;gBACpE,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,QAAQ;gBACR,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,cAAc,EAAE,SAAS,CAAC,cAAc;gBACxC,eAAe,EAAE,SAAS,CAAC,qBAAqB;gBAChD,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;gBAChD,MAAM;gBACN,GAAG;aACJ,CAAC,CAAC;YACH,oEAAoE;YACpE,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;gBACtD,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,QAAQ;gBACR,eAAe;gBACf,SAAS;aACV,CAAC,CAAC;YACH,oEAAoE;YACpE,mEAAmE;YACnE,kEAAkE;YAClE,+DAA+D;YAC/D,OAAO,SAAS,GAAG,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kEAAkE;YAClE,mEAAmE;YACnE,mEAAmE;YACnE,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC9C,aAAa,EAAE,WAAW,CAAC,aAAa;gBACxC,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,QAAQ;gBACR,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,GAAG,YAAY,CAAC,KAAK,CAAC;aACvB,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,qBAAqB,CAAC;QAC1C,KAAK,EAAE,gBAAgB;QACvB,wEAAwE;QACxE,kEAAkE;QAClE,OAAO,EAAE,GAAG,EAAE,CAAC,mBAAmB;QAClC,UAAU;QACV,SAAS;QACT,MAAM;KACP,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACpC,mBAAmB,EAAE,CAAC;QACtB,SAAS,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/ai-service/context-restore.d.ts

@@ -0,0 +1,64 @@
+import type { Logger } from "../util/logger.js";
+import type { ContextManagerV2 } from "./llm/context-v2/manager.js";
+import type { ContextId } from "./llm/context-v2/types.js";
+/**
+ * Outcome of the context-side rollback. The caller (handleRestoreToCommit) maps
+ * this to the `checkpoint_restore_outcomes_total` metric and gates the server
+ * chat truncation on it — so this function never touches the metric or the
+ * chat-phase outcomes (`restored` / `chat_truncate_failed`), keeping metric
+ * emission in one place:
+ *  - `rolled_back`: context rolled back on disk; the caller should truncate the
+ *    chat and then record the terminal outcome.
+ *  - `aborted`: the event-log truncation threw; the rollback was not confirmed.
+ *  - `unhealed`: the snapshot could not be made consistent; rollback not applied.
+ *  - `no_checkpoint`: the cold (remote) restore found nothing to install.
+ *
+ * The three failure values are a subset of `CheckpointRestoreOutcome`, so the
+ * caller can forward them to `recordCheckpointRestore` without translation.
+ */
+export type RestoreConversationOutcome = "rolled_back" | "aborted" | "unhealed" | "no_checkpoint";
+export interface RestoreConversationToCheckpointParams {
+    contextManagerV2: Pick<ContextManagerV2, "truncateContextAfterTimestamp">;
+    contextId: ContextId;
+    /** Checkpoint time (epoch ms). Turns newer than this are rolled back. */
+    sinceTimestamp: number;
+    /**
+     * Pull the checkpoint's context archive from the remote store and install it
+     * locally. Used only when there is no local event log to truncate — a
+     * recycled pod whose disk was wiped before the restore. Resolves true when a
+     * checkpoint was found and restored.
+     */
+    coldRestore: () => Promise<boolean>;
+    /**
+     * Re-upload the just-restored context to the remote store. After a warm
+     * truncation the local archive is corrected; republishing makes the remote
+     * copy the freshest one, so a later cold-pod reconnect — which resolves the
+     * newest-by-mtime archive — sees the rolled-back conversation rather than the
+     * pre-restore one that a debounced flush left behind. Best-effort: a failure
+     * is logged, not thrown, so it cannot block the chat truncation that follows.
+     */
+    republish: () => Promise<void>;
+    logger: Logger;
+}
+/**
+ * Roll Clark's conversation back to a checkpoint.
+ *
+ * Prefers the local event log: it is append-only and per-turn timestamped, so
+ * truncating it to the checkpoint moment reproduces the conversation exactly as
+ * it was at that commit. This is the warm-pod path (no restart), and it is
+ * correct even when the remote commit archive was overwritten by a
+ * post-checkpoint flush, because it never reads that archive. After a warm
+ * truncation the corrected context is republished so a subsequent cold-pod
+ * reconnect resolves the rolled-back state too.
+ *
+ * Falls back to a remote checkpoint restore ONLY when there is no local event
+ * log to truncate (a recycled pod whose disk was already wiped). A warm pod
+ * whose truncation *fails* does not fall back — the remote archive may be the
+ * poisoned one — and instead reports not-restored so the chat is preserved.
+ *
+ * Returns a {@link RestoreConversationOutcome} so the caller can gate the
+ * server-side chat truncation (`rolled_back`) and record the metric in one
+ * place.
+ */
+export declare function restoreConversationToCheckpoint({ contextManagerV2, contextId, sinceTimestamp, coldRestore, republish, logger, }: RestoreConversationToCheckpointParams): Promise<RestoreConversationOutcome>;
+//# sourceMappingURL=context-restore.d.ts.map

package/dist/ai-service/context-restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-restore.d.ts","sourceRoot":"","sources":["../../src/ai-service/context-restore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,0BAA0B,GAClC,aAAa,GACb,SAAS,GACT,UAAU,GACV,eAAe,CAAC;AAEpB,MAAM,WAAW,qCAAqC;IACpD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;IAC1E,SAAS,EAAE,SAAS,CAAC;IACrB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC;;;;;;;OAOG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,+BAA+B,CAAC,EACpD,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,SAAS,EACT,MAAM,GACP,EAAE,qCAAqC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAuJ7E"}

package/dist/ai-service/context-restore.js

@@ -0,0 +1,136 @@
+import { getErrorMeta } from "../util/logger.js";
+/**
+ * Roll Clark's conversation back to a checkpoint.
+ *
+ * Prefers the local event log: it is append-only and per-turn timestamped, so
+ * truncating it to the checkpoint moment reproduces the conversation exactly as
+ * it was at that commit. This is the warm-pod path (no restart), and it is
+ * correct even when the remote commit archive was overwritten by a
+ * post-checkpoint flush, because it never reads that archive. After a warm
+ * truncation the corrected context is republished so a subsequent cold-pod
+ * reconnect resolves the rolled-back state too.
+ *
+ * Falls back to a remote checkpoint restore ONLY when there is no local event
+ * log to truncate (a recycled pod whose disk was already wiped). A warm pod
+ * whose truncation *fails* does not fall back — the remote archive may be the
+ * poisoned one — and instead reports not-restored so the chat is preserved.
+ *
+ * Returns a {@link RestoreConversationOutcome} so the caller can gate the
+ * server-side chat truncation (`rolled_back`) and record the metric in one
+ * place.
+ */
+export async function restoreConversationToCheckpoint({ contextManagerV2, contextId, sinceTimestamp, coldRestore, republish, logger, }) {
+    // New telemetry follows the OpenTelemetry dotted-attribute style (AGENTS.md).
+    const correlation = {
+        "app.id": contextId.appId,
+        "clark.context.name": contextId.name,
+        "clark.checkpoint.since_timestamp": sinceTimestamp,
+    };
+    let outcome;
+    try {
+        outcome = await contextManagerV2.truncateContextAfterTimestamp(contextId, sinceTimestamp);
+    }
+    catch (error) {
+        // A warm pod whose local log exists but could not be truncated (disk I/O
+        // error, a bug). The local log is the only trustworthy source; the remote
+        // archive may be the poisoned one. Do NOT fall back to it — report
+        // not-restored so the caller preserves the chat and the user can retry.
+        // This is distinct from `hadEvents: false` (no local log at all), which
+        // does fall back below.
+        logger.error(`[context-restore] Local event-log truncation failed for '${contextId.name}' ` +
+            `(appId=${contextId.appId}, sinceTimestamp=${sinceTimestamp}); not restoring so the chat is preserved`, getErrorMeta(error));
+        return "aborted";
+    }
+    if (outcome.hadEvents) {
+        if (!outcome.healed) {
+            // The rollback did not take effect on disk: either the event log could
+            // not be truncated, or a stale snapshot with a newer summary will
+            // override the truncated log on load. Either way the effective context
+            // still shows the pre-checkpoint turns, so report not-restored and leave
+            // the chat intact to match — rather than truncating it to a rollback that
+            // won't hold. (Identifiers are in the message because logger.error takes
+            // only ErrorMeta, not arbitrary structured fields.)
+            logger.error(`[context-restore] Could not roll back the conversation for '${contextId.name}' ` +
+                `(appId=${contextId.appId}, sinceTimestamp=${sinceTimestamp}); not restoring so the chat is preserved`);
+            return "unhealed";
+        }
+        if (outcome.dropped === 0) {
+            // A checkpoint restore is expected to drop at least the turns that
+            // followed the checkpoint. Zero dropped means either the local log
+            // already matched the checkpoint, or `sinceTimestamp` is wrong (clock
+            // skew / a mis-derived checkpoint time). Emit the newest event time
+            // alongside it so oncall can tell the two apart: ~equal is a benign
+            // already-matched restore, far-below means a too-large checkpoint time.
+            logger.warn("[context-restore] Checkpoint restore dropped 0 events; the checkpoint timestamp may be wrong or the local log already matched", {
+                ...correlation,
+                "clark.checkpoint.latest_event_timestamp": outcome.latestEventTimestamp,
+            });
+        }
+        else {
+            logger.info(`[context-restore] Truncated ${outcome.dropped} post-checkpoint event(s) from the local log`, correlation);
+        }
+        // Republish the corrected context so a later cold-pod reconnect (which
+        // resolves the newest remote archive) also sees the rollback. When the heal
+        // had to DELETE the snapshot, the archive is events-only; the republish
+        // uploads it anyway (allowEventsOnlyArchive) and the download rebuilds the
+        // rolled-back record from the truncated event log, so the remote is healed
+        // either way rather than left poisoned.
+        try {
+            await republish();
+        }
+        catch (error) {
+            logger.warn("[context-restore] Failed to republish the restored context (non-blocking)", { ...correlation, ...getErrorMeta(error) });
+        }
+        return "rolled_back";
+    }
+    // No local event log to truncate (a recycled pod whose disk was wiped, or a
+    // manager without an event store). Install the remote checkpoint archive,
+    // then truncate THAT by the same timestamp: restoreContextFromCheckpoint
+    // writes the archive's event log with original timestamps, so even a poisoned
+    // commit archive is rolled back to the checkpoint instead of round-tripped.
+    const restoredCold = await coldRestore();
+    if (!restoredCold) {
+        return "no_checkpoint";
+    }
+    let afterInstall;
+    try {
+        afterInstall = await contextManagerV2.truncateContextAfterTimestamp(contextId, sinceTimestamp);
+    }
+    catch (error) {
+        // Could not truncate the freshly-installed archive. Don't truncate the
+        // chat to a rollback we couldn't apply — that would leave the (possibly
+        // poisoned) archive as the effective context while the chat dropped turns.
+        logger.error(`[context-restore] Failed to truncate the installed remote archive for '${contextId.name}' ` +
+            `(appId=${contextId.appId}, sinceTimestamp=${sinceTimestamp}); not confirming the rollback so the chat is preserved`, getErrorMeta(error));
+        return "aborted";
+    }
+    if (afterInstall.hadEvents && !afterInstall.healed) {
+        // The archive had a local event log but it could not be made consistent
+        // with the rollback, so the installed context would stay ahead of a
+        // truncated chat. Preserve the chat instead of recreating the split.
+        logger.error(`[context-restore] Installed remote archive could not be rolled back consistently for '${contextId.name}' ` +
+            `(appId=${contextId.appId}, sinceTimestamp=${sinceTimestamp}); not restoring so the chat is preserved`);
+        return "unhealed";
+    }
+    if (afterInstall.hadEvents) {
+        logger.info(`[context-restore] Rolled back the installed remote archive by ${afterInstall.dropped} event(s)`, correlation);
+        // Republish the rolled-back context, exactly like the warm path. The cold
+        // restore installed a possibly-poisoned archive and we just truncated it
+        // locally; without this the remote's newest archive stays poisoned and the
+        // NEXT cold reconnect would reload the reverted turns. Best-effort.
+        try {
+            await republish();
+        }
+        catch (error) {
+            logger.warn("[context-restore] Failed to republish the rolled-back archive (non-blocking)", { ...correlation, ...getErrorMeta(error) });
+        }
+    }
+    else {
+        // No local event log in the archive to timestamp-truncate; the commit-keyed
+        // archive is the checkpoint's own snapshot, freshly downloaded, so it is
+        // used as-is and there is nothing new to republish.
+        logger.info("[context-restore] Installed remote archive has no local event log to truncate; using it as-is", correlation);
+    }
+    return "rolled_back";
+}
+//# sourceMappingURL=context-restore.js.map

package/dist/ai-service/context-restore.js.map

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

package/dist/ai-service/context-upload.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from "../util/logger.js";
+/**
+ * Uploads all context files and event logs to Bucketeer.
+ * Reads files from .superblocks/context/shared/ and
+ * .superblocks/events/shared/ and uploads them in one archive payload.
+ * Dynamically detects MIME types for any file type
+ */
+export declare function uploadContextToBucketeer({ applicationId, commitId, branchName, appRootDirPath, useServerUpload, superblocksBaseUrl, logger, jwt, allowEventsOnlyArchive, }: {
+    applicationId: string;
+    commitId: string;
+    branchName: string;
+    appRootDirPath: string;
+    useServerUpload?: boolean;
+    superblocksBaseUrl: string;
+    logger: Logger;
+    jwt: string;
+    /**
+     * Permit an archive with no `main.json` (event logs only). Off by default so
+     * the debounced FLUSH path never overwrites a good archive with an
+     * incomplete, mid-generation one. Checkpoint restore opts IN: after it deletes
+     * the legacy snapshot, the truncated event log is the sole authority, and the
+     * download side rebuilds the rolled-back record from that event log — so
+     * uploading it (rather than skipping) is what heals the remote `/context/latest`
+     * for a later cold-pod reconnect.
+     */
+    allowEventsOnlyArchive?: boolean;
+}): Promise<{
+    rawContextBytes: number;
+    fileCount: number;
+}>;
+//# sourceMappingURL=context-upload.d.ts.map

package/dist/ai-service/context-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-upload.d.ts","sourceRoot":"","sources":["../../src/ai-service/context-upload.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAmChD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,EAC7C,aAAa,EACb,QAAQ,EACR,UAAU,EACV,cAAc,EACd,eAAuB,EACvB,kBAAkB,EAClB,MAAM,EACN,GAAG,EACH,sBAA8B,GAC/B,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAsM1D"}

package/dist/ai-service/context-upload.js

@@ -0,0 +1,180 @@
+import { readdir, readFile } from "node:fs/promises";
+import * as path from "node:path";
+import { getBucketeerUrlFromSuperblocksUrl } from "@superblocksteam/util";
+import { getErrorMeta } from "../util/logger.js";
+import { safeJoinUnderRoot, SHARED_CONTEXT_SEGMENT, } from "./context-archive-paths.js";
+import { getScopedToken } from "./util/scoped-token-utils.js";
+const EVENT_LOG_ARCHIVE_PREFIX = "events__";
+async function readDirectoryFiles({ dir, archiveName, onMissing, }) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile())
+            .map((entry) => ({
+            archiveName: archiveName(entry.name),
+            filePath: path.join(dir, entry.name),
+        }));
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            onMissing();
+            return [];
+        }
+        throw err;
+    }
+}
+/**
+ * Uploads all context files and event logs to Bucketeer.
+ * Reads files from .superblocks/context/shared/ and
+ * .superblocks/events/shared/ and uploads them in one archive payload.
+ * Dynamically detects MIME types for any file type
+ */
+export async function uploadContextToBucketeer({ applicationId, commitId, branchName, appRootDirPath, useServerUpload = false, superblocksBaseUrl, logger, jwt, allowEventsOnlyArchive = false, }) {
+    // The reasoning context is shared per app; read the single shared store.
+    const contextRoot = path.join(appRootDirPath, ".superblocks", "context");
+    const eventsRoot = path.join(appRootDirPath, ".superblocks", "events");
+    const contextDir = safeJoinUnderRoot(contextRoot, SHARED_CONTEXT_SEGMENT);
+    const eventDir = safeJoinUnderRoot(eventsRoot, SHARED_CONTEXT_SEGMENT);
+    const filesToUpload = [
+        ...(await readDirectoryFiles({
+            dir: contextDir,
+            archiveName: (fileName) => fileName,
+            onMissing: () => logger.info(`[uploadContextToBucketeer] No shared context directory found for applicationId=${applicationId}`),
+        })),
+        ...(await readDirectoryFiles({
+            dir: eventDir,
+            archiveName: (fileName) => `${EVENT_LOG_ARCHIVE_PREFIX}${fileName}`,
+            onMissing: () => logger.info(`[uploadContextToBucketeer] No shared event log directory found for applicationId=${applicationId}`),
+        })),
+    ];
+    if (filesToUpload.length === 0) {
+        logger.info(`[uploadContextToBucketeer] No shared context or event log files found for applicationId=${applicationId}, skipping upload`);
+        return { rawContextBytes: 0, fileCount: 0 };
+    }
+    const contextFileData = [];
+    const uploadedFiles = [];
+    for (const file of filesToUpload) {
+        try {
+            // Read file as buffer to preserve binary content
+            const fileBuffer = await readFile(file.filePath);
+            // Convert Buffer to Uint8Array for Blob
+            // Content-Type is optional - server can infer from filename
+            contextFileData.push({ data: fileBuffer, archiveName: file.archiveName });
+            uploadedFiles.push(file.archiveName);
+        }
+        catch (err) {
+            logger.warn(`[uploadContextToBucketeer] Failed to read context file ${file.archiveName}, skipping`, getErrorMeta(err));
+            // Continue with other files even if one fails
+        }
+    }
+    if (uploadedFiles.length === 0) {
+        logger.warn(`[uploadContextToBucketeer] No files were successfully read for upload`);
+        return { rawContextBytes: 0, fileCount: 0 };
+    }
+    // Guard: a flush without main.json is normally incomplete (a mid-generation
+    // flush before the context record was persisted). Uploading it would overwrite
+    // a good archive with one that carries no snapshot, so skip by default. The
+    // exception is checkpoint restore (allowEventsOnlyArchive): it has already
+    // truncated the event log to the checkpoint and deleted the stale snapshot, so
+    // the event-log-only archive IS the rolled-back state — the download rebuilds
+    // the record from it. Skipping there would leave the poisoned archive live for
+    // a cold-pod reconnect, so upload it.
+    if (!uploadedFiles.includes("main.json")) {
+        if (!allowEventsOnlyArchive) {
+            logger.warn(`[uploadContextToBucketeer] Skipping upload: archive has no main.json (applicationId=${applicationId}, files=${uploadedFiles.join(", ")}). ` +
+                `This flush was likely triggered mid-generation before the context record was persisted.`);
+            return { rawContextBytes: 0, fileCount: 0 };
+        }
+        // Opt-in path (checkpoint restore): the snapshot was deleted, so the
+        // truncated event log is the whole archive. Log it so an events-only
+        // overwrite of the remote leaves a breadcrumb instead of being silent.
+        logger.info(`[uploadContextToBucketeer] Uploading events-only archive (no main.json) for applicationId=${applicationId}, commitId=${commitId}, files=${uploadedFiles.join(", ")}; ` +
+            `the download rebuilds the record from the event log (checkpoint restore heal).`);
+    }
+    // Raw on-disk buffer size summed across files, before FormData/multipart
+    // encoding; the actual HTTP payload is larger. Named to avoid implying this
+    // is the number of bytes transferred over the network.
+    const rawContextBytes = contextFileData.reduce((total, file) => total + file.data.length, 0);
+    const buildFormData = () => {
+        const formData = new FormData();
+        for (const contextFile of contextFileData) {
+            formData.append("context", new Blob([new Uint8Array(contextFile.data)]), contextFile.archiveName);
+        }
+        return formData;
+    };
+    const uploadViaServer = async () => {
+        const url = new URL(`${superblocksBaseUrl}/api/v1/files/upload`);
+        url.searchParams.set("scopeType", "app");
+        url.searchParams.set("purpose", "context");
+        url.searchParams.set("applicationId", applicationId);
+        url.searchParams.set("branchName", branchName);
+        url.searchParams.set("commitId", commitId);
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            body: buildFormData(),
+            headers: {
+                Authorization: `Bearer ${jwt}`,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response
+                .text()
+                .catch(() => "Unable to read error response");
+            throw new Error(`Server context upload failed: status=${response.status}, error=${errorText}`);
+        }
+    };
+    const uploadViaBucketeer = async () => {
+        let scopedToken;
+        try {
+            scopedToken = await getScopedToken({
+                applicationId,
+                superblocksBaseUrl,
+                jwt,
+            });
+        }
+        catch (error) {
+            logger.error("[uploadContextToBucketeer] Failed to get scoped token", getErrorMeta(error));
+            throw error;
+        }
+        // Get Bucketeer URL from Superblocks base URL
+        const bucketeerUrl = getBucketeerUrlFromSuperblocksUrl(superblocksBaseUrl);
+        // Upload to Bucketeer using the branch-aware context endpoint
+        const url = `${bucketeerUrl}/applications/${applicationId}/branches/${encodeURIComponent(branchName)}/commits/${encodeURIComponent(commitId)}/context`;
+        const response = await fetch(url, {
+            method: "POST",
+            body: buildFormData(),
+            headers: {
+                Authorization: `Bearer ${scopedToken}`,
+                // Content-Type will be set automatically by fetch with boundary
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response
+                .text()
+                .catch(() => "Unable to read error response");
+            logger.error(`[uploadContextToBucketeer] Upload failed: status=${response.status}, statusText=${response.statusText}, error=${errorText} for applicationId=${applicationId}, commitId=${commitId}`);
+            throw new Error(`Context upload failed: ${response.statusText}`);
+        }
+    };
+    try {
+        if (useServerUpload) {
+            try {
+                await uploadViaServer();
+            }
+            catch (error) {
+                logger.warn("[uploadContextToBucketeer] Server context upload failed, falling back to Bucketeer", getErrorMeta(error));
+                await uploadViaBucketeer();
+            }
+        }
+        else {
+            await uploadViaBucketeer();
+        }
+        logger.info(`[uploadContextToBucketeer] Successfully uploaded ${uploadedFiles.length} context file(s) (${uploadedFiles.join(", ")}) for applicationId=${applicationId}, commitId=${commitId}`);
+        return { rawContextBytes, fileCount: uploadedFiles.length };
+    }
+    catch (error) {
+        logger.error("[uploadContextToBucketeer] Failed to upload context", getErrorMeta(error));
+        throw error;
+    }
+}
+//# sourceMappingURL=context-upload.js.map

package/dist/ai-service/context-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-upload.js","sourceRoot":"","sources":["../../src/ai-service/context-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAE5C,KAAK,UAAU,kBAAkB,CAAC,EAChC,GAAG,EACH,WAAW,EACX,SAAS,GAKV;IACC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC;SACrC,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,EAC7C,aAAa,EACb,QAAQ,EACR,UAAU,EACV,cAAc,EACd,eAAe,GAAG,KAAK,EACvB,kBAAkB,EAClB,MAAM,EACN,GAAG,EACH,sBAAsB,GAAG,KAAK,GAoB/B;IACC,yEAAyE;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAEvE,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,MAAM,kBAAkB,CAAC;YAC3B,GAAG,EAAE,UAAU;YACf,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACnC,SAAS,EAAE,GAAG,EAAE,CACd,MAAM,CAAC,IAAI,CACT,kFAAkF,aAAa,EAAE,CAClG;SACJ,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,kBAAkB,CAAC;YAC3B,GAAG,EAAE,QAAQ;YACb,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,wBAAwB,GAAG,QAAQ,EAAE;YACnE,SAAS,EAAE,GAAG,EAAE,CACd,MAAM,CAAC,IAAI,CACT,oFAAoF,aAAa,EAAE,CACpG;SACJ,CAAC,CAAC;KACJ,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,2FAA2F,aAAa,mBAAmB,CAC5H,CAAC;QACF,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,eAAe,GAAiD,EAAE,CAAC;IACzE,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjD,wCAAwC;YACxC,4DAA4D;YAC5D,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC1E,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,0DAA0D,IAAI,CAAC,WAAW,YAAY,EACtF,YAAY,CAAC,GAAG,CAAC,CAClB,CAAC;YACF,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,uEAAuE,CACxE,CAAC;QACF,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,4EAA4E;IAC5E,+EAA+E;IAC/E,4EAA4E;IAC5E,2EAA2E;IAC3E,+EAA+E;IAC/E,8EAA8E;IAC9E,+EAA+E;IAC/E,sCAAsC;IACtC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,uFAAuF,aAAa,WAAW,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;gBAC1I,yFAAyF,CAC5F,CAAC;YACF,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,qEAAqE;QACrE,qEAAqE;QACrE,uEAAuE;QACvE,MAAM,CAAC,IAAI,CACT,6FAA6F,aAAa,cAAc,QAAQ,WAAW,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACrK,gFAAgF,CACnF,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,4EAA4E;IAC5E,uDAAuD;IACvD,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAC5C,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EACzC,CAAC,CACF,CAAC;IAEF,MAAM,aAAa,GAAG,GAAa,EAAE;QACnC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,KAAK,MAAM,WAAW,IAAI,eAAe,EAAE,CAAC;YAC1C,QAAQ,CAAC,MAAM,CACb,SAAS,EACT,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAC5C,WAAW,CAAC,WAAW,CACxB,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;QAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,kBAAkB,sBAAsB,CAAC,CAAC;QACjE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QACrD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa,EAAE;YACrB,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,GAAG,EAAE;aAC/B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ;iBAC7B,IAAI,EAAE;iBACN,KAAK,CAAC,GAAG,EAAE,CAAC,+BAA+B,CAAC,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,CAAC,MAAM,WAAW,SAAS,EAAE,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,KAAK,IAAmB,EAAE;QACnD,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,cAAc,CAAC;gBACjC,aAAa;gBACb,kBAAkB;gBAClB,GAAG;aACJ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,uDAAuD,EACvD,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;YACF,MAAM,KAAK,CAAC;QACd,CAAC;QAED,8CAA8C;QAC9C,MAAM,YAAY,GAAG,iCAAiC,CAAC,kBAAkB,CAAC,CAAC;QAE3E,8DAA8D;QAC9D,MAAM,GAAG,GAAG,GAAG,YAAY,iBAAiB,aAAa,aAAa,kBAAkB,CAAC,UAAU,CAAC,YAAY,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC;QACvJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa,EAAE;YACrB,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,gEAAgE;aACjE;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ;iBAC7B,IAAI,EAAE;iBACN,KAAK,CAAC,GAAG,EAAE,CAAC,+BAA+B,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CACV,oDAAoD,QAAQ,CAAC,MAAM,gBAAgB,QAAQ,CAAC,UAAU,WAAW,SAAS,sBAAsB,aAAa,cAAc,QAAQ,EAAE,CACtL,CAAC;YACF,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,eAAe,EAAE,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,oFAAoF,EACpF,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;gBACF,MAAM,kBAAkB,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,kBAAkB,EAAE,CAAC;QAC7B,CAAC;QAED,MAAM,CAAC,IAAI,CACT,oDAAoD,aAAa,CAAC,MAAM,qBAAqB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,aAAa,cAAc,QAAQ,EAAE,CAClL,CAAC;QACF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CACV,qDAAqD,EACrD,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}