@kiturone/kapibala 0.0.5 → 0.0.6

package/dist/index.d.cts

@@ -231,10 +231,20 @@ declare class KapibalaError extends Error {
     readonly code: string;
     readonly retryPolicy: 'never' | 'immediate' | 'backoff' | 'after_user_action';
     readonly safeMessage: string;
+    readonly dispatchOutcome?: 'not_sent' | 'succeeded' | 'failed' | 'unknown';
     constructor(message: string, options?: {
         code?: string;
         retryPolicy?: 'never' | 'immediate' | 'backoff' | 'after_user_action';
         safeMessage?: string;
+        dispatchOutcome?: 'not_sent' | 'succeeded' | 'failed' | 'unknown';
+    });
+}
+/** 工具向外部发送前在微任务复核或状态检查中被撤销/拒绝；dispatchOutcome 固定 not_sent。 */
+declare class PreDispatchError extends KapibalaError {
+    constructor(message: string, options?: {
+        code?: string;
+        retryPolicy?: 'never' | 'after_user_action';
+        safeMessage?: string;
     });
 }
 /** 模型调用失败；message 已脱敏，对外诊断统一经 describeModelError 产出，retryPolicy 仅为处理建议。 */
@@ -336,11 +346,26 @@ interface ProviderStateBlock {
 }
 /** canonical 历史的内容块联合；provider_state 等私有块只在同 run、同模型与端点续答回传。 */
 type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ThinkingBlock | RedactedThinkingBlock | ProviderStateBlock;
+/**
+ * 宿主准备受控 Prompt 时的来源元数据（v1）。
+ * 用于追踪 Prompt 来源、版本与内容摘要；不保存认证值或重复保存原始参数，
+ * 不发送到 Provider wire，不从历史恢复授权。
+ */
+interface PromptContentSource {
+    version: 1;
+    server: string;
+    name: string;
+    scope?: string;
+    contentDigest?: string;
+    configIdentity?: string;
+}
 interface TextBlock {
     type: 'text';
     text: string;
     /** 宿主注入技能的可选来源；只追踪正文，缺失或恢复不授予权限。 */
     skillSource?: SkillContentSource;
+    /** 宿主注入受控 Prompt 的可选来源；只追踪正文与审计摘要，缺失或恢复不授予权限。 */
+    promptSource?: PromptContentSource;
     /** 源 wire Item 元数据；正文被改写后由调用方清除，不作为业务身份。 */
     protocolMeta?: ProtocolItemMetadata;
 }
@@ -356,6 +381,19 @@ interface ToolUseBlock {
     /** 源 wire Item 元数据；内容被改写后由调用方清除，不作为业务身份。 */
     protocolMeta?: ProtocolItemMetadata;
 }
