berry-agent 0.1.0-alpha.1

package/dist/api/surface.json

@@ -0,0 +1,1632 @@
+{
+  "apiVersion": "1.0",
+  "enforcement": "pre-ignition",
+  "exports": [
+    {
+      "symbol": "AgentEvent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "AgentEvent 10 型联合",
+      "kind": "type",
+      "sig": "b6401b6a1a32d74e"
+    },
+    {
+      "symbol": "AgentEventSink",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "事件汇（消费面：TUI/SPA 活体呈现、金样录制器等；void/Promise 双形兼容）",
+      "kind": "type",
+      "sig": "c0da353134972f25"
+    },
+    {
+      "symbol": "AgentMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "消息模型全集：标准三角色 ∪ 自定义角色（loop 与驱动侧的共同消息面）",
+      "kind": "type",
+      "sig": "0b3b57587ae5c3a0"
+    },
+    {
+      "symbol": "AgentTool",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具执行体（loop 工具批消费的最小形状——完整 defineTool 形在 tools 件）",
+      "kind": "interface",
+      "sig": "4b1c41d587597499"
+    },
+    {
+      "symbol": "AgentToolCall",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具批执行输入项（assistant 内联 toolCall 块的直取形）",
+      "kind": "type",
+      "sig": "91cccd472455ecea"
+    },
+    {
+      "symbol": "AgentToolResult",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具执行结果（终值——错误也走 isError 数据面不走异常面）",
+      "kind": "interface",
+      "sig": "7603c6264bb7cc8a"
+    },
+    {
+      "symbol": "ApiBlock",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "清单 api 块形状",
+      "kind": "interface",
+      "sig": "9908c12f10a2b293"
+    },
+    {
+      "symbol": "ApiTier",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "API 稳定性 tier 词汇",
+      "kind": "type",
+      "sig": "eae60cd3d5ce7dce"
+    },
+    {
+      "symbol": "ApprovalAskAnswer",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "审批 ask 应答闭集（07 §4.3 提问队列条款——审批入队契约）：approve/reject/ cancel/always/unavailable",
+      "kind": "type",
+      "sig": "2f4e86e5b19c183f"
+    },
+    {
+      "symbol": "ApprovalAskRequest",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "审批 ask 呈现载荷（07 §4.3——通道侧形）：channels 与 safety 边表互无边（02 §4.1），safety 侧 ApprovalRequest 经装配根映射注入本形；`suggestedEntry` = 「始终允许」草案条目（04 §9 ③ 策略表 allow 条目回写目标；无草案 = always 选项语义上不呈现、防御收口视同 approve）",
+      "kind": "interface",
+      "sig": "e894ee1d2ec6808b"
+    },
+    {
+      "symbol": "AssistantMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "助手消息（流式组装终值；stopReason=error/aborted 时错误即数据，见 AssistantStream）",
+      "kind": "interface",
+      "sig": "d13b04c0d40f7c7b"
+    },
+    {
+      "symbol": "AssistantStream",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "流式响应：异步迭代事件 + 最终消息取值口",
+      "kind": "interface",
+      "sig": "df158ffbf377e6e6"
+    },
+    {
+      "symbol": "AssistantStreamEvent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "流式事件（pi-ai AssistantMessageEvent 同构 12 型）",
+      "kind": "type",
+      "sig": "d168e4b908f91e2a"
+    },
+    {
+      "symbol": "BaseError",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "全仓单一错误基类",
+      "kind": "class",
+      "sig": "f4be1eb8a66b83c4"
+    },
+    {
+      "symbol": "CORE_EVENT_TYPE_NAMES",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "核心词类型名清单（核心词保护判据——registerEventType 拒收）",
+      "kind": "const",
+      "sig": "5fa92f9db6979ac1"
+    },
+    {
+      "symbol": "CREDENTIALS_ENV_REF_PREFIX",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "引用形 sigil 前缀（含冒号——`@credentials:`；名 = 前缀后的非空余段）",
+      "kind": "const",
+      "sig": "ab1169de837d8d9b"
+    },
+    {
+      "symbol": "CredentialEnvRef",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "引用形解析结果（三态：非引用形 / 引用形携名 / 前缀命中而坏形）",
+      "kind": "type",
+      "sig": "14f5e2963d9cb7ed"
+    },
+    {
+      "symbol": "CustomMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "自定义角色消息（content 载荷形状由角色定义自裁——toLlm 映射的输入）",
+      "kind": "interface",
+      "sig": "06dea5b0a8b35e29"
+    },
+    {
+      "symbol": "DeliverChannel",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "三通道词表：steer = busy 注入合批 / followUp = idle 起跑 / inject = dismantled 停摆后注入",
+      "kind": "type",
+      "sig": "7c3e59e7b20a120a"
+    },
+    {
+      "symbol": "ERROR_CODE_PREFIXES",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "错误码前缀族明列——文档性常量，供注册面校验与 CI 目录生成； 'HOST_' 系装配根码族",
+      "kind": "const",
+      "sig": "3124d4cfc86e4039"
+    },
+    {
+      "symbol": "EVENT_CATEGORIES",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "事件类别四分法闭集（类别列口径与 05 §3.1 投影执法对齐）",
+      "kind": "const",
+      "sig": "97f9d7c412f51c23"
+    },
+    {
+      "symbol": "ErrorBucket",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "错误四桶（04 §3.5 表）",
+      "kind": "type",
+      "sig": "218fe1e49eed3f5b"
+    },
+    {
+      "symbol": "ErrorCodeInfo",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "错误码目录条目（可枚举目录 = 注册表值形态）",
+      "kind": "interface",
+      "sig": "7d4ca3f2847a79c9"
+    },
+    {
+      "symbol": "EventCategory",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "kind": "type",
+      "sig": "aba693736dd87995"
+    },
+    {
+      "symbol": "EventSource",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "user/message 的 source 归因词汇闭集（05 §3.1 表全列）：六字面量 ∪ 三前缀模板串",
+      "kind": "type",
+      "sig": "4b762ab725c557f8"
+    },
+    {
+      "symbol": "EventSourceKind",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "source 归一化种类（前缀型归并到 kind；字面量一一对应）",
+      "kind": "type",
+      "sig": "8cfb9fde8b34bf8d"
+    },
+    {
+      "symbol": "EventTypeMeta",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "事件类型目录条目（注册表值形态）",
+      "kind": "interface",
+      "sig": "25a4746162e827d9"
+    },
+    {
+      "symbol": "ExecuteInput",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "执行段 waterfall 载荷（around-dispatch：T = 执行闭包，监听者包装后经 next 传播）",
+      "kind": "type",
+      "sig": "88e0e02b4f8d31ab"
+    },
+    {
+      "symbol": "GateAction",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "守门段决策词汇（03 §2.4——拦截族 handler 控制输出同一套）",
+      "kind": "type",
+      "sig": "5c63915b3c56e64e"
+    },
+    {
+      "symbol": "GateDecisionRecord",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "gate/decision durable 落账记录（05 §1.1 词汇表 gate/decision 行的 data 形状）",
+      "kind": "interface",
+      "sig": "7710fcdd9c92bd13"
+    },
+    {
+      "symbol": "GateDecisionSink",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "gate/decision 落账 sink（装配根接 session.append；tools 不依赖 session——DAG 单向）",
+      "kind": "type",
+      "sig": "161b0853f89f1bd4"
+    },
+    {
+      "symbol": "GateInput",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "守门段 waterfall 载荷（04 §7 段 2）",
+      "kind": "interface",
+      "sig": "d96227e8fdbcc3c9"
+    },
+    {
+      "symbol": "HostFace",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "宿主自省面——插件问宿主，而非探测猜",
+      "kind": "interface",
+      "sig": "aea7ba3946df29ee"
+    },
+    {
+      "symbol": "HostFaceInput",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "HostFace 的纯数据输入（装配根物化用）：capabilities/experimentalKeys 清单派生源 = surface.json capabilities[] 与键表 tier=experimental 子集",
+      "kind": "interface",
+      "sig": "b8ca034cce360edd"
+    },
+    {
+      "symbol": "ImageContent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "图片块（多模态附件；base64 数据）",
+      "kind": "interface",
+      "sig": "7a11d114bfc3b8bd"
+    },
+    {
+      "symbol": "JobEntry",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "Job 注册表条目（进程内状态——04 §10 终态不镜像落库明文豁免）",
+      "kind": "interface",
+      "sig": "f1b29b0a115091e6"
+    },
+    {
+      "symbol": "JobKind",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "Job 种类闭集（04 §10——kind 现设四值；registerKind 显式登记后方可使用）",
+      "kind": "type",
+      "sig": "70e3a22f6a466552"
+    },
+    {
+      "symbol": "JobSettledEvent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "job_settled 活体事件载荷（04 §10——总线词，内存直推不落库）",
+      "kind": "interface",
+      "sig": "bfcf18fa39640d72"
+    },
+    {
+      "symbol": "JobStatus",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "Job 状态机（04 §10：running →（可选 stopping）→ 唯一终态；first-wins）",
+      "kind": "type",
+      "sig": "10b3211f13ac4450"
+    },
+    {
+      "symbol": "JobTerminal",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "Job 终态载荷（settle 时落——first-wins 封口后的不可变值）",
+      "kind": "interface",
+      "sig": "8b37d3953546febf"
+    },
+    {
+      "symbol": "LlmContext",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "单次 LLM 请求上下文（StreamFn 第一参数；04 §3.1）",
+      "kind": "interface",
+      "sig": "ee023bbf51ec4750"
+    },
+    {
+      "symbol": "LlmTool",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "LLM 工具描述（parameters 为 JSON Schema——typebox 产物即此形状）",
+      "kind": "interface",
+      "sig": "c26c21fc2c90ac69"
+    },
+    {
+      "symbol": "Message",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "LLM 边界标准三角色（convertToLlm 透传的标准半边）",
+      "kind": "type",
+      "sig": "b8b13927589a2c17"
+    },
+    {
+      "symbol": "MessageRoleDefinition",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "角色定义：toLlm 映射（进模型上下文的降写）+ render 呈现（用户可见面）",
+      "kind": "interface",
+      "sig": "aad86c9e7450aaef"
+    },
+    {
+      "symbol": "MessageRoleRender",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "呈现意图（render 映射的输出半边；hidden = 瞬态注入不进用户可见流）",
+      "kind": "interface",
+      "sig": "cb1837728fc1b34f"
+    },
+    {
+      "symbol": "ModelInfo",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "模型目录只读投影（listModels()/getModel() 返回形）：pi-ai Model 的应用友好子集——枚举/展示/能力判别所需字段直通，传输与 provider 配置面（baseUrl/ headers/samplingParams/compat）不披露",
+      "kind": "interface",
+      "sig": "e1f6c5401361d632"
+    },
+    {
+      "symbol": "NotifyLevel",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "notify 通知档（07 §4.3 签名定稿；'success' = 任务完成语义档）",
+      "kind": "type",
+      "sig": "44c03899f663f946"
+    },
+    {
+      "symbol": "ParsedEventSource",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "parseEventSource 结果：归一化种类 + 原值 + 投影位判别",
+      "kind": "interface",
+      "sig": "b28cda611bb20b4e"
+    },
+    {
+      "symbol": "PostExecuteInput",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "后处理段 waterfall 载荷（可就地改写 result——裁剪/spill/isError 改写）",
+      "kind": "interface",
+      "sig": "52f7bc117a9828b8"
+    },
+    {
+      "symbol": "ProgrammaticSubagentDef",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "程序化 named provider 注册 def（03 §2.2 第十二动词 ctx.agent.registerSubagentProvider 单参——04 §10 程序化注册槽段机制真源）",
+      "kind": "interface",
+      "sig": "026e057ad79a62a1"
+    },
+    {
+      "symbol": "RetryProbe",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "重试进行态只读小面（04 §3.3 注记 seam——批 13a 落码位）：conversation 驱动重试循环的只读探针，SDK 线协议心跳载荷是该 seam 的**唯一线面出口** （03 §10.6 线协议②：`retry <attempt>/<next>` 不可从事件流推导——活体层「重试续入零新事件型」维持不破；非事件型、不进 durable）",
+      "kind": "interface",
+      "sig": "7830b4efa0d9724a"
+    },
+    {
+      "symbol": "RunStatus",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "run 终态恰三值",
+      "kind": "type",
+      "sig": "1143b08931044782"
+    },
+    {
+      "symbol": "STANDARD_MESSAGE_ROLES",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "标准角色名闭集（convertToLlm 透传的标准半边；自定义角色撞此集任何一名即拒）",
+      "kind": "const",
+      "sig": "734176dabc67a1c8"
+    },
+    {
+      "symbol": "SUBAGENT_DEPTH_MAX",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "委派深度帽（04 §10 委派边界③）：根会话委派 = 深度 1；子代理再委派逐层 +1；超帽 3 拒（SUBAGENT_DEPTH_EXCEEDED——防自嵌套爆栈）",
+      "kind": "const",
+      "sig": "a5691a655c07cc26"
+    },
+    {
+      "symbol": "SessionEnvelope",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "多会话信封（07 §4.1 channels 纵切批定形三则②）：AgentEvent 不带会话归属是刻意的——loop 是单 run 视角无多会话概念；归属信封的包装位 = host 装配的 per-run sink 包装器（conversation 侧 sink 签名零 channels 感知、纯 AgentEvent 回调注册面，host 汇入 channels 分发器时附加信封——装配根是唯一允许 import 全部宿主模块的横切层，2026-09-06 冷读裁决 C-1），channels 消费分流",
+      "kind": "interface",
+      "sig": "d2bddb7a08fb0c43"
+    },
+    {
+      "symbol": "SessionEvent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "会话事件信封：日志唯一条目形态（append-only，写入即冻结）",
+      "kind": "interface",
+      "sig": "2eb92c60b818ae07"
+    },
+    {
+      "symbol": "SessionLineage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "血缘三元组（fork 动作的分层返回外层，05 §5.2；不返回幻影 id）",
+      "kind": "interface",
+      "sig": "e7c0cd6e20659aaa"
+    },
+    {
+      "symbol": "SessionOrigin",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "会话血缘 origin 闭集（05 §5.1）：'conversation'（普通对话）/ 'delegation' （委派子会话）/ 'import'（外部导入）/ 'fork'（显式 fork）/ 'trigger'（触发器 starter 起的无头会话——首 turn 非人触，2026-09-07 触发器面 C 批落码扩词； 05 §9 sessions.origin 与 03 §2.4 session_start 载荷三处闭集同笔）",
+      "kind": "type",
+      "sig": "234964b610aaf051"
+    },
+    {
+      "symbol": "StopReason",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "LLM 调用终态（pi-ai 同构七值）",
+      "kind": "type",
+      "sig": "e198e323e6a12900"
+    },
+    {
+      "symbol": "StreamFn",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "模型层注入签名（llm 模块整体替换位——agent 与 llm 两模块的唯一会合点，故落在 contracts）",
+      "kind": "type",
+      "sig": "9324dbd30ac1667d"
+    },
+    {
+      "symbol": "StreamFnOptions",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "StreamFn 每次调用的选项（model 为模型 id 字符串——解析归 llm 模块，loop 不持模型对象）",
+      "kind": "interface",
+      "sig": "1a4290af791ae0d7"
+    },
+    {
+      "symbol": "SubagentCapabilities",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "SubagentProvider 能力协商面（04 §10——五布尔）：注册方声明，消费方（委派机器/呈现面）据以决定可用形态（如 background=false 的 provider 不受理后台收场）",
+      "kind": "interface",
+      "sig": "c615a984583d9a8d"
+    },
+    {
+      "symbol": "SubagentDef",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "声明式子代理解析产物（06 §11.6 agents/*.md 纯数据 def）",
+      "kind": "interface",
+      "sig": "39d4cd0c4c3cd5a7"
+    },
+    {
+      "symbol": "SubagentProvider",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "SubagentProvider 契约（04 §10——subagent 件提供，core:）：能力协商 + 单一委派动词",
+      "kind": "interface",
+      "sig": "409292bc3b8e5940"
+    },
+    {
+      "symbol": "SubagentRequest",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "委派请求（04 §10：请求含 prompt、工具白名单、模型覆盖——其余为机器注入位，模型侧工具 schema 不暴露）",
+      "kind": "interface",
+      "sig": "12f0cd32cdd5a338"
+    },
+    {
+      "symbol": "SubagentResult",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "委派结算（04 §10：子代理是黑盒——结果不重试，立即结算给父）",
+      "kind": "interface",
+      "sig": "697c569c80d49c40"
+    },
+    {
+      "symbol": "SubagentStopReason",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "子代理收场原因闭集（StopReason 子集——委派语境三值；'killed' 承 Job 终态词）",
+      "kind": "type",
+      "sig": "eab7cefb3aa6ae97"
+    },
+    {
+      "symbol": "SurfaceOp",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "表面遮蔽指令（改历史的唯一合法形态——追加 replace 指令事件遮蔽旧区间，原文保留可审计）",
+      "kind": "interface",
+      "sig": "fc681ead08fc910d"
+    },
+    {
+      "symbol": "TOOLS_CHANGE_EVENT",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "kind": "const",
+      "sig": "02c841113fa48cc5"
+    },
+    {
+      "symbol": "TOOL_EVENT_NAMES",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "tools 件经 ctx 事件面消费的词汇全集（装配根注册清单单源）",
+      "kind": "const",
+      "sig": "07a204e8d1a235a3"
+    },
+    {
+      "symbol": "TOOL_EXECUTE_EVENT",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "kind": "const",
+      "sig": "34a35c3a08e3d246"
+    },
+    {
+      "symbol": "TOOL_POST_EXECUTE_EVENT",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "kind": "const",
+      "sig": "ab9a73ce37834fa5"
+    },
+    {
+      "symbol": "TOOL_PRE_EXECUTE_EVENT",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "kind": "const",
+      "sig": "10a7f9d4dba3297e"
+    },
+    {
+      "symbol": "TOOL_TIER_RANK",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具档偏序 rank（04 §9 定形块①：read < write < exec）",
+      "kind": "const",
+      "sig": "b9da2b2887f71001"
+    },
+    {
+      "symbol": "TextContent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "文本块（user/assistant/toolResult 通用）",
+      "kind": "interface",
+      "sig": "dbf3e677b4573564"
+    },
+    {
+      "symbol": "ThinkingContent",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "思考块（仅 assistant；供应商推理内容回放）",
+      "kind": "interface",
+      "sig": "0f2ec9a6666cc2cf"
+    },
+    {
+      "symbol": "ThinkingLevel",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "思考档位（pi-ai 同构七值；xhigh/max 仅部分模型家族支持——会话态非 run 态，04 §5）",
+      "kind": "type",
+      "sig": "f38b086347a97505"
+    },
+    {
+      "symbol": "ToolCallBlock",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具调用块（仅 assistant 内联；arguments 已是解析后的对象）",
+      "kind": "interface",
+      "sig": "1889ece095f0a5cf"
+    },
+    {
+      "symbol": "ToolContext",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具执行语境（管道构造后传给 ToolDefinition.execute 的第 2 参）",
+      "kind": "interface",
+      "sig": "d8b47296f2607e66"
+    },
+    {
+      "symbol": "ToolDefinition",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "注册表内工具定义（03 §2.3 defineTool 形——插件注册动词 ctx.tools.register 的入参形状）",
+      "kind": "interface",
+      "sig": "8346342f4e61a8a7"
+    },
+    {
+      "symbol": "ToolEffect",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具效果面（03 §2.3 一位两用）——**工具档三值**（04 §9 定形块①，2026-09-11 审批分档批）：`read` = 只读（批内并行调度、不走审批对）；`write` = 写面（批边界串行屏障 + 审批对触发）；`exec` = 任意进程执行类（v1 升档清单恰一处 = bash——exec/bash.ts；write/exec 同触发审批对、同走批边界串行）",
+      "kind": "type",
+      "sig": "a1f0c02a6ea977f7"
+    },
+    {
+      "symbol": "ToolPipelineExecutor",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "三段管道执行器（注册表 toAgentTool 的执行真身；抛 BaseError 由 loop 包装 isError）",
+      "kind": "type",
+      "sig": "17426ce31cb7fb6c"
+    },
+    {
+      "symbol": "ToolResultMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具结果消息（与 assistant 内 toolCall 按 toolCallId 配对）",
+      "kind": "interface",
+      "sig": "3b2525c357f955e9"
+    },
+    {
+      "symbol": "ToolUpdateCallback",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具执行进度回调（tool_execution_update 事件的载荷源；promise 结算后的迟到进度被丢弃）",
+      "kind": "type",
+      "sig": "1740ef09091e6da2"
+    },
+    {
+      "symbol": "TurnEndReason",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "turn/end 的 reason 闭集（05 §1.1 表：completed / aborted / blocked / error / max-tokens / interrupted，可扩展）",
+      "kind": "type",
+      "sig": "7806806ab5b8cd06"
+    },
+    {
+      "symbol": "UiAskOptions",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "阻塞原语公共选项（07 §4.3 撤销面：abort 按取消收场取保守值）",
+      "kind": "interface",
+      "sig": "aa90463450f5562c"
+    },
+    {
+      "symbol": "UiBackend",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "通道后端接口（通道核的呈现消费面）",
+      "kind": "interface",
+      "sig": "e78468f04fa989fc"
+    },
+    {
+      "symbol": "UiCapabilities",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "通道能力声明（07 §4.3 通道降级规则的判定面）：不支持的原语按「notify 化」降级（select→input→notify、setWidget→notify）——插件不感知通道能力差异，降级判定与编舞在核",
+      "kind": "interface",
+      "sig": "5d6db677578502ba"
+    },
+    {
+      "symbol": "UiInputOptions",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "input 原语选项",
+      "kind": "interface",
+      "sig": "6a236cb87ddeac7b"
+    },
+    {
+      "symbol": "UiSelectChoice",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "select 单选项（07 §4.3 签名定稿形）",
+      "kind": "interface",
+      "sig": "b0b22829e52dcdd2"
+    },
+    {
+      "symbol": "Usage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "一次 LLM 调用的 token 用量（pi-ai 同构）：cacheRead/cacheWrite 独立拆桶， cacheWrite1h（仅 Anthropic 上报拆分）与 reasoning（已含于 output，供应商不报则缺省）为可选子集",
+      "kind": "interface",
+      "sig": "67231de2db7ee993"
+    },
+    {
+      "symbol": "UsageBuckets",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "计量四桶形：input/output/ cacheRead/cacheWrite 四桶必落（供应商恒报），cacheWrite1h/reasoning 上报才落； totalTokens（派生）与 cost（折算）**不入账**——token 原始值入账、货币折算在投影查询做（价格表更新不回改历史）",
+      "kind": "interface",
+      "sig": "fd4f8ec355c72f7a"
+    },
+    {
+      "symbol": "UserMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "用户消息（content 允许纯文本或图文块数组）",
+      "kind": "interface",
+      "sig": "7a913ca8b7c56d48"
+    },
+    {
+      "symbol": "compareApiVersions",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "apiVersion 比较：MAJOR.MINOR 逐段数值比较——禁字符串比较（\"1.10\" > \"1.9\"）",
+      "kind": "function",
+      "sig": "57a9ec6695ced147"
+    },
+    {
+      "symbol": "getErrorCodeInfo",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "错误码目录条目查询（未注册返回 undefined）",
+      "kind": "function",
+      "sig": "afa96860b326b4dd"
+    },
+    {
+      "symbol": "getEventTypeMeta",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "事件类型目录条目查询（未注册返回 undefined；类别/归属消费面用）",
+      "kind": "function",
+      "sig": "5f44704420997a76"
+    },
+    {
+      "symbol": "getMessageRoleDefinition",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "查询角色定义（标准角色与未注册角色返回 undefined）",
+      "kind": "function",
+      "sig": "c1e61b6b589b7a21"
+    },
+    {
+      "symbol": "isKnownErrorCode",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "判别错误码是否已注册（catch 面 code 分派前的目录查询）",
+      "kind": "function",
+      "sig": "19b15f61e3332e94"
+    },
+    {
+      "symbol": "isKnownEventType",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "判别事件类型是否已注册（session append 词汇检查的判据源）",
+      "kind": "function",
+      "sig": "451f9b8d58b10ea7"
+    },
+    {
+      "symbol": "isStandardMessage",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "标准消息窄化守卫（正向判窄化——自定义消息判别用 !isStandardMessage）",
+      "kind": "function",
+      "sig": "cd998bd878463796"
+    },
+    {
+      "symbol": "isValidApiVersion",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "断言 apiVersion 格式合法（清单校验面用——错误归 PLUGIN_INVALID 语境由调用方包，本函数只做纯格式判定的复用体）",
+      "kind": "function",
+      "sig": "1e5d019d447f8711"
+    },
+    {
+      "symbol": "listErrorCodes",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "全量目录枚举（生成目录 / CI 校验用）",
+      "kind": "function",
+      "sig": "96d19b61a903825c"
+    },
+    {
+      "symbol": "listEventTypes",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "全量目录枚举（生成目录 / CI 校验用）",
+      "kind": "function",
+      "sig": "d38e2103b2d09b37"
+    },
+    {
+      "symbol": "listMessageRoleNames",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "在册自定义角色名枚举（诊断/目录面）",
+      "kind": "function",
+      "sig": "384ed3de7b398207"
+    },
+    {
+      "symbol": "parseCredentialEnvRef",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "解析 env 值是否为凭证引用形",
+      "kind": "function",
+      "sig": "1449baeea9679cc6"
+    },
+    {
+      "symbol": "parseEventSource",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "解析 source 归因字符串（闭集执法的读侧判据，05 §3.1）： - 已知前缀的未知后缀（如 'plugin:未来插件'）按前缀行语义展开； - 未知字面量（旧日志向前兼容）按 user 同视； - append 侧新值必须先扩闭集（类型 + 本函数）——写入纪律归 session 落码批",
+      "kind": "function",
+      "sig": "5a4f58922cd93033"
+    },
+    {
+      "symbol": "redactKnownSecretValues",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "值基腿：已知秘密活值整段置换（split/join 字面替换——值含正则元字符安全）",
+      "kind": "function",
+      "sig": "a26333e4b3dc8d73"
+    },
+    {
+      "symbol": "redactSensitiveText",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "模式腿：出口文本消毒（04 §7 出口治理③模式集三段——纯函数、幂等、恒在场）",
+      "kind": "function",
+      "sig": "32fece1948948df2"
+    },
+    {
+      "symbol": "redactToolResultExit",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具结果出口消毒（管道链尾调用——04 §7 定形①：护栏之前一步）",
+      "kind": "function",
+      "sig": "000236cf5f259e23"
+    },
+    {
+      "symbol": "registerErrorCodes",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "注册错误码（宿主件落码批与插件装载面的统一入口）",
+      "kind": "function",
+      "sig": "c1e097430aba2857"
+    },
+    {
+      "symbol": "registerEventType",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "注册事件类型（插件扩展唯一入口；宿主件自管类型已列核心表）",
+      "kind": "function",
+      "sig": "67494a9eacf7b606"
+    },
+    {
+      "symbol": "registerMessageRole",
+      "module": "berry-agent",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "注册自定义消息角色（ctx.agent.registerMessageRole 的本体——单入口）",
+      "kind": "function",
+      "sig": "3fbb7c68b0fe8765"
+    },
+    {
+      "symbol": "anthropicMessagesApi",
+      "module": "berry-agent/llm",
+      "tier": "stable",
+      "since": "1.0",
+      "sig": "60b7613c7ea6b9f5"
+    },
+    {
+      "symbol": "createProvider",
+      "module": "berry-agent/llm",
+      "tier": "stable",
+      "since": "1.0",
+      "sig": "5cadc02791ab4d6c"
+    },
+    {
+      "symbol": "hasApi",
+      "module": "berry-agent/llm",
+      "tier": "stable",
+      "since": "1.0",
+      "sig": "8e121625fd0160ed"
+    },
+    {
+      "symbol": "lazyApi",
+      "module": "berry-agent/llm",
+      "tier": "stable",
+      "since": "1.0",
+      "sig": "9d3b33568822fbc4"
+    },
+    {
+      "symbol": "openAICompletionsApi",
+      "module": "berry-agent/llm",
+      "tier": "stable",
+      "since": "1.0",
+      "sig": "87e52b877fd9c602"
+    },
+    {
+      "symbol": "CommandAccount",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "命令注册账（注入式真注册表——register/disposer 出入账计数，跨换代共享一账）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "DispatchListenerProbe",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "事件分派监听器净计数探针（实例方法包壳观察——真派发行为不 mock，只记账）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "HarnessInstallOutcome",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "装机结果（installPlugin 直传——ok = 落账条目）",
+      "kind": "type"
+    },
+    {
+      "symbol": "LifecycleMatrixReport",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "矩阵总报告（ok = 无 fail 行；skipped 不折损——环境位如实呈现）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "MatrixOptions",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "矩阵选项（harness 选项 + 作者声明面 + pack 预检开关）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "MatrixRowResult",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "单行结果（pass/fail/skipped——skipped = 环境不适用非放行）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "MemoryAuditSink",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "内存审计汇（AuditFace 真形实现——append/lastOf/listRecent 三法 + 断言器扩展读面）",
+      "kind": "class"
+    },
+    {
+      "symbol": "PluginHarness",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "假宿主装配件（矩阵断言器的运转底座——全部动词真身直调）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "PluginHarnessOptions",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "构造选项（作者测试文件一行起跑）",
+      "kind": "interface"
+    },
+    {
+      "symbol": "createCommandAccount",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "命令注册账铸造（disposer 出账——换代 dispose 后单注可证）",
+      "kind": "function"
+    },
+    {
+      "symbol": "createPluginHarness",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "装配假宿主（构造即读清单定 id——坏清单构造即红，坏样本由矩阵层收面）",
+      "kind": "function"
+    },
+    {
+      "symbol": "formatMatrixReceipt",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "可贴 README 的 markdown 回执（「产出可贴 README 的证明」——03 §9.5 定位段）",
+      "kind": "function"
+    },
+    {
+      "symbol": "instrumentDispatchListeners",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "分派器监听器探针铸造（on 注册 +1、退订 −1；onWaterfall 腿 v1 未观察——注释明示）",
+      "kind": "function"
+    },
+    {
+      "symbol": "npmPackFiles",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "npm pack 文件清单探测（--dry-run 零 tarball 落盘；60s 帽防挂）",
+      "kind": "function"
+    },
+    {
+      "symbol": "proveLifecycleMatrix",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "生命周期证明矩阵主入口——一站式可召唤（作者测试一行起跑）： ```ts const report = await proveLifecycleMatrix({ pluginDir: __dirname }); expect(report.ok).toBe(true); ``` 收场自动回卷在飞代 + 清理自建临时目录（报告先行返回——dispose 失败不折损证明）",
+      "kind": "function"
+    },
+    {
+      "symbol": "realStoreFs",
+      "module": "berry-agent/testkit",
+      "tier": "experimental",
+      "since": "1.0",
+      "desc": "假宿主真盘数据面（PluginStoreFs 真身适配——node:fs 直连，无内存仿真）",
+      "kind": "function"
+    },
+    {
+      "symbol": "agents",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "声明式子代理目录清单（06 §11.6 位 4；与 skills 同形——mount 即收集、物化消费腿挂 core:subagent 消费批）"
+    },
+    {
+      "symbol": "api",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "API 治理块（minApiVersion/targetApiVersion/experimental）"
+    },
+    {
+      "symbol": "config",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "宿主侧默认配置值（启用行 config 缺席时作 apply 的 config 实参；形状声明归 configSchema——2026-09-11 交互动词族批 schema/值分键）"
+    },
+    {
+      "symbol": "configSchema",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "配置字段声明面（字段描述数组——字段级校验与 /plugins config 表单渲染双消费源）"
+    },
+    {
+      "symbol": "entry",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "入口文件（相对包根）；缺席走入口解析序三步"
+    },
+    {
+      "symbol": "grants",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "授权申请面；单维 writableRoots 字符串数组"
+    },
+    {
+      "symbol": "id",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "插件 id；缺省取 package.json name，不合字符集须显式声明（无隐式映射变换）"
+    },
+    {
+      "symbol": "label",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "展示名；缺省取 id"
+    },
+    {
+      "symbol": "skills",
+      "module": "manifest-keys",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "技能目录清单；非空即在场的「声明载荷」之一（纯声明包零码装载）"
+    },
+    {
+      "symbol": "compaction",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "压缩策略面（ctx.get(\"compaction\") 消费——setConfig 数值槽/registerSummarizer 摘要 provider 槽两动词装载窗 only 严于通律、单席位先到占；provider 只作用阈值路，溢出兜底恒宿主缺省算法）",
+      "sig": "e0485d01d7f92816"
+    },
+    {
+      "symbol": "compaction.registerSummarizer",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "摘要 provider 槽（常设算法位——签名 05 §2.1 SummarizerFn；只作用阈值路，溢出兜底恒宿主缺省算法）",
+      "sig": "68a4d02f81b932c5"
+    },
+    {
+      "symbol": "compaction.setConfig",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "数值配置槽（Partial<CompactionConfig> 合并——字段射程 = 全七字段，两路同生效：数值是宿主机制参数非策略算法）",
+      "sig": "eaed545e9db39e4a"
+    },
+    {
+      "symbol": "sdk-routes",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "路由受理面（ctx.get(\"sdk-routes\") 消费——register 受理制注册 sdk HTTP 面插件道路由：前缀 /plugins/<id>/ 恒受理面施加 + 收窄四件〔鉴权子集/loopbackOnly 恒 true/体帽 1MiB 缺席即帽值/数帽 16〕+ 门检 sdk.register-route 前置 + 装载窗 only；裁决纯函数 sdk/plugin-routes.ts）",
+      "sig": "4250a3173111eeb0"
+    },
+    {
+      "symbol": "sdk-routes.register",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "受理制注册（返摘除 fn——/reload 换代门复检的回收腿；数帽分帐随摘除递减）",
+      "sig": "e660058e2f2a6e62"
+    },
+    {
+      "symbol": "secrets",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "插件凭证受理制读写面（ctx.get(\"secrets\") 消费——get 缺省自域、越域读走高危面开门 credentials.read-cross；set 恒自域且只在宿主回调窗内可达）",
+      "sig": "29cc2437a806c7ba"
+    },
+    {
+      "symbol": "secrets.get",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "凭证读（返回明文值）",
+      "sig": "2b8d84decf8708a4"
+    },
+    {
+      "symbol": "secrets.registerOAuthFlow",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "注册 oauth 流（c-6——装载窗内合法，窗外拒 PLUGIN_WINDOW_CLOSED）",
+      "sig": "1a5030573333c3f5"
+    },
+    {
+      "symbol": "secrets.set",
+      "module": "services",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "凭证写（恒自域——无跨域写面）",
+      "sig": "a145f2df1e101ef9"
+    },
+    {
+      "symbol": "approval/asked",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "审批提问（决策对完整内容；turn 内闭合可回放）"
+    },
+    {
+      "symbol": "approval/decided",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "审批决策（决策对完整内容；turn 内闭合可回放）"
+    },
+    {
+      "symbol": "assistant/message",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "组装完成后的消息级事件；toolCall 块不内联 content（由 tool/call 唯一承载）；errorMessage 腿独立 2KiB 小帽"
+    },
+    {
+      "symbol": "capability/used",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "高危面开门后的每次换装/注册使用事实（宿主门检接线位在门检通过、注册动词受理成功后落；载体 = 进程级 durable 审计流 audit_events〔05 §9〕；v1 射程 = channels.ui-backend + triggers.start-run 逐次 fire（triggerName 归因腿）+ credentials.read-cross 逐次越域读（core: 直开豁免照记——豁免免的是门不是账，c-3），sdk.register-route 随 U5）"
+    },
+    {
+      "symbol": "compaction/end",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "压缩收尾标记（reason=completed/failed/vetoed/aborted；failed=摘要通道失败即时闭段防孤 start 悬挂；vetoed=钩子否决收形〔U4——start 后即 end 无摘要无遮蔽〕；aborted=§4 恢复协议合成形非 live 写入位）"
+    },
+    {
+      "symbol": "compaction/fallback",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "接管/算法槽失败回落事实（05 §2.1 回落三律第 3 律——回落非静默换算法；source=plugin:<id>、stage=throw|timeout|rejected〔抛错/超预算/产物被拒——空文本同宿主通道失败律〕、error? 截断、circuit?=true 末次记三振停用〔进程级，复位走重启〕；U4 调整途非法调整同 stage=rejected 记账）"
+    },
+    {
+      "symbol": "compaction/skip",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "压缩判据观测五门 skip（obs-b 2026-09-13——05 §1.1 行 82 + §2.1 判序定形注：fire 而被门挡才落，below 恒不落）：gate=pending〔防重入挡〕|cooldown〔冷却窗挡，+remainMs 窗余〕|no-segment〔fire 但区间规划无合法段〕|retracted〔排队锁内复评已不 fire——幻影触发可查〕|no-channel〔摘要通道缺席——首触落一条后静默，与 warn-once 同锚〕；basis 五件同 compaction/start（fire 判据快照——触发时刻判据素材，非门检时刻）；五门均不动冷却锚（skip 非 completed）；写入者 = 宿主 compaction 件 handleRunSettled"
+    },
+    {
+      "symbol": "compaction/start",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "压缩意图与判据快照（reason=threshold/overflow + willRetry + basis?；05 §2.1 五步之一）"
+    },
+    {
+      "symbol": "compaction/surface",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "遮蔽指令事件（信封 surfaceOp 载体本尊；data=summarySeq/规模审计；经 appendWithSurfaceOp 正门）"
+    },
+    {
+      "symbol": "credentials/changed",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "凭证治理记账（凭证代管批 c-1 立词 2026-09-08——05 §1.1 词条单源；ix-4 补注册：规范立词而核心词表漏行的 c 批真遗漏，audit 词汇闸 fail-loud 抓出）：载荷 {namespace, name, action: add|remove|rotate, origin: human|oauth-flow}（值恒不入载荷——模型可见性铁律 03 §10.9）；写点 = 宿主受理位（人面 /credentials add/rm + oauth 流写/轮换 + /plugins config 表单 secret 入盒——装配根单写者律）；载体 = audit_events"
+    },
+    {
+      "symbol": "doors/updated",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "进程级开门位授予面切换事实（开门制扩展批 2026-09-09——doors 段〔模型道高危面授予载体，03 §4.6 双源并集律第二源〕的审计腿，与 plugin/opens 分立成对：行 opens 授予跟插件 id 走、doors 段授予跟进程走）：boot 装载序以 doors 段现值与审计流尾最近一条本词 diff——有变才落幂等记账（空面首记不落），撤位落 doors:[] 空数组形收口；载荷 {doors 全量清单快照, origin（boot-diff|tui-cmd）}；载体 = audit_events"
+    },
+    {
+      "symbol": "gate/decision",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "守门段决策（toolCallId/decision(allow|block|mutate)/reason）——「守门不可绕」不变式的断言对象"
+    },
+    {
+      "symbol": "hook/registered",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "钩子监听者受理账（T9 案一批 2026-09-09——context_transform 瀑布等钩子注册全隐身的 durable 归因：「谁在改我的上下文」有账）：载荷 {pluginId, hook}（无 rank——03 §2.4 ctx.on 两参签名恒定、注册序由受理时序承载）；写点 = ctx.on 受理壳成功尾逐笔（waterfall/notify 两腿返回位；含 §2.1 回调窗延伸内的受理；拒路径零审计〔PLUGIN_HOOK_UNKNOWN/PLUGIN_WINDOW_CLOSED——被拒的注册不是行为〕）；/reload 换代新受理新账（受理制非 boot diff——钩子注册无 fold 语义系行为流，每代如实记）；载体 = audit_events"
+    },
+    {
+      "symbol": "kv/written",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "键值写历史（T9 案一批 2026-09-09——store_state LRU+ttl 只有终态、写无历史的 durable 归因）：载荷 {pluginId, key 裸键名, action: set|delete}（值与 ttl/kind 元数据恒不入载荷——credentials/changed 同律；读腿零落账；persist 层 LRU/ttl 治理写零落账〔治理/受理分层〕）；写点 = ctx.sessions store_state 受理面 set/delete 成功尾逐笔——**规范已裁、代码未落**（词先锚定，发射位随受理制写面落码批兑现，compaction/fallback 同律）；载体 = audit_events"
+    },
+    {
+      "symbol": "llm/retry",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "turn 级 auto-retry 的 durable 事实（attempt/phase scheduled|aborted|exhausted；成功不落）"
+    },
+    {
+      "symbol": "llm/usage",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "complete 单发补全通道的计量事实（token 原始值入账，货币折算在投影查询做）"
+    },
+    {
+      "symbol": "plugin/installed",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "生命周期归因面——装机成功事实（id/source/version；写点 = CLI 人面 install 成功尾；载体 = 进程级 durable 审计流 audit_events〔05 §9〕非会话流，05 §1.1 生命周期归因面行）"
+    },
+    {
+      "symbol": "plugin/mounted",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "生命周期归因面——挂载事实（id；写点两路 = CLI 人面 mount 成功尾 + boot 装载序手编 enabled.yaml 漂移 diff 补播；载体 = audit_events；core: 内置基线态不造首记噪声——diff 基线 core: 前缀按启用算）"
+    },
+    {
+      "symbol": "plugin/opens",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "高危面开门授予面切换事实（boot 装载序对每插件 grantedOpens 与审计流尾最近一条本词 diff——有变才落幂等记账；撤位落 opens:[] 空数组形收口；载体 = 进程级 durable 审计流 audit_events〔05 §9〕非会话流，fold = 审计流尾条 = 该插件当前有效授予面）"
+    },
+    {
+      "symbol": "plugin/toggled",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "生命周期归因面——禁用态翻转事实（id/disabled 双态 true|false——审计词形独立于 enabled.yaml 行形〔行内 absent 即启用、无 false 键〕，翻回启用需 false 位表达；写点两路 = CLI toggle 成功尾 + boot diff 补播；载体 = audit_events）"
+    },
+    {
+      "symbol": "plugin/uninstalled",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "卸载四段成功尾落账（id/source/dataAction/affected?；核心词身份拒装载面注册）"
+    },
+    {
+      "symbol": "plugin/unmounted",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "生命周期归因面——卸下事实（id；装机保留行移除；写点两路同 mounted；载体 = audit_events——与 plugin/uninstalled 同面（装机面落码批已先行，CLI 人面无会话恒此载体）；卸下/卸载两动词分立——卸下保留装机、卸载清算资产）"
+    },
+    {
+      "symbol": "plugin/updated",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "生命周期归因面——换装成功事实（id/from?/to——from 缺席 = 旧账本无版本位；local 源 no-op 不落〔无变更不造账〕；写点 = CLI 人面 update 成功尾；载体 = audit_events）"
+    },
+    {
+      "symbol": "preset/applied",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "权限预设切换审计（审批分档批 ap-3 2026-09-11——04 §9 定形块⑥「预设切换落审计」兑现：用户主权动作留痕，/danger approve 同形）：载荷 {preset: conservative|balanced|open, sandboxMode, approvalPolicy, appended}（appended = 建议集去重后真追加数——balanced/conservative 恒 0）；写点 = TUI /approval preset 执行尾恰一笔（写盘成功后；CLI --preset 逐次形零审计、失败路径零落账）；载体 = audit_events"
+    },
+    {
+      "symbol": "request/header",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "完整请求信封快照；reason = initial/resume/change，重建请求取最后一条为基准"
+    },
+    {
+      "symbol": "sandbox/mode",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "会话级沙箱状态 = fold(events)，append 即切换、重放即恢复（无独立配置存储）"
+    },
+    {
+      "symbol": "session/end-seed",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "fork 种子边界标记（data 为空对象，边界即事件自身 seq）"
+    },
+    {
+      "symbol": "session/paused",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "会话停靠（无人值守深化批 u-3 2026-09-11——04 §5 停靠升格定形注②；05 §1.1 词行）：载荷 {reason}（v1 单值 budget——预算语境停靠；触发形态非穷举：记账刹停/budgetExceeded 复验/起跑前池检拒/issue 悬置同词承载）；写入者 = 编排层停靠登记位（run 在飞时先 driver.abort() 协作中止、收口后落词）；fold 语义 = 尾条即停靠（SessionLiveState paused 档推导判据）；恢复不设对称词——唤醒消息（user/message source=budget-extended）落账尾条翻位即恢复 running，resumed 词不立；载体 = 会话流"
+    },
+    {
+      "symbol": "session/thinking-level",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "会话级思考档位 = fold(events)，append 即切换、重放即恢复（与 sandbox/mode 同形态；04 §5「thinkingLevel 是会话态不是 run 态」的 durable 落账词；写入者 = conversation 件档位切换面）"
+    },
+    {
+      "symbol": "todo/write",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "轮内清单全量快照（last-write-wins）；fold = 日志倒扫最后一条 user/message 之后的最后一条本事件"
+    },
+    {
+      "symbol": "tool/call",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "工具调用（arguments 存原始未解析字符串——审计保真）"
+    },
+    {
+      "symbol": "tool/result",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "一调用一结果"
+    },
+    {
+      "symbol": "turn/end",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "一轮结束；reason = completed/aborted/blocked/error/max-tokens/interrupted（可扩展）"
+    },
+    {
+      "symbol": "turn/start",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "一轮（用户输入 → 停止）开始"
+    },
+    {
+      "symbol": "user/message",
+      "module": "session-events",
+      "tier": "stable",
+      "since": "1.0",
+      "desc": "用户输入（string 或 text/image 块）；source 归因词汇闭集见 types.ts"
+    },
+    {
+      "symbol": "Static",
+      "module": "typebox",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    },
+    {
+      "symbol": "TSchema",
+      "module": "typebox",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    },
+    {
+      "symbol": "Type",
+      "module": "typebox",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    },
+    {
+      "symbol": "Code",
+      "module": "typebox/compile",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    },
+    {
+      "symbol": "Compile",
+      "module": "typebox/compile",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    },
+    {
+      "symbol": "Value",
+      "module": "typebox/value",
+      "tier": "stable",
+      "since": "1.0",
+      "forwarded": true,
+      "sig": "forwarded"
+    }
+  ],
+  "capabilities": [
+    {
+      "name": "channels.ui-backend",
+      "providedBy": "channels",
+      "userGrantable": true
+    },
+    {
+      "name": "credentials.read-cross",
+      "providedBy": "core:credentials",
+      "userGrantable": true
+    },
+    {
+      "name": "sdk.register-route",
+      "providedBy": "core:sdk",
+      "userGrantable": true
+    },
+    {
+      "name": "sessions.control-cross",
+      "providedBy": "host",
+      "userGrantable": true
+    },
+    {
+      "name": "sessions.observe-cross",
+      "providedBy": "host",
+      "userGrantable": true
+    },
+    {
+      "name": "triggers.start-run",
+      "providedBy": "host",
+      "userGrantable": true
+    }
+  ]
+}