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

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

@@ -1,127 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
-import { SettingsManager } from '../settings/settings-protocol';
-import { AgentCompletionWaiter, AgentManager, AgentService, type RunRequest } from '../../vendor/cbc-core/node/index.js';
-export declare class AgentController {
-    /**
-     * Standard HTTP headers that should be filtered out
-     * Only custom/extension headers will be preserved for model requests
-     */
-    private static readonly STANDARD_HEADERS;
-    protected readonly agentService: AgentService;
-    protected readonly sessionManager: SessionManager;
-    protected readonly agentManager: AgentManager;
-    protected readonly logger: Logger;
-    protected readonly completionWaiter: AgentCompletionWaiter;
-    protected readonly settingsManager: SettingsManager;
-    /**
-     * stdio stream-json 长轮询旁路（B1）的 park 超时。到点返回空响应让客户端重开一条，
-     * 避免长轮询无限挂起、也让心跳/断线可控。
-     */
-    private static readonly DRAIN_WAIT_TIMEOUT_MS;
-    /**
-     * 把客户端随本条 prompt 透传的自定义 header 写入本轮 session，供 ModelProvider 在每次
-     * 出站模型请求时转发到 model gateway。安全约束：
-     * - 仅来源于 stream-json `_meta['codebuddy.ai'].customPassthroughHeaders`（不复用 loopback
-     *   HTTP header 的 filterHeaders denylist——那是另一条通道）。
-     * - 经启动期前缀白名单 `CODEBUDDY_PASSTHROUGH_HEADER_PREFIXES`（默认空 ⇒ 功能关闭）过滤
-     *   （见 passthrough-header-policy）；前缀即安全边界，部署方须选与内部 `X-*` header 命名
-     *   空间不相交的前缀。
-     * - **每轮 set-or-clear**：不带该字段的后续 prompt 不会继承上一轮的值，保证 per-turn 语义。
-     *   本 slot 只归本特性所有且 run() 每轮执行一次，故无需 finally 恢复。
-     */
-    private applyCustomPassthroughHeaders;
-    /**
-     * Filter and keep only custom/extension headers
-     * Standard HTTP headers are filtered out
-     */
-    private filterHeaders;
-    /**
-     * GET /agent/models
-     *
-     * Returns the list of available models for the default agent.
-     * Used by Desktop UI to populate the model selector before a session is created.
-     */
-    getModels(): Promise<{
-        models: Array<{
-            id: string;
-            name: string;
-            description?: string;
-            _meta?: Record<string, unknown>;
-        }>;
-    }>;
-    run(request: RunRequest, headers: Record<string, string>): Promise<Session>;
-    /**
-     * 处理 stdio stream-json 的 drain-wait 长轮询请求（B1 旁路）。
-     *
-     * @returns true  → 需要走正常 StreamJsonView 渲染（本轮确实发起了 drain-run）
-     *          false → 已在本方法内直接写空响应并 end，调用方应返回 undefined 阻止 view 渲染
-     */
-    private handleDrainWait;
-    /**
-     * 发起一次 drain-run，并回答「这一轮真的跑起来了吗」。
-     *
-     * 为什么发起前的 `canDrainNow` 不够：它只在**派发之前**看一眼状态机，挡不住这个窗口
-     * ——检查通过之后、拦截器做决策之前，一条真实 prompt 抢先把 session 推离 idle，于是这条
-     * 空 input 的 drain-run 照样被 `skipRun`（input-interceptors 的队列路由），一个队列项都
-     * 没消费、也没产出自己的 RunResult。
-     *
-     * 这时若仍返回 true 让调用方走正常渲染，`StreamJsonView.render` 会从 `resultSubject`
-     * 绑到**上一轮**那条早已 completed 的 RunResult，再靠它的「漏结束补发」把上一轮的结束
-     * 当成本轮的结束写到 stdout。下游 sandbox-proxy 见到 `type=result` 立刻发 endTurn 收流，
-     * 刚进来的那条真实 prompt 于是只剩 query、没有 response（现场：第二条 prompt 写入 229ms
-     * 后就冒出一条 `duration_ms=29280` 的 result，而真正的回答 34 秒后才生成，已无处可去）。
-     *
-     * 判据取 `resultSubject` 的**对象身份**，而不是再查一次状态机：被 `skipRun` 的 run 在
-     * `runner.run` 之前就返回，永远不会 `resultSubject.next`，所以「引用没变」是「这一轮没
-     * 产出」的直接证据，不依赖任何时序假设。真跑起来的 drain 必定推入一条新的 RunResult，
-     * 行为逐字节不变。
-     *
-     * 没产出时走的是本方法族既有的安全出口：写空响应、返回 false，客户端据此重开一条新的
-     * 长轮询，队列项由 `IdleQueueDrainService` / `BackgroundTaskNotifier` 的 idle 重投兜底。
-     */
-    private dispatchDrainRun;
-    /**
-     * 本轮 drain-run 现在能否真正跑起来并消费掉队列项。
-     *
-     * 判据取 `isIdle`，与**发起 drain 的那一族**完全同源：
-     * - `BackgroundTaskNotifier.scheduleDrain` 用 `isBusy` 双重把关，其
-     *   `dispatchDrain` 注释明写「调用方已确认 session 活着、idle、未 abort」
-     *   （background-task-notifier.ts:375/383/390）；
-     * - `BackgroundTaskNotifier.tryIdleRetry` 用 `isIdle`（background-task-notifier.ts:491）；
-     * - `AcpView` 的同族 drain 循环同样用 `isIdle`（acp-view.ts:2007）。
-     *
-     * 刻意**不用** `isBusyForQueue`：那是 `MessageQueueAgentRunInterceptor` 的**队列路由**
-     * 判据，它把 `PREPARING` 当作不忙，目的是避免首个真实请求在启动期被误入队
-     * （session-run-state-machine.ts:236-238）。drain-wait 是后台旁路，语义相反——另一个
-     * 真实 prompt 已进入启动期时，它必须让路，而不是抢先发起空 drain 去争
-     * `session.queue` 与 `abortController`。
-     *
-     * 为什么这个前提不可省：queue-busy 期间的空 input drain-run **必定**被拦截器
-     * `skipRun`（input-interceptors.ts:90-98），不消费任何队列项，却仍会走
-     * `AgentService.runDefault` → `createRunStartupController`，后者在拦截器决策**之前**
-     * 就无条件改写 `session.abortController` / `abortSignal`（agent-service.ts:165）。而
-     * 该 controller 的身份正是 `agent-service.ts:548 newerPhysicalRunOwnsSession` 判断
-     * 「是否有新 physical run 接管」、以及 skipRun 安全网决定要不要 `forceIdle` 的权威依据。
-     * 一旦某轮 run 卡在非 idle 态，队列不再下降、快路径每次长轮询都命中，客户端 500ms 就
-     * 重开一条（cli-executor.ts:530），该判据被持续污染 → 卡住的 run 再也无法被安全网收回
-     * idle，用户 Stop 已 abort 的 controller 也会被顶掉。
-     *
-     * 只加前提、不改 drain 本身：可 drain 时行为逐字节不变。busy 期的队列项不会丢——
-     * `IdleQueueDrainService` 在 `agent_end` 后兜底 drain（idle-queue-drain-service.ts:84），
-     * `BackgroundTaskNotifier` 另有常驻 idle 重投。
-     *
-     * 用协议级纯函数而不注入 `SessionRunStateMachine`：协议明确要求两者保持一致
-     * （session-run-state-machine-protocol.ts:143-152），且避免给 controller 增加硬 DI
-     * 依赖——精简/测试容器未装配该组件时会导致整个 controller 实例化失败。
-     */
-    private canDrainNow;
-    /** 解析 StreamJsonDrainTrigger（可选：ACP/纯 print 等模式下可能未注册）。 */
-    private resolveDrainTrigger;
-    /**
-     * drain-wait 无事发生（超时/冲突）时的空响应：不写任何 NDJSON 消息，直接以
-     * stream-json content-type 结束。客户端 handleStreamResponse 收到 end 即 resolve，
-     * 立刻重开下一条长轮询。
-     */
-    private writeEmptyDrainResponse;
-}

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

