agent-bober 0.18.0 → 0.19.0

package/dist/providers/anthropic.js.map

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

package/dist/providers/claude-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAyDpB,qBAAa,iBAAkB,YAAW,SAAS;IAM/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B;;;OAGG;gBAEgB,MAAM,GAAE,MAAiB,EACzB,SAAS,GAAE,MAAgB;IAGxC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA0EtD"}
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAyDpB,qBAAa,iBAAkB,YAAW,SAAS;IAM/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B;;;OAGG;gBAEgB,MAAM,GAAE,MAAiB,EACzB,SAAS,GAAE,MAAgB;IAGxC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA8FtD"}

package/dist/providers/claude-code.js

@@ -83,6 +83,9 @@ export class ClaudeCodeAdapter {
         this.timeoutMs = timeoutMs;
     }
     async chat(params) {
+        // params.onTextDelta (sprint 8, streaming): accepted but never invoked —
+        // the `claude` CLI's text-only boundary stays; this adapter always shells
+        // out and parses the final JSON result (documented no-op).
         const { system, messages, tools, model } = params;
         // Hard fail on tools — see SPIKE SCOPE. Silent drop would corrupt the
         // caller's agentic loop (it would wait forever for tool_use that can't come).
@@ -92,6 +95,14 @@ export class ClaudeCodeAdapter {
                 "Use this provider only for prompt→text roles (e.g. planner), or use " +
                 "the anthropic/openai-compat providers for tool-driven roles.");
         }
+        // Hard fail on documents — the `claude` CLI accepts only a text prompt, so a
+        // PDF/file would be silently dropped (the model would answer from nothing).
+        if (params.documents && params.documents.length > 0) {
+            throw new Error("ClaudeCodeAdapter does not support `documents` (PDF/file inputs): the " +
+                "`claude` CLI accepts only a text prompt, so a document would be " +
+                "silently dropped. Use the anthropic, openai, or google provider for " +
+                "document parsing.");
+        }
         const prompt = flattenMessages(messages);
         const args = [
             "-p",
@@ -137,6 +148,12 @@ export class ClaudeCodeAdapter {
                 inputTokens: parsed.usage?.input_tokens ?? 0,
                 outputTokens: parsed.usage?.output_tokens ?? 0,
             },
+            // Vendor-authoritative real cost (ADR-3: claude-code never estimates
+            // via CostMeter). Conditional-spread so the key is ABSENT — not
+            // `costUsd: undefined` — when an older CLI omits total_cost_usd.
+            ...(typeof parsed.total_cost_usd === "number"
+                ? { costUsd: parsed.total_cost_usd }
+                : {}),
         };
     }
 }

