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

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

@@ -1,52 +0,0 @@
-/**
- * 同事（Agent Home colleague job）的记忆落点与共享层。
- *
- * ## 为什么分区
- *
- * 对齐上游 sand-memory 的 shard per assistant：上游把记忆按 agent 分目录，注释里
- * 写明了意图——"one shard folder per assistant so every file has a single writer"。
- *
- * 我们原来的记忆目录只按 cwd 分（`projects/{projectId}/memory/`）：同一个仓库下的
- * 主 Agent、同事、子代理共用同一个 `MEMORY.md`。而提取是"对话结束 fire-and-forget
- * 起一个 run 去写文件"，几个同事同时写就是后写覆盖先写，也分不清是谁学到的。
- *
- * ## 写私有、读共享
- *
- * 对齐上游 own > project > user 的三层优先级：
- * - 写：`projects/{projectId}/memory/agents/{agentId}/`（私有，单写者）
- * - 读：自己的分区 + 项目（cwd）记忆 + 全局记忆（后两者只读，靠提示里的路径去
- *   Read / Grep；共享层保持单写者，不因为"读得到"就变成谁都能写）
- *
- * ## 门闸
- *
- * `isAgentHomeExclusiveToolSurface`（表面 ∧ 非子会话，含 WorkBuddy 宿主硬排除）
- * 之上再加一条：**有 jobId 且该 job 能在 agent-home 目录里解析成同事**——普通 TUI
- * 里的子代理也有 jobId，靠这条排除。任一不成立返回 undefined = 调用方走原路径。
- */
-export interface ColleagueMemoryScope {
-    /** 私有分区：写这里。 */
-    memoryDir: string;
-    /** 项目（cwd）记忆：同事可读不可写。 */
-    projectDir: string;
-    /** 全局记忆（跨项目的本机共享层）：同事可读不可写。 */
-    globalDir: string;
-}
-/**
- * 解析当前会话是不是"该分区的同事"。不是就返回 undefined。
- * 纯解析：不建目录（要写提示前先调 ensureColleagueMemoryDir）。
- */
-export declare function resolveColleagueMemoryScope(input: {
-    session?: unknown;
-    agent?: unknown;
-}): Promise<ColleagueMemoryScope | undefined>;
-/**
- * 记忆提示写着 "This directory already exists — write to it directly"，所以注入提示
- * 前把私有分区建出来（幂等）。建不出来不拦：Write 工具自己会补父目录。
- */
-export declare function ensureColleagueMemoryDir(scope: ColleagueMemoryScope): void;
-/**
- * 同事记忆的提示补充（挂到 buildMemoryPrompt 的 extraGuidelines）。
- *
- * 只对同事生效：主 Agent / TUI / WorkBuddy 的提示文本一个字节都不改。
- */
-export declare function colleagueMemoryGuidelines(scope: ColleagueMemoryScope): string[];

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

