larkway 0.3.34 → 0.3.36

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.34**
+**Current release: v0.3.36**
 
 ---
 

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.34**
+**当前版本：v0.3.36**
 
 ---
 

package/dist/cli/index.js

@@ -25413,13 +25413,13 @@ var require_lib2 = __commonJS({
       Domain[Domain["Lark"] = 1] = "Lark";
     })(exports.Domain || (exports.Domain = {}));
     exports.LoggerLevel = void 0;
-    (function(LoggerLevel) {
-      LoggerLevel[LoggerLevel["fatal"] = 0] = "fatal";
-      LoggerLevel[LoggerLevel["error"] = 1] = "error";
-      LoggerLevel[LoggerLevel["warn"] = 2] = "warn";
-      LoggerLevel[LoggerLevel["info"] = 3] = "info";
-      LoggerLevel[LoggerLevel["debug"] = 4] = "debug";
-      LoggerLevel[LoggerLevel["trace"] = 5] = "trace";
+    (function(LoggerLevel2) {
+      LoggerLevel2[LoggerLevel2["fatal"] = 0] = "fatal";
+      LoggerLevel2[LoggerLevel2["error"] = 1] = "error";
+      LoggerLevel2[LoggerLevel2["warn"] = 2] = "warn";
+      LoggerLevel2[LoggerLevel2["info"] = 3] = "info";
+      LoggerLevel2[LoggerLevel2["debug"] = 4] = "debug";
+      LoggerLevel2[LoggerLevel2["trace"] = 5] = "trace";
     })(exports.LoggerLevel || (exports.LoggerLevel = {}));
     var CEventType = /* @__PURE__ */ Symbol("event-type");
     var CTenantKey = /* @__PURE__ */ Symbol("tenant-key");
@@ -112381,6 +112381,125 @@ var init_channelPostClient = __esm({
   }
 });
 
+// src/lark/channelCotClient.ts
+async function withTimeout(p, ms, label) {
+  let timer;
+  const timeout = new Promise((_resolve, reject) => {
+    timer = setTimeout(
+      () => reject(new Error(`[channel.cot] ${label} timed out after ${ms}ms`)),
+      ms
+    );
+    timer.unref?.();
+  });
+  try {
+    return await Promise.race([p, timeout]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+function assertOk(res, label) {
+  if (res.code !== void 0 && res.code !== 0) {
+    throw new Error(
+      `[channel.cot] ${label} failed: code=${res.code} msg=${res.msg ?? "<no msg>"}`
+    );
+  }
+}
+function stringField(data, key) {
+  const value = data?.[key];
+  return typeof value === "string" ? value : void 0;
+}
+var COT_REQUEST_TIMEOUT_MS, ChannelCotClient;
+var init_channelCotClient = __esm({
+  "src/lark/channelCotClient.ts"() {
+    "use strict";
+    COT_REQUEST_TIMEOUT_MS = 8e3;
+    ChannelCotClient = class {
+      resolveChannel;
+      constructor(opts) {
+        this.resolveChannel = opts.resolveChannel;
+      }
+      channel() {
+        const ch = this.resolveChannel();
+        if (!ch) {
+          throw new Error("[channel.cot] outbound called before the Channel SDK connected");
+        }
+        return ch;
+      }
+      /** Every COT call goes through here, so all get the same hard timeout. */
+      request(opts) {
+        return withTimeout(
+          this.channel().rawClient.request(opts),
+          COT_REQUEST_TIMEOUT_MS,
+          `${opts.method} ${opts.url}`
+        );
+      }
+      async create(target) {
+        const receiveIdType = target.threadId ? "thread_id" : "chat_id";
+        const receiveId = target.threadId ?? target.chatId;
+        const res = await this.request({
+          url: "/open-apis/im/v1/message_cot",
+          method: "POST",
+          params: { receive_id_type: receiveIdType },
+          data: {
+            receive_id: receiveId,
+            // origin_message_id only anchors non-thread bubbles; harmless if set,
+            // but omitted for topic threads where the thread id already anchors.
+            ...!target.threadId && target.originMessageId ? { origin_message_id: target.originMessageId } : {}
+          }
+        });
+        assertOk(res, "create");
+        const cotId = stringField(res.data, "cot_id");
+        const messageId = stringField(res.data, "message_id");
+        if (!cotId || !messageId) {
+          throw new Error(
+            `[channel.cot] create returned no cot_id/message_id (${JSON.stringify(res.data ?? {}).slice(0, 200)})`
+          );
+        }
+        return { cotId, messageId };
+      }
+      async update(ref, events) {
+        if (events.length === 0) return;
+        const res = await this.request({
+          url: "/open-apis/im/v1/message_cot",
+          method: "PUT",
+          data: { cot_id: ref.cotId, message_id: ref.messageId, events: [...events] }
+        });
+        assertOk(res, "update");
+      }
+      async complete(ref, reason) {
+        const res = await this.request({
+          url: `/open-apis/im/v1/message_cot/complete/${encodeURIComponent(ref.cotId)}`,
+          method: "POST",
+          params: { message_id: ref.messageId, reason }
+        });
+        assertOk(res, "complete");
+      }
+      async resolveThreadId(messageId) {
+        try {
+          const res = await this.request({
+            url: `/open-apis/im/v1/messages/${encodeURIComponent(messageId)}`,
+            method: "GET"
+          });
+          if (res.code !== void 0 && res.code !== 0) return void 0;
+          const items = res.data?.["items"];
+          if (!Array.isArray(items)) return void 0;
+          for (const item of items) {
+            if (item && typeof item === "object") {
+              const threadId = item["thread_id"];
+              if (typeof threadId === "string" && threadId.startsWith("omt_")) {
+                return threadId;
+              }
+            }
+          }
+          return void 0;
+        } catch {
+          return void 0;
+        }
+      }
+    };
+  }
+});
+
 // src/lark/channelClient.ts
 var channelClient_exports = {};
 __export(channelClient_exports, {
@@ -112431,13 +112550,13 @@ function arrayField(obj, key) {
   const value = obj[key];
   return Array.isArray(value) ? value : null;
 }
-function stringField(obj, key) {
+function stringField2(obj, key) {
   if (!obj || typeof obj !== "object") return void 0;
   const value = obj[key];
   return typeof value === "string" ? value : void 0;
 }
 function nonEmptyStringField(obj, key) {
-  const value = stringField(obj, key);
+  const value = stringField2(obj, key);
   return value && value.length > 0 ? value : void 0;
 }
 function parseLarkCliMessages(stdout2) {
@@ -112540,6 +112659,7 @@ var init_channelClient = __esm({
     init_channelCardClient();
     init_channelCardKitClient();
     init_channelPostClient();
+    init_channelCotClient();
     execFile4 = promisify4(execFileCallback);
     LEARNED_CHATS_LIMIT = 100;
     SEEN_MESSAGES_LIMIT = 1e3;
@@ -112675,6 +112795,8 @@ var init_channelClient = __esm({
       cardKitClient = null;
       /** Lazily built and only requested by main.ts when post outbound gates are configured. */
       postClient = null;
+      /** Lazily built COT (思维链) client; only requested when a bot enables cot != off. */
+      cotClient = null;
       constructor(opts) {
         if (!opts.appId || !opts.appSecret) {
           throw new Error(
@@ -112940,6 +113062,22 @@ var init_channelClient = __esm({
         }
         return this.cardKitClient;
       }
+      /**
+       * Return an OutboundCotClient bound to this client's channel handle.
+       *
+       * main.ts only calls this when the bot's `cot` config is not "off". The COT
+       * bubble uses the SDK's generic rawClient.request() (tenant token auto-
+       * injected via the same token manager as every other outbound call), so it
+       * adds no auth surface. Resolves the live channel lazily at call time.
+       */
+      outboundCotClient() {
+        if (!this.cotClient) {
+          this.cotClient = new ChannelCotClient({
+            resolveChannel: () => this.channel
+          });
+        }
+        return this.cotClient;
+      }
       /**
        * Return an OutboundPostClient bound to this client's channel handle.
        *
@@ -113243,7 +113381,7 @@ var init_channelClient = __esm({
             const chats = parseLarkCliMessages(stdout2) ?? [];
             fetched += chats.length;
             for (const raw of chats) {
-              const chatId = stringField(raw, "chat_id");
+              const chatId = stringField2(raw, "chat_id");
               if (!chatId?.startsWith("oc_")) continue;
               discoveredChatIds.add(chatId);
               const before = this.recentlySeenChatIds.size;
@@ -113257,7 +113395,7 @@ var init_channelClient = __esm({
             const hasMore = Boolean(
               (data && typeof data === "object" && data["has_more"]) ?? (parsed && typeof parsed === "object" && parsed["has_more"])
             );
-            pageToken = stringField(data, "page_token") ?? stringField(parsed, "page_token") ?? "";
+            pageToken = stringField2(data, "page_token") ?? stringField2(parsed, "page_token") ?? "";
             if (!hasMore || !pageToken) break;
           }
           if (newlyLearned > 0) {
@@ -113571,7 +113709,7 @@ function isTaskRequestTimeoutError(err2) {
   if (err2 instanceof TaskApiError && err2.cause instanceof TaskRequestTimeoutError) return true;
   return false;
 }
-function withTimeout(promise, ms, label) {
+function withTimeout2(promise, ms, label) {
   let timer;
   const timeout = new Promise((_, reject) => {
     timer = setTimeout(() => reject(new TaskRequestTimeoutError(`${label} timed out after ${ms}ms`)), ms);
@@ -113615,7 +113753,7 @@ var init_client = __esm({
       }
       /** Single choke point for every outbound call — applies the timeout race uniformly. */
       #request(config, label) {
-        return withTimeout(this.#requester.request(config), this.#timeoutMs, label);
+        return withTimeout2(this.#requester.request(config), this.#timeoutMs, label);
       }
       async getTask(taskGuid) {
         let resp;
@@ -125718,6 +125856,31 @@ var BotConfigSchema = external_exports.object({
    * @default "claude"
    */
   backend: external_exports.string().min(1).default("claude"),
+  /**
+   * COT (思维链) 气泡:把 agent 的 thinking 思考过程 + 工具调用摘要实时推到飞书
+   * 原生的可折叠思维链气泡(与最终答案卡片互不干扰,最终答案永远只走卡片)。
+   *
+   * - "off":完全不调用 message_cot API(零网络、零副作用)。
+   * - "brief"(默认):思考过程 + 工具名摘要。
+   * - "detailed":额外推工具入参(TOOL_CALL_ARGS)与截断后的工具结果。
+   *
+   * message_cot 是无公开文档的 API —— 任何一步失败都会在本次会话内自动降级、
+   * 只记 warn,绝不影响卡片和最终答案(见 src/bridge/cotProgress.ts)。
+   */
+  cot: external_exports.enum(["off", "brief", "detailed"]).default("brief"),
+  /**
+   * COT 展示形态。`cot` 管密度(off/brief/detailed),这个管落点:
+   * - "bubble"(默认):走飞书原生 message_cot 思维链气泡(src/bridge/cotProgress.ts)——
+   *   客户端原生渲染(工具图标列表 + 可折叠头),真机体验最好。已知限制:话题内
+   *   锚定不可用(气泡落群顶层,本租户 thread 通道判死),收尾 bug 已在 main 修复。
+   * - "card":思考过程内嵌进答案卡片里的 collapsible_panel(懒创建、答案上方)。
+   *   ⚠️ 实验选项 —— 2026-07-05 真机实测:飞书客户端**不渲染 collapsible_panel 的
+   *   折叠交互**(API 全 code=0,但面板被拍平成普通文本、无折叠箭头、终态也不可折叠;
+   *   CardKit 无 GET 读回、只能真机人眼验)。故 card 形态目前仅作纯文本内嵌展示用,
+   *   体验不如气泡,不建议作默认。见 memory feishu-message-cot-api。
+   * cot="off" 时本字段无意义(两种形态都不产出)。
+   */
+  cotSurface: external_exports.enum(["card", "bubble"]).default("bubble"),
   /**
    * 话题 ↔ 飞书任务句柄(docs/task-handle.md,v2)。省略此字段不代表关闭,但也
    * 不会触发任何自动建清单——main.ts 在 startup 时只做只读解析(yaml 里的
@@ -127196,6 +127359,8 @@ async function runCreateBot(ctx, creds, basics) {
     response_surface_prototype: DEFAULT_RESPONSE_SURFACE_PROTOTYPE,
     runtime: "agent_workspace",
     backend: basics.backend,
+    cot: "brief",
+    cotSurface: "bubble",
     memory_file: memoryFile,
     ...basics.gitlabTokenEnv ? { gitlab_token_env: basics.gitlabTokenEnv } : {},
     ...basics.gitName && basics.gitEmail ? { git_identity: { name: basics.gitName, email: basics.gitEmail } } : {}
@@ -127864,9 +128029,9 @@ async function checkWsConnectivity(ctx, opts) {
 }
 async function probeTaskScope(appId, appSecret, tasklistGuid) {
   try {
-    const { Client: LarkSdkClient2 } = await Promise.resolve().then(() => __toESM(require_lib2(), 1));
+    const { Client: LarkSdkClient2, LoggerLevel: LoggerLevel2 } = await Promise.resolve().then(() => __toESM(require_lib2(), 1));
     const { TaskListClient: TaskListClient2 } = await Promise.resolve().then(() => (init_client(), client_exports));
-    const sdkClient = new LarkSdkClient2({ appId, appSecret });
+    const sdkClient = new LarkSdkClient2({ appId, appSecret, loggerLevel: LoggerLevel2.fatal });
     const taskClient = new TaskListClient2({
       request: (config) => sdkClient.request(config)
     });
@@ -130650,6 +130815,8 @@ async function createBotFromCreds(opts) {
     response_surface_prototype: DEFAULT_RESPONSE_SURFACE_PROTOTYPE,
     runtime: "agent_workspace",
     backend: form.backend && form.backend.trim() ? form.backend.trim() : "codex",
+    cot: "brief",
+    cotSurface: "bubble",
     // Persist the Feishu avatar URL so the Web 管理面 can show an avatar before
     // the bridge writes status.json (pre-bridge / central roster). Best-effort:
     // only set when resolveBotIdentity returned a valid url.
@@ -131182,8 +131349,8 @@ async function loadChatNameMap(profile) {
   try {
     const { stdout: stdout2 } = await eventExecFile("lark-cli", args, { timeout: 8e3 });
     for (const chat of extractLarkCliChats(stdout2)) {
-      const chatId = stringField2(chat, "chat_id");
-      const name = stringField2(chat, "name");
+      const chatId = stringField3(chat, "chat_id");
+      const name = stringField3(chat, "name");
       if (chatId && name) names.set(chatId, name);
     }
   } catch {
@@ -131210,7 +131377,7 @@ function extractLarkCliChats(stdout2) {
 function isLarkOpenChatId(value) {
   return typeof value === "string" && value.startsWith("oc_");
 }
-function stringField2(value, key) {
+function stringField3(value, key) {
   if (!value || typeof value !== "object") return void 0;
   const out = value[key];
   return typeof out === "string" ? out : void 0;
@@ -132695,27 +132862,50 @@ function runLarkCliJson(args, spawnSyncFn) {
   }
   return { ok: true, data: parsed };
 }
-function listUserTasklists(profile, spawnSyncFn = spawnSync3) {
+function searchUserTasklists(profile, query, spawnSyncFn = spawnSync3) {
   const result = runLarkCliJson(
-    ["task", "tasklists", "list", "--as", "user", "--profile", profile, "--page-all", "--json"],
+    ["task", "+tasklist-search", "--as", "user", "--profile", profile, "--query", query, "--page-all", "--json"],
     spawnSyncFn
   );
   if (!result.ok) return result;
-  const data = result.data;
-  const items = typeof data === "object" && data !== null ? data["items"] : void 0;
-  if (!Array.isArray(items)) {
-    return { ok: false, error: `lark-cli \u8FD4\u56DE\u7684\u6E05\u5355\u5217\u8868\u5F62\u72B6\u4E0D\u5BF9(\u7F3A\u5C11 items \u6570\u7EC4):${JSON.stringify(data).slice(0, 300)}` };
+  return extractTasklistSummaries(result.data);
+}
+function extractTasklistSummaries(data) {
+  const rec = typeof data === "object" && data !== null ? data : {};
+  const nested = typeof rec["data"] === "object" && rec["data"] !== null ? rec["data"] : {};
+  let arr;
+  for (const candidate of [
+    data,
+    rec["items"],
+    rec["tasklists"],
+    rec["results"],
+    nested["items"],
+    nested["tasklists"],
+    nested["results"]
+  ]) {
+    if (Array.isArray(candidate)) {
+      arr = candidate;
+      break;
+    }
   }
-  const tasklists = [];
-  for (const raw of items) {
+  if (!arr) {
+    return {
+      ok: false,
+      error: `lark-cli +tasklist-search \u8FD4\u56DE\u7684\u5F62\u72B6\u65E0\u6CD5\u8BC6\u522B(\u627E\u4E0D\u5230\u6E05\u5355\u6570\u7EC4):${JSON.stringify(data).slice(0, 300)}`
+    };
+  }
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of arr) {
     if (typeof raw !== "object" || raw === null) continue;
     const guid = raw["guid"];
     const name = raw["name"];
-    if (typeof guid === "string" && guid.length > 0) {
-      tasklists.push({ guid, name: typeof name === "string" ? name : "(\u65E0\u6807\u9898)" });
+    if (typeof guid === "string" && guid.length > 0 && !seen.has(guid)) {
+      seen.add(guid);
+      out.push({ guid, name: typeof name === "string" ? name : "(\u65E0\u6807\u9898)" });
     }
   }
-  return { ok: true, data: tasklists };
+  return { ok: true, data: out };
 }
 function addTasklistMembersAsUser(profile, tasklistGuid, members, spawnSyncFn = spawnSync3) {
   const dataJson = JSON.stringify({ members });
@@ -132802,33 +132992,41 @@ var USAGE2 = `larkway tasklist-init [--team <bot1,bot2,\u2026>] [--name <\u6E05\
 \u5E2E\u52A9\u7684 agent,\u7B2C\u4E00\u6B65\u5FC5\u7136\u4F1A\u8DD1 \`larkway tasklist-init --help\`(\u5C31\u662F\u4F60\u6B63\u5728\u770B\u7684\u8FD9\u6BB5),
 \u4ECE\u8FD9\u91CC\u5C31\u80FD\u5B66\u4F1A\u600E\u4E48\u628A\u672C\u673A\u6240\u6709\u5DF2\u914D\u7F6E\u7684 bot \u90FD\u914D\u6210\u6E05\u5355\u6210\u5458,\u4E0D\u9700\u8981\u4F60\u518D\u624B\u52A8\u4F20\u4EFB\u4F55\u53C2\u6570\u3002
 
-\u96F6\u53C2\u6570\u4E09\u6B65 Quickstart:
-  1. (\u53EF\u9009)\u5148\u5728\u98DE\u4E66\u4EFB\u52A1\u4E2D\u5FC3\u624B\u52A8\u5EFA\u4E00\u4E2A\u6E05\u5355,\u540D\u5B57\u968F\u4FBF\u53D6,\u6BD4\u5982 "Agent Team"\u3002
-  2. \u8DD1:larkway tasklist-init
+\u96F6\u53C2\u6570 Quickstart:
+  1. \u8DD1:larkway tasklist-init
      \u2014\u2014 \u4F1A\u81EA\u52A8:--team = \u672C\u673A bots/ \u76EE\u5F55\u4E0B\u5168\u90E8\u5DF2\u914D\u7F6E bot;--name = "Agent Team";
-     \u7528\u4F60\u7684 lark-cli \u7528\u6237\u8EAB\u4EFD\u6309\u540D\u5B57\u67E5\u4E00\u904D\u80FD\u770B\u5230\u7684\u6E05\u5355 \u2014\u2014 \u67E5\u5230\u540C\u540D\u7684\u5C31 adopt(\u628A\u8FD9\u4E9B
-     bot \u52A0\u4E3A editor);\u67E5\u4E0D\u5230(\u6216\u6CA1\u767B\u5F55/\u7F3A scope)\u5C31\u9759\u9ED8\u56DE\u9000\u5230\u65E7\u7684\u521B\u5EFA\u8DEF\u5F84(\u7528\u7B2C\u4E00\u4E2A
-     bot \u7684 app \u8EAB\u4EFD\u65B0\u5EFA\u4E00\u4E2A\u6E05\u5355,\u5E76\u81EA\u52A8\u628A\u4F60\u52A0\u4E3A owner)\u3002
-  3. \u53BB\u98DE\u4E66\u4EFB\u52A1\u4E2D\u5FC3\u786E\u8BA4\u8FD9\u4E2A\u6E05\u5355\u5728\u4F60\u7684\u5217\u8868\u91CC\u53EF\u89C1,\u4E4B\u540E\u53F3\u952E\u8BDD\u9898\u6D88\u606F\u9009"\u8F6C\u4EFB\u52A1"\u5373\u53EF\u3002
+     \u7528\u7B2C\u4E00\u4E2A bot \u7684 app \u8EAB\u4EFD**\u65B0\u5EFA**\u4E00\u4E2A\u6E05\u5355(\u6E05\u5355 owner = \u8BE5 bot app),\u5E76\u628A\u4F60
+     \u52A0\u4E3A editor \u6210\u5458(\u65B9\u4FBF\u5728\u4EFB\u52A1\u4E2D\u5FC3\u770B\u5230\u5E76\u7F16\u8F91)\u3002\u96F6\u53C2\u6570**\u4E0D\u4F1A**\u81EA\u52A8\u53BB\u8BA4\u9886\u540C\u540D\u6E05\u5355\u3002
+  2. \u53BB\u98DE\u4E66\u4EFB\u52A1\u4E2D\u5FC3\u786E\u8BA4\u8FD9\u4E2A\u6E05\u5355\u5728\u4F60\u7684\u5217\u8868\u91CC\u53EF\u89C1,\u4E4B\u540E\u53F3\u952E\u8BDD\u9898\u6D88\u606F\u9009"\u8F6C\u4EFB\u52A1"\u5373\u53EF\u3002
+
+\u60F3\u8BA9\u6E05\u5355\u5F52**\u4F60\u81EA\u5DF1**\u6240\u6709(\u800C\u4E0D\u662F bot app)?\u5148\u5728\u4EFB\u52A1\u4E2D\u5FC3\u81EA\u5DF1\u5EFA\u4E00\u4E2A,\u518D\u7528
+\`--adopt "<\u6E05\u5355\u540D>"\` \u8BA4\u9886(\u89C1\u4E0B)\u3002\u591A\u5957 Larkway \u90E8\u7F72\u65F6,\u7ED9\u6BCF\u5957\u7528 --name \u6539\u4E2A\u4E0D\u540C
+\u540D\u5B57\u505A\u9694\u79BB,\u907F\u514D\u6DF7\u7528\u3002
 
 \u4EE5\u4E0A\u5168\u90E8\u662F\u7F3A\u7701\u884C\u4E3A,\u4EE5\u4E0B flag \u4EC5\u7528\u4E8E\u8986\u76D6:
 
   --team <bot1,bot2,\u2026>   \u663E\u5F0F\u6307\u5B9A\u8981\u52A0\u5165\u6E05\u5355\u7684 bot(\u9ED8\u8BA4 = \u5168\u90E8\u5DF2\u914D\u7F6E bot)
-  --name <\u6E05\u5355\u540D>          \u663E\u5F0F\u6307\u5B9A\u6E05\u5355\u540D(\u9ED8\u8BA4 "Agent Team"),\u4EC5\u5728\u81EA\u52A8/\u663E\u5F0F create
-                          \u8DEF\u5F84\u91CC\u751F\u6548;--adopt/--adopt-guid \u4F1A\u5FFD\u7565\u5B83,\u6309\u540D\u5B57/guid \u67E5
-  --adopt "<\u6E05\u5355\u540D>"       \u5F3A\u5236\u8D70 adopt \u6A21\u5F0F\u5E76\u7528\u8FD9\u4E2A\u540D\u5B57\u67E5\u627E\u2014\u2014\u67E5\u4E0D\u5230/\u67E5\u51FA\u591A\u4E2A\u90FD\u4F1A
-                          \u76F4\u63A5\u62A5\u9519\u9000\u51FA,\u4E0D\u4F1A\u9759\u9ED8\u56DE\u9000\u5230\u521B\u5EFA\u8DEF\u5F84(\u4F60\u5DF2\u7ECF\u660E\u786E\u8981 adopt\u4E86)
-  --adopt-guid <guid>     \u8DF3\u8FC7\u6309\u540D\u5B57\u67E5\u627E,\u76F4\u63A5 adopt \u8FD9\u4E2A guid \u7684\u6E05\u5355(\u5355\u72EC\u4F7F\u7528\u4E5F
-                          \u7B49\u4EF7\u4E8E\u5F3A\u5236 adopt \u6A21\u5F0F);\u591A\u4E2A\u540C\u540D\u6E05\u5355\u65F6\u7528\u5B83\u6D88\u6B67
+  --name <\u6E05\u5355\u540D>          \u663E\u5F0F\u6307\u5B9A\u8981\u521B\u5EFA/\u590D\u7528\u7684\u6E05\u5355\u540D(\u9ED8\u8BA4 "Agent Team");\u591A\u56E2\u961F
+                          \u90E8\u7F72\u7528\u5B83\u9694\u79BB\u3002--adopt/--adopt-guid \u4F1A\u5FFD\u7565\u5B83,\u6309\u540D\u5B57/guid \u67E5
+  --adopt "<\u6E05\u5355\u540D>"       \u8BA4\u9886\u4F60\u81EA\u5DF1\u5728\u4EFB\u52A1\u4E2D\u5FC3\u5EFA\u597D\u7684\u540C\u540D\u6E05\u5355(\u628A\u8FD9\u4E9B bot \u52A0\u4E3A editor)\u2014\u2014
+                          \u67E5\u4E0D\u5230/\u67E5\u51FA\u591A\u4E2A\u90FD\u76F4\u63A5\u62A5\u9519\u9000\u51FA,\u7EDD\u4E0D\u9759\u9ED8\u56DE\u9000\u5230\u521B\u5EFA\u8DEF\u5F84
+  --adopt-guid <guid>     \u8DF3\u8FC7\u6309\u540D\u5B57\u67E5\u627E,\u76F4\u63A5\u8BA4\u9886\u8FD9\u4E2A guid \u7684\u6E05\u5355;\u591A\u4E2A\u540C\u540D\u6E05\u5355\u65F6\u6D88\u6B67
   --owner <open_id>       \u663E\u5F0F\u6307\u5B9A\u4EBA\u7C7B owner(\u4EC5\u521B\u5EFA\u8DEF\u5F84\u7528\u5230,adopt \u6A21\u5F0F\u4E0B\u4F60\u672C\u6765\u5C31\u662F
                           owner,\u4E0D\u9700\u8981\u8FD9\u4E2A)
   --force                 \u8986\u76D6\u5171\u4EAB\u6CE8\u518C\u6587\u4EF6\u91CC\u5DF2\u6709\u7684 guid(\u9ED8\u8BA4\u4E0D\u8986\u76D6,\u907F\u514D\u8BEF\u64CD\u4F5C\u628A
                           \u6574\u4E2A\u56E2\u961F\u5207\u5230\u4E00\u4E2A\u65B0\u677F)
 
-\u2500\u2500 adopt \u6A21\u5F0F\u5185\u90E8\u6B65\u9AA4(\u81EA\u52A8\u9009\u4E2D,\u6216\u663E\u5F0F --adopt/--adopt-guid \u89E6\u53D1)\u2500\u2500
+\u2500\u2500 \u5220\u9664/\u6E05\u7406(\u6682\u65E0\u81EA\u52A8\u5B50\u547D\u4EE4)\u2500\u2500
+  \u96F6\u53C2\u6570\u521B\u5EFA\u7684\u6E05\u5355 owner \u662F bot app,\u4F60\u7684\u7528\u6237\u8EAB\u4EFD\u5220\u4E0D\u6389\u5B83\u3002\u8981\u5220\u9664\u672C\u673A\u6CE8\u518C\u7684\u6E05\u5355:
+  \u7528\u521B\u5EFA\u5B83\u7684 bot \u7684 app \u51ED\u8BC1(bridge \u81EA\u5DF1\u7528\u7684\u90A3\u5957,tenant_access_token)\u8C03
+  \`DELETE /open-apis/task/v2/tasklists/{guid}\`(guid \u89C1 <LARKWAY_HOME>/task-team.json),
+  \u518D\u5220\u6389\u672C\u673A\u72B6\u6001\u6587\u4EF6:task-team.json\u3001candidate-alerts-<guid>.json\u3001\u5404 bot \u7684
+  task-handles.json \u91CC\u5BF9\u5E94\u8BB0\u5F55\u3002(\u81EA\u52A8 --delete \u5B50\u547D\u4EE4\u6309\u9700\u518D\u52A0\u3002)
+
+\u2500\u2500 adopt \u6A21\u5F0F\u5185\u90E8\u6B65\u9AA4(\u4EC5\u663E\u5F0F --adopt/--adopt-guid \u89E6\u53D1)\u2500\u2500
   1. \u4EE5\u4F60(\u64CD\u4F5C\u8005)\u7684\u7528\u6237\u8EAB\u4EFD\u6309\u540D\u5B57\u7CBE\u786E\u5339\u914D\u4F60\u80FD\u770B\u5230\u7684\u6E05\u5355(\u91CD\u540D \u2192 \u62A5\u9519\u5217\u51FA\u5168\u90E8
-     guid,\u8BA9\u4F60\u52A0 --adopt-guid <guid> \u6D88\u6B67\u91CD\u8DD1;\u4E00\u4E2A\u90FD\u627E\u4E0D\u5230 \u2192 \u81EA\u52A8\u6A21\u5F0F\u4E0B\u9759\u9ED8\u56DE\u9000
-     \u521B\u5EFA\u8DEF\u5F84,\u663E\u5F0F --adopt \u4E0B\u62A5\u9519\u63D0\u793A\u5148\u53BB\u4EFB\u52A1\u4E2D\u5FC3\u5EFA\u4E00\u4E2A)
+     guid,\u8BA9\u4F60\u52A0 --adopt-guid <guid> \u6D88\u6B67\u91CD\u8DD1;\u4E00\u4E2A\u90FD\u627E\u4E0D\u5230 \u2192 \u62A5\u9519\u63D0\u793A\u5148\u53BB\u4EFB\u52A1
+     \u4E2D\u5FC3\u5EFA\u4E00\u4E2A,\u7EDD\u4E0D\u9759\u9ED8\u521B\u5EFA)
   2. \u628A\u6BCF\u4E2A bot \u7684 app \u52A0\u4E3A\u6E05\u5355\u6210\u5458(role=editor,\u5E42\u7B49,\u5DF2\u662F\u6210\u5458\u7684\u8DF3\u8FC7/\u65E0\u5BB3\u91CD\u590D)
   3. \u5199\u5165\u5171\u4EAB\u6CE8\u518C\u6587\u4EF6 <LARKWAY_HOME>/task-team.json(\u4E0E\u521B\u5EFA\u8DEF\u5F84\u540C\u4E00\u5957
      first-writer-wins / --force \u8986\u76D6\u8BED\u4E49)
@@ -132938,25 +133136,12 @@ async function run10(ctx, args) {
       loginHint
     });
   }
-  const autoTarget = resolveAdoptTarget(creatorProfile, name, void 0, loginHint);
-  if (autoTarget.ok) {
-    return runAdoptWithGuid(ctx, {
-      guid: autoTarget.guid,
-      matchedName: autoTarget.matchedName,
-      bots,
-      force,
-      creatorProfile,
-      loginHint
-    });
-  }
-  if (autoTarget.reason === "ambiguous") {
-    if (ctx.flags.json) ctx.ui.emitJson({ ok: false, error: autoTarget.message });
-    else ctx.ui.failure(autoTarget.message);
-    return 1;
-  }
   if (!ctx.flags.json) {
-    const why = autoTarget.reason === "list-failed" ? "\u65E0\u6CD5\u4EE5\u4F60\u7684\u7528\u6237\u8EAB\u4EFD\u67E5\u8BE2\u6E05\u5355" : `\u6CA1\u627E\u5230\u540C\u540D\u6E05\u5355 "${name}"`;
-    ctx.ui.print(ctx.ui.dim(`(${why},\u56DE\u9000\u5230\u7528 bot app \u8EAB\u4EFD\u521B\u5EFA/\u590D\u7528\u6E05\u5355\u2014\u2014\u5982\u9700\u5F3A\u5236 adopt \u89C1 --adopt)`));
+    ctx.ui.print(
+      ctx.ui.dim(
+        `(\u7528 bot app \u8EAB\u4EFD\u521B\u5EFA/\u590D\u7528\u6E05\u5355 "${name}"\u3002\u60F3\u8BA4\u9886\u4F60\u81EA\u5DF1\u5728\u4EFB\u52A1\u4E2D\u5FC3\u5EFA\u7684\u6E05\u5355\u8BF7\u7528 --adopt "<\u6E05\u5355\u540D>" / --adopt-guid <guid>;\u591A\u56E2\u961F\u90E8\u7F72\u5EFA\u8BAE\u7528 --name \u6539\u540D\u9694\u79BB\u3002)`
+      )
+    );
   }
   const ownerOpenId = explicitOwner ?? resolveOwnerOpenId(creatorProfile);
   if (!ownerOpenId) {
@@ -132968,7 +133153,11 @@ async function run10(ctx, args) {
     }
     return 1;
   }
-  const sdkClient = new import_node_sdk2.Client({ appId: creator.app_id, appSecret: creator.appSecret });
+  const sdkClient = new import_node_sdk2.Client({
+    appId: creator.app_id,
+    appSecret: creator.appSecret,
+    loggerLevel: import_node_sdk2.LoggerLevel.fatal
+  });
   const requester = {
     request: (config) => sdkClient.request(config)
   };
@@ -132987,13 +133176,22 @@ async function run10(ctx, args) {
     try {
       await taskClient.addTasklistMembers(tasklistGuid, members);
     } catch (err2) {
-      const msg = `\u590D\u7528\u5DF2\u6709\u6E05\u5355 ${tasklistGuid} \u65F6\u8865\u5145\u6210\u5458\u5931\u8D25: ${err2 instanceof Error ? err2.message : String(err2)}`;
-      if (ctx.flags.json) ctx.ui.emitJson({ ok: false, error: msg });
-      else {
-        ctx.ui.failure(msg);
-        ctx.ui.print("\u5E38\u89C1\u539F\u56E0:app \u672A\u5728\u5F00\u653E\u5E73\u53F0\u540E\u53F0\u52FE\u9009 task:tasklist:write / task:task:write scope(\u89C1 docs/task-handle.md \xA77)\u3002");
+      const errMsg = err2 instanceof Error ? err2.message : String(err2);
+      if (isMembersEndpoint404(err2)) {
+        if (!ctx.flags.json) {
+          ctx.ui.warning(
+            `\u590D\u7528\u6E05\u5355 ${tasklistGuid} \u65F6 add_members \u8FD4\u56DE 404(app \u7C7B\u578B\u6210\u5458\u7AEF\u70B9\u4E0D\u652F\u6301\u81EA\u52A9\u52A0\u5165,bot \u901A\u5E38\u5DF2\u7ECF\u662F\u6210\u5458)\u2014\u2014\u5DF2\u5FFD\u7565,\u4E0D\u5F71\u54CD\u4F7F\u7528(\u4E0E bridge \u542F\u52A8\u7684\u81EA\u52A9\u52A0\u5165\u540C\u6B3E\u964D\u7EA7)\u3002`
+          );
+        }
+      } else {
+        const msg = `\u590D\u7528\u5DF2\u6709\u6E05\u5355 ${tasklistGuid} \u65F6\u8865\u5145\u6210\u5458\u5931\u8D25: ${errMsg}`;
+        if (ctx.flags.json) ctx.ui.emitJson({ ok: false, error: msg });
+        else {
+          ctx.ui.failure(msg);
+          ctx.ui.print("\u5E38\u89C1\u539F\u56E0:app \u672A\u5728\u5F00\u653E\u5E73\u53F0\u540E\u53F0\u52FE\u9009 task:tasklist:write / task:task:write scope(\u89C1 docs/task-handle.md \xA77)\u3002");
+        }
+        return 1;
       }
-      return 1;
     }
   } else {
     reused = false;
@@ -133050,8 +133248,10 @@ async function run10(ctx, args) {
   } else {
     ctx.ui.success(`\u6E05\u5355 "${name}" \u5DF2\u521B\u5EFA: ${tasklistGuid}`);
   }
-  ctx.ui.print(`owner \u6210\u5458: ${ownerOpenId}${explicitOwner ? "" : "(\u4ECE lark-cli \u5F53\u524D\u767B\u5F55\u7528\u6237\u81EA\u52A8\u89E3\u6790)"}`);
-  ctx.ui.print(`\u5DF2\u52A0\u5165\u6210\u5458(editor): ${bots.map((b) => b.id).join(", ")}`);
+  ctx.ui.print(
+    `\u4F60(${ownerOpenId})\u5DF2\u4F5C\u4E3A editor \u52A0\u5165${explicitOwner ? "" : "(open_id \u4ECE lark-cli \u5F53\u524D\u767B\u5F55\u7528\u6237\u81EA\u52A8\u89E3\u6790)"} \u2014\u2014 \u6E05\u5355 owner \u662F\u521B\u5EFA\u5B83\u7684 bot app;\u4F60\u662F editor \u6210\u5458(\u53EF\u5728\u4EFB\u52A1\u4E2D\u5FC3\u770B\u5230\u5E76\u7F16\u8F91)\u3002`
+  );
+  ctx.ui.print(`\u5DF2\u52A0\u5165(editor)\u7684 bot: ${bots.map((b) => b.id).join(", ")}`);
   ctx.ui.print("");
   if (!reused) {
     ctx.ui.print(
@@ -133070,16 +133270,22 @@ async function run10(ctx, args) {
   );
   return 0;
 }
+function isMembersEndpoint404(err2) {
+  if (err2 instanceof TaskApiError) {
+    return err2.status === 404 && err2.code === void 0;
+  }
+  return /page not found/i.test(err2 instanceof Error ? err2.message : String(err2));
+}
 function resolveAdoptTarget(creatorProfile, name, explicitGuid, loginHint) {
   if (explicitGuid) {
     return { ok: true, guid: explicitGuid, matchedName: name };
   }
-  const listResult = listUserTasklists(creatorProfile);
+  const listResult = searchUserTasklists(creatorProfile, name);
   if (!listResult.ok) {
     return {
       ok: false,
       reason: "list-failed",
-      message: `\u65E0\u6CD5\u4EE5\u4F60\u7684\u7528\u6237\u8EAB\u4EFD\u5217\u51FA\u6E05\u5355:${listResult.error}
+      message: `\u65E0\u6CD5\u4EE5\u4F60\u7684\u7528\u6237\u8EAB\u4EFD\u67E5\u8BE2\u6E05\u5355:${listResult.error}
 
 \u8BF7\u5148\u786E\u8BA4\u5DF2\u7528\u8FD9\u4E2A profile \u767B\u5F55\u8FC7\u7528\u6237\u8EAB\u4EFD\u3001\u4E14\u7533\u8BF7\u4E86 task \u57DF\u6743\u9650:
   ${loginHint}