@plurnk/plurnk-providers 1.16.5 → 1.18.0

package/.env.defaults

@@ -1,178 +1,112 @@
-# REFERENCE - @plurnk/plurnk-providers' shipped .env.defaults: the operative floor for
-# PLURNK_PROVIDERS_* knobs and provider declarations ({§operator-config-env-defaults});
-# every package owns what it reads, and this file IS the configuration reference.
-# The daemon assembles every installed member's file into one floor (set-if-unset under the
-# operator's env) - do NOT edit this file; put YOUR config in
-# $XDG_CONFIG_HOME/plurnk/.env or ./.env. A key
-# claimed by two packages crashes boot naming both.
-#
-# EVERY PLURNK_PROVIDERS_* knob is per-alias-scopable: PLURNK_PROVIDERS_<KNOB>_<alias> wins over
-# the bare name (suffix case-folds; SPEC §4). Set lines are the floor; commented lines are values
-# whose UNSET state is meaningful (derive/auto/off, or a required secret) - uncomment to pin.
-#
-# Models.dev supplies cataloged providers' SDK package, endpoint, credential names,
-# and model facts. {§model-fact-resolution} defines precedence per fact; there is
-# no live price fetch. Secret VALUES never belong here.
+# @plurnk/plurnk-providers — models, generation, and transport.
+# Per-model knobs accept _<alias> overrides; nonempty overrides win, alias case-insensitively.
+# Provider declarations (PROVIDER_<NAME>_*) apply to that provider, not one alias.
+# Models.dev supplies known endpoints, credential names, limits, capabilities, and prices.
+# Active lines are defaults. Commented lines are optional examples, not loaded values.
 
-# --- OpenRouter application attribution ({§openrouter-app-attribution}) ---
-# OpenRouter uses the public URL as the app identity and the title for display.
-# Override both for a downstream application. An explicitly empty URL suppresses
-# attribution entirely; a title without a URL is never sent.
-OPENROUTER_HTTP_REFERER=https://github.com/plurnk/plurnk-service
-OPENROUTER_APP_TITLE=Plurnk
+# --- Model selection ---
+# PLURNK_MODEL accepts an exact provider/model route or a declared alias.
+# The model id may contain "/". Aliases provide reusable endpoint/tuning scopes.
+# PLURNK_MODEL_cloud=openrouter/qwen/qwen3-coder
+# PLURNK_MODEL_local=openai/model-name-from-endpoint
+# PLURNK_BASEURL_local=http://127.0.0.1:8080/v1
+# PLURNK_MODEL=cloud
+# PLURNK_MODEL=google/gemini-3-flash
 
-# --- Generation envelope ({§provider-generation-envelope}, #242) ---
-# OUTPUT_BUDGET is one total response ceiling, including hidden reasoning. It accepts a
-# percentage of the effective context window or an absolute token count and is always
-# capped by known model output limits. REASONING_BUDGET is an optional subset of that
-# total; leave it unset for provider-adaptive depth. Both are alias-scopable.
+# --- Capacity ---
+# Total output envelope INCLUDING reasoning: positive tokens or context percentage in (0,100).
+# Known model limits cap it. Must leave input capacity; the context budget is derived, not set here.
 PLURNK_PROVIDERS_OUTPUT_BUDGET=35%
+# Optional reasoning subset of output, using the same units; must be smaller than total output.
+# Unset/empty = provider-adaptive budget, not reasoning off.
 # PLURNK_PROVIDERS_REASONING_BUDGET=8192
-# Rate override (#461, {§operator-cost-override}): Models.dev is the starting point;
-# declare exact per-1M-token USD rates when a provider reprices ahead of the catalog.
-# Keys merge over the catalog block; alias-scoped (PLURNK_PROVIDERS_COST_<alias>).
-# PLURNK_PROVIDERS_COST=input=0.22,output=0.66,reasoning=0.66,cacheRead=0.007
+# Total context cap, tokens; unset = live endpoint capacity, then Models.dev, otherwise unknown.
+# A cap can reduce known capacity or declare unknown capacity; it cannot enlarge known limits.
+# PLURNK_PROVIDERS_CONTEXT_WINDOW=200000
 
-# --- Side-channel reasoning ({§provider-reasoning-policy}) ---
-# off | adaptive | low | medium | high. Policy and budget remain independent;
-# adaptive requests native dynamic reasoning where available and otherwise the
-# provider's supported high posture. Alias-scoped values seed a worker once.
+# --- Reasoning ---
+# off | adaptive | low | medium | high | xhigh | max. Seed for durable Worker reasoning.
+# adaptive uses native dynamic reasoning where supported, otherwise the supported high posture.
 PLURNK_PROVIDERS_REASONING=adaptive
-
-# Response-content interpretation ({§provider-tagged-reasoning}) is independent
-# from request-side reasoning activation. The portable floor trusts only
-# structured provider/SDK reasoning fields and leaves visible content verbatim.
-# Set think-tags only on an alias whose exact model/endpoint contract emits one
-# leading <think> envelope; it is never inferred from generic reasoning capability.
+# Response interpretation: verbatim = trust structured reasoning fields; think-tags = extract one
+# leading <think> envelope. Select only for an endpoint that emits it; independent of activation.
 PLURNK_PROVIDERS_REASONING_RESPONSE_STYLE=verbatim
-# PLURNK_PROVIDERS_REASONING_RESPONSE_STYLE_cfds1=think-tags
 
