@kafca/agentdock 0.1.46 → 0.1.48

package/dist-electron/tests/electron/plugin-kernel.test.js

@@ -437,7 +437,12 @@ OPENAI_API_KEY = "override-openai-key"
         strict_1.default.equal(route?.agentType, 'pi');
         strict_1.default.equal(route?.config.command, process.execPath);
         strict_1.default.match(route?.config.args[0] || '', /pi-acp[/\\]dist[/\\]index\.js$/);
-        strict_1.default.match(route?.config.env.PI_ACP_PI_COMMAND || '', /@mariozechner[/\\]pi-coding-agent[/\\]dist[/\\]cli\.js$/);
+        if (process.platform === 'win32') {
+            strict_1.default.match(route?.config.env.PI_ACP_PI_COMMAND || '', /[\\/]node_modules[\\/]\.bin[\\/]pi\.CMD$/i);
+        }
+        else {
+            strict_1.default.match(route?.config.env.PI_ACP_PI_COMMAND || '', /@mariozechner[/\\]pi-coding-agent[/\\]dist[/\\]cli\.js$/);
+        }
         strict_1.default.equal(route?.config.env.OPENAI_API_KEY, 'override-openai-key');
         strict_1.default.match(route?.config.env.PI_CODING_AGENT_DIR || '', /[\\/]\.pi-agent[\\/]pi-workspace$/);
         strict_1.default.deepEqual(await runtime.workspaceRouter.listWorkspaces(), [
@@ -735,14 +740,14 @@ model = "deepseek-v4-flash"
     });
     await controller.init();
     strict_1.default.equal(started, true);
