@runlot/ai-sdk-provider 0.0.0-stage → 0.1.0-rc.206

package/README.md

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# @runlot/ai-sdk-provider
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [AI SDK](https://ai-sdk.dev) provider over a Runlot worker's `env.ai` binding. Any framework
+that takes an AI SDK model — the AI SDK itself, Mastra, the OpenAI Agents SDK through its AI SDK
+adapter, LangGraph through its AI SDK chat model — calls Runlot's models with it, billed to your
+organization's AI credit or served by your team's lent subscriptions.
+
+```sh
+npm install @runlot/ai-sdk-provider ai@7
+```
+
+```ts
+import { generateText, stepCountIs, tool } from "ai";
+import { z } from "zod";
+import { createRunlot } from "@runlot/ai-sdk-provider";
+
+export default {
+  async fetch(request: Request, env: Env): Promise<Response> {
+    const runlot = createRunlot({ ai: env.ai });
+    const r = await generateText({
+      model: runlot("anthropic/claude-sonnet-5"),
+      prompt: "Weather in Seoul?",
+      tools: {
+        weather: tool({
+          description: "Current weather for a city",
+          inputSchema: z.object({ city: z.string() }),
+          execute: async ({ city }) => ({ city, tempC: 18 }),
+        }),
+      },
+      stopWhen: stepCountIs(4),
+    });
+    return Response.json({ text: r.text });
+  },
+};
+```
+
+- **AI SDK 7.** The provider implements the AI SDK's provider specification v4, which AI SDK 7
+  reads; AI SDK 5 and 6 refuse it with `UnsupportedModelVersionError`.
+- Models: `runlot("<model id>")` for chat, `runlot.embeddingModel("<model id>")` for embeddings.
+  The ids are those of `runlot ai models`.
+- Tool calls run in your code, the framework's loop: the provider asks `env.ai` to return the
+  model's tool calls (`toolMode: "return"`) and sends the results back as structured parts.
+  On a runtime that does not announce `contentParts` in `env.ai.features`, it falls back to
+  writing earlier calls and results into the text, returns at most one tool call per step, and
+  labels each such result with a `compatibility` warning.
+- Usage, including `usage.unreported` for cache counts the provider did not report, is passed
+  through on every step.
+- Frameworks that need Node built-ins (Mastra, the OpenAI Agents SDK, LangGraph) need a
+  `compatibilityDate` that provides them; `runlot deploy` names the date when one is missing.
+
+Documentation: <https://docs.runlot.io/docs/data/ai/agent-frameworks>

package/dist/binding.d.ts

@@ -0,0 +1,128 @@
+/**
+ * One content part of a message (docs/ai.md §2.1): text anywhere, a tool call and a
+ * reasoning block on an assistant turn, a tool result on a user turn.
+ */
+export type RunlotAIPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_call";
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "tool_result";
+    callId: string;
+    text?: string;
+    data?: unknown;
+    isError?: boolean;
+} | {
+    type: "reasoning";
+    text?: string;
+    signature?: string;
+    redacted?: string;
+};
+/**
+ * One conversational message: a role and a string, or — on a runtime whose
+ * `features` lists `contentParts` — an array of parts.
+ */
+export interface RunlotAIMessage {
+    role: "user" | "assistant";
+    content: string | RunlotAIPart[];
+    cacheBreakpoint?: boolean;
+}
+export interface RunlotAIUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    /** The part of `inputTokens` read from the provider's prompt cache. */
+    cachedInputTokens?: number;
+    /** The part of `inputTokens` written to the provider's prompt cache. */
+    cacheWriteInputTokens?: number;
+}
+export interface RunlotAIToolContext {
+    signal: AbortSignal;
+    callId: string;
+    model: string;
+}
+export interface RunlotAITool {
+    name: string;
+    description: string;
+    inputJsonSchema: Record<string, unknown>;
+    /** Run by `env.ai`'s own loop; absent with `toolMode: "return"`. */
+    execute?(args: unknown, ctx: RunlotAIToolContext): Promise<unknown> | unknown;
+}
+export interface RunlotAICacheOptions {
+    mode?: "implicit" | "explicit";
+    ttl?: string;
+    key?: string;
+    system?: boolean;
+}
+export interface RunlotAIMetadata {
+    sessionId?: string;
+    userId?: string;
+    tags?: string[];
+}
+export interface RunlotAIRunOptions {
+    messages: RunlotAIMessage[];
+    system?: string;
+    maxTokens?: number;
+    temperature?: number;
+    stream?: boolean;
+    tools?: RunlotAITool[];
+    /** `"return"`: one model call; the answer carries the tool calls instead of running them. */
+    toolMode?: "execute" | "return";
+    maxToolRounds?: number;
+    reasoning?: {
+        effort: string;
+    };
+    responseFormat?: {
+        type: "json_schema";
+        name?: string;
+        schema: unknown;
+    };
+    cache?: RunlotAICacheOptions;
+    metadata?: RunlotAIMetadata;
+    signal?: AbortSignal;
+}
+export interface RunlotAIFinalTool {
+    id: string;
+    name: string;
+    args: unknown;
+    result: unknown;
+}
+export interface RunlotAIRunResult {
+    text: string;
+    model?: string;
+    stopReason?: string;
+    usage?: RunlotAIUsage;
+    usageComplete?: boolean;
+    finalTool?: RunlotAIFinalTool;
+    /** `toolMode: "return"`: every tool call of the round, `[]` when none. */
+    toolCalls?: {
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }[];
+    /** `toolMode: "return"`: the assistant turn as parts, in the model's order. */
+    content?: RunlotAIPart[];
+}
+export interface RunlotAIEmbedResult {
+    vectors: number[][];
+    dimensions?: number;
+    model?: string;
+    usage?: {
+        inputTokens?: number;
+    };
+}
+/** `env.ai`, as far as this provider uses it. */
+export interface RunlotAIBinding {
+    /** What this runtime takes beyond string messages: `contentParts`, `toolModeReturn`. Absent on an older one. */
+    readonly features?: readonly string[];
+    run(model: string, options: RunlotAIRunOptions): Promise<RunlotAIRunResult | ReadableStream<Uint8Array>>;
+    embed(model: string, input: string | string[], options?: {
+        dimensions?: number;
+        taskType?: string;
+        metadata?: RunlotAIMetadata;
+    }): Promise<RunlotAIEmbedResult>;
+}
+//# sourceMappingURL=binding.d.ts.map

