@tencent-ai/agent-sdk 0.3.263-dev.90f0e98.202609190050 → 0.3.263

package/cli/dist-server/types/node/agent-home/agent-home-channel-context.d.ts

@@ -1,44 +0,0 @@
-/** 频道上下文解析（只读免锁）：工具与 HTTP 共用「读目录 → 认自己 → 找频道 → 列成员」，只给结构化错误码。 */
-import { type AgentHomeChannel, type AgentHomeDirectoryFile, type AgentHomeProfile } from './agent-home-directory';
-export type AgentHomeChannelContextError = 'DIRECTORY_UNAVAILABLE' | 'INVALID_ACTOR' | 'CHANNEL_NOT_FOUND' | 'CHANNEL_NEED_ID';
-export interface AgentHomeSelfContext {
-    directory: AgentHomeDirectoryFile;
-    self: AgentHomeProfile;
-}
-export type ResolveAgentHomeSelfResult = {
-    ok: true;
-    context: AgentHomeSelfContext;
-} | {
-    ok: false;
-    error: 'DIRECTORY_UNAVAILABLE' | 'INVALID_ACTOR';
-};
-export interface ResolveAgentHomeChannelContextInput {
-    homeDir: string;
-    jobId?: string;
-    /** 频道 id；不传 = 唯一频道。 */
-    channelRef?: string;
-    /** 调用方已读过目录时传入，省一次读盘（必须是同一 homeDir 的最新快照）。 */
-    directory?: AgentHomeDirectoryFile;
-}
-export type ResolveAgentHomeChannelContextResult = {
-    ok: true;
-    directory: AgentHomeDirectoryFile;
-    self: AgentHomeProfile;
-    channel: AgentHomeChannel;
-    members: AgentHomeProfile[];
-    /** 自己可见的全部频道（错误提示与「你在哪几个频道」用）。 */
-    channels: AgentHomeChannel[];
-} | {
-    ok: false;
-    error: AgentHomeChannelContextError;
-    channels: AgentHomeChannel[];
-};
-/** 认自己：没有 job 映射就是默认 Agent；目录读不到 / 认不出都是错误。 */
-export declare function resolveAgentHomeSelfContext(input: {
-    homeDir: string;
-    jobId?: string;
-    directory?: AgentHomeDirectoryFile;
-}): Promise<ResolveAgentHomeSelfResult>;
-export declare function membersOfChannel(directory: AgentHomeDirectoryFile, channel: AgentHomeChannel): AgentHomeProfile[];
-/** 认自己 + 在自己可见的频道里找 channelRef。 */
-export declare function resolveAgentHomeChannelContext(input: ResolveAgentHomeChannelContextInput): Promise<ResolveAgentHomeChannelContextResult>;

package/cli/dist-server/types/node/agent-home/agent-home-channel-create.d.ts

