@tencent-ai/agent-sdk 0.3.252 → 0.3.253

package/cli/dist-server/types/node/command/vim-command-executor.d.ts

@@ -1,11 +0,0 @@
-import { SessionManager } from '../session';
-import { CommandExecuteContext, CommandExecutor } from './command-protocol';
-import { VimManager } from '../vim';
-export declare class VimCommandExecutor implements CommandExecutor {
-    name: string;
-    message: string;
-    autoGenerateHistory: boolean;
-    protected readonly sessionManager: SessionManager;
-    protected readonly vimManager: VimManager;
-    execute(ctx: CommandExecuteContext): Promise<void>;
-}

package/cli/dist-server/types/node/command/workflows-command-executor.d.ts

@@ -1,26 +0,0 @@
-/**
- * /workflows —— 列出所有 saved + builtin workflow,以及当前 session 内运行中的 workflow run。
- *
- * 单一职责:把 WorkflowManager.listActive() + WorkflowRegistry.list() 拼成
- * markdown 字符串,通过标准 finalize 路径写入 session 历史。
- *
- * Batch 4 简化:不实现交互式键位(`s/p/r/x/j/k`),只输出文本列表。
- * 后续 UI batch 接入 Ink 组件后再补。
- */
-import { Logger } from '@genie/telemetry';
-import { SessionManager } from '../session';
-import type { WorkflowManager, WorkflowRegistry } from '@genie/cbc-workflow';
-import { CommandExecuteContext, CommandExecutor } from './command-protocol';
-export declare class WorkflowsCommandExecutor implements CommandExecutor {
-    name: string;
-    autoGenerateHistory: boolean;
-    protected readonly logger: Logger;
-    protected readonly sessionManager: SessionManager;
-    protected readonly manager: WorkflowManager;
-    protected readonly registry: WorkflowRegistry;
-    execute(ctx: CommandExecuteContext): Promise<void>;
-    private buildOutput;
-    private renderRunningSection;
-    private renderSavedSection;
-    private appendHistory;
-}

package/cli/dist-server/types/node/feedback/feedback-protocol.d.ts

@@ -1,32 +0,0 @@
-import { BehaviorSubject } from 'rxjs';
-import { Session } from '../session';
-export declare const FeedbackService: unique symbol;
-/**
- * Feedback 状态
- */
-export type FeedbackStatus = 'idle' | 'loading' | 'opening' | 'success' | 'failed' | 'not-configured';
-/**
- * Feedback 状态数据
- */
-export interface FeedbackState {
-    status: FeedbackStatus;
-    feedbackUrl?: string;
-}
-/**
- * Feedback 服务接口
- */
-export interface FeedbackService {
-    /**
-     * 状态 Subject，用于 UI 订阅
-     */
-    readonly stateSubject: BehaviorSubject<FeedbackState>;
-    /**
-     * 打开反馈页面
-     * @param session 当前会话
-     */
-    openFeedbackPage(session: Session): Promise<void>;
-    /**
-     * 重置状态
-     */
-    reset(): void;
-}

package/cli/dist-server/types/node/feedback/feedback-service.d.ts

@@ -1,19 +0,0 @@
-import { AuthenticationManager } from '@genie/authentication';
-import { ProductManager } from '@genie/product';
-import { ExternalUriOpener } from '@genie/runtime';
-import { BehaviorSubject } from 'rxjs';
-import { InstallService } from '../install';
-import { Session } from '../session';
-import { FeedbackService, FeedbackState } from './feedback-protocol';
-export declare class FeedbackServiceImpl implements FeedbackService {
-    readonly stateSubject: BehaviorSubject<FeedbackState>;
-    protected readonly productManager: ProductManager;
-    protected readonly externalUriOpener: ExternalUriOpener;
-    protected readonly authenticationManager: AuthenticationManager;
-    protected readonly installService: InstallService;
-    openFeedbackPage(session: Session): Promise<void>;
-    reset(): void;
-    protected buildFeedbackUrl(baseUrl: string, session: Session): Promise<string>;
-    protected buildFeedbackBody(session: Session): Promise<string>;
-    protected getInstallMethod(): Promise<string>;
-}

package/cli/dist-server/types/node/feedback/index.d.ts

@@ -1,2 +0,0 @@
-export * from './feedback-protocol';
-export * from './feedback-service';

package/cli/dist-server/types/node/goal/goal-policy.d.ts