@@ -1,76 +0,0 @@
-/**
- * 活人：写进 job inbox，让已经在跑的 JobInboxConsumer 取走。
- * 死人：enqueueReply 再 respawn / 叫醒票。不在 resume 期强行 run()。
- * 信封不能当 --resume 位置参数。
- */
-import { type IDaemonProcessManager } from '@genie/cbc-daemon';
-import { type IJobStore } from '../agent-view/agent-view-protocol';
-/**
- * 同事 job 的进程还活着吗。判活只有一份实现（目录锁 / 协调者租约 / 这里共用）：
- * `kill(0,0)` / `kill(-1,0)` 在 Unix 上不是「这个同事还活着」。
- */
-export declare function isColleagueJobPidAlive(pid: number | undefined): boolean;
-export declare function respawnColleagueJob(store: IJobStore, jobId: string, processManager?: IDaemonProcessManager, options?: {
-    resumeStopped?: boolean;
-}): Promise<boolean>;
-/**
- * 记下"这件活在哪个主会话里被起（或被叫起来）"：同事回投主 Agent 时按它寻址，
- * 信就落在那个会话的上下文里，而不是"谁先 tick 谁拿"。
- *
- * 解析不出会话（后台 tick / 没有当前会话）就不写 —— 信会按活跃会话启发式投，不丢。
- * 已经记过就保持不动（见下面的"只写一次"）。
- */
-export declare function noteColleagueJobOrigin(store: IJobStore, jobId: string, homeDir: string): Promise<void>;
-/** 这个同事 job 的回投地址（没记过 / 读不到 = undefined）。 */
-export declare function readColleagueJobOrigin(jobId: string | undefined): Promise<string | undefined>;
-/**
- * 投递结果：
- * - `delivered`：信已经进了活着的收件箱（对方进程会自己消费），或本次重拉成功；
- * - `deferred`：信写进了收件箱，但对方进程不在、本次也没拉起来 —— 只留了唤醒票等
- *   broker 拉起。**不等于送达**（现场误判过一次：任务指派后审计全是 delivered，
- *   实际被指派人从未被拉起，见 #118277）。
- * - `skipped-*`：一个字节都没写（原因会进审计）。
- */
-export type ColleagueDelivery = 'delivered' | 'deferred' | 'skipped-user-stopped' | 'skipped-dead' | 'skipped-flood';
-export declare function deliverToColleagueJob(input: {
-    store: IJobStore;
-    jobId: string;
-    text: string;
-    homeDir: string;
-    canRespawn: boolean;
-    respawn?: (jobId: string) => Promise<boolean>;
-    /** 用户显式点名时允许把"用户终止过"的同事重新拉起；自动唤醒不允许。 */
-    resumeStopped?: boolean;
-    /**
-     * true = 对方进程不在就**不投递**（不写信、不 respawn、不留票）。
-     * 成员之间 @ 用这个：信留在频道 transcript 里（事实源），等它下次被叫起来自己读；
-     * 只有用户发言才值得把一个死人拉起来。
-     */
-    skipIfDead?: boolean;
-}): Promise<ColleagueDelivery>;
-/**
- * 入队预算（进程内滑动窗口）：同一个 job 在 10 分钟内最多收这么多条频道/同事信封。
- *
- * 超了**丢掉这条"提示"**——不丢信息：频道 transcript 才是事实源，对方下次被叫起来自己会读。
- * 用户消息不走这条路径，永远不会被丢；进程内计数是"兜底"，不是精确配额（多进程各自计数）。
- */
-export declare const MAX_ENVELOPES_PER_JOB = 20;
-export declare const ENVELOPE_WINDOW_MS: number;
-/** 单测用：清空窗口计数（模块级状态，跨用例会互相污染）。 */
-export declare function resetEnvelopeBudgetForTests(): void;
-/** 单测用：窗口表当前键数（钉住"键不会只增不减"，见 ENVELOPE_WINDOW_MAX_JOBS）。 */
-export declare function __envelopeWindowKeyCountForTests(): number;
-/**
- * 投递到主 Agent（委托侧）：**只落盘**，不做注入。
- *
- * 主会话活在 serve 进程里、由 agent-home-main-inbox-consumer 在它 idle 时取走；
- * 窗口关着 / 进程重启都不丢——这正是它必须落盘、不能进内存队列的原因。
- * 用信封装（和同事那条一样），主会话收到的是 action=incoming 的回执，不是用户打字。
- */
-export declare function deliverToMainAgent(input: {
-    homeDir: string;
-    text: string;
-    fromAgentId?: string;
-    /** 收件会话 = 这件活在哪个主会话里被起（见 noteColleagueJobOrigin）；缺省走启发式投。 */
-    targetSessionId?: string;
-}): Promise<'delivered'>;

package/cli/dist-server/types/node/agent-home/agent-home-directory-lock.d.ts

@@ -1,22 +0,0 @@
-/**
- * directory.json 跨进程锁。控制器 withLock 和 SpeakInChannel 共用。
- * 进程内排队 + mkdir 锁目录。
- *
- * 约定：
- * - 没拿到锁不要在 finally 里 rm 别人的锁目录。
- * - 过期只在持有者 pid 已死时拆；不靠 mtime 抢活锁。
- * - mkdir 成功但 pid 文件还没写 / 还是空的：等，不要当无主拆。
- * - 可重入只限当前异步上下文（AsyncLocalStorage），并发 withLock 必须排队。
- * - 释放时只删自己 pid 的锁。
- */
-/**
- * 抢不到目录锁（预算内没等到）。**抛这个错时什么都没写**，所以调用方可以放心重试：
- * HTTP 层映射成 503 + Retry-After，前端只对这一类失败自动重试。
- */
-export declare class AgentHomeDirectoryBusyError extends Error {
-    readonly lockDir: string;
-    constructor(lockDir: string);
-}
-/** 进程还活着吗（给锁与协调者租约共用；kill(0) 的坑见 deliver 侧注释）。 */
-export declare function pidLooksLive(pid: number): boolean;
-export declare function withAgentHomeDirectoryLock<T>(homeDir: string, task: () => Promise<T>): Promise<T>;

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

@@ -1,17 +0,0 @@
-/**
- * Agent Home 的错误码单一映射表（建人/建频道 + 频道任务板，两张表一份形状）。
- *
- * 加/改一个错误只动本文件：domain 抛 code，工具层取 llmMessage，HTTP controller 取
- * httpStatus/httpMessage。别在三处各写一遍——这里连"表驱动构造器"也只有一份。
- */
-export type AgentHomeCreateErrorCode = 'DIRECTORY_UNAVAILABLE' | 'INVALID_ACTOR' | 'INVALID_INPUT' | 'ENGINE_NOT_ALLOWED' | 'QUOTA_AGENTS' | 'QUOTA_CHANNELS' | 'DEPTH_EXCEEDED' | 'CHANNEL_MEMBERS' | 'MEMBER_NOT_FOUND' | 'ALREADY_MEMBER' | 'MEMBER_NOT_ALLOWED' | 'MAIN_AGENT_NOT_MEMBER' | 'LEAD_NOT_MEMBER' | 'PERMISSION_MODE_NOT_ALLOWED';
-export type ChannelTaskErrorCode = 'CHANNEL_NOT_FOUND' | 'CHANNEL_NEED_ID' | 'DIRECTORY_UNAVAILABLE' | 'INVALID_ACTOR' | 'INVALID_TASK' | 'TASK_NOT_FOUND' | 'TASK_CLAIM_CONFLICT' | 'TASK_DONE' | 'TASK_FORBIDDEN' | 'TASK_DUPLICATE' | 'BOARD_FULL' | 'BOARD_WRITE_FAILED' | 'LEAD_ONLY' | 'MEMBER_NOT_FOUND';
-/** 两张表共用的行形状：[码, http 状态, http 文案（英文，给调用方）, llm 文案（英文，给模型，要可执行）]。 */
-export interface AgentHomeErrorSpec<C extends string = string> {
-    code: C;
-    httpStatus: number;
-    httpMessage: string;
-    llmMessage: string;
-}
-export declare function agentHomeCreateError(code: AgentHomeCreateErrorCode): AgentHomeErrorSpec<AgentHomeCreateErrorCode>;
-export declare function channelTaskError(code: ChannelTaskErrorCode): AgentHomeErrorSpec<ChannelTaskErrorCode>;

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

