@genesislcap/foundation-ai 15.33.1 → 15.34.0

package/dist/dts/index.d.ts

@@ -10,6 +10,10 @@ export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini
 export { DEFAULT_PROVIDER_REFUSED_MESSAGE, PROVIDER_REFUSED_CODE, ProviderRefusedError, } from './transports/provider-refused';
 export type { ProviderRefusalKind } from './transports/provider-refused';
 export { ContextOverflowError, contextOverflowOf, DEFAULT_CONTEXT_OVERFLOW_MESSAGE, } from './transports/context-overflow-error';
+export { AI_TIER_IDS, AI_TIER_VENDORS, DEFAULT_AI_TIERS, resolveAITiers } from './tiers/ai-tiers';
+export type { AITierId, AITierOverrides, AITiers, AITierVendor, AnthropicTierConfig, GeminiTierConfig, } from './tiers/ai-tiers';
+export { buildTierProviders } from './tiers/build-tier-providers';
+export type { BuildTierProvidersOptions } from './tiers/build-tier-providers';
 export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
 export { ChatTemperature } from './utils/temperature';
 export { ANTHROPIC_CACHE_READ_MULTIPLIER, ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER, ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER, anthropicRatesFor, anthropicTokenCost, GEMINI_CACHED_INPUT_MULTIPLIER, GEMINI_LONG_CONTEXT_THRESHOLD, geminiRatesFor, geminiTokenCost, } from './utils/token-cost';

package/dist/dts/index.d.ts.map

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

package/dist/dts/tiers/ai-tiers.d.ts

