@code-yeongyu/senpi 2026.8.18 → 2026.8.19

package/dist/core/extensions/builtin/loop/store.js

@@ -0,0 +1,424 @@
+/**
+ * Atomic, versioned, per-session sidecar store for `/loop` state.
+ *
+ * Mirrors the goal store's persistence discipline (temp file + rename, per-file mutation
+ * serialization, strict versioned parsing) because scheduler state must never be half
+ * written or silently reset: a corrupt file arms nothing and surfaces a typed error so
+ * the extension can end affected loops with `error` instead of guessing.
+ *
+ * Session custom entries are deliberately NOT the authoritative store: they are branch
+ * nodes, so a globally scanned "latest" entry can come from an abandoned branch, while
+ * loop schedules are session-scoped.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { EFFECTIVE_INTERVAL_UNITS, isRecord, LOOP_END_REASONS, LOOP_PHASES, LOOP_SENTINELS, LOOP_STATE_VERSION, LOOP_WAKE_SOURCE_KINDS, REQUESTED_INTERVAL_UNITS, } from "./types.js";
+export class InvalidLoopStoreError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "InvalidLoopStoreError";
+    }
+}
+export class UnsupportedLoopStoreVersionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnsupportedLoopStoreVersionError";
+    }
+}
+const mutationTails = new Map();
+const snapshots = new Map();
+export function encodedSessionId(ref) {
+    return encodeURIComponent(ref.sessionId);
+}
+export function loopStateFilePath(ref) {
+    return join(ref.baseDir, `${encodedSessionId(ref)}.json`);
+}
+export function emptyLoopState(sessionId) {
+    return { version: LOOP_STATE_VERSION, sessionId, entries: {}, activeDynamicId: null, updatedAt: 0 };
+}
+/**
+ * Reads persisted state, or null when this session has never persisted any loop.
+ * Throws {@link InvalidLoopStoreError} / {@link UnsupportedLoopStoreVersionError} on
+ * unusable state so callers fail closed rather than resetting a user's schedule.
+ */
+export async function readLoopState(ref) {
+    let raw;
+    try {
+        raw = await readFile(loopStateFilePath(ref), "utf8");
+    }
+    catch (error) {
+        if (isFileSystemError(error, "ENOENT"))
+            return null;
+        throw error;
+    }
+    const state = parseLoopState(raw, ref);
+    snapshots.set(loopStateFilePath(ref), state);
+    return state;
+}
+/** Like {@link readLoopState}, but returns an empty state when nothing is persisted. */
+export async function loadLoopState(ref) {
+    return (await readLoopState(ref)) ?? emptyLoopState(ref.sessionId);
+}
+/**
+ * Last successfully loaded or written state for this ref, for synchronous consumers
+ * (status line, tick attribution). Undefined until the store has been touched.
+ */
+export function snapshotLoopState(ref) {
+    return snapshots.get(loopStateFilePath(ref));
+}
+/**
+ * Serializes read-modify-write cycles through a per-file promise tail so command,
+ * timer, tool, and lifecycle writes cannot interleave and lose an update.
+ */
+export function mutateLoopState(ref, mutation) {
+    return enqueue(ref, async () => {
+        const current = await loadLoopState(ref);
+        const next = await mutation(current);
+        await writeLoopState(ref, next);
+        return next;
+    });
+}
+/** Persists a complete state atomically. Prefer {@link mutateLoopState} for updates. */
+export async function writeLoopState(ref, state) {
+    const filePath = loopStateFilePath(ref);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeAtomic(filePath, `${JSON.stringify(state, null, 2)}\n`);
+    snapshots.set(filePath, state);
+}
+/** Drops cached snapshots; used when a session ends or tests reset global state. */
+export function clearLoopStateSnapshot(ref) {
+    snapshots.delete(loopStateFilePath(ref));
+}
+function enqueue(ref, operation) {
+    const key = loopStateFilePath(ref);
+    const previous = mutationTails.get(key) ?? Promise.resolve();
+    const run = previous.then(operation);
+    const tail = run.then(() => undefined, () => undefined);
+    mutationTails.set(key, tail);
+    void tail.then(() => {
+        if (mutationTails.get(key) === tail)
+            mutationTails.delete(key);
+    });
+    return run;
+}
+async function writeAtomic(filePath, contents) {
+    const tempPath = join(dirname(filePath), `.loop-${randomUUID()}.tmp`);
+    try {
+        await writeFile(tempPath, contents, { encoding: "utf8", mode: 0o600 });
+        await rename(tempPath, filePath);
+    }
+    catch (error) {
+        try {
+            await rm(tempPath, { force: true });
+        }
+        catch (cleanupError) {
+            throw new AggregateError([error, cleanupError], "loop store write failed and its temporary file could not be removed");
+        }
+        throw error;
+    }
+}
+function parseLoopState(raw, ref) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new InvalidLoopStoreError("loop store contains unparseable JSON", { cause: error });
+    }
+    if (!isRecord(parsed))
+        throw new InvalidLoopStoreError("loop store must be a JSON object");
+    if (parsed.version !== LOOP_STATE_VERSION) {
+        throw new UnsupportedLoopStoreVersionError(`unsupported loop store version: ${JSON.stringify(parsed.version)} (expected ${LOOP_STATE_VERSION})`);
+    }
+    if (typeof parsed.sessionId !== "string" || parsed.sessionId.length === 0) {
+        throw new InvalidLoopStoreError("loop store is missing a sessionId");
+    }
+    if (parsed.sessionId !== ref.sessionId) {
+        throw new InvalidLoopStoreError(`loop store sessionId ${parsed.sessionId} does not match the session it was loaded for`);
+    }
+    if (!isEpochMs(parsed.updatedAt))
+        throw new InvalidLoopStoreError("loop store has an invalid updatedAt");
+    if (!isRecord(parsed.entries))
+        throw new InvalidLoopStoreError("loop store entries must be an object");
+    const entries = {};
+    for (const [id, value] of Object.entries(parsed.entries)) {
+        const entry = parseEntry(id, value);
+        entries[id] = entry;
+    }
+    const activeDynamicId = parsed.activeDynamicId;
+    if (activeDynamicId !== null) {
+        if (typeof activeDynamicId !== "string") {
+            throw new InvalidLoopStoreError("loop store activeDynamicId must be a string or null");
+        }
+        const active = entries[activeDynamicId];
+        if (active === undefined || active.kind !== "dynamic") {
+            throw new InvalidLoopStoreError(`loop store activeDynamicId ${activeDynamicId} does not name a dynamic loop`);
+        }
+    }
+    return {
+        version: LOOP_STATE_VERSION,
+        sessionId: parsed.sessionId,
+        entries,
+        activeDynamicId,
+        updatedAt: parsed.updatedAt,
+    };
+}
+function parseEntry(id, value) {
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} is not an object`);
+    if (value.id !== id)
+        throw new InvalidLoopStoreError(`loop entry ${id} carries a mismatched id`);
+    const kind = value.kind;
+    if (kind !== "fixed" && kind !== "dynamic")
+        throw new InvalidLoopStoreError(`loop entry ${id} has an unknown kind`);
+    const base = parseEntryFields(id, value);
+    if (kind === "fixed") {
+        const fixed = {
+            ...base,
+            kind: "fixed",
+            requestedInterval: parseRequestedInterval(id, value.requestedInterval),
+            effectiveInterval: parseEffectiveInterval(id, value.effectiveInterval),
+            cronExpression: requireString(id, "cronExpression", value.cronExpression),
+            nextFireAt: requireEpochMs(id, "nextFireAt", value.nextFireAt),
+            intervalMs: requirePositiveInteger(id, "intervalMs", value.intervalMs),
+        };
+        return fixed;
+    }
+    const keepaliveCredit = value.keepaliveCredit;
+    if (keepaliveCredit !== 0 && keepaliveCredit !== 1) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid keepaliveCredit`);
+    }
+    const dynamic = {
+        ...base,
+        kind: "dynamic",
+        pendingWakeup: parsePendingWakeup(id, value.pendingWakeup),
+        keepaliveCredit,
+    };
+    return dynamic;
+}
+function parseEntryFields(id, value) {
+    const fields = {
+        id,
+        originalArgs: requireString(id, "originalArgs", value.originalArgs, { allowEmpty: true }),
+        reentryPrompt: requireString(id, "reentryPrompt", value.reentryPrompt),
+        payload: parsePayload(id, value.payload),
+        createdAt: requireEpochMs(id, "createdAt", value.createdAt),
+        lastFiredAt: parseNullableEpochMs(id, "lastFiredAt", value.lastFiredAt),
+        expiresAt: requireEpochMs(id, "expiresAt", value.expiresAt),
+        lastScheduledForAt: parseNullableEpochMs(id, "lastScheduledForAt", value.lastScheduledForAt),
+        coalescedFirePending: requireBoolean(id, "coalescedFirePending", value.coalescedFirePending),
+        queuedForAt: parseNullableEpochMs(id, "queuedForAt", value.queuedForAt),
+        noopStreak: requireNonNegativeInteger(id, "noopStreak", value.noopStreak),
+        tickCount: requireNonNegativeInteger(id, "tickCount", value.tickCount),
+        sentinelDelivery: parseSentinelDelivery(id, value.sentinelDelivery),
+        wakeSources: parseWakeSources(id, value.wakeSources),
+    };
+    return { ...fields, ...parseLifecycle(id, value) };
+}
+function parseLifecycle(id, value) {
+    const phase = value.phase;
+    if (typeof phase !== "string" || !isLoopPhase(phase)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid phase`);
+    }
+    if (phase !== "ended") {
+        if (value.endedAt !== undefined || value.endReason !== undefined || value.endDetail !== undefined) {
+            throw new InvalidLoopStoreError(`loop entry ${id} carries terminal fields while not ended`);
+        }
+        return { phase };
+    }
+    const endReason = value.endReason;
+    if (typeof endReason !== "string" || !isLoopEndReason(endReason)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid endReason`);
+    }
+    const endDetail = value.endDetail;
+    if (endDetail !== undefined && typeof endDetail !== "string") {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid endDetail`);
+    }
+    return {
+        phase: "ended",
+        endedAt: requireEpochMs(id, "endedAt", value.endedAt),
+        endReason,
+        ...(endDetail === undefined ? {} : { endDetail }),
+    };
+}
+function parsePayload(id, value) {
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid payload`);
+    if (value.type === "prompt") {
+        return { type: "prompt", prompt: requireString(id, "payload.prompt", value.prompt) };
+    }
+    if (value.type === "sentinel") {
+        const sentinel = value.sentinel;
+        if (typeof sentinel !== "string" || !isLoopSentinel(sentinel)) {
+            throw new InvalidLoopStoreError(`loop entry ${id} has an unknown payload sentinel`);
+        }
+        return { type: "sentinel", sentinel };
+    }
+    throw new InvalidLoopStoreError(`loop entry ${id} has an unknown payload type`);
+}
+function parseSentinelDelivery(id, value) {
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid sentinelDelivery`);
+    return {
+        autonomousPreambleDelivered: requireBoolean(id, "sentinelDelivery.autonomousPreambleDelivered", value.autonomousPreambleDelivered),
+        lastLoopFileDelivered: parseFingerprint(id, value.lastLoopFileDelivered),
+        forceFullDelivery: requireBoolean(id, "sentinelDelivery.forceFullDelivery", value.forceFullDelivery),
+    };
+}
+function parseFingerprint(id, value) {
+    if (value === null)
+        return null;
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid loop-file fingerprint`);
+    return {
+        path: requireString(id, "fingerprint.path", value.path),
+        mtimeMs: requireFiniteNumber(id, "fingerprint.mtimeMs", value.mtimeMs),
+        size: requireNonNegativeInteger(id, "fingerprint.size", value.size),
+        contentHash: requireString(id, "fingerprint.contentHash", value.contentHash),
+        anchorDeliveryId: requireString(id, "fingerprint.anchorDeliveryId", value.anchorDeliveryId),
+    };
+}
+function parseWakeSources(id, value) {
+    if (!Array.isArray(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has invalid wakeSources`);
+    return value.map((candidate) => {
+        if (!isRecord(candidate))
+            throw new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source`);
+        const source = candidate.source;
+        if (typeof source !== "string" || !isWakeSourceKind(source)) {
+            throw new InvalidLoopStoreError(`loop entry ${id} has an unknown wake source kind`);
+        }
+        const description = candidate.description;
+        if (description !== undefined && typeof description !== "string") {
+            throw new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source description`);
+        }
+        return {
+            source,
+            id: requireString(id, "wakeSource.id", candidate.id),
+            createdAt: requireEpochMs(id, "wakeSource.createdAt", candidate.createdAt),
+            ...(description === undefined ? {} : { description }),
+        };
+    });
+}
+function parsePendingWakeup(id, value) {
+    if (value === null || value === undefined)
+        return null;
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup`);
+    const source = value.source;
+    if (source !== "model" && source !== "keepalive") {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup source`);
+    }
+    if (value.kind !== "dynamic")
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup kind`);
+    return {
+        id: requireString(id, "pendingWakeup.id", value.id),
+        loopId: requireString(id, "pendingWakeup.loopId", value.loopId),
+        kind: "dynamic",
+        source,
+        requestedDelaySeconds: requireFiniteNumber(id, "pendingWakeup.requestedDelaySeconds", value.requestedDelaySeconds),
+        delaySeconds: requirePositiveInteger(id, "pendingWakeup.delaySeconds", value.delaySeconds),
+        dueAt: requireEpochMs(id, "pendingWakeup.dueAt", value.dueAt),
+        reason: requireString(id, "pendingWakeup.reason", value.reason),
+        prompt: requireString(id, "pendingWakeup.prompt", value.prompt),
+        noop: requireBoolean(id, "pendingWakeup.noop", value.noop),
+        createdAt: requireEpochMs(id, "pendingWakeup.createdAt", value.createdAt),
+    };
+}
+function parseRequestedInterval(id, value) {
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval`);
+    const unit = value.unit;
+    if (typeof unit !== "string" || !isRequestedIntervalUnit(unit)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval unit`);
+    }
+    return {
+        value: requirePositiveInteger(id, "requestedInterval.value", value.value),
+        unit,
+        raw: requireString(id, "requestedInterval.raw", value.raw),
+    };
+}
+function parseEffectiveInterval(id, value) {
+    if (!isRecord(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval`);
+    const unit = value.unit;
+    if (typeof unit !== "string" || !isEffectiveIntervalUnit(unit)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval unit`);
+    }
+    const roundingNotice = value.roundingNotice;
+    if (roundingNotice !== undefined && typeof roundingNotice !== "string") {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval roundingNotice`);
+    }
+    return {
+        value: requirePositiveInteger(id, "effectiveInterval.value", value.value),
+        unit,
+        human: requireString(id, "effectiveInterval.human", value.human),
+        rounded: requireBoolean(id, "effectiveInterval.rounded", value.rounded),
+        ...(roundingNotice === undefined ? {} : { roundingNotice }),
+    };
+}
+function requireString(id, field, value, options) {
+    if (typeof value !== "string" || (options?.allowEmpty !== true && value.length === 0)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    }
+    return value;
+}
+function requireBoolean(id, field, value) {
+    if (typeof value !== "boolean")
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    return value;
+}
+function requireFiniteNumber(id, field, value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    }
+    return value;
+}
+function requireNonNegativeInteger(id, field, value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    }
+    return value;
+}
+function requirePositiveInteger(id, field, value) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    }
+    return value;
+}
+function requireEpochMs(id, field, value) {
+    if (!isEpochMs(value))
+        throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);
+    return value;
+}
+function parseNullableEpochMs(id, field, value) {
+    if (value === null || value === undefined)
+        return null;
+    return requireEpochMs(id, field, value);
+}
+function isEpochMs(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function isLoopPhase(value) {
+    return LOOP_PHASES.includes(value);
+}
+function isLoopEndReason(value) {
+    return LOOP_END_REASONS.includes(value);
+}
+function isLoopSentinel(value) {
+    return LOOP_SENTINELS.includes(value);
+}
+function isWakeSourceKind(value) {
+    return LOOP_WAKE_SOURCE_KINDS.includes(value);
+}
+function isRequestedIntervalUnit(value) {
+    return REQUESTED_INTERVAL_UNITS.includes(value);
+}
+function isEffectiveIntervalUnit(value) {
+    return EFFECTIVE_INTERVAL_UNITS.includes(value);
+}
+function isFileSystemError(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+//# sourceMappingURL=store.js.map

package/dist/core/extensions/builtin/loop/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Atomic, versioned, per-session sidecar store for `/loop` state.\n *\n * Mirrors the goal store's persistence discipline (temp file + rename, per-file mutation\n * serialization, strict versioned parsing) because scheduler state must never be half\n * written or silently reset: a corrupt file arms nothing and surfaces a typed error so\n * the extension can end affected loops with `error` instead of guessing.\n *\n * Session custom entries are deliberately NOT the authoritative store: they are branch\n * nodes, so a globally scanned \"latest\" entry can come from an abandoned branch, while\n * loop schedules are session-scoped.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport {\n\ttype CronEntry,\n\ttype DynamicCronEntry,\n\tEFFECTIVE_INTERVAL_UNITS,\n\ttype EffectiveInterval,\n\ttype EffectiveIntervalUnit,\n\ttype EpochMs,\n\ttype FixedCronEntry,\n\tisRecord,\n\tLOOP_END_REASONS,\n\tLOOP_PHASES,\n\tLOOP_SENTINELS,\n\tLOOP_STATE_VERSION,\n\tLOOP_WAKE_SOURCE_KINDS,\n\ttype LoopEndReason,\n\ttype LoopEntryFields,\n\ttype LoopFileFingerprint,\n\ttype LoopLifecycle,\n\ttype LoopPayload,\n\ttype LoopPhase,\n\ttype LoopSentinel,\n\ttype LoopState,\n\ttype LoopStoreRef,\n\ttype LoopWakeSource,\n\ttype LoopWakeSourceKind,\n\ttype PendingWakeup,\n\tREQUESTED_INTERVAL_UNITS,\n\ttype RequestedInterval,\n\ttype RequestedIntervalUnit,\n\ttype SentinelDeliveryState,\n} from \"./types.ts\";\n\nexport class InvalidLoopStoreError extends Error {\n\tconstructor(message: string, options?: { cause?: unknown }) {\n\t\tsuper(message, options);\n\t\tthis.name = \"InvalidLoopStoreError\";\n\t}\n}\n\nexport class UnsupportedLoopStoreVersionError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"UnsupportedLoopStoreVersionError\";\n\t}\n}\n\n/** Mutation callback. May be async; its result becomes the next persisted state. */\nexport type LoopStateMutation = (current: LoopState) => LoopState | Promise<LoopState>;\n\nconst mutationTails = new Map<string, Promise<void>>();\nconst snapshots = new Map<string, LoopState>();\n\nexport function encodedSessionId(ref: LoopStoreRef): string {\n\treturn encodeURIComponent(ref.sessionId);\n}\n\nexport function loopStateFilePath(ref: LoopStoreRef): string {\n\treturn join(ref.baseDir, `${encodedSessionId(ref)}.json`);\n}\n\nexport function emptyLoopState(sessionId: string): LoopState {\n\treturn { version: LOOP_STATE_VERSION, sessionId, entries: {}, activeDynamicId: null, updatedAt: 0 };\n}\n\n/**\n * Reads persisted state, or null when this session has never persisted any loop.\n * Throws {@link InvalidLoopStoreError} / {@link UnsupportedLoopStoreVersionError} on\n * unusable state so callers fail closed rather than resetting a user's schedule.\n */\nexport async function readLoopState(ref: LoopStoreRef): Promise<LoopState | null> {\n\tlet raw: string;\n\ttry {\n\t\traw = await readFile(loopStateFilePath(ref), \"utf8\");\n\t} catch (error) {\n\t\tif (isFileSystemError(error, \"ENOENT\")) return null;\n\t\tthrow error;\n\t}\n\tconst state = parseLoopState(raw, ref);\n\tsnapshots.set(loopStateFilePath(ref), state);\n\treturn state;\n}\n\n/** Like {@link readLoopState}, but returns an empty state when nothing is persisted. */\nexport async function loadLoopState(ref: LoopStoreRef): Promise<LoopState> {\n\treturn (await readLoopState(ref)) ?? emptyLoopState(ref.sessionId);\n}\n\n/**\n * Last successfully loaded or written state for this ref, for synchronous consumers\n * (status line, tick attribution). Undefined until the store has been touched.\n */\nexport function snapshotLoopState(ref: LoopStoreRef): LoopState | undefined {\n\treturn snapshots.get(loopStateFilePath(ref));\n}\n\n/**\n * Serializes read-modify-write cycles through a per-file promise tail so command,\n * timer, tool, and lifecycle writes cannot interleave and lose an update.\n */\nexport function mutateLoopState(ref: LoopStoreRef, mutation: LoopStateMutation): Promise<LoopState> {\n\treturn enqueue(ref, async () => {\n\t\tconst current = await loadLoopState(ref);\n\t\tconst next = await mutation(current);\n\t\tawait writeLoopState(ref, next);\n\t\treturn next;\n\t});\n}\n\n/** Persists a complete state atomically. Prefer {@link mutateLoopState} for updates. */\nexport async function writeLoopState(ref: LoopStoreRef, state: LoopState): Promise<void> {\n\tconst filePath = loopStateFilePath(ref);\n\tawait mkdir(dirname(filePath), { recursive: true });\n\tawait writeAtomic(filePath, `${JSON.stringify(state, null, 2)}\\n`);\n\tsnapshots.set(filePath, state);\n}\n\n/** Drops cached snapshots; used when a session ends or tests reset global state. */\nexport function clearLoopStateSnapshot(ref: LoopStoreRef): void {\n\tsnapshots.delete(loopStateFilePath(ref));\n}\n\nfunction enqueue<T>(ref: LoopStoreRef, operation: () => Promise<T>): Promise<T> {\n\tconst key = loopStateFilePath(ref);\n\tconst previous = mutationTails.get(key) ?? Promise.resolve();\n\tconst run = previous.then(operation);\n\tconst tail = run.then(\n\t\t() => undefined,\n\t\t() => undefined,\n\t);\n\tmutationTails.set(key, tail);\n\tvoid tail.then(() => {\n\t\tif (mutationTails.get(key) === tail) mutationTails.delete(key);\n\t});\n\treturn run;\n}\n\nasync function writeAtomic(filePath: string, contents: string): Promise<void> {\n\tconst tempPath = join(dirname(filePath), `.loop-${randomUUID()}.tmp`);\n\ttry {\n\t\tawait writeFile(tempPath, contents, { encoding: \"utf8\", mode: 0o600 });\n\t\tawait rename(tempPath, filePath);\n\t} catch (error) {\n\t\ttry {\n\t\t\tawait rm(tempPath, { force: true });\n\t\t} catch (cleanupError) {\n\t\t\tthrow new AggregateError(\n\t\t\t\t[error, cleanupError],\n\t\t\t\t\"loop store write failed and its temporary file could not be removed\",\n\t\t\t);\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction parseLoopState(raw: string, ref: LoopStoreRef): LoopState {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch (error) {\n\t\tthrow new InvalidLoopStoreError(\"loop store contains unparseable JSON\", { cause: error });\n\t}\n\tif (!isRecord(parsed)) throw new InvalidLoopStoreError(\"loop store must be a JSON object\");\n\tif (parsed.version !== LOOP_STATE_VERSION) {\n\t\tthrow new UnsupportedLoopStoreVersionError(\n\t\t\t`unsupported loop store version: ${JSON.stringify(parsed.version)} (expected ${LOOP_STATE_VERSION})`,\n\t\t);\n\t}\n\tif (typeof parsed.sessionId !== \"string\" || parsed.sessionId.length === 0) {\n\t\tthrow new InvalidLoopStoreError(\"loop store is missing a sessionId\");\n\t}\n\tif (parsed.sessionId !== ref.sessionId) {\n\t\tthrow new InvalidLoopStoreError(\n\t\t\t`loop store sessionId ${parsed.sessionId} does not match the session it was loaded for`,\n\t\t);\n\t}\n\tif (!isEpochMs(parsed.updatedAt)) throw new InvalidLoopStoreError(\"loop store has an invalid updatedAt\");\n\tif (!isRecord(parsed.entries)) throw new InvalidLoopStoreError(\"loop store entries must be an object\");\n\n\tconst entries: Record<string, CronEntry> = {};\n\tfor (const [id, value] of Object.entries(parsed.entries)) {\n\t\tconst entry = parseEntry(id, value);\n\t\tentries[id] = entry;\n\t}\n\n\tconst activeDynamicId = parsed.activeDynamicId;\n\tif (activeDynamicId !== null) {\n\t\tif (typeof activeDynamicId !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(\"loop store activeDynamicId must be a string or null\");\n\t\t}\n\t\tconst active = entries[activeDynamicId];\n\t\tif (active === undefined || active.kind !== \"dynamic\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop store activeDynamicId ${activeDynamicId} does not name a dynamic loop`);\n\t\t}\n\t}\n\n\treturn {\n\t\tversion: LOOP_STATE_VERSION,\n\t\tsessionId: parsed.sessionId,\n\t\tentries,\n\t\tactiveDynamicId,\n\t\tupdatedAt: parsed.updatedAt,\n\t};\n}\n\nfunction parseEntry(id: string, value: unknown): CronEntry {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} is not an object`);\n\tif (value.id !== id) throw new InvalidLoopStoreError(`loop entry ${id} carries a mismatched id`);\n\tconst kind = value.kind;\n\tif (kind !== \"fixed\" && kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an unknown kind`);\n\n\tconst base = parseEntryFields(id, value);\n\tif (kind === \"fixed\") {\n\t\tconst fixed: FixedCronEntry = {\n\t\t\t...base,\n\t\t\tkind: \"fixed\",\n\t\t\trequestedInterval: parseRequestedInterval(id, value.requestedInterval),\n\t\t\teffectiveInterval: parseEffectiveInterval(id, value.effectiveInterval),\n\t\t\tcronExpression: requireString(id, \"cronExpression\", value.cronExpression),\n\t\t\tnextFireAt: requireEpochMs(id, \"nextFireAt\", value.nextFireAt),\n\t\t\tintervalMs: requirePositiveInteger(id, \"intervalMs\", value.intervalMs),\n\t\t};\n\t\treturn fixed;\n\t}\n\n\tconst keepaliveCredit = value.keepaliveCredit;\n\tif (keepaliveCredit !== 0 && keepaliveCredit !== 1) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid keepaliveCredit`);\n\t}\n\tconst dynamic: DynamicCronEntry = {\n\t\t...base,\n\t\tkind: \"dynamic\",\n\t\tpendingWakeup: parsePendingWakeup(id, value.pendingWakeup),\n\t\tkeepaliveCredit,\n\t};\n\treturn dynamic;\n}\n\nfunction parseEntryFields(id: string, value: Record<string, unknown>): LoopEntryFields & LoopLifecycle {\n\tconst fields = {\n\t\tid,\n\t\toriginalArgs: requireString(id, \"originalArgs\", value.originalArgs, { allowEmpty: true }),\n\t\treentryPrompt: requireString(id, \"reentryPrompt\", value.reentryPrompt),\n\t\tpayload: parsePayload(id, value.payload),\n\t\tcreatedAt: requireEpochMs(id, \"createdAt\", value.createdAt),\n\t\tlastFiredAt: parseNullableEpochMs(id, \"lastFiredAt\", value.lastFiredAt),\n\t\texpiresAt: requireEpochMs(id, \"expiresAt\", value.expiresAt),\n\t\tlastScheduledForAt: parseNullableEpochMs(id, \"lastScheduledForAt\", value.lastScheduledForAt),\n\t\tcoalescedFirePending: requireBoolean(id, \"coalescedFirePending\", value.coalescedFirePending),\n\t\tqueuedForAt: parseNullableEpochMs(id, \"queuedForAt\", value.queuedForAt),\n\t\tnoopStreak: requireNonNegativeInteger(id, \"noopStreak\", value.noopStreak),\n\t\ttickCount: requireNonNegativeInteger(id, \"tickCount\", value.tickCount),\n\t\tsentinelDelivery: parseSentinelDelivery(id, value.sentinelDelivery),\n\t\twakeSources: parseWakeSources(id, value.wakeSources),\n\t};\n\treturn { ...fields, ...parseLifecycle(id, value) };\n}\n\ntype ParsedLifecycle =\n\t| { phase: Exclude<LoopPhase, \"ended\"> }\n\t| { phase: \"ended\"; endedAt: EpochMs; endReason: LoopEndReason; endDetail?: string };\n\nfunction parseLifecycle(id: string, value: Record<string, unknown>): ParsedLifecycle {\n\tconst phase = value.phase;\n\tif (typeof phase !== \"string\" || !isLoopPhase(phase)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid phase`);\n\t}\n\tif (phase !== \"ended\") {\n\t\tif (value.endedAt !== undefined || value.endReason !== undefined || value.endDetail !== undefined) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} carries terminal fields while not ended`);\n\t\t}\n\t\treturn { phase };\n\t}\n\tconst endReason = value.endReason;\n\tif (typeof endReason !== \"string\" || !isLoopEndReason(endReason)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endReason`);\n\t}\n\tconst endDetail = value.endDetail;\n\tif (endDetail !== undefined && typeof endDetail !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid endDetail`);\n\t}\n\treturn {\n\t\tphase: \"ended\",\n\t\tendedAt: requireEpochMs(id, \"endedAt\", value.endedAt),\n\t\tendReason,\n\t\t...(endDetail === undefined ? {} : { endDetail }),\n\t};\n}\n\nfunction parsePayload(id: string, value: unknown): LoopPayload {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid payload`);\n\tif (value.type === \"prompt\") {\n\t\treturn { type: \"prompt\", prompt: requireString(id, \"payload.prompt\", value.prompt) };\n\t}\n\tif (value.type === \"sentinel\") {\n\t\tconst sentinel = value.sentinel;\n\t\tif (typeof sentinel !== \"string\" || !isLoopSentinel(sentinel)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload sentinel`);\n\t\t}\n\t\treturn { type: \"sentinel\", sentinel };\n\t}\n\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown payload type`);\n}\n\nfunction parseSentinelDelivery(id: string, value: unknown): SentinelDeliveryState {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid sentinelDelivery`);\n\treturn {\n\t\tautonomousPreambleDelivered: requireBoolean(\n\t\t\tid,\n\t\t\t\"sentinelDelivery.autonomousPreambleDelivered\",\n\t\t\tvalue.autonomousPreambleDelivered,\n\t\t),\n\t\tlastLoopFileDelivered: parseFingerprint(id, value.lastLoopFileDelivered),\n\t\tforceFullDelivery: requireBoolean(id, \"sentinelDelivery.forceFullDelivery\", value.forceFullDelivery),\n\t};\n}\n\nfunction parseFingerprint(id: string, value: unknown): LoopFileFingerprint | null {\n\tif (value === null) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid loop-file fingerprint`);\n\treturn {\n\t\tpath: requireString(id, \"fingerprint.path\", value.path),\n\t\tmtimeMs: requireFiniteNumber(id, \"fingerprint.mtimeMs\", value.mtimeMs),\n\t\tsize: requireNonNegativeInteger(id, \"fingerprint.size\", value.size),\n\t\tcontentHash: requireString(id, \"fingerprint.contentHash\", value.contentHash),\n\t\tanchorDeliveryId: requireString(id, \"fingerprint.anchorDeliveryId\", value.anchorDeliveryId),\n\t};\n}\n\nfunction parseWakeSources(id: string, value: unknown): readonly LoopWakeSource[] {\n\tif (!Array.isArray(value)) throw new InvalidLoopStoreError(`loop entry ${id} has invalid wakeSources`);\n\treturn value.map((candidate): LoopWakeSource => {\n\t\tif (!isRecord(candidate)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source`);\n\t\tconst source = candidate.source;\n\t\tif (typeof source !== \"string\" || !isWakeSourceKind(source)) {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an unknown wake source kind`);\n\t\t}\n\t\tconst description = candidate.description;\n\t\tif (description !== undefined && typeof description !== \"string\") {\n\t\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid wake source description`);\n\t\t}\n\t\treturn {\n\t\t\tsource,\n\t\t\tid: requireString(id, \"wakeSource.id\", candidate.id),\n\t\t\tcreatedAt: requireEpochMs(id, \"wakeSource.createdAt\", candidate.createdAt),\n\t\t\t...(description === undefined ? {} : { description }),\n\t\t};\n\t});\n}\n\nfunction parsePendingWakeup(id: string, value: unknown): PendingWakeup | null {\n\tif (value === null || value === undefined) return null;\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup`);\n\tconst source = value.source;\n\tif (source !== \"model\" && source !== \"keepalive\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup source`);\n\t}\n\tif (value.kind !== \"dynamic\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid pendingWakeup kind`);\n\treturn {\n\t\tid: requireString(id, \"pendingWakeup.id\", value.id),\n\t\tloopId: requireString(id, \"pendingWakeup.loopId\", value.loopId),\n\t\tkind: \"dynamic\",\n\t\tsource,\n\t\trequestedDelaySeconds: requireFiniteNumber(\n\t\t\tid,\n\t\t\t\"pendingWakeup.requestedDelaySeconds\",\n\t\t\tvalue.requestedDelaySeconds,\n\t\t),\n\t\tdelaySeconds: requirePositiveInteger(id, \"pendingWakeup.delaySeconds\", value.delaySeconds),\n\t\tdueAt: requireEpochMs(id, \"pendingWakeup.dueAt\", value.dueAt),\n\t\treason: requireString(id, \"pendingWakeup.reason\", value.reason),\n\t\tprompt: requireString(id, \"pendingWakeup.prompt\", value.prompt),\n\t\tnoop: requireBoolean(id, \"pendingWakeup.noop\", value.noop),\n\t\tcreatedAt: requireEpochMs(id, \"pendingWakeup.createdAt\", value.createdAt),\n\t};\n}\n\nfunction parseRequestedInterval(id: string, value: unknown): RequestedInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isRequestedIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid requestedInterval unit`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"requestedInterval.value\", value.value),\n\t\tunit,\n\t\traw: requireString(id, \"requestedInterval.raw\", value.raw),\n\t};\n}\n\nfunction parseEffectiveInterval(id: string, value: unknown): EffectiveInterval {\n\tif (!isRecord(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval`);\n\tconst unit = value.unit;\n\tif (typeof unit !== \"string\" || !isEffectiveIntervalUnit(unit)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval unit`);\n\t}\n\tconst roundingNotice = value.roundingNotice;\n\tif (roundingNotice !== undefined && typeof roundingNotice !== \"string\") {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid effectiveInterval roundingNotice`);\n\t}\n\treturn {\n\t\tvalue: requirePositiveInteger(id, \"effectiveInterval.value\", value.value),\n\t\tunit,\n\t\thuman: requireString(id, \"effectiveInterval.human\", value.human),\n\t\trounded: requireBoolean(id, \"effectiveInterval.rounded\", value.rounded),\n\t\t...(roundingNotice === undefined ? {} : { roundingNotice }),\n\t};\n}\n\nfunction requireString(id: string, field: string, value: unknown, options?: { allowEmpty?: boolean }): string {\n\tif (typeof value !== \"string\" || (options?.allowEmpty !== true && value.length === 0)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireBoolean(id: string, field: string, value: unknown): boolean {\n\tif (typeof value !== \"boolean\") throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction requireFiniteNumber(id: string, field: string, value: unknown): number {\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value;\n}\n\nfunction requireNonNegativeInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) < 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requirePositiveInteger(id: string, field: string, value: unknown): number {\n\tif (!Number.isSafeInteger(value) || (value as number) <= 0) {\n\t\tthrow new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\t}\n\treturn value as number;\n}\n\nfunction requireEpochMs(id: string, field: string, value: unknown): EpochMs {\n\tif (!isEpochMs(value)) throw new InvalidLoopStoreError(`loop entry ${id} has an invalid ${field}`);\n\treturn value;\n}\n\nfunction parseNullableEpochMs(id: string, field: string, value: unknown): EpochMs | null {\n\tif (value === null || value === undefined) return null;\n\treturn requireEpochMs(id, field, value);\n}\n\nfunction isEpochMs(value: unknown): value is EpochMs {\n\treturn Number.isSafeInteger(value) && (value as number) >= 0;\n}\n\nfunction isLoopPhase(value: string): value is LoopPhase {\n\treturn (LOOP_PHASES as readonly string[]).includes(value);\n}\n\nfunction isLoopEndReason(value: string): value is LoopEndReason {\n\treturn (LOOP_END_REASONS as readonly string[]).includes(value);\n}\n\nfunction isLoopSentinel(value: string): value is LoopSentinel {\n\treturn (LOOP_SENTINELS as readonly string[]).includes(value);\n}\n\nfunction isWakeSourceKind(value: string): value is LoopWakeSourceKind {\n\treturn (LOOP_WAKE_SOURCE_KINDS as readonly string[]).includes(value);\n}\n\nfunction isRequestedIntervalUnit(value: string): value is RequestedIntervalUnit {\n\treturn (REQUESTED_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n\nfunction isEffectiveIntervalUnit(value: string): value is EffectiveIntervalUnit {\n\treturn (EFFECTIVE_INTERVAL_UNITS as readonly string[]).includes(value);\n}\n\nfunction isFileSystemError(error: unknown, code: string): boolean {\n\treturn error instanceof Error && \"code\" in error && error.code === code;\n}\n"]}

