@sema-agent/client-core 0.68.2 → 0.69.1

package/dist/coreValuePorts.d.ts

@@ -0,0 +1,161 @@
+/**
+ * coreValuePorts.ts — 引擎(`@sema-agent/core`)**值级**面的端口注入口(CC-07,0.69.0;cli L-249 到期桶 core-value 清零)。
+ *
+ * ## 这一格要解决的问题
+ * 壳(cli)有五组逻辑必须与引擎**跑同一个函数体**才不分歧:自主循环提示词的组装、权限规则「放宽」判据、
+ * 工具策略的组合、工具名的协议/退役/语法判别与规则编译校验、讨论工作流的名字。它们此前在壳里**值级直连**
+ * `@sema-agent/core`(cli sdk-isolation 门的 `core-value` 桶,retireBy 已过期),而 web / desktop 座位层
+ * 结构上装不了引擎 —— 同一句判据在三端里只有一端有。
+ *
+ * ## 🔴 为什么是端口注入而不是 `export … from '@sema-agent/core'`
+ * 与 `hitl/editedRuleTextPrecheck.ts` 逐字同一条硬约束:本包的可移植门是外部包**等值集**(`{diff, @sema-agent/sdk}`)
+ * + `--platform=browser` 真打包,而 core 的 barrel 值级拉 `node:crypto` / `node:fs` / `node:path` ⇒ 一条值级
+ * re-export 会把整台引擎焊进每一个装本包的端。⇒ **包声明端口 + 诚实缺席读口;Node 宿主在装配根把 core 的真实现
+ * 原样装进来(不许包一层判断);浏览器 lane 留缺席走各自的往返/降级形**。
+ *
+ * ## 形(逐组,签名与 core 7.18.0 `dist/**.d.ts` 逐字同,只把 core 私有型换成**结构等价的镜像**)
+ *  · `resolveAutonomousLoopPrompt(prompt, opts?)` → `string | null`(core `tools/loop-tick.d.ts`);
+ *  · `loosenReasons(prior, next)` → `string[]`(core `core/session-permission-rules`;两参用 sdk 的
+ *    `SessionPermissionRules`,与 core 同名同形);
+ *  · `combinePolicies(...policies)` / `createAllowDenyPolicy(opts)` → 工具策略(core `core/tool-policy.d.ts`;
+ *    策略对本包是**不透明句柄** {@link CoreToolPolicyHandle}:本包不调 `check`,只把它交回引擎/请求装配);
+ *  · `MCP_NAMESPACE` / `RETIRED_TOOL_NAMES` / `protocolOf(name)` / `ruleToolGrammarOf(toolName)` /
+ *    `validatePermissionRules(rules, opts?)`(core `core/protocol-table.d.ts` / `core/permission-rules.d.ts`);
+ *  · `DISCUSSION_WORKFLOW_NAME`(core 常量 `"discussion"`)。
+ *
+ * ## 🔴 读口纪律(与 `precheckEditedRuleText` 同律)
+ *  · 没装 ⇒ 返 `undefined`(**诚实缺席**),绝不返一个编出来的值(空数组 / 默认策略 / `"discussion"` 字面量都算编);
+ *  · 装的必须是 core 的**同一只**实现,原样装 —— 包一层就把「同一函数体」这条唯一的抗漂移保证拆掉;
+ *  · core 对调用方 bug 的响亮抛(如 `createAllowDenyPolicy` 的 `config.invalid_tool_name_set`)**原样上抛**,本层不吞;
+ *  · 装口返回**还原函数**(还原到装之前那一只,不是无脑清空 —— 嵌套装载时无脑清空会抹掉外层)。
+ *
+ * ## 缺席语义(三端)
+ *  · cli / desktop 主进程(Node,引擎在场):装配根一处 `installCoreValuePorts({...core 那十件...})`,缺席 = 宿主漏装 = bug;
+ *  · web / desktop 渲染层:结构上装不了 ⇒ 恒缺席;消费点按 `undefined` 走各自的降级形(不判定、交引擎端裁)。
+ *  本口的缺席因此**不是**「宿主忘了装」的同义词,别拿它判部署形态(`hasCoreValuePorts()` 只答「装没装」)。
+ */
+import type { SessionPermissionRules } from '@sema-agent/sdk';
+/** core `AutonomousLoopPromptOptions` 的逐形镜像(三键全可选)。 */
+export interface AutonomousLoopPromptOptionsView {
+    firstTick?: boolean;
+    persistentVariant?: boolean;
+    pushNotification?: boolean;
+}
+/**
+ * core `ToolPolicy` 的**不透明句柄**:本包不调 `check`(那是引擎在 run 里做的事),只把策略原样交回。
+ * 结构上只钉「有一只 `check`」—— core 的 `ToolPolicy` / `NamedToolPolicy` 都可赋给它;反向刻意不钉。
+ */
+export interface CoreToolPolicyHandle {
+    readonly check: (req: never, signal?: AbortSignal) => CorePermissionResultView | Promise<CorePermissionResultView>;
+    readonly projection?: object;
+}
+/** core `PermissionResult` 的最小镜像(本包只钉判别位 `action`;其余位在引擎侧)。 */
+export interface CorePermissionResultView {
+    readonly action: 'allow' | 'ask' | 'deny' | (string & {});
+}
+/** core `createAllowDenyPolicy` 的入参镜像。 */
+export interface AllowDenyPolicyOptionsView {
+    allow?: string[];
+    deny?: string[];
+    /** 非裸工具名的 entry(规则内容形)怎么办:`throw`(缺省)在构造时拒;`skip` 丢掉并经 `onInvalidNameIssue` 报。 */
+    onInvalidName?: 'throw' | 'skip';
+    onInvalidNameIssue?: (issue: AllowDenyInvalidNameIssueView) => void;
+}
+/** `onInvalidName: 'skip'` 时逐条报出的那一件。 */
+export interface AllowDenyInvalidNameIssueView {
+    entry: string;
+    list: 'allow' | 'deny';
+    message: string;
+}
+/** core `ProtocolNamespace` 的镜像(`id` 按开集读:core 今天 `mcp` / `a2a` 两词)。 */
+export interface CoreProtocolNamespaceView {
+    readonly id: string;
+    readonly prefix: string;
+    makeName(peer: string, tool: string): string;
+    /** 解不出 ⇒ `undefined`(core `ProtocolPeerTool` 对本包不透明,只钉「解出了一个对象」)。 */
+    parse(name: string): object | undefined;
+    displayGroupKey(name: string): string;
+}
+/** core `PermissionRule` 的逐形镜像。 */
+export interface PermissionRuleView {
+    rule: string;
+    behavior: 'deny' | 'ask' | 'allow';
+    source?: string;
+}
+/**
+ * core `PermissionRuleIssue` 的镜像。🔴 `code` 按**开集串**读:core 那张码表(`invalid.*` / `unsupported.*`)属主在引擎,
+ * 镜像枚举 = 引擎加员当天把一个合法码判没(#157 词表纪律)。
+ */
+export interface PermissionRuleIssueView {
+    rule: string;
+    code: string;
+    message: string;
+}
+/** core `validatePermissionRules` 第二参的镜像(`Pick<PermissionRulePolicyOptions, …>` 四键)。 */
+export interface ValidatePermissionRulesOptionsView {
+    primaryFieldGeneric?: 'reject' | 'allow-lexical';
+    /** core `Partial<PermissionRuleCaps>`;本包不钉各帽名(属主在引擎),按对象透传。 */
+    caps?: object;
+    ruleFaces?: (toolName: string) => object | undefined;
+    /** core `PathRuleBases`:`cwd` / `root` / `home` 三基各可选(按开集键读)。 */
+    pathBases?: {
+        readonly [base: string]: string | undefined;
+    };
+}
+/** 十件端口的**形**(每一件的唯一合法实参 = core 导出的同名那一只,原样装)。 */
+export interface CoreValuePorts {
+    resolveAutonomousLoopPrompt: (prompt: string, opts?: AutonomousLoopPromptOptionsView) => string | null;
+    loosenReasons: (prior: SessionPermissionRules, next: SessionPermissionRules) => string[];
+    combinePolicies: (...policies: CoreToolPolicyHandle[]) => CoreToolPolicyHandle;
+    createAllowDenyPolicy: (opts: AllowDenyPolicyOptionsView) => CoreToolPolicyHandle;
+    MCP_NAMESPACE: CoreProtocolNamespaceView;
+    RETIRED_TOOL_NAMES: ReadonlyMap<string, string>;
+    protocolOf: (name: string) => CoreProtocolNamespaceView | undefined;
+    ruleToolGrammarOf: (toolName: string) => 'command' | 'path' | undefined;
+    validatePermissionRules: (rules: PermissionRuleView[], opts?: ValidatePermissionRulesOptionsView) => PermissionRuleIssueView[];
+    DISCUSSION_WORKFLOW_NAME: string;
+}
+/** 端口名的闭集(读口逐名一一对应;`hasCoreValuePort(name)` 的入参域)。 */
+export declare const CORE_VALUE_PORT_NAMES: readonly ["resolveAutonomousLoopPrompt", "loosenReasons", "combinePolicies", "createAllowDenyPolicy", "MCP_NAMESPACE", "RETIRED_TOOL_NAMES", "protocolOf", "ruleToolGrammarOf", "validatePermissionRules", "DISCUSSION_WORKFLOW_NAME"];
+export type CoreValuePortName = (typeof CORE_VALUE_PORT_NAMES)[number];
+/**
+ * 装/卸端口(可以只装一部分:没装的那几件读口照旧缺席)。返回**还原函数**(还原到装之前那一袋)。
+ *
+ * Node 宿主的装法(**逐字**,别加工):
+ * ```ts
+ * import { resolveAutonomousLoopPrompt, loosenReasons, combinePolicies, createAllowDenyPolicy,
+ *          MCP_NAMESPACE, RETIRED_TOOL_NAMES, protocolOf, ruleToolGrammarOf, validatePermissionRules,
+ *          DISCUSSION_WORKFLOW_NAME } from '@sema-agent/core'
+ * installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolicies, createAllowDenyPolicy,
+ *          MCP_NAMESPACE, RETIRED_TOOL_NAMES, protocolOf, ruleToolGrammarOf, validatePermissionRules,
+ *          DISCUSSION_WORKFLOW_NAME })
+ * ```
+ * 🔴 传 `null` = 卸;传一袋 = **整袋替换**(不与上一袋合并 —— 合并会让「卸掉一件」这件事无法表达)。
+ */
+export declare function installCoreValuePorts(ports: Partial<CoreValuePorts> | null): () => void;
+/** 装没装(整袋)。`false` 时所有读口缺席。 */
+export declare function hasCoreValuePorts(): boolean;
+/** 某一件装没装(存在性读口哨兵:`boolean` 形)。 */
+export declare function hasCoreValuePort(name: CoreValuePortName): boolean;
+/** 十件里还没装的那几件的名字(宿主自检 / doctor 行用;全装 ⇒ `[]`,整袋没装 ⇒ 十件全列)。 */
+export declare function coreValuePortMisses(): readonly CoreValuePortName[];
+/** 自主循环提示词组装(core `resolveAutonomousLoopPrompt`)。没装 ⇒ `undefined`;装了但 core 判「不组」⇒ `null`(两态不折)。 */
+export declare function resolveAutonomousLoopPrompt(prompt: string, opts?: AutonomousLoopPromptOptionsView): string | null | undefined;
+/** 「`next` 相对 `prior` 放宽了哪些」(core `loosenReasons`;空数组 = 没放宽)。没装 ⇒ `undefined`(不是 `[]`)。 */
+export declare function loosenReasons(prior: SessionPermissionRules, next: SessionPermissionRules): string[] | undefined;
+/** 组合工具策略(core `combinePolicies`,deny-wins)。没装 ⇒ `undefined`。 */
+export declare function combinePolicies(...policies: CoreToolPolicyHandle[]): CoreToolPolicyHandle | undefined;
+/** 白/黑名单策略(core `createAllowDenyPolicy`;`onInvalidName` 缺省 `throw`,core 响亮抛原样上抛)。没装 ⇒ `undefined`。 */
+export declare function createAllowDenyPolicy(opts: AllowDenyPolicyOptionsView): CoreToolPolicyHandle | undefined;
+/** MCP 协议命名空间(core `MCP_NAMESPACE`;`prefix` 今天 `mcp__`)。没装 ⇒ `undefined`。 */
+export declare function mcpNamespace(): CoreProtocolNamespaceView | undefined;
+/** 退役工具名 → 继任名(core `RETIRED_TOOL_NAMES`)。没装 ⇒ `undefined`(不是空 Map)。 */
+export declare function retiredToolNames(): ReadonlyMap<string, string> | undefined;
+/** 名字属于哪个协议命名空间(core `protocolOf`)。没装 ⇒ `undefined`;装了但不属任何协议 ⇒ 也是 `undefined`(两态在这一格上**不可分**,要分先问 `hasCoreValuePort('protocolOf')`)。 */
+export declare function protocolOf(name: string): CoreProtocolNamespaceView | undefined;
+/** 规则内容语法族(core `ruleToolGrammarOf`;`command` / `path`)。没装 ⇒ `undefined`(与「该工具无语法族」同形,要分先问 `hasCoreValuePort`)。 */
+export declare function ruleToolGrammarOf(toolName: string): 'command' | 'path' | undefined;
+/** 规则编译校验(core `validatePermissionRules`;空数组 = 全部编译得了)。没装 ⇒ `undefined`(不是 `[]` —— 那会把「没校」说成「全过」)。 */
+export declare function validatePermissionRules(rules: PermissionRuleView[], opts?: ValidatePermissionRulesOptionsView): PermissionRuleIssueView[] | undefined;
+/** 讨论工作流的名字(core `DISCUSSION_WORKFLOW_NAME`,今天 `"discussion"`)。没装 ⇒ `undefined`(不铸字面量)。 */
+export declare function discussionWorkflowName(): string | undefined;