-    strict_1.default.deepEqual(await controller.getCapabilities(), capabilitySnapshot);
-    strict_1.default.deepEqual(await controller.getChannelQrCode('test-channel', 'workspace-1', 'instance-1'), {
+    strict_1.default.deepEqual(await controller.kernel.getCapabilitySnapshot(), capabilitySnapshot);
+    strict_1.default.deepEqual(await controller.channelService.getQrCode('test-channel', 'workspace-1', 'instance-1'), {
         ticket: 'ticket:workspace-1',
         expiresIn: 60,
         qrCodeUrl: 'https://example.test/qr',
         instanceId: 'instance-1',
     });
-    strict_1.default.deepEqual(await controller.checkChannelQrCodeStatus('test-channel', 'workspace-1', 'signed-ticket'), {
+    strict_1.default.deepEqual(await controller.channelService.checkQrCodeStatus('test-channel', 'workspace-1', 'signed-ticket'), {
         status: 'signed',
     });
     await controller.saveStructuredConfigFile({ projects: [] });
@@ -936,8 +941,12 @@ model = "deepseek-v4-flash"
 });
 (0, node_test_1.default)('server QR routes dispatch through generic channel bindings', async () => {
     const calls = [];
-    const bindings = Object.assign(new node_events_1.EventEmitter(), {
-        getChannelQrCode: async (platform, workspaceId, instanceId) => {
+    const controller = Object.assign(new node_events_1.EventEmitter(), {
+        getChannelQrCode: undefined,
+        checkChannelQrCodeStatus: undefined,
+    });
+    const channelService = {
+        getQrCode: async (platform, workspaceId, instanceId) => {
             calls.push(`get:${platform}:${workspaceId}:${instanceId || ''}`);
             return {
                 ticket: 'ticket-1',
@@ -946,11 +955,12 @@ model = "deepseek-v4-flash"
                 instanceId,
             };
         },
-        checkChannelQrCodeStatus: async (platform, workspaceId, ticket, instanceId) => {
+        checkQrCodeStatus: async (platform, workspaceId, ticket, instanceId) => {
             calls.push(`check:${platform}:${workspaceId}:${ticket}:${instanceId || ''}`);
             return { status: 'signed' };
         },
-    });
+    };
+    const bindings = { controller, channelService };
     const server = new server_js_1.LocalAiCoreServer(bindings, { port: 0 });
     const qrResponse = await invokeServer(server, 'POST', '/api/local/v1/platforms/slack/workspace-1/qrcode?instance_id=bot-1');
     strict_1.default.equal(qrResponse.body.data.ticket, 'ticket-1');
@@ -962,7 +972,8 @@ model = "deepseek-v4-flash"
     ]);
 });
 (0, node_test_1.default)('server unknown routes return structured error responses', async () => {
-    const bindings = new node_events_1.EventEmitter();
+    const controller = new node_events_1.EventEmitter();
+    const bindings = { controller };
     const server = new server_js_1.LocalAiCoreServer(bindings, { port: 0 });
     const response = await invokeServer(server, 'GET', '/api/local/v1/not-found');
     strict_1.default.equal(response.statusCode, 404);
@@ -973,24 +984,7 @@ model = "deepseek-v4-flash"
 });
 (0, node_test_1.default)('server diagnostics routes dispatch through generic bindings', async () => {
     const calls = [];
-    const bindings = Object.assign(new node_events_1.EventEmitter(), {
-        listDiagnosticErrors: async () => {
-            calls.push('errors');
-            return [{
-                    key: 'channel.weixin:channel_session_expired:workspace-1',
-                    count: 2,
-                    firstSeenAt: '2026-05-12T00:00:00.000Z',
-                    lastSeenAt: '2026-05-12T00:05:00.000Z',
-                    errorInfo: {
-                        code: 'channel_session_expired',
-                        message: 'WeChat login expired.',
-                        userMessage: 'Channel login has expired.',
-                        severity: 'error',
-                        retryable: false,
-                        suggestedAction: 'Reconnect the channel.',
-                    },
-                }];
-        },
+    const controller = Object.assign(new node_events_1.EventEmitter(), {
         runDiagnosticsDoctor: async () => {
             calls.push('doctor');
             return {
@@ -1012,6 +1006,26 @@ model = "deepseek-v4-flash"
             };
         },
     });
+    const errorReporter = {
+        list: async () => {
+            calls.push('errors');
+            return [{
+                    key: 'channel.weixin:channel_session_expired:workspace-1',
+                    count: 2,
+                    firstSeenAt: '2026-05-12T00:00:00.000Z',
+                    lastSeenAt: '2026-05-12T00:05:00.000Z',
+                    errorInfo: {
+                        code: 'channel_session_expired',
+                        message: 'WeChat login expired.',
+                        userMessage: 'Channel login has expired.',
+                        severity: 'error',
+                        retryable: false,
+                        suggestedAction: 'Reconnect the channel.',
+                    },
+                }];
+        },
+    };
+    const bindings = { controller, errorReporter };
     const server = new server_js_1.LocalAiCoreServer(bindings, { port: 0 });
     const errorsResponse = await invokeServer(server, 'GET', '/api/local/v1/diagnostics/errors');
     const doctorResponse = await invokeServer(server, 'POST', '/api/local/v1/diagnostics/doctor');
@@ -1023,8 +1037,9 @@ model = "deepseek-v4-flash"
 });
 (0, node_test_1.default)('server OpenAI-compatible chat route maps metadata to sandbox yolo external run', async () => {
     let externalInput;
-    const bindings = Object.assign(new node_events_1.EventEmitter(), {
-        createExternalRun: async (input) => {
+    const controller = new node_events_1.EventEmitter();
+    const externalService = {
+        createRun: async (input) => {
             externalInput = input;
             return {
                 project: {},
@@ -1036,7 +1051,7 @@ model = "deepseek-v4-flash"
                 events_url: '/api/local/v1/external/runs/run-1/events',
             };
         },
-        getExternalRunSnapshot: async () => ({
+        getRunSnapshot: async () => ({
             runId: 'run-1',
             task: {
                 taskId: 'task-1',
@@ -1069,7 +1084,8 @@ model = "deepseek-v4-flash"
                     }],
             },
         }),
-    });
+    };
+    const bindings = { controller, externalService };
     const server = new server_js_1.LocalAiCoreServer(bindings, { port: 0 });
     const response = await invokeServer(server, 'POST', '/api/local/v1/openai/chat/completions', {
         model: 'model-1',

package/dist-electron/tests/electron/project-provider-config.test.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const project_provider_config_1 = require("../../src/pages/Projects/project-provider-config");
+function createConfig() {
+    return {
+        projects: [{
+                name: 'agentdock',
+                agent: {
+                    type: 'localcore-acp',
+                    options: {
+                        model: 'old-model',
+                        provider_id: 'old-provider',
+                    },
+                },
+                platforms: [],
+            }],
+    };
+}
+(0, node_test_1.default)('project provider selection updates agent provider_id without mutating the original config', () => {
+    const config = createConfig();
+    const next = (0, project_provider_config_1.selectProjectProvider)(config, 'agentdock', 'deepseek');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(next, 'agentdock'), 'deepseek');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(config, 'agentdock'), 'old-provider');
+    strict_1.default.equal(next.projects?.[0]?.agent.options?.model, 'old-model');
+});
+(0, node_test_1.default)('project model selection updates only the project model override', () => {
+    const config = createConfig();
+    const next = (0, project_provider_config_1.selectProjectModel)(config, 'agentdock', 'deepseek-chat');
+    strict_1.default.equal(next.projects?.[0]?.agent.options?.model, 'deepseek-chat');
+    strict_1.default.equal(next.projects?.[0]?.agent.options?.provider_id, 'old-provider');
+    strict_1.default.equal(config.projects?.[0]?.agent.options?.model, 'old-model');
+});
+(0, node_test_1.default)('project provider selection reports missing projects clearly', () => {
+    strict_1.default.throws(() => (0, project_provider_config_1.selectProjectProvider)(createConfig(), 'missing', 'deepseek'), /Project not found in config: missing/);
+});
+(0, node_test_1.default)('provider removal clears references from every project without mutating the original config', () => {
+    const config = createConfig();
+    config.projects?.push({
+        name: 'project-2',
+        agent: {
+            type: 'localcore-acp',
+            options: {
+                model: 'other-model',
+                provider_id: 'old-provider',
+            },
+        },
+        platforms: [],
+    });
+    config.projects?.push({
+        name: 'project-3',
+        agent: {
+            type: 'localcore-acp',
+            options: {
+                model: 'third-model',
+                provider_id: 'keep-provider',
+            },
+        },
+        platforms: [],
+    });
+    const next = (0, project_provider_config_1.removeProviderReferences)(config, 'old-provider');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(next, 'agentdock'), '');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(next, 'project-2'), '');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(next, 'project-3'), 'keep-provider');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(config, 'agentdock'), 'old-provider');
+    strict_1.default.equal((0, project_provider_config_1.getProjectProviderId)(config, 'project-2'), 'old-provider');
+});

package/dist-electron/tests/electron/workspace-task-store.test.js

@@ -16,6 +16,7 @@ const scheduler_service_js_1 = require("../../services/local-ai-core/src/schedul
 const lark_schedule_adapter_js_1 = require("../../services/local-ai-core/src/scheduler/lark-schedule-adapter.js");
 const bootstrap_js_1 = require("../../services/local-ai-core/src/kernel/bootstrap.js");
 const local_core_controller_js_1 = require("../../services/local-ai-core/src/runtime/local-core-controller.js");
+const env_utils_js_1 = require("../../services/local-ai-core/src/runtime/env-utils.js");
 (0, node_test_1.default)('workspace registry entries persist in LocalCoreAcpStore', () => {
     const userDataPath = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'workspace-registry-'));
     try {
@@ -130,9 +131,9 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
         const config = await controller.readConfigFile();
         strict_1.default.equal(config.parsed?.projects?.[0]?.agent.options?.provider_id, 'deepseek');
         strict_1.default.equal(config.parsed?.projects?.[0]?.agent.providers, undefined);
-        const providers = await controller.listModelProviders();
-        strict_1.default.equal(providers.providers[0]?.id, 'deepseek');
-        strict_1.default.equal(providers.providers[0]?.name, 'deepseek');
+        const providers = controller.store.listModelProviders();
+        strict_1.default.equal(providers[0]?.id, 'deepseek');
+        strict_1.default.equal(providers[0]?.name, 'deepseek');
         await controller.close();
     }
     finally {
@@ -148,7 +149,7 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
             log: () => { },
         });
         const controller = new local_core_controller_js_1.LocalCoreController(userDataPath, runtime);
-        const provider = await controller.createModelProvider({
+        const provider = controller.store.upsertModelProvider({
             name: 'deepseek',
             api_key: 'secret',
             base_url: 'https://api.deepseek.com',
@@ -167,7 +168,7 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
                     platforms: [],
                 }],
         });
-        const workspaces = await controller.listWorkspaces();
+        const workspaces = await controller.workspaceRouter.listWorkspaces();
         strict_1.default.equal(workspaces[0]?.id, 'workspace-a');
         strict_1.default.equal(workspaces[0]?.agentType, 'pi');
         await controller.close();
@@ -197,7 +198,7 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
             created_at: now,
             updated_at: now,
         });
-        const job = await controller.createScheduledJob({
+        const job = await controller.scheduledJobs.createJob({
             workspaceId: 'workspace-a',
             threadId: thread.id,
             executionMode: 'side-thread',
@@ -240,7 +241,7 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
             created_at: now,
             updated_at: now,
         });
-        const job = await controller.createScheduledJob({
+        const job = await controller.scheduledJobs.createJob({
             workspaceId: 'workspace-a',
             threadId: thread.id,
             executionMode: 'side-thread',
@@ -583,8 +584,12 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
     const previousHome = process.env.HOME;
     process.env.HOME = '/home/agentdock-test';
     try {
-        const path = (0, local_core_acp_session_coordinator_js_1.buildAgentPath)('/usr/bin:/bin', '/opt/agentdock/bin');
-        strict_1.default.equal(path, '/opt/agentdock/bin:/home/agentdock-test/.local/bin:/home/agentdock-test/bin:/usr/bin:/bin');
+        const existingPath = ['/usr/bin', '/bin'].join(node_path_1.delimiter);
+        const path = (0, local_core_acp_session_coordinator_js_1.buildAgentPath)(existingPath, '/opt/agentdock/bin', { pathExists: () => false });
+        const expectedEntries = process.platform === 'win32'
+            ? ['/opt/agentdock/bin', '/usr/bin', '/bin']
+            : ['/opt/agentdock/bin', '/home/agentdock-test/.local/bin', '/home/agentdock-test/bin', '/usr/bin', '/bin'];
+        strict_1.default.equal(path, expectedEntries.join(node_path_1.delimiter));
     }
     finally {
         if (previousHome === undefined) {
@@ -595,6 +600,26 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
         }
     }
 });
+(0, node_test_1.default)('ACP runtime PATH adds Git Bash bin when Windows PATH only has Git cmd', () => {
+    const existingPath = [
+        'C:\\Windows\\System32',
+        'D:\\Program Files\\Git\\cmd',
+    ].join(';');
+    const path = (0, local_core_acp_session_coordinator_js_1.buildAgentPath)(existingPath, undefined, {
+        platform: 'win32',
+        pathExists: (candidate) => candidate === 'D:\\Program Files\\Git\\bin\\bash.exe',
+    });
+    strict_1.default.equal(path, [
+        'D:\\Program Files\\Git\\bin',
+        'C:\\Windows\\System32',
+        'D:\\Program Files\\Git\\cmd',
+    ].join(';'));
+});
+(0, node_test_1.default)('ACP runtime reads Windows Path env regardless of key casing', () => {
+    strict_1.default.equal((0, env_utils_js_1.getPathEnv)({ Path: 'C:\\Windows\\System32;C:\\Program Files\\nodejs' }), 'C:\\Windows\\System32;C:\\Program Files\\nodejs');
+    strict_1.default.equal((0, env_utils_js_1.getPathEnv)({ PATH: '/usr/bin:/bin' }), '/usr/bin:/bin');
+    strict_1.default.equal((0, env_utils_js_1.getPathEnv)({ Path: 'C:\\Windows\\System32', PATH: 'D:\\agentdock\\bin' }), 'D:\\agentdock\\bin');
+});
 (0, node_test_1.default)('ACP transport reports missing agent commands without an unhandled process error', async () => {
     const closed = new Promise((resolve) => {
         const transport = new local_core_acp_transport_js_1.LocalCoreAcpTransport({
@@ -625,8 +650,9 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
 });
 (0, node_test_1.default)('ACP scheduled session can override permission mode without changing thread mode', async () => {
     const userDataPath = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'scheduler-permission-mode-'));
+    let store = null;
     try {
-        const store = new local_core_acp_store_js_1.LocalCoreAcpStore(userDataPath);
+        store = new local_core_acp_store_js_1.LocalCoreAcpStore(userDataPath);
         const thread = store.createThread('workspace-a', 'Thread');
         const capturedSessionNewParams = [];
         let closeCount = 0;
@@ -692,13 +718,15 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
         });
     }
     finally {
+        store?.close();
         (0, node_fs_1.rmSync)(userDataPath, { recursive: true, force: true });
     }
 });
 (0, node_test_1.default)('ACP sandbox sessions use container workspace cwd', async () => {
     const userDataPath = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'sandbox-session-cwd-'));
+    let store = null;
     try {
-        const store = new local_core_acp_store_js_1.LocalCoreAcpStore(userDataPath);
+        store = new local_core_acp_store_js_1.LocalCoreAcpStore(userDataPath);
         const thread = store.createThread('workspace-a', 'Thread');
         let sessionNewParams;
         const coordinator = new local_core_acp_session_coordinator_js_1.LocalCoreAcpSessionCoordinator({
@@ -769,6 +797,7 @@ const local_core_controller_js_1 = require("../../services/local-ai-core/src/run
         strict_1.default.equal(sessionNewParams?.cwd, '/workspace');
     }
     finally {
+        store?.close();
         (0, node_fs_1.rmSync)(userDataPath, { recursive: true, force: true });
     }
 });

package/dist-electron/tests/integration/local-core-cors.test.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const server_helpers_js_1 = require("../../services/local-ai-core/src/runtime/server-helpers.js");
+class HeaderRecorder {
+    headers = new Map();
+    setHeader(name, value) {
+        this.headers.set(name, value);
+    }
+}
+(0, node_test_1.default)('local core CORS preflight allows provider update PUT requests', () => {
+    const req = { headers: { origin: 'http://127.0.0.1:5173' } };
+    const res = new HeaderRecorder();
+    (0, server_helpers_js_1.setCorsHeaders)(req, res);
+    strict_1.default.equal(res.headers.get('Access-Control-Allow-Origin'), 'http://127.0.0.1:5173');
+    strict_1.default.match(String(res.headers.get('Access-Control-Allow-Methods')), /(?:^|,)PUT(?:,|$)/);
+    strict_1.default.match(String(res.headers.get('Access-Control-Allow-Headers')), /Content-Type/);
+});

package/dist-electron/tests/integration/local-core-refactor.test.js

@@ -313,11 +313,15 @@ const thread_slash_command_dispatcher_js_1 = require("../../services/local-ai-co
     try {
         const store = new local_core_acp_store_js_1.LocalCoreAcpStore(dir);
         const thread = store.createThread('workspace-a', 'Mode test', 'claudecode');
+        strict_1.default.equal(thread.agentMode, 'default');
         strict_1.default.equal(store.getThreadRow(thread.id)?.agent_mode, 'default');
         const inheritedThread = store.createThread('workspace-a', 'Inherited mode test', 'claudecode', 'bypassPermissions');
+        strict_1.default.equal(inheritedThread.agentMode, 'bypassPermissions');
         strict_1.default.equal(store.getThreadRow(inheritedThread.id)?.agent_mode, 'bypassPermissions');
         store.updateThreadAgentMode(thread.id, 'bypassPermissions');
         strict_1.default.equal(store.getThreadRow(thread.id)?.agent_mode, 'bypassPermissions');
+        strict_1.default.equal(store.getThread(thread.id, []).agentMode, 'bypassPermissions');
+        strict_1.default.equal(store.listThreadSummaries('workspace-a').find((item) => item.id === thread.id)?.agentMode, 'bypassPermissions');
         store.close();
     }
     finally {
@@ -894,3 +898,176 @@ const thread_slash_command_dispatcher_js_1 = require("../../services/local-ai-co
         sessionKey: 'session:thread-origin',
     });
 });
+(0, node_test_1.default)('platform thread binding persists preferred agent across upserts and updates', () => {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'agentdock-binding-pref-'));
+    try {
+        const store = new local_core_acp_store_js_1.LocalCoreAcpStore(dir);
+        const now = new Date().toISOString();
+        store.upsertPlatformThreadBinding({
+            workspace_id: 'workspace-a',
+            platform: 'lark',
+            chat_id: 'chat-1',
+            platform_user_id: 'user-1',
+            thread_id: 'thread-1',
+            last_platform_message_id: null,
+            created_at: now,
+            updated_at: now,
+        });
+        store.updatePlatformThreadPreferredAgent('workspace-a', 'chat-1', 'user-1', 'claudecode', 'lark');
+        let binding = store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark');
+        strict_1.default.equal(binding?.preferred_agent_type, 'claudecode');
+        const later = new Date().toISOString();
+        store.upsertPlatformThreadBinding({
+            workspace_id: 'workspace-a',
+            platform: 'lark',
+            chat_id: 'chat-1',
+            platform_user_id: 'user-1',
+            thread_id: 'thread-2',
+            last_platform_message_id: null,
+            created_at: later,
+            updated_at: later,
+        });
+        binding = store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark');
+        strict_1.default.equal(binding?.thread_id, 'thread-2');
+        strict_1.default.equal(binding?.preferred_agent_type, 'claudecode');
+        store.updatePlatformThreadPreferredAgent('workspace-a', 'chat-1', 'user-1', null, 'lark');
+        binding = store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark');
+        strict_1.default.equal(binding?.preferred_agent_type, null);
+        store.close();
+    }
+    finally {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('slash agent command in a channel writes preferred agent to the binding', async () => {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'agentdock-channel-agent-cmd-'));
+    try {
+        const store = new local_core_acp_store_js_1.LocalCoreAcpStore(dir);
+        const thread = store.createThread('workspace-a', 'Channel thread', 'codex');
+        const now = new Date().toISOString();
+        store.upsertPlatformThreadBinding({
+            workspace_id: 'workspace-a',
+            platform: 'lark',
+            chat_id: 'chat-1',
+            platform_user_id: 'user-1',
+            thread_id: thread.id,
+            last_platform_message_id: null,
+            created_at: now,
+            updated_at: now,
+        });
+        const row = store.getThreadRow(thread.id);
+        const dispatcher = new thread_slash_command_dispatcher_js_1.ThreadSlashCommandDispatcher({
+            session: {
+                listThreads: () => [],
+                getThread: (id) => ({ id, title: row.title, messages: [] }),
+                createThread: (workspaceId, title) => ({ id: 'new-thread', title, messages: [] }),
+                renameThread: (id, title) => ({ id, title, messages: [] }),
+                deleteThread: () => ({ deleted: true }),
+            },
+            thread: {
+                getThreadRow: (id) => store.getThreadRow(id),
+                updateThreadAgentMode: (id, mode) => store.updateThreadAgentMode(id, mode),
+                updateThreadAgentType: (id, agentType) => store.updateThreadAgentType(id, agentType),
+                getLatestRunForThread: () => undefined,
+                createAuditEvent: () => { },
+                getAgentTypes: () => ['codex', 'pi', 'claudecode'],
+                setChannelPreferredAgent: (input) => store.updatePlatformThreadPreferredAgent(input.workspaceId, input.chatId, input.platformUserId, input.agentType, input.platform),
+            },
+        });
+        const useResult = await dispatcher.execute({
+            threadId: thread.id,
+            workspaceId: 'workspace-a',
+            content: '/agent use claudecode',
+            defaultAgentType: 'codex',
+            channel: { chatId: 'chat-1', platformUserId: 'user-1', platform: 'lark' },
+        });
+        strict_1.default.equal(useResult.handled, true);
+        strict_1.default.equal(store.getThreadRow(thread.id)?.agent_type, 'claudecode');
+        strict_1.default.equal(store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark')?.preferred_agent_type, 'claudecode');
+        const resetResult = await dispatcher.execute({
+            threadId: thread.id,
+            workspaceId: 'workspace-a',
+            content: '/agent reset',
+            defaultAgentType: 'codex',
+            channel: { chatId: 'chat-1', platformUserId: 'user-1', platform: 'lark' },
+        });
+        strict_1.default.equal(resetResult.handled, true);
+        strict_1.default.equal(store.getThreadRow(thread.id)?.agent_type, 'codex');
+        strict_1.default.equal(store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark')?.preferred_agent_type, null);
+        store.close();
+    }
+    finally {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('channel session runtime applies preferred agent when creating a new thread', async () => {
+    const dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'agentdock-channel-new-inherit-'));
+    try {
+        const store = new local_core_acp_store_js_1.LocalCoreAcpStore(dir);
+        const original = store.createThread('workspace-a', 'Original channel thread', 'codex');
+        const now = new Date().toISOString();
+        store.upsertPlatformThreadBinding({
+            workspace_id: 'workspace-a',
+            platform: 'lark',
+            chat_id: 'chat-1',
+            platform_user_id: 'user-1',
+            thread_id: original.id,
+            last_platform_message_id: null,
+            created_at: now,
+            updated_at: now,
+        });
+        store.updatePlatformThreadPreferredAgent('workspace-a', 'chat-1', 'user-1', 'claudecode', 'lark');
+        store.updateThreadAgentType(original.id, 'claudecode');
+        const createdThreadIds = [];
+        const routes = new Map();
+        const dispatcher = new thread_slash_command_dispatcher_js_1.ThreadSlashCommandDispatcher({
+            session: {
+                listThreads: () => [],
+                getThread: (id) => ({ id, title: 'X', messages: [] }),
+                createThread: (_workspaceId, title) => {
+                    const created = store.createThread('workspace-a', title, 'codex');
+                    createdThreadIds.push({ id: created.id, initialAgentType: 'codex' });
+                    return created;
+                },
+                renameThread: (id, title) => ({ id, title, messages: [] }),
+                deleteThread: () => ({ deleted: true }),
+            },
+            thread: {
+                getThreadRow: (id) => store.getThreadRow(id),
+                updateThreadAgentMode: (id, mode) => store.updateThreadAgentMode(id, mode),
+                updateThreadAgentType: (id, agentType) => store.updateThreadAgentType(id, agentType),
+                getLatestRunForThread: () => undefined,
+                createAuditEvent: () => { },
+                getAgentTypes: () => ['codex', 'claudecode'],
+            },
+        });
+        const runtime = new session_command_runtime_js_1.ChannelSessionCommandRuntime({
+            dispatcher,
+            store,
+            getThreadSessionKey: (id) => `session:${id}`,
+            setThreadRoute: (sessionKey, route) => { routes.set(sessionKey, route); },
+            createRoute: (input, id) => ({ workspaceId: input.workspaceId, chatId: input.chatId, threadId: id }),
+            sendResult: async () => { },
+        });
+        const result = await runtime.execute({
+            workspaceId: 'workspace-a',
+            currentThreadId: original.id,
+            text: '/new Follow up',
+            defaultTitle: 'Follow up',
+            defaultAgentType: 'codex',
+            chatId: 'chat-1',
+            platformUserId: 'user-1',
+            platformKey: 'lark',
+            instanceId: 'default',
+        });
+        strict_1.default.equal(result.handled, true);
+        strict_1.default.equal(result.threadId, createdThreadIds[0]?.id);
+        strict_1.default.equal(createdThreadIds[0]?.initialAgentType, 'codex', 'createThread starts with default agent before inheritance');
+        strict_1.default.equal(store.getThreadRow(result.threadId)?.agent_type, 'claudecode', 'new thread should inherit preferred agent after creation');
+        strict_1.default.equal(store.getPlatformThreadBinding('workspace-a', 'chat-1', 'user-1', 'lark')?.preferred_agent_type, 'claudecode');
+        store.close();
+    }
+    finally {
+        (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+});

package/dist-electron/tests/integration/local-core-routes.test.js

@@ -5,7 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_test_1 = __importDefault(require("node:test"));
 const strict_1 = __importDefault(require("node:assert/strict"));
+const node_stream_1 = require("node:stream");
 const server_routes_js_1 = require("../../services/local-ai-core/src/runtime/server-routes.js");
+const thread_handler_js_1 = require("../../services/local-ai-core/src/runtime/handlers/thread-handler.js");
 (0, node_test_1.default)('local core route parser separates runtime refresh and runtime detail routes', () => {
     strict_1.default.deepEqual((0, server_routes_js_1.parseLocalAiCoreRoute)('GET', '/api/local/v1/logs'), { name: 'logs.list' });
     strict_1.default.deepEqual((0, server_routes_js_1.parseLocalAiCoreRoute)('GET', '/api/local/v1/runtimes'), { name: 'runtimes.list' });
@@ -45,6 +47,10 @@ const server_routes_js_1 = require("../../services/local-ai-core/src/runtime/ser
         name: 'thread.update-knowledge-bases',
         threadId: 'thread-1',
     });
+    strict_1.default.deepEqual((0, server_routes_js_1.parseLocalAiCoreRoute)('PATCH', '/api/local/v1/threads/thread-1/mode'), {
+        name: 'thread.update-mode',
+        threadId: 'thread-1',
+    });
     strict_1.default.deepEqual((0, server_routes_js_1.parseLocalAiCoreRoute)('POST', '/api/local/v1/threads/thread-1/messages'), {
         name: 'thread.messages.send',
         threadId: 'thread-1',
@@ -55,6 +61,45 @@ const server_routes_js_1 = require("../../services/local-ai-core/src/runtime/ser
     });
     strict_1.default.equal((0, server_routes_js_1.parseLocalAiCoreRoute)('GET', '/api/local/v1/threads/thread-1/messages'), null);
 });
+(0, node_test_1.default)('thread mode route handler persists normalized mode through workspace router', async () => {
+    const calls = [];
+    const map = new Map();
+    (0, thread_handler_js_1.registerThreadHandlers)(map, {
+        setThreadMode: async (threadId, mode) => {
+            calls.push({ threadId, mode });
+            return {
+                id: threadId,
+                workspaceId: 'workspace-a',
+                title: 'Thread',
+                live: false,
+                updatedAt: '2026-06-14T00:00:00.000Z',
+                createdAt: '2026-06-14T00:00:00.000Z',
+                historyCount: 0,
+                excerpt: '',
+                agentMode: 'bypassPermissions',
+                messages: [],
+                selectedKnowledgeBaseIds: [],
+            };
+        },
+    });
+    const req = node_stream_1.Readable.from([Buffer.from(JSON.stringify({ mode: 'bypassPermissions' }))]);
+    const headers = {};
+    let responseBody = '';
+    const res = {
+        statusCode: 0,
+        setHeader: (name, value) => {
+            headers[name] = value;
+        },
+        end: (body) => {
+            responseBody = body;
+        },
+    };
+    await map.get('thread.update-mode')({ name: 'thread.update-mode', threadId: 'thread-1' }, req, res, new URL('http://127.0.0.1/api/local/v1/threads/thread-1/mode'));
+    strict_1.default.deepEqual(calls, [{ threadId: 'thread-1', mode: 'bypassPermissions' }]);
+    strict_1.default.equal(res.statusCode, 200);
+    strict_1.default.equal(headers['Content-Type'], 'application/json; charset=utf-8');
+    strict_1.default.equal(JSON.parse(responseBody).data.agentMode, 'bypassPermissions');
+});
 (0, node_test_1.default)('local core route parser only accepts run interrupt action with POST', () => {
     strict_1.default.deepEqual((0, server_routes_js_1.parseLocalAiCoreRoute)('POST', '/api/local/v1/runs/run-1/interrupt'), {
         name: 'run.interrupt',