-# --- Decode tuning ({§provider-sampling-passthrough}, #480) ---
-# The service imposes no sampling opinion: EMPTY (the normal default) sends no
-# temperature and no repeat_penalty — the provider's or model's own defaults
-# govern. Set a value (usually per-alias) only from measurement; the reference
-# blocks below carry each local model's measured numbers.
+# --- Sampling ---
+# Temperature; empty = omit, retaining the provider's sampling default.
 PLURNK_PROVIDERS_TEMPERATURE=
+# Repetition penalty; empty = omit. Values above 1 can penalize required verbatim repetition.
 PLURNK_PROVIDERS_REPEAT_PENALTY=
-# FREQUENCY_PENALTY (https://github.com/plurnk/plurnk-service/issues/426):
-# optional cloud anti-degeneration tuning. API acceptance
-# permits the field to ride but does not establish its semantic effect, and provider
-# implementations differ. The portable floor is off; enable per alias only from
-# provider documentation or a controlled behavioral experiment.
+# Frequency penalty; 0 = off. Support and effect depend on the endpoint.
 PLURNK_PROVIDERS_FREQUENCY_PENALTY=0
-# PLURNK_PROVIDERS_FREQUENCY_PENALTY_myendpoint=0.4
-# Fixed provider service tier. Fireworks accepts auto|default|flex|priority;
-# normally set per alias so a paid routing choice is explicit.
-# PLURNK_PROVIDERS_SERVICE_TIER_myfireworks=priority
-# Route adapters project the stable worker identity through only the provider's
-# documented session/cache-affinity control. Unknown compatible routes receive
-# no guessed field. Disable globally or per alias only for operational diagnosis.
+# Repeat-penalty window, tokens; unset = endpoint default.
+# PLURNK_PROVIDERS_REPEAT_LAST_N=512
+# llama.cpp DRY repeated-sequence penalty; 0 = off. Nonzero can distort required exact copying.
+PLURNK_PROVIDERS_DRY_MULTIPLIER=0
+# DRY exponential base; unset/empty = endpoint default.
+# PLURNK_PROVIDERS_DRY_BASE=
+# DRY unpenalized sequence length, tokens; unset/empty = endpoint default.
+# PLURNK_PROVIDERS_DRY_ALLOWED_LENGTH=
+
+# --- Cache and billing ---
+# Stable Worker affinity on supported routes: 1 = on; 0 = off. Unknown routes get no guessed field.
 PLURNK_PROVIDERS_CACHE_AFFINITY=1
-# Explicit cache writes are distinct from affinity and may affect billing.
-# stable-system marks only the reusable system boundary on supported Claude
-# routes; off requests no explicit cache write. Provider-default lifetime is 5m.
+# Explicit cache writes: stable-system = reusable system boundary on supported Claude routes;
+# off = no explicit writes. This is distinct from affinity and can affect billing.
 PLURNK_PROVIDERS_CACHE_WRITE_POLICY=stable-system
-# https://github.com/plurnk/plurnk-service/issues/567: DRY is a llama.cpp-only
-# repeated-sequence penalty. It can reduce
-# degenerate loops, but it can also corrupt exact source, identifiers, quoted
-# evidence, and other repetition required by PLURNK operations. The portable
-# server-wide default is off. A nonzero alias override is an explicit fidelity
-# tradeoff; DRY_BASE_<alias> and DRY_ALLOWED_LENGTH_<alias> tune that opt-in.
-PLURNK_PROVIDERS_DRY_MULTIPLIER=0
-# PLURNK_PROVIDERS_DRY_BASE_<alias>=
-# PLURNK_PROVIDERS_DRY_ALLOWED_LENGTH_<alias>=
-# REPEAT_LAST_N widens the older repeat_penalty window past the box's default.
-# Set it per alias only from measured model behavior.
-# PLURNK_PROVIDERS_REPEAT_LAST_N_<alias>=512
+# Provider service tier; unset = provider default. Usually set per alias: routing can change cost.
+# PLURNK_PROVIDERS_SERVICE_TIER_myfireworks=priority
+# USD per million tokens, merged over Models.dev rates; omitted categories retain catalog values.
+# Supported keys: input, output, reasoning, cacheRead, cacheWrite. This is estimation, not billing truth.
+# PLURNK_PROVIDERS_COST=input=0.22,output=0.66,reasoning=0.66,cacheRead=0.007
 
-# --- Connectivity budgets ({§provider-connectivity}, #240) ---
-# Complete logical generation deadline (ms), spanning every physical attempt
-# and retry delay. Zero disables this outer deadline; caller cancellation still
-# spans the operation. The floor leaves all four ten-minute attempts plus normal
-# backoff available under the three-retry floor.
+# --- Connectivity (milliseconds; each deadline accepts 0 = off) ---
+# Logical generation deadline, including physical attempts and retry delays.
 PLURNK_PROVIDERS_OPERATION_TIMEOUT=2700000
-# Maximum duration (ms) of one physical generation attempt. Zero disables the
-# per-attempt deadline without changing the operation deadline.
+# Deadline per physical generation attempt.
 PLURNK_PROVIDERS_FETCH_TIMEOUT=600000
-# Maximum wait (ms) from response-stream start to first semantic model content.
-# Transport metadata and empty deltas do not satisfy it. The portable floor
-# allows endpoints that intentionally buffer a full attempt; tighten per alias
-# from measured time-to-first-content. Zero disables it.
+# Wait from stream start to first semantic content; metadata/empty deltas do not count.
 PLURNK_PROVIDERS_FIRST_CONTENT_TIMEOUT=180000
