@namzu/sdk 42.0.2 → 44.0.0

package/dist/store/session-claim.d.ts

@@ -0,0 +1,30 @@
+import { type SessionLocatorOptions } from '../runtime/query/abandon-turn.js';
+import { NamzuError } from '../types/errors/index.js';
+import type { SessionId } from '../types/ids/index.js';
+import type { FencingToken, LeaseSummary } from '../types/session/durable.js';
+import type { ClaimSessionOptions, SessionLease, SessionLog } from './session-log/index.js';
+/**
+ * Take exclusive working possession of a session (its `lease.json`), or
+ * report that somebody else holds it. `null` is the ordinary outcome of a
+ * queue with more than one reader, not an error.
+ *
+ * A lease expires; claiming an expired one succeeds and mints a fence
+ * strictly greater than every fence issued before, so the stalled holder's
+ * next append is refused.
+ */
+export declare function claimSession(sessionId: SessionId, options: ClaimSessionOptions & Omit<SessionLocatorOptions, 'lease'>): Promise<SessionLease | null>;
+/**
+ * Give a lease up early. Idempotent; presenting a superseded lease releases
+ * nothing.
+ */
+export declare function releaseSession(sessionId: SessionId, lease: SessionLease, options?: Omit<SessionLocatorOptions, 'lease'>): Promise<void>;
+/** A lease as a listing reports it, judged against one clock. */
+export declare function toClaimSummary(lease: SessionLease, now: number): LeaseSummary;
+/** The refusal for an append presented under a superseded lease. */
+export declare function fencedOut(sessionId: SessionId, presented: FencingToken, current: FencingToken): NamzuError;
+/** What `session-log:single-open-writer` is evaluated against: one session and the fence a writer presents. */
+export interface SingleOpenWriterContext {
+    readonly log: SessionLog;
+    readonly presentedFence: FencingToken;
+}
+//# sourceMappingURL=session-claim.d.ts.map

package/dist/store/session-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-claim.d.ts","sourceRoot":"","sources":["../../src/store/session-claim.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,qBAAqB,EAAoB,MAAM,kCAAkC,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAE3F;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CACjC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,GACjE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAQ9B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CACnC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAM,GAChD,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAO7E;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CACxB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,YAAY,GACnB,UAAU,CAOZ;AAED,+GAA+G;AAC/G,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAA;CACrC"}

package/dist/store/session-claim.js

@@ -0,0 +1,71 @@
+import { invariants } from '../invariants/index.js';
+import { locateSessionLog } from '../runtime/query/abandon-turn.js';
+import { NamzuError } from '../types/errors/index.js';
+/**
+ * Take exclusive working possession of a session (its `lease.json`), or
+ * report that somebody else holds it. `null` is the ordinary outcome of a
+ * queue with more than one reader, not an error.
+ *
+ * A lease expires; claiming an expired one succeeds and mints a fence
+ * strictly greater than every fence issued before, so the stalled holder's
+ * next append is refused.
+ */
+export async function claimSession(sessionId, options) {
+    const { log: given, index, home, ...claim } = options;
+    const log = await locateSessionLog(sessionId, {
+        ...(given ? { log: given } : {}),
+        ...(index ? { index } : {}),
+        ...(home ? { home } : {}),
+    });
+    return log.claim(claim);
+}
+/**
+ * Give a lease up early. Idempotent; presenting a superseded lease releases
+ * nothing.
+ */
+export async function releaseSession(sessionId, lease, options = {}) {
+    const log = await locateSessionLog(sessionId, options);
+    await log.release(lease);
+}
+/** A lease as a listing reports it, judged against one clock. */
+export function toClaimSummary(lease, now) {
+    return {
+        holder: lease.holder,
+        fence: lease.fence,
+        expiresAt: lease.expiresAt,
+        expired: now >= lease.expiresAt,
+    };
+}
+/** The refusal for an append presented under a superseded lease. */
+export function fencedOut(sessionId, presented, current) {
+    return new NamzuError({
+        code: 'storage_error',
+        message: `Refusing an append to session ${sessionId} fenced at ${presented}: the session is now leased at ${current}. Another worker took it over, so this process no longer holds it. Stop rather than retrying: the lease is gone, not busy.`,
+        details: { sessionId, presentedFence: presented, currentFence: current },
+        retryable: false,
+    });
+}
+/**
+ * One writer per session: a writer presenting a fence below the session's
+ * current lease is a stalled holder somebody took the session from.
+ * Evaluated per session; without one it reports `unknown`.
+ */
+invariants.register('session-log', 'single-open-writer', async (ctx) => {
+    if (!ctx) {
+        return {
+            state: 'unknown',
+            reason: 'no session log given — this invariant is evaluated per session, not for the process as a whole',
+        };
+    }
+    const current = await ctx.log.lease();
+    if (current && ctx.presentedFence < current.fence) {
+        const holderNote = current.holder ? ` (now held by "${current.holder}")` : '';
+        return {
+            state: 'violated',
+            detail: `presented fence ${ctx.presentedFence} is behind this session's current fence ` +
+                `${current.fence}${holderNote} — another worker has taken this session over`,
+        };
+    }
+    return { state: 'holds' };
+});
+//# sourceMappingURL=session-claim.js.map

