smart_prompt 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6417bfd0f16178f4e5b2d26b9c14f3ce8a22e8d9ab77f3cacf1845fa6531d6d0
-  data.tar.gz: 9eae765158a312e1605aad80917d59180109bb0a8c2603a2e2b7b95dd7284b00
+  metadata.gz: 73eed476ea088ca5d249ae100e774c4bbe4235242773c49b478ac60304f2250e
+  data.tar.gz: 7e28652297f66ab0829ea9f24927bfa0d8f8618915dc4e2d969f7733c29ca8bc
 SHA512:
-  metadata.gz: 4109ce9c8131961870d2c9b83d3d2ed534ebdf2ba42b34674516b61058034bab9af6c53079354d39a154759ca02bb39751eeb2c055465f2dfb7db8f2a3a12682
-  data.tar.gz: e12c080c4d95a7196e91497b02ef493a11b45e3da7ba6cdb5e342c00c40abb686fa1aac3e6c0db9e3905f5f18adab0395559188fe0fae5837c1128dad70f236b
+  metadata.gz: cfed4b173e3382fd59c8be7dd7712dd3e2da56948cf605e1e402e0c998bd20e6f0867915c9d8f749e6f794a63d796a013ea4c5aabad0177df17b2649e931c181
+  data.tar.gz: 21a684256011301008700ce3b66bf2220778ced62d1ecb4195fc610d492123a14717420f671af3499662f4df4fb9004948a7aeb5b9788756e715be2fdc9c344a

data/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.4.0] - 2026-06-21
+## [0.5.1] - 2026-06-21
 ### Added
 - **SenseNova (商汤日日新) support** — unified `SenseNovaAdapter` covering chat (商量), multimodal vision, Cupido embeddings, and 秒画 text-to-image, with SSE streaming and reasoning-field handling
 - **智谱 AI (BigModel / GLM) support** — unified `ZhipuAIAdapter` covering all REST categories: chat (GLM-4), vision (GLM-4V), embeddings (embedding-3), text-to-image (CogView), text-to-video (CogVideoX async), TTS (GLM-TTS), ASR (GLM-ASR), and rerank
@@ -13,9 +13,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Intelligent conversation history management (sliding-window, relevance-based, summary-based, hybrid strategies) with session isolation, compression, persistence, and LRU caching
 - Token counter, message/session models, and persistence layer
 - Example configs, workers, and self-contained examples for every provider
+- Integrated upstream gemma4 multimodal support (`use_model`, `thinking`, `image`/`audio`/`video`, `multimodal_prompt`) and `request_options` plumbing
 
 ### Fixed
 - Expose `engine` on `WorkerContext` so workers can reach a configured adapter directly (fixes the `engine.llms[...]` pattern used by media workers)
+- `Worker#execute` default session_id was hard-coded to `"default"`, leaving the per-worker session branch as dead code and collapsing all history-using workers onto one shared session; now generates `worker_<name>_<ts>`
+- `AnthropicAdapter`: add `extract_content_from_response` and stop double-wrapping multimodal (array) content
+- file_upload multimodal fix: base64-encode local image/audio/video files instead of passing raw paths
+
+## [0.4.1] - 2026-04-22
+### Fixed
+- Re-release package with `lib/smart_prompt/anthropic_adapter.rb`, which is required by the gem entrypoint.
+
+## [0.4.0] - 2026-04-22
+### Added
+- Anthropic adapter support.
+
+## [0.3.6] - 2026-04-08
+### Changed
+- Bumped `ruby-openai` dependency from `8.1.0` to `8.3.0`
 
 ## [0.3.2] - 2025-05-18
 ### Added
@@ -46,4 +62,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial gem release
 - Llama.cpp adapter
 - Basic configuration parameters
-- Environment bug fixes
+- Environment bug fixes

data/README.cn.md

@@ -95,12 +95,33 @@ llms:
     adapter: openai
     url: http://localhost:11434/
     default_model: deepseek-r1
+  gemma4_local:
+    adapter: openai
+    url: http://localhost:8000/v1
+    api_key: dummy
+    default_model: gemma-4-12B-it
+    temperature: 1.0
+    top_p: 0.95
+    top_k: 64
   deepseek:
     adapter: openai
     url: https://api.deepseek.com
     api_key: ENV["DSKEY"]
     default_model: deepseek-reasoner
 
+# 模型别名配置
+models:
+  local/qwen3.5:
+    use: local
+    model: qwen3.5
+  deepseekv3.2:
+    use: SiliconFlow
+    model: Pro/deepseek-ai/DeepSeek-V3.2
+  gemma4/12b:
+    use: gemma4_local
+    model: gemma-4-12B-it
+    max_tokens: 1024
+
 # 默认设置
 default_llm: SiliconFlow
 template_path: "./templates"
@@ -128,9 +149,8 @@ logger_file: "./logs/smart_prompt.log"
 **workers/chat_worker.rb**:
 ```ruby
 SmartPrompt.define_worker :chat_assistant do
-  # 使用特定的 LLM
-  use "SiliconFlow"
-  model "deepseek-ai/DeepSeek-V3"
+  # 使用配置好的模型别名
+  use_model "deepseekv3.2"
   # 设置系统消息
   sys_msg("你是一个有用的 AI 助手。", params)
   # 使用模板和参数  
@@ -182,6 +202,26 @@ engine.call_worker_by_stream(:streaming_chat, {
 end
 ```
 