@@ -1,77 +0,0 @@
-import { Agent } from '@genie/product';
-export type AgentDisplaySource = 'user' | 'project' | 'managed' | 'plugin' | 'cli-arg' | 'built-in';
-export interface AgentSourceGroup {
-    readonly label: string;
-    readonly source: AgentDisplaySource;
-}
-/**
- * Ordered list of agent source groups for display. Mirrors Claude Code's
- * `AGENT_SOURCE_GROUPS` so `codebuddy agents` reads like `claude agents`.
- * genie has no `local` scope, so that group is intentionally omitted.
- */
-export declare const AGENT_SOURCE_GROUPS: readonly AgentSourceGroup[];
-export interface AgentDisplayInfo {
-    readonly name: string;
-    /** Picker / list label; falls back to `name` when unset. */
-    readonly displayName?: string;
-    readonly source: AgentDisplaySource;
-    /** 文本行展示用模型标签（逗号拼接，未声明为 'inherit'，对齐 CC）。 */
-    readonly model: string;
-    /** 声明的模型列表（JSON 输出用）；未声明时为空数组，JSON 输出 null（继承）。 */
-    readonly models: readonly string[];
-    readonly description?: string;
-    /** 持久记忆 scope（user/project/local），对齐 Claude Code 列表展示。 */
-    readonly memory?: string;
-    /** 工具集（显式白名单）；继承全部工具时为空，JSON 输出为 '*'。 */
-    readonly tools?: readonly string[];
-}
-export interface GroupedAgents {
-    readonly groups: ReadonlyArray<{
-        readonly group: AgentSourceGroup;
-        readonly agents: AgentDisplayInfo[];
-    }>;
-    readonly total: number;
-}
-/** Options for {@link isHiddenAgent} / {@link classifyAgentSource}. */
-export interface AgentDisplayOptions {
-    /**
-     * Keep internal generator agents (compact, contextSummary, classifiers, …)
-     * in the list. The `/agents` TUI panel needs them visible because they carry
-     * the "Enter to edit model" affordance (Issue #66763); the `codebuddy agents`
-     * CLI hides them for Claude Code parity (`claude agents` doesn't list them).
-     */
-    includeInternal?: boolean;
-}
-/**
- * Whether an agent config should be hidden from the user-facing list.
- * Always excludes the main/default agent and the synthetic `fork` agent;
- * internal generator agents (compaction, summaries, classifiers, …) are
- * excluded unless `includeInternal` is set (see {@link AgentDisplayOptions}).
- */
-/** Product default (`cli`) carries the `default` tag and is hidden from `/agents` lists. */
-export declare function isProductDefaultAgent(agent: {
-    tags?: readonly string[];
-}): boolean;
-export declare function isHiddenAgent(agent: Agent, options?: AgentDisplayOptions): boolean;
-/**
- * Classify a product `Agent` into its display source group, or `undefined` when
- * the agent should not be listed. The product configuration is already merged
- * across scopes/providers, so every listed agent is the winning definition.
- */
-export declare function classifyAgentSource(agent: Agent, options?: AgentDisplayOptions): AgentDisplaySource | undefined;
-/**
- * Model label for display: declared model(s), or `inherit` when unset (the agent
- * inherits the main session model at runtime).
- */
-export declare function resolveAgentModelDisplay(agent: Agent): string;
-/** `name · model · <scope> memory` — 对齐 Claude Code 的 agents 列表行展示。 */
-export declare function formatAgentLine(info: AgentDisplayInfo): string;
-/**
- * Group and sort product agents by display source. Agents that shouldn't be
- * listed are dropped, and empty groups are omitted.
- */
-export declare function groupAgentsForDisplay(agents: readonly Agent[]): GroupedAgents;
-/** Render the human-readable `codebuddy agents` output. */
-export declare function renderAgentsList(grouped: GroupedAgents): string;
-/** Render machine-readable JSON for `codebuddy agents --json`. */
-export declare function renderAgentsJson(grouped: GroupedAgents): string;

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

