@pentoshi/clai 4.1.0 → 4.2.0

package/dist/llm/context-snapshot.d.ts

@@ -0,0 +1,100 @@
+import { type GenerationAttemptMode, type GenerationAttemptOutcome, type GenerationAttemptReason, type ProviderId } from "../types.js";
+import type { OperationUsageSnapshot } from "./operation-usage.js";
+import type { ContextUsageSnapshot } from "./token-usage.js";
+/** Versioned runtime representation for one observed context measurement. */
+export declare const CONTEXT_SNAPSHOT_VERSION: 1;
+export type ContextSnapshotScope = "provider-request" | "assembled-request" | "message-history" | "unknown";
+export type ContextSnapshotPrecision = "provider-exact" | "estimate" | "unknown";
+export type ContextLimitSource = "session-override" | "model-catalog" | "configured-trigger" | "provider-reported" | "unknown";
+export interface ContextSnapshotLimit {
+    readonly source: ContextLimitSource;
+    readonly tokens?: number | undefined;
+}
+export type ContextSnapshotHeadroom = {
+    readonly kind: "known";
+    /** Remaining tokens in the same scope as contextTokens. */
+    readonly remainingTokens: number;
+    /** Optional future request-budget metadata; T110 leaves it unknown. */
+    readonly effectiveTriggerTokens?: number | undefined;
+    readonly outputReserveTokens?: number | undefined;
+    readonly safetyMarginTokens?: number | undefined;
+} | {
+    readonly kind: "unknown";
+};
+/** Provider-reported cache outcomes; absence is explicitly unknown, never zero. */
+export type ContextSnapshotCache = {
+    readonly kind: "unknown";
+} | {
+    readonly kind: "reported";
+    readonly readTokens?: number | undefined;
+    readonly creationTokens?: number | undefined;
+    /** Input tokens explicitly not served from the provider cache. */
+    readonly uncachedTokens?: number | undefined;
+};
+/** Provider-reported reasoning usage; absence is explicitly unknown, never zero. */
+export type ContextSnapshotReasoning = {
+    readonly kind: "unknown";
+} | {
+    readonly kind: "reported";
+    readonly outputTokens?: number | undefined;
+    readonly inputArtifactTokens?: number | undefined;
+};
+/**
+ * A T100 record sequence is scoped to one logical provider operation. It is
+ * exposed only when that operation snapshot actually reached the caller.
+ */
+export type ContextAttemptReference = {
+    readonly kind: "unavailable";
+} | {
+    readonly kind: "generation";
+    readonly sequence: number;
+    readonly provider: ProviderId;
+    readonly model: string;
+    readonly mode: GenerationAttemptMode;
+    readonly reason: GenerationAttemptReason;
+    readonly outcome: GenerationAttemptOutcome;
+};
+export interface ContextSnapshotV1 {
+    readonly version: typeof CONTEXT_SNAPSHOT_VERSION;
+    /** The observed context fill in the declared scope. */
+    readonly contextTokens: number;
+    readonly lastCompletionTokens: number;
+    readonly sessionPromptTokens: number;
+    readonly sessionCompletionTokens: number;
+    readonly scope: ContextSnapshotScope;
+    readonly precision: ContextSnapshotPrecision;
+    readonly limit: ContextSnapshotLimit;
+    readonly headroom: ContextSnapshotHeadroom;
+    readonly cache: ContextSnapshotCache;
+    readonly reasoning: ContextSnapshotReasoning;
+    readonly attempt: ContextAttemptReference;
+    /** Epoch milliseconds captured at measurement time, never at projection time. */
+    readonly observedAt: number;
+}
+export interface CreateContextSnapshotInput {
+    readonly contextTokens: number;
+    readonly lastCompletionTokens?: number | undefined;
+    readonly sessionPromptTokens?: number | undefined;
+    readonly sessionCompletionTokens?: number | undefined;
+    readonly scope: ContextSnapshotScope;
+    readonly precision: ContextSnapshotPrecision;
+    readonly limit?: ContextSnapshotLimit | undefined;
+    readonly headroom?: ContextSnapshotHeadroom | undefined;
+    readonly cache?: ContextSnapshotCache | undefined;
+    readonly reasoning?: ContextSnapshotReasoning | undefined;
+    readonly attempt?: ContextAttemptReference | undefined;
+    readonly observedAt?: number | undefined;
+}
+/** Build one immutable, versioned observation without synthesizing telemetry. */
+export declare function createContextSnapshot(input: CreateContextSnapshotInput): ContextSnapshotV1;
+/** The only legacy projection consumed by existing renderers and old history. */
+export declare function toLegacyContextUsage(snapshot: ContextSnapshotV1): ContextUsageSnapshot;
+export declare function contextLimitFromSessionOverride(tokens: number | undefined): ContextSnapshotLimit;
+/** Rebind only live limit metadata; measurements retain their original time. */
+export declare function withContextSnapshotLimit(snapshot: ContextSnapshotV1, limit: ContextSnapshotLimit): ContextSnapshotV1;
+/** Convert an unversioned six-field persisted/rendering snapshot once. */
+export declare function contextSnapshotFromLegacy(snapshot: ContextUsageSnapshot, limit: ContextSnapshotLimit, observedAt?: number | undefined): ContextSnapshotV1;
+/** Narrow persisted JSON before treating it as the current schema. */
+export declare function isContextSnapshotV1(value: unknown): value is ContextSnapshotV1;
+/** Return the final physical T100 attempt only when it really exists. */
+export declare function contextAttemptFromOperationUsage(operationUsage: OperationUsageSnapshot | undefined): ContextAttemptReference;