package/dist/binding.d.ts.map

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

package/dist/binding.js

@@ -0,0 +1,7 @@
+// The part of a worker's `env.ai` this provider calls, typed structurally so that the
+// package depends on no Runlot runtime package. The authority is the generated facade
+// (`node/internal/workerd/ai.go`, `aiJS`) and the entry wrapper that runs tools
+// (`node/internal/workerd/email.go`, `wrapAI`); `binding.test.ts` runs this provider
+// against both sources, so a field either of them drops fails there.
+export {};
+//# sourceMappingURL=binding.js.map

package/dist/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,sFAAsF;AACtF,gFAAgF;AAChF,qFAAqF;AACrF,qEAAqE"}

package/dist/embedding-model.d.ts

@@ -0,0 +1,21 @@
+import type { EmbeddingModelV4, EmbeddingModelV4CallOptions, EmbeddingModelV4Result } from "@ai-sdk/provider";
+import type { RunlotAIBinding, RunlotAIMetadata } from "./binding.js";
+export interface RunlotEmbeddingSettings {
+    /** `env.ai.embed`'s `taskType` (what the vectors are for). Absent means the model's default. */
+    taskType?: string;
+    /** `env.ai.embed`'s `dimensions`, when the call does not name its own. */
+    dimensions?: number;
+    metadata?: RunlotAIMetadata;
+}
+export declare class RunlotEmbeddingModel implements EmbeddingModelV4 {
+    readonly modelId: string;
+    private readonly ai;
+    private readonly settings;
+    readonly specificationVersion: "v4";
+    readonly provider = "runlot";
+    readonly maxEmbeddingsPerCall: undefined;
+    readonly supportsParallelCalls = true;
+    constructor(modelId: string, ai: RunlotAIBinding, settings?: RunlotEmbeddingSettings);
+    doEmbed(opts: EmbeddingModelV4CallOptions): Promise<EmbeddingModelV4Result>;
+}
+//# sourceMappingURL=embedding-model.d.ts.map

package/dist/embedding-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-model.d.ts","sourceRoot":"","sources":["../src/embedding-model.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGtE,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAOzD,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,QAAQ,CAAC,oBAAoB,EAAG,IAAI,CAAU;IAC9C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,oBAAoB,YAAa;IAC1C,QAAQ,CAAC,qBAAqB,QAAQ;gBAG3B,OAAO,EAAE,MAAM,EACP,EAAE,EAAE,eAAe,EACnB,QAAQ,GAAE,uBAA4B;IAGnD,OAAO,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAoBlF"}

