@sema-agent/client-core 0.77.1 → 0.77.2

package/dist/permissionRulesWriteCapability.d.ts

@@ -1,35 +1,3 @@
-/**
- * permissionRulesWriteCapability — `GET /v1/capabilities.permissionRulesWrite`(server ≥7.91.1;sdk 9.8.1
- * 尚未声明该键 ⇒ 结构读)的三端共用读面(0.76.1 CC-102;与 sql / writeProtection / webSearch.backend /
- * executionLane / approvalsStreamLive / deviceExecutor.management / peerLane 各只兄弟同一套四态词汇)。
- *
- * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
- * 「收紧方向的单步规则写入口(把某条工具规则改成 deny/ask 的那一步)对**这一次调用方**够不够得着」。
- * 这一位与「规则车道整体在不在」是上游同一个内部表达式的两次读——车道在场 ∧ 这次调用带得到可验明
- * 的身份——所以两者永远同真同假;但它们**不是同一个位**,原因见下。
- *
- * ── 🔴 读法(两处上游源码逐字一致,别按撤销面那一位类推)─────────────────────────────────────
- *  ① **键缺席 ⇒ 这份二进制比单步写口本身还老**:更早的引擎上,规则车道的其它几口已经在正常
- *     应答(甚至已经报真),但这一条写口压根没有路由——键缺席就是这件事的信号,消费端据此**藏起**
- *     这个写入口(真打了也能认:那类拒绝是裸的「方法不许」形,但不必打了才知道)。
- *  ② **键在场 ⇒ 按这一位自己的值判「这次够不够得着」**:值为 `true`/`false` 直接就是答案,不需要
- *     再去核对车道整体那一位。
- *  ③ ⚠️ **与撤销面那一只存在性信号刻意不同源**:那一位是**部署级**的、与调用方身份无关的布尔(它的
- *     值本身要当版本探针用);本位不是——本位的值同时编码了「车道在不在」与「这次调用带没带得到
- *     身份」两件事,上游明确说这两位的读法不能互相套用。
- *  ④ 位为真**不**保证任意一次写都成功:方向 / 规则文本 / scope 的合法性由每次调用自己的应答逐次
- *     回答,这一位只回答「入口在不在、这次摸不摸得到」。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- *   ① `unobserved`   —— 本进程一次 caps 响应都没观测到。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 引擎比这条写口老(见①),藏入口。
- *   ③ `absent`       —— 键在、值**明确是** `false`:这次调用够不着这条写口(车道没开,或这次调用
- *      带不到可验明的身份)。**正面事实**,与 `not_reported`(判不出)是两件不同的事。
- *   ④ `present`      —— 键在、值为 `true`:这次调用摸得到这条写口。
- * 值既不是 `true` 也不是 `false` ⇒ 畸形 ⇒ 删格(⇒ `unobserved`)。
- * 🔴 三种「没有」(`unobserved` / `not_reported` / `absent`)**不许互折**。
- */
-/** 四态读数。`unobserved` 由读口在这一格空缺时铸,不由投影铸。 */
 export type PermissionRulesWriteReading = {
     kind: 'unobserved';
 } | {
@@ -39,26 +7,12 @@ export type PermissionRulesWriteReading = {
 } | {
     kind: 'present';
 };
-/** caps 回体 → 本格读数;畸形一律 `undefined`(= 这一格不写 ⇒ 读口答 `unobserved`)。 */
 export declare function projectPermissionRulesWriteCapability(caps: unknown): PermissionRulesWriteReading | undefined;
-/** 宿主 caps probe 的读面 tee 落点。绝不 throw;畸形 ⇒ 删格;`opts.generation` 关掉旧探测覆盖新读数的竞态。 */
 export declare function noteEngineCapsForPermissionRulesWrite(baseUrl: string, caps: unknown, opts?: {
     generation?: number;
 }): void;
-/** 本进程观测到的读数;这一格空缺 ⇒ `{kind:'unobserved'}`。 */
 export declare function observedPermissionRulesWrite(baseUrl?: string | undefined): PermissionRulesWriteReading;
-/**
- * 「这次调用摸不摸得到单步写入口」的判据单源(布尔):只有 `present` 才 `true`;其余三态
- * (`absent` / `not_reported` / `unobserved`)一律 `false`——藏入口的默认方向是**保守**的,
- * 判不出与明确没有对「要不要露出这个写按钮」是同一个答案。
- *
- * 🔴 本函数是本位**唯一**的派生点:{@link "./hitl/persistedRulesWire.js".persistedRulesWriteAvailable}
- * 只调用它,不再合取别的位、也不再另读一遍 caps——同一件事只许有一个判官。
- */
 export declare function permissionRulesWriteAvailable(reading: PermissionRulesWriteReading): boolean;
-/** doctor 那一行的 detail 串,唯一措辞真源。🔴 两种「读不出」都不许暗示「够得着」或「够不着」。 */
 export declare function permissionRulesWriteDoctorDetail(reading: PermissionRulesWriteReading): string;
-/** 换代失效口(引擎温切成功后调):清成未观测。空串 ⇒ no-op;绝不 throw。 */
 export declare function forgetPermissionRulesWriteReading(baseUrl: string | undefined): void;
-/** 测试钩子。 */
 export declare function __resetPermissionRulesWriteReadingsForTests(): void;

package/dist/permissionRulesWriteCapability.js

@@ -1,47 +1,12 @@
-/**
- * permissionRulesWriteCapability — `GET /v1/capabilities.permissionRulesWrite`(server ≥7.91.1;sdk 9.8.1
- * 尚未声明该键 ⇒ 结构读)的三端共用读面(0.76.1 CC-102;与 sql / writeProtection / webSearch.backend /
- * executionLane / approvalsStreamLive / deviceExecutor.management / peerLane 各只兄弟同一套四态词汇)。
- *
- * ── 这一位答的是哪一个问题 ────────────────────────────────────────────────────────────────
- * 「收紧方向的单步规则写入口(把某条工具规则改成 deny/ask 的那一步)对**这一次调用方**够不够得着」。
- * 这一位与「规则车道整体在不在」是上游同一个内部表达式的两次读——车道在场 ∧ 这次调用带得到可验明
- * 的身份——所以两者永远同真同假;但它们**不是同一个位**,原因见下。
- *
- * ── 🔴 读法(两处上游源码逐字一致,别按撤销面那一位类推)─────────────────────────────────────
- *  ① **键缺席 ⇒ 这份二进制比单步写口本身还老**:更早的引擎上,规则车道的其它几口已经在正常
- *     应答(甚至已经报真),但这一条写口压根没有路由——键缺席就是这件事的信号,消费端据此**藏起**
- *     这个写入口(真打了也能认:那类拒绝是裸的「方法不许」形,但不必打了才知道)。
- *  ② **键在场 ⇒ 按这一位自己的值判「这次够不够得着」**:值为 `true`/`false` 直接就是答案,不需要
- *     再去核对车道整体那一位。
- *  ③ ⚠️ **与撤销面那一只存在性信号刻意不同源**:那一位是**部署级**的、与调用方身份无关的布尔(它的
- *     值本身要当版本探针用);本位不是——本位的值同时编码了「车道在不在」与「这次调用带没带得到
- *     身份」两件事,上游明确说这两位的读法不能互相套用。
- *  ④ 位为真**不**保证任意一次写都成功:方向 / 规则文本 / scope 的合法性由每次调用自己的应答逐次
- *     回答,这一位只回答「入口在不在、这次摸不摸得到」。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- *   ① `unobserved`   —— 本进程一次 caps 响应都没观测到。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 引擎比这条写口老(见①),藏入口。
- *   ③ `absent`       —— 键在、值**明确是** `false`:这次调用够不着这条写口(车道没开,或这次调用
- *      带不到可验明的身份)。**正面事实**,与 `not_reported`(判不出)是两件不同的事。
- *   ④ `present`      —— 键在、值为 `true`:这次调用摸得到这条写口。
- * 值既不是 `true` 也不是 `false` ⇒ 畸形 ⇒ 删格(⇒ `unobserved`)。
- * 🔴 三种「没有」(`unobserved` / `not_reported` / `absent`)**不许互折**。
- */
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
-/** caps 回体 → 本格读数;畸形一律 `undefined`(= 这一格不写 ⇒ 读口答 `unobserved`)。 */
 export function projectPermissionRulesWriteCapability(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, 'permissionRulesWrite'))
         return { kind: 'not_reported' };