@@ -1,101 +0,0 @@
-/**
- * Agent Home 落盘式收件箱：**同事 job 收件箱**（`jobs/<id>/colleague-inbox/`）+
- * **唤醒票目录**（`agent-home/wake/`）+ 目录监听。
- *
- * 除了同事侧，这里还有**主 Agent 收件箱**（`agent-home/inbox/`）：主 Agent 虽然不进频道
- * 成员表（委托侧定位见 agent-home-membership），但它是**委托人**——同事可以用
- * `MessageColleague` 回报它、一批派单全部完成时 lead 也会回报它，所以这条边是活的
- * （入队 `enqueueMainAgentMail`，由 agent-home-main-inbox-consumer 在主会话空闲时投递）。
- * 别再照着旧注释以为可以整条删掉。
- */
-export declare function agentHomeWakeDir(homeDir: string): string;
-export declare function colleagueInboxDir(jobDir: string): string;
-export declare function enqueueColleagueInbox(jobDir: string, text: string): Promise<void>;
-export declare function drainColleagueInbox(jobDir: string): Promise<Array<{
-    text: string;
-}>>;
-export declare function enqueueColleagueWake(homeDir: string, jobId: string): Promise<void>;
-/** 先看票再叫醒，成功后再删。失败把文件留在盘上。 */
-export declare function peekColleagueWake(homeDir: string): Promise<Array<{
-    jobId: string;
-    path: string;
-}>>;
-export declare function removeWakeTicket(path: string): Promise<void>;
-/**
- * 主 Agent 收件箱（委托侧）：同事的回报/私信先落这里，主会话 idle 时由
- * agent-home-main-inbox-consumer 取走。落盘 = 窗口关着、进程重启都不丢；
- * 投递成功再删（与唤醒票同一条纪律）。
- */
-export declare function agentHomeMainMailboxDir(homeDir: string): string;
-export declare function enqueueMainAgentMail(homeDir: string, mail: {
-    text: string;
-    fromAgentId?: string;
-    targetSessionId?: string;
-}): Promise<void>;
-/** 先看信再投递，成功后再删。失败把文件留在盘上，下一 tick 重试。 */
-export declare function peekMainAgentMail(homeDir: string): Promise<Array<{
-    text: string;
-    fromAgentId?: string;
-    targetSessionId?: string;
-    path: string;
-}>>;
-export declare function removeMainAgentMail(path: string): Promise<void>;
-/**
- * 已认领（取出处理中）目录：`agent-home/inbox/.processing/`。
- * 与同事收件箱同一套两阶段纪律：认领是 rename，确认（ack = removeMainAgentMail）才真删。
- */
-export declare function agentHomeMainMailboxProcessingDir(homeDir: string): string;
-/**
- * 认领租约（兜底）。正常路径走不到它：
- * - 认领者崩溃 → pid 已死 → **下一个 kick 立刻回收**；
- * - 认领者活着（哪怕正在跑一个很长的回合）→ 不抢，否则多窗口会重复投递。
- * 只有 pid 被复用 / 进程僵死（活着但永不 ack）才会等到这里，属极端兜底。
- */
-export declare const MAIN_MAIL_CLAIM_LEASE_MS: number;
-/** 派发失败后的重投退避：落 `.retry/`（**不在被 watch 的队列里**），到点由下一轮 claim 提升回队列。 */
-export declare const MAIN_MAIL_RETRY_BACKOFF_MS = 5000;
-/** 重投队列（退避期）：`agent-home/inbox/.retry/`。刻意不在 inbox 根下——那是被 fs.watch 盯着的目录。 */
-export declare function agentHomeMainMailboxRetryDir(homeDir: string): string;
-/**
- * 派发失败（或暂时拿不到 agent）的信：进重投队列等退避。**不能直接放回 inbox**——
- * 那是一次写盘，本进程的 fs.watch 立刻被叫醒 → 下一轮又派发又失败，实测 2 秒能打 40 次 run()。
- */
-export declare function deferMainAgentMail(homeDir: string, path: string): Promise<void>;
-/**
- * 认领主 Agent 邮箱（两阶段的第一阶段）：`inbox/*.json` rename 进 `inbox/.processing/<认领标记>`，
- * 并**回收无主残留**（上一轮认领后没确认、且认领者已死或超租约的信），一起返回。
- * 崩溃残留不丢（at-least-once，重复由 message_id 去重吸收）。
- *
- * rename 是原子操作：**多窗口共享同一个 HOME 时，同一封信只会被一个进程认领**——
- * 原先 peek 不改盘，两个进程能各自看到同一封并各投一遍。正在被活进程投递的信这一轮不回收。
- *
- * 解析不出 `text` 的文件（坏 JSON / 缺字段）不返回也不动它：与 peek 的跳过语义一致，
- * 它留在 .processing 里等人工排查，不会被当成待投递的信反复取。
- */
-export declare function claimMainAgentMail(homeDir: string): Promise<Array<{
-    text: string;
-    fromAgentId?: string;
-    targetSessionId?: string;
-    path: string;
-}>>;
-/** 跳过目录：判等不可靠（旧格式无 message_id）且已在历史里的信放这儿——不删、也不再进队列。 */
-export declare function agentHomeMainMailboxSkippedDir(homeDir: string): string;
-/**
- * 旧格式（无 message_id）的信已在历史里：不再投，但判等会回落到「同发信人 + 同正文」，
- * 删了可能丢真信，所以**留盘**——但必须离开待取队列。
- *
- * 为什么不能像以前那样放回 inbox：那是一次写盘，本进程的 fs.watch 立刻被叫醒 →
- * 下一轮又认领又放回，实测 2 秒 40 轮、每轮还写一条审计，永远不收敛。
- */
-export declare function skipMainAgentMail(homeDir: string, path: string): Promise<void>;
-/** 隔离目录：认不出来的信放这儿（不删——用户可见的回报不能静默丢）。 */
-export declare function agentHomeMainMailboxQuarantineDir(homeDir: string): string;
-/**
- * 认不出的信移进隔离目录：**不丢**，但离开主队列（否则每个 tick 都重试、把队列堵死）。
- * 出队的原因是解析失败/格式过旧，调用方要落一条审计说明。
- */
-export declare function quarantineMainAgentMail(homeDir: string, path: string): Promise<void>;
-/** 信落到目录就叫醒（同事收件箱 / 唤醒票目录 / 主 Agent 邮箱共用）。事件去抖 25ms，避免一次落盘叫醒多次。 */
-export declare function watchInboxDirectory(dir: string, onEvent: () => void): {
-    dispose(): void;
-};