@@ -1,69 +0,0 @@
-import { type AgentLoopCancellation, AgentLoopInteraction, AgentLoopTelemetry, AgentManager, AgentPluginRefresh, AgentQueueOutput, type AgentRunInterceptor, AgentRunObserver, AgentRunSettings, type AgentRunSettingsValues, AgentRuntimeResolver, AgentToolRuntime, RunnerModelProvider, type Session, SessionManager, type ToolCallLoopEventKind, type ToolCallLoopEvidence } from '../../vendor/cbc-core/node/index.js';
-import type { Agent } from '../../vendor/cbc-shared/node/index.js';
-import { Logger } from '@genie/telemetry';
-import { AcpBroadcastService } from '../acp/acp-protocol';
-import { ModelProvider } from '../model/model-protocol';
-import { PluginRuntimeRefreshService } from '@genie/cbc-plugins';
-import { SettingsManager } from '../settings';
-import { TelemetryService } from '../telemetry/telemetry-protocol';
-import { ToolArgumentRewriteService } from '../tools/tool-protocol';
-import { MainAgentGateProvider } from './main-agent-resolver';
-export declare class CliAgentRuntimeResolver implements AgentRuntimeResolver {
-    protected readonly agentManager: AgentManager;
-    protected readonly sessionManager: SessionManager;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly mainAgentGateProvider?: MainAgentGateProvider;
-    protected readonly logger: Logger;
-    resolveAgentForSession(session?: Session): Promise<Agent>;
-}
-export declare class CliAgentPluginRefresh implements AgentPluginRefresh {
-    protected readonly refresh?: PluginRuntimeRefreshService;
-    waitForRefreshSettled(): Promise<void>;
-    waitForComposePluginsReady(): Promise<void>;
-}
-export declare class CliAgentToolRuntime implements AgentToolRuntime {
-    protected readonly argumentRewrite: ToolArgumentRewriteService;
-    rewriteArguments(argumentsText: string): unknown;
-    enterToolCall(callId: string, toolName: string, sessionId?: string): void;
-    leaveToolCall(callId: string): void;
-    isPolicyDeniedResult(output: unknown): output is {
-        terminal: {
-            reason: 'policy-denied';
-            finalOutput: string;
-        };
-    };
-}
-export declare class CliAgentQueueOutput implements AgentQueueOutput {
-    protected readonly broadcast?: AcpBroadcastService;
-    broadcastMessageQueueUpdate(sessionId: string, queueData: Record<string, unknown>): Promise<void>;
-    broadcastUserMessage(...args: Parameters<AgentQueueOutput['broadcastUserMessage']>): Promise<void>;
-}
-export declare class CliAgentRunSettings implements AgentRunSettings {
-    protected readonly settings: SettingsManager;
-    get<K extends keyof AgentRunSettingsValues>(key: K): Promise<AgentRunSettingsValues[K]>;
-}
-export declare class CliRunnerModelProvider implements RunnerModelProvider {
-    protected readonly provider: ModelProvider;
-    getModel(modelName: Parameters<RunnerModelProvider['getModel']>[0]): ReturnType<RunnerModelProvider['getModel']>;
-}
-export declare class CliAgentRunObserver implements AgentRunObserver {
-    enterJobActivity(): () => void;
-    resolveInterceptorName(interceptor: AgentRunInterceptor): string;
-    markStart(phase: string, label?: string): void;
-    markEnd(phase: string): void;
-    begin(phase: string, label: string): unknown;
-    end(span: unknown, status?: 'error'): void;
-    private profiler;
-}
-export declare class CliAgentLoopTelemetry implements AgentLoopTelemetry {
-    protected readonly telemetry: TelemetryService;
-    reportUserTaskFailedCreditRefund(session: Session, reason: 'loop_detected'): Promise<void>;
-    reportToolCallLoopEvent(kind: ToolCallLoopEventKind, session: Session, evidence: ToolCallLoopEvidence): Promise<void>;
-}
-export declare class CliAgentLoopInteraction implements AgentLoopInteraction {
-    readonly cancelReasonKey: "codebuddy.ai/cancelReason";
-    readonly cancelledReason: "tool_call_loop_stopped";
-    readonly interceptType: "tool-call-loop";
-    isEnabled(): boolean;
-    getCancellationForSession(session: Session): AgentLoopCancellation | undefined;
-}

