@tenphi/akno-core 0.1.0

package/dist/ops/write.js

@@ -0,0 +1,463 @@
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { AknoError, WriteInput } from '@tenphi/akno-protocol';
+import { parsePage } from "../kb/page.js";
+import { declaredFrontmatter, readString, spliceAfterFence } from "../kb/frontmatter.js";
+import { detectConflict } from "../write/conflict.js";
+import { applyEdit } from "../write/edit.js";
+import { insertEvent, newLedger } from "../write/ledger.js";
+import { extract } from "../ingest/extract.js";
+import { provenanceLines, recordDocument, storeDocument } from "../ingest/store.js";
+import { fileEntry } from "../write/journal.js";
+import { writeFileAtomic } from "../write/atomic.js";
+import { ledgerSlug } from "../reserved.js";
+/**
+ * Create, append, patch or replace a page — and the only thing that
+ * actually happens on disk is that Markdown changes. There is no fact store to
+ * insert into: facts appear afterwards because the indexer re-derives them from
+ * the sentences that are now there.
+ *
+ * The order is deliberate. Gate before conflict before write before journal before
+ * index, so a write that is going to be refused is refused before anything is
+ * touched, and a write that lands is recorded before the indexer can be told
+ * about it.
+ */
+export async function write(ctx, rawInput) {
+    const input = WriteInput.parse(rawInput);
+    const actor = ctx.actor;
+    // An event with no slug is a real case, not a degenerate one: plenty of things
+    // happen that will never have a page. It goes straight to the ledger.
+    if (!input.slug && !input.propose_slug && input.event) {
+        return writeEventOnly(ctx, input.event, input.dry_run ?? false);
+    }
+    const slug = normalizeSlug(input.slug ?? input.propose_slug);
+    if (refusesLedgerProse({
+        slug,
+        ledger: ledgerSlug(ctx.config),
+        actor,
+        edit: input.content !== undefined ? 'content' : input.append !== undefined ? 'append' : null,
+    })) {
+        throw new AknoError('invalid', `'${slug}' is the event ledger: it takes events, not prose. Record the event with ` +
+            '`write({ event: { date, summary }, slug })` — the line is placed under its year for you — ' +
+            'and put what is true on the page the event is about.');
+    }
+    const existing = ctx.store.db.prepare('SELECT id, rel_path FROM pages WHERE slug = ?').get(slug);
+    // ── Gate ────────────────────────────────────────────────────────────────
+    if (!existing) {
+        const decision = ctx.gate.check(slug, actor);
+        if (!decision.allowed) {
+            return {
+                status: 'ok',
+                outcome: 'requires_folder',
+                requires_folder: decision.requiresFolder,
+                note: `'${decision.requiresFolder.folder}' has not been declared. Call \`folder\` with a ` +
+                    'description of what belongs there — nobody is asked and nothing waits on approval — ' +
+                    'then repeat this write. Or write into one of the folders that already exists.',
+            };
+        }
+    }
+    const relPath = existing?.rel_path ?? `${slug}.md`;
+    const absPath = path.join(ctx.config.aknoPath, relPath);
+    const before = existing ? await fsp.readFile(absPath, 'utf8') : null;
+    const edit = resolveEdit(input, before !== null);
+    const edited = before === null
+        ? { content: composeNewPage(input, slug, edit), firstChangedLine: null }
+        : applyEdit(before, edit);
+    if (edited.content === before) {
+        return { status: 'ok', outcome: 'noop', note: 'the page already reads exactly that way' };
+    }
+    // ── Conflict ────────────────────────────────────────────────────────────
+    if (existing && before !== null) {
+        const parsed = parsePage(relPath, before);
+        const conflict = detectConflict({
+            store: ctx.store,
+            pageId: existing.id,
+            slug,
+            body: parsed.body,
+            bodyStartLine: parsed.bodyLine,
+            incoming: incomingText(input, edit),
+            ...(input.resolve_conflict ? { resolveToken: input.resolve_conflict } : {}),
+        });
+        if (conflict) {
+            return {
+                status: 'ok',
+                outcome: 'conflict',
+                conflict,
+                note: 'an existing line claims something different. Ask the user which is current, then repeat the ' +
+                    'write with `resolve_conflict` set to the token above.',
+            };
+        }
+    }
+    if (input.dry_run) {
+        return {
+            status: 'ok',
+            outcome: 'ok',
+            wrote: [
+                {
+                    slug,
+                    action: existing ? actionFor(edit) : 'created',
+                    ...(edited.firstChangedLine ? { line: edited.firstChangedLine } : {}),
+                },
+            ],
+            note: 'dry run — nothing was written',
+        };
+    }
+    // ── Write ───────────────────────────────────────────────────────────────
+    const files = [];
+    const wrote = [];
+    const result = await writeFileAtomic(ctx.config.aknoPath, relPath, edited.content);
+    files.push(fileEntry(result));
+    wrote.push({
+        slug,
+        action: existing ? actionFor(edit) : 'created',
+        ...(edited.firstChangedLine ? { line: edited.firstChangedLine } : {}),
+    });
+    // The same storage rules, reached through `write` rather than `ingest`: content-addressed
+    // off the page basename, extracted on arrival, embedded in the page. The difference is
+    // only who chose the destination — here the caller did, so nothing is routed or named.
+    const attached = [];
+    if (input.documents?.length) {
+        for (const document of input.documents) {
+            const source = path.resolve(document.path);
+            if (!(await fsp.stat(source).catch(() => null))) {
+                throw new AknoError('not_found', `no file to attach at ${source}`);
+            }
+            const stored = await storeDocument({ ctx, source, pageSlug: slug, move: false });
+            files.push(stored.file);
+            const extraction = await extract({
+                absPath: source,
+                maxOcrPages: ctx.config.ingest.maxOcrPages,
+                maxBytes: ctx.config.ingest.maxFileBytes,
+                ...(ctx.models.vision.available ? { vision: ctx.models.vision } : {}),
+            });
+            attached.push({
+                relPath: stored.relPath,
+                extraction,
+                ...(document.label ? { label: document.label } : {}),
+            });
+            wrote.push({ slug, action: 'attached' });
+        }
+        // The page has to reference what is now beside it, or the attachment is orphaned from
+        // a reader's point of view even though the index knows about it.
+        const embedded = await appendEmbeds(ctx, relPath, attached, files[0]);
+        if (embedded)
+            files[0] = embedded;
+    }
+    // The ledger line and the page land in one change, so the promise holds:
+    // there is no way to get a ledger line whose detail page was never written.
+    if (input.event) {
+        const ledger = await appendToLedger(ctx, { ...input.event, slug });
+        // No file when the day already has this event: the page part of this change still stands, and
+        // the caller is still told which ledger line the event is on — the existing one.
+        if (ledger.file)
+            files.push(ledger.file);
+        wrote.push({ slug: ledgerSlug(ctx.config), line: ledger.line, action: 'event' });
+    }
+    const changeId = ctx.journal.record({
+        actor,
+        op: 'write',
+        summary: `${existing ? actionFor(edit) : 'created'} ${slug}${input.event ? ' + event' : ''}`,
+        files,
+    });
+    // ── Index ───────────────────────────────────────────────────────────────
+    // The indexer follows exactly as it would for a hand edit: line
+    // hashes moved, so old facts retire and new ones are derived from the new lines.
+    //
+    // It must run *before* anything records the new hash in `files`. Recording first
+    // makes the stat fast path conclude the file is unchanged and skip it — the page
+    // lands on disk and never reaches the index, which is the worst of both worlds.
+    // The indexer records the file itself as part of indexing it.
+    //
+    // Structure now, meaning now — the page is searchable by its own text, its links resolve, its
+    // documents exist. What is deferred is only the *reading* of it: summary, keywords, the claims a
+    // deriver finds in the sentences. Awaiting that put a cold local model, a minute to load, inside
+    // every write, and the tool calling it gave up at sixty seconds while the write itself had
+    // already landed.
+    const paths = files.map((file) => file.relPath);
+    const report = await ctx.indexer.runForeground({ only: paths, modelPaths: [] });
+    ctx.derive.schedule(paths);
+    // After indexing: the `documents` rows exist now, so the extraction can be recorded
+    // against them. The row keeps the *whole* text — the body carries a capped excerpt, and
+    // `read({document})` should not be limited by what fits comfortably in a page.
+    const documents = attached.map((entry) => {
+        const id = recordDocument({
+            ctx,
+            relPath: entry.relPath,
+            extraction: entry.extraction,
+            ...(entry.label ? { label: entry.label } : {}),
+        });
+        return { id: id ?? '', rel_path: entry.relPath, text_from: entry.extraction.via };
+    });
+    // A frontmatter rewrite is reported, never silent. The caller may not have realised the block
+    // it echoed back was a declaration, and dropping `temporal` or `management` changes how the
+    // page behaves for months without changing a word anybody reads.
+    const note = edited.frontmatter
+        ? `the frontmatter you sent replaced the page's` +
+            (edited.frontmatter.dropped.length > 0
+                ? `, dropping ${edited.frontmatter.dropped.map((key) => `\`${key}\``).join(', ')} — ` +
+                    `write again with those keys if that was not deliberate, or \`undo\` the change`
+                : '')
+        : null;
+    return {
+        status: 'ok',
+        outcome: 'ok',
+        change_id: changeId,
+        wrote,
+        facts: { retired: 0, added: report.factsDerived },
+        ...(documents.length > 0 ? { documents } : {}),
+        ...(note ? { note } : {}),
+    };
+}
+/**
+ * Adds `![[file]]` embeds for attachments the page does not already reference, and records
+ * each one's provenance beside it.
+ *
+ * The document's *text* is not written here. It is indexed against the document, where the
+ * file's hash can invalidate it and a hit can name the page within the file that produced
+ * it. Pasting it into the body as well made the same words arrive twice
+ * against one recall budget, and put a copy in the user's Markdown that no file change
+ * could ever correct.
+ *
+ * Appended rather than spliced: a page's structure belongs to whoever wrote it, and
+ * guessing where an embed "should" go would rewrite their layout.
+ */
+async function appendEmbeds(ctx, relPath, attached, pageEntry) {
+    const current = await fsp.readFile(path.join(ctx.config.aknoPath, relPath), 'utf8');
+    const additions = [];
+    for (const entry of attached) {
+        const name = path.basename(entry.relPath);
+        if (current.includes(name))
+            continue;
+        const provenance = provenanceLines(entry.extraction);
+        // Blank line between the embed and its provenance: a list crammed against an image
+        // reads as part of the image's caption.
+        additions.push(provenance.length > 0 ? `![[${name}]]\n\n${provenance.join('\n')}` : `![[${name}]]`);
+    }
+    if (additions.length === 0)
+        return null;
+    const next = `${current.replace(/\s+$/, '')}\n\n${additions.join('\n\n')}\n`;
+    const written = await writeFileAtomic(ctx.config.aknoPath, relPath, next);
+    // The page entry was recorded before the embeds existed; replace its `after` so undo
+    // restores the version that was actually on disk when the change completed.
+    return { ...pageEntry, after: written.after };
+}
+/**
+ * **The ledger takes events. It does not take prose.**
+ *
+ * `append` and `content` write at the *end of the body*, and the end of the ledger's body is
+ * below the last year heading — outside every `- **YYYY-MM-DD** |` line the event parser
+ * matches. A claim put there is not merely in the wrong place: it is in a file that will never
+ * read it back, and it is a second copy of something whose home is the page it belongs to.
+ *
+ * This is not a hypothetical. `remember` routes claims by recall, the ledger is a plain `full`
+ * page, and a ledger that already mentions a subject scores highest *for that subject* — so a
+ * claim about an ongoing complaint landed under the event list of the very page recording it.
+ * Routing now skips reserved paths, and this is the layer under it: a guard in the prompt or in
+ * the caller is a guard that the next caller does not have.
+ *
+ * `patch` and `replace` are allowed through. Both are line-targeted and cannot append at the
+ * bottom, so a line that went in wrong stays correctable — which the ledger's own append-only
+ * rule needs, since a wrong line is corrected rather than removed.
+ *
+ * `akno` is exempt: a verified `broken_link` curation item rewrites link targets, and a ledger
+ * line whose page was renamed is exactly the kind of thing it exists to fix.
+ */
+export function refusesLedgerProse(input) {
+    if (input.actor === 'akno')
+        return false;
+    if (input.slug !== input.ledger)
+        return false;
+    return input.edit === 'append' || input.edit === 'content';
+}
+// ─── Event-only write ───────────────────────────────────────────────────────
+async function writeEventOnly(ctx, event, dryRun) {
+    if (dryRun) {
+        return {
+            status: 'ok',
+            outcome: 'ok',
+            wrote: [{ slug: ledgerSlug(ctx.config), action: 'event' }],
+            note: 'dry run — nothing was written',
+        };
+    }
+    const ledger = await appendToLedger(ctx, event);
+    // The day already has this event. Journalling anyway would put a change in `undo --list` that
+    // reverses nothing, and tell the caller something was kept when the ledger is exactly as it was.
+    if (!ledger.file) {
+        return {
+            status: 'ok',
+            outcome: 'noop',
+            note: 'the ledger already records this event for that date',
+            wrote: [{ slug: ledgerSlug(ctx.config), line: ledger.line, action: 'event' }],
+        };
+    }
+    const changeId = ctx.journal.record({
+        actor: ctx.actor,
+        op: 'write',
+        summary: `event ${event.date}: ${event.summary.slice(0, 60)}`,
+        files: [ledger.file],
+    });
+    await ctx.indexer.runForeground({ only: [ledger.file.relPath], modelPaths: [] });
+    // The ledger's events are parsed structurally, above — this is for the summary and any claims in
+    // the prose around them, which nobody is waiting on.
+    ctx.derive.schedule([ledger.file.relPath]);
+    return {
+        status: 'ok',
+        outcome: 'ok',
+        change_id: changeId,
+        // Addressable as `timeline:47`, so it obeys the same provenance rule as
+        // everything else — the ledger is a page like any other.
+        wrote: [{ slug: ledgerSlug(ctx.config), line: ledger.line, action: 'event' }],
+    };
+}
+export async function appendToLedger(ctx, event) {
+    const relPath = ctx.config.paths.timeline;
+    const absPath = path.join(ctx.config.aknoPath, relPath);
+    let current;
+    try {
+        current = await fsp.readFile(absPath, 'utf8');
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+        current = newLedger(event.date.slice(0, 4));
+    }
+    const inserted = insertEvent(current, event);
+    // Nothing to write: the day already has this event, in these words or in others. Rewriting the
+    // file with its own bytes would journal a change that added nothing — `undo --list` would offer
+    // to reverse an event that was never appended, and the caller would be told it had been kept.
+    if (inserted.content === current)
+        return { file: null, line: inserted.line };
+    const result = await writeFileAtomic(ctx.config.aknoPath, relPath, inserted.content);
+    return { file: fileEntry(result), line: inserted.line };
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function resolveEdit(input, exists) {
+    if (input.content !== undefined)
+        return { kind: 'content', content: input.content };
+    if (input.append !== undefined) {
+        return { kind: 'append', text: input.append, ...(input.section ? { section: input.section } : {}) };
+    }
+    if (input.patch !== undefined)
+        return { kind: 'patch', patch: input.patch };
+    if (input.replace !== undefined) {
+        return { kind: 'replace', find: input.replace.find, with: input.replace.with };
+    }
+    if (!exists) {
+        throw new AknoError('invalid', 'a new page needs `content`; there is nothing to append to or patch');
+    }
+    throw new AknoError('invalid', 'write needs one of: content, append, patch, replace');
+}
+function actionFor(edit) {
+    switch (edit.kind) {
+        case 'content':
+            return 'replaced';
+        case 'append':
+            return 'appended';
+        case 'patch':
+            return 'patched';
+        case 'replace':
+            return 'replaced';
+    }
+}
+/** Only the text being introduced is worth checking for conflicts. */
+function incomingText(input, edit) {
+    switch (edit.kind) {
+        case 'content':
+            // A declaration is not a claim. `role: knowledge` is not the page asserting anything
+            // about the world, and scanning it for conflicts finds pairs that mean nothing.
+            return declaredFrontmatter(edit.content)?.body ?? edit.content;
+        case 'append':
+            return edit.text;
+        case 'replace':
+            return edit.with;
+        case 'patch':
+            // Only the added lines: a context line is not a new claim.
+            return input
+                .patch.split('\n')
+                .filter((line) => line.startsWith('+') && !line.startsWith('+++'))
+                .map((line) => line.slice(1))
+                .join('\n');
+    }
+}
+/**
+ * A new page gets frontmatter only for what the caller actually said. Akno
+ * inventing a `type` or a `tags` list would be putting words in the user's
+ * knowledge base that nobody chose.
+ *
+ * Composed directly rather than seeded-then-edited: `content` means "this is the
+ * body", so running it through the body editor discarded the `# Title` heading the
+ * seed had just added, and left the frontmatter fence flush against the first line.
+ *
+ * A caller who wrote their own frontmatter keeps it verbatim — the same courtesy the body
+ * already extends to a caller who wrote their own `# Heading`, and the same rule `applyEdit`
+ * follows for a page that already exists. `title`, `type` and `tags` then fill in only the
+ * keys the block left out, because an argument and a block that both say `title` are one
+ * intent stated twice and the block is the more specific statement of it.
+ */
+function composeNewPage(input, slug, edit) {
+    const supplied = edit.kind === 'content' ? edit.content : edit.kind === 'append' ? edit.text : '';
+    const declared = edit.kind === 'content' ? declaredFrontmatter(supplied) : null;
+    const title = readString(declared?.data ?? {}, 'title') ?? input.title ?? titleFromSlug(slug);
+    const body = (declared?.body ?? supplied).trim();
+    // A caller who wrote their own heading keeps it; one who did not gets the title
+    // as an H1, because a page whose body starts mid-sentence reads as a fragment.
+    const heading = /^#{1,6}\s/.test(body) ? '' : `# ${title}\n\n`;
+    const links = input.links?.length
+        ? `\n\n${input.links.map((link) => `Related: [[${link}]]`).join('\n')}`
+        : '';
+    if (declared) {
+        const missing = [
+            declared.data.title === undefined ? `title: ${title}` : null,
+            input.type && declared.data.type === undefined ? `type: ${input.type}` : null,
+            input.tags?.length && declared.data.tags === undefined ? `tags: [${input.tags.join(', ')}]` : null,
+        ].filter((line) => line !== null);
+        return `${spliceAfterFence(declared.head, missing)}\n${heading}${body}${links}\n`;
+    }
+    const front = [`title: ${title}`];
+    if (input.type)
+        front.push(`type: ${input.type}`);
+    if (input.tags?.length)
+        front.push(`tags: [${input.tags.join(', ')}]`);
+    return `---\n${front.join('\n')}\n---\n\n${heading}${body}${links}\n`;
+}
+export function titleFromSlug(slug) {
+    const base = slug.split('/').pop() ?? slug;
+    return base.replace(/[-_]+/g, ' ').replace(/\b\w/g, (char) => char.toUpperCase());
+}
+export function normalizeSlug(raw) {
+    const slug = raw
+        .trim()
+        .replace(/\\/g, '/')
+        .replace(/\.(md|markdown)$/i, '')
+        .replace(/\/+/g, '/');
+    // A caller must not be able to name a file outside the folder the user pointed
+    // Akno at, whatever it sends. An absolute path is **rejected, not stripped**:
+    // quietly reading `/etc/passwd` as `etc/passwd` writes somewhere the caller did
+    // not ask for and then cannot find.
+    const safe = slug.length > 0 &&
+        slug.length <= 512 &&
+        !slug.startsWith('/') &&
+        !slug.startsWith('~') &&
+        !/^[a-zA-Z]:/.test(slug) &&
+        !slug.includes('\0') &&
+        slug.split('/').every((segment) => segment !== '');
+    if (!safe)
+        throw new AknoError('invalid', `not a usable slug: ${raw}`);
+    // **Akno ignores dot paths, so it must refuse to create one.** `scanTree`, the
+    // watcher, the folder catalog and both ingest walks all skip any name starting with
+    // a dot — that is where Obsidian, git and sync clients keep working state, and none
+    // of it is a note. A slug that lands in one is therefore written and then invisible
+    // to everything: `indexer.run({only})` *filters the scan output* rather than
+    // bypassing it, so the file is never indexed, and recall, read and list will all
+    // say the page does not exist while it sits on disk. `.git/config` was accepted and
+    // would have put a stray `config.md` inside the git directory.
+    //
+    // This subsumes `.` and `..`, which were the only two rejected before.
+    const dotted = slug.split('/').find((segment) => segment.startsWith('.'));
+    if (dotted !== undefined) {
+        throw new AknoError('invalid', `'${dotted}' starts with a dot, and Akno does not index dot paths — a page there would be ` +
+            `written and then invisible to recall. Choose a name without the leading dot.`, { slug: raw, segment: dotted });
+    }
+    return slug;
+}
+//# sourceMappingURL=write.js.map

package/dist/ops/write.js.map

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

package/dist/recall/assemble.d.ts

@@ -0,0 +1,81 @@
+import type { Card, Depth, PageRole, RecallMode, RecallResult } from '@tenphi/akno-protocol';
+import type { AknoConfig } from '../config/schema.ts';
+import type { Store } from '../store/db.ts';
+import type { ChunkHit } from './search.ts';
+export interface AssembleOptions {
+    hits: ChunkHit[];
+    mode: RecallMode;
+    depth: Depth;
+    limit: number;
+    budget: number;
+    /** Body lines per card: lookup gets deep windows, question gets tight ones. */
+    lineWindow: number;
+    /** Concepts the query asked about. Terms are matched against what came back. */
+    concepts: string[];
+    /** `include: ['source'], depth: 'full'` lifts the source quote cap. */
+    include: PageRole[] | null;
+}
+export interface Assembled {
+    results: RecallResult[];
+    cards: Card[];
+    budgetUsed: number;
+    coverage: Record<string, boolean> | null;
+    droppedCards: number;
+}
+/**
+ * Recall returns page or document cards — never chunks. A chunk boundary is an
+ * indexing artifact and means nothing to a reader.
+ */
+export declare class Assembler {
+    #private;
+    constructor(config: AknoConfig, store: Store);
+    assemble(options: AssembleOptions): Assembled;
+    private pageResult;
+    /**
+     * Ranking policy lives in the layer: knowledge pages outrank source pages,
+     * which outrank derived inferences. A folder rule can set `rank` to
+     * adjust it. Role applies at **assembly**, not at search — source pages
+     * compete for relevance on equal terms, then come back capped.
+     */
+    private rankFactor;
+    private pageRow;
+    private documentRow;
+    private buildDocumentCard;
+    private buildCard;
+    /**
+     * Reads the matching lines from the file rather than from the chunk text, so a
+     * line's number is the number it actually has on disk. A citation that points
+     * at the wrong line is worse than no citation: cite or stay quiet.
+     */
+    private readLines;
+    private factsFor;
+    private linksFor;
+    /**
+     * The page's attachments, with the matching text quoted from any that matched.
+     *
+     * The card points at the page, the document, **and the page number within it**. That
+     * is the whole reason document text is chunked per page — a quote from page 9 of a
+     * contract attributed to nothing is a citation a reader cannot check.
+     *
+     * A document that matched is always included, even past the display cap: dropping the one
+     * that produced the hit would leave a card quoting evidence it does not list.
+     */
+    private documentsFor;
+    /** One query for every hit chunk's metadata, rather than one per hit inside two loops. */
+    private chunkMeta;
+}
+/**
+ * Deterministic — did the key terms of the expanded query actually appear in
+ * what was returned — **not** a model judging whether the answer is there. Cheap,
+ * honest, and it closes the most common hallucination path there is: a page ranks
+ * first because it matches half the question, the agent reads it, and confidently
+ * invents the other half.
+ */
+export declare function computeCoverage(concepts: string[], results: Array<Card | RecallResult>): Record<string, boolean>;
+/**
+ * Four characters per token. Crude, but the budget's job is to stop an overrun,
+ * and a tokenizer per model would make the number precise about the wrong thing —
+ * the caller's budget is a ceiling, not an accounting target.
+ */
+export declare function estimateTokens(card: Card | RecallResult): number;
+//# sourceMappingURL=assemble.d.ts.map

package/dist/recall/assemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../src/recall/assemble.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,IAAI,EACJ,KAAK,EAGL,QAAQ,EACR,UAAU,EAGV,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAK5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uEAAuE;IACvE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD;;;GAGG;AACH,qBAAa,SAAS;;gBAIR,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK;IAK5C,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS;IA4G7C,OAAO,CAAC,UAAU;IAYlB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;IAmEzB,OAAO,CAAC,SAAS;IAwDjB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IA6CjB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,QAAQ;IAShB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IAuFpB,0FAA0F;IAC1F,OAAO,CAAC,SAAS;CAUlB;AAcD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAoBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,GAAG,MAAM,CAwBhE"}