@tencent-ai/agent-harness 0.2.0-beta.1 → 0.2.0-beta.2

package/cli/dist-server/types/vendor/cbc-core/node/session/session-protocol.d.ts

@@ -89,6 +89,7 @@ export type AgentPhase = 'preparing' | 'model_requesting' | 'model_streaming' |
 export interface AgentPhaseInfo {
     phase: AgentPhase;
     toolName?: string;
+    toolCallId?: string;
     streamingToolName?: string;
     startedAt: number;
     /**
@@ -177,6 +178,8 @@ export interface PreToolUseHookResult {
     permissionDecision?: 'allow' | 'deny' | 'ask';
     permissionDecisionReason?: string;
     runtimeSecurity?: Record<string, unknown>;
+    /** PreToolUse `continue:false` — stop the current turn after the deny result is recorded. */
+    preventContinuation?: boolean;
 }
 export interface Session {
     id: string;
@@ -206,6 +209,8 @@ export interface Session {
      */
     replSandboxDepth?: number;
     state?: RunState<any, any>;
+    /** Emitted after a physical run releases its lifecycle owner and abort links. */
+    runSettledSubject?: Subject<void>;
     createdAt: number;
     updatedAt: number;
     meta?: Record<string, any>;
@@ -638,6 +643,12 @@ export interface Session {
          * Context from UserPromptSubmit hook to be injected into current user message
          */
         userPromptSubmitContext?: string;
+        /**
+         * Context from UserPromptExpansion hook (hookSpecificOutput.additionalContext),
+         * to be injected alongside the expanded prompt (Claude Code parity: same
+         * injection point as UserPromptSubmit — "alongside the submitted prompt").
+         */
+        userPromptExpansionContext?: string;
         /**
          * Context from PostToolUse hook to be injected after tool execution
          */
@@ -915,6 +926,8 @@ export interface SessionOptions {
     debugToStderr?: boolean;
     verbose?: boolean;
     print?: boolean;
+    /** Host Bash output preference; omitted preserves the CLI's PTY selection. */
+    usePty?: boolean;
     outputFormat?: 'text' | 'json' | 'stream-json';
     inputFormat?: 'text' | 'stream-json';
     /** Whether to persist the session transcript. Defaults to true; false keeps history in memory only. */
@@ -1123,9 +1136,11 @@ export interface SessionManager {
      *
      * 幂等：未注册的 sessionId 为 no-op。
      *
-     * @param id 已完成 subagent 的 session id
+     * @param target 传 Session 对象时，索引键与身份校验同源——只有注册表当前持有
+     * 的正是这个对象才释放，复用同一 sessionId 的后继对象不会被误清。只拿得到
+     * id 的调用方（RPC、`remove(id)`）传字符串，此时不做身份校验。
      */
-    releaseInMemory(id: string): void;
+    releaseInMemory(target: string | Session): void;
     /**
      * 该 sessionId 是否已在本进程通过 get() 加载过（且尚未 remove()/releaseInMemory()）。
      *
@@ -1216,8 +1231,31 @@ export interface SessionManager {
      */
     flushHistory(session: Session): Promise<void>;
 }
+/**
+ * Cumulative transcript persistence counters (issue #119545 埋点建议).
+ * A best-effort side channel, so every reader must treat the numbers as a
+ * snapshot that may be sampled at any moment.
+ */
+export interface TranscriptPersistenceMetrics {
+    /** In-band retry attempts consumed. */
+    retries: number;
+    /** Batches that only landed because of a retry. */
+    retrySucceeded: number;
+    /** Batches given up on after the retry budget. */
+    abandonedBatches: number;
+    /** Lines lost with those batches. */
+    abandonedLines: number;
+}
 export interface SessionStore {
     getSessionFilePath(id: string, parentSessionId?: string, cwd?: string): string;
+    /**
+     * Transcript persistence counters, when the implementation keeps any.
+     * Optional so in-memory and host-delegating stores do not have to fake it.
+     * Exposed so callers that observe a degradation can log the counters from
+     * their own call site: the store's own abandon audit line is best-effort
+     * and a lost line would otherwise take the only copy of the numbers.
+     */
+    transcriptPersistenceMetrics?(): Readonly<TranscriptPersistenceMetrics>;
     get(id: string, options?: SessionGetOptions): Promise<Session | undefined>;
     getAcrossProjects(id: string, options?: SessionGetOptions): Promise<Session | undefined>;
     save(session: Session, cwd?: string): Promise<void>;
@@ -1376,6 +1414,26 @@ export interface SessionHookManager {
      * Does NOT support continueRequest.
      */
     executeFinalStopHooks(session: Session, reason?: FinalStopReason): Promise<void>;
+    /**
+     * UserPromptExpansion — Claude Code 官方事件（非 cbc 专属扩展）：任何用户输入的
+     * 命令/skill 在展开成 prompt、送进模型之前统一从这里触发，可阻断展开。适用于
+     * skill、自定义命令、Dynamic Workflow、MCP prompt 等一切"输入即展开"的路径，
+     * 不是只服务某一个具体调用方（如统一资产门控）。
+     */
+    executeUserPromptExpansionHooks(session: Session, payload: {
+        /** Claude Code spec: 'slash_command' for skill/custom commands, 'mcp_prompt' for MCP prompts. */
+        expansionType: 'slash_command' | 'mcp_prompt' | string;
+        commandName: string;
+        /** Claude Code spec: required field (empty string when no args), always sent. */
+        commandArgs: string;
+        /** e.g. Skill.source / Command.scope ('project' | 'user' | 'plugin' | 'mcp' | ...). */
+        commandSource?: string;
+        /** Claude Code spec: required field — raw, pre-expansion prompt text as typed by the user. */
+        prompt: string;
+    }): Promise<{
+        allowed: boolean;
+        message?: string;
+    }>;
 }
 export interface RunItemProcessor {
     process(runItem: RunItem): Promise<void>;
@@ -1494,9 +1552,10 @@ export interface InterruptionService {
      *
      * 幂等：session 未注册时为 no-op。只清内存映射，不动磁盘 jsonl。
      *
-     * @param sessionId 已完成 subagent 的 session id
+     * @param target 传 Session 对象时按对象身份校验，同 id 的后继对象不会被误清；
+     * 只拿得到 id 的调用方传字符串，此时不做身份校验。
      */
-    releaseSession(sessionId: string): void;
+    releaseSession(target: string | Session): void;
 }
 export interface MessageQueueManager {
     enqueueMessage(session: Session, message: AgentInputItem): string;

package/cli/dist-server/types/vendor/cbc-core/node/session/session-run-state-machine-protocol.d.ts

@@ -114,6 +114,7 @@ export type SessionRunEvent = {
 } | {
     type: SessionRunEventType.TOOL_STARTED;
     toolName?: string;
+    toolCallId?: string;
     reason?: string;
 } | {
     type: SessionRunEventType.TOOL_ENDED;

package/cli/dist-server/types/vendor/cbc-core/node/session/session-runtime-lifecycle.d.ts

@@ -0,0 +1,5 @@
+import type { Session } from './session-protocol';
+export declare function isSessionRuntimeClosed(session: Session): boolean;
+export declare function closeSessionRuntime(session: Session): void;
+export declare function sessionRuntimeSignal(session: Session): AbortSignal;
+export declare function assertSessionRuntimeOpen(session: Session | undefined): void;

package/cli/dist-server/types/vendor/cbc-core/node/session/session-store.d.ts

@@ -2,7 +2,7 @@ import { Logger } from '@celljs/core';
 import { type AgentInputItem } from '../../../cbc-shared/node/index.js';
 import * as fs from 'fs/promises';
 import { LocalJsonlSessionStore } from './local-jsonl-session-store';
-import { type Session, SessionFactory, type SessionForkMutationOptions, type SessionGetOptions, type SessionRewindMutationOptions, SessionStore } from './session-protocol';
+import { type Session, SessionFactory, type SessionForkMutationOptions, type SessionGetOptions, type SessionRewindMutationOptions, SessionStore, type TranscriptPersistenceMetrics } from './session-protocol';
 import type { Lane, LanePointer, SessionKey, SessionStoreEntry } from './session-store-contract';
 import { SessionImageStorage as ImageBlobService, SessionRestoreHost, SessionStoragePaths, SessionToolOutputStorage as ToolResultBlobService } from './session-store-host-protocol';
 /**
@@ -10,6 +10,27 @@ import { SessionImageStorage as ImageBlobService, SessionRestoreHost, SessionSto
  * 达到此阈值且遇到 user message 时停止逆序读取，避免启动时全量读 JSONL。
  */
 export declare const DEFAULT_SESSION_MAX_ITEMS = 1000;
+/**
+ * 每追加这么多条 history 行，就把当前 session-meta 快照重新补写到文件尾部。
+ *
+ * 读侧按 item 数封顶逆序读，只在窗口内找 session-meta；写侧按内容去重，身份
+ * 不变就只有创建时那一行（文件第 1 行）。会话一长，读窗口够不到它 → resume
+ * 静默丢 `codebuddy.ai/mainAgent`（PTC 掉回 cli、REPL 消失）/ `multitaskMode`
+ * / `codebuddy.ai/a2aContexts` / `codebuddy.ai/hostKind`（#128860）。
+ *
+ * 取值远小于 {@link DEFAULT_SESSION_MAX_ITEMS}，读侧即使把上限调低也仍能覆盖；
+ * 代价是每 200 行多一条约 200 字节的行（≈0.1%）。
+ *
+ * **与 {@link SESSION_META_HEAD_SCAN_BYTES} 是配对约束，必须满足**
+ * `SESSION_META_TAIL_REFRESH_LINES × 单行平均字节 << SESSION_META_HEAD_SCAN_BYTES`：
+ * 写侧靠本行距把快照压在文件尾部，读侧只有 256KB 的文件头兜底窗口 —— 一旦尾部快照
+ * 滑出头部窗口，长会话 resume 丢键（#128860 本体）就会以另一种形式回归。
+ * 当前 200 × ~200B ≈ 40KB，对 256KB 有约 6× 余量。**调大本值或让单行显著变长
+ * （例如工具结果外置后仍很大的行）都必须同步核对另一侧**，spec 里有一条边界断言钉住。
+ */
+export declare const SESSION_META_TAIL_REFRESH_LINES = 200;
+/** 文件头 session-meta 兜底读取的字节窗口（存量会话用，不做全量回扫）。与上者配对，见其注释。导出以便 spec 钉住配对约束。 */
+export declare const SESSION_META_HEAD_SCAN_BYTES: number;
 /**
  * Keys of session.meta that persist across processes (the off-tree
  * session-meta line; bin resume only — served sessions never write). A
@@ -22,6 +43,37 @@ export declare const DEFAULT_SESSION_MAX_ITEMS = 1000;
  * Role / locks / parentSessionId stay runtime-only.
  */
 export declare const PERSISTED_SESSION_META_KEYS: readonly ['codebuddy.ai/mainAgent', 'codebuddy.ai/hostKind', 'multitaskMode', 'codebuddy.ai/a2aContexts'];
+/**
+ * 白名单里「缺席即删除」的键：只认最新那一行的存在性，不向更早的行按键继承。
+ *
+ * 其余键（mainAgent / hostKind / a2aContexts）只会被赋值、不会被 delete，所以
+ * 读侧按键继承——某个写方视野不全（只快照了自己关心的键）不能把别的键擦掉
+ * （#128860：`/multitask` 盖章写出只含 multitaskMode 的行，把 PTC 站立身份永久
+ * 抹掉，`/agent-mode` 变成 Standard(cli)）。
+ *
+ * `multitaskMode` 是唯一会被真正 delete 的键（multitask/session-flags.ts 的
+ * clearMultitaskSession），所以必须留在这里，否则"关掉多任务"会被更早的
+ * `true` 复活。**新增白名单键时**：只要它的"缺席"承载语义，就必须登记到本表。
+ *
+ * 注意「缺席」要能写进文件才算数：子集被删空时 `persistSessionMeta` 会补一条
+ * `meta: {}` 的墓碑行，否则最新那条仍是删除前的快照，缺席永远不会出现。墓碑是
+ * **整份空快照**：本表登记第二个键之后，为删 A 写的墓碑会连带把 B 也判成缺席，
+ * 届时得改成按键墓碑，别直接往表里加。
+ */
+export declare const SNAPSHOT_ONLY_SESSION_META_KEYS: ReadonlyArray<string>;
+/**
+ * 参与合并的一条 session-meta 行。
+ *
+ * `id` 可能是空串：#94203 才给这行加上自身 UUIDv7，更早写下的存量行没有 id
+ * （CHANGELOG 明确「兼容旧的无 ID 记录」）。任何按 id 判等的地方都必须先处理
+ * 这个缺失，见 {@link SessionStoreImpl.metaLineIdentity}。
+ */
+interface SessionMetaLine {
+    id: string;
+    meta: Record<string, unknown>;
+    /** 行原文（trim 后）。缺 id 的存量行靠它做判等。 */
+    raw: string;
+}
 /**
  * 解析 session 历史回放的 maxItems。
  *
@@ -46,6 +98,7 @@ export declare class SessionStoreImpl implements SessionStore {
     protected readonly paths: SessionStoragePaths;
     protected readonly restoreHost: SessionRestoreHost;
     private writeLocks;
+    private readonly transcriptMetrics;
     private readonly transcriptAuditOnce;
     private transcriptAuditSequence;
     /**
@@ -113,6 +166,16 @@ export declare class SessionStoreImpl implements SessionStore {
      * behavioral loop: externalize → Read → externalize → Read …).
      */
     private externalizeToolResultIfNeeded;
+    /**
+     * Externalize the UI-only copy of a tool result. Tool implementations commonly store
+     * the same payload again in providerData.toolResult.content/renderer; keeping that copy
+     * defeats output externalization and can make a single JSONL row hundreds of KiB.
+     *
+     * The render payload is persisted as one JSON document. History keeps a text renderer
+     * pointing at that file, so clients always have a visible fallback instead of trying to
+     * parse a <persisted-output> marker as the original media/custom renderer payload.
+     */
+    private externalizeToolRenderDataIfNeeded;
     /**
      * Handle externalization for structured array output.
      * Iterates through array elements and externalizes any input_text items that exceed the threshold.
@@ -139,7 +202,25 @@ export declare class SessionStoreImpl implements SessionStore {
      */
     getSessionMetaFilePath(id: string, parentSessionId?: string, cwd?: string): string;
     private lastPersistedMeta;
+    /** 各转录文件「距上次 session-meta 行」的 history 行数（进程内，用于尾部刷新节流）。 */
+    private historyLinesSinceMeta;
+    /** 读侧靠文件头兜底才拿到 meta 的转录文件：下一批 append 立即把快照补到尾部。 */
+    private staleTailMeta;
+    /**
+     * 「据已知，该转录尾部最新那条 session-meta 还带着非空子集」——决定子集被删空时
+     * 要不要补墓碑。
+     *
+     * 判据必须是**文件事实**而不是"本进程写过什么"：resume 只 `get()` 不 `save()`
+     * （agent-task.ts 的子代理恢复就是这样），进程内缓存恒空，冷启动后第一轮就关掉
+     * 多任务会写不出墓碑，"关掉"永远落不了盘。所以读侧 load 完也要维护它。
+     *
+     * 仍是进程内状态：同一转录被两个进程同时写时，另一方的非空写入本进程不可见
+     * （与 `lastPersistedMeta` 同一层限制）。
+     */
+    private tailMetaNonEmpty;
     private persistedMetaSubset;
+    /** 一条 off-tree session-meta 行的字节形式。空 `persisted` 即墓碑快照。 */
+    private metaSnapshotLine;
     /** The off-tree session-meta line, or undefined when there is nothing to persist. */
     protected sessionMetaLineFor(fileId: string, meta: Session['meta']): string | undefined;
     /**
@@ -150,7 +231,59 @@ export declare class SessionStoreImpl implements SessionStore {
      * .meta.json overwrite. Bin surface only — served sessions never reach
      * here (persistence gate; locked by spec).
      */
-    protected persistSessionMeta(fileId: string, meta: Session['meta'], parentSessionId?: string, cwd?: string): Promise<void>;
+    protected persistSessionMeta(fileId: string, meta: Session['meta'], parentSessionId?: string, cwd?: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * 尾部快照刚落盘后的进程内状态收尾 —— 四份状态必须一起动。
+     *
+     * `lastPersistedMeta` / `historyLinesSinceMeta` / `staleTailMeta` / `tailMetaNonEmpty`
+     * 都以 filePath 为键、都描述「这个转录尾部最新那条 meta 现在是什么」。任何往尾部
+     * 写快照的路径（persistSessionMeta / initializeForkHistory）都要走这里：在调用点
+     * 手写四行，下一次再加状态时必然漏一处 —— fork 初始化就是这么漏的（lastPersistedMeta
+     * 写了，另外三份没写，导致 fork 后关掉多任务写不出墓碑、行数计数带着旧值）。
+     */
+    private markTailMetaPersisted;
+    /**
+     * 让「最新 session-meta」始终留在读侧的逆序窗口内（#128860 根治的写入侧）。
+     *
+     * 只在 history 真正落盘之后调用：每 {@link SESSION_META_TAIL_REFRESH_LINES}
+     * 行补写一次快照；读侧走过文件头兜底的文件（存量长会话）立即补写一次，
+     * 这样同一个会话只会退化一次。
+     *
+     * 失败不能拖垮本轮 append —— 转录字节已经写成功了，meta 下一批还会重试。
+     */
+    private refreshTailSessionMeta;
+    /**
+     * 文件头的 session-meta 兜底读取。
+     *
+     * `session-meta` 创建行通常在文件靠前的位置（新建会话是第 1 行；子会话/迁移过的
+     * 会话可能更靠后），而 history 逆序读有 item 上限——长会话倒着读到不了那里
+     * （#128860）。这里只读文件头一小段，不做全量回扫：
+     * 29MB 的会话里末尾 1100 行只占 20% 字节，回扫到头会把 resume 的读 I/O 放大 5×。
+     *
+     * 返回窗口内所有 session-meta 的 meta（文件序，旧→新），由
+     * {@link composeSessionMeta} 统一合并。
+     */
+    protected readHeadSessionMeta(filePath: string): Promise<SessionMetaLine[] | undefined>;
+    /**
+     * 合并去重用的行身份。
+     *
+     * 不能直接用 `id`：#94203 之前的存量行没有 id，兜成空串会让「头部的创建行」
+     * 和「尾部的残缺行」撞成同一个键 —— 头部那条被当成"已经见过"丢掉，正好复现
+     * 本 issue 要修的丢键现场（本机实测 2607 条 meta 行里 1195 条没有 id）。
+     * 缺 id 时退回整行原文：内容相同的两行参与合并是幂等的，丢一条无害。
+     */
+    private metaLineIdentity;
+    /**
+     * 把若干条 session-meta（文件序，旧→新）合成一份 meta 事实。
+     *
+     * - {@link SNAPSHOT_ONLY_SESSION_META_KEYS}：只认最新那一行（缺席=已删除）。
+     * - 其余白名单键：按键向更早的行继承，最新的值优先。写方只快照了自己视野
+     *   里的键时，别人的键不会被顺带擦掉（#128860 的第二处：`/multitask` 写出
+     *   只含 multitaskMode 的行，PTC 站立身份被永久抹掉）。
+     */
+    protected composeSessionMeta(metaLinesOldestFirst: ReadonlyArray<SessionMetaLine>): Record<string, unknown> | undefined;
     private findSubagentSessionByStoreId;
     protected deserializeSessionFromJsonl(id: string, options?: SessionGetOptions): Promise<Session | undefined>;
     /**
@@ -225,13 +358,25 @@ export declare class SessionStoreImpl implements SessionStore {
      */
     protected isNonUserSession(session: Session): boolean;
     appendHistory(id: string, input: AgentInputItem[], parentSessionId?: string, session?: Session, cwd?: string): Promise<void>;
+    protected openJsonlFile(filePath: string, flags: string): ReturnType<typeof fs.open>;
+    /** Short, in-band only: this runs on the addHistory chain, so it is turn latency. */
+    protected transcriptRetryDelaysMs(): readonly number[];
+    protected sleepBeforeTranscriptRetry(delayMs: number): Promise<void>;
+    /** Cumulative transcript persistence counters (issue #119545 埋点). */
+    transcriptPersistenceMetrics(): Readonly<TranscriptPersistenceMetrics>;
     /**
-     * The transcript-line writer, extracted verbatim from the previous
-     * appendHistory body: exclusive-create or append open, chunked line
+     * The transcript-line writer: exclusive-create or append open, chunked line
      * writes, and on failure a rollback (unlink a file this batch created,
      * truncate to the original size otherwise) with forensic audit logs.
+     *
+     * A retryable failure gets a short in-band retry. When the budget runs out
+     * the batch is abandoned and reported as a typed error — the local copy is
+     * allowed to lose its tail, and `addHistory` keeps the turn running. Read
+     * paths repair the gap (unpaired tool calls are filtered out of model
+     * input), so the cost of a loss is a shorter history, not a broken one.
      */
     protected writeTranscriptLines(sessionFilePath: string, lines: string[], key?: SessionKey): Promise<void>;
+    private writeTranscriptLinesOnce;
     private readonly entriesStoreInstances;
     /**
      * The embedded SessionStore-contract backend — the single jsonl writer
@@ -312,3 +457,4 @@ export declare class SessionStoreImpl implements SessionStore {
     private cleanupFailedFork;
     rewindSession(source: Session, options: SessionRewindMutationOptions): Promise<void>;
 }
+export {};

package/cli/dist-server/types/vendor/cbc-core/node/session/stream-timeout-retry-budget.d.ts

@@ -6,9 +6,21 @@ import type { Session } from './session-protocol';
  * terminal results are suppressed only while a retry will actually be scheduled.
  */
 export declare function hasExhaustedStreamTimeoutRetryBudget(session: Session, isFirstTokenTimeout: boolean): boolean;
+/**
+ * `finish_reason=error` 且没有可用输出的两种空流：reasoning-only 与 no-token。
+ * placeholder（空 200 / 心跳帧）仍是会话层终态，由拦截器切一次备站。
+ */
 export declare function isRetryableEmptyStreamError(error: unknown): boolean;
 /**
  * Empty 200 / placeholder-only：拦截器最多切一次备站，会话层终态（#115866）。
- * reasoning-only + finish_reason=error：上游瞬时失败，会话层最多重试 1 次（#122115）。
+ * reasoning-only / no-token + finish_reason=error：上游瞬时失败，按 error 预算重试。
+ * 流空闲超时 / 首 token 超时：按各自的超时预算重试。
  */
 export declare function shouldAutoRetryStreamTimeout(session: Session, error: unknown): boolean;
+/**
+ * 为一次流错误恢复认领额度，返回序号（1-based）；不可重试或已耗尽返回 `undefined`。
+ * 调用方必须先用 {@link shouldAutoRetryStreamTimeout} 判定，本函数只负责同步认领。
+ */
+export declare function claimStreamRecoveryAttempt(session: Session, error: unknown): number | undefined;
+/** 认领后没有真正发起恢复时退回额度。 */
+export declare function releaseStreamRecoveryAttempt(session: Session, error: unknown): void;

package/cli/dist-server/types/vendor/cbc-core/node/utils/history-utils.d.ts

@@ -364,6 +364,29 @@ export declare abstract class HistoryUtils {
      */
     static filterApiErrorMessages(history: AgentInputItem[]): AgentInputItem[];
     static filterRenameHistory(history: AgentInputItem[]): AgentInputItem[];
+    /**
+     * 让 model input 里的 tool_call 与 tool_result 严格一一配对（issue #119545）。
+     *
+     * 背景：工具结果丢失（状态机吞掉 TOOL_ENDED、持久化缺口、压缩切断）后，历史里会留下
+     * 只有 call、没有任何 result 的孤儿。上游对 tool_calls 强制配对，一条孤儿就让整个
+     * 请求 400，会话从此不可恢复——而本地历史里的孤儿是持久化的，每次恢复都会重现。
+     *
+     * 三类都处理，因为上游拒的是"不配对"这件事本身，方向无关：
+     * 1. call 没有任何同 callId 的结果项 → 丢 call；
+     * 2. 同一 callId 出现多条 call（重放/重试残留）→ 只留最后一条；
+     * 3. 结果项的 callId 没有留下来的 call（头部被截断，或 call 属于上面两类）→ 丢结果。
+     *
+     * 判据只看"存在性"，不看结果的真伪：skipRun 占位/拒绝、partial aborted 等伪结果都算
+     * 配对，它们的取舍归 filterTruncatedToolCalls，两者职责不重叠。改写只落在当轮副本上，
+     * 因此日志按轮聚合成一条并截断样本。
+     */
+    static filterUnpairedToolCalls(modelData: {
+        input: AgentInputItem[];
+        instructions?: string;
+    }, logger?: Logger): {
+        input: AgentInputItem[];
+        instructions?: string;
+    };
     static getItemsNeedingFill(history: AgentInputItem[]): FunctionCallItem[];
     static getFillItemsForNeedingFill(itemsNeedingFill: FunctionCallItem[]): FunctionCallResultItem[];
     /**

package/cli/dist-server/types/vendor/cbc-core/node/utils/index.d.ts

@@ -23,5 +23,6 @@ export * from './queue-dispatch-utils';
 export * from './run-result-utils';
 export * from './session-utils';
 export * from './summary-utils';
+export * from './string-retention-utils';
 export * from './token-utils';
 export * from './usage-utils';

package/cli/dist-server/types/vendor/cbc-core/node/utils/message-utils.d.ts

@@ -79,6 +79,18 @@ export declare abstract class MessageUtils {
     static createFilteredCopyForCompaction(messages: AgentInputItem[]): AgentInputItem[];
     private static filterHiddenSystemRemindersForCompaction;
     static stripSystemRemindersOutsideUserQuery(text: string): string;
+    /**
+     * 压缩链路的统计日志出口。
+     *
+     * **禁止改回 `process.stderr.write` / `process.stdout.write`**（issue #76749）：
+     * TUI 下裸写 stderr 会破坏 Ink 帧间光标定位，导致行级 diff 错位、spinner 残留。
+     * 走 logger 落盘即可，既保留排查信息又不碰 TTY。
+     *
+     * `catch` 有意整段吞掉，不做分级上报：日志出口的任何失败（容器未就绪、logger 自身
+     * 抛错）都不得影响压缩本身；而「失败时改走 stderr 兜底」恰会在异常路径上重新引入
+     * 本 issue 要修掉的 TTY 裸写。统计丢失是可接受的降级。
+     */
+    private static logCompaction;
     /**
      * Microcompact: clear output of old tool results (> 1 hour) to reduce token count.
      * Modifies items in place. Should be called BEFORE createFilteredCopyForCompaction.

package/cli/dist-server/types/vendor/cbc-core/node/utils/model-utils.d.ts

@@ -70,6 +70,13 @@ export declare abstract class ModelUtils {
      */
     private static readRuntimeModelId;
     static isHunyuanModel(session: Session): Promise<boolean>;
+    /**
+     * ImageGen 实际使用的图片模型是否为混元。
+     *
+     * 取「产品配置里第一个带 text-to-image tag 的模型」，与 image-service 的解析顺序一致；
+     * 配置里没有图片模型时会走客户端的混元兜底模型，同样按混元处理。
+     */
+    static isHunyuanImageModel(): Promise<boolean>;
     static isMandatoryApprovalTarget(session: Session, targetToolName: string): Promise<boolean>;
 }
 export {};

package/cli/dist-server/types/vendor/cbc-core/node/utils/queue-dispatch-utils.d.ts

@@ -17,7 +17,8 @@ import type { Session } from '../session/session-protocol';
  * 取；CLI **不再自动 drain**。后果有两条，改这块代码前必须知道：
  *  1. `session.queue` 降级为 rich queue 的**展示镜像**（只给 CLI TUI 看），镜像段由
  *     `RichMessageQueueManagerImpl.syncToSessionQueue` 整体重建；
- *  2. 上面列举的那些 legacy 自动 drain 路径**全部被显式短路**。
+ *  2. 主会话的 legacy 自动 drain 路径被短路。子任务没有客户端派发者，仍由
+ *     MessageQueueAgentRunInterceptor 消费非镜像项（包括普通 user 消息）。
  *
  * 因此在 Mode B 下 `session.queue` 是两个所有者共用的数组：镜像段属于 rich queue，
  * 系统注入项（后台任务通知 / channel / teammate / ACP steer 等）属于各自的注入方。任何一方读写它时
@@ -63,9 +64,30 @@ export declare abstract class QueueDispatchUtils {
      * 从 `session.queue` 里挑出「自动 drain 通道」该消费的项。
      *
      * Mode A：整个队列都是待发输入，原样返回（保持既有行为）。
-     * Mode B：只返回系统注入项，rich queue 的展示镜像不属于本通道。
+     * Mode B 主会话：只返回系统注入项。子任务：所有非镜像项都是真实待发输入。
      */
     static ownedQueueItems(session: Session): AgentInputItem[];
+    /** Task runtimes have no client queue dispatcher, including restored child sessions. */
+    static isTaskQueue(session: Session): boolean;
+    /** The legacy interceptor owns all Mode A input and Mode B task input, never rich mirrors. */
+    static usesLocalQueueDispatch(session: Session): boolean;
+    static autoDrainQueueItems(session: Session): AgentInputItem[];
+    /**
+     * Observe which items one drain invocation actually consumed.
+     *
+     * **`input` is matched by array *identity*, not contents** — a copy observes
+     * nothing, and the caller then reads a failed drain as having consumed
+     * nothing. Per instance rather than per session because a session-wide
+     * snapshot cannot tell this batch apart from a competing run's.
+     *
+     * @returns disposer; call it once the run settles.
+     */
+    static observeQueueDrain(input: AgentInputItem[], observer: (items: AgentInputItem[], signal?: AbortSignal) => void): () => void;
+    /**
+     * Report the items consumed for `input`. No-op when nobody observes that
+     * exact array instance — see {@link observeQueueDrain} for the contract.
+     */
+    static recordQueueDrain(input: AgentInputItem[], items: AgentInputItem[], signal?: AbortSignal): void;
     /**
      * Async check — reads product config when env var is not set.
      */

package/cli/dist-server/types/vendor/cbc-core/node/utils/session-utils.d.ts

@@ -11,7 +11,10 @@ export declare abstract class SessionUtils {
      * session 中发生实际可见的 ID 冲突。
      */
     static subAgentId(): string;
-    static isSubAgent(session: Session): boolean;
+    static isSubAgent(session: {
+        id?: string;
+        storeId?: string;
+    }): boolean;
     /**
      * Clone one history item for a fork without duplicating large string payloads.
      *

package/cli/dist-server/types/vendor/cbc-core/node/utils/string-retention-utils.d.ts

@@ -0,0 +1,4 @@
+/** Materialize an independent string without changing its UTF-16 code units. */
+export declare function copyString(value: string): string;
+/** Truncate by JavaScript string length and detach the retained prefix from its parent. */
+export declare function truncateAndCopyString(value: string, maxLength: number, suffix?: string): string;

package/cli/dist-server/types/vendor/cbc-shared/node/hooks/hook-types.d.ts

@@ -83,7 +83,13 @@ export declare enum HookEvent {
     FILE_CHANGED = "FileChanged",
     CWD_CHANGED = "CwdChanged",
     /** Terminal event; does not support continueRequest. */
-    FINAL_STOP = "FinalStop"
+    FINAL_STOP = "FinalStop",
+    /**
+     * Triggered when a user-typed command/skill expands into a prompt, before
+     * it reaches the model. Can block the expansion.
+     * Claude Code parity: matcher filters on `command_name`.
+     */
+    USER_PROMPT_EXPANSION = "UserPromptExpansion"
 }
 /** Hook script stdout payload. */
 export interface HookOutput {

package/cli/dist-server/types/vendor/cbc-shared/node/index.d.ts

@@ -1,6 +1,8 @@
 export * from './agent/openai-agents-types';
 export * from './agent-home/agent-home-envelope-body';
 export * from './utils/abort-utils';
+export * from './utils/retry-backoff';
+export * from './utils/retry-policy';
 export * from './settings/settings-types';
 export * from './tools/tool-permission-types';
 export * from './tools/tool-permission-messages';

package/cli/dist-server/types/vendor/cbc-shared/node/model/model-errors.d.ts

@@ -17,10 +17,14 @@ export declare class StreamTimeoutError extends CustomError {
 }
 /**
  * placeholder：空 200 / 心跳占位，拦截器最多切一次备站，会话层终态。
- * reasoning-only：已流出思考、finish_reason=error 且无可用输出（#63761 / #122115），
- * 会话层允许 1 次有界重试。
+ * reasoning-only：已流出思考、finish_reason=error 且无可用输出（#63761 / #122115）。
+ * no-token：finish_reason=error 到达时一个模型 token 都没有（连 reasoning 也没有）。
+ *
+ * reasoning-only 与 no-token 都是上游瞬时失败，会话层按 error 恢复预算重试；
+ * placeholder 必须与 no-token 分开——两者共用一个值时，放开 no-token 会连带
+ * 推翻空 200 的终态判定。
  */
-export type EmptyStreamKind = 'placeholder' | 'reasoning-only';
+export type EmptyStreamKind = 'placeholder' | 'reasoning-only' | 'no-token';
 /**
  * 空流错误
  * 语义上仍然是"上游没有提供模型输出"，所以继承 StreamTimeoutError

package/cli/dist-server/types/vendor/cbc-shared/node/tools/tool-names.d.ts

@@ -63,6 +63,7 @@ export declare enum ToolNames {
     WAIT_FOR_MCP_SERVERS = "WaitForMcpServers",
     WORKFLOW = "Workflow",
     VIDEO_GEN = "VideoGen",
+    AUDIO_TRANSCRIBE = "AudioTranscribe",
     REPORT_FINDINGS = "ReportFindings",
     MONITOR = "Monitor",
     LIST_AGENTS = "ListAgents",

package/cli/dist-server/types/vendor/cbc-shared/node/utils/retry-backoff.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 自动恢复链的统一口径：最多 3 次，1s 起步、2 倍指数退避（基准 1s → 2s → 4s）。
+ *
+ * 适用于会话层的 error / 网络 / 流超时恢复，以及模型层的连接级透明重试。
+ * 第 1 层请求级（429/502/503 等）不带网关 retry_policy 时仍保持自己的 500ms 基数，
+ * 所以这里只共享算法，基数与上限由调用方传入。
+ */
+export declare const MAX_RECOVERY_RETRIES = 3;
+export declare const RECOVERY_RETRY_BASE_DELAY_MS = 1000;
+export declare const RECOVERY_RETRY_MAX_DELAY_MS = 32000;
+export interface ExponentialBackoffOptions {
+    baseDelayMs: number;
+    maxDelayMs: number;
+    random?: () => number;
+}
+/**
+ * `base * 2^(attempt-1)` 封顶到 `maxDelayMs`，再做 25% 下减抖动（区间 `[0.75x, 1x]`）。
+ *
+ * 必须下减而不是上加：上加会让实际等待越过 `maxDelayMs` 25%，调用方对封顶的承诺就不成立。
+ * `attempt` 从 1 起，小于 1 按 1 处理。
+ */
+export declare function computeExponentialBackoffMs(attempt: number, options: ExponentialBackoffOptions): number;
+export declare function computeRecoveryBackoffMs(attempt: number, random?: () => number): number;
+/**
+ * 可取消的等待。`signal` 在等待前或等待中 abort 时返回 `false`，正常等满返回 `true`。
+ *
+ * 返回布尔而不是 reject：恢复链上的调用方拿到 `false` 后要自己决定退还额度、跳过发起，
+ * 用异常表达会把「用户取消」和「真正的错误」混在一条 catch 路径里。
+ */
+export declare function waitForRecoveryBackoff(ms: number, signal?: AbortSignal): Promise<boolean>;

package/cli/dist-server/types/vendor/cbc-shared/node/utils/retry-policy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 模型网关在 HTTP 错误体里下发的重试指示，与 `code` / `msg` / `displayMsg` 同层：
+ *
+ * ```json
+ * { "code": 11101, "msg": "...", "retry_policy": { "retry": false }, "displayMsg": { ... } }
+ * ```
+ *
+ * - `force-retry`：策略是普通对象且 `retry !== false`（含 `true`、缺 `retry` 键、类型异常）。
+ *   只在本地已判定可重试的范围内把请求级重试提到 3 次，不扩大可重试状态码。
+ * - `forbid-retry`：策略是普通对象且 `retry === false`。不重试、不换模型、不重放备站、不做鉴权刷新重试。
+ * - `unset`：字段缺失、`null`、数组或其他非对象形态，完全按原有逻辑处理。
+ *
+ * 只有显式 `false` 才阻断：网关形态小改动时宁可多试一次，也不要静默丧失恢复能力。
+ */
+export type RetryPolicyDecision = 'force-retry' | 'forbid-retry' | 'unset';
+export declare const RETRY_POLICY_FIELD = "retry_policy";
+/**
+ * 按固定层级找 `retry_policy` 原值，返回第一个存在的值（可能是非法形态，由调用方裁决）。
+ *
+ * 同一份策略会以三种形态出现：网关原始错误体（顶层或 `data` / `error.data`）、错误分析器
+ * 规范化后的 `{ error: { code, message, data } }`、SDK 包装后的 APIError（`error.data`，
+ * 外层再包一层时为 `error.error.data`）。层级写死、不递归，避免在任意嵌套里误捡字段。
+ */
+export declare function findRetryPolicy(source: unknown): unknown;
+export declare function decideRetryPolicy(policy: unknown): RetryPolicyDecision;
+export declare function resolveRetryPolicy(source: unknown): RetryPolicyDecision;