package/cli/dist-server/types/node/agent/custom-agent-identity.d.ts

@@ -1,54 +0,0 @@
-/**
- * New custom agents created by AI must be a single lowercase hyphenated id.
- * Existing on-disk agents are NOT required to match this — WorkBuddy and
- * older CLI users may already have mixed-case or underscored names.
- */
-export declare const NEW_CUSTOM_AGENT_NAME_PATTERN: RegExp;
-export type CustomAgentNameFailure = 'invalid' | 'reserved';
-export interface CustomAgentNameOk {
-    readonly ok: true;
-    readonly name: string;
-}
-export interface CustomAgentNameErr {
-    readonly ok: false;
-    readonly reason: CustomAgentNameFailure;
-}
-export type CustomAgentNameInspection = CustomAgentNameOk | CustomAgentNameErr;
-/**
- * Names that must not be minted by create-by-AI (SmartMerge would overlay
- * the shipped agent). Load path does not use this set — existing files stay
- * visible so WorkBuddy / legacy custom agents keep working.
- */
-export declare function reservedCustomAgentNames(): ReadonlySet<string>;
-/**
- * Path-safety only: one segment, no traversal, no absolute, no NUL.
- * Allows mixed case / underscores so existing WorkBuddy agents still load.
- */
-export declare function isSafeCustomAgentPathSegment(name: unknown): name is string;
-export declare function inspectNewCustomAgentName(name: unknown): CustomAgentNameInspection;
-export declare function describeCustomAgentNameFailure(reason: CustomAgentNameFailure): string;
-/**
- * Resolve `<directory>/<name>.md` and refuse anything that escapes `directory`.
- * `name` must be a safe path segment (not the stricter create-by-AI pattern),
- * so delete/open of existing mixed-case agents still works.
- */
-export declare function resolveCustomAgentFilePath(directory: string, name: string): string;
-/**
- * Containment check for management operations (write / delete / open).
- *
- * `PathUtils.isPathInside` is a string-prefix test, so a symlink placed inside
- * the agents directory passes it while the OS resolves to a target elsewhere —
- * `unlink` would then follow the link and an editor would open the target. So
- * resolve both sides with `realpath` before comparing.
- *
- * Lexical mismatch is not enough to refuse: macOS `/var` and `/private/var`
- * are the same directory after realpath. Only the resolved paths decide.
- *
- * Non-existent paths are expected (create writes a new file): fall back to the
- * deepest existing ancestor. Do not use that fallback for a dangling symlink —
- * the hop chain already decided whether its target escapes.
- *
- * Async on purpose — this runs on the daemon's HTTP path (`/api/v1/agents/*`),
- * where a sync realpath on a slow/network filesystem would block the loop.
- */
-export declare function assertCustomAgentFileContained(filePath: string, baseDirectory: string): Promise<void>;