package/dist/embedding-model.js

@@ -0,0 +1,37 @@
+import { toAPICallError } from "./language-model.js";
+export class RunlotEmbeddingModel {
+    modelId;
+    ai;
+    settings;
+    specificationVersion = "v4";
+    provider = "runlot";
+    maxEmbeddingsPerCall = undefined;
+    supportsParallelCalls = true;
+    constructor(modelId, ai, settings = {}) {
+        this.modelId = modelId;
+        this.ai = ai;
+        this.settings = settings;
+    }
+    async doEmbed(opts) {
+        opts.abortSignal?.throwIfAborted();
+        const dimensions = opts.dimensions ?? this.settings.dimensions;
+        const options = {
+            ...(dimensions === undefined ? {} : { dimensions }),
+            ...(this.settings.taskType === undefined ? {} : { taskType: this.settings.taskType }),
+            ...(this.settings.metadata === undefined ? {} : { metadata: this.settings.metadata }),
+        };
+        try {
+            const r = await this.ai.embed(this.modelId, opts.values, options);
+            const tokens = r.usage?.inputTokens;
+            return {
+                embeddings: r.vectors,
+                ...(typeof tokens === "number" ? { usage: { tokens } } : {}),
+                warnings: [],
+            };
+        }
+        catch (e) {
+            throw toAPICallError(e, { model: this.modelId, input: opts.values, ...options });
+        }
+    }
+}
+//# sourceMappingURL=embedding-model.js.map

package/dist/embedding-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-model.js","sourceRoot":"","sources":["../src/embedding-model.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAUrD,MAAM,OAAO,oBAAoB;IAOpB;IACQ;IACA;IARV,oBAAoB,GAAG,IAAa,CAAC;IACrC,QAAQ,GAAG,QAAQ,CAAC;IACpB,oBAAoB,GAAG,SAAS,CAAC;IACjC,qBAAqB,GAAG,IAAI,CAAC;IAEtC,YACW,OAAe,EACP,EAAmB,EACnB,WAAoC,EAAE;QAF9C,YAAO,GAAP,OAAO,CAAQ;QACP,OAAE,GAAF,EAAE,CAAiB;QACnB,aAAQ,GAAR,QAAQ,CAA8B;IACtD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC/D,MAAM,OAAO,GAAG;YACd,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;YACnD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACrF,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;SACtF,CAAC;QACF,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,CAAC;YACpC,OAAO;gBACL,UAAU,EAAE,CAAC,CAAC,OAAO;gBACrB,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,cAAc,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { type ProviderV4 } from "@ai-sdk/provider";
+import type { RunlotAIBinding } from "./binding.js";
+import { RunlotEmbeddingModel, type RunlotEmbeddingSettings } from "./embedding-model.js";
+import { RunlotLanguageModel, type RunlotModelSettings } from "./language-model.js";
+export type * from "./binding.js";
+export { RunlotEmbeddingModel, type RunlotEmbeddingSettings } from "./embedding-model.js";
+export { RunlotLanguageModel, toAPICallError, type RunlotModelSettings, type RunlotProviderMetadata, } from "./language-model.js";
+export { lowerPrompt, TRANSCRIPT } from "./lower.js";
+export { STRUCTURED, supportsStructured, toStructured, type RunlotReasoningMetadata } from "./structured.js";
+export interface RunlotProviderOptions {
+    /** The worker's `env.ai` binding. */
+    ai: RunlotAIBinding;
+}
+export interface RunlotProvider extends ProviderV4 {
+    (modelId: string, settings?: RunlotModelSettings): RunlotLanguageModel;
+    languageModel(modelId: string, settings?: RunlotModelSettings): RunlotLanguageModel;
+    embeddingModel(modelId: string, settings?: RunlotEmbeddingSettings): RunlotEmbeddingModel;
+    /** The AI SDK's older name for `embeddingModel`. */
+    textEmbeddingModel(modelId: string, settings?: RunlotEmbeddingSettings): RunlotEmbeddingModel;
+}
+/** A provider over `env.ai`. Model ids are the catalog's (`env.ai.models()`, `runlot ai models`). */
+export declare function createRunlot(options: RunlotProviderOptions): RunlotProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEpF,mBAAmB,cAAc,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE7G,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,EAAE,EAAE,eAAe,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;IACvE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;IACpF,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;IAC1F,oDAAoD;IACpD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;CAC/F;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAoB3E"}

