@sema-agent/client-core 0.75.1 → 0.76.1

package/dist/mcpProbeCapability.d.ts

@@ -0,0 +1,84 @@
+/**
+ * mcpProbeCapability — `GET /v1/capabilities.mcpProbe` 的三端共用读面(0.76.1 CC-74;能力位读器第七只,
+ * 与 sql / writeProtection / webSearch.backend / executionLane / approvalsStreamLive / deviceExecutor.management
+ * 六只兄弟同一套词汇、同一份四口实现 {@link import("./engineCapReader.js").createEngineCapReader})。
+ * sdk 9.8.1 对该位**无型** ⇒ 按契约结构读(与 device 那一位 0.74.2 同路);sdk 出键当天由能力位台账门逼一次显式处置。
+ *
+ * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
+ * 「这台引擎上**能不能发 MCP 探测请求**」(`POST /v1/capabilities/mcp/probe`)。位为 `true` ⇔ 引擎认这次注入
+ * (**单用户姿态 ∧ MCP 车道 wired**,两条合取,与探测口 200 / 501 的谓词同一个表达式);位为 `false` ⇔ 两条里
+ * 缺任一条(多租户部署,**或**单用户但车道没 wired)⇒ 探测口回 `501 {@link MCP_INJECTION_REQUIRED_CODE}`。
+ * 🔴 **`false` 不许读成「多租户」**:「单用户但车道未 wired」是同样合法的一种部署,wire 上两者不可分 ⇒
+ *    措辞与判据都只说「探测口在这台引擎上不可用」,不替引擎推因由。
+ * ⚠️ 本位只说**探测口在不在**。`GET /v1/capabilities/mcp` 详情卡的实际响应由调用那一刻决定,不从本位推 ——
+ *    本仓没有任何证据支持「本位缺席 ⇒ 详情卡 404」这类蕴含,编一条出来就是替 server 许一个它没许的诺。
+ *
+ * ── 🔴 读法(四态,不是两态)─────────────────────────────────────────────────────────────────
+ *  ① `unobserved`   —— 这一格**没有可用读数**:本进程一次 caps 响应都没观测到(一次性诊断命令就是这一档)、
+ *     或最后一次回体**读不懂**被删格、或引擎温切后 {@link forgetMcpProbeReading} 清过。三条路同落这一档,
+ *     它们的共同点正是这句话本身 —— 不是「探测口不在」。
+ *  ② `not_reported` —— caps 观测到了,而回体上**没有** `mcpProbe` 这个键 ⇒ 老 server。🔴 **不折 `false`**:
+ *     折了就是替一台没说话的引擎断言「探测口不在」,而正确的下一步是**按 501 试探**。
+ *  ③ `absent`       —— 引擎**明确说** `false`。这是一个**正面事实**(明确的否),不是缺席。
+ *  ④ `present`      —— 引擎**明确说** `true`:探测口可用。
+ *  严格布尔:`null` / 串 / 数(含 `0` / `1`)/ 数组 / 对象 ⇒ 畸形(删格 ⇒ `unobserved`),🔴 **绝不折 `absent`** ——
+ *  一份读不懂的回体和一句「不可用」是两件事。判在场用 `hasOwn`(与 device 那一位同形):原型链上的同名键
+ *  不是这台引擎说的话。
+ *  「探测口能不能用」的判据归包:{@link mcpProbeAvailable} —— 只有 `present` 才 `'yes'`;`absent` ⇒ `'no'`;
+ *  其余 ⇒ `'unknown'`(端按 501 试探,不预判)。
+ */
+/**
+ * 探测口在这台引擎上不可用时的 501 错误码(逐字)。
+ *
+ * 🔴 它与本位的 `absent` 是**同一件事的两面**(同一个谓词):端读到 `absent` 就不必发那一发请求,
+ *    读到 `unknown` 就发出去、按这个码兜。消费点按**恰等**判,绝不放宽成 `capability.` 前缀
+ *    (`capability.*` 是开集,别的成员处置不同)。
+ */
+export declare const MCP_INJECTION_REQUIRED_CODE = "capability.mcp_injection_required";
+/** 四态读数(见文件头)。`unobserved` 由**读口**在这一格空缺时铸,不由投影铸。 */
+export type McpProbeReading = {
+    kind: 'unobserved';
+} | {
+    kind: 'not_reported';
+} | {
+    kind: 'absent';
+} | {
+    kind: 'present';
+};
+/**
+ * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
+ *
+ * 🔴 键缺席(`hasOwn` 为假,或显式 `undefined`)⇒ `not_reported`;`false` ⇒ `absent`;`true` ⇒ `present`;
+ *    其余一切值 ⇒ `undefined`。三条路互不折叠。
+ * 🔴 值**只读一次**(校验与分臂同一次读):变化的 getter 会让校验读到布尔、分臂读到别的东西。
+ */
+export declare function projectMcpProbeCapability(caps: unknown): McpProbeReading | undefined;
+/**
+ * 宿主 caps probe 的**读面 tee** 落点(与六只兄弟并列)。绝不 throw —— 读面腿不许反噬 caps 探测链。
+ * 投影 `undefined`(畸形)或投影抛出 ⇒ 这一格**被删**,不留上一台引擎的旧读数;`opts.generation` 关掉
+ * 「旧探测覆盖新读数」那条竞态(宿主在起探测那一刻 `engineCapsGeneration(baseUrl)` 抓号、在这里原样交回;
+ * 不传 ⇒ 与本位到货之前逐字节同行为)。
+ */
+export declare function noteEngineCapsForMcpProbe(baseUrl: string, caps: unknown, opts?: {
+    generation?: number;
+}): void;
+/** 本进程观测到的探测口姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `absent`)。 */
+export declare function observedMcpProbe(baseUrl?: string | undefined): McpProbeReading;
+/**
+ * 「MCP 探测口能不能用」的判据单源(三态):只有引擎明说在场(`present`)才 `'yes'`;明说不在(`absent`)⇒ `'no'`;
+ * 老 server / 从没观测 ⇒ `'unknown'`(端**按 501 试探,不预判** —— 把 unknown 当 no 会藏掉一台真能探测的引擎)。
+ */
+export declare function mcpProbeAvailable(reading: McpProbeReading): 'yes' | 'no' | 'unknown';
+/**
+ * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;端只拼接不另写)。
+ * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」两种「读不出」都**不等于**「探测口不在」;
+ *    `absent` 那一句既要说不可用、又**不许**推因由(多租户 / 车道未 wired wire 上不可分)。
+ */
+export declare function mcpProbeDoctorDetail(reading: McpProbeReading): string;
+/**
+ * **换代失效口**(与六只兄弟的同名口并列,由宿主在引擎温切成功后调):清成未观测,不是留旧值也不是铸一个
+ * `absent`。空串 / `undefined` ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
+ */
+export declare function forgetMcpProbeReading(baseUrl: string | undefined): void;
+/** 测试钩子(只清本只读器的读账:不动装好的 wire 读锚、不动 caps 缓存的代际号、不动别只读器的表)。 */
+export declare function __resetMcpProbeReadingsForTests(): void;

