ai-sdk-ollama 4.0.0 → 4.2.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 4.2.0
+
+### Minor Changes
+
+- a48c0e1: Add MCP Apps examples demonstrating the host flow for ui:// resources
+
+  - Node example: connect with mcpAppClientCapabilities, split tools by visibility, generateText with model-visible tools, read and fingerprint ui:// HTML resource, simulate iframe proxy allow/deny
+  - Browser example: Vite dev server hosts MCP Apps sandbox, proxies read-resource and call-tool requests, renders interactive dashboard via experimental_MCPAppRenderer
+  - Shared stdio MCP server with dashboard resource, model+app tool, and app-only refresh tool
+
+## 4.1.0
+
+### Minor Changes
+
+- 514304a: Support two AI SDK v7 provider-spec features that were previously unimplemented:
+
+  - `includeRawChunks`: `doStream` now emits `{ type: 'raw', rawValue }` parts carrying each unmodified Ollama chunk when the option is set (off by default).
+  - `usage.raw`: `doGenerate`/`doStream` now expose Ollama's own counters and timings (`prompt_eval_count`, `eval_count`, `total_duration`, `load_duration`, `prompt_eval_duration`, `eval_duration`) on `usage.raw`.
+
+  The streaming `finish` part now also carries the same `providerMetadata` that `doGenerate` already returned.
+
+  Internally, the two files that had grown past 1000 lines were split into focused modules with no behaviour change. `models/chat-language-model.ts` keeps the `LanguageModelV4` implementation and reliability orchestration, with request mapping in `models/chat-request.ts`, result assembly in `models/chat-result.ts`, and the streaming state machine in `models/chat-stream.ts`. `utils/object-generation-reliability.ts` keeps recovery orchestration, with JSON text repair in `utils/json-text-repair.ts` and schema fallback/coercion in `utils/json-schema-coercion.ts`. `enhancedRepairText`, `cascadeRepairText` and the `RepairTextFunction` type are still exported from the package root; only the internal module paths changed.
+
 ## 4.0.0
 
 ### Major Changes

package/README.md

@@ -1029,6 +1029,8 @@ For detailed testing information, see [Integration Tests Documentation](./src/in
 
 🔗 **[MCP Tools Example](../../examples/node/src/mcp-tools-example.ts)** - Model Context Protocol integration
 
+🧩 **[MCP Apps Example](../../examples/node/src/mcp-apps-example.ts)** - MCP Apps host flow (ui:// resources, split tools, iframe proxy)
+
 🔧 **[JSON repair example](../../examples/node/src/json-repair-example.ts)** - Object generation with repair options and custom repair
 
 🔀 **[Cascade repair example](../../examples/node/src/test-cascade-repair.ts)** - `cascadeRepairText` and `enhancedRepairText` (jsonrepair + Ollama-specific)

package/dist/functions/generate-text.d.ts

@@ -0,0 +1,63 @@
+/**
+ * generateText - Enhanced generateText with Ollama-specific reliability
+ *
+ * This wrapper provides response synthesis and enhanced tool calling reliability
+ * that addresses the core Ollama limitation: tools execute but no final text is generated.
+ */
+import { generateText as _generateText } from 'ai';
+/**
+ * Enhanced options for Ollama-specific reliability features
+ */
+export interface EnhancedOptions {
+    /**
+     * Enable response synthesis when tools are called but no text is generated
+     * @default true
+     */
+    enableSynthesis?: boolean;
+    /**
+     * Custom synthesis prompt template
+     */
+    synthesisPrompt?: string;
+    /**
+     * Maximum attempts for synthesis
+     * @default 2
+     */
+    maxSynthesisAttempts?: number;
+    /**
+     * Minimum response length to consider valid
+     * @default 10
+     */
+    minResponseLength?: number;
+    /**
+     * EXPERIMENTAL: Enable tool calling with structured output (output)
+     *
+     * The official AI SDK doesn't support combining toolChoice: 'required' with output.
+     * When enabled, this uses a two-phase approach:
+     * 1. Execute tools first (without output)
+     * 2. Generate structured output with tool results injected as context
+     *
+     * This is NOT standard AI SDK behavior - only enable if you need both features together.
+     *
+     * @default false
+     */
+    enableToolsWithStructuredOutput?: boolean;
+}
+/**
+ * Enhanced generateText options that extend the official AI SDK options
+ */
+export type GenerateTextOptions = Parameters<typeof _generateText>[0] & {
+    /**
+     * Enhanced options for Ollama-specific reliability features
+     */
+    enhancedOptions?: EnhancedOptions;
+};
+/**
+ * Enhanced generateText function with Ollama-specific reliability improvements
+ *
+ * This function applies synthesis by default when tools execute but return empty responses.
+ * The enhancement preserves the original response prototype and all methods/getters.
+ *
+ * Type parameters are inferred from the options, preserving AI SDK's type inference.
+ */
+export declare function generateText(options: GenerateTextOptions): Promise<Awaited<ReturnType<typeof _generateText>>>;
+//# sourceMappingURL=generate-text.d.ts.map

package/dist/functions/generate-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-text.d.ts","sourceRoot":"","sources":["../../src/functions/generate-text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,IAAI,aAAa,EAAe,MAAM,IAAI,CAAC;AAqBhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG;IACtE;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CA4NpD"}

package/dist/functions/stream-text.d.ts

@@ -0,0 +1,25 @@
+import { streamText as _streamText } from 'ai';
+type AIStreamTextOptions = Parameters<typeof _streamText>[0];
+export type StreamTextOptions = AIStreamTextOptions & {
+    enhancedOptions?: {
+        /**
+         * @default true
+         */
+        enableToolLogging?: boolean;
+        /**
+         * @default true
+         */
+        enableStreamingSynthesis?: boolean;
+        /**
+         * @default 10
+         */
+        minStreamLength?: number;
+        /**
+         * @default 3000
+         */
+        synthesisTimeout?: number;
+    };
+};
+export declare function streamText(options: StreamTextOptions): Promise<Awaited<ReturnType<typeof _streamText>>>;
+export {};
+//# sourceMappingURL=stream-text.d.ts.map

package/dist/functions/stream-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-text.d.ts","sourceRoot":"","sources":["../../src/functions/stream-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,WAAW,EAAe,MAAM,IAAI,CAAC;AAE5D,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAsC7D,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG;IACpD,eAAe,CAAC,EAAE;QAChB;;WAEG;QACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B;;WAEG;QACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;QACnC;;WAEG;QACH,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AAUF,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAsclD"}