-# Maximum silence (ms) between semantic streamed-content chunks after content
-# begins. Zero disables it. Both content deadlines consume the ordinary retry
-# budget when they expire.
+# Maximum silence between semantic content chunks after content begins.
 PLURNK_PROVIDERS_STREAM_IDLE_TIMEOUT=120000
-# Provider-directed-wait retries (#479): N = retries on HTTP 429, any response
-# carrying Retry-After (its duration wins over backoff), or an explicit
-# X-Should-Retry:true; 0 = surface even those at once. Every other failure (5xx, deadlines, network) surfaces on
-# the first attempt — the engine's {§provider-recovery} owns re-issue and park.
+# Retries for 429, Retry-After, or X-Should-Retry:true; 0 = none. Other failures return immediately
+# to Core's separate recovery window. Retry-After takes precedence over backoff.
 PLURNK_PROVIDERS_RETRY_ATTEMPTS=3
-# Maximum characters retained from an upstream provider diagnostic in the
-# public Problem detail. Structured failure facts are not truncated.
+# Maximum upstream diagnostic characters in public errors; structured facts remain complete.
 PLURNK_PROVIDERS_ERROR_DETAIL_LIMIT=512
-
-# --- Endpoint probe (#34) ---
-# GET /v1/models at construction (context window + llama-server fingerprint). One failure
-# must never decide capability: ATTEMPTS retries with DELAY(ms) backoff base.
+# Local endpoint /v1/models probe attempts (capacity and llama-server detection).
 PLURNK_PROVIDERS_PROBE_ATTEMPTS=3
+# Initial probe backoff, ms.
 PLURNK_PROVIDERS_PROBE_DELAY=250
 
-# --- Optional local constrained sampling (GBNF, SPEC §10) ---
-# Unset by default. Set per alias only for a local llama-server whose GBNF
-# transport is detected or pinned. Cloud and endpoint-managed model settings do
-# not use this knob.
-# Rails on a weak model need a recency reminder or turns death-march to the
-# token ceiling ({§gbnf-forced-march}): put in the Recap footer (core
-# PLURNK_SERVICE_RECAP) a line such as
-#   YOU MUST begin with `## PLAN0` and end with `### SEND0 [status code]`
-# PLURNK_PROVIDERS_GBNF=plurnk.qwen.gbnf
-# Debug toggle: validate but withhold a configured local GBNF, then report the
-# unconstrained output's divergence. Development aid; leave unset in production.
-# PLURNK_PROVIDERS_GBNF_DEBUG=0
-
-# --- Window ({§model-fact-resolution}) ---
-# Effective total context envelope. Unset derives natural capacity from a live endpoint probe
-# (n_ctx) or models.dev, else null (surfaced once via PLURNK_CONTEXT_UNKNOWN). A configured
-# value is a final hard cap on known capacity or declares the envelope when unknown. Model-facing
-# curation pressure is separate consumer policy.
-# PLURNK_PROVIDERS_CONTEXT_WINDOW=200000
-
-# --- llama-server detection pin (#34) ---
-# Unset = auto-detect from the /v1/models fingerprint. 1 = pin llama-server capabilities
-# (grammar transport, slot pinning, /tokenize) WITHOUT trusting the probe; 0 = force plain
-# remote even when the fingerprint matches. Usually per-alias: _<alias>.
+# --- Local endpoints and grammar ---
+# llama-server: unset = detect; 1 = pin capabilities; 0 = force plain compatible transport.
 # PLURNK_PROVIDERS_LLAMA_SERVER=1
+# Path of an operator-written GBNF grammar carried verbatim to a llama-server route; unset/0 = none.
+# The service ships no grammar profile; a bare name is an error. Per alias: PLURNK_PROVIDERS_GBNF_<alias>.
+# PLURNK_PROVIDERS_GBNF=~/.config/plurnk/my-rail.gbnf
 
-# --- Data capture (#36, SPEC §14) - OFF by default; the flag IS the isolation ---
-# Enable ONLY on a dataset-scraping alias (append _<alias>); serving turns then request and
-# carry nothing. TOP_LOGPROBS: "off" or a non-negative OpenAI top_logprobs count
-# (0 captures only the chosen token; surfaced on assistant.logprobs). "off" lets
-# an alias override process-wide capture. RAWBODY: truthy -> verbatim wire body
-# on response.rawBody (keeps sampling_logprob/token_id/bytes the digest drops).
-# PLURNK_PROVIDERS_TOP_LOGPROBS_myscraper=3
-# PLURNK_PROVIDERS_RAWBODY_myscraper=1
+# --- Evidence capture ---
+# OpenAI top_logprobs: off/unset = none; 0 = chosen token only; N > 0 = alternatives.
+# PLURNK_PROVIDERS_TOP_LOGPROBS=3
+# Retain raw wire body: unset/empty/0 = off; other values = on. Usually isolate to one capture alias.
+# PLURNK_PROVIDERS_RAWBODY=1
 
