@clawos-dev/clawd 0.2.489 → 0.2.490

package/dist/app-builder-plugin/mcp-server.cjs

@@ -21317,10 +21317,22 @@ var EnvSecretSchema = external_exports.object({
 var EnvAssetSchema = external_exports.object({
   name: external_exports.string().min(1)
 });
+var ConnectorNameSchema = external_exports.string().regex(/^[a-z0-9-]+$/, "\u8FDE\u63A5\u5668\u540D\u53EA\u80FD\u662F\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u77ED\u6A2A\u7EBF");
+var EnvConnectorSchema = external_exports.object({ name: ConnectorNameSchema });
 var MANIFEST_BODY = {
   clis: external_exports.array(EnvCliSchema),
   secrets: external_exports.array(EnvSecretSchema),
-  assets: external_exports.array(EnvAssetSchema)
+  assets: external_exports.array(EnvAssetSchema),
+  /**
+   * 装了哪些连接器（design 2026-09-09-cloud-connector-credentials §7.1）。**字符串数组**，
+   * 是四段里唯一不是 `{name}` 对象数组的一段：连接器没有任何附加属性，包一层对象只是多一层壳。
+   *
+   * 不复用 secrets：那段说的是「需要一份值，由部署者填」，这里没有值要填；
+   * 不从 clis 推断：lark-cli 在底座里，每个 persona 都有它，推不出任何东西。
+   *
+   * **缺省空而不是必填**：本机上已有的单据不用为此重扫一遍；没声明就是没装，扫描器照样会报。
+   */
+  connectors: external_exports.array(ConnectorNameSchema).default([])
 };
 var EnvManifestBodySchema = external_exports.object(MANIFEST_BODY);
 var EnvironmentManifestSchema = external_exports.object({
@@ -21453,8 +21465,9 @@ var DeployRerunJobArgsSchema = external_exports.object({
 }).strict();
 var DeployReportFindingArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1),
-  kind: external_exports.enum(["cli", "secret", "asset"]),
+  kind: external_exports.enum(["cli", "secret", "asset", "connector"]),
   // 该条目在 manifest 对应数组里的内容（形状随 kind 变，handler 按 kind 收窄校验）
+  // connector 的 item 只有 name，落进清单时只留名字（manifest.connectors 是字符串数组）
   item: external_exports.record(external_exports.string(), external_exports.unknown()),
   // 这条发现的来历（一句人话 + 原文出处），形状同 EnvEvidence，target 由 handler 从 kind+name 派生
   evidence: external_exports.object({
@@ -21750,6 +21763,16 @@ var DispatchRecordSchema = external_exports.object({
   sourceSessionId: external_exports.string().min(1),
   sourcePersonaId: external_exports.string().min(1).optional(),
   targetPersonaId: external_exports.string().min(1),
+  /**
+   * 跨设备派活时 B 所在的设备（`DispatchRunArgs.targetDeviceId`），A 端台账记「我派给了谁的机器」。
+   *
+   * **缺省即本机**，与入参侧用 `undefined` 表示本机是同一条口径——不引第二种表示法。
+   * 存量台账行没有这个字段，消费方（dispatch 卡片的归属带）据此只显示 persona、不显示设备。
+   *
+   * B 端自己的台账行**不会**有它：peer-forward 转发时故意 strip 掉（B 据此判定本地执行），
+   * 那条行记的是 B 视角的本地 dispatch。
+   */
+  targetDeviceId: external_exports.string().min(1).optional(),
   /** B 的 sessionId；registerBSession 后回填 */
   workerSessionId: external_exports.string().min(1).optional(),
   /** 任务摘要；截断（≤500 字符）在 daemon store.add 处保证 */
@@ -21776,7 +21799,17 @@ var DispatchRecordSchema = external_exports.object({
   deliveredAt: external_exports.string().min(1).optional()
 });
 var DispatchListArgsSchema = external_exports.object({
-  sourceSessionId: external_exports.string().min(1).optional()
+  sourceSessionId: external_exports.string().min(1).optional(),
+  /**
+   * 「**这条会话卷入的**所有台账行」：`sourceSessionId === it || workerSessionId === it`。
+   *
+   * 为什么不复用 `sourceSessionId`：一条会话既可能是派活方（在自己这儿看回报卡），也可能是
+   * 干活方（在 worker 会话里看任务包），后者用 sourceSessionId 过滤一条也查不到。UI 的
+   * dispatch 卡片要的正是「跟我这条会话有关的全部 dispatch」，一次调用答完，不必拉全量再本地筛。
+   *
+   * 与 `sourceSessionId` 同时给时两个条件都要满足（AND），但调用方没有这么用的场景。
+   */
+  relatedSessionId: external_exports.string().min(1).optional()
 });
 var DispatchListResultSchema = external_exports.object({
   records: external_exports.array(DispatchRecordSchema)

package/dist/cli.cjs

@@ -5951,7 +5951,7 @@ var init_contact_handshake = __esm({
 });
 
 // ../protocol/src/environment-schemas.ts
-var EnvCliSchema, EnvSecretSchema, EnvAssetSchema, MANIFEST_BODY, EnvManifestBodySchema, EnvironmentManifestSchema, EnvEvidenceSchema;
+var EnvCliSchema, EnvSecretSchema, EnvAssetSchema, ConnectorNameSchema, EnvConnectorSchema, MANIFEST_BODY, EnvManifestBodySchema, EnvironmentManifestSchema, EnvEvidenceSchema;
 var init_environment_schemas = __esm({
   "../protocol/src/environment-schemas.ts"() {
     "use strict";
@@ -5993,10 +5993,22 @@ var init_environment_schemas = __esm({
     EnvAssetSchema = external_exports.object({
       name: external_exports.string().min(1)
     });
+    ConnectorNameSchema = external_exports.string().regex(/^[a-z0-9-]+$/, "\u8FDE\u63A5\u5668\u540D\u53EA\u80FD\u662F\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u77ED\u6A2A\u7EBF");
+    EnvConnectorSchema = external_exports.object({ name: ConnectorNameSchema });
     MANIFEST_BODY = {
       clis: external_exports.array(EnvCliSchema),
       secrets: external_exports.array(EnvSecretSchema),
-      assets: external_exports.array(EnvAssetSchema)
+      assets: external_exports.array(EnvAssetSchema),
+      /**
+       * 装了哪些连接器（design 2026-09-09-cloud-connector-credentials §7.1）。**字符串数组**，
+       * 是四段里唯一不是 `{name}` 对象数组的一段：连接器没有任何附加属性，包一层对象只是多一层壳。
+       *
+       * 不复用 secrets：那段说的是「需要一份值，由部署者填」，这里没有值要填；
+       * 不从 clis 推断：lark-cli 在底座里，每个 persona 都有它，推不出任何东西。
+       *
+       * **缺省空而不是必填**：本机上已有的单据不用为此重扫一遍；没声明就是没装，扫描器照样会报。
+       */
+      connectors: external_exports.array(ConnectorNameSchema).default([])
     };
     EnvManifestBodySchema = external_exports.object(MANIFEST_BODY);
     EnvironmentManifestSchema = external_exports.object({
@@ -6148,8 +6160,9 @@ var init_deploy_schemas = __esm({
     }).strict();
     DeployReportFindingArgsSchema = external_exports.object({
       personaId: external_exports.string().min(1),
-      kind: external_exports.enum(["cli", "secret", "asset"]),
+      kind: external_exports.enum(["cli", "secret", "asset", "connector"]),
       // 该条目在 manifest 对应数组里的内容（形状随 kind 变，handler 按 kind 收窄校验）
+      // connector 的 item 只有 name，落进清单时只留名字（manifest.connectors 是字符串数组）
       item: external_exports.record(external_exports.string(), external_exports.unknown()),
       // 这条发现的来历（一句人话 + 原文出处），形状同 EnvEvidence，target 由 handler 从 kind+name 派生
       evidence: external_exports.object({
@@ -6494,6 +6507,16 @@ var init_dispatch = __esm({
       sourceSessionId: external_exports.string().min(1),
       sourcePersonaId: external_exports.string().min(1).optional(),
       targetPersonaId: external_exports.string().min(1),
+      /**
+       * 跨设备派活时 B 所在的设备（`DispatchRunArgs.targetDeviceId`），A 端台账记「我派给了谁的机器」。
+       *
+       * **缺省即本机**，与入参侧用 `undefined` 表示本机是同一条口径——不引第二种表示法。
+       * 存量台账行没有这个字段，消费方（dispatch 卡片的归属带）据此只显示 persona、不显示设备。
+       *
+       * B 端自己的台账行**不会**有它：peer-forward 转发时故意 strip 掉（B 据此判定本地执行），
+       * 那条行记的是 B 视角的本地 dispatch。
+       */
+      targetDeviceId: external_exports.string().min(1).optional(),
       /** B 的 sessionId；registerBSession 后回填 */
       workerSessionId: external_exports.string().min(1).optional(),
       /** 任务摘要；截断（≤500 字符）在 daemon store.add 处保证 */
@@ -6520,7 +6543,17 @@ var init_dispatch = __esm({
       deliveredAt: external_exports.string().min(1).optional()
     });
     DispatchListArgsSchema = external_exports.object({
-      sourceSessionId: external_exports.string().min(1).optional()
+      sourceSessionId: external_exports.string().min(1).optional(),
+      /**
+       * 「**这条会话卷入的**所有台账行」：`sourceSessionId === it || workerSessionId === it`。
+       *
+       * 为什么不复用 `sourceSessionId`：一条会话既可能是派活方（在自己这儿看回报卡），也可能是
+       * 干活方（在 worker 会话里看任务包），后者用 sourceSessionId 过滤一条也查不到。UI 的
+       * dispatch 卡片要的正是「跟我这条会话有关的全部 dispatch」，一次调用答完，不必拉全量再本地筛。
+       *
+       * 与 `sourceSessionId` 同时给时两个条件都要满足（AND），但调用方没有这么用的场景。
+       */
+      relatedSessionId: external_exports.string().min(1).optional()
     });
     DispatchListResultSchema = external_exports.object({
       records: external_exports.array(DispatchRecordSchema)
@@ -53667,6 +53700,7 @@ var PersonaDispatchManager = class {
       sourceSessionId: args.sourceSessionId,
       ...args.sourcePersonaId ? { sourcePersonaId: args.sourcePersonaId } : {},
       targetPersonaId: args.targetPersona,
+      ...args.targetDeviceId ? { targetDeviceId: args.targetDeviceId } : {},
       taskText: args.taskText,
       ...args.taskBrief ? { taskBrief: args.taskBrief } : {},
       ...args.meta ? { meta: args.meta } : {}
@@ -53784,6 +53818,7 @@ function createDispatchStore(deps) {
       sourceSessionId: input.sourceSessionId,
       ...input.sourcePersonaId ? { sourcePersonaId: input.sourcePersonaId } : {},
       targetPersonaId: input.targetPersonaId,
+      ...input.targetDeviceId ? { targetDeviceId: input.targetDeviceId } : {},
       taskText: input.taskText.slice(0, TASK_TEXT_MAX),
       ...input.taskBrief ? { taskBrief: input.taskBrief } : {},
       // 新开 dispatch = 第 1 轮；续派在 handler 里 +1
@@ -53805,7 +53840,9 @@ function createDispatchStore(deps) {
     return merged;
   }
   function list(filter) {
-    return records.filter((r) => !filter?.sourceSessionId || r.sourceSessionId === filter.sourceSessionId).slice().sort((a, b2) => a.createdAt < b2.createdAt ? 1 : a.createdAt > b2.createdAt ? -1 : 0);
+    return records.filter((r) => !filter?.sourceSessionId || r.sourceSessionId === filter.sourceSessionId).filter(
+      (r) => !filter?.relatedSessionId || r.sourceSessionId === filter.relatedSessionId || r.workerSessionId === filter.relatedSessionId
+    ).slice().sort((a, b2) => a.createdAt < b2.createdAt ? 1 : a.createdAt > b2.createdAt ? -1 : 0);
   }
   function markInterruptedAsFailed(nowIso3) {
     let touched = false;
@@ -54993,11 +55030,16 @@ async function writeScan(dir, scan) {
   await writeJson(import_node_path31.default.join(dir, SCAN_FILE), DeployScanSchema.parse(scan));
 }
 function emptyDeployFile() {
-  return { version: 1, manifest: { version: 1, clis: [], secrets: [], assets: [] } };
+  return { version: 1, manifest: { version: 1, clis: [], secrets: [], assets: [], connectors: [] } };
 }
+var FINDING_SCHEMAS = {
+  cli: EnvCliSchema,
+  secret: EnvSecretSchema,
+  asset: EnvAssetSchema,
+  connector: EnvConnectorSchema
+};
 function parseFinding(kind, item) {
-  const schema = kind === "cli" ? EnvCliSchema : kind === "secret" ? EnvSecretSchema : EnvAssetSchema;
-  const parsed = schema.safeParse(item);
+  const parsed = FINDING_SCHEMAS[kind].safeParse(item);
   if (!parsed.success) {
     const first = parsed.error.issues[0];
     throw new Error(`${kind} \u6761\u76EE\u4E0D\u5408\u6CD5\uFF1A${first ? `${first.path.join(".")} ${first.message}` : ""}`);
@@ -55005,6 +55047,11 @@ function parseFinding(kind, item) {
   return parsed.data;
 }
 function upsertFinding(file, kind, item) {
+  if (kind === "connector") {
+    const have = file.manifest.connectors;
+    const connectors = have.includes(item.name) ? have : [...have, item.name];
+    return { ...file, manifest: { ...file.manifest, connectors } };
+  }
   const key = kind === "cli" ? "clis" : kind === "secret" ? "secrets" : "assets";
   const list = [...file.manifest[key]];
   const idx = list.findIndex((x) => x.name === item.name);
@@ -55091,6 +55138,10 @@ var L = [
   // smoke 与 deploy 都要：smoke 得用正式那份模型探活，否则验的不是将要上线的东西。
   "      model: ${{ steps.plan.outputs.model }}",
   "      effort: ${{ steps.plan.outputs.effort }}",
+  // 装了哪些连接器（JSON 数组）。gateway 按它决定要不要为任务签工牌、把授权链接拼进 prompt
+  //（design 2026-09-09-cloud-connector-credentials）。名字形状在 deploy-file.mjs 卡死成 [a-z0-9-]，
+  // 所以下面单引号包住直接拼进命令行是安全的。
+  "      connectors: ${{ steps.plan.outputs.connectors }}",
   "    steps:",
   "      - name: Checkout persona",
   "        uses: actions/checkout@v4",
@@ -55213,6 +55264,7 @@ var L = [
   "            --persona-id '${{ needs.build.outputs.persona_id }}' \\",
   "            --model '${{ needs.build.outputs.model }}' \\",
   "            --effort '${{ needs.build.outputs.effort }}' \\",
+  "            --connectors '${{ needs.build.outputs.connectors }}' \\",
   "            --run-number '${{ github.run_number }}'",
   "",
   "  deploy:",
@@ -55242,7 +55294,8 @@ var L = [
   "            --image '${{ needs.build.outputs.image }}' \\",
   "            --persona-id '${{ needs.build.outputs.persona_id }}' \\",
   "            --model '${{ needs.build.outputs.model }}' \\",
-  "            --effort '${{ needs.build.outputs.effort }}'",
+  "            --effort '${{ needs.build.outputs.effort }}' \\",
+  "            --connectors '${{ needs.build.outputs.connectors }}'",
   ""
 ];
 var WORKFLOW_TEMPLATE = L.join("\n");
@@ -56848,9 +56901,10 @@ function canAccessPersona(grants, personaId2, action) {
 
 // src/handlers/persona-dispatch.ts
 init_claude();
-function buildFollowUpTaskPack(dispatchId, prompt, round) {
+function buildFollowUpTaskPack(dispatchId, prompt, round, from) {
   return formatDispatchTaskEnvelope({
     dispatchId,
+    ...from ? { from } : {},
     round,
     detail: [
       `[Follow-up instruction for dispatch ${dispatchId}]`,
@@ -56876,6 +56930,7 @@ function buildPersonaDispatchHandlers(deps) {
       });
     }
     const args = DispatchRunArgsSchema.parse(rest);
+    const sourcePersonaId = deps.getSessionPersonaId?.(sourceSessionId);
     if (args.tool !== void 0 && ctx?.principal.kind === "guest") {
       throw new ClawdError(
         ERROR_CODES.UNAUTHORIZED,
@@ -56931,7 +56986,14 @@ function buildPersonaDispatchHandlers(deps) {
       });
       const ok = deps.sendFollowUp(
         rec4.workerSessionId,
-        buildFollowUpTaskPack(args.dispatchId, args.prompt, nextRound),
+        buildFollowUpTaskPack(
+          args.dispatchId,
+          args.prompt,
+          nextRound,
+          // 台账行里有就用台账的（本机派活一律有），没有再现查一次：老台账行是在
+          // sourcePersonaId 有写入点之前落的，那些行只能靠现查补上。
+          rec4.sourcePersonaId ?? deps.getSessionPersonaId?.(sourceSessionId)
+        ),
         // 来源分型（L2）：续派并进 dispatch-task；realtime 侧靠这个 meta 打标，
         // history 侧靠 classifyUserMessage 从信封解出同值。
         "dispatch-task"
@@ -56997,6 +57059,10 @@ function buildPersonaDispatchHandlers(deps) {
       const { dispatchId: dispatchId2 } = mgr.start({
         sourceSessionId,
         targetPersona,
+        ...sourcePersonaId ? { sourcePersonaId } : {},
+        // A 端台账记「我派给了谁的机器」：worker 会话在对端，本机点不进去，卡片的归属带
+        // 靠这个字段说出「在哪台机器上」而不是干瞪眼（design §4 跨设备那一行）。
+        targetDeviceId: args.targetDeviceId,
         taskText: args.prompt,
         ...args.brief ? { taskBrief: args.brief } : {},
         ...args.meta ? { meta: args.meta } : {}
@@ -57070,6 +57136,9 @@ function buildPersonaDispatchHandlers(deps) {
     const { dispatchId } = mgr.start({
       sourceSessionId,
       targetPersona,
+      // 「这活谁派的」的真源。schema 里早就有这个字段，本次之前没有任何写入点——
+      // 于是 worker 会话的 dispatch 卡片永远查不到派活方（归属带只能退回信封）。
+      ...sourcePersonaId ? { sourcePersonaId } : {},
       taskText: args.prompt,
       ...args.brief ? { taskBrief: args.brief } : {},
       ...args.meta ? { meta: args.meta } : {}
@@ -57136,9 +57205,10 @@ function buildPersonaDispatchHandlers(deps) {
   const list = async (frame) => {
     const { type: _t, requestId: _r, ...rest } = frame;
     const args = DispatchListArgsSchema.parse(rest);
-    const records = deps.store.list(
-      args.sourceSessionId ? { sourceSessionId: args.sourceSessionId } : void 0
-    );
+    const records = deps.store.list({
+      ...args.sourceSessionId ? { sourceSessionId: args.sourceSessionId } : {},
+      ...args.relatedSessionId ? { relatedSessionId: args.relatedSessionId } : {}
+    });
     return {
       response: { type: "personaDispatch:list:ok", records }
     };
@@ -65464,7 +65534,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.489".length > 0 ? "0.2.489" : "dev";
+var version = "0.2.490".length > 0 ? "0.2.490" : "dev";
 
 // src/cli-probe/probe.ts
 var fs72 = __toESM(require("fs"), 1);
@@ -70582,6 +70652,9 @@ async function startDaemon(config) {
     },
     // 续派（spec 2026-07-21）：任务包注入 worker session，复用投递同款注入路径。
     sendFollowUp: (workerSessionId, text, meta) => manager.injectIntoSession(workerSessionId, text, meta),
+    // 「这活是谁派的」：台账 sourcePersonaId + 续派包信封 from 都吃它。与首发任务包在
+    // SessionManager 那侧的反查（buildDispatchTaskPack 的 from）是同一个字段、同一个查法。
+    getSessionPersonaId: (sessionId) => manager.findOwnedSession(sessionId)?.ownerPersonaId,
     logger,
     spawnB: async (args) => {
       logger.info("dispatch.spawnB.start", {

package/dist/dispatch/mcp-server.cjs

@@ -21310,10 +21310,22 @@ var EnvSecretSchema = external_exports.object({
 var EnvAssetSchema = external_exports.object({
   name: external_exports.string().min(1)
 });
+var ConnectorNameSchema = external_exports.string().regex(/^[a-z0-9-]+$/, "\u8FDE\u63A5\u5668\u540D\u53EA\u80FD\u662F\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u548C\u77ED\u6A2A\u7EBF");
+var EnvConnectorSchema = external_exports.object({ name: ConnectorNameSchema });
 var MANIFEST_BODY = {
   clis: external_exports.array(EnvCliSchema),
   secrets: external_exports.array(EnvSecretSchema),
-  assets: external_exports.array(EnvAssetSchema)
+  assets: external_exports.array(EnvAssetSchema),
+  /**
+   * 装了哪些连接器（design 2026-09-09-cloud-connector-credentials §7.1）。**字符串数组**，
+   * 是四段里唯一不是 `{name}` 对象数组的一段：连接器没有任何附加属性，包一层对象只是多一层壳。
+   *
+   * 不复用 secrets：那段说的是「需要一份值，由部署者填」，这里没有值要填；
+   * 不从 clis 推断：lark-cli 在底座里，每个 persona 都有它，推不出任何东西。
+   *
+   * **缺省空而不是必填**：本机上已有的单据不用为此重扫一遍；没声明就是没装，扫描器照样会报。
+   */
+  connectors: external_exports.array(ConnectorNameSchema).default([])
 };
 var EnvManifestBodySchema = external_exports.object(MANIFEST_BODY);
 var EnvironmentManifestSchema = external_exports.object({
@@ -21446,8 +21458,9 @@ var DeployRerunJobArgsSchema = external_exports.object({
 }).strict();
 var DeployReportFindingArgsSchema = external_exports.object({
   personaId: external_exports.string().min(1),
-  kind: external_exports.enum(["cli", "secret", "asset"]),
+  kind: external_exports.enum(["cli", "secret", "asset", "connector"]),
   // 该条目在 manifest 对应数组里的内容（形状随 kind 变，handler 按 kind 收窄校验）
+  // connector 的 item 只有 name，落进清单时只留名字（manifest.connectors 是字符串数组）
   item: external_exports.record(external_exports.string(), external_exports.unknown()),
   // 这条发现的来历（一句人话 + 原文出处），形状同 EnvEvidence，target 由 handler 从 kind+name 派生
   evidence: external_exports.object({
@@ -21743,6 +21756,16 @@ var DispatchRecordSchema = external_exports.object({
   sourceSessionId: external_exports.string().min(1),
   sourcePersonaId: external_exports.string().min(1).optional(),
   targetPersonaId: external_exports.string().min(1),
+  /**
+   * 跨设备派活时 B 所在的设备（`DispatchRunArgs.targetDeviceId`），A 端台账记「我派给了谁的机器」。
+   *
+   * **缺省即本机**，与入参侧用 `undefined` 表示本机是同一条口径——不引第二种表示法。
+   * 存量台账行没有这个字段，消费方（dispatch 卡片的归属带）据此只显示 persona、不显示设备。
+   *
+   * B 端自己的台账行**不会**有它：peer-forward 转发时故意 strip 掉（B 据此判定本地执行），
+   * 那条行记的是 B 视角的本地 dispatch。
+   */
+  targetDeviceId: external_exports.string().min(1).optional(),
   /** B 的 sessionId；registerBSession 后回填 */
   workerSessionId: external_exports.string().min(1).optional(),
   /** 任务摘要；截断（≤500 字符）在 daemon store.add 处保证 */
@@ -21769,7 +21792,17 @@ var DispatchRecordSchema = external_exports.object({
   deliveredAt: external_exports.string().min(1).optional()
 });
 var DispatchListArgsSchema = external_exports.object({
-  sourceSessionId: external_exports.string().min(1).optional()
+  sourceSessionId: external_exports.string().min(1).optional(),
+  /**
+   * 「**这条会话卷入的**所有台账行」：`sourceSessionId === it || workerSessionId === it`。
+   *
+   * 为什么不复用 `sourceSessionId`：一条会话既可能是派活方（在自己这儿看回报卡），也可能是
+   * 干活方（在 worker 会话里看任务包），后者用 sourceSessionId 过滤一条也查不到。UI 的
+   * dispatch 卡片要的正是「跟我这条会话有关的全部 dispatch」，一次调用答完，不必拉全量再本地筛。
+   *
+   * 与 `sourceSessionId` 同时给时两个条件都要满足（AND），但调用方没有这么用的场景。
+   */
+  relatedSessionId: external_exports.string().min(1).optional()
 });
 var DispatchListResultSchema = external_exports.object({
   records: external_exports.array(DispatchRecordSchema)

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-persona-for-deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: scan-persona-for-deploy
-description: 老板要把某个 persona 发布到云上时触发——把这个 persona 读一遍，弄清它挪到一台干净的云上机器要预备什么（命令行工具、凭据、随行资产），边查边填进它的部署文件。收到形如「扫描 persona-xxx 的部署环境，personaId=persona-xxx」的任务时使用。只负责扫，不负责部署。
+description: 老板要把某个 persona 发布到云上时触发——把这个 persona 读一遍，弄清它挪到一台干净的云上机器要预备什么（命令行工具、凭据、随行资产、连接器），边查边填进它的部署文件。收到形如「扫描 persona-xxx 的部署环境，personaId=persona-xxx」的任务时使用。只负责扫，不负责部署。
 ---
 
 # 扫 persona 的上云环境
@@ -35,7 +35,7 @@ description: 老板要把某个 persona 发布到云上时触发——把这个
 ```
 call({ method: "deploy:reportFinding", args: {
   personaId: "<任务里给的>",
-  kind: "cli" | "secret" | "asset",
+  kind: "cli" | "secret" | "asset" | "connector",
   item: { ... },        // 见下面各类的字段
   evidence: { reason: "...", file: "...", quote: "..." }
 }})
@@ -99,6 +99,18 @@ call({ method: "deploy:reportFinding", args: {
 - 判据往往落在「这个动作在云上由谁提供」。persona 在本机走 daemon 提供的 MCP 干的活，
   云上容器里没有 daemon，靠的就是那份随行资产。
 
+### kind: "connector" —— 以用户本人身份操作的第三方
+
+`item` 字段只有 `name`（小写字母、数字、短横线）。目前能声明的只有 `feishu`。
+
+判据：**persona 里出现「以用户本人身份操作某个第三方」的动作**就报——查他的日程、发他的消息、
+读他的文档，这类活在云上要先拿到他本人的授权，授权由云上的连接器完成，不是部署者填一份凭据就能代替的。
+
+- 跟 `secret` 的区别：`secret` 是「部署者出一份值，全体使用者共用」；`connector` 是「每个使用者各自授权一次」。
+  一个 persona 用 `lark-cli … --as user` 操作飞书，报的是 `connector: feishu`，**不要**再给它报一条飞书的 `secret`。
+- 跟 `cli` 的区别：`lark-cli` 这个工具本身在底座镜像里，不用报 `cli`；报 `connector` 说的是「它要用谁的身份」。
+- `evidence.quote` 引 skill 里带 `--as user` 的那类命令行就够。
+
 ### evidence —— 每条的来历
 
 - `reason`：**一句人话**，说清「为什么需要它 + 你从哪看出来的」，写给不熟悉这个 persona 的人看。