package/cli/dist-server/types/node/agent-home/agent-home-main-session.d.ts

@@ -1,33 +0,0 @@
-/**
- * 主邮箱旁的「活跃主会话」指针：`agent-home/main-session.json`。
- *
- * 多进程共享同一个 HOME（几个 TUI / Web UI serve / 同事 job 的宿主）时，主邮箱只有一份、
- * 信里也没有目标会话（同事根本不知道你有几个会话）。于是用这个指针回答"该投给谁"：
- * **最近有用户发言的那个会话**。指针由各进程在 drain 时单调推进（`at` 更大才写），
- * 读失败 / 缺失 = 没有活跃会话（不拦投递）。
- *
- * 注意：这个文件刻意**不在** `agent-home/inbox/` 里 —— 那个目录被 fs.watch 盯着，
- * 且扫描时会把根下所有 `*.json` 当信取走。
- */
-export interface ActiveMainSession {
-    sessionId: string;
-    /** 该会话最后一条用户发言的时间（ms）。 */
-    at: number;
-}
-/** 未来时间戳的容忍窗口（时钟偏移）；超出即视为坏数据。 */
-export declare const FUTURE_SKEW_MS: number;
-export declare function agentHomeMainSessionPath(homeDir: string): string;
-export declare function readActiveMainSession(homeDir: string): Promise<ActiveMainSession | undefined>;
-/**
- * 解析"发起这件事的会话"（信的收件地址）：
- * - 优先**当前会话** —— 调用发生在某个会话的上下文里（主 Agent 在会话 A 里给同事派活、
- *   在会话 A 的任务板上建任务），要的就是 A；
- * - 回落**活跃会话指针**（后台 tick 触发的唤醒，进程里没有"当前在跑的会话"）；
- * - 都没有 = 没地址，信按启发式投（见 agent-home-main-mail-gate.ts）。
- */
-export declare function resolveOriginSessionId(homeDir: string): Promise<string | undefined>;
-/**
- * 记活跃会话。只在 `at` 前进时写盘（两个进程并发时后写者赢，但 `at` 单调不回退）。
- * 返回是否真的写了（测试与排查用）。
- */
-export declare function noteActiveMainSession(homeDir: string, input: ActiveMainSession): Promise<boolean>;

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