package/dist/providers/claude-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAwB9B,0EAA0E;AAC1E,SAAS,aAAa,CAAC,GAAuB;IAC5C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,KAAK,CAAC;QACf,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,GAAG,IAAI,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,QAAgC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YAC9B,0EAA0E;YAC1E,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,OAAO,iBAAiB;IAMT;IACA;IANnB;;;OAGG;IACH,YACmB,SAAiB,QAAQ,EACzB,YAAoB,OAAO;QAD3B,WAAM,GAAN,MAAM,CAAmB;QACzB,cAAS,GAAT,SAAS,CAAkB;IAC3C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAAkB;QAC3B,yEAAyE;QACzE,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAElD,sEAAsE;QACtE,8EAA8E;QAC9E,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,uEAAuE;gBACvE,sEAAsE;gBACtE,8DAA8D,CACjE,CAAC;QACJ,CAAC;QAED,6EAA6E;QAC7E,4EAA4E;QAC5E,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,kEAAkE;gBAClE,sEAAsE;gBACtE,mBAAmB,CACtB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,MAAM;YACN,iBAAiB;YACjB,MAAM;YACN,gFAAgF;YAChF,oBAAoB;YACpB,wDAAwD;YACxD,qEAAqE;YACrE,qBAAqB;SACtB,CAAC;QACF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;YAC5C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,SAAS;YACvB,mCAAmC;YACnC,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAC1C,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,WACpC,EAAE,CACH,CAAC;QACJ,CAAC;QAED,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAoB,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,iCAAiC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YACzB,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;YAC7C,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;gBAC5C,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;aAC/C;YACD,qEAAqE;YACrE,gEAAgE;YAChE,iEAAiE;YACjE,GAAG,CAAC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;gBAC3C,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE;gBACpC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/cost-meter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Static USD cost estimation for LLM chat requests.
+ *
+ * Pure, no I/O, no dependencies on any other module in this project (other
+ * than a type-only import of {@link ProviderName}, which is erased at
+ * runtime). Maps `(provider, model, tokenUsage)` to a USD estimate via a
+ * static, in-repo price table keyed by `${provider}:${modelPrefix}` and
+ * resolved by longest-prefix match — the most specific known model prefix
+ * wins over a shorter/broader one.
+ *
+ * The `claude-code` provider is NEVER estimated here (ADR-3): the `claude`
+ * CLI reports its own vendor-authoritative `total_cost_usd` (which also
+ * accounts for cache-read/cache-creation tokens this module never sees), so
+ * `estimateCostUsd` unconditionally returns `undefined` for it.
+ *
+ * An unknown `provider:model` pair also returns `undefined` rather than a
+ * guessed number — callers must never surface a silently-wrong cost.
+ */
+import type { ProviderName } from "./factory.js";
+/** Per-million-token list prices for one model family. */
+export interface PriceRow {
+    /** USD per 1,000,000 input tokens. */
+    inputPerMillion: number;
+    /** USD per 1,000,000 output tokens. */
+    outputPerMillion: number;
+}
+/** Price table keyed by `${provider}:${modelPrefix}`, longest-prefix-match resolved. */
+export type PriceTable = Record<string, PriceRow>;
+export declare const PRICE_TABLE: PriceTable;
+/**
+ * Estimate the USD cost of a single chat request from its token usage.
+ *
+ * Resolution: builds `${provider}:${model}`, finds every price-table key
+ * that is a prefix of it, and picks the longest (most specific) match. When
+ * no key matches, or `provider` is `"claude-code"`, returns `undefined` —
+ * the caller must treat `undefined` as "unknown," never as zero.
+ *
+ * @param input.provider - The resolved provider name.
+ * @param input.model - The provider-native model ID actually used for the request.
+ * @param input.usage - Token usage for the request (inline shape — this module
+ *   has zero cross-module dependencies by design; see file header).
+ * @returns The estimated USD cost, or `undefined` if unknown/unpriced.
+ */
+export declare function estimateCostUsd(input: {
+    provider: ProviderName;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}): number | undefined;
+//# sourceMappingURL=cost-meter.d.ts.map

package/dist/providers/cost-meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-meter.d.ts","sourceRoot":"","sources":["../../src/providers/cost-meter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAelD,eAAO,MAAM,WAAW,EAAE,UAwBzB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD,GAAG,MAAM,GAAG,SAAS,CAgBrB"}

package/dist/providers/cost-meter.js