@@ -1,73 +0,0 @@
-/**
- * 自治建频道 / 拉人：成员解析（id）、配额、lead、provenance、审计。
- *
- * 成员资格（与组队同一条，见 agent-home-membership）：**只有常驻同事能进**。
- * 主 Agent 是委托侧的工作现场（随进程生灭、上下文是用户私有的现场），它**建频道、
- * 派单、读板、发言**都可以，但**不进成员表**——所以"创建者自动进频道"对主 Agent 不成立，
- * lead 也就不能缺省给创建者：缺省给"第一个成员同事"。invite 同上（主 Agent 加不进来）。
- */
-import { type AgentHomeChannel, type AgentHomeDirectoryFile, type AgentHomeProfile } from './agent-home-directory';
-import type { AgentHomeCreateErrorCode } from './agent-home-errors';
-type MemberResolution = {
-    ok: true;
-    profiles: AgentHomeProfile[];
-} | {
-    ok: false;
-    error: 'MEMBER_NOT_FOUND';
-};
-/**
- * 成员引用一律是 **id**（对齐上游：`createGroup` / `setGroupMembers` 只吃 memberIds，
- * `SendToAgent` 的 target_id 文档原话就是 "not a name"）。显示名不是地址——名字只用于
- * 正文里的 @ 点名（撞名时同名的人全部叫上，见 agent-home-mentions）。
- * `only` 限定候选集（例：任务指派只能落在频道成员里）。
- */
-export declare function resolveMemberRefs(directory: AgentHomeDirectoryFile, refs: readonly string[], options?: {
-    only?: ReadonlySet<string>;
-}): MemberResolution;
-export interface CreateChannelInput {
-    homeDir: string;
-    /** 发起者 agentId（工具必有；用户经 HTTP 建频道走 controller，不经过这里）。 */
-    creatorAgentId: string;
-    name?: string;
-    memberRefs: readonly string[];
-    /** lead 引用（id）；缺省 = 创建者。 */
-    leadRef?: string;
-    now?: number;
-}
-export type CreateChannelResult = {
-    ok: true;
-    channel: AgentHomeChannel;
-    members: AgentHomeProfile[];
-    directory: AgentHomeDirectoryFile;
-    /** 同一批人的频道已存在，直接复用了它（没有新建）。 */
-    reused?: boolean;
-} | {
-    ok: false;
-    error: AgentHomeCreateErrorCode;
-};
-/**
- * trim + 去重（保序）。成员名单 / @ 名单 / mention 列表都从它走——
- * 原先 speech 与 HTTP 各写一份，空串与重复的边界容易只在一侧处理。
- */
-export declare function uniqueTrimmed(ids: readonly string[]): string[];
-/** 成员集合是否相同（顺序无关；上游 isSameMemberSet）。HTTP 侧复用同一份。 */
-export declare function isSameMemberSet(a: readonly string[], b: readonly string[]): boolean;
-export declare function createAgentHomeChannel(input: CreateChannelInput): Promise<CreateChannelResult>;
-export interface InviteToChannelInput {
-    homeDir: string;
-    channelId: string;
-    actorAgentId: string;
-    memberRefs: readonly string[];
-    now?: number;
-}
-export type InviteToChannelResult = {
-    ok: true;
-    channel: AgentHomeChannel;
-    added: AgentHomeProfile[];
-    directory: AgentHomeDirectoryFile;
-} | {
-    ok: false;
-    error: AgentHomeCreateErrorCode;
-};
-export declare function inviteAgentHomeChannelMembers(input: InviteToChannelInput): Promise<InviteToChannelResult>;
-export {};

package/cli/dist-server/types/node/agent-home/agent-home-channel-events.d.ts

@@ -1,8 +0,0 @@
-/**
- * 频道 jsonl 落盘后的进程内通知。
- * SSE 不能只靠 macOS fs.watch：append 经常丢，客户端还要等切走才重新 GET。
- */
-type ChannelChangedListener = (channelId: string) => void;
-export declare function notifyAgentHomeChannelChanged(channelId: string): void;
-export declare function onAgentHomeChannelChanged(listener: ChannelChangedListener): () => void;
-export {};

package/cli/dist-server/types/node/agent-home/agent-home-channel-lookup.d.ts

@@ -1,30 +0,0 @@
-/**
- * 频道寻址：id 分配 / 查找 / 默认命名。
- *
- * 从 agent-home-directory 拆出。规则对齐上游（group 只按 id 找，`ListGroups` 给的就是 id）：
- * **找频道只认 id**；名字只是给人看的标签（重名允许，默认名顺手避开「群聊」纯粹为了侧栏好认）。
- * 本模块 → directory 只 import type。
- */
-import type { AgentHomeChannel, AgentHomeDirectoryFile } from './agent-home-directory';
-/** 人 / 房 / 频道共用的 id 集合，分配频道 id 时避开，避免串台。 */
-export declare function takenHomeIds(directory: AgentHomeDirectoryFile): Set<string>;
-/** 新频道的主键。UUID，且不与已有人/房/频道 id 碰撞。 */
-export declare function allocateUniqueChannelId(directory: AgentHomeDirectoryFile): string;
-export type ChannelLookup = {
-    status: 'ok';
-    channel: AgentHomeChannel;
-} | {
-    status: 'missing';
-} | {
-    status: 'need-id';
-};
-/**
- * 频道查找：只认 id（对齐上游：group 按 id 寻址）。
- * 没传 needle 且只有一间 → 那一间；多间 → need-id（让调用方去 ListColleagues 抄 id）。
- */
-export declare function lookupChannel(channels: readonly AgentHomeChannel[], wanted?: string): ChannelLookup;
-export declare function formatChannelChoice(channels: readonly AgentHomeChannel[]): string;
-/** 没起名时的标签。不是主键；重名允许，新建默认避开已有「群聊」纯粹为了列表好认。 */
-export declare function nextDefaultChannelName(existing: readonly {
-    name: string;
-}[]): string;