package/dist/coreValuePorts.js

@@ -0,0 +1,98 @@
+/** 端口名的闭集(读口逐名一一对应;`hasCoreValuePort(name)` 的入参域)。 */
+export const CORE_VALUE_PORT_NAMES = Object.freeze([
+    'resolveAutonomousLoopPrompt',
+    'loosenReasons',
+    'combinePolicies',
+    'createAllowDenyPolicy',
+    'MCP_NAMESPACE',
+    'RETIRED_TOOL_NAMES',
+    'protocolOf',
+    'ruleToolGrammarOf',
+    'validatePermissionRules',
+    'DISCUSSION_WORKFLOW_NAME',
+]);
+let installed = null;
+/**
+ * 装/卸端口(可以只装一部分:没装的那几件读口照旧缺席)。返回**还原函数**(还原到装之前那一袋)。
+ *
+ * Node 宿主的装法(**逐字**,别加工):
+ * ```ts
+ * import { resolveAutonomousLoopPrompt, loosenReasons, combinePolicies, createAllowDenyPolicy,
+ *          MCP_NAMESPACE, RETIRED_TOOL_NAMES, protocolOf, ruleToolGrammarOf, validatePermissionRules,
+ *          DISCUSSION_WORKFLOW_NAME } from '@sema-agent/core'
+ * installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolicies, createAllowDenyPolicy,
+ *          MCP_NAMESPACE, RETIRED_TOOL_NAMES, protocolOf, ruleToolGrammarOf, validatePermissionRules,
+ *          DISCUSSION_WORKFLOW_NAME })
+ * ```
+ * 🔴 传 `null` = 卸;传一袋 = **整袋替换**(不与上一袋合并 —— 合并会让「卸掉一件」这件事无法表达)。
+ */
+export function installCoreValuePorts(ports) {
+    const prev = installed;
+    installed = ports === null ? null : { ...ports };
+    return () => {
+        installed = prev;
+    };
+}
+/** 装没装(整袋)。`false` 时所有读口缺席。 */
+export function hasCoreValuePorts() {
+    return installed !== null;
+}
+/** 某一件装没装(存在性读口哨兵:`boolean` 形)。 */
+export function hasCoreValuePort(name) {
+    return installed !== null && installed[name] !== undefined;
+}
+/** 十件里还没装的那几件的名字(宿主自检 / doctor 行用;全装 ⇒ `[]`,整袋没装 ⇒ 十件全列)。 */
+export function coreValuePortMisses() {
+    return CORE_VALUE_PORT_NAMES.filter((n) => installed === null || installed[n] === undefined);
+}
+function port(name) {
+    return installed === null ? undefined : installed[name];
+}
+// ── 读口(逐件;没装 ⇒ undefined,绝不编值;core 的响亮抛原样上抛)──────────────────────────────
+/** 自主循环提示词组装(core `resolveAutonomousLoopPrompt`)。没装 ⇒ `undefined`;装了但 core 判「不组」⇒ `null`(两态不折)。 */
+export function resolveAutonomousLoopPrompt(prompt, opts) {
+    const fn = port('resolveAutonomousLoopPrompt');
+    return fn === undefined ? undefined : fn(prompt, opts);
+}
+/** 「`next` 相对 `prior` 放宽了哪些」(core `loosenReasons`;空数组 = 没放宽)。没装 ⇒ `undefined`(不是 `[]`)。 */
+export function loosenReasons(prior, next) {
+    const fn = port('loosenReasons');
+    return fn === undefined ? undefined : fn(prior, next);
+}
+/** 组合工具策略(core `combinePolicies`,deny-wins)。没装 ⇒ `undefined`。 */
+export function combinePolicies(...policies) {
+    const fn = port('combinePolicies');
+    return fn === undefined ? undefined : fn(...policies);
+}
+/** 白/黑名单策略(core `createAllowDenyPolicy`;`onInvalidName` 缺省 `throw`,core 响亮抛原样上抛)。没装 ⇒ `undefined`。 */
+export function createAllowDenyPolicy(opts) {
+    const fn = port('createAllowDenyPolicy');
+    return fn === undefined ? undefined : fn(opts);
+}
+/** MCP 协议命名空间(core `MCP_NAMESPACE`;`prefix` 今天 `mcp__`)。没装 ⇒ `undefined`。 */
+export function mcpNamespace() {
+    return port('MCP_NAMESPACE');
+}
+/** 退役工具名 → 继任名(core `RETIRED_TOOL_NAMES`)。没装 ⇒ `undefined`(不是空 Map)。 */
+export function retiredToolNames() {
+    return port('RETIRED_TOOL_NAMES');
+}
+/** 名字属于哪个协议命名空间(core `protocolOf`)。没装 ⇒ `undefined`;装了但不属任何协议 ⇒ 也是 `undefined`(两态在这一格上**不可分**,要分先问 `hasCoreValuePort('protocolOf')`)。 */
+export function protocolOf(name) {
+    const fn = port('protocolOf');
+    return fn === undefined ? undefined : fn(name);
+}
+/** 规则内容语法族(core `ruleToolGrammarOf`;`command` / `path`)。没装 ⇒ `undefined`(与「该工具无语法族」同形,要分先问 `hasCoreValuePort`)。 */
+export function ruleToolGrammarOf(toolName) {
+    const fn = port('ruleToolGrammarOf');
+    return fn === undefined ? undefined : fn(toolName);
+}
+/** 规则编译校验(core `validatePermissionRules`;空数组 = 全部编译得了)。没装 ⇒ `undefined`(不是 `[]` —— 那会把「没校」说成「全过」)。 */
+export function validatePermissionRules(rules, opts) {
+    const fn = port('validatePermissionRules');
+    return fn === undefined ? undefined : fn(rules, opts);
+}
+/** 讨论工作流的名字(core `DISCUSSION_WORKFLOW_NAME`,今天 `"discussion"`)。没装 ⇒ `undefined`(不铸字面量)。 */
+export function discussionWorkflowName() {
+    return port('DISCUSSION_WORKFLOW_NAME');
+}