package/dist/mcpProbeCapability.js

@@ -0,0 +1,124 @@
+/**
+ * mcpProbeCapability — `GET /v1/capabilities.mcpProbe` 的三端共用读面(0.76.1 CC-74;能力位读器第七只,
+ * 与 sql / writeProtection / webSearch.backend / executionLane / approvalsStreamLive / deviceExecutor.management
+ * 六只兄弟同一套词汇、同一份四口实现 {@link import("./engineCapReader.js").createEngineCapReader})。
+ * sdk 9.8.1 对该位**无型** ⇒ 按契约结构读(与 device 那一位 0.74.2 同路);sdk 出键当天由能力位台账门逼一次显式处置。
+ *
+ * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
+ * 「这台引擎上**能不能发 MCP 探测请求**」(`POST /v1/capabilities/mcp/probe`)。位为 `true` ⇔ 引擎认这次注入
+ * (**单用户姿态 ∧ MCP 车道 wired**,两条合取,与探测口 200 / 501 的谓词同一个表达式);位为 `false` ⇔ 两条里
+ * 缺任一条(多租户部署,**或**单用户但车道没 wired)⇒ 探测口回 `501 {@link MCP_INJECTION_REQUIRED_CODE}`。
+ * 🔴 **`false` 不许读成「多租户」**:「单用户但车道未 wired」是同样合法的一种部署,wire 上两者不可分 ⇒
+ *    措辞与判据都只说「探测口在这台引擎上不可用」,不替引擎推因由。
+ * ⚠️ 本位只说**探测口在不在**。`GET /v1/capabilities/mcp` 详情卡的实际响应由调用那一刻决定,不从本位推 ——
+ *    本仓没有任何证据支持「本位缺席 ⇒ 详情卡 404」这类蕴含,编一条出来就是替 server 许一个它没许的诺。
+ *
+ * ── 🔴 读法(四态,不是两态)─────────────────────────────────────────────────────────────────
+ *  ① `unobserved`   —— 这一格**没有可用读数**:本进程一次 caps 响应都没观测到(一次性诊断命令就是这一档)、
+ *     或最后一次回体**读不懂**被删格、或引擎温切后 {@link forgetMcpProbeReading} 清过。三条路同落这一档,
+ *     它们的共同点正是这句话本身 —— 不是「探测口不在」。
+ *  ② `not_reported` —— caps 观测到了,而回体上**没有** `mcpProbe` 这个键 ⇒ 老 server。🔴 **不折 `false`**:
+ *     折了就是替一台没说话的引擎断言「探测口不在」,而正确的下一步是**按 501 试探**。
+ *  ③ `absent`       —— 引擎**明确说** `false`。这是一个**正面事实**(明确的否),不是缺席。
+ *  ④ `present`      —— 引擎**明确说** `true`:探测口可用。
+ *  严格布尔:`null` / 串 / 数(含 `0` / `1`)/ 数组 / 对象 ⇒ 畸形(删格 ⇒ `unobserved`),🔴 **绝不折 `absent`** ——
+ *  一份读不懂的回体和一句「不可用」是两件事。判在场用 `hasOwn`(与 device 那一位同形):原型链上的同名键
+ *  不是这台引擎说的话。
+ *  「探测口能不能用」的判据归包:{@link mcpProbeAvailable} —— 只有 `present` 才 `'yes'`;`absent` ⇒ `'no'`;
+ *  其余 ⇒ `'unknown'`(端按 501 试探,不预判)。
+ */
+import { engineWireTarget } from './engineWireTarget.js';
+import { createEngineCapReader } from './engineCapReader.js';
+/**
+ * 探测口在这台引擎上不可用时的 501 错误码(逐字)。
+ *
+ * 🔴 它与本位的 `absent` 是**同一件事的两面**(同一个谓词):端读到 `absent` 就不必发那一发请求,
+ *    读到 `unknown` 就发出去、按这个码兜。消费点按**恰等**判,绝不放宽成 `capability.` 前缀
+ *    (`capability.*` 是开集,别的成员处置不同)。
+ */
+export const MCP_INJECTION_REQUIRED_CODE = 'capability.mcp_injection_required';
+/**
+ * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
+ *
+ * 🔴 键缺席(`hasOwn` 为假,或显式 `undefined`)⇒ `not_reported`;`false` ⇒ `absent`;`true` ⇒ `present`;
+ *    其余一切值 ⇒ `undefined`。三条路互不折叠。
+ * 🔴 值**只读一次**(校验与分臂同一次读):变化的 getter 会让校验读到布尔、分臂读到别的东西。
+ */
+export function projectMcpProbeCapability(caps) {
+    if (caps === null || typeof caps !== 'object')
+        return undefined;
+    const c = caps;
+    if (!Object.hasOwn(c, 'mcpProbe'))
+        return { kind: 'not_reported' };
+    const v = c.mcpProbe;
+    if (v === undefined)
+        return { kind: 'not_reported' };
+    if (typeof v !== 'boolean')
+        return undefined;
+    return v ? { kind: 'present' } : { kind: 'absent' };
+}
+/**
+ * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 七只能力位读器**共用同一份实现**
+ * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数 {@link projectMcpProbeCapability}、doctor 措辞表,以及本位自己的判据助手(如有)。
+ * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面。
+ */
+const reader = createEngineCapReader({
+    name: 'mcpProbe',
+    project: projectMcpProbeCapability,
+    makeUnobserved: () => ({ kind: 'unobserved' }),
+});
+/**
+ * 宿主 caps probe 的**读面 tee** 落点(与六只兄弟并列)。绝不 throw —— 读面腿不许反噬 caps 探测链。
+ * 投影 `undefined`(畸形)或投影抛出 ⇒ 这一格**被删**,不留上一台引擎的旧读数;`opts.generation` 关掉
+ * 「旧探测覆盖新读数」那条竞态(宿主在起探测那一刻 `engineCapsGeneration(baseUrl)` 抓号、在这里原样交回;
+ * 不传 ⇒ 与本位到货之前逐字节同行为)。
+ */
+export function noteEngineCapsForMcpProbe(baseUrl, caps, opts) {
+    reader.note(baseUrl, caps, opts);
+}
+/** 本进程观测到的探测口姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `absent`)。 */
+export function observedMcpProbe(baseUrl = engineWireTarget()?.baseUrl) {
+    return reader.observed(baseUrl);
+}
+/**
+ * 「MCP 探测口能不能用」的判据单源(三态):只有引擎明说在场(`present`)才 `'yes'`;明说不在(`absent`)⇒ `'no'`;
+ * 老 server / 从没观测 ⇒ `'unknown'`(端**按 501 试探,不预判** —— 把 unknown 当 no 会藏掉一台真能探测的引擎)。
+ */
+export function mcpProbeAvailable(reading) {
+    if (reading.kind === 'present')
+        return 'yes';
+    if (reading.kind === 'absent')
+        return 'no';
+    return 'unknown';
+}
+/**
+ * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;端只拼接不另写)。
+ * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」两种「读不出」都**不等于**「探测口不在」;
+ *    `absent` 那一句既要说不可用、又**不许**推因由(多租户 / 车道未 wired wire 上不可分)。
+ */
+export function mcpProbeDoctorDetail(reading) {
+    switch (reading.kind) {
+        case 'unobserved':
+            return ('MCP probe face not observed — the engine reports it on /v1/capabilities (mcpProbe); ' +
+                'this process has no usable capabilities reading cached for it (none received, or the last one was unreadable)');
+        case 'not_reported':
+            return ('MCP probe face not reported by this engine — only newer engines advertise it; ' +
+                'this does not say whether the probe endpoint exists, so probe it directly');
+        case 'absent':
+            return ('MCP probe face off on this deployment — the engine refuses injected MCP servers on this lane ' +
+                `(either a multi-tenant posture or an unwired MCP lane; the wire does not say which), so the probe endpoint is unavailable and answers 501 ${MCP_INJECTION_REQUIRED_CODE}`);
+        case 'present':
+            return 'MCP probe face on — the MCP probe endpoint is available on this engine';
+    }
+}
+/**
+ * **换代失效口**(与六只兄弟的同名口并列,由宿主在引擎温切成功后调):清成未观测,不是留旧值也不是铸一个
+ * `absent`。空串 / `undefined` ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
+ */
+export function forgetMcpProbeReading(baseUrl) {
+    reader.forget(baseUrl);
+}
+/** 测试钩子(只清本只读器的读账:不动装好的 wire 读锚、不动 caps 缓存的代际号、不动别只读器的表)。 */
+export function __resetMcpProbeReadingsForTests() {
+    reader.__resetForTests();
+}

