@keyou007/agent-bot 0.1.14-alpha.1 → 0.1.14-alpha.2

package/dist/cli.js

@@ -6,7 +6,7 @@ import { createInterface } from "node:readline";
 import { loadConfig, loadConfigWithoutEnvironmentMutation } from "./config/loadConfig.js";
 import { sendControlRequest, isServerReachable } from "./cli/LocalControlClient.js";
 import { controlEndpoint, } from "./cli/controlProtocol.js";
-import { acquireInitializationLock, cleanupFeishuCredentialTemporaryFiles, initializeAgentBot, readConfiguredAgentSelection, readFeishuCredentials, shouldCreateFeishuApp, shouldConfigureAgentsDuringInitialization, writeConfiguredAgentSelection, writeFeishuCredentials, } from "./cli/Initializer.js";
+import { acquireInitializationLock, cleanupFeishuCredentialTemporaryFiles, initializeAgentBot, readConfiguredAgentSelection, readFeishuCredentials, readGroupMessageResponseMode, shouldCreateFeishuApp, shouldConfigureAgentsDuringInitialization, shouldConfigureGroupMessagesDuringInitialization, writeConfiguredAgentSelection, writeFeishuCredentials, writeGroupMessageResponseMode, } from "./cli/Initializer.js";
 import { parseInitCommandOptions } from "./cli/initOptions.js";
 import { listenForManualPermissionSkip, listenForOptionalAuthorizationSkip, } from "./cli/OptionalAuthorizationSkip.js";
 import { registerFeishuApp, } from "./cli/FeishuAppRegistration.js";
@@ -23,13 +23,17 @@ import { applyExplicitProfile, parseGlobalOptions } from "./cli/profile.js";
 import { printVerificationQrAndLink } from "./cli/VerificationOutput.js";
 import { startInitializedServer, startServer, } from "./cli/ServerStarter.js";
 import { taskChatRoute } from "./cli/taskChatRoute.js";
-import { currentAppServerThreadIds, formatTaskList, resolveCurrentTask, taskStateLabel, } from "./cli/taskListOutput.js";
+import { currentAppServerThreadIds, formatTaskList, taskStateLabel, } from "./cli/taskListOutput.js";
+import { resolveCurrentTaskFromEnvironment, resolveTask, resolveTaskCommandTarget, } from "./cli/taskTarget.js";
 import { isThreadContextKey } from "./feishu/contextKey.js";
 import { refreshedSystemEnvironment } from "./supervision/systemEnvironment.js";
-import { parseTaskForkGroupOptions, parseTaskNewGroupOptions, } from "./cli/taskGroupOptions.js";
+import { parseTaskForkGroupOptions, parseTaskNewOptions, parseTaskNewGroupOptions, } from "./cli/taskGroupOptions.js";
 import { StateStore } from "./state/StateStore.js";
 import { nodeDiagnosticReportArguments, prepareCrashReportDirectory, resolveSupervisorDiagnosticsPaths, } from "./supervision/SupervisorDiagnostics.js";
 import { agentBotHome, defaultSqlitePath } from "./config/paths.js";
+import { finalizeSelfUpdatePlan, launchSelfUpdateRunner, parseSelfUpdateOptions, prepareSelfUpdate, releaseSelfUpdatePlan, requireNpmSelfUpdateInstallation, } from "./cli/SelfUpdater.js";
+import { createCurrentAutostartManager } from "./cli/AutostartManager.js";
+import { formatAutostartStatus, } from "./cli/autostartOutput.js";
 const args = process.argv.slice(2);
 void main(args).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
@@ -55,6 +59,10 @@ async function main(input) {
         await initCommand(rest, parsed.configPath, Boolean(parsed.profilePath));
         return;
     }
+    if (command === "update") {
+        await updateCommand(rest);
+        return;
+    }
     if (command === "console") {
         await consoleCommand(rest);
         return;
@@ -73,6 +81,73 @@ async function main(input) {
     }
     throw new Error(cliText(`Unknown command: ${command}. Run agentbot --help for usage.`, `未知命令：${command}。运行 agentbot --help 查看用法。`));
 }
