@nanonets/graft 0.23.1 → 0.24.1

package/dist/skills/ledger.js

@@ -0,0 +1,336 @@
+/**
+ * A skill's ledger (`~/.trail/ledger/<skill-id>.jsonl`, design 2.6): one line
+ * per event (saved, used, corrected, status changed), kept for good. It holds
+ * counts and labels only: which steps ran, which failed, whether the check
+ * passed, how many commands, the forms of the ready probes that failed; never
+ * a command, a probe's text, a prompt or an output. Each
+ * event's known fields are all that is ever written, so a caller that hands
+ * over more can't leak it.
+ *
+ * And credit (4.8): from the commands that ran after a run block came in,
+ * which of the skill's steps ran and worked, the step that failed, and
+ * whether its check passed. Pure: the calls come from the session state, or,
+ * for a run whose calls the session no longer holds (closed, its sheet
+ * written: D57), from its run sheet (`creditCalls`).
+ */
+import { randomBytes } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { appendPrivateLine, trailPath } from '../util/private-fs.js';
+import { flatLine } from '../notes/flatten.js';
+import { stepMatches } from '../trace/shell.js';
+import { callText, hasVersion, HEAD_SHA } from '../trace/checks.js';
+import { readRunSheet } from '../trace/run-sheets.js';
+import { joinCarriedSheet } from '../trace/run-join.js';
+import { ownFolder } from './own-folder.js';
+import { doesLess } from './ran-less.js';
+import { dirname } from 'node:path';
+/** A skill id as a file name: what Trail writes is 's-' and 6 hex; a hand-edited SKILL.md can say anything. */
+const SKILL_ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
+/** A call at most this long before a block's `at` belongs to it (the fold's own slack for the typed line, 4.1). */
+const SLACK_MS = 5000;
+/** A deploy status read over MCP (D59b, `RunCall.tool`): no command, never a step, not a Bash call. */
+const isToolCall = (c) => typeof c.tool === 'string';
+export function ledgerPath(skillId, env) {
+    if (!SKILL_ID.test(String(skillId)))
+        throw new Error(`trail: not a skill id: ${flatLine(skillId, 40)}`);
+    return trailPath(env, 'ledger', `${skillId}.jsonl`);
+}
+const str = (v, max) => flatLine(v, max);
+const count = (v) => (typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : 0);
+const steps = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'number' && Number.isInteger(x) && x > 0).slice(0, 50) : []);
+const oneOf = (v, values, fallback) => (values.includes(v) ? v : fallback);
+/** The forms a ready probe takes (4.5 step 11). The ledger keeps the form, never the probe's text. */
+export const PROBE_FORMS = ['clean', 'on-branch', 'program', 'path', 'ref', 'other'];
+/** A ready probe's form: `git status --porcelain` is clean, `... = <branch>` on-branch, and so on. A form stays itself. */
+export function probeForm(probe) {
+    const p = String(probe ?? '').trim();
+    if (PROBE_FORMS.includes(p))
+        return p;
+    if (/^git status --porcelain$/.test(p))
+        return 'clean';
+    if (/^git rev-parse --abbrev-ref HEAD = \S+$/.test(p))
+        return 'on-branch';
+    if (/^command -v \S+$/.test(p))
+        return 'program';
+    if (/^(?:test -[SfdeE] \S+|\[ -S \S+ \])$/.test(p))
+        return 'path';
+    if (/^git rev-parse --verify \S+$/.test(p))
+        return 'ref';
+    return 'other';
+}
+const forms = (v) => [...new Set((Array.isArray(v) ? v : []).filter((x) => typeof x === 'string').map(probeForm))];
+const LESSON_ID = /^(?:ls-[0-9a-f]{6}|l-[0-9a-f]{6,16})$/;
+/**
+ * Phase 2 (2.3, 4.1): a use line's fidelity facts, only when the caller gave them, so a 1b use line is written byte
+ * for byte as before. Counts, 8-hex shas (at most 4) and step numbers (at most 4); never a command.
+ */
+function useFacts(r) {
+    const out = {};
+    if (r.fid && typeof r.fid === 'object' && !Array.isArray(r.fid)) {
+        const f = r.fid;
+        out.fid = { ran: count(f.ran), missing: count(f.missing), extra: count(f.extra), changed: count(f.changed) };
+    }
+    if (Array.isArray(r.extraShas))
+        out.extraShas = r.extraShas.filter((x) => typeof x === 'string' && /^[0-9a-f]{8}$/.test(x)).slice(0, 4);
+    if (Array.isArray(r.changedSteps))
+        out.changedSteps = steps(r.changedSteps).slice(0, 4);
+    if (Array.isArray(r.handed))
+        out.handed = steps(r.handed).slice(0, 8);
+    return out;
+}
+/** The line as 2.6 writes it: its event's fields, in order, and nothing else. Throws on an unknown event. */
+function shape(skillId, l) {
+    const r = l;
+    const at = str(r.at, 40);
+    switch (r.event) {
+        case 'saved': {
+            const rc = (r.receipt && typeof r.receipt === 'object' ? r.receipt : {});
+            return {
+                at, event: 'saved', skill: skillId, v: str(r.v, 10), from: oneOf(r.from, ['init', 'repeated', 'repaired', 'asked'], 'asked'),
+                scope: oneOf(r.scope, ['personal', 'repo', 'team'], 'personal'),
+                receipt: { consent: oneOf(rc.consent, ['offer-yes', 'asked', 'init'], 'asked'), stepsVerified: count(rc.stepsVerified), stepsTotal: count(rc.stepsTotal) },
+            };
+        }
+        case 'use':
+            return {
+                at, event: 'use', useId: str(r.useId, 20), skill: skillId, v: str(r.v, 10), host: str(r.host, 20),
+                cue: oneOf(r.cue, ['job', 'name', 'compact', 'run'], 'job'), repo: str(r.repo, 200), stepsRan: steps(r.stepsRan),
+                failedStep: typeof r.failedStep === 'number' && Number.isInteger(r.failedStep) && r.failedStep > 0 ? r.failedStep : null,
+                readyFailed: forms(r.readyFailed),
+                check: oneOf(r.check, ['passed', 'failed', 'none'], 'none'), calls: count(r.calls), failed: count(r.failed),
+                ...useFacts(r),
+            };
+        // Phase 2 (2.3): a change to the file Trail wrote.
+        case 'changed':
+            return {
+                at, event: 'changed', skill: skillId, op: oneOf(r.op, ['update', 'extend', 'replace', 'adopted', 'restore-version'], 'update'),
+                from: count(r.from), to: count(r.to), offerId: typeof r.offerId === 'string' && /^o-[0-9a-f]{6}$/.test(r.offerId) ? r.offerId : null,
+                ...(Array.isArray(r.lessonIds) ? { lessonIds: r.lessonIds.filter((x) => typeof x === 'string' && LESSON_ID.test(x)).slice(0, 10) } : {}),
+            };
+        case 'corrected':
+            return { at, event: 'corrected', skill: skillId, useId: str(r.useId, 20) };
+        case 'status': {
+            const statuses = ['candidate', 'active', 'needs-fix', 'retired'];
+            return {
+                at, event: 'status', skill: skillId, from: oneOf(r.from, statuses, 'candidate'), to: oneOf(r.to, statuses, 'candidate'),
+                reason: oneOf(r.reason, ['checked-use', 'failed-twice', 'forget', 'restore', 'retire-offer'], 'restore'),
+            };
+        }
+        // 1b: a lesson kept on the skill, and an asks phrase dropped (by its sha only, never the phrase: R30).
+        case 'lesson':
+            return {
+                at, event: 'lesson', skill: skillId, lessonId: LESSON_ID.test(String(r.lessonId)) ? r.lessonId : '',
+                src: oneOf(r.src, ['correction', 'repair'], 'correction'), consent: 'offer-yes',
+            };
+        case 'cue':
+            return { at, event: 'cue', skill: skillId, phraseSha: /^[0-9a-f]{8}$/.test(String(r.phraseSha)) ? r.phraseSha : '', change: 'dropped' };
+        default:
+            throw new Error(`trail: not a ledger event: ${flatLine(r.event, 20)}`);
+    }
+}
+/** One line, O_APPEND. Throws on a ledger folder that is a link (own-folder.ts) or a ledger file that is one. */
+export function appendLedger(skillId, line, env) {
+    const path = ledgerPath(skillId, env);
+    ownFolder(dirname(path));
+    appendPrivateLine(path, JSON.stringify(shape(skillId, line)));
+}
+const EVENTS = new Set(['saved', 'use', 'corrected', 'status', 'lesson', 'cue', 'changed']);
+/** Every line, oldest first; a broken line, or one that isn't a ledger event, is skipped. [] for an unknown or bad id. */
+export function readLedger(skillId, env) {
+    let text;
+    try {
+        text = readFileSync(ledgerPath(skillId, env), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const raw of text.split('\n')) {
+        if (!raw.trim())
+            continue;
+        try {
+            const v = JSON.parse(raw);
+            if (v && typeof v === 'object' && !Array.isArray(v) && EVENTS.has(v.event) && typeof v.skill === 'string' && typeof v.at === 'string')
+                out.push(v);
+        }
+        catch { /* a torn or hand-mangled line */ }
+    }
+    return out;
+}
+/** A tool's own name, as `metadata.check-tool` keeps it: `mcp__claude_ai_Vercel__get_deployment` -> `get_deployment`. */
+const toolName = (name) => name.replace(/^mcp__.+__(?=[^_])/, '');
+/** The commit a skill's block is about, when it is one (`{sha}` filled with a hash). */
+const blockSha = (inj) => (/^[0-9a-f]{7,40}$/i.test(inj.params.sha ?? '') ? inj.params.sha.toLowerCase() : null);
+const sameCommit = (a, b) => a.startsWith(b) || b.startsWith(a);
+const HEAD_ALL = new RegExp(HEAD_SHA, 'g');
+const hasHead = (t) => new RegExp(HEAD_SHA).test(t);
+/** A written-out commit: 7 to 40 hex with a digit and a letter (promptParams' rule), not part of a longer word. */
+const LITERAL_SHA = /(?<![\w-])(?=[0-9a-f]*\d)(?=[0-9a-f]*[a-f])[0-9a-f]{7,40}(?![\w-])/g;
+const shasIn = (t) => [...new Set(t.match(LITERAL_SHA) ?? [])].slice(0, 6);
+/**
+ * D71 c: a skill's step or check matches a call that ran it, its commit written either way: the skill's
+ * `$(git rev-parse HEAD)` (the `{sha}` default) where the run wrote the commit out, the commit the block named
+ * where the run worked it out with `$(git rev-parse HEAD)`, and a short sha where the run wrote the full one.
+ * Another commit is never a match.
+ */
+export function ranAs(step, ran, params) {
+    // D138 (2): a call that made the step do less (a dry run, a --no- flag, a hidden failure) is not the step.
+    if (doesLess(step, ran))
+        return false;
+    if (stepMatches(step, ran, params, true))
+        return true;
+    const ranShas = shasIn(ran);
+    if (hasHead(step)) {
+        for (const sha of ranShas)
+            if (stepMatches(step.replace(HEAD_ALL, sha), ran, params, true))
+                return true;
+    }
+    const stepShas = shasIn(step);
+    if (hasHead(ran)) {
+        for (const sha of stepShas)
+            if (stepMatches(step, ran.replace(HEAD_ALL, sha), params, true))
+                return true;
+    }
+    for (const s of stepShas) {
+        for (const r of ranShas)
+            if (r !== s && sameCommit(s, r) && stepMatches(step.split(s).join(r), ran, params, true))
+                return true;
+    }
+    return false;
+}
+/**
+ * D66: a deploy status read over MCP is the check of a skill whose check is that tool (`checkTool`, from
+ * `metadata.check-tool`), when it read the block's commit (or says no commit). Null when it is not the check.
+ */
+function toolCheck(inj, c) {
+    if (!inj.checkTool || !c.tool || toolName(c.tool) !== toolName(inj.checkTool))
+        return null;
+    const sha = blockSha(inj);
+    const read = c.check?.facts.sha?.toLowerCase();
+    if (sha && read && !sameCommit(sha, read))
+        return null;
+    return c.check?.passed === true;
+}
+/** The end of the `$(…)` that opens at `open` (the index after `$(`), quotes respected; -1 when it never closes. */
+function closeParen(text, open) {
+    let depth = 1;
+    let quote = null;
+    for (let i = open; i < text.length; i++) {
+        const ch = text[i];
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            else if (ch === '\\' && quote === '"')
+                i++;
+        }
+        else if (ch === "'" || ch === '"')
+            quote = ch;
+        else if (ch === '\\')
+            i++;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')' && --depth === 0)
+            return i;
+    }
+    return -1;
+}
+const LOOP = /(?:^|[\s;&|(])(?:until|while|for)\s[\s\S]*\bdo\b[\s\S]*\bdone\b/;
+/**
+ * D65 / D59c: the check run inside a wait loop, as a `$(CHECK)` the loop compares (the skill's own wait step,
+ * `until [ "$(CHECK)" = "success" ]`) or as the loop's condition (`until CHECK >/dev/null`, `while ! CHECK`).
+ * Only a call the fold read as a check (`c.check`) is judged this way: its CheckHit is the loop's last reading.
+ */
+function checkInLoop(check, text, params) {
+    if (!LOOP.test(text))
+        return false;
+    const inner = [];
+    for (const m of text.matchAll(/\$\(/g)) {
+        const from = m.index + 2;
+        const to = closeParen(text, from);
+        if (to > from)
+            inner.push(text.slice(from, to));
+    }
+    for (const m of text.matchAll(/(?:^|[\s;&|(])(?:until|while)\s+(?:!\s+)?(?!\[)([^;]+);\s*do\b/g))
+        inner.push(m[1]);
+    return inner.some((t) => ranAs(check, t.trim(), params));
+}
+/**
+ * Credit from commands that ran (4.8). Pure. The calls are the injection's run's (`creditCalls`); only those at or
+ * after `inj.at` (less 5 s, the fold's slack) count. Each call goes to the first step it matches (params filled,
+ * env prefixes ignored); a step's last outcome wins, so a failed try then a pass ran. `calls` and `failed` count Bash
+ * calls only: an MCP deploy read (`tool`) is never a step. A check-cue injection earns nothing.
+ *
+ * The check (D65): a call matching `inj.check` at a command start, the check run inside a wait loop, or for a
+ * check-tool skill (D66) that tool's result. It is the run's check only once a step has run ok before it (or the
+ * call is itself a step, as a tests check is): a check that passed before the steps ran proves nothing about them.
+ * Any passing reading makes it `passed`; a reading that never passed, `failed`. A reading is the fold's, except for a
+ * version check (D106, `checkVersion`): it passes when the call worked and showed that version.
+ */
+export function creditRun(inj, calls) {
+    if (inj.cue === 'check')
+        return { stepsRan: [], failedStep: null, check: 'none', calls: 0, failed: 0 };
+    const from = Date.parse(inj.at);
+    const span = calls.filter((c) => Number.isNaN(from) || Date.parse(c.at) >= from - SLACK_MS);
+    const bash = span.filter((c) => !isToolCall(c));
+    const last = new Map();
+    let check = 'none';
+    let stepRan = false;
+    // D137: a gated step handed to the person (denied here, theirs to run) counts as ran, its denied call no failure.
+    const handed = new Set((inj.handed ?? []).map((h) => h.n).filter((n) => Number.isInteger(n) && n >= 1 && n <= inj.steps.length));
+    const reading = (passed) => {
+        if (check !== 'passed')
+            check = passed ? 'passed' : 'failed';
+    };
+    // D106: a version check passes when it shows the version the block filled in, not on what the fold could tell.
+    const want = inj.checkVersion;
+    const passes = (c) => (want ? !c.failed && (hasVersion(c.tail ?? '', want) || c.check?.facts.version === want) : c.check?.passed === true);
+    for (const c of span) {
+        if (isToolCall(c)) {
+            const hit = stepRan ? toolCheck(inj, c) : null;
+            if (hit !== null)
+                reading(hit);
+            continue;
+        }
+        const text = callText(c);
+        if (!text)
+            continue;
+        const i = inj.steps.findIndex((s) => ranAs(s, text, inj.params));
+        const ok = !c.failed || handed.has(i + 1);
+        if (i >= 0)
+            last.set(i + 1, ok);
+        if (inj.check && !inj.checkTool && (stepRan || i >= 0)) {
+            if (ranAs(inj.check, text, inj.params))
+                reading(passes(c));
+            else if (c.check && checkInLoop(inj.check, text, inj.params))
+                reading(passes(c));
+        }
+        if (i >= 0 && ok)
+            stepRan = true;
+    }
+    for (const n of handed)
+        if (!last.has(n))
+            last.set(n, true);
+    const ran = [...last].filter(([, ok]) => ok).map(([n]) => n).sort((a, b) => a - b);
+    const bad = [...last].filter(([, ok]) => !ok).map(([n]) => n);
+    return { stepsRan: ran, failedStep: bad.length ? Math.min(...bad) : null, check, calls: bash.length, failed: bash.filter((c) => c.failed).length };
+}
+/**
+ * D57: the calls an injection is credited from. Its run's calls while the session state holds them (the open run,
+ * or a run the fold just closed, inside `withSkillSession`'s fn), else its run sheet: a closed run's calls are
+ * emptied once its sheet is written, so a run the next typed ask closed is credited from `runs/<id>.json`. A sheet
+ * carried across a compaction (D59a) is joined with the parts before it (`joinCarriedSheet`).
+ * With no run, every call of the injection's epoch the session still holds. [] when there is nothing.
+ */
+export function creditCalls(inj, runs, env) {
+    if (!inj.runId)
+        return runs.filter((r) => r.epoch === inj.epoch).flatMap((r) => r.calls);
+    const run = runs.find((r) => r.id === inj.runId);
+    if (run && (run.calls.length || !run.closed))
+        return run.calls;
+    const sheet = readRunSheet(inj.runId, env);
+    return sheet ? joinCarriedSheet(sheet, (id) => readRunSheet(id, env)).calls : [];
+}
+export function newUseId() {
+    return `u-${randomBytes(3).toString('hex')}`;
+}
+//# sourceMappingURL=ledger.js.map

package/dist/skills/ledger.js.map

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