@@ -0,0 +1,154 @@
+import type { AnthropicModelId, GeminiModelId } from '../types';
+/**
+ * The platform's tier → model table (GENC-1610).
+ *
+ * @remarks
+ * Pure data, and deliberately so: this module imports nothing but types, never
+ * `ai-provider-di` (the one `@microsoft/fast-foundation` importer) and never
+ * `@genesislcap/web-core`, so it loads in bare Node. It is re-exported by name from
+ * `@genesislcap/ai-assistant/chat-driver`, which a server-side host requires at runtime —
+ * an `export *` or a DOM import anywhere in its closure crashes that host at require time.
+ * Provider construction lives next door in `build-tier-providers.ts`, which is browser-only.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Every tier id, in ascending capability order.
+ *
+ * This array is the source of truth and {@link AITierId} is derived from it, so the two cannot
+ * drift: a tier exists exactly when it is listed here. That matters because the provider
+ * builders and the table's tests all loop over this array — a tier missing from it would get
+ * no provider and no test, with nothing to say so.
+ *
+ * @beta
+ */
+export declare const AI_TIER_IDS: readonly ["low", "high", "reasoning"];
+/**
+ * The tier a caller asks for, rather than a model id.
+ *
+ * Tier-shaped names are what let an app swap vendor (or re-bench a tier onto a
+ * newer model) without touching a single agent config — agents resolve `'high'`,
+ * not `claude-sonnet-5`. Derived from {@link AI_TIER_IDS}.
+ *
+ * @beta
+ */
+export type AITierId = (typeof AI_TIER_IDS)[number];
+/**
+ * Every vendor in the table — the two the platform's proxy meters. The source of truth for
+ * {@link AITierVendor}, for the same reason as {@link AI_TIER_IDS}.
+ *
+ * @beta
+ */
+export declare const AI_TIER_VENDORS: readonly ["anthropic", "gemini"];
+/**
+ * The cloud vendors the tier table covers. Derived from {@link AI_TIER_VENDORS}.
+ *
+ * @beta
+ */
+export type AITierVendor = (typeof AI_TIER_VENDORS)[number];
+/**
+ * What one tier is worth on Anthropic: the model, its output ceiling, and the two clocks.
+ *
+ * @beta
+ */
+export interface AnthropicTierConfig {
+    model: AnthropicModelId;
+    /**
+     * `max_tokens` for every request on this tier. Part of the tier, not an optional
+     * extra: Anthropic requires the field and the transport defaults it to 4096, which
+     * truncates a large single-call file write mid-stream (`stop_reason: max_tokens`)
+     * and leaves the tool input unparseable. Values sit inside each model's documented
+     * output ceiling.
+     */
+    maxTokens: number;
+    /** Inactivity window on a stream that has started. */
+    stallTimeoutMs: number;
+    /** Ceiling on the wait for the FIRST byte — a different clock from the stall one. */
+    timeoutMs: number;
+}
+/**
+ * What one tier is worth on Gemini.
+ *
+ * No `maxTokens`: `GeminiAIConfig` has no such field and the provider's own (much
+ * larger) default applies, so Gemini writes never hit the Anthropic wall above.
+ *
+ * @beta
+ */
+export interface GeminiTierConfig {
+    model: GeminiModelId;
+    /** Inactivity window on a stream that has started. */
+    stallTimeoutMs: number;
+    /** Ceiling on the wait for the FIRST byte — a different clock from the stall one. */
+    timeoutMs: number;
+}
+/**
+ * The whole table: every tier, for every vendor.
+ *
+ * Total records, not partials — a tier a vendor cannot serve is not a tier, it is a
+ * gap that only shows up when an agent resolves it at runtime.
+ *
+ * @beta
+ */
+export interface AITiers {
+    anthropic: Record<AITierId, AnthropicTierConfig>;
+    gemini: Record<AITierId, GeminiTierConfig>;
+}
+/**
+ * The platform's default tier table.
+ *
+ * @remarks
+ * Frozen, because it is shared by every app in the process: {@link resolveAITiers} returns
+ * a fresh object for callers that override, and hands this back untouched for callers that
+ * do not.
+ *
+ * The models are the ones Genesis Create has been running these tiers on in production — except
+ * Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a
+ * **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini
+ * defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates
+ * are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that
+ * doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced),
+ * and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it
+ * saying the High tier is the thing to re-bench.
+ *
+ * Every model here must be in `SUPPORTED_*_MODEL_IDS` with a context limit and a price —
+ * pinned by tests, because an unpriced model silently bills at nothing.
+ *
+ * @beta
+ */
+export declare const DEFAULT_AI_TIERS: AITiers;
+/**
+ * Per-tier overrides, shallow-merged field by field over the defaults.
+ *
+ * @beta
+ */
+export interface AITierOverrides {
+    anthropic?: Partial<Record<AITierId, Partial<AnthropicTierConfig>>>;
+    gemini?: Partial<Record<AITierId, Partial<GeminiTierConfig>>>;
+}
+/**
+ * The table an app should actually use: {@link DEFAULT_AI_TIERS} with `overrides` applied
+ * per field, so an app that wants one model moved says only that and keeps the platform's
+ * clocks and ceilings.
+ *
+ * @remarks
+ * An override field set to `undefined` is skipped, exactly as if it had been left out. The
+ * common caller passes an optional config value straight through
+ * (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would
+ * hand the transport no model at all — it then quietly falls back to its own default, with
+ * nothing logged.
+ *
+ * The result is frozen whether or not anything was overridden, so whether mutating it throws
+ * does not depend on what the caller passed. The default itself is returned untouched when
+ * there is nothing to override, and is never mutated, which matters because it is shared
+ * across every app in the process.
+ *
+ * @example
+ * ```ts
+ * // Keep everything, but run the reasoning tier on Fable.
+ * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });
+ * ```
+ *
+ * @beta
+ */
+export declare function resolveAITiers(overrides?: AITierOverrides): AITiers;
+//# sourceMappingURL=ai-tiers.d.ts.map

package/dist/dts/tiers/ai-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tiers.d.ts","sourceRoot":"","sources":["../../../src/tiers/ai-tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,uCAAwC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAsBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAsD7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAMnE"}

package/dist/dts/tiers/build-tier-providers.d.ts