package/dist/memoryComplianceCapability.d.ts

@@ -0,0 +1,73 @@
+/**
+ * memoryComplianceCapability — `GET /v1/capabilities.memoryCompliance` 的三端共用读面(0.76.1 CC-97a;
+ * 与 sql / writeProtection / webSearch.backend / executionLane / approvalsStreamLive /
+ * deviceExecutor.management 诸只兄弟同一套四态词汇,四口走共用工厂 {@link createEngineCapReader})。
+ *
+ * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
+ * 「**出处问询 / 抹除**两口(`GET /v1/memory/entries/:entryId/provenance` ·
+ * `POST /v1/memory/erase`,operator 车道)在这台引擎上在不在」。引擎侧的谓词是**两项合取**:
+ *  ① 合规面挂上了 —— 挂载期判后端自带引擎控制面归属,缺则整口不挂;
+ *  ② 这台部署的 operator 名单**非空** —— 空名单下两口对任何身份恒 403。
+ * ⚠️ 位为真**只**保证「门能过 + 面在场」,**不**保证这一次调用成功:控制面账本损坏是**运行期**事实
+ *    (typed 500),引擎刻意不把它编进部署级布尔。
+ * ⚠️ 与「治理携出 bundle」那一位**不同源**:两位的第一项查的是后端的**不同面**,一个部署可以有 bundle
+ *    复合面而没有控制面归属,反之亦然 —— 任一侧都不许拿来替另一侧作答(合成一位会对其中一半撒谎)。
+ * ⚠️ 与 `memoryOrigin`(外源标记人面三口)**同判据不同位**:两族今天查后端的同一个面,但它们是**两个
+ *    产品面**,一个部署可以只开其中一族。引擎刻意不合并,即使今天两位恒同值 ⇒ **本包也不合并**:
+ *    两只读器各持一张 per-baseUrl 表,一只收到读不懂的回体只删自己那一格
+ *    ({@link observedMemoryOrigin} 的读数一字不变)。
+ *
+ * ── 🔴 读法 ─────────────────────────────────────────────────────────────────────────────────
+ *  ① 引擎铸这一位时**恒在场**(一格布尔,不是条件在场)⇒ **键缺席 = 老引擎根本不报这一位** ⇒
+ *     `not_reported`(判不出)。折成 `false` 就是替引擎断言「这台没有合规面」。
+ *  ② `false` 是**明确的否** ⇒ `absent`。wire 上分不出「后端没有控制面归属」与「operator 名单为空」
+ *     两种成因(引擎的谓词是合取,回体只有一格布尔)⇒ 措辞**不推因由**。
+ *  ③ 严格布尔;`null` / 串 / `0` / `1` / 数组 / 对象一律畸形 ⇒ 删格 ⇒ `unobserved`,🔴 绝不折 `absent`
+ *     (读不懂与「明确的否」是两回事)。
+ *  ③b caps 回体本身不是对象(`null` / 数组 / 串 / 数)⇒ 畸形删格,**不是** `not_reported`(那一态只说「这是
+ *      一份 caps,但没有这一格」)。
+ *  ④ 判在场用 `hasOwn`:原型链上的同名键永远不会被序列化上 wire,把它读成在场就是凭空造一格读数。
+ *  ⑤ 「两口能不能用」的判据归包:{@link memoryComplianceVerbsAvailable} —— 只有 `present` 才 `'yes'`,
+ *     `absent` ⇒ `'no'`(明确的否),其余 ⇒ `'unknown'`(端按 501 试探,不预判)。
+ */
+/**
+ * 记忆治理面缺席时两族(合规两口 / 外源三口)共用的 501 码 —— **本包唯一铸点**,
+ * {@link memoryComplianceDoctorDetail} 与 {@link import('./memoryOriginCapability.js')} 的措辞表都取这一个常量,
+ * 两处不许各写一遍字面(码字面漂移时只有一处要改)。
+ */
+export declare const MEMORY_ENGINE_REQUIRED_CODE = "capability.memory_engine_required";
+/** 四态读数。`unobserved` 由读口在这一格空缺时铸,不由投影铸。 */
+export type MemoryComplianceReading = {
+    kind: 'unobserved';
+}
+/** 键缺席:老引擎不报这一位 ⇒ 判不出(**不是** `absent`)。 */
+ | {
+    kind: 'not_reported';
+}
+/** 位在场且为 `false`:这台部署上两口用不了(成因在 wire 上不可分)。 */
+ | {
+    kind: 'absent';
+}
+/** 位在场且为 `true`:门能过 + 面在场(不承诺这一次调用成功)。 */
+ | {
+    kind: 'present';
+};
+/** caps 回体 → 本格读数;畸形一律 `undefined`(= 这一格不写 ⇒ 读口答 `unobserved`)。 */
+export declare function projectMemoryComplianceCapability(caps: unknown): MemoryComplianceReading | undefined;
+/** 宿主 caps probe 的读面 tee 落点(与诸只兄弟并列)。绝不 throw;畸形 ⇒ 删格;`opts.generation` 关掉旧探测覆盖新读数的竞态。 */
+export declare function noteEngineCapsForMemoryCompliance(baseUrl: string, caps: unknown, opts?: {
+    generation?: number;
+}): void;
+/** 本进程观测到的读数;这一格空缺 ⇒ `{kind:'unobserved'}`。 */
+export declare function observedMemoryCompliance(baseUrl?: string | undefined): MemoryComplianceReading;
+/**
+ * 「出处问询 / 抹除两口能不能用」的判据单源(三态):只有引擎明说在场才 `'yes'`;明说不在 ⇒ `'no'`;
+ * 老引擎不报 / 从没观测 ⇒ `'unknown'`(端按 501 试探,不预判,也不预先藏掉入口)。
+ */
+export declare function memoryComplianceVerbsAvailable(reading: MemoryComplianceReading): 'yes' | 'no' | 'unknown';
+/** doctor 那一行的 detail 串,唯一措辞真源。🔴 两种「读不出」的句子都不许暗示「这台没有合规面」。 */
+export declare function memoryComplianceDoctorDetail(reading: MemoryComplianceReading): string;
+/** 换代失效口(引擎温切成功后调):清成未观测。空串 ⇒ no-op;绝不 throw。 */
+export declare function forgetMemoryComplianceReading(baseUrl: string | undefined): void;
+/** 测试钩子。 */
+export declare function __resetMemoryComplianceReadingsForTests(): void;