@@ -1,55 +0,0 @@
-/**
- * Goal 默认策略层：文案、prompt 模板、scope id 生成。
- *
- * 全部为纯逻辑，单测里直接 import 即可断言（不依赖 DI / Service）。
- * 业务侧若要定制（i18n、品牌词替换、scope 命名规则）可构造自定义
- * `GoalServicePolicy` 注入到 `GoalServiceImpl.configure()`。
- */
-import { ActiveGoal, GoalServicePolicy } from './goal-protocol';
-/**
- * 与 cc 二进制中的 stop-condition user message 对齐。
- *
- * 设计原因：
- *   - JSON schema、三态语义、impossible 强约束都已在 evaluator agent 的
- *     `prompt-hook-evaluator-instructions.tpl` 里集中说明（system prompt），
- *     user message 只负责把"问题"抛给模型即可——避免与 system prompt 重复
- *     甚至产生冲突说法（之前两态 vs 三态就出过这种漂移）；
- *   - 文案与 cc 的 user message 字字对齐："Based on the conversation
- *     transcript above, has the following stopping condition been satisfied?
- *     Answer based on transcript evidence only."
- *   - prompt-hook-service 会自动把 ARGUMENTS JSON 追加到末尾，无需在此手拼。
- *
- * 评估窗口约束：当同一 session 在历史上设置过多个 goal 时，旧 goal 的
- * 成功响应仍留在 transcript 里。如果不告诉模型"评估窗口"，它很容易把
- * 上一次的 "已完成" 错误地归到当前 goal 头上（实测 deepseek 等网关
- * 会立即返回 ok=true）。`createdAt` 以 ISO 8601 字符串注入，让 evaluator
- * 知道从哪个时刻起的对话才算数。
- */
-export declare function buildStopConditionPrompt(goal: ActiveGoal): string;
-/**
- * 生成 scope id：`goal:<sessionId>:<nonce>`。
- *
- * 加 nonce 后缀是为了让 onResult 回调的"防漂移"判断生效：用户用 `/goal`
- * 替换当前目标后，旧目标的 hook 评估回调如果延迟到达，能通过对比 scopeId
- * 识别出"我已经不是当前活跃的目标"并 silently ignore，避免对新目标做副作用。
- *
- * nonce 用 8 位 base36 随机数；同进程内冲突概率可忽略。
- */
-export declare function generateGoalScopeId(sessionId: string): string;
-/**
- * 构造 `/goal <condition>` 设置完成后立即发送给 agent 的"启动消息"。
- *
- * 这条消息会被 GoalServiceImpl.set() fire-and-forget 地通过 agentService.runDefault
- * 投递，让 agent 立刻开始工作；之后 Stop hook 会在 agent 每次自然停下来时
- * 评估目标是否达成。
- *
- * 文本与 Claude Code `/goal` 的注入 prompt 对齐——本质是一段 system-reminder
- * 风格的指令（而非普通 user 提问），目的是：
- *   1. 简短致意 + 立刻开始/继续工作，不要回头问用户做什么；
- *   2. 把 condition 本身当作"指令"消费；
- *   3. 解释 stop hook 的 block 语义（不会让你停下来）；
- *   4. 解释 auto-clear 语义——达成后不要叫用户跑 `/goal clear`，
- *      那只用于"提前放弃"。
- */
-export declare function buildGoalKickoffMessage(condition: string): string;
-export declare const DEFAULT_GOAL_POLICY: GoalServicePolicy;

package/cli/dist-server/types/node/goal/goal-protocol.d.ts