package/dist/index.js

@@ -0,0 +1,47 @@
+// @runlot/ai-sdk-provider: an AI SDK provider over a Runlot worker's `env.ai`
+// (docs/agent-frameworks.md §6). Every framework that takes an AI SDK model — the AI SDK
+// itself, Mastra, the OpenAI Agents SDK through `aisdk()` — runs on it:
+//
+//   import { createRunlot } from "@runlot/ai-sdk-provider";
+//   const runlot = createRunlot({ ai: env.ai });
+//   await generateText({ model: runlot("anthropic/claude-sonnet-5"), prompt });
+//
+// The binding is the credential: there is no key, and the call is metered and billed
+// like any other `env.ai.run`.
+//
+// **Tool transcript: structured.** On a runtime whose `env.ai.features` lists
+// `contentParts` and `toolModeReturn` (docs/ai.md §2.1), each step is one
+// `env.ai.run` with `toolMode: "return"`: every tool call of the round comes back, and
+// the calls, their results and a Claude turn's signed thinking go back to the model as
+// native parts (`structured.ts`). On an older runtime the provider falls back to the
+// lowered transcript — labelled text, one call per step, a `compatibility` warning
+// (`lower.ts`). `providerMetadata.runlot.transcript` says which: `"structured"` or
+// `"lowered-text"`.
+import { NoSuchModelError } from "@ai-sdk/provider";
+import { RunlotEmbeddingModel } from "./embedding-model.js";
+import { RunlotLanguageModel } from "./language-model.js";
+export { RunlotEmbeddingModel } from "./embedding-model.js";
+export { RunlotLanguageModel, toAPICallError, } from "./language-model.js";
+export { lowerPrompt, TRANSCRIPT } from "./lower.js";
+export { STRUCTURED, supportsStructured, toStructured } from "./structured.js";
+/** A provider over `env.ai`. Model ids are the catalog's (`env.ai.models()`, `runlot ai models`). */
+export function createRunlot(options) {
+    const { ai } = options;
+    if (ai == null || typeof ai.run !== "function") {
+        throw new TypeError("createRunlot: pass the worker's env.ai binding as { ai: env.ai }");
+    }
+    const languageModel = (modelId, settings) => new RunlotLanguageModel(modelId, ai, settings);
+    const embeddingModel = (modelId, settings) => new RunlotEmbeddingModel(modelId, ai, settings);
+    const provider = ((modelId, settings) => languageModel(modelId, settings));
+    Object.assign(provider, {
+        specificationVersion: "v4",
+        languageModel,
+        embeddingModel,
+        textEmbeddingModel: embeddingModel,
+        imageModel(modelId) {
+            throw new NoSuchModelError({ modelId, modelType: "imageModel", message: "env.ai has no image models" });
+        },
+    });
+    return provider;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yFAAyF;AACzF,wEAAwE;AACxE,EAAE;AACF,4DAA4D;AAC5D,iDAAiD;AACjD,gFAAgF;AAChF,EAAE;AACF,qFAAqF;AACrF,+BAA+B;AAC/B,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,uFAAuF;AACvF,uFAAuF;AACvF,qFAAqF;AACrF,mFAAmF;AACnF,mFAAmF;AACnF,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAmB,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAgC,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAA4B,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EAAE,oBAAoB,EAAgC,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EACL,mBAAmB,EACnB,cAAc,GAGf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAC;AAe7G,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,OAA8B;IACzD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,SAAS,CAAC,kEAAkE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,QAA8B,EAAuB,EAAE,CAC7F,IAAI,mBAAmB,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,CAAC,OAAe,EAAE,QAAkC,EAAwB,EAAE,CACnG,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAe,EAAE,QAA8B,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAmB,CAAC;IAC3H,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACtB,oBAAoB,EAAE,IAAa;QACnC,aAAa;QACb,cAAc;QACd,kBAAkB,EAAE,cAAc;QAClC,UAAU,CAAC,OAAe;YACxB,MAAM,IAAI,gBAAgB,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAC1G,CAAC;KACF,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/language-model.d.ts

@@ -0,0 +1,50 @@
+import { APICallError, type LanguageModelV4, type LanguageModelV4CallOptions, type LanguageModelV4GenerateResult, type LanguageModelV4StreamResult } from "@ai-sdk/provider";
+import type { RunlotAIBinding, RunlotAICacheOptions, RunlotAIMetadata } from "./binding.js";
+import { TRANSCRIPT } from "./lower.js";
+import { STRUCTURED } from "./structured.js";
+/** Per-model settings that ride on every call made through the model. */
+export interface RunlotModelSettings {
+    /** `env.ai.run`'s `cache` (the explicit prompt cache; only on models whose catalog row lists `cacheTTLs`). */
+    cache?: RunlotAICacheOptions;
+    /** `env.ai.run`'s `metadata`: the app's own session, user and tags on the call's record (docs/ai-observability.md). */
+    metadata?: RunlotAIMetadata;
+}
+/** The `providerMetadata.runlot` every result carries. */
+export interface RunlotProviderMetadata {
+    /** False when `usage` is an observed subtotal, not the exact total (docs/ai.md `usageComplete`). */
+    usageComplete: boolean | null;
+    /** `env.ai.run`'s own stop reason (`end_turn`, `max_tokens`, `tool_stop`, …). */
+    stopReason: string | null;
+    /**
+     * How earlier tool calls and results reach the model: as native parts (`structured.ts`),
+     * or as labelled text on a runtime that predates them (`lower.ts`).
+     */
+    transcript: typeof STRUCTURED | typeof TRANSCRIPT;
+}
+/**
+ * `env.ai`'s error as the `APICallError` frameworks know how to read: the gateway's
+ * status as `statusCode`, its code on `data.code` (and on the error itself), and
+ * `isRetryable` from the code — so a retry loop backs off on `rate_limited` and stops
+ * on `no_credit`.
+ */
+export declare function toAPICallError(e: unknown, body: unknown): APICallError;
+export declare class RunlotLanguageModel implements LanguageModelV4 {
+    readonly modelId: string;
+    private readonly ai;
+    private readonly settings;
+    readonly specificationVersion: "v4";
+    readonly provider = "runlot";
+    readonly supportedUrls: Record<string, RegExp[]>;
+    constructor(modelId: string, ai: RunlotAIBinding, settings?: RunlotModelSettings);
+    private prepare;
+    /** A return-mode answer's calls: every call of the round, as `env.ai` returned them. */
+    private returnedCalls;
+    /** The run's tool calls: every call `env.ai` dispatched before the first stop ended the run. */
+    private toolCalls;
+    private call;
+    doGenerate(opts: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
+    doStream(opts: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
+    /** `env.ai`'s SSE (`{"delta"}`, `usage`, `done`, `error`) as AI SDK stream parts. */
+    private translate;
+}
+//# sourceMappingURL=language-model.d.ts.map

package/dist/language-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-model.d.ts","sourceRoot":"","sources":["../src/language-model.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,YAAY,EAGZ,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAG/B,KAAK,6BAA6B,EAElC,KAAK,2BAA2B,EAIjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EAEpB,gBAAgB,EAMjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAe,UAAU,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAa,UAAU,EAAkE,MAAM,iBAAiB,CAAC;AAExH,yEAAyE;AACzE,MAAM,WAAW,mBAAmB;IAClC,8GAA8G;IAC9G,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,uHAAuH;IACvH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,oGAAoG;IACpG,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,iFAAiF;IACjF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,UAAU,EAAE,OAAO,UAAU,GAAG,OAAO,UAAU,CAAC;CACnD;AAuBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,CAwBtE;AA+DD,qBAAa,mBAAoB,YAAW,eAAe;IAMvD,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAP3B,QAAQ,CAAC,oBAAoB,EAAG,IAAI,CAAU;IAC9C,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAM;gBAG3C,OAAO,EAAE,MAAM,EACP,EAAE,EAAE,eAAe,EACnB,QAAQ,GAAE,mBAAwB;IAGrD,OAAO,CAAC,OAAO;IAsGf,wFAAwF;IACxF,OAAO,CAAC,aAAa;IAIrB,gGAAgG;IAChG,OAAO,CAAC,SAAS;YAaH,IAAI;IAmBZ,UAAU,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAkCpF,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAqBtF,qFAAqF;IACrF,OAAO,CAAC,SAAS;CAuHlB"}