@nanonets/graft 0.24.0 → 0.24.1

package/dist/skills/versions.js

@@ -0,0 +1,351 @@
+/**
+ * Kept versions of a personal skill (phase 2 design 2.1, 4.5, 4.6, 4.12):
+ * `skills/<name>/.versions/`. Trail writes a new SKILL.md only over the file
+ * it wrote itself, byte for byte (0 rule 2), and only after the file it is
+ * about to replace is kept as `v<n>/` (0 rule 3). A file the person changed
+ * is never written: the change goes beside it as `proposed-v<n>/`, with the
+ * person's file kept as `hand-<date>/`, and Trail takes the file as its own
+ * again only when the person copied the proposal over it, byte for byte.
+ *
+ * A write marks itself in the state first (`pendingWrite`, R8), so a process
+ * killed between the new file and the state is finished on the next read
+ * instead of looking hand-edited forever. A state that can't be written
+ * puts the old file back (D68). Every path refuses a link, a file that isn't
+ * regular, or one over 64 KB, and fails closed: nothing changes.
+ *
+ * This module never imports the fold (fold.ts imports recall.ts, which
+ * calls `adoptIfCopied`): it writes text it is given.
+ */
+import { readdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseSkillMd, renderSkillMd, skillHash } from './skillmd.js';
+import { getSkillState, updateSkillState } from './state.js';
+import { appendLedger } from './ledger.js';
+import { underStoreLock } from './store-fs.js';
+import { phraseSha } from './staleness.js';
+import { rebuildCompiled } from './skill-rebuild.js';
+import { printDiff } from './skill-diff.js';
+import { writePrivate } from '../util/private-fs.js';
+import { copyFlat, keepFolder, keepHand, lessonFiles, LinkError, lst, moveLessons, ownDir, prune, regularText, swapScripts, V_DIR, versionsDir, } from './versions-fs.js';
+export { versionsDir } from './versions-fs.js';
+export const VERSIONS_KEPT = 10;
+/** Test seam: runs right before the write's state update (step 4), so a test can hold the state lock. */
+export const VERSION_SEAMS = {};
+/** Kept version numbers, ascending: `v<n>` folders only (links and files skipped). */
+export function listVersions(ref) {
+    let names;
+    try {
+        if (!lst(versionsDir(ref))?.isDirectory())
+            return [];
+        names = readdirSync(versionsDir(ref));
+    }
+    catch {
+        return [];
+    }
+    return names.flatMap((n) => {
+        const m = V_DIR.exec(n);
+        return m && lst(join(versionsDir(ref), n))?.isDirectory() ? [Number(m[1])] : [];
+    }).sort((a, b) => a - b);
+}
+/** The number the next written version gets: one past both the file's own and every kept one. */
+export function nextVersion(ref, current) {
+    return Math.max(current, 0, ...listVersions(ref)) + 1;
+}
+const intOf = (v) => (typeof v === 'string' && /^[1-9]\d{0,5}$/.test(v) ? Number(v) : 1);
+/** 2.2: what a new version resets. Uses, checked uses, where it came from and when it was added stay. */
+function versionReset(s, hash, asks, at) {
+    s.hash = hash;
+    s.status = 'candidate';
+    s.changedAt = at;
+    s.firings = [];
+    s.lastFails = [];
+    delete s.statusWhy;
+    delete s.prevStatus;
+    delete s.fixHash;
+    s.proposed = null;
+    s.pendingWrite = null;
+    const keep = new Set(asks.split(',').map((p) => p.trim()).filter(Boolean).map(phraseSha));
+    if (s.cueMisses && typeof s.cueMisses === 'object')
+        s.cueMisses = Object.fromEntries(Object.entries(s.cueMisses).filter(([k]) => keep.has(k)));
+}
+const clearPending = (id, env) => {
+    try {
+        updateSkillState(id, (s) => (s ? { ...s, pendingWrite: null } : s), env);
+    }
+    catch { /* the marker is harmless: its hash isn't the file's */ }
+};
+/** 4.5 steps 1 to 6 under the store lock, then the state lock. */
+function commit(ref, c, env, now) {
+    if (ref.scope !== 'personal')
+        return { ok: false, why: 'changed' };
+    try {
+        return underStoreLock(env, () => commitLocked(ref, c, env, now));
+    }
+    catch (e) {
+        if (e instanceof LinkError)
+            return { ok: false, why: 'link' };
+        return { ok: false, why: /busy/.test(e instanceof Error ? e.message : '') ? 'busy' : 'io' };
+    }
+}
+function commitLocked(ref, c, env, now) {
+    // 1. The folder and the file are Trail's: no link, a regular file of at most 64 KB, Trail's own bytes.
+    const dirSt = lst(ref.dir);
+    if (!dirSt || dirSt.isSymbolicLink())
+        return { ok: false, why: dirSt ? 'link' : 'io' };
+    if (!dirSt.isDirectory())
+        return { ok: false, why: 'io' };
+    const vs = lst(versionsDir(ref));
+    if (vs && !vs.isDirectory())
+        return { ok: false, why: 'link' };
+    const fileSt = lst(ref.file);
+    if (fileSt?.isSymbolicLink())
+        return { ok: false, why: 'link' };
+    const text = regularText(ref.file);
+    if (text === null)
+        return { ok: false, why: 'changed' };
+    const parsed = parseSkillMd(text, ref.name);
+    const st = getSkillState(ref.id, env);
+    if (!parsed || parsed.meta.trail !== ref.id || !st || st.scope !== 'personal')
+        return { ok: false, why: 'changed' };
+    const hash = skillHash(text);
+    const handEdited = hash !== st.hash;
+    if (c.baseHash !== null && (handEdited || hash !== c.baseHash))
+        return { ok: false, why: 'changed' };
+    const from = intOf(parsed.meta.version);
+    const to = nextVersion(ref, from);
+    if (c.expect !== undefined && c.expect !== to)
+        return { ok: false, why: 'changed' };
+    const next = c.render(to);
+    const nextHash = skillHash(next);
+    const at = now.toISOString();
+    if (!updateSkillState(ref.id, (s) => (s ? { ...s, pendingWrite: { hash: nextHash, from, at } } : s), env))
+        return { ok: false, why: 'busy' };
+    let swap = null;
+    try {
+        // 2. The file it replaces is kept first: Trail's own as v<from>, a hand-edited one (a restore only) as hand-<date>.
+        let keptAs = null;
+        if (handEdited)
+            keepHand(ref, text, now);
+        else {
+            keptAs = `v${from}`;
+            if (keepFolder(ref, keptAs, text, join(ref.dir, 'scripts')) === 'changed') {
+                clearPending(ref.id, env);
+                return { ok: false, why: 'changed' };
+            }
+        }
+        // 3. The new file (temp file and rename), and for a replace or restore its scripts.
+        if (c.helpers)
+            swap = swapScripts(ref, { helpers: c.helpers });
+        else if (c.restoreFrom && lst(join(c.restoreFrom, 'scripts'))?.isDirectory())
+            swap = swapScripts(ref, { from: join(c.restoreFrom, 'scripts') });
+        writePrivate(ref.file, next);
+        if (regularText(ref.file) !== next)
+            throw new Error('trail: the new SKILL.md did not read back');
+        // 4. The state, then the ledger line. A state that can't be written puts the old file back (D68).
+        VERSION_SEAMS.beforeState?.();
+        const asks = String(parseSkillMd(next, ref.name)?.meta.asks ?? '');
+        const done = updateSkillState(ref.id, (s) => {
+            if (!s)
+                return s;
+            versionReset(s, nextHash, asks, at);
+            return s;
+        }, env);
+        if (!done) {
+            putBack(ref, text, swap);
+            swap = null;
+            clearPending(ref.id, env);
+            return { ok: false, why: 'busy' };
+        }
+        try {
+            swap?.done();
+        }
+        catch { /* the old scripts stay in a dot folder nobody reads */ }
+        swap = null;
+        try {
+            appendLedger(ref.id, { at, event: 'changed', skill: ref.id, op: c.op, from, to, offerId: c.offerId, ...(c.lessonIds?.length ? { lessonIds: c.lessonIds } : {}) }, env);
+        }
+        catch { /* the state is the truth; the ledger is its record */ }
+        // 5. Lessons: folded ones move to lessons/.folded; a replace's go with the old version; a restore brings its own back.
+        try {
+            const files = lessonFiles(ref.dir);
+            if (c.lessonIds?.length)
+                moveLessons(ref.dir, files.filter((f) => c.lessonIds.includes(f.id)), join(ref.dir, 'lessons', '.folded'));
+            if (c.replace && keptAs)
+                moveLessons(ref.dir, files.filter((f) => !f.guardrail), join(versionsDir(ref), keptAs, 'lessons'));
+            if (c.restoreFrom && lst(join(c.restoreFrom, 'lessons'))?.isDirectory()) {
+                const have = new Set(files.map((f) => f.name));
+                copyFlat(join(c.restoreFrom, 'lessons'), join(ref.dir, 'lessons'), 0o600, (n) => n.endsWith('.md') && !have.has(n));
+            }
+        }
+        catch { /* a lesson left riding the block is harmless */ }
+        // 6. Ten kept versions.
+        prune(ref, V_DIR, VERSIONS_KEPT);
+        return { ok: true, version: to };
+    }
+    catch (e) {
+        putBack(ref, text, swap);
+        clearPending(ref.id, env);
+        if (e instanceof LinkError)
+            return { ok: false, why: 'link' };
+        return { ok: false, why: 'io' };
+    }
+}
+/** The old file (and scripts) back, when it isn't already. */
+function putBack(ref, text, swap) {
+    try {
+        if (regularText(ref.file) !== text)
+            writePrivate(ref.file, text);
+    }
+    catch { /* the marker lets the next read tell the new file from a hand edit */ }
+    try {
+        swap?.undo();
+    }
+    catch { /* scripts/ as the new version left it */ }
+}
+/**
+ * 4.5: keeps the current file, writes `next` as the next version, updates state and the ledger. `next.meta.version`
+ * must be that next number (`nextVersion`), or nothing is written: the bytes written are the bytes shown.
+ */
+export function writeNewVersion(ref, next, o) {
+    if (typeof o.baseHash !== 'string' || !o.baseHash)
+        return { ok: false, why: 'changed' };
+    const replace = o.op === 'replace';
+    return commit(ref, {
+        render: (v) => renderSkillMd({ ...next, meta: { ...next.meta, version: String(v) } }),
+        op: o.op, offerId: o.offerId, baseHash: o.baseHash, lessonIds: o.op === 'extend' ? o.lessonIds : undefined,
+        // A fold keeps scripts/ as it is (a rebuilt skill's helpers are names only); a replace writes the fresh compile's (R22).
+        helpers: replace ? next.helpers : null, replace, expect: Number(next.meta.version),
+    }, o.env, o.now ?? new Date());
+}
+/* ---------------------------------------------------------- hand edits (4.6) */
+/** 4.6: the proposal beside a hand-edited file, the person's file kept as hand-<date>. Never touches SKILL.md. */
+export function writeProposal(ref, next, op, env, now = new Date()) {
+    if (ref.scope !== 'personal')
+        return null;
+    try {
+        return underStoreLock(env, () => {
+            const dirSt = lst(ref.dir);
+            if (!dirSt?.isDirectory() || lst(ref.file)?.isSymbolicLink())
+                return null;
+            const current = regularText(ref.file);
+            if (current === null)
+                return null;
+            const version = intOf(next.meta.version);
+            const text = renderSkillMd(next);
+            const name = `proposed-v${version}`;
+            // One proposal at a time: an older one goes first.
+            ownDir(versionsDir(ref));
+            for (const n of readdirSync(versionsDir(ref)))
+                if (/^proposed-/.test(n) && n !== name)
+                    rmSync(join(versionsDir(ref), n), { recursive: true, force: true });
+            if (lst(join(versionsDir(ref), name)))
+                rmSync(join(versionsDir(ref), name), { recursive: true, force: true });
+            keepFolder(ref, name, text, null);
+            const hand = keepHand(ref, current, now);
+            const done = updateSkillState(ref.id, (s) => (s ? { ...s, proposed: { hash: skillHash(text), version, op, at: now.toISOString() } } : s), env);
+            if (!done)
+                return null;
+            const path = join(versionsDir(ref), name, 'SKILL.md');
+            return { path, hand, version, diff: printDiff(current, text, [`${ref.name}/SKILL.md (yours)`, `${ref.name}/.versions/${name}/SKILL.md`]) };
+        });
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 4.6 and R8, from a read of the file (`candidatesHere`): a file equal to an unfinished write's hash finishes it; one
+ * equal to the state's hash clears a stale marker; one equal to the proposal is taken as Trail's own (adopted). True
+ * when the file was adopted. One compare when nothing is pending; the locks only on a match.
+ */
+export function adoptIfCopied(ref, st, fileHash, env, now = new Date()) {
+    if (!st || ref.scope !== 'personal' || typeof fileHash !== 'string')
+        return false;
+    const pending = st.pendingWrite && typeof st.pendingWrite === 'object' ? st.pendingWrite : null;
+    const proposed = st.proposed && typeof st.proposed === 'object' ? st.proposed : null;
+    if (pending && (fileHash === pending.hash || fileHash === st.hash)) {
+        // Under the store lock (a try): a write still running holds it, so its own new file is never "finished" here and
+        // then put back by that write (D68), which would leave Trail's file looking hand-edited. The file is read again inside.
+        try {
+            underStoreLock(env, () => {
+                const text = regularText(ref.file);
+                const now = text === null ? null : skillHash(text);
+                if (now !== fileHash)
+                    return;
+                const asks = fileHash === pending.hash ? String(parseSkillMd(text, ref.name)?.meta.asks ?? '') : null;
+                updateSkillState(ref.id, (s) => {
+                    if (!s?.pendingWrite)
+                        return s;
+                    if (fileHash === s.pendingWrite.hash)
+                        versionReset(s, fileHash, asks ?? '', s.pendingWrite.at);
+                    else if (fileHash === s.hash)
+                        s.pendingWrite = null;
+                    return s;
+                }, env);
+            }, 200);
+        }
+        catch { /* busy: the next read finishes it */ }
+        return false;
+    }
+    if (!proposed || fileHash !== proposed.hash)
+        return false;
+    let adopted = false;
+    try {
+        underStoreLock(env, () => {
+            const text = regularText(ref.file);
+            if (text === null || skillHash(text) !== fileHash || lst(ref.dir)?.isSymbolicLink())
+                return;
+            const asks = String(parseSkillMd(text, ref.name)?.meta.asks ?? '');
+            const at = now.toISOString();
+            const done = updateSkillState(ref.id, (s) => {
+                if (!s?.proposed || s.proposed.hash !== fileHash)
+                    return s;
+                versionReset(s, fileHash, asks, at);
+                adopted = true;
+                return s;
+            }, env);
+            if (!done || !adopted)
+                return;
+            try {
+                appendLedger(ref.id, { at, event: 'changed', skill: ref.id, op: 'adopted', from: Math.max(0, proposed.version - 1), to: proposed.version, offerId: null }, env);
+            }
+            catch { /* the state is the truth */ }
+            try {
+                rmSync(join(versionsDir(ref), `proposed-v${proposed.version}`), { recursive: true, force: true });
+            }
+            catch { /* left beside it */ }
+        }, 200);
+    }
+    catch {
+        return false;
+    }
+    return adopted;
+}
+/* ------------------------------------------------------- restore (4.12, P28) */
+/**
+ * 4.12, person only (the CLI checks the terminal; the agent guard denies `restore-version`): `.versions/v<n>/` back
+ * as a new version. The current file is kept first (a hand-edited one as hand-<date>, R6). The restored file's
+ * `version` is rewritten to the new number through the round trip; one that doesn't round-trip goes back as it is.
+ */
+export function restoreVersion(ref, version, env, now = new Date()) {
+    if (!Number.isSafeInteger(version) || version < 1)
+        return { ok: false, why: 'unknown' };
+    const from = join(versionsDir(ref), `v${version}`);
+    const fs = lst(from);
+    if (fs?.isSymbolicLink() || lst(versionsDir(ref))?.isSymbolicLink())
+        return { ok: false, why: 'link' };
+    const old = fs?.isDirectory() ? regularText(join(from, 'SKILL.md')) : null;
+    const parsed = old === null ? null : parseSkillMd(old, ref.name);
+    if (old === null || !parsed || parsed.meta.trail !== ref.id)
+        return { ok: false, why: 'unknown' };
+    const st = getSkillState(ref.id, env);
+    const rebuilt = rebuildCompiled(old, parsed, { source: st?.source ?? null, helpers: [], runId: st?.runId ?? null });
+    const r = commit(ref, {
+        render: (v) => (rebuilt ? renderSkillMd({ ...rebuilt, meta: { ...rebuilt.meta, version: String(v) } }) : old),
+        op: 'restore-version', offerId: null, baseHash: null, restoreFrom: from,
+    }, env, now);
+    if (r.ok)
+        return r;
+    return { ok: false, why: r.why === 'changed' ? 'io' : r.why };
+}
+//# sourceMappingURL=versions.js.map

package/dist/skills/versions.js.map

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

package/dist/trace/checks.d.ts

@@ -0,0 +1,63 @@
+import type { CallKind, CheckFamily, CheckHit, JobClass, PromptParams, RunCall } from './types.js';
+export interface RunFacts {
+    /** Values seen earlier in the run that a check can confirm. */
+    versions: string[];
+    shas: string[];
+    pushedBranches: string[];
+    pr?: string;
+    /** A publish worked in this run: with no version known, npm view may show any (4.2). */
+    published?: boolean;
+    /** D140: a push or a deploy step worked in this run, so a health read after it is a deploy check. */
+    deployed?: boolean;
+}
+/** npm-view, deploy, gh-checks, ls-remote: they only read, so a non-final one is look-only (4.5 step 2). */
+export declare const READ_ONLY_FAMILIES: ReadonlySet<CheckFamily>;
+/**
+ * The commit a skill works out when it runs: `$(git rev-parse HEAD)` (the `{sha}` default), `--short`, `--verify`
+ * (D71 c). A deploy status read at it is a deploy check like one at a written-out sha; it just names no sha.
+ */
+export declare const HEAD_SHA: string;
+/** The family a command belongs to, from the command alone. Cheap: PostToolUse uses it to decide whether to write a mark. */
+export declare function checkFamilyOf(cmd: string, job: JobClass | null): CheckFamily | null;
+/**
+ * What a Bash call is (4.1): plumbing, work, look or step. A simple command
+ * that is a read-only check (npm view, a deploy status, CI checks, ls-remote)
+ * only reads, so it counts as look; the rest of the command still decides.
+ */
+export declare function callKind(cmd: string, job: JobClass | null): CallKind;
+/**
+ * A call's command as text: `cmd`, or for a call kept piece by piece (over 2,000 characters, D58c) its pieces
+ * joined by their separators, a piece not kept standing as `:`.
+ */
+export declare function callText(c: Pick<RunCall, 'cmd' | 'parts'>): string;
+/** `v` (with or without a leading v) as a whole version in `text`: 1.4.3 is not in 1.4.30. */
+export declare const hasVersion: (text: string, v: string) => boolean;
+/**
+ * D101: the call ends in `|| <fallback>` (`docker info || echo "docker not running"`, `npm test || true`), so its
+ * exit 0 may come from the fallback alone. Such a call is never a passing check, and a run proven only by such
+ * calls is not a good run. One top-level split: linear.
+ */
+export declare function fallbackOnly(cmd: string): boolean;
+/** 4.2. The `query` family only when job === 'report'. D101: never passed behind a fallback. */
+export declare function classifyCheck(cmd: string, resultText: string, r: {
+    failed: boolean;
+    isError: boolean;
+}, facts: RunFacts, job: JobClass | null): CheckHit | null;
+/** A deployment status tool: its result is check evidence for the deploy family, and the call is never a step (D59b). */
+export declare function isDeployTool(name: string): boolean;
+/**
+ * D59b: a Vercel deployment status result as a deploy check. Passed when the deployment is READY. `get_deployment`
+ * reads the deployment the agent named (as `vercel inspect <url>` does). A list is Trail's pick: the newest
+ * deployment, or when the run knows commits (`facts.shas`) and the list names commits, the newest at one of them
+ * (READY for another commit is not this push). Any other state (BUILDING, QUEUED, INITIALIZING, ERROR, CANCELED,
+ * BLOCKED) or a failed call is not a pass. Null for any other tool.
+ */
+export declare function classifyToolCheck(name: string, resultText: string, r: {
+    failed: boolean;
+    isError: boolean;
+}, facts: RunFacts): CheckHit | null;
+export declare function factsFromCalls(calls: RunCall[], prompt: PromptParams): RunFacts;
+/** 4.3, on the last assistant message of the turn. */
+export declare function endsInQuestion(assistantText: string): boolean;
+export declare function endsInFailure(assistantText: string): boolean;
+//# sourceMappingURL=checks.d.ts.map

package/dist/trace/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../src/trace/checks.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4GAA4G;AAC5G,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,WAAW,CAA0E,CAAC;AAEnI;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAqF,CAAC;AAkF3G,6HAA6H;AAC7H,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAQpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,MAAM,CAIlE;AAMD,8FAA8F;AAC9F,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,EAAE,GAAG,MAAM,YAA2E,CAAC;AA8E9H;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAG/J;AAuDD,yHAAyH;AACzH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlD;AAyCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAQ9I;AA0DD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,QAAQ,CA+B/E;AAaD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE5D"}