@@ -1,178 +0,0 @@
-/**
- * `/goal` 功能的对外契约。
- *
- * 与实现 (`goal-service.ts`) 解耦：业务侧只需要依赖本文件的 Symbol + interface
- * 即可注入并测试，不必拉到具体实现类（DI / mock 都更轻）。
- *
- * 模块组织（doctor / memory / checkpoint 同模式）：
- *   - goal-protocol.ts    Symbol + interface + 数据契约 + 常量
- *   - goal-policy.ts      纯文案 / prompt 模板 / 默认 policy
- *   - goal-utils.ts       纯函数：parseActiveGoal / buildGoalPromptHook
- *   - goal-service.ts     `@Component(GoalService)` 唯一实现
- *   - goal-session-start-hook.ts SessionStart 路径自动 restore
- */
-import { GoalResultItem } from '../agent/openai-agents-types';
-import { PromptHookDefinition, PromptHookResult } from '../hooks/hook-protocol';
-import { Session } from '../session/session-protocol';
-export declare const GoalService: unique symbol;
-export interface ActiveGoal {
-    condition: string;
-    /** scope id；唯一定位一次 set() 注册的 hook 实例。详见 GoalServicePolicy.scopeIdFor。 */
-    scopeId: string;
-    createdAt: number;
-    /**
-     * goal set 时的 session.usage.totalTokens 快照。
-     * 终态时用 (当前 totalTokens - tokensAtStart) 计算 goal 期间的增量 token，
-     * 与 cc 的 "Goal achieved (… · N tokens)" 语义对齐。
-     * 缺省（旧 session resume 时）按 0 处理 → tokenDelta 退化为 totalTokens。
-     */
-    tokensAtStart?: number;
-    /**
-     * goal 期间已发生的 turn 数（kick-off + 每次 stop-hook 评估算一轮）。
-     * 终态时随 GoalResultItem 一起持久化。
-     * 该字段会被 GoalServiceImpl.setMeta 持久化到 session.meta，
-     * 因此即便跨 hook 回调也能稳定累加。
-     */
-    turnCount?: number;
-    /**
-     * Web UI 暂停：卸掉 Stop hook，但保留 condition / createdAt。
-     * 当前回合继续跑；暂停后不再自动续轮。
-     */
-    paused?: boolean;
-    /** 点暂停时的墙钟，用来冻住 elapsed。 */
-    pausedAt?: number;
-}
-export interface GoalService {
-    /** 设定/替换当前 session 的目标。若已有目标则先注销并提示替换。 */
-    set(session: Session, condition: string): Promise<void>;
-    /** 清除当前目标，并注销已注册的 hook。 */
-    clear(session: Session): Promise<void>;
-    /**
-     * 暂停目标：卸 Stop hook、冻计时，并打断当前回合（Web / 独立 TUI）。
-     * 条还在，点继续才重新挂 hook。WorkBuddy --acp 不 abort，避免改 Desktop 语义。
-     */
-    pause(session: Session): Promise<void>;
-    /**
-     * 继续已暂停的目标：重新注册 hook。
-     * 当前回合还在跑就只恢复续跑；空闲才 kick-off。
-     */
-    resume(session: Session): Promise<void>;
-    /** 显示当前目标。无目标时输出引导文案。 */
-    show(session: Session): Promise<void>;
-    /**
-     * 从 session.meta 中已存的 activeGoal 重新注册 hook（resume 路径）。
-     * 幂等：若 scopeId 已经在 registry 内则跳过。
-     */
-    restoreFromMeta(session: Session): Promise<void>;
-    /** 当前 session 是否有 active goal。 */
-    has(session: Session): boolean;
-    /** 当前 session 的 active goal（仅读 meta，不查 registry）。 */
-    get(session: Session): ActiveGoal | undefined;
-    /**
-     * 取 session.history 中最近一次（按 append 顺序）的 goal-result 终态项。
-     *
-     * 用于无参 `/goal` 的 recap 面板：在没有 active goal 时把最后一次达成 /
-     * 不可达的目标 surface 出来，对齐 cc `/goal` 的 banner 行为
-     * （`✔ Goal achieved` + Goal: + stats，Esc to dismiss）。
-     *
-     * 实现层只读 history、不写副作用——便于 panel 直接订阅。
-     */
-    getLatestResult(session: Session): GoalResultItem | undefined;
-}
-/** condition 字符长度软上限（与 cc 文档对齐：4000 字符）。 */
-export declare const GOAL_CONDITION_MAX_CHARS = 4000;
-/** scopeId 前缀；所有 goal hook 的 scope 都以此打头。 */
-export declare const GOAL_SCOPE_PREFIX = "goal:";
-/** 已知的 goal metric 名（保持与 cc 字面对齐，便于跨工具检索）。 */
-export declare const GOAL_METRICS: {
-    readonly SET: 'tengu_goal_set';
-    readonly CLEARED: 'tengu_goal_cleared';
-    readonly ACHIEVED: 'tengu_goal_achieved';
-    readonly MET: 'goal_met';
-    readonly FAILED: 'tengu_goal_failed';
-    readonly RESTORED: 'tengu_goal_restored_on_resume';
-};
-export type GoalMetricName = typeof GOAL_METRICS[keyof typeof GOAL_METRICS];
-/** Goal metric 发送通道。生产由 service 注入实现，单测可换 spy。 */
-export interface GoalMetricSink {
-    record(name: GoalMetricName, payload?: Record<string, unknown>): void;
-}
-/**
- * Goal 文案表。集中所有面向用户的英文 string 以便未来 i18n / 个性化。
- * 都是 `(args) => string` 形式，便于参数化。
- */
-export interface GoalMessages {
-    usage(): string;
-    tooLong(actual: number, max: number): string;
-    hooksDisabled(): string;
-    cleared(prev: string): string;
-    set(condition: string): string;
-    clearedOnly(prev: string): string;
-    noGoal(): string;
-    active(condition: string): string;
-    paused(condition: string): string;
-    resumed(condition: string): string;
-    achieved(reason?: string): string;
-    impossible(reason?: string): string;
-}
-/**
- * 可替换的策略层。集中所有可变常量与小算法，便于：
- *   - 测试时注入 stub policy 控制行为；
- *   - 未来切换文案 / scope 命名规则 / prompt 模板时不动 service。
- */
-export interface GoalServicePolicy {
-    maxConditionChars: number;
-    scopeIdFor(sessionId: string): string;
-    /**
-     * 构造发给 stop-condition evaluator 的 user prompt。
-     *
-     * @param goal 当前 active goal（含 condition、createdAt 等上下文）
-     *
-     * 接收整个 goal 而不仅是 condition，是为了让 prompt 能告知 evaluator
-     * "评估窗口"——只看 goal 设置之后的对话，避免被同 session 中上一个 goal
-     * 的成功响应误判（实测在国内 deepseek 等网关上很容易出现"刚 set 完
-     * 立刻 achieved"的现象）。
-     */
-    buildStopConditionPrompt(goal: ActiveGoal): string;
-    /**
-     * 构造 `/goal <condition>` 设置完成后立即下发给 agent 的"启动消息"。
-     *
-     * 设计原因（与 Claude Code 行为对齐）：
-     *   - cc 的 `/goal` 设置后会立即 kick off agent run，而我们之前的实现只
-     *     注册了 Stop hook 等待用户下次输入触发 agent，导致表现"什么都没发生"；
-     *   - 把启动文案抽到 policy，方便 i18n 与单测断言。
-     *
-     * 返回 falsy（''/null/undefined）表示"不要 kick off"——给业务侧（或测试）
-     * 一个关闭自动启动的旁门。
-     */
-    buildKickoffMessage(condition: string): string;
-    messages: GoalMessages;
-}
-/** Hook callback 类型别名，方便 utils 引用。 */
-export type GoalPromptHookCallback = NonNullable<PromptHookDefinition['onResult']>;
-/** 内部使用：onResult 收到的回调入参。 */
-export type GoalPromptHookResult = PromptHookResult;
-/**
- * `/goal` 命令各种状态文案的"事件类型"枚举。
- *
- * 后端 GoalServiceImpl 把每条状态文案 emit 到 history 时同时挂上结构化的
- * `providerData.goalStatus`，让 Web UI / 其它 ACP 客户端拿到**与 locale
- * 无关**的事件 + 字段，自己用 i18n 字典渲染本地化文案。
- *
- * 列表与 `GoalServicePolicy.messages` 一一对应，方便后续新增字段时机械同步。
- */
-export type GoalStatusKind = 'usage' | 'too-long' | 'hooks-disabled' | 'set' | 'set-replaced' | 'cleared' | 'no-goal' | 'active' | 'paused' | 'resumed';
-export interface GoalStatusPayload {
-    kind: GoalStatusKind;
-    /** set / set-replaced / active / paused / resumed 携带新条件 */
-    condition?: string;
-    /** set-replaced / cleared 携带被替换/被清除的旧条件 */
-    prev?: string;
-    /** too-long 错误诊断字段 */
-    actual?: number;
-    max?: number;
-    /** set / active / paused 携带 goal.createdAt，给 Web UI 输入框 elapsed 用 */
-    createdAt?: number;
-    /** paused 携带冻结时刻，给 Web UI 冻 elapsed */
-    pausedAt?: number;
-}