package/dist/memoryComplianceCapability.js

@@ -0,0 +1,109 @@
+/**
+ * memoryComplianceCapability — `GET /v1/capabilities.memoryCompliance` 的三端共用读面(0.76.1 CC-97a;
+ * 与 sql / writeProtection / webSearch.backend / executionLane / approvalsStreamLive /
+ * deviceExecutor.management 诸只兄弟同一套四态词汇,四口走共用工厂 {@link createEngineCapReader})。
+ *
+ * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
+ * 「**出处问询 / 抹除**两口(`GET /v1/memory/entries/:entryId/provenance` ·
+ * `POST /v1/memory/erase`,operator 车道)在这台引擎上在不在」。引擎侧的谓词是**两项合取**:
+ *  ① 合规面挂上了 —— 挂载期判后端自带引擎控制面归属,缺则整口不挂;
+ *  ② 这台部署的 operator 名单**非空** —— 空名单下两口对任何身份恒 403。
+ * ⚠️ 位为真**只**保证「门能过 + 面在场」,**不**保证这一次调用成功:控制面账本损坏是**运行期**事实
+ *    (typed 500),引擎刻意不把它编进部署级布尔。
+ * ⚠️ 与「治理携出 bundle」那一位**不同源**:两位的第一项查的是后端的**不同面**,一个部署可以有 bundle
+ *    复合面而没有控制面归属,反之亦然 —— 任一侧都不许拿来替另一侧作答(合成一位会对其中一半撒谎)。
+ * ⚠️ 与 `memoryOrigin`(外源标记人面三口)**同判据不同位**:两族今天查后端的同一个面,但它们是**两个
+ *    产品面**,一个部署可以只开其中一族。引擎刻意不合并,即使今天两位恒同值 ⇒ **本包也不合并**:
+ *    两只读器各持一张 per-baseUrl 表,一只收到读不懂的回体只删自己那一格
+ *    ({@link observedMemoryOrigin} 的读数一字不变)。
+ *
+ * ── 🔴 读法 ─────────────────────────────────────────────────────────────────────────────────
+ *  ① 引擎铸这一位时**恒在场**(一格布尔,不是条件在场)⇒ **键缺席 = 老引擎根本不报这一位** ⇒
+ *     `not_reported`(判不出)。折成 `false` 就是替引擎断言「这台没有合规面」。
+ *  ② `false` 是**明确的否** ⇒ `absent`。wire 上分不出「后端没有控制面归属」与「operator 名单为空」
+ *     两种成因(引擎的谓词是合取,回体只有一格布尔)⇒ 措辞**不推因由**。
+ *  ③ 严格布尔;`null` / 串 / `0` / `1` / 数组 / 对象一律畸形 ⇒ 删格 ⇒ `unobserved`,🔴 绝不折 `absent`
+ *     (读不懂与「明确的否」是两回事)。
+ *  ③b caps 回体本身不是对象(`null` / 数组 / 串 / 数)⇒ 畸形删格,**不是** `not_reported`(那一态只说「这是
+ *      一份 caps,但没有这一格」)。
+ *  ④ 判在场用 `hasOwn`:原型链上的同名键永远不会被序列化上 wire,把它读成在场就是凭空造一格读数。
+ *  ⑤ 「两口能不能用」的判据归包:{@link memoryComplianceVerbsAvailable} —— 只有 `present` 才 `'yes'`,
+ *     `absent` ⇒ `'no'`(明确的否),其余 ⇒ `'unknown'`(端按 501 试探,不预判)。
+ */
+import { engineWireTarget } from './engineWireTarget.js';
+import { createEngineCapReader } from './engineCapReader.js';
+/**
+ * 记忆治理面缺席时两族(合规两口 / 外源三口)共用的 501 码 —— **本包唯一铸点**,
+ * {@link memoryComplianceDoctorDetail} 与 {@link import('./memoryOriginCapability.js')} 的措辞表都取这一个常量,
+ * 两处不许各写一遍字面(码字面漂移时只有一处要改)。
+ */
+export const MEMORY_ENGINE_REQUIRED_CODE = 'capability.memory_engine_required';
+/** caps 回体 → 本格读数;畸形一律 `undefined`(= 这一格不写 ⇒ 读口答 `unobserved`)。 */
+export function projectMemoryComplianceCapability(caps) {
+    // 🔴 数组也是畸形:一个数组回体**不是**引擎对 caps 的回答,从它上面读出「老引擎不报这一位」是替引擎
+    //    编了一句它没说的话。`not_reported` 只留给**真的是 caps 对象、但这一格不在**那一形。
+    if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
+        return undefined;
+    const c = caps;
+    if (!Object.hasOwn(c, 'memoryCompliance'))
+        return { kind: 'not_reported' };
+    // 🔴 只读一次:校验与分臂若各读一次,变化的 getter 能让校验读到布尔、分臂读到别的东西。
+    const v = c.memoryCompliance;
+    if (v === undefined)
+        return { kind: 'not_reported' };
+    if (typeof v !== 'boolean')
+        return undefined;
+    return v ? { kind: 'present' } : { kind: 'absent' };
+}
+/**
+ * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 能力位读器**共用同一份实现**
+ * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数
+ * {@link projectMemoryComplianceCapability}、doctor 措辞表与本位的判据助手。
+ * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面
+ * (尤其不连坐同判据的 `memoryOrigin`)。
+ */
+const reader = createEngineCapReader({
+    name: 'memoryCompliance',
+    project: projectMemoryComplianceCapability,
+    makeUnobserved: () => ({ kind: 'unobserved' }),
+});
+/** 宿主 caps probe 的读面 tee 落点(与诸只兄弟并列)。绝不 throw;畸形 ⇒ 删格;`opts.generation` 关掉旧探测覆盖新读数的竞态。 */
+export function noteEngineCapsForMemoryCompliance(baseUrl, caps, opts) {
+    reader.note(baseUrl, caps, opts);
+}
+/** 本进程观测到的读数;这一格空缺 ⇒ `{kind:'unobserved'}`。 */
+export function observedMemoryCompliance(baseUrl = engineWireTarget()?.baseUrl) {
+    return reader.observed(baseUrl);
+}
+/**
+ * 「出处问询 / 抹除两口能不能用」的判据单源(三态):只有引擎明说在场才 `'yes'`;明说不在 ⇒ `'no'`;
+ * 老引擎不报 / 从没观测 ⇒ `'unknown'`(端按 501 试探,不预判,也不预先藏掉入口)。
+ */
+export function memoryComplianceVerbsAvailable(reading) {
+    if (reading.kind === 'present')
+        return 'yes';
+    if (reading.kind === 'absent')
+        return 'no';
+    return 'unknown';
+}
+/** doctor 那一行的 detail 串,唯一措辞真源。🔴 两种「读不出」的句子都不许暗示「这台没有合规面」。 */
+export function memoryComplianceDoctorDetail(reading) {
+    switch (reading.kind) {
+        case 'unobserved':
+            return 'memory compliance face not observed — the engine reports it on /v1/capabilities (memoryCompliance); this process has no usable capabilities reading cached for it (none received, or the last one was unreadable)';
+        case 'not_reported':
+            return 'memory compliance face not reported by this engine — only newer engines advertise it; this does not say whether the provenance and erasure endpoints exist, probe them directly';
+        case 'absent':
+            return `memory compliance face off on this deployment — the entry-provenance and erasure endpoints are unavailable (${MEMORY_ENGINE_REQUIRED_CODE}); the engine does not say which half is missing (a memory backend that does not own the engine control plane, or an empty operator roster), so do not guess`;
+        case 'present':
+            return 'memory compliance face on — the entry-provenance and erasure endpoints are mounted and the operator roster is non-empty on this engine; this says the door opens, not that any one call succeeds (a damaged control-plane ledger is a runtime fact and arrives as a typed 500)';
+    }
+}
+/** 换代失效口(引擎温切成功后调):清成未观测。空串 ⇒ no-op;绝不 throw。 */
+export function forgetMemoryComplianceReading(baseUrl) {
+    reader.forget(baseUrl);
+}
+/** 测试钩子。 */
+export function __resetMemoryComplianceReadingsForTests() {
+    reader.__resetForTests();
+}