@@ -0,0 +1,67 @@
+import { type AIProvider } from '../ai-provider';
+import type { AnthropicAIConfig, GeminiAIConfig } from '../types';
+import { type AITierId, type AITiers, type AITierVendor } from './ai-tiers';
+/**
+ * Turns the tier table into live providers (GENC-1610).
+ *
+ * @remarks
+ * Split from `ai-tiers.ts` because this half is **browser-only**: `createAIProvider` checks
+ * the AI feature flag, which reads `window.location`. The table is what a Node host needs
+ * (model ids and pricing); provider construction is not, so only the table is re-exported
+ * from the `@genesislcap/ai-assistant/chat-driver` Node entry.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Options for {@link buildTierProviders}.
+ *
+ * @beta
+ */
+export interface BuildTierProvidersOptions {
+    /** Which vendor's models to build. */
+    vendor: AITierVendor;
+    /**
+     * The proxy endpoint every tier posts to — a string, or a function of the vendor for a
+     * caller that builds more than one vendor from one rule (see the example below).
+     *
+     * Always a server endpoint, never an API key: these providers are meant for an app whose
+     * keys stay on its server. An empty endpoint throws here rather than at the first turn.
+     */
+    serverEndpoint: string | ((vendor: AITierVendor) => string);
+    /** The table to build from. Defaults to {@link DEFAULT_AI_TIERS}. */
+    tiers?: AITiers;
+}
+/**
+ * Builds one {@link AIProvider} per tier for a vendor, ready to register under the tier
+ * names agents resolve (`low` / `high` / `reasoning`).
+ *
+ * @remarks
+ * Each provider carries its tier's model, output ceiling (Anthropic) and both clocks, so no
+ * tier can silently fall back to the transport defaults — which is how a large tool write
+ * ends up truncated at 4096 tokens.
+ *
+ * @example
+ * ```ts
+ * registerAIProviders(
+ *   container,
+ *   buildTierProviders({ vendor: 'gemini', serverEndpoint: (v) => `/gwf/ai-service/${v}/chat` }),
+ *   { default: 'high' },
+ * );
+ * ```
+ *
+ * @beta
+ */
+export declare function buildTierProviders(options: BuildTierProvidersOptions): Record<AITierId, AIProvider>;
+/**
+ * The provider configs {@link buildTierProviders} builds from, before they reach
+ * `createAIProvider`.
+ *
+ * A seam rather than an inline literal, because what is being asserted is exactly what a
+ * constructed provider hides: a transport keeps `maxTokens` and both clocks private, so a
+ * tier silently falling back to the 4096-token default would be invisible from the outside
+ * — which is the failure this table exists to prevent.
+ *
+ * @internal
+ */
+export declare function tierProviderConfigs(options: BuildTierProvidersOptions): Record<AITierId, AnthropicAIConfig | GeminiAIConfig>;
+//# sourceMappingURL=build-tier-providers.d.ts.map

package/dist/dts/tiers/build-tier-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tier-providers.d.ts","sourceRoot":"","sources":["../../../src/tiers/build-tier-providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC;IAC5D,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAO9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,yBAAyB,GACjC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,GAAG,cAAc,CAAC,CAkCtD"}

package/dist/dts/utils/token-cost.d.ts

@@ -144,6 +144,20 @@ export declare const GEMINI_LONG_CONTEXT_THRESHOLD = 200000;
  * @beta
  */
 export declare const GEMINI_CACHED_INPUT_MULTIPLIER = 0.1;