+/**
+ * canonical 工具结果的可选 v1 执行事实元数据。
+ * 适配器按发送证据先记录 dispatchOutcome，执行器在发生本地钩子、校验、转换或审计失败时附加 hostError。
+ * 随 canonical 结果持久化；不直接上 Provider wire，不从历史中推断不存在的事实。
+ */
+interface ToolResultExecution {
+    version: 1;
+    dispatchOutcome: 'not_sent' | 'succeeded' | 'failed' | 'unknown';
+    hostError?: {
+        phase: 'validation' | 'projection' | 'hook' | 'audit';
+        code: string;
+    };
+}
 interface ToolResultBlock {
     type: 'tool_result';
     /** 完整技能正文的宿主来源；不发送到Provider wire，不从历史恢复授权。 */
@@ -369,6 +407,12 @@ interface ToolResultBlock {
     errorCode?: string;
     /** 不代表自动重试，只描述调用方应如何处理该错误。 */
     retryPolicy?: 'never' | 'immediate' | 'backoff' | 'after_user_action';
+    /**
+     * 可选 v1 执行事实元数据。
+     * 适配器按发送证据先记录 dispatchOutcome，执行器在发生本地钩子、校验、转换或审计失败时附加 hostError。
+     * 随 canonical 结果持久化；不直接上 Provider wire，不从历史中推断不存在的事实。
+     */
+    execution?: ToolResultExecution;
 }
 interface ThinkingBlock {
     type: 'thinking';
@@ -587,6 +631,13 @@ type SessionEvent = {
     usage?: Usage;
     ttftMs?: number;
     durationMs?: number;
+} | {
+    type: 'mcp_prompt_loaded';
+    server: string;
+    name: string;
+    persistence: 'disk' | 'memory';
+    promptSource: PromptContentSource;
+    runId?: string;
 } | {
     type: 'turn_finish';
     turn: number;
@@ -1523,7 +1574,28 @@ declare class PermissionPolicy {
 declare function visibleTools(tools: readonly Tool[], mode: SessionMode, rules?: readonly PermissionRule[]): Tool[];
 
 /** 执行能力的最小分类；权限规则、模式裁决与工具元数据声明共用这一词汇表。 */
-type Capability = 'fs:read' | 'fs:write' | 'exec' | 'net:outbound' | 'env:read' | 'agent:spawn';
+type Capability = 'fs:read' | 'fs:write' | 'exec' | 'net:outbound' | 'env:read' | 'agent:spawn' | 'external:call';
+/**
+ * 外部调用的精确执行身份；供审批缓存、发送前复核与审计消费。
+ * 包含服务端物理身份、连接代次、目录 epoch 与定义摘要等不可伪造字段。
+ */
+interface ToolExecutionIdentity {
+    serverIdentity?: string;
+    connectionGeneration?: number;
+    catalogEpoch?: number;
+    toolDigest?: string;
+    [key: string]: unknown;
+}
+/**
+ * 显式 opt-in 规范化执行结果；普通对象返回值保持兼容不强制包装。
+ */
+interface ToolExecutionResult {
+    content: string;
+    isError?: boolean;
+    errorCode?: string;
+    retryPolicy?: 'never' | 'after_user_action';
+    execution?: ToolResultExecution;
+}
 interface ToolMetadata {
     /** 注册来源标记（如 'builtin'）；注册表据此执行冲突策略并支持按源注销。 */
     source?: string;
@@ -1533,6 +1605,8 @@ interface ToolMetadata {
     permissions?: Capability[];
     /** 工具自身等待进程资源回收，执行器不可再使用通用 Promise.race 超时。 */
     managesTimeout?: boolean;
+    /** 只读提示；工具声明自身无副作用，供 UI 展示与只读过滤参考。 */
+    readOnlyHint?: boolean;
 }
 /** 工具执行期由宿主注入的运行环境；信号取消后工具应尽快清理在途资源再返回。 */
 interface ToolContext {
@@ -1547,6 +1621,13 @@ interface ToolContext {
         outputBytes: number;
     }) => void;
 }
+/**
+ * 工具输入参数校验结果；valid 为 false 或抛出异常均阻止审批和发送。
+ */
+interface ToolInputValidation {
+    valid: boolean;
+    message?: string;
+}
 /** 工具契约；parameters 是 JSON Schema，模型只能看到经 toToolDefinition 投影后的三个字段。 */
 interface Tool<TInput = Record<string, unknown>, TOutput = unknown> {
     readonly name: string;
@@ -1555,6 +1636,12 @@ interface Tool<TInput = Record<string, unknown>, TOutput = unknown> {
     readonly metadata?: ToolMetadata;
     /** 声明本次输入的精确执行目标，供审批展示与执行前指纹复核；无固定执行目标的工具不实现。 */
     approvalScope?(input: TInput, rootDir: string): ShellScope;
+    /** 本次执行身份；审批缓存与执行前复核消费，缺省保持旧工具规则。 */
+    executionIdentity?(input: TInput, rootDir: string): ToolExecutionIdentity;
+    /** 无副作用地校验最终参数，不修改参数、不访问远端；异常与拒绝均阻止审批和发送。 */
+    validateInput?(input: TInput): ToolInputValidation | undefined;
+    /** 显式 opt-in 转换为标准执行结果；未提供时普通返回值继续作为常规输出。 */
+    toExecutionResult?(raw: TOutput): ToolExecutionResult;
     execute(input: TInput, ctx: ToolContext): Promise<TOutput>;
 }
 /** 恒等构造器：只为工具实现提供类型推断与统一书写形式，不产生任何运行时包装。 */
@@ -1602,6 +1689,10 @@ interface ApprovalRequest {
     input: Record<string, unknown>;
     rootDir: string;
     shell?: ShellScope;
+    /**
+     * 本次调用的外部执行身份；深度哈希纳入审批缓存键，断连重连或目录变更后旧会话批准自动失效。
+     */
+    executionIdentity?: ToolExecutionIdentity;
     /** 宿主是否允许本次请求写入会话级允许缓存；deny_session 的缓存不受此限制。 */
     sessionAllowed: boolean;
 }
@@ -1621,29 +1712,68 @@ declare class SessionApprovalCache {
 
 /** 同名工具冲突策略：error 直接抛错；prefer-builtin 保留既有内置注册；prefer-last 后到者覆盖。 */
 type ConflictPolicy = 'error' | 'prefer-builtin' | 'prefer-last';
+/**
+ * 不可变工具注册表快照；捕获特定时刻的工具定义、执行引用与版本。
+ * 外部注册表后续的增删改绝不改写已有快照视图。
+ */
+interface ToolRegistrySnapshot {
+    readonly version: number;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    resolve(name: string): Tool;
+    list(): Tool[];
+    definitions(): ToolDefinition[];
+    sourceOf(name: string): string | undefined;
+}
 /**
  * 按名称索引的工具注册表。冲突按构造时给定的策略处理，胜出条目的来源标签保持不变；
- * 来源标签支持按源批量注册与注销，注销只移除以该标签注册的工具，不回收冲突中保留的内置实现。
+ * 支持原子来源替换（replaceSource）、不可变运行快照（snapshot）与来源注销。
  */
 declare class ToolRegistry {
     private readonly tools;
     private readonly toolSources;
     private readonly conflictPolicy;
+    private version;
     constructor(options?: {
         conflictPolicy?: ConflictPolicy;
     });
+    /** 获取当前注册表版本号；每次有效变更（注册、替换、注销）单调自增。 */
+    get currentVersion(): number;
     register(tool: Tool, opts?: {
         source?: string;
     }): void;
+    /**
+     * 原子替换指定来源的全部工具：
+     * 1. 预检候选批内自身重名：若候选批次内包含同名工具，整批拒绝；
+     * 2. 预检跨来源冲突：若候选工具被其它来源占用且策略不允许覆盖，整批拒绝；
+     * 3. 同步原子提交：预检全部通过后一次性清理该来源旧工具并写入新工具；失败时完全保持旧状态不变。
+     */
+    replaceSource(source: string, tools: Tool[]): void;
+    /**
+     * 注册指定来源的工具集。
+     *
+     * 语义与约束：
+     * 1. 委托给 `replaceSource` 实现整源原子替换（新集合未包含的该来源旧工具将被注销移除，非增量累加）；
+     * 2. 默认禁止跨来源名称冲突（抛出 KapibalaError TOOL_CONFLICT）；若 options 配置了 conflictPolicy: 'prefer-last' 则允许覆盖旧来源同名工具；
+     * 3. 预检阶段发现批内同名重复时整批拒绝，绝不破坏注册表原子状态。
+     */
     registerSource(source: string, tools: Tool[]): void;
     unregisterSource(source: string): void;
     get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    /** 获取工具对应的来源标记。 */
+    sourceOf(name: string): string | undefined;
     /** 注销指定名称及来源记录；调用方须核对实例身份，不能移除同名替代工具。 */
     unregister(name: string): void;
     /** 未命中时抛 ToolNotFound，并携带当前全部可用名称辅助模型自纠。 */
     resolve(name: string): Tool;
     list(): Tool[];
     definitions(): ToolDefinition[];
+    /**
+     * 捕获当前注册表的不可变只读快照。
+     * 注册表后续的增删改绝不改变该快照的定义列表、工具执行实例与来源版本。
+     */
+    snapshot(): ToolRegistrySnapshot;
 }
 
 /**
@@ -1724,7 +1854,7 @@ interface ExecutorOptions {
     hardDenial?: (tool: Tool, input: Record<string, unknown>) => ToolHardDenial | undefined;
     /** 结果钩子和执行审计完成后调用；用于在同批次下一调用前安装宿主收紧状态。 */
     onToolResult?: (tool: Tool, input: Record<string, unknown>, result: ToolResultBlock) => void | Promise<void>;
-    tools: ToolRegistry;
+    tools: ToolRegistry | ToolRegistrySnapshot;
     hooks: HookRegistry;
     /** 工具执行的绝对根目录；路径解析与审批均以此为基准。 */
     rootDir: string;
@@ -2024,12 +2154,55 @@ interface PluginContext {
     readonly rootDir: string;
     readonly logger?: (msg: string) => void;
 }
-/** 插件生命周期：setup 在会话空闲时挂载执行一次，teardown 在会话销毁时逐个调用以回收资源。 */
+/**
+ * 插件声明的命令贡献描述元数据。
+ *
+ * 约束、边界与为什么：
+ * 1. 纯元数据定义：只包含名称、描述、用法与变更标记，禁止引入 ANSI 渲染、Readline 或 TTY 依赖，坚守 Core Headless 铁律；
+ * 2. 供宿主（CLI/TUI/Web）按需消费并装配到人机交互界面；非交互或 Headless 宿主可安全忽略本字段；
+ * 3. 别名与主名均遵循全小写规范，防止跨平台输入歧义。
+ */
+interface PluginCommandContribution {
+    /** 命令主名称（不含前导斜杠，如 'mcp' 或 'prompts'）。 */
+    readonly name: string;
+    /** 命令用途说明，供帮助菜单展示。 */
+    readonly description: string;
+    /** 格式化调用用法（如 '/mcp [tools <server>]'）。 */
+    readonly usage?: string;
+    /** 可选别名列表（如 ['plugin']）。 */
+    readonly aliases?: readonly string[];
+    /** 命令是否产生状态变更；true 表示写操作（受忙碌状态门拦截），false 表示纯只读诊断。 */
+    readonly mutates?: boolean;
+}
+/**
+ * 插件声明的扩展贡献元数据聚合容器。
+ *
+ * 约束与边界：
+ * 1. 声明式规范：允许外部扩展包一次性声明技能根目录、交互命令与扩展元数据；
+ * 2. 宿主（CLI）在会话挂载插件时自动读取并完成装配，无需在宿主层硬编码插件内部命令。
+ */
+interface PluginContribution {
+    /** 插件显式携带或依赖的技能根目录集合（绝对物理路径）。 */
+    readonly skillsRoots?: readonly string[];
+    /** 插件贡献给宿主交互终端的斜杠命令列表。 */
+    readonly commands?: readonly PluginCommandContribution[];
+}
+/**
+ * 插件生命周期契约：setup 在会话空闲时挂载执行一次，teardown 在会话销毁时逐个调用以回收资源。
+ * 遵循「一 Session 一插件实例」约束，实现外部生态向 Agent Harness 的受控单向注入。
+ */
 interface AgentPlugin {
-    /** 用于挂载失败与 teardown 的诊断信息。 */
+    /** 插件唯一识别名称，用于诊断输出与依赖追踪。 */
     readonly name: string;
+    /** 插件语义版本号，默认遵循包版本。 */
     readonly version?: string;
+    /** 插件用途与功能描述。 */
+    readonly description?: string;
+    /** 插件声明的扩展贡献元数据（命令清单、技能目录等）。 */
+    readonly contributes?: PluginContribution;
+    /** 挂载执行入口；仅在空闲状态调用，可向 tools / hooks 注册能力。 */
     setup(ctx: PluginContext): void | Promise<void>;
+    /** 销毁回收入口；必须幂等执行，彻底清理进程、网络连接或定时器。 */
     teardown?(): void | Promise<void>;
 }
 
@@ -2176,7 +2349,7 @@ interface PromptAssemblerOptions {
     contextWindow?: number;
     skillBudgetTokens?: number;
     /** 提供时才生成 L2 工具清单段；缺省表示本次运行不向模型展示任何工具。 */
-    tools?: ToolRegistry;
+    tools?: ToolRegistry | ToolRegistrySnapshot;
     /** L3 环境段展示的工作区根目录；文件工具的沙箱边界与其保持一致。 */
     rootDir: string;
     agentName?: string;
@@ -2226,7 +2399,7 @@ interface AgentLoopOptions {
     onToolBatchUpdate?: (messages: readonly CanonicalMessage[]) => void;
     provider: ModelProvider;
     executor: ToolExecutor;
-    tools: ToolRegistry;
+    tools: ToolRegistry | ToolRegistrySnapshot;
     hooks: HookRegistry;
     systemPrompt?: string;
     /** 单次 run 的最大 turn 数，耗尽时以 error 事件收尾；缺省 20。 */
@@ -2279,6 +2452,28 @@ declare class AgentLoop {
     run(history: CanonicalMessage[]): AsyncIterable<SessionEvent>;
 }
 
+/**
+ * 任务准备上下文；提供当前会话取消信号、runId 与不可变工具快照。
+ */
+interface PreparedTaskContext {
+    signal?: AbortSignal;
+    runId: string;
+    tools: ToolRegistrySnapshot;
+}
+/**
+ * 任务准备产物；包含要附加到 User 消息的内容块，以及提交前的身份复核回调。
+ */
+interface PreparedTaskResult {
+    /** 任务附加内容块或纯文本（如 Prompt 内容或技能正文）。 */
+    content: ContentBlock[] | string;
+    /** 可选来源元数据；仅在 content 为 string 时由宿主自动包装为带来源的 TextBlock。 */
+    promptSource?: PromptContentSource;
+    /** 最终提交前核对准备身份；若在此期间目录变化或连接重置，返回 false 拒绝提交并零发送闭合。 */
+    verifyIdentity?: () => boolean | Promise<boolean>;
+    /** 可选技能名称；存在时按显式技能流程处理。 */
+    skillName?: string;
+}
+
 /** AgentSession 的构造配置；除主任务绑定外均可缺省，缺省行为见各字段。 */
 interface SessionConfig {
     /** 宿主显式技能配置；缺省不扫描home，项目根需独立信任。 */
@@ -2392,6 +2587,12 @@ declare class AgentSession {
     init(): Promise<void>;
     /** 挂载插件并执行 setup；销毁后或运行中拒绝，setup 失败的插件不进入已装列表。 */
     use(plugin: AgentPlugin): Promise<void>;
+    /**
+     * 获取当前会话已成功挂载的扩展插件只读列表。
+     *
+     * 保证返回当前状态的独立切片，外部修改不污染内部挂载表。
+     */
+    getPlugins(): readonly AgentPlugin[];
     /**
      * 空闲时原子替换角色的模型绑定；本方法不改变当前角色或工具权限。
      * @param profile 模型协议、请求目标和输出预算。
@@ -2412,6 +2613,8 @@ declare class AgentSession {
     /** 只在空闲时切换本次会话模式；宿主负责 FullAccess 的显式选择交互。 */
     switchMode(mode: SessionMode): void;
     getMode(): SessionMode;
+    /** 获取当前会话生效的权限规则列表。 */
+    getPermissionRules(): readonly PermissionRule[];
     /** 返回最近一次成功装载的来源路径，不暴露指令正文。 */
     getInstructionSources(): string[];
     /** 稳定会话身份，独立于当前进程日志实例和每次用户交互。 */
@@ -2464,6 +2667,19 @@ declare class AgentSession {
         signal?: AbortSignal;
         role?: PrimaryModelRole;
     }): AsyncIterable<SessionEvent>;
+    /**
+     * 受控任务准备入口：在同一运行锁内异步准备文本块/来源，预算和存储成功后才进入模型。
+     *
+     * @param task 用户显式任务正文（或命令描述）。
+     * @param prepare 异步任务准备函数；在锁内执行，若准备失败或取消则释放锁且零 append。
+     * @param options 可选中止信号与显式主任务角色。
+     * @returns 结构化事件的异步流。
+     * @throws {SessionBusyError} 当前会话忙碌时抛出。
+     */
+    runPreparedTask(task: string, prepare: (context: PreparedTaskContext) => Promise<PreparedTaskResult>, options?: {
+        signal?: AbortSignal;
+        role?: PrimaryModelRole;
+    }): AsyncIterable<SessionEvent>;
     /** 单次任务执行主体；调用方 return 的中止与 finally 清理由外层统一协调。 */
     private runOperation;
     /** 幂等销毁：卸载插件后发出 session:end；运行中拒绝，teardown 失败聚合抛出且不完成销毁。 */
@@ -2505,4 +2721,4 @@ declare class AgentSession {
     private findClosedToolMessages;
 }
 
-export { AbortError, AgentLoop, type AgentLoopOptions, type AgentPlugin, AgentSession, AnthropicProvider, type AnthropicProviderOptions, type ApprovalChannel, type ApprovalChoice, type ApprovalRequest, type CanonicalMessage, type Capability, type ChatCapabilities, type CommandResult, type ConflictPolicy, type ContentBlock, type ContextBudget, ContextBudgetError, ContextManager, type ContextManagerOptions, ContextOverflowError, type ContextSnapshot, ContextStorageError, type ContextSummary, type ContextUsage, type ContextWindowValue, DEFAULT_CONTEXT_WINDOW_TOKENS, type EventLogger, type ExecutorOptions, FatalError, type FileDetails, FileLogSink, type FileLogSinkOptions, type FileObservation, type HistoryRepair, type HookContext, type HookHandlers, type HookPoint, HookRegistry, type InstructionLoadOptions, type InstructionSnapshot, type InstructionSource, type InteractionBoundary, type InteractionTerminal, JSONLMessageStore, KapibalaError, type LogChannel, type LogEvent, type LogField, type LogInput, type LogLevel, type LogSink, type ManagedSession, type MessageRole, type MessageStore, ModelError, type ModelErrorCategory, type ModelErrorInfo, type ModelErrorOptions, type ModelEvent, type ModelProfile, type ModelProtocol, type ModelProvider, type ModelProviderBinding, type ModelRequest, type ModelRole, type ModelRouter, type NormalizedHistory, OpenAICompatibleProvider, type OpenAIProviderOptions, OpenAIResponsesProvider, type OpenAIResponsesProviderOptions, PathSandbox, type PermissionAction, type PermissionDecision, PermissionPolicy, type PermissionRequest, type PermissionRule, type PluginContext, type PreparedSkill, type PrimaryModelRole, type ProjectIdentity, PromptAssembler, type PromptAssemblerOptions, type ProtocolItemMetadata, type ProtocolOrigin, type ProviderStateBlock, type RedactedThinkingBlock, type RequestPreparation, type ResolvedContextWindow, type RunCommandInput, type RunMetrics, SESSION_SCHEMA_VERSION, SKILL_LIMITS, SUMMARY_OUTPUT_BUFFER_MULTIPLIER, type SandboxConfig, SessionApprovalCache, SessionBusyError, type SessionConfig, type SessionEvent, type SessionHeader, SessionLock, SessionManager, type SessionManagerOptions, type SessionMetadata, type SessionMode, type SessionRecord, type SessionRecordType, type SessionState, type SessionStats, SessionStore, type ShellDetectOptions, type ShellEnvironment, type ShellKind, type ShellPreference, type ShellScope, SimpleModelRouter, type SkillActivation, type SkillCatalog, type SkillContentSource, type SkillContextState, type SkillDefinition, type SkillDiagnostic, type SkillDocument, type SkillMetadata, type SkillOptions, type SkillQuery, type SkillQueryPage, SkillRegistry, type SkillResourceInput, type SkillResourcePage, type SkillRoot, SkillRuntime, type SkillScanResult, type SkillScope, type StatefulMessageStore, type StepLogEntry, type StepLogStage, StructuredLogger, type SummaryCandidate, SummaryService, type SummaryServiceOptions, type TextBlock, type ThinkingBlock, type TokenEstimate, type TokenEstimator, type Tool, type ToolContext, type ToolDecision, type ToolDefinition, ToolError, ToolExecutor, type ToolHardDenial, type ToolMetadata, ToolNotFound, ToolRegistry, type ToolResultBlock, type ToolUseBlock, TransportError, type TurnMetrics, UnicodeTokenEstimator, type Usage, assembleCanonicalToolResults, builtinTools, classifyBashOutput, cleanupCommandResults, commandAuditSummary, compareSkillPaths, createContextBudget, createDefaultLogSinks, createLogId, createMessageId, createRunCommandTool, defineTool, describeModelError, detectShell, editFileTool, escapeSkillXml, estimateSkillTokens, executionFingerprint, extractFileDetails, findSkillContent, formatSkillCatalog, globTool, grepTool, identifyHistory, indexInteractions, inspectSkillContent, intersectSkillTools, isSkillName, isTextBlock, isThinkingBlock, isToolResultBlock, isToolUseBlock, isWithinSkillRoot, listSkillResources, loadInstructions, normalizeHistory, normalizeSkillTools, parseSkillDocument, projectSafeFields, readBoundedSkillText, readFileTool, readSkillResource, recoverIncompleteAudit, renderFileDetails, renderSkillReloads, requestFingerprint, resolveContextWindow, resolveSessionProject, sanitizeModelErrorMessage, sanitizeSessionTitle, scanSkillRoot, skillDigest, skillFailure, skillPathKey, stableJsonStringify, stableSerialize, supportsSessionState, toToolDefinition, truncateToolOutput, validateModelBinding, validatePermissionRules, validateSummary, visibleTools, writeFileTool };
+export { AbortError, AgentLoop, type AgentLoopOptions, type AgentPlugin, AgentSession, AnthropicProvider, type AnthropicProviderOptions, type ApprovalChannel, type ApprovalChoice, type ApprovalRequest, type CanonicalMessage, type Capability, type ChatCapabilities, type CommandResult, type ConflictPolicy, type ContentBlock, type ContextBudget, ContextBudgetError, ContextManager, type ContextManagerOptions, ContextOverflowError, type ContextSnapshot, ContextStorageError, type ContextSummary, type ContextUsage, type ContextWindowValue, DEFAULT_CONTEXT_WINDOW_TOKENS, type EventLogger, type ExecutorOptions, FatalError, type FileDetails, FileLogSink, type FileLogSinkOptions, type FileObservation, type HistoryRepair, type HookContext, type HookHandlers, type HookPoint, HookRegistry, type InstructionLoadOptions, type InstructionSnapshot, type InstructionSource, type InteractionBoundary, type InteractionTerminal, JSONLMessageStore, KapibalaError, type LogChannel, type LogEvent, type LogField, type LogInput, type LogLevel, type LogSink, type ManagedSession, type MessageRole, type MessageStore, ModelError, type ModelErrorCategory, type ModelErrorInfo, type ModelErrorOptions, type ModelEvent, type ModelProfile, type ModelProtocol, type ModelProvider, type ModelProviderBinding, type ModelRequest, type ModelRole, type ModelRouter, type NormalizedHistory, OpenAICompatibleProvider, type OpenAIProviderOptions, OpenAIResponsesProvider, type OpenAIResponsesProviderOptions, PathSandbox, type PermissionAction, type PermissionDecision, PermissionPolicy, type PermissionRequest, type PermissionRule, type PluginCommandContribution, type PluginContext, type PluginContribution, PreDispatchError, type PreparedSkill, type PreparedTaskContext, type PreparedTaskResult, type PrimaryModelRole, type ProjectIdentity, PromptAssembler, type PromptAssemblerOptions, type PromptContentSource, type ProtocolItemMetadata, type ProtocolOrigin, type ProviderStateBlock, type RedactedThinkingBlock, type RequestPreparation, type ResolvedContextWindow, type RunCommandInput, type RunMetrics, SESSION_SCHEMA_VERSION, SKILL_LIMITS, SUMMARY_OUTPUT_BUFFER_MULTIPLIER, type SandboxConfig, SessionApprovalCache, SessionBusyError, type SessionConfig, type SessionEvent, type SessionHeader, SessionLock, SessionManager, type SessionManagerOptions, type SessionMetadata, type SessionMode, type SessionRecord, type SessionRecordType, type SessionState, type SessionStats, SessionStore, type ShellDetectOptions, type ShellEnvironment, type ShellKind, type ShellPreference, type ShellScope, SimpleModelRouter, type SkillActivation, type SkillCatalog, type SkillContentSource, type SkillContextState, type SkillDefinition, type SkillDiagnostic, type SkillDocument, type SkillMetadata, type SkillOptions, type SkillQuery, type SkillQueryPage, SkillRegistry, type SkillResourceInput, type SkillResourcePage, type SkillRoot, SkillRuntime, type SkillScanResult, type SkillScope, type StatefulMessageStore, type StepLogEntry, type StepLogStage, StructuredLogger, type SummaryCandidate, SummaryService, type SummaryServiceOptions, type TextBlock, type ThinkingBlock, type TokenEstimate, type TokenEstimator, type Tool, type ToolContext, type ToolDecision, type ToolDefinition, ToolError, type ToolExecutionIdentity, type ToolExecutionResult, ToolExecutor, type ToolHardDenial, type ToolInputValidation, type ToolMetadata, ToolNotFound, ToolRegistry, type ToolRegistrySnapshot, type ToolResultBlock, type ToolResultExecution, type ToolUseBlock, TransportError, type TurnMetrics, UnicodeTokenEstimator, type Usage, assembleCanonicalToolResults, builtinTools, classifyBashOutput, cleanupCommandResults, commandAuditSummary, compareSkillPaths, createContextBudget, createDefaultLogSinks, createLogId, createMessageId, createRunCommandTool, defineTool, describeModelError, detectShell, editFileTool, escapeSkillXml, estimateSkillTokens, executionFingerprint, extractFileDetails, findSkillContent, formatSkillCatalog, globTool, grepTool, identifyHistory, indexInteractions, inspectSkillContent, intersectSkillTools, isSkillName, isTextBlock, isThinkingBlock, isToolResultBlock, isToolUseBlock, isWithinSkillRoot, listSkillResources, loadInstructions, normalizeHistory, normalizeSkillTools, parseSkillDocument, projectSafeFields, readBoundedSkillText, readFileTool, readSkillResource, recoverIncompleteAudit, renderFileDetails, renderSkillReloads, requestFingerprint, resolveContextWindow, resolveSessionProject, sanitizeModelErrorMessage, sanitizeSessionTitle, scanSkillRoot, skillDigest, skillFailure, skillPathKey, stableJsonStringify, stableSerialize, supportsSessionState, toToolDefinition, truncateToolOutput, validateModelBinding, validatePermissionRules, validateSummary, visibleTools, writeFileTool };