package/dist/llm/context-snapshot.js

@@ -0,0 +1,277 @@
+import { providerIds, } from "../types.js";
+/** Versioned runtime representation for one observed context measurement. */
+export const CONTEXT_SNAPSHOT_VERSION = 1;
+const LIMIT_SOURCES = new Set([
+    "session-override",
+    "model-catalog",
+    "configured-trigger",
+    "provider-reported",
+    "unknown",
+]);
+const SCOPES = new Set([
+    "provider-request",
+    "assembled-request",
+    "message-history",
+    "unknown",
+]);
+const PRECISIONS = new Set([
+    "provider-exact",
+    "estimate",
+    "unknown",
+]);
+const UNKNOWN_HEADROOM = Object.freeze({
+    kind: "unknown",
+});
+const UNKNOWN_CACHE = Object.freeze({
+    kind: "unknown",
+});
+const UNKNOWN_REASONING = Object.freeze({
+    kind: "unknown",
+});
+const UNAVAILABLE_ATTEMPT = Object.freeze({
+    kind: "unavailable",
+});
+function nonNegativeInteger(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.floor(value));
+}
+function optionalNonNegativeInteger(value) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return undefined;
+    return Math.max(0, Math.floor(value));
+}
+function positiveInteger(value) {
+    const normalized = optionalNonNegativeInteger(value);
+    return normalized !== undefined && normalized > 0 ? normalized : undefined;
+}
+function normalizeLimit(limit) {
+    if (!limit || !LIMIT_SOURCES.has(limit.source)) {
+        return Object.freeze({ source: "unknown" });
+    }
+    const tokens = positiveInteger(limit.tokens);
+    return Object.freeze({
+        source: limit.source,
+        ...(tokens !== undefined ? { tokens } : {}),
+    });
+}
+function normalizeCache(cache) {
+    if (!cache || cache.kind !== "reported")
+        return UNKNOWN_CACHE;
+    const readTokens = optionalNonNegativeInteger(cache.readTokens);
+    const creationTokens = optionalNonNegativeInteger(cache.creationTokens);
+    const uncachedTokens = optionalNonNegativeInteger(cache.uncachedTokens);
+    if (readTokens === undefined &&
+        creationTokens === undefined &&
+        uncachedTokens === undefined) {
+        return UNKNOWN_CACHE;
+    }
+    return Object.freeze({
+        kind: "reported",
+        ...(readTokens !== undefined ? { readTokens } : {}),
+        ...(creationTokens !== undefined ? { creationTokens } : {}),
+        ...(uncachedTokens !== undefined ? { uncachedTokens } : {}),
+    });
+}
+function normalizeReasoning(reasoning) {
+    if (!reasoning || reasoning.kind !== "reported")
+        return UNKNOWN_REASONING;
+    const outputTokens = optionalNonNegativeInteger(reasoning.outputTokens);
+    const inputArtifactTokens = optionalNonNegativeInteger(reasoning.inputArtifactTokens);
+    if (outputTokens === undefined && inputArtifactTokens === undefined) {
+        return UNKNOWN_REASONING;
+    }
+    return Object.freeze({
+        kind: "reported",
+        ...(outputTokens !== undefined ? { outputTokens } : {}),
+        ...(inputArtifactTokens !== undefined ? { inputArtifactTokens } : {}),
+    });
+}
+function derivedHeadroom(contextTokens, scope, limit) {
+    if (scope === "message-history" ||
+        scope === "unknown" ||
+        limit.source !== "session-override" ||
+        limit.tokens === undefined) {
+        return UNKNOWN_HEADROOM;
+    }
+    return Object.freeze({
+        kind: "known",
+        remainingTokens: Math.max(0, limit.tokens - contextTokens),
+    });
+}
+function normalizeObservedAt(value) {
+    const candidate = value ?? Date.now();
+    return nonNegativeInteger(candidate);
+}
+/** Build one immutable, versioned observation without synthesizing telemetry. */
+export function createContextSnapshot(input) {
+    const contextTokens = nonNegativeInteger(input.contextTokens);
+    const limit = normalizeLimit(input.limit);
+    return Object.freeze({
+        version: CONTEXT_SNAPSHOT_VERSION,
+        contextTokens,
+        lastCompletionTokens: nonNegativeInteger(input.lastCompletionTokens),
+        sessionPromptTokens: nonNegativeInteger(input.sessionPromptTokens),
+        sessionCompletionTokens: nonNegativeInteger(input.sessionCompletionTokens),
+        scope: input.scope,
+        precision: input.precision,
+        limit,
+        headroom: input.headroom ?? derivedHeadroom(contextTokens, input.scope, limit),
+        cache: normalizeCache(input.cache),
+        reasoning: normalizeReasoning(input.reasoning),
+        attempt: input.attempt ?? UNAVAILABLE_ATTEMPT,
+        observedAt: normalizeObservedAt(input.observedAt),
+    });
+}
+/** The only legacy projection consumed by existing renderers and old history. */
+export function toLegacyContextUsage(snapshot) {
+    return Object.freeze({
+        contextTokens: snapshot.contextTokens,
+        contextLimit: snapshot.limit.source === "session-override" && snapshot.limit.tokens
+            ? snapshot.limit.tokens
+            : 0,
+        lastCompletionTokens: snapshot.lastCompletionTokens,
+        sessionPromptTokens: snapshot.sessionPromptTokens,
+        sessionCompletionTokens: snapshot.sessionCompletionTokens,
+        exact: snapshot.precision === "provider-exact",
+    });
+}
+export function contextLimitFromSessionOverride(tokens) {
+    const normalized = positiveInteger(tokens);
+    return Object.freeze(normalized === undefined
+        ? { source: "unknown" }
+        : { source: "session-override", tokens: normalized });
+}
+/** Rebind only live limit metadata; measurements retain their original time. */
+export function withContextSnapshotLimit(snapshot, limit) {
+    const normalizedLimit = normalizeLimit(limit);
+    return Object.freeze({
+        ...snapshot,
+        limit: normalizedLimit,
+        headroom: derivedHeadroom(snapshot.contextTokens, snapshot.scope, normalizedLimit),
+    });
+}
+/** Convert an unversioned six-field persisted/rendering snapshot once. */
+export function contextSnapshotFromLegacy(snapshot, limit, observedAt) {
+    return createContextSnapshot({
+        contextTokens: snapshot.contextTokens,
+        lastCompletionTokens: snapshot.lastCompletionTokens,
+        sessionPromptTokens: snapshot.sessionPromptTokens,
+        sessionCompletionTokens: snapshot.sessionCompletionTokens,
+        scope: "unknown",
+        precision: snapshot.exact ? "provider-exact" : "estimate",
+        limit,
+        observedAt,
+    });
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isNonNegativeIntegerValue(value) {
+    return (typeof value === "number" &&
+        Number.isSafeInteger(value) &&
+        value >= 0);
+}
+function hasOptionalNonNegativeInteger(value) {
+    return value === undefined || isNonNegativeIntegerValue(value);
+}
+function isContextLimit(value) {
+    return (isRecord(value) &&
+        LIMIT_SOURCES.has(value.source) &&
+        (value.tokens === undefined ||
+            (isNonNegativeIntegerValue(value.tokens) && value.tokens > 0)));
+}
+function isContextHeadroom(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.kind === "unknown")
+        return true;
+    return (value.kind === "known" &&
+        isNonNegativeIntegerValue(value.remainingTokens) &&
+        hasOptionalNonNegativeInteger(value.effectiveTriggerTokens) &&
+        hasOptionalNonNegativeInteger(value.outputReserveTokens) &&
+        hasOptionalNonNegativeInteger(value.safetyMarginTokens));
+}
+function isContextCache(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.kind === "unknown")
+        return true;
+    return (value.kind === "reported" &&
+        hasOptionalNonNegativeInteger(value.readTokens) &&
+        hasOptionalNonNegativeInteger(value.creationTokens) &&
+        hasOptionalNonNegativeInteger(value.uncachedTokens));
+}
+function isContextReasoning(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.kind === "unknown")
+        return true;
+    return (value.kind === "reported" &&
+        hasOptionalNonNegativeInteger(value.outputTokens) &&
+        hasOptionalNonNegativeInteger(value.inputArtifactTokens));
+}
+const ATTEMPT_MODES = new Set(["complete", "stream"]);
+const ATTEMPT_REASONS = new Set([
+    "initial",
+    "retry",
+    "fallback",
+    "adaptation",
+    "provider-retry",
+]);
+const ATTEMPT_OUTCOMES = new Set([
+    "success",
+    "failure",
+    "cancelled",
+]);
+const ATTEMPT_PROVIDERS = new Set(providerIds);
+function isContextAttempt(value) {
+    if (!isRecord(value))
+        return false;
+    if (value.kind === "unavailable")
+        return true;
+    return (value.kind === "generation" &&
+        isNonNegativeIntegerValue(value.sequence) &&
+        value.sequence > 0 &&
+        ATTEMPT_PROVIDERS.has(value.provider) &&
+        typeof value.model === "string" &&
+        value.model.trim().length > 0 &&
+        ATTEMPT_MODES.has(value.mode) &&
+        ATTEMPT_REASONS.has(value.reason) &&
+        ATTEMPT_OUTCOMES.has(value.outcome));
+}
+/** Narrow persisted JSON before treating it as the current schema. */
+export function isContextSnapshotV1(value) {
+    if (!isRecord(value) || value.version !== CONTEXT_SNAPSHOT_VERSION)
+        return false;
+    return (SCOPES.has(value.scope) &&
+        PRECISIONS.has(value.precision) &&
+        isContextLimit(value.limit) &&
+        isContextHeadroom(value.headroom) &&
+        isContextCache(value.cache) &&
+        isContextReasoning(value.reasoning) &&
+        isContextAttempt(value.attempt) &&
+        [
+            value.contextTokens,
+            value.lastCompletionTokens,
+            value.sessionPromptTokens,
+            value.sessionCompletionTokens,
+            value.observedAt,
+        ].every(isNonNegativeIntegerValue));
+}
+/** Return the final physical T100 attempt only when it really exists. */
+export function contextAttemptFromOperationUsage(operationUsage) {
+    const attempt = operationUsage?.attempts.at(-1);
+    if (!attempt)
+        return UNAVAILABLE_ATTEMPT;
+    return Object.freeze({
+        kind: "generation",
+        sequence: attempt.sequence,
+        provider: attempt.provider,
+        model: attempt.model,
+        mode: attempt.mode,
+        reason: attempt.reason,
+        outcome: attempt.outcome,
+    });
+}
+//# sourceMappingURL=context-snapshot.js.map