+/**
+ * The day `gemini-3.8-flash` leaves its introductory rate (see `GEMINI_PRICING` below).
+ *
+ * A constant rather than a literal in the test that enforces it, because a SECOND dated
+ * assertion now hangs off the same day: the High tier picked that model while it was the
+ * cheaper one, so the flip is also the trigger to re-bench the tier (`tiers/ai-tiers.test.ts`).
+ * Two hand-copied dates would drift the moment either is corrected, and a re-bench reminder
+ * that fires on the wrong day is no reminder at all.
+ *
+ * Not part of the package's public surface — it exists for those two tests.
+ *
+ * @internal
+ */
+export declare const GEMINI_3_8_FLASH_INTRO_RATE_ENDS: number;
 /**
  * Resolve the per-million-token rates for a model given the request's prompt size,
  * selecting the long-context tier for tiered models when the prompt exceeds

package/dist/dts/utils/token-cost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-cost.d.ts","sourceRoot":"","sources":["../../../src/utils/token-cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkDhE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;CACtB;AAiCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAErE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,YAAY;AACZ,eAAO,MAAM,mCAAmC,OAAO,CAAC;AACxD,YAAY;AACZ,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,oBAAoB,GAC1B,SAAS,CAiCX;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAsDlD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,CAMrF;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAuBzF"}
+{"version":3,"file":"token-cost.d.ts","sourceRoot":"","sources":["../../../src/utils/token-cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkDhE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;CACtB;AAiCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAErE;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,YAAY;AACZ,eAAO,MAAM,mCAAmC,OAAO,CAAC;AACxD,YAAY;AACZ,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;;;OASG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,oBAAoB,GAC1B,SAAS,CAiCX;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAErD;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,QAAqC,CAAC;AAsDnF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU,CAMrF;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAuBzF"}

package/dist/esm/index.js

@@ -15,6 +15,13 @@ export { GeminiTransport, MalformedFunctionCallError } from './transports/gemini
 // first reword.
 export { DEFAULT_PROVIDER_REFUSED_MESSAGE, PROVIDER_REFUSED_CODE, ProviderRefusedError, } from './transports/provider-refused';
 export { ContextOverflowError, contextOverflowOf, DEFAULT_CONTEXT_OVERFLOW_MESSAGE, } from './transports/context-overflow-error';
+// The platform tier table (GENC-1610) — what a `low` / `high` / `reasoning` slot resolves to
+// per vendor, including the Anthropic output ceiling and both timeout clocks. Named exports,
+// and the data half is deliberately free of DOM and DI imports so it also rides the
+// `@genesislcap/ai-assistant/chat-driver` Node bundle; `buildTierProviders` does NOT, because
+// it constructs providers through the feature-flag gate (see `tiers/build-tier-providers.ts`).
+export { AI_TIER_IDS, AI_TIER_VENDORS, DEFAULT_AI_TIERS, resolveAITiers } from './tiers/ai-tiers';
+export { buildTierProviders } from './tiers/build-tier-providers';
 export { AI_FEATURE_FLAG, isAIFeatureEnabled } from './utils/feature-flags';
 export { ChatTemperature } from './utils/temperature';
 // Request pricing. Exported so a host that prices its own calls — a server proxy, a usage ledger,

package/dist/esm/tiers/ai-tiers.js

@@ -0,0 +1,173 @@
+/**
+ * The platform's tier → model table (GENC-1610).
+ *
+ * @remarks
+ * Pure data, and deliberately so: this module imports nothing but types, never
+ * `ai-provider-di` (the one `@microsoft/fast-foundation` importer) and never
+ * `@genesislcap/web-core`, so it loads in bare Node. It is re-exported by name from
+ * `@genesislcap/ai-assistant/chat-driver`, which a server-side host requires at runtime —
+ * an `export *` or a DOM import anywhere in its closure crashes that host at require time.
+ * Provider construction lives next door in `build-tier-providers.ts`, which is browser-only.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Every tier id, in ascending capability order.
+ *
+ * This array is the source of truth and {@link AITierId} is derived from it, so the two cannot
+ * drift: a tier exists exactly when it is listed here. That matters because the provider
+ * builders and the table's tests all loop over this array — a tier missing from it would get
+ * no provider and no test, with nothing to say so.
+ *
+ * @beta
+ */
+export const AI_TIER_IDS = ['low', 'high', 'reasoning'];
+/**
+ * Every vendor in the table — the two the platform's proxy meters. The source of truth for
+ * {@link AITierVendor}, for the same reason as {@link AI_TIER_IDS}.
+ *
+ * @beta
+ */
+export const AI_TIER_VENDORS = ['anthropic', 'gemini'];
+/**
+ * 60s inactivity backstop on a stream that has already started.
+ *
+ * `foundation-ai` defaults this to 30s, which is TIGHTER than the platform proxy's own
+ * 45s mid-stream watchdog — so the client won every race and aborted the request before
+ * the server could notice, classify or log the stall. A stall is not retried; it surfaces
+ * as a dead turn. 60s puts the proxy back in charge of detecting upstream stalls.
+ */
+const AI_STALL_TIMEOUT_MS = 60000;
+/**
+ * 300s ceiling on the wait for the first byte — nothing has arrived yet.
+ *
+ * Distinct from {@link AI_STALL_TIMEOUT_MS}, which is only armed once the body starts.
+ * It stays generous because on the legacy (unframed) proxy path the response is buffered,
+ * so the first byte only lands when generation is complete; a tight value there would cap
+ * total generation time. Set explicitly rather than inherited, so it is a decision on the record.
+ */
+const AI_NO_RESPONSE_TIMEOUT_MS = 300000;
+/**
+ * The platform's default tier table.
+ *
+ * @remarks
+ * Frozen, because it is shared by every app in the process: {@link resolveAITiers} returns
+ * a fresh object for callers that override, and hands this back untouched for callers that
+ * do not.
+ *
+ * The models are the ones Genesis Create has been running these tiers on in production — except
+ * Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a
+ * **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini
+ * defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates
+ * are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that
+ * doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced),
+ * and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it
+ * saying the High tier is the thing to re-bench.
+ *
+ * Every model here must be in `SUPPORTED_*_MODEL_IDS` with a context limit and a price —
+ * pinned by tests, because an unpriced model silently bills at nothing.
+ *
+ * @beta
+ */
+export const DEFAULT_AI_TIERS = Object.freeze({
+    anthropic: Object.freeze({
+        low: Object.freeze({
+            model: 'claude-haiku-4-5-20251001',
+            maxTokens: 16000,
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+        // The heavy tier: whole-file writes, and adaptive thinking out of the same budget
+        // wherever a caller leaves thinking on — hence Sonnet 5's full 128K ceiling rather
+        // than a figure that only fits one of the two.
+        high: Object.freeze({
+            model: 'claude-sonnet-5',
+            maxTokens: 128000,
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+        // One-shot judgement calls rather than tool loops, so a smaller ceiling is ample:
+        // `max_tokens` is only a cap, and this tier never emits a whole file.
+        //
+        // Opus 4.8 rather than the 4.7 Create benched: the same price ($5 / $25) and the same 1M
+        // window, but 4.8 supports native structured output where 4.7 takes the forced-tool
+        // fallback — and structured judgement is what this tier is asked for most (review of #2540).
+        reasoning: Object.freeze({
+            model: 'claude-opus-4-8',
+            maxTokens: 32000,
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+    }),
+    gemini: Object.freeze({
+        low: Object.freeze({
+            model: 'gemini-3.1-flash-lite',
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+        // On an INTRODUCTORY rate that doubles to $1.50 / $7.50 on 2027-01-01, from which point it
+        // is dearer on input than the gemini-3.5-flash it replaced. Chosen at the introductory rate
+        // knowingly; `ai-tiers.test.ts` fails that day to force the re-bench.
+        high: Object.freeze({
+            model: 'gemini-3.8-flash',
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+        // A PREVIEW model: no stability guarantee, and it may be withdrawn at short notice (its
+        // transport warns on every construction). Accepted knowingly as the platform default because
+        // no stable Gemini Pro was on offer when the tiers were benched; revisit as soon as Google
+        // promotes, deprecates or withdraws it, since every app on this default inherits the risk.
+        reasoning: Object.freeze({
+            model: 'gemini-3.1-pro-preview',
+            stallTimeoutMs: AI_STALL_TIMEOUT_MS,
+            timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
+        }),
+    }),
+});
+/**
+ * The table an app should actually use: {@link DEFAULT_AI_TIERS} with `overrides` applied
+ * per field, so an app that wants one model moved says only that and keeps the platform's
+ * clocks and ceilings.
+ *
+ * @remarks
+ * An override field set to `undefined` is skipped, exactly as if it had been left out. The
+ * common caller passes an optional config value straight through
+ * (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would
+ * hand the transport no model at all — it then quietly falls back to its own default, with
+ * nothing logged.
+ *
+ * The result is frozen whether or not anything was overridden, so whether mutating it throws
+ * does not depend on what the caller passed. The default itself is returned untouched when
+ * there is nothing to override, and is never mutated, which matters because it is shared
+ * across every app in the process.
+ *
+ * @example
+ * ```ts
+ * // Keep everything, but run the reasoning tier on Fable.
+ * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });
+ * ```
+ *
+ * @beta
+ */
+export function resolveAITiers(overrides) {
+    if (!(overrides === null || overrides === void 0 ? void 0 : overrides.anthropic) && !(overrides === null || overrides === void 0 ? void 0 : overrides.gemini))
+        return DEFAULT_AI_TIERS;
+    return Object.freeze({
+        anthropic: mergeVendor(DEFAULT_AI_TIERS.anthropic, overrides.anthropic),
+        gemini: mergeVendor(DEFAULT_AI_TIERS.gemini, overrides.gemini),
+    });
+}
+function mergeVendor(defaults, overrides) {
+    var _a;
+    const merged = {};
+    for (const tier of AI_TIER_IDS) {
+        const defined = Object.fromEntries(Object.entries((_a = overrides === null || overrides === void 0 ? void 0 : overrides[tier]) !== null && _a !== void 0 ? _a : {}).filter(([, value]) => value !== undefined));
+        // Frozen in place rather than through `Object.freeze`'s return value, whose overloads
+        // widen a generic `T` to an index signature; the typed reference is the one we keep.
+        const entry = Object.assign(Object.assign({}, defaults[tier]), defined);
+        Object.freeze(entry);
+        merged[tier] = entry;
+    }
+    Object.freeze(merged);
+    return merged;
+}

package/dist/esm/tiers/build-tier-providers.js

@@ -0,0 +1,72 @@
+import { createAIProvider } from '../ai-provider';
+import { AI_TIER_IDS, DEFAULT_AI_TIERS, } from './ai-tiers';
+/**
+ * Builds one {@link AIProvider} per tier for a vendor, ready to register under the tier
+ * names agents resolve (`low` / `high` / `reasoning`).
+ *
+ * @remarks
+ * Each provider carries its tier's model, output ceiling (Anthropic) and both clocks, so no
+ * tier can silently fall back to the transport defaults — which is how a large tool write
+ * ends up truncated at 4096 tokens.
+ *
+ * @example
+ * ```ts
+ * registerAIProviders(
+ *   container,
+ *   buildTierProviders({ vendor: 'gemini', serverEndpoint: (v) => `/gwf/ai-service/${v}/chat` }),
+ *   { default: 'high' },
+ * );
+ * ```
+ *
+ * @beta
+ */
+export function buildTierProviders(options) {
+    const configs = tierProviderConfigs(options);
+    const providers = {};
+    for (const tier of AI_TIER_IDS) {
+        providers[tier] = createAIProvider(configs[tier]);
+    }
+    return providers;
+}
+/**
+ * The provider configs {@link buildTierProviders} builds from, before they reach
+ * `createAIProvider`.
+ *
+ * A seam rather than an inline literal, because what is being asserted is exactly what a
+ * constructed provider hides: a transport keeps `maxTokens` and both clocks private, so a
+ * tier silently falling back to the 4096-token default would be invisible from the outside
+ * — which is the failure this table exists to prevent.
+ *
+ * @internal
+ */
+export function tierProviderConfigs(options) {
+    const { vendor, tiers = DEFAULT_AI_TIERS } = options;
+    const serverEndpoint = typeof options.serverEndpoint === 'function'
+        ? options.serverEndpoint(vendor)
+        : options.serverEndpoint;
+    if (!serverEndpoint) {
+        throw new Error(`buildTierProviders: no serverEndpoint for '${vendor}'. Every tier posts to your app's ` +
+            'AI proxy; there is no browser-key mode here.');
+    }
+    const configs = {};
+    for (const tier of AI_TIER_IDS) {
+        configs[tier] =
+            vendor === 'anthropic'
+                ? {
+                    providerType: 'anthropic',
+                    model: tiers.anthropic[tier].model,
+                    maxTokens: tiers.anthropic[tier].maxTokens,
+                    serverEndpoint,
+                    stallTimeout: tiers.anthropic[tier].stallTimeoutMs,
+                    timeout: tiers.anthropic[tier].timeoutMs,
+                }
+                : {
+                    providerType: 'gemini',
+                    model: tiers.gemini[tier].model,
+                    serverEndpoint,
+                    stallTimeout: tiers.gemini[tier].stallTimeoutMs,
+                    timeout: tiers.gemini[tier].timeoutMs,
+                };
+    }
+    return configs;
+}

package/dist/esm/utils/token-cost.js

@@ -161,6 +161,20 @@ export const GEMINI_LONG_CONTEXT_THRESHOLD = 200000;
  * @beta
  */
 export const GEMINI_CACHED_INPUT_MULTIPLIER = 0.1;
+/**
+ * The day `gemini-3.8-flash` leaves its introductory rate (see `GEMINI_PRICING` below).
+ *
+ * A constant rather than a literal in the test that enforces it, because a SECOND dated
+ * assertion now hangs off the same day: the High tier picked that model while it was the
+ * cheaper one, so the flip is also the trigger to re-bench the tier (`tiers/ai-tiers.test.ts`).
+ * Two hand-copied dates would drift the moment either is corrected, and a re-bench reminder
+ * that fires on the wrong day is no reminder at all.
+ *
+ * Not part of the package's public surface — it exists for those two tests.
+ *
+ * @internal
+ */
+export const GEMINI_3_8_FLASH_INTRO_RATE_ENDS = Date.parse('2027-01-01T00:00:00Z');
 /**
  * Paid Standard tier rates (USD per million tokens) —
  * https://ai.google.dev/gemini-api/docs/pricing