v2.0.0

BREAKING CHANGE(vercel-ai-sdk): migrate to Vercel AI SDK v6 and introduce provider registry (getModel) returning LanguageModelV3
v0.13.3
2026-03-05 19:37:29 +00:00 · 2026-03-05 19:37:29 +00:00 · 2026-01-20 03:55:09 +00:00 · 2026-01-20 03:55:09 +00:00 · 2026-01-20 03:54:51 +00:00 · 2026-01-20 02:50:46 +00:00
50 changed files with 13750 additions and 4381 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -3,7 +3,6 @@
 # artifacts
 coverage/
 public/
-pages/

 # installs
 node_modules/
@@ -17,4 +16,8 @@ node_modules/
 dist/
 dist_*/

-# custom
+# AI
+.claude/
+.serena/
+
+#------# custom
--- a/changelog.md
+++ b/changelog.md
@@ -0,0 +1,427 @@
+# Changelog
+
+## 2026-03-05 - 2.0.0 - BREAKING CHANGE(vercel-ai-sdk)
+migrate to Vercel AI SDK v6 and introduce provider registry (getModel) returning LanguageModelV3
+
+- Major API rewrite and module reorganization; bump package version to 1.0.0
+- Replace many legacy provider implementations with @ai-sdk/* providers and a new Ollama adapter (LanguageModelV3-based)
+- Add subpath exports for capability packages: ./vision, ./audio, ./image, ./document, ./research
+- Introduce Anthropic prompt-caching middleware and provider-level promptCaching option
+- Split functionality into focused ts_* packages (ts_audio, ts_image, ts_document, ts_vision, ts_research) and adapt tests accordingly
+- Update dependencies and devDependencies to use ai SDK providers and newer package versions
+
+## 2026-01-20 - 0.13.3 - fix()
+no changes detected
+
+- No files changed in the provided diff.
+- No version bump required.
+
+## 2026-01-20 - 0.13.2 - fix(repo)
+no changes detected in diff; nothing to commit
+
+- Git diff reported no changes — no files modified
+- No code or dependency updates detected, so no version bump required
+
+## 2026-01-20 - 0.13.1 - fix()
+no changes detected; no release required
+
+- No changes found in the provided git diff
+- Current package version is 0.13.0
+
+## 2026-01-20 - 0.13.0 - feat(provider.ollama)
+add chain-of-thought reasoning support to chat messages and Ollama provider
+
+- Added optional reasoning?: string to chat message and chat response interfaces to surface chain-of-thought data.
+- Propagates reasoning from message history into formatted requests sent to Ollama.
+- Maps Ollama response fields (thinking or reasoning) into ChatResponse.reasoning so downstream code can access model reasoning output.
+
+## 2026-01-20 - 0.12.1 - fix(docs)
+update documentation: clarify provider capabilities, add provider capabilities summary, polish examples and formatting, and remove Serena project config
+
+- Removed .serena/project.yml and cleaned up .serena/.gitignore
+- Added Provider Capabilities Summary and expanded/clarified provider tables in readme.md and readme.hints.md
+- Clarified Anthropic extended thinking details and Mistral native PDF OCR notes
+- Polished example code snippets and fixed minor typos/formatting (GPT-5 mention, ElevenLabs model note, consistent punctuation)
+- Updated test command references and other README usage instructions
+
+## 2026-01-20 - 0.12.0 - feat(ollama)
+add support for base64-encoded images in chat messages and forward them to the Ollama provider
+
+- Add optional images?: string[] to ChatMessage and ChatOptions interfaces (multimodal/vision support)
+- Propagate images from messageHistory and ChatOptions to the Ollama API payload in chat, chatStreaming, and streaming handlers
+- Changes are non-breaking: images are optional and existing behavior is preserved when absent
+
+## 2026-01-20 - 0.11.0 - feat(ollama)
+support defaultOptions and defaultTimeout for ollama provider
+
+- Added ollama.defaultOptions object with fields: num_ctx, temperature, top_k, top_p, repeat_penalty, num_predict, stop, seed
+- Added ollama.defaultTimeout option
+- Pass defaultOptions and defaultTimeout into OllamaProvider constructor when initializing the provider
+- Non-breaking change: existing behavior preserved if new fields are undefined
+
+## 2026-01-20 - 0.10.1 - fix()
+no changes detected — no release necessary
+
+- No files changed in the provided diff; there are no code, documentation, or configuration modifications to release.
+
+## 2026-01-18 - 0.10.0 - feat(mistral)
+add Mistral provider with native PDF OCR and chat integration
+
+- Adds dependency @mistralai/mistralai
+- Implements ts/provider.mistral.ts providing chat() and document() (OCR) functionality
+- Registers and exposes MistralProvider in SmartAi (options, lifecycle, conversation routing)
+- Adds unit/integration tests: test.chat.mistral.ts and test.document.mistral.ts
+- Updates readme.hints.md with Mistral usage, configuration and notes
+
+## 2026-01-18 - 0.9.0 - feat(providers)
+Add Anthropic extended thinking and adapt providers to new streaming/file APIs; bump dependencies and update docs, tests and configuration
+
+- Add IAnthropicProviderOptions.extendedThinking with thinking modes (quick/normal/deep/off) and getThinkingConfig mapping budgets; apply thinking to Anthropic requests and omit temperature when thinking is enabled.
+- Update Anthropic research flow to include thinking configuration and conditionally set temperature.
+- OpenAI image editing: use openai.toFile to convert image/mask Buffers to uploadable files (image/png) before sending.
+- ElevenLabs streaming: switch from response.streamNode() to response.stream() and convert web stream to Node stream using Readable.fromWeb().
+- Upgrade dependencies and dev tools: @anthropic-ai/sdk ^0.71.2, @push.rocks/smartrequest ^5.0.1, @git.zone/tsbuild and related @git.zone packages, and other bumps in package.json.
+- Tests and test imports updated to use @git.zone/tstest/tapbundle; many test files adjusted accordingly.
+- Docs and hints updated: README and readme.hints.md include extended thinking docs, examples, formatting fixes, security/issue reporting guidance, and trademark/license clarifications.
+- Project config tweaks: package build script changed, tsconfig baseUrl/paths added, npmextra.json reorganized (release registries added), .gitignore updated to ignore .claude/.serena local tooling files.
+
+## 2025-10-30 - 0.8.0 - feat(provider.anthropic)
+
+Add extended thinking modes to AnthropicProvider and apply thinking budgets to API calls
+
+- Introduce IAnthropicProviderOptions.extendedThinking to configure thinking modes: 'quick' | 'normal' | 'deep' | 'off'.
+- Add getThinkingConfig() helper mapping modes to token budgets (quick=2048, normal=8000, deep=16000, off=0).
+- Apply thinking configuration to Anthropic API calls (chat, chatStream, vision, document, research) and increase max_tokens where appropriate (up to 20000).
+- Add comprehensive tests (test/test.thinking.anthropic.ts) and update readme.hints.md with usage examples and recommendations.
+- Add .claude/settings.local.json for local assistant permissions used in development/testing.
+
+## 2025-10-10 - 0.7.7 - fix(MultiModalModel)
+
+Lazy-load SmartPdf and guard document processing across providers; ensure SmartPdf is initialized only when needed
+
+- Make SmartPdf lazy-loaded: smartpdfInstance is now nullable and no longer started automatically in start()
+- Add ensureSmartpdfReady() to initialize and start SmartPdf on demand before document processing
+- Providers updated (OpenAI, Anthropic, Ollama, xAI) to call ensureSmartpdfReady() and use the smartpdfInstance for PDF -> image conversion
+- stop() now cleans up and nullifies smartpdfInstance to release resources
+- Avoids starting a browser/process unless document() is actually used (reduces unnecessary resource usage)
+- Add local Claude permissions file (.claude/settings.local.json) for tooling/configuration
+
+## 2025-10-09 - 0.7.6 - fix(provider.elevenlabs)
+
+Provide default ElevenLabs TTS voice fallback and add local tool/project configs
+
+- ElevenLabsProvider: fallback to Samara voice id ('19STyYD15bswVz51nqLf') when no voiceId or defaultVoiceId is provided — avoids throwing an error on TTS calls.
+- ElevenLabsProvider: continue to use 'eleven_v3' as the default model for TTS.
+- Add .claude/settings.local.json with expanded allowed permissions for local tooling and web search.
+- Add .serena/project.yml and .serena/.gitignore to include Serena project configuration and ignore cache.
+
+## 2025-10-08 - 0.7.5 - fix(provider.elevenlabs)
+
+Update ElevenLabs default TTS model to eleven_v3 and add local Claude permissions file
+
+- Changed default ElevenLabs modelId from 'eleven_multilingual_v2' to 'eleven_v3' in ts/provider.elevenlabs.ts to use the newer/default TTS model.
+- Added .claude/settings.local.json with a permissions allow-list for local Claude tooling and CI tasks.
+
+## 2025-10-03 - 0.7.4 - fix(provider.anthropic)
+
+Use image/png for embedded PDF images in Anthropic provider and add local Claude settings for development permissions
+
+- AnthropicProvider: change media_type from 'image/jpeg' to 'image/png' when embedding images extracted from PDFs to ensure correct format in Anthropic requests.
+- Add .claude/settings.local.json with development/testing permissions for local Claude usage (shell commands, webfetch, websearch, test/run tasks).
+
+## 2025-10-03 - 0.7.3 - fix(tests)
+
+Add extensive provider/feature tests and local Claude CI permissions
+
+- Add many focused test files covering providers and features: OpenAI, Anthropic, Perplexity, Groq, Ollama, Exo, XAI (chat, audio, vision, document, research, image generation, stubs, interfaces, basic)
+- Introduce .claude/settings.local.json to declare allowed permissions for local Claude/CI actions
+- Replace older aggregated test files with modular per-feature tests (removed legacy combined tests and split into smaller suites)
+- No changes to library runtime code — this change adds tests and CI/local agent configuration only
+
+## 2025-10-03 - 0.7.2 - fix(anthropic)
+
+Update Anthropic provider branding to Claude Sonnet 4.5 and add local Claude permissions
+
+- Docs: Replace 'Claude 3 Opus' with 'Claude Sonnet 4.5' in README provider capabilities matrix.
+- Config: Add .claude/settings.local.json to define local Claude permissions for tests and development commands.
+
+## 2025-10-03 - 0.7.1 - fix(docs)
+
+Add README image generation docs and .claude local settings
+
+- Add .claude/settings.local.json with permission allow-list for local assistant tooling and web search
+- Update README provider capabilities table to include an Images column and reference gpt-image-1
+- Add Image Generation & Editing section with examples, options, and gpt-image-1 advantages
+- Mark image generation support as implemented in the roadmap and remove duplicate entry
+
+## 2025-10-03 - 0.7.0 - feat(providers)
+
+Add research API and image generation/editing support; extend providers and tests
+
+- Introduce ResearchOptions and ResearchResponse to the MultiModalModel interface and implement research() where supported
+- OpenAiProvider: implement research(), add imageGenerate() and imageEdit() methods (gpt-image-1 / DALL·E support), and expose imageModel option
+- AnthropicProvider: implement research() and vision handling; explicitly throw for unsupported image generation/editing
+- PerplexityProvider: implement research() (sonar / sonar-pro support) and expose citation parsing
+- Add image/document-related interfaces (ImageGenerateOptions, ImageEditOptions, ImageResponse) to abstract API
+- Add image generation/editing/no-op stubs for other providers (Exo, Groq, Ollama, XAI) that throw informative errors to preserve API compatibility
+- Add comprehensive OpenAI image generation tests and helper to save test outputs (test/test.image.openai.ts)
+- Update README with Research & Web Search documentation, capability matrix, and roadmap entry for Research & Web Search API
+- Add local Claude agent permissions file (.claude/settings.local.json) and various provider type/import updates
+
+## 2025-09-28 - 0.6.1 - fix(provider.anthropic)
+
+Fix Anthropic research tool identifier and add tests + local Claude permissions
+
+- Replace Anthropic research tool type from 'computer_20241022' to 'web_search_20250305' to match the expected web-search tool schema.
+- Add comprehensive test suites and fixtures for providers and research features (new/updated tests under test/ including anthropic, openai, research.\* and stubs).
+- Fix test usage of XAI provider class name (use XAIProvider) and adjust basic provider test expectations (provider instantiation moved to start()).
+- Add .claude/settings.local.json with local Claude permissions to allow common CI/dev commands and web search during testing.
+
+## 2025-09-28 - 0.6.0 - feat(research)
+
+Introduce research API with provider implementations, docs and tests
+
+- Add ResearchOptions and ResearchResponse interfaces and a new abstract research() method to MultiModalModel
+- Implement research() for OpenAiProvider (deep research model selection, optional web search/tools, background flag, source extraction)
+- Implement research() for AnthropicProvider (web search tool support, domain filters, citation extraction)
+- Implement research() for PerplexityProvider (sonar / sonar-pro model usage and citation parsing)
+- Add research() stubs to Exo, Groq, Ollama and XAI providers that throw a clear 'not yet supported' error to preserve interface compatibility
+- Add tests for research interfaces and provider research methods (test files updated/added)
+- Add documentation: readme.research.md describing the research API, usage and configuration
+- Export additional providers from ts/index.ts and update provider typings/imports across files
+- Add a 'typecheck' script to package.json
+- Add .claude/settings.local.json (local agent permissions for CI/dev tasks)
+
+## 2025-08-12 - 0.5.11 - fix(openaiProvider)
+
+Update default chat model to gpt-5-mini and bump dependency versions
+
+- Changed default chat model in OpenAiProvider from 'o3-mini' and 'o4-mini' to 'gpt-5-mini'
+- Upgraded @anthropic-ai/sdk from ^0.57.0 to ^0.59.0
+- Upgraded openai from ^5.11.0 to ^5.12.2
+- Added new local Claude settings configuration (.claude/settings.local.json)
+
+## 2025-08-03 - 0.5.10 - fix(dependencies)
+
+Update SmartPdf to v4.1.1 for enhanced PDF processing capabilities
+
+- Updated @push.rocks/smartpdf from ^3.3.0 to ^4.1.1
+- Enhanced PDF conversion with improved scale options and quality controls
+- Dependency updates for better performance and compatibility
+
+## 2025-08-01 - 0.5.9 - fix(documentation)
+
+Remove contribution section from readme
+
+- Removed the contribution section from readme.md as requested
+- Kept the roadmap section for future development plans
+
+## 2025-08-01 - 0.5.8 - fix(core)
+
+Fix SmartPdf lifecycle management and update dependencies
+
+- Moved SmartPdf instance management to the MultiModalModel base class for better resource sharing
+- Fixed memory leaks by properly implementing cleanup in the base class stop() method
+- Updated SmartAi class to properly stop all providers on shutdown
+- Updated @push.rocks/smartrequest from v2.1.0 to v4.2.1 with migration to new API
+- Enhanced readme with professional documentation and feature matrix
+
+## 2025-07-26 - 0.5.7 - fix(provider.openai)
+
+Fix stream type mismatch in audio method
+
+- Fixed type error where OpenAI SDK returns a web ReadableStream but the audio method needs to return a Node.js ReadableStream
+- Added conversion using Node.js's built-in Readable.fromWeb() method
+
+## 2025-07-25 - 0.5.5 - feat(documentation)
+
+Comprehensive documentation enhancement and test improvements
+
+- Completely rewrote readme.md with detailed provider comparisons, advanced usage examples, and performance tips
+- Added comprehensive examples for all supported providers (OpenAI, Anthropic, Perplexity, Groq, XAI, Ollama, Exo)
+- Included detailed sections on chat interactions, streaming, TTS, vision processing, and document analysis
+- Added verbose flag to test script for better debugging
+
+## 2025-05-13 - 0.5.4 - fix(provider.openai)
+
+Update dependency versions, clean test imports, and adjust default OpenAI model configurations
+
+- Bump dependency versions in package.json (@git.zone/tsbuild, @push.rocks/tapbundle, openai, etc.)
+- Change default chatModel from 'gpt-4o' to 'o4-mini' and visionModel from 'gpt-4o' to '04-mini' in provider.openai.ts
+- Remove unused 'expectAsync' import from test file
+
+## 2025-04-03 - 0.5.3 - fix(package.json)
+
+Add explicit packageManager field to package.json
+
+- Include the packageManager property to specify the pnpm version and checksum.
+- Align package metadata with current standards.
+
+## 2025-04-03 - 0.5.2 - fix(readme)
+
+Remove redundant conclusion section from README to streamline documentation.
+
+- Eliminated the conclusion block describing SmartAi's capabilities and documentation pointers.
+
+## 2025-02-25 - 0.5.1 - fix(OpenAiProvider)
+
+Corrected audio model ID in OpenAiProvider
+
+- Fixed audio model identifier from 'o3-mini' to 'tts-1-hd' in the OpenAiProvider's audio method.
+- Addressed minor code formatting issues in test suite for better readability.
+- Corrected spelling errors in test documentation and comments.
+
+## 2025-02-25 - 0.5.0 - feat(documentation and configuration)
+
+Enhanced package and README documentation
+
+- Expanded the package description to better reflect the library's capabilities.
+- Improved README with detailed usage examples for initialization, chat interactions, streaming chat, audio generation, document analysis, and vision processing.
+- Provided error handling strategies and advanced streaming customization examples.
+
+## 2025-02-25 - 0.4.2 - fix(core)
+
+Fix OpenAI chat streaming and PDF document processing logic.
+
+- Updated OpenAI chat streaming to handle new async iterable format.
+- Improved PDF document processing by filtering out empty image buffers.
+- Removed unsupported temperature options from OpenAI requests.
+
+## 2025-02-25 - 0.4.1 - fix(provider)
+
+Fix provider modules for consistency
+
+- Updated TypeScript interfaces and options in provider modules for better type safety.
+- Modified transform stream handlers in Exo, Groq, and Ollama providers for consistency.
+- Added optional model options to OpenAI provider for custom model usage.
+
+## 2025-02-08 - 0.4.0 - feat(core)
+
+Added support for Exo AI provider
+
+- Introduced ExoProvider with chat functionalities.
+- Updated SmartAi class to initialize ExoProvider.
+- Extended Conversation class to support ExoProvider.
+
+## 2025-02-05 - 0.3.3 - fix(documentation)
+
+Update readme with detailed license and legal information.
+
+- Added explicit section on License and Legal Information in the README.
+- Clarified the use of trademarks and company information.
+
+## 2025-02-05 - 0.3.2 - fix(documentation)
+
+Remove redundant badges from readme
+
+- Removed Build Status badge from the readme file.
+- Removed License badge from the readme file.
+
+## 2025-02-05 - 0.3.1 - fix(documentation)
+
+Updated README structure and added detailed usage examples
+
+- Introduced a Table of Contents
+- Included comprehensive sections for chat, streaming chat, audio generation, document processing, and vision processing
+- Added example code and detailed configuration steps for supported AI providers
+- Clarified the development setup with instructions for running tests and building the project
+
+## 2025-02-05 - 0.3.0 - feat(integration-xai)
+
+Add support for X.AI provider with chat and document processing capabilities.
+
+- Introduced XAIProvider class for integrating X.AI features.
+- Implemented chat streaming and synchronous chat for X.AI.
+- Enabled document processing capabilities with PDF conversion in X.AI.
+
+## 2025-02-03 - 0.2.0 - feat(provider.anthropic)
+
+Add support for vision and document processing in Anthropic provider
+
+- Implemented vision tasks for Anthropic provider using Claude-3-opus-20240229 model.
+- Implemented document processing for Anthropic provider, supporting conversion of PDF documents to images and analysis with Claude-3-opus-20240229 model.
+- Updated documentation to reflect the new capabilities of the Anthropic provider.
+
+## 2025-02-03 - 0.1.0 - feat(providers)
+
+Add vision and document processing capabilities to providers
+
+- OpenAI and Ollama providers now support vision tasks using GPT-4 Vision and Llava models respectively.
+- Document processing has been implemented for OpenAI and Ollama providers, converting PDFs to images for analysis.
+- Introduced abstract methods for vision and document processing in the MultiModalModel class.
+- Updated the readme file with examples for vision and document processing.
+
+## 2025-02-03 - 0.0.19 - fix(core)
+
+Enhanced chat streaming and error handling across providers
+
+- Refactored chatStream method to properly handle input streams and processes in Perplexity, OpenAI, Ollama, and Anthropic providers.
+- Improved error handling and message parsing in chatStream implementations.
+- Defined distinct interfaces for chat options, messages, and responses.
+- Adjusted the test logic in test/test.ts for the new classification response requirement.
+
+## 2024-09-19 - 0.0.18 - fix(dependencies)
+
+Update dependencies to the latest versions.
+
+- Updated @git.zone/tsbuild from ^2.1.76 to ^2.1.84
+- Updated @git.zone/tsrun from ^1.2.46 to ^1.2.49
+- Updated @push.rocks/tapbundle from ^5.0.23 to ^5.3.0
+- Updated @types/node from ^20.12.12 to ^22.5.5
+- Updated @anthropic-ai/sdk from ^0.21.0 to ^0.27.3
+- Updated @push.rocks/smartfile from ^11.0.14 to ^11.0.21
+- Updated @push.rocks/smartpromise from ^4.0.3 to ^4.0.4
+- Updated @push.rocks/webstream from ^1.0.8 to ^1.0.10
+- Updated openai from ^4.47.1 to ^4.62.1
+
+## 2024-05-29 - 0.0.17 - Documentation
+
+Updated project description.
+
+- Improved project description for clarity and details.
+
+## 2024-05-17 - 0.0.16 to 0.0.15 - Core
+
+Fixes and updates.
+
+- Various core updates and fixes for stability improvements.
+
+## 2024-04-29 - 0.0.14 to 0.0.13 - Core
+
+Fixes and updates.
+
+- Multiple core updates and fixes for enhanced functionality.
+
+## 2024-04-29 - 0.0.12 - Core
+
+Fixes and updates.
+
+- Core update and bug fixes.
+
+## 2024-04-29 - 0.0.11 - Provider
+
+Fix integration for anthropic provider.
+
+- Correction in the integration process with anthropic provider for better compatibility.
+
+## 2024-04-27 - 0.0.10 to 0.0.9 - Core
+
+Fixes and updates.
+
+- Updates and fixes to core components.
+- Updated tsconfig for improved TypeScript configuration.
+
+## 2024-04-01 - 0.0.8 to 0.0.7 - Core and npmextra
+
+Core updates and npmextra configuration.
+
+- Core fixes and updates.
+- Updates to npmextra.json for githost configuration.
+
+## 2024-03-31 - 0.0.6 to 0.0.2 - Core
+
+Initial core updates and fixes.
+
+- Multiple updates and fixes to core following initial versions.
+
+This summarizes the relevant updates and changes based on the provided commit messages. The changelog excludes commits that are version tags without meaningful content or repeated entries.
--- a/19
+++ b/19
@@ -0,0 +1,19 @@
+Copyright (c) 2024 Task Venture Capital GmbH (hello@task.vc)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
--- a/npmextra.json
+++ b/npmextra.json
@@ -1,33 +1,51 @@
 {
-  "gitzone": {
+  "@git.zone/cli": {
    "projectType": "npm",
    "module": {
      "githost": "code.foss.global",
      "gitscope": "push.rocks",
      "gitrepo": "smartai",
-      "description": "Provides a standardized interface for integrating and conversing with multiple AI models, supporting operations like chat and potentially audio responses.",
+      "description": "SmartAi is a versatile TypeScript library designed to facilitate integration and interaction with various AI models, offering functionalities for chat, audio generation, document processing, and vision tasks.",
      "npmPackagename": "@push.rocks/smartai",
      "license": "MIT",
      "projectDomain": "push.rocks",
      "keywords": [
-        "AI models integration",
-        "OpenAI GPT",
-        "Anthropic AI",
-        "text-to-speech",
-        "conversation stream",
+        "AI integration",
        "TypeScript",
-        "ESM",
-        "streaming API",
-        "modular design",
-        "development tool"
+        "chatbot",
+        "OpenAI",
+        "Anthropic",
+        "multi-model",
+        "audio generation",
+        "text-to-speech",
+        "document processing",
+        "vision processing",
+        "streaming chat",
+        "API",
+        "multiple providers",
+        "AI models",
+        "synchronous chat",
+        "asynchronous chat",
+        "real-time interaction",
+        "content analysis",
+        "image description",
+        "document classification",
+        "AI toolkit",
+        "provider switching"
+      ]
+    },
+    "release": {
+      "accessLevel": "public",
+      "registries": [
+        "https://verdaccio.lossless.digital",
+        "https://registry.npmjs.org"
      ]
    }
  },
-  "npmci": {
-    "npmGlobalTools": [],
-    "npmAccessLevel": "public"
-  },
-  "tsdoc": {
+  "@git.zone/tsdoc": {
    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
+  },
+  "@ship.zone/szci": {
+    "npmGlobalTools": []
  }
 }
--- a/package.json
+++ b/package.json
@@ -1,71 +1,121 @@
 {
  "name": "@push.rocks/smartai",
-  "version": "0.0.12",
+  "version": "2.0.0",
  "private": false,
-  "description": "Provides a standardized interface for integrating and conversing with multiple AI models, supporting operations like chat and potentially audio responses.",
+  "description": "Provider registry and capability utilities for ai-sdk (Vercel AI SDK). Core export returns LanguageModel; subpath exports provide vision, audio, image, document and research capabilities.",
  "main": "dist_ts/index.js",
  "typings": "dist_ts/index.d.ts",
  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist_ts/index.js",
+      "types": "./dist_ts/index.d.ts"
+    },
+    "./vision": {
+      "import": "./dist_ts_vision/index.js",
+      "types": "./dist_ts_vision/index.d.ts"
+    },
+    "./audio": {
+      "import": "./dist_ts_audio/index.js",
+      "types": "./dist_ts_audio/index.d.ts"
+    },
+    "./image": {
+      "import": "./dist_ts_image/index.js",
+      "types": "./dist_ts_image/index.d.ts"
+    },
+    "./document": {
+      "import": "./dist_ts_document/index.js",
+      "types": "./dist_ts_document/index.d.ts"
+    },
+    "./research": {
+      "import": "./dist_ts_research/index.js",
+      "types": "./dist_ts_research/index.d.ts"
+    }
+  },
  "author": "Task Venture Capital GmbH",
  "license": "MIT",
  "scripts": {
-    "test": "(tstest test/ --web)",
-    "build": "(tsbuild --web --allowimplicitany)",
+    "test": "(tstest test/ --verbose --logfile)",
+    "typecheck": "tsbuild check",
+    "build": "(tsbuild tsfolders --allowimplicitany)",
    "buildDocs": "(tsdoc)"
  },
  "devDependencies": {
-    "@git.zone/tsbuild": "^2.1.25",
-    "@git.zone/tsbundle": "^2.0.5",
-    "@git.zone/tsrun": "^1.2.46",
-    "@git.zone/tstest": "^1.0.90",
-    "@push.rocks/qenv": "^6.0.5",
-    "@push.rocks/tapbundle": "^5.0.23",
-    "@types/node": "^20.12.7"
+    "@git.zone/tsbuild": "^4.2.6",
+    "@git.zone/tsbundle": "^2.9.1",
+    "@git.zone/tsrun": "^2.0.1",
+    "@git.zone/tstest": "^3.2.0",
+    "@push.rocks/qenv": "^6.1.3",
+    "@types/node": "^25.3.3",
+    "typescript": "^5.9.3"
  },
  "dependencies": {
-    "@anthropic-ai/sdk": "^0.20.7",
-    "@push.rocks/smartarray": "^1.0.8",
-    "@push.rocks/smartfile": "^11.0.14",
-    "@push.rocks/smartpath": "^5.0.18",
-    "@push.rocks/smartpdf": "^3.1.5",
-    "@push.rocks/smartpromise": "^4.0.3",
-    "@push.rocks/smartrequest": "^2.0.22",
-    "@push.rocks/webstream": "^1.0.8",
-    "openai": "^4.38.5"
+    "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/google": "^3.0.43",
+    "@ai-sdk/groq": "^3.0.29",
+    "@ai-sdk/mistral": "^3.0.24",
+    "@ai-sdk/openai": "^3.0.41",
+    "@ai-sdk/perplexity": "^3.0.23",
+    "@ai-sdk/provider": "^3.0.8",
+    "@ai-sdk/xai": "^3.0.67",
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@push.rocks/smartpdf": "^4.1.3",
+    "ai": "^6.0.116",
+    "openai": "^6.26.0"
  },
  "repository": {
    "type": "git",
-    "url": "git+https://code.foss.global/push.rocks/smartai.git"
+    "url": "https://code.foss.global/push.rocks/smartai.git"
  },
  "bugs": {
    "url": "https://code.foss.global/push.rocks/smartai/issues"
  },
-  "homepage": "https://code.foss.global/push.rocks/smartai#readme",
+  "homepage": "https://code.foss.global/push.rocks/smartai",
  "browserslist": [
    "last 1 chrome versions"
  ],
  "files": [
    "ts/**/*",