package/cli/dist-server/types/node/goal/goal-service.d.ts

@@ -1,201 +0,0 @@
-/**
- * `/goal` 命令背后的 service 实现。
- *
- * Claude Code 官方文档定义：
- * > The /goal command is a built-in shortcut for a session-scoped
- * > prompt-based Stop hook.
- *
- * 实现思路：
- *  - `/goal <condition>` 通过 ScopedHookRegistry 注册一个 prompt-type Stop hook，
- *    scopeId 由 `policy.scopeIdFor(sessionId)` 生成（含 nonce 防漂移），
- *    并把 `condition` 与 scopeId 写入 `session.meta.activeGoal`。
- *  - hook 评估返回 `{ok:true}` 则模型自然停止，输出 "Goal achieved"，自动注销。
- *  - 评估返回 `{ok:false}` 则 hook 返回 block + continueRequest，模型继续工作。
- *  - 评估返回 `{ok:false, impossible:true}` 则视作"目标不可达"，停止循环，
- *    输出 "Goal could not be achieved: <reason>"，自动注销。
- *  - 通过 PromptHookDefinition.onResult 回调订阅评估结果。
- *
- * 设计点（可维护性 / 可测试性）：
- *  - 所有契约都从 `goal-protocol` 引入，方便业务侧只依赖 Symbol + interface。
- *  - 所有 mutable 副作用都封装在 protected 方法，便于子类化定制 / spy。
- *  - `configure({ policy, metrics })` 注入测试替身，无需绕开 DI。
- *  - onResult 回调先校验 `current.scopeId === goal.scopeId`，避免对早已被
- *    替换或清除的 goal 做副作用。
- */
-import { Logger } from '@genie/telemetry';
-import { AcpBroadcastService } from '../acp/acp-protocol';
-import { AgentService } from '../agent/agent-protocol';
-import { GoalResultItem } from '../agent/openai-agents-types';
-import { AcpDrainTrigger } from '../agent-task/agent-task-protocol';
-import { HookInput, PromptHookDefinition, PromptHookResult, ScopedHookRegistry } from '../hooks/hook-protocol';
-import { MessageQueueManager, Session, SessionManager } from '../session/session-protocol';
-import { ActiveGoal, GoalMetricSink, GoalService, GoalServicePolicy, GoalStatusPayload } from './goal-protocol';
-export declare class GoalServiceImpl implements GoalService {
-    protected readonly logger: Logger;
-    protected readonly scopedHookRegistry: ScopedHookRegistry;
-    protected readonly sessionManager: SessionManager;
-    /**
-     * AgentService 用 @Optional() 注入：
-     *   - 单测里我们不挂 AgentService（kick-off 可被 stub 关闭）；
-     *   - headless / 异常 IoC 场景下没有 AgentService 时 set() 仍然能完成
-     *     hook 注册，只是不会自动 kick off。
-     */
-    protected readonly agentService?: AgentService;
-    protected readonly acpBroadcastService?: AcpBroadcastService;
-    /**
-     * ACP / Web UI 的 kick-off 不能直接 runDefault：slash `/goal` 的 prompt 马上
-     * 就返回，createEventForwardingPromise 随之拆掉，后续模型事件到不了前端。
-     * 入队后由 AcpView.drainQueuedMessages 带着转发链路消费。
-     */
-    protected readonly messageQueueManager?: MessageQueueManager;
-    /**
-     * HTTP PUT / 暂停后继续 走 GoalService 时，当前并不在 AcpView.executePrompt 里，
-     * 只入队没有人 drain。注入 AcpDrainTrigger，把 kick-off 送进带转发的 drain。
-     */
-    protected readonly acpDrainTrigger?: AcpDrainTrigger;
-    /**
-     * 可注入的策略层。生产用 `DEFAULT_GOAL_POLICY`；测试可通过 configure() 替换。
-     * 故意 protected 而非 private，方便子类化做小幅定制。
-     */
-    protected policy: GoalServicePolicy;
-    /** 进行中的 Stop hook 对象，pause 时要就地关掉续跑。 */
-    protected readonly goalHooks: Map<string, PromptHookDefinition>;
-    /** 可注入的 metric 发送器；默认走 logger。 */
-    protected metrics: GoalMetricSink;
-    protected init(): void;
-    /** 测试钩子：替换 policy / metrics（例：service.configure({ policy: stub })). */
-    configure(opts: Partial<{
-        policy: GoalServicePolicy;
-        metrics: GoalMetricSink;
-    }>): void;
-    set(session: Session, condition: string): Promise<void>;
-    clear(session: Session): Promise<void>;
-    pause(session: Session): Promise<void>;
-    resume(session: Session): Promise<void>;
-    show(session: Session): Promise<void>;
-    restoreFromMeta(session: Session): Promise<void>;
-    has(session: Session): boolean;
-    get(session: Session): ActiveGoal | undefined;
-    /**
-     * 倒序扫 session.history 找最近一条 goal-result 终态项。复杂度 O(n)，
-     * goal 终态项稀疏（一次 /goal 周期才一条），实测开销可忽略。
-     *
-     * 注意：history 直接持有 AgentInputItem 引用，调用方不应就地修改。
-     * 这里 cast 为 GoalResultItem——`type === 'goal-result'` 已是判别量。
-     */
-    getLatestResult(session: Session): GoalResultItem | undefined;
-    protected registerGoalHook(session: Session, goal: ActiveGoal): void;
-    protected unregisterHook(scopeId: string): void;
-    protected persistMeta(session: Session): Promise<void>;
-    protected setMeta(session: Session, goal: ActiveGoal): void;
-    protected clearMeta(session: Session): void;
-    protected areHooksDisabled(): boolean;
-    /**
-     * `set()` 完成后的"启动 agent run"副作用。
-     *
-     * 抽成独立 protected 方法的好处：
-     *   - 单测可以 spy / stub 它，断言 set() 是否在正确时机触发；
-     *   - 未来切换为"通过 message queue 入队"或"延迟一个 tick"等策略时不动 set()。
-     *
-     * 实现细节：
-     *   - 走 policy 拿启动文案（i18n / 业务定制点）；
-     *   - 把 kick-off 消息标记为 `providerData.isMeta=true`，与 cc 行为对齐：
-     *     模型在 transcript 里能看到目标条件，但 UI 不渲染这条 user message
-     *     （`conversation-box.tsx` / `queue-display.tsx` / `structured-output-view-filter`
-     *      均按 isMeta 过滤）。
-     *   - 走 @Optional 注入的 AgentService，若不可用（headless 极简栈 / 单测）
-     *     则跳过 + warn，set() 仍然完成，hook 仍然注册；
-     *   - fire-and-forget；任何异常落 logger，不冒泡到调用方。
-     */
-    protected kickoffAgentRun(session: Session, condition: string): Promise<void>;
-    /**
-     * `/goal` slash 自己的 skipRun 窗口。AgentService.run() 先 RUN_PREPARING
-     * 再进命令拦截器，这时 abort 会掐掉正在执行的这次 slash，随后 triggerDrain
-     * 被 aborted 守卫丢掉——Web UI 手打 `/goal` 换条件会自伤。
-     */
-    private static readonly SLASH_OWNED_STATUSES;
-    /**
-     * Web UI 与独立 TUI 暂停要打断当前回合。WorkBuddy `--acp`（有 acp、无 webUiAcp）
-     * 保持旧语义，只卸 hook。
-     */
-    protected shouldAbortOnPause(session: Session): boolean;
-    protected isRunInFlight(session: Session): boolean;
-    protected abortInFlightRun(session: Session): void;
-    protected ensureAbortControllerReady(session: Session): void;
-    protected replaceAbortController(session: Session): void;
-    /**
-     * 读取 session.usage.totalTokens 作为统计起点 / 终点。
-     * - usage 字段在 fresh session 上是 Usage 实例（含 totalTokens 数值）。
-     * - 单测 / 老 session 上 usage 可能不存在，按 0 处理避免 NaN。
-     */
-    protected readSessionTokens(session: Session): number;
-    /**
-     * 给当前 active goal 累加 turn 计数并持久化到 session.meta。
-     * 防漂移：找不到 goal（已被替换 / 清除）时静默忽略。
-     */
-    protected bumpTurnCount(session: Session, delta: number): void;
-    /**
-     * 把 stdout 文本以 local-command-stdout 形式写入 session.history。
-     *
-     * `status` 参数可选：当 emit 的是 /goal 状态文案（set / cleared / active 等）
-     * 时，调用方传入结构化 GoalStatusPayload。该 payload 会写到
-     * `providerData.goalStatus`，让 ACP 转换层把它转成 `session_info_update +
-     * _meta` 推 Web UI 用 i18n 渲染（Web UI 不依赖英文文本格式）；TUI 仍按
-     * stdout 原样渲染英文文案，与 cc parity 保持一致。
-     */
-    protected emit(session: Session, text: string, status?: GoalStatusPayload): Promise<void>;
-    /**
-     * Prompt hook 的 onResult 回调。
-     * 注意：hook-manager 已经处理了 block / continueRequest 逻辑；这里只负责
-     *   - 在 ok:true（达成）和 impossible（不可达）两种「终态」时清理 hook + UI 提示
-     *   - ok:false（条件还没满足）维持现状，模型仍被 block 着工作
-     *
-     * 防御性：回调可能在用户已经手动 `/goal clear` 或替换为新 goal 之后才异步
-     * 触发，这种情况下不应对当前 session.meta 做副作用。
-     */
-    protected handleHookResult(session: Session, goal: ActiveGoal, result: PromptHookResult, _input: HookInput): Promise<void>;
-    /**
-     * 把 stop-hook evaluator 的 reason 反馈给模型（cc parity）。
-     *
-     * 设计要点：
-     *   - 只在 reason 非空时 emit——空 reason 喂给模型只是噪声；
-     *   - 文本格式与 cc jsonl 严格对齐："Stop hook feedback: [<condition>]: <reason>"
-     *     这样模型在 transcript 里看到的格式是它训练时见过的稳定模式；
-     *   - providerData.isMeta=true 让 UI 过滤（避免用户看到内部反馈条），
-     *     同时也能被 SystemReminderAgentRunInterceptor 等识别为非真实用户输入。
-     *   - 不参与对话链（无 parentId）：这是个旁路注入，不影响树结构。
-     */
-    protected emitFeedbackToModel(session: Session, _goal: ActiveGoal, reason?: string): Promise<void>;
-    /**
-     * 把 goal 变更推给 Web UI。slash 路径还有 combineSubject，HTTP API / idle 连接只靠这里。
-     */
-    protected notifyAcpClients(session: Session, item?: {
-        type?: string;
-        providerData?: unknown;
-    }, busy?: boolean): Promise<void>;
-    /**
-     * 把 goal 终态结果以 `goal-result` history item 形式写入 session.history。
-     * 由 chat-view 的 GoalResultMessageBox 渲染为可折叠状态条（对齐 cc UI）。
-     *
-     * 字段语义：
-     *   - durationMs：goal.createdAt 起到现在的耗时
-     *   - turnCount：至少 1（防御 0 turn 异常 case，UI 不显示 "0 turns"）
-     *   - tokenDelta：(当前 totalTokens - tokensAtStart)，下界 0
-     */
-    protected emitGoalResult(session: Session, goal: ActiveGoal, outcome: {
-        ok: boolean;
-        reason?: string;
-    }): Promise<void>;
-    /**
-     * 把 goal 进行中状态以 `goal-progress` history item 形式写入 session.history。
-     * 由 chat-view 的 GoalProgressMessageBox 渲染为 cc 同款可折叠状态条
-     * `◯ Goal not yet met… continuing`。
-     *
-     * 触发时机：每次 stop-condition hook 评估返回 ok:false（非 impossible），
-     * 表示模型还要继续工作。reason 来自 evaluator 的判定理由，仅在用户
-     * Ctrl+O 展开时才显示，避免污染对话流。
-     *
-     * 不参与对话链，也不喂给 LLM —— 由 CUSTOM_INPUT_ITEM_TYPES 兜底过滤。
-     */
-    protected emitGoalProgress(session: Session, goal: ActiveGoal, reason?: string): Promise<void>;
-}