-# --- Provider declarations (SPEC §5) ---
-# Models.dev supplies the AI SDK package, credential names, endpoint, and model
-# metadata for cataloged providers. These knobs override those facts or declare
-# an endpoint Models.dev does not list. NAME is the alias provider segment.
-# PLURNK_PROVIDERS_PROVIDER_<NAME>_NPM=<supported AI SDK package>
-# PLURNK_PROVIDERS_PROVIDER_<NAME>_BASE_URL=<endpoint>
-# PLURNK_PROVIDERS_PROVIDER_<NAME>_API_KEY_ENV=<one exact env name>
-# Models.dev is authoritative for cataloged providers ({§provider-fact-authority}):
-# package defaults never redefine a cataloged NPM, BASE_URL, or credential name.
-# Fireworks reasoners default on when reasoning_effort is omitted; explicit
-# "none" is its off switch. This is a declared wire exception, not a registry.
+# --- Provider declarations ---
+# Override known facts or declare an uncataloged provider. NAME is the route's provider segment.
+# API_KEY_ENV names a variable, never its secret value.
+# PLURNK_PROVIDERS_PROVIDER_ACME_NPM=@ai-sdk/openai-compatible
+# PLURNK_PROVIDERS_PROVIDER_ACME_BASE_URL=https://api.acme.example/v1
+# PLURNK_PROVIDERS_PROVIDER_ACME_API_KEY_ENV=ACME_API_KEY
+# Reasoning wire adaptations that are not expressed by catalog metadata:
+# Fireworks requires an explicit off effort; Cloudflare graded models require an effort.
 PLURNK_PROVIDERS_PROVIDER_FIREWORKS_AI_REASONING_STYLE=effort_explicit
-# Cloudflare graded reasoners require an effort value; Models.dev supplies each
-# route's exact vocabulary and routes without graded control use their default.
 PLURNK_PROVIDERS_PROVIDER_CLOUDFLARE_WORKERS_AI_REASONING_STYLE=effort_required
-# The operator may declare efforts a provider's reasoning routes accept beyond Models.dev
-# (comma-separated: none, minimal, low, medium, high, xhigh, max); the daemon adds none.
+# Additional supported Cloudflare effort values, comma-separated; empty = Models.dev only.
 PLURNK_PROVIDERS_PROVIDER_CLOUDFLARE_WORKERS_AI_REASONING_EFFORTS=
-# Direct DeepSeek reasoning follows {§deepseek-reasoning-request}.
+# Direct DeepSeek thinking activation and effort.
 PLURNK_PROVIDERS_PROVIDER_DEEPSEEK_REASONING_STYLE=thinking_effort
+# Uncataloged compatible providers: SDK, endpoint, and credential-variable name.
 PLURNK_PROVIDERS_PROVIDER_BAICHUAN_NPM=@ai-sdk/openai-compatible
 PLURNK_PROVIDERS_PROVIDER_BAICHUAN_BASE_URL=https://api.baichuan-ai.com/v1
 PLURNK_PROVIDERS_PROVIDER_BAICHUAN_API_KEY_ENV=BAICHUAN_API_KEY
@@ -180,61 +114,14 @@ PLURNK_PROVIDERS_PROVIDER_QIANFAN_NPM=@ai-sdk/openai-compatible
 PLURNK_PROVIDERS_PROVIDER_QIANFAN_BASE_URL=https://qianfan.baidubce.com/v2
 PLURNK_PROVIDERS_PROVIDER_QIANFAN_API_KEY_ENV=QIANFAN_API_KEY
 
-# --- Model selectors and optional alias cascade (SPEC §5) ---
-# First path segment is the provider name; the rest is the provider-native model id (may
-# contain "/"). PLURNK_MODEL accepts that exact route or a declared alias. An
-# alias is useful when the route needs a reusable name, endpoint, or scoped tuning.
-# Operator-specific, no default - the examples are commented.
-# PLURNK_MODEL_gemma=openai/macher.gguf
-# PLURNK_MODEL_opus=anthropic/claude-opus-4-8
-# PLURNK_MODEL_sonnet=openrouter/anthropic/claude-sonnet-latest
-# PLURNK_MODEL=gemma
-# PLURNK_MODEL=google/gemini-3-flash
-#
-# PLURNK_BASEURL_<alias> - bind an endpoint to ONE alias (the only way to run N self-hosted
-# boxes of one provider: openai=llama.cpp/vLLM, ollama). WINS over the provider's *_BASE_URL;
-# a dangling override fails hard.
-# PLURNK_MODEL_HAZEL1=openai/qwen2.5-coder
-# PLURNK_BASEURL_HAZEL1=http://hazel1:8080/v1
-# PLURNK_MODEL_NOOK=ollama/qwen2.5-coder
-# PLURNK_BASEURL_NOOK=http://nook:11434
-
-# The compatible `openai` and first-party `plurnk` adapters are intentionally
-# local contracts rather than catalog declarations. OpenAI defaults to its
-# canonical endpoint; override it per alias for llama-server or vLLM.
+# --- Compatible and first-party endpoints ---
+# OpenAI-compatible fallback endpoint; PLURNK_BASEURL_<alias> overrides it for one declared alias.
 OPENAI_BASE_URL=https://api.openai.com/v1
-# PLURNK_API_KEY is an optional bearer; the endpoint is eventually keyless.
+# First-party Plurnk endpoint; authentication uses optional PLURNK_API_KEY in the operator environment.
 PLURNK_BASE_URL=https://plurnk.ai/v1
-# PLURNK_BASE_URL=http://plurnksnr2kihuukt6v22ko72r34dxeatbsfhgow3hvnlw6btanxphad.onion/v1   # Tor
 