package/cli/dist-server/types/node/agent-home/agent-home-channel-speech.d.ts

@@ -1,72 +0,0 @@
-/**
- * 频道发言落盘：jsonl append + directory lastPreview/unread。
- * POST /channels/:id/messages 和 SpeakInChannel 共用。写 directory 必须带锁。
- */
-import { type ChannelAttachment } from './agent-home-attachments';
-import { type AgentHomeChannel, type AgentHomeChannelMessage, type AgentHomeDirectoryFile } from './agent-home-directory';
-export interface ApplyChannelSpeechInput {
-    homeDir: string;
-    channelId: string;
-    text: string;
-    from: 'user' | 'agent';
-    agentId?: string;
-    /** 锁内再 resolve 一次，避免解锁读到的 self 已过期。 */
-    jobId?: string;
-    mentionAgentIds?: readonly string[];
-    messageId?: string;
-    /**
-     * 显式开一轮房间轮次（对齐上游的「用户发言开一轮」）。
-     * 用户发言自动算；CreateChannel 的 kickoff 用这个标记显式开一轮。
-     */
-    startRoomTurn?: boolean;
-    /**
-     * 引用某条消息（对齐上游 SendMessage 的 reply_to）：
-     * 房间历史里的短地址（#xxxxxxxx）或消息 id，前缀唯一即可。
-     */
-    replyTo?: string;
-    /**
-     * 附件（对齐上游 SendMessage 的 type:attachment）：本地文件路径。
-     * 会复制进频道附件目录（内容寻址），房间据此长期可见。
-     */
-    attachments?: readonly string[];
-    /**
-     * 选项卡卡片（对齐上游 type:widget）。给了它就把这条消息发成卡片：
-     * 正文用 prompt，且**本轮发言到此为止**——等用户点选（点选会作为
-     * 用户发言开新一轮）。
-     */
-    widget?: unknown;
-}
-/** 附件收了之后的账：收进来的 + 没收成的（原因逐条转告模型）。 */
-interface IngestedAttachments {
-    attachments: ChannelAttachment[];
-    issues: string[];
-}
-export type ApplyChannelSpeechResult = {
-    ok: true;
-    message: AgentHomeChannelMessage;
-    channel: AgentHomeChannel;
-    directory: AgentHomeDirectoryFile;
-    /** 这次发言是否推进/开启了房间轮次（false = 没推进：插话/发卡片/不在编排里）。 */
-    advancedTurn: boolean;
-    /** 给了 replyTo 但地址解析不到（已按普通消息落盘，调用方可以提醒模型）。 */
-    replyToDropped?: boolean;
-    /** 附件没收进来的原因（超限/读不到/不是文件），逐条转告模型。 */
-    attachmentIssues?: string[];
-    /** 卡片不合法（没有正确落盘），原因原样转告模型。 */
-    widgetIssue?: string;
-} | {
-    ok: false;
-    error: 'CHANNEL_NOT_FOUND' | 'INVALID_SPEAKER' | 'DIRECTORY_UNAVAILABLE' | 'INVALID_WIDGET' | 'EMPTY_TEXT';
-    /** INVALID_WIDGET 时给出人话原因，工具会原样转告模型。 */
-    reason?: string;
-};
-export declare function applyChannelSpeech(input: ApplyChannelSpeechInput): Promise<ApplyChannelSpeechResult>;
-/**
- * 调用方已持有 withAgentHomeDirectoryLock。
- * `preIngested`：锁外已经收好的附件（见 applyChannelSpeech）；不传则锁内现收
- * （已持锁的调用方——用户 HTTP 路径不带附件，走不到这条）。
- */
-export declare function applyChannelSpeechToDirectory(directory: AgentHomeDirectoryFile, input: ApplyChannelSpeechInput, options?: {
-    preIngested?: IngestedAttachments;
-}): Promise<ApplyChannelSpeechResult>;
-export {};

package/cli/dist-server/types/node/agent-home/agent-home-channel-task-events.d.ts