@@ -0,0 +1,81 @@
+/**
+ * Static USD cost estimation for LLM chat requests.
+ *
+ * Pure, no I/O, no dependencies on any other module in this project (other
+ * than a type-only import of {@link ProviderName}, which is erased at
+ * runtime). Maps `(provider, model, tokenUsage)` to a USD estimate via a
+ * static, in-repo price table keyed by `${provider}:${modelPrefix}` and
+ * resolved by longest-prefix match — the most specific known model prefix
+ * wins over a shorter/broader one.
+ *
+ * The `claude-code` provider is NEVER estimated here (ADR-3): the `claude`
+ * CLI reports its own vendor-authoritative `total_cost_usd` (which also
+ * accounts for cache-read/cache-creation tokens this module never sees), so
+ * `estimateCostUsd` unconditionally returns `undefined` for it.
+ *
+ * An unknown `provider:model` pair also returns `undefined` rather than a
+ * guessed number — callers must never surface a silently-wrong cost.
+ */
+// ── Static price table ──────────────────────────────────────────────
+//
+// Prices as of 2026-07 (list prices; guardrail semantics, not billing).
+// Rows are keyed by `${provider}:${modelPrefix}` and matched by longest
+// prefix of `${provider}:${model}` — a specific row (e.g. "gpt-4.1-mini")
+// always wins over a shorter one that is also a valid prefix (e.g. "gpt-4.1").
+//
+// Only model families that appear in `orchestrator/model-resolver.ts`'s
+// SHORTHAND_MAP are priced here. Anything else (including deliberately
+// unpriced/unknown model strings) falls through to `undefined` — the safe
+// fail-open per ADR-3, rather than a guessed number. Prices are NOT
+// config-overridable and are NOT fetched at runtime (explicitly out of scope
+// for this sprint).
+export const PRICE_TABLE = {
+    // Anthropic (direct API — not claude-code, which is never estimated)
+    "anthropic:claude-opus-4": { inputPerMillion: 15, outputPerMillion: 75 },
+    "anthropic:claude-sonnet-4": { inputPerMillion: 3, outputPerMillion: 15 },
+    "anthropic:claude-haiku-4-5": { inputPerMillion: 1, outputPerMillion: 5 },
+    // OpenAI
+    "openai:gpt-4.1-mini": { inputPerMillion: 0.4, outputPerMillion: 1.6 },
+    "openai:gpt-4.1": { inputPerMillion: 2, outputPerMillion: 8 },
+    "openai:o4-mini": { inputPerMillion: 1.1, outputPerMillion: 4.4 },
+    "openai:o3": { inputPerMillion: 10, outputPerMillion: 40 },
+    // OpenAI-compatible: DeepSeek (api.deepseek.com)
+    "openai-compat:deepseek-v4-pro": { inputPerMillion: 0.55, outputPerMillion: 2.19 },
+    "openai-compat:deepseek-v4-flash": { inputPerMillion: 0.14, outputPerMillion: 0.28 },
+    // OpenAI-compatible: xAI / Grok (api.x.ai)
+    "openai-compat:grok-4-fast": { inputPerMillion: 0.2, outputPerMillion: 0.5 },
+    "openai-compat:grok-4": { inputPerMillion: 3, outputPerMillion: 15 },
+    // Google Gemini (not yet wired into GoogleAdapter — table row reserved
+    // for when the adapter is updated to populate ChatResponse.costUsd)
+    "google:gemini-2.5-pro": { inputPerMillion: 1.25, outputPerMillion: 5 },
+    "google:gemini-2.5-flash": { inputPerMillion: 0.075, outputPerMillion: 0.3 },
+};
+/**
+ * Estimate the USD cost of a single chat request from its token usage.
+ *
+ * Resolution: builds `${provider}:${model}`, finds every price-table key
+ * that is a prefix of it, and picks the longest (most specific) match. When
+ * no key matches, or `provider` is `"claude-code"`, returns `undefined` —
+ * the caller must treat `undefined` as "unknown," never as zero.
+ *
+ * @param input.provider - The resolved provider name.
+ * @param input.model - The provider-native model ID actually used for the request.
+ * @param input.usage - Token usage for the request (inline shape — this module
+ *   has zero cross-module dependencies by design; see file header).
+ * @returns The estimated USD cost, or `undefined` if unknown/unpriced.
+ */
+export function estimateCostUsd(input) {
+    // claude-code reports its own real cost; never estimate here (ADR-3).
+    if (input.provider === "claude-code")
+        return undefined;
+    const fullKey = `${input.provider}:${input.model}`;
+    const match = Object.keys(PRICE_TABLE)
+        .filter((k) => fullKey.startsWith(k))
+        .sort((a, b) => b.length - a.length)[0]; // longest-prefix wins
+    if (match === undefined)
+        return undefined;
+    const row = PRICE_TABLE[match];
+    return ((input.usage.inputTokens / 1_000_000) * row.inputPerMillion +
+        (input.usage.outputTokens / 1_000_000) * row.outputPerMillion);
+}
+//# sourceMappingURL=cost-meter.js.map

