chivgent 0.7.0 → 0.9.0

package/dist/context/compaction.js

@@ -0,0 +1,141 @@
+export const DEFAULT_FILE_EFFECTS = {
+    reads: ["read_file"],
+    mutates: ["write_file", "edit_file"],
+};
+const SUMMARY_INSTRUCTIONS = `You are compacting an engineering conversation so it can continue in a smaller context.
+Reply with JSON only, no code fence, matching:
+{"summary": string, "decisions": string[], "pendingTasks": string[]}
+summary: what was asked and what was established, in a few sentences.
+decisions: choices that later work must respect.
+pendingTasks: work that was identified but not finished.
+Omit file lists; they are tracked separately.`;
+export class Compactor {
+    llm;
+    fileEffects;
+    constructor(llm, options = {}) {
+        this.llm = llm;
+        this.fileEffects = options.fileEffects ?? DEFAULT_FILE_EFFECTS;
+    }
+    async compact(messages, signal) {
+        const files = collectFiles(messages, this.fileEffects);
+        const prose = await this.summarise(messages, signal);
+        return { ...prose, ...files };
+    }
+    async summarise(messages, signal) {
+        const response = await this.llm.complete({
+            systemPrompt: SUMMARY_INSTRUCTIONS,
+            messages: [{ role: "user", content: renderTranscript(messages) }],
+            tools: [],
+            ...(signal === undefined ? {} : { signal }),
+        });
+        return parseSummary(response.message.content);
+    }
+}
+/** Falls back to the raw text when the model does not return usable JSON. */
+export function parseSummary(content) {
+    const fallback = {
+        summary: content.trim(),
+        decisions: [],
+        pendingTasks: [],
+    };
+    const start = content.indexOf("{");
+    const end = content.lastIndexOf("}");
+    if (start === -1 || end <= start) {
+        return fallback;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content.slice(start, end + 1));
+    }
+    catch {
+        return fallback;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return fallback;
+    }
+    const record = parsed;
+    const summary = typeof record.summary === "string" && record.summary.trim().length > 0
+        ? record.summary.trim()
+        : fallback.summary;
+    return {
+        summary,
+        decisions: stringList(record.decisions),
+        pendingTasks: stringList(record.pendingTasks),
+    };
+}
+function stringList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((entry) => typeof entry === "string" && entry.length > 0);
+}
+function collectFiles(messages, effects) {
+    const readFiles = new Set();
+    const modifiedFiles = new Set();
+    for (const message of messages) {
+        if (message.role !== "assistant") {
+            continue;
+        }
+        for (const call of message.toolCalls) {
+            const filePath = pathArgument(call);
+            if (filePath === undefined) {
+                continue;
+            }
+            if (effects.mutates.includes(call.name)) {
+                modifiedFiles.add(filePath);
+            }
+            else if (effects.reads.includes(call.name)) {
+                readFiles.add(filePath);
+            }
+        }
+    }
+    // A file that was changed is more relevant as "changed" than as "read".
+    for (const filePath of modifiedFiles) {
+        readFiles.delete(filePath);
+    }
+    return {
+        readFiles: [...readFiles].sort(),
+        modifiedFiles: [...modifiedFiles].sort(),
+    };
+}
+function pathArgument(call) {
+    if (typeof call.arguments !== "object" || call.arguments === null) {
+        return undefined;
+    }
+    const value = call.arguments.path;
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function renderTranscript(messages) {
+    return messages
+        .map((message) => {
+        if (message.role === "assistant") {
+            const calls = message.toolCalls
+                .map((call) => `\n[tool call] ${call.name} ${JSON.stringify(call.arguments)}`)
+                .join("");
+            return `assistant: ${message.content}${calls}`;
+        }
+        if (message.role === "tool") {
+            return `[tool result] ${message.toolName}${message.isError ? " (error)" : ""}: ${message.content}`;
+        }
+        return `user: ${message.content}`;
+    })
+        .join("\n\n");
+}
+/** Renders compaction state as the single message that replaces the history. */
+export function renderCompactionState(state) {
+    const sections = [`Summary of earlier work:\n${state.summary}`];
+    if (state.readFiles.length > 0) {
+        sections.push(`Files read:\n${state.readFiles.map((f) => `- ${f}`).join("\n")}`);
+    }
+    if (state.modifiedFiles.length > 0) {
+        sections.push(`Files modified:\n${state.modifiedFiles.map((f) => `- ${f}`).join("\n")}`);
+    }
+    if (state.decisions.length > 0) {
+        sections.push(`Decisions to respect:\n${state.decisions.map((d) => `- ${d}`).join("\n")}`);
+    }
+    if (state.pendingTasks.length > 0) {
+        sections.push(`Still pending:\n${state.pendingTasks.map((t) => `- ${t}`).join("\n")}`);
+    }
+    return sections.join("\n\n");
+}
+//# sourceMappingURL=compaction.js.map

package/dist/context/compaction.js.map

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

package/dist/context/context-manager.d.ts

@@ -0,0 +1,72 @@
+import type { Message } from "../messages.js";
+import { Compactor, type CompactionState } from "./compaction.js";
+import { type TokenEstimator } from "./token-estimator.js";
+export declare const DEFAULT_CONTEXT_WINDOW = 128000;
+export declare const DEFAULT_RESERVE_TOKENS = 16384;
+export declare const DEFAULT_KEEP_RECENT_TOKENS = 20000;
+export interface ContextManagerOptions {
+    readonly contextWindow?: number;
+    /** Head-room left for the model's own reply and for estimator error. */
+    readonly reserveTokens?: number;
+    /** Roughly how much recent conversation survives a compaction verbatim. */
+    readonly keepRecentTokens?: number;
+    readonly estimator?: TokenEstimator;
+    /** Omit to disable compaction; the transcript is then passed through. */
+    readonly compactor?: Compactor;
+    readonly onCompaction?: (event: CompactionEvent) => void;
+}
+export interface CompactionEvent {
+    readonly droppedMessages: number;
+    readonly tokensBefore: number;
+    readonly tokensAfter: number;
+    readonly state: CompactionState;
+}
+export interface AppliedCompaction {
+    readonly state: CompactionState;
+    /** Index into the full transcript where verbatim history resumes. */
+    readonly splitIndex: number;
+}
+export interface BuildOptions {
+    /** The compaction already in force, so it is not recomputed every turn. */
+    readonly previous?: AppliedCompaction;
+    readonly signal?: AbortSignal;
+}
+export interface BuiltContext {
+    readonly messages: readonly Message[];
+    /**
+     * True when this call summarised history. Providers that chain history
+     * server-side must discard their continuation when this is set: with a
+     * continuation they replay their own stored history and ignore the messages
+     * in the request, which would carry back the very history just removed.
+     */
+    readonly compacted: boolean;
+    readonly estimatedTokens: number;
+    /** Carry this into the next build to reuse the summary. */
+    readonly compaction?: AppliedCompaction;
+}
+/**
+ * Decides what the model sees for one request.
+ *
+ * The session owns what happened; this owns what is worth sending. Keeping
+ * them apart is what lets a long session stay inside a fixed context window.
+ */
+export declare class ContextManager {
+    private readonly contextWindow;
+    private readonly reserveTokens;
+    private readonly keepRecentTokens;
+    private readonly estimator;
+    private readonly compactor?;
+    private readonly onCompaction?;
+    constructor(options?: ContextManagerOptions);
+    get budget(): number;
+    build(messages: readonly Message[], options?: BuildOptions): Promise<BuiltContext>;
+}
+/**
+ * Chooses where recent history begins.
+ *
+ * Tool results immediately follow the assistant message that requested them,
+ * so a split that lands on a tool result would orphan it. Moving forward past
+ * the whole group keeps every tool call and its result on the same side.
+ */
+export declare function findSplitIndex(messages: readonly Message[], estimator: TokenEstimator, keepRecentTokens: number): number;
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/context/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../src/context/context-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,SAAS,EAET,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmC;IAEjE,YAAY,OAAO,GAAE,qBAA0B,EAoB9C;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAEK,KAAK,CACT,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CAuDvB;CACF;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,SAAS,EAAE,cAAc,EACzB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CA4BR"}

package/dist/context/context-manager.js

@@ -0,0 +1,129 @@
+import { Compactor, renderCompactionState, } from "./compaction.js";
+import { HeuristicTokenEstimator, } from "./token-estimator.js";
+export const DEFAULT_CONTEXT_WINDOW = 128_000;
+export const DEFAULT_RESERVE_TOKENS = 16_384;
+export const DEFAULT_KEEP_RECENT_TOKENS = 20_000;
+/**
+ * Decides what the model sees for one request.
+ *
+ * The session owns what happened; this owns what is worth sending. Keeping
+ * them apart is what lets a long session stay inside a fixed context window.
+ */
+export class ContextManager {
+    contextWindow;
+    reserveTokens;
+    keepRecentTokens;
+    estimator;
+    compactor;
+    onCompaction;
+    constructor(options = {}) {
+        this.contextWindow = options.contextWindow ?? DEFAULT_CONTEXT_WINDOW;
+        // A small window must still leave room to reply, so the fixed reserve is
+        // capped at a share of the window rather than applied blindly.
+        this.reserveTokens =
+            options.reserveTokens ??
+                Math.min(DEFAULT_RESERVE_TOKENS, Math.floor(this.contextWindow / 4));
+        this.keepRecentTokens =
+            options.keepRecentTokens ??
+                Math.min(DEFAULT_KEEP_RECENT_TOKENS, Math.floor(this.contextWindow / 2));
+        this.estimator = options.estimator ?? new HeuristicTokenEstimator();
+        if (options.compactor !== undefined) {
+            this.compactor = options.compactor;
+        }
+        if (options.onCompaction !== undefined) {
+            this.onCompaction = options.onCompaction;
+        }
+        if (this.reserveTokens >= this.contextWindow) {
+            throw new TypeError("reserveTokens must be smaller than contextWindow.");
+        }
+    }
+    get budget() {
+        return this.contextWindow - this.reserveTokens;
+    }
+    async build(messages, options = {}) {
+        const previous = options.previous;
+        const effective = previous === undefined
+            ? messages
+            : [summaryMessage(previous.state), ...messages.slice(previous.splitIndex)];
+        const estimatedTokens = this.estimator.estimateMessages(effective);
+        if (this.compactor === undefined || estimatedTokens <= this.budget) {
+            return {
+                messages: effective,
+                compacted: false,
+                estimatedTokens,
+                ...(previous === undefined ? {} : { compaction: previous }),
+            };
+        }
+        const cut = findSplitIndex(effective, this.estimator, this.keepRecentTokens);
+        // A cut of zero leaves nothing to summarise; with a previous compaction the
+        // cut must also clear the injected summary for progress to be made.
+        if (cut <= 0 || (previous !== undefined && cut < 1)) {
+            return {
+                messages: effective,
+                compacted: false,
+                estimatedTokens,
+                ...(previous === undefined ? {} : { compaction: previous }),
+            };
+        }
+        const head = effective.slice(0, cut);
+        const tail = effective.slice(cut);
+        const state = await this.compactor.compact(head, options.signal);
+        const compactedMessages = [summaryMessage(state), ...tail];
+        const tokensAfter = this.estimator.estimateMessages(compactedMessages);
+        // Map the cut back onto the full transcript, allowing for the summary
+        // message that the previous compaction injected at the front.
+        const splitIndex = previous === undefined
+            ? cut
+            : previous.splitIndex + (cut - 1);
+        this.onCompaction?.({
+            droppedMessages: head.length,
+            tokensBefore: estimatedTokens,
+            tokensAfter,
+            state,
+        });
+        return {
+            messages: compactedMessages,
+            compacted: true,
+            estimatedTokens: tokensAfter,
+            compaction: { state, splitIndex },
+        };
+    }
+}
+function summaryMessage(state) {
+    return { role: "user", content: renderCompactionState(state) };
+}
+/**
+ * Chooses where recent history begins.
+ *
+ * Tool results immediately follow the assistant message that requested them,
+ * so a split that lands on a tool result would orphan it. Moving forward past
+ * the whole group keeps every tool call and its result on the same side.
+ */
+export function findSplitIndex(messages, estimator, keepRecentTokens) {
+    let tokens = 0;
+    let index = messages.length;
+    while (index > 0) {
+        const message = messages[index - 1];
+        if (message === undefined) {
+            break;
+        }
+        const cost = estimator.estimateMessage(message);
+        if (tokens + cost > keepRecentTokens) {
+            break;
+        }
+        tokens += cost;
+        index -= 1;
+    }
+    while (index < messages.length && messages[index]?.role === "tool") {
+        index += 1;
+    }
+    // Always leave at least one real message after the summary.
+    if (index >= messages.length) {
+        index = messages.length - 1;
+        while (index > 0 && messages[index]?.role === "tool") {
+            index -= 1;
+        }
+    }
+    return index;
+}
+//# sourceMappingURL=context-manager.js.map

package/dist/context/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../src/context/context-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AA+CjD;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACR,aAAa,CAAS;IACtB,aAAa,CAAS;IACtB,gBAAgB,CAAS;IACzB,SAAS,CAAiB;IAC1B,SAAS,CAAa;IACtB,YAAY,CAAoC;IAEjE,YAAY,OAAO,GAA0B,EAAE;QAC7C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;QACrE,yEAAyE;QACzE,+DAA+D;QAC/D,IAAI,CAAC,aAAa;YAChB,OAAO,CAAC,aAAa;gBACrB,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,gBAAgB;YACnB,OAAO,CAAC,gBAAgB;gBACxB,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,uBAAuB,EAAE,CAAC;QACpE,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CACT,QAA4B,EAC5B,OAAO,GAAiB,EAAE;QAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,SAAS,GACb,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAEnE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACnE,OAAO;gBACL,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,KAAK;gBAChB,eAAe;gBACf,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7E,4EAA4E;QAC5E,oEAAoE;QACpE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,KAAK;gBAChB,eAAe;gBACf,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,iBAAiB,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QAEvE,sEAAsE;QACtE,8DAA8D;QAC9D,MAAM,UAAU,GACd,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,QAAQ,CAAC,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAEtC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,eAAe,EAAE,IAAI,CAAC,MAAM;YAC5B,YAAY,EAAE,eAAe;YAC7B,WAAW;YACX,KAAK;SACN,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,iBAAiB;YAC3B,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,WAAW;YAC5B,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;SAClC,CAAC;IACJ,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAsB;IAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA4B,EAC5B,SAAyB,EACzB,gBAAwB;IAExB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC5B,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,MAAM,GAAG,IAAI,GAAG,gBAAgB,EAAE,CAAC;YACrC,MAAM;QACR,CAAC;QACD,MAAM,IAAI,IAAI,CAAC;QACf,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACnE,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,4DAA4D;IAC5D,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC7B,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,OAAO,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YACrD,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/context/token-estimator.d.ts

@@ -0,0 +1,22 @@
+import type { Message } from "../messages.js";
+export interface TokenEstimator {
+    estimateMessage(message: Message): number;
+    estimateMessages(messages: readonly Message[]): number;
+}
+/**
+ * Approximates token counts from character length.
+ *
+ * A real tokenizer is Provider- and model-specific and would pull in a large
+ * dependency for a number that only decides *when* to compact. The reserve
+ * budget exists to absorb this estimate's error: overshooting compacts a
+ * little early, which costs a summary call rather than a failed request.
+ */
+export declare class HeuristicTokenEstimator implements TokenEstimator {
+    private readonly charactersPerToken;
+    private readonly messageOverheadTokens;
+    constructor(charactersPerToken?: number, messageOverheadTokens?: number);
+    estimateMessage(message: Message): number;
+    estimateMessages(messages: readonly Message[]): number;
+    private textOf;
+}
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/context/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/context/token-estimator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1C,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC;CACxD;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAE1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAFxC,YACmB,kBAAkB,SAAI,EACtB,qBAAqB,SAAI,EAK3C;IAED,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAKxC;IAED,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAMrD;IAED,OAAO,CAAC,MAAM;CAYf"}

package/dist/context/token-estimator.js

@@ -0,0 +1,43 @@
+/**
+ * Approximates token counts from character length.
+ *
+ * A real tokenizer is Provider- and model-specific and would pull in a large
+ * dependency for a number that only decides *when* to compact. The reserve
+ * budget exists to absorb this estimate's error: overshooting compacts a
+ * little early, which costs a summary call rather than a failed request.
+ */
+export class HeuristicTokenEstimator {
+    charactersPerToken;
+    messageOverheadTokens;
+    constructor(charactersPerToken = 4, messageOverheadTokens = 4) {
+        this.charactersPerToken = charactersPerToken;
+        this.messageOverheadTokens = messageOverheadTokens;
+        if (charactersPerToken <= 0) {
+            throw new TypeError("charactersPerToken must be positive.");
+        }
+    }
+    estimateMessage(message) {
+        return (this.messageOverheadTokens +
+            Math.ceil(this.textOf(message).length / this.charactersPerToken));
+    }
+    estimateMessages(messages) {
+        let total = 0;
+        for (const message of messages) {
+            total += this.estimateMessage(message);
+        }
+        return total;
+    }
+    textOf(message) {
+        if (message.role === "assistant") {
+            const calls = message.toolCalls
+                .map((call) => `${call.name}${JSON.stringify(call.arguments)}`)
+                .join("");
+            return `${message.content}${calls}`;
+        }
+        if (message.role === "tool") {
+            return `${message.toolName}${message.content}`;
+        }
+        return message.content;
+    }
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/context/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/context/token-estimator.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAEf,kBAAkB;IAClB,qBAAqB;IAFxC,YACmB,kBAAkB,GAAG,CAAC,EACtB,qBAAqB,GAAG,CAAC;kCADzB,kBAAkB;qCAClB,qBAAqB;QAEtC,IAAI,kBAAkB,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,OAAO,CACL,IAAI,CAAC,qBAAqB;YAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,CACjE,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,QAA4B;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,OAAgB;QAC7B,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS;iBAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;iBAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;QACtC,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/providers/client.d.ts

@@ -0,0 +1,7 @@
+import type { CliOptions } from "../cli-options.js";
+import type { LLMClient } from "../llm.js";
+import { ProviderRegistry } from "./registry.js";
+import { CredentialResolver } from "../auth/credentials.js";
+/** Returns the configured client, or the message explaining what is missing. */
+export declare function createConfiguredClient(options: CliOptions, registry?: ProviderRegistry, resolver?: CredentialResolver): Promise<LLMClient | string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/providers/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/providers/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EAA2B,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAK5D,gFAAgF;AAChF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,UAAU,EACnB,QAAQ,GAAE,gBAA0C,EACpD,QAAQ,GAAE,kBAAuD,GAChE,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,CAkC7B"}

package/dist/providers/client.js

@@ -0,0 +1,48 @@
+import { RetryingLLMClient } from "../retry.js";
+import { defaultProviderRegistry, ProviderRegistry } from "./registry.js";
+import { CredentialResolver } from "../auth/credentials.js";
+import { RuntimeCredentialSource } from "../auth/runtime-credentials.js";
+import { EnvCredentialSource } from "../auth/env-credentials.js";
+import { defaultAuthFile, FileCredentialSource } from "../auth/file-credentials.js";
+/** Returns the configured client, or the message explaining what is missing. */
+export async function createConfiguredClient(options, registry = defaultProviderRegistry, resolver = defaultCredentialResolver(options)) {
+    const definition = registry.get(options.provider);
+    if (options.model === undefined) {
+        const variables = definition.modelEnvKeys.join(" or ");
+        return `--model or ${variables} is required for ${definition.id}.`;
+    }
+    if (definition.requiresBaseURL && options.baseURL === undefined) {
+        const variables = definition.baseUrlEnvKeys.join(" or ");
+        return `${variables} is required for ${definition.id}.`;
+    }
+    let credential;
+    try {
+        credential = await resolver.resolve(definition);
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    if (credential === undefined) {
+        return resolver.describeExpectations(definition);
+    }
+    const client = definition.createClient({
+        apiKey: credential.apiKey,
+        model: options.model,
+        ...(options.baseURL === undefined ? {} : { baseURL: options.baseURL }),
+    });
+    return new RetryingLLMClient(client, {
+        onRetry: ({ attempt, delayMs, reason }) => {
+            process.stderr.write(`Provider call failed (${reason}); retry ${attempt} in ${delayMs}ms.\n`);
+        },
+    });
+}
+function defaultCredentialResolver(options) {
+    return new CredentialResolver([
+        new RuntimeCredentialSource(options.apiKey),
+        new EnvCredentialSource(process.env),
+        new FileCredentialSource(defaultAuthFile(process.env), (message) => {
+            process.stderr.write(`${message}\n`);
+        }),
+    ]);
+}
+//# sourceMappingURL=client.js.map

package/dist/providers/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/providers/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,QAAQ,GAAqB,uBAAuB,EACpD,QAAQ,GAAuB,yBAAyB,CAAC,OAAO,CAAC;IAEjE,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,cAAc,SAAS,oBAAoB,UAAU,CAAC,EAAE,GAAG,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,GAAG,SAAS,oBAAoB,UAAU,CAAC,EAAE,GAAG,CAAC;IAC1D,CAAC;IAED,IAAI,UAAU,CAAC;IACf,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC;QACrC,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;KACvE,CAAC,CAAC;IAEH,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE;QACnC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;YACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,MAAM,YAAY,OAAO,OAAO,OAAO,OAAO,CACxE,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAmB;IACpD,OAAO,IAAI,kBAAkB,CAAC;QAC5B,IAAI,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC3C,IAAI,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC;QACpC,IAAI,oBAAoB,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/definitions.d.ts

@@ -0,0 +1,25 @@
+import type { LLMClient } from "../llm.js";
+export interface ProviderClientConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly baseURL?: string;
+}
+export interface ProviderDefinition {
+    readonly id: string;
+    /** Environment variables searched in order for this Provider's API key. */
+    readonly envKeys: readonly string[];
+    /** Environment variables searched in order for a default model. */
+    readonly modelEnvKeys: readonly string[];
+    /** Used when neither --model nor an environment variable supplies one. */
+    readonly defaultModel?: string;
+    /** Environment variables searched in order for a base URL override. */
+    readonly baseUrlEnvKeys: readonly string[];
+    readonly defaultBaseURL?: string;
+    /** True when the Provider cannot be configured without an explicit model. */
+    readonly requiresModel: boolean;
+    /** True when the Provider cannot be configured without an explicit base URL. */
+    readonly requiresBaseURL: boolean;
+    createClient(config: ProviderClientConfig): LLMClient;
+}
+export declare const BUILTIN_PROVIDERS: readonly ProviderDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

package/dist/providers/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/providers/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACvD;AAkCD,eAAO,MAAM,iBAAiB,EAAE,SAAS,kBAAkB,EAqE1D,CAAC"}

package/dist/providers/definitions.js

@@ -0,0 +1,97 @@
+import { OpenAIClient } from "./openai.js";
+import { OpenAICompatibleChatClient } from "./openai-compatible-chat.js";
+import { DeepSeekChatClient } from "./deepseek.js";
+/**
+ * Most Providers speak OpenAI-compatible Chat Completions and differ only by
+ * base URL, so they are declared rather than implemented.
+ */
+function compatibleProvider(definition) {
+    return {
+        id: definition.id,
+        envKeys: definition.envKeys,
+        modelEnvKeys: definition.modelEnvKeys,
+        ...(definition.defaultModel === undefined
+            ? {}
+            : { defaultModel: definition.defaultModel }),
+        baseUrlEnvKeys: [],
+        defaultBaseURL: definition.defaultBaseURL,
+        requiresModel: definition.defaultModel === undefined,
+        requiresBaseURL: false,
+        createClient: ({ apiKey, model, baseURL }) => new OpenAICompatibleChatClient({
+            apiKey,
+            model,
+            baseURL: baseURL ?? definition.defaultBaseURL,
+            continuationTag: `${definition.id}-chat`,
+        }),
+    };
+}
+export const BUILTIN_PROVIDERS = [
+    {
+        id: "openai",
+        envKeys: ["OPENAI_API_KEY"],
+        modelEnvKeys: ["OPENAI_MODEL"],
+        defaultModel: "gpt-5.6",
+        baseUrlEnvKeys: [],
+        requiresModel: false,
+        requiresBaseURL: false,
+        createClient: ({ apiKey, model }) => new OpenAIClient({ apiKey, model }),
+    },
+    {
+        id: "deepseek",
+        envKeys: ["DEEPSEEK_API_KEY"],
+        modelEnvKeys: ["DEEPSEEK_MODEL"],
+        defaultModel: "deepseek-v4-flash",
+        baseUrlEnvKeys: [],
+        requiresModel: false,
+        requiresBaseURL: false,
+        createClient: ({ apiKey, model, baseURL }) => new DeepSeekChatClient({
+            apiKey,
+            model,
+            ...(baseURL === undefined ? {} : { baseURL }),
+        }),
+    },
+    {
+        id: "openai-compatible",
+        envKeys: ["OPENAI_API_KEY"],
+        modelEnvKeys: ["OPENAI_MODEL"],
+        baseUrlEnvKeys: ["OPENAI_BASE_URL"],
+        requiresModel: true,
+        requiresBaseURL: true,
+        createClient: ({ apiKey, model, baseURL }) => {
+            if (baseURL === undefined) {
+                throw new TypeError("OpenAI-compatible Provider requires a base URL.");
+            }
+            return new OpenAICompatibleChatClient({
+                apiKey,
+                model,
+                baseURL,
+                continuationTag: "openai-compatible-chat",
+            });
+        },
+    },
+    compatibleProvider({
+        id: "openrouter",
+        envKeys: ["OPENROUTER_API_KEY"],
+        modelEnvKeys: ["OPENROUTER_MODEL"],
+        defaultBaseURL: "https://openrouter.ai/api/v1",
+    }),
+    compatibleProvider({
+        id: "groq",
+        envKeys: ["GROQ_API_KEY"],
+        modelEnvKeys: ["GROQ_MODEL"],
+        defaultBaseURL: "https://api.groq.com/openai/v1",
+    }),
+    compatibleProvider({
+        id: "xai",
+        envKeys: ["XAI_API_KEY"],
+        modelEnvKeys: ["XAI_MODEL"],
+        defaultBaseURL: "https://api.x.ai/v1",
+    }),
+    compatibleProvider({
+        id: "moonshot",
+        envKeys: ["MOONSHOT_API_KEY"],
+        modelEnvKeys: ["MOONSHOT_MODEL"],
+        defaultBaseURL: "https://api.moonshot.cn/v1",
+    }),
+];
+//# sourceMappingURL=definitions.js.map

package/dist/providers/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/providers/definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA0BnD;;;GAGG;AACH,SAAS,kBAAkB,CAAC,UAM3B;IACC,OAAO;QACL,EAAE,EAAE,UAAU,CAAC,EAAE;QACjB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,GAAG,CAAC,UAAU,CAAC,YAAY,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,EAAE,CAAC;QAC9C,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,aAAa,EAAE,UAAU,CAAC,YAAY,KAAK,SAAS;QACpD,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAC3C,IAAI,0BAA0B,CAAC;YAC7B,MAAM;YACN,KAAK;YACL,OAAO,EAAE,OAAO,IAAI,UAAU,CAAC,cAAc;YAC7C,eAAe,EAAE,GAAG,UAAU,CAAC,EAAE,OAAO;SACzC,CAAC;KACL,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,CAAC,gBAAgB,CAAC;QAC3B,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,YAAY,EAAE,SAAS;QACvB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;KACzE;IACD;QACE,EAAE,EAAE,UAAU;QACd,OAAO,EAAE,CAAC,kBAAkB,CAAC;QAC7B,YAAY,EAAE,CAAC,gBAAgB,CAAC;QAChC,YAAY,EAAE,mBAAmB;QACjC,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAC3C,IAAI,kBAAkB,CAAC;YACrB,MAAM;YACN,KAAK;YACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;SAC9C,CAAC;KACL;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,OAAO,EAAE,CAAC,gBAAgB,CAAC;QAC3B,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,cAAc,EAAE,CAAC,iBAAiB,CAAC;QACnC,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,IAAI,0BAA0B,CAAC;gBACpC,MAAM;gBACN,KAAK;gBACL,OAAO;gBACP,eAAe,EAAE,wBAAwB;aAC1C,CAAC,CAAC;QACL,CAAC;KACF;IACD,kBAAkB,CAAC;QACjB,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,CAAC,oBAAoB,CAAC;QAC/B,YAAY,EAAE,CAAC,kBAAkB,CAAC;QAClC,cAAc,EAAE,8BAA8B;KAC/C,CAAC;IACF,kBAAkB,CAAC;QACjB,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,YAAY,EAAE,CAAC,YAAY,CAAC;QAC5B,cAAc,EAAE,gCAAgC;KACjD,CAAC;IACF,kBAAkB,CAAC;QACjB,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,cAAc,EAAE,qBAAqB;KACtC,CAAC;IACF,kBAAkB,CAAC;QACjB,EAAE,EAAE,UAAU;QACd,OAAO,EAAE,CAAC,kBAAkB,CAAC;QAC7B,YAAY,EAAE,CAAC,gBAAgB,CAAC;QAChC,cAAc,EAAE,4BAA4B;KAC7C,CAAC;CACH,CAAC"}