@polpo-ai/llm 0.15.4 → 0.15.6

package/dist/index.d.ts

@@ -16,4 +16,6 @@ export { estimateCost } from "./cost.js";
 export type { CostEstimate, LanguageModelUsage } from "./cost.js";
 export { isProviderInCooldown, markProviderCooldown, clearProviderCooldown, getProviderCooldowns, classifyProviderError, } from "./cooldown.js";
 export { queryText, queryStream, queryTextWithFallback, } from "./query.js";
+export { streamModelTurn, } from "./stream-turn.js";
+export type { ModelTurnEvent, ModelTurnResult, StreamModelTurnInput, } from "./stream-turn.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY,EAEZ,aAAa,EACb,UAAU,EACV,0BAA0B,EAE1B,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EAErB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGlE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY,EAEZ,aAAa,EACb,UAAU,EACV,0BAA0B,EAE1B,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EAErB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGlE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -28,4 +28,6 @@ export { estimateCost } from "./cost.js";
 export { isProviderInCooldown, markProviderCooldown, clearProviderCooldown, getProviderCooldowns, classifyProviderError, } from "./cooldown.js";
 // ─── Query Functions ──────────���──────────────────────
 export { queryText, queryStream, queryTextWithFallback, } from "./query.js";
+// ─── Model Turn Primitive ───────────────────────────
+export { streamModelTurn, } from "./stream-turn.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,wDAAwD;AACxD,OAAO;AACL,kBAAkB;AAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY;AACZ,wCAAwC;AACxC,aAAa,EACb,UAAU,EACV,0BAA0B;AAC1B,qBAAqB;AACrB,oBAAoB,EACpB,oBAAoB;AACpB,kBAAkB;AAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB;AACrB,sBAAsB;AACtB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAO7B,yDAAyD;AACzD,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,wDAAwD;AACxD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,wDAAwD;AACxD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,wDAAwD;AACxD,OAAO;AACL,kBAAkB;AAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY;AACZ,wCAAwC;AACxC,aAAa,EACb,UAAU,EACV,0BAA0B;AAC1B,qBAAqB;AACrB,oBAAoB,EACpB,oBAAoB;AACpB,kBAAkB;AAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB;AACrB,sBAAsB;AACtB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAO7B,yDAAyD;AACzD,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,wDAAwD;AACxD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,wDAAwD;AACxD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,uDAAuD;AACvD,OAAO,EACL,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/stream-turn.d.ts

@@ -0,0 +1,73 @@
+import { type FinishReason, type LanguageModel, type LanguageModelUsage, type ModelMessage, type ProviderMetadata, type StreamTextResult, type ToolChoice, type ToolSet, type TypedToolCall, type TypedToolResult } from "ai";
+export type ModelTurnEvent<TOOLS extends ToolSet = ToolSet> = {
+    type: "reasoning-delta";
+    id: string;
+    text: string;
+} | {
+    type: "text-delta";
+    id: string;
+    text: string;
+} | {
+    type: "tool-input-start";
+    id: string;
+    name: string;
+    providerExecuted?: boolean;
+    dynamic?: boolean;
+    title?: string;
+} | {
+    type: "tool-input-delta";
+    id: string;
+    delta: string;
+} | {
+    type: "tool-input-end";
+    id: string;
+} | {
+    type: "tool-call";
+    id: string;
+    name: string;
+    args: unknown;
+    providerExecuted?: boolean;
+    dynamic?: boolean;
+} | {
+    type: "tool-result";
+    id: string;
+    name: string;
+    output: unknown;
+} | {
+    type: "tool-error";
+    id: string;
+    name: string;
+    error: unknown;
+} | {
+    type: "finish";
+    finishReason: FinishReason;
+    rawFinishReason?: string;
+    totalUsage?: LanguageModelUsage;
+} | {
+    type: "error";
+    error: unknown;
+};
+export type ModelTurnResult<TOOLS extends ToolSet = ToolSet> = {
+    text: string;
+    toolCalls: TypedToolCall<TOOLS>[];
+    toolResults: TypedToolResult<TOOLS>[];
+    usage: LanguageModelUsage;
+    totalUsage: LanguageModelUsage;
+    finishReason: FinishReason;
+    rawFinishReason?: string;
+    providerMetadata?: ProviderMetadata;
+    responseMessages: unknown[];
+    response?: Awaited<StreamTextResult<TOOLS, any>["response"]>;
+};
+export type StreamModelTurnInput<TOOLS extends ToolSet = ToolSet> = {
+    model: LanguageModel;
+    system?: string;
+    messages: ModelMessage[];
+    tools?: TOOLS;
+    toolChoice?: ToolChoice<TOOLS>;
+    maxOutputTokens?: number;
+    providerOptions?: Record<string, unknown>;
+    abortSignal?: AbortSignal;
+};
+export declare function streamModelTurn<TOOLS extends ToolSet = ToolSet>(input: StreamModelTurnInput<TOOLS>, onEvent?: (event: ModelTurnEvent<TOOLS>) => void | Promise<void>): Promise<ModelTurnResult<TOOLS>>;
+//# sourceMappingURL=stream-turn.d.ts.map

