@sema-agent/client-core 0.77.1 → 0.77.2

package/dist/workflowMonitor.d.ts

@@ -1,27 +1,6 @@
-/**
- * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6):workflow 监视器的**状态契约**(MF-W ·
- *    contract/MF-W-workflow-monitor.md)从 cli `src/sema/overrides/workflow-detail-dialog.tsx:118-200`
- *    搬入 —— 逐字,一个字段都没动。
- *
- * 🔴 **为什么类型必须先过来**:`workflowClient.projectWorkflowRun()`(同批搬入)的**产物**就是这套
- *    形状。类型留在一个 `.tsx` 渲染文件里,等于「库产出的东西,它的契约住在 TUI 里」——
- *    web/桌面要消费同一份投影就得手抄一遍 shape,而手抄的那份**没有任何东西**会在它漂移时报红。
- *    定位公理([1832])说的「CC 皮肤形状全收本包」,指的正是这种东西。
- *
- * 🔴 **拆缝**:`workflow-detail-dialog.tsx` 本身是 Ink 渲染件(设计稿 §2 分类表「Ink 渲染」),
- *    **留 TUI**;搬过来的只有 ① 六个契约类型 ② `agentDisplayStatus`(WPe —— 从 wire 输入词表
- *    派生显示态的那条**纯**规则,是本契约的消费侧半场,端端都要用)。
- *    留在 TUI 的:`computeVisibleWindow`(滚动窗口数学 = 视口概念,端专属)、glyph/color 映射、
- *    以及整棵 JSX。壳侧 shim = 那个 tsx 改成从本包 re-export 这两样,自己不再定义。
- */
 import type { WorkflowParkRowView } from './workflowClient.js';