package/cli/dist-server/types/node/goal/goal-session-start-hook.d.ts

@@ -1,24 +0,0 @@
-/**
- * SessionStart hook：在 session 恢复（`source === 'resume'` / `'compact'`）
- * 时，根据 `session.meta.activeGoal` 重新注册 prompt-type Stop hook。
- *
- * 走 internal Hook 路径而非命令拦截器，是因为：
- *   1. SESSION_START 事件已经是 hooks 系统的标准入口；不必为 /goal 专门接
- *      session-manager 生命周期。
- *   2. Hook 自带 priority + source 匹配，与 `StructuredOutputSessionStartHook`
- *      模式一致，新增/移除都是局部改动，可维护。
- *   3. 单测时只需 mock GoalService，断言 restoreFromMeta 是否被调用。
- *
- * 不抛错 / 不阻塞：恢复失败不应阻断 session 启动，只记录 warn。
- */
-import { Logger } from '@genie/telemetry';
-import { Hook, HookEvent, HookExecutionResult, HookInput, HookPriority } from '../hooks/hook-protocol';
-import { GoalService } from './goal-protocol';
-export declare class GoalSessionStartHook implements Hook {
-    readonly event = HookEvent.SESSION_START;
-    readonly priority = HookPriority.Normal;
-    protected readonly logger: Logger;
-    protected readonly goalService: GoalService;
-    protected init(): void;
-    execute(input: HookInput): Promise<HookExecutionResult | undefined>;
-}

