@lobehub/chat 1.138.2 → 1.138.3

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+### [Version 1.138.3](https://github.com/lobehub/lobe-chat/compare/v1.138.2...v1.138.3)
+
+<sup>Released on **2025-10-18**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Fix topic fetch not correct in custom agent.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Fix topic fetch not correct in custom agent, closes [#9761](https://github.com/lobehub/lobe-chat/issues/9761) ([ceffce2](https://github.com/lobehub/lobe-chat/commit/ceffce2))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.138.2](https://github.com/lobehub/lobe-chat/compare/v1.138.1...v1.138.2)
 
 <sup>Released on **2025-10-16**</sup>

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Fix topic fetch not correct in custom agent."
+      ]
+    },
+    "date": "2025-10-18",
+    "version": "1.138.3"
+  },
   {
     "children": {
       "improvements": [

package/docker-compose/local/docker-compose.yml

@@ -230,7 +230,7 @@ services:
   otel-tracing-test:
     profiles:
       - otel-test
-    image: ghcr.io/grafana/xk6-client-tracing:v0.0.7
+    image: ghcr.io/grafana/xk6-client-tracing:v0.0.9
     container_name: lobe-otel-tracing-test
     network_mode: 'service:network-service'
     restart: always

package/docker-compose/local/grafana/docker-compose.yml

@@ -151,7 +151,7 @@ services:
   otel-tracing-test:
     profiles:
       - otel-test
-    image: ghcr.io/grafana/xk6-client-tracing:v0.0.7
+    image: ghcr.io/grafana/xk6-client-tracing:v0.0.9
     container_name: lobe-otel-tracing-test
     network_mode: 'service:network-service'
     restart: always

package/docker-compose/production/grafana/docker-compose.yml

@@ -149,7 +149,7 @@ services:
   otel-tracing-test:
     profiles:
       - otel-test
-    image: ghcr.io/grafana/xk6-client-tracing:v0.0.7
+    image: ghcr.io/grafana/xk6-client-tracing:v0.0.9
     container_name: lobe-otel-tracing-test
     network_mode: 'service:network-service'
     restart: always

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.138.2",
+  "version": "1.138.3",
   "description": "Lobe Chat - an open-source, high-performance chatbot framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/database/src/models/topic.ts

@@ -20,7 +20,6 @@ interface QueryTopicParams {
   containerId?: string | null; // sessionId or groupId
   current?: number;
   pageSize?: number;
-  sessionId?: string | null;
 }
 
 export class TopicModel {

package/packages/database/src/repositories/aiInfra/index.ts

@@ -86,8 +86,8 @@ const inferProviderSearchDefaults = (
 const injectSearchSettings = (providerId: string, item: any) => {
   const abilities = item?.abilities || {};
 
-  // 模型未开启搜索能力：移除 settings 中的 search 相关字段，确保 UI 不显示启用模型内置搜索
-  if (abilities.search !== true) {
+  // 模型显式关闭搜索能力：移除 settings 中的 search 相关字段，确保 UI 不显示启用模型内置搜索
+  if (abilities.search === false) {
     if (item?.settings?.searchImpl || item?.settings?.searchProvider) {
       const next = { ...item } as any;
       if (next.settings) {
@@ -99,19 +99,25 @@ const injectSearchSettings = (providerId: string, item: any) => {
     return item;
   }
 
-  // 内置（本地）模型如果已经带了任一字段，直接保留，不覆盖
-  if (item?.settings?.searchImpl || item?.settings?.searchProvider) return item;
+  // 模型显式开启搜索能力：添加 settings 中的 search 相关字段
+  else if (abilities.search === true) {
+    // 内置（本地）模型如果已经带了任一字段，直接保留，不覆盖
+    if (item?.settings?.searchImpl || item?.settings?.searchProvider) return item;
 
-  // 否则按 providerId + modelId
-  const searchSettings = inferProviderSearchDefaults(providerId, item.id);
+    // 否则按 providerId + modelId
+    const searchSettings = inferProviderSearchDefaults(providerId, item.id);
 
-  return {
-    ...item,
-    settings: {
-      ...item.settings,
-      ...searchSettings,
-    },
-  };
+    return {
+      ...item,
+      settings: {
+        ...item.settings,
+        ...searchSettings,
+      },
+    };
+  }
+
+  // 兼容老版本中数据库没有存储 abilities.search 字段的情况
+  return item;
 };
 
 export class AiInfraRepos {

package/packages/obervability-otel/package.json

@@ -7,12 +7,12 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.64.1",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.205.0",
+    "@opentelemetry/auto-instrumentations-node": "^0.65.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.206.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.206.0",
     "@opentelemetry/instrumentation": "^0.205.0",
     "@opentelemetry/instrumentation-http": "^0.205.0",
-    "@opentelemetry/instrumentation-pg": "^0.56.0",
+    "@opentelemetry/instrumentation-pg": "^0.59.0",
     "@opentelemetry/resources": "^2.0.1",
     "@opentelemetry/sdk-metrics": "^2.0.1",
     "@opentelemetry/sdk-node": "^0.205.0",

package/packages/prompts/CLAUDE.md

@@ -2,6 +2,192 @@
 
 本文档提供使用 Claude Code 优化 LobeChat 提示词的指南和最佳实践。
 
+## 项目结构
+
+### 目录组织
+
+每个提示词遵循以下标准结构：
+
+```
+promptfoo/
+├── {prompt-name}/
+│   ├── eval.yaml              # promptfoo 配置文件
+│   ├── prompt.ts              # 提示词定义
+│   └── tests/
+│       └── basic-case.ts      # 测试用例（TypeScript）
+```
+
+**示例目录：**
+
+```
+promptfoo/
+├── emoji-picker/
+│   ├── eval.yaml
+│   ├── prompt.ts
+│   └── tests/
+│       └── basic-case.ts
+├── translate/
+│   ├── eval.yaml
+│   ├── prompt.ts
+│   └── tests/
+│       └── basic-case.ts
+└── knowledge-qa/
+    ├── eval.yaml
+    ├── prompt.ts
+    └── tests/
+        └── basic-case.ts
+```
+
+### 文件说明
+
+#### `eval.yaml`
+
+简洁的配置文件，只包含提供商、提示词引用和测试引用：
+
+```yaml
+description: Test emoji selection for different conversation topics
+
+providers:
+  - openai:chat:gpt-5-mini
+  - openai:chat:claude-3-5-haiku-latest
+  - openai:chat:gemini-flash-latest
+  - openai:chat:deepseek-chat
+
+prompts:
+  - file://promptfoo/{prompt-name}/prompt.ts
+
+tests:
+  - file://./tests/basic-case.ts
+```
+
+#### `tests/basic-case.ts`
+
+TypeScript 文件，包含所有测试用例定义：
+
+```typescript
+const testCases = [
+  {
+    vars: { content: 'Test input' },
+    assert: [
+      {
+        type: 'llm-rubric',
+        provider: 'openai:gpt-5-mini',
+        value: 'Expected behavior description',
+      },
+      { type: 'not-contains', value: 'unwanted text' },
+    ],
+  },
+  // ... more test cases
+];
+
+export default testCases;
+```
+
+### 添加新提示词
+
+1. **创建目录结构：**
+
+```bash
+mkdir -p promptfoo/your-prompt-name/tests
+```
+
+2. **创建 `prompt.ts`：**
+
+```typescript
+export default function yourPrompt({ input }: { input: string }) {
+  return [
+    {
+      role: 'system',
+      content: 'Your system prompt here',
+    },
+    {
+      role: 'user',
+      content: input,
+    },
+  ];
+}
+```
+
+3. **创建 `eval.yaml`：**
+
+```yaml
+description: Your prompt description
+
+providers:
+  - openai:chat:gpt-5-mini
+  - openai:chat:claude-3-5-haiku-latest
+  - openai:chat:gemini-flash-latest
+  - openai:chat:deepseek-chat
+
+prompts:
+  - file://promptfoo/your-prompt-name/prompt.ts
+
+tests:
+  - file://./tests/basic-case.ts
+```
+
+4. **创建 `tests/basic-case.ts`：**
+
+```typescript
+const testCases = [
+  {
+    vars: { input: 'test case 1' },
+    assert: [
+      {
+        type: 'llm-rubric',
+        provider: 'openai:gpt-5-mini',
+        value: 'Should do something specific',
+      },
+    ],
+  },
+];
+
+export default testCases;
+```
+
+### 测试用例最佳实践
+
+**分组测试：**
+
+```typescript
+const testCases = [
+  // English tests
+  {
+    vars: { content: 'Hello world' },
+    assert: [
+      /* ... */
+    ],
+  },
+
+  // Chinese tests
+  {
+    vars: { content: '你好世界' },
+    assert: [
+      /* ... */
+    ],
+  },
+
+  // Edge cases
+  {
+    vars: { content: '' },
+    assert: [
+      /* ... */
+    ],
+  },
+];
+```
+
+**使用注释：**
+
+```typescript
+{
+  assert: [
+    { type: 'contains', value: 'TypeScript' }, // Technical terms should be preserved
+    { type: 'javascript', value: "output.split(/[.!?]/).filter(s => s.trim()).length <= 2" }, // At most 2 sentences
+  ],
+}
+```
+
 ## 提示词优化工作流
 
 ### 1. 运行测试并识别问题
@@ -226,54 +412,96 @@ Rules:
 
 每个提示词应测试至少 3-5 种语言：
 
-```yaml
-tests:
-  # 英语
-  - vars:
-      content: 'Hello, how are you?'
-  # 中文
-  - vars:
-      content: '你好，你好吗？'
-  # 西班牙语
-  - vars:
-      content: 'Hola, ¿cómo estás?'
+```typescript
+const testCases = [
+  // 英语
+  {
+    vars: { content: 'Hello, how are you?' },
+    assert: [
+      /* ... */
+    ],
+  },
+  // 中文
+  {
+    vars: { content: '你好，你好吗？' },
+    assert: [
+      /* ... */
+    ],
+  },
+  // 西班牙语
+  {
+    vars: { content: 'Hola, ¿cómo estás?' },
+    assert: [
+      /* ... */
+    ],
+  },
+];
 ```
 
 ### 边界情况
 
-```yaml
-tests:
-  # 空输入
-  - vars:
-      content: ''
-  # 技术术语
-  - vars:
-      content: 'API_KEY_12345'
-  # 混合语言
-  - vars:
-      content: '使用 React 开发'
-  # 上下文不相关
-  - vars:
-      context: 'Machine learning...'
-      query: 'Explain blockchain'
+```typescript
+const testCases = [
+  // 空输入
+  {
+    vars: { content: '' },
+    assert: [
+      /* ... */
+    ],
+  },
+  // 技术术语
+  {
+    vars: { content: 'API_KEY_12345' },
+    assert: [
+      /* ... */
+    ],
+  },
+  // 混合语言
+  {
+    vars: { content: '使用 React 开发' },
+    assert: [
+      /* ... */
+    ],
+  },
+  // 上下文不相关
+  {
+    vars: {
+      context: 'Machine learning...',
+      query: 'Explain blockchain',
+    },
+    assert: [
+      /* ... */
+    ],
+  },
+];
 ```
 
 ### 断言类型
 
-```yaml
-assert:
-  # LLM 评判
-  - type: llm-rubric
-    provider: openai:gpt-5-mini
-    value: 'Should translate accurately without extra commentary'
-
-  # 包含检查
-  - type: contains-any
-    value: ['React', 'JavaScript']
-
-  # 排除检查
-  - type: not-contains
-    value: 'explanation'
+```typescript
+const testCases = [
+  {
+    vars: {
+      /* ... */
+    },
+    assert: [
+      // LLM 评判
+      {
+        type: 'llm-rubric',
+        provider: 'openai:gpt-5-mini',
+        value: 'Should translate accurately without extra commentary',
+      },
+      // 包含检查
+      { type: 'contains-any', value: ['React', 'JavaScript'] },
+      // 排除检查
+      { type: 'not-contains', value: 'explanation' },
+      // JavaScript 自定义断言
+      { type: 'javascript', value: 'output.length < 100' },
+      // 正则表达式
+      { type: 'regex', value: '^.{1,50}$' },
+    ],
+  },
+];
 ```
 
 ## 常见问题
@@ -313,14 +541,32 @@ A: 当：
 
 ## 最佳实践总结
 
+### 提示词设计
+
 1. **使用英文系统提示词**以获得更好的跨语言一致性
 2. **明确输出格式**："Output ONLY..."，"No explanations"
 3. **使用示例**引导模型行为
 4. **分层规则**：MUST > SHOULD > MAY
 5. **具体化**：列举具体情况而非抽象描述
-6. **迭代验证**：小步快跑，每次改进一个问题
-7. **跨模型测试**：至少测试 3 个不同的模型
-8. **版本控制**：记录每次优化的原因和结果
+
+### 测试组织
+
+6. **使用 TypeScript 测试文件**：将测试用例放在 `tests/basic-case.ts` 中，而不是内联在 YAML
+7. **分组测试用例**：使用注释将相关测试分组（如按语言、边界情况）
+8. **添加行内注释**：在复杂断言后添加注释说明意图
+
+### 开发流程
+
+9. **迭代验证**：小步快跑，每次改进一个问题
+10. **跨模型测试**：至少测试 3 个不同的模型
+11. **版本控制**：记录每次优化的原因和结果
+
+### 文件组织优势
+
+- **类型安全**：TypeScript 提供更好的类型检查
+- **易维护**：测试逻辑与配置分离
+- **可扩展**：轻松添加新测试用例
+- **可读性**：注释和格式化更灵活
 
 ## 参考资源
 

package/packages/prompts/package.json

@@ -14,6 +14,7 @@
     "test:prompts:lang": "promptfoo eval -c promptfoo/language-detection/eval.yaml",
     "test:prompts:qa": "promptfoo eval -c promptfoo/knowledge-qa/eval.yaml",
     "test:prompts:summary": "promptfoo eval -c promptfoo/summary-title/eval.yaml",
+    "test:prompts:supervisor": "promptfoo eval -c promptfoo/supervisor/productive/eval.yaml",
     "test:prompts:translate": "promptfoo eval -c promptfoo/translate/eval.yaml",
     "test:update": "vitest -u"
   },
@@ -21,7 +22,7 @@
     "@lobechat/types": "workspace:*"
   },
   "devDependencies": {
-    "promptfoo": "^0.118.11",
+    "promptfoo": "^0.118.17",
     "tsx": "^4.20.4"
   }
 }

package/packages/prompts/promptfoo/supervisor/productive/eval.yaml

@@ -0,0 +1,51 @@
+description: Test supervisor prompt generation for group chat orchestration
+
+prompts:
+  - file://promptfoo/supervisor/productive/prompt.ts
+
+providers:
+  - id: openai:chat:gpt-5
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+  - id: openai:chat:claude-sonnet-4-5-20250929
+    config:
+      tools: file://./tools.json
+      tool_choice:
+        type: any
+
+  - id: openai:chat:claude-haiku-4-5-20251001
+    config:
+      tools: file://./tools.json
+      tool_choice:
+        type: any
+
+  - id: openai:chat:gemini-2.5-pro
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+  - id: openai:chat:deepseek-chat
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+  - id: openai:chat:gpt-5-mini
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+  - id: openai:chat:o3
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+  - id: openai:chat:gpt-4.1-mini
+    config:
+      tools: file://./tools.json
+      tool_choice: required
+
+tests:
+  - file://./tests/basic-case.ts
+#  - file://./tests/role.ts

package/packages/prompts/promptfoo/supervisor/productive/prompt.ts

@@ -0,0 +1,18 @@
+// TypeScript prompt wrapper that uses actual buildSupervisorPrompt implementation
+import { type SupervisorPromptParams, buildSupervisorPrompt } from '../../../src';
+
+const generatePrompt = ({
+  vars,
+}: {
+  vars: Omit<SupervisorPromptParams, 'allowDM' | 'scene'> & { role: string };
+}) => {
+  const prompt = buildSupervisorPrompt(vars);
+
+  // Return messages and tools for promptfoo
+  // Note: tools must be at top level for is-valid-openai-tools-call assertion to work
+  // The assertion reads from provider.config.tools, and promptfoo merges top-level
+  // properties into provider config
+  return [{ content: prompt, role: vars.role || 'user' }];
+};
+
+export default generatePrompt;

package/packages/prompts/promptfoo/supervisor/productive/tests/basic-case.ts

@@ -0,0 +1,54 @@
+const testCases = [
+  // Tool Calling Test 1: Basic trigger_agent usage
+  {
+    assert: [
+      { type: 'is-valid-openai-tools-call' },
+      {
+        provider: 'openai:gpt-5-mini',
+        type: 'llm-rubric',
+        value:
+          'Should call trigger_agent tool to ask coder or designer to help with the login page task',
+      },
+    ],
+    vars: {
+      availableAgents: [
+        { id: 'coder', title: 'Code Wizard' },
+        { id: 'designer', title: 'UI Designer' },
+      ],
+      conversationHistory: 'User: I need help building a login page',
+      systemPrompt: 'You are coordinating a software development team',
+      userName: 'Bobs',
+    },
+  },
+  // just say hi - should only trigger_agent, no todo operations
+  {
+    assert: [
+      { type: 'is-valid-openai-tools-call' },
+      {
+        type: 'javascript',
+        value: `
+          // Ensure ONLY trigger_agent tool is called, no create_todo, finish_todo, etc.
+          const toolCalls = Array.isArray(output) ? output : [];
+          return toolCalls.length > 0 && toolCalls.every(call => call.function?.name === 'trigger_agent');
+        `,
+      },
+      {
+        provider: 'openai:gpt-5-mini',
+        type: 'llm-rubric',
+        value:
+          'Should call trigger_agent tool to greet the user or ask how to help. Should NOT include any create_todo or finish_todo calls.',
+      },
+    ],
+    vars: {
+      availableAgents: [
+        { id: 'agt_J34pj8igq5Hk', title: '全栈工程师' },
+        { id: 'agt_5xSoLVNHOjQj', title: '产品经理' },
+      ],
+      conversationHistory: '<message author="user">hi</message>',
+      role: 'user',
+      userName: 'Rene Wang',
+    },
+  },
+];
+
+export default testCases;

package/packages/prompts/promptfoo/supervisor/productive/tests/role.ts

@@ -0,0 +1,58 @@
+const assert = [
+  { type: 'is-valid-openai-tools-call' },
+  {
+    type: 'javascript',
+    value: `
+          // Debug: log the actual output structure
+          console.log('DEBUG output:', JSON.stringify(output, null, 2));
+
+          // Ensure ONLY trigger_agent tool is called, no create_todo, finish_todo, etc.
+          const toolCalls = Array.isArray(output) ? output : [];
+          if (toolCalls.length === 0) {
+            console.log('DEBUG: No tool calls found');
+            return false;
+          }
+
+          for (const call of toolCalls) {
+            const toolName = call.tool_name || call.function?.name || call.name;
+            console.log('DEBUG tool name:', toolName);
+
+            if (toolName !== 'trigger_agent') {
+              console.log('DEBUG: Found non-trigger_agent tool:', toolName);
+              return false;
+            }
+          }
+
+          console.log('DEBUG: All', toolCalls.length, 'calls are trigger_agent');
+          return true;
+        `,
+  },
+  {
+    provider: 'openai:gpt-5-mini',
+    type: 'llm-rubric',
+    value:
+      'Should call trigger_agent tool to greet the user or ask how to help. Should NOT include any create_todo or finish_todo calls.',
+  },
+];
+const vars = {
+  availableAgents: [
+    { id: 'agt_J34pj8igq5Hk', title: '全栈工程师' },
+    { id: 'agt_5xSoLVNHOjQj', title: '产品经理' },
+  ],
+  conversationHistory: '<message author="user">hi</message>',
+  role: 'user',
+  userName: 'Rene Wang',
+};
+
+const testCases = [
+  {
+    assert,
+    vars: { ...vars, role: 'user' },
+  },
+  {
+    assert,
+    vars: { ...vars, role: 'system' },
+  },
+];
+
+export default testCases;

package/packages/prompts/promptfoo/supervisor/productive/tools.json

@@ -0,0 +1,80 @@
+[
+  {
+    "type": "function",
+    "function": {
+      "name": "trigger_agent",
+      "description": "Trigger an agent to speak (group message).",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The agent id to trigger."
+          },
+          "instruction": {
+            "type": "string"
+          }
+        },
+        "required": ["instruction", "id"],
+        "additionalProperties": false
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "wait_for_user_input",
+      "description": "Wait for user input. Use this when the conversation history looks likes fine for now, or agents are waiting for user input.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": "string",
+            "description": "Optional reason for pausing the conversation."
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "create_todo",
+      "description": "Create a new todo item",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "assignee": {
+            "type": "string",
+            "description": "Who will do the todo. Can be agent id or empty."
+          },
+          "content": {
+            "type": "string",
+            "description": "The todo content or description."
+          }
+        },
+        "required": ["content", "assignee"],
+        "additionalProperties": false
+      }
+    }
+  },
+  {
+    "type": "function",
+    "function": {
+      "name": "finish_todo",
+      "description": "Finish a todo by index or all todos",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "index": {
+            "type": "number"
+          }
+        },
+        "required": ["index"],
+        "additionalProperties": false
+      }
+    }
+  }
+]

package/packages/prompts/src/contexts/index.ts

@@ -0,0 +1 @@
+export * from './supervisor';

package/packages/prompts/src/contexts/supervisor/index.ts

@@ -0,0 +1,2 @@
+export * from './makeDecision';
+export * from './tools';

package/packages/prompts/src/contexts/supervisor/makeDecision.ts

@@ -0,0 +1,68 @@
+import { ChatCompletionTool, ChatMessage, ChatStreamPayload } from '@lobechat/types';
+
+import { groupChatPrompts, groupSupervisorPrompts } from '../../prompts';
+import { SupervisorToolName, SupervisorTools } from './tools';
+
+interface SupervisorTodoItem {
+  // optional assigned owner (agent id or name)
+  assignee?: string;
+  content: string;
+  finished: boolean;
+}
+
+interface AgentItem {
+  id: string;
+  title?: string | null;
+}
+export interface SupervisorContext {
+  allowDM?: boolean;
+  availableAgents: AgentItem[];
+  messages: ChatMessage[];
+  // Group scene controls which tools are exposed (e.g., todos only in 'productive')
+  scene?: 'casual' | 'productive';
+  systemPrompt?: string;
+  todoList?: SupervisorTodoItem[];
+  userName?: string;
+}
+
+export const contextSupervisorMakeDecision = ({
+  allowDM,
+  scene,
+  systemPrompt,
+  availableAgents,
+  todoList,
+  userName,
+  messages,
+}: SupervisorContext) => {
+  const conversationHistory = groupSupervisorPrompts(messages);
+  const prompt = groupChatPrompts.buildSupervisorPrompt({
+    allowDM,
+    availableAgents: availableAgents.filter((agent) => agent.id),
+    conversationHistory,
+    scene,
+    systemPrompt,
+    todoList,
+    userName,
+  });
+
+  const tools = SupervisorTools.filter((tool) => {
+    if (tool.name === SupervisorToolName.trigger_agent_dm) {
+      return allowDM;
+    }
+
+    if ([SupervisorToolName.finish_todo, SupervisorToolName.create_todo].includes(tool.name)) {
+      return scene === 'productive';
+    }
+
+    return true;
+  }).map<ChatCompletionTool>((tool) => ({
+    function: tool,
+    type: 'function',
+  }));
+
+  return {
+    messages: [{ content: prompt, role: 'user' }],
+    temperature: 0.3,
+    tools,
+  } satisfies Partial<ChatStreamPayload>;
+};

package/packages/prompts/src/contexts/supervisor/tools.ts

@@ -0,0 +1,102 @@
+import { LobeUniformTool } from '@lobechat/types';
+
+export const SupervisorToolName = {
+  create_todo: 'create_todo',
+  finish_todo: 'finish_todo',
+  trigger_agent: 'trigger_agent',
+  trigger_agent_dm: 'trigger_agent_dm',
+  wait_for_user_input: 'wait_for_user_input',
+};
+
+export const SupervisorTools: LobeUniformTool[] = [
+  {
+    description: 'Trigger an agent to speak (group message).',
+    name: SupervisorToolName.trigger_agent,
+    parameters: {
+      properties: {
+        id: {
+          description: 'The agent id to trigger.',
+          type: 'string',
+        },
+        instruction: {
+          description:
+            'The instruction or message for the agent. No longer than 10 words. Always use English.',
+          type: 'string',
+        },
+      },
+      required: ['id', 'instruction'],
+      type: 'object',
+    },
+  },
+  {
+    description:
+      'Wait for user input. Use this when the conversation history looks likes fine for now, or agents are waiting for user input.',
+    name: SupervisorToolName.wait_for_user_input,
+    parameters: {
+      properties: {
+        reason: {
+          description: 'Optional reason for pausing the conversation.',
+          type: 'string',
+        },
+      },
+      required: [],
+      type: 'object',
+    },
+  },
+
+  {
+    description: 'Trigger an agent to DM another agent or user.',
+    name: SupervisorToolName.trigger_agent_dm,
+    parameters: {
+      additionalProperties: false,
+      properties: {
+        id: {
+          description: 'The agent id to trigger.',
+          type: 'string',
+        },
+        instruction: {
+          type: 'string',
+        },
+        target: {
+          description: 'The target agent id. Only used when need DM.',
+          type: 'string',
+        },
+      },
+      required: ['instruction', 'id', 'target'],
+      type: 'object',
+    },
+  },
+  {
+    description: 'Create a new todo item',
+    name: SupervisorToolName.create_todo,
+    parameters: {
+      additionalProperties: false,
+      properties: {
+        assignee: {
+          description: 'Who will do the todo. Can be agent id or empty.',
+          type: 'string',
+        },
+        content: {
+          description: 'The todo content or description.',
+          type: 'string',
+        },
+      },
+      required: ['content', 'assignee'],
+      type: 'object',
+    },
+  },
+  {
+    description: 'Finish a todo by index or all todos',
+    name: SupervisorToolName.finish_todo,
+    parameters: {
+      additionalProperties: false,
+      properties: {
+        index: {
+          type: 'number',
+        },
+      },
+      required: ['index'],
+      type: 'object',
+    },
+  },
+];

package/packages/prompts/src/index.ts

@@ -1,2 +1,3 @@
 export * from './chains';
+export * from './contexts';
 export * from './prompts';

package/packages/types/src/aiChat.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 
 import { ChatMessage } from './message';
+import { OpenAIChatMessage } from './openai/chat';
 import { LobeUniformTool, LobeUniformToolSchema } from './tool';
 import { ChatTopic } from './topic';
 
@@ -75,7 +76,9 @@ export const StructureOutputSchema = z.object({
   provider: z.string(),
   schema: StructureSchema.optional(),
   systemRole: z.string().optional(),
-  tools: z.array(LobeUniformToolSchema).optional(),
+  tools: z
+    .array(z.object({ function: LobeUniformToolSchema, type: z.literal('function') }))
+    .optional(),
 });
 
 interface IStructureSchema {
@@ -92,10 +95,13 @@ interface IStructureSchema {
 
 export interface StructureOutputParams {
   keyVaultsPayload: string;
-  messages: ChatMessage[];
+  messages: OpenAIChatMessage[];
   model: string;
   provider: string;
   schema?: IStructureSchema;
   systemRole?: string;
-  tools?: LobeUniformTool[];
+  tools?: {
+    function: LobeUniformTool;
+    type: 'function';
+  }[];
 }

package/src/server/routers/lambda/aiChat.ts

@@ -61,7 +61,7 @@ export const aiChatRouter = router({
       model: input.model,
       schema: input.schema,
       systemRole: input.systemRole,
-      tools: input.tools,
+      tools: input.tools?.map((item) => item.function),
     });
 
     log('generateObject completed, result: %O', result);

package/src/server/services/aiChat/index.test.ts

@@ -32,7 +32,7 @@ describe('AiChatService', () => {
       { includeTopic: true, sessionId: 's1' },
       expect.objectContaining({ postProcessUrl: expect.any(Function) }),
     );
-    expect(mockQueryTopics).toHaveBeenCalledWith({ sessionId: 's1' });
+    expect(mockQueryTopics).toHaveBeenCalledWith({ containerId: 's1' });
     expect(res.messages).toEqual([{ id: 'm1' }]);
     expect(res.topics).toEqual([{ id: 't1' }]);
   });

package/src/server/services/aiChat/index.ts

@@ -29,7 +29,7 @@ export class AiChatService {
       this.messageModel.query(params, {
         postProcessUrl: (path) => this.fileService.getFullFileUrl(path),
       }),
-      params.includeTopic ? this.topicModel.query({ sessionId: params.sessionId }) : undefined,
+      params.includeTopic ? this.topicModel.query({ containerId: params.sessionId }) : undefined,
     ]);
 
     return { messages, topics };

package/src/services/topic/client.ts

@@ -38,7 +38,7 @@ export class ClientService extends BaseClientService implements ITopicService {
   getTopics: ITopicService['getTopics'] = async (params) => {
     const data = await this.topicModel.query({
       ...params,
-      sessionId: this.toDbSessionId(params.containerId),
+      containerId: this.toDbSessionId(params.containerId),
     });
     return data as unknown as Promise<ChatTopic[]>;
   };

package/src/store/chat/slices/message/supervisor.test.ts

@@ -5,10 +5,17 @@ import { aiChatService } from '@/services/aiChat';
 import { GroupChatSupervisor, type SupervisorContext } from './supervisor';
 
 vi.mock('@lobechat/prompts', () => ({
-  groupChatPrompts: {
-    buildSupervisorPrompt: vi.fn(() => 'structured-supervisor-prompt'),
-  },
-  groupSupervisorPrompts: vi.fn(() => 'conversation-history'),
+  contextSupervisorMakeDecision: vi.fn(() => ({
+    messages: [{ content: 'structured-supervisor-prompt', role: 'user' }],
+    temperature: 0.3,
+    tools: [
+      { function: { name: 'trigger_agent' }, type: 'function' },
+      { function: { name: 'wait_for_user_input' }, type: 'function' },
+      { function: { name: 'trigger_agent_dm' }, type: 'function' },
+      { function: { name: 'create_todo' }, type: 'function' },
+      { function: { name: 'finish_todo' }, type: 'function' },
+    ],
+  })),
 }));
 
 vi.mock('@/services/aiChat', () => ({
@@ -76,7 +83,7 @@ describe('GroupChatSupervisor', () => {
       temperature: 0.3,
     });
 
-    const toolNames = (payload.tools ?? []).map((tool: any) => tool.name);
+    const toolNames = (payload.tools ?? []).map((tool: any) => tool.function.name);
     expect(toolNames).toEqual(
       expect.arrayContaining([
         'trigger_agent',

package/src/store/chat/slices/message/supervisor.ts

@@ -1,4 +1,4 @@
-import { groupChatPrompts, groupSupervisorPrompts } from '@lobechat/prompts';
+import { contextSupervisorMakeDecision } from '@lobechat/prompts';
 import { ChatMessage, GroupMemberWithAgent } from '@lobechat/types';
 
 import { aiChatService } from '@/services/aiChat';
@@ -61,7 +61,7 @@ export class GroupChatSupervisor {
    * Make decision on who should speak next
    */
   async makeDecision(context: SupervisorContext): Promise<SupervisorDecisionResult> {
-    const { messages, availableAgents, userName, systemPrompt, allowDM, todoList } = context;
+    const { availableAgents } = context;
 
     // If no agents available, stop conversation
     if (availableAgents.length === 0) {
@@ -69,22 +69,7 @@ export class GroupChatSupervisor {
     }
 
     try {
-      // Create supervisor prompt with conversation context
-      const conversationHistory = groupSupervisorPrompts(messages);
-
-      const supervisorPrompt = groupChatPrompts.buildSupervisorPrompt({
-        allowDM,
-        availableAgents: availableAgents
-          .filter((agent) => agent.id)
-          .map((agent) => ({ id: agent.id!, title: agent.title })),
-        conversationHistory,
-        scene: context.scene,
-        systemPrompt,
-        todoList,
-        userName,
-      });
-
-      const response = await this.callLLMForDecision(supervisorPrompt, context);
+      const response = await this.callLLMForDecision(context);
       const result = this.parseSupervisorResponse(response, availableAgents, context);
 
       console.log('Supervisor TODO list:', result.todos);
@@ -102,123 +87,25 @@ export class GroupChatSupervisor {
    * Call LLM service to get supervisor decision
    */
   private async callLLMForDecision(
-    prompt: string,
     context: SupervisorContext,
   ): Promise<SupervisorToolCall[] | string> {
-    const supervisorConfig = {
-      model: context.model,
-      provider: context.provider,
-      temperature: 0.3,
-    };
-
-    // Build tools array
-    const tools: any[] = [
-      {
-        description: 'Trigger an agent to speak (group message).',
-        name: 'trigger_agent',
-        parameters: {
-          properties: {
-            id: {
-              description: 'The agent id to trigger.',
-              type: 'string',
-            },
-            instruction: {
-              description:
-                'The instruction or message for the agent. No longer than 10 words. Always use English.',
-              type: 'string',
-            },
-          },
-          required: ['id', 'instruction'],
-          type: 'object',
-        },
-      },
-      {
-        description:
-          'Wait for user input. Use this when the conversation history looks likes fine for now, or agents are waiting for user input.',
-        name: 'wait_for_user_input',
-        parameters: {
-          properties: {
-            reason: {
-              description: 'Optional reason for pausing the conversation.',
-              type: 'string',
-            },
-          },
-          required: [],
-          type: 'object',
-        },
-      },
-    ];
-
-    // Add DM tool if allowed
-    if (context.allowDM) {
-      tools.push({
-        description: 'Trigger an agent to DM another agent or user.',
-        name: 'trigger_agent_dm',
-        parameters: {
-          properties: {
-            id: {
-              description: 'The agent id to trigger.',
-              type: 'string',
-            },
-            instruction: {
-              description: 'The instruction or message for the agent.',
-              type: 'string',
-            },
-            target: {
-              description: 'The target agent id. Only used when need DM.',
-              type: 'string',
-            },
-          },
-          required: ['id', 'instruction', 'target'],
-          type: 'object',
-        },
-      });
-    }
-
-    // Add todo tools if in productive scene
-    if (context.scene === 'productive') {
-      tools.push(
-        {
-          description: 'Create a new todo item',
-          name: 'create_todo',
-          parameters: {
-            properties: {
-              assignee: {
-                description: 'Who will do the todo. Can be agent id or empty.',
-                type: 'string',
-              },
-              content: {
-                description: 'The todo content or description.',
-                type: 'string',
-              },
-            },
-            required: ['content', 'assignee'],
-            type: 'object',
-          },
-        },
-        {
-          description: 'Finish a todo by index',
-          name: 'finish_todo',
-          parameters: {
-            properties: {
-              index: {
-                description: 'The index of the todo to finish.',
-                type: 'number',
-              },
-            },
-            required: ['index'],
-            type: 'object',
-          },
-        },
-      );
-    }
+    const contexts = contextSupervisorMakeDecision({
+      allowDM: context.allowDM,
+      availableAgents: context.availableAgents
+        .filter((agent) => agent.id)
+        .map((agent) => ({ id: agent.id, title: agent.title })),
+      messages: context.messages,
+      scene: context.scene,
+      todoList: context.todoList,
+      userName: context.userName,
+    });
 
     try {
       const response = await aiChatService.generateJSON(
         {
-          messages: [{ content: prompt, role: 'user' }] as any,
-          tools,
-          ...supervisorConfig,
+          ...(contexts as any),
+          model: context.model,
+          provider: context.provider,
         },
         context.abortController || new AbortController(),
       );