+### Gemma 4 12B 多模态
+
+Gemma 4 12B 可以通过 LiteRT-LM、LM Studio、Ollama、llama.cpp 等 OpenAI 兼容本地服务接入。SmartPrompt 会把图片放在文本前、音频放在文本后，以匹配 Gemma 4 的多模态最佳实践。
+
+```ruby
+SmartPrompt.define_worker :gemma_multimodal_assistant do
+  use_model "gemma4/12b"
+  thinking params.fetch(:thinking, true)
+  sys_msg("你是一个严谨的本地多模态助手。", params)
+
+  image(params[:image], token_budget: params[:token_budget] || 280) if params[:image]
+  video(params[:video], fps: 1, max_seconds: 60) if params[:video]
+  audio(params[:audio]) if params[:audio]
+  prompt(params[:message])
+
+  request_options(response_format: { type: "json_object" }) if params[:json]
+  send_msg
+end
+```
+
 ### 工具集成
 
 ```ruby
@@ -561,6 +601,17 @@ llms:
     model: "FunAudioLLM/CosyVoice2-0.5B"
 ```
 
+### 模型别名配置
+
+```yaml
+models:
+  model_alias:
+    use: "llm_name"
+    model: "model_identifier"
+```
+
+在 worker 中，`use_model "model_alias"` 等价于调用 `use "llm_name"` 和 `model "model_identifier"`。
+
 ### 路径配置
 
 ```yaml
@@ -685,4 +736,4 @@ end
 
 ---
 
-**SmartPrompt** - 让 Ruby 应用中的 LLM 集成变得简单、强大且优雅。
+**SmartPrompt** - 让 Ruby 应用中的 LLM 集成变得简单、强大且优雅。

data/README.md

@@ -95,12 +95,33 @@ llms:
     adapter: openai
     url: http://localhost:11434/
     default_model: deepseek-r1
+  gemma4_local:
+    adapter: openai
+    url: http://localhost:8000/v1
+    api_key: dummy
+    default_model: gemma-4-12B-it
+    temperature: 1.0
+    top_p: 0.95
+    top_k: 64
   deepseek:
     adapter: openai
     url: https://api.deepseek.com
     api_key: ENV["DSKEY"]
     default_model: deepseek-reasoner
 
+# Model aliases
+models:
+  local/qwen3.5:
+    use: local
+    model: qwen3.5
+  deepseekv3.2:
+    use: SiliconFlow
+    model: Pro/deepseek-ai/DeepSeek-V3.2
+  gemma4/12b:
+    use: gemma4_local
+    model: gemma-4-12B-it
+    max_tokens: 1024
+
 # Default settings
 default_llm: SiliconFlow
 template_path: "./templates"
@@ -128,9 +149,8 @@ Create worker files in your `workers/` directory:
 **workers/chat_worker.rb**:
 ```ruby
 SmartPrompt.define_worker :chat_assistant do
-  # Use a specific LLM
-  use "SiliconFlow"
-  model "deepseek-ai/DeepSeek-V3"
+  # Use a configured model alias
+  use_model "deepseekv3.2"
   # Set system message
   sys_msg("You are a helpful AI assistant.", params)
   # Use template with parameters  
@@ -182,6 +202,26 @@ engine.call_worker_by_stream(:streaming_chat, {
 end
 ```
 
+### Gemma 4 12B Multimodal
+
+Gemma 4 12B can be connected through OpenAI-compatible local servers such as LiteRT-LM, LM Studio, Ollama, or llama.cpp. SmartPrompt places images before text and audio after text to match Gemma 4 multimodal best practices.
+
+```ruby
+SmartPrompt.define_worker :gemma_multimodal_assistant do
+  use_model "gemma4/12b"
+  thinking params.fetch(:thinking, true)
+  sys_msg("You are a precise local multimodal assistant.", params)
+
+  image(params[:image], token_budget: params[:token_budget] || 280) if params[:image]
+  video(params[:video], fps: 1, max_seconds: 60) if params[:video]
+  audio(params[:audio]) if params[:audio]
+  prompt(params[:message])
+
+  request_options(response_format: { type: "json_object" }) if params[:json]
+  send_msg
+end
+```
+
 ### Tool Integration
 
 ```ruby
@@ -565,6 +605,17 @@ llms:
     model: "FunAudioLLM/CosyVoice2-0.5B"
 ```
 
+### Model Alias Configuration
+
+```yaml
+models:
+  model_alias:
+    use: "llm_name"
+    model: "model_identifier"
+```
+
+In a worker, `use_model "model_alias"` is equivalent to calling `use "llm_name"` and `model "model_identifier"`.
+
 ### Path Configuration
 
 ```yaml
@@ -689,4 +740,4 @@ This project is licensed under the MIT License - see the [LICENSE.txt](LICENSE.t
 
 ---
 
-**SmartPrompt** - Making LLM integration in Ruby applications simple, powerful, and elegant.
+**SmartPrompt** - Making LLM integration in Ruby applications simple, powerful, and elegant.