@@ -1,45 +0,0 @@
-/**
- * 频道任务板的组合层：锁 → 读板 → 纯函数 mutate → 写板 → transcript 投影 → 算唤醒目标。
- *
- * 纪律：
- * - 板写必须在 withAgentHomeDirectoryLock 内；
- * - transcript 是投影不是真理：事件行写失败不回滚板；
- * - 唤醒永远在锁外（本模块只返回 wakeAgentIds / wakeText，调用方解锁后再叫）。
- */
-import { type AgentHomeChannelTask, type AgentHomeChannelTaskActor, type AgentHomeChannelTaskBoard, type ChannelTaskAction, type ChannelTaskEvent } from './agent-home-channel-tasks';
-import { type AgentHomeChannel, type AgentHomeDirectoryFile } from './agent-home-directory';
-import type { ChannelTaskErrorCode } from './agent-home-errors';
-export interface ApplyChannelTaskInput {
-    homeDir: string;
-    channelId: string;
-    actor: AgentHomeChannelTaskActor;
-    action: ChannelTaskAction;
-    now?: number;
-}
-export type ApplyChannelTaskResult = {
-    ok: true;
-    tasks: AgentHomeChannelTask[];
-    events: ChannelTaskEvent[];
-    /** 板已扣预算的唤醒目标（解锁后由调用方叫）。 */
-    wakeAgentIds: string[];
-    /** 给被叫醒的人看的一行摘要。 */
-    wakeText: string;
-    directory: AgentHomeDirectoryFile;
-    channel: AgentHomeChannel;
-} | {
-    ok: false;
-    error: ChannelTaskErrorCode;
-};
-/** 免锁读板 + 频道（GET / SSE 语义）。 */
-export declare function readChannelTaskBoard(input: {
-    homeDir: string;
-    channelId: string;
-}): Promise<{
-    ok: true;
-    board: AgentHomeChannelTaskBoard;
-    channel: AgentHomeChannel;
-} | {
-    ok: false;
-    error: ChannelTaskErrorCode;
-}>;
-export declare function applyChannelTaskEvent(input: ApplyChannelTaskInput): Promise<ApplyChannelTaskResult>;

package/cli/dist-server/types/node/agent-home/agent-home-channel-task-order.d.ts

@@ -1,25 +0,0 @@
-/**
- * 任务板的**分组色调 + 组内顺序**：node 域与 web-ui 共用这一份。
- *
- * 两侧各写一份曾经漂过：done 组一边按 doneAt 排、一边按 updatedAt 排，而拖拽重排的
- * 目标位次是前端按自己那份算、服务端按自己那份算的（两份必须逐字一致才成立）。
- *
- * 零 import：它会被 web-ui 直接引用（见 agent-home-web-ui-shared-imports.spec.ts），
- * 别在这里引 node 侧模块。
- */
-/** 排序只关心这几个字段；node 的 AgentHomeChannelTask 与 web-ui 的 DTO 都结构化兼容。 */
-export interface ChannelTaskOrderFields {
-    status: 'open' | 'claimed' | 'done';
-    stalled?: boolean;
-    sortIndex?: number;
-    updatedAt: number;
-    doneAt?: number;
-}
-export type ChannelTaskTone = 'stalled' | 'claimed' | 'open' | 'done';
-export declare function channelTaskTone(task: ChannelTaskOrderFields): ChannelTaskTone;
-/**
- * 组内顺序：手工顺序（`sortIndex` 升序）在前，没设过的按最近活动倒序跟在后面
- * （已完成的看完成时间，其余看更新时间）。
- * 新任务建的时候会拿到一个比全板都小的 `sortIndex`，于是落在自己那组的顶上。
- */
-export declare function compareChannelTasks(a: ChannelTaskOrderFields, b: ChannelTaskOrderFields): number;

package/cli/dist-server/types/node/agent-home/agent-home-channel-tasks.d.ts