package/cli/dist-server/types/node/agent/custom-agent-manager.d.ts

@@ -1,43 +0,0 @@
-import { Logger } from '@celljs/core';
-import { ProductManager } from '@genie/product';
-import { ConsoleManager } from '../console';
-import { type Session, SessionManager } from '../../vendor/cbc-core/node/index.js';
-import { AgentService, CreateCustomAgentResult, CustomAgent, CustomAgentManager, CustomAgentScope } from '../../vendor/cbc-core/node/index.js';
-import { CustomAgentPathRegistry } from './custom-agent-path-registry';
-export declare class CustomAgentManagerImpl implements CustomAgentManager {
-    protected readonly productManager: ProductManager;
-    protected readonly sessionManager: SessionManager;
-    protected readonly agentService: AgentService;
-    protected readonly logger: Logger;
-    protected readonly consoleManager: ConsoleManager;
-    protected readonly customAgentPathRegistry?: CustomAgentPathRegistry;
-    protected customAgents: CustomAgent[];
-    init(): void;
-    /**
-     * Build the model catalog exposed to the one-time agent generator.
-     * Keep it derived from the current ProductConfiguration (the same filtered
-     * source used by `/model`) and omit endpoint/key fields.
-     */
-    private getAiModelChoices;
-    /**
-     * Normalize the model selected by the generator. Exact IDs are preferred,
-     * but display names and aliases are accepted for natural-language output.
-     * Unknown/disabled models fail closed to parent-model inheritance.
-     */
-    private resolveAiModel;
-    private buildAiModelPrompt;
-    private agentSettingsWithAI;
-    private static readonly AI_TOOLS_FALLBACK;
-    private resolveAiTools;
-    private createAgentMd;
-    private loadCustomAgents;
-    private getSavePath;
-    createByAI(session: Session, description: string, scope: CustomAgentScope): Promise<CreateCustomAgentResult>;
-    delete(agentName: string): Promise<void>;
-    get(agentName: string): CustomAgent | undefined;
-    getAll(): CustomAgent[];
-    resolveSettingsPath(agent: CustomAgent): Promise<string>;
-    openSettings(agent: CustomAgent, options?: {
-        allowTerminalEditor?: boolean;
-    }): Promise<void>;
-}