@@ -1,38 +0,0 @@
-/**
- * 统一收件人解析：一个 ref（**id**）→ 投递目标。
- *
- * 对齐上游 `SendToAgent({ target_id })` 的语义：**目标是"某个 agent"，不是"某个房间成员"**，
- * 而且参数就是 id（上游文档原话："Use an id from your teammates list … — not a name"）。
- * 我们 1:1 只有两类落点：
- * - `colleague`：常驻同事 → 他的 job 收件箱（进程不在就拉起）；
- * - `main`：主 Agent = 委托侧的工作现场 → 主会话邮箱（idle 时注入）。
- * 频道（上游的 group 目标）走 SpeakInChannel，不在这里。
- *
- * 显示名不是地址：名字只用于正文里的 @ 点名（撞名时同名的人全部叫上，见 agent-home-mentions）。
- * 极简引擎的人不能当收件人，判据是「能不能进频道」（canJoinAgentHomeChannel：
- * 极简在房间里说不了话）——不是"它没有 job"：极简照样有 job，只是不参与房间编排。
- */
-import { type AgentHomeDirectoryFile, type AgentHomeProfile } from './agent-home-directory';
-export type HomeMessageTarget = {
-    kind: 'colleague';
-    id: string;
-    name: string;
-    /** 主对话（还没有 = 他还没开过口，投递即拉起）。 */
-    jobId?: string;
-} | {
-    kind: 'main';
-    id: string;
-    name: string;
-};
-export type HomeMessageTargetLookup = {
-    status: 'found';
-    target: HomeMessageTarget;
-} | {
-    status: 'missing';
-} | {
-    status: 'ineligible';
-    agent: AgentHomeProfile;
-};
-/** 全部可投递的人（主 Agent + 能进频道的同事），供"你能联系谁"的提示用。 */
-export declare function listHomeMessageTargets(directory: AgentHomeDirectoryFile): HomeMessageTarget[];
-export declare function resolveHomeMessageTarget(directory: AgentHomeDirectoryFile, ref: string): HomeMessageTargetLookup;

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

@@ -1,30 +0,0 @@
-/** 用户消息上附隐藏房间花名册（system-reminder）。 */
-import { AgentRunInterceptor, AgentRunRequest } from '../../vendor/cbc-core/node/index.js';
-import { SettingsManager } from '../settings/settings-protocol';
-export declare class AgentHomeRoomContextInterceptor implements AgentRunInterceptor {
-    priority: number;
-    protected readonly settingsManager?: SettingsManager;
-    intercept(request: AgentRunRequest): Promise<void>;
-    /** 信封带了 mention_ids 且没有自己：这封是点别人的，不要回。 */
-    private channelMailIsForSomeoneElse;
-    private lastUserMessageText;
-    private attachRoomRoster;
-    private lastUserMessageHasReminder;
-    /**
-     * 频道叫醒：只教 SpeakInChannel，不挂房间花名册（否则模型会去 MessageColleague）。
-     * 入站是 function_call_result 时挂不上 last user，所以在回执后补一条 isMeta reminder。
-     */
-    private attachChannelReminder;
-    /**
-     * 看板注入：lead 拿完整快照、成员拿一行概览（详略由 copy 层决定）。
-     * 挂进同一条 reminder，避免 inputHasChannelReminder 去重导致二次注入失效。
-     */
-    private boardBrief;
-    private inputHasChannelReminder;
-    private incomingFromReceipt;
-    /**
-     * History 拦截器已经把 request.input 换成了 session.history 的同一引用。
-     * 提醒必须写在副本上，否则会改脏落盘历史，回放时同一封信再画一张卡片。
-     */
-    private detachLastUserMessage;
-}

package/cli/dist-server/types/node/agent-home/agent-home-runtime-arm-state.d.ts

@@ -1,14 +0,0 @@
-/**
- * Agent Home 运行时 arm 标志（**叶子模块，不 import 任何东西**）。
- *
- * 为什么要单独一个文件：`isAgentHomeRuntimeArmed()` 要被 **同步**判据用
- * （`isAgentHomeJobBlockingAgentTeams` / `agentHomeToolSearchVisibility`），
- * 而那些判据住在 agent-home-runtime / agent-home-tool-gate；arm 逻辑又要 import 它们
- * 的 `isAgentHomeFeatureEnabled`。把标志抽成叶子，两边都只依赖它，避免 import 成环。
- */
-/** 运行时是否已 arm（同步可读）。 */
-export declare function isAgentHomeRuntimeArmed(): boolean;
-/** 置位（返回是否是本次置上的：false = 之前已 arm，幂等）。 */
-export declare function markAgentHomeRuntimeArmed(): boolean;
-/** 测试用：复位。 */
-export declare function __resetAgentHomeRuntimeArmedForTests(): void;

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

