@lobehub/lobehub 2.0.0-next.327 → 2.0.0-next.329

package/.env.example

@@ -307,9 +307,6 @@ OPENAI_API_KEY=sk-xxxxxxxxx
 # Shared between Better-Auth and Next-Auth
 # AUTH_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 
-# Auth URL (accessible from browser, optional if same domain)
-# NEXT_PUBLIC_AUTH_URL=http://localhost:3210
-
 # Require email verification before allowing users to sign in (default: false)
 # Set to '1' to force users to verify their email before signing in
 # NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION=0

package/.env.example.development

@@ -43,9 +43,6 @@ NEXT_PUBLIC_ENABLE_BETTER_AUTH=1
 # Better Auth secret for JWT signing (generate with: openssl rand -base64 32)
 AUTH_SECRET=${UNSAFE_SECRET}
 
-# Authentication URL
-NEXT_PUBLIC_AUTH_URL=${APP_URL}
-
 # SSO providers configuration - using Casdoor for development
 AUTH_SSO_PROVIDERS=casdoor
 

package/CHANGELOG.md

@@ -2,6 +2,64 @@
 
 # Changelog
 
+## [Version 2.0.0-next.329](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.328...v2.0.0-next.329)
+
+<sup>Released on **2026-01-21**</sup>
+
+#### ♻ Code Refactoring
+
+- **auth**: Remove NEXT_PUBLIC_AUTH_URL env variable.
+
+#### 🐛 Bug Fixes
+
+- **misc**: Sloved the old removeSessionTopics not work.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### Code refactoring
+
+- **auth**: Remove NEXT_PUBLIC_AUTH_URL env variable, closes [#11658](https://github.com/lobehub/lobe-chat/issues/11658) ([c0f9875](https://github.com/lobehub/lobe-chat/commit/c0f9875))
+
+#### What's fixed
+
+- **misc**: Sloved the old removeSessionTopics not work, closes [#11671](https://github.com/lobehub/lobe-chat/issues/11671) ([06d41e5](https://github.com/lobehub/lobe-chat/commit/06d41e5))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
+## [Version 2.0.0-next.328](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.327...v2.0.0-next.328)
+
+<sup>Released on **2026-01-20**</sup>
+
+#### ✨ Features
+
+- **misc**: Support client tasks mode.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Support client tasks mode, closes [#11666](https://github.com/lobehub/lobe-chat/issues/11666) ([98cf57b](https://github.com/lobehub/lobe-chat/commit/98cf57b))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.327](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.326...v2.0.0-next.327)
 
 <sup>Released on **2026-01-20**</sup>

package/Dockerfile

@@ -189,8 +189,7 @@ ENV KEY_VAULTS_SECRET="" \
 
 # Better Auth
 ENV AUTH_SECRET="" \
-    AUTH_SSO_PROVIDERS="" \
-    NEXT_PUBLIC_AUTH_URL=""
+    AUTH_SSO_PROVIDERS=""
 
 # Clerk
 ENV CLERK_SECRET_KEY="" \

package/changelog/v1.json

@@ -1,4 +1,22 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Sloved the old removeSessionTopics not work."
+      ]
+    },
+    "date": "2026-01-21",
+    "version": "2.0.0-next.329"
+  },
+  {
+    "children": {
+      "features": [
+        "Support client tasks mode."
+      ]
+    },
+    "date": "2026-01-20",
+    "version": "2.0.0-next.328"
+  },
   {
     "children": {},
     "date": "2026-01-20",

package/docs/self-hosting/advanced/auth.mdx

@@ -39,12 +39,11 @@ By setting the environment variables `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` and `CL
 
 To enable Better Auth in LobeChat, set the following environment variables:
 
-| Environment Variable             | Type     | Description                                                                                                                                                                |
-| -------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `NEXT_PUBLIC_ENABLE_BETTER_AUTH` | Required | Set to `1` to enable Better Auth service                                                                                                                                   |
-| `AUTH_SECRET`                    | Required | Key used to encrypt session tokens. Generate using: `openssl rand -base64 32`                                                                                              |
-| `NEXT_PUBLIC_AUTH_URL`           | Required | The browser-accessible base URL for Better Auth (e.g., `http://localhost:3010`, `https://lobechat.com`). Optional for Vercel deployments (auto-detected from `VERCEL_URL`) |
-| `AUTH_SSO_PROVIDERS`             | Optional | Comma-separated list of enabled SSO providers, e.g., `google,github,microsoft`                                                                                             |
+| Environment Variable             | Type     | Description                                                                   |
+| -------------------------------- | -------- | ----------------------------------------------------------------------------- |
+| `NEXT_PUBLIC_ENABLE_BETTER_AUTH` | Required | Set to `1` to enable Better Auth service                                      |
+| `AUTH_SECRET`                    | Required | Key used to encrypt session tokens. Generate using: `openssl rand -base64 32` |
+| `AUTH_SSO_PROVIDERS`             | Optional | Comma-separated list of enabled SSO providers, e.g., `google,github,microsoft`|
 
 <Callout type={'error'}>
   **Important**: Better Auth is currently only suitable for **fresh deployments**. If you are already using NextAuth or Clerk and have existing user data in your database, **do not switch to Better Auth yet**, otherwise existing users will not be able to log in.

package/docs/self-hosting/advanced/auth.zh-CN.mdx

@@ -37,12 +37,11 @@ LobeChat 与 Clerk 做了深度集成，能够为用户提供一个更加安全
 
 要在 LobeChat 中启用 Better Auth，请设置以下环境变量：
 
-| 环境变量                             | 类型 | 描述                                                                                                               |
-| -------------------------------- | -- | ---------------------------------------------------------------------------------------------------------------- |
-| `NEXT_PUBLIC_ENABLE_BETTER_AUTH` | 必选 | 设置为 `1` 以启用 Better Auth 服务                                                                                       |
-| `AUTH_SECRET`                    | 必选 | 用于加密会话令牌的密钥。使用以下命令生成：`openssl rand -base64 32`                                                                   |
-| `NEXT_PUBLIC_AUTH_URL`           | 必选 | 浏览器可访问的 Better Auth 基础 URL（例如 `http://localhost:3010`、`https://lobechat.com`）。Vercel 部署时可选（会自动从 `VERCEL_URL` 获取） |
-| `AUTH_SSO_PROVIDERS`             | 可选 | 启用的 SSO 提供商列表，以逗号分隔，例如 `google,github,microsoft`                                                                 |
+| 环境变量                             | 类型 | 描述                                                          |
+| -------------------------------- | -- | ----------------------------------------------------------- |
+| `NEXT_PUBLIC_ENABLE_BETTER_AUTH` | 必选 | 设置为 `1` 以启用 Better Auth 服务                                   |
+| `AUTH_SECRET`                    | 必选 | 用于加密会话令牌的密钥。使用以下命令生成：`openssl rand -base64 32`              |
+| `AUTH_SSO_PROVIDERS`             | 可选 | 启用的 SSO 提供商列表，以逗号分隔，例如 `google,github,microsoft`             |
 
 <Callout type={'error'}>
   **重要提示**：Better Auth 目前仅适用于**全新部署**的场景。如果你已经使用 NextAuth 或 Clerk 并且数据库中存在用户数据，**请暂时不要切换到 Better Auth**，否则现有用户将无法登录。

package/docs/self-hosting/environment-variables/auth.mdx

@@ -34,13 +34,6 @@ LobeChat provides a complete authentication service capability when deployed. Th
 - Default: `-`
 - Example: `Tfhi2t2pelSMEA8eaV61KaqPNEndFFdMIxDaJnS1CUI=`
 
-#### `NEXT_PUBLIC_AUTH_URL`
-
-- Type: Optional
-- Description: The URL accessible from the browser for Better Auth callbacks. Only set this if the default generated URL is incorrect.
-- Default: `-`
-- Example: `https://example.com`
-
 #### `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION`
 
 - Type: Optional

package/docs/self-hosting/environment-variables/auth.zh-CN.mdx

@@ -32,13 +32,6 @@ LobeChat 在部署时提供了完善的身份验证服务能力，以下是相
 - 默认值：`-`
 - 示例：`Tfhi2t2pelSMEA8eaV61KaqPNEndFFdMIxDaJnS1CUI=`
 
-#### `NEXT_PUBLIC_AUTH_URL`
-
-- 类型：可选
-- 描述：浏览器可访问的 Better Auth 回调 URL。仅在默认生成的 URL 不正确时设置。
-- 默认值：`-`
-- 示例：`https://example.com`
-
 #### `NEXT_PUBLIC_AUTH_EMAIL_VERIFICATION`
 
 - 类型：可选

package/locales/en-US/chat.json

@@ -204,6 +204,7 @@
   "noSelectedAgents": "No members selected yet",
   "openInNewWindow": "Open in New Window",
   "operation.execAgentRuntime": "Preparing response",
+  "operation.execClientTask": "Executing task",
   "operation.sendMessage": "Sending message",
   "owner": "Group owner",
   "pageCopilot.title": "Page Agent",
@@ -322,13 +323,17 @@
   "tab.profile": "Agent Profile",
   "tab.search": "Search",
   "task.activity.calling": "Calling Skill...",
+  "task.activity.clientExecuting": "Executing locally...",
   "task.activity.generating": "Generating response...",
   "task.activity.gotResult": "Tool result received",
   "task.activity.toolCalling": "Calling {{toolName}}...",
   "task.activity.toolResult": "{{toolName}} result received",
   "task.batchTasks": "{{count}} Batch Subtasks",
+  "task.instruction": "Task Instruction",
+  "task.intermediateSteps": "{{count}} intermediate steps",
+  "task.metrics.duration": "(took {{duration}})",
   "task.metrics.stepsShort": "steps",
-  "task.metrics.toolCallsShort": "tool uses",
+  "task.metrics.toolCallsShort": "skill uses",
   "task.status.cancelled": "Task Cancelled",
   "task.status.failed": "Task Failed",
   "task.status.initializing": "Initializing task...",

package/locales/en-US/discover.json

@@ -141,6 +141,7 @@
   "filterBy.timePeriod.year": "Last Year",
   "footer.desc": "Evolve with AI users worldwide. Become a creator to submit your agents and skills to the LobeHub Community.",
   "footer.title": "Share your creation on LobeHub Community today",
+  "groupAgents.tag": "Group",
   "home.communityAgents": "Community Agents",
   "home.featuredAssistants": "Featured Agents",
   "home.featuredModels": "Featured Models",

package/locales/zh-CN/chat.json

@@ -204,6 +204,7 @@
   "noSelectedAgents": "还未选择成员",
   "openInNewWindow": "在新窗口打开",
   "operation.execAgentRuntime": "准备响应中",
+  "operation.execClientTask": "执行任务中",
   "operation.sendMessage": "消息发送中",
   "owner": "群主",
   "pageCopilot.title": "文稿助理",
@@ -322,11 +323,15 @@
   "tab.profile": "助理档案",
   "tab.search": "搜索",
   "task.activity.calling": "正在调用技能…",
+  "task.activity.clientExecuting": "本地执行中…",
   "task.activity.generating": "正在生成回复…",
   "task.activity.gotResult": "已获取技能结果",
   "task.activity.toolCalling": "正在调用 {{toolName}}…",
   "task.activity.toolResult": "已获取 {{toolName}} 结果",
   "task.batchTasks": "{{count}} 个批量子任务",
+  "task.instruction": "任务说明",
+  "task.intermediateSteps": "{{count}} 个中间步骤",
+  "task.metrics.duration": "（用时 {{duration}}）",
   "task.metrics.stepsShort": "步",
   "task.metrics.toolCallsShort": "次技能调用",
   "task.status.cancelled": "任务已取消",

package/locales/zh-CN/discover.json

@@ -141,6 +141,7 @@
   "filterBy.timePeriod.year": "近一年",
   "footer.desc": "与全球 AI 用户共同进化。成为创作者，向 LobeHub 社区提交你的助手和技能。",
   "footer.title": "立即在 LobeHub 社区分享你的创作",
+  "groupAgents.tag": "群组",
   "home.communityAgents": "社区助理",
   "home.featuredAssistants": "推荐助理",
   "home.featuredModels": "推荐模型",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.327",
+  "version": "2.0.0-next.329",
   "description": "LobeHub - an open-source,comprehensive AI Agent 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/agent-runtime/src/agents/GeneralChatAgent.ts

@@ -359,6 +359,30 @@ export class GeneralChatAgent implements Agent {
               type: 'exec_tasks',
             };
           }