-# --- Local floor models (commented reference; per-alias forms win over the bare knobs) ---
-# The two local models this floor is measured against. Vendor sampling guidance is from the
-# model cards; the plurnk lines are what today's runs showed matters. Uncomment per alias.
-#
-# gemma 4 (e.g. gemma-4-26B-A4B QAT on llama-server, rail plurnk.gemma.gbnf). Thinking is a
-# template switch on the openai-compatible provider, and a thinking budget must ride or the
-# model may skip its thought channel entirely (2026-08-26: empty channel, twelve-op shotgun).
-# Gemma model-card sampling: temperature 1.0, top_k 64, top_p 0.95 (top_k/top_p are server flags).
-# PLURNK_MODEL_rtxgemma=openai/<gguf name exactly as /v1/models lists it>
-# PLURNK_PROVIDERS_PROVIDER_OPENAI_REASONING_STYLE=template
-# PLURNK_PROVIDERS_GBNF_rtxgemma=plurnk.gemma.gbnf
-# PLURNK_PROVIDERS_REASONING_BUDGET_rtxgemma=4096
-# PLURNK_PROVIDERS_OUTPUT_BUDGET_rtxgemma=8192      # a runaway SEND body ends here (~40 s), not at 35% of the context
-# PLURNK_PROVIDERS_TEMPERATURE_rtxgemma=1.0
-# PLURNK_PROVIDERS_REPEAT_PENALTY_rtxgemma=1.0      # the grammar demands exact repetition; a penalty above 1.0 fights it
-#
-# qwen 3.8 (llama-server, rail plurnk.qwen.gbnf — <think> syntax; Qwen template profile #243).
-# Qwen model-card sampling, thinking mode: temperature 0.6, top_p 0.95, top_k 20, min_p 0;
-# never greedy; presence_penalty 0-2 against repetition (top_p/top_k/min_p are server flags).
-# PLURNK_MODEL_qwen38=openai/<gguf name exactly as /v1/models lists it>
-# PLURNK_PROVIDERS_PROVIDER_OPENAI_REASONING_STYLE=template
-# PLURNK_PROVIDERS_GBNF_qwen38=plurnk.qwen.gbnf
-# Reasoning disposition rides into the Qwen3.8 chat template as its own variable. The template
-# knows three rungs: xhigh (its default; 'high' is an alias) injects "consider plausible
-# alternatives" and dilates to any cap; medium injects nothing; low injects "brief and focused".
-# Measured 2026-09-01 on a packet severed at 16k under xhigh: medium decided in ~560 tokens.
-# PLURNK_PROVIDERS_REASONING_qwen38=medium
-# PLURNK_PROVIDERS_REASONING_BUDGET_qwen38=4096
-# PLURNK_PROVIDERS_OUTPUT_BUDGET_qwen38=8192
-# PLURNK_PROVIDERS_TEMPERATURE_qwen38=0.6
-# PLURNK_PROVIDERS_REPEAT_PENALTY_qwen38=1.0
+# --- OpenRouter application attribution ---
+# Public application URL; empty suppresses attribution, including the title.
+OPENROUTER_HTTP_REFERER=https://github.com/plurnk/plurnk-service
+# Application display name, sent only with a nonempty URL.
+OPENROUTER_APP_TITLE=Plurnk

package/README.md

@@ -12,7 +12,8 @@ Ordinary provider behavior is intentionally not reimplemented here:
 - PLURNK owns aliases, generation envelopes, normalized usage and errors,
   evidence capture, first-party metadata, and local endpoint capabilities.
 
-See `SPEC.md` for the contract and `.env.defaults` for every operational knob.
+See [SPEC.md](SPEC.md) for the contract, [the model guide](docs/models.md) for
+configuration relationships, and [.env.defaults](.env.defaults) for every knob.
 The package-owned `PLURNK_PROVIDERS_ERROR_DETAIL_LIMIT` bounds upstream
 diagnostic text in public provider Problems.
 

package/SPEC.md

@@ -164,9 +164,9 @@ because PLURNK grammar did not accept it.
 adapter opens one durable identity through it immediately before each physical
 I/O and settles that identity with the resulting
 `ProviderRequestAccounting`. This applies to generation retries and capacity
-failover as well as every standard embedding `doEmbed` occurrence. The
+failover. The
 observer is a durability sink, not an alternate evidence representation; the
-same ordered records remain on the final generation or embedding result or
+same ordered records remain on the final generation result or
 error.
 
 §provider-reasoning-observer When a consumer supplies `observeReasoning`, the
@@ -208,7 +208,14 @@ explicit alias-scoped response style:
 | `think-tags`    | `<think>reasoning` with no close, including a capped turn. | The complete post-open tail becomes reasoning; content is empty.                                         |
 
 Tag projection never runs when readable structured reasoning is already
-present. Streamed and buffered transports converge on this response boundary.
+present. Streamed and buffered transports use the same leading-envelope parser.
+An enabled tagged projection delivers readable deltas as content chunks arrive,
+holding only incomplete delimiter prefixes; it does not wait for the closing
+tag or response completion. An unfinished closing prefix is literal reasoning
+at EOF. Constrained template calls that retain the grammar sentence use the
+same path for `<think>\n…</think>` and `<|channel>thought\n…<channel|>`.
+Observation resets for each physical request and completed reasoning is not
+replayed. Neither the internal working copy nor its curation supplies this stream.
 When the upstream reports only combined output usage, that value remains
 `outputTokens` and its unavailable text/reasoning detail stays absent. The
 adapter never apportions tokens from character lengths.