@@ -1,87 +0,0 @@
-/**
- * Agent Home 专属表面。WorkBuddy / Zed `--acp` 不在这里。
- *
- * 允许：
- * - 同事 job worker（CODEBUDDY_JOB_ID）
- * - PWA ACP（session.options.webUiAcp，客户端名 codebuddy-web-ui）
- * - `--serve` 宿主自己的非 ACP 会话（host-detection = web-ui）
- *
- * 不允许：任何 `acp && !webUiAcp`（WorkBuddy / Zed 连 --serve 也不行）、
- * WorkBuddy Desktop、纯 TUI/CLI。即使 ~/.codebuddy/agent-home
- * 里已有房间/频道，也不能把 MessageColleague / SpeakInChannel 露出去。
- */
-interface SessionLike {
-    options?: {
-        acp?: boolean;
-        webUiAcp?: boolean;
-    };
-}
-/**
- * isEnabled 有的走 `{ runContext: { context } }`，有的直接塞 RunContext。
- * 自治工具的闸门（agent-home-tool-gate）也用它取会话，勿另写一份。
- */
-export declare function sessionFromToolEnabledArgs(args?: unknown): SessionLike | undefined;
-/**
- * env 总闸。HTTP 目录在 env 未设时还看 settings；
- * 工具 / interceptor / inbox / wake 走 isAgentHomeSurface（env ∧ 表面）。
- */
-export declare function isAgentHomeFeatureEnabled(): boolean;
-/**
- * 同事 job 是 Agent Home 频道/1:1，不是 Agent Teams。
- * TeamCreate / SendMessage 留着，模型会拿来「演示 @」，和频道 @ 不是一回事。
- */
-export declare function isAgentHomeJobBlockingAgentTeams(): boolean;
-/** isEnabled 没挡住时（旧会话还握着工具）execute 也要拒，并指向 SpeakInChannel。 */
-export declare function agentHomeAgentTeamsBlockedMessage(): string;
-/** 功能开着，并且当前是 Agent Home 表面。 */
-export declare function isAgentHomeSurface(hint?: unknown): boolean;
-/**
- * 进程身份（job id / HOST=web-ui）或会话身份（webUiAcp）。
- * 非 PWA ACP：`acp && !webUiAcp` 关，即使连的是 --serve。
- * `webUiAcp === true` 算 PWA（prompt 每轮重盖 stamp）。
- * 无 hint 的进程级消费者只看 job / --serve host，不会套用会话级 veto。
- *
- * **WorkBuddy 硬排除**（按宿主，不看会话选项）：原先只靠 `session.options.acp`，
- * 而 WB 的 headless/print 入口未必盖 acp，那时只要进程里有 job id 就会被判成
- * "Agent Home 表面"——实测（2026-09-14 抓请求体）WB 宿主 + 同事 job 会拿到
- * CreateChannel/CreateColleague。产品口径是"WB 看不到自治工具"，所以这里按宿主
- * 一刀切；IDE(vscode-acp) 各入口都盖 acp，交给上面那条即可。
- */
-export declare function isAgentHomeExclusiveRuntime(hint?: unknown): boolean;
-/**
- * 宿主是否可能是 Agent Home 的 Web 面（进程级）：显式 `CODEBUDDY_HOST=web-ui`，
- * 或**没有**显式宿主信号时 argv 回退到 `--serve`（CBC Web UI 的真实形态：它不设该 env）。
- *
- * 为什么不能裸判 `getHostName() === 'web-ui'`：`detectHost()` 对**未识别**的显式宿主值
- * 会继续扫 argv —— 而 WB 的进程恰好都带 `--serve`，一次宿主信号改名/丢失
- * （如 sidecar 的 hostId 落回 'workbuddy-server'）就会静默落进"放行档"，
- * 工具面 / 生命周期 / 收件箱投递 / HTTP 面一起打开（2026-09-14 漏口同型）。
- * 对未知显式宿主一律按"不是 Web UI"处理：判错方向只能是更严，不能更宽。
- *
- * ⚠️ 只给**工具面**用（要求 --serve 指纹没错：TUI 主对话不该拿自治工具）。
- * HTTP 面别用它——TUI 进程也内嵌 Web UI，见 isAgentHomeHttpHostAllowed。
- */
-export declare function isAgentHomeWebUiHost(): boolean;
-/**
- * **主 Agent 邮箱消费者**的进程闸：比自治工具面（isAgentHomeSurface）宽一档。
- *
- * 工具面只对 Web UI PWA / 同事 job / `--serve` 宿主开放；但「同事回报主 Agent」这条边
- * 在**任何合法宿主**都该通 —— 实测用户在 TUI（host=cli）里对话时消费者压根没起，
- * 同事的完成报告永远躺在 `agent-home/inbox/`（最久 8 小时）。
- *
- * 仍硬排除：WorkBuddy 宿主、未知显式宿主、IDE 的 ACP 会话（vscode-acp）。
- */
-export declare function isAgentHomeMainInboxHost(): boolean;
-/**
- * HTTP 面（`/api/v1/agent-home/*`）的宿主判据：只按**明确的非 Web UI 宿主**拒绝。
- *
- * 为什么不能复用 `isAgentHomeWebUiHost()`（要求 --serve 指纹）：**TUI 进程也在内嵌服务
- * Web UI**（banner 里的 http://127.0.0.1:<port> 就是它，argv 无 --serve、host='cli'），
- * 要求指纹会把这类用户的频道/看板一起静默关掉（2026-08-16 实发回归）。
- * 拒绝面收窄为：WorkBuddy 宿主（workbuddy-desktop）与未知显式宿主（workbuddy-server 等）——
- * 其余的 host（未设置 / web-ui / cli）都由 gateway 鉴权 + settings 开关各自兜底。
- */
-export declare function isAgentHomeHttpHostAllowed(): boolean;
-/** 工具 execute：不在表面上时的拒绝文案。在表面上返回 undefined。 */
-export declare function agentHomeToolUnavailableMessage(hint: unknown, product: 'channel' | 'room'): string | undefined;
-export {};

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

