@tencent-ai/agent-sdk 0.3.237-dev.cd99b52.202608040127 → 0.3.237-dev.fc41ac4.202608061734

package/lib/types.d.ts

@@ -135,7 +135,7 @@ export interface HookCallbackMatcher {
 }
 export interface BaseHookInput {
     session_id: string;
-    transcript_path?: string;
+    transcript_path: string;
     cwd: string;
     permission_mode?: string;
 }
@@ -191,7 +191,7 @@ export type SubagentStopHookInput = BaseHookInput & {
     hook_event_name: 'SubagentStop';
     stop_hook_active: boolean;
     agent_id: string;
-    agent_transcript_path?: string;
+    agent_transcript_path: string;
 };
 export type PreCompactHookInput = BaseHookInput & {
     hook_event_name: 'PreCompact';
@@ -489,11 +489,6 @@ export interface SystemMessage {
     subtype: 'init';
     uuid: string;
     session_id: string;
-    /**
-     * 当前帧所属的 run 标识。由 CLI 侧写入并透传给下游消费者，用于按 run 归类每一帧。
-     * resume 或 replay 阶段 runId 尚未分配时可能缺失。
-     */
-    run_id?: string;
     apiKeySource?: string;
     cwd?: string;
     tools: string[];
@@ -512,14 +507,10 @@ export interface SystemMessage {
         path: string;
     }>;
 }
-export interface RemoteOperationContext {
-    contextId: string;
-}
 export interface UserMessage {
     type: 'user';
     uuid?: string;
     session_id: string;
-    run_id?: string;
     message: {
         role: 'user';
         content: string | ContentBlock[];
@@ -534,7 +525,6 @@ export interface AssistantMessage {
     type: 'assistant';
     uuid: string;
     session_id: string;
-    run_id?: string;
     message: {
         id: string;
         type: 'message';
@@ -554,14 +544,12 @@ export interface PartialAssistantMessage {
     parent_tool_use_id: string | null;
     uuid: string;
     session_id: string;
-    run_id?: string;
 }
 export type ResultMessage = {
     type: 'result';
     subtype: 'success';
     uuid: string;
     session_id: string;
-    run_id?: string;
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
@@ -576,7 +564,6 @@ export type ResultMessage = {
     subtype: 'error_during_execution' | 'error_max_turns' | 'error_max_budget_usd';
     uuid: string;
     session_id: string;
-    run_id?: string;
     duration_ms: number;
     duration_api_ms: number;
     is_error: boolean;
@@ -591,7 +578,6 @@ export interface CompactBoundaryMessage {
     subtype: 'compact_boundary';
     uuid: string;
     session_id: string;
-    run_id?: string;
     compact_metadata: {
         trigger: 'manual' | 'auto';
         pre_tokens: number;
@@ -603,44 +589,6 @@ export interface StatusMessage {
     status: 'compacting' | null;
     uuid: string;
     session_id: string;
-    run_id?: string;
-}
-/**
- * Run 生命周期帧：一次 run 开始时由 CLI 发送一次。
- *
- * 作为独立 subtype 加入 Message union，而非拓展 SystemMessage.subtype，
- * 以保持 init 字面量类型的精确性。CLI 侧通过 --emit-run-lifecycle 显式启用；
- * 不启用时消费方永远不会收到该帧。
- */
-export interface RunStartedMessage {
-    type: 'system';
-    subtype: 'run_started';
-    uuid: string;
-    session_id: string;
-    /** 归属 run 的标识（本帧必填）。 */
-    run_id: string;
-    /** run 开始时的时间戳（毫秒）。 */
-    run_started_at: number;
-}
-/**
- * 会话镜像写入失败帧（对齐 Claude 的 {type:'system', subtype:'mirror_error'}）。
- *
- * 双写语义下本地已持久化，镜像失败不中断查询——重试耗尽后丢弃该批，
- * flush 超时则远端结果未知；两者都会合成本帧进结果迭代器。
- * 作为独立 subtype 加入 Message union（同 RunStartedMessage 的做法），
- * 保持 SystemMessage.subtype 'init' 字面量类型的精确性。
- */
-export interface MirrorErrorMessage {
-    type: 'system';
-    subtype: 'mirror_error';
-    uuid: string;
-    session_id: string;
-    /** 失败批次的目标 key（含 subpath 时为子代理记录） */
-    session_store_key: SessionKey;
-    /** 失败原因描述 */
-    error: string;
-    /** 受影响的条目数；flush 超时时不表示远端一定未提交 */
-    dropped_entries: number;
 }
 /**
  * Emitted when a background task starts.
@@ -739,20 +687,11 @@ export interface ToolProgressMessage {
     elapsed_time_seconds: number;
     uuid: string;
     session_id: string;
-    run_id?: string;
 }
-/**
- * 错误帧。有两个来源：
- *   1. CLI 主动输出的 error 帧；
- *   2. ProcessTransport 在 CLI 异常退出（未输出 result 就结束）时合成的补偿帧。
- * 合成路径会尽量填充 run_id 与 uuid，便于下游将失败归属到具体的 run。
- */
 export interface ErrorMessage {
     type: 'error';
     error: string;
     session_id?: string;
-    run_id?: string;
-    uuid?: string;
 }
 /**
  * Topic message for session title/topic updates.
@@ -762,7 +701,6 @@ export interface TopicMessage {
     type: 'topic';
     topic: string;
     session_id: string;
-    run_id?: string;
 }
 /**
  * AI-generated session title update.
@@ -771,7 +709,6 @@ export interface AiTitleMessage {
     type: 'ai-title';
     aiTitle: string;
     session_id: string;
-    run_id?: string;
 }
 /**
  * File history snapshot message.
@@ -791,12 +728,11 @@ export interface FileHistorySnapshotMessage {
     };
     id?: string;
     parentId?: string;
-    run_id?: string;
 }
 /**
  * @experimental _requestId is an experimental field that may change in future versions.
  */
-export type Message = (SystemMessage | UserMessage | AssistantMessage | PartialAssistantMessage | ResultMessage | CompactBoundaryMessage | StatusMessage | TaskStartedMessage | TaskProgressMessage | TaskUpdatedMessage | TaskNotificationMessage | RunStartedMessage | MirrorErrorMessage | ToolProgressMessage | ErrorMessage | TopicMessage | AiTitleMessage | FileHistorySnapshotMessage) & {
+export type Message = (SystemMessage | UserMessage | AssistantMessage | PartialAssistantMessage | ResultMessage | CompactBoundaryMessage | StatusMessage | TaskStartedMessage | TaskProgressMessage | TaskUpdatedMessage | TaskNotificationMessage | ToolProgressMessage | ErrorMessage | TopicMessage | AiTitleMessage | FileHistorySnapshotMessage) & {
     /** @experimental */
     _requestId?: string;
 };
@@ -871,490 +807,6 @@ export interface Query extends AsyncGenerator<Message, void> {
     streamInput(stream: AsyncIterable<UserMessage>): Promise<void>;
 }
 export type SettingSource = 'user' | 'project' | 'local';
-export type FileSystemModuleName = 'tools' | 'memory' | 'settings' | 'skills';
-export interface FileSystemHandlerOptions {
-    module?: FileSystemModuleName;
-    contextId?: string;
-    signal?: AbortSignal;
-}
-/**
- * 路径上下文：cbc 本地绝对路径 + workspace 根(cwd) + 配置根(homedir)。
- * handler 可据此把 workspace 路径映射到远端；homedir 只作为上下文保留，
- * 不代表远端存在对应的 home/assets 镜像。
- */
-export interface FsPathInfo {
-    absolutePath: string;
-    cwd: string;
-    homedir: string;
-}
-export interface FileSystemVersionedContent {
-    exists: boolean;
-    content: string;
-    revision: string;
-}
-export type FileSystemMutation = {
-    op: 'write';
-    path: FsPathInfo;
-    content: string;
-} | {
-    op: 'writeBytes';
-    path: FsPathInfo;
-    base64: string;
-} | {
-    op: 'rm';
-    path: FsPathInfo;
-    recursive: boolean;
-    force: boolean;
-};
-export interface FileSystemConditionalBatchResult {
-    revision: string;
-}
-export interface FileSystemConflictError extends Error {
-    code: 'FILE_SYSTEM_CONFLICT';
-    currentRevision?: string;
-}
-/**
- * 用户提供的 FileSystem 替换实现；可落到本地、远程沙箱或测试 fake。
- *
- * 每个 op 接收可选 `signal`：query 取消（query.interrupt() 或 abortController.abort()）
- * 时 SDK 会触发该 signal，handler 应把信号透传到远端请求或长耗时 IO。v1 handler
- * 可忽略 signal（cbc 侧已有 per-op 30s 超时兜底），但接口必须现在就暴露，避免后续
- * 加 signal 变成 breaking change。
- *
- * 错误约定：handler 抛 `Error & { code?: string }`，SDK 会把 `error.code`
- * （如 'ENOENT' / 'EACCES' / 'ENOSPC'）回包给 cbc，cbc 侧 tool 依此还原与本地
- * 一致的报错文案。
- */
-export interface FileSystemHandler {
-    /** 文本读：返回 UTF-8 解码后的字符串。非 UTF-8 文件应用 readBytes。 */
-    read(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<string>;
-    /** 字节读：返回 base64 编码的字符串（cbc 侧负责 Buffer.from(base64, 'base64')）。 */
-    readBytes(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<string>;
-    /** 文本写：content 是 UTF-8 字符串；append=true 追加，否则覆盖。 */
-    write(path: FsPathInfo, content: string, append: boolean, options?: FileSystemHandlerOptions): Promise<void>;
-    /** 字节写：base64 是 base64 编码的字节流（cbc 已对 Buffer.toString('base64') 后传入）。 */
-    writeBytes(path: FsPathInfo, base64: string, append: boolean, options?: FileSystemHandlerOptions): Promise<void>;
-    /** mtime 单位毫秒（与 fs.Stats.mtimeMs 对齐）。 */
-    stat(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<{
-        isFile: boolean;
-        isDirectory: boolean;
-        size: number;
-        mtime: number;
-    }>;
-    exists(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<boolean>;
-    mkdir(path: FsPathInfo, recursive: boolean, options?: FileSystemHandlerOptions): Promise<void>;
-    readdir(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<{
-        name: string;
-        type: 'file' | 'directory' | 'symlink';
-    }[]>;
-    rm(path: FsPathInfo, recursive: boolean, force: boolean, options?: FileSystemHandlerOptions): Promise<void>;
-    /** 原子读取文件内容及其不透明 revision；文件不存在时仍返回可用于条件创建的 revision。 */
-    readVersioned?(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<FileSystemVersionedContent>;
-    /** 返回文件或目录 scope 的不透明 revision。 */
-    revision?(path: FsPathInfo, options?: FileSystemHandlerOptions): Promise<string>;
-    /** 全部 mutation 原子提交；revision 不匹配时抛 FileSystemConflictError，禁止部分写入。 */
-    conditionalBatch?(scope: FsPathInfo, expectedRevision: string, mutations: readonly FileSystemMutation[], options?: FileSystemHandlerOptions): Promise<FileSystemConditionalBatchResult>;
-}
-export interface FileSystemOptions {
-    /** 'all' 替换全部已接入 module；数组只替换指定 module，且不能为空。 */
-    modules: 'all' | FileSystemModuleName[];
-    /** 必填：fs 替换实现，由调用方提供（SDK 不内置默认）。 */
-    handler: FileSystemHandler;
-}
-export type SearchGrepOutputMode = 'content' | 'files_with_matches' | 'count';
-export interface SearchPathInfo {
-    absolutePath: string;
-    cwd: string;
-    homedir: string;
-}
-export interface SearchLimits {
-    maxResults?: number;
-    offset?: number;
-    maxBytes: number;
-    timeoutMs: number;
-}
-export interface SearchGlobRequest {
-    pattern: string;
-    path: SearchPathInfo;
-    limits: SearchLimits;
-    contextId?: string;
-}
-export interface SearchGlobResult {
-    matches: Array<{
-        path: string;
-        modifiedAt?: number;
-    }>;
-    totalCount: number;
-}
-export interface SearchGrepRequest {
-    query: string;
-    path: SearchPathInfo;
-    include?: string;
-    fileType?: string;
-    outputMode: SearchGrepOutputMode;
-    caseInsensitive?: boolean;
-    multiline?: boolean;
-    lineNumbers?: boolean;
-    context?: {
-        before?: number;
-        after?: number;
-    };
-    limits: SearchLimits;
-    contextId?: string;
-}
-export interface SearchGrepMatch {
-    path: string;
-    line?: number;
-    text?: string;
-    count?: number;
-    kind?: 'match' | 'context';
-}
-export interface SearchGrepResult {
-    matches: SearchGrepMatch[];
-    totalCount: number;
-}
-export interface SearchHandler {
-    glob(request: SearchGlobRequest, options: {
-        signal: AbortSignal;
-    }): Promise<SearchGlobResult>;
-    grep(request: SearchGrepRequest, options: {
-        signal: AbortSignal;
-    }): Promise<SearchGrepResult>;
-}
-export interface SearchOptions {
-    handler: SearchHandler;
-}
-export interface EnvironmentSnapshot {
-    cwd: string;
-    homeDir: string;
-    configRoot: string;
-    platform: string;
-    platformVersion: string;
-    arch: string;
-    shell: string;
-    isWsl?: boolean;
-    locale?: string;
-    timezone?: string;
-    toolVersions?: Record<string, string>;
-    version?: string;
-}
-export interface EnvironmentSnapshotHandler {
-    getSnapshot(options: {
-        signal: AbortSignal;
-        contextId?: string;
-    }): Promise<EnvironmentSnapshot>;
-}
-export interface EnvironmentSnapshotOptions {
-    handler: EnvironmentSnapshotHandler;
-}
-export type AgentStateScope = 'session' | 'workspace' | 'user';
-export interface AgentStateKey {
-    namespace: string;
-    scope: AgentStateScope;
-    scopeId: string;
-    key: string;
-}
-export interface AgentStateEntry {
-    key: AgentStateKey;
-    value: JsonValue;
-    etag: string;
-    expiresAt?: number;
-}
-export type AgentStateMutation = {
-    op: 'put';
-    key: AgentStateKey;
-    value: JsonValue;
-    expectedEtag?: string;
-    ifAbsent?: boolean;
-    ttlMs?: number;
-} | {
-    op: 'delete';
-    key: AgentStateKey;
-    expectedEtag?: string;
-};
-export interface AgentStateStoreHandlerOptions {
-    signal: AbortSignal;
-    contextId?: string;
-}
-export interface AgentStateStoreHandler {
-    get(key: AgentStateKey, options: AgentStateStoreHandlerOptions): Promise<AgentStateEntry | undefined>;
-    put(key: AgentStateKey, value: JsonValue, write: {
-        expectedEtag?: string;
-        ifAbsent?: boolean;
-        ttlMs?: number;
-    }, options: AgentStateStoreHandlerOptions): Promise<AgentStateEntry>;
-    delete(key: AgentStateKey, expectedEtag: string | undefined, options: AgentStateStoreHandlerOptions): Promise<boolean>;
-    list(scope: Omit<AgentStateKey, 'key'>, prefix: string | undefined, options: AgentStateStoreHandlerOptions): Promise<AgentStateEntry[]>;
-    batch(mutations: AgentStateMutation[], options: AgentStateStoreHandlerOptions): Promise<AgentStateEntry[]>;
-}
-export interface AgentStateStoreOptions {
-    handler: AgentStateStoreHandler;
-}
-/** 会在控制面本地 spawn 子进程的执行消费者类别（fail-closed 的作用对象）。 */
-export declare const LOCAL_EXECUTION_MODULE_NAMES: readonly ['mcpStdio', 'lsp', 'bash', 'search', 'hook', 'detachedProcess'];
-export type LocalExecutionModuleName = typeof LOCAL_EXECUTION_MODULE_NAMES[number];
-/**
- * 控制面本地执行拒绝清单。'all' = 拒绝全部消费者（含未来新增，fail-safe）；
- * 数组 = 只拒绝列出者；未传 / [] = 不拒绝。用显式 'all' 而非「空 = 全部」，
- * 避免安全开关读反导致 fail-open。
- */
-export type LocalExecutionDeny = 'all' | LocalExecutionModuleName[];
-export interface RemoteMcpOptions {
-    /** 开启后，远程 MCP 必须走 host 委托；不能在 CLI 进程里本地直连。 */
-    managed?: true;
-    /** 限制 host 可代转的远程 transport；不传时表示三种都支持。 */
-    remoteTransports?: Array<'http' | 'sse' | 'remote'>;
-}
-/**
- * channel open 配置：描述要拉起的远端 channel 类型与启动参数。
- * type 目前由服务端侧解读（如 'mcp_stdio'），SDK 仅原样透传给 handler。
- */
-export interface ChannelOpenConfig {
-    type: string;
-    serverName: string;
-    command: string;
-    args?: string[];
-    cwd?: string;
-    env?: Record<string, string>;
-    workspaceRoot?: string;
-    idleTimeoutMs?: number;
-}
-/**
- * 服务端 → SDK 推送的 channel 事件。jsonrpc 用于 mcp_stdio 类型的双向消息；
- * stderr/exit/error 用于进程生命周期通知；cursor 留作长任务进度游标。
- */
-export interface ChannelEvent {
-    type: 'response' | 'notification' | 'progress' | 'stderr' | 'exit' | 'error';
-    jsonrpc?: unknown;
-    message?: string;
-    exitCode?: number;
-    cursor?: string;
-}
-/**
- * 用户提供的 Channel 处理器；SDK 把 cbc 下发的 channel control-request
- * 按 op 派发到对应方法，handler 在远端（如 AL）拉起/写入/收口 channel。
- * onEvent 由 handler 内部在收到服务端推送时调用，SDK 负责转发给 CLI。
- */
-export interface ChannelHandler {
-    open(config: ChannelOpenConfig, options?: {
-        signal?: AbortSignal;
-    }): Promise<{
-        channelId: string;
-        type: string;
-    }>;
-    write(channelId: string, message: unknown, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    heartbeat(channelId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    stop(channelId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<void>;
-    /** SDK handler 接到服务端的 channel events 后调此回调推给 CLI */
-    onEvent?: (channelId: string, event: ChannelEvent) => void;
-}
-export interface ChannelOptions {
-    handler: ChannelHandler;
-}
-export interface ExecPathInfo {
-    workspaceRoot: string;
-    homedir: string;
-}
-export interface ExecRequestContext {
-    userId: string;
-    sessionId: string;
-    runId: string;
-    requestId: string;
-    v: number;
-    toolCallId?: string;
-    conversationRequestId?: string;
-    capabilityId?: string;
-    contextId?: string;
-    remoteExecutionContextId?: string;
-}
-export interface ExecRunArgs {
-    cmd: string;
-    cwd?: string;
-    env?: Record<string, string>;
-    timeoutMs?: number;
-    maxOutputBytes?: number;
-}
-export type ExecExitReason = 'exited' | 'signaled' | 'timeout' | 'sandbox_denied' | 'permission_denied' | 'unsupported';
-export type ExecErrorCode = 'EXEC_TIMEOUT' | 'EXEC_UNSUPPORTED' | 'EXEC_NO_HANDLER' | 'EXEC_INVALID_REQUEST' | 'EXEC_SANDBOX_DENIED' | 'EXEC_PERMISSION_DENIED' | 'EXEC_HANDLER_ERROR';
-export type ExecUnsupportedFeature = 'pty' | 'interactive' | 'background' | 'persistent_stdin' | 'signal' | 'resize' | 'other';
-export interface ExecRunResult {
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    exitReason: ExecExitReason;
-    signal?: number;
-    timedOut?: boolean;
-    unsupported?: boolean;
-    unsupportedFeature?: ExecUnsupportedFeature;
-    unsupportedReason?: string;
-    stdoutTruncated?: boolean;
-    stderrTruncated?: boolean;
-    sandboxDenied?: boolean;
-    sandboxBlockedPaths?: string[];
-    errorCode?: ExecErrorCode;
-    error?: string;
-}
-export type ExecRunHandlerRequest = ExecRunArgs & {
-    path: ExecPathInfo;
-    context: ExecRequestContext;
-};
-export interface ExecRunHandler {
-    run(request: ExecRunHandlerRequest, options: {
-        signal: AbortSignal;
-    }): Promise<ExecRunResult>;
-}
-export interface ExecOptions {
-    handler: ExecRunHandler;
-    maxOutputBytes?: number;
-    capabilityId?: string;
-    remoteExecutionContextId?: string;
-}
-export type RemoteExtensionScope = 'user' | 'project' | 'connector' | 'plugin';
-export type RemoteExtensionErrorCode = 'EXTENSION_NOT_FOUND' | 'EXTENSION_INVALID' | 'EXTENSION_UNSUPPORTED' | 'EXTENSION_TOO_LARGE' | 'EXTENSION_UNAVAILABLE';
-export declare const REMOTE_EXTENSION_HOOK_EVENTS: readonly ['PreToolUse', 'PostToolUse', 'PostToolUseFailure', 'UserPromptSubmit', 'SessionStart', 'SessionEnd', 'Stop', 'SubagentStart', 'SubagentStop', 'PreCompact', 'PermissionRequest'];
-export type RemoteHookEvent = typeof REMOTE_EXTENSION_HOOK_EVENTS[number];
-export type JsonValue = null | boolean | number | string | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-export interface RemoteResourceMetadata {
-    path: string;
-    kind?: 'text' | 'binary' | 'script' | 'asset';
-    size?: number;
-    digest?: string;
-}
-export interface RemoteHookMetadata {
-    hookRef: string;
-    event: RemoteHookEvent;
-    type: 'command' | 'prompt' | 'agent' | 'http';
-    matcher?: string;
-    if?: string;
-    once?: boolean;
-    timeout?: number;
-    scope?: string;
-    async?: false;
-    asyncRewake?: false;
-}
-interface RemoteExtensionComponentMetadataBase {
-    ref: string;
-    name: string;
-    description: string;
-    scope: RemoteExtensionScope;
-    /**
-     * Host-controlled absolute directory for resources materialized before the
-     * CLI starts. The CLI does not scan this directory for discovery.
-     */
-    baseDirectory?: string;
-    plugin?: string;
-    hooks?: RemoteHookMetadata[];
-    resources?: RemoteResourceMetadata[];
-}
-export interface RemoteSkillMetadata extends RemoteExtensionComponentMetadataBase {
-    kind: 'skill';
-    disableModelInvocation?: boolean;
-    userInvocable?: boolean;
-}
-export interface RemoteCommandMetadata extends RemoteExtensionComponentMetadataBase {
-    kind: 'command';
-    argumentHint?: string;
-    disableModelInvocation?: boolean;
-}
-export interface RemoteAgentMetadata extends RemoteExtensionComponentMetadataBase {
-    kind: 'agent';
-}
-export interface RemoteOutputStyleMetadata extends RemoteExtensionComponentMetadataBase {
-    kind: 'output_style';
-    keepCodingInstructions?: boolean;
-}
-export type RemoteExtensionComponentMetadata = RemoteSkillMetadata | RemoteCommandMetadata | RemoteAgentMetadata | RemoteOutputStyleMetadata;
-export interface RemotePluginMetadata {
-    kind: 'plugin';
-    ref: string;
-    name: string;
-    description?: string;
-    scope: Exclude<RemoteExtensionScope, 'plugin'>;
-    components: RemoteExtensionComponentMetadata[];
-    hooks?: RemoteHookMetadata[];
-    options?: Record<string, JsonValue>;
-    settings?: {
-        agent?: string;
-    };
-}
-export type RemoteExtensionMetadata = RemoteSkillMetadata | RemoteCommandMetadata | RemoteAgentMetadata | RemotePluginMetadata;
-export type RemoteExtensionContent = {
-    kind: 'skill';
-    ref: string;
-    instructions: string;
-    allowedTools?: string[];
-    context?: 'fork';
-    agent?: string;
-    model?: string;
-    disableModelInvocation?: boolean;
-    userInvocable?: boolean;
-} | {
-    kind: 'command';
-    ref: string;
-    prompt: string;
-    allowedTools?: string[];
-    argumentHint?: string;
-    model?: string;
-    disableModelInvocation?: boolean;
-} | {
-    kind: 'agent';
-    ref: string;
-    instructions: string;
-    tools?: string[];
-    model?: string;
-    permissionMode?: string;
-    skills?: string[];
-    color?: string;
-} | {
-    kind: 'output_style';
-    ref: string;
-    content: string;
-    keepCodingInstructions?: boolean;
-} | {
-    kind: 'hook_prompt';
-    ref: string;
-    prompt: string;
-    model?: string;
-    continueOnBlock?: boolean;
-};
-export interface ExtensionResourceContent {
-    encoding: 'utf8' | 'base64';
-    content: string;
-}
-export interface RemoteHookInput {
-    event: RemoteHookEvent;
-    payload: Record<string, JsonValue>;
-}
-export type RemoteHookRawResult = {
-    kind: 'command';
-    result: ExecRunResult;
-} | {
-    kind: 'http';
-    status: number;
-    body: string;
-} | {
-    kind: 'http';
-    status: null;
-    failure: 'network' | 'timeout' | 'denied';
-    errorMessage?: string;
-};
-export interface RemoteExtensionHandler {
-    load(ref: string, signal: AbortSignal): Promise<RemoteExtensionContent>;
-    readResource(ref: string, path: string, signal: AbortSignal): Promise<ExtensionResourceContent>;
-    executeHook(hookRef: string, input: RemoteHookInput, signal: AbortSignal): Promise<RemoteHookRawResult>;
-}
-export interface RemoteExtensionsOptions {
-    metadata: RemoteExtensionMetadata[];
-    handler: RemoteExtensionHandler;
-}
 export interface Options {
     /** Controller for cancelling the query */
     abortController?: AbortController;
@@ -1439,8 +891,6 @@ export interface Options {
     pathToCodebuddyCode?: string;
     /** Request timeout for control requests (milliseconds) */
     requestTimeoutMs?: number;
-    /** Opaque per-query context used by managed remote operation protocols. */
-    remoteContext?: RemoteOperationContext;
     /** Permission mode */
     permissionMode?: PermissionMode;
     /** Require explicit flag for bypassPermissions */
@@ -1451,17 +901,6 @@ export interface Options {
     resume?: string;
     /** Custom session ID for creating new sessions */
     sessionId?: string;
-    /**
-     * 会话存储后端。默认由 CLI 以 mirror 模式运行：本地 JSONL 是真源，
-     * 每批条目异步转发到 append()；persistSession:false 选择 remote 模式，
-     * CLI 不读写本地 history JSONL。mirror 写失败重试耗尽或收尾 flush 超时后合成
-     * {type:'system', subtype:'mirror_error'} 帧，查询继续；超时表示远端结果未知。
-     * 与 enableFileCheckpointing:true 互斥，因为 file-history 备份 blob 不在
-     * SessionStore 协议内。
-     */
-    sessionStore?: SessionStore;
-    /** remote 模式下由宿主绑定的稳定逻辑项目 key。 */
-    sessionStoreProjectKey?: string;
     /** Resume at specific message ID */
     resumeSessionAt?: string;
     /** Sandbox settings */
@@ -1492,63 +931,6 @@ export interface Options {
     traceId?: string;
     /** Parent span ID from upstream caller, used to link CLI trace as child of upstream span. */
     parentSpanId?: string;
-    /** FileSystem 替换实现：modules='all' 时替换全部已接入 module。 */
-    fileSystem?: FileSystemOptions;
-    /** Search 替换实现：Glob/Grep 由 SDK host 在权威 workspace 上执行。 */
-    search?: SearchOptions;
-    /** Host 权威运行环境快照；系统提示词不得再读取控制面进程环境。 */
-    environmentSnapshot?: EnvironmentSnapshotOptions;
-    /** todo/task 等可变 Agent 状态的 host 权威存储。 */
-    agentStateStore?: AgentStateStoreOptions;
-    /** Channel 处理器：cbc 下发 channel control-request 时由 SDK 路由到此。 */
-    channel?: ChannelOptions;
-    /** Exec 替换实现：cbc 下发 exec.run control-request 时由 SDK 路由到此。 */
-    exec?: ExecOptions;
-    /** Query 级远端扩展清单与按需处理器。处理器留在 SDK 宿主进程。 */
-    remoteExtensions?: RemoteExtensionsOptions;
-    /**
-     * 控制面本地执行拒绝清单。传入即开启：拒绝会在控制面本地 spawn 子进程的
-     * 执行消费者（当前 mcpStdio / lsp）。'all' = 全部（含未来新增）；数组 = 仅列出者；
-     * 未传 / [] = 不拒绝（本地 agent 现状）。用于控制面可能执行在远端的场景。
-     */
-    localExecutionDeny?: LocalExecutionDeny;
-    /**
-     * 远程 MCP 委托开关。开启后，cbc 仍负责发现/选择 MCP tool，
-     * 但真实 HTTP/SSE 请求由 SDK host 侧的 `mcpTransportFactory` 代发。
-     */
-    remoteMcp?: RemoteMcpOptions;
-    /**
-     * 暴露给 cbc 的远程 MCP server 清单。这里故意只放可给模型看的描述信息：
-     * serverName / transport / capabilityId / tools 等。
-     *
-     * 不要在这里放 url、headers、token 或 OAuth refresh 信息。真实 endpoint 和
-     * 凭证应由 host 侧按 tenant/user/session/run 维度解析，并在 `mcpTransportFactory`
-     * 中创建真实 MCP transport。
-     */
-    delegatedMcpServers?: McpMessageDelegatedServerDescriptor[];
-    /**
-     * host 侧提供的委托 transport 工厂。SDK 在 cbc 发起 `mcp_message` 时调用它：
-     *
-     * - `scopedKey`：由 controlConnectionId / tenantId / userId / sessionId / runId / serverName
-     *   拼出，用来索引本次会话可用的 endpoint 和凭证。
-     * - `descriptor`：来自 `delegatedMcpServers` 的非敏感描述。
-     *
-     * agent-sdk-js 不读取 `.env.local`，也不内置 OAuth 或 secret store；AL / Gateway /
-     * 业务 host 应在这里完成 endpoint 查找、OAuth token 刷新、secret 注入和审计。
-     */
-    mcpTransportFactory?: (scopedKey: string, descriptor: {
-        transport: 'http' | 'sse' | 'remote';
-        capabilityId?: string;
-    }) => Promise<import('./mcp/managed-remote-mcp-bridge').RealMcpTransport>;
-    /**
-     * scoped key 维度：control connection / tenant / user / run。
-     * 与 sessionId 一道拼成 `ManagedRemoteMcpBridge` 的 scoped key，避免多 tenant / 多 session /
-     * 多 run 之间串 endpoint / token / pending。任一缺失即退化（仍优于裸 serverName）。
-     */
-    controlConnectionId?: string;
-    tenantId?: string;
-    userId?: string;
-    runId?: string;
 }
 export interface SessionOptions {
     /** Custom session ID for the conversation */
@@ -1571,10 +953,6 @@ export interface SessionOptions {
     env?: Record<string, string | undefined>;
     /** Request timeout for control requests (milliseconds) */
     requestTimeoutMs?: number;
-    /** Enable file checkpointing. */
-    enableFileCheckpointing?: boolean;
-    /** Opaque connection context shared by all remote operations in this Session. */
-    remoteContext?: RemoteOperationContext;
     /** MCP server configurations (object or file path string) */
     mcpServers?: Record<string, McpServerConfig> | string;
     /** Strict MCP config validation */
@@ -1662,42 +1040,6 @@ export interface SessionOptions {
     thinking?: ThinkingConfig;
     /** Effort level for model reasoning. */
     effort?: Effort;
-    /** 会话存储后端；persistSession:false 选择 remote，否则为 mirror。 */
-    sessionStore?: SessionStore;
-    /** 是否保留 CLI 本地 Session；与 sessionStore 组合决定 mirror/remote。 */
-    persistSession?: boolean;
-    /** remote 模式下由宿主绑定的稳定逻辑项目 key。 */
-    sessionStoreProjectKey?: string;
-    /** FileSystem 替换实现：modules='all' 时替换全部已接入 module。 */
-    fileSystem?: FileSystemOptions;
-    /** Search 替换实现：同 Options.search。 */
-    search?: SearchOptions;
-    /** Host 权威运行环境快照：同 Options.environmentSnapshot。 */
-    environmentSnapshot?: EnvironmentSnapshotOptions;
-    /** Agent 可变状态存储：同 Options.agentStateStore。 */
-    agentStateStore?: AgentStateStoreOptions;
-    /** Channel 处理器：同 Options.channel，cbc 下发 channel control-request 时由 SDK 路由到此。 */
-    channel?: ChannelOptions;
-    /** Exec 替换实现：同 Options.exec，cbc 下发 exec.run control-request 时由 SDK 路由到此。 */
-    exec?: ExecOptions;
-    /** Session 级远端扩展清单与按需处理器。处理器留在 SDK 宿主进程。 */
-    remoteExtensions?: RemoteExtensionsOptions;
-    /** 控制面本地执行拒绝清单，语义同 Options.localExecutionDeny。 */
-    localExecutionDeny?: LocalExecutionDeny;
-    /** 同 Options.remoteMcp。 */
-    remoteMcp?: RemoteMcpOptions;
-    /** 同 Options.delegatedMcpServers；host 声明的委托远程 MCP server 描述符。 */
-    delegatedMcpServers?: McpMessageDelegatedServerDescriptor[];
-    /** 同 Options.mcpTransportFactory；受管层提供的委托 transport 工厂。 */
-    mcpTransportFactory?: (scopedKey: string, descriptor: {
-        transport: 'http' | 'sse' | 'remote';
-        capabilityId?: string;
-    }) => Promise<import('./mcp/managed-remote-mcp-bridge').RealMcpTransport>;
-    /** 同 Options 的 scoped key 维度字段。 */
-    controlConnectionId?: string;
-    tenantId?: string;
-    userId?: string;
-    runId?: string;
 }
 export interface Session {
     readonly sessionId: string;
@@ -1706,7 +1048,7 @@ export interface Session {
     send(message: string | UserMessage): Promise<void>;
     /** Stream messages from the agent */
     stream(): AsyncGenerator<Message, void>;
-    close(): Promise<void>;
+    close(): void;
     [Symbol.asyncDispose](): Promise<void>;
     /**
      * Set the permission mode for the session.
@@ -1827,40 +1169,15 @@ export interface SdkCapabilities {
     elicitation?: {
         form?: boolean;
     };
-    /** host 声明的远程 MCP 委托能力。 */
-    mcp?: {
-        remoteMcpManaged?: true;
-        remoteTransports?: Array<'http' | 'sse' | 'remote'>;
-    };
-}
-/**
- * host 声明的远程 MCP server 描述符。
- * 不含 url / headers / token / urlRef —— 真实 endpoint/token 只存在于
- * Gateway registry，按 scoped key 索引。
- */
-export interface McpMessageDelegatedServerDescriptor {
-    serverName: string;
-    transport: 'http' | 'sse' | 'remote';
-    description?: string;
-    scope?: string;
-    capabilityId?: string;
-    tools?: Record<string, unknown>;
-    builtin_tools?: string[];
-    transparent_proxy?: boolean;
 }
 export interface ControlInitializeRequest {
     subtype: 'initialize';
-    remoteContext?: RemoteOperationContext;
-    remoteExtensions?: {
-        metadata: RemoteExtensionMetadata[];
-    };
     hooks?: Partial<Record<HookEvent, Array<{
         matcher?: string;
         hookCallbackIds: string[];
         timeout?: number;
     }>>>;
     sdkMcpServers?: string[];
-    delegatedMcpServers?: McpMessageDelegatedServerDescriptor[];
     jsonSchema?: Record<string, unknown>;
     systemPrompt?: string;
     appendSystemPrompt?: string;
@@ -1874,17 +1191,9 @@ export interface ControlInitializeRequest {
     /** Whether a prompt will be sent after initialization (used for resume history decision) */
     hasPrompt?: boolean;
 }
-export interface ControlShutdownRequest {
-    subtype: 'shutdown';
-    session_id?: string;
-    reason: 'prompt_input_exit' | 'other';
-}
 export interface ControlInitializeResponse {
     /** The current model ID resolved by CLI */
     currentModelId?: string;
-    commands?: SlashCommand[];
-    models?: ModelInfo[];
-    account?: AccountInfo;
 }
 export interface ControlInterruptRequest {
     subtype: 'interrupt';
@@ -2077,7 +1386,7 @@ export interface ControlLogoutRequest {
 /**
  * Supported subscription channels.
  */
-export type SubscriptionChannel = 'commands' | 'elicitation' | 'session_store';
+export type SubscriptionChannel = 'commands' | 'elicitation';
 /**
  * Subscribe request - subscribe to a channel for push notifications.
  */
@@ -2099,16 +1408,6 @@ export interface ControlUnsubscribeRequest {
     subtype: 'unsubscribe';
     channel: SubscriptionChannel;
 }
-/**
- * Channel event push: SDK handler receives events from server SSE and pushes them
- * back to cbc via this control-request. cbc's ChannelEventSubtypeHandler forwards
- * them to ChannelEventReceiver subscribers (e.g. RemoteChannelMcpTransport).
- */
-export interface ControlChannelEventRequest {
-    subtype: 'channel_event';
-    channelId: string;
-    event: ChannelEvent;
-}
 /**
  * Unsubscribe response.
  */
@@ -2149,103 +1448,7 @@ export interface CommandsNotificationData {
     }>;
     timestamp: number;
 }
-/**
- * 会话记录的寻址 key（形状对齐 Claude Agent SDK SessionKey）。
- */
-export interface SessionKey {
-    /**
-     * 工作目录的稳定文件系统安全编码，等于 CLI 的项目目录名
-     * （PathUtils.compressPath 产物，如 'Users-me-my-project'）。
-     */
-    projectKey: string;
-    /** 主会话 UUID */
-    sessionId: string;
-    /**
-     * 子代理记录时设置，格式 `subagents/agent-<id>`，视为不透明 key 后缀；
-     * undefined 指主记录。
-     */
-    subpath?: string;
-}
-/** JSON wire-safe history item；业务 id 不承担持久化幂等语义。 */
-export interface SessionStoreEntry {
-    type: string;
-    id?: string;
-    [key: string]: unknown;
-}
-export interface SessionStoreEvent {
-    eventId: string;
-    item: SessionStoreEntry;
-}
-export type SessionStoreMode = 'mirror' | 'remote';
-export type SessionStoreCapability = 'immutable_event_identity' | 'atomic_batch_append' | 'payload_conflict_detection' | 'canonical_payload_v1' | 'subsession_addressing' | 'list_sessions' | 'list_subkeys' | 'delete' | 'deleted_key_fencing';
-export interface ControlSessionStoreRequest {
-    subtype: 'session_store';
-    op: 'initialize' | 'append' | 'load' | 'listSessions' | 'listSubkeys' | 'delete';
-    mode?: 'mirror' | 'remote';
-    protocolVersion?: 1;
-    requiredCapabilities?: SessionStoreCapability[];
-    key?: SessionKey;
-    events?: SessionStoreEvent[];
-    contextId?: string;
-}
-export type ControlRemoteExtensionRequest = {
-    subtype: 'remote_extension';
-    op: 'load';
-    contextId?: string;
-    ref: string;
-} | {
-    subtype: 'remote_extension';
-    op: 'read_resource';
-    contextId?: string;
-    ref: string;
-    path: string;
-} | {
-    subtype: 'remote_extension';
-    op: 'execute_hook';
-    contextId?: string;
-    hookRef: string;
-    input: RemoteHookInput;
-};
-export interface SessionStoreInitializeResult {
-    protocolVersion: 1;
-    capabilities: SessionStoreCapability[];
-    projectKey?: string;
-}
-/**
- * 会话存储后端（形状对齐 Claude Agent SDK SessionStore）。
- *
- * mirror 模式下本接口是本地真源的副本；remote 模式下本接口是真源。
- * retention 是适配器的责任。
- */
-export interface SessionStore {
-    /** 按完整 key 原子追加，按 eventId 做不可变幂等。 */
-    append(key: SessionKey, events: SessionStoreEvent[]): Promise<void>;
-    /**
-     * CLI 恢复会话时调用；会话未知返回 null。
-     * 返回条目须与追加时深度相等（不要求字节相等的序列化）。
-     */
-    load(key: SessionKey): Promise<SessionStoreEvent[] | null>;
-    /** 按 projectKey 列举主会话。 */
-    listSessions(projectKey: string): Promise<Array<{
-        sessionId: string;
-        mtime: number;
-    }>>;
-    /** 删主 key 必须级联删除子 key，并阻止迟到 append 复活。 */
-    delete(key: SessionKey): Promise<void>;
-    /** 枚举主会话下的子代理 subpath。 */
-    listSubkeys(key: {
-        projectKey: string;
-        sessionId: string;
-    }): Promise<string[]>;
-}
-/**
- * session_store channel 的通知负载：CLI 每批历史落盘成功后 fire-and-forget 下发。
- */
-export interface SessionStoreMirrorNotificationData {
-    key: SessionKey;
-    events: SessionStoreEvent[];
-}
-export type ControlRequestPayload = ControlInitializeRequest | ControlShutdownRequest | ControlInterruptRequest | ControlSetPermissionModeRequest | ControlSetModelRequest | ControlSetConfigRequest | ControlGetAvailableModesRequest | ControlGetAvailableModelsRequest | ControlSetMaxThinkingTokensRequest | ControlHookCallbackRequest | ControlPermissionRequest | ControlElicitationCreateRequest | ControlMcpMessageRequest | ControlLogoutRequest | ControlSubscribeRequest | ControlUnsubscribeRequest | ControlChannelEventRequest | ControlSessionStoreRequest | ControlRemoteExtensionRequest;
+export type ControlRequestPayload = ControlInitializeRequest | ControlInterruptRequest | ControlSetPermissionModeRequest | ControlSetModelRequest | ControlSetConfigRequest | ControlGetAvailableModesRequest | ControlGetAvailableModelsRequest | ControlSetMaxThinkingTokensRequest | ControlHookCallbackRequest | ControlPermissionRequest | ControlElicitationCreateRequest | ControlMcpMessageRequest | ControlLogoutRequest | ControlSubscribeRequest | ControlUnsubscribeRequest;
 export interface ControlRequest {
     type: 'control_request';
     request_id: string;
@@ -2260,12 +1463,10 @@ export interface ControlErrorResponse {
     subtype: 'error';
     request_id: string;
     error: string;
-    code?: string;
 }
 export interface ControlResponseMessage {
     type: 'control_response';
     response: ControlResponse | ControlErrorResponse;
 }
 export type ControlSignalMessage = ControlRequest | ControlResponseMessage;
-export {};
 //# sourceMappingURL=types.d.ts.map