@modelprofile.com/flexharness-models 8.1.0 → 8.3.0

package/dist_ts_models/index.d.ts

@@ -1,5 +1,6 @@
 export * from './interfaces.js';
 export * from './classes.modelregistry.js';
 export * from './smartai.cache.js';
+export * from './smartai.limits.js';
 export { generateText, streamText, tool, jsonSchema } from 'ai';
 export type { ModelMessage, ToolSet, StreamTextResult } from 'ai';

package/dist_ts_models/index.js

@@ -1,5 +1,6 @@
 export * from './interfaces.js';
 export * from './classes.modelregistry.js';
 export * from './smartai.cache.js';
+export * from './smartai.limits.js';
 export { generateText, streamText, tool, jsonSchema } from 'ai';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19tb2RlbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsT0FBTyxFQUFFLFlBQVksRUFBRSxVQUFVLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxNQUFNLElBQUksQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19tb2RlbHMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxpQkFBaUIsQ0FBQztBQUNoQyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxPQUFPLEVBQUUsWUFBWSxFQUFFLFVBQVUsRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLE1BQU0sSUFBSSxDQUFDIn0=

package/dist_ts_models/smartai.limits.d.ts

@@ -0,0 +1,68 @@
+import type { LanguageModelV4Middleware } from '@ai-sdk/provider';
+/**
+ * `usage_limit`: the account's quota is spent until it resets, so no retry can succeed earlier.
+ * `rate_limit`: a short throttle that a retry after the advertised delay may pass.
+ */
+export type TModelLimitKind = 'usage_limit' | 'rate_limit';
+export interface IModelLimitInfo {
+    kind: TModelLimitKind;
+    /** The provider that reported the limit, for example `openai` or `anthropic`. */
+    provider: string;
+    /** When the limit resets, in epoch milliseconds. */
+    resetsAt?: number;
+    /** The delay the provider asked for before the next request, in milliseconds. */
+    retryAfterMs?: number;
+    /** The account plan the provider reported. */
+    planType?: string;
+    /** The exhausted limit window, for example `5h` or `7d`. */
+    window?: string;
+}
+/** What a provider dialect reads from a failure; the limit middleware adds the provider. */
+export type TModelLimitClassification = Omit<IModelLimitInfo, 'provider'>;
+/** A failed model call reduced to the parts a limit dialect reads. */
+export interface IModelCallFailure {
+    /** When the failure was observed, in epoch milliseconds; relative reset times count from here. */
+    observedAt: number;
+    /** HTTP status of the failed response, when the provider reported one. */
+    statusCode?: number;
+    /** Response headers with lower-case names. */
+    headers: Readonly<Record<string, string>>;
+    /** The parsed JSON error body, or the error frame of a failed stream. */
+    body?: unknown;
+}
+/** Reads one provider's limit dialect; returns undefined for failures that are not limits. */
+export type TModelLimitClassifier = (failure: IModelCallFailure) => TModelLimitClassification | undefined;
+export interface IModelLimitMiddlewareOptions {
+    provider: string;
+    classify: TModelLimitClassifier;
+}
+/** Upper bound for the provider, plan and window names a limit carries. */
+export declare const MODEL_LIMIT_TEXT_MAX_LENGTH = 128;
+/** The value as a JSON object, or undefined for arrays, primitives and null. */
+export declare function readJsonRecord(value: unknown): Readonly<Record<string, unknown>> | undefined;
+/** Whether a value is a complete, bounded limit description. */
+export declare function isModelLimitInfo(value: unknown): value is IModelLimitInfo;
+/** A short sentence naming the limit and, when known, its reset time. */
+export declare function describeModelLimit(limit: IModelLimitInfo): string;
+/** A provider refused a model call because a usage or rate limit was reached. */
+export declare class ModelLimitError extends Error {
+    readonly limit: Readonly<IModelLimitInfo>;
+    constructor(limit: IModelLimitInfo, options?: ErrorOptions);
+}
+/** Recognizes a ModelLimitError, also one created by another copy of this package. */
+export declare function isModelLimitError(error: unknown): error is ModelLimitError;
+/** Reads `retry-after-ms`, then `retry-after` in seconds or as an HTTP date, from lower-case headers. */
+export declare function readRetryAfterMs(headers: Readonly<Record<string, string>> | undefined, now?: number): number | undefined;
+/** Converts a Unix timestamp in seconds, as a number or numeric string, to epoch milliseconds. */
+export declare function readEpochSeconds(value: unknown): number | undefined;
+/**
+ * A limit from provider-reported values, which are untrusted: a delay or reset time outside the
+ * representable range and an overlong plan or window name are dropped, and a missing reset time
+ * follows from the delay. Kind and provider are kept as given.
+ */
+export declare function createModelLimitInfo(reported: IModelLimitInfo, observedAt: number): IModelLimitInfo;
+/**
+ * Turns the failures a provider dialect recognizes as limits into ModelLimitError, keeping the
+ * original failure as its cause. Covers thrown call errors and error parts of a running stream.
+ */
+export declare function createModelLimitMiddleware(options: IModelLimitMiddlewareOptions): LanguageModelV4Middleware;