@@ -1,39 +0,0 @@
-/**
- * Agent Home 的用户开关。**Web UI 设置里只有一个**：`codebuddy.agentHome.orchestration`
- * （「Agent 团队（Agent Home）」组的「允许智能体自主组队」）。
- *
- * 绑定的分工（新增链路时按这个选，别再各处自己判）：
- *
- * - **行为链路**走 `isAgentHomeOrchestrationEnabled`：自治工具（建人/建频道/任务板/
- *   发言/私信）、频道提醒注入、唤醒投递与轮次看门狗。关掉 = 同事不再被叫、不再注入。
- * - **表面读路径**走 `isAgentHomeSurfaceEnabled`：Web UI 自己的目录/频道/看板 API。
- *   关掉只是 Web 回落 Job 列表，不动已存在的房间数据。
- * - **例外：同事记忆的目录布局**只看"这是不是一个同事 job"（`agent-home-colleague-memory`）。
- *   开关不该改变数据落点——关一下就把同事的记忆目录指回共享目录，多同事又会互相覆盖。
- *
- * 优先级：env 硬覆盖 > settings > env 总闸。读失败不拦（总闸有 env 兜底）。
- *
- * **默认关**（2026-09）：settings 里没开过 = 整块不出现。用户第一次在智能体面板的
- * 「开启 Agent 团队」入口（或设置页开关）打开后才生效。这也是防"宿主判据漏网"的
- * 第二道锁——WorkBuddy 等宿主即使判据失效，默认关也兜住。
- */
-import type { SettingsManager } from '../settings/settings-protocol';
-export interface AgentHomeCodebuddySettings {
-    agentHome?: {
-        enabled?: boolean;
-        orchestration?: boolean;
-    };
-}
-export type AgentHomeSettingsSource = Pick<SettingsManager, 'get'>;
-export declare function readAgentHomeCodebuddySettings(settingsManager?: AgentHomeSettingsSource): Promise<AgentHomeCodebuddySettings | undefined>;
-/**
- * Agent Home 整个表面（目录 / 频道 / 同事）是否可用。**纯开关判据：只看 env 总闸 + settings，
- * 不含宿主闸**——HTTP 面必须经 `isAgentHomeHttpEnabled`（它另外要求 Web UI 宿主），
- * 别直接拿这个函数当"HTTP 能不能开"的判据。
- */
-export declare function isAgentHomeSurfaceEnabled(settingsManager?: AgentHomeSettingsSource): Promise<boolean>;
-/**
- * Agent Home 自治机器总闸（Web UI 那个开关）：工具、频道提醒、唤醒与看门狗都走它。
- * 表面读路径（Web UI 目录/频道 API）用 `isAgentHomeSurfaceEnabled`。
- */
-export declare function isAgentHomeOrchestrationEnabled(settingsManager?: AgentHomeSettingsSource): Promise<boolean>;

package/cli/dist-server/types/node/agent-home/agent-home-tool-gate.d.ts

@@ -1,53 +0,0 @@
-/**
- * Agent Home 自治工具（CreateColleague / CreateChannel / ChannelTasks）专属闸门。
- *
- * 在 `isAgentHomeSurface`（只对同事 job / PWA ACP / --serve web-ui 开放）之上，
- * 再排除三类「不是主对话」的会话，避免子代理、团队成员、内部生成器 agent
- * 拿到建人 / 建频道 / 改任务板的能力：
- *
- * - 子代理：`SessionUtils.isSubAgent`（storeId 与 id 不同）或 `meta.parentSessionId`
- * - 团队：`meta.isTeamLead` / `meta.isTeamMember`（SessionUtils.isTeamSession）
- * - 生成器：`INTERNAL_GENERATOR_AGENTS`（compact / summary 等旁路 LLM 调用）
- *
- * 与 `agent-home-membership.ts` 不同，本模块允许依赖会话与 agent 协议——
- * 它只服务 Node 侧工具，web-ui 不要 import。
- */
-import { type AgentHomeSettingsSource } from './agent-home-settings';
-/** 子代理 / 团队成员 / 内部生成器：看得见主对话之外的工具面，自治工具必须挡住。 */
-export declare function isAgentHomeSubSession(args?: unknown): boolean;
-/** 自治工具的唯一表面判据：Agent Home 表面 ∧ 非子会话。 */
-export declare function isAgentHomeExclusiveToolSurface(args?: unknown): boolean;
-/** 工具 execute：不在自治表面上时的拒绝文案。在表面上返回 undefined。 */
-export declare function agentHomeExclusiveToolUnavailableMessage(args: unknown): string | undefined;
-/**
- * 自治工具的完整开关：表面 ∧ 非子会话 ∧ Web UI 设置里的开关。
- * 工具 isEnabled 直接 await 本函数；execute 里 `!enabled` 时用下面的文案硬拒。
- */
-export declare function isAgentHomeOrchestrationToolEnabled(args: unknown, settingsManager?: AgentHomeSettingsSource): Promise<boolean>;
-/** 表面成立、只是被设置/总闸关掉时的拒绝文案（能力中立：建人建频道、发言、私信都用它）。 */
-export declare function agentHomeOrchestrationDisabledMessage(): string;
-/**
- * 房间类工具（SpeakInChannel / MessageColleague）的统一闸门：拒绝时给文案，放行给 undefined。
- * 顺序固定：先产品级不可用（不在表面 / 子会话），再设置级关掉。isEnabled 与 execute 共用，
- * 免得两个地方的判据与文案各写一份。
- */
-export declare function agentHomeRoomToolRefusal(args: unknown, settingsManager: AgentHomeSettingsSource | undefined, product: 'channel' | 'room'): Promise<string | undefined>;
-/**
- * 自治工具 `shouldShowInToolSearch` 的统一口径；房间类工具用 `hasLocal` 追加自己的
- * "有频道 / 有房间"前提（它的 isEnabled 已经改写成了异步，同步回调读不到设置）。
- *
- * 为什么是"近似"：deferred 可见性回调只接受同步返回，且**拿不到 session**
- * （`ToolManager.indexDeferredTool` 存的是不带参数的 bound 函数，
- * `buildDeferredToolEnabledCheck` 也是拿 `runContext: undefined` 调 isEnabled）。
- * 于是只能退回进程级信号：功能总闸 + 有没有 jobId + 宿主是不是 web-ui。
- *
- * 实测现状：这几个工具**不在** `product.tools` 的 `deferLoading` 列表里 →
- * `indexDeferredToolsFromProductConfig` 不会索引它们 → 本回调当前不会被调用。
- * 保留它是为了将来若被标成 deferred 时有正确口径：真正的门槛始终是带 session 的
- * `isEnabled` / `execute`（`isAgentHomeExclusiveToolSurface`），这里给宽了也只是
- * 多一条提示，不会多一份能力。
- *
- * 注意别把它当成"Cli 会话可见"的开关：普通 TUI（host=cli、无 job）在这里是 false，
- * 而它在 REPL 沙箱里同样调不动——两边一致。
- */
-export declare function agentHomeToolSearchVisibility(hasLocal?: () => boolean): boolean;

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