-export type AgentState = 'start' | 'progress' | 'queued' | 'done' | 'error' | 'inactive'
-/** sema 超集:这条腿耐久挂在一张审批卡上(engine core 7.10.0 #642)。见上方头注。 */
- | 'parked';
-export type DisplayStatus = 'queued' | 'running' | 'done' | 'failed' | 'skipped' | 'interrupted'
-/** sema 超集:同上。🔴 端的 glyph/颜色映射是**穷尽形**,加这一词就必须同批加一条 case
- *  (措辞按「waiting for approval」一类,别复用 running 的字与色)。 */
- | 'parked';
+export type AgentState = 'start' | 'progress' | 'queued' | 'done' | 'error' | 'inactive' | 'parked';
+export type DisplayStatus = 'queued' | 'running' | 'done' | 'failed' | 'skipped' | 'interrupted' | 'parked';
 export interface WorkflowToolCall {
     name: string;
     summary?: string;
@@ -36,40 +15,26 @@ export interface WorkflowAgent {
     remoteSessionId?: string;
     cached?: boolean;
     state: AgentState;
-    /** WPe maps state→display; `skipped` distinguishes an error that was a user-skip. */
     skipped?: boolean;
     tokens?: number;
     toolCalls?: number;
     durationMs?: number;
     queuedAt?: number;
     startedAt?: number;
-    /** ofm/C0l: `idle <t>` when running and lastProgressAt is ≥30s ago. (contract: idleSince) */
     lastProgressAt?: number;
     attempt?: number;
     lastAttemptReason?: 'throttled' | 'user-retry' | 'stalled';
     error?: string;
     agentId?: string;
-    /**
-     * #242 批 1(A-028.8):`ctx.agent` 调用的**稳定确定性身份**(resume-journal key,
-     * SDK `WorkflowAgentRow.callKey`)。运行期 activity 台账的 SSE 帧(`agent_activity`)以它为键,
-     * 而此前投影把它丢了 —— 于是 label 成了合并层唯一的钥匙,同名 agent 只能整组跳过。
-     * 投影带出它之后,重名 label 也能精确归属;缺席(老引擎/老 run)时才回落到 label。
-     */
     callKey?: string;
-    /** detail "Prompt" body; promptPreview is the fallback when no transcript is loaded. */
     promptPreview?: string;
-    /** detail "Activity" rows. */
     activity?: WorkflowToolCall[];
     lastToolName?: string;
     lastToolSummary?: string;
-    /** detail "Outcome" body for done agents (the StructuredOutput JSON / final text). */
     resultPreview?: string;
 }
 export interface WorkflowPhase {
     title: string;
-    /** 🔴 `parked` = 这一格里没有一条腿能自己往前走(全员不是完成就是停在审批门上)。见 `AgentState`
-     *  的同名头注;上游今天不给 phase 铸这个词(core:「a phase or group never parks」),本包这一位有两个
-     *  来路:①上游哪天真铸了 ⇒ 原词透出而不是折成 running;②本包从桶里的腿**推**出来。 */
     status: 'not-started' | 'running' | 'done' | 'failed' | 'parked' | 'unknown';
     doneCount: number;
     totalCount: number;
@@ -82,48 +47,13 @@ export interface WorkflowRunState {
     summary?: string;
     script: string;
     scriptPath?: string;
-    /** 🔴 `parked`(0.63.1,additive):**前向预挂** —— engine core 7.10.0 的 run 级词表仍闭在
-     *  running|completed|failed(一条腿 park ⇒ 整只 run 按 `WorkflowAgentParkedError` 收在 `failed`),
-     *  所以今天没有任何受支持的引擎在这一位上发 `parked`。留这条臂是为了「词真到了就原样透出」,
-     *  绝不是说它现在会到 —— 判「这条 run 停着等人批」今天要看**腿**那一级(见 `AgentState.parked`)。 */
-    /** 0.72.12 CC-51:`unknown`(additive)= wire 上认不出的 run 状态词;绝不再折成 running(端要渲原串请读 wire `run.status`)。 */
     status: 'running' | 'done' | 'failed' | 'stopped' | 'paused' | 'parked' | 'unknown';
     cloud?: boolean;
     agentCount: number;
-    /** 🔴 0.73.0(BREAKING):可选。有键 ⇒ 总用量(含真 0);缺键 ⇒ 没有权威总数且有腿未报(或零条腿)—— 渲「—」,不渲 0。 */
     totalTokens?: number;
-    /** phases as authored; the component derives the active/clamped windows itself. */
     phases: WorkflowPhase[];
-    /**
-     * CC-12(0.69.1;core 7.18.0 #755 / server ≥7.78.0):这条 run **负责**的 park 行(自己的 + 从被 resume 的 run 继承的),
-     * 由 `readWorkflowParks` 铸(三键行 + never-false 第四键 `originUnconfirmed`)。🔴 缺席两义(与读器同):整键缺席 =
-     * 旧引擎记录 / 读不出(证不出有没有 park);`[]` = 本引擎记录且一个 park 都没有。端渲 resume 候选时按这一位,
-     * 不再各自 `run.parks.map(...)`(修前本视图丢了它,端结构性造不出 —— cli 接入回执 ④)。
-     */
     parks?: readonly WorkflowParkRowView[];
-    /** CC-12:在场 = 这条 resume run 的准入没完成 = **不是 resume 基**(core 逐字);缺席 = 常态。never false。 */
     resumeAdmissionIncomplete?: true;
-    /** the 187 reads e.workflowProgress to recompute phases; the mock pre-builds them. */
     workflowProgress?: unknown;
 }
-/**
- * WPe — agentDisplayStatus: agent.state (+ workflowActive) → display status.
- *
- * FAITHFUL to the atlas state SET (atlas 0476_076:30-34). The atlas `WPe` reads ONLY these inputs:
- *   if(state==="done") → "done"
- *   if(state==="error") → skipped?"skipped":"failed"
- *   if(!workflowActive) → "interrupted"          // the inactive/non-active fallback
- *   else → (queuedAt!=null && startedAt==null) ? "queued" : "running"
- * The atlas runner's agent-state enum the monitor sees is {start, progress, queued, done, error,
- * inactive} — there is NO `failed`/`skipped`/`interrupted`/`stopped`/`running` INPUT state; those are
- * DISPLAY statuses derived here: `failed`/`skipped` from `error` (+ the `skipped` flag), `interrupted` from
- * `!workflowActive` (the `inactive`/non-active fallback), and `queued`/`running` from the queuedAt/startedAt
- * fields on the active path. The AgentState type carries exactly this input set, so the type contract now
- * matches the atlas vocabulary 1:1 — the branches below consume only atlas input states and the output
- * DisplayStatus set + glyph/color mapping ($jn) is identical.
- *
- * 🔴 **`parked` 是这条规则上唯一的 sema 超集臂**(0.63.1):atlas 没有它,因为 CC 的编排里没有耐久
- * 审批这一层。它**不派生**——上游直接铸这个词(engine core 7.10.0 #642 的 agent 行 `status` 与
- * `deriveAgentDisplayStatus` 产物),这里只是不许把它折掉。臂的**位置**是承重的,理由写在分支处。
- */
 export declare function agentDisplayStatus(a: WorkflowAgent, workflowActive: boolean): DisplayStatus;

package/dist/workflowMonitor.js

@@ -1,36 +1,10 @@
-/**
- * WPe — agentDisplayStatus: agent.state (+ workflowActive) → display status.
- *
- * FAITHFUL to the atlas state SET (atlas 0476_076:30-34). The atlas `WPe` reads ONLY these inputs:
- *   if(state==="done") → "done"
- *   if(state==="error") → skipped?"skipped":"failed"
- *   if(!workflowActive) → "interrupted"          // the inactive/non-active fallback
- *   else → (queuedAt!=null && startedAt==null) ? "queued" : "running"
- * The atlas runner's agent-state enum the monitor sees is {start, progress, queued, done, error,
- * inactive} — there is NO `failed`/`skipped`/`interrupted`/`stopped`/`running` INPUT state; those are
- * DISPLAY statuses derived here: `failed`/`skipped` from `error` (+ the `skipped` flag), `interrupted` from
- * `!workflowActive` (the `inactive`/non-active fallback), and `queued`/`running` from the queuedAt/startedAt
- * fields on the active path. The AgentState type carries exactly this input set, so the type contract now
- * matches the atlas vocabulary 1:1 — the branches below consume only atlas input states and the output
- * DisplayStatus set + glyph/color mapping ($jn) is identical.
- *
- * 🔴 **`parked` 是这条规则上唯一的 sema 超集臂**(0.63.1):atlas 没有它,因为 CC 的编排里没有耐久
- * 审批这一层。它**不派生**——上游直接铸这个词(engine core 7.10.0 #642 的 agent 行 `status` 与
- * `deriveAgentDisplayStatus` 产物),这里只是不许把它折掉。臂的**位置**是承重的,理由写在分支处。
- */
 export function agentDisplayStatus(a, workflowActive) {
     if (a.state === 'done')
         return 'done';
-    // atlas: `state==="error"` → skipped?"skipped":"failed".
     if (a.state === 'error')
         return a.skipped ? 'skipped' : 'failed';
-    // 🔴 sema 超集臂,**位置承重**:必须在 `!workflowActive` 之前判。一条腿 park 之后 run 自己收在
-    //    `failed`(core `WorkflowAgentParkedError`)⇒ `workflowActive` 恒假 ⇒ 放到后面就永远被
-    //    `interrupted` 吃掉,而 interrupted 说的是「run 结束时它还没跑完」——那是一件**已经过去**的事,
-    //    parked 说的是「它还挂在那儿,等一个人做决定」,是一件**还能动手**的事。两句下一步不同。
     if (a.state === 'parked')
         return 'parked';
-    // atlas `!t` (workflow not active) → interrupted (also the `inactive`-state landing).
     if (!workflowActive)
         return 'interrupted';
     return a.queuedAt != null && a.startedAt == null ? 'queued' : 'running';

package/dist/writeProtectionCapability.d.ts

@@ -1,44 +1,8 @@
-/**
- * writeProtectionCapability — **写保护名表**姿态的三端共用读面(0.60.0)。
- *
- * 引擎带一张**字面名表**,落在表行上的可定路径写(Write / Edit / NotebookEdit)从 `allow` 降级成
- * `ask` —— 所以端可以**事先**告诉人「这些路径会弹卡」。两个读面同源同一份 boot 产物:
- *   · **租户面** `GET /v1/capabilities` 的 `writeProtection`(engine ≥7.63.0 / S-138;sdk 8.4.0
- *     `Capabilities.writeProtection`)—— 只有三位计数/开关,**不含行内容**;
- *   · **operator 面** `GET /v1/diagnostics/wiring` 的 `writeProtection` —— 多出**行内容**与来源词。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` 逐字同一套词汇(通用读口答「这一格上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 老引擎(<7.63.0)。
- *      🔴 它**不是**「这台部署没有写保护表」—— 恰恰相反:引擎侧**座位缺席时缺省表在岗**
- *         (按键名 grep 推断「没装」会推错,上游把这一条写进了本位的顶注)。
- *   ③ `none`         —— 引擎**明确说** `null`:这个进程说不出来(非 composition root 装配的夹具形)。
- *      同样**不是**「没有表」。
- *   ④ `present`      —— 三位俱全,原样渲。
- *
- * ── 🔴 三位刻意不合成一个布尔(上游顶注逐字)────────────────────────────────────────────────
- * `armed`(生效表非空 ⇒ 真会弹卡)/ `rows`(生效表行数)/ `replaced`(整表替换旋钮被写过)——
- * 合成之后「引擎缺省表在岗」与「运维换了一张自己的表」同为 true,而两者对运维说的是两件事。
- * ⚠️ `replaced` 把「整表替换成**空**表」也算 true:报 false 会把「运维亲手关掉了表」说成
- * 「缺省表没被动过」。
- *
- * ── 🔴 最小披露:逐行 name/kind 不上租户面 ──────────────────────────────────────────────────
- * 部署自定义行可能含内部路径名,列出来等于告诉想绕过的人「哪些名字不受保护」。行内容只在
- * operator 面({@link projectWriteProtectionPosture}),而那个端点本身是 operator-gated。
- * 🔴 与**模式型** write deny(`SENSITIVE_WRITE_PATTERNS`)是**并列机制**,两个读面分开报、
- * 绝不合成一位:两者的解法不同(一套改模式,一套改名表)。
- */
-/** 租户面三位(server `WriteProtectionCapability` 逐字同形)。 */
 export interface WriteProtectionCapabilityView {
-    /** 生效表非空 ⇒ 引擎真会对表行弹卡。 */
     armed: boolean;
-    /** 生效表的**行数**(内容只上 operator 面)。 */
     rows: number;
-    /** 整表替换旋钮被写过 ⇒ 缺省表不再原样在岗。与 {@link armed} 刻意不合成。 */
     replaced: boolean;
 }
-/** 四态读数(见文件头)。`unobserved` 由**读口**在这一格空缺时铸,不由投影铸。 */
 export type WriteProtectionReading = {
     kind: 'unobserved';
 } | {
@@ -49,98 +13,22 @@ export type WriteProtectionReading = {
     kind: 'present';
     view: WriteProtectionCapabilityView;
 };
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 `undefined`(键不在)与 `null`(引擎说不出来)**是两件事**:前者 ⇒ `not_reported`(老引擎),
- *    后者 ⇒ `none`(夹具形进程)。用 `??` / falsy 判会把两者压成一件。
- * 🔴 三位**任一**形不合 ⇒ 整条判畸形。绝不留一个缺位的对象:一行写着「rows: 」的诊断比不渲这一行
- *    更坏(它看起来像一个答案)。
- * ⚠️ `rows` 按**非负有限整数**判,不按真值判:`0` 是合法读数(表在、但生效行为零),折成缺席会让
- *    「表空了」与「没报」在消费端同形。
- */
 export declare function projectWriteProtectionCapability(caps: unknown): WriteProtectionReading | undefined;
-/** operator 面的一行:一个**字面**名字 + 它怎么匹配。`name` 同时是这一行的稳定身份。 */
 export interface WriteProtectedRowView {
     name: string;
-    /** `basename`(目标最后一段)/ `segment`(任意一段)/ `segment-run`(连续若干段);**开集读**。 */
     kind: string;
 }
-/** operator 面读数(`GET /v1/diagnostics/wiring` 的 `writeProtection`)。 */
 export interface WriteProtectionPostureView {
-    /** 生效表逐行,逐字来自引擎自己的编译产物。**空数组 = 显式无表**(不是缺席)。 */
     rows: readonly WriteProtectedRowView[];
-    /** `default`(两根旋钮都没写)/ `extra`(缺省表 + 增量)/ `replace`(整表替换)/ `off`
-     *  (整表替换成空表,合法且响亮);**开集读**。 */
     source: string;
-    /** 整表替换**丢掉**的缺省行名;只在替换族在场。 */
     droppedDefaultRows?: readonly string[];
 }
-/**
- * operator 面回体的 `writeProtection` 段 → 读数;不成形 ⇒ `undefined`。
- *
- * 🔴 **空 `rows` 数组是正面事实**(「显式无表」),照铸 `[]` —— 与 `wiring_manifest.mcp[]` 同一条
- *    已定谳的纪律;把它折成缺席等于把引擎明说的一句话读成「不知道」。
- * 🔴 **坏行只丢那一行**(与 mcp 行同判据),但 `source` 读不出 ⇒ **整段缺席**:没有来源词的行表
- *    答不了运维真正要问的那一问(「这是缺省表还是你换过的表」),而半段会被当成完整答案。
- * 🔴 **不校「`droppedDefaultRows` 只在替换族在场」**:那是引擎的段内规矩,server 已按它铸;
- *    包再校一遍只会在上游合法演进的当天把一个真读数判没(与开集词表同规)。
- */
 export declare function projectWriteProtectionPosture(wiring: unknown): WriteProtectionPostureView | undefined;
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` 并列)。绝不 throw ——
- * 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * ⚠️ 「同端口 respawn / 版本回滚之后新探测失败或还在飞」是**另一条路**(本 tee 一次都不触发),
- *    由 {@link forgetWriteProtectionReading} 在装配口上收 —— 与 SQL 那一格逐字同形。
- * 🔴 **不按 principal 分域**:写保护表是**这台 worker 的 boot 产物**,与调用者是谁无关。
- *
- * 🔴 **`opts.generation` = 关掉「旧探测覆盖新读数」那条竞态的唯一正确供给**(0.60.0;异源对抗复审
- *    [medium] 采纳,真病):`kickEngineCapsProbe` 的代际闸在 **probe 返回之后**才跑,而本 tee 是在
- *    probe **内部**落地的 ⇒ 一次慢的旧探测能在 `invalidateEngineCaps` + 新探测都走完之后才返回,
- *    把**上一台引擎**的读数重新写回来。宿主在**起探测那一刻**调 `engineCapsGeneration(baseUrl)` 抓号、
- *    在这里原样交回,陈旧那一发就会被整只丢掉。
- *    ⚠️ **不传 = 与本位到货之前逐字节同行为**(照写)—— additive 供给,不是强制门;端没跟上之前不会
- *    有任何东西变坏。🔴 **tee 自己抓号是假判据**(陈旧那一发在这里读到的是新代号,永远像当代的)。
- */
 export declare function noteEngineCapsForWriteProtection(baseUrl: string, caps: unknown, opts?: {
     generation?: number;
 }): void;
-/** 本进程观测到的写保护姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export declare function observedWriteProtection(baseUrl?: string | undefined): WriteProtectionReading;
-/**
- * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;别在各端的行装配里另写一遍
- * —— 与 `sqlEngineDoctorDetail` / `autoModeDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」「进程说不出来」三种「读不出」
- *    对运维是三条不同的下一步,而**没有一条**等于「这台部署没有写保护」。
- * 🔴 `present` 那一句把三位**分开说**(见文件头「刻意不合成」):`armed` 说会不会弹卡,`rows` 说
- *    几行,`replaced` 说缺省表还在不在岗。
- * 🔴 行内容一个字都不渲(最小披露);`source` 是 operator 面的位,不上这一行。
- */
 export declare function writeProtectionDoctorDetail(reading: WriteProtectionReading): string;
-/**
- * operator 面读数 → 一行 detail(行名是 UNTRUSTED 自由文本 ⇒ 呈前**逐条**消毒 + 封长)。
- *
- * 🔴 消毒与封长的顺序 = **先转义、后按转义结果封长**({@link capForDisplay},0.62.0 起本包该族的
- *    唯一实现)。此前这三处是反的(先按原文 `slice` 再转义),一段纯控制字符的 40 字符原文转义后
- *    能占 240 个显示字符 —— 承诺的列宽预算成了名义值的六倍。同形存量另有 SQL 姿态行一处,同批同改。
- *
- * 🔴 只给**行数与来源**加上「头几行的名字」,不整表倾泻:一行诊断不是一个表格,而 operator 面的
- *    真表读法是那个端点本身。
- * 🔴 `rows: []` 渲的是**显式无表**这句正面事实,不是「读不出」。
- */
 export declare function writeProtectionPostureDetail(posture: WriteProtectionPostureView): string;
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` 并列,由宿主在引擎温切成功后调)。
- *
- * 🔴 代际闸挡不住这一形:那道闸挡的是「旧响应写脏新一代」,而本格的病是反过来的 —— 新一代的探测
- *    **根本没成功**,tee 一次都没触发,上一台引擎留在同一端口上的读数继续被当成当代事实答出去。
- *    在 doctor 上它的形态最坏:一句**肯定句**(「这台部署有 12 行写保护」),说的却是一台已经不在
- *    的引擎。处置是**清成未观测**,不是留旧值也不是铸一个 `none`。
- * 空串 ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
- */
 export declare function forgetWriteProtectionReading(baseUrl: string | undefined): void;
-/** 测试钩子。 */
 export declare function __resetWriteProtectionReadingsForTests(): void;

package/dist/writeProtectionCapability.js

@@ -1,52 +1,9 @@
-/**
- * writeProtectionCapability — **写保护名表**姿态的三端共用读面(0.60.0)。
- *
- * 引擎带一张**字面名表**,落在表行上的可定路径写(Write / Edit / NotebookEdit)从 `allow` 降级成
- * `ask` —— 所以端可以**事先**告诉人「这些路径会弹卡」。两个读面同源同一份 boot 产物:
- *   · **租户面** `GET /v1/capabilities` 的 `writeProtection`(engine ≥7.63.0 / S-138;sdk 8.4.0
- *     `Capabilities.writeProtection`)—— 只有三位计数/开关,**不含行内容**;
- *   · **operator 面** `GET /v1/diagnostics/wiring` 的 `writeProtection` —— 多出**行内容**与来源词。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` 逐字同一套词汇(通用读口答「这一格上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 老引擎(<7.63.0)。
- *      🔴 它**不是**「这台部署没有写保护表」—— 恰恰相反:引擎侧**座位缺席时缺省表在岗**
- *         (按键名 grep 推断「没装」会推错,上游把这一条写进了本位的顶注)。
- *   ③ `none`         —— 引擎**明确说** `null`:这个进程说不出来(非 composition root 装配的夹具形)。
- *      同样**不是**「没有表」。
- *   ④ `present`      —— 三位俱全,原样渲。
- *
- * ── 🔴 三位刻意不合成一个布尔(上游顶注逐字)────────────────────────────────────────────────
- * `armed`(生效表非空 ⇒ 真会弹卡)/ `rows`(生效表行数)/ `replaced`(整表替换旋钮被写过)——
- * 合成之后「引擎缺省表在岗」与「运维换了一张自己的表」同为 true,而两者对运维说的是两件事。
- * ⚠️ `replaced` 把「整表替换成**空**表」也算 true:报 false 会把「运维亲手关掉了表」说成
- * 「缺省表没被动过」。
- *
- * ── 🔴 最小披露:逐行 name/kind 不上租户面 ──────────────────────────────────────────────────
- * 部署自定义行可能含内部路径名,列出来等于告诉想绕过的人「哪些名字不受保护」。行内容只在
- * operator 面({@link projectWriteProtectionPosture}),而那个端点本身是 operator-gated。
- * 🔴 与**模式型** write deny(`SENSITIVE_WRITE_PATTERNS`)是**并列机制**,两个读面分开报、
- * 绝不合成一位:两者的解法不同(一套改模式,一套改名表)。
- */
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 `undefined`(键不在)与 `null`(引擎说不出来)**是两件事**:前者 ⇒ `not_reported`(老引擎),
- *    后者 ⇒ `none`(夹具形进程)。用 `??` / falsy 判会把两者压成一件。
- * 🔴 三位**任一**形不合 ⇒ 整条判畸形。绝不留一个缺位的对象:一行写着「rows: 」的诊断比不渲这一行
- *    更坏(它看起来像一个答案)。
- * ⚠️ `rows` 按**非负有限整数**判,不按真值判:`0` 是合法读数(表在、但生效行为零),折成缺席会让
- *    「表空了」与「没报」在消费端同形。
- */
 export function projectWriteProtectionCapability(caps) {
     if (caps === null || typeof caps !== 'object')
         return undefined;
-    // 0.77.0 整族改齐:① 非对象 / 数组 caps 不是能力表 ⇒ 畸形(投影答 undefined ⇒ 删格 ⇒ 读口答 unobserved),不再答 not_reported
-    //    (那是把「取不到」冒充「报了但没提」);② 在场判据改 hasOwn —— 原型链上的同名键永远不会被序列化上 wire,读成在场 = 凭空造一格。
     if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
         return undefined;
     if (!Object.hasOwn(caps, 'writeProtection'))
@@ -59,7 +16,6 @@ export function projectWriteProtectionCapability(caps) {
     if (typeof wp !== 'object' || Array.isArray(wp))
         return undefined;
     const w = wp;
-    // 🔴 只读一次(0.74.2 CC-69 复审 R1 族扫):校验与返回各读一次,变化的 getter 会让校验读到合形、返回读到别的。
     const armed = w.armed;
     const replaced = w.replaced;
     const rows = w.rows;
@@ -71,16 +27,6 @@ export function projectWriteProtectionCapability(caps) {
         return undefined;
     return { kind: 'present', view: { armed, rows, replaced } };
 }
-/**
- * operator 面回体的 `writeProtection` 段 → 读数;不成形 ⇒ `undefined`。
- *
- * 🔴 **空 `rows` 数组是正面事实**(「显式无表」),照铸 `[]` —— 与 `wiring_manifest.mcp[]` 同一条
- *    已定谳的纪律;把它折成缺席等于把引擎明说的一句话读成「不知道」。
- * 🔴 **坏行只丢那一行**(与 mcp 行同判据),但 `source` 读不出 ⇒ **整段缺席**:没有来源词的行表
- *    答不了运维真正要问的那一问(「这是缺省表还是你换过的表」),而半段会被当成完整答案。
- * 🔴 **不校「`droppedDefaultRows` 只在替换族在场」**:那是引擎的段内规矩,server 已按它铸;
- *    包再校一遍只会在上游合法演进的当天把一个真读数判没(与开集词表同规)。
- */
 export function projectWriteProtectionPosture(wiring) {
     if (wiring === null || typeof wiring !== 'object')
         return undefined;
@@ -113,52 +59,18 @@ export function projectWriteProtectionPosture(wiring) {
         ...(dropped !== undefined ? { droppedDefaultRows: dropped } : {}),
     };
 }
-/**
- * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 各只能力位读器**共用同一份实现**
- * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数 {@link projectWriteProtectionCapability}、doctor 措辞表,以及本位自己的判据助手(如有)。
- * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面。
- */
 const reader = createEngineCapReader({
     name: 'writeProtection',
     project: projectWriteProtectionCapability,
     makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` 并列)。绝不 throw ——
- * 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * ⚠️ 「同端口 respawn / 版本回滚之后新探测失败或还在飞」是**另一条路**(本 tee 一次都不触发),
- *    由 {@link forgetWriteProtectionReading} 在装配口上收 —— 与 SQL 那一格逐字同形。
- * 🔴 **不按 principal 分域**:写保护表是**这台 worker 的 boot 产物**,与调用者是谁无关。
- *
- * 🔴 **`opts.generation` = 关掉「旧探测覆盖新读数」那条竞态的唯一正确供给**(0.60.0;异源对抗复审
- *    [medium] 采纳,真病):`kickEngineCapsProbe` 的代际闸在 **probe 返回之后**才跑,而本 tee 是在
- *    probe **内部**落地的 ⇒ 一次慢的旧探测能在 `invalidateEngineCaps` + 新探测都走完之后才返回,
- *    把**上一台引擎**的读数重新写回来。宿主在**起探测那一刻**调 `engineCapsGeneration(baseUrl)` 抓号、
- *    在这里原样交回,陈旧那一发就会被整只丢掉。
- *    ⚠️ **不传 = 与本位到货之前逐字节同行为**(照写)—— additive 供给,不是强制门;端没跟上之前不会
- *    有任何东西变坏。🔴 **tee 自己抓号是假判据**(陈旧那一发在这里读到的是新代号,永远像当代的)。
- */
 export function noteEngineCapsForWriteProtection(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
 }
-/** 本进程观测到的写保护姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export function observedWriteProtection(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-/** 单行 UNTRUSTED 座的展示上限(UTF-16 单元;与 SQL 那一格同值同理由)。 */
 const WP_DETAIL_MAX = 40;
-/**
- * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;别在各端的行装配里另写一遍
- * —— 与 `sqlEngineDoctorDetail` / `autoModeDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」「进程说不出来」三种「读不出」
- *    对运维是三条不同的下一步,而**没有一条**等于「这台部署没有写保护」。
- * 🔴 `present` 那一句把三位**分开说**(见文件头「刻意不合成」):`armed` 说会不会弹卡,`rows` 说
- *    几行,`replaced` 说缺省表还在不在岗。
- * 🔴 行内容一个字都不渲(最小披露);`source` 是 operator 面的位,不上这一行。
- */
 export function writeProtectionDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
@@ -183,17 +95,6 @@ export function writeProtectionDoctorDetail(reading) {
         }
     }
 }
-/**
- * operator 面读数 → 一行 detail(行名是 UNTRUSTED 自由文本 ⇒ 呈前**逐条**消毒 + 封长)。
- *
- * 🔴 消毒与封长的顺序 = **先转义、后按转义结果封长**({@link capForDisplay},0.62.0 起本包该族的
- *    唯一实现)。此前这三处是反的(先按原文 `slice` 再转义),一段纯控制字符的 40 字符原文转义后
- *    能占 240 个显示字符 —— 承诺的列宽预算成了名义值的六倍。同形存量另有 SQL 姿态行一处,同批同改。
- *
- * 🔴 只给**行数与来源**加上「头几行的名字」,不整表倾泻:一行诊断不是一个表格,而 operator 面的
- *    真表读法是那个端点本身。
- * 🔴 `rows: []` 渲的是**显式无表**这句正面事实,不是「读不出」。
- */
 export function writeProtectionPostureDetail(posture) {
     const source = capForDisplay(posture.source, WP_DETAIL_MAX);
     if (posture.rows.length === 0)
@@ -208,19 +109,9 @@ export function writeProtectionPostureDetail(posture) {
         : '';
     return `source ${source} · ${String(posture.rows.length)} ${posture.rows.length === 1 ? 'name' : 'names'}: ${shown}${more}${dropped}`;
 }
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` 并列,由宿主在引擎温切成功后调)。
- *
- * 🔴 代际闸挡不住这一形:那道闸挡的是「旧响应写脏新一代」,而本格的病是反过来的 —— 新一代的探测
- *    **根本没成功**,tee 一次都没触发,上一台引擎留在同一端口上的读数继续被当成当代事实答出去。
- *    在 doctor 上它的形态最坏:一句**肯定句**(「这台部署有 12 行写保护」),说的却是一台已经不在
- *    的引擎。处置是**清成未观测**,不是留旧值也不是铸一个 `none`。
- * 空串 ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
- */
 export function forgetWriteProtectionReading(baseUrl) {
     reader.forget(baseUrl);
 }
-/** 测试钩子。 */
 export function __resetWriteProtectionReadingsForTests() {
     reader.__resetForTests();
 }

package/docs/INTEGRATION-CLIENTS.md

@@ -19,7 +19,7 @@
 
 | 项 | 值 | 真源 |
 |---|---|---|
-| 本包 | `@sema-agent/client-core` **0.77.1**(本批发布版 = **patch**:外部验收三件回填 —— 读器族边界残留 projectMcpReconnectCapability 只认自有键(CC-107)/ rewind 四子键恰读一次(CC-108)/ 子代输出合并按回体 output.type · retrieval_status 定处置(CC-109,server ≥7.92.0 cursorSemantics 缺席面);型面 additive 一处;公面 1143;§80。上一版 0.77.0 = **minor**:请求装配逐键去向回执 + print 车道补座 + 表外键响亮拒(CC-101,四条行为 BREAKING)/ 会话策略写端口(CC-105)/ 持久规则单步写面(CC-103)/ workflow 子代面板行代际三向恢复(CC-104,零改码)/ 能力位读器族口径整族改齐 + 外部验收 F-A / F-B 处置 + 合并树异源复审两轮处置;公面 1143;§79。上一版 0.76.2 = **patch**:制品卫生 —— 清 dist 重 build 去掉两只已撤出源码的编译产物 + dist ⇄ src 对账门;零源码 / 零型面 / 零行为改动;公面 1122;§78。上一版 0.76.1 = **patch**:能力位读器工厂(CC-75)/ MCP 活性观察读口(CC-36)/ `capabilities.peerLane` · `permissionRulesWrite` 四态读口(CC-102)/ 记忆治理面两只读口 + 三只条目面回体读口(CC-97 a)/ 主车道证明逐次新建(CC-99)+ 修 0.76.0 的 F1 / F2(身份四键一次性快照只修了投影口一侧);公面 1122;§77。上一版 0.76.0 = **minor**:六票一批 —— `prompt_assembled` 投影臂 / 审批 feed 三态(**型面 BREAKING**)/ `ApprovalResolution` 单源联合 / 记忆 spec 读口 / 终态词表上游钉 / `tasks_expand` 退役(**型面 BREAKING**),外加身份四键一次性快照(跨全部内部臂);公面 1081;§76。上一版 0.75.1 = **patch**:面板短命子代反序缓行放不出的残洞(外部复验 D1)+ 同代 running 帧三向定形(B4)+ #969 提货 `spawnName` 透传与 `agentType` 改读诚实来源(CC-95);§75。上一版 0.75.0 = **minor**:压缩的非 compacted 结局上 chrome 面 `compaction_outcome`(新内部臂 —— 自建 print 出口的端先表态)+ peer sdk 地板 `>=9.8.1`;型面 additive(ChromeEvent +1 臂)、公面 1065、零 wire 新键;§74。上一版 0.74.5 = **patch**:core 7.24.0 提货 `_sema_freed_tokens?` + 首见即终态的行零事件(幽灵完成行)+ `isNewEngineAgentPanelCycle` / `approvalOutcomeNoteOf` 上公面;型面 additive、公面 1065、peer 不动;§73。上一版 0.74.4 = **patch**:面板键「先发布的键为准」(tick 归不了一的三序不再两行)+ 前代 UUID 迟到 tick 丢弃 + `readRunCancelContext` 下钻收紧;型面 additive、公面 1061、peer 不动;§72。上一版 0.74.3 = **patch**:面板子代身份归一(tick / end 的 UUID 归到 fleet 尾段,宿主零改)+ run 记录 `cancelContext` 读口与成因四词 + workflow 行 `errorCode` + reopen 第二臂两件;型面纯 additive、公面 1061、peer 不动;§71。上一版 0.74.2 = **patch**:`capabilities.deviceExecutor.management` 四态读口(缺席 ≠ false;`deviceExecutor: false` = 车道缺席;管理动词可用性三态归包);公面 1052;§70。上一版 0.74.1 = **patch**:审批卡无决断收口 + 结局回交;§69。上一版 0.74.0 = **minor**:peer sdk 地板 >=9.7.1 + covers 过境 + 面板周期身份 + 离场读口;§68。上一版 0.73.5 = **patch**:workflow 规模告警判定上收进包(`evaluateWorkflowSize` 三态:未知的规模不当作规模正常;分母口径与帽优先级单源;env 读口纯函数);型面纯 additive、公面 1044、peer 不动;§67。上一版 0.73.4 = **patch**:终帧 `permission_denials` 第三键 ⇐ 同一条流 `tool_start` 入参按 `toolCallId` join(三道闸;join 不上留 sema 载体;🔴 更正 0.73.2「自动升级收口」一句)+ 审批 feed push 侧取件失败的欠账退避重试;型面纯 additive、公面 1033、peer 不动;§66。上一版 0.73.3 = **patch**:CC-61 sdk 9.7.1 提货 + `capabilities.approvalsStreamLive` 四态读口(缺席 = 判不出;`livePendingNeedsReconcile` 只在引擎明说会推时才让对账节拍降兜底)+ CC-60 五条模型面文案锚包侧半场(cursorSemantics 机读位 / result 行注记 / bash 首行两变体与良性槽 / 通知 seed 并集 / parked 臂);型面纯 additive、公面 1032、peer 不动;§65。上一版 0.73.2 = **patch**:CC-59 悬挂 ask 全卡 —— `livePending[].frame`(server ≥7.87.0)两道闸窄读进视图,在场即走流内帧腿同一条路(入参可见、改写可转发),缺席保持盲卡;CC-34 收口(引擎半场随 7.87.0 到货,判据交黑盒);型面纯 additive、公面 1026、peer 不动;§64。上一版 0.73.1 = **patch**:CC-57 `decidePlanReview` outcome 尾句按「决断有没有生效」四态选(单铸点 `planReviewOutcomeTail`;此前本地拒发仍让模型汇报已拒绝)+ CC-56 cancel 的 409 按机器码分家(`cancelConflictFromError` 三形 / 新安全码 `cancel_run_not_running`)与提交面 429 用量窗读口 + 人话;型面纯 additive、公面 1026、peer 不动;§63。上一版 0.73.0 = **minor,型面 BREAKING**:fleet 视图八个数值键改可选 —— CC-52 `FleetTaskView.elapsedMs` / `tokens` / `queuedCount` 与 `FleetWorkflowView.doneCount` / `totalCount` / `failedCount` / `tokens` / `elapsedMs` 不再 `?? 0`(有键 = 真值含真 0,缺键 = 不知道;逐键缺席语义见 §62b)+ 台账补偿链无基数不铸;公面导出名零增减 1019、零 wire 变化、peer 不动;§62。上一版 0.72.14 = **patch**:悬挂的流内 ask 拉半场 —— CC-55 `startApprovalsFeed` 快照加 `livePending` 段并进变化摘要(键缺席 = 未报,不铸空)+ 视图 / 去重账 / 与流内帧腿同链的决断口(入参不可见上卡明说、改写不转发)+ 宿主闸对账节拍 + 待决计数读口(不知道 = null);型面纯 additive、公面 1019、peer 不动;§61。上一版 0.72.13 = **patch**:server 7.86.0 提货 —— CC-46 plan_review `permissionModeAfter` 发口(三选卡双闸:宿主声明只读起步 ∧ 引擎 ≥7.86.0;400 field_conflict 两种处置)+ CC-54 `capabilities.executionLane` 四态读面(键缺席 ≠ 不是本机车道;`toolsRunHere` 判据归包)+ CC-53 detach 版本闸三态;型面 additive(另撤回 0.72.12 的主通道 `absent` 臂,改独立缺席订阅口)、公面 1011、peer 不动;§60;**预告 0.73.0 BREAKING**:fleet 视图数值键改可选。上一版 0.72.12 = **patch**:「缺席被折成正向终态」按类清剿 —— CC-50 M1 头条(fleet 行缺席改发 `absent` 不再铸 `end{isError:false}`)+ 六站一次改齐(缺席 ⇒ `unknown`)+ 结果边界 fail-closed 取舍 + `_sema_outcome` + `Outcome unknown:` 行 + CC-51 M6(default 臂不再谎报 running)+ 普查门 + DS-06;型面 additive、公面 993、peer 不动;行为面三处真变化见 CHANGELOG 取舍段;§59。上一版 0.72.11 = **patch**:core 7.23.0 提货 —— CC-49 通告码 66 → 67 `config.write_protection_unresolved`(operator;兄弟码 `target_view_absent` = 没有视图,这枚 = 有视图解析不出)+ `permission_denials` 自动升级腿通电(`gates[].toolCallId` ⇒ `tool_use_id`;CC-34 引擎半场);型面零变化、公面 989、peer 不动、devDep core ~7.23.0;§58。上一版 0.72.10 = **patch**:CC-41 leader run 终局 `needs_human` + `result.conflict` 三形读面(none 缺席不可分 / unreadable 在场读不懂 / conflict;`salvaged[]` 原样给落盘口;措辞单源不提重试);型面纯 additive、公面 989、peer 不动;§57。上一版 0.72.9 = **patch**:server 7.85.0 提货 —— CC-30 会话内 MCP re-dial 消费口(`reconnectMcpServer` 三态 / unsupported 恒五键 / 交易文案单源)+ CC-39② memory-status `autoConsolidationArmed` 三态 + CC-45 resume 补充句渲保留秒数;型面纯 additive、公面 985、peer 不动;§56。上一版 0.72.8 = **patch**:清账三票 —— `memory:"off"` 请求键(CC-39③,server 7.84.0 S-405)+ `runStream` 第二条中性臂 `Model output error:`(CC-43)+ 注入件撞活 run 自动 steer 零卡(CC-44);型面纯 additive、公面 977、peer 不动;§55。上一版 0.72.7 = **patch**:core 7.22.0 提货 —— 通告码 66 `mcp.server_redialed` + 读器 `readMcpServerRedialed` + `wiring_manifest.readDeny` 第九段 `_sema_readDeny`(缺席 = 没有内置行判这条腿);型面纯 additive、公面 971、peer 不动、devDep core ~7.22.0;§54。上一版 0.72.6 = **patch**:cli L-379 包侧半场 —— `steerFollowIntent` steer 后续听意图三态(tail / after-decision / after-wake)+ `activeRunSelfHealRow` 续听声明第五参;型面纯 additive、公面 969、peer 不动;§53。上一版 0.72.5 = **patch**:server 7.82.1 提货 —— `capabilities.webSearch.backend` 部署默认 WebSearch 后端四态读面(键缺席 = 老引擎判不了 ≠ `none`);型面纯 additive、公面 968、peer 不动;§52。上一版 0.72.4 = **patch**:core 7.21.x 三件经 server 7.82.0 提货 —— `wiring_manifest.autoConsolidation` 第八段 `_sema_autoConsolidation`(缺席 = indeterminate 不折 false);型面纯 additive、公面 962、peer 不动;§51。上一版 0.72.3 = **patch**:core #863 记忆单系统半场 ① —— `projectAgentsForWire` 投影 `agents[].memory`(user|project|local 三词同映射引擎平面 agent:<type>);型面纯 additive、公面 962、零 wire 新键、peer 不动;§50。上一版 0.72.2 = **patch**:workflow 视图两票 —— `LiveWorkflowController.resolution()` 六态(snapshot() 的 null 三义拆开)+ `noteOwnWorkflowRun` own 台账同拍登记;型面纯 additive、公面 961、零 wire 键、peer 不动;§49。上一版 0.72.1 = **patch**:server 7.80.1 提货 —— 409 `conflict.resume_context_unavailable` 结构读数(`staleAfterSec` / `runId`;sdk 9.6.0 尚未带键,经 sdk 今天恒缺席)+ `SkillSpec.baseDir`(只在本机车道带);型面纯 additive、公面 960、peer 不动;§48。上一版 0.72.0 = **minor**:型面 BREAKING —— 39 个零消费导出退出公面(CC-32 退役批,[7419] §45 预告 / cli [7422] 同意 / web-client·desktop 过节拍沉默 = 同意;名单见 §47a S-1);运行期零 BREAKING、公面 956、peer 不动、devDep core ~7.20.1;随批:已退役名账 `removed` + export-liveness 门 G 段 + 冻结账门 ⑧c;§47。上一版 0.71.4 = **patch**:core 7.20.1 提货 —— `ENGINE_NOTICE_CODES` 65 + `wiring_manifest.writeProtection` 第七段 `_sema_writeProtection`;型面纯 additive、公面 995、peer 不动、devDep core `~7.20.1`;§46。上一版 0.71.3 = **patch**:门体系清账批 —— CC-24 export-liveness 门 + 39 个导出退役预告(0.72.0 删,表态制)/ CC-26 `as unknown as` 铸链棘轮 / CC-25 冻结账门 ⑧ 段 / CC-06 B-081 包侧半场(终帧 `_sema_effective_reasoning` / `_sema_effective_memory_scopes` + resume reopen 族 + `routePairingVerdict`);型面纯 additive、公面 986 → 995、peer 不动;§45。上一版 0.71.2 = **patch**:接入方验收两票归包 —— CC-28 B-132 decide 拒体三句去内部车道词 / CC-29 B-133 committedUuids 唯一性(重复 ⇒ 形 f);零型面变化、公面 986、peer 不动;§44。上一版 0.71.1 = **patch**:接入档打回修正 —— CC-27 `ApprovalCardRequest.readRootCandidate?` 帧→卡透传位 + 新导出型 `ReadRootCandidateView`;型面纯 additive、公面 986 不变、peer 不动;§43。上一版 0.71.0 = **minor**:型面 BREAKING 六件 —— peer sdk 地板 >=9.6.0 + agent-types >=0.3.0 / `SkillsListingTruncatedFactsView` 删 `requestedBudgetBytes?`·`laneClamped?` / `WiringManifestMcpEntry` → `WiringManifestMcpEntryView` / `MAX_AGENT_SKILLS` 删 / `decide.workflow_host_not_parked` 退役;运行期零 BREAKING。内容:core 7.20.0 提货(闭集 +5 六十四码)/ 🔴 CC-16 `text_segment_end.committedUuids[]` / CC-08 全五件(tool_disclosure / tool_progress 两 chrome 臂、wiring_manifest tools·hooks·lsp 进切片、tool_roster_delta 接上、context_usage 进切片、`readRootCandidate` 镜像)/ CC-19 `mcpEngineLegPresence` 归包 / CC-20 not_parked clean-cut;公面 986;§42 / 42y 八条)|
+| 本包 | `@sema-agent/client-core` **0.77.2**(本批发布版 = **patch**:出包面结构卫生 —— 构建期 removeComments,dist js / d.ts 零注释(新门 run-dist-comments-test.mjs + 卫生门词表 32 条 + 文档向前执法;CC-100)+ gateDeniedByDetail 表外词兜底句改「本版不认识这个层名」(CC-111 ①);行为 / 型面逐字节同 0.77.1;公面 1143;§81。上一版 0.77.1 = **patch**:外部验收三件回填 —— 读器族边界残留 projectMcpReconnectCapability 只认自有键(CC-107)/ rewind 四子键恰读一次(CC-108)/ 子代输出合并按回体 output.type · retrieval_status 定处置(CC-109,server ≥7.92.0 cursorSemantics 缺席面);型面 additive 一处;公面 1143;§80。上一版 0.77.0 = **minor**:请求装配逐键去向回执 + print 车道补座 + 表外键响亮拒(CC-101,四条行为 BREAKING)/ 会话策略写端口(CC-105)/ 持久规则单步写面(CC-103)/ workflow 子代面板行代际三向恢复(CC-104,零改码)/ 能力位读器族口径整族改齐 + 外部验收 F-A / F-B 处置 + 合并树异源复审两轮处置;公面 1143;§79。上一版 0.76.2 = **patch**:制品卫生 —— 清 dist 重 build 去掉两只已撤出源码的编译产物 + dist ⇄ src 对账门;零源码 / 零型面 / 零行为改动;公面 1122;§78。上一版 0.76.1 = **patch**:能力位读器工厂(CC-75)/ MCP 活性观察读口(CC-36)/ `capabilities.peerLane` · `permissionRulesWrite` 四态读口(CC-102)/ 记忆治理面两只读口 + 三只条目面回体读口(CC-97 a)/ 主车道证明逐次新建(CC-99)+ 修 0.76.0 的 F1 / F2(身份四键一次性快照只修了投影口一侧);公面 1122;§77。上一版 0.76.0 = **minor**:六票一批 —— `prompt_assembled` 投影臂 / 审批 feed 三态(**型面 BREAKING**)/ `ApprovalResolution` 单源联合 / 记忆 spec 读口 / 终态词表上游钉 / `tasks_expand` 退役(**型面 BREAKING**),外加身份四键一次性快照(跨全部内部臂);公面 1081;§76。上一版 0.75.1 = **patch**:面板短命子代反序缓行放不出的残洞(外部复验 D1)+ 同代 running 帧三向定形(B4)+ #969 提货 `spawnName` 透传与 `agentType` 改读诚实来源(CC-95);§75。上一版 0.75.0 = **minor**:压缩的非 compacted 结局上 chrome 面 `compaction_outcome`(新内部臂 —— 自建 print 出口的端先表态)+ peer sdk 地板 `>=9.8.1`;型面 additive(ChromeEvent +1 臂)、公面 1065、零 wire 新键;§74。上一版 0.74.5 = **patch**:core 7.24.0 提货 `_sema_freed_tokens?` + 首见即终态的行零事件(幽灵完成行)+ `isNewEngineAgentPanelCycle` / `approvalOutcomeNoteOf` 上公面;型面 additive、公面 1065、peer 不动;§73。上一版 0.74.4 = **patch**:面板键「先发布的键为准」(tick 归不了一的三序不再两行)+ 前代 UUID 迟到 tick 丢弃 + `readRunCancelContext` 下钻收紧;型面 additive、公面 1061、peer 不动;§72。上一版 0.74.3 = **patch**:面板子代身份归一(tick / end 的 UUID 归到 fleet 尾段,宿主零改)+ run 记录 `cancelContext` 读口与成因四词 + workflow 行 `errorCode` + reopen 第二臂两件;型面纯 additive、公面 1061、peer 不动;§71。上一版 0.74.2 = **patch**:`capabilities.deviceExecutor.management` 四态读口(缺席 ≠ false;`deviceExecutor: false` = 车道缺席;管理动词可用性三态归包);公面 1052;§70。上一版 0.74.1 = **patch**:审批卡无决断收口 + 结局回交;§69。上一版 0.74.0 = **minor**:peer sdk 地板 >=9.7.1 + covers 过境 + 面板周期身份 + 离场读口;§68。上一版 0.73.5 = **patch**:workflow 规模告警判定上收进包(`evaluateWorkflowSize` 三态:未知的规模不当作规模正常;分母口径与帽优先级单源;env 读口纯函数);型面纯 additive、公面 1044、peer 不动;§67。上一版 0.73.4 = **patch**:终帧 `permission_denials` 第三键 ⇐ 同一条流 `tool_start` 入参按 `toolCallId` join(三道闸;join 不上留 sema 载体;🔴 更正 0.73.2「自动升级收口」一句)+ 审批 feed push 侧取件失败的欠账退避重试;型面纯 additive、公面 1033、peer 不动;§66。上一版 0.73.3 = **patch**:CC-61 sdk 9.7.1 提货 + `capabilities.approvalsStreamLive` 四态读口(缺席 = 判不出;`livePendingNeedsReconcile` 只在引擎明说会推时才让对账节拍降兜底)+ CC-60 五条模型面文案锚包侧半场(cursorSemantics 机读位 / result 行注记 / bash 首行两变体与良性槽 / 通知 seed 并集 / parked 臂);型面纯 additive、公面 1032、peer 不动;§65。上一版 0.73.2 = **patch**:CC-59 悬挂 ask 全卡 —— `livePending[].frame`(server ≥7.87.0)两道闸窄读进视图,在场即走流内帧腿同一条路(入参可见、改写可转发),缺席保持盲卡;CC-34 收口(引擎半场随 7.87.0 到货,判据交黑盒);型面纯 additive、公面 1026、peer 不动;§64。上一版 0.73.1 = **patch**:CC-57 `decidePlanReview` outcome 尾句按「决断有没有生效」四态选(单铸点 `planReviewOutcomeTail`;此前本地拒发仍让模型汇报已拒绝)+ CC-56 cancel 的 409 按机器码分家(`cancelConflictFromError` 三形 / 新安全码 `cancel_run_not_running`)与提交面 429 用量窗读口 + 人话;型面纯 additive、公面 1026、peer 不动;§63。上一版 0.73.0 = **minor,型面 BREAKING**:fleet 视图八个数值键改可选 —— CC-52 `FleetTaskView.elapsedMs` / `tokens` / `queuedCount` 与 `FleetWorkflowView.doneCount` / `totalCount` / `failedCount` / `tokens` / `elapsedMs` 不再 `?? 0`(有键 = 真值含真 0,缺键 = 不知道;逐键缺席语义见 §62b)+ 台账补偿链无基数不铸;公面导出名零增减 1019、零 wire 变化、peer 不动;§62。上一版 0.72.14 = **patch**:悬挂的流内 ask 拉半场 —— CC-55 `startApprovalsFeed` 快照加 `livePending` 段并进变化摘要(键缺席 = 未报,不铸空)+ 视图 / 去重账 / 与流内帧腿同链的决断口(入参不可见上卡明说、改写不转发)+ 宿主闸对账节拍 + 待决计数读口(不知道 = null);型面纯 additive、公面 1019、peer 不动;§61。上一版 0.72.13 = **patch**:server 7.86.0 提货 —— CC-46 plan_review `permissionModeAfter` 发口(三选卡双闸:宿主声明只读起步 ∧ 引擎 ≥7.86.0;400 field_conflict 两种处置)+ CC-54 `capabilities.executionLane` 四态读面(键缺席 ≠ 不是本机车道;`toolsRunHere` 判据归包)+ CC-53 detach 版本闸三态;型面 additive(另撤回 0.72.12 的主通道 `absent` 臂,改独立缺席订阅口)、公面 1011、peer 不动;§60;**预告 0.73.0 BREAKING**:fleet 视图数值键改可选。上一版 0.72.12 = **patch**:「缺席被折成正向终态」按类清剿 —— CC-50 M1 头条(fleet 行缺席改发 `absent` 不再铸 `end{isError:false}`)+ 六站一次改齐(缺席 ⇒ `unknown`)+ 结果边界 fail-closed 取舍 + `_sema_outcome` + `Outcome unknown:` 行 + CC-51 M6(default 臂不再谎报 running)+ 普查门 + DS-06;型面 additive、公面 993、peer 不动;行为面三处真变化见 CHANGELOG 取舍段;§59。上一版 0.72.11 = **patch**:core 7.23.0 提货 —— CC-49 通告码 66 → 67 `config.write_protection_unresolved`(operator;兄弟码 `target_view_absent` = 没有视图,这枚 = 有视图解析不出)+ `permission_denials` 自动升级腿通电(`gates[].toolCallId` ⇒ `tool_use_id`;CC-34 引擎半场);型面零变化、公面 989、peer 不动、devDep core ~7.23.0;§58。上一版 0.72.10 = **patch**:CC-41 leader run 终局 `needs_human` + `result.conflict` 三形读面(none 缺席不可分 / unreadable 在场读不懂 / conflict;`salvaged[]` 原样给落盘口;措辞单源不提重试);型面纯 additive、公面 989、peer 不动;§57。上一版 0.72.9 = **patch**:server 7.85.0 提货 —— CC-30 会话内 MCP re-dial 消费口(`reconnectMcpServer` 三态 / unsupported 恒五键 / 交易文案单源)+ CC-39② memory-status `autoConsolidationArmed` 三态 + CC-45 resume 补充句渲保留秒数;型面纯 additive、公面 985、peer 不动;§56。上一版 0.72.8 = **patch**:清账三票 —— `memory:"off"` 请求键(CC-39③,server 7.84.0 S-405)+ `runStream` 第二条中性臂 `Model output error:`(CC-43)+ 注入件撞活 run 自动 steer 零卡(CC-44);型面纯 additive、公面 977、peer 不动;§55。上一版 0.72.7 = **patch**:core 7.22.0 提货 —— 通告码 66 `mcp.server_redialed` + 读器 `readMcpServerRedialed` + `wiring_manifest.readDeny` 第九段 `_sema_readDeny`(缺席 = 没有内置行判这条腿);型面纯 additive、公面 971、peer 不动、devDep core ~7.22.0;§54。上一版 0.72.6 = **patch**:cli L-379 包侧半场 —— `steerFollowIntent` steer 后续听意图三态(tail / after-decision / after-wake)+ `activeRunSelfHealRow` 续听声明第五参;型面纯 additive、公面 969、peer 不动;§53。上一版 0.72.5 = **patch**:server 7.82.1 提货 —— `capabilities.webSearch.backend` 部署默认 WebSearch 后端四态读面(键缺席 = 老引擎判不了 ≠ `none`);型面纯 additive、公面 968、peer 不动;§52。上一版 0.72.4 = **patch**:core 7.21.x 三件经 server 7.82.0 提货 —— `wiring_manifest.autoConsolidation` 第八段 `_sema_autoConsolidation`(缺席 = indeterminate 不折 false);型面纯 additive、公面 962、peer 不动;§51。上一版 0.72.3 = **patch**:core #863 记忆单系统半场 ① —— `projectAgentsForWire` 投影 `agents[].memory`(user|project|local 三词同映射引擎平面 agent:<type>);型面纯 additive、公面 962、零 wire 新键、peer 不动;§50。上一版 0.72.2 = **patch**:workflow 视图两票 —— `LiveWorkflowController.resolution()` 六态(snapshot() 的 null 三义拆开)+ `noteOwnWorkflowRun` own 台账同拍登记;型面纯 additive、公面 961、零 wire 键、peer 不动;§49。上一版 0.72.1 = **patch**:server 7.80.1 提货 —— 409 `conflict.resume_context_unavailable` 结构读数(`staleAfterSec` / `runId`;sdk 9.6.0 尚未带键,经 sdk 今天恒缺席)+ `SkillSpec.baseDir`(只在本机车道带);型面纯 additive、公面 960、peer 不动;§48。上一版 0.72.0 = **minor**:型面 BREAKING —— 39 个零消费导出退出公面(CC-32 退役批,[7419] §45 预告 / cli [7422] 同意 / web-client·desktop 过节拍沉默 = 同意;名单见 §47a S-1);运行期零 BREAKING、公面 956、peer 不动、devDep core ~7.20.1;随批:已退役名账 `removed` + export-liveness 门 G 段 + 冻结账门 ⑧c;§47。上一版 0.71.4 = **patch**:core 7.20.1 提货 —— `ENGINE_NOTICE_CODES` 65 + `wiring_manifest.writeProtection` 第七段 `_sema_writeProtection`;型面纯 additive、公面 995、peer 不动、devDep core `~7.20.1`;§46。上一版 0.71.3 = **patch**:门体系清账批 —— CC-24 export-liveness 门 + 39 个导出退役预告(0.72.0 删,表态制)/ CC-26 `as unknown as` 铸链棘轮 / CC-25 冻结账门 ⑧ 段 / CC-06 B-081 包侧半场(终帧 `_sema_effective_reasoning` / `_sema_effective_memory_scopes` + resume reopen 族 + `routePairingVerdict`);型面纯 additive、公面 986 → 995、peer 不动;§45。上一版 0.71.2 = **patch**:接入方验收两票归包 —— CC-28 B-132 decide 拒体三句去内部车道词 / CC-29 B-133 committedUuids 唯一性(重复 ⇒ 形 f);零型面变化、公面 986、peer 不动;§44。上一版 0.71.1 = **patch**:接入档打回修正 —— CC-27 `ApprovalCardRequest.readRootCandidate?` 帧→卡透传位 + 新导出型 `ReadRootCandidateView`;型面纯 additive、公面 986 不变、peer 不动;§43。上一版 0.71.0 = **minor**:型面 BREAKING 六件 —— peer sdk 地板 >=9.6.0 + agent-types >=0.3.0 / `SkillsListingTruncatedFactsView` 删 `requestedBudgetBytes?`·`laneClamped?` / `WiringManifestMcpEntry` → `WiringManifestMcpEntryView` / `MAX_AGENT_SKILLS` 删 / `decide.workflow_host_not_parked` 退役;运行期零 BREAKING。内容:core 7.20.0 提货(闭集 +5 六十四码)/ 🔴 CC-16 `text_segment_end.committedUuids[]` / CC-08 全五件(tool_disclosure / tool_progress 两 chrome 臂、wiring_manifest tools·hooks·lsp 进切片、tool_roster_delta 接上、context_usage 进切片、`readRootCandidate` 镜像)/ CC-19 `mcpEngineLegPresence` 归包 / CC-20 not_parked clean-cut;公面 986;§42 / 42y 八条)|
 | peer:wire 契约 | `@sema-agent/sdk` **>=9.8.1**(value-level,非 type-only;**0.75.0 抬版**:9.8.x 声明 `Capabilities.deviceExecutor.management?`,9.7.1 失去物料见证;**0.74.0 曾抬到 >=9.7.1**:9.7.x 追平的六处型面是本包 0.73.3 起的编译基线,且 9.6.0 失去物料见证;**0.71.0 曾抬到 >=9.6.0**:`tool_disclosure` / `tool_progress` 两帧型与 `ToolApprovalFrame.readRootCandidate` 自 9.6.0 起;0.69.0 曾抬到 >=9.4.0(`reasoning_end` / `lastLegMcp`),0.60.0 抬到 >=8.4.0;地板由 `scripts/run-sdk-floor-test.mjs` 的 `FLOOR` 与 public-surface 门 C-CC-3「不低于见证到的最低实装版」双钉)| `package.json` `peerDependencies` |
 | peer:会话词汇表 | `@sema-agent/agent-types` **>=0.3.0**(type-only,零运行时;0.71.0 抬版:devDep 与 peer 同步,type-superset 门 ④ 撞名预警对着 0.3.0 的 .d.ts 求值) | 同上 |
 | runtime dep | `diff` ^9.0.0(**唯一**一条;portability 门按**等值**钉死) | `package.json` `dependencies` |
@@ -9597,3 +9597,32 @@ installCoreValuePorts({ resolveAutonomousLoopPrompt, loosenReasons, combinePolic
 3. **成文改口**:① 「每个已知键恰读一次」射程从「顶层键」改为「顶层键 + `rewind` 四子键 + `settings` 子键」;② 「读器族 11 只整族改齐」补族边界定义(经工厂、返回 `{ kind }`),族外裸字符串读口 `projectMcpReconnectCapability` 本版同律;③ 「型面零变」(0.77.0)指 wire 键 / ChromeEvent 臂零变,不是 `.d.ts` 零变(0.77.0 的 `.d.ts` 差异 = `taskRequest.d.ts` −`agents` +两函数两常量、`persistedRulesWire.d.ts` +写面、`sessionPolicy*` 两只新文件);④ 采外部验收红基线读数:0.76.2 上 `rewind:{model:'HIJACKED'}` 真能覆盖顶层 `model`、`rewind:{maxCostUsd:'5'}` 真能绕过坏值门、`rewind:'abc'` 摊下标键;`settings` 表外子键也抛(0.77.0 §79c G1 有,发车帖正文漏)。
 
 **包侧缺口:** ① 出包面注释存量(别仓名 / 票号 / 帖号 / 过程词)与卫生门判据太窄(CC-100)—— 方案候拍板(dist 去注释 vs 手清),0.77.2 · ② `DeniedBy` 第十词 `read_boundary` / `teamName` / `stillLive` 三词随 sdk 10 型面在 0.78.0 吸收(CC-106)· ③ `capabilities.mcpProbe` 候 core 7.26.0 #951 → server 7.93.0(CC-74)。
+
+## §81 🆕 0.77.2 dist 零注释 + 门词汇表外句改口(patch;型面零变、行为零变)
+
+> **patch**:公面 1143 不变、wire 零新键、peer 地板不动 `>=9.8.1`。两件:① 制品面 —— 构建期去注释,dist `.js` / `.d.ts` 零注释;② 闭集读数改口 —— `gateDeniedByDetail` 表外词兜底句。按 C-R69 全速模式一帖即通知。
+
+### 81a. 处置表
+
+| # | 面 | 本包做了什么 | 端要做什么 |
+|---|---|---|---|
+| S-1 | dist 制品(CC-100) | **changed(制品面)**:`removeComments`;dist 零注释由新门 `run-dist-comments-test.mjs` 钉(`DIST-COMMENT-FAIL`);行为 / 型面逐字节同 0.77.1 | 零改。IDE 悬停不再显示 JSDoc —— 本文档是唯一契约面,按 §NN 段接入;若端侧有「按包注释接」的习惯,从此改按本文档 |
+| S-2 | `gateDeniedByDetail` 表外词兜底句(CC-111 ①) | **changed(闭集读数)**:`denied by a layer this build does not know (<word>) — this build does not know this layer name: a newer engine may have added it, or the record may be damaged; this client cannot tell which`(此前断言「it is damaged」) | 渲染端零改(仍是一句可渲染文本);把这一句钉进快照测试的端按新句改 |
+
+### 81b. 缺席语义(逐键)
+
+- `deniedBy` 表外词(含空串 / 非串):兜底句 = 「本版不认识这个层名」,**不断言坏记录**;原样带上那个词。第十词 `read_boundary`(server ≥7.92.0 已过境)在本包 0.77.x 上就是这一格;它的专属人话句(含读边界含义)随 sdk 10 型面在 0.78.0(CC-106)。
+- dist 零注释对缺席语义无影响;去注释后**字符串字面量与元组类型里的文案仍在**(如请求装配车道表的 `why`、分歧台账),它们是运行期数据不是注释。
+
+### 81c. 黑盒判据骨架
+
+- **G1**:tarball 内每个 `dist/**/*.js` / `*.d.ts` 用 TypeScript 扫描器数注释 trivia ⇒ 0(0.77.1 上 `.js` 33,393 行注释);去注释归一化后逐文件 diff 0.77.1 ⇒ 只差 `gateVocabulary` 与 `request/taskRequest`(后者一处 `why` 串去人名)。
+- **G2**:`gateDeniedByDetail('brand_new_layer')` ⇒ 含 `does not know this layer name` 且含 `brand_new_layer`、不含 `is damaged`;九词各自仍返回专属句(0.77.1 上表外词句含 `so this one is damaged`)。
+
+### 81y. 🔴 三端升级必读(固定段式,[C295])
+
+1. **换钉 `^0.77.2` 之前**:零动作;若有快照测试钉着表外词旧句,按 81a S-2 改。
+2. **零改的面**:§79 / §80 全部内容原样适用;行为与型面逐字节同 0.77.1。
+3. **成文改口**:① 「包源注释 = 对外面」作废 → dist 零注释,源码注释是内部面;对外面 = dist 代码(含字符串字面量 / 类型级文案)+ 四份文档;② 表外词兜底句从「坏记录」改「本版不认识」。
+
+**包侧缺口:** ① 第十词 `read_boundary` 专属句随 sdk 10 抬地板 0.78.0(CC-106)· ② `mandate` 帧位镜像候 core 7.26.0 铸点(CC-110)· ③ 字符串字面量 / 元组类型里的历史台账文案(分歧台账、duty 句)含 `cli` 等产品名与票号 / 帖号,按拍板允许,不再清。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.77.1",
+  "version": "0.77.2",
   "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",