@genesislcap/foundation-ai 15.3.2 → 15.3.3-alpha-4899ddd.0

package/dist/foundation-ai.api.json

@@ -2312,6 +2312,346 @@
             }
           ]
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!BUDGETED_VENDORS:var",
+          "docComment": "/**\n * The vendors whose spend the ai-service proxy meters — i.e. the only vendors that can raise a {@link BudgetExhaustedError}, and therefore the only ones a 402's `otherVendorAvailable: false` is a statement about.\n *\n * Deliberately narrower than the keys of {@link VENDOR_LABELS}, and it must stay exactly the proxy's own list — `VENDORS` in ai-service's `utils/aiVendor.js`. A vendor listed here that the proxy does not meter gets walled by the `otherVendorAvailable: false` sweep on a verdict that says nothing about it, and if it is reachable, `blocked` then derives true and locks a composer with headroom left.\n *\n * Two vendors are excluded for that reason: - `chrome` runs on-device — no pot to exhaust, and free. - `openai` is **not budgeted by the proxy**. ai-service rejects it up front with `400 UNSUPPORTED_PROVIDER` (`SUPPORTED_PROVIDERS` in `aiVendor.js`), no `MODEL_PRICING` row names it, and `otherVendorAvailable` is computed over Anthropic and Gemini alone. So it can never raise a 402, and a 402 is never a statement about it.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "BUDGETED_VENDORS: "
+            },
+            {
+              "kind": "Content",
+              "text": "readonly "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderType",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "BUDGETED_VENDORS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
+        {
+          "kind": "Class",
+          "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError:class",
+          "docComment": "/**\n * Thrown when the AI-spend budget for the caller (user, tenant, or project) is exhausted and the ai-service proxy refuses the request outright — HTTP `402` with `code: 'BUDGET_EXCEEDED'`, in either the legacy JSON or the NDJSON framed mode.\n *\n * This is a **terminal, non-transient** condition, in the same family as `ResponseTruncatedError`: no amount of retrying clears it, because nothing about the request is wrong. The budget has to be raised out-of-band before any further call can succeed, so both the transport retry ladder and the driver's transient-retry catch step aside for it and the failure surfaces immediately as the `'budget-exhausted'` `TurnFailureReason`.\n *\n * `budgetUsd`/`spentUsd` are populated from the rejection body when the proxy supplies them (the workstream-C contract does); they are optional because a plain-text or truncated 402 from an older proxy still has to classify.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class BudgetExhaustedError extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "Error",
+              "canonicalReference": "!Error:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "releaseTag": "Beta",
+          "isAbstract": false,
+          "name": "BudgetExhaustedError",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `BudgetExhaustedError` class\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "constructor(\n    vendorLabel: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", \n    budgetUsd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", \n    spentUsd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", \n    detail?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", \n    extra?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        otherVendorAvailable?: boolean;\n        serverVendor?: string;\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vendorLabel",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "budgetUsd",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "spentUsd",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "detail",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 7,
+                    "endIndex": 8
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "extra",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 9,
+                    "endIndex": 10
+                  },
+                  "isOptional": true
+                }
+              ]
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#budgetUsd:member",
+              "docComment": "/**\n * The configured spend cap in USD, when the proxy reported one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly budgetUsd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "budgetUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#detail:member",
+              "docComment": "/**\n * The proxy's human-readable rejection message, when present.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly detail?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "detail",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#otherVendorAvailable:member",
+              "docComment": "/**\n * The proxy's own verdict on whether **any other** vendor it meters still has headroom, from the 402's `otherVendorAvailable`.\n *\n * The one field on this error a client cannot re-derive. A client can only infer \"another vendor is free\" from registry membership — which knows nothing about that vendor's remaining spend — so a `false` here is the only thing standing between the user and \"Switch to Gemini to keep going\" for a Gemini pot that is already empty. `undefined` means the proxy did not say (an older build), and the client is back to inferring.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly otherVendorAvailable?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "otherVendorAvailable",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#serverVendor:member",
+              "docComment": "/**\n * The vendor the **proxy** says it refused, verbatim from the 402's `vendor`.\n *\n * A second opinion, not the first: {@link BudgetExhaustedError.vendorLabel} comes from the transport that was actually called and wins wherever it resolves. This one rescues attribution when the transport's label does not — a white-labelled or multiplexing gateway whose single transport fronts more than one upstream stamps one static label for all of them, and only the proxy knows which pot the request was actually booked against.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly serverVendor?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "serverVendor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#spentUsd:member",
+              "docComment": "/**\n * Spend already booked against that cap in USD, when the proxy reported it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly spentUsd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "spentUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#vendorLabel:member",
+              "docComment": "/**\n * Vendor label of the transport that was refused (e.g. `'Anthropic'`).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly vendorLabel: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "vendorLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            }
+          ],
+          "extendsTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "implementsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!CachePolicy:type",
@@ -3147,7 +3487,16 @@
             },
             {
               "kind": "Content",
-              "text": ";\n} | {\n    reason: 'agent-handoff';\n    summary: string;\n    remainingTask: string;\n}"
+              "text": ";\n    budget?: {\n        budgetUsd?: number;\n        spentUsd?: number;\n        vendorLabel: string;\n        vendor?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderType",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
+            },
+            {
+              "kind": "Content",
+              "text": ";\n        otherVendorAvailable?: boolean;\n    };\n} | {\n    reason: 'agent-handoff';\n    summary: string;\n    remainingTask: string;\n}"
             },
             {
               "kind": "Content",
@@ -3159,7 +3508,7 @@
           "name": "ChatDriverResult",
           "typeTokenRange": {
             "startIndex": 1,
-            "endIndex": 4
+            "endIndex": 6
           }
         },
         {
@@ -6430,6 +6779,33 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!DEFAULT_BUDGET_EXHAUSTED_MESSAGE:var",
+          "docComment": "/**\n * The single copy shown to a user whose AI budget is gone — the transcript bubble the chat driver appends, and the default text of the assistant's blocked banner.\n *\n * Deliberately **vendor-neutral**: the same bundle ships to white-labelled deployments where \"contact Genesis\" is simply wrong. A host that wants branded wording overrides both surfaces — the banner via `FoundationAiAssistant.setBlocked(true, reason)`, the transcript bubble via `ChatDriverConfig.budgetExhaustedMessage` — so neither is stuck with this default while the other is customised.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "DEFAULT_BUDGET_EXHAUSTED_MESSAGE = "
+            },
+            {
+              "kind": "Content",
+              "text": "\"You've reached your AI usage limit. Contact your administrator to raise it.\""
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "DEFAULT_BUDGET_EXHAUSTED_MESSAGE",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!FieldLike:type",
@@ -7677,6 +8053,52 @@
           "parameters": [],
           "name": "isAIFeatureEnabled"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ai!isBudgetedVendor:function(1)",
+          "docComment": "/**\n * Whether this vendor's spend is metered by the proxy — see {@link BUDGETED_VENDORS}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "isBudgetedVendor: (vendor: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderType",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
+            },
+            {
+              "kind": "Content",
+              "text": " | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 4,
+            "endIndex": 5
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "vendor",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isBudgetedVendor"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-ai!isChatToolCallUnknown:function(1)",
@@ -9492,7 +9914,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!SubAgentFailureReason:type",
-          "docComment": "/**\n * Why a sub-agent run ended without producing a structured result via `completeSubAgent`. Surfaced on the `{ ok: false }` branch of `requestSubAgent` so the parent tool handler can decide how to recover.\n *\n * - `max_iterations` — the sub-agent's tool loop ended without calling its completion tool (hit the iteration cap, or — defensively — a provider ignored forced tool use and returned a free-text turn). - `malformed_tool_call` — the provider repeatedly returned an unparseable tool call (e.g. Gemini `MALFORMED_FUNCTION_CALL`) after retries. - `empty_response` — the model repeatedly returned an empty response after retries. - `unknown_tool_limit` — the model repeatedly called tools that aren't available to it. - `timeout` — the sub-agent did not finish within {@link SubAgentRequestOptions.timeoutMs} (its run was aborted), or a transport request timed out inside the child's own run. - `response_truncated` — a turn stopped at the provider's output-token cap with an incomplete tool call; deterministic, so it is not retried. - `refusal` — a safety-classifier decline (e.g. Fable 5 `stop_reason: 'refusal'`), which returns empty content; deterministic, so it is not retried.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Why a sub-agent run ended without producing a structured result via `completeSubAgent`. Surfaced on the `{ ok: false }` branch of `requestSubAgent` so the parent tool handler can decide how to recover.\n *\n * - `max_iterations` — the sub-agent's tool loop ended without calling its completion tool (hit the iteration cap, or — defensively — a provider ignored forced tool use and returned a free-text turn). - `malformed_tool_call` — the provider repeatedly returned an unparseable tool call (e.g. Gemini `MALFORMED_FUNCTION_CALL`) after retries. - `empty_response` — the model repeatedly returned an empty response after retries. - `unknown_tool_limit` — the model repeatedly called tools that aren't available to it. - `timeout` — the sub-agent did not finish within {@link SubAgentRequestOptions.timeoutMs} (its run was aborted), or a transport request timed out inside the child's own run. - `response_truncated` — a turn stopped at the provider's output-token cap with an incomplete tool call; deterministic, so it is not retried. - `refusal` — a safety-classifier decline (e.g. Fable 5 `stop_reason: 'refusal'`), which returns empty content; deterministic, so it is not retried. - `budget_exhausted` — the AI-spend budget is used up and the proxy refused the request (HTTP 402). **Terminal for the parent too, and enforced**: the parent driver ends its own turn as soon as this outcome comes back, instead of appending it as a tool result and calling the model again into the same wall. So a handler that receives it will not be called a second time this turn, and the parent turn reports `'budget-exhausted'` in its own right.\n *\n * Recovery guidance differs sharply by reason — see `docs/sub_agent.md`. Only `budget_exhausted` and `refusal` are terminal; retrying either just reproduces it. The rest are worth a retry or a question to the user.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9500,7 +9922,7 @@
             },
             {
               "kind": "Content",
-              "text": "'max_iterations' | 'malformed_tool_call' | 'empty_response' | 'unknown_tool_limit' | 'timeout' | 'response_truncated' | 'refusal'"
+              "text": "'max_iterations' | 'malformed_tool_call' | 'empty_response' | 'unknown_tool_limit' | 'timeout' | 'response_truncated' | 'refusal' | 'budget_exhausted'"
             },
             {
               "kind": "Content",
@@ -9741,7 +10163,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!TurnFailureReason:type",
-          "docComment": "/**\n * Why a driver turn ended in failure — the typed taxonomy the tool loop already records onto its debug-log timeline (`turn.error` / `turn.retry` details), surfaced here so callers of a turn can read the outcome structurally instead of scraping prose. Distinct from {@link SubAgentFailureReason} (underscored, its own `timeout` member) because the two enums serialise into different log surfaces and READMEs; a transport request timeout on the main turn is recorded as `exception`.\n *\n * - `exception` — an uncaught error escaped the tool loop (catch-all, includes a transport request timeout). - `malformed-function-call` — the provider returned an unparseable tool call. - `empty-response` — the model returned no content and no tool calls. - `unknown-tool-limit` — the model repeatedly called tools it couldn't dispatch, whether hallucinated or stale (real earlier, retired now). - `max-iterations` — the tool loop hit its iteration cap. - `response-truncated` — a turn stopped at the provider's output-token cap with an incomplete tool call; deterministic, so it bails without retry. - `refusal` — a safety-classifier decline (e.g. Fable 5 `stop_reason: 'refusal'`), which returns empty content; deterministic, so it is not retried.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Why a driver turn ended in failure — the typed taxonomy the tool loop already records onto its debug-log timeline (`turn.error` / `turn.retry` details), surfaced here so callers of a turn can read the outcome structurally instead of scraping prose. Distinct from {@link SubAgentFailureReason} (underscored, its own `timeout` member) because the two enums serialise into different log surfaces and READMEs; a transport request timeout on the main turn is recorded as `exception`.\n *\n * - `exception` — an uncaught error escaped the tool loop (catch-all, includes a transport request timeout). - `malformed-function-call` — the provider returned an unparseable tool call. - `empty-response` — the model returned no content and no tool calls. - `unknown-tool-limit` — the model repeatedly called tools it couldn't dispatch, whether hallucinated or stale (real earlier, retired now). - `max-iterations` — the tool loop hit its iteration cap. - `response-truncated` — a turn stopped at the provider's output-token cap with an incomplete tool call; deterministic, so it bails without retry. - `refusal` — a safety-classifier decline (e.g. Fable 5 `stop_reason: 'refusal'`), which returns empty content; deterministic, so it is not retried. - `budget-exhausted` — the AI-spend budget is used up and the proxy refused the request (`BudgetExhaustedError`, HTTP 402). Terminal, not retried: the budget must be raised out-of-band before any call can succeed.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9749,7 +10171,7 @@
             },
             {
               "kind": "Content",
-              "text": "'exception' | 'malformed-function-call' | 'empty-response' | 'unknown-tool-limit' | 'max-iterations' | 'response-truncated' | 'refusal'"
+              "text": "'exception' | 'malformed-function-call' | 'empty-response' | 'unknown-tool-limit' | 'max-iterations' | 'response-truncated' | 'refusal' | 'budget-exhausted'"
             },
             {
               "kind": "Content",
@@ -9763,6 +10185,111 @@
             "startIndex": 1,
             "endIndex": 2
           }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!VENDOR_LABELS:var",
+          "docComment": "/**\n * Display name for each concrete AI vendor: the **single source** every transport's `vendorLabel` is read from, and the only place a vendor's name is spelled for a user.\n *\n * This map is the hinge of the per-vendor budget model (GENC-1464). A wall is attributed to a vendor by reverse-looking-up the label the refused transport stamped on its {@link BudgetExhaustedError} — so a label that drifts from this map (a literal typo, a casing change, a new vendor added with a hardcoded string) silently degrades every wall from that transport to \"unattributable\" and re-locks the whole session instead of just that vendor. It fails safe, but the feature quietly stops working, which is why the transports read their label from here rather than restating it.\n *\n * The map has **two kinds of entry**, and the difference matters:\n *\n * - The {@link BUDGETED_VENDORS} — `anthropic` and `gemini` — reach the model through the ai-service proxy, are metered by it, and stamp their label on a {@link BudgetExhaustedError}. For these the label is both an attribution key and display copy. - `chrome` and `openai` are **display-only**. `ChromeProvider` talks to the on-device Prompt API and the proxy refuses `openai` outright, so neither can be refused for budget or stamp a label — but both report a `provider` from `getStatus()`, which puts them in the assistant's reachable set, which is what the blocked banner names when it tells a walled user where they can still go (\"Switch to Chrome to keep going.\"). Dropping either entry would print the raw type there.\n *\n * `'none'` is excluded deliberately: it is the \"no provider configured\" sentinel, not a vendor, and nothing can be refused by it — nor switched to.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "VENDOR_LABELS: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Readonly",
+              "canonicalReference": "!Readonly:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Record",
+              "canonicalReference": "!Record:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "Exclude",
+              "canonicalReference": "!Exclude:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderType",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
+            },
+            {
+              "kind": "Content",
+              "text": ", 'none'>, string>>"
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "VENDOR_LABELS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 9
+          }
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ai!vendorTypeOfLabel:function(1)",
+          "docComment": "/**\n * The {@link AIProviderType} behind a vendor label, or `undefined` for a label no vendor claims.\n *\n * Case-insensitive and whitespace-tolerant, because the label travels as free text on the wire (the driver contract carries `vendorLabel`, not the type) and an unrecognised label must degrade to \"unattributable\" rather than to a wrong attribution — blocking the wrong vendor is worse than blocking none.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function vendorTypeOfLabel(label?: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderType",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
+            },
+            {
+              "kind": "Content",
+              "text": " | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/transports/budget-exhausted-error.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 5
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "label",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "vendorTypeOfLabel"
         }
       ]
     }