package/dist/stream-turn.d.ts.map

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

package/dist/stream-turn.js

@@ -0,0 +1,110 @@
+import { streamText, } from "ai";
+export async function streamModelTurn(input, onEvent) {
+    const result = streamText({
+        model: input.model,
+        ...(input.system ? { system: input.system } : {}),
+        messages: input.messages,
+        ...(input.tools ? { tools: input.tools } : {}),
+        ...(input.toolChoice ? { toolChoice: input.toolChoice } : {}),
+        ...(input.maxOutputTokens ? { maxOutputTokens: input.maxOutputTokens } : {}),
+        ...(input.providerOptions ? { providerOptions: input.providerOptions } : {}),
+        ...(input.abortSignal ? { abortSignal: input.abortSignal } : {}),
+    });
+    let text = "";
+    for await (const part of result.fullStream) {
+        switch (part.type) {
+            case "reasoning-delta":
+                await onEvent?.({ type: "reasoning-delta", id: part.id, text: part.text });
+                break;
+            case "text-delta":
+                text += part.text;
+                await onEvent?.({ type: "text-delta", id: part.id, text: part.text });
+                break;
+            case "tool-input-start":
+                await onEvent?.({
+                    type: "tool-input-start",
+                    id: part.id,
+                    name: part.toolName,
+                    providerExecuted: part.providerExecuted,
+                    dynamic: part.dynamic,
+                    title: part.title,
+                });
+                break;
+            case "tool-input-delta":
+                await onEvent?.({ type: "tool-input-delta", id: part.id, delta: part.delta });
+                break;
+            case "tool-input-end":
+                await onEvent?.({ type: "tool-input-end", id: part.id });
+                break;
+            case "tool-call":
+                await onEvent?.({
+                    type: "tool-call",
+                    id: part.toolCallId,
+                    name: part.toolName,
+                    args: part.input,
+                    providerExecuted: part.providerExecuted,
+                    dynamic: part.dynamic,
+                });
+                break;
+            case "tool-result":
+                await onEvent?.({
+                    type: "tool-result",
+                    id: part.toolCallId,
+                    name: part.toolName,
+                    output: part.output,
+                });
+                break;
+            case "tool-error":
+                await onEvent?.({
+                    type: "tool-error",
+                    id: part.toolCallId,
+                    name: part.toolName,
+                    error: part.error,
+                });
+                break;
+            case "finish":
+                await onEvent?.({
+                    type: "finish",
+                    finishReason: part.finishReason,
+                    rawFinishReason: part.rawFinishReason,
+                    totalUsage: part.totalUsage,
+                });
+                break;
+            case "error":
+                await onEvent?.({ type: "error", error: part.error });
+                break;
+        }
+    }
+    const responsePromise = Promise.resolve()
+        .then(() => result.response)
+        .catch(() => undefined);
+    const providerMetadataPromise = Promise.resolve()
+        .then(() => result.providerMetadata)
+        .catch(() => undefined);
+    const toolResultsPromise = Promise.resolve()
+        .then(() => result.toolResults)
+        .catch(() => []);
+    const [toolCalls, toolResults, usage, totalUsage, finishReason, rawFinishReason, response, providerMetadata] = await Promise.all([
+        result.toolCalls,
+        toolResultsPromise,
+        result.usage,
+        result.totalUsage,
+        result.finishReason,
+        result.rawFinishReason,
+        responsePromise,
+        providerMetadataPromise,
+    ]);
+    return {
+        text,
+        toolCalls,
+        toolResults,
+        usage,
+        totalUsage,
+        finishReason,
+        rawFinishReason,
+        providerMetadata,
+        responseMessages: response?.messages ?? [],
+        response,
+    };
+}
+//# sourceMappingURL=stream-turn.js.map

package/dist/stream-turn.js.map

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

package/dist/stream-turn.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stream-turn.test.d.ts.map

package/dist/stream-turn.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-turn.test.d.ts","sourceRoot":"","sources":["../src/stream-turn.test.ts"],"names":[],"mappings":""}

package/dist/stream-turn.test.js

