@descryy/mcp 0.11.5 → 0.11.6

package/dist/tools/draw-conclusion.js.map

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

package/dist/tools/git-context.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `git_context` — merges `get_git_diff` and `get_git_history` behind one
+ * `verb` (mcp-surface-consolidation.md group 2: both read/evidence, both live
+ * git reads of the working repository, neither touches the stored graph).
+ *
+ * Each verb's behaviour is unchanged from the tool it replaces. The two
+ * verbs' property sets do not overlap ("diff" never took a singular "file";
+ * "log" never took a "files" array), so `selectVerb` mostly guards against a
+ * genuinely misrouted call rather than a naming collision — but it is still
+ * mandatory, per verb.ts's header: a flat unioned schema cannot discriminate
+ * on its own once `additionalProperties: false` has to admit both verbs'
+ * properties.
+ */
+import type { GitDiffFile, PathLogCommit } from "@descryy/core";
+import { type ToolDefinition } from "./kit.ts";
+export type GitContextVerb = "diff" | "log";
+export type GitDiffEntry = GitDiffFile;
+export interface GitDiffData {
+    readonly mode: "range" | "working-tree";
+    readonly base: string | null;
+    readonly head: string | null;
+    readonly workingTree?: {
+        readonly scope: "unstaged" | "staged" | "all";
+        readonly includeUntracked: boolean;
+        readonly untrackedTotal: number;
+        readonly untrackedTruncated: boolean;
+    };
+    readonly files: readonly GitDiffEntry[];
+    readonly filesTotal: number;
+}
+export type GitHistoryCommit = PathLogCommit;
+export interface GitHistoryData {
+    readonly file: string;
+    readonly commits: readonly GitHistoryCommit[];
+    readonly totalTouching: number;
+}
+export type GitContextData = GitDiffData | GitHistoryData;
+export declare const gitContextTool: ToolDefinition;
+//# sourceMappingURL=git-context.d.ts.map

package/dist/tools/git-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../src/tools/git-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAMlB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAQ5C,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;QAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;KACtC,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAiED,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAC;AA2V1D,eAAO,MAAM,cAAc,EAAE,cAW5B,CAAC"}

package/dist/tools/git-context.js