@@ -265,6 +272,12 @@ the `reasoning.max_tokens` form — the only dial a budget_tokens-only route
 understands; a fixed policy keeps the `effort` form, and `off` suppresses the
 budget.
 
+`catalogReasoningPolicies` projects that same admission calculation from catalog
+facts and provider-wide environment declarations without constructing a model,
+requiring credentials, or performing provider I/O.
+Admission respects the installed projection: native SDK fixed efforts exclude
+`max`; the OpenRouter model-settings projection also excludes `xhigh`.
+
 Models.dev's route-specific `reasoning_options` is the capability authority for
 what the daemon offers on its own; the daemon never adds vendor behaviour absent
 from the catalog. The operator may declare efforts a provider's reasoning routes
@@ -280,17 +293,12 @@ explicit compatible adapter owns the wire projection:
 | --- | --- | --- |
 | `reasoning: false` | No reasoning request | `off` |
 | `reasoning_options: []` | Provider default | None |
-| `effort.values` | Native dynamic mechanism, otherwise strongest transportable positive value | Exact members of `low`, `medium`, and `high`; `off` only when `none` is transportable |
+| `effort.values` | Native dynamic mechanism, otherwise strongest transportable positive value | Transportable fixed members of {§reasoning-policy-wire}; `off` only when `none` is transportable |
 | `toggle` | Native or explicitly declared activation, otherwise provider default | `off` only when that transport owns the toggle wire |
 | `budget_tokens` | Does not select policy | None; an adapter may use its bounds when projecting the independent budget |
 | No catalog entry | Explicit adapter declaration | Only the declaration's exact subset |
 | Operator-declared efforts | Join the catalog's `effort.values` for that provider's reasoning routes | Their exact members, under the transport rule above |
 
-The OpenRouter adapter reads neither the generic `reasoning` call setting nor
-provider options for its request; a fixed policy and `off` are represented in
-its model settings (`reasoning: { effort }`, `off` as `none`), and `adaptive`
-sends no reasoning setting on that route.
-
 Models.dev identifies the route's controls but not a provider-specific toggle
 or budget field name. The adapter supplies that last-mile mechanism; it never
 invents a cataloged effort value.
@@ -383,25 +391,6 @@ the global provider configuration. Declared aliases retain their provenance,
 endpoint override, and alias-scoped tuning.
 `PLURNK_BASEURL_<alias>` is a per-alias endpoint override.
 
-§provider-embedding-resolution Embedding-model construction uses the same
-provider identity, endpoint precedence, credential declaration, environment
-expansion, and readiness predicate as generation-model construction. The
-public resolver returns an AI SDK `EmbeddingModelV4` plus the canonical
-provider/model identity; it does not own dimensions, token windows,
-query/document policy, or vector-space identity. Those are embedding-profile
-facts ({§mimetype-embedding-profile}).
-
-| Catalog package | Embedding adapter |
-| --- | --- |
-| AI SDK package with an embedding-model constructor | Its official embedding model. |
-| `@ai-sdk/openai-compatible` | Standard `/embeddings` model using the cataloged or declared base URL and credential. |
-| AI SDK package without embedding support | Precise unsupported-capability failure before transport. |
-
-Cloudflare, Fireworks, and a declared local OpenAI-compatible server therefore
-share one adapter family; OpenRouter uses its official SDK embedding surface.
-Provider construction performs no request and never infers model facts from a
-probe.
-
 §model-catalog-readiness **Catalog readiness and construction share one local
 configuration predicate.** For each Models.dev provider, readiness evaluates
 the same effective credential names, endpoint template coordinates, base-URL
@@ -520,12 +509,12 @@ A provider plugin:
 §provider-grammar-transport A plugin whose backend accepts a llama.cpp-style
 GBNF grammar may declare `plurnk.grammarStyle: "llamacpp"` beside its kind and
 name; the discovery records it and the adapted Provider carries the capability,
-so an operator-configured rail ({§grammar-rail-registration}) rides the wire
-exactly as on a probed llama-server. Absence or `"none"` keeps the grammar off
-the wire; any other value fails discovery loudly. The declaration is the
-plugin author's fact about their backend — a wrong declaration fails at the
-rail-truth boundary ({§rail-truth-engine-verdict}), never by degrading
-admission.
+so an operator's grammar file ({§operator-grammar}) rides the wire exactly as
+on a probed llama-server. Absence or `"none"` keeps the grammar off the wire;
+any other value fails discovery loudly. The declaration is the plugin author's
+fact about their backend; the transport evidence on each response
+({§provider-grammar-evidence}) is where a wrong declaration shows, never by
+degrading admission.
 
 PLURNK adapts the returned language model. The plugin does not implement the
 PLURNK `Provider`, read PLURNK tuning knobs, or reproduce transport policy.
@@ -628,6 +617,20 @@ normal value. Retry exhaustion is preserved as `attempts` and
 `retryExhausted`, and the resulting Problem is not marked retryable after the
 provider has consumed its automatic retry budget.
 