package/cli/dist-server/types/node/hooks/parse-frontmatter-hooks.d.ts

@@ -1,42 +0,0 @@
-/**
- * Frontmatter hooks 解析
- *
- * 公共解析函数，用于从 agent `.md` / skill SKILL.md 的 frontmatter.hooks
- * 字段解析出 HookSettings。
- *
- * 对齐 Claude Code 行为：
- * - `~/workspace/claude-code-source/src/tools/AgentTool/loadAgentsDir.ts:424`
- * - `~/workspace/claude-code-source/src/skills/loadSkillsDir.ts:136`
- *
- * CC 两侧同名 `parseHooksFromFrontmatter` 是 copy-paste 关系，cbc 抽公共函数
- * 避免后续维护时漂移（FEEDBACK_DUPLICATE_NORMALIZE_PARSERS_SYNC 的典型反例）。
- */
-import type { Logger } from '@genie/telemetry';
-import { HookConfig, HookEvent } from './hook-protocol';
-/**
- * settings.json / frontmatter 中 hooks 字段的通用结构：
- * ```
- * hooks:
- *   PreToolUse:
- *     - matcher: "Bash"
- *       hooks:
- *         - type: command
- *           command: ./check.sh
- *           once: true
- * ```
- */
-export type HookSettings = Partial<Record<HookEvent | string, HookConfig[]>>;
-/**
- * 解析 frontmatter.hooks 字段为 HookSettings。
- *
- * - `raw` 是 undefined / 非对象 → 返回 undefined（不报错，视为未配置）
- * - 单个 event 的 HookConfig[] 不符合 schema → logger.warn 跳过该 event，
- *   其他 event 正常解析（最大努力原则）
- * - 未知的 event key → logger.warn 跳过
- * - 所有 event 都解析失败 → 返回 undefined
- *
- * @param raw 原始 frontmatter.hooks 值
- * @param sourceLabel 用于日志的来源标签，如 "agent 'code-reviewer'"
- * @param logger telemetry logger
- */
-export declare function parseFrontmatterHooks(raw: unknown, sourceLabel: string, logger: Logger): HookSettings | undefined;