package/dist_ts_models/smartai.limits.js

@@ -0,0 +1,185 @@
+import { APICallError } from '@ai-sdk/provider';
+/** Upper bound for the provider, plan and window names a limit carries. */
+export const MODEL_LIMIT_TEXT_MAX_LENGTH = 128;
+/** The latest instant a Date can represent, in epoch milliseconds. */
+const MAX_DATE_EPOCH_MS = 8_640_000_000_000_000;
+const modelLimitKinds = ['usage_limit', 'rate_limit'];
+const modelLimitKeys = new Set([
+    'kind',
+    'provider',
+    'resetsAt',
+    'retryAfterMs',
+    'planType',
+    'window',
+]);
+const modelLimitLabels = {
+    usage_limit: 'Usage limit',
+    rate_limit: 'Rate limit',
+};
+const modelLimitErrorMarker = Symbol.for('@modelprofile.com/flexharness-models/ModelLimitError');
+/** The value as a JSON object, or undefined for arrays, primitives and null. */
+export function readJsonRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function isLimitText(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= MODEL_LIMIT_TEXT_MAX_LENGTH;
+}
+function isLimitDelay(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function isLimitInstant(value) {
+    return isLimitDelay(value) && value <= MAX_DATE_EPOCH_MS;
+}
+/** Whether a value is a complete, bounded limit description. */
+export function isModelLimitInfo(value) {
+    const limit = readJsonRecord(value);
+    if (!limit || Object.keys(limit).some((key) => !modelLimitKeys.has(key)))
+        return false;
+    return modelLimitKinds.includes(limit.kind)
+        && isLimitText(limit.provider)
+        && (limit.resetsAt === undefined || isLimitInstant(limit.resetsAt))
+        && (limit.retryAfterMs === undefined || isLimitDelay(limit.retryAfterMs))
+        && (limit.planType === undefined || isLimitText(limit.planType))
+        && (limit.window === undefined || isLimitText(limit.window));
+}
+/** A short sentence naming the limit and, when known, its reset time. */
+export function describeModelLimit(limit) {
+    const label = modelLimitLabels[limit.kind];
+    return limit.resetsAt === undefined
+        ? `${label} reached.`
+        : `${label} reached; resets at ${new Date(limit.resetsAt).toISOString()}.`;
+}
+/** A provider refused a model call because a usage or rate limit was reached. */
+export class ModelLimitError extends Error {
+    limit;
+    constructor(limit, options) {
+        if (!isModelLimitInfo(limit))
+            throw new TypeError('ModelLimitError requires a valid limit description.');
+        super(describeModelLimit(limit), options);
+        this.name = 'ModelLimitError';
+        this.limit = Object.freeze({ ...limit });
+        Object.defineProperty(this, modelLimitErrorMarker, { value: true });
+    }
+}
+/** Recognizes a ModelLimitError, also one created by another copy of this package. */
+export function isModelLimitError(error) {
+    return error instanceof Error
+        && error[modelLimitErrorMarker] === true;
+}
+/** Reads `retry-after-ms`, then `retry-after` in seconds or as an HTTP date, from lower-case headers. */
+export function readRetryAfterMs(headers, now = Date.now()) {
+    const milliseconds = Number.parseFloat(headers?.['retry-after-ms'] ?? '');
+    if (Number.isFinite(milliseconds) && milliseconds >= 0)
+        return Math.ceil(milliseconds);
+    const retryAfter = headers?.['retry-after'];
+    if (retryAfter === undefined)
+        return undefined;
+    const seconds = Number.parseFloat(retryAfter);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return Math.ceil(seconds * 1000);
+    const delay = Date.parse(retryAfter) - now;
+    return Number.isFinite(delay) && delay > 0 ? Math.ceil(delay) : undefined;
+}
+/** Converts a Unix timestamp in seconds, as a number or numeric string, to epoch milliseconds. */
+export function readEpochSeconds(value) {
+    const seconds = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+    return typeof seconds === 'number' && Number.isFinite(seconds) && seconds >= 0
+        ? Math.round(seconds * 1000)
+        : undefined;
+}
+function lowerCaseHeaders(headers) {
+    const normalized = {};
+    for (const [name, value] of Object.entries(headers ?? {})) {
+        if (typeof value === 'string')
+            normalized[name.toLowerCase()] = value;
+    }
+    return normalized;
+}
+function parseJsonBody(body) {
+    if (body === undefined)
+        return undefined;
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return body;
+    }
+}
+/**
+ * A limit from provider-reported values, which are untrusted: a delay or reset time outside the
+ * representable range and an overlong plan or window name are dropped, and a missing reset time
+ * follows from the delay. Kind and provider are kept as given.
+ */
+export function createModelLimitInfo(reported, observedAt) {
+    const retryAfterMs = isLimitDelay(reported.retryAfterMs) ? reported.retryAfterMs : undefined;
+    const resetsAt = [reported.resetsAt, retryAfterMs === undefined ? undefined : observedAt + retryAfterMs]
+        .find(isLimitInstant);
+    return {
+        kind: reported.kind,
+        provider: reported.provider,
+        ...(resetsAt === undefined ? {} : { resetsAt }),
+        ...(retryAfterMs === undefined ? {} : { retryAfterMs }),
+        ...(isLimitText(reported.planType) ? { planType: reported.planType } : {}),
+        ...(isLimitText(reported.window) ? { window: reported.window } : {}),
+    };
+}
+function describeFailure(error, streamHeaders, observedAt) {
+    if (APICallError.isInstance(error)) {
+        return {
+            observedAt,
+            ...(error.statusCode === undefined ? {} : { statusCode: error.statusCode }),
+            headers: lowerCaseHeaders(error.responseHeaders),
+            body: parseJsonBody(error.responseBody) ?? error.data,
+        };
+    }
+    return { observedAt, headers: lowerCaseHeaders(streamHeaders), body: error };
+}
+function completeLimit(provider, classification, failure) {
+    return createModelLimitInfo({
+        ...classification,
+        provider,
+        retryAfterMs: classification.retryAfterMs ?? readRetryAfterMs(failure.headers, failure.observedAt),
+    }, failure.observedAt);
+}
+/**
+ * Turns the failures a provider dialect recognizes as limits into ModelLimitError, keeping the
+ * original failure as its cause. Covers thrown call errors and error parts of a running stream.
+ */
+export function createModelLimitMiddleware(options) {
+    const classifyError = (error, streamHeaders) => {
+        if (isModelLimitError(error))
+            return error;
+        const failure = describeFailure(error, streamHeaders, Date.now());
+        const classification = options.classify(failure);
+        return classification === undefined
+            ? error
+            : new ModelLimitError(completeLimit(options.provider, classification, failure), { cause: error });
+    };
+    const call = async (operation) => {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            throw classifyError(error);
+        }
+    };
+    return {
+        specificationVersion: 'v4',
+        wrapGenerate: ({ doGenerate }) => call(doGenerate),
+        wrapStream: async ({ doStream }) => {
+            const result = await call(doStream);
+            const headers = result.response?.headers;
+            return {
+                ...result,
+                stream: result.stream.pipeThrough(new TransformStream({
+                    transform: (part, controller) => {
+                        controller.enqueue(part.type === 'error' ? { ...part, error: classifyError(part.error, headers) } : part);
+                    },
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhaS5saW1pdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19tb2RlbHMvc21hcnRhaS5saW1pdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBa0RoRCwyRUFBMkU7QUFDM0UsTUFBTSxDQUFDLE1BQU0sMkJBQTJCLEdBQUcsR0FBRyxDQUFDO0FBRS9DLHNFQUFzRTtBQUN0RSxNQUFNLGlCQUFpQixHQUFHLHFCQUFxQixDQUFDO0FBRWhELE1BQU0sZUFBZSxHQUErQixDQUFDLGFBQWEsRUFBRSxZQUFZLENBQUMsQ0FBQztBQUNsRixNQUFNLGNBQWMsR0FBd0IsSUFBSSxHQUFHLENBQUM7SUFDbEQsTUFBTTtJQUNOLFVBQVU7SUFDVixVQUFVO0lBQ1YsY0FBYztJQUNkLFVBQVU7SUFDVixRQUFRO0NBQ1QsQ0FBQyxDQUFDO0FBQ0gsTUFBTSxnQkFBZ0IsR0FBb0M7SUFDeEQsV0FBVyxFQUFFLGFBQWE7SUFDMUIsVUFBVSxFQUFFLFlBQVk7Q0FDekIsQ0FBQztBQUNGLE1BQU0scUJBQXFCLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxzREFBc0QsQ0FBQyxDQUFDO0FBRWpHLGdGQUFnRjtBQUNoRixNQUFNLFVBQVUsY0FBYyxDQUFDLEtBQWM7SUFDM0MsT0FBTyxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDO1FBQ3pFLENBQUMsQ0FBQyxLQUFnQztRQUNsQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQ2hCLENBQUM7QUFFRCxTQUFTLFdBQVcsQ0FBQyxLQUFjO0lBQ2pDLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxJQUFJLEtBQUssQ0FBQyxNQUFNLElBQUksMkJBQTJCLENBQUM7QUFDdEcsQ0FBQztB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

package/package.json

@@ -2,7 +2,7 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "name": "@modelprofile.com/flexharness-models",
-  "version": "8.1.0",
+  "version": "8.3.0",
   "type": "module",
   "description": "Provider-independent model contracts, prompt caching and explicit model registration.",
   "main": "./dist_ts_models/index.js",

package/readme.md

@@ -15,6 +15,15 @@ pnpm add @modelprofile.com/flexharness-models
 See the [toolbox usage and migration guide](https://code.foss.global/modelprofile.com/flexharness#readme)
 for composition examples and the SmartAI/SmartAgent migration map.
 
+`ModelLimitError` is the one typed error for provider usage and rate limits; its `limit`
+(`IModelLimitInfo`) carries `kind`, `provider`, and when known `resetsAt` (epoch milliseconds),
+`retryAfterMs`, `planType` and `window`. `createModelLimitMiddleware({ provider, classify })`
+raises it for the failures a provider dialect recognizes, from thrown calls and from stream error
+parts, keeping the provider failure as `cause`. A classifier receives the failure's `observedAt` time for relative
+reset delays; a delay or reset time outside the range a `Date` can represent is dropped from the
+limit. `createModelLimitInfo`, `isModelLimitError`, `isModelLimitInfo`, `describeModelLimit`,
+`readRetryAfterMs`, `readEpochSeconds` and `readJsonRecord` are exported for dialects and hosts.
+
 ## License and Legal Information
 
 This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.

package/ts_models/index.ts

@@ -1,5 +1,6 @@
 export * from './interfaces.js';
 export * from './classes.modelregistry.js';
 export * from './smartai.cache.js';
+export * from './smartai.limits.js';
 export { generateText, streamText, tool, jsonSchema } from 'ai';
 export type { ModelMessage, ToolSet, StreamTextResult } from 'ai';

package/ts_models/readme.md

@@ -15,6 +15,15 @@ pnpm add @modelprofile.com/flexharness-models
 See the [toolbox usage and migration guide](https://code.foss.global/modelprofile.com/flexharness#readme)
 for composition examples and the SmartAI/SmartAgent migration map.
 
+`ModelLimitError` is the one typed error for provider usage and rate limits; its `limit`
+(`IModelLimitInfo`) carries `kind`, `provider`, and when known `resetsAt` (epoch milliseconds),
+`retryAfterMs`, `planType` and `window`. `createModelLimitMiddleware({ provider, classify })`
+raises it for the failures a provider dialect recognizes, from thrown calls and from stream error
+parts, keeping the provider failure as `cause`. A classifier receives the failure's `observedAt` time for relative
+reset delays; a delay or reset time outside the range a `Date` can represent is dropped from the
+limit. `createModelLimitInfo`, `isModelLimitError`, `isModelLimitInfo`, `describeModelLimit`,
+`readRetryAfterMs`, `readEpochSeconds` and `readJsonRecord` are exported for dialects and hosts.
+
 ## License and Legal Information
 
 This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the repository license file.

package/ts_models/smartai.limits.ts

@@ -0,0 +1,253 @@
+import { APICallError } from '@ai-sdk/provider';
+import type {
+  LanguageModelV4Middleware,
+  LanguageModelV4StreamPart,
+  SharedV4Headers,
+} from '@ai-sdk/provider';
+
+/**
+ * `usage_limit`: the account's quota is spent until it resets, so no retry can succeed earlier.
+ * `rate_limit`: a short throttle that a retry after the advertised delay may pass.
+ */
+export type TModelLimitKind = 'usage_limit' | 'rate_limit';
+
+export interface IModelLimitInfo {
+  kind: TModelLimitKind;
+  /** The provider that reported the limit, for example `openai` or `anthropic`. */
+  provider: string;
+  /** When the limit resets, in epoch milliseconds. */
+  resetsAt?: number;
+  /** The delay the provider asked for before the next request, in milliseconds. */
+  retryAfterMs?: number;
+  /** The account plan the provider reported. */
+  planType?: string;
+  /** The exhausted limit window, for example `5h` or `7d`. */
+  window?: string;
+}
+
+/** What a provider dialect reads from a failure; the limit middleware adds the provider. */
+export type TModelLimitClassification = Omit<IModelLimitInfo, 'provider'>;
+
+/** A failed model call reduced to the parts a limit dialect reads. */
+export interface IModelCallFailure {
+  /** When the failure was observed, in epoch milliseconds; relative reset times count from here. */
+  observedAt: number;
+  /** HTTP status of the failed response, when the provider reported one. */
+  statusCode?: number;
+  /** Response headers with lower-case names. */
+  headers: Readonly<Record<string, string>>;
+  /** The parsed JSON error body, or the error frame of a failed stream. */
+  body?: unknown;
+}
+
+/** Reads one provider's limit dialect; returns undefined for failures that are not limits. */
+export type TModelLimitClassifier = (failure: IModelCallFailure) => TModelLimitClassification | undefined;
+
+export interface IModelLimitMiddlewareOptions {
+  provider: string;
+  classify: TModelLimitClassifier;
+}
+
+/** Upper bound for the provider, plan and window names a limit carries. */
+export const MODEL_LIMIT_TEXT_MAX_LENGTH = 128;
+
+/** The latest instant a Date can represent, in epoch milliseconds. */
+const MAX_DATE_EPOCH_MS = 8_640_000_000_000_000;
+
+const modelLimitKinds: readonly TModelLimitKind[] = ['usage_limit', 'rate_limit'];
+const modelLimitKeys: ReadonlySet<string> = new Set([
+  'kind',
+  'provider',
+  'resetsAt',
+  'retryAfterMs',
+  'planType',
+  'window',
+]);
+const modelLimitLabels: Record<TModelLimitKind, string> = {
+  usage_limit: 'Usage limit',
+  rate_limit: 'Rate limit',
+};
+const modelLimitErrorMarker = Symbol.for('@modelprofile.com/flexharness-models/ModelLimitError');
+
+/** The value as a JSON object, or undefined for arrays, primitives and null. */
+export function readJsonRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+    ? value as Record<string, unknown>
+    : undefined;
+}
+
+function isLimitText(value: unknown): value is string {
+  return typeof value === 'string' && value.length > 0 && value.length <= MODEL_LIMIT_TEXT_MAX_LENGTH;
+}
+
+function isLimitDelay(value: unknown): value is number {
+  return Number.isSafeInteger(value) && (value as number) >= 0;
+}
+
+function isLimitInstant(value: unknown): value is number {
+  return isLimitDelay(value) && value <= MAX_DATE_EPOCH_MS;
+}
+
+/** Whether a value is a complete, bounded limit description. */
+export function isModelLimitInfo(value: unknown): value is IModelLimitInfo {
+  const limit = readJsonRecord(value);
+  if (!limit || Object.keys(limit).some((key) => !modelLimitKeys.has(key))) return false;
+  return modelLimitKinds.includes(limit.kind as TModelLimitKind)
+    && isLimitText(limit.provider)
+    && (limit.resetsAt === undefined || isLimitInstant(limit.resetsAt))
+    && (limit.retryAfterMs === undefined || isLimitDelay(limit.retryAfterMs))
+    && (limit.planType === undefined || isLimitText(limit.planType))
+    && (limit.window === undefined || isLimitText(limit.window));
+}
+
+/** A short sentence naming the limit and, when known, its reset time. */
+export function describeModelLimit(limit: IModelLimitInfo): string {
+  const label = modelLimitLabels[limit.kind];
+  return limit.resetsAt === undefined
+    ? `${label} reached.`
+    : `${label} reached; resets at ${new Date(limit.resetsAt).toISOString()}.`;
+}
+
+/** A provider refused a model call because a usage or rate limit was reached. */
+export class ModelLimitError extends Error {
+  public readonly limit: Readonly<IModelLimitInfo>;
+
+  constructor(limit: IModelLimitInfo, options?: ErrorOptions) {
+    if (!isModelLimitInfo(limit)) throw new TypeError('ModelLimitError requires a valid limit description.');
+    super(describeModelLimit(limit), options);
+    this.name = 'ModelLimitError';
+    this.limit = Object.freeze({ ...limit });
+    Object.defineProperty(this, modelLimitErrorMarker, { value: true });
+  }
+}
+
+/** Recognizes a ModelLimitError, also one created by another copy of this package. */
+export function isModelLimitError(error: unknown): error is ModelLimitError {
+  return error instanceof Error
+    && (error as Error & Record<symbol, unknown>)[modelLimitErrorMarker] === true;
+}
+
+/** Reads `retry-after-ms`, then `retry-after` in seconds or as an HTTP date, from lower-case headers. */
+export function readRetryAfterMs(
+  headers: Readonly<Record<string, string>> | undefined,
+  now = Date.now(),
+): number | undefined {
+  const milliseconds = Number.parseFloat(headers?.['retry-after-ms'] ?? '');
+  if (Number.isFinite(milliseconds) && milliseconds >= 0) return Math.ceil(milliseconds);
+  const retryAfter = headers?.['retry-after'];
+  if (retryAfter === undefined) return undefined;
+  const seconds = Number.parseFloat(retryAfter);
+  if (Number.isFinite(seconds) && seconds >= 0) return Math.ceil(seconds * 1000);
+  const delay = Date.parse(retryAfter) - now;
+  return Number.isFinite(delay) && delay > 0 ? Math.ceil(delay) : undefined;
+}
+
+/** Converts a Unix timestamp in seconds, as a number or numeric string, to epoch milliseconds. */
+export function readEpochSeconds(value: unknown): number | undefined {
+  const seconds = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+  return typeof seconds === 'number' && Number.isFinite(seconds) && seconds >= 0
+    ? Math.round(seconds * 1000)
+    : undefined;
+}
+
+function lowerCaseHeaders(headers: SharedV4Headers | undefined): Record<string, string> {
+  const normalized: Record<string, string> = {};
+  for (const [name, value] of Object.entries(headers ?? {})) {
+    if (typeof value === 'string') normalized[name.toLowerCase()] = value;
+  }
+  return normalized;
+}
+
+function parseJsonBody(body: string | undefined): unknown {
+  if (body === undefined) return undefined;
+  try {
+    return JSON.parse(body);
+  } catch {
+    return body;
+  }
+}
+
+/**
+ * A limit from provider-reported values, which are untrusted: a delay or reset time outside the
+ * representable range and an overlong plan or window name are dropped, and a missing reset time
+ * follows from the delay. Kind and provider are kept as given.
+ */
+export function createModelLimitInfo(reported: IModelLimitInfo, observedAt: number): IModelLimitInfo {
+  const retryAfterMs = isLimitDelay(reported.retryAfterMs) ? reported.retryAfterMs : undefined;
+  const resetsAt = [reported.resetsAt, retryAfterMs === undefined ? undefined : observedAt + retryAfterMs]
+    .find(isLimitInstant);
+  return {
+    kind: reported.kind,
+    provider: reported.provider,
+    ...(resetsAt === undefined ? {} : { resetsAt }),
+    ...(retryAfterMs === undefined ? {} : { retryAfterMs }),
+    ...(isLimitText(reported.planType) ? { planType: reported.planType } : {}),
+    ...(isLimitText(reported.window) ? { window: reported.window } : {}),
+  };
+}
+
+function describeFailure(
+  error: unknown,
+  streamHeaders: SharedV4Headers | undefined,
+  observedAt: number,
+): IModelCallFailure {
+  if (APICallError.isInstance(error)) {
+    return {
+      observedAt,
+      ...(error.statusCode === undefined ? {} : { statusCode: error.statusCode }),
+      headers: lowerCaseHeaders(error.responseHeaders),
+      body: parseJsonBody(error.responseBody) ?? error.data,
+    };
+  }
+  return { observedAt, headers: lowerCaseHeaders(streamHeaders), body: error };
+}
+
+function completeLimit(
+  provider: string,
+  classification: TModelLimitClassification,
+  failure: IModelCallFailure,
+): IModelLimitInfo {
+  return createModelLimitInfo({
+    ...classification,
+    provider,
+    retryAfterMs: classification.retryAfterMs ?? readRetryAfterMs(failure.headers, failure.observedAt),
+  }, failure.observedAt);
+}
+
+/**
+ * Turns the failures a provider dialect recognizes as limits into ModelLimitError, keeping the
+ * original failure as its cause. Covers thrown call errors and error parts of a running stream.
+ */
+export function createModelLimitMiddleware(options: IModelLimitMiddlewareOptions): LanguageModelV4Middleware {
+  const classifyError = (error: unknown, streamHeaders?: SharedV4Headers): unknown => {
+    if (isModelLimitError(error)) return error;
+    const failure = describeFailure(error, streamHeaders, Date.now());
+    const classification = options.classify(failure);
+    return classification === undefined
+      ? error
+      : new ModelLimitError(completeLimit(options.provider, classification, failure), { cause: error });
+  };
+  const call = async <TResult>(operation: () => PromiseLike<TResult>): Promise<TResult> => {
+    try {
+      return await operation();
+    } catch (error) {
+      throw classifyError(error);
+    }
+  };
+  return {
+    specificationVersion: 'v4',
+    wrapGenerate: ({ doGenerate }) => call(doGenerate),
+    wrapStream: async ({ doStream }) => {
+      const result = await call(doStream);
+      const headers = result.response?.headers;
+      return {
+        ...result,
+        stream: result.stream.pipeThrough(new TransformStream<LanguageModelV4StreamPart, LanguageModelV4StreamPart>({
+          transform: (part, controller) => {
+            controller.enqueue(part.type === 'error' ? { ...part, error: classifyError(part.error, headers) } : part);
+          },
+        })),
+      };
+    },
+  };
+}