package/cli/dist-server/types/node/agent/custom-agent-path-registry.d.ts

@@ -1,19 +0,0 @@
-/**
- * Maps loaded custom-agent names to their original markdown file paths.
- *
- * `CustomAgentsProductProvider` scans `.codebuddy/agents` recursively and is the
- * only place that knows the real file (including subdirectories and files whose
- * frontmatter `name` differs from the file name). It records that path here so
- * `CustomAgentManager` can delete/open the exact file without re-scanning or
- * carrying agent-cli internals on the shared product `Agent` type.
- *
- * The registry is rebuilt on every product provider pass (`clear()` then `set()`),
- * so it cannot go stale across config hot-reloads.
- */
-export declare class CustomAgentPathRegistry {
-    private readonly paths;
-    set(name: string, filePath: string): void;
-    get(name: string): string | undefined;
-    delete(name: string): void;
-    clear(): void;
-}

package/cli/dist-server/types/node/agent/insights-data-agent-run-interceptor.d.ts

@@ -1,67 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { PromptRenderer } from '../../vendor/cbc-core/node/index.js';
-import { SessionRunStateMachine } from '../../vendor/cbc-core/node/index.js';
-import { SettingsManager } from '../settings';
-import { InsightsReportService, SessionFacetService, StatsService } from '../stats';
-import { AgentRunInterceptor, AgentRunRequest } from '../../vendor/cbc-core/node/index.js';
-/**
- * Insights 数据 Agent 运行拦截器
- *
- * 对齐 Claude Code 的增量 facet 架构：
- * 1. 通过 SessionFacetService 增量分析每个 session（跳过未变化的）
- * 2. 聚合所有 per-session facet 数据 + 全局统计数据
- * 3. 并行发送 7 个汇总请求（基于聚合数据）
- * 4. 发送第 8 个 at-a-glance 请求
- * 5. 生成 HTML 报告并替换占位符
- */
-export declare class InsightsDataAgentRunInterceptor implements AgentRunInterceptor {
-    priority: number;
-    protected readonly statsService: StatsService;
-    protected readonly sessionFacetService: SessionFacetService;
-    protected readonly promptRenderer: PromptRenderer;
-    protected readonly reportService: InsightsReportService;
-    protected readonly logger: Logger;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly stateMachine: SessionRunStateMachine;
-    intercept(request: AgentRunRequest): Promise<void>;
-    /**
-     * 从 per-session facets + 全局统计构建聚合数据
-     * 这是发送给 7 个汇总请求的输入
-     */
-    private buildAggregatedData;
-    /**
-     * 渲染模板
-     */
-    private renderPrompt;
-    /**
-     * 并行发送 7 个汇总分析请求
-     */
-    private runAggregateRequests;
-    /**
-     * 构建 facet 摘要（供 at-a-glance 使用）
-     */
-    private buildFacetSummary;
-    /**
-     * 发送 at-a-glance 汇总请求
-     */
-    private runConsolidationRequest;
-    /**
-     * 组装最终 InsightsData
-     */
-    private assembleInsightsData;
-    private parseJsonResponse;
-    private getFallback;
-    private replacePlaceholder;
-    /**
-     * 更新 loading box 中的进度文本
-     */
-    private emitProgress;
-    /**
-     * 清除进度文本，恢复默认 loading phrase
-     */
-    private clearProgress;
-    /**
-     * 检查 abort 信号，如果已取消则抛出 AbortError
-     */
-    private throwIfAborted;
-}

package/cli/dist-server/types/node/agent/interceptor-name-registry.d.ts

@@ -1,4 +0,0 @@
-/** 解析拦截器的稳定名称，用于 trace span 命名，避免生产压缩后的乱码类名。 */
-export declare function resolveInterceptorName(interceptor: {
-    constructor: Function;
-}): string;

package/cli/dist-server/types/node/agent/interceptors/channel-event-interceptor.d.ts