-    // 🔴 只读一次:在场判据与取值同一次读。
     const v = caps.permissionRulesWrite;
     if (v === undefined)
         return { kind: 'not_reported' };
@@ -49,37 +14,20 @@ export function projectPermissionRulesWriteCapability(caps) {
         return undefined;
     return v ? { kind: 'present' } : { kind: 'absent' };
 }
-/**
- * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 能力位读器**共用同一份实现**
- * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数
- * {@link projectPermissionRulesWriteCapability}、doctor 措辞表,以及本位自己的判据助手。
- * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面。
- */
 const reader = createEngineCapReader({
     name: 'permissionRulesWrite',
     project: projectPermissionRulesWriteCapability,
     makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-/** 宿主 caps probe 的读面 tee 落点。绝不 throw;畸形 ⇒ 删格;`opts.generation` 关掉旧探测覆盖新读数的竞态。 */
 export function noteEngineCapsForPermissionRulesWrite(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
 }
-/** 本进程观测到的读数;这一格空缺 ⇒ `{kind:'unobserved'}`。 */
 export function observedPermissionRulesWrite(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-/**
- * 「这次调用摸不摸得到单步写入口」的判据单源(布尔):只有 `present` 才 `true`;其余三态
- * (`absent` / `not_reported` / `unobserved`)一律 `false`——藏入口的默认方向是**保守**的,
- * 判不出与明确没有对「要不要露出这个写按钮」是同一个答案。
- *
- * 🔴 本函数是本位**唯一**的派生点:{@link "./hitl/persistedRulesWire.js".persistedRulesWriteAvailable}
- * 只调用它,不再合取别的位、也不再另读一遍 caps——同一件事只许有一个判官。
- */
 export function permissionRulesWriteAvailable(reading) {
     return reading.kind === 'present';
 }
-/** doctor 那一行的 detail 串,唯一措辞真源。🔴 两种「读不出」都不许暗示「够得着」或「够不着」。 */
 export function permissionRulesWriteDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
@@ -92,11 +40,9 @@ export function permissionRulesWriteDoctorDetail(reading) {
             return 'permission-rule write entry reachable for this call — a per-call attempt still answers for itself whether the direction, text, and scope are accepted';
     }
 }
-/** 换代失效口(引擎温切成功后调):清成未观测。空串 ⇒ no-op;绝不 throw。 */
 export function forgetPermissionRulesWriteReading(baseUrl) {
     reader.forget(baseUrl);
 }
-/** 测试钩子。 */
 export function __resetPermissionRulesWriteReadingsForTests() {
     reader.__resetForTests();
 }

package/dist/permissionWireCaps.d.ts

@@ -1,44 +1,7 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/permissionWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/permissionWireCaps.ts — PURE CC permission-mode INTENT projection (R4, revised per the two-axis
- * seamless principle). seamQuery imports it.
- *
- * 🔴 Design (memory seamless-two-axis-wire-principle): the frontend carries the RAW permission-mode INTENT; the
- * SERVICE interprets it (axis-aware, tighten-only). We do NOT pre-interpret `plan → enablePlanMode+handsReadOnly`
- * on the client — that bakes policy into one frontend and would drift between the TUI shell and the web portal.
- * Instead we stamp `permissionMode` and let the service own the interpretation (plan ⇒ present_plan + read-only;
- * acceptEdits/bypassPermissions ⇒ loosening, coerced to default engine-side, enforced client-side). This keeps the
- * shell a thin per-turn intent projector that's identical across TOC-local / TOB-cloud / centralized-session axes.
- *
- * `auto`(分类器批3,[907] server 五模式表):server ≥1.209 coercePermissionMode 认 "auto"
- * (解释 = default 同款 fs 写 ask 门;存活 ask 由引擎侧 auto-mode 分类器先行裁决——武装 AND 门
- * RuntimeCaps.autoMode ∧ RunnerDeps.autoMode,缺一静默回 ask,fail-closed)。壳只透传意图,分类器
- * 规则/权益都在装配面,非 TaskSpec 字段。版本安全:老 server coerce 未知非空词 → "default"
- * (manual ask 门)= 只紧不松。
- */
 export type PermissionMode = 'default' | 'plan' | 'acceptEdits' | 'bypassPermissions' | 'auto';
 export interface PermissionModeField {
     permissionMode?: PermissionMode;
 }
-/**
- * Project the client's permission mode → the wire intent. Carries any KNOWN non-`default` mode verbatim (the
- * service interprets); `default`/unknown/undefined ⇒ no stamp (the deployment baseline governs). No policy baked
- * here — relevance + tighten-only governance is the service's job.
- *
- * `stampDefault`([830]① server 1.191 五模式解释层):server 侧 absent-mode 不挂门,manual(=CC
- * default)要挂 fs 写 ask 门必须显式 stamp `permissionMode:"default"`。老 server 对 "default" 走
- * basePolicy(与 absent 等价),version-safe。
- *
- * 🔴 现有三个 `stampDefault:true` 调用点(2026-08-05 起,别再按「只有交互 REPL 传 true」读这段——
- * 那句旧话在 [2713] 之前就已被 env 支推翻,照它去「恢复」旧形 = 静默重开 P0 断链):
- *   · 交互 REPL(seamQuery,leader ToolUseConfirm 队列已注册 ⇒ 三选卡真弹得出来);
- *   · headless env 支(headlessPermissionModeWire,SEMA_HEADLESS_PERMISSION_MODE = 显式垫层旋钮);
- *   · headless flag 支([2713] 根修:`--permission-mode default|manual|dontAsk` 显式表态必须 stamp,
- *     否则 server `deriveSettingsPolicy` 因 `!perms` 返回 `{}` ⇒ print 车道**全无客户端门**)。
- * 不传 `stampDefault` 的调用方(缺省 false)= 「没有表态」,继续吃部署基线,行为逐字不变。
- */
 export declare function permissionModeField(mode: string | undefined, opts?: {
     stampDefault?: boolean;
 }): PermissionModeField;

package/dist/permissionWireCaps.js

@@ -1,23 +1,3 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/permissionWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/permissionWireCaps.ts — PURE CC permission-mode INTENT projection (R4, revised per the two-axis
- * seamless principle). seamQuery imports it.
- *
- * 🔴 Design (memory seamless-two-axis-wire-principle): the frontend carries the RAW permission-mode INTENT; the
- * SERVICE interprets it (axis-aware, tighten-only). We do NOT pre-interpret `plan → enablePlanMode+handsReadOnly`
- * on the client — that bakes policy into one frontend and would drift between the TUI shell and the web portal.
- * Instead we stamp `permissionMode` and let the service own the interpretation (plan ⇒ present_plan + read-only;
- * acceptEdits/bypassPermissions ⇒ loosening, coerced to default engine-side, enforced client-side). This keeps the
- * shell a thin per-turn intent projector that's identical across TOC-local / TOB-cloud / centralized-session axes.
- *
- * `auto`(分类器批3,[907] server 五模式表):server ≥1.209 coercePermissionMode 认 "auto"
- * (解释 = default 同款 fs 写 ask 门;存活 ask 由引擎侧 auto-mode 分类器先行裁决——武装 AND 门
- * RuntimeCaps.autoMode ∧ RunnerDeps.autoMode,缺一静默回 ask,fail-closed)。壳只透传意图,分类器
- * 规则/权益都在装配面,非 TaskSpec 字段。版本安全:老 server coerce 未知非空词 → "default"
- * (manual ask 门)= 只紧不松。
- */
 const KNOWN = new Set([
     'default',
     'plan',
@@ -25,23 +5,6 @@ const KNOWN = new Set([
     'bypassPermissions',
     'auto',
 ]);
-/**
- * Project the client's permission mode → the wire intent. Carries any KNOWN non-`default` mode verbatim (the
- * service interprets); `default`/unknown/undefined ⇒ no stamp (the deployment baseline governs). No policy baked
- * here — relevance + tighten-only governance is the service's job.
- *
- * `stampDefault`([830]① server 1.191 五模式解释层):server 侧 absent-mode 不挂门,manual(=CC
- * default)要挂 fs 写 ask 门必须显式 stamp `permissionMode:"default"`。老 server 对 "default" 走
- * basePolicy(与 absent 等价),version-safe。
- *
- * 🔴 现有三个 `stampDefault:true` 调用点(2026-08-05 起,别再按「只有交互 REPL 传 true」读这段——
- * 那句旧话在 [2713] 之前就已被 env 支推翻,照它去「恢复」旧形 = 静默重开 P0 断链):
- *   · 交互 REPL(seamQuery,leader ToolUseConfirm 队列已注册 ⇒ 三选卡真弹得出来);
- *   · headless env 支(headlessPermissionModeWire,SEMA_HEADLESS_PERMISSION_MODE = 显式垫层旋钮);
- *   · headless flag 支([2713] 根修:`--permission-mode default|manual|dontAsk` 显式表态必须 stamp,
- *     否则 server `deriveSettingsPolicy` 因 `!perms` 返回 `{}` ⇒ print 车道**全无客户端门**)。
- * 不传 `stampDefault` 的调用方(缺省 false)= 「没有表态」,继续吃部署基线,行为逐字不变。
- */
 export function permissionModeField(mode, opts) {
     if (typeof mode === 'string' && mode !== 'default' && KNOWN.has(mode)) {
         return { permissionMode: mode };

package/dist/postureKnob.d.ts

@@ -1,91 +1,20 @@
-/**
- * 一个旋钮的值是谁定的 —— 四词闭集,**顺序即优先序**(engine 侧是穷举 switch,加词在那里编译红)。
- *   · `env` —— 这台机器的 env 变量钉的(部署主权,恒赢任何下发值);
- *   · `center` —— 配置中心发布的(重启生效;本机写同名 env 即把这个键收回);
- *   · `posture` —— 从**部署形**派生的(单用户 turnkey);
- *   · `engine-default` —— 没人钉过,内建缺省在岗。
- * 🔴 本包按**开集**读实际值(词表属主在引擎侧,加词不该让消费端把一个合法读数判没);这张表是
- *    **优先序与判据**的真源,不是一道准入门。
-
- * 🔴 形制:`Object.freeze` 的数组,**不是**只在类型面只读的 `readonly T[]` —— 后者一行 `.splice()`
- *    就能改,而公面消费者拿到的正是这个实例(本仓已定谳的病形,同 `RESUME_RETRY_LATER_CODES`)。
- */
 export declare const POSTURE_SOURCE_WORDS: readonly string[];
-/**
- * 「**运维显式表态过吗**」——只有 `env` / `center` 两词算数。
- *
- * 🔴 `posture` 派生出来的 `true` **不是**「有人要求过」:它是部署形状的推论,换一台机器就变。
- *    把它读成表态,会让「运维明确开过这个开关」这句话在一台谁都没碰过的机器上为真。
- * 🔴 表外词(开集逃生口)一律**不算**表态:读不懂的来源不是「有人钉过」的证据。
- */
 export declare function postureSourceIsOperatorPinned(source: string): boolean;
-/** 一根旋钮的读数视图(sdk `PostureKnobReading<V>` 的防御读形;结构逐字同源,见文件尾对账钉)。 */
 export interface PostureKnobView<V> {
-    /** 这根旋钮此刻的生效值。 */
     value: V;
-    /**
-     * 这个值是谁定的。**按开集读**(闭四词见 {@link POSTURE_SOURCE_WORDS})。
-     * 🔴 `legacy` 为真时这一格**不是一次观测**,只是形上的占位 —— 机读一律走
-     *    {@link postureKnobSourceOf}。
-     */
     source: string;
-    /** 给运维的指路句(逐键专属的散文,**不是机读码**:分类读 `source`,别对它做等值匹配)。
-     *  UNTRUSTED-for-display:呈前消毒 + 封长,见 {@link postureKnobDetail}。 */
     note: string;
-    /** 这份读数是从 <7.67.0 worker 的**裸值**形折出来的(那台 worker 说不出来源)。 */
     legacy?: true;
 }
-/**
- * 这根旋钮的来源词,**答不出来就答不出来**。
- * 🔴 legacy 行(老 worker 的裸值)⇒ `undefined`:形上的占位值不是一次观测,交出去就是编答案。
- */
 export declare function postureKnobSourceOf(knob: PostureKnobView<unknown> | undefined): string | undefined;
-/** `serverGates` 上三根 posture 旋钮的读数。 */
 export interface ServerGateKnobsView {
-    /** 耐久审批门总开关。**本面的判别锚**:它读不出来 ⇒ 整段缺席(见 {@link projectServerGateKnobs})。 */
     durableApproval: PostureKnobView<boolean>;
-    /** 审批窗(毫秒)。<7.67.0 整键缺席 ⇒ 这一格缺席 —— **绝不**铸 300000 的默认冒充读数。 */
     streamAskWindowMs?: PostureKnobView<number>;
-    /** 会话自动起标题。同上,缺席即缺席。 */
     sessionAutoTitle?: PostureKnobView<boolean>;
-    /** 这份读数整体是从老 worker 的裸值形折出来的。 */
     legacy: boolean;
 }
-/** 三根旋钮的名字(给人读的);措辞铸点按它取词,端零自拼。 */
 export type PostureKnobName = 'durableApproval' | 'streamAskWindowMs' | 'sessionAutoTitle';
-/**
- * `wiring.serverGates` → 三旋钮读数;**畸形一律 `undefined`**,绝不抛出。
- *
- * 🔴 **判别锚是 `durableApproval`**:它是这一面上唯一**两代都在**的旋钮(老 worker 上是裸布尔,
- *    新 worker 上是读数)。它读不出来 ⇒ 整段缺席 —— 一份没有主锚的旋钮面答不了运维要问的那一问,
- *    而半段会被当成完整答案(与 `writeProtectionPosture` 缺 `source` ⇒ 整段缺席同一条纪律)。
- * 🔴 **旁枝坏形只丢那一根**:`streamAskWindowMs` / `sessionAutoTitle` 各自独立,一根形坏不该把
- *    另外两根一起藏起来(旁枝与主锚的处置刻意不同,理由见上一条)。
- * 🔴 **缺席不铸默认**:另两根整键缺席时这两格就是缺席。铸 `300000` / `true` 会把「这台 worker
- *    说不出来」渲成「它说了这个值」——那正是本面存在要根治的病。
- * ⚠️ 「整键缺席(老 worker)」与「在场但形坏」在旁枝上折成同一个缺席;「为什么答不出来」不是
- *    这一位该回答的(见 {@link postureKnobDetail} 的 `reachable` 段)。
- */
 export declare function projectServerGateKnobs(wiring: unknown): ServerGateKnobsView | undefined;
-/**
- * 四态措辞的**唯一铸点**(三端共用一句话;别在各端的行装配里另写一遍 —— 与
- * `readFacePostureDetail` / `writeProtectionDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句刻意**逐字互异**(黑盒锚),对运维是四条不同的下一步:
- *   ① 读数在场 —— `<旋钮> <值> (source: <来源> — <指路句>)`;
- *   ② 读数在场但来自老 worker 的裸值(`legacy`)—— 报得出**值**,但逐字点明「这台 worker 说不出
- *      是谁定的」;**句中不出现任何来源词**(冒称来源比不说更坏:它会让人以为查过了);
- *   ③ `opts.reachable === false` —— 「未观测」:这一次进程没读到 operator 响应。
- *      🔴 **这一格先判**(0.63.1):它压过任何在手的读数 —— 宿主拿着上一拍的 view、这一拍探测
- *      打不通时,它能翻的只有这一位;先看读数在不在会照渲上一拍的值,等于拿陈读数冒充现势;
- *   ④ `reachable:true` 但读数仍缺席 —— 「不报」:响应读到了,只是这一位读不出来。
- *      **不武断咎为版本**:整键缺席(老引擎)与在场却形坏折成同一个缺席,句子不能替一种情形撒谎。
- * 🔴 ③④ 两句**一个值都不报** —— 它们要是顺口说了 `off`,消费端就会把「读不出」当成「关着」。
- *
- * ⚠️ **数值一律按毫秒读**:本面今天唯一的数值旋钮就是那只毫秒窗(门里有一条对 sdk spec 的钉:
- *    `ServerWiringGates` 上 `type: number` 的旋钮恰一根)。上游哪天加第二根非时长数值旋钮,那条
- *    钉先红,免得这里的措辞开始对它撒谎。
- */
 export declare function postureKnobDetail(knob: PostureKnobView<boolean | number> | undefined, opts: {
     reachable: boolean;
     knob: PostureKnobName;

package/dist/postureKnob.js

@@ -1,47 +1,20 @@
 import { capForDisplay } from './fleetTaskDesc.js';
-/**
- * 一个旋钮的值是谁定的 —— 四词闭集,**顺序即优先序**(engine 侧是穷举 switch,加词在那里编译红)。
- *   · `env` —— 这台机器的 env 变量钉的(部署主权,恒赢任何下发值);
- *   · `center` —— 配置中心发布的(重启生效;本机写同名 env 即把这个键收回);
- *   · `posture` —— 从**部署形**派生的(单用户 turnkey);
- *   · `engine-default` —— 没人钉过,内建缺省在岗。
- * 🔴 本包按**开集**读实际值(词表属主在引擎侧,加词不该让消费端把一个合法读数判没);这张表是
- *    **优先序与判据**的真源,不是一道准入门。
-
- * 🔴 形制:`Object.freeze` 的数组,**不是**只在类型面只读的 `readonly T[]` —— 后者一行 `.splice()`
- *    就能改,而公面消费者拿到的正是这个实例(本仓已定谳的病形,同 `RESUME_RETRY_LATER_CODES`)。
- */
 export const POSTURE_SOURCE_WORDS = Object.freeze(['env', 'center', 'posture', 'engine-default']);
-/**
- * 「**运维显式表态过吗**」——只有 `env` / `center` 两词算数。
- *
- * 🔴 `posture` 派生出来的 `true` **不是**「有人要求过」:它是部署形状的推论,换一台机器就变。
- *    把它读成表态,会让「运维明确开过这个开关」这句话在一台谁都没碰过的机器上为真。
- * 🔴 表外词(开集逃生口)一律**不算**表态:读不懂的来源不是「有人钉过」的证据。
- */
 export function postureSourceIsOperatorPinned(source) {
     return source === 'env' || source === 'center';
 }
-/**
- * 这根旋钮的来源词,**答不出来就答不出来**。
- * 🔴 legacy 行(老 worker 的裸值)⇒ `undefined`:形上的占位值不是一次观测,交出去就是编答案。
- */
 export function postureKnobSourceOf(knob) {
     if (knob === undefined || knob.legacy === true)
         return undefined;
     return knob.source;
 }
-/** 旋钮 → 人话名。**唯一铸点**(三端共用一套词;别在各端的行装配里另起一份)。 */
 const KNOB_LABELS = Object.freeze({
     durableApproval: 'durable approval',
     streamAskWindowMs: 'approval window',
     sessionAutoTitle: 'session auto-title',
 });
-/** `note` 上屏封长(UTF-16 单元,按**转义后**的长度算;与 readFace 那一格同值同理由)。 */
 const KNOB_NOTE_MAX = 256;
-/** `source` 上屏封长(同上)。 */
 const KNOB_WORD_MAX = 40;
-/** 一只 `{value, source, note}` 读数的公共窄读(值判据由调用方给)。坏形 ⇒ `undefined`。 */
 function readKnob(raw, valueOk) {
     if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
         return undefined;
@@ -50,27 +23,12 @@ function readKnob(raw, valueOk) {
         return undefined;
     if (typeof r.source !== 'string' || r.source.length === 0)
         return undefined;
-    // `note` 允许空串(自由文本;空文本本身也是一句读数,不是「读不出」)。
     if (typeof r.note !== 'string')
         return undefined;
     return { value: r.value, source: r.source, note: r.note };
 }
 const isBool = (v) => typeof v === 'boolean';
-/** 窗值:有限**非负**数(负窗在引擎侧是拒启门,一个负数读数是坏形不是事实)。 */
 const isWindowMs = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
-/**
- * `wiring.serverGates` → 三旋钮读数;**畸形一律 `undefined`**,绝不抛出。
- *
- * 🔴 **判别锚是 `durableApproval`**:它是这一面上唯一**两代都在**的旋钮(老 worker 上是裸布尔,
- *    新 worker 上是读数)。它读不出来 ⇒ 整段缺席 —— 一份没有主锚的旋钮面答不了运维要问的那一问,
- *    而半段会被当成完整答案(与 `writeProtectionPosture` 缺 `source` ⇒ 整段缺席同一条纪律)。
- * 🔴 **旁枝坏形只丢那一根**:`streamAskWindowMs` / `sessionAutoTitle` 各自独立,一根形坏不该把
- *    另外两根一起藏起来(旁枝与主锚的处置刻意不同,理由见上一条)。
- * 🔴 **缺席不铸默认**:另两根整键缺席时这两格就是缺席。铸 `300000` / `true` 会把「这台 worker
- *    说不出来」渲成「它说了这个值」——那正是本面存在要根治的病。
- * ⚠️ 「整键缺席(老 worker)」与「在场但形坏」在旁枝上折成同一个缺席;「为什么答不出来」不是
- *    这一位该回答的(见 {@link postureKnobDetail} 的 `reachable` 段)。
- */
 export function projectServerGateKnobs(wiring) {
     if (typeof wiring !== 'object' || wiring === null || Array.isArray(wiring))
         return undefined;
@@ -82,8 +40,6 @@ export function projectServerGateKnobs(wiring) {
     let durableApproval;
     let legacy = false;
     if (typeof raw === 'boolean') {
-        // 老 worker(<7.67.0)的裸布尔:折进同一只壳,但立 legacy 位。`source` 是形上的占位,
-        // **不是**一次观测 —— 机读走 `postureKnobSourceOf`(它对 legacy 行答 undefined)。
         durableApproval = { value: raw, source: 'engine-default', note: '', legacy: true };
         legacy = true;
     }
@@ -101,14 +57,7 @@ export function projectServerGateKnobs(wiring) {
         legacy,
     };
 }
-/**
- * 毫秒 → 人话。
- * 🔴 **只在整除时才升单位**:`90m` 比 `1.5h` 更不容易被读错,而 `5400000ms` 谁也读不出是一个半
- *    小时。除不尽 ⇒ 原样报毫秒(诚实优于好看)。
- */
 function humanMs(ms) {
-    // 天不单列:`24h` 比 `1d` 更贴近运维钉回时写的那个数(`STREAM_ASK_WINDOW_MS`),小时这一档
-    // 已经把它读成人话了。
     if (ms > 0 && ms % 3600000 === 0)
         return `${ms / 3600000}h`;
     if (ms > 0 && ms % 60000 === 0)
@@ -117,41 +66,13 @@ function humanMs(ms) {
         return `${ms / 1000}s`;
     return `${ms}ms`;
 }
-/** 值 → 上屏词。布尔渲 `on`/`off`(`true`/`false` 是给机器读的);数值按毫秒渲人话。 */
 function knobValueWord(value) {
     if (typeof value === 'boolean')
         return value ? 'on' : 'off';
     return humanMs(value);
 }
-/**
- * 四态措辞的**唯一铸点**(三端共用一句话;别在各端的行装配里另写一遍 —— 与
- * `readFacePostureDetail` / `writeProtectionDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句刻意**逐字互异**(黑盒锚),对运维是四条不同的下一步:
- *   ① 读数在场 —— `<旋钮> <值> (source: <来源> — <指路句>)`;
- *   ② 读数在场但来自老 worker 的裸值(`legacy`)—— 报得出**值**,但逐字点明「这台 worker 说不出
- *      是谁定的」;**句中不出现任何来源词**(冒称来源比不说更坏:它会让人以为查过了);
- *   ③ `opts.reachable === false` —— 「未观测」:这一次进程没读到 operator 响应。
- *      🔴 **这一格先判**(0.63.1):它压过任何在手的读数 —— 宿主拿着上一拍的 view、这一拍探测
- *      打不通时,它能翻的只有这一位;先看读数在不在会照渲上一拍的值,等于拿陈读数冒充现势;
- *   ④ `reachable:true` 但读数仍缺席 —— 「不报」:响应读到了,只是这一位读不出来。
- *      **不武断咎为版本**:整键缺席(老引擎)与在场却形坏折成同一个缺席,句子不能替一种情形撒谎。
- * 🔴 ③④ 两句**一个值都不报** —— 它们要是顺口说了 `off`,消费端就会把「读不出」当成「关着」。
- *
- * ⚠️ **数值一律按毫秒读**:本面今天唯一的数值旋钮就是那只毫秒窗(门里有一条对 sdk spec 的钉:
- *    `ServerWiringGates` 上 `type: number` 的旋钮恰一根)。上游哪天加第二根非时长数值旋钮,那条
- *    钉先红,免得这里的措辞开始对它撒谎。
- */
 export function postureKnobDetail(knob, opts) {
-    // 🔴 **按自有属性查表**(同形族扫):键在型面上是闭三词,但本口吃的是运行期值 —— 一个 JS 调用方
-    //    塞进 `toString`,裸下标会命中 `Object.prototype` 上的函数并被拼进句子。读不出名字时退到
-    //    一个中性词:**名字读不出不该让「这根旋钮的值是什么」也一起说不出来**。
     const label = Object.hasOwn(KNOB_LABELS, opts.knob) ? KNOB_LABELS[opts.knob] : 'posture knob';
-    // 🔴 **判序承重**(0.63.1,G-3):`!reachable` **先判**,压过任何在手的读数。调用惯例上宿主手里
-    //    就只有上一拍那一只 view —— 探测这一拍打不通时它能翻的只有 `reachable`,别的没得换。先看
-    //    `knob !== undefined` 的旧序会照渲**上一拍的读数**,屏上一个字都看不出这一次根本没读到,
-    //    等于把陈读数冒充现势。打不通时旧读数不是现势:值与来源词一个都不许漏出去。
-    //    ⇒ 求值序是 ③ → ①/② → ④(与上方四句的编号次序无关,编号只是四种情形的清单)。
     if (!opts.reachable) {
         return `${label} not observed (this end could not read the engine's diagnostics)`;
     }
@@ -168,13 +89,6 @@ export function postureKnobDetail(knob, opts) {
     }
     return `${label} not reported by this engine (an engine below 7.67.0, or a response this end could not parse)`;
 }
-/**
- * **编译期对账钉**(不出公面):sdk 的读数形必须能赋给本视图,`ServerWiringGates` 的三根旋钮
- * 必须真是读数形 —— 上游改形时这一行是本包第一个红的地方。
- *
- * 🔴 反向**刻意不钉**(本视图不必能赋给 sdk 形):`source` 在本视图上放宽成任意 `string`(开集读),
- * 那是**故意比铸点宽** —— 窄读域只许等于或宽于铸点域,钉反向会把这条纪律反过来判成错。
- */
 const _postureKnobShapePin = (w) => w;
 void _postureKnobShapePin;
 const _serverGateKnobsShapePin = (g) => g;

package/dist/principalWire.d.ts

@@ -1,18 +1 @@
-/**
- * principalWire.ts — principal 在场性判定的**唯一原语**(A-028.10,#244 族E,2026-08-15)。
- *
- * 裁定背景(cli 主会话裁,census top-07 §2):壳 `livePrincipal.ts` 与本包
- * `engineWireTarget.engineWireTargetFor()` 各持一条 principal 解析,且**语义相反**:壳判
- * `v && v.trim() !== ''`(全空白=缺席),包侧裸 truthy(全空白=在场)⇒ `SEMA_LIVE_PRINCIPAL='   '`
- * 会发出一个全空白的 `x-agent-principal` 头 —— 垃圾值伪装在场,破坏 F-011 停发纪律
- * ([3279]:缺席=不发头,owner-null;绝不铸哨兵值)。裁定=壳 trim 语义为正,包侧两臂
- * (env 派生臂 + 显式装配臂)都收编本原语。
- *
- * 🔴 语义逐字(壳 `resolveLivePrincipal` 的判定半场):
- *   · undefined / '' / 全空白 ⇒ undefined(键缺席,不发头);
- *   · 其余 ⇒ **原值原样返回**(不 trim 改写 —— ` alice ` 照发 ` alice `,在场性判定与值改写
- *     是两件事,本原语只做前者)。
- * env 的读取方式留在端上(壳读 `process.env`,包内经 `hostEnv()`)——本原语零 IO 零 env。
- */
-/** principal 在场性判定:全空白=缺席(undefined);实值原样返回(绝不改写)。 */
 export declare function normalizeWirePrincipal(v: string | undefined): string | undefined;

package/dist/principalWire.js

@@ -1,20 +1,3 @@
-/**
- * principalWire.ts — principal 在场性判定的**唯一原语**(A-028.10,#244 族E,2026-08-15)。
- *
- * 裁定背景(cli 主会话裁,census top-07 §2):壳 `livePrincipal.ts` 与本包
- * `engineWireTarget.engineWireTargetFor()` 各持一条 principal 解析,且**语义相反**:壳判
- * `v && v.trim() !== ''`(全空白=缺席),包侧裸 truthy(全空白=在场)⇒ `SEMA_LIVE_PRINCIPAL='   '`
- * 会发出一个全空白的 `x-agent-principal` 头 —— 垃圾值伪装在场,破坏 F-011 停发纪律
- * ([3279]:缺席=不发头,owner-null;绝不铸哨兵值)。裁定=壳 trim 语义为正,包侧两臂
- * (env 派生臂 + 显式装配臂)都收编本原语。
- *
- * 🔴 语义逐字(壳 `resolveLivePrincipal` 的判定半场):
- *   · undefined / '' / 全空白 ⇒ undefined(键缺席,不发头);
- *   · 其余 ⇒ **原值原样返回**(不 trim 改写 —— ` alice ` 照发 ` alice `,在场性判定与值改写
- *     是两件事,本原语只做前者)。
- * env 的读取方式留在端上(壳读 `process.env`,包内经 `hostEnv()`)——本原语零 IO 零 env。
- */
-/** principal 在场性判定:全空白=缺席(undefined);实值原样返回(绝不改写)。 */
 export function normalizeWirePrincipal(v) {
     return v !== undefined && v.trim() !== '' ? v : undefined;
 }