-    "ts_web/**/*",
-    "dist/**/*",
+    "ts_vision/**/*",
+    "ts_audio/**/*",
+    "ts_image/**/*",
+    "ts_document/**/*",
+    "ts_research/**/*",
    "dist_*/**/*",
-    "dist_ts/**/*",
-    "dist_ts_web/**/*",
    "assets/**/*",
-    "cli.js",
    "npmextra.json",
    "readme.md"
  ],
  "keywords": [
-    "AI models integration",
-    "OpenAI GPT",
-    "Anthropic AI",
-    "text-to-speech",
-    "conversation stream",
+    "AI integration",
    "TypeScript",
-    "ESM",
-    "streaming API",
-    "modular design",
-    "development tool"
-  ]
+    "chatbot",
+    "OpenAI",
+    "Anthropic",
+    "multi-model",
+    "audio generation",
+    "text-to-speech",
+    "document processing",
+    "vision processing",
+    "streaming chat",
+    "API",
+    "multiple providers",
+    "AI models",
+    "synchronous chat",
+    "asynchronous chat",
+    "real-time interaction",
+    "content analysis",
+    "image description",
+    "document classification",
+    "AI toolkit",
+    "provider switching"
+  ],
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "puppeteer"
+    ],
+    "overrides": {}
+  },
+  "packageManager": "pnpm@10.7.0+sha512.6b865ad4b62a1d9842b61d674a393903b871d9244954f652b8842c2b553c72176b278f64c463e52d40fff8aba385c235c8c9ecf5cc7de4fd78b8bb6d49633ab6"
 }
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/readme.hints.md
+++ b/readme.hints.md
@@ -1 +1,50 @@
- 
+# SmartAI Project Hints
+
+## Architecture (v1.0.0 - Vercel AI SDK rewrite)
+
+The package is a **provider registry** built on the Vercel AI SDK (`ai` v6). The core export returns a `LanguageModelV3` from `@ai-sdk/provider`. Specialized capabilities are in subpath exports.
+
+### Core Entry (`ts/`)
+- `getModel(options)` → returns `LanguageModelV3` for any supported provider
+- Providers: anthropic, openai, google, groq, mistral, xai, perplexity, ollama
+- Anthropic prompt caching via `wrapLanguageModel` middleware (enabled by default)
+- Custom Ollama provider implementing `LanguageModelV3` directly (for think, num_ctx support)
+
+### Subpath Exports
+- `@push.rocks/smartai/vision` — `analyzeImage()` using `generateText` with image content
+- `@push.rocks/smartai/audio` — `textToSpeech()` using OpenAI SDK directly
+- `@push.rocks/smartai/image` — `generateImage()`, `editImage()` using OpenAI SDK directly
+- `@push.rocks/smartai/document` — `analyzeDocuments()` using SmartPdf + `generateText`
+- `@push.rocks/smartai/research` — `research()` using `@anthropic-ai/sdk` web_search tool
+
+## Dependencies
+
+- `ai` ^6.0.116 — Vercel AI SDK core
+- `@ai-sdk/*` — Provider packages (anthropic, openai, google, groq, mistral, xai, perplexity)
+- `@ai-sdk/provider` ^3.0.8 — LanguageModelV3 types
+- `@anthropic-ai/sdk` ^0.78.0 — Direct SDK for research (web search tool)
+- `openai` ^6.25.0 — Direct SDK for audio TTS and image generation/editing
+- `@push.rocks/smartpdf` ^4.1.3 — PDF to PNG conversion for document analysis
+
+## Build
+
+- `pnpm build` → `tsbuild tsfolders --allowimplicitany`
+- Compiles: ts/, ts_vision/, ts_audio/, ts_image/, ts_document/, ts_research/
+
+## Important Notes
+
+- LanguageModelV3 uses `unified`/`raw` in FinishReason (not `type`/`rawType`)
+- LanguageModelV3 system messages have `content: string` (not array)
+- LanguageModelV3 file parts use `mediaType` (not `mimeType`)
+- LanguageModelV3FunctionTool uses `inputSchema` (not `parameters`)
+- Ollama `think` param goes at request body top level, not inside `options`
+- Qwen models get default temperature 0.55 in the custom Ollama provider
+- `qenv.getEnvVarOnDemand()` returns a Promise — must be awaited in tests
+
+## Testing
+
+```bash
+pnpm test                            # all tests
+tstest test/test.smartai.ts --verbose # core tests
+tstest test/test.ollama.ts --verbose  # ollama provider tests (mocked, no API needed)
+```
--- a/readme.md
+++ b/readme.md
@@ -1,128 +1,447 @@
 # @push.rocks/smartai

-Provides a standardized interface for integrating and conversing with multiple AI models, supporting operations like chat and potentially audio responses.
+**A unified provider registry for the Vercel AI SDK** 🧠⚡

