@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/lesson-gate.js

@@ -0,0 +1,316 @@
+import { readdirSync, readFileSync, lstatSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { skillsGate, withSkillSession } from '../trace/skill-session.js';
+import { classifyAnswer } from '../trace/typed.js';
+import { readRunSheet } from '../trace/runs.js';
+import { flatLine } from '../notes/flatten.js';
+import { parseNote } from '../notes/notes.js';
+import { readJsonSafe, trailPath, withLock, writePrivate } from '../util/private-fs.js';
+import { hookError } from '../claude/skills-hook-util.js';
+import { localDate, skillsOn } from './settings.js';
+import { hostFacts } from './host-facts.js';
+import { codexSandboxRefusal } from './codex-sandbox.js';
+import { endsWithLine } from './offer-words.js';
+import { isLessonOffer } from './offer-words-1b.js';
+import { correctionLesson, offerLinesOf } from './offer-lines.js';
+import { fixedWords, lessonWhere, repairLessonText, REPAIR_COPY } from './offer-repair.js';
+import { LESSON_COPY, lessonRefused, lessonSha, newLessonId, writeLesson } from './lessons.js';
+import { appendLedger } from './ledger.js';
+import { underStoreLock } from './store-fs.js';
+import { receiptPath, receiptTranscriptOk, receiptTranscriptRead, typedLineStillThere } from './receipts.js';
+import { dialectUse, personLine, replyBefore } from './save-verify.js';
+import { parseSkillsLesson, SKILLS_LESSON_RE } from './save-parse.js';
+import { bashCommand, tailCalls, tamperInTail } from './save-gate.js';
+import { CLAUDE_DIALECT, dialectFor } from '../trace/dialect.js';
+import { detectHost } from '../trace/host.js';
+import { noteWalls, programKey, readWalls, repairsSeen } from '../trace/wall-state.js';
+/** A lesson receipt older than this is stale (2.11). */
+const FRESH_MS = 2 * 60 * 60_000;
+const AHEAD_MS = 5_000;
+const NOT = 'trail · lesson not kept: ';
+export const LESSON_DENY = {
+    flags: `${NOT}\`trail skills lesson\` takes only a skill name and --offer <id>.`,
+    noOffer: `${NOT}there is no lesson offer with that id in this session, so there is nothing the person said yes to.`,
+    noYes: "the person didn't say yes to this lesson in this session",
+    changed: 'the lesson changed after the offer, so it is not the one the person said yes to',
+    refused: 'its text would tell an agent to skip a check or run a step that cannot be undone',
+    // D111: 1a's refusals in a lesson's words.
+    subagent: `${NOT}only the main session can keep a lesson.`,
+    noPerson: `${NOT}this session runs without a person at the keyboard (headless, CI or a scratch folder), so Trail keeps nothing from it.`,
+    busy: `${NOT}Trail was busy. Run the same command again.`,
+};
+const skillDeny = (name, id) => `${NOT}the offer was for the skill ${flatLine(name, 60)}. Run: trail skills lesson ${flatLine(name, 60)} --offer ${flatLine(id, 40)}`;
+const wallDeny = (id) => `${NOT}that offer keeps a lesson about an error, not one on a skill. Run: trail skills lesson --offer ${flatLine(id, 40)}`;
+const tamperDeny = (what) => `${NOT}this session changed Trail's own files (${flatLine(what, 120)}), so Trail can't trust its record of what was offered.`;
+/** The lesson the offer showed, rebuilt now: from the correction line by its pointer, or from the repair's delta. */
+function lessonOf(po, tx, env, use) {
+    if (po.moment === 'correction' && po.correction) {
+        const l = correctionLesson(po.correction, tx, env, use);
+        return l ? { text: l.text, pinned: po.correction.lessonSha } : null;
+    }
+    if (po.moment === 'repaired' && po.repair?.as === 'lesson') {
+        const text = repairLessonText(po.repair.cls, po.repair.delta ?? []);
+        return text ? { text, pinned: po.repair.lessonSha } : null;
+    }
+    return null;
+}
+/** 4.15, both halves: the pending offer, the person's typed yes to it as the first line after it, the reply ending with its line 2, the lesson unchanged. */
+function decide(cmd, ctx, st) {
+    const env = ctx.env;
+    if (ctx.subagent)
+        return { deny: LESSON_DENY.subagent };
+    if (!ctx.fold || !ctx.learn)
+        return { deny: LESSON_DENY.noPerson };
+    if (!cmd || cmd.flags.length)
+        return { deny: LESSON_DENY.flags };
+    if (st.tampered)
+        return { deny: tamperDeny(st.tampered) };
+    const po = st.pendingOffer;
+    if (!po || po.offerId !== cmd.offerId || !isLessonOffer(po))
+        return { deny: LESSON_DENY.noOffer };
+    if (po.moment === 'correction' && cmd.skill !== po.name)
+        return { deny: skillDeny(po.name, po.offerId) };
+    if (po.moment === 'repaired' && cmd.skill !== null)
+        return { deny: wallDeny(po.offerId) };
+    const tx = ctx.transcriptPath;
+    const no = { deny: `${NOT}${LESSON_DENY.noYes}.` };
+    if (!tx || !po.shownAt || !po.yes)
+        return no;
+    // The first typed line after the offer is the yes (a lesson offer has no "show me").
+    const first = po.typedAfter[0];
+    if (!first || first.answer !== 'yes' || first.sha !== po.yes.typedSha)
+        return no;
+    const how = dialectUse(ctx.host, st);
+    const p = personLine(tx, first.offset, first.sha, (t) => classifyAnswer(t, false) === 'yes', env, undefined, how);
+    if (!p)
+        return no;
+    const lines = offerLinesOf(po, tx, env, how);
+    const lesson = lessonOf(po, tx, env, how);
+    if (!lines || !lesson || lessonSha(lesson.text) !== lesson.pinned)
+        return { deny: `${NOT}${LESSON_DENY.changed}.` };
+    if (lessonRefused(lesson.text))
+        return { deny: `${NOT}${LESSON_DENY.refused}.` };
+    // D72: the agent's reply right before the yes ended with the offer's own question (unless the host showed it as Trail's notice).
+    const notice = po.channel === 'notice' && hostFacts(env, ctx.host).offerChannel === 'notice';
+    if (!notice && !endsWithLine(replyBefore(tx, first.offset, env, how) ?? '', lines[1]))
+        return no;
+    return { po, typed: p.typed, text: lesson.text, sha: lesson.pinned };
+}
+/* ------------------------------------------------------------ the receipts */
+const lessonReceiptPath = (session, env) => receiptPath(session, env).replace(/\.json$/, '.lesson.json');
+const str = (v) => typeof v === 'string';
+function asLessonReceipt(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return null;
+    const r = v;
+    if (r.v !== 1 || r.kind !== 'lesson' || !str(r.session) || !str(r.transcriptPath) || !str(r.toolUseId) || !str(r.offerId) || !str(r.at))
+        return null;
+    if (r.skill !== null && !str(r.skill))
+        return null;
+    if (!r.typed || typeof r.typed !== 'object' || typeof r.typed.offset !== 'number' || !str(r.typed.lineSha) || !str(r.lessonSha))
+        return null;
+    if ((r.verdict !== 'live' && r.verdict !== 'held') || (r.usedAt !== null && !str(r.usedAt)))
+        return null;
+    return r;
+}
+function readLessonReceipt(path) {
+    try {
+        if (!lstatSync(path).isFile())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    return asLessonReceipt(readJsonSafe(path));
+}
+/** The unused, fresh lesson receipt for this offer (any session's file; the newest). */
+export function findLessonReceipt(offerId, now, env) {
+    const dir = trailPath(env, 'receipts');
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    let best = null;
+    for (const n of names) {
+        if (!n.endsWith('.lesson.json'))
+            continue;
+        const r = readLessonReceipt(join(dir, n));
+        if (!r || r.usedAt !== null || r.offerId !== offerId)
+            continue;
+        const age = now.getTime() - Date.parse(r.at);
+        if (Number.isNaN(age) || age > FRESH_MS || age < -AHEAD_MS)
+            continue;
+        if (!best || Date.parse(r.at) > Date.parse(best.at))
+            best = r;
+    }
+    return best;
+}
+function markLessonReceiptUsed(r, now, env) {
+    const path = lessonReceiptPath(r.session, env);
+    withLock(path, () => {
+        const cur = readLessonReceipt(path);
+        if (!cur || cur.toolUseId !== r.toolUseId || cur.at !== r.at || cur.usedAt !== null)
+            return;
+        writePrivate(path, `${JSON.stringify({ ...cur, usedAt: now.toISOString() }, null, 2)}\n`);
+    }, 1000);
+}
+/**
+ * The host whose transcript a lesson receipt names, from its path (a lesson receipt keeps no host): Codex for a
+ * rollout, else Claude Code. The path still has to pass that host's own transcript checks.
+ */
+const hostOfReceipt = (r) => detectHost({ session_id: r.session, transcript_path: r.transcriptPath, hook_event_name: 'Stop' }).host === 'codex' ? 'codex' : 'claude';
+/** The lesson receipt as 1a's transcript checks read a receipt: its host, tier A (lessons are offered only where learning is on). */
+const asReceipt = (r) => ({ ...r, host: hostOfReceipt(r), tier: 'A' });
+/* ----------------------------------------------------------- PreToolUse half */
+/** PreToolUse half for `trail skills lesson ... --offer <id>`: needs the hook's yes and the typed yes (4.15). A deny, or null after writing the receipt. */
+export async function lessonGatePre(input, ctx) {
+    const command = input?.tool_input?.command;
+    if (typeof command !== 'string' || !SKILLS_LESSON_RE.test(command))
+        return null;
+    if (ctx.subagent)
+        return { permissionDecision: 'deny', reason: LESSON_DENY.subagent };
+    if (!ctx.fold)
+        return { permissionDecision: 'deny', reason: LESSON_DENY.noPerson };
+    const cmd = parseSkillsLesson(command);
+    const r = withSkillSession(ctx, { catchUp: true, waitMs: 300 }, (st) => {
+        const d = decide(cmd, ctx, st);
+        if ('deny' in d)
+            return { permissionDecision: 'deny', reason: d.deny };
+        const receipt = {
+            v: 1, kind: 'lesson', session: ctx.sessionId, transcriptPath: ctx.transcriptPath ?? '', toolUseId: typeof input?.tool_use_id === 'string' ? input.tool_use_id : '',
+            offerId: d.po.offerId, skill: cmd.skill, typed: d.typed, lessonSha: d.sha, at: ctx.now.toISOString(), verdict: 'live', usedAt: null,
+        };
+        writePrivate(lessonReceiptPath(ctx.sessionId, ctx.env), `${JSON.stringify(receipt, null, 2)}\n`);
+        return null;
+    });
+    return r === undefined ? { permissionDecision: 'deny', reason: LESSON_DENY.busy } : r;
+}
+/** 3.3 step 2 for a lesson command, from the hook's payload: the gate, then `lessonGatePre`. Skills off or no session: null (the CLI holds). */
+export async function lessonGate(input, dir, env = process.env, now) {
+    try {
+        const g = skillsGate(input, dir, env, now);
+        return g.ok ? await lessonGatePre(input, g.ctx) : null;
+    }
+    catch (e) {
+        hookError('pre-bash', e, env);
+        return null;
+    }
+}
+/* ------------------------------------------------------------------ CLI half */
+/** The transcript shows the main session's agent running exactly this lesson command, with the receipt's tool_use id. */
+function lessonInTranscript(r, skill, offerId, calls) {
+    if (!r.toolUseId)
+        return false;
+    return calls.some((t) => {
+        const raw = t.id === r.toolUseId ? bashCommand(t) : null;
+        const c = raw === null ? null : parseSkillsLesson(raw);
+        return c !== null && !c.flags.length && c.skill === skill && c.offerId === offerId;
+    });
+}
+const held = (why) => ({ code: 1, line: `${NOT}${why}.` });
+/** A wall lesson's learning id, read back from the file it was written to. */
+function learningIdOf(path) {
+    try {
+        return parseNote(readFileSync(path, 'utf8'), path)?.id ?? basename(path, '.md');
+    }
+    catch {
+        return basename(path, '.md');
+    }
+}
+/** R48: a moment-3 lesson starts with the epochs the same fix worked in: the earlier same-delta ones, and this one. */
+function startWorked(po, lessonId, ctx, now) {
+    const rep = po.repair;
+    const repo = po.repo ?? '';
+    if (!rep || !repo)
+        return;
+    const sheet = readRunSheet(po.runId, ctx.env);
+    const epoch = sheet?.epoch ?? 0;
+    const d = localDate(sheet?.endedAt ?? now.toISOString());
+    const program = programKey(rep.program);
+    noteWalls({ fixed: [{ cls: rep.cls, d, sh: ctx.sessionHash, epoch, repo, program, delta: rep.delta.map((x) => ({ kind: x.kind, name: x.name })) }] }, ctx.env);
+    const seen = repairsSeen(readWalls(ctx.env), repo, rep.cls, program, ctx.sessionHash, epoch, now);
+    if (seen.from.length)
+        noteWalls({ worked: seen.from.map((f) => ({ cls: rep.cls, lessonId, sh: f.sh, epoch: f.epoch, d: f.d })) }, ctx.env);
+}
+/** CLI half: re-decides from the transcript, checks lessonSha, writes the lesson. Exit 0 saved, 1 held. */
+export function keepLessonCli(skill, offerId, env, now = new Date()) {
+    if (!skillsOn(env))
+        return { code: 1, line: 'Skills are off. Turn them on with: trail skills on' };
+    const found = findLessonReceipt(offerId, now, env);
+    if (!found)
+        return held(LESSON_DENY.noYes);
+    const sandboxed = codexSandboxRefusal(hostOfReceipt(found), `trail skills lesson ${skill ? `${skill} ` : ''}--offer ${offerId}`, env);
+    if (sandboxed)
+        return { code: 1, line: sandboxed };
+    const r = receiptTranscriptOk(asReceipt(found), env) && receiptTranscriptRead(asReceipt(found), env) ? found : null;
+    if (!r) {
+        markLessonReceiptUsed(found, now, env);
+        const where = hostOfReceipt(found) === 'codex' ? 'Codex' : 'Claude Code';
+        return held(`Trail couldn't find this conversation where ${where} keeps it, so it can't check that the person said yes`);
+    }
+    const host = hostOfReceipt(r);
+    const calls = tailCalls(r.transcriptPath, dialectFor(host) ?? CLAUDE_DIALECT, env);
+    if (!lessonInTranscript(r, skill, offerId, calls))
+        return held(LESSON_DENY.noYes);
+    const tampered = tamperInTail(calls, r.transcriptPath, env);
+    if (tampered) {
+        markLessonReceiptUsed(r, now, env);
+        return held(`this session changed Trail's own files (${flatLine(tampered, 120)}), so Trail can't trust its record of what was offered`);
+    }
+    const ctx = {
+        sessionId: r.session, sessionHash: createHash('sha256').update(r.session).digest('hex').slice(0, 12), host, tier: 'A',
+        entry: 'interactive', permissionMode: null, subagent: false, fold: true, learn: true, learnOff: null, dir: '', checkout: '', repoKey: '',
+        transcriptPath: r.transcriptPath, env, now,
+    };
+    let out;
+    try {
+        out = withSkillSession(ctx, { catchUp: true, waitMs: 1000 }, (st) => {
+            const d = decide({ skill, offerId, flags: [] }, ctx, st);
+            if ('deny' in d)
+                return { held: d.deny.replace(NOT, '').replace(/\.$/, '') };
+            const backed = d.typed.offset === r.typed.offset && d.typed.lineSha === r.typed.lineSha && d.sha === r.lessonSha && typedLineStillThere(r.transcriptPath, r.typed);
+            if (!backed)
+                return { held: LESSON_DENY.changed };
+            if (lessonRefused(d.text))
+                return { held: LESSON_DENY.refused };
+            // The consent is spent with the write, under the same lock; a write that throws puts the state back.
+            const po = d.po;
+            st.pendingOffer = null;
+            const id = po.moment === 'correction' ? newLessonId() : '';
+            const lesson = {
+                id, skill: po.moment === 'correction' ? po.name : null, at: localDate(now), text: d.text, kind: 'lesson',
+                src: po.moment === 'correction' ? 'correction' : 'repair', wall: po.moment === 'repaired' ? po.repair.cls : null,
+            };
+            // b3: two keeps can't race for one file name.
+            const path = underStoreLock(env, () => writeLesson(lesson, po.repo ?? '', env));
+            return { saved: { po, text: d.text, path, id: id || learningIdOf(path) } };
+        });
+    }
+    catch (e) {
+        return held(`Trail couldn't write it (${flatLine(e instanceof Error ? e.message : String(e), 160).replace(/^trail:\s*/, '')})`);
+    }
+    if (out === undefined)
+        return held('Trail was busy. Run the same command again');
+    markLessonReceiptUsed(r, now, env);
+    if ('held' in out)
+        return held(out.held);
+    const { po, id } = out.saved;
+    if (po.moment === 'correction') {
+        try {
+            appendLedger(po.correction.skillId, { at: now.toISOString(), event: 'lesson', skill: po.correction.skillId, lessonId: id, src: 'correction', consent: 'offer-yes' }, env);
+        }
+        catch { /* the lesson is kept; the ledger line is a record */ }
+        return { code: 0, line: fill(LESSON_COPY.saved, { skill: flatLine(po.name, 60), id }) };
+    }
+    try {
+        startWorked(po, id, ctx, now);
+    }
+    catch { /* the lesson is kept; it shows once it works again */ }
+    return { code: 0, line: fill(REPAIR_COPY.savedWall, { where: `in ${lessonWhere(po.repair.cls)}`, fixed: fixedWords(po.repair.cls), id }) };
+}
+const fill = (t, v) => t.replace(/\{(\w+)\}/g, (m, k) => v[k] ?? m);
+//# sourceMappingURL=lesson-gate.js.map

package/dist/skills/lesson-gate.js.map

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

package/dist/skills/lessons.d.ts

@@ -0,0 +1,60 @@
+import type { WallClass } from '../trace/types.js';
+export interface Lesson {
+    /** Skill lesson: 'ls-' + 6 hex (never a learning id, R4). Wall lesson: the learning's id. */
+    id: string;
+    /** null: tied to a wall only (moment 3 fallback). */
+    skill: string | null;
+    /** Local date. */
+    at: string;
+    /** At most 200 chars, flatLine'd, a leading [trail] or [graft] stripped (spec 7, R27). */
+    text: string;
+    /** 'guardrail' when the text starts with never / don't / ask first (spec 13). */
+    kind: 'lesson' | 'guardrail';
+    src: 'correction' | 'repair';
+    wall: WallClass | null;
+}
+export declare const LESSON_MAX = 200;
+/** The words a lesson reaches the agent and the person in (J07, 4.14, 4.15). Information, tied to the skill (D88). */
+export declare const LESSON_COPY: Record<string, string>;
+/** The correction forms of 4.14 step 2, first match. Null when none matches. */
+export declare function correctionPhrase(typed: string): {
+    said: string;
+    lesson: string;
+    kind: 'lesson' | 'guardrail';
+} | null;
+/** `{lesson}: {fix command}` (params put back), or `{lesson}` alone; one line, at most 200, no leading marker. A cut command is never kept. */
+export declare function lessonText(phrase: {
+    lesson: string;
+}, fixCmd: string | null, params: Record<string, string>): string;
+export declare function lessonSha(text: string): string;
+export declare function newLessonId(): string;
+/**
+ * Why a lesson's text can't reach the agent, or null (D88, D101, 4.14 step 3): it tells the agent not to ask or
+ * confirm (Trail never says that; Claude Code asks before a step that can't be undone), it talks about asking
+ * without adding asking (D111: "you don't need to ask first" must never come back as an ask turned around), a
+ * command the risk rules never keep, or, unless it is a guardrail that forbids it ("never npm publish from a
+ * laptop"), a gated command the block would show with no ask. The same rule for a new lesson's phrase and for a
+ * lesson file read back.
+ */
+export declare function lessonRefused(text: string): string | null;
+/**
+ * skills/<name>/lessons/<date>-<n>.md for a skill (never written through a link); for a wall-only lesson a learning
+ * of kind lesson (every-repo for a machine wall, the repo's personal folder for git-https-auth, R49). Returns the path.
+ */
+export declare function writeLesson(l: Lesson, repoKey: string, env?: NodeJS.ProcessEnv): string;
+/** The lessons in `<skillDir>/lessons/` (never through a link), oldest first; the newest 50 files read. */
+export declare function readLessons(skillDir: string): Lesson[];
+/**
+ * The live lessons kept for a wall class here: every-repo ones, then this repo's (oldest first). For lastTimeText
+ * (4.10). D117 (4): read through the mtime-keyed lesson index; `write` (Stop, session start) keeps what changed.
+ */
+export declare function wallLessons(cls: WallClass, repoKey: string, env?: NodeJS.ProcessEnv, opts?: {
+    write?: boolean;
+}): Lesson[];
+/** A guardrail-kind lesson (never trimmed from a block): so marked, or its text starts with never / don't / ask first. */
+export declare const isGuardrailLesson: (l: Lesson) => boolean;
+/** Guardrail-kind lessons first (never trimmed), then up to 3 newest lessons, oldest of them first (4.16, J07). */
+/** One lesson's line (`Lesson (the person, Nov 3): ...`). */
+export declare const lessonLine: (l: Lesson) => string;
+export declare function lessonLines(lessons: Lesson[]): string[];
+//# sourceMappingURL=lessons.d.ts.map

package/dist/skills/lessons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessons.d.ts","sourceRoot":"","sources":["../../src/skills/lessons.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAenD,MAAM,WAAW,MAAM;IACrB,6FAA6F;IAC7F,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,GAAG,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,UAAU,MAAM,CAAC;AAU9B,sHAAsH;AACtH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM9C,CAAC;AAmEF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAA;CAAE,GAAG,IAAI,CAcrH;AAgBD,+IAA+I;AAC/I,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQpH;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAgDD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWzD;AA6CD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAyBvF;AAuBD,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,EAAE,CAW9H;AAUD,0HAA0H;AAC1H,eAAO,MAAM,iBAAiB,GAAI,GAAG,MAAM,YAAiE,CAAC;AAE7G,mHAAmH;AACnH,6DAA6D;AAC7D,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,WAAuF,CAAC;AAE5H,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMvD"}