+§provider-failure-cause **The wrapper's cause is evidence, bounded.** The SDK
+reports every processing failure of a 2xx body with one message ("Failed to
+process successful response") and keeps what happened as `cause`. A normalized
+Problem carries that cause as a bounded classification — `cause.causeKind` is
+`transport_terminated` (the body ended under a successful status),
+`invalid_json`, `schema_invalid`, `invalid_response_data`, or `internal`, with
+the cause's error name and one bounded line of its message — so forensics can
+tell an interrupted stream from a malformed body without the kind changing:
+classification of the Problem (`providerKind`, retryability, accounting) is
+untouched by this evidence. The SDK's parse and validation messages embed the
+payload, so those two report shape (character count, the validator's issue
+line), never response text; no headers, credentials, stack frames, or body
+dumps enter any Problem. Covered by `errors.test.ts` (#593).
+
 §provider-capacity-failure A proven exact preflight overflow and an upstream
 context rejection normalize to `ProviderError(kind="capacity_exceeded")` and
 an RFC 9457 status 413. `capacityStage` is `preflight` or `upstream`; a
@@ -677,7 +680,7 @@ deadline:
 | Layer | Operator knob | Boundary | Expiry |
 | --- | --- | --- | --- |
 | Operation | `PLURNK_PROVIDERS_OPERATION_TIMEOUT` | Complete logical call, including every attempt and retry delay. | Final `deadline_exceeded` Problem at 504 with `timeoutPhase=operation`; never retried. Enforced as a race, not only the advisory signal, so a wedged transport that never observes the abort cannot hang the loop past the deadline (#505); a well-behaved transport unwinds within a short grace and settles its own attempt evidence first. |
-| Attempt | `PLURNK_PROVIDERS_FETCH_TIMEOUT` | One physical generation request, including response consumption. | Surfaced `network_failure` with `timeoutPhase=attempt`; never transport-retried (#479) — the consumer's recovery owns re-issue. Embedding requests share the same per-physical-request deadline, enforced as a race so a wedged adapter cannot hang its awaiters (#463). |
+| Attempt | `PLURNK_PROVIDERS_FETCH_TIMEOUT` | One physical generation request, including response consumption. | Surfaced `network_failure` with `timeoutPhase=attempt`; never transport-retried (#479) — the consumer's recovery owns re-issue. |
 | First content | `PLURNK_PROVIDERS_FIRST_CONTENT_TIMEOUT` | Response-stream start through first semantic model content; metadata, empty deltas, and transport activity do not satisfy it. | Surfaced `network_failure` with `timeoutPhase=first_content`; never transport-retried (#479). |
 | Stream idle | `PLURNK_PROVIDERS_STREAM_IDLE_TIMEOUT` | Silence between semantic content chunks after content begins. | Surfaced `network_failure` with `timeoutPhase=stream_idle`; never transport-retried (#479). |
 
@@ -708,6 +711,13 @@ ordinary 5xx surface on the first failure as consumer-recoverable kinds; one
 retry authority — the consumer's own provider-recovery machinery — owns
 re-issue, backoff, and park above the transport.
 
+§provider-request-rejection An HTTP 4xx rejection not classified as authorization,
+quota, capacity, grammar, rate limit, or transient transport failure is
+`request_rejected`: preserve the upstream status and detail, with `retryable: false`.
+It is not an `invalid_response`; that kind describes a malformed successful
+response. Consumers terminate a rejected request with its exact Problem rather
+than retrying unchanged input or assigning response-contract strikes.
+
 ### §provider-interrupted-attempt Provider-declared interruption
 
 A successful transport response can still declare that inference did not
@@ -726,37 +736,21 @@ completed exchange.
 ## §10 Grammar
 
 GBNF is a local llama-server capability, not a generic provider expectation.
-The consumer chooses whether to supply a grammar. The provider never creates or
-rewrites one.
-
-GBNF defines the accepted sampled text; it runs before response reasoning is
-separated from regular content. A generated rail may declare a response root
-that composes a template-provided prefix for independent evidence grading. The shipped PLURNK sentence is owned by
-`plurnk-contracts` {§gbnf-turn-shape} and {§gbnf-reasoning-boundary}; this package does
-not restate or rewrite it.
-
-When a grammar-capable adapter receives a grammar, `ProviderResponse` carries
-`grammarEvidence: { input, contentStart, transported }`. `input` is the exact
-pre-projection sentence represented by the response, `contentStart` is its
-Unicode-code-point offset to `assistant.content`, and `transported` says whether
-the grammar was actually sent. Active llama-server template reasoning requests
-the unprojected sentence, records it, and then separates its leading enclosure;
-an empty body therefore remains observable. An endpoint that projects despite
-that request supplies no independent evidence. For an unsplit response, `input`
-is `content` and `contentStart` is zero.
-
-§gbnf-forced-march **A grammar masks end-of-generation until the sentence completes — pair rails on a weak model with a recency reminder.** llama-server admits EOG only in a grammar-accepting state, so a model whose intended emission diverges from the required turn shape cannot stop: each masked substitution drifts it further from the terminal, and the request runs to the token ceiling and dies as a length cut (measured 2026-09-01, #477 — the thought budget fires and throughput is unaffected; the march is the grammar's one failure mode, and the weaker the model, the likelier the divergence that triggers it). When enabling a GBNF rail for a model that does not reliably hold the frame shape, put the shape command where recency helps — the operator's Recap footer (core `PLURNK_SERVICE_RECAP`) — for example:
-
-```text
-YOU MUST begin with `## PLAN0` and end with `### SEND0 [status code]`
-```
-
-A model that emits valid frames freehand needs neither the rail nor the reminder.
-
-§gbnf-response-observation The provider transports and represents; it does not grade its own enforcement.
-The consumer validates `grammarEvidence.input` outside the enforcer's failure
-domain. `PLURNK_PROVIDERS_GBNF_DEBUG` still validates grammar syntax before the
-call and sets `transported: false` for the unconstrained comparison.
+The consumer chooses whether to supply a grammar and reads it from the
+operator's own file; the provider never creates, ships, rewrites, validates, or
+grades one (#588). Transport is `{§provider-grammar-transport}`.
+
+§provider-grammar-evidence When a grammar-capable adapter receives a grammar,
+`ProviderResponse` carries `grammarEvidence: { input, contentStart, transported }`.
+`input` is the exact pre-projection sentence represented by the response,
+`contentStart` is its Unicode-code-point offset to `assistant.content`, and
+`transported` says whether the grammar was actually sent. Active llama-server
+template reasoning requests the unprojected sentence, records it, and then
+separates its leading enclosure; an empty body therefore remains observable. An
+endpoint that projects despite that request supplies no independent evidence.
+For an unsplit response, `input` is `content` and `contentStart` is zero. This
+is transport evidence so a digest can prove a run was constrained; nothing in
+the service issues a verdict on it.
 
 ## §11 Evidence and metadata
 
@@ -771,6 +765,19 @@ When enabled, raw per-token model logprob is canonical; alternatives are
 preserved when returned. Raw body/chunks preserve wire evidence the normalized
 record omits.
 
+§provider-usage-refusal **The provider's bookkeeping is not the exchange.** Usage
+normalization is exact and refuses counters that contradict each other (a
+reasoning detail larger than its output aggregate, a total that disagrees with
+its parts). A refusal is not a request failure: the response is delivered, its
+accounting row carries no `usage` and a cost of kind `unknown` with the reason
+(never an invented, clamped, or zero counter), and the transport record keeps
+`usageRefusal` — the normalizer's reason beside the counters exactly as the
+wire reported them — so the digest can read what the provider said. The same
+holds for the usage inside failure evidence. Before this rule a contradictory
+counter turned a complete response into a retryable `network_failure` and lost
+the response (#580). Covered by `aiSdkTransport.test.ts` and
+`AiSdkProvider.test.ts`.
+
 §provider-encrypted-reasoning **Readable reasoning and encrypted reasoning are
 separate.** Encrypted payload bytes remain opaque and are never decoded. The
 provider boundary distinguishes preserved detail evidence from derived entity

package/dist/AiSdkProvider.d.ts

@@ -54,7 +54,6 @@ export type AiSdkProviderConfig = {
     systemCacheProviderOptions?: AiSdkProviderOptions;
     reasoningResponseProviderOptions?: AiSdkProviderOptions;
     serviceTier?: string;
-    gbnfDebug?: boolean;
     streaming?: boolean;
     firstPartyMetadata?: boolean;
     apiKeyRejectedMessage?: string;

package/dist/AiSdkProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AiSdkProvider.d.ts","sourceRoot":"","sources":["../src/AiSdkProvider.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAmB,sBAAsB,EAAE,QAAQ,EAAmB,sBAAsB,EAAE,oBAAoB,EAA6B,uBAAuB,EAA6B,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjS,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,IAAI,CAAC;AACjD,OAAO,EAA2B,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAEhG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAMxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAQvF,MAAM,MAAM,aAAa,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AA0BpD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,mBAAmB,GAAG,QAAQ,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtK,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AACpF,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG,KAAK,CAAC;AAItE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/C,MAAM,MAAM,aAAa,GACnB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;AAIzF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,iBAAiB,CAAC;IACxE,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0BAA0B,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAIxD,iBAAiB,CAAC,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;IAE/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAI1B,2BAA2B,CAAC,EAAE,yBAAyB,GAAG,kBAAkB,CAAC;IAC7E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gCAAgC,CAAC,EAAE,oBAAoB,CAAC;IAKxD,yBAAyB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzI,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,KAAK,YAAY,CAAC;IAClE,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAG5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAG9B,0BAA0B,CAAC,EAAE,oBAAoB,CAAC;IAGlD,gCAAgC,CAAC,EAAE,oBAAoB,CAAC;IAGxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAI1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,eAAe,CAAC,EAAE,MAAM,CAAC;IAKzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAM/B,SAAS,EAAE,SAAS,CAAC;IAOrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAK7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,aAAa,EAAE,MAAM,CAAC;IAItB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAQ1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAUlB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AA0GF,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,QAAQ;;IA0DlD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,iBAAiB,CAAC;IAMjF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C,YAAY,MAAM,EAAE,mBAAmB,EAqKtC;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAAgC;IAClE,IAAI,eAAe,IAAI,WAAW,CAAC,aAAa,CAAC,CAAkC;IACnF,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAAiC;IACpE,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAAkC;IACtE,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAA+B;IAChE,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAAkC;IACtE,IAAI,0BAA0B,IAAI,SAAS,eAAe,EAAE,CAA6C;IACzG,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAMjC;IACD,IAAI,KAAK,IAAI,MAAM,CAAwB;IAE3C,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAA8B;IAEnE,IAAI,oBAAoB,IAAI,OAAO,GAAG,SAAS,CAAuC;IAItF,IAAI,gBAAgB,IAAI,OAAO,CAA0C;IAEnE,iBAAiB,CACnB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,sBAAsB,CAAC,CAqDjC;IAEK,qBAAqB,CACvB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,uBAAuB,CAAC,CAmBlC;IA4BK,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAscvP;CAEJ"}
+{"version":3,"file":"AiSdkProvider.d.ts","sourceRoot":"","sources":["../src/AiSdkProvider.ts"],"names":[],"mappings":"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"}