package/cli/dist-server/types/node/install/index.d.ts

@@ -1,6 +0,0 @@
-export * from './install-controller';
-export * from './install-env';
-export * from './install-protocol';
-export * from './install-service';
-export * from './releases-service';
-export * from './shell-setup';

package/cli/dist-server/types/node/install/install-controller.d.ts

@@ -1,15 +0,0 @@
-import { Logger } from '@celljs/core';
-import { ConsoleManager } from '../console';
-import type { InstallOptions, InstallResult } from './install-protocol';
-import { InstallService } from './install-protocol';
-export declare class InstallController {
-    protected readonly logger: Logger;
-    protected readonly installer: InstallService;
-    protected readonly consoleManager: ConsoleManager;
-    install(options: InstallOptions): Promise<InstallResult>;
-    private displayResult;
-    private displaySuccess;
-    private displayPathInstructions;
-    private displayProgress;
-    private displayError;
-}

package/cli/dist-server/types/node/install/install-env.d.ts

@@ -1,12 +0,0 @@
-import { homedir, platform } from 'node:os';
-import { FileSystem } from '@genie/runtime';
-import { InstallEnvironment } from './install-protocol';
-export declare class InstallEnvironmentImpl implements InstallEnvironment {
-    readonly fs: FileSystem;
-    platform: typeof platform;
-    arch: () => NodeJS.Architecture;
-    homedir: typeof homedir;
-    versiondir(app: string): string;
-    bindir(app: string): string;
-    findCmd(cmd: string): Promise<string | undefined>;
-}