@@ -1,44 +0,0 @@
-import { Logger } from '@genie/telemetry';
-import { ChannelEventService, ChannelManager } from '../../channel';
-import { AgentRunInterceptor, AgentRunRequest } from '../../../vendor/cbc-core/node/index.js';
-/**
- * Channel Event Injection Interceptor
- *
- * 在 Agent 执行前从 session 的待处理 channel 事件队列消费事件
- * 并将其格式化为 `<channel>` 标签注入到请求的 input 末尾（作为系统提醒）
- *
- * 优先级：1170 - 在 SystemReminderContext (1200) 之后，MessageReorganize (1300) 之前
- * 这样做的好处：
- * 1. SystemReminder 在非收窄模式注入 channel instructions（指导说明）。
- *    极简没有 channel 发送工具，只保留本拦截器的事件正文。
- * 2. 本拦截器注入具体的 channel 事件（实际推送）
- * 3. MessageReorganize 最后再做消息整理
- */
-export declare class ChannelEventAgentRunInterceptor implements AgentRunInterceptor {
-    protected readonly logger: Logger;
-    protected readonly channelManager: ChannelManager;
-    protected readonly channelEventService: ChannelEventService;
-    priority: number;
-    intercept(request: AgentRunRequest): Promise<void>;
-    /**
-     * 将多个 channel 事件格式化为 XML 格式的系统提醒
-     * 格式: <system-reminder>
-     *   <channel source="...">...</channel>
-     *   <channel source="...">...</channel>
-     * </system-reminder>
-     */
-    private formatChannelEvents;
-    /**
-     * 格式化单个 channel 事件为 XML 格式
-     * 格式: <channel source="server-name" key="value">content</channel>
-     */
-    private formatChannelEvent;
-    /**
-     * 转义 XML 属性值中的特殊字符
-     */
-    private escapeXmlAttr;
-    /**
-     * 转义 XML 内容中的特殊字符
-     */
-    private escapeXmlContent;
-}

package/cli/dist-server/types/node/agent/interceptors/command-interceptors.d.ts

@@ -1,71 +0,0 @@
-import { Command, ProductManager } from '@genie/product';
-import { Logger } from '@genie/telemetry';
-import { CustomCommandRenderer, McpPromptRenderer } from '../../command';
-import { PromptRenderer } from '../../../vendor/cbc-core/node/index.js';
-import { SessionHookManager } from '../../../vendor/cbc-core/node/index.js';
-import { SettingsManager } from '../../settings/settings-protocol';
-import { AgentManager, AgentRunInterceptor, AgentRunInterceptorPriority, AgentRunRequest } from '../../../vendor/cbc-core/node/index.js';
-import { type AgentInputItem } from '../../../vendor/cbc-shared/node/index.js';
-export declare class AgentSwitchAgentRunInterceptor implements AgentRunInterceptor {
-    priority: AgentRunInterceptorPriority;
-    protected readonly agentManager: AgentManager;
-    protected readonly productManager: ProductManager;
-    protected readonly settingsManager: SettingsManager;
-    protected readonly promptRenderer: PromptRenderer;
-    protected readonly customCommandRenderer: CustomCommandRenderer;
-    protected readonly mcpPromptRenderer: McpPromptRenderer;
-    protected readonly logger: Logger;
-    protected readonly sessionHookManager: SessionHookManager;
-    intercept(request: AgentRunRequest): Promise<void>;
-    /**
-     * `/compact` 直接路由到 compact agent，不经过 ContextCompactSummarizer，
-     * 因此需要在这里单独触发 PreCompact。内部压缩回灌消息带有
-     * isCompactInternal，必须跳过以避免重复触发。
-     */
-    protected executeManualPreCompactHooks(request: AgentRunRequest): Promise<void>;
-    /**
-     * 从输入中提取命令名（不含 / 前缀）。
-     * 支持从 <channel> 标签包裹的文本中提取斜杠命令。
-     */
-    private extractInputCommandName;
-    protected resolveAgent<TAgent>(command: Command): Promise<TAgent | undefined>;
-    protected handleCommands(input: AgentInputItem[], commands: Command[]): Promise<Command | undefined>;
-    protected safeRender(promptToRender: string, ctx?: Record<string, any>): Promise<string>;
-    protected isCommand(text: string, command: Command): boolean;
-    /**
-     * 构建命令上下文标签（统一格式）
-     * 用于 MCP prompt 和 custom command，确保两者拼接给模型的格式一致
-     * @param commandName 命令名称（如 /review-pr 或 /mcp__server__prompt）
-     * @param fullInput 完整输入（包含命令名和参数）
-     * @returns 格式化的标签字符串
-     */
-    protected buildCommandContextTags(commandName: string, fullInput: string): string;
-    /**
-     * Extract the command text from a message, unwrapping any envelope the client
-     * put around it. For plain text, returns the trimmed text.
-     */
-    private extractCommandText;
-    /**
-     * 拆开客户端加在命令文本外面的包裹，并保留改写后要还原的隐藏上下文。
-     *
-     * 支持两种形态：
-     * - `<channel source="...">/cmd</channel>`（多频道事件）；
-     * - `<system-reminder …>…</system-reminder>\n<user_query>/cmd</user_query>`
-     *   （WorkBuddy / IDE 客户端发送前就拼好的形态，见 HIDDEN_CONTEXT_USER_QUERY_RE）。
-     */
-    private parseCommandEnvelope;
-    /**
-     * 把隐藏上下文放回改写结果前面。
-     *
-     * 不重新套 `<user_query>`：TUI 路径下展开产物同样是裸的
-     * `<command-message>…`（`UserQueryWrapperAgentRunInterceptor` 认它是系统注入内容
-     * 而跳过包裹），这里保持一致，避免两条链路给模型的形状不同。
-     */
-    private restoreHiddenContext;
-    /**
-     * 处理 skill 的斜杠命令调用
-     * 当用户输入 /skill-name 或 skill-name 且未匹配到 command 时，尝试在 skills 中查找
-     * 找到后将用户输入替换为 skill 指令内容，使 LLM 直接执行 skill
-     */
-    protected handleSkillSlashCommand(request: AgentRunRequest): Promise<boolean>;
-}