@@ -0,0 +1,91 @@
+import { describe, expect, it } from "vitest";
+import { jsonSchema } from "ai";
+import { MockLanguageModelV3, convertArrayToReadableStream } from "ai/test";
+import { streamModelTurn } from "./stream-turn.js";
+function usage() {
+    return {
+        inputTokens: { total: 10, noCache: undefined, cacheRead: undefined, cacheWrite: undefined },
+        outputTokens: { total: 5, text: undefined, reasoning: undefined },
+    };
+}
+function mockModel(parts) {
+    return new MockLanguageModelV3({
+        doGenerate: {
+            content: [{ type: "text", text: "unused" }],
+            finishReason: { unified: "stop", raw: undefined },
+            usage: usage(),
+            warnings: [],
+        },
+        doStream: {
+            stream: convertArrayToReadableStream(parts),
+        },
+    });
+}
+describe("streamModelTurn", () => {
+    it("streams text events and returns response messages", async () => {
+        const events = [];
+        const model = mockModel([
+            { type: "stream-start", warnings: [] },
+            { type: "text-start", id: "txt_1" },
+            { type: "text-delta", id: "txt_1", delta: "Hello" },
+            { type: "text-delta", id: "txt_1", delta: " world" },
+            { type: "text-end", id: "txt_1" },
+            { type: "finish", finishReason: { unified: "stop", raw: undefined }, usage: usage() },
+        ]);
+        const result = await streamModelTurn({
+            model,
+            messages: [{ role: "user", content: "Say hello" }],
+        }, (event) => {
+            events.push(event);
+        });
+        expect(result.text).toBe("Hello world");
+        expect(events).toEqual([
+            { type: "text-delta", id: "txt_1", text: "Hello" },
+            { type: "text-delta", id: "txt_1", text: " world" },
+            expect.objectContaining({ type: "finish", finishReason: "stop" }),
+        ]);
+        expect(result.toolCalls).toEqual([]);
+        expect(result.responseMessages.length).toBeGreaterThan(0);
+    });
+    it("streams tool input deltas before the completed tool call", async () => {
+        const events = [];
+        const model = mockModel([
+            { type: "stream-start", warnings: [] },
+            { type: "tool-input-start", id: "call_1", toolName: "bash" },
+            { type: "tool-input-delta", id: "call_1", delta: "{\"command\":" },
+            { type: "tool-input-delta", id: "call_1", delta: "\"pwd\"}" },
+            { type: "tool-input-end", id: "call_1" },
+            { type: "tool-call", toolCallId: "call_1", toolName: "bash", input: "{\"command\":\"pwd\"}" },
+            { type: "finish", finishReason: { unified: "tool-calls", raw: undefined }, usage: usage() },
+        ]);
+        const result = await streamModelTurn({
+            model,
+            messages: [{ role: "user", content: "Run pwd" }],
+            tools: {
+                bash: {
+                    description: "Run a shell command",
+                    inputSchema: jsonSchema({
+                        type: "object",
+                        properties: { command: { type: "string" } },
+                        required: ["command"],
+                    }),
+                },
+            },
+        }, (event) => {
+            events.push(event);
+        });
+        expect(events).toEqual([
+            { type: "tool-input-start", id: "call_1", name: "bash", providerExecuted: undefined, dynamic: false, title: undefined },
+            { type: "tool-input-delta", id: "call_1", delta: "{\"command\":" },
+            { type: "tool-input-delta", id: "call_1", delta: "\"pwd\"}" },
+            { type: "tool-input-end", id: "call_1" },
+            { type: "tool-call", id: "call_1", name: "bash", args: { command: "pwd" }, providerExecuted: undefined, dynamic: undefined },
+            expect.objectContaining({ type: "finish", finishReason: "tool-calls" }),
+        ]);
+        expect(result.toolCalls).toHaveLength(1);
+        expect(result.toolCalls[0]?.toolName).toBe("bash");
+        expect(result.toolCalls[0]?.input).toEqual({ command: "pwd" });
+        expect(result.responseMessages.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=stream-turn.test.js.map

package/dist/stream-turn.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polpo-ai/llm",
-  "version": "0.15.4",
+  "version": "0.15.6",
   "description": "LLM abstraction for Polpo — multi-provider model resolution, streaming, cost tracking, and failover built on Vercel AI SDK + AI Gateway",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
   "dependencies": {
     "@ai-sdk/openai": "^3.0.48",
     "@ai-sdk/openai-compatible": "^2.0.37",
-    "@polpo-ai/core": "0.15.4"
+    "@polpo-ai/core": "0.15.6"
   },
   "peerDependencies": {
     "@ai-sdk/gateway": ">=3.0.0",