@@ -1,156 +0,0 @@
-/**
- * 频道任务板（黑板）：类型 + 落盘 IO + 纯函数 mutateBoard（领域层，无文案/HTTP/唤醒）。
- * 单写者纪律是产品语义：claim 走 CAS、只有 owner 能 complete/release、done 不可变、
- * 唤醒预算按「任务 × 人」计（超限标 stalled 停叫）。
- */
-import type { AgentHomeChannelTaskEventPayload } from './agent-home-channel-task-event';
-import type { ChannelTaskErrorCode } from './agent-home-errors';
-export { channelTaskTone, compareChannelTasks } from './agent-home-channel-task-order';
-export type AgentHomeChannelTaskStatus = 'open' | 'claimed' | 'done';
-export interface AgentHomeChannelTaskRef {
-    kind: 'issue' | 'file' | 'pr' | 'commit' | 'url';
-    value: string;
-}
-/** kind 的运行时白名单（类型只管编译期；盘上手改/旧数据可能是任意串）。HTTP 与 domain 共用这一份。 */
-export declare const TASK_REF_KINDS: ReadonlySet<string>;
-export interface AgentHomeChannelTask {
-    id: string;
-    subject: string;
-    detail?: string;
-    status: AgentHomeChannelTaskStatus;
-    ownerId?: string;
-    /** dispatch 指定的接收人：只有本人能 claim。 */
-    assigneeId?: string;
-    refs?: AgentHomeChannelTaskRef[];
-    /**
-     * 手工顺序（拖拽排序）。只在**同一个色调分组内**比较：小的在前；
-     * 没设过的手工顺序（老数据 / 新任务的旧写法）排在最后，按 updatedAt 倒序。
-     */
-    sortIndex?: number;
-    /** create / dispatch 的幂等键。 */
-    requestId?: string;
-    createdBy: 'user' | 'agent';
-    creatorAgentId?: string;
-    /** 每人对本任务的自动唤醒次数（只增不减）。 */
-    wakeCounts?: Record<string, number>;
-    stalled?: boolean;
-    stalledReason?: 'wake_budget';
-    createdAt: number;
-    updatedAt: number;
-    doneAt?: number;
-}
-export interface AgentHomeChannelTaskBoard {
-    version: 1;
-    tasks: AgentHomeChannelTask[];
-    /**
-     * 下一个要发的任务号。删了任务也要往上走——id 复用会让时间线里的 t3
-     * 前后指的不是同一条活（历史是 append-only 的，不能重编号）。
-     */
-    nextTaskId?: number;
-}
-/** 任务板文件：channels/<id>.tasks.json。文件名 = channel.id，不是显示名。 */
-export declare function agentHomeChannelTasksPath(homeDir: string, channelId: string): string;
-export declare const EMPTY_CHANNEL_TASK_BOARD: AgentHomeChannelTaskBoard;
-export declare function parseAgentHomeChannelTaskBoard(raw: string): AgentHomeChannelTaskBoard;
-/** 免锁读（GET / 看板快照语义）。缺文件 / 坏文件都当空板。 */
-export declare function readAgentHomeChannelTasksSync(homeDir: string, channelId: string): AgentHomeChannelTaskBoard;
-/** 锁内写：tmp + rename，避免半截 JSON。 */
-export declare function writeAgentHomeChannelTasks(homeDir: string, channelId: string, board: AgentHomeChannelTaskBoard): Promise<void>;
-export type AgentHomeChannelTaskActor = {
-    kind: 'agent';
-    agentId: string;
-    isLead: boolean;
-} | {
-    kind: 'user';
-};
-export type ChannelTaskEventType = 'created' | 'claimed' | 'completed' | 'released' | 'dispatched' | 'nudged' | 'escalated' | 'stalled'
-/** 板上最后一项也完成了：这一批结束了，该有人回报委托人（lead 的活）。 */
- | 'batch_done'
-/** 改了任务本身（标题 / 细节 / 指派 / 引用）：编排与用户都能纠错。 */
- | 'updated'
-/** 从板上撤掉一条（历史行留在时间线里，这一行记谁撤的）。 */
- | 'deleted';
-/**
- * 结构化事件：文案由 copy 层生成，这里只给数据。
- * 形状与落盘记录 / web-ui 共用 `agent-home-channel-task-event`（那份是 SSOT）。
- */
-export type ChannelTaskEvent = AgentHomeChannelTaskEventPayload & {
-    type: ChannelTaskEventType;
-};
-export type ChannelTaskAction = {
-    type: 'create';
-    subject: string;
-    detail?: string;
-    assignAgentId?: string;
-    refs?: AgentHomeChannelTaskRef[];
-    requestId?: string;
-} | {
-    type: 'claim';
-    taskId: string;
-} | {
-    type: 'update';
-    taskId: string;
-    /** 只传要改的字段；`null` 表示清空（细节 / 取消指派 / 清空引用），不传表示不动。 */
-    subject?: string;
-    detail?: string | null;
-    assignAgentId?: string | null;
-    /** 整表替换（UI 的加/删引用都在客户端算好整份传上来）。 */
-    refs?: AgentHomeChannelTaskRef[] | null;
-} | {
-    type: 'delete';
-    taskId: string;
-}
-/** 同组内重排：`toIndex` 是这一组（停滞 / 进行中 / 待认领 / 已完成）里的目标位次。 */
- | {
-    type: 'move';
-    taskId: string;
-    toIndex: number;
-} | {
-    type: 'complete';
-    taskId: string;
-    refs?: AgentHomeChannelTaskRef[];
-} | {
-    type: 'release';
-    taskId: string;
-} | {
-    type: 'dispatch';
-    items: {
-        subject: string;
-        detail?: string;
-        assignAgentId: string;
-        refs?: AgentHomeChannelTaskRef[];
-    }[];
-    requestId?: string;
-} | {
-    type: 'escalate';
-    mode: 'nudge' | 'release';
-    taskIds?: string[];
-    maxStaleMs?: number;
-};
-export interface ChannelTaskMutationInput {
-    board: AgentHomeChannelTaskBoard;
-    actor: AgentHomeChannelTaskActor;
-    action: ChannelTaskAction;
-    now: number;
-    /** 频道 lead（agentId）；缺省 = user-as-lead。竞态外的唤醒目标用。 */
-    leadAgentId?: string;
-    /** 单板任务上限，默认 MAX_TASKS_PER_CHANNEL（测试可覆盖）。 */
-    maxTasks?: number;
-    /** 唤醒预算，默认 MAX_WAKE_PER_TASK_PER_AGENT（测试可覆盖）。 */
-    wakeBudget?: number;
-}
-export interface ChannelTaskMutationSuccess {
-    ok: true;
-    board: AgentHomeChannelTaskBoard;
-    events: ChannelTaskEvent[];
-    /** 需要叫醒的人（已扣预算；预算耗尽的人不在内，任务已标 stalled）。 */
-    wakeAgentIds: string[];
-    /** 本次操作直接涉及的任务（工具返回值用）。 */
-    tasks: AgentHomeChannelTask[];
-}
-export type ChannelTaskMutationResult = ChannelTaskMutationSuccess | {
-    ok: false;
-    error: ChannelTaskErrorCode;
-};
-export declare function normalizeTaskSubject(subject: string): string;
-export declare function mutateChannelTaskBoard(input: ChannelTaskMutationInput): ChannelTaskMutationResult;