package/dist/llm/context-snapshot.js.map

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

package/dist/llm/context-windows.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderId } from "../types.js";
+export declare function modelContextWindow(model: string | undefined, provider?: ProviderId | undefined): number;
+/**
+ * The model's nominal family window, ignoring provider-served overrides.
+ * Some overrides (Groq's low-TPM tiers) are budget advisories that steer
+ * earlier compaction, not physical maximums a dispatch gate should enforce.
+ */
+export declare function nominalModelContextWindow(model: string | undefined): number;
+/** Exact served window for a provider-published alias, when one exists. */
+export declare function providerContextOverrideTokens(provider: ProviderId, model: string | undefined): number | undefined;

package/dist/llm/context-windows.js

@@ -0,0 +1,129 @@
+/**
+ * Known model context windows (tokens). Patterns are tested in order;
+ * first match wins. Keep conservative defaults so % never under-reports fill.
+ */
+const CONTEXT_WINDOW_RULES = [
+    // Anthropic
+    { pattern: /claude-(?:fable|mythos)-5/i, tokens: 1_000_000 },
+    { pattern: /claude-(?:opus|sonnet)-5/i, tokens: 1_000_000 },
+    { pattern: /claude-(?:opus|sonnet)-4\.[678]/i, tokens: 1_000_000 },
+    { pattern: /claude-(?:opus|sonnet)-4/i, tokens: 200_000 },
+    { pattern: /claude-haiku-4/i, tokens: 200_000 },
+    { pattern: /claude-3-7/i, tokens: 200_000 },
+    { pattern: /claude-3-5/i, tokens: 200_000 },
+    { pattern: /claude-3/i, tokens: 200_000 },
+    // OpenAI
+    { pattern: /gpt-5\.[456](?:[-.]|$)/i, tokens: 1_050_000 },
+    { pattern: /gpt-5/i, tokens: 400_000 },
+    { pattern: /gpt-4\.1/i, tokens: 1_047_576 },
+    { pattern: /gpt-4o/i, tokens: 128_000 },
+    { pattern: /gpt-4-turbo/i, tokens: 128_000 },
+    // Plain gpt-4 is 8k (32k for the -32k variant); the generic 128k rule below
+    // used to over-size it, so no warning arrived before a hard context error.
+    { pattern: /gpt-4-32k/i, tokens: 32_768 },
+    { pattern: /^gpt-4(?:-\d{4})?$/i, tokens: 8_192 },
+    { pattern: /gpt-4/i, tokens: 128_000 },
+    { pattern: /o3/i, tokens: 200_000 },
+    { pattern: /o4/i, tokens: 200_000 },
+    { pattern: /o1/i, tokens: 200_000 },
+    // Google — keep explicit rules ahead of the generic /gemini/i fallback, which
+    // used to catch the shipped gemini-3.x default at an order of magnitude low.
+    { pattern: /gemini-3/i, tokens: 1_048_576 },
+    { pattern: /gemini-2\.5/i, tokens: 1_048_576 },
+    { pattern: /gemini-2\.0/i, tokens: 1_048_576 },
+    { pattern: /gemini-1\.5/i, tokens: 1_048_576 },
+    { pattern: /gemini/i, tokens: 128_000 },
+    // Meta / Groq
+    { pattern: /llama-4/i, tokens: 128_000 },
+    { pattern: /llama-3\.3/i, tokens: 128_000 },
+    { pattern: /llama-3\.1/i, tokens: 128_000 },
+    { pattern: /llama-3/i, tokens: 128_000 },
+    // DeepSeek / Qwen / Kimi / GLM / etc.
+    { pattern: /deepseek-v4/i, tokens: 1_000_000 },
+    { pattern: /deepseek/i, tokens: 128_000 },
+    { pattern: /qwen3\.7/i, tokens: 1_000_000 },
+    { pattern: /qwen3\.(?:8|6|5)/i, tokens: 262_144 },
+    { pattern: /qwen3/i, tokens: 128_000 },
+    { pattern: /qwen2\.5/i, tokens: 128_000 },
+    { pattern: /qwen/i, tokens: 128_000 },
+    // Kimi-K3 is a 1M-window model. Keep this before generic Kimi/K2 rules so
+    // Modal and gateway model IDs such as `moonshotai/Kimi-K3` are not clamped
+    // to the legacy 128k family window.
+    { pattern: /kimi-k3/i, tokens: 1_000_000 },
+    { pattern: /kimi-k2/i, tokens: 256_000 },
+    { pattern: /kimi/i, tokens: 128_000 },
+    { pattern: /glm-?5\.2/i, tokens: 1_000_000 },
+    { pattern: /glm-?5/i, tokens: 200_000 },
+    { pattern: /glm-?4\.[56]/i, tokens: 200_000 },
+    { pattern: /glm-?4/i, tokens: 128_000 },
+    { pattern: /minimax-m3/i, tokens: 1_000_000 },
+    { pattern: /minimax-m2\.7/i, tokens: 204_800 },
+    { pattern: /minimax/i, tokens: 128_000 },
+    { pattern: /mimo/i, tokens: 128_000 },
+    { pattern: /gpt-oss/i, tokens: 128_000 },
+    { pattern: /nemotron/i, tokens: 128_000 },
+    { pattern: /muse-spark/i, tokens: 1_048_576 },
+];
+const DEFAULT_CONTEXT_WINDOW = 250_000;
+/**
+ * Provider-specific served windows that are smaller than the model's nominal
+ * one. The `provider` argument used to be accepted and discarded, so `%` of
+ * context was wrong wherever a gateway serves a truncated window.
+ */
+const PROVIDER_CONTEXT_OVERRIDES = {
+    // Groq serves these two on a low TPM tier; the usable prompt is far below the
+    // model's nominal window (mirrors `groqInputTokenBudget`).
+    groq: [
+        { pattern: /qwen\/qwen3-32b/i, tokens: 5_500 },
+        { pattern: /openai\/gpt-oss-20b/i, tokens: 7_500 },
+    ],
+    // TokenRouter publishes the real upstream window per model id, and several
+    // are far larger than the generic family rules below would guess. Model ids
+    // are vendor-namespaced (`deepseek/deepseek-v4-pro`) but older sessions and
+    // catalogs still carry the bare alias, so both forms must match (MR-033).
+    tokenrouter: [
+        { pattern: /^(?:[a-z0-9-]+\/)?deepseek-v4-(?:pro|flash)$/i, tokens: 1_000_000 },
+        { pattern: /^(?:[a-z0-9-]+\/)?minimax-m3$/i, tokens: 524_288 },
+        { pattern: /^(?:[a-z0-9-]+\/)?minimax-m2p7$/i, tokens: 196_608 },
+        { pattern: /^(?:[a-z0-9-]+\/)?kimi-k2(?:p\d|\.\d)/i, tokens: 262_144 },
+        { pattern: /^(?:[a-z0-9-]+\/)?qwen3p\d-plus$/i, tokens: 262_144 },
+        { pattern: /^(?:[a-z0-9-]+\/)?glm-5p1(?:-fast)?$/i, tokens: 202_752 },
+        { pattern: /^(?:[a-z0-9-]+\/)?gpt-oss-120b$/i, tokens: 131_072 },
+    ],
+};
+export function modelContextWindow(model, provider) {
+    if (!model)
+        return DEFAULT_CONTEXT_WINDOW;
+    const overrides = provider ? PROVIDER_CONTEXT_OVERRIDES[provider] : undefined;
+    if (overrides) {
+        for (const rule of overrides) {
+            if (rule.pattern.test(model))
+                return rule.tokens;
+        }
+    }
+    return nominalModelContextWindow(model);
+}
+/**
+ * The model's nominal family window, ignoring provider-served overrides.
+ * Some overrides (Groq's low-TPM tiers) are budget advisories that steer
+ * earlier compaction, not physical maximums a dispatch gate should enforce.
+ */
+export function nominalModelContextWindow(model) {
+    if (!model)
+        return DEFAULT_CONTEXT_WINDOW;
+    for (const rule of CONTEXT_WINDOW_RULES) {
+        if (rule.pattern.test(model))
+            return rule.tokens;
+    }
+    return DEFAULT_CONTEXT_WINDOW;
+}
+/** Exact served window for a provider-published alias, when one exists. */
+export function providerContextOverrideTokens(provider, model) {
+    if (!model)
+        return undefined;
+    const overrides = PROVIDER_CONTEXT_OVERRIDES[provider];
+    if (!overrides)
+        return undefined;
+    return overrides.find((rule) => rule.pattern.test(model))?.tokens;
+}
+//# sourceMappingURL=context-windows.js.map

