@sema-agent/client-core 0.68.1 → 0.69.0

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/engineHttpTools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * src/engineHttpTools.ts — SDK **纯工具面**的转口口(L-61 / L-318 件④,0.68.2)。
+ *
+ * ── 病形(为什么要有这一只)──────────────────────────────────────────────────────────────────
+ * 端对引擎 wire 的一切消费必须经本包(sdk-isolation 门公约),而 SDK 里有两件**纯工具**至今没有
+ * 经本包的路:
+ *   · `engineUrl(baseUrl, path)` —— 「URL 去尾斜杠 + 拼路径」的语义单真源(端自己拼字符串就会
+ *     在 `//v1/...` 这类形上各错各的);
+ *   · `probeHealth(baseUrl, timeoutMs?, fetchImpl?)` —— 引擎存活探针的单真源。
+ * 于是 cli 有 5 个产品文件**直连** `@sema-agent/sdk` 只为取这两件(sdk-isolation 存量册
+ * `sdk-value` 桶里那几条,`_retirement` 段逐字:「多数只取 engineUrl builder 一件」),web /
+ * desktop 接同一条腿时会再各直连一次。
+ *
+ * ── 为什么这一只可以做**值级**转口(与 core 判官那一只的分界)──────────────────────────────
+ * 可移植门(`run-client-core-portability-test.mjs`)对包总入口做两件事:外部包**等值集**
+ * `EXPECTED_PACKAGES_INDEX` + esbuild `--platform=browser` 真打一次包。
+ *   · `@sema-agent/sdk` **本来就在**那个等值集里(本包已有 5 处值级 SDK import)⇒ 加这一只
+ *     不改集合,只让闭包文件数 +1(棘轮按既有姿势逐件记账,见该门 `MAX_CLOSURE_FILES_INDEX` 头注);
+ *   · SDK 的 `dist/health.js` **零 import**(实测:整文件一条 `import`/`require` 都没有,传输走
+ *     全局 `fetch` = web 标准,不是 Node 内建)⇒ 浏览器打包面零风险。
+ * 🔴 对照:`@sema-agent/core` 的同类件**不能**这么做(`hitl/editedRuleTextPrecheck.ts` 头注逐字:
+ *    core 的 barrel 值级拉 `node:crypto`/`node:fs`/`node:path`,一条这样的边会把整台引擎焊进
+ *    web/desktop 的产物)—— 那一族走**端口注入**形。两者的分界线是「这个外部包在不在等值集里」,
+ *    不是「它是不是纯函数」。
+ *
+ * 🔴 **原样转口,一个字节都不加工**:本模块不包装、不改签名、不补默认值 —— 包一层就是把「同一
+ *    函数体」这条唯一的抗漂移保证亲手拆掉(与 `editedRuleTextPrecheck` 的装口纪律同一条)。
+ *    要在这两件之上加判定的那天,新开一个具名模块,别往转口口里塞。
+ */
+export { engineUrl, probeHealth } from '@sema-agent/sdk';
+export type { ProbeHealthResult } from '@sema-agent/sdk';

package/dist/engineHttpTools.js

@@ -0,0 +1,30 @@
+/**
+ * src/engineHttpTools.ts — SDK **纯工具面**的转口口(L-61 / L-318 件④,0.68.2)。
+ *
+ * ── 病形(为什么要有这一只)──────────────────────────────────────────────────────────────────
+ * 端对引擎 wire 的一切消费必须经本包(sdk-isolation 门公约),而 SDK 里有两件**纯工具**至今没有
+ * 经本包的路:
+ *   · `engineUrl(baseUrl, path)` —— 「URL 去尾斜杠 + 拼路径」的语义单真源(端自己拼字符串就会
+ *     在 `//v1/...` 这类形上各错各的);
+ *   · `probeHealth(baseUrl, timeoutMs?, fetchImpl?)` —— 引擎存活探针的单真源。
+ * 于是 cli 有 5 个产品文件**直连** `@sema-agent/sdk` 只为取这两件(sdk-isolation 存量册
+ * `sdk-value` 桶里那几条,`_retirement` 段逐字:「多数只取 engineUrl builder 一件」),web /
+ * desktop 接同一条腿时会再各直连一次。
+ *
+ * ── 为什么这一只可以做**值级**转口(与 core 判官那一只的分界)──────────────────────────────
+ * 可移植门(`run-client-core-portability-test.mjs`)对包总入口做两件事:外部包**等值集**
+ * `EXPECTED_PACKAGES_INDEX` + esbuild `--platform=browser` 真打一次包。
+ *   · `@sema-agent/sdk` **本来就在**那个等值集里(本包已有 5 处值级 SDK import)⇒ 加这一只
+ *     不改集合,只让闭包文件数 +1(棘轮按既有姿势逐件记账,见该门 `MAX_CLOSURE_FILES_INDEX` 头注);
+ *   · SDK 的 `dist/health.js` **零 import**(实测:整文件一条 `import`/`require` 都没有,传输走
+ *     全局 `fetch` = web 标准,不是 Node 内建)⇒ 浏览器打包面零风险。
+ * 🔴 对照:`@sema-agent/core` 的同类件**不能**这么做(`hitl/editedRuleTextPrecheck.ts` 头注逐字:
+ *    core 的 barrel 值级拉 `node:crypto`/`node:fs`/`node:path`,一条这样的边会把整台引擎焊进
+ *    web/desktop 的产物)—— 那一族走**端口注入**形。两者的分界线是「这个外部包在不在等值集里」,
+ *    不是「它是不是纯函数」。
+ *
+ * 🔴 **原样转口,一个字节都不加工**:本模块不包装、不改签名、不补默认值 —— 包一层就是把「同一
+ *    函数体」这条唯一的抗漂移保证亲手拆掉(与 `editedRuleTextPrecheck` 的装口纪律同一条)。
+ *    要在这两件之上加判定的那天,新开一个具名模块,别往转口口里塞。
+ */
+export { engineUrl, probeHealth } from '@sema-agent/sdk';

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