package/cli/dist-server/types/node/agent-home/agent-home-channel-wake-guard.d.ts

@@ -1,35 +0,0 @@
-export interface ChannelWakeGuard {
-    /** 去重桶：有 room turn 时 = 轮次号；没有时 = 时间窗序号。 */
-    bucket: string;
-    /** 该桶里已经被自动叫过的人。 */
-    wokenIds: string[];
-    /** 窗口内的自动唤醒时间戳（超过上限就抑制）。 */
-    autoWakes: number[];
-}
-/** 护栏文件：channels/<id>.wake.json。文件名 = channel.id，不是显示名。 */
-export declare function agentHomeChannelWakeGuardPath(homeDir: string, channelId: string): string;
-/** 读护栏（容错：缺失 / 坏 JSON / 字段类型不对一律当空，绝不因为护栏挡住唤醒）。 */
-export declare function readChannelWakeGuard(homeDir: string, channelId: string): ChannelWakeGuard;
-/**
- * 预约这一棒能叫谁。
- * - `bucket` 变了（新一轮 / 新窗口）→ 已叫名单清空；
- * - 窗口内自动唤醒次数达上限 → 一个都不叫（`suppressed: 'rate'`）；
- * - 同一桶里已经叫过的人 → 去重（进 `deduped`）。
- */
-export declare function reserveAutoWakes(input: {
-    homeDir: string;
-    channelId: string;
-    bucket: string;
-    now: number;
-    targets: readonly string[];
-}): Promise<{
-    allowed: string[];
-    deduped: string[];
-    suppressed: 'rate' | undefined;
-}>;
-/**
- * 去重桶键：
- * - 有进行中的轮次 → 用轮次号（**同一轮不重复叫同一个人**）；
- * - 没有轮次（成员插话）→ 用时间窗序号（窗口内同样不重复叫人）。
- */
-export declare function channelWakeBucket(channelId: string, round: number | undefined, now: number): string;