package/dist/engineNoticeCodes.d.ts

@@ -54,7 +54,7 @@
 /** 一条通告是**说给谁听**的。两值,刻意不设第三值(见模块顶注)。 */
 export type NoticeAudience = 'user' | 'operator';
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.17.x = 五十二码**;顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.18.0 = 五十六码**(7.17.x 五十二 + #748 两枚 writeFace + #742 两枚 classifier,均 operator);顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。

package/dist/engineNoticeCodes.js

@@ -52,7 +52,7 @@
  * 出现在本包源码或产物里 => 当场红。
  */
 /**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.17.x = 五十二码**;顺序同源)。
+ * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.18.0 = 五十六码**(7.17.x 五十二 + #748 两枚 writeFace + #742 两枚 classifier,均 operator);顺序同源)。
  * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
  * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
  *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
@@ -67,6 +67,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.models_swapped',
     'config.read_face_swapped',
     'config.read_face_deployment_clamped',
+    // core 7.18.0 #748(0.68.3 提货批 CC-05):writeFace 席的两枚运维通告;位置 = governance-codes.d.ts 元组 @6/@7 真字节。
+    'config.write_face_swapped',
+    'config.write_face_deployment_clamped',
     'config.tool_model_gate_removed',
     'config.tool_model_gate_unknown_class',
     'config.tool_model_gate_env_invalid',
@@ -83,6 +86,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'peer.held_settled',
     'peer.idle_subscription',
     'classifier.denial_limit',
+    // core 7.18.0 #742(CC-05):分类器席坏配置 ⇒ 主模型代判的一条运维通告;元组 @22。
+    'classifier.fallback',
     'checkpoint.execution_outcome_unrecorded',
     'delegation.transcript_integrity',
     'delegation.ask_unresolvable',
@@ -104,6 +109,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'memory.consolidation_refused',
     'memory.consolidation_withheld',
     'route.fallback_to_primary',
+    // core 7.18.0 #742(CC-05):分类器候选梯子无可路由席;元组 @44。
+    'route.classifier_unroutable',
     'route.base_url_changed_key_unchanged',
     'task.user_steer_undrained',
     'task.user_followup_undrained',
@@ -137,6 +144,8 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.models_swapped': 'operator',
     'config.read_face_swapped': 'operator',
     'config.read_face_deployment_clamped': 'operator',
+    'config.write_face_swapped': 'operator',
+    'config.write_face_deployment_clamped': 'operator',
     'config.tool_model_gate_removed': 'operator',
     'config.tool_model_gate_unknown_class': 'operator',
     'config.tool_model_gate_env_invalid': 'operator',
@@ -152,6 +161,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'peer.held_settled': 'user',
     'peer.idle_subscription': 'user',
     'classifier.denial_limit': 'user',
+    'classifier.fallback': 'operator',
     'checkpoint.execution_outcome_unrecorded': 'operator',
     'delegation.transcript_integrity': 'operator',
     'delegation.ask_unresolvable': 'user',
@@ -175,6 +185,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     //    理由 = 这条通告没有 sessionId,一次固化跑在任何会话之外)。
     'memory.consolidation_withheld': 'operator',
     'route.fallback_to_primary': 'operator',
+    'route.classifier_unroutable': 'operator',
     'route.base_url_changed_key_unchanged': 'operator',
     'task.user_steer_undrained': 'user',
     'task.user_followup_undrained': 'user',

package/dist/gateOutcome.d.ts

@@ -51,8 +51,12 @@ import type { DeniedBy, Settlement } from '@sema-agent/sdk';
  */
 export type GateDispositionView = {
     kind: 'allowed';
+    /** 0.68.3(core 7.18.0 #742):分类器轮记录;缺席 = 未知(见 {@link GateClassifierRoundView})。 */
+    classifier?: GateClassifierRoundView;
 } | {
     kind: 'denied';
+    /** 同上 —— 两臂都可带(core `GateDisposition` 两臂各自声明,本层逐臂逐键挑)。 */
+    classifier?: GateClassifierRoundView;
     deniedBy: DeniedBy | (string & {});
     /**
      * 0.67.0(core 7.14.0 #688)—— 这次 deny 是**分类器那一轮没能裁决**的哪一形
@@ -69,6 +73,29 @@ export type GateDispositionView = {
      */
     cause?: string;
 };
+/**
+ * 0.68.3(core 7.18.0 #742)—— **分类器那一轮到底问了谁**(`AutoModeClassifierRound` 的防御读视图)。
+ *
+ * 🔴 **缺席 = 未知 ≠ 席自答**(core 提货单 [7281] 逐字):缺席同时覆盖「这不是分类器轮」「老引擎」
+ *    「分类器席没配」三形,端**禁**读成「主模型自己判的」。
+ * · `modelRequested` / `modelUsed`:请求的席与实际答题的模型(两者不同 ⇒ 走了候选梯子)。
+ * · `fallback`:从哪一级退到哪一级、为什么(`cause` = core `AUTO_MODE_FALLBACK_CAUSES` 三词
+ *   `error` / `timeout` / `parse_error`,**按开集读**;本包不持该表)。缺席 = 没退。
+ *   ⚠️ core 顶注:prompt 都没能组出来的那一形也记成 `{from: seat, to: main, cause: "error"}`——
+ *   「没问过任何模型」与「问了但坏了」在这一位上**分不开**,端别据它渲「分类器席坏了」。
+ * 🔴 两个必在位缺一 ⇒ 整只 `classifier` 缺席(半只视图比没有更坏);`fallback` 三键缺一 ⇒ 只丢 `fallback`。
+ */
+export interface GateClassifierRoundView {
+    modelRequested: string;
+    modelUsed: string;
+    fallback?: GateClassifierFallbackView;
+}
+/** 分类器候选梯子的一次退级:从哪一级到哪一级、为什么(`cause` 按开集读)。 */
+export interface GateClassifierFallbackView {
+    from: string;
+    to: string;
+    cause: string;
+}
 /** 结算方的身份座(形由 {@link SettlementView.kind} 决定,本读器不重铸那张配对表)。 */
 export interface SettlementWhoView {
     /** `person` / `engine` / `host` / `none`(开集读)。 */
@@ -96,19 +123,6 @@ export interface GateOutcomeView {
     /** 谁**问**的(core `ASK_ORIGINS`,7.6.0 起十词;**按开集读**)。与 {@link settlement} 同在同缺。 */
     origin?: string;
 }
-/**
- * `tool_end` 帧(或本包投影出的 `tool_end_result` 内部臂、耐久行的 resolved outcome)→ 门记录。
- *
- * 入参是**帧**而不是 `frame.gate`,刻意如此:端不必知道这条记录挂在哪个键上(那正是下一次形变
- * 会动的东西),也不必自己判「这一帧带不带门」。
- *
- * 🔴 `disposition` 是**唯一的承重座**:它读不出来 ⇒ 整只 `undefined`。一条只有 `settlement` 而
- *    说不出「放行还是拒了」的记录,消费端能从它得到的只有误导。
- * 🔴 **不校 I1–I4 那四条不变量**(`settlement` ⇔ `origin` 同在、`ask_resolution` ⇒ 有拒绝类结算……):
- *    筛子的属主是引擎,server 对过不了筛的记录**整条不投**。包再校一遍,只会在上游合法演进的当天
- *    把一条真记录判没,而本层给不出比「原样交给端」更好的降级动作(`wiring_manifest.autoMode`
- *    那一段的反向先例是**同一条帧上的段内自洽**,不是跨系统的不变量,两者刻意不同处置)。
- */
 export declare function gateOutcomeOf(frame: unknown): GateOutcomeView | undefined;
 /**
  * 这次调用是**被门 park 了**吗 —— 「没在这里结算」的**第二形**(engine 7.64.0 真机黑盒直证)。

package/dist/gateOutcome.js

@@ -56,6 +56,26 @@ function readSettlement(v) {
  *    把一条真记录判没,而本层给不出比「原样交给端」更好的降级动作(`wiring_manifest.autoMode`
  *    那一段的反向先例是**同一条帧上的段内自洽**,不是跨系统的不变量,两者刻意不同处置)。
  */
+function readClassifierRound(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return undefined;
+    const r = raw;
+    const modelRequested = str(r.modelRequested);
+    const modelUsed = str(r.modelUsed);
+    if (modelRequested === undefined || modelUsed === undefined)
+        return undefined;
+    const view = { modelRequested, modelUsed };
+    const fb = r.fallback;
+    if (typeof fb === 'object' && fb !== null && !Array.isArray(fb)) {
+        const f = fb;
+        const from = str(f.from);
+        const to = str(f.to);
+        const cause = str(f.cause);
+        if (from !== undefined && to !== undefined && cause !== undefined)
+            view.fallback = { from, to, cause };
+    }
+    return view;
+}
 export function gateOutcomeOf(frame) {
     if (typeof frame !== 'object' || frame === null || Array.isArray(frame))
         return undefined;
@@ -69,8 +89,10 @@ export function gateOutcomeOf(frame) {
     const dr = d;
     const dk = str(dr.kind);
     let disposition;
+    // 0.68.3(core 7.18.0 #742):两臂都可带 `classifier`;逐键挑、缺席不铸键。
+    const classifier = readClassifierRound(dr.classifier);
     if (dk === 'allowed') {
-        disposition = { kind: 'allowed' };
+        disposition = { kind: 'allowed', ...(classifier !== undefined ? { classifier } : {}) };
     }
     else if (dk === 'denied') {
         const deniedBy = str(dr.deniedBy);
@@ -79,7 +101,12 @@ export function gateOutcomeOf(frame) {
             return undefined;
         // 0.67.0:分类器 deny 的成因位(开集透传、缺席不铸键;判成员在 `classifierDenyCauseOf`)。
         const cause = str(dr.cause);
-        disposition = { kind: 'denied', deniedBy, ...(cause !== undefined ? { cause } : {}) };
+        disposition = {
+            kind: 'denied',
+            deniedBy,
+            ...(cause !== undefined ? { cause } : {}),
+            ...(classifier !== undefined ? { classifier } : {}),
+        };
     }
     else {
         // 处置词本身不认识 ⇒ 整只不成形:`allowed` / `denied` 是这条记录的**判别位**,猜不得。

package/dist/index.d.ts

@@ -249,6 +249,7 @@ export { isAskTool } from './hitl/frameRouter.js';
 export * from './hitl/hitlHostSurface.js';
 export * from './hitl/toolApprovalWire.js';
 export * from './hitl/editedRuleTextPrecheck.js';
+export * from './coreValuePorts.js';
 export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
 export * from './hitl/gateIdentity.js';

package/dist/index.js

@@ -433,6 +433,8 @@ export * from './hitl/toolApprovalWire.js';
 // `--platform=browser` 真打包,一条这样的边会把整台引擎焊进 web/desktop 的产物。
 // ⇒ 转出口取「类型面 + 注入口 + 诚实缺席读口」三件(逐条理由见模块头注)。
 export * from './hitl/editedRuleTextPrecheck.js';
+// CC-07(0.69.0):core **值级**面十件的端口注入口(cli L-249 core-value 桶清零;同 editedRuleTextPrecheck 形:包声明端口 + 诚实缺席读口)。
+export * from './coreValuePorts.js';
 export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
 // ── A-028.2/.3(#244 族A,2026-08-12):决断卡链的键词汇/呈现台账/归属判据三件 ————————————

package/dist/mcpPanel.d.ts

@@ -1,3 +1,35 @@
+/**
+ * mcpPanel.ts — `GET /v1/sessions/:id/mcp` 面板体(sdk `McpStatusPanel`)的**防御读视图**
+ * (CC-03,0.68.2;server 7.77.0 S-297 可选键 `lastLegMcp`;回 A-093 ③)。
+ *
+ * ── 为什么在包里(归层)────────────────────────────────────────────────────────────────────
+ * 面板体是三端都要渲的同一份读面:`servers[]` 是「这台部署此刻按需 materialize 出来的连接状态」,
+ * `lastLegMcp` 是「这个会话最近一条腿的账本里申报了哪些 MCP」。**两面合法可不同**(部署缺省场景
+ * 与按请求注入的名册本来就是两张表),契约 G.7 第 4 条禁止消费端拿它们对账后渲「不一致」。
+ * 这条纪律若各端自己写一遍,迟早有一端写反。⇒ 读法(哪些键、坏形怎么办、缺席说什么)只在这里
+ * 有一份;端只渲。
+ *
+ * ── 缺席语义(逐键)──────────────────────────────────────────────────────────────────────────
+ *  · `lastLegMcp` **整键缺席** = server 的三形同形(新会话 / 最近腿的账本行在保留窗外 / 该腿没推
+ *    `wiring_manifest`)**或**引擎早于 7.77.0;本视图同样不铸该键。「为什么缺席」这一位答不出来,
+ *    也不猜。
+ *  · `lastLegMcp` **在场但形坏**(`runId` / `at` 不是非空串、`mcp` 读不出一行)⇒ 视图不铸该键,
+ *    改立 {@link McpPanelView.lastLegMcpUnreadable}(never false)。「引擎送了一份我读不懂的」与
+ *    「引擎没送」对运维是两句话,不折成一个 `undefined`。
+ *  · `degraded`:只在 server 的超时臂铸(sdk openapi 顶注逐字)⇒ 本视图 never false:在场 = 取不到,
+ *    缺席 = 正常 materialize(`servers: []` 那时是「一台都没配」这句正面事实,不是「不知道」)。
+ *  · `servers[]` 逐行:`name` + `status` 是必需两座(缺一丢该行,坏一行只丢那一行);**非空输入而零行
+ *    幸存 ⇒ 整个视图 `undefined`**(「我读不出来」不是「我知道是零」,与 `wiring_manifest.mcp`
+ *    同一条规矩)。`status` 按开集读(sdk 只声明 connected/failed 两词,core 未来加词照渲不丢行)。
+ *  · `error`:server 已脱敏 + 200 字符封顶;本视图仍按 UNTRUSTED-for-display 再过一次
+ *    {@link capForDisplay}(呈前消毒 + 封长),与本包其余远端文本铸点同律。
+ *
+ * ── `mcp[]` 条目与 `wiring_manifest` 第三段**同一只读器**─────────────────────────────────────
+ * `lastLegMcp.mcp[]` 是该腿 `wiring_manifest.mcp[]` 的逐字回放(server S-297),本视图直接调
+ * {@link projectMcpSection} —— 同一形、同一判据、同一缺席律;三端渲这两处用同一个
+ * {@link WiringManifestMcpEntry},不会出现「活体腿一种形、账本回放另一种形」。
+ */
+import type { AgentClient } from '@sema-agent/sdk';
 import { type WiringManifestMcpEntry } from './adapter/downstream/eventToSdkMessage.js';
 /** 面板 `servers[]` 一行(sdk `McpServerStatus` 的窄读;开集键不透传,逐键挑)。 */
 export interface McpPanelServerView {
@@ -46,10 +78,22 @@ export interface McpPanelView {
  *    (契约 G.7 第 4 条:两面合法可不同)。
  */
 export declare function projectMcpPanel(body: unknown): McpPanelView | undefined;
+/**
+ * 取面板体并投成读视图(CC-03 补件,0.69.0):`GET /v1/sessions/:id/mcp` 经 sdk `client.sessions.mcp`(自 sdk 0.0.75 在场,
+ * 与 `runs.subagentOutput` 同一条 transport,鉴权/principal 由 sdk 带 —— 本包**不**裸 fetch,不做第二套鉴权铸点)。
+ *
+ * 🔴 返回 `undefined` 的三形**同形**(与 {@link projectMcpPanel} 的缺席律一致):传输失败(网络 / 4xx / 5xx / abort)、
+ *    体读不出(必填位坏)、`sessionId` 空串(不发请求)。「为什么」不在返回值上 —— 传输失败留一行 `hostLog('debug')`,
+ *    端要分「未观测 vs 读不出」用 {@link mcpPanelLastLegDetail} 的 `reachable` 位(`view !== undefined` 即 reachable)。
+ * 🔴 `client` 只钉 `sessions` 一格(`Pick`):端传本包 `makeEngineWireClient` 造的实例即可,测试可喂假客户端。
+ */
+export declare function fetchMcpPanel(client: Pick<AgentClient, 'sessions'>, sessionId: string, opts?: {
+    signal?: AbortSignal;
+}): Promise<McpPanelView | undefined>;
 /**
  * `lastLegMcp` 那一行措辞的**唯一铸点**(三端共用;别在各端的行装配里另写一遍)。
  *
- * 🔴 四句刻意逐字互异(黑盒锚),且**没有一句**提到 `servers[]`:
+ * 🔴 五句刻意逐字互异(黑盒锚;0.69.1 订正:此前写「四句」漏了「面板体读不出」那一句),且**没有一句**提到 `servers[]`:
  *   ① 在场 —— 名册 + runId + at;
  *   ② `opts.reachable === false` —— 「未观测」:这次进程没读到面板体;
  *   ③ 面板读到了但 `lastLegMcp` 整键缺席 —— 「不报」:三形同形 + 老引擎,**不武断咎为版本**;

package/dist/mcpPanel.js

@@ -1,3 +1,4 @@
+import { hostLog } from './host.js';
 import { projectMcpSection } from './adapter/downstream/eventToSdkMessage.js';
 import { capForDisplay } from './fleetTaskDesc.js';
 /** `error` 上屏前的封长(server 侧 `slice(200)`,同值)。 */
@@ -70,10 +71,33 @@ export function projectMcpPanel(body) {
     }
     return view;
 }
+/**
+ * 取面板体并投成读视图(CC-03 补件,0.69.0):`GET /v1/sessions/:id/mcp` 经 sdk `client.sessions.mcp`(自 sdk 0.0.75 在场,
+ * 与 `runs.subagentOutput` 同一条 transport,鉴权/principal 由 sdk 带 —— 本包**不**裸 fetch,不做第二套鉴权铸点)。
+ *
+ * 🔴 返回 `undefined` 的三形**同形**(与 {@link projectMcpPanel} 的缺席律一致):传输失败(网络 / 4xx / 5xx / abort)、
+ *    体读不出(必填位坏)、`sessionId` 空串(不发请求)。「为什么」不在返回值上 —— 传输失败留一行 `hostLog('debug')`,
+ *    端要分「未观测 vs 读不出」用 {@link mcpPanelLastLegDetail} 的 `reachable` 位(`view !== undefined` 即 reachable)。
+ * 🔴 `client` 只钉 `sessions` 一格(`Pick`):端传本包 `makeEngineWireClient` 造的实例即可,测试可喂假客户端。
+ */
+export async function fetchMcpPanel(client, sessionId, opts) {
+    if (typeof sessionId !== 'string' || sessionId.length === 0)
+        return undefined;
+    let body;
+    try {
+        body = await client.sessions.mcp(sessionId, opts?.signal ? { signal: opts.signal } : undefined);
+    }
+    catch (e) {
+        const status = e?.status;
+        hostLog('debug', `[mcp-panel] ${sessionId}: ${typeof status === 'number' ? status : String(e).slice(0, 160)}`);
+        return undefined;
+    }
+    return projectMcpPanel(body);
+}
 /**
  * `lastLegMcp` 那一行措辞的**唯一铸点**(三端共用;别在各端的行装配里另写一遍)。
  *
- * 🔴 四句刻意逐字互异(黑盒锚),且**没有一句**提到 `servers[]`:
+ * 🔴 五句刻意逐字互异(黑盒锚;0.69.1 订正:此前写「四句」漏了「面板体读不出」那一句),且**没有一句**提到 `servers[]`:
  *   ① 在场 —— 名册 + runId + at;
  *   ② `opts.reachable === false` —— 「未观测」:这次进程没读到面板体;
  *   ③ 面板读到了但 `lastLegMcp` 整键缺席 —— 「不报」:三形同形 + 老引擎,**不武断咎为版本**;

package/dist/sdkWireTransit.d.ts

@@ -38,4 +38,4 @@ export { isApprovalRequestFrameV1, isApprovalRevokeFrameV1 } from '@sema-agent/s
  * 🔴 **谁是权威**:权威恒是 `@sema-agent/sdk` 本身。本文件是**别名**,上游改名 ⇒ 本文件当场编译红,
  *    端跟着红 —— 这正是型面转口相对「端各自直连」唯一多出来的那点好处(红在一处,不是散在九处)。
  */
-export type { TaskRequest, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, } from '@sema-agent/sdk';
+export type { TaskRequest, SessionPermissionRules, SemaSettings, SkillSpec, AgentEvent, RunReceipt, CancelAck, RunRecord, ToolApprovalRespondAck, FleetTaskRow, FleetWorkflowRow, ApprovalCard, ApprovalRequestFrame, ApprovalRiskAxes, AskDecisionAck, AskDecisionBody, } from '@sema-agent/sdk';

package/dist/seam.d.ts

@@ -533,7 +533,7 @@ export type ChromeEvent = {
  * ⚠️ **只有 live 腿有本帧**(server 7.69.0 亲读:durable/bg 腿把它喂给 rewind 锚而不入账本)
  * ⇒ replay/resume 上映射表是空的;那时正解是**不画分割线**,不是回退成「画在最后一条」。
  */
- | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent
+ | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent
 /**
  * B-078 / L-208(0.65.0):design/172 流内审批协议的**两条帧**。修前它们在标准管线上落
  * `dropped('unsupported_arm')`,壳自己另接一份 ⇒ 只走包管线的宿主(desktop/web)拿不到
@@ -707,6 +707,52 @@ export interface TextSegmentEndChromeEvent {
     /** core 铸的事件身份(uuidv7 形);wire 未必带 ⇒ 缺席时本键不在场。 */
     eventId?: string;
 }
+/**
+ * {@link ChromeEvent} 的 `thinking_segment_end` 臂(CC-02,0.68.3;server ≥7.77.0 S-310 `reasoning_end`,
+ * sdk ≥9.4.0 `SegmentEndFields` 与 `text_end` 单源)——「**引擎明报:一段推理到此为止,这是它的权威全文**」。
+ *
+ * ── 与 `text_segment_end` 同一句消费律(sdk 顶注逐字:一个 wire 概念一份形,读法只学一次)────────
+ * `reasoning_delta` 逐 chunk 脱敏对**跨 chunk** 的凭据形无能为力,只有整段看得见 ⇒ `content` 是经与
+ * `text_end` / `result` **同一只**脱敏器的段权威全文,**可以**与活体增量的拼接不相等。本包在臂上做
+ * **整段替换**(思考缓冲 + 活体尾巴),三个 additive 键与 `text_segment_end` **同名同律**(never-false)。
+ *
+ * ── 与散文段的一处结构差(读这一条再接)──────────────────────────────────────────────────────
+ * 思考块**没有 idle-flush**:本包只在三处正常边界提交它(思考→回答边界 / 工具卡前 / turn 收口),
+ * 提交是**整块**的 ⇒ 「已提交前缀」在思考面上是**全有或全无**:`committedPrefixDiverged` 在场时,
+ * `committedPrefixLen` 恒 = 那条已 committed 思考行的全文长度,而且本臂**多带一把钥匙**
+ * {@link ThinkingSegmentEndChromeEvent.committedUuid}(那条行的 `uuid`,本包铸的)—— 思考行**不盖**
+ * `_sema_segment_id`(CC-01 只盖文本行,刻意),宿主认行用这把 uuid 就够了(整块换,不切片)。
+ *
+ * ── 🔴 宿主消费义务(与 `text_segment_end` 逐条同形)─────────────────────────────────────────
+ *  ① `diverged` 在场 ⇒ **自己拼 `stream_delta{channel:'thinking'}` 上屏**的端按 `content` 重渲该块;
+ *     只渲 transcript 平面的端零改动(包已把权威全文换进思考缓冲,下一次提交交的就是它)。
+ *  ② `committedPrefixDiverged` 在场 ⇒ **所有端都要做**:那条已 committed 的思考行(`uuid === committedUuid`)
+ *     是过期的,整块换成 `content`;本包在这一形上**一个字节都不再交**(再交一条 = 同一段推理上屏两遍)。
+ *  ③ 三键全缺席 ⇒ 照旧只当对账/定界,拿 `content` 再渲一行 = 同一段上屏两遍。
+ *  ④ 缺席 ≠ 段没结束:只有会报块结束的引擎才发它;按整条流判有没有边界帧。
+ */
+export interface ThinkingSegmentEndChromeEvent {
+    kind: 'thinking_segment_end';
+    laneProof: LaneProof;
+    /** 该段推理的**权威全文**(server ≥7.77.0 经脱敏器;可以与活体增量拼接不相等)。读法见义务 ①③。 */
+    content: string;
+    /** 活体面那份过期了(never false)。 */
+    diverged?: true;
+    /** 已 committed 的那条思考行过期了(never false)⇒ 整块换,本包不再交字节。 */
+    committedPrefixDiverged?: true;
+    /** 已 committed 思考行的全文长度(UTF-16 代码单元;never 0)—— 思考面上恒 = 整块。 */
+    committedPrefixLen?: number;
+    /** 有已提交思考行时在场:**末条**行的 `uuid`(0.69.0 兼容位;整段归属看 {@link committedUuids})。 */
+    committedUuid?: string;
+    /**
+     * CC-11(0.69.1):有已提交思考行时在场 —— 段内**全部**已提交行的 `uuid`,按提交序(一段推理跨工具卡时多条)。
+     * 🔴 `committedPrefixDiverged` 在场 ⇒ 宿主把这些行**全部删掉**、在首行位置放一条 `content`(整段换,不切片);
+     *    缺席(`committedPrefixDiverged` 缺席)⇒ 这些行照旧,本包只换了还押着的后段(或零字节)。
+     */
+    committedUuids?: readonly string[];
+    /** core 铸的事件身份(uuidv7 形);wire 未必带 ⇒ 缺席时本键不在场。 */
+    eventId?: string;
+}
 /**
  * {@link ChromeEvent} 的 `approval_request` 臂(B-078 / L-208,0.65.0;design/172 流内审批协议,
  * server ≥7.3.0、7.5.0 起默认开)——「**引擎在这条流上呈了一张审批卡**」。