@@ -0,0 +1,374 @@
+/**
+ * `git_context` — merges `get_git_diff` and `get_git_history` behind one
+ * `verb` (mcp-surface-consolidation.md group 2: both read/evidence, both live
+ * git reads of the working repository, neither touches the stored graph).
+ *
+ * Each verb's behaviour is unchanged from the tool it replaces. The two
+ * verbs' property sets do not overlap ("diff" never took a singular "file";
+ * "log" never took a "files" array), so `selectVerb` mostly guards against a
+ * genuinely misrouted call rather than a naming collision — but it is still
+ * mandatory, per verb.ts's header: a flat unioned schema cannot discriminate
+ * on its own once `additionalProperties: false` has to admit both verbs'
+ * properties.
+ */
+import { applyReplySizeBudget, changedFiles, gitDiff, gitWorkingTreeChange, logForPath, TOTAL_PATCH_BUDGET_REASON_PREFIX, } from "@descryy/core";
+import { answer, descryOwnState, optionalInteger, optionalString, optionalStringArray, requiredString, ToolInputError, } from "./kit.js";
+import { capBySize, sizeCapNote } from "../capped.js";
+import { selectVerb } from "./verb.js";
+// --- get_git_diff's own shapes, unchanged -----------------------------------
+const DIFF_DEFAULT_LIMIT = 200;
+const REPLY_BUDGET_REASON_PREFIX = "the reply's overall size ceiling";
+function fileBytes(file) {
+    return Buffer.byteLength(JSON.stringify(file), "utf8") + 1;
+}
+function fitDiff(identity, shown, filesTotal, budgetBytes) {
+    const scaffold = Buffer.byteLength(JSON.stringify({ ...identity, files: [], filesTotal }), "utf8");
+    const fitted = applyReplySizeBudget(shown, {
+        maxTotalBytes: budgetBytes,
+        overheadBytes: scaffold,
+        sizeOf: fileBytes,
+        hasPayload: (f) => f.patch !== null,
+        withhold: (f) => ({
+            ...f,
+            patch: null,
+            patchOmittedReason: `${REPLY_BUDGET_REASON_PREFIX} left no room for it`,
+        }),
+    });
+    const notes = [];
+    if (fitted.withheldCount > 0) {
+        notes.push(`${fitted.withheldCount} of the listed file(s) had their patch text withheld to keep this ` +
+            "reply inside its overall size ceiling, not by either patch budget — their stats above are " +
+            'complete. Re-request them with a narrowed "files" to read their patches.');
+    }
+    if (fitted.droppedCount > 0) {
+        notes.push(`${fitted.droppedCount} further changed file(s) are absent from this reply entirely — the ` +
+            "per-file rows for every changed file do not fit inside the reply's size ceiling on their " +
+            'own. This is a limit of one reply, not a finding about those files: re-request them with ' +
+            '"files" to see them.');
+    }
+    return {
+        data: { ...identity, files: fitted.items, filesTotal },
+        notes,
+        ...(fitted.droppedCount > 0
+            ? {
+                truncatedDetail: {
+                    shown: fitted.items.length,
+                    total: filesTotal,
+                    more: null,
+                },
+            }
+            : {}),
+    };
+}
+// --- get_git_history's own shapes, unchanged --------------------------------
+const LOG_DEFAULT_MAX_COMMITS = 20;
+/**
+ * `commits` scales with `maxCommits` (caller-controlled, no upper bound) and
+ * with how long each commit's own subject/body is, so even a file with a
+ * handful of commits carrying long bodies can overflow. Rows are
+ * self-contained, so shrinking means dropping trailing (older) commits.
+ */
+function fitLog(rest, shownCommits, budgetBytes) {
+    const scaffoldBytes = Buffer.byteLength(JSON.stringify({ ...rest, commits: [] }), "utf8");
+    const fit = capBySize(shownCommits, budgetBytes, scaffoldBytes);
+    const notes = fit.droppedForSize === 0 ? [] : [sizeCapNote("commit", fit.shown.length, shownCommits.length, fit.droppedForSize)];
+    return {
+        data: { ...rest, commits: fit.shown },
+        notes,
+        ...(fit.droppedForSize === 0
+            ? {}
+            : { truncatedDetail: { shown: fit.shown.length, total: rest.totalTouching, more: null } }),
+    };
+}
+// --- per-verb argument ownership, for selectVerb ----------------------------
+const VERB_SPECS = [
+    {
+        verb: "diff",
+        accepts: ["base", "workingTree", "includeUntracked", "head", "files", "maxPatchBytes", "maxTotalPatchBytes", "limit"],
+    },
+    { verb: "log", accepts: ["file", "maxCommits"] },
+];
+const SCHEMA = {
+    type: "object",
+    properties: {
+        verb: {
+            type: "string",
+            enum: ["diff", "log"],
+            description: "diff: changes + patch text between refs or uncommitted state. log: commit history for one file.",
+        },
+        base: {
+            type: "string",
+            description: "diff only: ref to diff against. Required unless workingTree given.",
+        },
+        workingTree: {
+            type: "string",
+            enum: ["unstaged", "staged", "all"],
+            description: "diff only: uncommitted state instead of two refs. Exclusive with base.",
+        },
+        includeUntracked: {
+            type: "boolean",
+            description: "diff only, with workingTree: also report never-added files. Default true.",
+        },
+        head: { type: "string", description: "diff only: tip diffed. Default HEAD." },
+        files: {
+            type: "array",
+            items: { type: "string" },
+            description: "diff only: restrict to these paths. Default: whole diff.",
+        },
+        maxPatchBytes: {
+            type: "integer",
+            minimum: 1,
+            description: "diff only: omit a file's patch (stats kept) above this size. Default 20,000.",
+        },
+        maxTotalPatchBytes: {
+            type: "integer",
+            minimum: 1,
+            description: "diff only: cap on total patch text. Default 40,000; over it, patch withheld.",
+        },
+        file: {
+            type: "string",
+            description: "log only, REQUIRED: path to read history for.",
+        },
+        maxCommits: {
+            type: "integer",
+            minimum: 1,
+            description: "log only: cap on commits, newest-first. Default 20.",
+        },
+        limit: { type: "integer", minimum: 1, description: "diff only: cap on files in the reply. Default 200." },
+    },
+    required: ["verb"],
+    additionalProperties: false,
+};
+async function runDiff(args, ctx) {
+    const workingTree = optionalString(args, "workingTree");
+    const includeUntracked = args["includeUntracked"] !== false;
+    const baseArg = optionalString(args, "base");
+    if (workingTree === undefined && baseArg === undefined) {
+        throw new ToolInputError('Give either "base" (a ref range) or "workingTree" (uncommitted state). There is no ' +
+            "defensible default, and guessing one silently changes which diff the answer describes.");
+    }
+    if (workingTree !== undefined && baseArg !== undefined) {
+        throw new ToolInputError('"base" and "workingTree" are mutually exclusive — they are two different questions. ' +
+            "Ask one.");
+    }
+    if (workingTree !== undefined && !["unstaged", "staged", "all"].includes(workingTree)) {
+        throw new ToolInputError(`"workingTree" must be "unstaged", "staged" or "all" — got "${workingTree}".`);
+    }
+    const base = baseArg ?? null;
+    const head = base === null ? null : optionalString(args, "head") ?? "HEAD";
+    const files = optionalStringArray(args, "files");
+    const maxPatchBytes = optionalInteger(args, "maxPatchBytes", 1);
+    const maxTotalPatchBytes = optionalInteger(args, "maxTotalPatchBytes", 1);
+    const limit = optionalInteger(args, "limit", 1) ?? DIFF_DEFAULT_LIMIT;
+    const { session } = ctx;
+    const stamp = session.provider().baseStamp();
+    const envelope = {
+        resolutionFloor: 0,
+        commitSha: stamp.commitSha,
+        graphBuiltAt: stamp.graphBuiltAt,
+        irSchemaVersion: stamp.irSchemaVersion,
+        commitSpread: stamp.commitSpread,
+        repoCount: stamp.repoCount,
+        nameLevel: true,
+    };
+    const scope = (workingTree ?? "all");
+    const subject = base === null ? `the working tree (${scope})` : `${base}...${head}`;
+    const mode = base === null ? "working-tree" : "range";
+    ctx.progress(`Diffing ${subject}`);
+    let all;
+    let untrackedTotal = 0;
+    let untrackedTruncated = false;
+    try {
+        if (base === null) {
+            const change = await gitWorkingTreeChange(session.repoPath, {
+                scope,
+                includeUntracked,
+                exclude: descryOwnState(session.config.graph),
+                ...(files === undefined ? {} : { files }),
+                ...(maxPatchBytes === undefined ? {} : { maxPatchBytes }),
+                ...(maxTotalPatchBytes === undefined ? {} : { maxTotalPatchBytes }),
+            });
+            all = change.files;
+            untrackedTotal = change.untrackedTotal;
+            untrackedTruncated = change.untrackedTruncated;
+        }
+        else {
+            all = await gitDiff(session.repoPath, base, head, {
+                ...(files === undefined ? {} : { files }),
+                ...(maxPatchBytes === undefined ? {} : { maxPatchBytes }),
+                ...(maxTotalPatchBytes === undefined ? {} : { maxTotalPatchBytes }),
+            });
+        }
+    }
+    catch (error) {
+        return answer({
+            ...envelope,
+            headline: `Could not diff ${subject}.`,
+            state: "refused",
+            data: {
+                mode,
+                base,
+                head,
+                files: [],
+                filesTotal: 0,
+                ...(base === null
+                    ? { workingTree: { scope, includeUntracked, untrackedTotal: 0, untrackedTruncated: false } }
+                    : {}),
+            },
+            notes: [
+                `git rejected it: ${error.message.trim()}.`,
+                "No diff was read, which is not a finding that nothing changed.",
+            ],
+        });
+    }
+    let filesMatchedNothing = false;
+    let wholeDiffCount = 0;
+    if (base !== null && all.length === 0 && files !== undefined && files.length > 0) {
+        ctx.progress(`Checking whether ${base}...${head} has any changes at all`);
+        const wholeDiff = await changedFiles(session.repoPath, base, head).catch(() => null);
+        if (wholeDiff !== null && wholeDiff.length > 0) {
+            filesMatchedNothing = true;
+            wholeDiffCount = wholeDiff.length;
+        }
+    }
+    const shown = all.slice(0, limit);
+    const notes = [];
+    if (filesMatchedNothing) {
+        notes.push(`0 of the ${(files ?? []).length} named file(s) have any change in ${subject}, which ` +
+            `changes ${wholeDiffCount} file(s) in total when read without "files". This is not a ` +
+            "statement that the diff itself is empty.");
+    }
+    if (shown.length < all.length) {
+        notes.push(`${all.length - shown.length} further changed file(s) exist but are not listed — the reply ` +
+            `is capped at ${limit}.`);
+    }
+    const omittedPatches = shown.filter((f) => f.patchOmittedReason !== null).length;
+    if (omittedPatches > 0) {
+        notes.push(`${omittedPatches} of the listed file(s) had their patch text withheld — see each file's own ` +
+            '"patchOmittedReason".');
+    }
+    const budgetWithheld = shown.filter((f) => f.patchOmittedReason?.startsWith(TOTAL_PATCH_BUDGET_REASON_PREFIX)).length;
+    if (budgetWithheld > 0) {
+        notes.push(`${budgetWithheld} of those were withheld by the reply's total patch budget, not by their ` +
+            'own size — their stats above are complete. Re-request them with a narrowed "files" to ' +
+            "read their patches.");
+    }
+    if (base === null && !includeUntracked) {
+        notes.push("Untracked files were not included — no form of git diff reports them, so a file written " +
+            'and not yet added is absent from this answer. Pass "includeUntracked" to see them.');
+    }
+    if (untrackedTruncated) {
+        notes.push(`${untrackedTotal} untracked file(s) exist and only some were diffed. The rest were counted, ` +
+            "not examined.");
+    }
+    return answer({
+        ...envelope,
+        headline: all.length === 0
+            ? filesMatchedNothing
+                ? `0 of the ${(files ?? []).length} named file(s) have any change in ${subject}. ` +
+                    "Not empty, not checked for those files."
+                : `${subject} has no changes.`
+            : `${subject} changes ${all.length} file(s)` +
+                (shown.length < all.length ? `, showing the first ${shown.length}.` : "."),
+        ...(all.length === 0 ? { state: "empty" } : {}),
+        data: {
+            mode,
+            base,
+            head,
+            files: shown,
+            filesTotal: all.length,
+            ...(base === null
+                ? { workingTree: { scope, includeUntracked, untrackedTotal, untrackedTruncated } }
+                : {}),
+        },
+        truncated: shown.length < all.length,
+        ...(shown.length < all.length
+            ? { truncatedDetail: { shown: shown.length, total: all.length, more: null } }
+            : {}),
+        notes,
+        fitToBudget: (budgetBytes) => fitDiff({
+            mode,
+            base,
+            head,
+            ...(base === null
+                ? { workingTree: { scope, includeUntracked, untrackedTotal, untrackedTruncated } }
+                : {}),
+        }, shown, all.length, budgetBytes),
+    });
+}
+async function runLog(args, ctx) {
+    const file = requiredString(args, "file");
+    const maxCommits = optionalInteger(args, "maxCommits", 1) ?? LOG_DEFAULT_MAX_COMMITS;
+    const { session } = ctx;
+    const stamp = session.provider().baseStamp();
+    const envelope = {
+        resolutionFloor: 0,
+        commitSha: stamp.commitSha,
+        graphBuiltAt: stamp.graphBuiltAt,
+        irSchemaVersion: stamp.irSchemaVersion,
+        commitSpread: stamp.commitSpread,
+        repoCount: stamp.repoCount,
+        nameLevel: true,
+    };
+    ctx.progress(`Reading live commit history for ${file}`);
+    let result;
+    try {
+        result = await logForPath(session.repoPath, file, { maxCommits });
+    }
+    catch (error) {
+        return answer({
+            ...envelope,
+            headline: `Could not read history for "${file}".`,
+            state: "refused",
+            data: { file, commits: [], totalTouching: 0 },
+            notes: [
+                `git rejected the read: ${error.message.trim()}.`,
+                "No history was read, which is not a finding that this file has none.",
+            ],
+        });
+    }
+    const notes = [];
+    if (result.totalTouching > result.commits.length) {
+        notes.push(`${result.totalTouching - result.commits.length} further commit(s) touch this file but are ` +
+            `not listed — the reply is capped at ${maxCommits}, newest-first.`);
+    }
+    const restOfLogData = { file, totalTouching: result.totalTouching };
+    return answer({
+        ...envelope,
+        headline: result.totalTouching === 0
+            ? `No commit reachable from HEAD touches "${file}".`
+            : `${result.totalTouching} commit(s) touch "${file}"` +
+                (result.commits.length < result.totalTouching
+                    ? `; showing the ${result.commits.length} most recent.`
+                    : "."),
+        ...(result.totalTouching === 0 ? { state: "empty" } : {}),
+        data: { ...restOfLogData, commits: result.commits },
+        truncated: result.commits.length < result.totalTouching,
+        ...(result.commits.length < result.totalTouching
+            ? { truncatedDetail: { shown: result.commits.length, total: result.totalTouching, more: null } }
+            : {}),
+        notes,
+        fitToBudget: (budgetBytes) => fitLog(restOfLogData, result.commits, budgetBytes),
+    });
+}
+async function run(args, ctx) {
+    const verb = selectVerb(args, "verb", VERB_SPECS);
+    switch (verb) {
+        case "diff":
+            return runDiff(args, ctx);
+        case "log":
+            return runLog(args, ctx);
+    }
+}
+export const gitContextTool = {
+    name: "git_context",
+    class: "read",
+    tier: "evidence",
+    version: "1.0.0",
+    title: "Live git diff or live git log, read directly from the repository",
+    description: "Live reads of the repository, never the stored graph. diff: changes + patch text between " +
+        "refs or uncommitted state. log: commit history for one file.",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=git-context.js.map

package/dist/tools/git-context.js.map

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

package/dist/tools/git-diff.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `get_git_diff` — §18's "other useful Git tool": a live textual diff
+ * between two refs. P27's disclosed remainder — `ai-layer-plan.md` §3's
+ * re-derivation found `history.ts`'s own header already stating why it
+ * cannot be stretched into this shape: it is scoped to the stored
+ * `CHANGES_WITH` ledger, not a live `git diff`. `changedFiles`
+ * (`cross-pr.ts`) answers "which files changed" as a bare path list; this
+ * answers "what changed in them" — per-file status and line counts always,
+ * plus the unified-diff patch text when it is cheap enough to hand to a
+ * model (§4: the client's context window is not this tool's to spend).
+ */
+import type { GitDiffFile } from "@descryy/core";
+import { type ToolDefinition } from "./kit.ts";
+export type GitDiffEntry = GitDiffFile;
+/**
+ * One shape for all three states (`ok` / `empty` / `refused`) — unlike
+ * `cross-pr`'s union, a git-rejected range and a genuinely empty diff carry
+ * the identical fields here (`files: []`, `filesTotal: 0`); `state` and
+ * `disclosures` are what tell them apart, not the payload's shape.
+ */
+export interface GitDiffData {
+    /**
+     * Which question was answered — declared by the caller, never inferred.
+     *
+     * `range` compares two refs. `working-tree` reports what is uncommitted right
+     * now. They are different questions and a reply that did not say which one it
+     * answered would be readable as either.
+     */
+    readonly mode: "range" | "working-tree";
+    /** Null in working-tree mode: there is no second ref to compare against. */
+    readonly base: string | null;
+    readonly head: string | null;
+    /** Present in working-tree mode only. */
+    readonly workingTree?: {
+        readonly scope: "unstaged" | "staged" | "all";
+        readonly includeUntracked: boolean;
+        readonly untrackedTotal: number;
+        readonly untrackedTruncated: boolean;
+    };
+    /** Capped by `limit`; `filesTotal` is the uncapped count. Empty on a git failure. */
+    readonly files: readonly GitDiffEntry[];
+    readonly filesTotal: number;
+}
+export declare const gitDiffTool: ToolDefinition;
+//# sourceMappingURL=git-diff.d.ts.map

package/dist/tools/git-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.d.ts","sourceRoot":"","sources":["../../src/tools/git-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AA4FlB,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;QAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;KACtC,CAAC;IACF,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAiRD,eAAO,MAAM,WAAW,EAAE,cAsBzB,CAAC"}