package/cli/dist-server/types/node/agent-home/agent-home-channel-wake.d.ts

@@ -1,102 +0,0 @@
-/** 落盘后叫醒频道成员。用户发言全员；同事发言只叫 @。 */
-import type { IDaemonProcessManager } from '@genie/cbc-daemon';
-import type { IJobStore } from '../agent-view/agent-view-protocol';
-import { type AgentHomeChannel, type AgentHomeChannelMessage, type AgentHomeDirectoryFile } from './agent-home-directory';
-/** 唤醒被跳过时给审计的原因（写进 audit.jsonl 的 wake_skipped）。 */
-export type ChannelWakeSkipReason = 'no-job' | 'error' | 'user-stopped' | 'dead' | 'flood' | 'deferred';
-/** 落盘成功后的叫醒出口：HTTP 回车和 SpeakInChannel 共用。 */
-export declare function wakeAfterChannelSpeech(input: {
-    directory: AgentHomeDirectoryFile;
-    channel: AgentHomeChannel;
-    message: AgentHomeChannelMessage;
-    /** speech 侧的结果：这次发言有没有推进轮次。false = 别叫人（待发言的人早就叫过了）。 */
-    advancedTurn?: boolean;
-    homeDir: string;
-    store: IJobStore;
-    processManager?: IDaemonProcessManager;
-    canRespawn?: boolean;
-    reloadDirectory?: () => Promise<AgentHomeDirectoryFile | undefined>;
-    onSkip?: (agentId: string, reason: ChannelWakeSkipReason) => void;
-    onDelivered?: (agentId: string) => void;
-    log?: (message: string) => void;
-}): Promise<void>;
-export declare function wakeChannelMembers(input: {
-    directory: AgentHomeDirectoryFile;
-    channel: AgentHomeChannel;
-    text: string;
-    /** 说话人：user 或成员 agentId。 */
-    from?: string;
-    mentionNames?: string[];
-    messageId?: string;
-    /** 这条发言带的附件：信封会带绝对路径（只给名字同事读不到，会去磁盘翻同名旧图）。 */
-    attachments?: readonly {
-        name: string;
-        file: string;
-    }[];
-    /** 轮转标记（如 "3/10"）：这封是轮到你发言，不是被 @。 */
-    round?: string;
-    homeDir: string;
-    store: IJobStore;
-    processManager?: IDaemonProcessManager;
-    /** 拉起接缝：默认走 respawnColleagueJob + processManager；单测注入假实现。 */
-    respawn?: (jobId: string, options?: {
-        resumeStopped?: boolean;
-    }) => Promise<boolean>;
-    /** 默认 true。job worker 里应 false，只写信 + wake 票，避免双 fork。 */
-    canRespawn?: boolean;
-    /**
-     * 对方进程已死（被 reaper 回收，pid 没了）时**干脆不投**——默认 false（交给
-     * respawn 拉起来）。只有「成员之间依次发言」这一条路传 true：那一棒不负责拉人，
-     * 死人的信留在频道里，等用户发言 / 派单 / 看门狗走 respawn 那条路再拉。
-     * 不能拿 `from` 代替——派单（from = 主 Agent id）与看门狗（from = 'system'）
-     * 都必须能把回收掉的同事拉起来，否则工具会返回"已派给 N 人"而实际谁也没收到。
-     */
-    skipIfDead?: boolean;
-    /** 没开过 1:1 时按招人同一条路起 job，写上 primaryJobId。不要把 channel.id 写进 jobAssignments。 */
-    ensureJob?: (agentId: string) => Promise<string | undefined>;
-    onSkip?: (agentId: string, reason: ChannelWakeSkipReason) => void;
-    /** 投递成功回调：信已经进对方的 job 收件箱。 */
-    onDelivered?: (agentId: string) => void;
-    /** 说话人自己不要再吃一封自己的入站。 */
-    excludeAgentId?: string;
-    /**
-     * 只叫醒这些成员（仍会去掉 exclude）。
-     * 不传 = 全员。传 [] = 谁也不叫（同事没 @ 任何人）。
-     */
-    onlyAgentIds?: readonly string[];
-    /**
-     * 这条消息里**用户真正 @ 到的人**（与 onlyAgentIds 不是一回事：用户发言开一轮时
-     * 只叫指针第一位，但那位不一定是被 @ 的）。
-     * 只用来判"要不要把被用户终止过的同事重新拉起"。不传 = 退回 onlyAgentIds（工具侧
-     * 的定向叫醒本来就只有这一份名单）。
-     */
-    mentionedAgentIds?: readonly string[];
-    /** 每人投递前再读一次目录，避免解锁后 primary 被改派。 */
-    reloadDirectory?: () => Promise<AgentHomeDirectoryFile | undefined>;
-    /**
-     * 这是不是**自动链**（成员发言触发的那一棒）：是则过互叫护栏（同轮去重 + 窗口限速）。
-     * 用户发言 / @ 点名 / 派单不传，不受限。
-     */
-    autoWake?: boolean;
-}): Promise<void>;
-/** 叫醒计划：叫谁（已按叫醒池过滤）+ 这封要不要带轮次标记。 */
-export interface ChannelWakePlan {
-    targets: string[];
-    /** 轮次标记（如 "1/3 · 2/10"）。没有进行中的轮次、或这次发言没推进轮次时不带。 */
-    round?: string;
-}
-/**
- * 叫醒判定 —— **唯一一份**。HTTP 回执（要回 wokeAgentIds）与投递
- * （wakeAfterChannelSpeech）都调它；两边输入相同，结论就相同，不存在"两处要保持一致"。
- */
-export declare function planChannelWake(input: {
-    directory: AgentHomeDirectoryFile;
-    channel: AgentHomeChannel;
-    /** 说话人：'user' 或成员 agentId。 */
-    from?: string;
-    mentionAgentIds?: readonly string[];
-    /** speech 侧结果：这次发言有没有推进/开启轮次。false = 待发言的人早叫过了，别重复叫。 */
-    advancedTurn?: boolean;
-    /** 说话人自己不吃自己的入站。 */
-    excludeAgentId?: string;
-}): ChannelWakePlan;

