@namzu/sdk 42.0.2 → 44.0.0

package/dist/store/session-log/core.js

@@ -0,0 +1,516 @@
+import { SessionLogLineError, formatSessionLogLine, parseSessionLogLine, } from '../../session/log-hash.js';
+import { SESSION_RECORD_MAX_BYTES, SESSION_RECORD_SCHEMA_VERSION, SessionRecordSchema, } from '../../types/session/records.js';
+import { TurnInProgressError, } from '../../types/session/turn.js';
+import { generateRecordId } from '../../utils/id.js';
+import { LineSplitter, SessionLogChain, SessionLogIntegrityError, verifyPointer, } from './chain.js';
+import { SessionTurnState, TurnRuleError, foldSessionMessages, } from './fold.js';
+import { repairRecordDraft } from './heal.js';
+import { SessionLeasesReleasedError, sessionLeasesReleasedForExit, trackHeldSessionLease, untrackHeldSessionLease, } from './held-leases.js';
+import { StaleSessionLeaseError, isLeaseLive, } from './lease.js';
+/** A draft that is not a valid session record once enveloped. */
+export class InvalidSessionRecordError extends Error {
+    name = 'InvalidSessionRecordError';
+}
+/** The log changed under a writer in a way it cannot reconcile (a concurrent writer). */
+export class SessionLogConflictError extends Error {
+    name = 'SessionLogConflictError';
+}
+const BOUNDARY_TYPES = new Set([
+    'session_started',
+    'turn_started',
+    'turn_paused',
+    'turn_resuming',
+    'turn_completed',
+    'turn_failed',
+    'checkpoint_written',
+    'decision_requested',
+    'decision_resolved',
+    'decision_expired',
+    'log_repaired',
+]);
+/** Characters of a spilled message kept inline as its preview. */
+const PREVIEW_CHARS = 2000;
+const ZERO_USAGE = {
+    promptTokens: 0,
+    completionTokens: 0,
+    totalTokens: 0,
+    cachedTokens: 0,
+    cacheWriteTokens: 0,
+};
+const ZERO_COST = { totalCost: 0, cacheDiscount: 0, unpricedTokens: 0 };
+/** Serialises a log's writes within one instance. */
+class Mutex {
+    #tail = Promise.resolve();
+    run(operation) {
+        const result = this.#tail.then(operation);
+        this.#tail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+/**
+ * The log's behaviour, shared by both backends so they cannot disagree. A
+ * backend supplies the medium, the lease store and the spill store.
+ */
+export class SessionLogCore {
+    sessionId;
+    #medium;
+    #leases;
+    #spills;
+    #now;
+    #spillAbove;
+    #sync;
+    #mutex = new Mutex();
+    #chain = new SessionLogChain();
+    #turns = new SessionTurnState();
+    /** The holding this instance took, which it presents to renew. */
+    #held;
+    /** This instance's entry in the process's held leases (`releaseHeldSessionLeases`). */
+    #holding = { release: () => this.#releaseHeld() };
+    /** Bytes of the log this instance has verified and applied. */
+    #synced = 0;
+    #torn = 0;
+    constructor(options) {
+        this.sessionId = options.sessionId;
+        this.#medium = options.medium;
+        this.#leases = options.leases;
+        this.#spills = options.spills;
+        this.#now = options.now ?? Date.now;
+        this.#spillAbove = Math.min(options.spillAboveBytes ?? SESSION_RECORD_MAX_BYTES, SESSION_RECORD_MAX_BYTES);
+        this.#sync = options.sync ?? 'boundaries';
+    }
+    // ── state ──
+    /** Catch up with the medium: verify and apply whatever was appended since the last sync. */
+    async #catchUp() {
+        const size = await this.#medium.size();
+        if (size === this.#synced + this.#torn && size >= this.#synced)
+            return;
+        if (size < this.#synced)
+            this.#reset();
+        const splitter = new LineSplitter(this.#synced);
+        for await (const chunk of this.#medium.stream(this.#synced)) {
+            for (const { line, offset } of splitter.push(chunk)) {
+                const entry = this.#chain.accept(line, offset);
+                if (this.#chain.sessionId !== this.sessionId) {
+                    throw new SessionLogIntegrityError('session-mismatch', entry.pointer.seq, offset, `The log belongs to session ${this.#chain.sessionId}, not ${this.sessionId}.`);
+                }
+                this.#turns.apply(entry.record);
+                this.#synced = offset + line.byteLength;
+            }
+        }
+        this.#torn = splitter.pendingBytes;
+    }
+    #reset() {
+        this.#chain = new SessionLogChain();
+        this.#turns = new SessionTurnState();
+        this.#synced = 0;
+        this.#torn = 0;
+    }
+    async #requireCurrent(lease) {
+        const fence = await this.#leases.fence();
+        if (lease.fence !== fence) {
+            const current = await this.#leases.current();
+            throw new StaleSessionLeaseError(lease.fence, fence, current?.holder);
+        }
+    }
+    /** Truncate a torn tail and record the repair. Caller holds the mutex and a current lease. */
+    async #heal(lease) {
+        if (this.#torn === 0)
+            return;
+        const truncated = this.#torn;
+        await this.#medium.truncate(this.#synced, this.#synced + this.#torn);
+        this.#torn = 0;
+        const draft = repairRecordDraft({
+            truncatedBytes: truncated,
+            lastGoodSeq: this.#chain.head?.seq ?? 0,
+            activeTurnId: this.#turns.active?.turnId,
+        });
+        if (draft !== undefined)
+            await this.#write(lease, draft);
+    }
+    // ── lease ──
+    async claim(options) {
+        if (sessionLeasesReleasedForExit())
+            throw new SessionLeasesReleasedError();
+        // The log's own highest gen is the floor for a new fence, so lease files
+        // that were lost or cleared cannot mint a fence below records already
+        // written. A log that cannot be read is refused below, after the claim,
+        // so that the refusal releases what it took.
+        const above = await this.#mutex.run(async () => {
+            await this.#catchUp().catch(() => undefined);
+            return this.#chain.gen;
+        });
+        // Renewal presents the holding this instance has; a name alone never renews.
+        const lease = await this.#leases.claim(options, { renew: this.#held, above });
+        if (lease === null)
+            return null;
+        this.#held = lease;
+        trackHeldSessionLease(this.#holding);
+        try {
+            // A claim that was in flight when the process gave its leases back
+            // must not leave a live lease behind it.
+            if (sessionLeasesReleasedForExit())
+                throw new SessionLeasesReleasedError();
+            await this.#mutex.run(async () => {
+                await this.#catchUp();
+                await this.#heal(lease);
+            });
+        }
+        catch (error) {
+            // A log this writer cannot append to (a broken chain, a conflict) is
+            // not held: the next taker gets the same refusal instead of a wait.
+            this.#held = undefined;
+            untrackHeldSessionLease(this.#holding);
+            await this.#leases.release(lease).catch(() => undefined);
+            throw error;
+        }
+        return lease;
+    }
+    /**
+     * In write order: a release waits for the append in flight, so it never
+     * lands between a record's fence check and its bytes.
+     */
+    release(lease) {
+        return this.#mutex.run(async () => {
+            if (this.#held?.fence === lease.fence) {
+                this.#held = undefined;
+                untrackHeldSessionLease(this.#holding);
+            }
+            await this.#leases.release(lease);
+        });
+    }
+    /** Give up this instance's holding, if it has one (`releaseHeldSessionLeases`). */
+    #releaseHeld() {
+        return this.#mutex.run(async () => {
+            const lease = this.#held;
+            untrackHeldSessionLease(this.#holding);
+            if (lease === undefined)
+                return;
+            this.#held = undefined;
+            await this.#leases.release(lease);
+        });
+    }
+    lease() {
+        return this.#leases.current();
+    }
+    // ── writes ──
+    append(lease, draft) {
+        return this.#mutex.run(async () => {
+            await this.#requireCurrent(lease);
+            await this.#catchUp();
+            await this.#heal(lease);
+            if (draft.type === 'turn_started') {
+                throw new TurnRuleError('Begin a turn with beginTurn, which enforces one active turn.');
+            }
+            this.#checkOwnership(lease, draft);
+            return this.#write(lease, draft);
+        });
+    }
+    /**
+     * Records of an interrupted turn — one whose owner lease is gone — are
+     * refused until it is resumed or closed: a new holder does not silently
+     * continue a dead process's turn.
+     */
+    #checkOwnership(lease, draft) {
+        const active = this.#turns.active;
+        if (active === undefined || draft.turnId !== active.turnId || active.paused)
+            return;
+        if (active.ownerGen === lease.fence)
+            return;
+        if (draft.type === 'turn_resuming' ||
+            draft.type === 'turn_failed' ||
+            draft.type === 'turn_completed') {
+            return;
+        }
+        throw new TurnRuleError(`Turn ${active.turnId} was started under lease fence ${active.ownerGen} and is interrupted; resume it (turn_resuming) or close it before appending to it.`);
+    }
+    beginTurn(lease, draft, options = {}) {
+        return this.#mutex.run(async () => {
+            await this.#requireCurrent(lease);
+            await this.#catchUp();
+            await this.#heal(lease);
+            const active = this.#turns.active;
+            if (active !== undefined) {
+                const state = this.#stateFor(active, lease.fence);
+                if (state !== 'interrupted' || !options.abandonInterrupted) {
+                    throw new TurnInProgressError({
+                        sessionId: this.sessionId,
+                        activeTurnId: active.turnId,
+                        state,
+                    });
+                }
+                await this.#write(lease, this.#failedDraft(active, 'interrupted', 'The process running this turn is gone; the turn was closed before the next one began.'));
+            }
+            return this.#write(lease, { type: 'turn_started', ...draft });
+        });
+    }
+    abandonTurn(lease, turnId, reason) {
+        return this.#mutex.run(async () => {
+            await this.#requireCurrent(lease);
+            await this.#catchUp();
+            await this.#heal(lease);
+            const active = this.#turns.active;
+            if (active === undefined || active.turnId !== turnId) {
+                throw new TurnRuleError(`Turn ${turnId} is not this session's active turn.`);
+            }
+            const state = this.#stateFor(active, lease.fence);
+            if (state === 'running') {
+                throw new TurnInProgressError({ sessionId: this.sessionId, activeTurnId: turnId, state });
+            }
+            return this.#write(lease, this.#failedDraft(active, 'abandoned', reason));
+        });
+    }
+    #stateFor(active, fence) {
+        if (active.paused)
+            return 'paused';
+        return active.ownerGen === fence ? 'running' : 'interrupted';
+    }
+    #failedDraft(active, code, message) {
+        const settlement = {
+            status: 'failed',
+            iterations: 0,
+            usage: ZERO_USAGE,
+            cost: ZERO_COST,
+            durationMs: Math.max(0, this.#now() - Date.parse(active.startedAt)),
+            resultSource: 'model',
+            abandonedTaskIds: [],
+            abandonedJobIds: [],
+        };
+        return {
+            type: 'turn_failed',
+            turnId: active.turnId,
+            error: message,
+            failure: { code, message, retryable: false },
+            settlement,
+        };
+    }
+    /** Envelope, spill, validate, check the turn rules, write. Caller holds the mutex. */
+    async #write(lease, draft) {
+        // The chain would refuse a regressed gen only after the bytes landed,
+        // leaving a line no reader accepts; refuse it before writing
+        // anything, a spill included.
+        if (lease.fence < this.#chain.gen) {
+            throw new StaleSessionLeaseError(lease.fence, this.#chain.gen);
+        }
+        const head = this.#chain.head;
+        const envelope = {
+            v: SESSION_RECORD_SCHEMA_VERSION,
+            id: generateRecordId(),
+            sessionId: this.sessionId,
+            seq: (head?.seq ?? 0) + 1,
+            ts: new Date(this.#now()).toISOString(),
+            prev: head,
+            gen: lease.fence,
+        };
+        const { type, ...payload } = draft;
+        let candidate = { ...envelope, type, ...payload };
+        candidate = await this.#spillIfLarge(candidate);
+        const parsed = SessionRecordSchema.safeParse(candidate);
+        if (!parsed.success) {
+            throw new InvalidSessionRecordError(`A ${type} record is not a valid session record: ${parsed.error.issues
+                .map((issue) => `${issue.path.join('.') || '(record)'}: ${issue.message}`)
+                .join('; ')}`);
+        }
+        // The candidate, not the parse output: zod may reorder or drop nothing
+        // here (every schema is strict), and the bytes hashed are the bytes written.
+        const record = candidate;
+        this.#turns.check(record);
+        let line;
+        try {
+            line = formatSessionLogLine(record);
+        }
+        catch (error) {
+            throw new InvalidSessionRecordError(error instanceof SessionLogLineError ? error.message : String(error));
+        }
+        const bytes = Buffer.from(line, 'utf8');
+        const sync = this.#sync === 'all' || (this.#sync === 'boundaries' && BOUNDARY_TYPES.has(type));
+        await this.#medium.append(bytes, this.#synced, sync);
+        const entry = this.#chain.accept(bytes, this.#synced);
+        this.#turns.apply(entry.record);
+        this.#synced += bytes.byteLength;
+        return entry;
+    }
+    async #spillIfLarge(candidate) {
+        const type = candidate.type;
+        if (type !== 'message' &&
+            type !== 'message_replaced' &&
+            type !== 'compaction' &&
+            type !== 'turn_completed')
+            return candidate;
+        const size = Buffer.byteLength(`${JSON.stringify(candidate)}\n`, 'utf8');
+        if (size <= this.#spillAbove)
+            return candidate;
+        if (type === 'turn_completed') {
+            if (typeof candidate.result !== 'string')
+                return candidate;
+            const ref = await this.#spills.write(`record:${String(candidate.id)}`, 'message', candidate.result);
+            const preview = `${candidate.result.slice(0, PREVIEW_CHARS)}\n[… ${ref.bytes} bytes spilled to ${ref.path}]`;
+            return { ...candidate, result: preview, resultSpill: ref };
+        }
+        if (candidate.type === 'compaction') {
+            if (!Array.isArray(candidate.summary))
+                return candidate;
+            const ref = await this.#spills.write(`compaction:${String(candidate.compactionId)}`, 'messages', JSON.stringify(candidate.summary));
+            return { ...candidate, summary: ref };
+        }
+        const content = candidate.content;
+        const key = content.role === 'tool' && typeof content.toolCallId === 'string'
+            ? content.toolCallId
+            : type === 'message_replaced'
+                ? `record:${String(candidate.id)}`
+                : `message:${String(candidate.messageId)}`;
+        const ref = await this.#spills.write(key, 'message', JSON.stringify(content));
+        const text = typeof content.content === 'string' ? content.content : JSON.stringify(content.content);
+        const preview = {
+            role: content.role,
+            content: `${text.slice(0, PREVIEW_CHARS)}\n[… ${ref.bytes} bytes spilled to ${ref.path}]`,
+            ...(typeof content.toolCallId === 'string' ? { toolCallId: content.toolCallId } : {}),
+        };
+        return { ...candidate, content: preview, spill: ref };
+    }
+    // ── reads ──
+    activeTurn(options = {}) {
+        return this.#mutex.run(async () => {
+            await this.#catchUp();
+            const active = this.#turns.active;
+            if (active === undefined)
+                return null;
+            if (active.paused)
+                return { ...active, state: 'paused' };
+            const now = options.now ?? this.#now();
+            const lease = options.lease ?? (await this.#leases.current());
+            const live = options.lease !== undefined || isLeaseLive(lease, now);
+            const state = live && lease !== null && lease.fence === active.ownerGen ? 'running' : 'interrupted';
+            return { ...active, state };
+        });
+    }
+    head() {
+        return this.#mutex.run(async () => {
+            await this.#catchUp();
+            const pointer = this.#chain.head;
+            if (pointer === null)
+                return null;
+            return { pointer, gen: this.#chain.gen, bytes: this.#synced };
+        });
+    }
+    read(options = {}) {
+        return walkSessionLog(this.#medium, { ...options, sessionId: this.sessionId });
+    }
+    async readAll(options = {}) {
+        return collect(this.read(options));
+    }
+    async messages(options = {}) {
+        const log = this;
+        async function* records() {
+            for await (const entry of log.read({ throughSeq: options.throughSeq }))
+                yield entry.record;
+        }
+        return foldSessionMessages(records(), {
+            throughSeq: options.throughSeq,
+            readSpill: (ref) => this.#spills.read(ref),
+        });
+    }
+    readSpill(ref) {
+        return this.#spills.read(ref);
+    }
+}
+/** Drain a walk into entries plus its summary. */
+export async function collect(walk) {
+    const entries = [];
+    for (;;) {
+        const step = await walk.next();
+        if (step.done)
+            return { ...step.value, entries };
+        entries.push(step.value);
+    }
+}
+/**
+ * Walk a log's bytes, verifying the chain as it goes (spec §4.1). Shared by
+ * both backends and by `readSessionLog`.
+ */
+export async function* walkSessionLog(medium, options) {
+    const strict = (options.mode ?? 'strict') === 'strict';
+    let chain;
+    let start = 0;
+    let brokeAt;
+    const fail = (error) => {
+        if (strict)
+            throw error;
+        brokeAt = error;
+    };
+    if (options.after !== undefined) {
+        const after = options.after;
+        if (!(await verifyPointer(medium, after))) {
+            const error = new SessionLogIntegrityError('anchor-mismatch', after.seq, after.offset, `The log does not hold the record the cursor names (seq ${after.seq} at byte ${after.offset}).`);
+            fail(error);
+            return { intact: false, throughSeq: 0, head: null, tornBytes: 0, break: error };
+        }
+        const parsed = parseSessionLogLine(await medium.read(after.offset, after.length));
+        chain = new SessionLogChain({
+            head: after,
+            sessionId: options.sessionId ?? parsed.record.sessionId,
+            gen: parsed.record.gen,
+        });
+        start = after.offset + after.length;
+    }
+    else {
+        chain = new SessionLogChain({ head: null, sessionId: options.sessionId });
+    }
+    const splitter = new LineSplitter(start);
+    let anchorSeen = false;
+    let stopped = false;
+    outer: for await (const chunk of medium.stream(start)) {
+        let lines;
+        try {
+            lines = splitter.push(chunk);
+            for (const { line, offset } of lines) {
+                let entry;
+                try {
+                    entry = chain.accept(line, offset);
+                }
+                catch (error) {
+                    if (!(error instanceof SessionLogIntegrityError))
+                        throw error;
+                    fail(error);
+                    stopped = true;
+                    break outer;
+                }
+                if (options.expectHead !== undefined && entry.pointer.seq === options.expectHead.seq) {
+                    anchorSeen = true;
+                    const e = options.expectHead;
+                    if (e.offset !== entry.pointer.offset ||
+                        e.length !== entry.pointer.length ||
+                        e.sha256 !== entry.pointer.sha256) {
+                        fail(new SessionLogIntegrityError('anchor-mismatch', e.seq, entry.pointer.offset, `The record at seq ${e.seq} is not the one the anchor names; the log was altered.`));
+                        stopped = true;
+                        break outer;
+                    }
+                }
+                yield entry;
+                if (options.throughSeq !== undefined && entry.pointer.seq >= options.throughSeq) {
+                    stopped = true;
+                    break outer;
+                }
+            }
+        }
+        catch (error) {
+            if (!(error instanceof SessionLogIntegrityError))
+                throw error;
+            fail(error);
+            stopped = true;
+            break;
+        }
+    }
+    if (!stopped && options.expectHead !== undefined && !anchorSeen && brokeAt === undefined) {
+        const e = options.expectHead;
+        fail(new SessionLogIntegrityError('anchor-mismatch', e.seq, chain.end, `The log ends at seq ${chain.head?.seq ?? 0}, before the anchored seq ${e.seq}; it was truncated.`));
+    }
+    const pointer = chain.head;
+    return {
+        intact: brokeAt === undefined,
+        throughSeq: pointer?.seq ?? 0,
+        head: pointer === null ? null : { pointer, gen: chain.gen, bytes: chain.end },
+        tornBytes: stopped ? 0 : splitter.pendingBytes,
+        ...(brokeAt === undefined ? {} : { break: brokeAt }),
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/store/session-log/core.js.map

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

package/dist/store/session-log/disk.d.ts

@@ -0,0 +1,56 @@
+import { type SessionLocator, type SessionPaths } from '../../session/paths.js';
+import type { SessionId } from '../../types/ids/index.js';
+import type { SessionLogEntry } from './chain.js';
+import { type LogMedium, type ReadSessionLogOptions, SessionLogCore, type SessionLogCoreOptions, type SessionLogRead, type SessionLogReadSummary } from './core.js';
+/** The bytes of one log file. */
+export declare class DiskLogMedium implements LogMedium {
+    readonly file: string;
+    constructor(file: string);
+    size(): Promise<number>;
+    read(offset: number, length: number): Promise<Uint8Array>;
+    stream(offset: number): AsyncIterable<Uint8Array>;
+    append(bytes: Uint8Array, expectedOffset: number, sync: boolean): Promise<void>;
+    truncate(size: number, expectedSize: number): Promise<void>;
+}
+export interface DiskSessionLogOptions extends Pick<SessionLogCoreOptions, 'now' | 'spillAboveBytes' | 'sync'> {
+    readonly sessionId: SessionId;
+    /** `<session-id>.jsonl`. */
+    readonly file: string;
+    /** `<session-id>/`: the lease files and `tool-results/`. */
+    readonly sessionDir: string;
+    /**
+     * Where the session sits in its project's layout. {@link DiskSessionLog.at}
+     * sets it; otherwise it is read from `file` (`…/<parent-id>/subagents/<id>.jsonl`
+     * names its ancestors), so a log opened from the index's `logPath` sits
+     * where `at` put it. The stores that keep a session's other documents
+     * (`checkpoints/`, …) read it, so a child session's documents land in its
+     * own directory under its ancestors rather than at the top level.
+     */
+    readonly locator?: SessionLocator;
+}
+/** A session log on disk. One instance per writer process; readers may open their own. */
+export declare class DiskSessionLog extends SessionLogCore {
+    readonly file: string;
+    readonly sessionDir: string;
+    /**
+     * See {@link DiskSessionLogOptions.locator}. `undefined` only for a log
+     * whose file is not named `<session-id>.jsonl`.
+     */
+    readonly locator: SessionLocator | undefined;
+    constructor(options: DiskSessionLogOptions);
+    /** The log of `locator` in a project's layout. */
+    static at(paths: SessionPaths, locator: SessionLocator, options?: Pick<SessionLogCoreOptions, 'now' | 'spillAboveBytes' | 'sync'>): DiskSessionLog;
+}
+/**
+ * Walk a session log file, verifying the chain (spec §4.1). Yields each
+ * record with its pointer and returns the summary. A missing file is an empty
+ * log.
+ */
+export declare function streamSessionLog(file: string, options?: ReadSessionLogOptions & {
+    readonly sessionId?: SessionId;
+}): AsyncGenerator<SessionLogEntry, SessionLogReadSummary>;
+/** Read a whole session log file: strict by default, or tolerant (stops at the first break). */
+export declare function readSessionLog(file: string, options?: ReadSessionLogOptions & {
+    readonly sessionId?: SessionId;
+}): Promise<SessionLogRead>;
+//# sourceMappingURL=disk.d.ts.map

package/dist/store/session-log/disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../../src/store/session-log/disk.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EACN,KAAK,SAAS,EACd,KAAK,qBAAqB,EAE1B,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAG1B,MAAM,WAAW,CAAA;AA4BlB,iCAAiC;AACjC,qBAAa,aAAc,YAAW,SAAS;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAE3B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IASvB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBxD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,UAAU,CAAC;IAUlD,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B/E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAejE;AAED,MAAM,WAAW,qBAChB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,KAAK,GAAG,iBAAiB,GAAG,MAAM,CAAC;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CACjC;AAED,0FAA0F;AAC1F,qBAAa,cAAe,SAAQ,cAAc;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;gBAEhC,OAAO,EAAE,qBAAqB;IAoB1C,kDAAkD;IAClD,MAAM,CAAC,EAAE,CACR,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,KAAK,GAAG,iBAAiB,GAAG,MAAM,CAAM,GAC3E,cAAc;CASjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,GACtE,cAAc,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAExD;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,GACtE,OAAO,CAAC,cAAc,CAAC,CAEzB"}