-## Install
+[![npm version](https://img.shields.io/npm/v/@push.rocks/smartai.svg)](https://www.npmjs.com/package/@push.rocks/smartai)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

-To add @push.rocks/smartai to your project, run the following command in your terminal:
+SmartAI gives you a single `getModel()` function that returns a standard `LanguageModelV3` for **any** supported provider — Anthropic, OpenAI, Google, Groq, Mistral, XAI, Perplexity, or Ollama. Use the returned model with the Vercel AI SDK's `generateText()`, `streamText()`, and tool ecosystem. Specialized capabilities like vision, audio, image generation, document analysis, and web research are available as dedicated subpath imports.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## 🎯 Why SmartAI?
+
+- **🔌 One function, eight providers** — `getModel()` returns a standard `LanguageModelV3`. Switch providers by changing a string.
+- **🧱 Built on Vercel AI SDK** — Uses `ai` v6 under the hood. Your model works with `generateText()`, `streamText()`, tool calling, structured output, and everything else in the AI SDK ecosystem.
+- **🏠 Custom Ollama provider** — A full `LanguageModelV3` implementation for Ollama with support for `think` mode, `num_ctx`, auto-tuned temperature for Qwen models, and native tool calling.
+- **💰 Anthropic prompt caching** — Automatic `cacheControl` middleware reduces cost and latency on repeated calls. Enabled by default, opt out with `promptCaching: false`.
+- **📦 Modular subpath exports** — Vision, audio, image, document, and research capabilities ship as separate imports. Only import what you need.
+- **⚡ Zero lock-in** — Your code uses standard AI SDK types. Swap providers without touching application logic.
+
+## 📦 Installation

 ```bash
-npm install @push.rocks/smartai
+pnpm install @push.rocks/smartai
 ```

-This command installs the package and adds it to your project's dependencies.
-
-## Usage
-
-The usage section delves into how to leverage the `@push.rocks/smartai` package to interact with AI models in an application. This package simplifies the integration and conversation with AI models by providing a standardized interface. The examples below demonstrate the package's capabilities in engaging with AI models for chat operations and potentially handling audio responses using TypeScript and ESM syntax.
-
-### Integrating AI Models
-
-#### Importing the Module
-
-Start by importing `SmartAi` and the AI providers you wish to use from `@push.rocks/smartai`.
+## 🚀 Quick Start

 ```typescript
-import { SmartAi, OpenAiProvider, AnthropicProvider } from '@push.rocks/smartai';
-```
+import { getModel, generateText, streamText } from '@push.rocks/smartai';

-#### Initializing `SmartAi`
-
-Create an instance of `SmartAi` with the necessary credentials for accessing the AI services.
-
-```typescript
-const smartAi = new SmartAi({
-  openaiToken: 'your-openai-access-token',
-  anthropicToken: 'your-anthropic-access-token'
+// Get a model for any provider
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
 });
+
+// Use it with the standard AI SDK functions
+const result = await generateText({
+  model,
+  prompt: 'Explain quantum computing in simple terms.',
+});
+
+console.log(result.text);
 ```

-### Chatting with the AI
+That's it. Change `provider` to `'openai'` and `model` to `'gpt-4o'` and the rest of your code stays exactly the same.

-#### Creating a Conversation
+## 🔧 Core API

-To begin a conversation, choose the AI provider you'd like to use. For instance, to use OpenAI:
+### `getModel(options): LanguageModelV3`
+
+The primary export. Returns a standard `LanguageModelV3` you can use with any AI SDK function.

 ```typescript
-async function createOpenAiConversation() {
-  const conversation = await smartAi.createOpenApiConversation();
-  // Use the conversation for chatting
+import { getModel } from '@push.rocks/smartai';
+import type { ISmartAiOptions } from '@push.rocks/smartai';
+
+const options: ISmartAiOptions = {
+  provider: 'anthropic',  // 'anthropic' | 'openai' | 'google' | 'groq' | 'mistral' | 'xai' | 'perplexity' | 'ollama'
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: 'sk-ant-...',
+  // Anthropic-only: prompt caching (default: true)
+  promptCaching: true,
+  // Ollama-only: base URL (default: http://localhost:11434)
+  baseUrl: 'http://localhost:11434',
+  // Ollama-only: model runtime options
+  ollamaOptions: { think: true, num_ctx: 4096 },
+};
+
+const model = getModel(options);
+```
+
+### Re-exported AI SDK Functions
+
+SmartAI re-exports the most commonly used functions from `ai` for convenience:
+
+```typescript
+import {
+  getModel,
+  generateText,
+  streamText,
+  tool,
+  jsonSchema,
+} from '@push.rocks/smartai';
+
+import type {
+  ModelMessage,
+  ToolSet,
+  StreamTextResult,
+  LanguageModelV3,
+} from '@push.rocks/smartai';
+```
+
+## 🤖 Supported Providers
+
+| Provider | Package | Example Models |
+|----------|---------|----------------|
+| **Anthropic** | `@ai-sdk/anthropic` | `claude-sonnet-4-5-20250929`, `claude-opus-4-5-20250929` |
+| **OpenAI** | `@ai-sdk/openai` | `gpt-4o`, `gpt-4o-mini`, `o3-mini` |
+| **Google** | `@ai-sdk/google` | `gemini-2.0-flash`, `gemini-2.5-pro` |
+| **Groq** | `@ai-sdk/groq` | `llama-3.3-70b-versatile`, `mixtral-8x7b-32768` |
+| **Mistral** | `@ai-sdk/mistral` | `mistral-large-latest`, `mistral-small-latest` |
+| **XAI** | `@ai-sdk/xai` | `grok-3`, `grok-3-mini` |
+| **Perplexity** | `@ai-sdk/perplexity` | `sonar-pro`, `sonar` |
+| **Ollama** | Custom `LanguageModelV3` | `qwen3:8b`, `llama3:8b`, `deepseek-r1` |
+
+## 💬 Text Generation
+
+### Generate Text
+
+```typescript
+import { getModel, generateText } from '@push.rocks/smartai';
+
+const model = getModel({
+  provider: 'openai',
+  model: 'gpt-4o',
+  apiKey: process.env.OPENAI_TOKEN,
+});
+
+const result = await generateText({
+  model,
+  system: 'You are a helpful assistant.',
+  prompt: 'What is 2 + 2?',
+});
+
+console.log(result.text); // "4"
+```
+
+### Stream Text
+
+```typescript
+import { getModel, streamText } from '@push.rocks/smartai';
+
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+});
+
+const result = await streamText({
+  model,
+  prompt: 'Count from 1 to 10.',
+});
+
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
 }
 ```

-Similarly, for an Anthropic AI conversation:
+### Tool Calling

 ```typescript
-async function createAnthropicConversation() {
-  const conversation = await smartAi.createAnthropicConversation();
-  // Use the conversation for chatting
-}
-```
+import { getModel, generateText, tool, jsonSchema } from '@push.rocks/smartai';

-### Streaming Chat with OpenAI
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+});

-For more advanced scenarios, like a streaming chat with OpenAI, you would interact with the chat stream directly:
-
-```typescript
-// Assuming a conversation has been created and initialized...
-const inputStreamWriter = conversation.getInputStreamWriter();
-const outputStream = conversation.getOutputStream();
-
-// Write a message to the input stream for the AI to process
-await inputStreamWriter.write('Hello, how can I help you today?');
-
-// Listen to the output stream for responses from AI
-const reader = outputStream.getReader();
-reader.read().then(function processText({ done, value }) {
-  if (done) {
-    console.log("No more messages from AI");
-    return;
-  }
-  console.log("AI says:", value);
-  // Continue reading messages
-  reader.read().then(processText);
+const result = await generateText({
+  model,
+  prompt: 'What is the weather in London?',
+  tools: {
+    getWeather: tool({
+      description: 'Get weather for a location',
+      parameters: jsonSchema({
+        type: 'object',
+        properties: {
+          location: { type: 'string' },
+        },
+        required: ['location'],
+      }),
+      execute: async ({ location }) => {
+        return { temperature: 18, condition: 'cloudy' };
+      },
+    }),
+  },
 });
 ```

-### Handling Audio Responses
+## 🏠 Ollama (Local Models)

-The package may also support converting text responses from the AI into audio. While specific implementation details depend on the AI provider's capabilities, a generic approach would involve creating a text-to-speech instance and utilizing it:
+The custom Ollama provider implements `LanguageModelV3` directly, calling Ollama's native `/api/chat` endpoint. This gives you features that generic OpenAI-compatible wrappers miss:

 ```typescript
-// This is a hypothetical function call as the implementation might vary
-const tts = await TTS.createWithOpenAi(smartAi);
+import { getModel, generateText } from '@push.rocks/smartai';

-// The TTS instance would then be used to convert text to speech
+const model = getModel({
+  provider: 'ollama',
+  model: 'qwen3:8b',
+  baseUrl: 'http://localhost:11434', // default
+  ollamaOptions: {
+    think: true,      // Enable thinking/reasoning mode
+    num_ctx: 8192,     // Context window size
+    temperature: 0.7,  // Override default (Qwen models auto-default to 0.55)
+  },
+});
+
+const result = await generateText({
+  model,
+  prompt: 'Solve this step by step: what is 15% of 340?',
+});
+
+console.log(result.text);
 ```

-### Extensive Feature Set
+### Ollama Features

-`@push.rocks/smartai` provides comprehensive support for interacting with various AI models, not limited to text chat. It encompasses audio responses, potentially incorporating AI-powered analyses, and other multi-modal interactions.
+- **`think` mode** — Enables reasoning for models that support it (Qwen3, QwQ, DeepSeek-R1). The `think` parameter is sent at the top level of the request body as required by the Ollama API.
+- **Auto-tuned temperature** — Qwen models automatically get `temperature: 0.55` when no explicit temperature is set, matching the recommended inference setting.
+- **Native tool calling** — Full tool call support via Ollama's native format (not shimmed through OpenAI-compatible endpoints).
+- **Streaming with reasoning** — `doStream()` emits proper `reasoning-start`, `reasoning-delta`, `reasoning-end` parts alongside text.
+- **All Ollama options** — `num_ctx`, `top_k`, `top_p`, `repeat_penalty`, `num_predict`, `stop`, `seed`.

-Refer to the specific AI providers’ documentation through `@push.rocks/smartai`, such as OpenAI and Anthropic, for detailed guidance on utilizing the full spectrum of capabilities, including the implementation of custom conversation flows, handling streaming data efficiently, and generating audio responses from AI conversations.
+## 💰 Anthropic Prompt Caching

-### Conclusion
+When using the Anthropic provider, SmartAI automatically wraps the model with caching middleware that adds `cacheControl: { type: 'ephemeral' }` to the last system message and last user message. This can significantly reduce cost and latency for repeated calls with the same system prompt.

-Equipped with `@push.rocks/smartai`, developers can streamline the integration of sophisticated AI interactions into their applications. The package facilitates robust communication with AI models, supporting diverse operations from simple chats to complex audio feedback mechanisms, all within a unified, easy-to-use interface.
+```typescript
+// Caching enabled by default
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+});

-Explore the package more to uncover its full potential in creating engaging, AI-enhanced interactions in your applications.
+// Opt out of caching
+const modelNoCaching = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+  promptCaching: false,
+});
+```

+You can also use the middleware directly:
+
+```typescript
+import { createAnthropicCachingMiddleware } from '@push.rocks/smartai';
+import { wrapLanguageModel } from 'ai';
+
+const middleware = createAnthropicCachingMiddleware();
+const cachedModel = wrapLanguageModel({ model: baseModel, middleware });
+```
+
+## 📦 Subpath Exports
+
+SmartAI provides specialized capabilities as separate subpath imports. Each one is a focused utility that takes a model (or API key) and does one thing well.
+
+### 👁️ Vision — `@push.rocks/smartai/vision`
+
+Analyze images using any vision-capable model.
+
+```typescript
+import { analyzeImage } from '@push.rocks/smartai/vision';
+import { getModel } from '@push.rocks/smartai';
+import * as fs from 'fs';
+
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+});
+
+const description = await analyzeImage({
+  model,
+  image: fs.readFileSync('photo.jpg'),
+  prompt: 'Describe this image in detail.',
+  mediaType: 'image/jpeg', // optional, defaults to 'image/jpeg'
+});
+
+console.log(description);
+```
+
+**`analyzeImage(options)`** accepts:
+- `model` — Any `LanguageModelV3` with vision support
+- `image` — `Buffer` or `Uint8Array`
+- `prompt` — What to ask about the image
+- `mediaType` — `'image/jpeg'` | `'image/png'` | `'image/webp'` | `'image/gif'`
+
+### 🎙️ Audio — `@push.rocks/smartai/audio`
+
+Text-to-speech using OpenAI's TTS models.
+
+```typescript
+import { textToSpeech } from '@push.rocks/smartai/audio';
+import * as fs from 'fs';
+
+const stream = await textToSpeech({
+  apiKey: process.env.OPENAI_TOKEN,
+  text: 'Welcome to the future of AI development!',
+  voice: 'nova',     // 'alloy' | 'echo' | 'fable' | 'onyx' | 'nova' | 'shimmer'
+  model: 'tts-1-hd', // 'tts-1' | 'tts-1-hd'
+  responseFormat: 'mp3', // 'mp3' | 'opus' | 'aac' | 'flac'
+  speed: 1.0,         // 0.25 to 4.0
+});
+
+stream.pipe(fs.createWriteStream('welcome.mp3'));
+```
+
+### 🎨 Image — `@push.rocks/smartai/image`
+
+Generate and edit images using OpenAI's image models.
+
+```typescript
+import { generateImage, editImage } from '@push.rocks/smartai/image';
+
+// Generate an image
+const result = await generateImage({
+  apiKey: process.env.OPENAI_TOKEN,
+  prompt: 'A futuristic cityscape at sunset, digital art',
+  model: 'gpt-image-1',     // 'gpt-image-1' | 'dall-e-3' | 'dall-e-2'
+  quality: 'high',           // 'low' | 'medium' | 'high' | 'auto'
+  size: '1024x1024',
+  background: 'transparent', // gpt-image-1 only
+  outputFormat: 'png',       // 'png' | 'jpeg' | 'webp'
+  n: 1,
+});
+
+// result.images[0].b64_json — base64-encoded image data
+const imageBuffer = Buffer.from(result.images[0].b64_json!, 'base64');
+
+// Edit an existing image
+const edited = await editImage({
+  apiKey: process.env.OPENAI_TOKEN,
+  image: imageBuffer,
+  prompt: 'Add a rainbow in the sky',
+  model: 'gpt-image-1',
+});
+```
+
+### 📄 Document — `@push.rocks/smartai/document`
+
+Analyze PDF documents by converting them to images and using a vision model. Uses `@push.rocks/smartpdf` for PDF-to-PNG conversion (requires Chromium/Puppeteer).
+
+```typescript
+import { analyzeDocuments, stopSmartpdf } from '@push.rocks/smartai/document';
+import { getModel } from '@push.rocks/smartai';
+import * as fs from 'fs';
+
+const model = getModel({
+  provider: 'anthropic',
+  model: 'claude-sonnet-4-5-20250929',
+  apiKey: process.env.ANTHROPIC_TOKEN,
+});
+
+const analysis = await analyzeDocuments({
+  model,
+  systemMessage: 'You are a legal document analyst.',
+  userMessage: 'Summarize the key terms and conditions.',
+  pdfDocuments: [fs.readFileSync('contract.pdf')],
+  messageHistory: [],  // optional: prior conversation context
+});
+
+console.log(analysis);
+
+// Clean up the SmartPdf instance when done
+await stopSmartpdf();
+```
+
+### 🔬 Research — `@push.rocks/smartai/research`
+
+Perform web-search-powered research using Anthropic's `web_search_20250305` tool.
+
+```typescript
+import { research } from '@push.rocks/smartai/research';
+
+const result = await research({
+  apiKey: process.env.ANTHROPIC_TOKEN,
+  query: 'What are the latest developments in quantum computing?',
+  searchDepth: 'basic',     // 'basic' | 'advanced' | 'deep'
+  maxSources: 10,           // optional: limit number of search results
+  allowedDomains: ['nature.com', 'arxiv.org'],  // optional: restrict to domains
+  blockedDomains: ['reddit.com'],               // optional: exclude domains
+});
+
+console.log(result.answer);
+console.log('Sources:', result.sources);       // Array<{ url, title, snippet }>
+console.log('Queries:', result.searchQueries); // search queries the model used
+```
+
+## 🧪 Testing
+
+```bash
+# All tests
+pnpm test
+
+# Individual test files
+tstest test/test.smartai.ts --verbose    # Core getModel + generateText + streamText
+tstest test/test.ollama.ts --verbose     # Ollama provider (mocked, no API needed)
+tstest test/test.vision.ts --verbose     # Vision analysis
+tstest test/test.image.ts --verbose      # Image generation
+tstest test/test.research.ts --verbose   # Web research
+tstest test/test.audio.ts --verbose      # Text-to-speech
+tstest test/test.document.ts --verbose   # Document analysis (needs Chromium)
+```
+
+Most tests skip gracefully when API keys are not set. The Ollama tests are fully mocked and require no external services.
+
+## 📐 Architecture
+
+```
+@push.rocks/smartai
+├── ts/                          # Core package
+│   ├── index.ts                 # Re-exports getModel, AI SDK functions, types
+│   ├── smartai.classes.smartai.ts  # getModel() — provider switch
+│   ├── smartai.interfaces.ts    # ISmartAiOptions, TProvider, IOllamaModelOptions
+│   ├── smartai.provider.ollama.ts  # Custom LanguageModelV3 for Ollama
+│   ├── smartai.middleware.anthropic.ts  # Prompt caching middleware
+│   └── plugins.ts               # AI SDK provider factories
+├── ts_vision/                   # @push.rocks/smartai/vision
+├── ts_audio/                    # @push.rocks/smartai/audio
+├── ts_image/                    # @push.rocks/smartai/image
+├── ts_document/                 # @push.rocks/smartai/document
+└── ts_research/                 # @push.rocks/smartai/research
+```
+
+The core package is a thin registry. `getModel()` creates the appropriate `@ai-sdk/*` provider, calls it with the model ID, and returns the resulting `LanguageModelV3`. For Anthropic, it optionally wraps the model with prompt caching middleware. For Ollama, it returns a custom `LanguageModelV3` implementation that talks directly to Ollama's `/api/chat` endpoint.
+
+Subpath modules are independent — they import `ai` and provider SDKs directly, not through the core package. This keeps the dependency graph clean and allows tree-shaking.

 ## License and Legal Information

-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.

 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

 ### Trademarks

-This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.

 ### Company Information

-Task Venture Capital GmbH  
-Registered at District court Bremen HRB 35230 HB, Germany
+Task Venture Capital GmbH
+Registered at District Court Bremen HRB 35230 HB, Germany

-For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
+For any legal inquiries or further information, please contact us via email at hello@task.vc.

 By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