package/dist/core/extensions/builtin/loop/tick-prompt.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Tick-prompt templates with cache-friendly sentinel expansion.
+ *
+ * `buildTickMessage` is pure: it reads no files, touches no clock, and mutates nothing.
+ * The caller resolves the loop file (see `loopfile.ts`) and hands the snapshot in; this
+ * module decides full-vs-reminder delivery, renders the tick text, and returns the
+ * updated sentinel delivery state to persist.
+ *
+ * Cache discipline: the long instruction blocks are delivered once (the "anchor") and
+ * later ticks send a short reminder that points back at that anchored message, so the
+ * cached message prefix stays stable across fires.
+ */
+import type { DeliveryId, LoopFileFingerprint, LoopId, LoopPayload, LoopSentinel, SentinelDeliveryState } from "./types.ts";
+export type LoopMode = "fixed" | "dynamic";
+/** `prompt` covers a verbatim user prompt; sentinels alternate between full and reminder. */
+export type TickDelivery = "full" | "reminder" | "prompt";
+/** Resolved loop-file state for this fire, produced by the caller's loop-file reader. */
+export type LoopFileSnapshot = {
+    readonly present: false;
+} | {
+    readonly present: true;
+    readonly path: string;
+    /** Model-visible (already truncated) representation. */
+    readonly content: string;
+    readonly mtimeMs: number;
+    readonly size: number;
+    /** SHA-256 of the model-visible representation. */
+    readonly contentHash: string;
+};
+export interface TickPromptInput {
+    readonly loopId: LoopId;
+    readonly deliveryId: DeliveryId;
+    readonly mode: LoopMode;
+    readonly payload: LoopPayload;
+    /** Canonical re-entry text, e.g. `/loop check the deploy` or `/loop`. */
+    readonly reentryPrompt: string;
+    readonly deliveryState: SentinelDeliveryState;
+    readonly loopFile: LoopFileSnapshot;
+}
+export interface LoopTickDetails {
+    readonly loopId: LoopId;
+    readonly deliveryId: DeliveryId;
+    readonly mode: LoopMode;
+    readonly delivery: TickDelivery;
+    readonly sentinel?: LoopSentinel;
+    readonly loopFile?: LoopFileFingerprint;
+}
+export interface TickPromptResult {
+    readonly text: string;
+    readonly delivery: TickDelivery;
+    readonly details: LoopTickDetails;
+    /** Delivery state to persist after this tick is dispatched. */
+    readonly deliveryState: SentinelDeliveryState;
+}
+/**
+ * Render one tick message plus the delivery state to persist afterwards.
+ *
+ * Full delivery happens on the first sentinel delivery, when `forceFullDelivery` is set
+ * (accepted compaction or a missing anchor on resume), when the loop file's fingerprint
+ * changed, or when the file reappeared after absence. Otherwise the tick is a short
+ * reminder anchored to the last full message.
+ */
+export declare function buildTickMessage(input: TickPromptInput): TickPromptResult;
+//# sourceMappingURL=tick-prompt.d.ts.map

package/dist/core/extensions/builtin/loop/tick-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick-prompt.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/loop/tick-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,mBAAmB,EACnB,MAAM,EACN,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,6FAA6F;AAC7F,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1D,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GACzB;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAC3B;IACA,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEL,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;CAC9C;AA4LD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CASzE"}