@namzu/sdk 30.2.0 → 31.0.0

package/dist/store/goal/index.js

@@ -0,0 +1,436 @@
+import { join } from 'node:path';
+import { TenantIsolationError } from '../../session/errors.js';
+import { asGoalId, asSessionId, generateGoalId } from '../../utils/id.js';
+import { DiskRevisionRecordStore, revisionFileSegment, } from '../kv/revision-record-store.js';
+import { defineSchema } from '../schema.js';
+/** Current source-backed limit for a human goal objective. */
+export const MAX_GOAL_OBJECTIVE_CHARS = 4_000;
+/** Source-aligned default; hosts may choose a smaller positive finite cap. */
+export const DEFAULT_MAX_GOAL_ROUNDS = 256;
+/** A mutation was based on a goal revision that is no longer current. */
+export class StaleGoalError extends Error {
+    details;
+    constructor(details) {
+        super(`Stale goal for ${details.sessionId}: expected revision=${details.expectedRevision}, actual=${details.actualRevision}.`);
+        this.name = 'StaleGoalError';
+        this.details = details;
+    }
+}
+/** A session already has a goal that has not completed or been cleared. */
+export class GoalExistsError extends Error {
+    goal;
+    constructor(goal) {
+        super(`Session ${goal.sessionId} already has an ${goal.phase} goal.`);
+        this.goal = goal;
+        this.name = 'GoalExistsError';
+    }
+}
+/** A goal operation was requested for a session with no current goal. */
+export class GoalNotFoundError extends Error {
+    sessionId;
+    constructor(sessionId) {
+        super(`Session ${sessionId} has no current goal.`);
+        this.sessionId = sessionId;
+        this.name = 'GoalNotFoundError';
+    }
+}
+/** A goal transition is invalid from its current durable phase. */
+export class GoalTransitionError extends Error {
+    phase;
+    operation;
+    constructor(phase, operation) {
+        super(`Cannot ${operation} a goal whose phase is ${phase}.`);
+        this.phase = phase;
+        this.operation = operation;
+        this.name = 'GoalTransitionError';
+    }
+}
+/** Goal storage refuses ids that do not name a live tenant-owned Session. */
+export class GoalSessionNotFoundError extends Error {
+    sessionId;
+    constructor(sessionId) {
+        super(`Cannot use a goal for ${sessionId}: that session does not exist.`);
+        this.sessionId = sessionId;
+        this.name = 'GoalSessionNotFoundError';
+    }
+}
+/** Admission reached its finite cap after durably blocking the goal. */
+export class GoalRoundLimitError extends Error {
+    goal;
+    constructor(goal) {
+        super(`Goal ${goal.id} has admitted all ${goal.maxGoalRounds} automatic rounds.`);
+        this.goal = goal;
+        this.name = 'GoalRoundLimitError';
+    }
+}
+const SCHEMA = defineSchema({
+    kind: 'session-goal',
+    current: 2,
+    migrations: {
+        1: (record) => {
+            const goal = record.goal;
+            if (goal === null || typeof goal !== 'object' || Array.isArray(goal))
+                return record;
+            return {
+                ...record,
+                goal: {
+                    ...goal,
+                    maxGoalRounds: DEFAULT_MAX_GOAL_ROUNDS,
+                    roundsAdmitted: 0,
+                },
+            };
+        },
+    },
+});
+const revisionRecords = new DiskRevisionRecordStore(SCHEMA, 'session goal store', (record) => record.storageRevision);
+const backends = new WeakMap();
+function backendFor(store) {
+    const backend = backends.get(store);
+    if (!backend)
+        throw new Error('Session goal store backend was not initialized.');
+    return backend;
+}
+function validSessionId(value) {
+    if (typeof value !== 'string')
+        throw new TypeError('sessionId must be a string.');
+    return asSessionId(value);
+}
+function validRef(ref) {
+    if (typeof ref.id !== 'string')
+        throw new TypeError('goal id must be a string.');
+    const id = asGoalId(ref.id);
+    if (!Number.isSafeInteger(ref.revision) || ref.revision < 1) {
+        throw new TypeError(`goal revision must be a positive safe integer, got ${ref.revision}.`);
+    }
+    return { id, revision: ref.revision };
+}
+function objective(value) {
+    if (typeof value !== 'string')
+        throw new TypeError('goal objective must be a string.');
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        throw new TypeError('goal objective must not be empty.');
+    if ([...trimmed].length > MAX_GOAL_OBJECTIVE_CHARS) {
+        throw new TypeError(`goal objective must be at most ${MAX_GOAL_OBJECTIVE_CHARS} characters.`);
+    }
+    return trimmed;
+}
+function maxGoalRounds(value) {
+    const resolved = value ?? DEFAULT_MAX_GOAL_ROUNDS;
+    if (!Number.isSafeInteger(resolved) || resolved < 1) {
+        throw new TypeError(`maxGoalRounds must be a positive safe integer, got ${resolved}.`);
+    }
+    return resolved;
+}
+function blockReason(value) {
+    if (typeof value?.code !== 'string' ||
+        !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u.test(value.code) ||
+        typeof value?.message !== 'string' ||
+        value.message.trim().length === 0) {
+        throw new TypeError('goal block reason requires a lower-kebab-case code and a non-empty message.');
+    }
+    return { code: value.code, message: value.message.trim() };
+}
+function assertTenant(record, tenantId) {
+    if (record.tenantId !== tenantId) {
+        throw new TenantIsolationError({
+            requested: tenantId,
+            resource: `session-goal(${record.sessionId})`,
+        });
+    }
+}
+function currentGoal(record, sessionId, tenantId, ref) {
+    if (!record)
+        throw new GoalNotFoundError(sessionId);
+    assertTenant(record, tenantId);
+    if (record.sessionId !== sessionId)
+        throw new Error('Session goal storage key mismatch.');
+    const goal = record.goal;
+    if (!goal)
+        throw new GoalNotFoundError(sessionId);
+    if (goal.id !== ref.id || goal.revision !== ref.revision) {
+        throw new StaleGoalError({
+            sessionId,
+            expectedRevision: ref.revision,
+            actualRevision: goal.revision,
+        });
+    }
+    return goal;
+}
+class SessionGoalStoreBase {
+    sessions;
+    now;
+    makeGoalId;
+    constructor(sessions, now, makeGoalId) {
+        this.sessions = sessions;
+        this.now = now;
+        this.makeGoalId = makeGoalId;
+    }
+    async requireSession(sessionId, tenantId) {
+        const checked = validSessionId(sessionId);
+        if (!(await this.sessions.getSession(checked, tenantId))) {
+            throw new GoalSessionNotFoundError(checked);
+        }
+        return checked;
+    }
+    async getGoal(sessionId, tenantId) {
+        const checked = await this.requireSession(sessionId, tenantId);
+        const record = await backendFor(this).read(checked);
+        if (!record)
+            return null;
+        assertTenant(record, tenantId);
+        if (record.sessionId !== checked)
+            throw new Error('Session goal storage key mismatch.');
+        return record.goal;
+    }
+    async createGoal(params, tenantId) {
+        const sessionId = await this.requireSession(params.sessionId, tenantId);
+        const text = objective(params.objective);
+        const maxRounds = maxGoalRounds(params.maxGoalRounds);
+        return await backendFor(this).transact(sessionId, (existing) => {
+            if (existing) {
+                assertTenant(existing, tenantId);
+                if (existing.goal && existing.goal.phase !== 'complete') {
+                    throw new GoalExistsError(existing.goal);
+                }
+            }
+            const now = this.now();
+            const goal = {
+                id: this.makeGoalId(),
+                sessionId,
+                tenantId,
+                revision: 1,
+                objective: text,
+                phase: 'active',
+                maxGoalRounds: maxRounds,
+                roundsAdmitted: 0,
+                createdAt: now,
+                updatedAt: now,
+            };
+            const record = {
+                sessionId,
+                tenantId,
+                storageRevision: (existing?.storageRevision ?? 0) + 1,
+                goal,
+                updatedAt: now,
+            };
+            return { record, result: goal };
+        });
+    }
+    async editGoal(sessionId, tenantId, ref, changes) {
+        const checked = await this.requireSession(sessionId, tenantId);
+        const expected = validRef(ref);
+        const nextObjective = objective(changes.objective);
+        return await this.mutate(checked, tenantId, expected, (goal) => {
+            if (goal.phase === 'complete')
+                throw new GoalTransitionError(goal.phase, 'edit');
+            return {
+                ...goal,
+                objective: nextObjective,
+            };
+        });
+    }
+    async pauseGoal(sessionId, tenantId, ref) {
+        return await this.transition(sessionId, tenantId, ref, 'pause', ['active'], 'paused');
+    }
+    async resumeGoal(sessionId, tenantId, ref) {
+        return await this.transition(sessionId, tenantId, ref, 'resume', ['paused', 'blocked'], 'active');
+    }
+    async admitRound(sessionId, tenantId, ref) {
+        const checked = await this.requireSession(sessionId, tenantId);
+        const expected = validRef(ref);
+        const outcome = await backendFor(this).transact(checked, (existing) => {
+            const goal = currentGoal(existing, checked, tenantId, expected);
+            if (goal.phase !== 'active')
+                throw new GoalTransitionError(goal.phase, 'admit a round for');
+            const now = this.now();
+            if (goal.roundsAdmitted >= goal.maxGoalRounds) {
+                const blocked = {
+                    ...goal,
+                    revision: goal.revision + 1,
+                    phase: 'blocked',
+                    blockedReason: {
+                        code: 'round-limit',
+                        message: `Reached the ${goal.maxGoalRounds}-round limit.`,
+                    },
+                    updatedAt: now,
+                };
+                return {
+                    record: {
+                        sessionId: checked,
+                        tenantId,
+                        storageRevision: (existing?.storageRevision ?? 0) + 1,
+                        goal: blocked,
+                        updatedAt: now,
+                    },
+                    result: { kind: 'exhausted', goal: blocked },
+                };
+            }
+            const admitted = {
+                ...goal,
+                revision: goal.revision + 1,
+                roundsAdmitted: goal.roundsAdmitted + 1,
+                updatedAt: now,
+            };
+            const authority = {
+                id: admitted.id,
+                revision: admitted.revision,
+                sessionId: admitted.sessionId,
+                tenantId: admitted.tenantId,
+                objective: admitted.objective,
+                round: admitted.roundsAdmitted,
+                maxGoalRounds: admitted.maxGoalRounds,
+            };
+            return {
+                record: {
+                    sessionId: checked,
+                    tenantId,
+                    storageRevision: (existing?.storageRevision ?? 0) + 1,
+                    goal: admitted,
+                    updatedAt: now,
+                },
+                result: { kind: 'admitted', authority },
+            };
+        });
+        if (outcome.kind === 'exhausted')
+            throw new GoalRoundLimitError(outcome.goal);
+        return outcome.authority;
+    }
+    async completeGoal(sessionId, tenantId, ref) {
+        return await this.transition(sessionId, tenantId, ref, 'complete', ['active', 'paused', 'blocked'], 'complete');
+    }
+    async blockGoal(sessionId, tenantId, ref, reason) {
+        const validated = blockReason(reason);
+        const checked = await this.requireSession(sessionId, tenantId);
+        const expected = validRef(ref);
+        return await this.mutate(checked, tenantId, expected, (goal) => {
+            if (goal.phase !== 'active')
+                throw new GoalTransitionError(goal.phase, 'block');
+            return { ...goal, phase: 'blocked', blockedReason: validated };
+        });
+    }
+    async clearGoal(sessionId, tenantId, ref) {
+        const checked = await this.requireSession(sessionId, tenantId);
+        const expected = validRef(ref);
+        await backendFor(this).transact(checked, (existing) => {
+            currentGoal(existing, checked, tenantId, expected);
+            const now = this.now();
+            return {
+                record: {
+                    sessionId: checked,
+                    tenantId,
+                    storageRevision: (existing?.storageRevision ?? 0) + 1,
+                    goal: null,
+                    updatedAt: now,
+                },
+                result: undefined,
+            };
+        });
+    }
+    async transition(sessionId, tenantId, ref, operation, from, to) {
+        const checked = await this.requireSession(sessionId, tenantId);
+        const expected = validRef(ref);
+        return await this.mutate(checked, tenantId, expected, (goal) => {
+            if (!from.includes(goal.phase))
+                throw new GoalTransitionError(goal.phase, operation);
+            const { blockedReason: _blockedReason, ...rest } = goal;
+            return { ...rest, phase: to };
+        });
+    }
+    async mutate(sessionId, tenantId, ref, change) {
+        return await backendFor(this).transact(sessionId, (existing) => {
+            const goal = currentGoal(existing, sessionId, tenantId, ref);
+            const now = this.now();
+            const updated = {
+                ...change(goal),
+                revision: goal.revision + 1,
+                updatedAt: now,
+            };
+            return {
+                record: {
+                    sessionId,
+                    tenantId,
+                    storageRevision: (existing?.storageRevision ?? 0) + 1,
+                    goal: updated,
+                    updatedAt: now,
+                },
+                result: updated,
+            };
+        });
+    }
+}
+export class InMemorySessionGoalStore extends SessionGoalStoreBase {
+    records = new Map();
+    constructor(config, now = Date.now, makeGoalId = generateGoalId) {
+        super(config.sessions, now, makeGoalId);
+        backends.set(this, {
+            read: async (sessionId) => this.records.get(sessionId) ?? null,
+            transact: async (sessionId, mutate) => {
+                const proposal = mutate(this.records.get(sessionId) ?? null);
+                await this.put(proposal.record);
+                return proposal.result;
+            },
+        });
+    }
+    async put(record) {
+        const existing = this.records.get(record.sessionId);
+        if (existing)
+            assertTenant(existing, record.tenantId);
+        const actual = existing?.storageRevision ?? 0;
+        if (record.storageRevision !== actual + 1) {
+            throw new StaleGoalError({
+                sessionId: record.sessionId,
+                expectedRevision: record.storageRevision - 1,
+                actualRevision: existing?.goal?.revision ?? 0,
+            });
+        }
+        this.records.set(record.sessionId, record);
+    }
+}
+export class DiskSessionGoalStore extends SessionGoalStoreBase {
+    config;
+    constructor(config, now = Date.now, makeGoalId = generateGoalId) {
+        super(config.sessions, now, makeGoalId);
+        this.config = config;
+        backends.set(this, {
+            read: async (sessionId) => await revisionRecords.read(this.location(sessionId)),
+            transact: async (sessionId, mutate) => {
+                const location = this.location(sessionId);
+                const proposal = mutate(await revisionRecords.read(location));
+                try {
+                    await this.put(proposal.record);
+                }
+                catch (error) {
+                    if (error instanceof StaleGoalError)
+                        mutate(await revisionRecords.read(location));
+                    throw error;
+                }
+                return proposal.result;
+            },
+        });
+    }
+    location(sessionId) {
+        const root = join(this.config.rootDir, 'goals');
+        const segment = revisionFileSegment(sessionId);
+        return {
+            legacyPath: join(root, `${segment}.json`),
+            revisionsDir: join(root, '.revisions', segment),
+        };
+    }
+    async put(record) {
+        await revisionRecords.transact(this.location(record.sessionId), (existing) => {
+            if (existing)
+                assertTenant(existing, record.tenantId);
+            const actual = existing?.storageRevision ?? 0;
+            if (record.storageRevision !== actual + 1) {
+                throw new StaleGoalError({
+                    sessionId: record.sessionId,
+                    expectedRevision: record.storageRevision - 1,
+                    actualRevision: existing?.goal?.revision ?? 0,
+                });
+            }
+            return { record, result: undefined };
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/store/goal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/goal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAU9D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,EACN,uBAAuB,EAGvB,mBAAmB,GACnB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAA;AAE7C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAmC1C,yEAAyE;AACzE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC/B,OAAO,CAIf;IAED,YAAY,OAAkC;QAC7C,KAAK,CACJ,kBAAkB,OAAO,CAAC,SAAS,uBAAuB,OAAO,CAAC,gBAAgB,YAAY,OAAO,CAAC,cAAc,GAAG,CACvH,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED,2EAA2E;AAC3E,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACpB;IAArB,YAAqB,IAAiB;QACrC,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,mBAAmB,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAA;QADjD,SAAI,GAAJ,IAAI,CAAa;QAErC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC9B,CAAC;CACD;AAED,yEAAyE;AACzE,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACtB;IAArB,YAAqB,SAAoB;QACxC,KAAK,CAAC,WAAW,SAAS,uBAAuB,CAAC,CAAA;QAD9B,cAAS,GAAT,SAAS,CAAW;QAExC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IAChC,CAAC;CACD;AAED,mEAAmE;AACnE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEnC;IACA;IAFV,YACU,KAAgB,EAChB,SAAiB;QAE1B,KAAK,CAAC,UAAU,SAAS,0BAA0B,KAAK,GAAG,CAAC,CAAA;QAHnD,UAAK,GAAL,KAAK,CAAW;QAChB,cAAS,GAAT,SAAS,CAAQ;QAG1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IAClC,CAAC;CACD;AAED,6EAA6E;AAC7E,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC7B;IAArB,YAAqB,SAAoB;QACxC,KAAK,CAAC,yBAAyB,SAAS,gCAAgC,CAAC,CAAA;QADrD,cAAS,GAAT,SAAS,CAAW;QAExC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACvC,CAAC;CACD;AAED,wEAAwE;AACxE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACxB;IAArB,YAAqB,IAAiB;QACrC,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,qBAAqB,IAAI,CAAC,aAAa,oBAAoB,CAAC,CAAA;QAD7D,SAAI,GAAJ,IAAI,CAAa;QAErC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IAClC,CAAC;CACD;AAWD,MAAM,MAAM,GAAG,YAAY,CAAC;IAC3B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,CAAC;IACV,UAAU,EAAE;QACX,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;YACxB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAA;YACnF,OAAO;gBACN,GAAG,MAAM;gBACT,IAAI,EAAE;oBACL,GAAG,IAAI;oBACP,aAAa,EAAE,uBAAuB;oBACtC,cAAc,EAAE,CAAC;iBACjB;aACD,CAAA;QACF,CAAC;KACD;CACD,CAAC,CAAA;AACF,MAAM,eAAe,GAAG,IAAI,uBAAuB,CAClD,MAAM,EACN,oBAAoB,EACpB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAClC,CAAA;AAUD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuB,CAAA;AAEnD,SAAS,UAAU,CAAC,KAAa;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAChF,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAA;IACjF,OAAO,WAAW,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC7B,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAA;IAChF,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,SAAS,CAAC,sDAAsD,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAA;IAC3F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAA;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAA;IACtF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAA;IAClF,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CAAC,kCAAkC,wBAAwB,cAAc,CAAC,CAAA;IAC9F,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC/C,MAAM,QAAQ,GAAG,KAAK,IAAI,uBAAuB,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,SAAS,CAAC,sDAAsD,QAAQ,GAAG,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAsB;IAC1C,IACC,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ;QAC/B,CAAC,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACpD,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ;QAClC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAChC,CAAC;QACF,MAAM,IAAI,SAAS,CAClB,6EAA6E,CAC7E,CAAA;IACF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAA;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,MAAyB,EAAE,QAAkB;IAClE,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,IAAI,oBAAoB,CAAC;YAC9B,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,gBAAgB,MAAM,CAAC,SAAS,GAAG;SAC7C,CAAC,CAAA;IACH,CAAC;AACF,CAAC;AAED,SAAS,WAAW,CACnB,MAAgC,EAChC,SAAoB,EACpB,QAAkB,EAClB,GAAY;IAEZ,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACnD,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC9B,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACzF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IACxB,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAA;IACjD,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,cAAc,CAAC;YACxB,SAAS;YACT,gBAAgB,EAAE,GAAG,CAAC,QAAQ;YAC9B,cAAc,EAAE,IAAI,CAAC,QAAQ;SAC7B,CAAC,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAe,oBAAoB;IAEd;IACA;IACA;IAHpB,YACoB,QAA0C,EAC1C,GAAiB,EACjB,UAAwB;QAFxB,aAAQ,GAAR,QAAQ,CAAkC;QAC1C,QAAG,GAAH,GAAG,CAAc;QACjB,eAAU,GAAV,UAAU,CAAc;IACzC,CAAC;IAII,KAAK,CAAC,cAAc,CAAC,SAAoB,EAAE,QAAkB;QACpE,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,OAAO,CAAA;IACf,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAoB,EAAE,QAAkB;QACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACxB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC9B,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACvF,OAAO,MAAM,CAAC,IAAI,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAA+B,EAAE,QAAkB;QACnE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QACvE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACxC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QACrD,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC9D,IAAI,QAAQ,EAAE,CAAC;gBACd,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;gBAChC,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBACzD,MAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;gBACzC,CAAC;YACF,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,MAAM,IAAI,GAAgB;gBACzB,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE;gBACrB,SAAS;gBACT,QAAQ;gBACR,QAAQ,EAAE,CAAC;gBACX,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,QAAQ;gBACf,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,CAAC;gBACjB,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;aACd,CAAA;YACD,MAAM,MAAM,GAAsB;gBACjC,SAAS;gBACT,QAAQ;gBACR,eAAe,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;gBACrD,IAAI;gBACJ,SAAS,EAAE,GAAG;aACd,CAAA;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QAChC,CAAC,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CACb,SAAoB,EACpB,QAAkB,EAClB,GAAY,EACZ,OAA8B;QAE9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAClD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU;gBAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAChF,OAAO;gBACN,GAAG,IAAI;gBACP,SAAS,EAAE,aAAa;aACxB,CAAA;QACF,CAAC,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAoB,EAAE,QAAkB,EAAE,GAAY;QACrE,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;IACtF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAoB,EAAE,QAAkB,EAAE,GAAY;QACtE,OAAO,MAAM,IAAI,CAAC,UAAU,CAC3B,SAAS,EACT,QAAQ,EACR,GAAG,EACH,QAAQ,EACR,CAAC,QAAQ,EAAE,SAAS,CAAC,EACrB,QAAQ,CACR,CAAA;IACF,CAAC;IAED,KAAK,CAAC,UAAU,CACf,SAAoB,EACpB,QAAkB,EAClB,GAAY;QAEZ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAG7C,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YACvB,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAC/D,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAA;YAC3F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC/C,MAAM,OAAO,GAAgB;oBAC5B,GAAG,IAAI;oBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;oBAC3B,KAAK,EAAE,SAAS;oBAChB,aAAa,EAAE;wBACd,IAAI,EAAE,aAAa;wBACnB,OAAO,EAAE,eAAe,IAAI,CAAC,aAAa,eAAe;qBACzD;oBACD,SAAS,EAAE,GAAG;iBACd,CAAA;gBACD,OAAO;oBACN,MAAM,EAAE;wBACP,SAAS,EAAE,OAAO;wBAClB,QAAQ;wBACR,eAAe,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;wBACrD,IAAI,EAAE,OAAO;wBACb,SAAS,EAAE,GAAG;qBACd;oBACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC5C,CAAA;YACF,CAAC;YAED,MAAM,QAAQ,GAAgB;gBAC7B,GAAG,IAAI;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;gBAC3B,cAAc,EAAE,IAAI,CAAC,cAAc,GAAG,CAAC;gBACvC,SAAS,EAAE,GAAG;aACd,CAAA;YACD,MAAM,SAAS,GAAuB;gBACrC,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,KAAK,EAAE,QAAQ,CAAC,cAAc;gBAC9B,aAAa,EAAE,QAAQ,CAAC,aAAa;aACrC,CAAA;YACD,OAAO;gBACN,MAAM,EAAE;oBACP,SAAS,EAAE,OAAO;oBAClB,QAAQ;oBACR,eAAe,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;oBACrD,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,GAAG;iBACd;gBACD,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE;aACvC,CAAA;QACF,CAAC,CAAC,CAAA;QACF,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;YAAE,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC7E,OAAO,OAAO,CAAC,SAAS,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAoB,EAAE,QAAkB,EAAE,GAAY;QACxE,OAAO,MAAM,IAAI,CAAC,UAAU,CAC3B,SAAS,EACT,QAAQ,EACR,GAAG,EACH,UAAU,EACV,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAC/B,UAAU,CACV,CAAA;IACF,CAAC;IAED,KAAK,CAAC,SAAS,CACd,SAAoB,EACpB,QAAkB,EAClB,GAAY,EACZ,MAAuB;QAEvB,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;QACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC/E,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAA;QAC/D,CAAC,CAAC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAoB,EAAE,QAAkB,EAAE,GAAY;QACrE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YACrD,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,OAAO;gBACN,MAAM,EAAE;oBACP,SAAS,EAAE,OAAO;oBAClB,QAAQ;oBACR,eAAe,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;oBACrD,IAAI,EAAE,IAAI;oBACV,SAAS,EAAE,GAAG;iBACd;gBACD,MAAM,EAAE,SAAS;aACjB,CAAA;QACF,CAAC,CAAC,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CACvB,SAAoB,EACpB,QAAkB,EAClB,GAAY,EACZ,SAAiB,EACjB,IAA0B,EAC1B,EAAa;QAEb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC9B,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YAC9D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACpF,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;YACvD,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;QAC9B,CAAC,CAAC,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CACnB,SAAoB,EACpB,QAAkB,EAClB,GAAY,EACZ,MAA0E;QAE1E,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,MAAM,OAAO,GAAgB;gBAC5B,GAAG,MAAM,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC;gBAC3B,SAAS,EAAE,GAAG;aACd,CAAA;YACD,OAAO;gBACN,MAAM,EAAE;oBACP,SAAS;oBACT,QAAQ;oBACR,eAAe,EAAE,CAAC,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC;oBACrD,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,GAAG;iBACd;gBACD,MAAM,EAAE,OAAO;aACf,CAAA;QACF,CAAC,CAAC,CAAA;IACH,CAAC;CACD;AAMD,MAAM,OAAO,wBAAyB,SAAQ,oBAAoB;IAChD,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAA;IAElE,YACC,MAAsC,EACtC,MAAoB,IAAI,CAAC,GAAG,EAC5B,aAA2B,cAAc;QAEzC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;QACvC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YAClB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI;YAC9D,QAAQ,EAAE,KAAK,EACd,SAAoB,EACpB,MAAqF,EACpF,EAAE;gBACH,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAA;gBAC5D,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAC/B,OAAO,QAAQ,CAAC,MAAM,CAAA;YACvB,CAAC;SACD,CAAC,CAAA;IACH,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,MAAyB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACnD,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;QACrD,MAAM,MAAM,GAAG,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAA;QAC7C,IAAI,MAAM,CAAC,eAAe,KAAK,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,cAAc,CAAC;gBACxB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,gBAAgB,EAAE,MAAM,CAAC,eAAe,GAAG,CAAC;gBAC5C,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC;aAC7C,CAAC,CAAA;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC3C,CAAC;CACD;AASD,MAAM,OAAO,oBAAqB,SAAQ,oBAAoB;IAE3C;IADlB,YACkB,MAAkC,EACnD,MAAoB,IAAI,CAAC,GAAG,EAC5B,aAA2B,cAAc;QAEzC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;QAJtB,WAAM,GAAN,MAAM,CAA4B;QAKnD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YAClB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC/E,QAAQ,EAAE,KAAK,EACd,SAAoB,EACpB,MAAqF,EACxE,EAAE;gBACf,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;gBAC7D,IAAI,CAAC;oBACJ,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAChC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,IAAI,KAAK,YAAY,cAAc;wBAAE,MAAM,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;oBACjF,MAAM,KAAK,CAAA;gBACZ,CAAC;gBACD,OAAO,QAAQ,CAAC,MAAM,CAAA;YACvB,CAAC;SACD,CAAC,CAAA;IACH,CAAC;IAEO,QAAQ,CAAC,SAAoB;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/C,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAA;QAC9C,OAAO;YACN,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,OAAO,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC;SAC/C,CAAA;IACF,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,MAAyB;QAC5C,MAAM,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC5E,IAAI,QAAQ;gBAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;YACrD,MAAM,MAAM,GAAG,QAAQ,EAAE,eAAe,IAAI,CAAC,CAAA;YAC7C,IAAI,MAAM,CAAC,eAAe,KAAK,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,cAAc,CAAC;oBACxB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,gBAAgB,EAAE,MAAM,CAAC,eAAe,GAAG,CAAC;oBAC5C,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC;iBAC7C,CAAC,CAAA;YACH,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;QACrC,CAAC,CAAC,CAAA;IACH,CAAC;CACD"}

package/dist/store/index.d.ts

@@ -1,6 +1,6 @@
 export { InMemoryStore } from './InMemoryStore.js';
 export type { Identifiable, Timestamped } from './InMemoryStore.js';
-export { RunDiskStore, readRunEventsIn } from './run/disk.js';
+export { RunDiskStore, readRunEventsIn, readRunMessagesIn } from './run/disk.js';
 export { InMemoryRunStore } from './run/memory.js';
 export { DiskCheckpointStore } from './run/checkpoint-disk.js';
 export type { DiskCheckpointStoreAttribution } from './run/checkpoint-disk.js';

package/dist/store/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAWpE,OAAO,EACN,4BAA4B,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,iBAAiB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAK7D,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,YAAY,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAWpE,OAAO,EACN,4BAA4B,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,iBAAiB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAK7D,cAAc,qBAAqB,CAAA"}

package/dist/store/index.js

@@ -1,5 +1,5 @@
 export { InMemoryStore } from './InMemoryStore.js';
-export { RunDiskStore, readRunEventsIn } from './run/disk.js';
+export { RunDiskStore, readRunEventsIn, readRunMessagesIn } from './run/disk.js';
 export { InMemoryRunStore } from './run/memory.js';
 export { DiskCheckpointStore } from './run/checkpoint-disk.js';
 export { InMemoryCheckpointStore } from './run/checkpoint-memory.js';

package/dist/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,kEAAkE;AAClE,mEAAmE;AACnE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,4BAA4B,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,iBAAiB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGlD,iEAAiE;AACjE,4EAA4E;AAC5E,qCAAqC;AACrC,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,kEAAkE;AAClE,mEAAmE;AACnE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,4BAA4B,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,iBAAiB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAG9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGlD,iEAAiE;AACjE,4EAA4E;AAC5E,qCAAqC;AACrC,cAAc,qBAAqB,CAAA"}

package/dist/store/kv/revision-record-store.d.ts

@@ -0,0 +1,70 @@
+import { type SchemaDefinition } from '../schema.js';
+/** The compatibility projection and the immutable commit directory for one record. */
+export interface RevisionedRecordLocation {
+    readonly legacyPath: string;
+    readonly revisionsDir: string;
+    /**
+     * False when the previous projection naming scheme is not injective for
+     * this key. The immutable commit remains authoritative and enumerable;
+     * publishing a colliding compatibility file would damage another record.
+     */
+    readonly publishLegacyProjection?: boolean;
+}
+/** One proposed committed value and the caller value it produces. */
+export interface RevisionMutation<T, R> {
+    readonly record: T;
+    readonly result: R;
+}
+/**
+ * Turn an opaque public id into exactly one injective filesystem segment.
+ *
+ * The unescaped alphabet deliberately excludes `.`, `%`, `~` and every path
+ * separator. Each other UTF-16 code unit has one fixed-width spelling, so
+ * `../x`, a literal escape-looking id, and an unpaired surrogate cannot
+ * collide or leave the store root.
+ */
+export declare function revisionFileSegment(value: string): string;
+/**
+ * Recover an opaque id from its canonical revision-directory segment.
+ *
+ * Listing stores need the inverse: a committed first write can exist without
+ * its best-effort legacy projection, so enumerating projection files alone
+ * would make a successful commit invisible. Non-canonical names return null
+ * rather than aliasing a real id; re-encoding is the final canonicality check.
+ */
+export declare function decodeRevisionFileSegment(segment: string): string | null;
+/**
+ * Preserve the old single-file name whenever it was already one path
+ * component. The immutable log always uses {@link revisionFileSegment}, but
+ * changing a dotted, spaced or Unicode id's projection name would strand the
+ * record written by the previous store implementation during upgrade.
+ */
+export declare function legacyRevisionFileSegment(value: string): string;
+/**
+ * Immutable revision commits over a filesystem.
+ *
+ * The body is complete before `link` publishes its revision name. `link`
+ * supplies the one kernel decision a read-check-replace sequence lacks:
+ * exactly one process can create `N.json`. Revision names are never deleted;
+ * deleting one would let an arbitrarily delayed stale writer issue N again.
+ *
+ * The old single-file record remains a compatibility projection. It is not
+ * authoritative once immutable commits exist, but it is checked on every
+ * read. A different value at the same revision, or a legacy revision ahead
+ * of the commit head, is evidence of an incompatible writer and is refused.
+ */
+export declare class DiskRevisionRecordStore<T> {
+    private readonly schema;
+    private readonly label;
+    private readonly revisionOf;
+    private readonly records;
+    constructor(schema: SchemaDefinition, label: string, revisionOf: (record: T) => number);
+    private checkedRevision;
+    read(location: RevisionedRecordLocation): Promise<T | null>;
+    private readStable;
+    private findHead;
+    transact<R>(location: RevisionedRecordLocation, mutate: (current: T | null) => RevisionMutation<T, R>): Promise<R>;
+    private publish;
+    private incompatible;
+}
+//# sourceMappingURL=revision-record-store.d.ts.map

package/dist/store/kv/revision-record-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-record-store.d.ts","sourceRoot":"","sources":["../../../src/store/kv/revision-record-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gBAAgB,EAAS,MAAM,cAAc,CAAA;AAG3D,sFAAsF;AACtF,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAC1C;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAClB;AA0BD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAezD;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAuB,CAAC,CAAC;IAIpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAG1B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM;IAKnD,OAAO,CAAC,eAAe;IAMjB,IAAI,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;YAInD,UAAU;YAgEV,QAAQ;IAkBhB,QAAQ,CAAC,CAAC,EACf,QAAQ,EAAE,wBAAwB,EAClC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GACnD,OAAO,CAAC,CAAC,CAAC;YAuDC,OAAO;IA0CrB,OAAO,CAAC,YAAY;CAYpB"}