claude-code-infinite 1.0.11 → 1.0.14

package/dist/project-meta.d.ts

@@ -0,0 +1,15 @@
+export interface ProjectMeta {
+    project_dir?: string;
+    git_repo?: string;
+    git_branch?: string;
+    git_commit?: string;
+}
+export type GitRunner = (args: string[], cwd: string) => Promise<string | undefined>;
+export declare function readProjectMeta(cwd?: string, git?: GitRunner): Promise<ProjectMeta>;
+/**
+ * `owner/repo` from a remote URL in any of git's forms (`https://…`,
+ * `ssh://…`, `git@host:owner/repo.git`, a local path): the last two path
+ * segments, `.git` dropped. Host, user, password and query never survive.
+ */
+export declare function repoNameFromRemote(remote: string): string | undefined;
+//# sourceMappingURL=project-meta.d.ts.map

package/dist/project-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-meta.d.ts","sourceRoot":"","sources":["../src/project-meta.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAErF,wBAAsB,eAAe,CACnC,GAAG,GAAE,MAAsB,EAC3B,GAAG,GAAE,SAAkB,GACtB,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBrE"}

package/dist/project-meta.js

@@ -0,0 +1,80 @@
+/**
+ * The project a ccc session runs in, sent with every MemTree call in
+ * `x-client-meta` (cc-request.ts memtreeClientMeta) so the user can list and
+ * search their sessions by project (`GET /v1/memtree/sessions?project=`).
+ *
+ * Read once at startup from the working directory: its name, the `origin`
+ * remote reduced to `owner/repo` (never the URL, so no host, user or token
+ * leaves the machine), the branch and the short HEAD commit. Every part is
+ * optional: outside a git repository, with git missing, or when a command is
+ * slow, the part is simply left out. Never throws.
+ */
+import { execFile } from "node:child_process";
+import path from "node:path";
+/** What the server keeps: short printable ASCII (client_session.py). */
+const META_VALUE = /^[\x20-\x7e]{1,128}$/;
+const GIT_TIMEOUT_MS = 1_500;
+export async function readProjectMeta(cwd = process.cwd(), git = runGit) {
+    const [remote, branch, commit] = await Promise.all([
+        git(["remote", "get-url", "origin"], cwd),
+        git(["rev-parse", "--abbrev-ref", "HEAD"], cwd),
+        git(["rev-parse", "--short", "HEAD"], cwd),
+    ]);
+    const candidate = {
+        project_dir: path.basename(path.resolve(cwd)),
+        git_repo: remote ? repoNameFromRemote(remote) : undefined,
+        git_branch: branch && branch !== "HEAD" ? branch : undefined,
+        git_commit: commit && /^[0-9a-f]{4,40}$/.test(commit) ? commit : undefined,
+    };
+    const meta = {};
+    for (const [key, value] of Object.entries(candidate)) {
+        if (value && META_VALUE.test(value))
+            meta[key] = value;
+    }
+    return meta;
+}
+/**
+ * `owner/repo` from a remote URL in any of git's forms (`https://…`,
+ * `ssh://…`, `git@host:owner/repo.git`, a local path): the last two path
+ * segments, `.git` dropped. Host, user, password and query never survive.
+ */
+export function repoNameFromRemote(remote) {
+    let pathPart = remote.trim();
+    if (!pathPart)
+        return undefined;
+    const scheme = /^[A-Za-z][A-Za-z0-9+.-]*:\/\//.exec(pathPart);
+    if (scheme) {
+        try {
+            pathPart = new URL(pathPart).pathname;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    else {
+        // scp-like `user@host:owner/repo`: everything after the first colon.
+        const scp = /^[^/:]+:(.*)$/.exec(pathPart);
+        if (scp)
+            pathPart = scp[1];
+    }
+    const segments = pathPart
+        .replace(/[?#].*$/, "")
+        .split(/[/\\]+/)
+        .filter(Boolean);
+    if (!segments.length)
+        return undefined;
+    segments[segments.length - 1] = segments[segments.length - 1].replace(/\.git$/, "");
+    const name = segments.slice(-2).join("/");
+    return name && !name.includes("@") ? name : undefined;
+}
+function runGit(args, cwd) {
+    return new Promise((resolve) => {
+        try {
+            execFile("git", args, { cwd, timeout: GIT_TIMEOUT_MS, windowsHide: true }, (err, stdout) => resolve(err ? undefined : String(stdout).trim() || undefined));
+        }
+        catch {
+            resolve(undefined);
+        }
+    });
+}
+//# sourceMappingURL=project-meta.js.map

package/dist/project-meta.js.map

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

package/dist/prompt-accounting.d.ts

@@ -0,0 +1,12 @@
+/** Display-only accounting: this class has no route authority. */
+export declare class PromptAccounting {
+    private readonly now;
+    private records;
+    constructor(now?: () => number);
+    add(sessionId: string | undefined, id: string | undefined, text: string | undefined): void;
+    hasId(id: string): boolean;
+    capture(sessionId: string | undefined, message: any): (delivered: boolean) => void;
+    pending(sessionId?: string): number;
+    private expire;
+}
+//# sourceMappingURL=prompt-accounting.d.ts.map

package/dist/prompt-accounting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-accounting.d.ts","sourceRoot":"","sources":["../src/prompt-accounting.ts"],"names":[],"mappings":"AAQA,kEAAkE;AAClE,qBAAa,gBAAgB;IAEf,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,OAAO,CAAC,OAAO,CAAsB;gBACR,GAAG,eAAW;IAE3C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAW1F,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK1B,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI;IAmBlF,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAKnC,OAAO,CAAC,MAAM;CAGf"}

package/dist/prompt-accounting.js

@@ -0,0 +1,70 @@
+import { stripSystemReminderText } from "./turns.js";
+const SESSION_PROMPT_LIMIT = 32;
+const TOTAL_PROMPT_LIMIT = 4096;
+const PROMPT_TTL_MS = 10 * 60_000;
+/** Display-only accounting: this class has no route authority. */
+export class PromptAccounting {
+    now;
+    records = [];
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    add(sessionId, id, text) {
+        this.expire();
+        const sameSession = this.records.filter((item) => item.sessionId === sessionId);
+        if (sameSession.length >= SESSION_PROMPT_LIMIT) {
+            this.records.splice(this.records.indexOf(sameSession[0]), 1);
+        }
+        // Also bound process-wide state when one proxy observes many sessions.
+        if (this.records.length >= TOTAL_PROMPT_LIMIT)
+            this.records.shift();
+        this.records.push({ sessionId, id, text, createdAt: this.now() });
+    }
+    hasId(id) {
+        this.expire();
+        return this.records.some((item) => item.id === id);
+    }
+    capture(sessionId, message) {
+        this.expire();
+        const texts = new Set(deliveredTexts(message).map(normalizeDeliveryText).filter(Boolean));
+        const candidates = new Set(this.records.filter((item) => item.sessionId === sessionId &&
+            texts.has(normalizeDeliveryText(item.text ?? ""))));
+        let settled = false;
+        return (delivered) => {
+            if (settled)
+                return;
+            settled = true;
+            if (!delivered)
+                return;
+            // Select the oldest still-pending snapshot record at settlement. Two
+            // concurrent deliveries can then retire two duplicates, while neither
+            // may consume a hook record that arrived after its request started.
+            this.expire();
+            this.records = this.records.filter((item) => !candidates.has(item) || !texts.delete(normalizeDeliveryText(item.text ?? "")));
+        };
+    }
+    pending(sessionId) {
+        this.expire();
+        return this.records.filter((item) => item.sessionId === sessionId).length;
+    }
+    expire() {
+        this.records = this.records.filter((item) => this.now() - item.createdAt < PROMPT_TTL_MS);
+    }
+}
+function deliveredTexts(message) {
+    if (message?.role !== "user")
+        return [];
+    if (typeof message.content === "string")
+        return [message.content];
+    if (!Array.isArray(message.content))
+        return [];
+    return message.content.flatMap((part) => {
+        if (typeof part === "string")
+            return [part];
+        return part?.type === "text" && typeof part.text === "string" ? [part.text] : [];
+    });
+}
+function normalizeDeliveryText(text) {
+    return stripSystemReminderText(text).replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=prompt-accounting.js.map

package/dist/prompt-accounting.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Claude Code Infinite local proxy (plans/2026-06-09_PLAN_local_proxy_app.md,
+ * refined by plans/2026-07-05_PLAN_first_user_turn_nonblocking.md).
+ *
+ * Claude Code points ANTHROPIC_BASE_URL at this 127.0.0.1 server. We never
+ * read, store, or refresh credentials: Claude Code keeps its native login and
+ * sends its own OAuth bearer here, and we forward its headers and query string
+ * verbatim to api.anthropic.com (the anthropic-beta flag list churns across CC
+ * versions — never reconstruct it). Only the `messages` body is ever altered
+ * (compression, plus defensive removal of legacy notice markers);
+ * auth, identity, and routing are never touched.
+ *
+ * Turn classification for POST /v1/messages:
+ * - Tool turn (last message isn't a real user input): background indexing,
+ *   forward as-is — riding its lane's memory route (routes live in a small
+ *   map keyed by request identity: session + main/away/agent-id), on the main
+ *   thread the session's stable prefix, or verbatim — while the estimated
+ *   size is under the budget, with no compress call. At the budget it
+ *   compresses once to the target (planToolCompaction), the same rule human
+ *   turns follow; on the main thread the result becomes the stable prefix
+ *   later tool and human turns ride. Failure degrades to the old ride or the
+ *   verbatim forward. Every identity installs into its own lane — isolation
+ *   is structural, not defended.
+ * - First user turn (no earlier real user input): background indexing, forward
+ *   as-is — nothing is indexed yet, so blocking would be a guaranteed no-op.
+ * - Followup user turn: blocking compress + substitute. The compressed body
+ *   remains the prefix for that turn's tool loop. On the main thread a
+ *   compaction also becomes the session's stable prefix (planEdgeCompaction):
+ *   later human turns ride it byte for byte, with no compress call, until
+ *   prefix + newer turns reach the budget or the covered messages change.
+ * - MemTree failure/timeout degrades to passthrough. A display-only success
+ *   notice is queued only when the memory response is selected AND MemTree's
+ *   index coverage grew since the last announcement (unchanged coverage means
+ *   the turn was appended after an index that learned nothing new); degraded
+ *   and unpaid states get their own notices.
+ *
+ * Every /v1/messages and count_tokens body is run through the legacy notice
+ * strip pass before hashing/forwarding. Live notices use Claude Code hooks and
+ * upstream response bytes pass through to the client unchanged.
+ */
+import { capCacheBreakpoints } from "./route-cache.js";
+import { estimateRequestTokens } from "./request-sizing.js";
+import { MemtreeClient } from "./memtree.js";
+import type { MemtreeLinkPlacement } from "./cli-args.js";
+import { type MemtreeLinkStore } from "./memtree-links.js";
+import type { NewestTreeLookup } from "./memtree-newest.js";
+import type { TranscriptUsageSource } from "./transcript-usage.js";
+import type { ProjectMeta } from "./project-meta.js";
+import { type RequestLogSink } from "./reqlog.js";
+export interface ProxyOptions {
+    memtree: MemtreeClient;
+    /**
+     * Treat current native-1M Anthropic model ids as 1M without requiring the
+     * legacy context-1m beta header. Defaults to true. Set false only when the
+     * client deliberately disables native 1M context.
+     */
+    nativeOneMillionContext?: boolean;
+    /**
+     * Tool-turn compaction (default true): a tool turn on any lane whose
+     * estimated size reaches the budget compresses once to the target, like a
+     * main human turn (planToolCompaction); on the main thread the result is
+     * the session's stable prefix. A soft fuse, not a hard payload cap: MemTree
+     * failure degrades to the old prefix or the original body. `false` (the
+     * CLI's `CCC_TOOL_ROUTE_RECOVERY=0`) is a pure-passthrough switch for tool
+     * turns: no size check and no compress call; they ride their lane's route
+     * when one exists and otherwise go out whole.
+     */
+    toolRouteRecovery?: boolean;
+    /**
+     * Size requests exactly with Anthropic's Count Tokens endpoint, using the
+     * request's own credentials (count-tokens.ts): before a compaction decision
+     * when the estimate is unknown or a jump nears the budget, and always before
+     * refusing a request on an estimate. The CLI turns this on
+     * (`CCC_COUNT_TOKENS=0` turns it off); embedders and tests keep estimates.
+     */
+    countTokens?: boolean;
+    /**
+     * Handle only Claude Code's own requests. ccc launches Claude Code with
+     * ANTHROPIC_BASE_URL pointing here, and every program Claude Code runs
+     * inherits it (scripts, test suites, SDK apps, a benchmark's judge calls).
+     * Claude Code's API client always sends `X-Claude-Code-Session-Id`; a
+     * request without it is another program's and is forwarded to Anthropic
+     * byte for byte: no MemTree compress or index, no route state, logged as
+     * `turnType: "foreign"`. The CLI turns this on; embedders and tests that
+     * send bare requests keep the old behaviour by default.
+     */
+    claudeCodeOnly?: boolean;
+    /**
+     * Compaction target (tokens) for every session that has not run
+     * `/memtree-compact`: `CCC_COMPACT_TARGET`. For benchmarks and headless
+     * runs, where the hook-driven command is unavailable. It sets what each
+     * compaction aims at (instead of half the budget); it does not trigger
+     * one — that is still the budget. `/memtree-compact off` still turns
+     * compaction off for one session. null (`CCC_COMPACT_TARGET=off`) starts
+     * every session in the `/memtree-compact off` state, for headless runs that
+     * cannot type the command; `/memtree-compact [N]` still turns it back on.
+     */
+    defaultCompactTarget?: number | null;
+    /**
+     * Test-only whole-request budget (tokens) for every session:
+     * `CCC_BUDGET_TOKENS`. Replaces the server-reported model budget (and the
+     * context-window fallback) so a cheap session crosses it in a few turns.
+     */
+    budgetTokensOverride?: number;
+    /** Test-only overrides for the first-tree probe (5s) and total wait (60s). */
+    awaitedIndexProbeTimeoutMs?: number;
+    awaitedIndexWaitTimeoutMs?: number;
+    debug?: boolean;
+    /**
+     * Always-on request/timing JSONL log (see reqlog.ts). Includes messages,
+     * MemTree calls, and successful notice claims; omitted means no logging.
+     */
+    reqlog?: RequestLogSink;
+    /**
+     * Where the MemTree page link is shown (default "turn"):
+     * - "turn": `• MemTree · <url>` once at the end of a user turn (Stop), and
+     *   only when the index behind the link changed since it was last shown.
+     * - "message": `• MemTree · <url>` under every finished assistant message,
+     *   Stop as the fallback for a turn that rendered none; the first message
+     *   after a newly finished index came into use is green, later ones dim.
+     * - "stop": the same trailer, on Stop only, once per turn.
+     * - "success": only under the `✓ MemTree · conversation optimized` line.
+     * In "turn" (the default) and "success", the success line carries the
+     * current page link on its own line below it; in "turn" the end-of-turn
+     * trailer then skips a link that line already showed.
+     * - "off": no link anywhere (the page still reaches the request log).
+     * The CLI maps `CCC_MEMTREE_LINK` onto this.
+     */
+    memtreeLinkPlacement?: MemtreeLinkPlacement;
+    /**
+     * Where the newest page per session is persisted so a resumed session can
+     * show its link (SessionStart hook). Omitted means no persistence (tests);
+     * the CLI passes the default store under ~/.claude-code-infinite.
+     */
+    memtreeLinkStore?: MemtreeLinkStore;
+    /**
+     * The session's newest completed tree, asked of the server, which the link
+     * shown to the user points at (the compress page is only the tree the memory
+     * came from, and can be days old). Omitted means the link is the compress
+     * page (tests); the CLI passes a lookup over the user's key.
+     */
+    newestTrees?: NewestTreeLookup;
+    /**
+     * Per-response token usage (thinking share on the MemTree page), read from
+     * Claude Code's transcript. Omitted means none is sent (tests); the CLI
+     * passes the reader for ~/.claude/projects.
+     */
+    transcriptUsage?: TranscriptUsageSource;
+    /**
+     * The session's project (project-meta.ts: directory name, `owner/repo`,
+     * branch, commit), added to every MemTree call's `x-client-meta` so the
+     * user can find sessions by project. Omitted means none is sent.
+     */
+    projectMeta?: ProjectMeta;
+    /** Test-only: forward to this origin instead of api.anthropic.com. */
+    upstreamOrigin?: string;
+    /** Test-only: dump each forwarded /v1/messages body to this directory. */
+    captureDir?: string;
+    /**
+     * Test-only fault-injection seam: invoked inside installMemoryRoute after
+     * its guards pass, immediately before the route is stored. Throwing here
+     * simulates route bookkeeping failing (the cloneJson/JSON.stringify
+     * calls), which no natural input can trigger — every install input has
+     * already survived JSON.parse. Exists solely so the "activation-error"
+     * install fate (label precedence over clientAborted, release keeping the
+     * lane's backoff) is pinnable by tests. Undefined in production.
+     */
+    routeInstallFault?: () => void;
+}
+export interface RunningProxy {
+    port: number;
+    /** Random per-process endpoint used by the ephemeral Claude plugin. */
+    hookUrl: string;
+    close: () => void;
+    /**
+     * Stop accepting work and give active requests a bounded grace period.
+     * On expiry, every accepted request and upstream is cancelled, then request
+     * finalizers are awaited; false reports that forced cancellation was needed.
+     */
+    drain: (timeoutMs?: number) => Promise<boolean>;
+}
+/**
+ * Budget fallback until the server reports `model_budget_tokens`: this share
+ * of the model's context window (800k of Opus 5.5's 1M, matching the server's
+ * large-context threshold).
+ */
+export declare const FALLBACK_BUDGET_WINDOW_RATIO = 0.8;
+export declare function startProxy(opts: ProxyOptions): Promise<RunningProxy>;
+/** The page id in a server-stamped link (`…/m/<id>` or `…/usage/memtree/<id>`). */
+export declare function memtreePageId(pageUrl: string): string | undefined;
+export declare const MEMTREE_COMPACT_MIN_TOKENS = 20000;
+/** "50k", "50000", "1.5m" → tokens; undefined when not a positive count. */
+export declare function parseTokenCount(text: string): number | undefined;
+/** Test seam. */
+export declare const __testCapCacheBreakpoints: typeof capCacheBreakpoints;
+export declare const __testEstimateRequestTokens: typeof estimateRequestTokens;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AASvD,OAAO,EAAiB,qBAAqB,EACD,MAAM,qBAAqB,CAAC;AAiBxE,OAAO,EAIL,aAAa,EAMd,MAAM,cAAc,CAAC;AAyCtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAA8B,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAS5D,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAOL,KAAK,cAAc,EAGpB,MAAM,aAAa,CAAC;AAgCrB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;;;;OASG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;OAIG;IACH,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD;AA6MD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAyMhD,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAkIpE;AAuQD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjE;AA05CD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AA4CjD,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhE;AAy2FD,iBAAiB;AACjB,eAAO,MAAM,yBAAyB,4BAAsB,CAAC;AAC7D,eAAO,MAAM,2BAA2B,8BAAwB,CAAC"}