+async function updateCommand(input) {
+    const options = parseSelfUpdateOptions(input);
+    requireNpmSelfUpdateInstallation();
+    const config = loadConfig();
+    const endpoint = controlEndpoint(config.storage.sqlitePath);
+    const serverRunning = await isServerReachable(endpoint);
+    if (!options.json)
+        process.stdout.write(cliText("Checking the installed Agent Bot package and npm release channel...\n", "正在检查已安装的 Agent Bot 包和 npm 发布通道……\n"));
+    const prepared = await prepareSelfUpdate({
+        channel: options.channel,
+        version: options.version,
+        allowDowngrade: options.allowDowngrade,
+    });
+    if (prepared.status === "current") {
+        if (options.json)
+            printJson(prepared);
+        else
+            process.stdout.write(cliText(`Agent Bot ${prepared.currentVersion} is already current on the ${prepared.channel} channel.\n`, `Agent Bot ${prepared.currentVersion} 已是 ${prepared.channel} 通道的当前版本。\n`));
+        return;
+    }
+    const reason = cliText(`Update Agent Bot from ${prepared.currentVersion} to ${prepared.targetVersion}`, `将 Agent Bot 从 ${prepared.currentVersion} 更新到 ${prepared.targetVersion}`);
+    try {
+        const notificationSessionId = serverRunning
+            ? resolveRestartNotificationSessionId(config.storage.sqlitePath, options.taskReference ? ["--task", options.taskReference] : [])
+            : undefined;
+        finalizeSelfUpdatePlan(prepared.planPath, {
+            controlEndpoint: endpoint,
+            databasePath: config.storage.sqlitePath,
+            restartService: serverRunning,
+            workingDirectory: process.cwd(),
+            reason,
+            notificationSessionId,
+        });
+        if (serverRunning) {
+            ensureOk(await sendControlRequest(endpoint, {
+                action: "server_update",
+                planPath: prepared.planPath,
+                reason,
+                notificationSessionId,
+            }, 15_000));
+        }
+        else {
+            launchSelfUpdateRunner(prepared.planPath, { waitPids: [process.pid] });
+        }
+    }
+    catch (error) {
+        releaseSelfUpdatePlan(prepared.planPath);
+        throw error;
+    }
+    const result = {
+        status: serverRunning ? "scheduled" : "started",
+        fromVersion: prepared.currentVersion,
+        toVersion: prepared.targetVersion,
+        channel: prepared.channel,
+        serviceWasRunning: serverRunning,
+        logPath: prepared.logPath,
+        resultPath: prepared.resultPath,
+    };
+    if (options.json)
+        printJson(result);
+    else {
+        process.stdout.write(serverRunning
+            ? cliText(`Agent Bot ${prepared.targetVersion} is verified and ready. The update will run after active tasks finish and the server becomes idle.\n`, `Agent Bot ${prepared.targetVersion} 已通过预检。更新将在活动任务完成且服务空闲后执行。\n`)
+            : cliText(`Agent Bot ${prepared.targetVersion} is verified. Installation will continue after this command exits.\n`, `Agent Bot ${prepared.targetVersion} 已通过预检。本命令退出后将继续安装。\n`));
+        process.stdout.write(`${cliText("Update log: ", "更新日志：")}${prepared.logPath}\n`);
+    }
+}
 async function initCommand(input, configPath, explicitProfile) {
     const options = parseInitCommandOptions(input, explicitProfile);
     const version = readPackageVersion();
@@ -90,6 +165,7 @@ async function initCommand(input, configPath, explicitProfile) {
             printInitializationPaths(paths);
         const inspectedAgents = await initializeSupportedAgents(options.json);
         const defaultAgent = await configureAgentsAndDefault(paths.config.path, inspectedAgents, options.json, shouldConfigureAgentsDuringInitialization(paths.config.status));
+        const groupMessages = await configureGroupMessageResponse(paths.config.path, options.json, shouldConfigureGroupMessagesDuringInitialization(paths.config.status));
         const configuredAgents = readConfiguredAgentSelection(paths.config.path).agents.map((agent) => agent.name);
         const configuredAgentNames = new Set(configuredAgents);
         const agents = inspectedAgents.map((agent) => ({
@@ -98,8 +174,9 @@ async function initCommand(input, configPath, explicitProfile) {
         }));
         initializationLock ??= acquireInitializationLock(paths.home.path);
         cleanupFeishuCredentialTemporaryFiles(paths.env.path);
-        const feishu = await initializeFeishu(paths, options);
-        initialized = { ...paths, agents, configuredAgents, defaultAgent, feishu };
+        const feishu = await initializeFeishu(paths, options, groupMessages.mode === "all");
+        const skill = bundledSkillRegistry().install();
+        initialized = { ...paths, agents, configuredAgents, defaultAgent, groupMessages, feishu, skill };
     }
     finally {
         initializationLock?.release();
@@ -256,6 +333,54 @@ async function configureAgentsAndDefault(configPath, inspections, json, configur
     output.write(cliText(`Default Agent: ${selectedDefault.name}${process.stdin.isTTY ? "" : " (selected automatically)"}\n`, `默认 Agent：${selectedDefault.name}${process.stdin.isTTY ? "" : "（已自动选择）"}\n`));
     return { name: selectedDefault.name, status: updated ? "selected" : "existing" };
 }
+async function configureGroupMessageResponse(configPath, json, configure) {
+    const output = json ? process.stderr : process.stdout;
+    if (!configure) {
+        return { mode: readGroupMessageResponseMode(configPath), status: "existing" };
+    }
+    let mode = "mention-only";
+    if (process.stdin.isTTY) {
+        output.write(cliText("\nChoose how Agent Bot responds to group messages:\n  1. Receive all group messages\n     The bot can respond without an @ mention. This requires an additional Lark permission.\n  2. Require an explicit @ mention\n     The additional all-group-message permission will not be requested.\n", "\n请选择 Agent Bot 响应群消息的方式：\n  1. 接收所有群消息\n     无需 @ 机器人即可响应，需要额外开通飞书权限。\n  2. 明确 @ 机器人才能接收消息\n     不会申请“免 @ 机器人”所需的额外权限。\n"));
+        mode = await promptForGroupMessageResponseMode();
+    }
+    else {
+        output.write(cliText("No interactive terminal is available. Group messages will require an explicit @ mention, and the all-group-message permission will not be requested.\n", "当前没有交互式终端。群消息将要求明确 @ 机器人，并且不会申请接收所有群消息的额外权限。\n"));
+    }
+    writeGroupMessageResponseMode(configPath, mode);
+    output.write(cliText(`Group message response: ${mode === "all" ? "receive all group messages" : "require an explicit @ mention"}\n`, `群消息响应方式：${mode === "all" ? "接收所有群消息" : "必须明确 @ 机器人"}\n`));
+    return { mode, status: "selected" };
+}
+function promptForGroupMessageResponseMode() {
+    const readline = createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (mode) => {
+            settled = true;
+            readline.close();
+            resolve(mode);
+        };
+        const ask = () => {
+            readline.question(cliText("Select 1 or 2 [2]: ", "请选择 1 或 2 [2]："), (answer) => {
+                const normalized = answer.trim().toLowerCase();
+                if (normalized === "1") {
+                    finish("all");
+                    return;
+                }
+                if (normalized === "" || normalized === "2") {
+                    finish("mention-only");
+                    return;
+                }
+                process.stderr.write(cliText("Enter 1 to receive all group messages, or 2 to require an @ mention.\n", "请输入 1 接收所有群消息，或输入 2 要求明确 @ 机器人。\n"));
+                ask();
+            });
+        };
+        listenForPromptCancellation(readline, () => {
+            settled = true;
+            reject(new Error(cliText("Initialization was cancelled.", "初始化已取消。")));
+        }, () => settled);
+        ask();
+    });
+}
 function promptForAgentMaintenance(choiceCount) {
     const readline = createInterface({ input: process.stdin, output: process.stderr });
     return new Promise((resolve, reject) => {
@@ -373,7 +498,7 @@ function refreshCurrentProcessPath() {
     if (pathEntry?.[1])
         process.env.PATH = pathEntry[1];
 }
-async function initializeFeishu(paths, options) {
+async function initializeFeishu(paths, options, respondToAllGroupMessages) {
     const existing = readFeishuCredentials(paths.env.path);
     if (options.skipFeishu) {
         return {
@@ -420,6 +545,7 @@ async function initializeFeishu(paths, options) {
         const optionalSkip = new AbortController();
         let skipListener;
         const configuration = await ensureFeishuAppConfiguration(credentials, {
+            respondToAllGroupMessages,
             signal: controller.signal,
             manualPermissionSkipSignal: manualPermissionSkip.signal,
             optionalSkipSignal: optionalSkip.signal,
@@ -466,9 +592,8 @@ async function assertResetProfileServerStopped(configPath) {
 }
 function skillsCommand(input) {
     const [action = "status", ...rest] = input;
-    const sourcePath = fileURLToPath(new URL("../skills/agent-bot/", import.meta.url));
     const targetRoot = optionValue(rest, "--target") ?? resolveSystemSkillsRoot();
-    const registry = new SkillRegistry(sourcePath, targetRoot);
+    const registry = bundledSkillRegistry(targetRoot);
     const json = rest.includes("--json");
     if (action === "install" || action === "register") {
         const result = registry.install();
@@ -511,6 +636,10 @@ function skillsCommand(input) {
     }
     throw new Error(cliText(`Unknown skills command: ${action}`, `未知的 skills 命令：${action}`));
 }
+function bundledSkillRegistry(targetRoot = resolveSystemSkillsRoot()) {
+    const sourcePath = fileURLToPath(new URL("../skills/agent-bot/", import.meta.url));
+    return new SkillRegistry(sourcePath, targetRoot);
+}
 async function consoleCommand(input) {
     const config = loadConfig();
     const endpoint = controlEndpoint(config.storage.sqlitePath);
@@ -565,6 +694,10 @@ async function serverCommand(input) {
         printServerStartResult(await startServer(config));
         return;
     }
+    if (action === "autostart") {
+        await serverAutostartCommand(config, endpoint, rest);
+        return;
+    }
     if (action === "stop") {
         ensureOk(await sendControlRequest(endpoint, { action: "server_stop" }));
         process.stdout.write(cliText("Agent Bot server stop requested.\n", "已请求停止 Agent Bot 服务。\n"));
@@ -588,6 +721,55 @@ async function serverCommand(input) {
     }
     throw new Error(cliText(`Unknown server command: ${action}`, `未知的 server 命令：${action}`));
 }
+async function serverAutostartCommand(config, endpoint, input) {
+    const actionIndex = input.findIndex((value) => !value.startsWith("--"));
+    const action = actionIndex < 0 ? "status" : input[actionIndex];
+    const rest = input.filter((_value, index) => index !== actionIndex);
+    const json = rest.includes("--json");
+    const linger = rest.includes("--linger");
+    const unsupported = rest.filter((value) => value !== "--json" && value !== "--linger");
+    if (unsupported.length > 0)
+        throw new Error(cliText(`Unsupported server autostart options: ${unsupported.join(" ")}`, `不支持这些 server autostart 参数：${unsupported.join(" ")}`));
+    if (action !== "enable" && linger) {
+        throw new Error(cliText("--linger can be used only with server autostart enable.", "--linger 只能与 server autostart enable 一起使用。"));
+    }
+    const manager = createCurrentAutostartManager(config);
+    let registration;
+    if (action === "enable") {
+        registration = manager.enable({ linger });
+    }
+    else if (action === "disable") {
+        registration = manager.disable();
+    }
+    else if (action === "status") {
+        registration = manager.status();
+    }
+    else {
+        throw new Error(cliText(`Unknown server autostart command: ${action}`, `未知的 server autostart 命令：${action}`));
+    }
+    const result = {
+        registration,
+        server: await readAutostartServerStatus(endpoint),
+    };
+    if (json)
+        printJson(result);
+    else
+        process.stdout.write(formatAutostartStatus(result));
+}
+async function readAutostartServerStatus(endpoint) {
+    try {
+        const response = await sendControlRequest(endpoint, { action: "health" }, 1_500);
+        if (!response.ok)
+            return { running: true, ready: false };
+        const data = response.data && typeof response.data === "object"
+            ? response.data
+            : {};
+        return { running: true, ready: data.ready !== false };
+    }
+    catch {
+        return { running: false, ready: false };
+    }
+}
 function resolveRestartNotificationSessionId(sqlitePath, args) {
     const store = new StateStore(sqlitePath);
     try {
@@ -619,6 +801,10 @@ async function taskCommand(input) {
     const store = new StateStore(config.storage.sqlitePath);
     try {
         const allSessions = store.listAllSessions();
+        if (action === "help" || action === "--help" || action === "-h") {
+            printHelp();
+            return;
+        }
         if (action === "current") {
             const unsupported = rest.filter((value) => value !== "--json");
             if (unsupported.length > 0)
@@ -628,25 +814,274 @@ async function taskCommand(input) {
             return;
         }
         if (action === "prompt" || action === "send") {
-            const [reference, ...promptParts] = rest;
-            if (!reference)
-                throw new Error(cliText(`task ${action} requires a task number or task ID.`, `task ${action} 需要任务序号或任务 ID。`));
-            const text = promptParts.join(" ").trim();
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const text = target.args.join(" ").trim();
             if (!text)
                 throw new Error(cliText(`task ${action} requires a Prompt.`, `task ${action} 需要提示词。`));
-            const session = resolveTask(allSessions, reference);
             const endpoint = controlEndpoint(config.storage.sqlitePath);
             ensureOk(await sendControlRequest(endpoint, {
                 action: "task_prompt",
-                localSessionId: session.localSessionId,
+                localSessionId: target.session.localSessionId,
                 text,
             }, 60_000));
             process.stdout.write(cliText("Prompt submitted.\n", "提示词已提交。\n"));
             return;
         }
+        if (action === "new") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = parseTaskNewOptions([target.session.localSessionId, ...target.args]);
+            const source = target.session;
+            const targetAgent = options.agentName ? config.agents[options.agentName] : undefined;
+            if (options.agentName && !targetAgent)
+                throw new Error(cliText(`Unknown Agent standard name: ${options.agentName}.`, `未知的 Agent 标准名：${options.agentName}。`));
+            if (options.projectless && targetAgent && targetAgent.kind !== "app-server")
+                throw new Error(cliText("task new --nodir is only available for App Server agents.", "task new --nodir 仅适用于 App Server Agent。"));
+            const created = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_new",
+                localSessionId: source.localSessionId,
+                ...(options.title ? { title: options.title } : {}),
+                ...(options.cwd ? { cwd: options.cwd } : {}),
+                ...(options.agentName ? { agentName: options.agentName } : {}),
+                ...(options.projectless ? { projectless: true } : {}),
+            }, 120_000));
+            if (options.json)
+                printJson(created);
+            else
+                printCreatedTask(created, "Task created");
+            return;
+        }
+        if (action === "fork") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = target.args;
+            rejectUnsupportedTaskOptions(action, options, ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task fork accepts only one task reference.", "task fork 只接受一个任务引用。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_fork",
+                localSessionId: target.session.localSessionId,
+            }, 120_000));
+            if (options.includes("--json"))
+                printJson(result);
+            else {
+                printCreatedTask(result.task, "Fork created");
+                process.stdout.write(`${cliText("Source turn: ", "来源 Turn：")}${result.sourceTurnId}\n`);
+            }
+            return;
+        }
+        if (action === "archive") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = target.args;
+            rejectUnsupportedTaskOptions(action, options, ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task archive accepts only one task reference.", "task archive 只接受一个任务引用。"));
+            const archived = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_archive",
+                localSessionId: target.session.localSessionId,
+            }, 60_000));
+            if (options.includes("--json"))
+                printJson(archived);
+            else
+                process.stdout.write(cliText(`Task archived: ${archived.title} (${archived.remoteSessionId})\n`, `任务已归档：${archived.title}（${archived.remoteSessionId}）\n`));
+            return;
+        }
+        if (action === "switch") {
+            const targetSelection = resolveTaskCommandTarget(allSessions, rest, action, { preferCurrent: true });
+            const switchArgs = targetSelection.args;
+            rejectUnsupportedTaskOptions(action, switchArgs, ["--json", "--previous"]);
+            const previous = switchArgs.includes("--previous");
+            const targetReferences = switchArgs.filter((value) => !value.startsWith("--"));
+            if (targetReferences.length > 1)
+                throw new Error(cliText("task switch accepts at most one target task.", "task switch 最多接受一个目标任务。"));
+            const targetReference = targetReferences[0];
+            if (previous && targetReference)
+                throw new Error(cliText("task switch cannot combine a target task with --previous.", "task switch 不能同时指定目标任务和 --previous。"));
+            const target = targetReference ? resolveTask(allSessions, targetReference) : undefined;
+            const switched = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_switch",
+                localSessionId: targetSelection.session.localSessionId,
+                ...(target ? { targetLocalSessionId: target.localSessionId } : {}),
+                ...(previous ? { previous: true } : {}),
+            }));
+            if (switchArgs.includes("--json"))
+                printJson(switched);
+            else
+                printCreatedTask(switched, "Current task");
+            return;
+        }
+        if (action === "queue" || action === "nosteer") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const text = target.args.join(" ").trim();
+            if (!text)
+                throw new Error(cliText(`task ${action} requires a Prompt.`, `task ${action} 需要提示词。`));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), { action: "task_queue", localSessionId: target.session.localSessionId, text }));
+            process.stdout.write(cliText(`Prompt queued (${result.queued} waiting): ${result.promptId}\n`, `提示词已排队（当前 ${result.queued} 条）：${result.promptId}\n`));
+            return;
+        }
+        if (action === "agent") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const [agentName, ...options] = target.args;
+            rejectUnsupportedTaskOptions(action, [agentName, ...options].filter((value) => value !== undefined), ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task agent accepts at most one Agent name.", "task agent 最多接受一个 Agent 名称。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_agent",
+                localSessionId: target.session.localSessionId,
+                ...(agentName && !agentName.startsWith("--") ? { agentName } : {}),
+            }));
+            const json = options.includes("--json") || agentName === "--json";
+            if (json)
+                printJson(result);
+            else
+                printTaskAgentSettings(result);
+            return;
+        }
+        if (["provider", "model", "thinking", "permissions"].includes(action)) {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const [rawValue, ...options] = target.args;
+            rejectUnsupportedTaskOptions(action, [rawValue, ...options].filter((value) => value !== undefined), ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText(`task ${action} accepts at most one value.`, `task ${action} 最多接受一个值。`));
+            const value = rawValue && !rawValue.startsWith("--") ? rawValue : undefined;
+            const json = options.includes("--json") || rawValue === "--json";
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_settings",
+                localSessionId: target.session.localSessionId,
+                ...(value ? { setting: action, value } : {}),
+            }, 60_000));
+            if (json)
+                printJson(result);
+            else
+                printTaskSettings(result, action);
+            return;
+        }
+        if (action === "goal") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const goalArgs = target.args;
+            const json = goalArgs.includes("--json");
+            const args = goalArgs.filter((value) => value !== "--json");
+            rejectUnsupportedTaskOptions(action, goalArgs, ["--json"]);
+            const parsedGoal = parseTaskGoal(args);
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_goal",
+                localSessionId: target.session.localSessionId,
+                goalAction: parsedGoal.action,
+                ...(parsedGoal.objective ? { objective: parsedGoal.objective } : {}),
+            }));
+            if (json)
+                printJson(result);
+            else
+                printTaskGoal(result);
+            return;
+        }
+        if (action === "turns") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = target.args;
+            rejectUnsupportedTaskOptions(action, options, ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task turns accepts only one task reference.", "task turns 只接受一个任务引用。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_turns",
+                localSessionId: target.session.localSessionId,
+            }, 60_000));
+            if (options.includes("--json"))
+                printJson(result);
+            else
+                printTaskTurns(result);
+            return;
+        }
+        if (action === "reset") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const [turnId, ...options] = target.args;
+            if (!turnId || turnId.startsWith("--"))
+                throw new Error(cliText("task reset requires a Turn ID.", "task reset 需要 Turn ID。"));
+            rejectUnsupportedTaskOptions(action, options, ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task reset accepts one task reference and one Turn ID.", "task reset 只接受一个任务引用和一个 Turn ID。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_reset",
+                localSessionId: target.session.localSessionId,
+                turnId,
+            }, 120_000));
+            if (options.includes("--json"))
+                printJson(result);
+            else
+                process.stdout.write(cliText(`Task reset to turn ${turnId}.\n`, `任务已 Reset 到 Turn ${turnId}。\n`));
+            return;
+        }
+        if (action === "mute") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const [rawMode, ...options] = target.args;
+            rejectUnsupportedTaskOptions(action, [rawMode, ...options].filter((value) => value !== undefined), ["--json"]);
+            if (options.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task mute accepts at most one mode.", "task mute 最多接受一个模式。"));
+            const mode = rawMode && !rawMode.startsWith("--") ? rawMode.toLowerCase() : "on";
+            if (mode && mode !== "on" && mode !== "off")
+                throw new Error(cliText("task mute accepts on or off.", "task mute 只接受 on 或 off。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_mute",
+                localSessionId: target.session.localSessionId,
+                enabled: mode === "on",
+            }));
+            const json = options.includes("--json") || rawMode === "--json";
+            if (json)
+                printJson(result);
+            else
+                process.stdout.write(cliText(`Mention-only mode: ${result.enabled ? "on" : "off"}\n`, `仅 @ 响应模式：${result.enabled ? "开启" : "关闭"}\n`));
+            return;
+        }
+        if (action === "shell") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const command = target.args.join(" ").trim();
+            if (!command)
+                throw new Error(cliText("task shell requires a command.", "task shell 需要命令。"));
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_shell",
+                localSessionId: target.session.localSessionId,
+                command,
+            }, 130_000));
+            printTaskShellResult(result);
+            if (result.exitCode && result.exitCode !== 0)
+                process.exitCode = result.exitCode;
+            return;
+        }
+        if (action === "dir") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const parsedDirectory = parseTaskDirectoryArgs([target.session.localSessionId, ...target.args]);
+            const result = controlData(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_directory",
+                localSessionId: target.session.localSessionId,
+                ...(parsedDirectory.directory ? { directory: parsedDirectory.directory } : {}),
+                ...(parsedDirectory.page !== undefined ? { page: parsedDirectory.page } : {}),
+            }, 60_000));
+            if (parsedDirectory.json)
+                printJson(result);
+            else
+                printTaskDirectory(result);
+            return;
+        }
+        if (action === "file") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const filePath = target.args.join(" ").trim();
+            if (!filePath)
+                throw new Error(cliText("task file requires a path.", "task file 需要文件路径。"));
+            ensureOk(await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
+                action: "task_send_file",
+                localSessionId: target.session.localSessionId,
+                filePath,
+            }, 120_000));
+            process.stdout.write(cliText("File sent to the task conversation.\n", "文件已发送到任务会话。\n"));
+            return;
+        }
+        if (action === "restart") {
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const translated = target.args.flatMap((value) => value === "--force" ? ["--immediate"] : [value]);
+            await serverCommand(["restart", "--task", target.session.localSessionId, ...translated]);
+            return;
+        }
         if (action === "newgroup") {
-            const options = parseTaskNewGroupOptions(rest);
-            const session = resolveTask(allSessions, options.reference);
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = parseTaskNewGroupOptions([target.session.localSessionId, ...target.args]);
+            const session = target.session;
             const targetAgentName = options.agentName ?? session.agentName;
             const targetAgent = config.agents[targetAgentName];
             if (!targetAgent) {
@@ -672,8 +1107,9 @@ async function taskCommand(input) {
             return;
         }
         if (action === "forkgroup") {
-            const options = parseTaskForkGroupOptions(rest);
-            const session = resolveTask(allSessions, options.reference);
+            const target = resolveTaskCommandTarget(allSessions, rest, action);
+            const options = parseTaskForkGroupOptions([target.session.localSessionId, ...target.args]);
+            const session = target.session;
             requireCliGroupUser(config.feishu.userOpenId);
             const response = await sendControlRequest(controlEndpoint(config.storage.sqlitePath), {
                 action: "task_fork_group",
@@ -687,39 +1123,44 @@ async function taskCommand(input) {
                 printTaskGroupResult(result, "forkgroup");
             return;
         }
-        const sessions = filterSessions(allSessions, rest);
-        if (action === "list") {
+        const sessions = filterSessions(allSessions, rest, action === "sessions" ? taskSessionsSearchTerm(rest) : undefined);
+        if (action === "list" || action === "sessions") {
             if (rest.includes("--json"))
                 printJson(sessions);
             else
                 printTaskList(sessions);
             return;
         }
-        const reference = rest.find((value) => !value.startsWith("--"));
-        if (!reference)
-            throw new Error(cliText(`task ${action} requires a task number or task ID.`, `task ${action} 需要任务序号或任务 ID。`));
-        const session = resolveTask(sessions, reference);
+        const target = resolveTaskCommandTarget(allSessions, rest, action);
+        const session = target.session;
         if (action === "chat") {
+            rejectUnsupportedTaskOptions(action, target.args, ["--json"]);
+            if (target.args.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task chat accepts only one task reference.", "task chat 只接受一个任务引用。"));
             const route = taskChatRoute(session);
-            if (rest.includes("--json"))
+            if (target.args.includes("--json"))
                 printJson(route);
             else
                 process.stdout.write(`${route.chatId}\n`);
             return;
         }
         if (action === "status") {
-            await outputTaskStatus(config.storage.sqlitePath, store, session, rest.includes("--json"));
+            rejectUnsupportedTaskOptions(action, target.args, ["--json"]);
+            if (target.args.some((value) => !value.startsWith("--")))
+                throw new Error(cliText("task status accepts only one task reference.", "task status 只接受一个任务引用。"));
+            await outputTaskStatus(config.storage.sqlitePath, store, session, target.args.includes("--json"));
             return;
         }
         const endpoint = controlEndpoint(config.storage.sqlitePath);
         if (action === "stop") {
+            if (target.args.length > 0)
+                throw new Error(cliText("task stop accepts only one task reference.", "task stop 只接受一个任务引用。"));
             ensureOk(await sendControlRequest(endpoint, { action: "task_stop", localSessionId: session.localSessionId }));
             process.stdout.write(cliText("Task stop requested.\n", "已请求停止任务。\n"));
             return;
         }
         if (action === "title") {
-            const referenceIndex = rest.indexOf(reference);
-            const titleArgs = rest.slice(referenceIndex + 1);
+            const titleArgs = target.args;
             const optionIndex = titleArgs.findIndex((value) => value.startsWith("--"));
             const title = titleArgs.slice(0, optionIndex < 0 ? undefined : optionIndex).join(" ").trim();
             if (!title)
@@ -738,15 +1179,151 @@ async function taskCommand(input) {
         store.close();
     }
 }
-function resolveCurrentTaskFromEnvironment(sessions) {
-    const resolution = resolveCurrentTask(sessions, currentAppServerThreadIds(process.env));
-    if (resolution.status === "found")
-        return resolution.session;
-    if (resolution.status === "missing-thread-id")
-        throw new Error(cliText("The current task cannot be detected because neither CODEX_THREAD_ID nor TRAECLI_THREAD_ID is set. Run this command from a Codex or TraeX task.", "无法检测当前任务：CODEX_THREAD_ID 和 TRAECLI_THREAD_ID 均未设置。请从 Codex 或 TraeX 任务中运行此命令。"));
-    if (resolution.status === "not-found")
-        throw new Error(cliText(`No AgentBot task matches the current App Server Thread ID (${resolution.threadIds.join(", ")}). Check that the correct Profile is selected.`, `没有 AgentBot 任务匹配当前 App Server Thread ID（${resolution.threadIds.join("，")}）。请检查是否选择了正确的 Profile。`));
-    throw new Error(cliText("The current task is ambiguous because multiple injected Thread IDs match AgentBot tasks. Use task status <task> with an explicit AgentBot task ID.", "当前任务存在歧义：多个注入的 Thread ID 匹配到了 AgentBot 任务。请使用明确的 AgentBot 任务 ID 执行 task status <任务>。"));
+function requireTaskCommandReference(action, reference) {
+    if (reference && !reference.startsWith("--"))
+        return;
+    throw new Error(cliText(`task ${action} requires a task number or task ID.`, `task ${action} 需要任务序号或任务 ID。`));
+}
+function rejectUnsupportedTaskOptions(action, args, supported) {
+    const unsupported = args.find((value) => value.startsWith("--") && !supported.includes(value));
+    if (!unsupported)
+        return;
+    throw new Error(cliText(`task ${action} does not support option: ${unsupported}.`, `task ${action} 不支持参数：${unsupported}。`));
+}
+function parseTaskGoal(args) {
+    if (args.length === 0 || args[0]?.toLowerCase() === "show")
+        return { action: "show" };
+    const first = args[0].toLowerCase();
+    if (first === "pause" || first === "resume" || first === "clear") {
+        if (args.length > 1)
+            throw new Error(cliText(`task goal ${first} does not accept extra arguments.`, `task goal ${first} 不接受额外参数。`));
+        return { action: first };
+    }
+    const action = first === "set" || first === "edit" ? first : "set";
+    const objective = (action === "set" && first !== "set" ? args : args.slice(1)).join(" ").trim();
+    if (!objective)
+        throw new Error(cliText(`task goal ${action} requires an objective.`, `task goal ${action} 需要目标。`));
+    return { action, objective };
+}
+function parseTaskDirectoryArgs(args) {
+    const positionals = [];
+    let page;
+    let json = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value === "--json") {
+            json = true;
+            continue;
+        }
+        if (value === "--page") {
+            const rawPage = args[index + 1];
+            const parsedPage = rawPage === undefined ? Number.NaN : Number(rawPage);
+            if (!Number.isSafeInteger(parsedPage) || parsedPage < 1)
+                throw new Error(cliText("task dir --page requires a positive page number.", "task dir --page 需要正整数页码。"));
+            page = parsedPage - 1;
+            index += 1;
+            continue;
+        }
+        if (value.startsWith("--"))
+            throw new Error(cliText(`task dir does not support option: ${value}.`, `task dir 不支持参数：${value}。`));
+        positionals.push(value);
+    }
+    const [reference, ...directoryParts] = positionals;
+    requireTaskCommandReference("dir", reference);
+    return {
+        reference,
+        directory: directoryParts.join(" ").trim() || undefined,
+        page,
+        json,
+    };
+}
+function controlData(response) {
+    ensureOk(response);
+    if (response.data === undefined)
+        throw new Error(cliText("Agent Bot returned no control result.", "Agent Bot 没有返回控制结果。"));
+    return response.data;
+}
+function printCreatedTask(session, label) {
+    process.stdout.write(`${cliText(`${label}: `, `${label === "Current task" ? "当前任务" : label === "Fork created" ? "分支任务已创建" : "任务已创建"}：`)}${session.title ?? "-"}\n`);
+    process.stdout.write(`${cliText("Local ID: ", "本地 ID：")}${session.localSessionId}\n`);
+    if (session.remoteSessionId)
+        process.stdout.write(`${cliText("Agent task ID: ", "Agent 任务 ID：")}${session.remoteSessionId}\n`);
+    process.stdout.write(`${cliText("Agent: ", "Agent：")}${session.agentName}\n`);
+    process.stdout.write(`${cliText("Directory: ", "目录：")}${session.cwd}\n`);
+}
+function printTaskAgentSettings(result) {
+    process.stdout.write(`${cliText("Default Agent: ", "默认 Agent：")}${result.current}\n`);
+    process.stdout.write(`${cliText("Available Agents: ", "可用 Agent：")}${result.agents.map((agent) => `${agent.name} (${agent.title})`).join(", ")}\n`);
+}
+function printTaskSettings(result, setting) {
+    const session = result.session;
+    process.stdout.write(`${cliText("Provider: ", "Provider：")}${session.modelProvider ?? cliText("Agent default", "Agent 默认")}\n`);
+    process.stdout.write(`${cliText("Model: ", "模型：")}${session.model ?? cliText("default", "默认")}\n`);
+    process.stdout.write(`${cliText("Thinking: ", "思考强度：")}${session.reasoningEffort ?? cliText("automatic", "自动")}\n`);
+    process.stdout.write(`${cliText("Permissions: ", "权限：")}${session.permissionMode ?? "auto"}\n`);
+    if (setting === "provider") {
+        process.stdout.write(`${cliText("Available Providers: ", "可用 Provider：")}${result.providers.map((item) => item.id).join(", ") || "-"}\n`);
+    }
+    else if (setting === "model") {
+        process.stdout.write(`${cliText("Available Models: ", "可用模型：")}${result.models.map((item) => item.id).join(", ") || "-"}\n`);
+    }
+    else if (setting === "thinking") {
+        process.stdout.write(`${cliText("Available Thinking Levels: ", "可用思考强度：")}${result.reasoningOptions.map((item) => item.value).join(", ") || "-"}\n`);
+    }
+    else {
+        process.stdout.write(`${cliText("Available Permission Modes: ", "可用权限模式：")}${result.permissionModes.join(", ")}\n`);
+    }
+}
+function printTaskGoal(result) {
+    if (!result.goal) {
+        process.stdout.write(result.cleared
+            ? cliText("Goal cleared.\n", "Goal 已清除。\n")
+            : cliText("No Goal is configured.\n", "当前没有 Goal。\n"));
+        return;
+    }
+    process.stdout.write(`${cliText("Goal: ", "Goal：")}${result.goal.objective}\n`);
+    process.stdout.write(`${cliText("Status: ", "状态：")}${result.goal.status}\n`);
+    process.stdout.write(`${cliText("Tokens used: ", "已用 Tokens：")}${result.goal.tokensUsed}\n`);
+    process.stdout.write(`${cliText("Time used: ", "已用时间：")}${result.goal.timeUsedSeconds}s\n`);
+}
+function printTaskTurns(result) {
+    process.stdout.write(`${cliText("Task: ", "任务：")}${result.session.title ?? result.session.localSessionId}\n`);
+    if (result.turns.length === 0) {
+        process.stdout.write(cliText("No completed turns.\n", "没有已完成的 Turn。\n"));
+        return;
+    }
+    for (const turn of result.turns) {
+        const marker = turn.current ? "*" : " ";
+        const parent = turn.parentTurnId ? ` <- ${turn.parentTurnId}` : "";
+        process.stdout.write(`${marker} ${turn.sequence}. ${turn.prompt?.replace(/\s+/g, " ").trim() || "-"}\n`);
+        process.stdout.write(`    ${turn.turnId}${parent}\n`);
+    }
+}
+function printTaskShellResult(result) {
+    if (result.stdout)
+        process.stdout.write(result.stdout);
+    if (result.stderr)
+        process.stderr.write(result.stderr);
+    if (!result.stdout && !result.stderr)
+        process.stdout.write(cliText("(no output)\n", "（无输出）\n"));
+    if (result.timedOut)
+        process.stderr.write(cliText("Command timed out after 120 seconds.\n", "命令在 120 秒后超时。\n"));
+}
+function printTaskDirectory(result) {
+    process.stdout.write(`${cliText("Directory: ", "目录：")}${result.directory}\n`);
+    if (result.parentDirectory)
+        process.stdout.write(`  [D] .. -> ${result.parentDirectory}\n`);
+    for (const entry of result.entries) {
+        const marker = entry.kind === "directory" || entry.kind === "drive"
+            ? "D"
+            : entry.kind === "image"
+                ? "I"
+                : entry.kind === "binary"
+                    ? "B"
+                    : "F";
+        process.stdout.write(`  [${marker}] ${entry.name}\n`);
+    }
+    process.stdout.write(cliText(`Page ${result.page + 1}/${result.totalPages}; ${result.totalEntries} entries.\n`, `第 ${result.page + 1}/${result.totalPages} 页；共 ${result.totalEntries} 项。\n`));
 }
 async function outputTaskStatus(sqlitePath, store, session, json) {
     const endpoint = controlEndpoint(sqlitePath);
@@ -775,31 +1352,35 @@ async function outputTaskStatus(sqlitePath, store, session, json) {
     else
         printTaskStatus(statusSession, snapshot, live?.remote);
 }
-function filterSessions(sessions, args) {
+function filterSessions(sessions, args, aliasSearchTerm) {
     const context = optionValue(args, "--context");
     const status = optionValue(args, "--status");
+    const search = (optionValue(args, "--search") ?? aliasSearchTerm)?.trim().toLowerCase();
     return sessions.filter((session) => (!context || session.contextKey === context)
-        && (!status || session.status === status || session.lastTurnStatus === status));
+        && (!status || session.status === status || session.lastTurnStatus === status)
+        && (!search || [
+            session.localSessionId,
+            session.remoteSessionId,
+            session.acpSessionId,
+            session.title,
+            session.agentName,
+            session.cwd,
+        ].some((value) => value?.toLowerCase().includes(search))));
 }
-function resolveTask(sessions, reference) {
-    if (/^\d+$/.test(reference)) {
-        const index = Number(reference) - 1;
-        const session = sessions[index];
-        if (!session)
-            throw new Error(cliText(`Task number is out of range: ${reference}`, `任务序号超出范围：${reference}`));
-        return session;
-    }
-    const exact = sessions.find((session) => session.localSessionId === reference || session.remoteSessionId === reference || session.acpSessionId === reference);
-    if (exact)
-        return exact;
-    const matches = sessions.filter((session) => session.localSessionId.startsWith(reference)
-        || session.remoteSessionId?.startsWith(reference)
-        || session.acpSessionId?.startsWith(reference));
-    if (matches.length === 1)
-        return matches[0];
-    if (matches.length > 1)
-        throw new Error(cliText(`Task ID prefix is ambiguous: ${reference}`, `任务 ID 前缀不唯一：${reference}`));
-    throw new Error(cliText(`Task not found: ${reference}`, `未找到任务：${reference}`));
+function taskSessionsSearchTerm(args) {
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index];
+        if (value === "--json")
+            continue;
+        if (value === "--context" || value === "--status" || value === "--search") {
+            index += 1;
+            continue;
+        }
+        if (!value.startsWith("--"))
+            positionals.push(value);
+    }
+    return positionals.join(" ").trim() || undefined;
 }
 function printTaskList(sessions) {
     process.stdout.write(formatTaskList(sessions, cliLanguage, currentAppServerThreadIds(process.env)));
@@ -864,6 +1445,10 @@ function printInitializationResult(result) {
     process.stdout.write(cliText("\nAgent Bot initialization completed.\n", "\nAgent Bot 初始化完成。\n"));
     process.stdout.write(`${cliText("Configured Agents: ", "已配置 Agent：")}${result.configuredAgents.join(", ")}\n`);
     process.stdout.write(`${cliText("Default Agent: ", "默认 Agent：")}${result.defaultAgent.name}\n`);
+    process.stdout.write(cliText(`Group message response: ${result.groupMessages.mode === "all" ? "receive all group messages" : "require an explicit @ mention"}\n`, `群消息响应方式：${result.groupMessages.mode === "all" ? "接收所有群消息" : "必须明确 @ 机器人"}\n`));
+    process.stdout.write(result.skill.updated
+        ? `${cliText("Agent Bot Skill: installed or updated at ", "Agent Bot Skill：已安装或更新至 ")}${result.skill.status.targetPath}\n`
+        : `${cliText("Agent Bot Skill: already up to date at ", "Agent Bot Skill：已是最新版本，位于 ")}${result.skill.status.targetPath}\n`);
     if (result.feishu.status === "created") {
         process.stdout.write(cliText(`Lark app: created and credentials saved (${result.feishu.appId})\n`, `飞书应用：已创建并保存凭据 (${result.feishu.appId})\n`));
     }