@anyr/ai-sdk-provider 0.1.4 → 0.1.7

package/README.md

@@ -3,8 +3,8 @@
 The [AnyRouter](https://anyrouter.dev) provider for the [Vercel AI SDK](https://ai-sdk.dev).
 
 Call every model on the AnyRouter gateway through the standard AI SDK
-interface — `generateText`, `streamText`, `generateObject`, `embedMany`,
-`generateImage` — with one key and one provider.
+interface — `generateText`, `streamText`, `generateObject`, `embedMany` —
+with one key and one provider.
 
 ## Install
 
@@ -147,23 +147,6 @@ const { embeddings } = await embedMany({
 console.log(embeddings[0]) // [0.123, -0.456, ...]
 ```
 
-### Image generation
-
-```ts
-import { createAnyRouter } from "@anyr/ai-sdk-provider"
-import { generateImage } from "ai"
-
-const anyrouter = createAnyRouter()
-
-const { image } = await generateImage({
-  model: anyrouter.imageModel("openai/dall-e-3"),
-  prompt: "A serene mountain lake at dawn, oil painting.",
-  size: "1024x1024",
-})
-
-// image.base64 — base64-encoded PNG or URL depending on the model
-```
-
 ### Provider options (routing, session, extra body)
 
 ```ts
@@ -227,7 +210,6 @@ const anyrouter = createAnyRouter({
 | `anyrouter.chat(modelId)` | `LanguageModelV3` | Chat / instruction language model |
 | `anyrouter.languageModel(modelId)` | `LanguageModelV3` | Alias for `.chat()` (ProviderV3 interface) |
 | `anyrouter.embeddingModel(modelId)` | `EmbeddingModelV3` | Text embedding model |
-| `anyrouter.imageModel(modelId)` | `ImageModelV3` | Image generation model |
 | `anyrouter.client` | `AnyRouter` | Raw `@anyr/sdk` client (escape hatch) |
 
 ## Default export

package/dist/index.d.cts

@@ -1,6 +1,83 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, ImageModelV3, ImageModelV3CallOptions, ProviderV3 } from '@ai-sdk/provider';
+import { SharedV4ProviderReference, LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, EmbeddingModelV4, EmbeddingModelV4CallOptions, EmbeddingModelV4Result, FilesV4, FilesV4UploadFileCallOptions, FilesV4UploadFileResult, ProviderV4 } from '@ai-sdk/provider';
 import { AnyRouter } from '@anyr/sdk';
 
+/**
+ * Identity of the client making the request. Mirrors the `X-AnyRouter-*`
+ * headers the gateway reads in `inference-telemetry.ts`.
+ */
+interface AppAttribution {
+    /**
+     * Stable machine identifier, becomes `generations.app_source`. Use a slug
+     * (`anyr-cli`, `anyr-agent`), not a display name.
+     */
+    source?: string;
+    /** Human-readable name, becomes `generations.app_title`. */
+    title?: string;
+    /** Client version, becomes `generations.app_version`. */
+    version?: string;
+    /**
+     * Curation categories (e.g. `cli-agent`). The gateway allowlists these and
+     * keeps at most two per request; unknown values are dropped server-side.
+     */
+    categories?: string[];
+    /**
+     * Public URL identifying the app, sent as `HTTP-Referer`. Only meaningful for
+     * apps that want to appear in the public app rankings.
+     */
+    url?: string;
+}
+/** This provider's own identity, used when the caller supplies no `app`. */
+declare const PROVIDER_ATTRIBUTION: AppAttribution;
+/**
+ * Translate an {@link AppAttribution} into wire headers. Blank/whitespace-only
+ * values are omitted rather than sent empty, so a partially-filled identity
+ * never overwrites a good value with `""`.
+ *
+ * Returns `{}` when `app` is undefined, so callers that pass no `app` send no
+ * attribution headers by default. This matches the provider contract in
+ * `types.ts`: browser callers are attributed by Referer instead.
+ */
+declare function buildAppAttributionHeaders(app: AppAttribution | undefined): Record<string, string>;
+
+/**
+ * The resolved representation of a cached file — a URL string ready to drop
+ * into an OpenAI-compatible message part and the media type that accompanies it.
+ */
+type ResolvedFileEntry = {
+    /** Ready-to-use string: a data URL (`data:<mime>;base64,…`) or an https URL. */
+    url: string;
+    mediaType: string;
+};
+/**
+ * In-session file reference cache.
+ *
+ * Files are keyed by a SHA-256 hex hash of their content.  A single provider
+ * instance shares one cache, so the same binary content is never encoded or
+ * stored more than once within an agent loop — even across multiple `doGenerate`
+ * / `doStream` calls.
+ *
+ * This class is intentionally free of I/O and network calls.  All async
+ * behaviour lives in the `hashFileData` helper below.
+ */
+declare class FileReferenceCache {
+    private readonly store;
+    /**
+     * Look up a cached entry via a `SharedV4ProviderReference`.
+     * Returns `undefined` when the reference was not created by this cache.
+     */
+    lookup(reference: SharedV4ProviderReference): ResolvedFileEntry | undefined;
+    /** Add an entry and return the corresponding provider reference. */
+    set(hash: string, entry: ResolvedFileEntry): SharedV4ProviderReference;
+    /** Returns true when the content hash is already cached. */
+    has(hash: string): boolean;
+    /**
+     * Build a `SharedV4ProviderReference` for the given hash without writing
+     * to the cache.  Use this to construct the return value of `uploadFile`
+     * after confirming the hash is already stored.
+     */
+    referenceFor(hash: string): SharedV4ProviderReference;
+}
+
 /**
  * Settings for `createAnyRouter(...)`.
  */
@@ -11,6 +88,16 @@ interface AnyRouterProviderSettings {
      * Resolved lazily at request time.
      */
     apiKey?: string;
+    /**
+     * Skip API-key resolution entirely. When `true`, no `Authorization` header is
+     * derived from `apiKey`/`ANYROUTER_API_KEY` — requests rely on ambient auth
+     * such as same-origin session cookies (the AnyRouter Playground) or an
+     * `Authorization` header supplied via {@link headers}.
+     *
+     * Without this, `createAnyRouter()` throws at request time when no key is
+     * present. Defaults to `false`.
+     */
+    keyless?: boolean;
     /**
      * API base URL.
      * Defaults to `https://anyrouter.dev/api/v1`.
@@ -20,6 +107,17 @@ interface AnyRouterProviderSettings {
      * Extra headers merged into every request.
      */
     headers?: Record<string, string>;
+    /**
+     * Identify your app to AnyRouter, sent as the `X-AnyRouter-*` attribution
+     * headers so your traffic shows up under your own name in usage analytics.
+     *
+     * Opt-in rather than defaulted: unlike `@anyr/sdk`, this provider is
+     * routinely used from a browser, where the gateway already attributes the
+     * request from its `Referer`. A default `X-AnyRouter-Source` would override
+     * that (the explicit header wins server-side) and misattribute browser apps
+     * to the provider library.
+     */
+    app?: AppAttribution;
     /**
      * Custom fetch implementation.
      * Defaults to the global `fetch`.
@@ -41,6 +139,19 @@ interface AnyRouterProviderSettings {
      * Per-call `providerOptions.anyrouter.extraBody` takes precedence.
      */
     extraBody?: Record<string, unknown>;
+    /**
+     * Cache every response for N seconds via Cloudflare AI Gateway.
+     * Sent as the `cf-aig-cache-ttl` header. Min 60, max ~1 month (2,678,400s).
+     * Per-call `providerOptions.anyrouter.cacheTtl` takes precedence.
+     */
+    cacheTtl?: number;
+    /**
+     * Skip Cloudflare AI Gateway response caching for every request, even if a
+     * default cache policy would otherwise apply. Sent as
+     * `cf-aig-skip-cache: true`. Per-call `providerOptions.anyrouter.skipCache`
+     * takes precedence.
+     */
+    skipCache?: boolean;
 }
 
 interface AnyRouterChatConfig {
@@ -49,16 +160,22 @@ interface AnyRouterChatConfig {
     headers: () => Record<string, string | undefined>;
     fetch?: typeof globalThis.fetch;
     settings: AnyRouterProviderSettings;
+    /**
+     * Shared file reference cache for the provider instance.
+     * When present, `{ type: 'reference' }` file parts are resolved via the cache
+     * rather than throwing `UnsupportedFunctionalityError`.
+     */
+    fileCache?: FileReferenceCache;
 }
-declare class AnyRouterChatLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
+declare class AnyRouterChatLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
     readonly modelId: string;
     readonly supportedUrls: Record<string, RegExp[]>;
     private readonly config;
     constructor(modelId: string, config: AnyRouterChatConfig);
-    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
-    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
+    doStream(options: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
 }
 
 interface AnyRouterEmbeddingConfig {
@@ -67,8 +184,8 @@ interface AnyRouterEmbeddingConfig {
     headers: () => Record<string, string | undefined>;
     fetch?: typeof globalThis.fetch;
 }
-declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
-    readonly specificationVersion: "v3";
+declare class AnyRouterEmbeddingModel implements EmbeddingModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
     readonly modelId: string;
     /** No hard per-call limit imposed by the provider layer. */
@@ -76,39 +193,72 @@ declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
     readonly supportsParallelCalls = true;
     private readonly config;
     constructor(modelId: string, config: AnyRouterEmbeddingConfig);
-    doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
+    doEmbed(options: EmbeddingModelV4CallOptions): Promise<EmbeddingModelV4Result>;
 }
 
-interface AnyRouterImageConfig {
-    provider: string;
-    baseURL: string;
-    headers: () => Record<string, string | undefined>;
-    fetch?: typeof globalThis.fetch;
-}
-declare class AnyRouterImageModel implements ImageModelV3 {
-    readonly specificationVersion: "v3";
+/**
+ * `FilesV4` implementation for the AnyRouter provider.
+ *
+ * ## How it works
+ *
+ * `uploadFile()` computes a SHA-256 hash of the file content and stores the
+ * resolved data URL in a shared `FileReferenceCache`.  It returns a
+ * `SharedV4ProviderReference` whose `anyrouter` key is that hash.
+ *
+ * When the same reference later appears as a `{ type: 'reference' }` file
+ * part in a multi-step prompt, `convertToAnyRouterChatMessages` looks up the
+ * hash in the cache and substitutes the stored URL — so the full file bytes
+ * are never re-encoded on subsequent calls within the same provider session.
+ *
+ * ## Limitations (Phase 2)
+ *
+ * The cache is in-memory and scoped to the provider instance.  References do
+ * not persist across process restarts.  A follow-up (Phase 3+) can wire this
+ * to the AnyRouter gateway's `/files` endpoint to get durable, cross-session
+ * file IDs that translate to `{ type: "file", file: { file_id: "…" } }` parts
+ * for providers that support it (e.g. OpenAI).
+ */
+declare class AnyRouterFiles implements FilesV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
-    readonly modelId: string;
+    private readonly cache;
+    constructor(provider: string, cache: FileReferenceCache);
     /**
-     * Most image generation APIs support only 1 image per call via the
-     * standard `/images/generations` endpoint.
+     * Register a file in the in-session cache and return a provider reference.
+     *
+     * Calling this multiple times with the same file content is idempotent —
+     * the hash check prevents redundant re-encoding.
      */
-    readonly maxImagesPerCall = 1;
-    private readonly config;
-    constructor(modelId: string, config: AnyRouterImageConfig);
-    doGenerate(options: ImageModelV3CallOptions): Promise<Awaited<ReturnType<ImageModelV3["doGenerate"]>>>;
+    uploadFile(options: FilesV4UploadFileCallOptions): Promise<FilesV4UploadFileResult>;
 }
 
-interface AnyRouterProvider extends ProviderV3 {
+interface AnyRouterProvider extends ProviderV4 {
     /** Create a chat language model by calling the provider directly. */
-    (modelId: string): LanguageModelV3;
+    (modelId: string): LanguageModelV4;
     /** Create a chat language model (explicit method). */
-    chat(modelId: string): LanguageModelV3;
+    chat(modelId: string): LanguageModelV4;
     /**
      * Low-level `@anyr/sdk` client instance.
      * Use this as an escape hatch when you need direct API access.
      */
     readonly client: AnyRouter;
+    /**
+     * File management interface (AI SDK v4 `FilesV4`).
+     *
+     * Call `uploadFile()` to register a file in the session cache.  The returned
+     * `providerReference` can be used in subsequent model calls as a
+     * `{ type: 'file', data: { type: 'reference', reference } }` part — the
+     * provider resolves the reference from the cache without re-encoding the file.
+     *
+     * ```ts
+     * const ref = await anyrouter.files().uploadFile({
+     *   data: { type: 'data', data: pdfBytes },
+     *   mediaType: 'application/pdf',
+     * })
+     * // ref.providerReference === { anyrouter: '<sha256-hex>' }
+     * ```
+     */
+    files(): FilesV4;
 }
 /**
  * Create an AnyRouter provider for the Vercel AI SDK.
@@ -146,4 +296,4 @@ declare function createAnyRouter(options?: AnyRouterProviderSettings): AnyRouter
  */
 declare const anyrouter: AnyRouterProvider;
 
-export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, type AnyRouterImageConfig, AnyRouterImageModel, type AnyRouterProvider, type AnyRouterProviderSettings, anyrouter, createAnyRouter };
+export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, AnyRouterFiles, type AnyRouterProvider, type AnyRouterProviderSettings, type AppAttribution, FileReferenceCache, PROVIDER_ATTRIBUTION, type ResolvedFileEntry, anyrouter, buildAppAttributionHeaders, createAnyRouter };

package/dist/index.d.ts

@@ -1,6 +1,83 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, EmbeddingModelV3, EmbeddingModelV3CallOptions, EmbeddingModelV3Result, ImageModelV3, ImageModelV3CallOptions, ProviderV3 } from '@ai-sdk/provider';
+import { SharedV4ProviderReference, LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, EmbeddingModelV4, EmbeddingModelV4CallOptions, EmbeddingModelV4Result, FilesV4, FilesV4UploadFileCallOptions, FilesV4UploadFileResult, ProviderV4 } from '@ai-sdk/provider';
 import { AnyRouter } from '@anyr/sdk';
 
+/**
+ * Identity of the client making the request. Mirrors the `X-AnyRouter-*`
+ * headers the gateway reads in `inference-telemetry.ts`.
+ */
+interface AppAttribution {
+    /**
+     * Stable machine identifier, becomes `generations.app_source`. Use a slug
+     * (`anyr-cli`, `anyr-agent`), not a display name.
+     */
+    source?: string;
+    /** Human-readable name, becomes `generations.app_title`. */
+    title?: string;
+    /** Client version, becomes `generations.app_version`. */
+    version?: string;
+    /**
+     * Curation categories (e.g. `cli-agent`). The gateway allowlists these and
+     * keeps at most two per request; unknown values are dropped server-side.
+     */
+    categories?: string[];
+    /**
+     * Public URL identifying the app, sent as `HTTP-Referer`. Only meaningful for
+     * apps that want to appear in the public app rankings.
+     */
+    url?: string;
+}
+/** This provider's own identity, used when the caller supplies no `app`. */
+declare const PROVIDER_ATTRIBUTION: AppAttribution;
+/**
+ * Translate an {@link AppAttribution} into wire headers. Blank/whitespace-only
+ * values are omitted rather than sent empty, so a partially-filled identity
+ * never overwrites a good value with `""`.
+ *
+ * Returns `{}` when `app` is undefined, so callers that pass no `app` send no
+ * attribution headers by default. This matches the provider contract in
+ * `types.ts`: browser callers are attributed by Referer instead.
+ */
+declare function buildAppAttributionHeaders(app: AppAttribution | undefined): Record<string, string>;
+
+/**
+ * The resolved representation of a cached file — a URL string ready to drop
+ * into an OpenAI-compatible message part and the media type that accompanies it.
+ */
+type ResolvedFileEntry = {
+    /** Ready-to-use string: a data URL (`data:<mime>;base64,…`) or an https URL. */
+    url: string;
+    mediaType: string;
+};
+/**
+ * In-session file reference cache.
+ *
+ * Files are keyed by a SHA-256 hex hash of their content.  A single provider
+ * instance shares one cache, so the same binary content is never encoded or
+ * stored more than once within an agent loop — even across multiple `doGenerate`
+ * / `doStream` calls.
+ *
+ * This class is intentionally free of I/O and network calls.  All async
+ * behaviour lives in the `hashFileData` helper below.
+ */
+declare class FileReferenceCache {
+    private readonly store;
+    /**
+     * Look up a cached entry via a `SharedV4ProviderReference`.
+     * Returns `undefined` when the reference was not created by this cache.
+     */
+    lookup(reference: SharedV4ProviderReference): ResolvedFileEntry | undefined;
+    /** Add an entry and return the corresponding provider reference. */
+    set(hash: string, entry: ResolvedFileEntry): SharedV4ProviderReference;
+    /** Returns true when the content hash is already cached. */
+    has(hash: string): boolean;
+    /**
+     * Build a `SharedV4ProviderReference` for the given hash without writing
+     * to the cache.  Use this to construct the return value of `uploadFile`
+     * after confirming the hash is already stored.
+     */
+    referenceFor(hash: string): SharedV4ProviderReference;
+}
+
 /**
  * Settings for `createAnyRouter(...)`.
  */
@@ -11,6 +88,16 @@ interface AnyRouterProviderSettings {
      * Resolved lazily at request time.
      */
     apiKey?: string;
+    /**
+     * Skip API-key resolution entirely. When `true`, no `Authorization` header is
+     * derived from `apiKey`/`ANYROUTER_API_KEY` — requests rely on ambient auth
+     * such as same-origin session cookies (the AnyRouter Playground) or an
+     * `Authorization` header supplied via {@link headers}.
+     *
+     * Without this, `createAnyRouter()` throws at request time when no key is
+     * present. Defaults to `false`.
+     */
+    keyless?: boolean;
     /**
      * API base URL.
      * Defaults to `https://anyrouter.dev/api/v1`.
@@ -20,6 +107,17 @@ interface AnyRouterProviderSettings {
      * Extra headers merged into every request.
      */
     headers?: Record<string, string>;
+    /**
+     * Identify your app to AnyRouter, sent as the `X-AnyRouter-*` attribution
+     * headers so your traffic shows up under your own name in usage analytics.
+     *
+     * Opt-in rather than defaulted: unlike `@anyr/sdk`, this provider is
+     * routinely used from a browser, where the gateway already attributes the
+     * request from its `Referer`. A default `X-AnyRouter-Source` would override
+     * that (the explicit header wins server-side) and misattribute browser apps
+     * to the provider library.
+     */
+    app?: AppAttribution;
     /**
      * Custom fetch implementation.
      * Defaults to the global `fetch`.
@@ -41,6 +139,19 @@ interface AnyRouterProviderSettings {
      * Per-call `providerOptions.anyrouter.extraBody` takes precedence.
      */
     extraBody?: Record<string, unknown>;
+    /**
+     * Cache every response for N seconds via Cloudflare AI Gateway.
+     * Sent as the `cf-aig-cache-ttl` header. Min 60, max ~1 month (2,678,400s).
+     * Per-call `providerOptions.anyrouter.cacheTtl` takes precedence.
+     */
+    cacheTtl?: number;
+    /**
+     * Skip Cloudflare AI Gateway response caching for every request, even if a
+     * default cache policy would otherwise apply. Sent as
+     * `cf-aig-skip-cache: true`. Per-call `providerOptions.anyrouter.skipCache`
+     * takes precedence.
+     */
+    skipCache?: boolean;
 }
 
 interface AnyRouterChatConfig {
@@ -49,16 +160,22 @@ interface AnyRouterChatConfig {
     headers: () => Record<string, string | undefined>;
     fetch?: typeof globalThis.fetch;
     settings: AnyRouterProviderSettings;
+    /**
+     * Shared file reference cache for the provider instance.
+     * When present, `{ type: 'reference' }` file parts are resolved via the cache
+     * rather than throwing `UnsupportedFunctionalityError`.
+     */
+    fileCache?: FileReferenceCache;
 }
-declare class AnyRouterChatLanguageModel implements LanguageModelV3 {
-    readonly specificationVersion: "v3";
+declare class AnyRouterChatLanguageModel implements LanguageModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
     readonly modelId: string;
     readonly supportedUrls: Record<string, RegExp[]>;
     private readonly config;
     constructor(modelId: string, config: AnyRouterChatConfig);
-    doGenerate(options: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult>;
-    doStream(options: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult>;
+    doGenerate(options: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
+    doStream(options: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
 }
 
 interface AnyRouterEmbeddingConfig {
@@ -67,8 +184,8 @@ interface AnyRouterEmbeddingConfig {
     headers: () => Record<string, string | undefined>;
     fetch?: typeof globalThis.fetch;
 }
-declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
-    readonly specificationVersion: "v3";
+declare class AnyRouterEmbeddingModel implements EmbeddingModelV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
     readonly modelId: string;
     /** No hard per-call limit imposed by the provider layer. */
@@ -76,39 +193,72 @@ declare class AnyRouterEmbeddingModel implements EmbeddingModelV3 {
     readonly supportsParallelCalls = true;
     private readonly config;
     constructor(modelId: string, config: AnyRouterEmbeddingConfig);
-    doEmbed(options: EmbeddingModelV3CallOptions): Promise<EmbeddingModelV3Result>;
+    doEmbed(options: EmbeddingModelV4CallOptions): Promise<EmbeddingModelV4Result>;
 }
 
-interface AnyRouterImageConfig {
-    provider: string;
-    baseURL: string;
-    headers: () => Record<string, string | undefined>;
-    fetch?: typeof globalThis.fetch;
-}
-declare class AnyRouterImageModel implements ImageModelV3 {
-    readonly specificationVersion: "v3";
+/**
+ * `FilesV4` implementation for the AnyRouter provider.
+ *
+ * ## How it works
+ *
+ * `uploadFile()` computes a SHA-256 hash of the file content and stores the
+ * resolved data URL in a shared `FileReferenceCache`.  It returns a
+ * `SharedV4ProviderReference` whose `anyrouter` key is that hash.
+ *
+ * When the same reference later appears as a `{ type: 'reference' }` file
+ * part in a multi-step prompt, `convertToAnyRouterChatMessages` looks up the
+ * hash in the cache and substitutes the stored URL — so the full file bytes
+ * are never re-encoded on subsequent calls within the same provider session.
+ *
+ * ## Limitations (Phase 2)
+ *
+ * The cache is in-memory and scoped to the provider instance.  References do
+ * not persist across process restarts.  A follow-up (Phase 3+) can wire this
+ * to the AnyRouter gateway's `/files` endpoint to get durable, cross-session
+ * file IDs that translate to `{ type: "file", file: { file_id: "…" } }` parts
+ * for providers that support it (e.g. OpenAI).
+ */
+declare class AnyRouterFiles implements FilesV4 {
+    readonly specificationVersion: "v4";
     readonly provider: string;
-    readonly modelId: string;
+    private readonly cache;
+    constructor(provider: string, cache: FileReferenceCache);
     /**
-     * Most image generation APIs support only 1 image per call via the
-     * standard `/images/generations` endpoint.
+     * Register a file in the in-session cache and return a provider reference.
+     *
+     * Calling this multiple times with the same file content is idempotent —
+     * the hash check prevents redundant re-encoding.
      */
-    readonly maxImagesPerCall = 1;
-    private readonly config;
-    constructor(modelId: string, config: AnyRouterImageConfig);
-    doGenerate(options: ImageModelV3CallOptions): Promise<Awaited<ReturnType<ImageModelV3["doGenerate"]>>>;
+    uploadFile(options: FilesV4UploadFileCallOptions): Promise<FilesV4UploadFileResult>;
 }
 
-interface AnyRouterProvider extends ProviderV3 {
+interface AnyRouterProvider extends ProviderV4 {
     /** Create a chat language model by calling the provider directly. */
-    (modelId: string): LanguageModelV3;
+    (modelId: string): LanguageModelV4;
     /** Create a chat language model (explicit method). */
-    chat(modelId: string): LanguageModelV3;
+    chat(modelId: string): LanguageModelV4;
     /**
      * Low-level `@anyr/sdk` client instance.
      * Use this as an escape hatch when you need direct API access.
      */
     readonly client: AnyRouter;
+    /**
+     * File management interface (AI SDK v4 `FilesV4`).
+     *
+     * Call `uploadFile()` to register a file in the session cache.  The returned
+     * `providerReference` can be used in subsequent model calls as a
+     * `{ type: 'file', data: { type: 'reference', reference } }` part — the
+     * provider resolves the reference from the cache without re-encoding the file.
+     *
+     * ```ts
+     * const ref = await anyrouter.files().uploadFile({
+     *   data: { type: 'data', data: pdfBytes },
+     *   mediaType: 'application/pdf',
+     * })
+     * // ref.providerReference === { anyrouter: '<sha256-hex>' }
+     * ```
+     */
+    files(): FilesV4;
 }
 /**
  * Create an AnyRouter provider for the Vercel AI SDK.
@@ -146,4 +296,4 @@ declare function createAnyRouter(options?: AnyRouterProviderSettings): AnyRouter
  */
 declare const anyrouter: AnyRouterProvider;
 
-export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, type AnyRouterImageConfig, AnyRouterImageModel, type AnyRouterProvider, type AnyRouterProviderSettings, anyrouter, createAnyRouter };
+export { type AnyRouterChatConfig, AnyRouterChatLanguageModel, type AnyRouterEmbeddingConfig, AnyRouterEmbeddingModel, AnyRouterFiles, type AnyRouterProvider, type AnyRouterProviderSettings, type AppAttribution, FileReferenceCache, PROVIDER_ATTRIBUTION, type ResolvedFileEntry, anyrouter, buildAppAttributionHeaders, createAnyRouter };