@sema-agent/client-core 0.76.1 → 0.77.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.76.1",
+  "version": "0.77.0",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",

package/dist/mcpProbeCapability.d.ts

@@ -1,84 +0,0 @@
-/**
- * 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

@@ -1,124 +0,0 @@
-/**
- * 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();
-}