package/cli/dist-server/types/node/agent/interceptors/deep-research-pending-interceptor.d.ts

@@ -1,30 +0,0 @@
-/**
- * DeepResearchPendingInterceptor —— 当 session 处于"已触发 /deep-research 但 Workflow 工具尚未调"
- * 状态时,每轮在 user input 末尾注入一段加强 reminder,降低主 agent "澄清几轮就忘了调工具"的概率。
- *
- * 单一职责:扫 history → 判断 pending 状态 → 注入 reminder。
- *
- * Pending 判断:
- *   - history 里有 user 消息含 `data-role="deep-research-trigger"` reminder
- *   - 且 history 里**没有** Workflow 工具的 function_call (`name === ToolNames.WORKFLOW`)
- *   两者同时成立 → pending → 注入。
- *
- * 一旦 Workflow 工具被调,pending 就解除,后续轮次不再注入。
- *
- * 优先级:与 keyword/effort 同档(SystemReminderContext - 35),先后无所谓。
- */
-import { PromptManager } from '@genie/prompts';
-import { AgentRunInterceptor, AgentRunRequest } from '../../../vendor/cbc-core/node/index.js';
-import type { AgentInputItem } from '../../../vendor/cbc-shared/node/index.js';
-export declare class DeepResearchPendingInterceptor implements AgentRunInterceptor {
-    priority: number;
-    protected readonly promptManager: PromptManager;
-    intercept(request: AgentRunRequest): Promise<void>;
-    /**
-     * Visible-for-testing:扫 history 判定是否处于"已触发但未调工具"状态。
-     */
-    isPending(history: ReadonlyArray<AgentInputItem>): boolean;
-    private isWorkflowToolCall;
-    private containsDeepResearchTrigger;
-    private loadReminder;
-}

package/cli/dist-server/types/node/agent/interceptors/env-interceptor.d.ts

@@ -1,7 +0,0 @@
-import { SettingsManager } from '../../settings';
-import { AgentRunInterceptor, AgentRunInterceptorPriority, AgentRunRequest } from '../../../vendor/cbc-core/node/index.js';
-export declare class EnvAgentRunInterceptor implements AgentRunInterceptor {
-    priority: AgentRunInterceptorPriority;
-    protected readonly settingsManager: SettingsManager;
-    intercept(_request: AgentRunRequest): Promise<void>;
-}