@@ -1,69 +0,0 @@
-/**
- * 频道唤醒编排服务：依赖（JobStore / Daemon）在这里解析一次，工具不再各自 ContainerUtil.get。
- * 只做「落盘之后叫醒」，永远在目录锁外调用；单测直接 new + 赋字段即可。
- */
-import { type IDaemonProcessManager } from '@genie/cbc-daemon';
-import { Logger } from '@genie/telemetry';
-import { type IJobStore } from '../agent-view/agent-view-protocol';
-import { SettingsManager } from '../settings/settings-protocol';
-import { type ChannelWakeSkipReason } from './agent-home-channel-wake';
-import { type AgentHomeChannel, type AgentHomeChannelMessage, type AgentHomeDirectoryFile } from './agent-home-directory';
-export interface ChannelWakeDeps {
-    store?: IJobStore;
-    processManager?: IDaemonProcessManager;
-}
-/**
- * 叫醒审计的两个回调（单一实现）：工具路径（ChannelWakeService）与 HTTP 路径
- * （local-agent-home-controller 的用户发言）共用，字段/文案不会各写一份。
- * 投递成功的语义是「信已经进了对方的 job 收件箱」，不代表对方已经开始处理。
- */
-export declare function channelWakeAudit(input: {
-    homeDir: string;
-    channelId: string;
-    actorAgentId?: string;
-    messageId?: string;
-    log?: (message: string) => void;
-}): {
-    onSkip: (agentId: string, reason: ChannelWakeSkipReason) => void;
-    onDelivered: (agentId: string) => void;
-};
-export declare class ChannelWakeService {
-    protected readonly injectedStore?: IJobStore;
-    protected readonly injectedProcessManager?: IDaemonProcessManager;
-    protected readonly settingsManager?: SettingsManager;
-    protected readonly logger?: Logger;
-    /** 注入优先；缺注入时退回容器（真实运行；单测没有容器也不会炸）。 */
-    resolveDeps(): ChannelWakeDeps;
-    /**
-     * 发言落盘后的叫醒出口。返回 false = 拿不到 JobStore（只记日志，不影响发言结果）。
-     * job worker 进程里 canRespawn 强制 false，只写信 + wake 票，避免双 fork。
-     */
-    wakeAfterSpeech(input: {
-        homeDir: string;
-        directory: AgentHomeDirectoryFile;
-        channel: AgentHomeChannel;
-        message: AgentHomeChannelMessage;
-        /** speech 侧结果：没有推进轮次就别重复叫人。 */
-        advancedTurn?: boolean;
-        onSkip?: (agentId: string, reason: ChannelWakeSkipReason) => void;
-    }): Promise<boolean>;
-    /** 叫醒审计（onSkip / onDelivered 回调），供各路径在投递结果上落审计行。 */
-    private audit;
-    /** 自治总闸（Web UI 那个开关）关掉就不投递：票与轮次留在原地，开关打开后自然继续。 */
-    private wakeAllowed;
-    /** 任务事件等非发言路径的定向叫醒。返回 false = 开关关着或拿不到 JobStore。 */
-    wakeMembers(input: {
-        homeDir: string;
-        directory: AgentHomeDirectoryFile;
-        channel: AgentHomeChannel;
-        text: string;
-        from?: string;
-        mentionNames?: string[];
-        messageId?: string;
-        onlyAgentIds?: readonly string[];
-        excludeAgentId?: string;
-        onSkip?: (agentId: string, reason: ChannelWakeSkipReason) => void;
-    }): Promise<boolean>;
-    /** 招人起 job 用的 logDir；工具拿不到容器时退化为默认。 */
-    logDir(): string;
-}