paseo-plugin-zcode-provider 0.2.0 → 0.4.0

package/server/vendor/zcode/packages/shared/src/bots.ts

@@ -1,6 +1,9 @@
+import { zcodeProtocolTraceSchema, type ZCodeProtocolTrace } from "./zcode-protocol/trace.js";
+import { channelContentPartsSchema, type ChannelContentPart } from "./channel-mention.js";
 /* oxlint-disable eslint(max-lines) -- Bot 共享合约集中维护 provider、状态和 schema，保持类型与校验就近。 */
 import { z } from "zod";
 import { modelSelectionSchema, type ModelSelection } from "./model-selection.js";
+import { conversationQuotesSchema } from "./conversationSelection.js";
 import { ZCODE_AGENT_PROVIDER, ZCODE_AGENT_PROVIDER_LABEL } from "./zcode-agent-policy.js";
 import type {
   ZCodeConfigOption,
@@ -44,6 +47,8 @@ export const zcodeAutomationBotDeliveryTargetSchema = z
     botId: z.string().trim().min(1),
     providerUserId: z.string().trim().min(1),
     chatType: z.enum(["private", "group"]),
+    threadId: z.string().min(1).optional(),
+    rootMessageId: z.string().min(1).optional(),
   })
   .strict();
 
@@ -76,6 +81,10 @@ export interface BotWorkspaceRef {
   label: string;
   workspacePath: string;
   workspaceIdentity?: string;
+  /** 新版选择虚拟项目；旧协议字段名保留。空 roots 在提交时才分配 cwd。 */
+  projectId?: string;
+  hostId?: string;
+  rootPaths?: string[];
 }
 
 export interface BotAllowedCommands {
@@ -176,9 +185,14 @@ export interface BotsConfigFile {
 
 export interface BotState {
   botId: string;
+  group?: BotGroupSession;
   workspacePath: string;
   workspaceIdentity?: string;
   workspaceId?: string;
+  /** hostId 缺席表示旧状态待交接；明确 NULL 项目不会再次按目录归入。 */
+  projectId?: string | null;
+  hostId?: string;
+  additionalDirectories?: string[];
   mode: BotContextMode;
   activeTaskId: string | null;
   draftOptions?: BotDraftOptions;
@@ -187,11 +201,263 @@ export interface BotState {
   telegramOffset?: number;
   weixinGetUpdatesBuf?: string;
   weixinActivatedAt?: number;
+  /** 单聊绑定代际，阻止换绑后迟到事件恢复旧关联。 */
+  privateBindingId?: string;
+  /** iLink 登录返回机器人身份，单聊接收人来自已授权入站消息。 */
+  privateRecipientId?: string;
   updatedAt: number;
 }
 
 export type BotContextState = BotState;
 
+export const botGroupDeliverySchema = z
+  .object({
+    /** 名字解析前的请求指纹；重复调用只读原回执，不因目录变化改发给其他人。 */
+    channelReplyRequestHash: z
+      .string()
+      .regex(/^[a-f0-9]{64}$/u)
+      .optional(),
+    appId: z.string().optional(),
+    trace: zcodeProtocolTraceSchema.optional(),
+    authorizationId: z.string().optional(),
+    id: z.string().min(1),
+    taskId: z.string().min(1),
+    sourceCommandId: z.string().min(1).optional(),
+    text: z.string(),
+    replyToMessageId: z.string().optional(),
+    mentionedUserIds: z.array(z.string().min(1)).max(200).optional(),
+    contentParts: channelContentPartsSchema.optional(),
+    providerMessageId: z.string().optional(),
+    threadId: z.string().min(1).optional(),
+    rootMessageId: z.string().optional(),
+    status: z.enum(["pending", "sent", "failed", "unknown", "invalidated"]),
+    lastError: z.string().optional(),
+    updatedAt: z.number(),
+  })
+  .strict();
+export type BotGroupDelivery = z.infer<typeof botGroupDeliverySchema>;
+
+export const botGroupCardSchema = z
+  .object({
+    chatId: z.string().min(1),
+    threadId: z.string().min(1).optional(),
+    conversationThreadId: z.string().min(1).nullable().optional(),
+    taskId: z.string().nullable(),
+    authorizationId: z.string().min(1),
+  })
+  .strict();
+export type BotGroupCard = z.infer<typeof botGroupCardSchema>;
+
+export const botTopicMessageSchema = z
+  .object({
+    id: z.string().min(1),
+    chatId: z.string().min(1),
+    threadId: z.string().min(1),
+    senderId: z.string(),
+    senderName: z.string().optional(),
+    parentId: z.string().optional(),
+    attachments: z.array(z.object({ name: z.string(), kind: z.string() }).strict()).optional(),
+    senderType: z.enum(["user", "app"]),
+    text: z.string(),
+    createdAt: z.number(),
+    kind: z.string(),
+    controlCard: z.boolean().optional(),
+    deleted: z.boolean().optional(),
+  })
+  .strict();
+export type BotTopicMessage = z.infer<typeof botTopicMessageSchema>;
+
+export interface BotTopicHistoryRequest {
+  chatId: string;
+  threadId: string;
+  rootMessageId: string;
+  messageId: string;
+  checkpoint?: string;
+}
+
+export const botTopicContextSchema = z
+  .object({
+    messages: z.array(botTopicMessageSchema).max(201),
+    checkpoint: z.string().min(1),
+    hasGap: z.boolean(),
+  })
+  .strict();
+export type BotTopicHistoryBatch = z.infer<typeof botTopicContextSchema>;
+
+export const botIdentitySchema = z
+  .object({ name: z.string().min(1), openId: z.string().min(1).optional() })
+  .strict();
+export const botBackgroundHistorySchema = z
+  .object({ revision: z.string().min(1), checkpoint: z.string().min(1).optional() })
+  .strict();
+
+export const botAutoReplyGuardSchema = z
+  .object({
+    consecutive: z.number().int().min(0).max(5),
+    messageIds: z.array(z.string().min(1)),
+  })
+  .strict();
+
+export interface BotGroupSession {
+  preparation?: BotTopicPreparation[];
+  chatId: string;
+  chatMode?: "group" | "topic";
+  threadId?: string;
+  rootMessageId?: string;
+  topicTitle?: string;
+  topicUrl?: string;
+  /** 仅群默认记录拥有此配置；话题按群授权检查读取。 */
+  historyEnabled?: boolean;
+  /** 仅成功接收首次输入后接入；leave 后保留任务但停止普通消息触发。 */
+  topicActive?: boolean;
+  topicAliases?: Record<string, { taskId: string; rootMessageId: string }>;
+  name: string;
+  ownerId: string;
+  enabled: boolean;
+  taskIds: string[];
+  taskWorkspaces?: Record<string, { workspacePath: string; workspaceIdentity?: string }>;
+  currentOptions: BotCurrentOptions;
+  initiatorId?: string;
+  authorizationId?: string;
+  deliveries?: Record<string, BotGroupDelivery>;
+  autoReplyGuard?: z.infer<typeof botAutoReplyGuardSchema>;
+  backgroundHistory?: z.infer<typeof botBackgroundHistorySchema>;
+  inputs?: Record<
+    string,
+    {
+      taskId: string;
+      source: BotGroupInputSource;
+      admission?: "pending" | "accepted" | "rejected";
+      progress?: BotGroupInputProgress;
+    }
+  >;
+}
+
+export const botGroupInputStatusSchema = z.enum([
+  "waiting",
+  "working",
+  "done",
+  "failed",
+  "stopped",
+  "cancelled",
+  "discarded",
+]);
+export type BotGroupInputStatus = z.infer<typeof botGroupInputStatusSchema>;
+export const botTopicPreparationSchema = z
+  .object({
+    contentParts: channelContentPartsSchema.optional(),
+    messageId: z.string().min(1),
+    senderName: z.string(),
+    text: z.string(),
+    status: z.enum(["preparing", "waitingStop", "failed"]),
+    error: z.string().optional(),
+  })
+  .strict();
+export type BotTopicPreparation = z.infer<typeof botTopicPreparationSchema>;
+export const botGroupInputProgressSchema = z
+  .object({
+    status: botGroupInputStatusSchema,
+    interruptionReason: z.literal("newMessage").optional(),
+    cardMessageId: z.string().min(1).optional(),
+    cardStatus: botGroupInputStatusSchema.optional(),
+  })
+  .strict();
+export type BotGroupInputProgress = z.infer<typeof botGroupInputProgressSchema>;
+
+/** CLI 只接收轻量材料索引；原文留在 Host 归档及文本附件。 */
+export const botTopicHistorySourceSchema = z
+  .object({
+    checkpoint: z.string().min(1).max(256),
+    hasGap: z.boolean(),
+    messageCount: z.number().int().min(0).max(201),
+    resourceMessages: z
+      .array(
+        z
+          .object({
+            messageId: z.string().min(1).max(256),
+            count: z.number().int().min(1).max(1000),
+          })
+          .strict(),
+      )
+      .max(201),
+  })
+  .strict();
+
+export const botTopicInputMessageSchema = z
+  .object({
+    contentParts: channelContentPartsSchema.optional(),
+    messageId: z.string().min(1),
+    senderId: z.string().min(1),
+    senderName: z.string(),
+    mentionedBot: z.boolean().optional(),
+    text: z.string(),
+    conversationQuotes: conversationQuotesSchema.optional(),
+    attachmentIndexes: z.array(z.number().int().nonnegative()),
+  })
+  .strict();
+
+/** 可信 Host 注入的输入来源；身份展示不能反向授予执行权限。 */
+export const botGroupInputSourceSchema = z
+  .object({
+    botIdentity: botIdentitySchema.optional(),
+    appId: z.string().min(1).optional(),
+    contentParts: channelContentPartsSchema.optional(),
+    authorizationId: z.string().min(1).optional(),
+    botId: z.string().min(1),
+    provider: z.enum(["feishu", "lark"]),
+    chatId: z.string().min(1),
+    threadId: z.string().min(1).optional(),
+    rootMessageId: z.string().optional(),
+    senderId: z.string().min(1),
+    senderName: z.string(),
+    mentionedBot: z.boolean().optional(),
+    messageId: z.string().min(1),
+    messages: z.array(botTopicInputMessageSchema).min(1).max(200).optional(),
+    topicContext: botTopicContextSchema.optional(),
+    topicHistory: botTopicHistorySourceSchema.optional(),
+  })
+  .strict()
+  .superRefine((source, ctx) => {
+    if (
+      source.messages &&
+      (!source.threadId ||
+        source.messages.at(-1)?.messageId !== source.messageId ||
+        new Set(source.messages.map((message) => message.messageId)).size !==
+          source.messages.length)
+    ) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["messages"],
+        message: "Topic batch boundary mismatch",
+      });
+    }
+
+    if (
+      source.topicHistory &&
+      (!source.threadId || source.topicHistory.checkpoint !== source.messageId)
+    ) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["topicHistory"],
+        message: "Topic history scope mismatch",
+      });
+    }
+    if (
+      source.topicContext &&
+      (!source.threadId ||
+        source.topicContext.checkpoint !== source.messageId ||
+        source.topicContext.messages.some(
+          (m) => m.chatId !== source.chatId || m.threadId !== source.threadId,
+        ))
+    )
+      ctx.addIssue({
+        code: "custom",
+        path: ["topicContext"],
+        message: "Topic context scope mismatch",
+      });
+  });
+export type BotGroupInputSource = z.infer<typeof botGroupInputSourceSchema>;
+
 export interface BotsStateFile {
   version: 3;
   bots: Record<string, BotState>;
@@ -200,6 +466,8 @@ export interface BotsStateFile {
 export interface BotRuntimeInfo {
   /** 最近一次消息投递错误；独立于长连接状态，成功投递后清除。 */
   deliveryError?: string;
+  /** 当前进程保留的失败单聊回复；显式重试可能重复此前已收到的内容。 */
+  deliveryRetryId?: string;
   botId: string;
   provider: BotProvider;
   status: "disabled" | "idle" | "polling" | "connected" | "error";
@@ -210,12 +478,20 @@ export interface BotRuntimeInfo {
 }
 
 export interface BotActor {
+  /** 本次可信输入是否明确提及机器人；用于话题回复提醒。 */
+  mentionedBot?: boolean;
   provider: BotProvider;
   botId: string;
   providerUserId: string;
   displayName?: string;
   chatType: "private" | "group";
   chatId?: string;
+  threadId?: string;
+  /** 仅服务根据已保存的结果关联设置；null 表示原群默认任务。 */
+  conversationThreadId?: string | null;
+  rootMessageId?: string;
+  topicTitle?: string;
+  topicUrl?: string;
   providerMessageId?: string;
   providerContextToken?: string;
 }
@@ -236,6 +512,10 @@ export interface BotInboundAttachment {
 }
 
 export type BotCommand =
+  | { type: "group.history"; enabled?: boolean }
+  | { type: "queue.cancel"; commandId: string }
+  | { type: "group.enable" }
+  | { type: "group.disable" }
   | { type: "bind"; code: string }
   | { type: "help" }
   | { type: "status" }
@@ -255,6 +535,7 @@ export type BotCommand =
   | { type: "reply.list" }
   | { type: "reply.set"; value: string }
   | { type: "stop" }
+  | { type: "topic.leave" }
   | { type: "permission.respond"; value: string }
   | { type: "elicitation.respond"; value: string }
   | { type: "elicitation.submit" }
@@ -272,6 +553,7 @@ export interface SelectionPrompt {
   cancelLabel?: string;
   showCancel?: boolean;
   action:
+    | "queue.cancel"
     | "workspace.set"
     | "model.provider.set"
     | "model.set"
@@ -289,6 +571,23 @@ export interface SelectionPrompt {
 }
 
 export interface BotInboundMessage {
+  /** 仅供命令/纯唤醒识别；原文 text 和 contentParts 保持完整。 */
+  commandText?: string;
+  /** Provider 核验的当前机器人身份，不从正文推断。 */
+  botOpenId?: string;
+  /** Provider 校验的发送者类型；机器人正文不具有控制命令权限。 */
+  senderType?: "user" | "app";
+  contentParts?: ChannelContentPart[];
+  /** 由 Provider 根据真实 mention 身份设置；不是正文解析结果。 */
+  mentionedBot?: boolean;
+  /** 原生根消息经 Provider 核验确为当前机器人发送。 */
+  topicRootIsCurrentBot?: boolean;
+  /** 可信 Provider 校验后的明确引用，不参与控制命令解析。 */
+  referencedMessage?: import("./conversationSelection.js").ConversationSelectionText & {
+    messageId: string;
+  };
+  groupCard?: BotGroupCard;
+  groupCardAction?: boolean;
   botId: string;
   actor: BotActor;
   text: string;
@@ -298,6 +597,12 @@ export interface BotInboundMessage {
 }
 
 export interface BotOutboundMessage {
+  trace?: ZCodeProtocolTrace;
+  contentParts?: ChannelContentPart[];
+  groupCard?: BotGroupCard;
+  threadId?: string;
+  conversationThreadId?: string | null;
+  rootMessageId?: string;
   botId: string;
   provider: BotProvider;
   providerUserId: string;
@@ -306,6 +611,18 @@ export interface BotOutboundMessage {
   selection?: SelectionPrompt;
   elicitation?: BotOutboundElicitationRequest;
   providerContextToken?: string;
+  /** 无权限/过期回调只能提示操作者，不能覆盖群共享卡片。 */
+  callbackToastOnly?: boolean;
+  /** 管理员待办独立通知，不允许用拒绝提示覆盖共享卡片。 */
+  administratorAttention?: boolean;
+  replyToMessageId?: string;
+  /** 可信输入决定的提醒对象；只作展示，不授予群操作权限。 */
+  mentionedUserIds?: string[];
+  deliveryId?: string;
+  /** 任务回推需在实际发送前重新验证群当前关联。控制命令回复不携带。 */
+  groupTaskId?: string;
+  /** 可信任务事件中的输入命令，用于将投递状态定位到对应回复。 */
+  groupSourceCommandId?: string;
 }
 
 export interface BotTaskSummary {
@@ -395,6 +712,13 @@ export const botAllowedCommandsSchema = z
 
 export const botCommandPolicySchema = botAllowedCommandsSchema;
 
+// 修复原因：第三方 CLI provider 已移除，ZCodeProvider 只剩 glm，但旧 bot 配置与状态文件里可能仍存有
+// 已移除 provider 的历史值。改成严格 literal 会让整份文件 parse 失败、Bot 全部不可用；
+// 因此解析时继续接受这些历史值，并统一归一到当前唯一的 agent provider。
+const legacyBotAgentProviderSchema = z
+  .enum(["codex", "claude", "opencode", "gemini", "glm"])
+  .transform((): typeof ZCODE_AGENT_PROVIDER => ZCODE_AGENT_PROVIDER);
+
 export const botCurrentOptionsSchema = z
   .object({
     modelSelection: modelSelectionSchema.optional(),
@@ -402,13 +726,13 @@ export const botCurrentOptionsSchema = z
     sandboxMode: z.string().min(1).optional(),
     approvalPolicy: z.string().min(1).optional(),
     // 兼容旧 bot-config.json；CLI provider 现在统一由 ZCode Protocol 侧配置决定。
-    cli: z.literal(ZCODE_AGENT_PROVIDER).optional(),
+    cli: legacyBotAgentProviderSchema.optional(),
   })
   .strict();
 
 export const botDraftOptionsSchema = z
   .object({
-    provider: z.literal(ZCODE_AGENT_PROVIDER),
+    provider: legacyBotAgentProviderSchema,
     modelSelection: modelSelectionSchema.optional(),
     mode: z.string().min(1).optional(),
   })
@@ -492,9 +816,66 @@ export const botsStateFileSchema = z
       z.string(),
       z.object({
         botId: z.string().min(1),
+        group: z
+          .object({
+            chatId: z.string().trim().min(1),
+            chatMode: z.enum(["group", "topic"]).optional(),
+            threadId: z.string().trim().min(1).optional(),
+            rootMessageId: z.string().min(1).optional(),
+            topicTitle: z.string().optional(),
+            topicUrl: z.string().url().optional(),
+            historyEnabled: z.boolean().optional(),
+            topicActive: z.boolean().optional(),
+            preparation: z.array(botTopicPreparationSchema).optional(),
+            topicAliases: z
+              .record(
+                z.string(),
+                z.object({ taskId: z.string().min(1), rootMessageId: z.string().min(1) }).strict(),
+              )
+              .optional(),
+            name: z.string(),
+            ownerId: z.string().min(1),
+            enabled: z.boolean(),
+            taskIds: z.array(z.string().min(1)),
+            taskWorkspaces: z
+              .record(
+                z.string(),
+                z
+                  .object({
+                    workspacePath: z.string().min(1),
+                    workspaceIdentity: z.string().optional(),
+                  })
+                  .strict(),
+              )
+              .optional(),
+            currentOptions: botCurrentOptionsSchema,
+            initiatorId: z.string().optional(),
+            authorizationId: z.string().optional(),
+            deliveries: z.record(z.string(), botGroupDeliverySchema).optional(),
+            autoReplyGuard: botAutoReplyGuardSchema.optional(),
+            backgroundHistory: botBackgroundHistorySchema.optional(),
+            inputs: z
+              .record(
+                z.string(),
+                z
+                  .object({
+                    taskId: z.string().min(1),
+                    source: botGroupInputSourceSchema,
+                    admission: z.enum(["pending", "accepted", "rejected"]).optional(),
+                    progress: botGroupInputProgressSchema.optional(),
+                  })
+                  .strict(),
+              )
+              .optional(),
+          })
+          .strict()
+          .optional(),
         workspacePath: z.string().min(1),
         workspaceIdentity: z.string().min(1).optional(),
         workspaceId: z.string().min(1).optional(),
+        projectId: z.string().min(1).nullable().optional(),
+        hostId: z.string().min(1).optional(),
+        additionalDirectories: z.array(z.string().min(1)).max(256).optional(),
         mode: z.enum(["draft", "task"]),
         activeTaskId: z.string().min(1).nullable(),
         draftOptions: botDraftOptionsSchema.optional(),
@@ -514,6 +895,8 @@ export const botsStateFileSchema = z
         telegramOffset: z.number().optional(),
         weixinGetUpdatesBuf: z.string().optional(),
         weixinActivatedAt: z.number().optional(),
+        privateBindingId: z.string().min(1).optional(),
+        privateRecipientId: z.string().min(1).optional(),
         updatedAt: z.number(),
       }),
     ),

package/server/vendor/zcode/packages/shared/src/browser-use/commands.ts

@@ -578,7 +578,9 @@ export const browserCommandSchema = z.discriminatedUnion("method", [
     })
     .strict(),
   z.object({ method: z.literal("turnEnded"), turnId: z.string().min(1).optional() }).strict(),
-  z.object({ method: z.literal("closeSession") }).strict(),
+  // closeTabs：连同该 session 名下的 tab 一起关（含已释放回该 session 的）。只给永不回来认领的
+  // session 用——dwf 子代理（docs/browser-use/2026-07-14-browser-tab-conversation-isolation-spec.md §2.3）。
+  z.object({ method: z.literal("closeSession"), closeTabs: z.boolean().optional() }).strict(),
   z.object({ method: z.literal("cancelRequest"), requestId: z.string().min(1) }).strict(),
   // close：关闭指定受控 tab（tabId 缺省=当前 tab）。manager 层处理：detach + 通知 renderer 卸载 webview。
   z.object({ method: z.literal("close"), tabId: z.string().optional() }).strict(),

package/server/vendor/zcode/packages/shared/src/channel-mention.ts

@@ -0,0 +1,131 @@
+import { zcodeProtocolTraceSchema } from "./zcode-protocol/trace.js";
+import { z } from "zod";
+
+export const channelMentionSchema = z
+  .object({
+    type: z.literal("channelMention"),
+    refId: z.string().min(1).max(200),
+    name: z.string().min(1).max(200),
+    channel: z.enum(["feishu", "lark"]),
+    targetId: z
+      .string()
+      .max(128)
+      .regex(/^ou_[a-zA-Z0-9_-]+$/u),
+    idType: z.literal("open_id"),
+    entityType: z.enum(["user", "bot", "unknown"]),
+  })
+  .strict();
+export const channelContentPartSchema = z.union([
+  z.object({ type: z.literal("text"), text: z.string().max(100_000) }).strict(),
+  channelMentionSchema,
+]);
+export const channelContentPartsSchema = z.array(channelContentPartSchema).max(200);
+export type ChannelContentPart = z.infer<typeof channelContentPartSchema>;
+export const channelReplyPartsSchema = z
+  .array(
+    z.union([
+      z.object({ type: z.literal("text"), text: z.string().max(2000) }).strict(),
+      z.object({ type: z.literal("mention"), refId: z.string().min(1).max(200) }).strict(),
+      z
+        .object({
+          type: z.literal("mentionName"),
+          name: z.string().trim().min(1).max(200),
+          candidateRef: z.string().min(1).max(200).optional(),
+        })
+        .strict(),
+    ]),
+  )
+  .min(1)
+  .max(50);
+export const channelReplyRequestSchema = z
+  .object({
+    taskId: z.string().min(1),
+    inputId: z.string().min(1),
+    authorizationId: z.string().min(1).optional(),
+    toolCallId: z.string().min(1),
+    parts: channelReplyPartsSchema,
+  })
+  .strict();
+const channelDeliveryResultSchema = z
+  .object({
+    status: z.enum(["sent", "failed", "unknown", "invalidated"]),
+    deliveryId: z.string(),
+    providerMessageId: z.string().optional(),
+    error: z.string().optional(),
+  })
+  .strict();
+export const channelMentionClarificationSchema = z
+  .object({
+    status: z.literal("needs_clarification"),
+    unresolved: z
+      .array(
+        z
+          .object({
+            name: z.string().max(200),
+            reason: z.enum(["ambiguous", "not_found", "unavailable", "selection_expired"]),
+            candidates: z
+              .array(
+                z
+                  .object({
+                    ref: z.string().max(200),
+                    name: z.string().max(200),
+                    label: z.string().max(250),
+                    kind: z.enum(["user", "bot", "unknown"]),
+                  })
+                  .strict(),
+              )
+              .max(10),
+            truncated: z.boolean(),
+          })
+          .strict(),
+      )
+      .min(1)
+      .max(50),
+  })
+  .strict();
+export const channelReplyResultSchema = z.union([
+  channelDeliveryResultSchema,
+  channelMentionClarificationSchema,
+]);
+export type ChannelReplyRequest = z.infer<typeof channelReplyRequestSchema>;
+export type ChannelReplyResult = z.infer<typeof channelReplyResultSchema>;
+export function channelContentText(parts: readonly ChannelContentPart[]): string {
+  return parts.map((part) => (part.type === "text" ? part.text : `@${part.name}`)).join("");
+}
+/** 只从 Host 已验证的会话输入解析 ref；模型不得直接提供平台 ID。 */
+export function resolveChannelReplyParts(
+  parts: z.infer<typeof channelReplyPartsSchema>,
+  source: readonly ChannelContentPart[],
+): ChannelContentPart[] {
+  const targets = new Map<string, z.infer<typeof channelMentionSchema>>();
+  for (const part of source) {
+    if (part.type !== "channelMention") continue;
+    const target = channelMentionSchema.parse(part);
+    const previous = targets.get(target.refId);
+    if (previous && JSON.stringify(previous) !== JSON.stringify(target))
+      throw new Error("Conflicting channel mention reference");
+    targets.set(target.refId, target);
+  }
+  channelReplyPartsSchema.parse(parts);
+  const resolved = parts.map((part) => {
+    if (part.type === "text") return part;
+    if (part.type === "mentionName")
+      throw new Error("Channel mention name must be resolved by Host");
+    const target = targets.get(part.refId);
+    if (!target) throw new Error("Unknown channel mention reference");
+    return target;
+  });
+  if (!channelContentText(resolved).trim() || channelContentText(resolved).length > 2000)
+    throw new Error("Channel reply must contain 1–2000 characters");
+  return resolved;
+}
+
+export const channelReplyHostRequestSchema = channelReplyRequestSchema
+  .extend({
+    trace: zcodeProtocolTraceSchema.optional(),
+    workspacePath: z.string().min(1),
+    workspaceIdentity: z.string().optional(),
+    remoteSessionId: z.string().optional(),
+  })
+  .strict();
+export type ChannelReplyHostRequest = z.infer<typeof channelReplyHostRequestSchema>;

package/server/vendor/zcode/packages/shared/src/conversationSelection.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+export const CONVERSATION_SELECTION_MAX_TEXT_LENGTH = 8_000;
+export const CONVERSATION_SELECTION_MAX_COUNT = 8;
+export const CONVERSATION_SELECTION_MAX_TOTAL_LENGTH = 16_000;
+
+export const conversationQuoteSchema = z.object({
+  text: z.string().max(CONVERSATION_SELECTION_MAX_TEXT_LENGTH),
+  path: z.string().optional(),
+  senderName: z.string().optional(),
+  senderId: z.string().optional(),
+  messageId: z.string().optional(),
+  sentAt: z.string().datetime({ offset: true }).optional(),
+});
+export const conversationQuotesSchema = z
+  .array(conversationQuoteSchema)
+  .max(CONVERSATION_SELECTION_MAX_COUNT)
+  .refine(
+    (quotes) =>
+      quotes.reduce((sum, quote) => sum + quote.text.length, 0) <=
+      CONVERSATION_SELECTION_MAX_TOTAL_LENGTH,
+  );
+export type ConversationSelectionText = z.infer<typeof conversationQuoteSchema>;
+
+export function buildPromptWithConversationSelections(
+  visibleContent: string,
+  references: readonly ConversationSelectionText[],
+): string {
+  if (references.length === 0) return visibleContent;
+  // 文件选段曾只发正文，导致模型与历史丢失文件来源；只保留路径，不发送内部身份字段。
+  const block = [
+    "# userselect:",
+    "```userselect",
+    JSON.stringify(references.map(({ text, path }) => (path?.trim() ? { path, text } : { text }))),
+    "```",
+  ].join("\n");
+  return visibleContent ? `${visibleContent}\n\n${block}` : block;
+}