--- a/test/test.audio.ts
+++ b/test/test.audio.ts
@@ -0,0 +1,36 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import { textToSpeech } from '../ts_audio/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('textToSpeech should return a readable stream', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('OPENAI_TOKEN');
+  if (!apiKey) {
+    console.log('OPENAI_TOKEN not set, skipping test');
+    return;
+  }
+
+  const stream = await textToSpeech({
+    apiKey,
+    text: 'Hello, this is a test of the text to speech system.',
+    voice: 'alloy',
+    model: 'tts-1',
+  });
+
+  expect(stream).toBeTruthy();
+  expect(stream.readable).toBeTrue();
+
+  // Read some bytes to verify it's actual audio data
+  const chunks: Buffer[] = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.from(chunk));
+    if (chunks.length > 2) break; // Just read a few chunks to verify
+  }
+
+  const totalBytes = chunks.reduce((sum, c) => sum + c.length, 0);
+  console.log(`Audio stream produced ${totalBytes} bytes in ${chunks.length} chunks`);
+  expect(totalBytes).toBeGreaterThan(0);
+});
+
+export default tap.start();
--- a/test/test.document.ts
+++ b/test/test.document.ts
@@ -0,0 +1,50 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import { getModel } from '../ts/index.js';
+import { analyzeDocuments, stopSmartpdf } from '../ts_document/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('analyzeDocuments should analyze a PDF', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  // Create a minimal test PDF (this is a valid minimal PDF)
+  const minimalPdf = Buffer.from(
+    '%PDF-1.0\n1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj\n' +
+    '2 0 obj<</Type/Pages/Kids[3 0 R]/Count 1>>endobj\n' +
+    '3 0 obj<</Type/Page/MediaBox[0 0 612 792]/Parent 2 0 R/Contents 4 0 R/Resources<</Font<</F1 5 0 R>>>>>>endobj\n' +
+    '4 0 obj<</Length 44>>stream\nBT /F1 12 Tf 100 700 Td (Hello World) Tj ET\nendstream\nendobj\n' +
+    '5 0 obj<</Type/Font/Subtype/Type1/BaseFont/Helvetica>>endobj\n' +
+    'xref\n0 6\n0000000000 65535 f \n0000000009 00000 n \n0000000058 00000 n \n0000000115 00000 n \n0000000266 00000 n \n0000000360 00000 n \n' +
+    'trailer<</Size 6/Root 1 0 R>>\nstartxref\n434\n%%EOF'
+  );
+
+  const model = getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+    promptCaching: false,
+  });
+
+  try {
+    const result = await analyzeDocuments({
+      model,
+      systemMessage: 'You are a document analysis assistant.',
+      userMessage: 'What text is visible in this document?',
+      pdfDocuments: [minimalPdf],
+    });
+
+    console.log('Document analysis result:', result);
+    expect(result).toBeTruthy();
+  } catch (error) {
+    console.log('Document test failed (may need puppeteer):', error.message);
+  } finally {
+    await stopSmartpdf();
+  }
+});
+
+export default tap.start();
--- a/test/test.image.ts
+++ b/test/test.image.ts
@@ -0,0 +1,35 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import { generateImage } from '../ts_image/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('generateImage should return an image response', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('OPENAI_TOKEN');
+  if (!apiKey) {
+    console.log('OPENAI_TOKEN not set, skipping test');
+    return;
+  }
+
+  const result = await generateImage({
+    apiKey,
+    prompt: 'A simple red circle on a white background',
+    model: 'gpt-image-1',
+    size: '1024x1024',
+    quality: 'low',
+    n: 1,
+  });
+
+  console.log('Image generation result: images count =', result.images.length);
+  expect(result.images).toBeArray();
+  expect(result.images.length).toBeGreaterThan(0);
+
+  const firstImage = result.images[0];
+  // gpt-image-1 returns b64_json by default
+  expect(firstImage.b64_json || firstImage.url).toBeTruthy();
+
+  expect(result.metadata).toBeTruthy();
+  expect(result.metadata!.model).toEqual('gpt-image-1');
+});
+
+export default tap.start();
--- a/test/test.ollama.ts
+++ b/test/test.ollama.ts
@@ -0,0 +1,390 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import { createOllamaModel } from '../ts/smartai.provider.ollama.js';
+import type { ISmartAiOptions } from '../ts/smartai.interfaces.js';
+
+tap.test('createOllamaModel returns valid LanguageModelV3', async () => {
+  const model = createOllamaModel({
+    provider: 'ollama',
+    model: 'qwen3:8b',
+    ollamaOptions: { think: true, num_ctx: 4096 },
+  });
+
+  expect(model.specificationVersion).toEqual('v3');
+  expect(model.provider).toEqual('ollama');
+  expect(model.modelId).toEqual('qwen3:8b');
+  expect(model).toHaveProperty('doGenerate');
+  expect(model).toHaveProperty('doStream');
+});
+
+tap.test('Qwen models get default temperature 0.55', async () => {
+  // Mock fetch to capture the request body
+  const originalFetch = globalThis.fetch;
+  let capturedBody: Record<string, unknown> | undefined;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    capturedBody = JSON.parse(init?.body as string);
+    return new Response(JSON.stringify({
+      message: { content: 'test response', role: 'assistant' },
+      done: true,
+      prompt_eval_count: 10,
+      eval_count: 5,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'qwen3:8b',
+    });
+
+    await model.doGenerate({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'hello' }] }],
+      inputFormat: 'prompt',
+    } as any);
+
+    expect(capturedBody).toBeTruthy();
+    // Temperature 0.55 should be in the options
+    expect((capturedBody!.options as Record<string, unknown>).temperature).toEqual(0.55);
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('think option is passed at top level of request body', async () => {
+  const originalFetch = globalThis.fetch;
+  let capturedBody: Record<string, unknown> | undefined;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    capturedBody = JSON.parse(init?.body as string);
+    return new Response(JSON.stringify({
+      message: { content: 'test', role: 'assistant', thinking: 'let me think...' },
+      done: true,
+      prompt_eval_count: 10,
+      eval_count: 5,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'qwen3:8b',
+      ollamaOptions: { think: true, num_ctx: 4096 },
+    });
+
+    await model.doGenerate({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'hello' }] }],
+      inputFormat: 'prompt',
+    } as any);
+
+    expect(capturedBody).toBeTruthy();
+    // think should be at top level, not inside options
+    expect(capturedBody!.think).toEqual(true);
+    // num_ctx should be in options
+    expect((capturedBody!.options as Record<string, unknown>).num_ctx).toEqual(4096);
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('Non-qwen models do not get default temperature', async () => {
+  const originalFetch = globalThis.fetch;
+  let capturedBody: Record<string, unknown> | undefined;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    capturedBody = JSON.parse(init?.body as string);
+    return new Response(JSON.stringify({
+      message: { content: 'test', role: 'assistant' },
+      done: true,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'llama3:8b',
+    });
+
+    await model.doGenerate({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'hello' }] }],
+      inputFormat: 'prompt',
+    } as any);
+
+    expect(capturedBody).toBeTruthy();
+    // No temperature should be set
+    expect((capturedBody!.options as Record<string, unknown>).temperature).toBeUndefined();
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('doGenerate parses reasoning/thinking from response', async () => {
+  const originalFetch = globalThis.fetch;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    return new Response(JSON.stringify({
+      message: {
+        content: 'The answer is 42.',
+        role: 'assistant',
+        thinking: 'Let me reason about this carefully...',
+      },
+      done: true,
+      prompt_eval_count: 20,
+      eval_count: 15,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'qwen3:8b',
+      ollamaOptions: { think: true },
+    });
+
+    const result = await model.doGenerate({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'What is the meaning of life?' }] }],
+    } as any);
+
+    // Should have both reasoning and text content
+    const reasoningParts = result.content.filter(c => c.type === 'reasoning');
+    const textParts = result.content.filter(c => c.type === 'text');
+
+    expect(reasoningParts.length).toEqual(1);
+    expect((reasoningParts[0] as any).text).toEqual('Let me reason about this carefully...');
+    expect(textParts.length).toEqual(1);
+    expect((textParts[0] as any).text).toEqual('The answer is 42.');
+    expect(result.finishReason.unified).toEqual('stop');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('doGenerate parses tool calls from response', async () => {
+  const originalFetch = globalThis.fetch;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    return new Response(JSON.stringify({
+      message: {
+        content: '',
+        role: 'assistant',
+        tool_calls: [
+          {
+            function: {
+              name: 'get_weather',
+              arguments: { location: 'London', unit: 'celsius' },
+            },
+          },
+        ],
+      },
+      done: true,
+      prompt_eval_count: 30,
+      eval_count: 10,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'qwen3:8b',
+    });
+
+    const result = await model.doGenerate({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'What is the weather in London?' }] }],
+      tools: [{
+        type: 'function' as const,
+        name: 'get_weather',
+        description: 'Get weather for a location',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            location: { type: 'string' },
+            unit: { type: 'string' },
+          },
+        },
+      }],
+    } as any);
+
+    const toolCalls = result.content.filter(c => c.type === 'tool-call');
+    expect(toolCalls.length).toEqual(1);
+    expect((toolCalls[0] as any).toolName).toEqual('get_weather');
+    expect(JSON.parse((toolCalls[0] as any).input)).toEqual({ location: 'London', unit: 'celsius' });
+    expect(result.finishReason.unified).toEqual('tool-calls');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('doStream produces correct stream parts', async () => {
+  const originalFetch = globalThis.fetch;
+
+  // Simulate Ollama's newline-delimited JSON streaming
+  const chunks = [
+    JSON.stringify({ message: { content: 'Hello', role: 'assistant' }, done: false }) + '\n',
+    JSON.stringify({ message: { content: ' world', role: 'assistant' }, done: false }) + '\n',
+    JSON.stringify({ message: { content: '!', role: 'assistant' }, done: true, prompt_eval_count: 5, eval_count: 3 }) + '\n',
+  ];
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+      start(controller) {
+        for (const chunk of chunks) {
+          controller.enqueue(encoder.encode(chunk));
+        }
+        controller.close();
+      },
+    });
+    return new Response(stream, { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'llama3:8b',
+    });
+
+    const result = await model.doStream({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'hello' }] }],
+    } as any);
+
+    const parts: any[] = [];
+    const reader = result.stream.getReader();
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      parts.push(value);
+    }
+
+    // Should have: text-start, text-delta x3, text-end, finish
+    const textDeltas = parts.filter(p => p.type === 'text-delta');
+    const finishParts = parts.filter(p => p.type === 'finish');
+    const textStarts = parts.filter(p => p.type === 'text-start');
+    const textEnds = parts.filter(p => p.type === 'text-end');
+
+    expect(textStarts.length).toEqual(1);
+    expect(textDeltas.length).toEqual(3);
+    expect(textDeltas.map((d: any) => d.delta).join('')).toEqual('Hello world!');
+    expect(textEnds.length).toEqual(1);
+    expect(finishParts.length).toEqual(1);
+    expect(finishParts[0].finishReason.unified).toEqual('stop');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('doStream handles thinking/reasoning in stream', async () => {
+  const originalFetch = globalThis.fetch;
+
+  const chunks = [
+    JSON.stringify({ message: { thinking: 'Let me think...', content: '', role: 'assistant' }, done: false }) + '\n',
+    JSON.stringify({ message: { thinking: ' about this.', content: '', role: 'assistant' }, done: false }) + '\n',
+    JSON.stringify({ message: { content: 'The answer.', role: 'assistant' }, done: false }) + '\n',
+    JSON.stringify({ message: { content: '', role: 'assistant' }, done: true, prompt_eval_count: 10, eval_count: 8 }) + '\n',
+  ];
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+      start(controller) {
+        for (const chunk of chunks) {
+          controller.enqueue(encoder.encode(chunk));
+        }
+        controller.close();
+      },
+    });
+    return new Response(stream, { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'qwen3:8b',
+      ollamaOptions: { think: true },
+    });
+
+    const result = await model.doStream({
+      prompt: [{ role: 'user', content: [{ type: 'text', text: 'think about this' }] }],
+    } as any);
+
+    const parts: any[] = [];
+    const reader = result.stream.getReader();
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      parts.push(value);
+    }
+
+    const reasoningStarts = parts.filter(p => p.type === 'reasoning-start');
+    const reasoningDeltas = parts.filter(p => p.type === 'reasoning-delta');
+    const reasoningEnds = parts.filter(p => p.type === 'reasoning-end');
+    const textDeltas = parts.filter(p => p.type === 'text-delta');
+
+    expect(reasoningStarts.length).toEqual(1);
+    expect(reasoningDeltas.length).toEqual(2);
+    expect(reasoningDeltas.map((d: any) => d.delta).join('')).toEqual('Let me think... about this.');
+    expect(reasoningEnds.length).toEqual(1);
+    expect(textDeltas.length).toEqual(1);
+    expect(textDeltas[0].delta).toEqual('The answer.');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+tap.test('message conversion handles system, assistant, and tool messages', async () => {
+  const originalFetch = globalThis.fetch;
+  let capturedBody: Record<string, unknown> | undefined;
+
+  globalThis.fetch = async (input: RequestInfo | URL, init?: RequestInit) => {
+    capturedBody = JSON.parse(init?.body as string);
+    return new Response(JSON.stringify({
+      message: { content: 'response', role: 'assistant' },
+      done: true,
+    }), { status: 200 });
+  };
+
+  try {
+    const model = createOllamaModel({
+      provider: 'ollama',
+      model: 'llama3:8b',
+    });
+
+    await model.doGenerate({
+      prompt: [
+        { role: 'system', content: 'You are helpful.' },
+        { role: 'user', content: [{ type: 'text', text: 'Hi' }] },
+        {
+          role: 'assistant',
+          content: [
+            { type: 'text', text: 'Let me check.' },
+            { type: 'tool-call', toolCallId: 'tc1', toolName: 'search', input: '{"q":"test"}' },
+          ],
+        },
+        {
+          role: 'tool',
+          content: [
+            { type: 'tool-result', toolCallId: 'tc1', output: { type: 'text', value: 'result data' } },
+          ],
+        },
+        { role: 'user', content: [{ type: 'text', text: 'What did you find?' }] },
+      ],
+    } as any);
+
+    const messages = capturedBody!.messages as Array<Record<string, unknown>>;
+    expect(messages.length).toEqual(5);
+    expect(messages[0].role).toEqual('system');
+    expect(messages[0].content).toEqual('You are helpful.');
+    expect(messages[1].role).toEqual('user');
+    expect(messages[1].content).toEqual('Hi');
+    expect(messages[2].role).toEqual('assistant');
+    expect(messages[2].content).toEqual('Let me check.');
+    expect((messages[2].tool_calls as any[]).length).toEqual(1);
+    expect((messages[2].tool_calls as any[])[0].function.name).toEqual('search');
+    expect(messages[3].role).toEqual('tool');
+    expect(messages[3].content).toEqual('result data');
+    expect(messages[4].role).toEqual('user');
+    expect(messages[4].content).toEqual('What did you find?');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+export default tap.start();
--- a/test/test.research.ts
+++ b/test/test.research.ts
@@ -0,0 +1,31 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import { research } from '../ts_research/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('research should return answer and sources', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  const result = await research({
+    apiKey,
+    query: 'What is the current version of Node.js?',
+    searchDepth: 'basic',
+  });
+
+  console.log('Research answer:', result.answer.substring(0, 200));
+  console.log('Research sources:', result.sources.length);
+  if (result.searchQueries) {
+    console.log('Search queries:', result.searchQueries);
+  }
+
+  expect(result.answer).toBeTruthy();
+  expect(result.answer.length).toBeGreaterThan(10);
+  expect(result.sources).toBeArray();
+});
+
+export default tap.start();
--- a/test/test.smartai.ts
+++ b/test/test.smartai.ts
@@ -0,0 +1,161 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import * as smartai from '../ts/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('getModel should return a LanguageModelV3 for anthropic', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  const model = smartai.getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+  });
+
+  expect(model).toHaveProperty('specificationVersion');
+  expect(model).toHaveProperty('provider');
+  expect(model).toHaveProperty('modelId');
+  expect(model).toHaveProperty('doGenerate');
+  expect(model).toHaveProperty('doStream');
+});
+
+tap.test('getModel with anthropic prompt caching returns wrapped model', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  // Default: prompt caching enabled
+  const model = smartai.getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+  });
+
+  // With caching disabled
+  const modelNoCaching = smartai.getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+    promptCaching: false,
+  });
+
+  // Both should be valid models
+  expect(model).toHaveProperty('doGenerate');
+  expect(modelNoCaching).toHaveProperty('doGenerate');
+});
+
+tap.test('generateText with anthropic model', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  const model = smartai.getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+  });
+
+  const result = await smartai.generateText({
+    model,
+    prompt: 'Say hello in exactly 3 words.',
+  });
+
+  console.log('Anthropic response:', result.text);
+  expect(result.text).toBeTruthy();
+  expect(result.text.length).toBeGreaterThan(0);
+});
+
+tap.test('getModel should return a LanguageModelV3 for openai', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('OPENAI_TOKEN');
+  if (!apiKey) {
+    console.log('OPENAI_TOKEN not set, skipping test');
+    return;
+  }
+
+  const model = smartai.getModel({
+    provider: 'openai',
+    model: 'gpt-4o-mini',
+    apiKey,
+  });
+
+  expect(model).toHaveProperty('doGenerate');
+  expect(model).toHaveProperty('doStream');
+});
+
+tap.test('streamText with anthropic model', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  const model = smartai.getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+  });
+
+  const result = await smartai.streamText({
+    model,
+    prompt: 'Count from 1 to 5.',
+  });
+
+  const tokens: string[] = [];
+  for await (const chunk of result.textStream) {
+    tokens.push(chunk);
+  }
+
+  const fullText = tokens.join('');
+  console.log('Streamed text:', fullText);
+  expect(fullText).toBeTruthy();
+  expect(fullText.length).toBeGreaterThan(0);
+  expect(tokens.length).toBeGreaterThan(1); // Should have multiple chunks
+});
+
+tap.test('generateText with openai model', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('OPENAI_TOKEN');
+  if (!apiKey) {
+    console.log('OPENAI_TOKEN not set, skipping test');
+    return;
+  }
+
+  const model = smartai.getModel({
+    provider: 'openai',
+    model: 'gpt-4o-mini',
+    apiKey,
+  });
+
+  const result = await smartai.generateText({
+    model,
+    prompt: 'What is 2+2? Reply with just the number.',
+  });
+
+  console.log('OpenAI response:', result.text);
+  expect(result.text).toBeTruthy();
+  expect(result.text).toInclude('4');
+});
+
+tap.test('getModel should throw for unknown provider', async () => {
+  let threw = false;
+  try {
+    smartai.getModel({
+      provider: 'nonexistent' as any,
+      model: 'test',
+    });
+  } catch (e) {
+    threw = true;
+    expect(e.message).toInclude('Unknown provider');
+  }
+  expect(threw).toBeTrue();
+});
+
+export default tap.start();
--- a/test/test.ts
+++ b/test/test.ts
@@ -1,84 +0,0 @@
-import { expect, expectAsync, tap } from '@push.rocks/tapbundle';
-import * as qenv from '@push.rocks/qenv';
-import * as smartrequest from '@push.rocks/smartrequest';
-import * as smartfile from '@push.rocks/smartfile';
-
-const testQenv = new qenv.Qenv('./', './.nogit/');
-
-import * as smartai from '../ts/index.js';
-
-let testSmartai: smartai.SmartAi;
-
-tap.test('should create a smartai instance', async () => {
-  testSmartai = new smartai.SmartAi({
-    openaiToken: await testQenv.getEnvVarOnDemand('OPENAI_TOKEN'),
-  });
-  await testSmartai.start();
-});
-
-tap.test('should create chat response with openai', async () => {
-  const userMessage = 'How are you?';
-  const response = await testSmartai.openaiProvider.chat({
-    systemMessage: 'Hello',
-    userMessage: userMessage,
-    messageHistory: [
-    ],
-  });
-  console.log(`userMessage: ${userMessage}`);
-  console.log(response.message.content);
-});
-
-tap.test('should document a pdf', async () => {
-  const pdfUrl = 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf';
-  const pdfResponse = await smartrequest.getBinary(pdfUrl);
-  const result = await testSmartai.openaiProvider.document({
-    systemMessage: 'Classify the document. Only the following answers are allowed: "invoice", "bank account statement", "contract", "other"',
-    userMessage: "Classify the document.",
-    messageHistory: [],
-    pdfDocuments: [pdfResponse.body],
-  });
-  console.log(result);
-});
-
-tap.test('should recognize companies in a pdf', async () => {
-  const pdfBuffer = await smartfile.fs.toBuffer('./.nogit/demo_without_textlayer.pdf');
-  const result = await testSmartai.openaiProvider.document({
-    systemMessage: `
-      summarize the document.
-
-      answer in JSON format, adhering to the following schema:
-      \`\`\`typescript
-        type TAnswer = {
-          entitySender: {
-            type: 'official state entity' | 'company' | 'person';
-            name: string;
-            address: string;
-            city: string;
-            country: string;
-            EU: boolean; // wether the entity is within EU
-          };
-          entityReceiver: {
-            type: 'official state entity' | 'company' | 'person';
-            name: string;
-            address: string;
-            city: string;
-            country: string;
-            EU: boolean; // wether the entity is within EU
-          };
-          date: string; // the date of the document as YYYY-MM-DD
-          title: string; // a short title, suitable for a filename
-        }
-      \`\`\`
-    `,
-    userMessage: "Classify the document.",
-    messageHistory: [],
-    pdfDocuments: [pdfBuffer],
-  });
-  console.log(result);
-})
-
-tap.test('should stop the smartai instance', async () => {
-  await testSmartai.stop();
-});
-
-export default tap.start();
--- a/test/test.vision.ts
+++ b/test/test.vision.ts
@@ -0,0 +1,66 @@
+import { tap, expect } from '@git.zone/tstest/tapbundle';
+import * as qenv from '@push.rocks/qenv';
+import * as fs from 'fs';
+import * as path from 'path';
+import { getModel } from '../ts/index.js';
+import { analyzeImage } from '../ts_vision/index.js';
+
+const testQenv = new qenv.Qenv('./', './.nogit/');
+
+tap.test('analyzeImage should describe a test image', async () => {
+  const apiKey = await testQenv.getEnvVarOnDemand('ANTHROPIC_TOKEN');
+  if (!apiKey) {
+    console.log('ANTHROPIC_TOKEN not set, skipping test');
+    return;
+  }
+
+  // Find an image file recursively in testimages/
+  const testImageDir = path.join(process.cwd(), 'test', 'testimages');
+  if (!fs.existsSync(testImageDir)) {
+    console.log('No test images directory found, skipping test');
+    return;
+  }
+
+  const findImage = (dir: string): string | null => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        const found = findImage(fullPath);
+        if (found) return found;
+      } else if (/\.(jpg|jpeg|png)$/i.test(entry.name)) {
+        return fullPath;
+      }
+    }
+    return null;
+  };
+
+  const imagePath = findImage(testImageDir);
+  if (!imagePath) {
+    console.log('No test images found, skipping test');
+    return;
+  }
+
+  const imageBuffer = fs.readFileSync(imagePath);
+  const ext = path.extname(imagePath).toLowerCase();
+  const mediaType = ext === '.png' ? 'image/png' : 'image/jpeg';
+
+  const model = getModel({
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-5-20250929',
+    apiKey,
+    promptCaching: false,
+  });
+
+  const result = await analyzeImage({
+    model,
+    image: imageBuffer,
+    prompt: 'Describe this image briefly.',
+    mediaType: mediaType as 'image/jpeg' | 'image/png',
+  });
+
+  console.log('Vision result:', result);
+  expect(result).toBeTruthy();
+  expect(result.length).toBeGreaterThan(10);
+});
+
+export default tap.start();
--- a/test/testimages/coffee-dani/README.md
+++ b/test/testimages/coffee-dani/README.md
@@ -0,0 +1,36 @@
+# Coffee Image Attribution
+
+## coffee.jpg
+
+**Photographer:** Dani (@frokz)
+**Source URL:** https://unsplash.com/photos/cup-of-coffee-on-saucer-ZLqxSzvVr7I
+**Direct Link:** https://images.unsplash.com/photo-1506372023823-741c83b836fe
+
+### Metadata
+- **Title:** Cup of coffee on saucer
+- **Description:** One of many coffee-moments in my life ;)
+- **Date Published:** September 25, 2017
+- **Location:** Stockholm, Sweden
+- **Tags:** coffee, cafe, heart, coffee cup, cup, barista, latte, mug, saucer, food, sweden, stockholm
+
+### License
+**Unsplash License** - Free to use
+- ✅ Commercial and non-commercial use
+- ✅ No permission needed
+- ❌ Cannot be sold without significant modification
+- ❌ Cannot be used to replicate Unsplash or similar service
+
+Full license: https://unsplash.com/license
+
+### Usage in This Project
+This image is used for testing vision/image processing capabilities in the SmartAI library test suite, specifically for:
+- Testing coffee/beverage recognition
+- Latte art pattern detection (heart shape)
+- Scene/environment analysis
+- Multi-element image understanding (cup, saucer, table)
+
+### Download Information
+- **Downloaded:** September 28, 2025
+- **Original Filename:** dani-ZLqxSzvVr7I-unsplash.jpg
+- **Resolution:** High resolution (3.7 MB)
+- **Format:** JPEG
--- a/test/testimages/coffee-dani/coffee.jpg
+++ b/test/testimages/coffee-dani/coffee.jpg
--- a/test/testimages/laptop-nicolas/README.md
+++ b/test/testimages/laptop-nicolas/README.md
@@ -0,0 +1,40 @@
+# Laptop Image Attribution
+
+## laptop.jpg
+
+**Photographer:** Nicolas Bichon (@nicol3a)
+**Source URL:** https://unsplash.com/photos/a-laptop-computer-sitting-on-top-of-a-wooden-desk-ZhV4iqAXxyA
+**Direct Link:** https://images.unsplash.com/photo-1704230972797-e0e3aba0fce7
+
+### Metadata
+- **Title:** A laptop computer sitting on top of a wooden desk
+- **Description:** Lifestyle photo I took for my indie app Type, a macOS app to take notes without interrupting your flow. https://usetype.app.
+- **Date Published:** January 2, 2024
+- **Camera:** FUJIFILM, X-T20
+- **Tags:** computer, laptop, mac, keyboard, computer keyboard, computer hardware, furniture, table, electronics, screen, monitor, hardware, display, tabletop, lcd screen, digital display
+
+### Statistics
+- **Views:** 183,020
+- **Downloads:** 757
+
+### License
+**Unsplash License** - Free to use
+- ✅ Commercial and non-commercial use
+- ✅ No permission needed
+- ❌ Cannot be sold without significant modification
+- ❌ Cannot be used to replicate Unsplash or similar service
+
+Full license: https://unsplash.com/license
+
+### Usage in This Project
+This image is used for testing vision/image processing capabilities in the SmartAI library test suite, specifically for:
+- Testing technology/computer equipment recognition
+- Workspace/office environment analysis
+- Object detection (laptop, keyboard, monitor, table)
+- Scene understanding and context analysis
+
+### Download Information
+- **Downloaded:** September 28, 2025
+- **Original Filename:** nicolas-bichon-ZhV4iqAXxyA-unsplash.jpg
+- **Resolution:** High resolution (1.8 MB)
+- **Format:** JPEG
--- a/test/testimages/laptop-nicolas/laptop.jpg
+++ b/test/testimages/laptop-nicolas/laptop.jpg
--- a/test/testimages/receipt-annie/README.md
+++ b/test/testimages/receipt-annie/README.md
@@ -0,0 +1,40 @@
+# Receipt Image Attribution
+
+## receipt.jpg
+
+**Photographer:** Annie Spratt (@anniespratt)
+**Source URL:** https://unsplash.com/photos/a-receipt-sitting-on-top-of-a-wooden-table-recgFWxDO1Y
+**Direct Link:** https://images.unsplash.com/photo-1731686602391-7484df33a03c
+
+### Metadata
+- **Title:** A receipt sitting on top of a wooden table
+- **Description:** Download this free HD photo of text, document, invoice, and receipt by Annie Spratt
+- **Date Published:** November 15, 2024
+- **Tags:** text, document, invoice, receipt, diaper
+
+### Statistics
+- **Views:** 54,593
+- **Downloads:** 764
+
+### License
+**Unsplash License** - Free to use
+- ✅ Commercial and non-commercial use
+- ✅ No permission needed
+- ❌ Cannot be sold without significant modification
+- ❌ Cannot be used to replicate Unsplash or similar service
+
+Full license: https://unsplash.com/license
+
+### Usage in This Project
+This image is used for testing vision/image processing capabilities in the SmartAI library test suite, specifically for:
+- Testing text extraction and OCR capabilities
+- Document recognition and classification
+- Receipt/invoice analysis
+- Text-heavy image understanding
+- Structured data extraction from documents
+
+### Download Information
+- **Downloaded:** September 28, 2025
+- **Original Filename:** annie-spratt-recgFWxDO1Y-unsplash.jpg
+- **Resolution:** High resolution (3.3 MB)
+- **Format:** JPEG
--- a/test/testimages/receipt-annie/receipt.jpg
+++ b/test/testimages/receipt-annie/receipt.jpg
--- a/ts/00_commitinfo_data.ts
+++ b/ts/00_commitinfo_data.ts
@@ -1,8 +1,8 @@
 /**
- * autocreated commitinfo by @pushrocks/commitinfo
+ * autocreated commitinfo by @push.rocks/commitinfo
 */
 export const commitinfo = {
  name: '@push.rocks/smartai',
-  version: '0.0.12',
-  description: 'Provides a standardized interface for integrating and conversing with multiple AI models, supporting operations like chat and potentially audio responses.'
+  version: '2.0.0',
+  description: 'Provider registry and capability utilities for ai-sdk (Vercel AI SDK). Core export returns LanguageModel; subpath exports provide vision, audio, image, document and research capabilities.'
 }