@@ -141,6 +141,10 @@ export * from './diagnostics.js';
 export * from './retryStatus.js';
 export * from './sessionMemoryStatus.js';
 export * from './adapt.js';
+export * from './adapt/textSegmentAuthority.js';
+export * from './engineHttpTools.js';
+export * from './sdkWireTransit.js';
+export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
 export * from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
 export * from './fleetAgentPanelProjection.js';
@@ -152,6 +156,7 @@ export * from './sqlEngineCapability.js';
 export * from './writeProtectionCapability.js';
 export * from './runTerminal.js';
 export * from './readFacePosture.js';
+export * from './mcpPanel.js';
 export * from './gateOutcome.js';
 export * from './postureKnob.js';
 export * from './engineIdentity.js';
@@ -244,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

@@ -152,6 +152,24 @@ export * from './retryStatus.js';
 // 合法缺席,一律读成「没有/关着/0」就是对用户下一个证不出的断言。
 export * from './sessionMemoryStatus.js';
 export * from './adapt.js';
+// ── L-318(0.68.2):`text_end` 权威段替换的**判决单源** + print 形车道的段账状态机 ──────────
+// 修前这套六形判据有两份实现:本包 `adapt/textStream.replaceAnswerSegment`(交互车道)与 cli
+// 1.0.114 在壳里热修的 `PrintStreamProjector.onTextEnd`(`-p` 车道,B-122)。两条车道的**账本**
+// 形状不同(消息划界 vs 帧划界,差别有理由、刻意不归一),但**判决**是同一件事 ⇒ 判决进包,
+// 两条车道同吃;`-p` 车道的段账(已出门前缀累加 / 轮收口清账 / 被扣段判重)也归包,端只留
+// 「把尾段写进哪一个 CC content block」这一步装配(§8-5:stream-json 帧序/SSE 重铸属端)。
+export * from './adapt/textSegmentAuthority.js';
+// ── L-61 / L-318 件④(0.68.2):SDK **纯工具面**转口口(engineUrl / probeHealth)。端直连 SDK
+// 只为取这两件的存量(cli sdk-isolation `sdk-value` 桶)从此有「经包」的路;值级转口在可移植门
+// 上零风险的理由(SDK 已在外部包等值集里 + `dist/health.js` 零 import)写在模块头注。
+export * from './engineHttpTools.js';
+// ── L-61 存量清零(clay 令 C-R43「所有欠账绝不延期,宁可红」):SDK **wire 面**转口口 ────────
+// 客户端类 + 流内审批帧谓词 + 端上存量实际用到的那一小撮 wire 型面。**原样转口零包装**;
+// 「端该不该直接 new AgentClient」是另一个(仍然欠着的)设计问题,不该继续挡着归层 —— 理由与
+// 射程边界全在模块头注。新码一律走本包自有的 `makeEngineWireClient`,本转口口只给存量用。
+export * from './sdkWireTransit.js';
+// CC-01(0.68.2):段身份键 —— committed assistant 文本行顶层 `_sema_segment_id` 的唯一字面量出处(壳只读此常量)。
+export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
 // ── B1 批:纯函数 / 侧信道台账 / 投影闸(2026-07-27)──────────────────────────────────────────
 export * from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
@@ -173,6 +191,8 @@ export * from './runTerminal.js';
 // (防御读 / 唯一措辞铸点 / UNTRUSTED-for-display);与租户面 `capabilities.readFace` 刻意不合流,
 // 只带一个纯比较函数,渲染归端。
 export * from './readFacePosture.js';
+// CC-03(0.68.2):`GET /v1/sessions/:id/mcp` 面板体的防御读视图 + lastLegMcp 一行措辞铸点(三端共用)。
+export * from './mcpPanel.js';
 export * from './gateOutcome.js';
 // 0.63.0(sdk 8.8.0 / engine ≥7.67.0 / S-178):`serverGates` 三根 posture 旋钮的读数窄读器
 // (值 + 谁定的 + 指路句)。四词来源表在本包只有这一份,`readFacePosture` 与它共用。
@@ -413,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):决断卡链的键词汇/呈现台账/归属判据三件 ————————————