package/cli/dist-server/types/node/agent-home/agent-home-colleague-job.d.ts

@@ -1,37 +0,0 @@
-/**
- * 同事的 job：还没开口的同事怎么被拉起来（招人 / 叫醒两处共用）。
- *
- * 从 agent-home-channel-wake 挪出来——唤醒模块只该负责「叫谁、怎么投递」，
- * 不该顺带管"给一个人起 job、写 primaryJobId"。这里只做创建侧的事：
- * 锁内规划 → 锁外 spawn → 锁内认领（拿不到就回收刚起的 job）。
- *
- * 不要写 channel.id 进 jobAssignments；默认 Agent / 极简不走这里。
- */
-import { type AgentViewActionDeps } from '../agent-view/agent-view-actions';
-import type { IJobStore } from '../agent-view/agent-view-protocol';
-import { type AgentHomeDirectoryFile, type AgentHomeProfile } from './agent-home-directory';
-/**
- * 「现在能不能给这个人起 job」的唯一判据（规划阶段与锁外 spawn 后的认领阶段共用）。
- *
- * 认领阶段要再问一次，是因为锁外 spawn 期间目录可能已经变了（别人先给他起了 job /
- * 他被删了 / 被改成极简）。两处必须同一组条件，否则会出现"规划说能起、认领说不行"
- * 的错配——那正是回收分支存在的原因。
- */
-type ColleagueJobVerdict = {
-    kind: 'spawn';
-    profile: AgentHomeProfile;
-} | {
-    kind: 'existing';
-    id: string;
-} | {
-    kind: 'blocked';
-};
-export declare function planColleagueJob(directory: AgentHomeDirectoryFile | undefined, agentId: string): ColleagueJobVerdict;
-export declare function ensureAgentHomeColleagueJob(input: {
-    homeDir: string;
-    agentId: string;
-    store: IJobStore;
-    processManager: AgentViewActionDeps['processManager'];
-    logDir?: string;
-}): Promise<string | undefined>;
-export {};