--- a/ts/abstract.classes.multimodal.ts
+++ b/ts/abstract.classes.multimodal.ts
@@ -1,32 +0,0 @@
-export abstract class MultiModalModel {
-  /**
-   * starts the model
-   */
-  abstract start(): Promise<void>;
-  
-  /**
-   * stops the model
-   */
-  abstract stop(): Promise<void>;
-
-  public abstract chat(optionsArg: {
-    systemMessage: string,
-    userMessage: string,
-    messageHistory: {
-      role: 'assistant' | 'user';
-      content: string;
-    }[]
-  }): Promise<{
-    role: 'assistant';
-    message: string;
-  }>
-  
-  /**
-   * Defines a streaming interface for chat interactions.
-   * The implementation will vary based on the specific AI model.
-   * @param input
-   */
-  public abstract chatStream(input: ReadableStream<string>): Promise<ReadableStream<string>>;
-
-
-}
--- a/ts/classes.conversation.ts
+++ b/ts/classes.conversation.ts
@@ -1,116 +0,0 @@
-import type { SmartAi } from "./classes.smartai.js";
-import { OpenAiProvider } from "./provider.openai.js";
-
-type TProcessFunction = (input: string) => Promise<string>;
-
-export interface IConversationOptions {
-  processFunction: TProcessFunction;
-}
-
-/**
- * a conversation
- */
-export class Conversation {
-  // STATIC
-  public static async createWithOpenAi(smartaiRefArg: SmartAi) {
-    if (!smartaiRefArg.openaiProvider) {
-      throw new Error('OpenAI provider not available');
-    }
-    const conversation = new Conversation(smartaiRefArg, {
-      processFunction: async (input) => {
-        return '' // TODO implement proper streaming
-      }
-    });
-    return conversation;
-  }
-
-  public static async createWithAnthropic(smartaiRefArg: SmartAi) {
-    if (!smartaiRefArg.anthropicProvider) {
-      throw new Error('Anthropic provider not available');
-    }
-    const conversation = new Conversation(smartaiRefArg, {
-      processFunction: async (input) => {
-        return '' // TODO implement proper streaming
-      }
-    });
-    return conversation;
-  }
-
-  public static async createWithPerplexity(smartaiRefArg: SmartAi) {
-    if (!smartaiRefArg.perplexityProvider) {
-      throw new Error('Perplexity provider not available');
-    }
-    const conversation = new Conversation(smartaiRefArg, {
-      processFunction: async (input) => {
-        return '' // TODO implement proper streaming
-      }
-    });
-    return conversation;
-  }
-
-  public static async createWithOllama(smartaiRefArg: SmartAi) {
-    if (!smartaiRefArg.ollamaProvider) {
-      throw new Error('Ollama provider not available');
-    }
-    const conversation = new Conversation(smartaiRefArg, {
-      processFunction: async (input) => {
-        return '' // TODO implement proper streaming
-      }
-    });
-    return conversation;
-  }
-
-  // INSTANCE
-  smartaiRef: SmartAi
-  private systemMessage: string;
-  private processFunction: TProcessFunction;
-  private inputStreamWriter: WritableStreamDefaultWriter<string> | null = null;
-  private outputStreamController: ReadableStreamDefaultController<string> | null = null;
-
-  constructor(smartairefArg: SmartAi, options: IConversationOptions) {
-    this.processFunction = options.processFunction;
-  }
-
-  public async setSystemMessage(systemMessageArg: string) {
-    this.systemMessage = systemMessageArg;
-  }
-
-  private setupOutputStream(): ReadableStream<string> {
-    return new ReadableStream<string>({
-      start: (controller) => {
-        this.outputStreamController = controller;
-      }
-    });
-  }
-
-  private setupInputStream(): WritableStream<string> {
-    const writableStream = new WritableStream<string>({
-      write: async (chunk) => {
-        const processedData = await this.processFunction(chunk);
-        if (this.outputStreamController) {
-          this.outputStreamController.enqueue(processedData);
-        }
-      },
-      close: () => {
-        this.outputStreamController?.close();
-      },
-      abort: (err) => {
-        console.error('Stream aborted', err);
-        this.outputStreamController?.error(err);
-      }
-    });
-    return writableStream;
-  }
-
-  public getInputStreamWriter(): WritableStreamDefaultWriter<string> {
-    if (!this.inputStreamWriter) {
-      const inputStream = this.setupInputStream();
-      this.inputStreamWriter = inputStream.getWriter();
-    }
-    return this.inputStreamWriter;
-  }
-
-  public getOutputStream(): ReadableStream<string> {
-    return this.setupOutputStream();
-  }
-}
--- a/ts/classes.smartai.ts
+++ b/ts/classes.smartai.ts
@@ -1,62 +0,0 @@
-import { Conversation } from './classes.conversation.js';
-import * as plugins from './plugins.js';
-import { AnthropicProvider } from './provider.anthropic.js';
-import type { OllamaProvider } from './provider.ollama.js';
-import { OpenAiProvider } from './provider.openai.js';
-import type { PerplexityProvider } from './provider.perplexity.js';
-
-
-export interface ISmartAiOptions {
-  openaiToken?: string;
-  anthropicToken?: string;
-  perplexityToken?: string;
-}
-
-export type TProvider = 'openai' | 'anthropic' | 'perplexity' | 'ollama';
-
-export class SmartAi {
-  public options: ISmartAiOptions;
-
-  public openaiProvider: OpenAiProvider;
-  public anthropicProvider: AnthropicProvider;
-  public perplexityProvider: PerplexityProvider;
-  public ollamaProvider: OllamaProvider;
-
-  constructor(optionsArg: ISmartAiOptions) {
-    this.options = optionsArg;
-  }
-
-  public async start() {
-    if (this.options.openaiToken) {
-      this.openaiProvider = new OpenAiProvider({
-        openaiToken: this.options.openaiToken,
-      });
-      await this.openaiProvider.start();
-    }
-    if (this.options.anthropicToken) {
-      this.anthropicProvider = new AnthropicProvider({
-        anthropicToken: this.options.anthropicToken,
-      });
-    }
-  }
-
-  public async stop() {}
-  
-  /**
-   * create a new conversation
-   */
-  createConversation(provider: TProvider) {
-    switch (provider) {
-      case 'openai':
-        return Conversation.createWithOpenAi(this);
-      case 'anthropic':
-        return Conversation.createWithAnthropic(this);
-      case 'perplexity':
-        return Conversation.createWithPerplexity(this);
-      case 'ollama':
-        return Conversation.createWithOllama(this);
-      default:
-        throw new Error('Provider not available');
-    }
-  }
-}
--- a/ts/classes.tts.ts
+++ b/ts/classes.tts.ts
@@ -1,15 +0,0 @@
-import type { SmartAi } from './classes.smartai.js';
-import * as plugins from './plugins.js';
-
-export class TTS {
-  public static async createWithOpenAi(smartaiRef: SmartAi): Promise<TTS> {
-    return new TTS(smartaiRef);
-  }
-
-  // INSTANCE
-  smartaiRef: SmartAi;
-
-  constructor(smartairefArg: SmartAi) {
-    this.smartaiRef = smartairefArg;
-  }
-}
--- a/ts/index.ts
+++ b/ts/index.ts
@@ -1,3 +1,8 @@
-export * from './classes.smartai.js';
-export * from './abstract.classes.multimodal.js';
-export * from './provider.openai.js';
+export { getModel } from './smartai.classes.smartai.js';
+export type { ISmartAiOptions, TProvider, IOllamaModelOptions, LanguageModelV3 } from './smartai.interfaces.js';
+export { createAnthropicCachingMiddleware } from './smartai.middleware.anthropic.js';
+export { createOllamaModel } from './smartai.provider.ollama.js';
+
+// Re-export commonly used ai-sdk functions for consumer convenience
+export { generateText, streamText, tool, jsonSchema } from 'ai';
+export type { ModelMessage, ToolSet, StreamTextResult } from 'ai';
--- a/ts/interfaces.ts
+++ b/ts/interfaces.ts
--- a/ts/paths.ts
+++ b/ts/paths.ts
@@ -1,4 +0,0 @@
-import * as plugins from './plugins.js';
-
-export const packageDir = plugins.path.join(plugins.smartpath.get.dirnameFromImportMetaUrl(import.meta.url), '../');
-export const nogitDir = plugins.path.join(packageDir, './.nogit');
--- a/ts/plugins.ts
+++ b/ts/plugins.ts
@@ -1,36 +1,22 @@
-// node native
-import * as path from 'path';
+// ai sdk core
+import { generateText, streamText, wrapLanguageModel, tool, jsonSchema } from 'ai';
+export { generateText, streamText, wrapLanguageModel, tool, jsonSchema };
+
+// ai sdk providers
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { createGroq } from '@ai-sdk/groq';
+import { createMistral } from '@ai-sdk/mistral';
+import { createXai } from '@ai-sdk/xai';
+import { createPerplexity } from '@ai-sdk/perplexity';

 export {
-  path,
-}
-
-// @push.rocks scope
-import * as qenv from '@push.rocks/qenv';
-import * as smartarray from '@push.rocks/smartarray';
-import * as smartfile from '@push.rocks/smartfile';
-import * as smartpath from '@push.rocks/smartpath';
-import * as smartpdf from '@push.rocks/smartpdf';
-import * as smartpromise from '@push.rocks/smartpromise';
-import * as smartrequest from '@push.rocks/smartrequest';
-import * as webstream from '@push.rocks/webstream';
-
-export {
-  smartarray,
-  qenv,
-  smartfile,
-  smartpath,
-  smartpdf,
-  smartpromise,
-  smartrequest,
-  webstream,
-}
-
-// third party
-import * as anthropic from '@anthropic-ai/sdk';
-import * as openai from 'openai';
-
-export {
-  anthropic,
-  openai,
-}
+  createAnthropic,
+  createOpenAI,
+  createGoogleGenerativeAI,
+  createGroq,
+  createMistral,
+  createXai,
+  createPerplexity,
+};
--- a/ts/provider.anthropic.ts
+++ b/ts/provider.anthropic.ts
@@ -1,62 +0,0 @@
-import * as plugins from './plugins.js';
-import * as paths from './paths.js';
-import { MultiModalModel } from './abstract.classes.multimodal.js';
-
-export interface IAnthropicProviderOptions {
-  anthropicToken: string;
-}
-
-export class AnthropicProvider extends MultiModalModel {
-  private options: IAnthropicProviderOptions;
-  public anthropicApiClient: plugins.anthropic.default;
-
-  constructor(optionsArg: IAnthropicProviderOptions) {
-    super();
-    this.options = optionsArg // Ensure the token is stored
-  }
-
-  async start() {
-    this.anthropicApiClient = new plugins.anthropic.default({
-      apiKey: this.options.anthropicToken,
-    });
-  }
-
-  async stop() {}
-
-  public async chatStream(input: ReadableStream<string>): Promise<ReadableStream<string>> {
-    // TODO: implement for OpenAI
-
-    const returnStream = new ReadableStream();
-    return returnStream;
-  }
-
-  // Implementing the synchronous chat interaction
-  public async chat(optionsArg: {
-    systemMessage: string;
-    userMessage: string;
-    messageHistory: {
-      role: 'assistant' | 'user';
-      content: string;
-    }[];
-  }) {
-    const result = await this.anthropicApiClient.messages.create({
-      model: 'claude-3-opus-20240229',
-      system: optionsArg.systemMessage,
-      messages: [
-        ...optionsArg.messageHistory,
-        { role: 'user', content: optionsArg.userMessage },
-      ],
-      max_tokens: 4000,
-    });
-
-    return {
-      role: result.role as 'assistant',
-      message: result.content.join('\n'),
-    };
-  }
-
-  private async audio(messageArg: string) {
-    // Anthropic does not provide an audio API, so this method is not implemented.
-    throw new Error('Audio generation is not yet supported by Anthropic.');
-  }
-}
--- a/ts/provider.ollama.ts
+++ b/ts/provider.ollama.ts
@@ -1,3 +0,0 @@
-import * as plugins from './plugins.js';
-
-export class OllamaProvider {}
--- a/ts/provider.openai.ts
+++ b/ts/provider.openai.ts
@@ -1,134 +0,0 @@
-import * as plugins from './plugins.js';
-import * as paths from './paths.js';
-
-import { MultiModalModel } from './abstract.classes.multimodal.js';
-
-export interface IOpenaiProviderOptions {
-  openaiToken: string;
-}
-
-export class OpenAiProvider extends MultiModalModel {
-  private options: IOpenaiProviderOptions;
-  public openAiApiClient: plugins.openai.default;
-  public smartpdfInstance: plugins.smartpdf.SmartPdf;
-
-  constructor(optionsArg: IOpenaiProviderOptions) {
-    super();
-    this.options = optionsArg;
-  }
-
-  public async start() {
-    this.openAiApiClient = new plugins.openai.default({
-      apiKey: this.options.openaiToken,
-      dangerouslyAllowBrowser: true,
-    });
-    this.smartpdfInstance = new plugins.smartpdf.SmartPdf();
-  }
-
-  public async stop() {}
-
-  public async chatStream(input: ReadableStream<string>): Promise<ReadableStream<string>> {
-    // TODO: implement for OpenAI
-
-    const returnStream = new ReadableStream();
-    return returnStream;
-  }
-
-  // Implementing the synchronous chat interaction
-  public async chat(optionsArg: {
-    systemMessage: string;
-    userMessage: string;
-    messageHistory: {
-      role: 'assistant' | 'user';
-      content: string;
-    }[];
-  }) {
-    const result = await this.openAiApiClient.chat.completions.create({
-      model: 'gpt-4-turbo-preview',
-
-      messages: [
-        { role: 'system', content: optionsArg.systemMessage },
-        ...optionsArg.messageHistory,
-        { role: 'user', content: optionsArg.userMessage },
-      ],
-    });
-    return {
-      role: result.choices[0].message.role as 'assistant',
-      message: result.choices[0].message.content,
-    };
-  }
-
-  public async audio(optionsArg: { message: string }): Promise<NodeJS.ReadableStream> {
-    const done = plugins.smartpromise.defer<NodeJS.ReadableStream>();
-    const result = await this.openAiApiClient.audio.speech.create({
-      model: 'tts-1-hd',
-      input: optionsArg.message,
-      voice: 'nova',
-      response_format: 'mp3',
-      speed: 1,
-    });
-    const stream = result.body;
-    done.resolve(stream);
-    return done.promise;
-  }
-
-  public async document(optionsArg: {
-    systemMessage: string;
-    userMessage: string;
-    pdfDocuments: Uint8Array[];
-    messageHistory: {
-      role: 'assistant' | 'user';
-      content: any;
-    }[];
-  }) {
-    let pdfDocumentImageBytesArray: Uint8Array[] = [];
-
-    for (const pdfDocument of optionsArg.pdfDocuments) {
-      const documentImageArray = await this.smartpdfInstance.convertPDFToPngBytes(pdfDocument);
-      pdfDocumentImageBytesArray = pdfDocumentImageBytesArray.concat(documentImageArray);
-    }
-
-    console.log(`image smartfile array`);
-    console.log(pdfDocumentImageBytesArray.map((smartfile) => smartfile.length));
-
-    const smartfileArray = await plugins.smartarray.map(
-      pdfDocumentImageBytesArray,
-      async (pdfDocumentImageBytes) => {
-        return plugins.smartfile.SmartFile.fromBuffer(
-          'pdfDocumentImage.jpg',
-          Buffer.from(pdfDocumentImageBytes)
-        );
-      }
-    );
-
-    const result = await this.openAiApiClient.chat.completions.create({
-      model: 'gpt-4-vision-preview',
-      // response_format: { type: "json_object" }, // not supported for now
-      messages: [
-        { role: 'system', content: optionsArg.systemMessage },
-        ...optionsArg.messageHistory,
-        {
-          role: 'user',
-          content: [
-            { type: 'text', text: optionsArg.userMessage },
-            ...(() => {
-              const returnArray = [];
-              for (const imageBytes of pdfDocumentImageBytesArray) {
-                returnArray.push({
-                  type: 'image_url',
-                  image_url: {
-                    url: 'data:image/png;base64,' + Buffer.from(imageBytes).toString('base64'),
-                  },
-                });
-              }
-              return returnArray;
-            })(),
-          ],
-        },
-      ],
-    });
-    return {
-      message: result.choices[0].message,
-    };
-  }
-}
--- a/ts/provider.perplexity.ts
+++ b/ts/provider.perplexity.ts
@@ -1,3 +0,0 @@
-import * as plugins from './plugins.js';
-
-export class PerplexityProvider {}
--- a/ts/smartai.classes.smartai.ts
+++ b/ts/smartai.classes.smartai.ts
@@ -0,0 +1,51 @@
+import * as plugins from './plugins.js';
+import type { ISmartAiOptions, LanguageModelV3 } from './smartai.interfaces.js';
+import { createOllamaModel } from './smartai.provider.ollama.js';
+import { createAnthropicCachingMiddleware } from './smartai.middleware.anthropic.js';
+
+/**
+ * Returns a LanguageModelV3 for the given provider and model.
+ * This is the primary API — consumers use the returned model with AI SDK's
+ * generateText(), streamText(), etc.
+ */
+export function getModel(options: ISmartAiOptions): LanguageModelV3 {
+  switch (options.provider) {
+    case 'anthropic': {
+      const p = plugins.createAnthropic({ apiKey: options.apiKey });
+      const base = p(options.model) as LanguageModelV3;
+      if (options.promptCaching === false) return base;
+      return plugins.wrapLanguageModel({
+        model: base,
+        middleware: createAnthropicCachingMiddleware(),
+      }) as unknown as LanguageModelV3;
+    }
+    case 'openai': {
+      const p = plugins.createOpenAI({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'google': {
+      const p = plugins.createGoogleGenerativeAI({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'groq': {
+      const p = plugins.createGroq({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'mistral': {
+      const p = plugins.createMistral({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'xai': {
+      const p = plugins.createXai({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'perplexity': {
+      const p = plugins.createPerplexity({ apiKey: options.apiKey });
+      return p(options.model) as LanguageModelV3;
+    }
+    case 'ollama':
+      return createOllamaModel(options);
+    default:
+      throw new Error(`Unknown provider: ${(options as ISmartAiOptions).provider}`);
+  }
+}
--- a/ts/smartai.interfaces.ts
+++ b/ts/smartai.interfaces.ts
@@ -0,0 +1,53 @@
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+
+export type TProvider =
+  | 'anthropic'
+  | 'openai'
+  | 'google'
+  | 'groq'
+  | 'mistral'
+  | 'xai'
+  | 'perplexity'
+  | 'ollama';
+
+export interface ISmartAiOptions {
+  provider: TProvider;
+  model: string;
+  apiKey?: string;
+  /** For Ollama: base URL of the local server. Default: http://localhost:11434 */
+  baseUrl?: string;
+  /**
+   * Ollama-specific model runtime options.
+   * Only used when provider === 'ollama'.
+   */
+  ollamaOptions?: IOllamaModelOptions;
+  /**
+   * Enable Anthropic prompt caching on system + recent messages.
+   * Only used when provider === 'anthropic'. Default: true.
+   */
+  promptCaching?: boolean;
+}
+
+/**
+ * Ollama model runtime options passed in the request body `options` field.
+ * @see https://github.com/ollama/ollama/blob/main/docs/modelfile.md
+ */
+export interface IOllamaModelOptions {
+  /** Context window size. Default: 2048. */
+  num_ctx?: number;
+  /** 0 = deterministic. Default: 0.8. For Qwen models use 0.55. */
+  temperature?: number;
+  top_k?: number;
+  top_p?: number;
+  repeat_penalty?: number;
+  num_predict?: number;
+  stop?: string[];
+  seed?: number;
+  /**
+   * Enable thinking/reasoning mode (Qwen3, QwQ, DeepSeek-R1 etc.).
+   * The custom Ollama provider handles this directly.
+   */
+  think?: boolean;
+}
+
+export type { LanguageModelV3 };
--- a/ts/smartai.middleware.anthropic.ts
+++ b/ts/smartai.middleware.anthropic.ts
@@ -0,0 +1,38 @@
+import type { LanguageModelV3Middleware, LanguageModelV3Prompt } from '@ai-sdk/provider';
+
+/**
+ * Creates middleware that adds Anthropic prompt caching directives.
+ * Marks the last system message and last user message with ephemeral cache control,
+ * reducing input token cost and latency on repeated calls.
+ */
+export function createAnthropicCachingMiddleware(): LanguageModelV3Middleware {
+  return {
+    specificationVersion: 'v3',
+    transformParams: async ({ params }) => {
+      const messages = [...params.prompt] as Array<Record<string, unknown>>;
+
+      // Find the last system message and last user message
+      let lastSystemIdx = -1;
+      let lastUserIdx = -1;
+      for (let i = 0; i < messages.length; i++) {
+        if (messages[i].role === 'system') lastSystemIdx = i;
+        if (messages[i].role === 'user') lastUserIdx = i;
+      }
+
+      const targets = [lastSystemIdx, lastUserIdx].filter(i => i >= 0);
+      for (const idx of targets) {
+        const msg = { ...messages[idx] };
+        msg.providerOptions = {
+          ...(msg.providerOptions as Record<string, unknown> || {}),
+          anthropic: {
+            ...((msg.providerOptions as Record<string, unknown>)?.anthropic as Record<string, unknown> || {}),
+            cacheControl: { type: 'ephemeral' },
+          },
+        };
+        messages[idx] = msg;
+      }
+
+      return { ...params, prompt: messages as unknown as LanguageModelV3Prompt };
+    },
+  };
+}
--- a/ts/smartai.provider.ollama.ts
+++ b/ts/smartai.provider.ollama.ts
@@ -0,0 +1,426 @@
+import type {
+  LanguageModelV3,
+  LanguageModelV3CallOptions,
+  LanguageModelV3GenerateResult,
+  LanguageModelV3StreamResult,
+  LanguageModelV3StreamPart,
+  LanguageModelV3Prompt,
+  LanguageModelV3Content,
+  LanguageModelV3Usage,
+  LanguageModelV3FinishReason,
+} from '@ai-sdk/provider';
+import type { ISmartAiOptions, IOllamaModelOptions } from './smartai.interfaces.js';
+
+interface IOllamaMessage {
+  role: string;
+  content: string;
+  images?: string[];
+  tool_calls?: Array<{
+    function: { name: string; arguments: Record<string, unknown> };
+  }>;
+  thinking?: string;
+}
+
+interface IOllamaTool {
+  type: 'function';
+  function: {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+  };
+}
+
+/**
+ * Convert AI SDK V3 prompt messages to Ollama's message format.
+ */
+function convertPromptToOllamaMessages(prompt: LanguageModelV3Prompt): IOllamaMessage[] {
+  const messages: IOllamaMessage[] = [];
+
+  for (const msg of prompt) {
+    if (msg.role === 'system') {
+      // System message content is a plain string in V3
+      messages.push({ role: 'system', content: msg.content });
+    } else if (msg.role === 'user') {
+      let text = '';
+      const images: string[] = [];
+      for (const part of msg.content) {
+        if (part.type === 'text') {
+          text += part.text;
+        } else if (part.type === 'file' && part.mediaType?.startsWith('image/')) {
+          // Handle image files — Ollama expects base64 images
+          if (typeof part.data === 'string') {
+            images.push(part.data);
+          } else if (part.data instanceof Uint8Array) {
+            images.push(Buffer.from(part.data).toString('base64'));
+          }
+        }
+      }
+      const m: IOllamaMessage = { role: 'user', content: text };
+      if (images.length > 0) m.images = images;
+      messages.push(m);
+    } else if (msg.role === 'assistant') {
+      let text = '';
+      let thinking = '';
+      const toolCalls: IOllamaMessage['tool_calls'] = [];
+      for (const part of msg.content) {
+        if (part.type === 'text') {
+          text += part.text;
+        } else if (part.type === 'reasoning') {
+          thinking += part.text;
+        } else if (part.type === 'tool-call') {
+          const args = typeof part.input === 'string'
+            ? JSON.parse(part.input as string)
+            : (part.input as Record<string, unknown>);
+          toolCalls.push({
+            function: {
+              name: part.toolName,
+              arguments: args,
+            },
+          });
+        }
+      }
+      const m: IOllamaMessage = { role: 'assistant', content: text };
+      if (toolCalls.length > 0) m.tool_calls = toolCalls;
+      if (thinking) m.thinking = thinking;
+      messages.push(m);
+    } else if (msg.role === 'tool') {
+      for (const part of msg.content) {
+        if (part.type === 'tool-result') {
+          let resultContent = '';
+          if (part.output) {
+            if (part.output.type === 'text') {
+              resultContent = part.output.value;
+            } else if (part.output.type === 'json') {
+              resultContent = JSON.stringify(part.output.value);
+            }
+          }
+          messages.push({ role: 'tool', content: resultContent });
+        }
+      }
+    }
+  }
+
+  return messages;
+}
+
+/**
+ * Convert AI SDK V3 tools to Ollama's tool format.
+ */
+function convertToolsToOllamaTools(tools: LanguageModelV3CallOptions['tools']): IOllamaTool[] | undefined {
+  if (!tools || tools.length === 0) return undefined;
+
+  return tools
+    .filter((t): t is Extract<typeof t, { type: 'function' }> => t.type === 'function')
+    .map(t => ({
+      type: 'function' as const,
+      function: {
+        name: t.name,
+        description: t.description ?? '',
+        parameters: t.inputSchema as Record<string, unknown>,
+      },
+    }));
+}
+
+function makeUsage(promptTokens?: number, completionTokens?: number): LanguageModelV3Usage {
+  return {
+    inputTokens: {
+      total: promptTokens,
+      noCache: undefined,
+      cacheRead: undefined,
+      cacheWrite: undefined,
+    },
+    outputTokens: {
+      total: completionTokens,
+      text: completionTokens,
+      reasoning: undefined,
+    },
+  };
+}
+
+function makeFinishReason(reason?: string): LanguageModelV3FinishReason {
+  if (reason === 'tool_calls' || reason === 'tool-calls') {
+    return { unified: 'tool-calls', raw: reason };
+  }
+  return { unified: 'stop', raw: reason ?? 'stop' };
+}
+
+let idCounter = 0;
+function generateId(): string {
+  return `ollama-${Date.now()}-${idCounter++}`;
+}
+
+/**
+ * Custom LanguageModelV3 implementation for Ollama.
+ * Calls Ollama's native /api/chat endpoint directly to support
+ * think, num_ctx, temperature, and other model options.
+ */
+export function createOllamaModel(options: ISmartAiOptions): LanguageModelV3 {
+  const baseUrl = options.baseUrl ?? 'http://localhost:11434';
+  const modelId = options.model;
+  const ollamaOpts: IOllamaModelOptions = { ...options.ollamaOptions };
+
+  // Apply default temperature of 0.55 for Qwen models
+  if (modelId.toLowerCase().includes('qwen') && ollamaOpts.temperature === undefined) {
+    ollamaOpts.temperature = 0.55;
+  }
+
+  const model: LanguageModelV3 = {
+    specificationVersion: 'v3',
+    provider: 'ollama',
+    modelId,
+    supportedUrls: {},
+
+    async doGenerate(callOptions: LanguageModelV3CallOptions): Promise<LanguageModelV3GenerateResult> {
+      const messages = convertPromptToOllamaMessages(callOptions.prompt);
+      const tools = convertToolsToOllamaTools(callOptions.tools);
+
+      const ollamaModelOptions: Record<string, unknown> = { ...ollamaOpts };
+      // Override with call-level options if provided
+      if (callOptions.temperature !== undefined) ollamaModelOptions.temperature = callOptions.temperature;
+      if (callOptions.topP !== undefined) ollamaModelOptions.top_p = callOptions.topP;
+      if (callOptions.topK !== undefined) ollamaModelOptions.top_k = callOptions.topK;
+      if (callOptions.maxOutputTokens !== undefined) ollamaModelOptions.num_predict = callOptions.maxOutputTokens;
+      if (callOptions.seed !== undefined) ollamaModelOptions.seed = callOptions.seed;
+      if (callOptions.stopSequences) ollamaModelOptions.stop = callOptions.stopSequences;
+      // Remove think from options — it goes at the top level
+      const { think, ...modelOpts } = ollamaModelOptions;
+
+      const requestBody: Record<string, unknown> = {
+        model: modelId,
+        messages,
+        stream: false,
+        options: modelOpts,
+      };
+
+      // Add think parameter at the top level (Ollama API requirement)
+      if (ollamaOpts.think !== undefined) {
+        requestBody.think = ollamaOpts.think;
+      }
+
+      if (tools) requestBody.tools = tools;
+
+      const response = await fetch(`${baseUrl}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(requestBody),
+        signal: callOptions.abortSignal,
+      });
+
+      if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Ollama API error ${response.status}: ${body}`);
+      }
+
+      const result = await response.json() as Record<string, unknown>;
+      const message = result.message as Record<string, unknown>;
+
+      // Build content array
+      const content: LanguageModelV3Content[] = [];
+
+      // Add reasoning if present
+      if (message.thinking && typeof message.thinking === 'string') {
+        content.push({ type: 'reasoning', text: message.thinking });
+      }
+
+      // Add text content
+      if (message.content && typeof message.content === 'string') {
+        content.push({ type: 'text', text: message.content });
+      }
+
+      // Add tool calls if present
+      if (Array.isArray(message.tool_calls)) {
+        for (const tc of message.tool_calls as Array<Record<string, unknown>>) {
+          const fn = tc.function as Record<string, unknown>;
+          content.push({
+            type: 'tool-call',
+            toolCallId: generateId(),
+            toolName: fn.name as string,
+            input: JSON.stringify(fn.arguments),
+          });
+        }
+      }
+
+      const finishReason = Array.isArray(message.tool_calls) && (message.tool_calls as unknown[]).length > 0
+        ? makeFinishReason('tool_calls')
+        : makeFinishReason('stop');
+
+      return {
+        content,
+        finishReason,
+        usage: makeUsage(
+          (result.prompt_eval_count as number) ?? undefined,
+          (result.eval_count as number) ?? undefined,
+        ),
+        warnings: [],
+        request: { body: requestBody },
+      };
+    },
+
+    async doStream(callOptions: LanguageModelV3CallOptions): Promise<LanguageModelV3StreamResult> {
+      const messages = convertPromptToOllamaMessages(callOptions.prompt);
+      const tools = convertToolsToOllamaTools(callOptions.tools);
+
+      const ollamaModelOptions: Record<string, unknown> = { ...ollamaOpts };
+      if (callOptions.temperature !== undefined) ollamaModelOptions.temperature = callOptions.temperature;
+      if (callOptions.topP !== undefined) ollamaModelOptions.top_p = callOptions.topP;
+      if (callOptions.topK !== undefined) ollamaModelOptions.top_k = callOptions.topK;
+      if (callOptions.maxOutputTokens !== undefined) ollamaModelOptions.num_predict = callOptions.maxOutputTokens;
+      if (callOptions.seed !== undefined) ollamaModelOptions.seed = callOptions.seed;
+      if (callOptions.stopSequences) ollamaModelOptions.stop = callOptions.stopSequences;
+      const { think, ...modelOpts } = ollamaModelOptions;
+
+      const requestBody: Record<string, unknown> = {
+        model: modelId,
+        messages,
+        stream: true,
+        options: modelOpts,
+      };
+
+      if (ollamaOpts.think !== undefined) {
+        requestBody.think = ollamaOpts.think;
+      }
+
+      if (tools) requestBody.tools = tools;
+
+      const response = await fetch(`${baseUrl}/api/chat`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(requestBody),
+        signal: callOptions.abortSignal,
+      });
+
+      if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Ollama API error ${response.status}: ${body}`);
+      }
+
+      const reader = response.body!.getReader();
+      const decoder = new TextDecoder();
+
+      const textId = generateId();
+      const reasoningId = generateId();
+      let textStarted = false;
+      let reasoningStarted = false;
+      let hasToolCalls = false;
+      let closed = false;
+
+      const stream = new ReadableStream<LanguageModelV3StreamPart>({
+        async pull(controller) {
+          if (closed) return;
+
+          const processLine = (line: string) => {
+            if (!line.trim()) return;
+            let json: Record<string, unknown>;
+            try {
+              json = JSON.parse(line);
+            } catch {
+              return;
+            }
+
+            const msg = json.message as Record<string, unknown> | undefined;
+
+            // Handle thinking/reasoning content
+            if (msg?.thinking && typeof msg.thinking === 'string') {
+              if (!reasoningStarted) {
+                reasoningStarted = true;
+                controller.enqueue({ type: 'reasoning-start', id: reasoningId });
+              }
+              controller.enqueue({ type: 'reasoning-delta', id: reasoningId, delta: msg.thinking });
+            }
+
+            // Handle text content
+            if (msg?.content && typeof msg.content === 'string') {
+              if (reasoningStarted && !textStarted) {
+                controller.enqueue({ type: 'reasoning-end', id: reasoningId });
+              }
+              if (!textStarted) {
+                textStarted = true;
+                controller.enqueue({ type: 'text-start', id: textId });
+              }
+              controller.enqueue({ type: 'text-delta', id: textId, delta: msg.content });
+            }
+
+            // Handle tool calls
+            if (Array.isArray(msg?.tool_calls)) {
+              hasToolCalls = true;
+              for (const tc of msg!.tool_calls as Array<Record<string, unknown>>) {
+                const fn = tc.function as Record<string, unknown>;
+                const callId = generateId();
+                controller.enqueue({
+                  type: 'tool-call',
+                  toolCallId: callId,
+                  toolName: fn.name as string,
+                  input: JSON.stringify(fn.arguments),
+                });
+              }
+            }
+
+            // Handle done
+            if (json.done) {
+              if (reasoningStarted && !textStarted) {
+                controller.enqueue({ type: 'reasoning-end', id: reasoningId });
+              }
+              if (textStarted) {
+                controller.enqueue({ type: 'text-end', id: textId });
+              }
+              controller.enqueue({
+                type: 'finish',
+                finishReason: hasToolCalls
+                  ? makeFinishReason('tool_calls')
+                  : makeFinishReason('stop'),
+                usage: makeUsage(
+                  (json.prompt_eval_count as number) ?? undefined,
+                  (json.eval_count as number) ?? undefined,
+                ),
+              });
+              closed = true;
+              controller.close();
+            }
+          };
+
+          try {
+            let buffer = '';
+            while (true) {
+              const { done, value } = await reader.read();
+              if (done) {
+                if (buffer.trim()) processLine(buffer);
+                if (!closed) {
+                  controller.enqueue({
+                    type: 'finish',
+                    finishReason: makeFinishReason('stop'),
+                    usage: makeUsage(undefined, undefined),
+                  });
+                  closed = true;
+                  controller.close();
+                }
+                return;
+              }
+
+              buffer += decoder.decode(value, { stream: true });
+              const lines = buffer.split('\n');
+              buffer = lines.pop() || '';
+              for (const line of lines) {
+                processLine(line);
+                if (closed) return;
+              }
+            }
+          } catch (error) {
+            if (!closed) {
+              controller.error(error);
+              closed = true;
+            }
+          } finally {
+            reader.releaseLock();
+          }
+        },
+      });
+
+      return {
+        stream,
+        request: { body: requestBody },
+      };
+    },
+  };
+
+  return model;
+}
--- a/ts_audio/index.ts
+++ b/ts_audio/index.ts
@@ -0,0 +1,24 @@
+import * as plugins from './plugins.js';
+import { Readable } from 'stream';
+
+export interface IOpenAiTtsOptions {
+  apiKey: string;
+  text: string;
+  voice?: 'alloy' | 'echo' | 'fable' | 'onyx' | 'nova' | 'shimmer';
+  model?: 'tts-1' | 'tts-1-hd';
+  responseFormat?: 'mp3' | 'opus' | 'aac' | 'flac';
+  speed?: number;
+}
+
+export async function textToSpeech(options: IOpenAiTtsOptions): Promise<NodeJS.ReadableStream> {
+  const client = new plugins.OpenAI({ apiKey: options.apiKey });
+  const result = await client.audio.speech.create({
+    model: options.model ?? 'tts-1',
+    voice: options.voice ?? 'alloy',
+    input: options.text,
+    response_format: options.responseFormat ?? 'mp3',
+    speed: options.speed ?? 1,
+  });
+  const stream = result.body;
+  return Readable.fromWeb(stream as any);
+}
--- a/ts_audio/plugins.ts
+++ b/ts_audio/plugins.ts
@@ -0,0 +1,2 @@
+import OpenAI from 'openai';
+export { OpenAI };
--- a/ts_document/index.ts
+++ b/ts_document/index.ts
@@ -0,0 +1,61 @@
+import * as plugins from './plugins.js';
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+import type { ModelMessage } from 'ai';
+
+let smartpdfInstance: InstanceType<typeof plugins.smartpdf.SmartPdf> | null = null;
+
+async function ensureSmartpdf(): Promise<InstanceType<typeof plugins.smartpdf.SmartPdf>> {
+  if (!smartpdfInstance) {
+    smartpdfInstance = new plugins.smartpdf.SmartPdf();
+    await smartpdfInstance.start();
+  }
+  return smartpdfInstance;
+}
+
+export interface IDocumentOptions {
+  model: LanguageModelV3;
+  systemMessage?: string;
+  userMessage: string;
+  pdfDocuments: Uint8Array[];
+  messageHistory?: ModelMessage[];
+}
+
+export async function analyzeDocuments(options: IDocumentOptions): Promise<string> {
+  const pdf = await ensureSmartpdf();
+
+  const imagePages: Uint8Array[] = [];
+  for (const doc of options.pdfDocuments) {
+    const pages = await pdf.convertPDFToPngBytes(doc);
+    imagePages.push(...pages);
+  }
+
+  // Filter out empty buffers
+  const validPages = imagePages.filter(page => page && page.length > 0);
+
+  const result = await plugins.generateText({
+    model: options.model,
+    system: options.systemMessage,
+    messages: [
+      ...(options.messageHistory ?? []),
+      {
+        role: 'user',
+        content: [
+          { type: 'text', text: options.userMessage },
+          ...validPages.map(page => ({
+            type: 'image' as const,
+            image: page,
+            mimeType: 'image/png' as const,
+          })),
+        ],
+      },
+    ],
+  });
+  return result.text;
+}
+
+export async function stopSmartpdf(): Promise<void> {
+  if (smartpdfInstance) {
+    await smartpdfInstance.stop();
+    smartpdfInstance = null;
+  }
+}
--- a/ts_document/plugins.ts
+++ b/ts_document/plugins.ts
@@ -0,0 +1,3 @@
+import { generateText } from 'ai';
+import * as smartpdf from '@push.rocks/smartpdf';
+export { generateText, smartpdf };
--- a/ts_image/index.ts
+++ b/ts_image/index.ts
@@ -0,0 +1,147 @@
+import * as plugins from './plugins.js';
+
+export interface IImageGenerateOptions {
+  apiKey: string;
+  prompt: string;
+  model?: 'gpt-image-1' | 'dall-e-3' | 'dall-e-2';
+  quality?: 'low' | 'medium' | 'high' | 'standard' | 'hd' | 'auto';
+  size?: '256x256' | '512x512' | '1024x1024' | '1536x1024' | '1024x1536' | '1792x1024' | '1024x1792' | 'auto';
+  style?: 'vivid' | 'natural';
+  background?: 'transparent' | 'opaque' | 'auto';
+  outputFormat?: 'png' | 'jpeg' | 'webp';
+  outputCompression?: number;
+  moderation?: 'low' | 'auto';
+  n?: number;
+  stream?: boolean;
+  partialImages?: number;
+}
+
+export interface IImageEditOptions {
+  apiKey: string;
+  image: Buffer;
+  prompt: string;
+  mask?: Buffer;
+  model?: 'gpt-image-1' | 'dall-e-2';
+  quality?: 'low' | 'medium' | 'high' | 'standard' | 'auto';
+  size?: '256x256' | '512x512' | '1024x1024' | '1536x1024' | '1024x1536' | 'auto';
+  background?: 'transparent' | 'opaque' | 'auto';
+  outputFormat?: 'png' | 'jpeg' | 'webp';
+  outputCompression?: number;
+  n?: number;
+  stream?: boolean;
+  partialImages?: number;
+}
+
+export interface IImageResponse {
+  images: Array<{
+    b64_json?: string;
+    url?: string;
+    revisedPrompt?: string;
+  }>;
+  metadata?: {
+    model: string;
+    quality?: string;
+    size?: string;
+    outputFormat?: string;
+    tokensUsed?: number;
+  };
+}
+
+export async function generateImage(options: IImageGenerateOptions): Promise<IImageResponse> {
+  const client = new plugins.OpenAI({ apiKey: options.apiKey });
+  const model = options.model || 'gpt-image-1';
+
+  const requestParams: Record<string, unknown> = {
+    model,
+    prompt: options.prompt,
+    n: options.n || 1,
+  };
+
+  if (model === 'gpt-image-1') {
+    if (options.quality) requestParams.quality = options.quality;
+    if (options.size) requestParams.size = options.size;
+    if (options.background) requestParams.background = options.background;
+    if (options.outputFormat) requestParams.output_format = options.outputFormat;
+    if (options.outputCompression !== undefined) requestParams.output_compression = options.outputCompression;
+    if (options.moderation) requestParams.moderation = options.moderation;
+    if (options.stream !== undefined) requestParams.stream = options.stream;
+    if (options.partialImages !== undefined) requestParams.partial_images = options.partialImages;
+  } else if (model === 'dall-e-3') {
+    if (options.quality) requestParams.quality = options.quality;
+    if (options.size) requestParams.size = options.size;
+    if (options.style) requestParams.style = options.style;
+    requestParams.response_format = 'b64_json';
+  } else if (model === 'dall-e-2') {
+    if (options.size) requestParams.size = options.size;
+    requestParams.response_format = 'b64_json';
+  }
+
+  const result: any = await client.images.generate(requestParams as any);
+
+  const images = (result.data || []).map((img: any) => ({
+    b64_json: img.b64_json,
+    url: img.url,
+    revisedPrompt: img.revised_prompt,
+  }));
+
+  return {
+    images,
+    metadata: {
+      model,
+      quality: result.quality,
+      size: result.size,
+      outputFormat: result.output_format,
+      tokensUsed: result.usage?.total_tokens,
+    },
+  };
+}
+
+export async function editImage(options: IImageEditOptions): Promise<IImageResponse> {
+  const client = new plugins.OpenAI({ apiKey: options.apiKey });
+  const model = options.model || 'gpt-image-1';
+
+  const imageFile = await plugins.toFile(options.image, 'image.png', { type: 'image/png' });
+
+  const requestParams: Record<string, unknown> = {
+    model,
+    image: imageFile,
+    prompt: options.prompt,
+    n: options.n || 1,
+  };
+
+  if (options.mask) {
+    requestParams.mask = await plugins.toFile(options.mask, 'mask.png', { type: 'image/png' });
+  }
+
+  if (model === 'gpt-image-1') {
+    if (options.quality) requestParams.quality = options.quality;
+    if (options.size) requestParams.size = options.size;
+    if (options.background) requestParams.background = options.background;
+    if (options.outputFormat) requestParams.output_format = options.outputFormat;
+    if (options.outputCompression !== undefined) requestParams.output_compression = options.outputCompression;
+    if (options.stream !== undefined) requestParams.stream = options.stream;
+    if (options.partialImages !== undefined) requestParams.partial_images = options.partialImages;
+  } else if (model === 'dall-e-2') {
+    if (options.size) requestParams.size = options.size;
+    requestParams.response_format = 'b64_json';
+  }
+
+  const result: any = await client.images.edit(requestParams as any);
+
+  const images = (result.data || []).map((img: any) => ({
+    b64_json: img.b64_json,
+    url: img.url,
+    revisedPrompt: img.revised_prompt,
+  }));
+
+  return {
+    images,
+    metadata: {
+      model,
+      quality: result.quality,
+      size: result.size,
+      outputFormat: result.output_format,
+      tokensUsed: result.usage?.total_tokens,
+    },
+  };
+}
--- a/ts_image/plugins.ts
+++ b/ts_image/plugins.ts
@@ -0,0 +1,3 @@
+import OpenAI from 'openai';
+import { toFile } from 'openai';
+export { OpenAI, toFile };
--- a/ts_research/index.ts
+++ b/ts_research/index.ts
@@ -0,0 +1,120 @@
+import * as plugins from './plugins.js';
+
+export interface IResearchOptions {
+  apiKey: string;
+  query: string;
+  searchDepth?: 'basic' | 'advanced' | 'deep';
+  maxSources?: number;
+  allowedDomains?: string[];
+  blockedDomains?: string[];
+}
+
+export interface IResearchResponse {
+  answer: string;
+  sources: Array<{ url: string; title: string; snippet: string }>;
+  searchQueries?: string[];
+  metadata?: Record<string, unknown>;
+}
+
+export async function research(options: IResearchOptions): Promise<IResearchResponse> {
+  const client = new plugins.Anthropic({ apiKey: options.apiKey });
+
+  const systemMessage = `You are a research assistant with web search capabilities.
+Provide comprehensive, well-researched answers with citations and sources.
+When searching the web, be thorough and cite your sources accurately.`;
+
+  // Build web search tool config
+  const webSearchTool: any = {
+    type: 'web_search_20250305',
+    name: 'web_search',
+  };
+
+  if (options.maxSources) {
+    webSearchTool.max_uses = options.maxSources;
+  }
+  if (options.allowedDomains?.length) {
+    webSearchTool.allowed_domains = options.allowedDomains;
+  } else if (options.blockedDomains?.length) {
+    webSearchTool.blocked_domains = options.blockedDomains;
+  }
+
+  const result = await client.messages.create({
+    model: 'claude-sonnet-4-5-20250929',
+    system: systemMessage,
+    messages: [
+      { role: 'user' as const, content: options.query },
+    ],
+    max_tokens: 20000,
+    temperature: 0.7,
+    tools: [webSearchTool],
+  });
+
+  // Extract answer, sources, and search queries
+  let answer = '';
+  const sources: Array<{ url: string; title: string; snippet: string }> = [];
+  const searchQueries: string[] = [];
+
+  for (const block of result.content) {
+    const b: any = block;
+    if ('text' in b) {
+      answer += b.text;
+
+      // Extract citations if present
+      if (b.citations && Array.isArray(b.citations)) {
+        for (const citation of b.citations) {
+          if (citation.type === 'web_search_result_location') {
+            sources.push({
+              title: citation.title || '',
+              url: citation.url || '',
+              snippet: citation.cited_text || '',
+            });
+          }
+        }
+      }
+    } else if (b.type === 'server_tool_use') {
+      if (b.name === 'web_search' && b.input?.query) {
+        searchQueries.push(b.input.query);
+      }
+    } else if (b.type === 'web_search_tool_result') {
+      if (Array.isArray(b.content)) {
+        for (const item of b.content) {
+          if (item.type === 'web_search_result') {
+            if (!sources.some(s => s.url === item.url)) {
+              sources.push({
+                title: item.title || '',
+                url: item.url || '',
+                snippet: '',
+              });
+            }
+          }
+        }
+      }
+    }
+  }
+
+  // Fallback: parse markdown links if no citations found
+  if (sources.length === 0) {
+    const urlRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+    let match: RegExpExecArray | null;
+    while ((match = urlRegex.exec(answer)) !== null) {
+      sources.push({
+        title: match[1],
+        url: match[2],
+        snippet: '',
+      });
+    }
+  }
+
+  const usage: any = result.usage;
+  return {
+    answer,
+    sources,
+    searchQueries: searchQueries.length > 0 ? searchQueries : undefined,
+    metadata: {
+      model: 'claude-sonnet-4-5-20250929',
+      searchDepth: options.searchDepth || 'basic',
+      tokensUsed: usage?.output_tokens,
+      webSearchesPerformed: usage?.server_tool_use?.web_search_requests ?? 0,
+    },
+  };
+}
--- a/ts_research/plugins.ts
+++ b/ts_research/plugins.ts
@@ -0,0 +1,2 @@
+import Anthropic from '@anthropic-ai/sdk';
+export { Anthropic };
--- a/ts_vision/index.ts
+++ b/ts_vision/index.ts
@@ -0,0 +1,29 @@
+import * as plugins from './plugins.js';
+import type { LanguageModelV3 } from '@ai-sdk/provider';
+
+export interface IVisionOptions {
+  model: LanguageModelV3;
+  image: Buffer | Uint8Array;
+  prompt: string;
+  mediaType?: 'image/jpeg' | 'image/png' | 'image/webp' | 'image/gif';
+}
+
+export async function analyzeImage(options: IVisionOptions): Promise<string> {
+  const result = await plugins.generateText({
+    model: options.model,
+    messages: [
+      {
+        role: 'user',
+        content: [
+          { type: 'text', text: options.prompt },
+          {
+            type: 'image',
+            image: options.image,
+            mediaType: options.mediaType ?? 'image/jpeg',
+          },
+        ],
+      },
+    ],
+  });
+  return result.text;
+}
--- a/ts_vision/plugins.ts
+++ b/ts_vision/plugins.ts
@@ -0,0 +1,2 @@
+import { generateText } from 'ai';
+export { generateText };
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -6,9 +6,9 @@
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "esModuleInterop": true,
-    "verbatimModuleSyntax": true
+    "verbatimModuleSyntax": true,
+    "baseUrl": ".",
+    "paths": {}
  },
-  "exclude": [
-    "dist_*/**/*.d.ts"
-  ]
+  "exclude": ["dist_*/**/*.d.ts"]
 }
Author	SHA1	Message	Date
Juergen Kunz	a51b002141	v2.0.0 Some checks failed Default (tags) / security (push) Failing after 0s Details Default (tags) / test (push) Failing after 0s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-03-05 19:37:29 +00:00
Juergen Kunz	c24010c9bc	BREAKING CHANGE(vercel-ai-sdk): migrate to Vercel AI SDK v6 and introduce provider registry (getModel) returning LanguageModelV3	2026-03-05 19:37:29 +00:00
Juergen Kunz	27cef60900	v0.13.3 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 03:55:09 +00:00
Juergen Kunz	2b00e36b02	fix(): no changes detected	2026-01-20 03:55:09 +00:00
Juergen Kunz	8eb3111e7e	fix(ollama): preserve tool_calls in message history for native tool calling When using native tool calling, the assistant's tool_calls must be saved in message history. Without this, the model doesn't know it already called a tool and may loop indefinitely calling the same tool. This fix adds tool_calls forwarding in chatStreamResponse and chatWithOptions history formatting.	2026-01-20 03:54:51 +00:00
Juergen Kunz	d296a1b676	v0.13.2 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 02:50:46 +00:00
Juergen Kunz	f74d1cf2ba	fix(repo): no changes detected in diff; nothing to commit	2026-01-20 02:50:46 +00:00
Juergen Kunz	b29d7f5df3	fix(classes.smartai): use IOllamaModelOptions type for defaultOptions instead of inline type	2026-01-20 02:50:32 +00:00
Juergen Kunz	00b8312fa7	v0.13.1 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 02:40:29 +00:00
Juergen Kunz	4be91d678a	fix(): no changes detected; no release required	2026-01-20 02:40:29 +00:00
Juergen Kunz	1156320546	feat(provider.ollama): add native tool calling support for Ollama API - Add IOllamaTool and IOllamaToolCall types for native function calling - Add think parameter to IOllamaModelOptions for reasoning models (GPT-OSS, QwQ) - Add tools parameter to IOllamaChatOptions - Add toolCalls to response interfaces (IOllamaStreamChunk, IOllamaChatResponse) - Update chat(), chatStreamResponse(), collectStreamResponse(), chatWithOptions() to support native tools - Parse tool_calls from Ollama API responses - Add support for tool message role in conversation history	2026-01-20 02:39:28 +00:00
Juergen Kunz	7cb9bc24dc	v0.13.0 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 02:03:20 +00:00
Juergen Kunz	9ad039f77b	feat(provider.ollama): add chain-of-thought reasoning support to chat messages and Ollama provider	2026-01-20 02:03:20 +00:00
Juergen Kunz	6c6652d75d	v0.12.1 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 01:27:52 +00:00
Juergen Kunz	2040b3c629	fix(docs): update documentation: clarify provider capabilities, add provider capabilities summary, polish examples and formatting, and remove Serena project config	2026-01-20 01:27:52 +00:00
Juergen Kunz	ae8d3ccf33	v0.12.0 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 01:10:27 +00:00
Juergen Kunz	3b900d0ba9	feat(ollama): add support for base64-encoded images in chat messages and forward them to the Ollama provider	2026-01-20 01:10:27 +00:00
Juergen Kunz	d49152390f	v0.11.1	2026-01-20 00:37:59 +00:00
Juergen Kunz	d615ec9227	feat(streaming): add chatStreaming method with token callback for real-time generation progress - Add StreamingChatOptions interface with onToken callback - Add optional chatStreaming method to MultiModalModel abstract class - Implement chatStreaming in OllamaProvider using collectStreamResponse	2026-01-20 00:37:49 +00:00
Juergen Kunz	dfa863ee7d	v0.11.0 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 00:12:21 +00:00
Juergen Kunz	c84ede1f1d	feat(ollama): support defaultOptions and defaultTimeout for ollama provider	2026-01-20 00:12:21 +00:00
Juergen Kunz	4937dbf6ab	v0.10.1 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-20 00:03:06 +00:00
Juergen Kunz	8cb052449e	fix(): no changes detected — no release necessary	2026-01-20 00:03:06 +00:00
Juergen Kunz	126e9b239b	feat(OllamaProvider): add model options, streaming support, and thinking tokens - Add IOllamaModelOptions interface for runtime options (num_ctx, temperature, etc.) - Extend IOllamaProviderOptions with defaultOptions and defaultTimeout - Add IOllamaChatOptions for per-request overrides - Add IOllamaStreamChunk and IOllamaChatResponse interfaces - Add chatStreamResponse() for async iteration with options - Add collectStreamResponse() for streaming with progress callback - Add chatWithOptions() for non-streaming with full options - Update chat() to use defaultOptions and defaultTimeout	2026-01-20 00:02:45 +00:00
Juergen Kunz	a556053510	v0.10.0 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-18 22:11:52 +00:00
Juergen Kunz	e4dc81edc9	feat(mistral): add Mistral provider with native PDF OCR and chat integration	2026-01-18 22:11:52 +00:00
Juergen Kunz	6f79dc3535	v0.9.0 Some checks failed Default (tags) / security (push) Failing after 1s Details Default (tags) / test (push) Failing after 1s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-18 16:26:16 +00:00
Juergen Kunz	b4ced080f2	feat(providers): Add Anthropic extended thinking and adapt providers to new streaming/file APIs; bump dependencies and update docs, tests and configuration	2026-01-18 16:26:16 +00:00
Juergen Kunz	e8a2a3ff1b	0.8.0 Some checks failed Default (tags) / security (push) Failing after 24s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-30 12:11:18 +00:00
Juergen Kunz	cbc9d8d45b	feat(provider.anthropic): Add extended thinking modes to AnthropicProvider and apply thinking budgets to API calls	2025-10-30 12:11:18 +00:00
Juergen Kunz	d52e6ae67d	0.7.7 Some checks failed Default (tags) / security (push) Failing after 23s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-10 07:32:21 +00:00
Juergen Kunz	b9745a1869	fix(MultiModalModel): Lazy-load SmartPdf and guard document processing across providers; ensure SmartPdf is initialized only when needed	2025-10-10 07:32:21 +00:00
Juergen Kunz	af3b61cf74	0.7.6 Some checks failed Default (tags) / security (push) Failing after 23s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-09 07:00:15 +00:00
Juergen Kunz	8666876879	fix(provider.elevenlabs): Provide default ElevenLabs TTS voice fallback and add local tool/project configs	2025-10-09 07:00:15 +00:00
Juergen Kunz	b78168307b	0.7.5 Some checks failed Default (tags) / security (push) Failing after 24s Details Default (tags) / test (push) Failing after 15s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-08 22:56:53 +00:00
Juergen Kunz	bbd8770205	fix(provider.elevenlabs): Update ElevenLabs default TTS model to eleven_v3 and add local Claude permissions file	2025-10-08 22:56:53 +00:00
Juergen Kunz	28bb13dc0c	update	2025-10-08 22:49:08 +00:00
Juergen Kunz	3a24c2c4bd	0.7.4 Some checks failed Default (tags) / security (push) Failing after 21s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-03 15:47:15 +00:00
Juergen Kunz	8244ac6eb0	fix(provider.anthropic): Use image/png for embedded PDF images in Anthropic provider and add local Claude settings for development permissions	2025-10-03 15:47:15 +00:00
Juergen Kunz	2791d738d6	0.7.3 Some checks failed Default (tags) / security (push) Failing after 22s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-03 14:21:25 +00:00
Juergen Kunz	3fbd054985	fix(tests): Add extensive provider/feature tests and local Claude CI permissions	2025-10-03 14:21:25 +00:00
Juergen Kunz	8e8830ef92	0.7.2 Some checks failed Default (tags) / security (push) Failing after 14s Details Default (tags) / test (push) Failing after 14s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-03 13:51:49 +00:00
Juergen Kunz	34931875ad	fix(anthropic): Update Anthropic provider branding to Claude Sonnet 4.5 and add local Claude permissions	2025-10-03 13:51:49 +00:00
Juergen Kunz	2672509d3f	0.7.1 Some checks failed Default (tags) / security (push) Failing after 23s Details Default (tags) / test (push) Failing after 13s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-03 13:49:46 +00:00
Juergen Kunz	ee3a635852	fix(docs): Add README image generation docs and .claude local settings	2025-10-03 13:49:46 +00:00
Juergen Kunz	a222b1c2fa	0.7.0 Some checks failed Default (tags) / security (push) Failing after 24s Details Default (tags) / test (push) Failing after 15s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-10-03 13:43:29 +00:00
Juergen Kunz	f0556e89f3	feat(providers): Add research API and image generation/editing support; extend providers and tests	2025-10-03 13:43:29 +00:00
Juergen Kunz	fe8540c8ba	feat(research): Implement research APIs.	2025-10-03 12:50:42 +00:00
Juergen Kunz	e34bf19698	0.6.1 Some checks failed Default (tags) / security (push) Failing after 21s Details Default (tags) / test (push) Failing after 13s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-09-28 15:51:50 +00:00
Juergen Kunz	f70353e6ca	fix(provider.anthropic): Fix Anthropic research tool identifier and add tests + local Claude permissions	2025-09-28 15:51:50 +00:00
Juergen Kunz	0403443634	0.6.0 Some checks failed Default (tags) / security (push) Failing after 23s Details Default (tags) / test (push) Failing after 13s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-09-28 15:06:07 +00:00
Juergen Kunz	e2ed429aac	feat(research): Introduce research API with provider implementations, docs and tests	2025-09-28 15:06:07 +00:00
Juergen Kunz	5c856ec3ed	0.5.11 Some checks failed Default (tags) / security (push) Failing after 21s Details Default (tags) / test (push) Failing after 12s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-08-12 13:15:37 +00:00
Juergen Kunz	052f37294d	fix(openaiProvider): Update default chat model to gpt-5-mini and bump dependency versions	2025-08-12 13:15:36 +00:00
Juergen Kunz	93bb375059	fix(dependencies): Update SmartPdf to v4.1.1 for enhanced PDF processing capabilities Some checks failed Default (tags) / security (push) Failing after 19s Details Default (tags) / test (push) Failing after 18s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-08-03 08:17:24 +00:00
Juergen Kunz	574f7a594c	fix(documentation): remove contribution section from readme Some checks failed Default (tags) / security (push) Failing after 23s Details Default (tags) / test (push) Failing after 12s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-08-01 18:37:26 +00:00
Juergen Kunz	0b2a058550	fix(core): improve SmartPdf lifecycle management and update dependencies Some checks failed Default (tags) / security (push) Failing after 19s Details Default (tags) / test (push) Failing after 16s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-08-01 18:25:46 +00:00
Juergen Kunz	88d15c89e5	0.5.6 Some checks failed Default (tags) / security (push) Failing after 24s Details Default (tags) / test (push) Failing after 13s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-07-26 16:17:11 +00:00
Juergen Kunz	4bf7113334	feat(documentation): comprehensive documentation enhancement and test improvements Some checks failed Default (tags) / security (push) Failing after 25s Details Default (tags) / test (push) Failing after 12s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2025-07-25 18:00:23 +00:00
Philipp Kunz	6bdbeae144	0.5.4	2025-05-13 18:39:58 +00:00
Philipp Kunz	09c27379cb	fix(provider.openai): Update dependency versions, clean test imports, and adjust default OpenAI model configurations	2025-05-13 18:39:57 +00:00
Philipp Kunz	2bc6f7ee5e	0.5.3	2025-04-03 21:46:40 +00:00
Philipp Kunz	0ac50d647d	fix(package.json): Add explicit packageManager field to package.json	2025-04-03 21:46:40 +00:00
Philipp Kunz	5f9ffc7356	0.5.2	2025-04-03 21:46:15 +00:00
Philipp Kunz	502b665224	fix(readme): Remove redundant conclusion section from README to streamline documentation.	2025-04-03 21:46:14 +00:00
Philipp Kunz	bda0d7ed7e	0.5.1	2025-02-25 19:15:32 +00:00
Philipp Kunz	de2a60d12f	fix(OpenAiProvider): Corrected audio model ID in OpenAiProvider	2025-02-25 19:15:32 +00:00
Philipp Kunz	5b3a93a43a	0.5.0	2025-02-25 19:04:40 +00:00
Philipp Kunz	6b241f8889	feat(documentation and configuration): Enhanced package and README documentation	2025-02-25 19:04:40 +00:00
Philipp Kunz	0a80ac0a8a	0.4.2	2025-02-25 18:23:28 +00:00
Philipp Kunz	6ce442354e	fix(core): Fix OpenAI chat streaming and PDF document processing logic.	2025-02-25 18:23:28 +00:00
Philipp Kunz	9b38a3c06e	0.4.1	2025-02-25 13:01:23 +00:00
Philipp Kunz	5dead05324	fix(provider): Fix provider modules for consistency	2025-02-25 13:01:23 +00:00
Philipp Kunz	6916dd9e2a	0.4.0	2025-02-08 12:08:14 +01:00
Philipp Kunz	f89888a542	feat(core): Added support for Exo AI provider	2025-02-08 12:08:14 +01:00
Philipp Kunz	d93b198b09	0.3.3	2025-02-05 14:24:34 +01:00
Philipp Kunz	9e390d0fdb	fix(documentation): Update readme with detailed license and legal information.	2025-02-05 14:24:34 +01:00
Philipp Kunz	8329ee861e	0.3.2	2025-02-05 14:22:41 +01:00
Philipp Kunz	b8585a0afb	fix(documentation): Remove redundant badges from readme	2025-02-05 14:22:41 +01:00
Philipp Kunz	c96f5118cf	0.3.1	2025-02-05 14:21:27 +01:00
Philipp Kunz	17e1a1f1e1	fix(documentation): Updated README structure and added detailed usage examples	2025-02-05 14:21:26 +01:00
Philipp Kunz	de940dff75	0.3.0	2025-02-05 14:09:07 +01:00
Philipp Kunz	4fc1e029e4	feat(integration-xai): Add support for X.AI provider with chat and document processing capabilities.	2025-02-05 14:09:06 +01:00
Philipp Kunz	d0a4151a2b	0.2.0	2025-02-03 17:48:37 +01:00
Philipp Kunz	ad5dd4799b	feat(provider.anthropic): Add support for vision and document processing in Anthropic provider	2025-02-03 17:48:36 +01:00
Philipp Kunz	1c49af74ac	0.1.0	2025-02-03 15:26:00 +01:00
Philipp Kunz	eda8ce36df	feat(providers): Add vision and document processing capabilities to providers	2025-02-03 15:26:00 +01:00
Philipp Kunz	e82c510094	0.0.19	2025-02-03 15:16:59 +01:00
Philipp Kunz	0378308721	fix(core): Enhanced chat streaming and error handling across providers	2025-02-03 15:16:58 +01:00
Philipp Kunz	189a32683f	0.0.18	2024-09-19 12:56:35 +02:00
Philipp Kunz	f731b9f78d	fix(dependencies): Update dependencies to the latest versions.	2024-09-19 12:56:35 +02:00
Philipp Kunz	3701e21284	update description	2024-05-29 14:11:41 +02:00
Philipp Kunz	490d4996d2	0.0.17	2024-05-17 17:18:26 +02:00
Philipp Kunz	f099a8f1ed	fix(core): update	2024-05-17 17:18:26 +02:00
Philipp Kunz	a0228a0abc	0.0.16	2024-05-17 16:25:22 +02:00
Philipp Kunz	a5257b52e7	fix(core): update	2024-05-17 16:25:22 +02:00
Philipp Kunz	a4144fc071	0.0.15	2024-04-29 18:04:14 +02:00
Philipp Kunz	af46b3e81e	fix(core): update	2024-04-29 18:04:14 +02:00
Philipp Kunz	d50427937c	0.0.14	2024-04-29 12:38:25 +02:00
Philipp Kunz	ffde2e0bf1	fix(core): update	2024-04-29 12:38:25 +02:00
Philipp Kunz	82abc06da4	0.0.13	2024-04-29 12:37:43 +02:00
Philipp Kunz	3a5f2d52e5	fix(core): update	2024-04-29 12:37:43 +02:00