package/dist/store/session-claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-claim.js","sourceRoot":"","sources":["../../src/store/session-claim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAA8B,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAKrD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,SAAoB,EACpB,OAAmE;IAEnE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IACrD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE;QAC7C,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzB,CAAC,CAAA;IACF,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,SAAoB,EACpB,KAAmB,EACnB,UAAgD,EAAE;IAElD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IACtD,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACzB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,GAAW;IAC9D,OAAO;QACN,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,SAAS;KAC/B,CAAA;AACF,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CACxB,SAAoB,EACpB,SAAuB,EACvB,OAAqB;IAErB,OAAO,IAAI,UAAU,CAAC;QACrB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,iCAAiC,SAAS,cAAc,SAAS,kCAAkC,OAAO,4HAA4H;QAC/O,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE;QACxE,SAAS,EAAE,KAAK;KAChB,CAAC,CAAA;AACH,CAAC;AAQD;;;;GAIG;AACH,UAAU,CAAC,QAAQ,CAClB,aAAa,EACb,oBAAoB,EACpB,KAAK,EAAE,GAAG,EAAE,EAAE;IACb,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO;YACN,KAAK,EAAE,SAAS;YAChB,MAAM,EACL,gGAAgG;SACjG,CAAA;IACF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;IACrC,IAAI,OAAO,IAAI,GAAG,CAAC,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7E,OAAO;YACN,KAAK,EAAE,UAAU;YACjB,MAAM,EACL,mBAAmB,GAAG,CAAC,cAAc,0CAA0C;gBAC/E,GAAG,OAAO,CAAC,KAAK,GAAG,UAAU,+CAA+C;SAC7E,CAAA;IACF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;AAC1B,CAAC,CACD,CAAA"}

package/dist/store/session-index/fts.d.ts

@@ -0,0 +1,60 @@
+import type { SessionRecord } from '../../types/session/records.js';
+/**
+ * Evidence search over the session logs: which text a record contributes,
+ * and what counts as a match.
+ *
+ * The text sources and the match rules are today's evidence search
+ * (`store/evidence`): a tool result, an assistant message's text, and the
+ * messages a compaction shed; literal substring or whole-token matching,
+ * case-sensitive by default, no regex operators, no ranking. `evidence_fts`
+ * (FTS5, trigram tokenizer) only narrows the candidates. Every candidate is
+ * checked here, so the SQLite index and the scan index return the same hits.
+ */
+/** One searchable text part of one record. */
+export interface EvidenceText {
+    /** The part's position among the record's text parts. */
+    readonly part: number;
+    /** `tool_completed`, `message_completed`, or `compaction_shed:<role|summary>`. */
+    readonly source: string;
+    readonly text: string;
+    readonly toolName?: string;
+    readonly isError?: boolean;
+}
+/** The searchable text parts of one record; empty for a record that carries none. */
+export declare function evidenceTexts(record: SessionRecord): EvidenceText[];
+/** What to look for. Exactly today's evidence-search options. */
+export interface EvidenceQuery {
+    /** A literal string. An empty query (or none) matches every part. */
+    readonly query?: string;
+    /** One to sixteen literal terms, matched as alternatives. Exclusive with `query`. */
+    readonly terms?: readonly string[];
+    /** `literal` (the default) matches substrings; `token` matches whole letter/number/underscore tokens. */
+    readonly matchMode?: 'literal' | 'token';
+    /** Defaults to true. */
+    readonly caseSensitive?: boolean;
+}
+/** Where the first match in a text is, and the excerpt around it (UTF-16 positions). */
+export interface EvidenceMatch {
+    readonly hit: number;
+    readonly start: number;
+    readonly end: number;
+}
+export declare class EvidenceQueryError extends Error {
+    readonly name = "EvidenceQueryError";
+}
+/**
+ * The matcher for a query: the first hit in a text and the excerpt a result
+ * shows for it (up to 120 characters before the hit, 512 in all, never
+ * splitting a surrogate pair), or `undefined` when the text does not match.
+ */
+export declare function evidenceMatcher(query: EvidenceQuery): (text: string) => EvidenceMatch | undefined;
+/**
+ * The FTS5 `MATCH` expression that narrows the candidates for a query, or
+ * `undefined` when narrowing could drop a hit and every part must be checked.
+ *
+ * The trigram tokenizer folds ASCII case and matches a quoted string as a
+ * substring, so for printable-ASCII terms of three or more characters its
+ * result is a superset of the literal and token matches.
+ */
+export declare function ftsMatchExpression(query: EvidenceQuery): string | undefined;
+//# sourceMappingURL=fts.d.ts.map