+
+          // GTD client-side async task (single, desktop only)
+          if (stateType === 'execClientTask') {
+            const { parentMessageId: execParentId, task } = data.state as {
+              parentMessageId: string;
+              task: any;
+            };
+            return {
+              payload: { parentMessageId: execParentId, task },
+              type: 'exec_client_task',
+            };
+          }
+
+          // GTD client-side async tasks (multiple, desktop only)
+          if (stateType === 'execClientTasks') {
+            const { parentMessageId: execParentId, tasks } = data.state as {
+              parentMessageId: string;
+              tasks: any[];
+            };
+            return {
+              payload: { parentMessageId: execParentId, tasks },
+              type: 'exec_client_tasks',
+            };
+          }
         }
 
         // Check if there are still pending tool messages waiting for approval

package/packages/agent-runtime/src/agents/__tests__/GeneralChatAgent.test.ts

@@ -368,6 +368,216 @@ describe('GeneralChatAgent', () => {
   });
 
   describe('tool_result phase', () => {
+    describe('GTD async tasks', () => {
+      it('should return exec_task for single async task (execTask)', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState();
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: true,
+          data: {
+            state: {
+              type: 'execTask',
+              parentMessageId: 'exec-parent-msg',
+              task: { instruction: 'Do something async', timeout: 30000 },
+            },
+          },
+        });
+
+        const result = await agent.runner(context, state);
+
+        expect(result).toEqual({
+          type: 'exec_task',
+          payload: {
+            parentMessageId: 'exec-parent-msg',
+            task: { instruction: 'Do something async', timeout: 30000 },
+          },
+        });
+      });
+
+      it('should return exec_tasks for multiple async tasks (execTasks)', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState();
+        const tasks = [
+          { instruction: 'Task 1', timeout: 30000 },
+          { instruction: 'Task 2', timeout: 30000 },
+        ];
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: true,
+          data: {
+            state: {
+              type: 'execTasks',
+              parentMessageId: 'exec-parent-msg',
+              tasks,
+            },
+          },
+        });
+
+        const result = await agent.runner(context, state);
+
+        expect(result).toEqual({
+          type: 'exec_tasks',
+          payload: {
+            parentMessageId: 'exec-parent-msg',
+            tasks,
+          },
+        });
+      });
+
+      it('should return exec_client_task for single client-side async task (execClientTask)', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState();
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: true,
+          data: {
+            state: {
+              type: 'execClientTask',
+              parentMessageId: 'exec-parent-msg',
+              task: { type: 'localFile', path: '/path/to/file' },
+            },
+          },
+        });
+
+        const result = await agent.runner(context, state);
+
+        expect(result).toEqual({
+          type: 'exec_client_task',
+          payload: {
+            parentMessageId: 'exec-parent-msg',
+            task: { type: 'localFile', path: '/path/to/file' },
+          },
+        });
+      });
+
+      it('should return exec_client_tasks for multiple client-side async tasks (execClientTasks)', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState();
+        const tasks = [
+          { type: 'localFile', path: '/path/to/file1' },
+          { type: 'localFile', path: '/path/to/file2' },
+        ];
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: true,
+          data: {
+            state: {
+              type: 'execClientTasks',
+              parentMessageId: 'exec-parent-msg',
+              tasks,
+            },
+          },
+        });
+
+        const result = await agent.runner(context, state);
+
+        expect(result).toEqual({
+          type: 'exec_client_tasks',
+          payload: {
+            parentMessageId: 'exec-parent-msg',
+            tasks,
+          },
+        });
+      });
+
+      it('should not trigger exec_task when stop is false', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState({
+          messages: [
+            { role: 'user', content: 'Hello' },
+            { role: 'assistant', content: '' },
+            { role: 'tool', content: 'Result', tool_call_id: 'call-1' },
+          ] as any,
+        });
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: false, // stop is false, should not trigger exec_task
+          data: {
+            state: {
+              type: 'execTask',
+              parentMessageId: 'exec-parent-msg',
+              task: { instruction: 'Do something async' },
+            },
+          },
+        });
+
+        const result = await agent.runner(context, state);
+
+        // Should return call_llm instead of exec_task
+        expect(result).toEqual({
+          type: 'call_llm',
+          payload: {
+            messages: state.messages,
+            model: 'gpt-4o-mini',
+            parentMessageId: 'tool-msg-1',
+            provider: 'openai',
+            tools: undefined,
+          },
+        });
+      });
+
+      it('should not trigger exec_task when data.state is undefined', async () => {
+        const agent = new GeneralChatAgent({
+          agentConfig: { maxSteps: 100 },
+          operationId: 'test-session',
+          modelRuntimeConfig: mockModelRuntimeConfig,
+        });
+
+        const state = createMockState({
+          messages: [
+            { role: 'user', content: 'Hello' },
+            { role: 'assistant', content: '' },
+            { role: 'tool', content: 'Result', tool_call_id: 'call-1' },
+          ] as any,
+        });
+        const context = createMockContext('tool_result', {
+          parentMessageId: 'tool-msg-1',
+          stop: true,
+          data: {}, // No state property
+        });
+
+        const result = await agent.runner(context, state);
+
+        // Should return call_llm instead of exec_task
+        expect(result).toEqual({
+          type: 'call_llm',
+          payload: {
+            messages: state.messages,
+            model: 'gpt-4o-mini',
+            parentMessageId: 'tool-msg-1',
+            provider: 'openai',
+            tools: undefined,
+          },
+        });
+      });
+    });
+
     it('should return call_llm when no pending tools', async () => {
       const agent = new GeneralChatAgent({
         agentConfig: { maxSteps: 100 },

package/packages/agent-runtime/src/types/instruction.ts

@@ -236,12 +236,26 @@ export interface ExecTaskItem {
   inheritMessages?: boolean;
   /** Detailed instruction/prompt for the task execution */
   instruction: string;
+  /**
+   * Whether to execute the task on the client side (desktop only).
+   * When true and running on desktop, the task will be executed locally
+   * with access to local tools (file system, shell commands, etc.).
+   *
+   * IMPORTANT: This MUST be set to true when the task requires:
+   * - Reading/writing local files via `local-system` tool
+   * - Executing shell commands
+   * - Any other desktop-only local tool operations
+   *
+   * If not specified or false, the task runs on the server (default behavior).
+   * On non-desktop platforms (web), this flag is ignored and tasks always run on server.
+   */
+  runInClient?: boolean;
   /** Timeout in milliseconds (optional, default 30 minutes) */
   timeout?: number;
 }
 
 /**
- * Instruction to execute a single async task
+ * Instruction to execute a single async task (server-side)
  */
 export interface AgentInstructionExecTask {
   payload: {
@@ -254,7 +268,7 @@ export interface AgentInstructionExecTask {
 }
 
 /**
- * Instruction to execute multiple async tasks in parallel
+ * Instruction to execute multiple async tasks in parallel (server-side)
  */
 export interface AgentInstructionExecTasks {
   payload: {
@@ -266,6 +280,34 @@ export interface AgentInstructionExecTasks {
   type: 'exec_tasks';
 }
 
+/**
+ * Instruction to execute a single async task on the client (desktop only)
+ * Used when task requires local tools like file system or shell commands
+ */
+export interface AgentInstructionExecClientTask {
+  payload: {
+    /** Parent message ID (tool message that triggered the task) */
+    parentMessageId: string;
+    /** Task to execute */
+    task: ExecTaskItem;
+  };
+  type: 'exec_client_task';
+}
+
+/**
+ * Instruction to execute multiple async tasks on the client in parallel (desktop only)
+ * Used when tasks require local tools like file system or shell commands
+ */
+export interface AgentInstructionExecClientTasks {
+  payload: {
+    /** Parent message ID (tool message that triggered the tasks) */
+    parentMessageId: string;
+    /** Array of tasks to execute */
+    tasks: ExecTaskItem[];
+  };
+  type: 'exec_client_tasks';
+}
+
 /**
  * Payload for task_result phase (single task)
  */
@@ -318,6 +360,8 @@ export type AgentInstruction =
   | AgentInstructionCallToolsBatch
   | AgentInstructionExecTask
   | AgentInstructionExecTasks
+  | AgentInstructionExecClientTask
+  | AgentInstructionExecClientTasks
   | AgentInstructionRequestHumanPrompt
   | AgentInstructionRequestHumanSelect
   | AgentInstructionRequestHumanApprove

package/packages/builtin-tool-gtd/src/const.ts

@@ -0,0 +1 @@
+export const isDesktop = process.env.NEXT_PUBLIC_IS_DESKTOP_APP === '1';