package/dist/providers/cost-meter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-meter.js","sourceRoot":"","sources":["../../src/providers/cost-meter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,uEAAuE;AACvE,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,0EAA0E;AAC1E,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,0EAA0E;AAC1E,oEAAoE;AACpE,6EAA6E;AAC7E,oBAAoB;AACpB,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,qEAAqE;IACrE,yBAAyB,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;IACxE,2BAA2B,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE;IACzE,4BAA4B,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE;IAEzE,SAAS;IACT,qBAAqB,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE;IACtE,gBAAgB,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE;IAC7D,gBAAgB,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE;IACjE,WAAW,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;IAE1D,iDAAiD;IACjD,+BAA+B,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE;IAClF,iCAAiC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE;IAEpF,2CAA2C;IAC3C,2BAA2B,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE;IAC5E,sBAAsB,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE;IAEpE,uEAAuE;IACvE,oEAAoE;IACpE,uBAAuB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAAE;IACvE,yBAAyB,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE;CAC7E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,KAI/B;IACC,sEAAsE;IACtE,IAAI,KAAK,CAAC,QAAQ,KAAK,aAAa;QAAE,OAAO,SAAS,CAAC;IAEvD,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAEjE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAE,CAAC;IAChC,OAAO,CACL,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,eAAe;QAC3D,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAC9D,CAAC;AACJ,CAAC"}

package/dist/providers/factory.d.ts

@@ -16,13 +16,18 @@ export type BinaryProbe = (binary: string) => Promise<boolean>;
  * @param probe - Injectable PATH-check function (default uses execa; override in tests).
  */
 export declare function preflightClaudeBinary(binary?: string, probe?: BinaryProbe): Promise<void>;
+/**
+ * True when the endpoint targets xAI's OpenAI-compatible Grok API.
+ * SOLE place the "api.x.ai" host substring is matched (sc-1-6).
+ */
+export declare function isXaiEndpoint(endpoint?: string): boolean;
 /**
  * Validate that the required API key environment variable is set for a given provider.
  *
  * @param resolvedProvider - The resolved provider name.
  * @param role - Optional role label (e.g. "Planner", "Generator", "Evaluator") for the error message.
  * @param apiKey - Optional explicit API key from providerConfig (skips env var check if set).
- * @param endpoint - Optional endpoint URL used to distinguish DeepSeek from other openai-compat servers.
+ * @param endpoint - Optional endpoint URL used to distinguish DeepSeek/xAI from other openai-compat servers.
  * @throws If the required environment variable is missing and no explicit apiKey was provided.
  */
 export declare function validateApiKey(resolvedProvider: string, role?: string, apiKey?: string, endpoint?: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,YAAY,CAAC;AAItE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,CAAC;AA6B/F;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAW/D;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,SAAW,EACjB,KAAK,GAAE,WAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CA0DN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAmGX"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,YAAY,CAAC;AAItE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,CAAC;AA6B/F;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAW/D;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,SAAW,EACjB,KAAK,GAAE,WAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAQf;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAoEN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAsGX"}

package/dist/providers/factory.js

@@ -51,13 +51,21 @@ export async function preflightClaudeBinary(binary = "claude", probe = defaultBi
             `requires the Claude Code CLI. Install it and ensure "${binary}" is on your PATH.`);
     }
 }
+// ── xAI / Grok endpoint predicate ────────────────────────────────────────────
+/**
+ * True when the endpoint targets xAI's OpenAI-compatible Grok API.
+ * SOLE place the "api.x.ai" host substring is matched (sc-1-6).
+ */
+export function isXaiEndpoint(endpoint) {
+    return !!endpoint && endpoint.includes("api.x.ai");
+}
 /**
  * Validate that the required API key environment variable is set for a given provider.
  *
  * @param resolvedProvider - The resolved provider name.
  * @param role - Optional role label (e.g. "Planner", "Generator", "Evaluator") for the error message.
  * @param apiKey - Optional explicit API key from providerConfig (skips env var check if set).
- * @param endpoint - Optional endpoint URL used to distinguish DeepSeek from other openai-compat servers.
+ * @param endpoint - Optional endpoint URL used to distinguish DeepSeek/xAI from other openai-compat servers.
  * @throws If the required environment variable is missing and no explicit apiKey was provided.
  */
 export function validateApiKey(resolvedProvider, role, apiKey, endpoint) {
@@ -99,6 +107,14 @@ export function validateApiKey(resolvedProvider, role, apiKey, endpoint) {
                         `Set the DEEPSEEK_API_KEY environment variable and try again.`);
                 }
             }