package/dist/store/session-index/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../../src/store/session-index/fts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAInE;;;;;;;;;;GAUG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC1B;AAqDD,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE,CAuBnE;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yGAAyG;IACzG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IACxC,wBAAwB;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,wBAAuB;CAC7C;AAsBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAmCjG;AAWD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAQ3E"}

package/dist/store/session-index/fts.js

@@ -0,0 +1,160 @@
+import { evidenceTokenMatcher, isEvidenceToken } from '../../utils/evidence-tokens.js';
+import { compactedToolMetadata } from '../evidence/compaction-provenance.js';
+function plainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+const ROLES = new Set(['system', 'user', 'assistant', 'tool']);
+/**
+ * The texts of shed messages, in today's order: every plain-string message
+ * first, then the text blocks of tool messages. Binary blocks are never text.
+ * A tool message's texts carry its tool name and error flag, as today's
+ * compaction text does.
+ */
+function shedTexts(messages) {
+    if (!Array.isArray(messages))
+        return [];
+    const strings = [];
+    const blocks = [];
+    const metadata = compactedToolMetadata(messages);
+    for (const [index, value] of messages.entries()) {
+        const message = plainObject(value);
+        if (!message || typeof message.role !== 'string' || !ROLES.has(message.role))
+            continue;
+        const role = message.role;
+        const tool = metadata[index];
+        if (typeof message.content === 'string') {
+            const summary = role === 'system' && plainObject(message.source)?.type === 'compaction-summary';
+            strings.push({
+                source: `compaction_shed:${summary ? 'summary' : role}`,
+                text: message.content,
+                ...tool,
+            });
+        }
+        else if (role === 'tool' && Array.isArray(message.content)) {
+            for (const block of message.content) {
+                const part = plainObject(block);
+                if (part?.type === 'text' && typeof part.text === 'string') {
+                    blocks.push({ source: 'compaction_shed:tool', text: part.text, ...tool });
+                }
+            }
+        }
+    }
+    return strings.concat(blocks);
+}
+/** The searchable text parts of one record; empty for a record that carries none. */
+export function evidenceTexts(record) {
+    switch (record.type) {
+        case 'tool_completed':
+            return typeof record.result === 'string'
+                ? [
+                    {
+                        part: 0,
+                        source: 'tool_completed',
+                        text: record.result,
+                        toolName: record.toolName,
+                        isError: record.isError,
+                    },
+                ]
+                : [];
+        case 'message_completed':
+            return typeof record.content === 'string'
+                ? [{ part: 0, source: 'message_completed', text: record.content }]
+                : [];
+        case 'compaction_shed':
+            return shedTexts(record.messages).map((text, part) => ({ part, ...text }));
+        default:
+            return [];
+    }
+}
+export class EvidenceQueryError extends Error {
+    name = 'EvidenceQueryError';
+}
+const LOW_SURROGATE = /[\uDC00-\uDFFF]/;
+function queryTerms(query) {
+    if (query.terms !== undefined && query.query !== undefined) {
+        throw new EvidenceQueryError('Supply either a literal query or literal terms, not both.');
+    }
+    if (query.terms !== undefined) {
+        if (query.terms.length === 0 || query.terms.length > 16) {
+            throw new EvidenceQueryError('Supply between one and sixteen terms.');
+        }
+        for (const term of query.terms) {
+            if (term.trim().length === 0 || term.length > 256) {
+                throw new EvidenceQueryError('Each term is nonblank and at most 256 characters.');
+            }
+        }
+        return [...new Set(query.terms)];
+    }
+    return [query.query ?? ''];
+}
+/**
+ * The matcher for a query: the first hit in a text and the excerpt a result
+ * shows for it (up to 120 characters before the hit, 512 in all, never
+ * splitting a surrogate pair), or `undefined` when the text does not match.
+ */
+export function evidenceMatcher(query) {
+    const terms = queryTerms(query);
+    const caseSensitive = query.caseSensitive ?? true;
+    const single = query.terms === undefined;
+    let find;
+    if (query.matchMode === 'token') {
+        if (!terms.every(isEvidenceToken)) {
+            throw new EvidenceQueryError('Token search requires nonempty letter/number/underscore tokens.');
+        }
+        const match = evidenceTokenMatcher(terms, caseSensitive);
+        find = (text) => match(text, 0)?.index ?? -1;
+    }
+    else if (caseSensitive && single) {
+        const needle = terms[0] ?? '';
+        find = (text) => text.indexOf(needle);
+    }
+    else {
+        const expression = new RegExp(terms.map((term) => term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|'), caseSensitive ? 'g' : 'giu');
+        find = (text) => {
+            expression.lastIndex = 0;
+            return expression.exec(text)?.index ?? -1;
+        };
+    }
+    return (text) => {
+        const hit = find(text);
+        if (hit < 0)
+            return undefined;
+        let start = Math.max(0, hit - 120);
+        if (start > 0 && LOW_SURROGATE.test(text[start] ?? ''))
+            start--;
+        let end = Math.min(text.length, start + 512);
+        if (end < text.length && LOW_SURROGATE.test(text[end] ?? ''))
+            end--;
+        return { hit, start, end };
+    };
+}
+/**
+ * Characters that a case-insensitive JavaScript match folds onto an ASCII
+ * letter although SQLite's folding may not (U+212A KELVIN SIGN onto `k`,
+ * U+017F LONG S onto `s`). A case-insensitive term containing `k` or `s`
+ * therefore gets no FTS narrowing, so the narrowing can never drop a hit.
+ */
+const FOLDS_FROM_NON_ASCII = /[ks]/i;
+const PRINTABLE_ASCII = /^[\x20-\x7e]+$/;
+/**
+ * The FTS5 `MATCH` expression that narrows the candidates for a query, or
+ * `undefined` when narrowing could drop a hit and every part must be checked.
+ *
+ * The trigram tokenizer folds ASCII case and matches a quoted string as a
+ * substring, so for printable-ASCII terms of three or more characters its
+ * result is a superset of the literal and token matches.
+ */
+export function ftsMatchExpression(query) {
+    const terms = queryTerms(query);
+    const caseSensitive = query.caseSensitive ?? true;
+    for (const term of terms) {
+        if (term.length < 3 || !PRINTABLE_ASCII.test(term))
+            return undefined;
+        if (!caseSensitive && FOLDS_FROM_NON_ASCII.test(term))
+            return undefined;
+    }
+    return terms.map((term) => `"${term.replace(/"/g, '""')}"`).join(' OR ');
+}
+//# sourceMappingURL=fts.js.map

package/dist/store/session-index/fts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.js","sourceRoot":"","sources":["../../../src/store/session-index/fts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAyB5E,SAAS,WAAW,CAAC,KAAc;IAClC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1E,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAA;AACb,CAAC;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;AAS9D;;;;;GAKG;AACH,SAAS,SAAS,CAAC,QAAiB;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAA;IACvC,MAAM,OAAO,GAAe,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAe,EAAE,CAAA;IAC7B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAChD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QAClC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAQ;QACtF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QAC5B,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,OAAO,GACZ,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,oBAAoB,CAAA;YAChF,OAAO,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,mBAAmB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;gBACvD,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,GAAG,IAAI;aACP,CAAC,CAAA;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;gBAC/B,IAAI,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;gBAC1E,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,MAAqB;IAClD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,gBAAgB;YACpB,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;gBACvC,CAAC,CAAC;oBACA;wBACC,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,gBAAgB;wBACxB,IAAI,EAAE,MAAM,CAAC,MAAM;wBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;qBACvB;iBACD;gBACF,CAAC,CAAC,EAAE,CAAA;QACN,KAAK,mBAAmB;YACvB,OAAO,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;gBACxC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClE,CAAC,CAAC,EAAE,CAAA;QACN,KAAK,iBAAiB;YACrB,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;QAC3E;YACC,OAAO,EAAE,CAAA;IACX,CAAC;AACF,CAAC;AAqBD,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC1B,IAAI,GAAG,oBAAoB,CAAA;CAC7C;AAED,MAAM,aAAa,GAAG,iBAAiB,CAAA;AAEvC,SAAS,UAAU,CAAC,KAAoB;IACvC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,IAAI,kBAAkB,CAAC,2DAA2D,CAAC,CAAA;IAC1F,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,CAAC,CAAA;QACtE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACnD,MAAM,IAAI,kBAAkB,CAAC,mDAAmD,CAAC,CAAA;YAClF,CAAC;QACF,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB;IACnD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAA;IACjD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,CAAA;IACxC,IAAI,IAA8B,CAAA;IAClC,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,kBAAkB,CAC3B,iEAAiE,CACjE,CAAA;QACF,CAAC;QACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QACxD,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAA;IAC7C,CAAC;SAAM,IAAI,aAAa,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC7B,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;SAAM,CAAC;QACP,MAAM,UAAU,GAAG,IAAI,MAAM,CAC5B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAC1E,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAC3B,CAAA;QACD,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE;YACf,UAAU,CAAC,SAAS,GAAG,CAAC,CAAA;YACxB,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAA;QAC1C,CAAC,CAAA;IACF,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,EAAE;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;QACtB,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,SAAS,CAAA;QAC7B,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC,CAAA;QAClC,IAAI,KAAK,GAAG,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAE,KAAK,EAAE,CAAA;QAC/D,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,GAAG,CAAC,CAAA;QAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAAE,GAAG,EAAE,CAAA;QACnE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAC3B,CAAC,CAAA;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,OAAO,CAAA;AACpC,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAExC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACtD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAA;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAA;QACpE,IAAI,CAAC,aAAa,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAA;IACxE,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AACzE,CAAC"}

package/dist/store/session-index/index.d.ts

@@ -0,0 +1,206 @@
+import type { ProjectId, SessionId, TurnId } from '../../types/ids/index.js';
+import type { RecordPointer, SessionRecord } from '../../types/session/records.js';
+import type { TurnExecutionStatus } from '../../types/session/turn.js';
+import type { EvidenceQuery } from './fts.js';
+import type { ExternalRefKind, ExternalRefTarget } from './refs.js';
+/**
+ * The rebuildable index over every session log under `NAMZU_HOME`
+ * (`$NAMZU_HOME/index.sqlite`, spec §4.6).
+ *
+ * The logs are the source of truth; every row here is derived from their
+ * records and nothing is written directly, so deleting the index loses
+ * nothing. `SqliteSessionIndex` keeps it in SQLite where `node:sqlite` loads
+ * (Node 22.13+); elsewhere `ScanSessionIndex` derives the same answers in
+ * memory from the logs.
+ */
+/** One record as a log reader yields it: the record and where it sits in its file. */
+export interface IndexableRecord {
+    readonly record: SessionRecord;
+    readonly pointer: RecordPointer;
+}
+/** One session log to index, as records. */
+export interface SessionLogInput {
+    /** The project slug the log is filed under (`projects/<slug>/`). */
+    readonly slug: string;
+    /** The log's path, recorded so a later check can compare the file with the index. */
+    readonly logPath: string;
+    /**
+     * The records, in order. Starting at seq 1 re-derives the session from
+     * scratch; starting right after the indexed head continues it; anything
+     * else is refused.
+     */
+    readonly records: AsyncIterable<IndexableRecord> | Iterable<IndexableRecord>;
+}
+/**
+ * `running`: a turn is open and not parked (the index cannot see leases, so
+ * an interrupted turn also reads `running`); `paused`: the open turn is
+ * parked; `idle`: no turn is open.
+ */
+export type IndexedSessionStatus = 'idle' | 'running' | 'paused';
+export interface IndexedSession {
+    readonly id: SessionId;
+    readonly slug: string;
+    readonly projectId: ProjectId;
+    readonly parentId?: SessionId;
+    readonly rootId: SessionId;
+    /** 0 for a root session. */
+    readonly depth: number;
+    readonly title?: string;
+    readonly archived: boolean;
+    readonly status: IndexedSessionStatus;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly logPath: string;
+    /** Bytes of the log the index has read: the end of the head record. */
+    readonly logBytes: number;
+    readonly headSeq: number;
+    readonly headSha256: string;
+}
+/** A turn's state as its records leave it. `paused` is parked, not terminal. */
+export type IndexedTurnStatus = 'running' | 'paused' | 'completed' | 'cancelled' | 'failed';
+export interface IndexedTurn {
+    readonly id: TurnId;
+    readonly sessionId: SessionId;
+    readonly status: IndexedTurnStatus;
+    readonly stopReason?: string;
+    readonly startedAt: string;
+    readonly endedAt?: string;
+    /** The settled total; 0 until the turn settles. */
+    readonly tokens: number;
+    readonly costUsd: number;
+    /** The first 200 characters of the prompt that opened the turn. */
+    readonly userPreview?: string;
+    readonly originKind?: string;
+}
+/** A decision a parked turn is waiting on. */
+export interface IndexedPendingDecision {
+    readonly decisionId: string;
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
+    readonly checkpointId: string;
+    readonly deadlineAt?: string;
+}
+/** A child session as its parent's log describes it, with the child's own row once its log is indexed. */
+export interface ChildSessionSummary {
+    readonly sessionId: SessionId;
+    readonly parentSessionId: SessionId;
+    readonly parentTurnId: TurnId;
+    readonly toolCallId: string;
+    readonly kind: string;
+    readonly description: string;
+    /** The child's log, relative to the parent's session directory. */
+    readonly path: string;
+    readonly batch?: {
+        readonly batchId: string;
+        readonly name: string;
+        readonly phase?: string;
+    };
+    /** `running` until the parent records `child_session_ended`, then the child's settled status. */
+    readonly status: TurnExecutionStatus;
+    readonly stopReason?: string;
+    readonly tokens: number;
+    readonly costUsd: number;
+    readonly spawnedAt: string;
+    readonly endedAt?: string;
+    readonly session?: IndexedSession;
+}
+/** A group of children spawned together, derived from `child_session_spawned.batch`. */
+export interface IndexedBatch {
+    readonly batchId: string;
+    readonly sessionId: SessionId;
+    readonly name: string;
+    /** The phase the most recent spawn named. */
+    readonly phase?: string;
+    readonly agentsDone: number;
+    readonly agentsTotal: number;
+    readonly tokensTotal: number;
+}
+/** One searchable part that matched. */
+export interface EvidenceHit {
+    readonly sessionId: SessionId;
+    readonly turnId?: TurnId;
+    readonly seq: number;
+    readonly part: number;
+    readonly source: string;
+    readonly toolName?: string;
+    readonly isError?: boolean;
+    /** UTF-16 position of the first match in the part's text. */
+    readonly hit: number;
+    /** The text around the first match. */
+    readonly excerpt: string;
+}
+export interface EvidenceSearchOptions extends EvidenceQuery {
+    readonly sessionId?: SessionId;
+    /** Defaults to 100. */
+    readonly limit?: number;
+}
+export interface ListSessionsOptions {
+    readonly slug?: string;
+    /** Only sessions with no parent. */
+    readonly rootsOnly?: boolean;
+    /** Defaults to true. */
+    readonly includeArchived?: boolean;
+}
+/**
+ * How a log compares with its row: `fresh`, `grown` (appended since; the
+ * index continues from its head), `truncated` or `rewritten` (the head record
+ * no longer ends where it did or no longer hashes the same; the session is
+ * re-derived), `unindexed` (no row yet) or `missing` (no file).
+ */
+export type SessionStaleness = 'fresh' | 'grown' | 'truncated' | 'rewritten' | 'unindexed' | 'missing';
+/** A log on disk, as the layout files it. */
+export interface SessionLogLocation {
+    readonly slug: string;
+    readonly logPath: string;
+    readonly sessionId: SessionId;
+}
+export interface SessionIndex {
+    readonly backend: 'sqlite' | 'scan';
+    /** Derive (or continue deriving) one session from its records. */
+    indexSession(input: SessionLogInput): Promise<IndexedSession | undefined>;
+    /** Compare one log with the index. */
+    staleness(location: SessionLogLocation): Promise<SessionStaleness>;
+    /** Bring one session up to date with its log; returns what was found. */
+    refresh(location: SessionLogLocation): Promise<SessionStaleness>;
+    /** Bring every session under `home` up to date and drop sessions whose log is gone. */
+    sync(home: string): Promise<void>;
+    getSession(sessionId: SessionId): Promise<IndexedSession | undefined>;
+    listSessions(options?: ListSessionsOptions): Promise<IndexedSession[]>;
+    listTurns(sessionId: SessionId): Promise<IndexedTurn[]>;
+    listChildren(sessionId: SessionId): Promise<ChildSessionSummary[]>;
+    listPendingDecisions(options?: {
+        sessionId?: SessionId;
+    }): Promise<IndexedPendingDecision[]>;
+    /** What a caller-side name refers to. The earliest claim wins when two sessions claim one name. */
+    resolveExternal(protocol: string, kind: ExternalRefKind, externalId: string): Promise<ExternalRefTarget | undefined>;
+    /** Every name one session holds, including those another session claimed first. */
+    listExternalRefs(sessionId: SessionId): Promise<ExternalRefTarget[]>;
+    batches(options?: {
+        sessionId?: SessionId;
+    }): Promise<IndexedBatch[]>;
+    searchEvidence(options: EvidenceSearchOptions): Promise<EvidenceHit[]>;
+    close(): void;
+}
+export interface OpenSessionIndexOptions {
+    /** Defaults to `resolveNamzuHome()`. */
+    readonly home?: string;
+    /** Defaults to `<home>/index.sqlite`. */
+    readonly path?: string;
+    /** `auto` (the default) uses SQLite when `node:sqlite` loads, the scan index otherwise. */
+    readonly backend?: 'auto' | 'sqlite' | 'scan';
+}
+/**
+ * Open the index for a home: a missing index, or one at another version, is
+ * rebuilt from the logs; an existing one is brought up to date with them.
+ */
+export declare function openSessionIndex(options?: OpenSessionIndexOptions): Promise<SessionIndex>;
+export { EvidenceQueryError, evidenceMatcher, evidenceTexts, ftsMatchExpression } from './fts.js';
+export type { EvidenceMatch, EvidenceQuery, EvidenceText } from './fts.js';
+export { externalRefChanges, sessionRefKind } from './refs.js';
+export type { ExternalRefChange, ExternalRefClaim, ExternalRefKind, ExternalRefTarget, } from './refs.js';
+export { SessionIndexError, discoverSessionLogs, readIndexableRecords, } from './rebuild.js';
+export type { IndexedLogPosition } from './rebuild.js';
+export { ScanSessionIndex } from './scan.js';
+export { SESSION_INDEX_VERSION, SqliteSessionIndex, rebuildSqliteSessionIndex, sqliteAvailable, } from './sqlite.js';
+export type { RebuildSqliteSessionIndexOptions, SqliteSessionIndexOptions } from './sqlite.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/store/session-index/index.js

@@ -0,0 +1,22 @@
+import { join } from 'node:path';
+import { resolveNamzuHome } from '../../session/home.js';
+import { ScanSessionIndex } from './scan.js';
+import { SqliteSessionIndex, sqliteAvailable } from './sqlite.js';
+/**
+ * Open the index for a home: a missing index, or one at another version, is
+ * rebuilt from the logs; an existing one is brought up to date with them.
+ */
+export async function openSessionIndex(options = {}) {
+    const home = options.home ?? resolveNamzuHome();
+    const backend = options.backend ?? 'auto';
+    if (backend === 'scan' || (backend === 'auto' && !sqliteAvailable())) {
+        return ScanSessionIndex.load(home);
+    }
+    return SqliteSessionIndex.open({ home, path: options.path ?? join(home, 'index.sqlite') });
+}
+export { EvidenceQueryError, evidenceMatcher, evidenceTexts, ftsMatchExpression } from './fts.js';
+export { externalRefChanges, sessionRefKind } from './refs.js';
+export { SessionIndexError, discoverSessionLogs, readIndexableRecords, } from './rebuild.js';
+export { ScanSessionIndex } from './scan.js';
+export { SESSION_INDEX_VERSION, SqliteSessionIndex, rebuildSqliteSessionIndex, sqliteAvailable, } from './sqlite.js';
+//# sourceMappingURL=index.js.map

package/dist/store/session-index/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/session-index/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAMxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AA+MjE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAA;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAA;IACzC,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC;QACtE,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,CAAA;AAC3F,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAEjG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAO9D,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EACN,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,GACf,MAAM,aAAa,CAAA"}