@full-self-browsing/lattice 1.4.0 → 1.5.0

package/dist/scaffolds-DKQrCRqh.d.ts

@@ -0,0 +1,535 @@
+import { $ as XaiQuirks, E as NegotiatedCapabilities, H as RecommendedPromptStrategy, J as LiteLLMQuirks, K as AnthropicQuirks, Q as OpenRouterQuirks, X as OpenAICompatQuirks, Y as LmStudioQuirks, Z as OpenAIQuirks, bn as RunEventSink, d as ProviderRunRequest, f as ProviderRunResponse, n as ModelCapability, nt as ValidateToolCallsOption, p as ProviderStream, q as GeminiQuirks, r as ProviderAdapter } from "./provider-C2IfKsvz.js";
+import { b as GatewayPolicy, r as ArtifactInput } from "./artifact-Bg6mJGnm.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/sanitizers/sanitizers.d.ts
+interface SanitizerContext {
+  readonly providerId: string;
+  readonly modelId?: string;
+  readonly outputName: string;
+}
+type SanitizerFn = (text: string, context: SanitizerContext) => string | Promise<string>;
+type SanitizeOutputOption = SanitizerFn | readonly SanitizerFn[];
+interface InternalEnvelopeOptions {
+  readonly field?: string;
+  readonly path?: string;
+  readonly schema?: StandardSchemaV1;
+}
+declare function stripReasoningTags(): SanitizerFn;
+declare function stripChatTemplateArtifacts(): SanitizerFn;
+declare function unwrapInternalEnvelope(schemaOrPath: string | InternalEnvelopeOptions | StandardSchemaV1): SanitizerFn;
+//#endregion
+//#region src/providers/adapters.d.ts
+interface OpenAICompatibleProviderOptions {
+  readonly id?: string;
+  readonly model: string;
+  readonly baseUrl: string;
+  readonly apiKey?: string;
+  readonly gateway?: GatewayPolicy;
+  readonly fetch?: typeof fetch;
+  /**
+   * Phase 7 addition: caller-supplied per-1k pricing. When provided, the
+   * adapter computes `normalizedUsage.costUsd` from the API-reported token
+   * counts. When omitted, `normalizedUsage.costUsd` is `null` so downstream
+   * consumers can distinguish "unmeasured" from "free" (per 07-CONTEXT.md).
+   */
+  readonly pricing?: {
+    readonly inputPer1kTokens?: number;
+    readonly outputPer1kTokens?: number;
+  };
+  /**
+   * Phase 34 — D-05/D-06/D-08 — TTL for the per-instance models cache.
+   * Default 300_000ms (5 minutes). Set to 0 to disable caching.
+   * Set to Infinity for process-lifetime caching.
+   *
+   * NOTE: for createOpenAICompatibleProvider, this option is accepted for
+   * option-bag uniformity but is NOT USED — openai-compat has no /models
+   * endpoint (D-04). Document in JSDoc for consumers pointing at known servers.
+   */
+  readonly modelsCacheTtlMs?: number;
+  /**
+   * Phase 34 — D-11 — Number of retry attempts on transient /models errors
+   * (5xx, network, timeout). Default 2. Set to 0 to disable retries.
+   *
+   * NOTE: for createOpenAICompatibleProvider, this option is accepted for
+   * option-bag uniformity but is NOT USED — openai-compat has no /models
+   * endpoint (D-04).
+   */
+  readonly modelsRetryCount?: number;
+  /**
+   * Phase 34 — D-12 — Optional RunEventSink for capability negotiation events.
+   * When provided, emits the "capabilities.negotiation.fallback" event on
+   * transient /models errors (5xx, network, timeout).
+   *
+   * NOTE: for createOpenAICompatibleProvider, this option is accepted for
+   * option-bag uniformity but the event is NOT FIRED for source: "registry"
+   * (the documented happy path for openai-compat). Emitting events for the
+   * intentional no-endpoint path would produce noisy false-positives.
+   */
+  readonly runEventSink?: RunEventSink;
+  /**
+   * Phase 36 — Optional output sanitizer pipeline. When provided, string
+   * rawOutputs are transformed in order after provider text extraction and
+   * before the adapter returns.
+   */
+  readonly sanitizeOutput?: SanitizeOutputOption;
+  /**
+   * Phase 37 — Optional returned tool-call validator. When provided, the
+   * adapter parses prompt-reencoded tool_calls envelopes and returns
+   * normalized validated calls without mutating rawOutputs or rawResponse.
+   */
+  readonly validateToolCalls?: ValidateToolCallsOption;
+}
+interface SdkLikeProviderOptions {
+  readonly id?: string;
+  readonly model: string;
+  readonly generate: (input: {
+    readonly task: string;
+    readonly outputNames: readonly string[];
+  }) => Promise<ProviderRunResponse> | ProviderRunResponse;
+}
+/**
+ * Phase 34 — D-04 / QUIRK-02 — OpenAI-compatible provider factory.
+ *
+ * This factory is the prototypical "intentional no remote /models endpoint"
+ * adapter per D-04. The consumer points this adapter at any OpenAI-shaped
+ * endpoint (vLLM, TGI, Ollama, custom), and the factory returns conservative
+ * defaults for the quirks block because the server could be anything.
+ *
+ * The `negotiateCapabilities` method performs NO fetch; it returns
+ * synthesizeNegotiatedCapabilitiesFromRegistry with source: "registry"
+ * (the intentional-no-endpoint signal, as distinct from "registry-fallback"
+ * which signals a transient failure). Plan 34-05 (LM Studio) reuses this
+ * same pattern.
+ *
+ * D-04 citation: "consumer adapters without a /models endpoint skip the
+ * fetch layer entirely and delegate to synthesizeNegotiatedCapabilitiesFromRegistry."
+ */
+declare function createOpenAICompatibleProvider(options: OpenAICompatibleProviderOptions): ProviderAdapter & {
+  readonly quirks: OpenAICompatQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+/**
+ * Phase 34 — QUIRK-02 / NEG-01 / NEG-02 — OpenAI provider factory.
+ *
+ * Extends the base OpenAI-compat factory with:
+ *   1. `quirks: OpenAIQuirks` — verified per RESEARCH §Q6 OpenAI vocabulary.
+ *   2. `negotiateCapabilities(modelId)` — queries OpenAI /v1/models GET with
+ *      Authorization: Bearer header; SPARSE response; intersects with Phase 33
+ *      registry for supports.* (per RESEARCH §Anti-patterns — don't assume
+ *      OpenAI /v1/models returns capability flags, it doesn't).
+ *
+ * The negotiate() pattern mirrors Plan 34-02 (Anthropic thick reference):
+ *   - Per-instance TTL cache (modelsCacheTtlMs, default 300_000ms)
+ *   - Single-flight inflight coalescing with .finally cleanup (Pitfall 4)
+ *   - Retry with [0, 200, 1000]ms backoff (modelsRetryCount, default 2)
+ *   - 401/403 throws NegotiationAuthError (D-10: no retry, no fallback, no event)
+ *   - 5xx/network/timeout falls back to registry with source: "registry-fallback"
+ *   - emitFallbackEvent fires the "capabilities.negotiation.fallback" RunEvent
+ *
+ * SECURITY (T-34-03-07): inflight Map MUST use .finally cleanup to prevent
+ * leak on rejection. Verifiable: grep `.finally` in this file.
+ */
+declare function createOpenAIProvider(options: OpenAICompatibleProviderOptions): ProviderAdapter & {
+  readonly quirks: OpenAIQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+declare function createAISdkProvider(options: SdkLikeProviderOptions): ProviderAdapter;
+//#endregion
+//#region src/providers/anthropic.d.ts
+/**
+ * Options for {@link createAnthropicProvider}.
+ *
+ * Mirrors `OpenAICompatibleProviderOptions` ergonomics (Phase 7 pattern) but
+ * for the Anthropic Messages API at `/v1/messages` -- which uses a top-level
+ * `system` field and a `content[0].text` response shape that diverges from
+ * the OpenAI Chat Completions schema (see FSB v0.9.x `extension/ai/universal-provider.js`
+ * lines 280-297 + 566-573 for the production reference).
+ *
+ * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
+ *
+ * STREAMING (Phase 44): supported through native Anthropic Messages SSE events.
+ *
+ * DEFERRED (Phase 4 carryforward notes):
+ *   - prompt caching   (Phase 39: opt-in via `ProviderRunRequest.cacheSystemPrefix` —
+ *                       emitted as a cache_control-marked system block when present)
+ *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
+ *
+ * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-02 + D-07: full custom adapter; preserve top-level `system`).
+ */
+interface AnthropicProviderOptions {
+  readonly id?: string;
+  readonly model: string;
+  readonly apiKey: string;
+  /** Defaults to `https://api.anthropic.com`. Override for proxies. */
+  readonly baseUrl?: string;
+  /** Defaults to `2023-06-01`. Override only if the consumer has tested a newer pinned version. */
+  readonly anthropicVersion?: string;
+  readonly fetch?: typeof fetch;
+  readonly pricing?: {
+    readonly inputPer1kTokens?: number;
+    readonly outputPer1kTokens?: number;
+  };
+  /**
+   * D-08: Per-instance TTL for the /v1/models response cache (milliseconds).
+   * Default 300_000 (5 minutes). `0` disables caching (always re-fetch -- for testing).
+   * `Infinity` disables expiry (process-lifetime for the instance).
+   */
+  readonly modelsCacheTtlMs?: number;
+  /**
+   * D-11: Number of retries for transient /v1/models fetch failures (5xx, network,
+   * timeout). Default 2 (3 total attempts). `0` disables retries.
+   * Backoff schedule: [0ms, 200ms, 1000ms].
+   */
+  readonly modelsRetryCount?: number;
+  /**
+   * D-12: Optional RunEventSink for emitting `capabilities.negotiation.fallback`
+   * events when the /v1/models fetch falls back to the Phase 33 static registry.
+   * If absent, fallback emits no event (no-op). Auth errors (401/403) never emit
+   * the fallback event -- they throw `NegotiationAuthError` instead.
+   */
+  readonly runEventSink?: RunEventSink;
+  readonly sanitizeOutput?: SanitizeOutputOption;
+  readonly validateToolCalls?: ValidateToolCallsOption;
+}
+declare function createAnthropicProvider(options: AnthropicProviderOptions): ProviderAdapter & {
+  readonly quirks: AnthropicQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/fake.d.ts
+interface FakeProviderOptions {
+  readonly id?: string;
+  readonly modelId?: string;
+  readonly response?: ProviderRunResponse | ((request: ProviderRunRequest) => ProviderRunResponse | Promise<ProviderRunResponse>);
+  readonly artifacts?: readonly ArtifactInput[];
+  /**
+   * Phase 7 addition: when provided, REPLACES the default single-capability
+   * array so callers (notably Plan 07-04's modality/privacy reject tests)
+   * can construct a fake adapter with arbitrary
+   * `inputModalities` / `outputModalities` / `dataPolicy` / `pricing`
+   * without mutating the returned adapter's readonly `capabilities` array.
+   * When omitted, the existing default capability is used.
+   */
+  readonly capabilities?: readonly ModelCapability[];
+}
+declare function createFakeProvider(options?: FakeProviderOptions): ProviderAdapter;
+//#endregion
+//#region src/providers/gemini.d.ts
+/**
+ * Options for {@link createGeminiProvider}.
+ *
+ * Mirrors `OpenAICompatibleProviderOptions` ergonomics (Phase 7 pattern) but
+ * for Google's Generative Language API at
+ * `/v1beta/models/{model}:generateContent` -- which uses `contents[].parts[].text`
+ * (NOT OpenAI's `messages[]`), `role: "model"` for assistant turns (NOT
+ * `"assistant"`), authenticates via `?key=` query string for execute(), and applies a
+ * 4-category `safetySettings` block at `BLOCK_NONE` thresholds (FSB convention
+ * mirrored from `extension/ai/universal-provider.js:255-272`).
+ *
+ * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
+ *
+ * STREAMING (Phase 44): supported through native `streamGenerateContent` SSE events.
+ *
+ * DEFERRED (Phase 4 carryforward notes):
+ *   - multimodal (vision) -- deferred
+ *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
+ *
+ * NOTE (Phase 34): negotiate() uses x-goog-api-key HEADER (preferred per RESEARCH §Q3).
+ * The existing execute() path uses ?key= query string -- execute() migration is out-of-scope
+ * for Phase 34 (additive only; T-34-04-01).
+ *
+ * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-02 + D-07: full custom adapter; preserve role:"model").
+ */
+interface GeminiProviderOptions {
+  readonly id?: string;
+  readonly model: string;
+  readonly apiKey: string;
+  /** Defaults to `https://generativelanguage.googleapis.com`. */
+  readonly baseUrl?: string;
+  readonly fetch?: typeof fetch;
+  readonly pricing?: {
+    readonly inputPer1kTokens?: number;
+    readonly outputPer1kTokens?: number;
+  };
+  /**
+   * D-08: TTL for per-instance /models response cache, in milliseconds.
+   * Default: 300_000ms (5 minutes). 0 = always refetch (tests). Infinity = process-lifetime.
+   */
+  readonly modelsCacheTtlMs?: number;
+  /**
+   * D-11: Number of retries on transient /models fetch errors. Default: 2.
+   * Retry schedule: immediate + 200ms + 1000ms (3 total attempts at retryCount=2).
+   * 0 = no retries (1 attempt total).
+   */
+  readonly modelsRetryCount?: number;
+  /**
+   * D-12: Optional event sink for observability. When provided, the adapter
+   * emits a "capabilities.negotiation.fallback" RunEvent on transient /models failure.
+   * If absent, no event is emitted (silent fallback).
+   */
+  readonly runEventSink?: RunEventSink;
+  readonly sanitizeOutput?: SanitizeOutputOption;
+  readonly validateToolCalls?: ValidateToolCallsOption;
+}
+/**
+ * Phase 34 — D-03 / D-05..D-12 — Extended Gemini provider factory.
+ *
+ * Returns a `ProviderAdapter` narrowed to expose:
+ *   - `quirks: GeminiQuirks` — static adapter capability flags
+ *   - `negotiateCapabilities(modelId)` — live /v1beta/models fetch with medium-thick
+ *     derivation (inputTokenLimit + thinking + supportedGenerationMethods from upstream)
+ *     intersected with Phase 33 registry; TTL cache + inflight coalescing + retry +
+ *     auth-throw + transient-fallback + event.
+ *
+ * NOTE on auth strategy (T-34-04-01): negotiate() uses x-goog-api-key HEADER
+ * (preferred per RESEARCH §Q3 -- avoids leaking the key in server-side logs that
+ * capture URL query strings). The existing execute() path uses ?key= query string
+ * and is NOT changed by Phase 34 (out-of-scope migration).
+ */
+declare function createGeminiProvider(options: GeminiProviderOptions): ProviderAdapter & {
+  readonly quirks: GeminiQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/litellm.d.ts
+/**
+ * Options for {@link createLiteLLMProvider}.
+ *
+ * Thin wrapper around {@link createOpenAICompatibleProvider} pinned to the
+ * documented local LiteLLM proxy URL. LiteLLM is treated as an
+ * OpenAI-compatible gateway over HTTP; this helper does not start, embed, or
+ * depend on a LiteLLM gateway process.
+ */
+interface LiteLLMProviderOptions extends Omit<OpenAICompatibleProviderOptions, "id" | "baseUrl" | "gateway"> {
+  readonly id?: string;
+  /** Defaults to `http://localhost:4000`. Override for hosted proxies or `/v1` deployments. */
+  readonly baseUrl?: string;
+  readonly gateway?: GatewayPolicy;
+}
+declare function createLiteLLMProvider(options: LiteLLMProviderOptions): ProviderAdapter & {
+  readonly quirks: LiteLLMQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/lm-studio.d.ts
+/**
+ * Options for {@link createLmStudioProvider}.
+ *
+ * Thin wrapper around {@link createOpenAICompatibleProvider} pinned to
+ * LM Studio's default local server URL `http://localhost:1234/v1`. Wire
+ * shape is OpenAI Chat Completions. LM Studio is no-auth by convention
+ * (CD-03): `apiKey` is OPTIONAL; when omitted, the underlying factory
+ * sends no `Authorization` header (see
+ * `lattice/packages/lattice/src/providers/adapters.ts:53` for the
+ * conditional auth-header wiring).
+ *
+ * Phase 34 additions:
+ *   - `modelsCacheTtlMs` -- Reserved for future /models discovery; LM Studio
+ *     currently has no remote /models endpoint. Accepted for option-bag
+ *     uniformity but NOT USED (D-04 intentional no-endpoint pattern).
+ *   - `runEventSink` -- Accepted for option-bag uniformity but NEVER fired
+ *     because source: "registry" is the documented happy path for LM Studio
+ *     (no event for intentional no-endpoint per RESEARCH Open Question 5).
+ *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
+ * DEFERRED (D-16 carryforward):
+ *   - latency-tail diagnostics  -- observability concern; LM Studio is
+ *                                  the canary for latency tails (INV-03);
+ *                                  diagnostics module deferred to a
+ *                                  follow-on observability phase.
+ *   - resume-from-eviction      -- see Phase 5 (MV3-survivability adapter).
+ *
+ * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03: thin wrapper; D-16: latency-tail deferred; CD-03 no-opt-out).
+ */
+interface LmStudioProviderOptions extends Omit<OpenAICompatibleProviderOptions, "id" | "baseUrl" | "apiKey"> {
+  readonly id?: string;
+  /** Defaults to `http://localhost:1234/v1`. Override for non-localhost deployments. */
+  readonly baseUrl?: string;
+  /**
+   * Optional. LM Studio is no-auth by convention (CD-03 default).
+   * When provided, sent as `Authorization: Bearer <apiKey>` (matches the
+   * underlying OpenAI-compat factory). Use only for proxied LM Studio
+   * deployments that have a token gate in front.
+   */
+  readonly apiKey?: string;
+}
+/**
+ * Phase 34 — D-04 / QUIRK-02 — LM Studio provider factory.
+ *
+ * LM Studio is the prototypical "intentional no remote /models endpoint"
+ * adapter per D-04 (alongside OpenAI-compat). The factory returns conservative
+ * defaults for the quirks block because LM Studio runs LOCAL quantized models
+ * whose capabilities vary wildly by chat template + model file.
+ *
+ * The `negotiateCapabilities` method performs NO fetch; it returns
+ * `synthesizeNegotiatedCapabilitiesFromRegistry` with source: "registry"
+ * (the intentional-no-endpoint signal, distinct from "registry-fallback"
+ * which signals a transient failure). Mirrors Plan 34-03 Task 2 (OpenAI-compat
+ * registry-only pattern) verbatim.
+ *
+ * D-04 citation: "consumer adapters without a /models endpoint skip the
+ * fetch layer entirely and delegate to synthesizeNegotiatedCapabilitiesFromRegistry."
+ *
+ * Open Question 5 (RESEARCH §): no event emitted for source: "registry" because
+ * this is the intentional happy path for LM Studio -- emitting a "fallback" event
+ * would produce false-positive noise for consumers monitoring the event stream.
+ */
+declare function createLmStudioProvider(options: LmStudioProviderOptions): ProviderAdapter & {
+  readonly quirks: LmStudioQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/openrouter.d.ts
+/**
+ * Options for {@link createOpenRouterProvider}.
+ *
+ * Thin wrapper around {@link createOpenAICompatibleProvider} pinned to
+ * OpenRouter's base URL `https://openrouter.ai/api/v1`. Wire shape is
+ * OpenAI Chat Completions; no provider-specific quirks at the
+ * single-shot Promise contract level.
+ *
+ * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
+ *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
+ * DEFERRED (D-17 carryforward; Phase 4 ships the named adapter as a
+ * first-class OpenAI-compat wrapper):
+ *   - per-message routing  -- deferred.
+ *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter).
+ *
+ * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03: thin wrapper; D-17: model-routing deferred).
+ */
+interface OpenRouterProviderOptions extends Omit<OpenAICompatibleProviderOptions, "id" | "baseUrl"> {
+  readonly id?: string;
+  /** Defaults to `https://openrouter.ai/api/v1`. Override for proxies. */
+  readonly baseUrl?: string;
+  /**
+   * D-08: TTL for per-instance /models response cache, in milliseconds.
+   * Default: 300_000ms (5 minutes). 0 = always refetch (tests). Infinity = process-lifetime.
+   */
+  readonly modelsCacheTtlMs?: number;
+  /**
+   * D-11: Number of retries on transient /models fetch errors. Default: 2.
+   * Retry schedule: immediate + 200ms + 1000ms (3 total attempts at retryCount=2).
+   * 0 = no retries (1 attempt total).
+   */
+  readonly modelsRetryCount?: number;
+  /**
+   * D-12: Optional event sink for observability. When provided, the adapter
+   * emits a "capabilities.negotiation.fallback" RunEvent on transient /models failure.
+   * If absent, no event is emitted (silent fallback).
+   */
+  readonly runEventSink?: RunEventSink;
+  /**
+   * Ordered OpenRouter model fallback candidates. The primary `model` remains
+   * the Lattice-selected route; these candidates serialize as OpenRouter's
+   * top-level `models` request field when non-empty.
+   */
+  readonly fallbackModels?: readonly string[];
+}
+/**
+ * Phase 34 — D-03 / D-05..D-12 — Extended OpenRouter provider factory.
+ *
+ * Returns a `ProviderAdapter` narrowed to expose:
+ *   - `quirks: OpenRouterQuirks` — static adapter capability flags (8 booleans)
+ *   - `negotiateCapabilities(modelId)` — live /api/v1/models fetch with rich /models
+ *     intersection (supported_parameters -> nativeToolCalling + structuredOutputs,
+ *     top_provider.context_length -> contextWindow) intersected with Phase 33 registry
+ *     for knownFailureModes + recommendedSanitizers.
+ *
+ * CRITICAL for ANCHOR CASE STUDY (session_1780792387779):
+ *   negotiate("openai/gpt-oss-120b:free") MUST resolve to:
+ *     - result.knownFailureModes.includes("internal_envelope_leak") -> TRUE
+ *     - result.recommendedSanitizers.includes("unwrapInternalEnvelope") -> TRUE
+ *     - result.source === "live" -> TRUE
+ *   This proves: live-fetch -> id suffix-strip via stripOpenRouterVariant
+ *   -> registry intersection -> getRecommendedSanitizers derivation.
+ *
+ * Anti-pattern (RESEARCH §Anti-pattern, lines 534-535):
+ *   The /api/v1/models endpoint is UNAUTHENTICATED (public discovery surface verified
+ *   Phase 33). Do NOT send Authorization Bearer to this endpoint -- it is NOT required
+ *   and would add unnecessary API key exposure surface in transit logs.
+ */
+declare function createOpenRouterProvider(options: OpenRouterProviderOptions): ProviderAdapter & {
+  readonly quirks: OpenRouterQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/xai.d.ts
+/**
+ * Options for {@link createXaiProvider}.
+ *
+ * Thin wrapper around {@link createOpenAICompatibleProvider} pinned to
+ * xAI's base URL `https://api.x.ai/v1`. The wire shape is identical to
+ * OpenAI Chat Completions, with one provider-specific quirk preserved:
+ * `response.usage.completion_tokens_details.reasoning_tokens` (xAI's
+ * separate reasoning-token accounting; see FSB
+ * `extension/ai/universal-provider.js:585-594` for the production reference).
+ *
+ * SECURITY: `apiKey` is a runtime parameter -- do NOT hardcode or log it.
+ *
+ * STREAMING (Phase 44): supported through the OpenAI-compatible stream path.
+ *
+ * DEFERRED (Phase 4 carryforward notes):
+ *   - tool-streaming -- deferred
+ *   - resume-from-eviction -- see Phase 5 (MV3-survivability adapter contract)
+ *
+ * Ref: FSB v0.10.0-attempt-2 Phase 4 (D-03 + D-07: thin wrapper; reasoning_tokens quirk preserved).
+ *
+ * Phase 34 additions:
+ *   - `modelsCacheTtlMs?` — D-05/D-06/D-08; default 300_000ms; 0 disables; Infinity = process-lifetime
+ *   - `modelsRetryCount?` — D-11; default 2; 0 disables retry
+ *   - `runEventSink?`     — D-12; fires "capabilities.negotiation.fallback" on transient errors
+ */
+interface XaiProviderOptions extends Omit<OpenAICompatibleProviderOptions, "id" | "baseUrl"> {
+  readonly id?: string;
+  /** Defaults to `https://api.x.ai/v1`. Override for proxies. */
+  readonly baseUrl?: string;
+}
+/**
+ * Phase 34 — QUIRK-02 / NEG-01 / NEG-02 — xAI provider factory.
+ *
+ * Extends the base OpenAI-compat execution wrapper with:
+ *   1. `quirks: XaiQuirks` — verified per RESEARCH §Q6 xAI vocabulary.
+ *   2. `negotiateCapabilities(modelId)` — queries xAI /v1/models GET with
+ *      Authorization: Bearer header; LENIENT-PARSE sparse OpenAI-shaped
+ *      response; intersects with Phase 33 registry for supports.*.
+ *
+ * CITED: RESEARCH §Q4 (INFERRED) — xAI /v1/models shape is undocumented;
+ * assumed OpenAI-compatible based on the chat completions wire format.
+ *
+ * CITED: RESEARCH §A1 — Pitfall 1 lenient parse: if xAI publishes a
+ * different /models shape, only the parsing logic updates; the contract
+ * (source values, NegotiatedCapabilities shape) holds.
+ *
+ * The negotiate() pattern mirrors Plan 34-02 (Anthropic thick reference):
+ *   - Per-instance TTL cache (modelsCacheTtlMs, default 300_000ms)
+ *   - Single-flight inflight coalescing with .finally cleanup (Pitfall 4)
+ *   - Retry with [0, 200, 1000]ms backoff (modelsRetryCount, default 2)
+ *   - 401/403 throws NegotiationAuthError with adapter: "xai" (D-10)
+ *   - 5xx/network/timeout falls back to registry + emits fallback event
+ *
+ * SECURITY (T-34-03-07): inflight Map MUST use .finally cleanup to prevent
+ * leak on rejection. Verifiable: grep `.finally` in this file.
+ */
+declare function createXaiProvider(options: XaiProviderOptions): ProviderAdapter & {
+  readonly quirks: XaiQuirks;
+  readonly negotiateCapabilities: (modelId: string) => Promise<NegotiatedCapabilities>;
+};
+//#endregion
+//#region src/providers/streaming.d.ts
+interface CollectStreamOptions {
+  readonly defaultOutput?: string;
+}
+declare function collectStream(stream: ProviderStream, options?: CollectStreamOptions): Promise<ProviderRunResponse>;
+//#endregion
+//#region src/prompts/scaffolds.d.ts
+declare const PROMPT_SCAFFOLD_VERSION: "lattice.prompt-scaffold/v1";
+declare const PROMPT_STRATEGIES: readonly ["frontier", "mid_tier", "open_weight", "reasoning", "local"];
+declare function getStructuredOutputContract(strategy: RecommendedPromptStrategy, schema: unknown): string;
+declare function getToolUseContract(strategy: RecommendedPromptStrategy, tools: unknown): string;
+//#endregion
+export { stripChatTemplateArtifacts as A, createAISdkProvider as C, SanitizeOutputOption as D, InternalEnvelopeOptions as E, unwrapInternalEnvelope as M, SanitizerContext as O, SdkLikeProviderOptions as S, createOpenAIProvider as T, FakeProviderOptions as _, CollectStreamOptions as a, createAnthropicProvider as b, createXaiProvider as c, LmStudioProviderOptions as d, createLmStudioProvider as f, createGeminiProvider as g, GeminiProviderOptions as h, getToolUseContract as i, stripReasoningTags as j, SanitizerFn as k, OpenRouterProviderOptions as l, createLiteLLMProvider as m, PROMPT_STRATEGIES as n, collectStream as o, LiteLLMProviderOptions as p, getStructuredOutputContract as r, XaiProviderOptions as s, PROMPT_SCAFFOLD_VERSION as t, createOpenRouterProvider as u, createFakeProvider as v, createOpenAICompatibleProvider as w, OpenAICompatibleProviderOptions as x, AnthropicProviderOptions as y };
+//# sourceMappingURL=scaffolds-DKQrCRqh.d.ts.map

package/dist/scaffolds-DKQrCRqh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolds-DKQrCRqh.d.ts","names":[],"sources":["../src/sanitizers/sanitizers.ts","../src/providers/adapters.ts","../src/providers/anthropic.ts","../src/providers/fake.ts","../src/providers/gemini.ts","../src/providers/litellm.ts","../src/providers/lm-studio.ts","../src/providers/openrouter.ts","../src/providers/xai.ts","../src/providers/streaming.ts","../src/prompts/scaffolds.ts"],"mappings":"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"}