package/dist/llm/context-windows.js.map

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

package/dist/llm/custom-provider-profile.d.ts

@@ -0,0 +1,75 @@
+import { type FinalTurnPreservation, type ProfileReplayScope, type ProfileTriState, type ProviderProfile, type ProviderProfileLayer, type ReasoningDisableForm, type ReasoningGeneration, type ReasoningOutputShape } from "./provider-profile.js";
+import type { ReasoningStyle } from "./http.js";
+import type { CachePolicyKind, LimitSource } from "./provider-profile.js";
+export type CustomAuthType = "bearer" | "custom-headers" | "none-keyless";
+/** Serializable wire subset a custom route may declare. */
+export interface CustomProviderProfileSpec {
+    readonly authType?: CustomAuthType | undefined;
+    readonly keyEnv?: string | undefined;
+    readonly baseUrlEnv?: string | undefined;
+    /** Values may be literals or `${ENV_NAME}` references. */
+    readonly headers?: Readonly<Record<string, string>> | undefined;
+    readonly tools?: ProfileTriState | undefined;
+    readonly images?: ProfileTriState | undefined;
+    readonly structuredOutput?: ProfileTriState | undefined;
+    readonly streamOptions?: ProfileTriState | undefined;
+    readonly reasoning?: {
+        readonly generation?: ReasoningGeneration | undefined;
+        readonly controlDialect?: "openai-effort" | "none" | undefined;
+        readonly acceptedEfforts?: readonly string[] | undefined;
+        readonly disable?: ProfileTriState | undefined;
+        readonly disableForm?: ReasoningDisableForm | undefined;
+        readonly outputShapes?: readonly ReasoningOutputShape[] | undefined;
+        readonly replayScope?: ProfileReplayScope | undefined;
+        readonly finalTurnPreservation?: FinalTurnPreservation | undefined;
+    } | undefined;
+    readonly limits?: {
+        readonly contextTokens?: number | undefined;
+        readonly outputTokens?: number | undefined;
+        readonly source?: LimitSource | undefined;
+    } | undefined;
+    readonly cache?: {
+        readonly kind?: CachePolicyKind | undefined;
+        readonly affinityField?: string | undefined;
+        readonly isolationField?: string | undefined;
+        readonly cacheAffectingFields?: readonly string[] | undefined;
+    } | undefined;
+    readonly usage?: {
+        readonly cachedInput?: readonly string[] | undefined;
+        readonly uncachedInput?: readonly string[] | undefined;
+        readonly cacheWrite?: readonly string[] | undefined;
+        readonly reasoningOutput?: readonly string[] | undefined;
+    } | undefined;
+    readonly terminal?: {
+        readonly naturalEofAccepted?: boolean | undefined;
+    } | undefined;
+}
+/**
+ * Local, actionable validation. Nothing here performs a network call; the goal
+ * is that an invalid declaration fails before any request is dispatched.
+ */
+export declare function validateCustomProviderProfile(raw: unknown): {
+    spec?: CustomProviderProfileSpec;
+    errors: string[];
+};
+/** Maps a validated spec onto the user-config evidence layer. */
+export declare function customProfileLayer(spec: CustomProviderProfileSpec | undefined): ProviderProfileLayer | undefined;
+export declare function endpointPrivacyHash(baseUrl: string): string;
+/**
+ * Conservative unknown unless declared; a custom endpoint that verifiably is
+ * the direct DeepSeek API earns the documented V4 builtin layer as route
+ * evidence below user declarations.
+ */
+export declare function resolveCustomProviderProfile(input: {
+    id: string;
+    model: string;
+    baseUrl: string;
+    profile?: CustomProviderProfileSpec | undefined;
+}): ProviderProfile;
+/**
+ * Serializer style for the compatible path. Undeclared routes omit optional
+ * reasoning controls entirely (send narrowly, parse broadly).
+ */
+export declare function customReasoningStyle(profile: CustomProviderProfileSpec | undefined): ReasoningStyle;
+/** Resolves `${ENV_NAME}` header references before dispatch; throws locally. */
+export declare function resolveCustomHeaders(headers: Readonly<Record<string, string>> | undefined): Record<string, string> | undefined;