+            // Grok/xAI (api.x.ai) requires a key — check specifically for it.
+            if (isXaiEndpoint(endpoint)) {
+                const key = apiKey ?? process.env["XAI_API_KEY"];
+                if (!key) {
+                    throw new Error(`${roleLabel} is configured to use Grok/xAI but XAI_API_KEY is not set. ` +
+                        `Set the XAI_API_KEY environment variable and try again.`);
+                }
+            }
             break;
         case "claude-code":
             // Subscription provider: no API key is read or required. The `claude`
@@ -182,12 +198,15 @@ export function createClient(provider, endpoint, providerConfig, model, role) {
             if (!resolvedEndpoint) {
                 throw new Error('OpenAI-compatible provider requires an endpoint. Set endpoint in provider config or use the "ollama/" model prefix.');
             }
-            // Inject DEEPSEEK_API_KEY env fallback only for the api.deepseek.com endpoint.
+            // Inject provider API key env fallback only for known cloud endpoints.
+            // Grok/xAI (api.x.ai) → XAI_API_KEY; DeepSeek (api.deepseek.com) → DEEPSEEK_API_KEY.
             // Ollama and other openai-compat endpoints keep the no-key (not-needed) behavior.
             const compatKey = apiKey ??
-                (resolvedEndpoint.includes("api.deepseek.com")
-                    ? process.env["DEEPSEEK_API_KEY"]
-                    : undefined);
+                (isXaiEndpoint(resolvedEndpoint)
+                    ? process.env["XAI_API_KEY"]
+                    : resolvedEndpoint.includes("api.deepseek.com")
+                        ? process.env["DEEPSEEK_API_KEY"]
+                        : undefined);
             return new OpenAICompatAdapter(resolvedEndpoint, resolvedModelId, compatKey);
         }
         case "claude-code": {

package/dist/providers/factory.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AA6MpB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAmC;gBAEpC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK1C;;;;;OAKG;YACW,QAAQ;IAmChB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAuEtD"}
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAkPpB;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,4DAA4D;IAC5D,OAAO,CAAC,KAAK,CAAmC;gBAEpC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAK1C;;;;;OAKG;YACW,QAAQ;IAmChB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CAgFtD"}

package/dist/providers/google.js

@@ -92,6 +92,27 @@ function toGeminiContents(message) {
     const geminiRole = textMsg.role === "assistant" ? "model" : "user";
     return [{ role: geminiRole, parts: [{ text: textMsg.content }] }];
 }
+/**
+ * Attach `documents` to the FIRST user content as Gemini `inlineData` parts.
+ *
+ * The existing text parts are preserved after the data parts. Mutates
+ * `contents` in place. When `documents` is empty the caller skips this
+ * entirely, leaving the request byte-identical.
+ */
+function attachGeminiDocuments(contents, documents) {
+    const firstUserIdx = contents.findIndex((c) => c.role === "user");
+    if (firstUserIdx === -1) {
+        return;
+    }
+    const firstUser = contents[firstUserIdx];
+    const dataParts = documents.map((doc) => ({
+        inlineData: { mimeType: doc.mediaType, data: doc.base64 },
+    }));
+    contents[firstUserIdx] = {
+        ...firstUser,
+        parts: [...dataParts, ...firstUser.parts],
+    };
+}
 /**
  * Extract normalized text and tool calls from Gemini response parts.
  */
@@ -168,6 +189,9 @@ export class GoogleAdapter {
         return this.genAI;
     }
     async chat(params) {
+        // params.onTextDelta (sprint 8, streaming): accepted but never invoked —
+        // this adapter always uses the non-streaming generateContent call, so
+        // there is nothing extra on the wire (documented no-op).
         const { model, system, messages, tools, responseSchema, maxTokens: _maxTokens = 16384, } = params;
         const genAI = await this.getGenAI();
         // When a responseSchema is set, request Gemini's native structured output.
@@ -186,6 +210,11 @@ export class GoogleAdapter {
         });
         // Convert provider-agnostic Message[] to Gemini contents format
         const contents = messages.flatMap(toGeminiContents);
+        // Documents (PDFs/files) → `inlineData` part on the first user content.
+        // Omitting documents leaves the rendered request byte-identical.
+        if (params.documents && params.documents.length > 0) {
+            attachGeminiDocuments(contents, params.documents);
+        }
         // Convert ToolDef[] to Gemini tools format (all declarations in one tool).
         // responseSchema is mutually exclusive with tools — when set, user tools
         // are NOT forwarded (structured output wins).

package/dist/providers/google.js.map

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

package/dist/providers/grounded-search.d.ts

@@ -0,0 +1,128 @@
+/**
+ * GroundedSearchClient — provider-agnostic web-search grounding
+ * (in-house-ai-visibility, Sprint 1;
+ * arch-20260717-in-house-oss-ai-visibility-architecture.md:118-129,247-248).
+ *
+ * Wraps an injected `LLMClient.chat` (`providers/types.ts:282`) with a
+ * `web_search` `ToolDef` and normalizes the vendor-native citation payload
+ * (surfaced via `ChatResponse.groundingCitations`, `types.ts`) into a plain
+ * `GroundedAnswer`. No `@anthropic-ai/sdk` or `openai` type crosses this
+ * file's boundary (sc-1-4) — it imports ONLY from `./types.js`.
+ *
+ * The `LLMClient` is CONSTRUCTOR-injected (mirrors `SeoAnalyzer(llm, model)`,
+ * `seo/analyzer.ts:304-307`) — a scripted fake drives every test here; the
+ * real client (and any seam wiring into `AiVisibilityProvider`) is built by
+ * a LATER sprint (nonGoals: no adapter wiring, no multiplexer, no factory,
+ * no `src/seo/` changes this sprint).
+ *
+ * `anthropic.ts`'s `normalizeContent` currently DROPS `web_search` citation
+ * blocks, so no real adapter populates `ChatResponse.groundingCitations`
+ * yet — that population is deferred to a later sprint (see the field's doc
+ * comment in `types.ts`). This client already reads and normalizes the
+ * field; it just has nothing to read from a live call today.
+ *
+ * Sprint 7 adds `PerplexitySonarClient`, a SECOND `GroundedSearchClient`
+ * implementation in this same file. Perplexity Sonar is a direct HTTP
+ * `chat/completions` API, not reachable through `LLMClient.chat` — that
+ * class does not wrap an `LLMClient` and introduces the file's only
+ * `fetch` reference, behind an injectable transport. All Perplexity-
+ * specific types stay local/unexported to this file (sc-7-4).
+ */
+import type { LLMClient } from "./types.js";
+/**
+ * Grounded-search engines. `"perplexity"` is part of the type (sc-1-1
+ * requires it in the union) but has NO implementation this sprint — it is
+ * Sprint 7 (nonGoal here). `LiveGroundedSearchClient.search` returns
+ * `citations: []` for it without throwing.
+ */
+export type GroundedEngine = "anthropic" | "openai" | "perplexity";
+/** A single normalized citation: just enough to attribute a claim. */
+export interface GroundedCitation {
+    url: string;
+    title: string;
+}
+/** The normalized result of one grounded-search turn. */
+export interface GroundedAnswer {
+    answerText: string;
+    citations: GroundedCitation[];
+    /** USD cost of the underlying LLM call, when known. Key omitted (never
+     * `costUsd: undefined`) when the cost cannot be determined — mirrors the
+     * `ChatResponse.costUsd` convention (`types.ts`, `anthropic.ts:53,63`). */
+    costUsd?: number;
+}
+/**
+ * Provider-agnostic grounded-search surface. Implementations run one
+ * web-search-enabled LLM turn and return a normalized `GroundedAnswer`.
+ */
+export interface GroundedSearchClient {
+    readonly engine: GroundedEngine;
+    search(prompt: string, locale?: string): Promise<GroundedAnswer>;
+}
+/**
+ * Wraps an injected `LLMClient.chat` to run a single web-search-grounded
+ * turn and normalize its citations. Never constructs a real provider
+ * client itself — the caller injects one built by `createClient`
+ * (`factory.ts`) at wiring time (a later sprint).
+ */
+export declare class LiveGroundedSearchClient implements GroundedSearchClient {
+    readonly engine: GroundedEngine;
+    private readonly llm;
+    private readonly model;
+    constructor(engine: GroundedEngine, llm: LLMClient, model: string);
+    /**
+     * Runs one grounded-search turn. Never throws on a non-grounded response
+     * (sc-1-3): `groundingCitations` is guarded with `?? []` before mapping,
+     * so `citations` is simply `[]` when the model didn't ground its answer.
+     */
+    search(prompt: string, locale?: string): Promise<GroundedAnswer>;
+}
+/**
+ * Duck-typed response — deliberately NOT the global `Response` type, so
+ * tests can construct fakes without touching the real fetch API. Mirrors
+ * `HttpResponse` (`seo/adapters/http.ts:23-27`) in SHAPE only — defined
+ * LOCALLY here (unexported) because `src/providers/` must not import from
+ * `src/seo/` (sc-7-4 / sprint briefing Pattern C).
+ */
+interface PerplexityTransportResponse {
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}
+/**
+ * Fetch-like injectable transport — the SOLE seam through which
+ * `PerplexitySonarClient` reaches the network. Defaults to a thin global-
+ * `fetch` wrapper (`defaultPerplexityTransport` below); tests inject a fake
+ * so no socket ever opens (sc-7-3).
+ */
+type PerplexityTransport = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<PerplexityTransportResponse>;
+/**
+ * `PerplexitySonarClient` — the third `GroundedSearchClient` arm (sc-7-1..
+ * sc-7-4). Mirrors the DataForSEO credential-injection idiom
+ * (`dataforseo-adapter.ts:162-178`): the API key is read from
+ * `PERPLEXITY_API_KEY` via an injected `getApiKey` (never hardcoded), and
+ * the network call goes through an injected `transport` — both default to
+ * real implementations so production wiring needs no arguments, while tests
+ * stub both and never open a real socket (sc-7-3).
+ */
+export declare class PerplexitySonarClient implements GroundedSearchClient {
+    private readonly transport;
+    private readonly getApiKey;
+    private readonly model;
+    readonly engine: GroundedEngine;
+    constructor(transport?: PerplexityTransport, getApiKey?: () => string | undefined, model?: string);
+    /**
+     * Runs one Sonar-grounded turn. Never throws (sc-7-1): a missing key, an
+     * `!res.ok` response, a network error, or malformed JSON all degrade to
+     * `{ answerText: "", citations: [] }` — there is no `DataOutcome`/abstain
+     * at this layer (that happens upstream in `ApiSpineEngineProvider.probe`,
+     * api-spine-provider.ts:80-84). `costUsd` is intentionally OMITTED
+     * (Pattern D) — Sonar cost is already N-baked via `perCallUsd`.
+     */
+    search(prompt: string, locale?: string): Promise<GroundedAnswer>;
+}
+export {};
+//# sourceMappingURL=grounded-search.d.ts.map

package/dist/providers/grounded-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounded-search.d.ts","sourceRoot":"","sources":["../../src/providers/grounded-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAgB,SAAS,EAAW,MAAM,YAAY,CAAC;AAInE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAEnE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B;;+EAE2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAClE;AAqCD;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,oBAAoB;IAEjE,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFb,MAAM,EAAE,cAAc,EACd,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM;IAGhC;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAsBvE;AAuBD;;;;;;GAMG;AACH,UAAU,2BAA2B;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACpE,OAAO,CAAC,2BAA2B,CAAC,CAAC;AA2C1C;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAI9D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAgB;gBAG5B,SAAS,GAAE,mBAAgD,EAC3D,SAAS,GAAE,MAAM,MAAM,GAAG,SAAmD,EAC7E,KAAK,GAAE,MAAiC;IAG3D;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CA6BvE"}