@sema-agent/client-core 0.63.2 → 0.64.0

package/docs/INTEGRATION-CLIENTS.md

@@ -23,7 +23,7 @@
 | peer:wire 契约 | `@sema-agent/sdk` **>=8.4.0**(value-level,非 type-only;**0.60.0 抬版**,四条硬理由见 §24a 与 `scripts/run-sdk-floor-test.mjs` 的 `FLOOR` 注;上一次是 0.59.0 的 `>=8.3.0`)。🔴 支持窗同批收到 **engine ≥7.64.0**:sdk 8.4.0 与 7.63.0 及以前的 wire **不同窗** | `package.json` `peerDependencies` |
 | peer:会话词汇表 | `@sema-agent/agent-types` **>=0.2.0**(type-only,零运行时) | 同上 |
 | runtime dep | `diff` ^9.0.0(**唯一**一条;portability 门按**等值**钉死) | `package.json` `dependencies` |
-| 公开导出面 | **905** 个运行期符号(+ 44 个测试钩;= 工作树当下的值 = **0.63.0 八件 additive、零删除**:`projectServerGateKnobs`/`postureKnobSourceOf`/`postureSourceIsOperatorPinned`/`postureKnobDetail`/`POSTURE_SOURCE_WORDS`(S-178 三根 posture 旋钮读数,详见 §27b)/ `PERSISTED_RULE_BEHAVIORS`/`PERSISTED_RULE_BEHAVIOR_UNKNOWN`/`persistedRuleBehaviorOf`/`persistedRuleBehaviorLabel`/`revokeTargetFromPersistedRule`(三态规则身份,§27c)/ `engineIdentityOf`/`engineIdentityVerdict`/`engineIdentityChanged`/`engineIdentityChangedBy`/`ENGINE_IDENTITY_ANCHORS`(S-179 代际锚,§27d)/ `GATE_DENIED_BY_WORDS`/`gateDeniedByDetail`/`ASK_ORIGIN_WORDS`/`askOriginDetail`(门词汇 +2,§27e)/ `PERMISSION_RULE_ISSUE_CODES`/`RETIRED_PERMISSION_RULE_ISSUE_CODES`/`permissionRuleIssueDetail`(规则 lint 码表,§27f)/ `projectToolRoster`/`toolRosterNames`/`toolShimFromRoster`/`applyToolRosterDelta`(L-161 工具名册,§27g)/ `ENGINE_NOTICE_CODES`/`ENGINE_NOTICE_AUDIENCE`/`noticeAudienceOf`/`engineNoticeInCatalog`/`MCP_INJECTION_DROP_REASONS`/`readMcpInjectionDrop`(L-167 通告码册,§27h)/ `AUTO_MODE_UNAVAILABLE_CAUSES`/`AUTO_MODE_BREAKER_CAUSES`/`classifierUnavailableOf`/`classifierUnavailableDetail`(件⑧ 分类器不可用事实,§27h2);`0.62.0` 是 **869**,那批是五件 additive、**零删除**:`capForDisplay`(呈前消毒 + 封长的共用铸点,详见 §26⑦)/ `SEAT_SEND_MESSAGE_KEY_ORIGINS`(座位载荷逐键出身表,详见 §26③)/ `configureSubagentContentStore`+`subagentContentStoreConfig`+`SUBAGENT_CONTENT_STORE_DEFAULTS`(子代内容账本字节预算,测试钩 `__resetSubagentContentStoreConfigForTests` +1,详见 §26②);`0.61.0` 是 **864**,那批是三件 additive、**零删除**:`projectReadFacePosture`/`readFacePostureDetail`/`readFaceDisagreement`(S-167 READ 容纳面 operator 读器,详见 §25);`0.60.0` 是 **861**,那批是二十五件 additive、**零删除**:`readRunTerminal`/`runTerminalCode`/`runTerminalGateKind`/`runTerminalGateToolName`/`isReviewPark`/`REVIEW_PARK_GATE_KINDS` 六件终局因由读器 + `gateOutcomeOf`/`isDeniedGate`/`gateDeniedBy`/`gateApprover`/`isApprovalWindowExpiredGate`/`isDenialLimitAutoDeniedGate`/`isParkSlaExpiredGate`/`isHumanSettledGate` 八件门记录读器 + `projectWriteProtectionCapability`/`noteEngineCapsForWriteProtection`/`observedWriteProtection`/`forgetWriteProtectionReading`/`writeProtectionDoctorDetail`/`projectWriteProtectionPosture`/`writeProtectionPostureDetail` 七件写保护读面(测试钩 `__resetWriteProtectionReadingsForTests` +1)+ `readWireErrorCode` + 真机边界①的两件 `isGateParkedToolEnd`/`GATE_PARKED_ERROR_CODE` + 异源复审逼出的 `engineCapsGeneration`;`0.59.0` 是 **836**,那批是八件 additive:`RULE_OFFERS_ABSENCE_REASONS`/`DENIAL_LIMIT_KINDS` 两张闭词表再导出 + `engineCapValue` 能力位四态通用读口 + `projectSqlEngineCapability`/`observedSqlEngine`/`noteEngineCapsForSqlEngine`/`forgetSqlEngineReading`/`sqlEngineDoctorDetail` 五件 SQL 姿态读面(测试钩 `__resetSqlEngineReadingsForTests` +1);`0.58.0` 是 **828**,那批是三件 additive:`RULE_OFFER_MATCHES`/`RULE_OFFER_BATCH_MEMBER_KINDS`/`RULE_OFFER_UNCOVERED_REASONS` 三张闭词表再导出 + `RESUME_REFUSAL_CODES`/`RESUME_PLACEMENT_MISMATCH`/`resumeRefusalFromError`/`resumeRefusalContent` 四件文案铸点;`0.57.0` 是 **821**;`0.56.0`/`0.55.0` 是 **815**;已发 `0.54.0`(design/385 十件 additive 含 `AUTHORITY_ENVELOPE_TAGS`);`0.52.0` 是 **805**(L-69⑨ 两件);`0.51.0` 是 **803**;`0.50.0` 是 **800**(S-81 五件);`0.49.0` 是 **795**;`0.48.0` 是 **794**;npm `0.47.0` 是 **790**,`0.46.0` 是 **787**,`0.44.0` 是 **783**,`0.43.1`/`0.43.0` 是 **776**,`0.42.0` 是 **771**,`0.41.0` 是 **767**,`0.39.0` 是 **766**,`0.38.0` 是 **764**;`0.37.0` 是 **753**,见 `CHANGELOG.md`) | `scripts/public-export-baseline.json` 的 `count` / `testHookCount` —— **别手抄进别处,以该文件为准** |
+| 公开导出面 | **918** 个运行期符号(+ 44 个测试钩;= 工作树当下的值 = **0.64.0 件①+件② 十三件 additive、零删除**:`CLASSIFIER_STATUS_STATES`/`classifierBreakerOf`/`classifierStatusOf`/`classifierStatusDetail`(分类器状态面,详见 §28②)/ `THINKING_FORMATS`/`THINKING_FORMAT_WIRE_TWINS`/`THINKING_DISABLE_PROBE_ORDER`/`MODEL_PROBE_VERDICTS`/`PROBE_PROMPT`/`PROBE_MAX_TOKENS`/`probeRequestBody`/`probeModelCapability`/`applyProbeToEntry`(模型思考能力探测,详见 §28①);`0.63.0` 是 **905**,那批是八件 additive、零删除:`projectServerGateKnobs`/`postureKnobSourceOf`/`postureSourceIsOperatorPinned`/`postureKnobDetail`/`POSTURE_SOURCE_WORDS`(S-178 三根 posture 旋钮读数,详见 §27b)/ `PERSISTED_RULE_BEHAVIORS`/`PERSISTED_RULE_BEHAVIOR_UNKNOWN`/`persistedRuleBehaviorOf`/`persistedRuleBehaviorLabel`/`revokeTargetFromPersistedRule`(三态规则身份,§27c)/ `engineIdentityOf`/`engineIdentityVerdict`/`engineIdentityChanged`/`engineIdentityChangedBy`/`ENGINE_IDENTITY_ANCHORS`(S-179 代际锚,§27d)/ `GATE_DENIED_BY_WORDS`/`gateDeniedByDetail`/`ASK_ORIGIN_WORDS`/`askOriginDetail`(门词汇 +2,§27e)/ `PERMISSION_RULE_ISSUE_CODES`/`RETIRED_PERMISSION_RULE_ISSUE_CODES`/`permissionRuleIssueDetail`(规则 lint 码表,§27f)/ `projectToolRoster`/`toolRosterNames`/`toolShimFromRoster`/`applyToolRosterDelta`(L-161 工具名册,§27g)/ `ENGINE_NOTICE_CODES`/`ENGINE_NOTICE_AUDIENCE`/`noticeAudienceOf`/`engineNoticeInCatalog`/`MCP_INJECTION_DROP_REASONS`/`readMcpInjectionDrop`(L-167 通告码册,§27h)/ `AUTO_MODE_UNAVAILABLE_CAUSES`/`AUTO_MODE_BREAKER_CAUSES`/`classifierUnavailableOf`/`classifierUnavailableDetail`(件⑧ 分类器不可用事实,§27h2);`0.62.0` 是 **869**,那批是五件 additive、**零删除**:`capForDisplay`(呈前消毒 + 封长的共用铸点,详见 §26⑦)/ `SEAT_SEND_MESSAGE_KEY_ORIGINS`(座位载荷逐键出身表,详见 §26③)/ `configureSubagentContentStore`+`subagentContentStoreConfig`+`SUBAGENT_CONTENT_STORE_DEFAULTS`(子代内容账本字节预算,测试钩 `__resetSubagentContentStoreConfigForTests` +1,详见 §26②);`0.61.0` 是 **864**,那批是三件 additive、**零删除**:`projectReadFacePosture`/`readFacePostureDetail`/`readFaceDisagreement`(S-167 READ 容纳面 operator 读器,详见 §25);`0.60.0` 是 **861**,那批是二十五件 additive、**零删除**:`readRunTerminal`/`runTerminalCode`/`runTerminalGateKind`/`runTerminalGateToolName`/`isReviewPark`/`REVIEW_PARK_GATE_KINDS` 六件终局因由读器 + `gateOutcomeOf`/`isDeniedGate`/`gateDeniedBy`/`gateApprover`/`isApprovalWindowExpiredGate`/`isDenialLimitAutoDeniedGate`/`isParkSlaExpiredGate`/`isHumanSettledGate` 八件门记录读器 + `projectWriteProtectionCapability`/`noteEngineCapsForWriteProtection`/`observedWriteProtection`/`forgetWriteProtectionReading`/`writeProtectionDoctorDetail`/`projectWriteProtectionPosture`/`writeProtectionPostureDetail` 七件写保护读面(测试钩 `__resetWriteProtectionReadingsForTests` +1)+ `readWireErrorCode` + 真机边界①的两件 `isGateParkedToolEnd`/`GATE_PARKED_ERROR_CODE` + 异源复审逼出的 `engineCapsGeneration`;`0.59.0` 是 **836**,那批是八件 additive:`RULE_OFFERS_ABSENCE_REASONS`/`DENIAL_LIMIT_KINDS` 两张闭词表再导出 + `engineCapValue` 能力位四态通用读口 + `projectSqlEngineCapability`/`observedSqlEngine`/`noteEngineCapsForSqlEngine`/`forgetSqlEngineReading`/`sqlEngineDoctorDetail` 五件 SQL 姿态读面(测试钩 `__resetSqlEngineReadingsForTests` +1);`0.58.0` 是 **828**,那批是三件 additive:`RULE_OFFER_MATCHES`/`RULE_OFFER_BATCH_MEMBER_KINDS`/`RULE_OFFER_UNCOVERED_REASONS` 三张闭词表再导出 + `RESUME_REFUSAL_CODES`/`RESUME_PLACEMENT_MISMATCH`/`resumeRefusalFromError`/`resumeRefusalContent` 四件文案铸点;`0.57.0` 是 **821**;`0.56.0`/`0.55.0` 是 **815**;已发 `0.54.0`(design/385 十件 additive 含 `AUTHORITY_ENVELOPE_TAGS`);`0.52.0` 是 **805**(L-69⑨ 两件);`0.51.0` 是 **803**;`0.50.0` 是 **800**(S-81 五件);`0.49.0` 是 **795**;`0.48.0` 是 **794**;npm `0.47.0` 是 **790**,`0.46.0` 是 **787**,`0.44.0` 是 **783**,`0.43.1`/`0.43.0` 是 **776**,`0.42.0` 是 **771**,`0.41.0` 是 **767**,`0.39.0` 是 **766**,`0.38.0` 是 **764**;`0.37.0` 是 **753**,见 `CHANGELOG.md`) | `scripts/public-export-baseline.json` 的 `count` / `testHookCount` —— **别手抄进别处,以该文件为准** |
 | 常驻门 | 以 `scripts/gates-manifest.json` 的 `suites` 长度为准(**本档不抄这个数**) | `scripts/gates-manifest.json`;`npm test` 的名单等值门与它逐名对账 |
 | 沿革档 | 0.29.0 起建 `CHANGELOG.md`;更早批次记账在 `src/index.ts` 文件头 + `docs/REFACTOR-LEDGER.md` | — |
 
@@ -111,7 +111,7 @@ SDK 核对「本包 import 的每个值级符号仍然导出」「`TaskStats.cos
 
 ## §2 公共导出面地图(按域)
 
-> 全集真源 = `scripts/public-export-baseline.json` 的 `names`(**905** 项)。
+> 全集真源 = `scripts/public-export-baseline.json` 的 `names`(**918** 项)。
 > 本节**不逐名抄**,只给「域 → 承重导出 → 用途 → 实现锚」。承重导出 = 一个端为了让这个域干活
 > **必须**直接调到的那几个符号;其余是它们的类型、变体与辅助位。
 > 单一入口:`import { … } from '@sema-agent/client-core'`(`exports` 只有 `.` 一个;
@@ -135,12 +135,12 @@ SDK 核对「本包 import 的每个值级符号仍然导出」「`TaskStats.cos
   `WorkflowsGateUnknownDenial` 四形**不在**基线里,`src/selfOrchestrationDenial.ts` 对基线贡献
   **4** 项运行期导出(三个函数 + `SELF_ORCHESTRATION_RETRY_WITHOUT`)。
 
-905 项的内部构成(帮助端估读表大小):**271** 项是 `SCREAMING_SNAKE` 常量数据表/词汇表
+918 项的内部构成(帮助端估读表大小):**278** 项是 `SCREAMING_SNAKE` 常量数据表/词汇表
 (矩阵、键集、env 名、锚串)而非可调用物;**5** 项是 PascalCase 运行期值
 (`ControlRouter` / `ControlSafetyError` / `HitlBridge` / `HitlSafetyError` / `DecideTransportRetryExhaustedError`);
 **41** 项是 `*For(sessionKey, …)` 的 per-session 变体(§6;其中 `engineNamespaceKeyFor` 是命名巧合 —— 参数是 baseUrl 不是 sessionKey,见域 14)。
 
-### 2b. 域图(16 域,逐域计数之和 = 905)
+### 2b. 域图(16 域,逐域计数之和 = 918)
 
 | # | 域 | 名数 | 承重导出 | 用途 | 实现锚 |
 |---|---|---|---|---|---|
@@ -152,9 +152,9 @@ SDK 核对「本包 import 的每个值级符号仍然导出」「`TaskStats.cos
 | 6 | **请求装配(上行唯一构造口)** | 8 | `buildTaskRequest` · `REQUEST_FIELD_MATRIX` · `unregisteredRequestKeys` · `applyLiveRequestDefaults` · `taskNotificationToPrintFrame` | 两条车道(`interactive`/`print`)出站请求的**唯一**构造器;`unregisteredRequestKeys` 是可执行门 —— 端偷带一个未登记键上 wire 就红 | `src/request/taskRequest.ts`、`src/request/printNotification.ts` |
 | 7 | **通知与 outstanding 台账** | 51 | `installNotificationQueuePort` · `normalizeTaskNotification` · `taskNotificationDedupKeyFromWire` · `registerOutstandingBgTask` / `registerOutstandingWorkflowRun` · `notificationQueuePortMisses` · `subscribeOutstandingWorkflows` · `outstandingDeliverableWorkflowCount` | `task_notification` 归一 + 去重 + 投递进宿主命令队列的**一把闸**;`outstandingDeliverableWorkflowCount()` 是 headless `-p` 的**退出门** · `classifyPeerNotification` / `renderPeerFrameTranscriptText` / `parsePeerFrameText` / `peerFrameDisplayName` + 三张闭集表(design/385,0.54.0:同一条 `task_notification` 车道上三条**引擎注入帧**的类型化投影 —— 判别位=载体在场而非 summary 文本,详见 §17) | `src/notifications.ts`(11 个 module 台账) |
 | 8 | **工具结果卡** | 25 | `structuredToToolUseResult` · `readAsyncLaunchedAgentReceipt` · `wireOutputToBody` · `parseModelFacingBash` · `getPatchFromContents` · `toolEndResultToUserFrame` · `flattenToolOutput` | 铸端要渲的 `tool_result` 卡体,含客户端 diff hunk(唯一 runtime dep 的用处) | `src/toolResult.ts`、`src/printToolResultFrame.ts`、`src/diff/patch.ts` |
-| 9 | **能力/旋钮 wire 门族** | 92 | `projectAgentsForWire` / `awaitTaskAgentsWire` · `hooksForWire` · `mcpConfigsToSpecs` · `ultracodeForRequest` · `resolveWebSearch` + `buildWebSearchEnv` · `attachmentsForRequest` · `projectEffectiveBody` · `classifySelfOrchestrationRefusal` / `stripSelfOrchestrationIntent` / `projectWorkflowsGate` / `SELF_ORCHESTRATION_RETRY_WITHOUT`(S-81,server 7.57.0:上面两条 stamp 腿的**背面** —— 半配置多租户形态下 server 把带 `selfOrchestration` / `settings.ultracode` 的提交 501 拒掉,判型/去键/caps 闸三处都是判定不是文案,详见 §13) · `engineCapsGeneration`(0.60.0,异源对抗复审 [medium] 逼出:caps 探测的**当代号**读口 —— 代际闸在 probe **返回之后**才跑,而宿主的读面 tee 是在 probe **内部**落地的 ⇒ 一次慢的旧探测能把上一台引擎的读数写回来。宿主在**起探测那一刻**抓号、tee 时交回 `{generation}`,陈旧那一发整只丢掉;不传 = 逐字节同行为,详见 §24e)| 逐功能的「引擎有没有这个能力 + 这个字段怎么上 wire」投影器,由 `buildTaskRequest` 组装。🔴 `hooksForWire()` 是 **fail-closed**:无 `SettingsPort` ⇒ 返回 `undefined`(信任门,不是取值) | 17 个 `src/*WireCaps.ts` + `src/scratchpadWireCaps.ts`、`src/hooksWireCaps.ts`、`src/goalStopHook.ts`、`src/websearch/searchProviderPresets.ts`、`src/selfOrchestrationDenial.ts`(S-81 拒绝判定层) |
+| 9 | **能力/旋钮 wire 门族** | 96 | `projectAgentsForWire` / `awaitTaskAgentsWire` · `hooksForWire` · `mcpConfigsToSpecs` · `ultracodeForRequest` · `resolveWebSearch` + `buildWebSearchEnv` · `attachmentsForRequest` · `projectEffectiveBody` · `classifySelfOrchestrationRefusal` / `stripSelfOrchestrationIntent` / `projectWorkflowsGate` / `SELF_ORCHESTRATION_RETRY_WITHOUT`(S-81,server 7.57.0:上面两条 stamp 腿的**背面** —— 半配置多租户形态下 server 把带 `selfOrchestration` / `settings.ultracode` 的提交 501 拒掉,判型/去键/caps 闸三处都是判定不是文案,详见 §13) · `engineCapsGeneration`(0.60.0,异源对抗复审 [medium] 逼出:caps 探测的**当代号**读口 —— 代际闸在 probe **返回之后**才跑,而宿主的读面 tee 是在 probe **内部**落地的 ⇒ 一次慢的旧探测能把上一台引擎的读数写回来。宿主在**起探测那一刻**抓号、tee 时交回 `{generation}`,陈旧那一发整只丢掉;不传 = 逐字节同行为,详见 §24e)| 逐功能的「引擎有没有这个能力 + 这个字段怎么上 wire」投影器,由 `buildTaskRequest` 组装。🔴 `hooksForWire()` 是 **fail-closed**:无 `SettingsPort` ⇒ 返回 `undefined`(信任门,不是取值) | 17 个 `src/*WireCaps.ts` + `src/scratchpadWireCaps.ts`、`src/hooksWireCaps.ts`、`src/goalStopHook.ts`、`src/websearch/searchProviderPresets.ts`、`src/selfOrchestrationDenial.ts`(S-81 拒绝判定层) |
 | 10 | **headless / 部署旋钮 wire** | 61 | `parseSandboxArgv` / `sandboxRequestFields` · `parseLimitsArgv` / `limitsForPrint` · `resolveHeadlessFinalVerify` · `resolveHeadlessPermissionMode` · `resolveHeadlessInteractiveTools` · `armDetachCancel` + `detachCancelArm` + `isDetachArmed` · `withHeadlessR1Reconnect` | `-p`/headless 车道的 env+argv 旋钮。🔴 `detachWire` 是**拆**的补偿:判定与 cancel-arm 台账在库,信号路径的裸 fetch 留宿主(`detachCancelArm()` 是取件口) | `src/sandboxWire.ts`、`scenarioWire.ts`、`finalVerifyWire.ts`、`limitsWire.ts`、`interactiveToolsWire.ts`、`headlessPermissionModeWire.ts`、`headlessReconnectWire.ts`、`detachWire.ts` |
-| 11 | **模型目录与预算** | 67 | `resolveModelCatalog` · `loadCatalogWithSources` · `PROVIDER_PRESETS` / `MODEL_FAMILIES` · `defaultMaxTokensFor` · `getLiveModelCatalog` / `setLiveModelCatalogRefresher` · `providerAuthMethods` / `beginDeviceCodeAuth` · `providerCatalogRows` / `providerCatalogRowDetail` / `providerPresetById`(#244 F4 族D A-028.17:46 家表的规范折表层 —— 全表不重排、诚实缺席「model id typed in」,cli 目录/web 向导同一份折表)· `TIER_ORDER` / `CC_TIER_ALIASES` / `isTier` / `resolveTierBinding`(A-028.18:档位词表+校验+fail-open 降档派生单源;settings 存储归宿主)· `resolveEntryVision` / `computeDeleteBlockers` / `computeDeleteWarnings`(0.38.0 #318 件③ 上收:Model Hub 供给面的三端公共判定 —— vision 生效值+来源三态、删除断链核(拒删+指路)、删除降级后果(照删但必说)。**零 IO**,读盘那半场留各端;`doc === null` 的两义在调用方分流) | 三层 provider 目录解析(线上 URL → 包内预设 → 用户覆盖)+ per-model `maxTokens` 封顶。线上腿需注入 `CatalogFetchJson`,缺席 ⇒ 整条不启用(`online.reason='no-fetch-port'`);缓存落盘经 `CatalogCachePort` | `src/model/{catalog,catalogLoader,providerAuth,providerPresets,providerCatalog,tierVocabulary}.ts`、`src/liveModelCatalog.ts`、`src/modelBudgetRule.ts`、`src/sessionModelLatch.ts`、`src/effortWire.ts` |
+| 11 | **模型目录与预算** | 76 | `resolveModelCatalog` · `loadCatalogWithSources` · `PROVIDER_PRESETS` / `MODEL_FAMILIES` · `defaultMaxTokensFor` · `getLiveModelCatalog` / `setLiveModelCatalogRefresher` · `providerAuthMethods` / `beginDeviceCodeAuth` · `providerCatalogRows` / `providerCatalogRowDetail` / `providerPresetById`(#244 F4 族D A-028.17:46 家表的规范折表层 —— 全表不重排、诚实缺席「model id typed in」,cli 目录/web 向导同一份折表)· `TIER_ORDER` / `CC_TIER_ALIASES` / `isTier` / `resolveTierBinding`(A-028.18:档位词表+校验+fail-open 降档派生单源;settings 存储归宿主)· `resolveEntryVision` / `computeDeleteBlockers` / `computeDeleteWarnings`(0.38.0 #318 件③ 上收:Model Hub 供给面的三端公共判定 —— vision 生效值+来源三态、删除断链核(拒删+指路)、删除降级后果(照删但必说)。**零 IO**,读盘那半场留各端;`doc === null` 的两义在调用方分流) | 三层 provider 目录解析(线上 URL → 包内预设 → 用户覆盖)+ per-model `maxTokens` 封顶。线上腿需注入 `CatalogFetchJson`,缺席 ⇒ 整条不启用(`online.reason='no-fetch-port'`);缓存落盘经 `CatalogCachePort` | `src/model/{catalog,catalogLoader,providerAuth,providerPresets,providerCatalog,tierVocabulary}.ts`、`src/liveModelCatalog.ts`、`src/modelBudgetRule.ts`、`src/sessionModelLatch.ts`、`src/effortWire.ts` |
 | 12 | **workflow 与后台工作视图** | 19 | `projectWorkflowRun` · `createLiveWorkflowSource` · `ensureWorkflowActivityLedger` · `readWorkflowActivityLedger` · `stopWorkflowActivityLedger` · `resetWorkflowActivityLedgers` · `createBackgroundView` · `projectBackgroundView` · `recordWorkflowAgentTaskId` · `agentDisplayStatus` | 活过一个 turn 的长任务读面:workflow run + 跨 session 后台任务归一表(`assistant.tasks` 与 fleet SSE **两源独立降级**) | `src/workflow.ts`、`src/workflowClient.ts`、`src/workflowMonitor.ts`、`src/agentSession/backgroundView.ts`(+ 纯类型 `src/agentSession/contract.ts`) |
 | 13 | **座位 IPC 契约** | 34 | `LOCAL_SESSIONS_SPEC` · `SEAT_METHOD_NAMES` · `SEAT_EVENT_TYPES` · `isLocalSessionEvent` · `isToolPermissionRequest` · `toolPermissionRequestId` · `SEAT_VALIDATOR_KEY_COVERAGE` · `SEAT_SEND_MESSAGE_KEY_ORIGINS`(0.62.0:座位载荷**逐键出身**登记 —— 每个位要么写明转投哪个引擎请求位、要么写明为什么不上 wire;常驻门对**装在盘上的** sdk 型面逐名核,详见 §26③)| desktop↔web 座位 IPC 契约的**单一真源**(此前两边各一份、名字零重合 ⇒ 编译器永远不会告诉你它们漂了)。🔴 加 verb 忘了加 `LOCAL_SESSIONS_SPEC` **不报错**:preload 不注册 channel、渲染端读到 `undefined` | `src/seatContract.ts`(**零 import**,纯类型 + 常量 + 纯谓词)。🔴 **证据等级标注(0.42.0,test [5087] 的「语料**种类**缺口」/ cli [5088] 认领件)**:该文件里所有以「CC 如何如何」为形的断言(`212 methods` / `854-channel census` / 方法名逐字保留 / `fQe` 逐字段对照 / 一切 `.vite/build/index.chunk-*.js` 坐标)**证据等级 = 桌面 unpack,本地语料库不可复验** —— 本仓手边可复验的参照语料**只覆盖终端 CLI 形态**的静态产物,拿它去 grep 桌面壳里的符号只会零命中,而零命中在这里**既不证真也不证伪**。复核这些断言**不得**拿本仓语料当反证 |
 | 14 | **宿主端口与会话槽** | 26 | `installHost` · `installHostFor` · `hostPortMisses(For)` · `DEFAULT_SESSION_KEY` · `hostEnv` · `unrefTimer` · `parseLocaleTag` / `pickUiLanguage`(#244 F4 族D A-028.20:locale tag 手术单源 + UI 语言判定;与 `resolveRegionHint` 双出口成文 —— 语言偏好域 en/zh ≠ 地址可达域 cn/intl/unknown,`zh-Hant` 前者 zh 后者 intl 是设计)· `engineNamespaceKeyFor` / `mergeSessionMapRecord` / `mergeEngineEntry`(A-028.12:会话 id 映射单一键形 + merge 判定;存储经 `SessionMapStorePort` 归端 —— cli 文件锁/原子写,web localStorage)| 进程/端级装配层(settings/fs/queue/timers/session/log/probe),与 per-turn 的 `AdapterContext` **分层**。头注的判定规则:**这个能力每 turn 都会变吗?** 会 ⇒ `ctx`;不会 ⇒ `installHost` | `src/host.ts`、`src/hostEnv.ts`、`src/sessionSlot.ts`、`src/unrefTimer.ts`、`src/env/{localeGeo,localeTag,uiLanguage}.ts`、`src/sessionMap.ts` |
@@ -4774,10 +4774,20 @@ core 双向对账)。**候上游导出即整只退役改成从 sdk 取**。
 - **G-19**:让分类器**答了但答在契约之外**(parse_error)—— 卡上**不出现**「分类器跑不了」那一族的
   任何一句(引擎在这一形上根本不盖那一格);而**不武装** auto 模式跑同样的调用 —— 卡上同样没有那一行
   (缺席 ≠「分类器跑成了」)。
-- **G-20**(0.63.1 订正判据口径:park 落在**腿**上不落在 run 上)——让一条 workflow **agent 腿**停在
-  审批门上:监视器里那一行的状态词**逐字是 `parked`**(不是 `running`,也不是 `interrupted` —— 那条腿
-  park 之后整只 run 就收在 `failed`,所以「run 不活跃 ⇒ interrupted」那条老臂会抢答);批掉那张卡之后
-  那一行**不再**是 `parked`。反向:随便造一个这一端没见过的状态词,那一行仍渲成在跑(开集兜底没被改宽)。
+- **G-20**(0.63.1 订正判据口径:park 落在**腿**上不落在 run 上;🆕 **0.64.0 再订正:显示词是
+  二次派生的,别去 agent 行上找它**)——让一条 workflow **agent 腿**停在审批门上,判据是**两条**:
+  ① 投影产物那一行的 `agent.state` **逐字是 `parked`**;② 把那一行喂进显示态派生
+  `agentDisplayStatus(agent, false)`(第二参 = run 是否还活跃;这里刻意传 `false`)得到的**也**逐字是
+  `parked` —— 不是 `running`,也不是 `interrupted`(那条腿 park 之后整只 run 就收在 `failed`,所以
+  「run 不活跃 ⇒ interrupted」那条老臂会抢答,②的第二参传 `false` 就是为了把那条老臂放到台面上)。
+  批掉那张卡之后两条判据**都不再**是 `parked`。反向:随便造一个这一端没见过的状态词,②仍渲成在跑
+  (开集兜底没被改宽)。
+  🔴 **订正的理由(test [6783] G-1/G-2 提的,亲核属实)**:原文写的是「监视器里那一行的状态词逐字是
+  `parked`」,而**投影产物的 agent 行上压根没有 `displayStatus` 这一格** —— `displayStatus` 是
+  service detail **入参**上的键,投影把它折进 `state` 之后就不再出现在产物上;显示词由
+  `agentDisplayStatus(agent, workflowActive)` **二次派生**。按原文字面去读 `row.displayStatus` 的 test
+  永远读到 `undefined`,于是这条判据要么恒红要么被写成别的东西。机读锚:
+  `scripts/run-client-core-pure-test.mjs` G-20 段新增一格,逐字断言那一行**没有** `displayStatus`。
 
 ---
 
@@ -4798,3 +4808,300 @@ core 双向对账)。**候上游导出即整只退役改成从 sdk 取**。
 | `scripts/run-integration-doc-freshness-test.mjs` | 本节新增坐标在盘 + 入库;§0a/§2/§2b 计数与基线等值;🆕 **①c**(0.63.1):签名块里的**表长数字** ⟷ 源码那张表的真实成员数(TS AST 取 `Object.freeze([...])` 的元素个数)。档里一律写阿拉伯数字 —— 中文数词读不出来的门等于没有门,抽取器读不出即判工具红 |
 
 ---
+
+## §28 🆕 0.64.0 内容批(模型思考能力探测 · 分类器状态面 · `DecisionReason` uplift 锚 · G-20 判据订正 · 落库前提门)
+
+### 28a. 本节速览
+
+| # | 件 | 面 | 破坏性 | 端要做什么 |
+|---|---|---|---|---|
+| ① | 模型思考能力探测(`src/modelCapabilityProbe.ts`) | 新 9 导出 | 无 | 模型目录页/向导加一个「探测」动作;**网络那半场端自己实现**并作为 `send` 注入 |
+| ② | auto 分类器状态面(`src/classifierStatus.ts` + `src/autoModeUnavailable.ts` 加员) | 新 4 导出 + wire additive 一键 | 无 | 诊断行 / 模型设置页 / 权限卡状态栏改接铸点;`breaker` 缺席 = 老引擎 |
+| ③ | `DecisionReason` +`read_only` 的 uplift 锚 | **零导出** | 无 | **端无事可做**;上游镜像到货时本包先红,那时才有铸点 |
+| ④ | §27j 的 G-20 判据口径订正 | 文档 + 机读锚 | 无 | test 侧改判据;端零改 |
+| ⑤ | devDep 抬 `@sema-agent/settings-schema ^1.10.0` + 落库前提门 | 门 | 无 | **端无事可做**(devDep,不进 peer、不出包) |
+
+🔴 **本批本包侧全部 additive、零删除**:`peerDependencies` 一字未动(仍 `@sema-agent/sdk >=8.8.0` /
+`@sema-agent/agent-types >=0.2.0`)。唯一的 wire 加员是 `_sema_autoMode` 段上的可选一键 `breaker`,
+缺席即老引擎,老端一个字节都不受影响。
+
+---
+
+### 28b. ① 模型「会不会思考、关不关得掉」的探测
+
+**它答的是哪一问**:一台 vLLM/Qwen 类网关**默认就在思考**,而「关掉」各家拼法不同 —— 有的读顶层
+`enable_thinking`,有的只认模板参数 `chat_template_kwargs.enable_thinking`,有的要
+`thinking:{type:"disabled"}`。目录条目上 `compat.thinkingFormat` 那一格就是告诉引擎该用哪一种,
+而**没有人能靠看一眼型号名答出它是哪一种**。⇒ 把这一问变成一次可复现的探测。
+
+**签名**
+
+```ts
+THINKING_FORMATS: readonly string[]              // 7 词,引擎闭集的镜像,顺序同源
+THINKING_DISABLE_PROBE_ORDER: readonly string[]  // 4 词,试关序(公面承诺)
+MODEL_PROBE_VERDICTS: readonly string[]          // 4 词
+THINKING_FORMAT_WIRE_TWINS: Readonly<Record<string, string>>
+PROBE_PROMPT: string
+PROBE_MAX_TOKENS: number
+
+probeRequestBody(entry: ModelProbeEntry, format?: string, opts?: { reasoningEffort?: string })
+  : OpenAICompletionsProbeBody
+probeModelCapability(entry: ModelProbeEntry, send: ProbeSend): Promise<ModelProbeResult>
+applyProbeToEntry<T extends { reasoning?: boolean; compat?: unknown }>(entry: T, result: ModelProbeResult): T
+```
+
+**输入形(端要实现的那一只)**
+
+```ts
+type ProbeSend = (body: OpenAICompletionsProbeBody) => Promise<{
+  content: string            // choices[0].message.content;没有 ⇒ 空串
+  reasoningContent?: string  // choices[0].message.reasoning_content;缺席 = 这台网关没给这一通道
+  finishReason?: string      // choices[0].finish_reason 原样
+  status?: number            // HTTP 状态码;缺席 = 端没报(不是 200)
+}>
+```
+
+🔴 **包内零网络**:鉴权、代理、超时、重试全在端手里;本包零 `fetch`、零 URL、零凭证键(门有源码级
+反向钉)。**抛错是合法回答** —— 端不必自己吞,本包按它发生在哪一发决定判词。
+
+**步骤与判词**
+
+1. baseline:最小请求(题面 `PROBE_PROMPT`,`max_tokens` = `PROBE_MAX_TOKENS`),不带任何方言位。
+   · **没有证据力** —— 被拒(抛错 / 状态码 ≥400),**或**一条「零思考 + 正文也空」的合法回执
+     (`{content:'', finishReason:'length', status:200}`,被截断 / 网关吞了正文)⇒ `inconclusive`,
+     **结果里压根没有 `reasoning` 这一格**;
+   · **正面证据**「正文非空且零思考」⇒ `no_reasoning`,**收工**(一次往返都不多烧)。
+2. 会思考 ⇒ 按 `THINKING_DISABLE_PROBE_ORDER` 逐臂试关,第一个**「零思考 且 正文非空」**的拼法
+   即答案 ⇒ `disabled_via`,收工。
+3. 四臂都没关掉:**每一臂都给出正面反证**(逐臂都看见思考还开着)⇒ `cannot_disable`,并补一发
+   `reasoning_effort:"low"` 记下这台网关**收不收**低档旋钮(`evidence.lowEffortAccepted`);
+   🔴 **任一臂没有证据力**(被拒,**或**空回执)⇒ `inconclusive` —— 那一种拼法**没被证伪**,
+   而 `cannot_disable` 是**删掉**条目上原有 `thinkingFormat` 的唯一触发,让一次偶发的超时或空回执
+   去抹掉一份正确配置是本探针能犯的最贵的错。证据里逐臂留着每一发的长度与状态,端可以据此
+   只重试那一臂。
+
+🔴 **贯穿三步的一条**:「**没看见思考**」不等于「**思考关掉了**」。每一发都先判**证据力**三态
+(`off` 正面看见关掉了 / `on` 正面看见还开着 / `moot` 什么都没证明),判词只建在正面证据上 ——
+把一条空回执读成任何一边,都会让一次偶发的网关抖动去覆盖一份正确的持久配置。
+`moot` 有**四个同形**(两轮异源复审各抓出一个,逐个补进来的):被拒(抛错 / 4xx)/ 正文空 /
+正文**纯空白**(只差一个空格就能骗过「长度 > 0」)/ 这一发**被截断了**(`finish_reason: "length"`
+—— 本探针的 `max_tokens` 只有 64,一台在思考的网关很容易先烧完额度再被截掉,那时思考通道可能一个字
+都没送出来)。⚠️ 截断只否掉 `off` 那一边:一发**已经吐出思考**的截断回执照旧是 `on`。
+`evidence` 因此把**原始** `contentLen` 与判据用的 `hasText` 分成两格 —— 一格当两用会逼着判据去读一个
+它不该读的量。
+
+**缺席语义(逐条,别读成更弱的话)**
+
+| 形 | 语义 | 🔴 不许渲成 |
+|---|---|---|
+| `verdict === 'inconclusive'` 且 `reasoning` 这一格**不在** | baseline 没有证据力(被拒,**或**空回执) | 「这个模型不会思考」 |
+| `verdict === 'inconclusive'` 且 `reasoning === true` | 会思考,但**关不关得掉问不出来**(baseline 有证据力,而**至少一臂**被拒或空回执) | 「关不掉」 |
+| `verdict === 'cannot_disable'`,`thinkingFormat` **缺席** | 四种拼法**逐臂给出正面反证**、都关不掉 | 挑一个词写上去 |
+| `evidence.lowEffortAccepted === true` | 低档旋钮**被收下了** | 「思考真的变少了」(本探针量不到) |
+| `evidence.lowEffortAccepted` 缺席 | **没做**这一发(没走到 `cannot_disable`) | `false` |
+
+**`applyProbeToEntry` 的三条纪律**
+
+- 只写 `reasoning` 与 `compat.thinkingFormat` 两键,条目上别的键(`name`/`tier`/`cost`/`extraBody`/
+  `compat` 里别的位)逐字原样带过去;**入参一个字节不动**(纯函数)。
+- 🔴 `inconclusive` ⇒ **原样退回同一只条目**(`===` 成立),一个键都不写。
+- 🔴 `cannot_disable` ⇒ 把条目上原有的 `thinkingFormat` **删掉**。留着的后果是双重的:引擎会继续发
+  一种**已被实测证伪**的拼法,而目录/卡面照那一格渲一句「思考已关」的假话。
+
+**🔴 试关序是公面承诺,不是实现细节**:每多试一种拼法就是对那台网关多烧一次真钱与真时延。
+模板形排第一,是因为观测到的真实序列是「顶层形关不掉、且把正文答空」;`openai` 不占一臂(它的关
+拼法要一份探针没有的 `thinkingLevelMap.off`,发出去等于把 baseline 那一发原样再烧一次);
+`zai`≡`qwen`、`together`≡`openrouter` 在这条轴上**请求体逐字节相同**,不各占一臂
+(对照表 `THINKING_FORMAT_WIRE_TWINS`)。
+
+**⚠️ 方言闭集的真源是引擎,不是 settings-schema**:`ModelEntry.compat` 在 settings-schema 1.10.0 上是
+**parse-transparent 的 `z.unknown()`**,其 JSDoc 逐字声明它刻意不复述词表(「the SHAPE and the
+VOCABULARY … are the consuming side's single point」)。真源是 core 的
+`OpenAICompletionsCompat.thinkingFormat`,本包按真字节镜像 + 常驻门双向对账。
+
+---
+
+### 28c. ② auto 分类器的**状态面**(与审批卡那一问分家)
+
+**两问不是同一问**:审批卡答「这一刻**为什么在问我**」(一次性的、就这只 ask,0.63.0 件⑧ 已有);
+诊断行 / 模型设置页 / 权限卡状态栏答「这个**会话**上分类器现在是什么状态」。两问的下一步不同,
+所以句子分家 —— 门里有一条反向钉守着两张面的句子**零重合**。
+
+**签名**
+
+```ts
+CLASSIFIER_STATUS_STATES: readonly string[]   // 3 词:available / breaker_open / unavailable_this_round
+
+classifierBreakerOf(autoMode: unknown): ClassifierBreakerView | undefined
+classifierStatusOf(autoMode: unknown, ask?: unknown): ClassifierStatusView | undefined
+classifierStatusDetail(view: ClassifierStatusView): string
+
+interface ClassifierBreakerView { openedAtMs: number; lastCause: string; failures: number; runId?: string }
+interface ClassifierStatusView { state: string; breaker?: ClassifierBreakerView; cause?: string }
+```
+
+**wire 加员**:`WiringManifestAutoMode` 上 additive 一键 `breaker`(core 7.10.0 `AutoModeBreakerTrip`
+的四键;**server ≥7.69.0 才投**),随 `_sema_autoMode` 段过帧。
+
+**输入形**:`autoMode` 吃 `wiring_manifest` 的 `autoMode` 段(投影后的或原始的都吃,本函数自己窄读);
+`ask` 吃一只 ask 或 durable park 行的 `tool_approval` 载荷(与 `classifierUnavailableOf` 同一只读器)。
+
+**缺席语义**
+
+| 形 | 语义 | 🔴 不许渲成 |
+|---|---|---|
+| `breaker` 键**不在场** | **没有可用的熔断记录** —— 四种成因不可分辨:①这个会话从没熔断过 ②账本(有界 FIFO)把它淘汰了 ③这一次是 standalone prepare(账本压根没接上)④server <7.69.0 不投这一段 | 「没熔断过」;也**别**读成「一定是老引擎」 |
+| `classifierStatusOf(...) === undefined` | 这一端说不出分类器的健康状况(段缺席;或没武装、且既无本轮事实也无历史记录) | `available` |
+| `runId` 缺席 | 引擎没报是哪条腿合的闩 | 编一个 |
+| 熔断记录三键(`openedAtMs`/`lastCause`/`failures`)缺任一 | **整段**判缺席(半句没有出口的话不如不渲) | 半句 |
+
+**四条承重(照抄进端的复审清单)**
+
+- 🔴 **熔断记录与 `armed`/`reason` 之间零互证**:闩合上之后被闩住的那条腿**不再把 auto 意图传给后续
+  腿**,于是后续腿读作 `no_intent` 而**不是** `latch_open` —— `{armed:false, reason:"no_intent",
+  breaker:{…}}` 是**最常见**的合法形。补一条「有 breaker 就该 latch_open」的互证会把真读数整段判没。
+- 🔴 **优先序:本轮事实 > 这条腿的 `armed` > 历史熔断记录**。判据锚在**真正决定「分类器现在跑不跑」
+  的量**上,而那个量是**这条腿的 `armed`**,不是账本里有没有一条旧记录 —— core 顶注逐字:
+  「A decider is minted per run (its latch is a RUN fact) … the ledger below carries the most recent one
+  forward per session」⇒ 同一会话的**后一条腿完全可以重新武装**(新 decider 的闩由构造关着),而账本
+  仍把那次旧 trip 带着。`armed === true` 时判 `breaker_open`,就是把一个**正在放行**的分类器显示成
+  已经关掉了。
+- 🔴 **历史记录不因为被压下去就丢掉**:任何一态上 `view.breaker` 都照带。`available` 因此有**两句**
+  措辞 —— 「在跑」与「在跑、但这个会话上**曾经**熔断过」是两条不同的下一步(后者要去看那次失败为什么
+  发生,它随时可能再来一次)。
+- 🔴 **别渲「不新开会话就恢复不了」**:闩是**一条腿**的事实,后一条腿会铸一只新的、闩关着的
+  decider ⇒ 那句话是编的。本包的两句熔断措辞都只说真的发生过的事(什么时候、因为什么、连着几次)。
+- 🔴 **`lastCause` 开集读**:词的属主在 core;端按具名词写的 `switch` **必须带 `default`**,
+  或者直接用 `classifierStatusDetail()`(它自带兜底句,原样带上那个词供运维追问上游)。
+- 🔴 **时刻是 UTC ISO**:时区是宿主的事。端要本地化就拿 `view.breaker.openedAtMs` **自己**格式化,
+  别去改那句话 —— 而 `openedAtMs` 已由窄读收进 `Date` 的真实值域(一个 wire 上的 `1e20` 会让
+  `toISOString()` 当场 `RangeError`,那是整屏崩不是一行渲不出)。
+
+---
+
+### 28d. ③ `DecisionReason` +`read_only`:**候 sdk**(本批零导出)
+
+`gateVocabulary.ts` 今天承载的是 `DeniedBy`(谁拒的)与 `AskOrigin`(谁问的)两张表。
+`DecisionReason`(**为什么这么判**)是**第三个**语义面,本包一张表都还没有。
+
+0.64.0 亲验的事实(别只信版本号):
+
+- 实装 **sdk 8.8.0** 全树**零** `DecisionReason` —— 那个联合上游至今没镜像给 sdk;
+- 实装 **core 7.10.0** 的 `DECISION_REASONS` 是**九词**(rule / mode / hook / safety / classifier /
+  persisted_rule / sandbox / org_rule / org_unavailable),**没有** `read_only`;npm 上
+  `@sema-agent/core` 的 latest 就是 7.10.0。
+
+⇒ 本批**不自铸**那张表(下游自铸的联合在上游镜像出来的那天就是第二个会漂的源,与
+`permissionRuleIssue.ts` 的「候上游导出即换」同款处置),改为在
+`scripts/run-gate-vocabulary-test.mjs` 的 D 段**两端各断言一次缺席**:sdk 那端(镜像到货时红)与
+devDep core 那端(提货批抬版时先红)。**红的那一刻 = 该铸一句「allowed: read-only shell command」
+并给三端一个铸点的施工令**,不是删锚的理由。
+
+🔴 **端本批无事可做**:在那句话有铸点之前,端**别自拼**一句 —— 那正是这条锚要避免的第二个源。
+
+---
+
+### 28e. ④⑤ 判据订正与依赖
+
+- **④ §27j 的 G-20**:判据口径已按 test [6783] G-1/G-2 订正(见 §27j 该条)。要点:
+  `displayStatus` **不在** `projectWorkflowRun` 的 agent 行上,显示词由
+  `agentDisplayStatus(agent, workflowActive)` **二次派生**。机读锚在
+  `scripts/run-client-core-pure-test.mjs` 的 G-20 段。**端零改**。
+- **⑤ devDep `@sema-agent/settings-schema ^1.10.0`**:**不进 peer**(本包运行期与 `.d.ts` 都不引用它),
+  **不出包**。它买的是一条跨包前提门 —— `applyProbeToEntry` 的产物要经 `ModelEntry` 的 zod 解析落库,
+  而那一格哪天从 parse-transparent 改成窄类型,探针写的 `thinkingFormat` 会在落库那一刻被**静默剥掉**
+  (三端看不到任何错误,长得就像「探测没跑」)。门里真跑一次那只解析器拿真产物对照,并用两个
+  「必须被拒」的形证明它不是一台「什么都收」的解析器。**端无事可做。**
+
+---
+
+### 28f. 🔴 三端换装清单(逐件坐标)
+
+| 件 | 壳(cli) | web-client | desktop |
+|---|---|---|---|
+| ① 探针 | 模型目录页/新增模型向导加一个「探测思考能力」动作:端实现 `send`(读自己那条凭证轨,**绝不**把 key 交进本包)→ `probeModelCapability(entry, send)` → 拿 `verdict` 渲结果 → 用户确认后 `applyProbeToEntry(entry, result)` 落库。`doctor` 的模型段可复用同一只结论渲一行。🔴 `inconclusive` 那一格**必须**渲成「这次没探到」而不是「不会思考」;`cannot_disable` 渲「会思考、当前关不掉;这个席位将按 low 档运行」(clay 裁),并读 `evidence.lowEffortAccepted` 决定那半句说不说得下去 | 模型设置页同左;`send` 走浏览器 `fetch`(注意 CORS 与代理由部署决定,失败照 `inconclusive` 渲) | 同 web-client;`send` 走主进程那条腿,渲染进程只拿结论 |
+| ② 状态面 | `doctor` 的 Permissions 段加**一行** `classifierStatusDetail(classifierStatusOf(autoMode, ask))`;`undefined` ⇒ **整行不渲**(不是渲「正常」)。权限卡的状态栏同一只铸点。🔴 `_sema_autoMode.breaker` 缺席 = 老引擎,别渲「没熔断过」 | 模型设置页/权限卡同左 | 同左 |
+| ③ uplift 锚 | 无 | 无 | 无 |
+| ④ G-20 订正 | 无(test 侧改判据) | 无 | 无 |
+| ⑤ 落库前提门 | 无 | 无 | 无 |
+
+**共同的两条**(三端逐条对照):
+
+1. 🔴 **`send` 是端的责任面**:凭证、代理、超时、并发上限、以及「探测要不要征得用户同意」都在端。
+   本包只保证**判定与序列**,不保证任何一台网关的行为。
+2. 🔴 **别在端上再写一份判定**:`thinkingIsOff` 那三条(零思考 / 正文非空 / 没被拒)、三态优先序、
+   缺席语义,端一条都不要自己复述 —— 复述一份就是第二个会漂的源,而这正是本包存在的理由。
+
+---
+
+### 28g. 黑盒判据(test 视角;以 `send` 桩序列可复现,不引用内部实现)
+
+> 🔴 **G-21…G-27 全部零网络可复现**:喂一只按剧本作答的 `send` 桩,数它被调用了几次、每次的请求体
+> 带的是哪一种拼法。这一节刻意做成这样,正是为了让 test 不必对着一台真网关花钱。
+
+- **G-21**:桩第一发就答「只有正文、没有思考通道」—— 结论是「不会思考」,而桩**总共只被调用一次**
+  (多烧任何一次往返都是缺陷:那是真钱)。
+- **G-21b**(🔴 异源复审逼出来的,**三个同形各跑一遍**):桩第一发分别答 ①**空正文**
+  ②**纯空白正文**(一个空格)③**被截断**的正文(`finish_reason: "length"`),都是零思考、HTTP 200
+  的合法回执 —— 三次的结论都是**「没探出来」**而不是「不会思考」,结论里**根本没有「会不会思考」
+  这一格**;把它落到一个原本声明了「会思考」的条目上,那一格**一个字节都没变**。
+  反向:同一构造换成一条答完了的非空正文,结论立刻变回「不会思考」。
+- **G-22**:桩对**带模板参数 `chat_template_kwargs.enable_thinking=false`** 的那一发答干净正文,对
+  别的一律答「还在思考、正文空」—— 结论点名的拼法是模板形,而桩**恰被调用两次**,且**顶层
+  `enable_thinking` 一次都没出现在线上**。
+- **G-23**:反过来,桩**只**认顶层 `enable_thinking=false` —— 结论点名顶层形,桩恰被调用三次,
+  调用序逐格是「baseline → 模板形 → 顶层形」(颠倒这个序 = 对每台这类网关多烧一次往返)。
+- **G-24**:桩对**每一发**都答「还在思考」—— 结论是「会思考、关不掉」,**不带任何拼法**;桩此后
+  **还多被调用一次**,那一发带的是 `reasoning_effort:"low"`。桩对那一发答 4xx 时,结论仍是
+  「关不掉」,但「低档收不收」那一格是**否**。
+- **G-24b**(🔴 混合形,异源复审逼出来的):桩只让**其中一发**试关超时、其余照答「还在思考」——
+  结论是**「没探出来」**而不是「关不掉」(那一种拼法压根没被证伪);把同一只条目落笔之后,
+  条目上**原有的拼法一个字节都没变**。反向:同一构造把那一发换成正常作答,结论立刻变回「关不掉」。
+- **G-24d**(🔴 同族第二形):桩让**四发试关全部**答空正文、零思考、HTTP 200 —— 结论同样是
+  **「没探出来」**(那四发一个字都没证明「思考还开着」),条目上原有的拼法照旧一个字节都没变。
+- **G-24e**(🔴 同族第三形):把**其中一发**试关换成纯空白正文、或换成被截断的正文 —— 那一发
+  **不算「关掉了」**(不许据它铸拼法),整只结论是「没探出来」,而条目上原有的拼法一个字节都没变。
+- **G-24c**:给条目的 compat 里塞一个名为 `__proto__` 的**自有**键(`JSON.parse` 造得出),再落一次
+  「关不掉」的结论 —— 铸出来的 compat **原型没被换掉**、那一键仍是自有属性、该删的那一键真的删了。
+- **G-25**:桩第一发就抛错(或答 401)—— 结论是「没探出来」,桩**不再被调用**,而且结论里**根本
+  没有「会不会思考」这一格**(不是「不会思考」)。把它落到条目上时,**条目一个键都不变**。
+- **G-26**:桩第一发答「在思考」,此后**每一发都抛错** —— 结论仍是「没探出来」(不是「关不掉」),
+  而「会不会思考」这一格**在场且为真**。
+- **G-27**:在答案与思考通道里各埋一串独一无二的文本 —— 把整只结论序列化之后,那串文本**一个字节
+  都不出现**(它要能整只进日志与工单)。
+- **G-28**:让一条会话的 auto 分类器**熔断**(连续失败到闩合上),而后续这条腿**没有重新武装**——
+  诊断行上那一句同时报出**成因、连续失败次数与合闩时刻**;把次数换一个数重放,**那句话里的数字
+  跟着变**(不是碰巧命中时刻串里的某个数字)。
+- **G-28b**(🔴 异源复审 r2 逼出来的):同一条会话上让后一条腿**重新武装**(auto 又跑起来了),
+  而那条旧熔断记录仍在 —— 诊断行说的是**「在跑」**,不是「已关闭」;同一行里**仍带得出**那段历史
+  (曾经熔断过、什么时候、因为什么、连着几次)。🔴 两句里**都不许**出现「不新开会话就恢复不了」
+  这类话 —— 那条腿已经在放行了。
+- **G-29**:对一台**不投熔断记录**的 worker(<7.69.0,或这个会话本来就没熔断过)做同样的事 ——
+  诊断行上**不出现**任何关于熔断的话(不是渲成「没熔断过」,也不是渲成「一定是老引擎」)。
+  而同一台机器上让分类器**这一轮**超时:诊断行改说**「这一轮没跑成」**(它是一条真事实,照渲),
+  且与卡上那句「这一刻为什么问我」**逐字不同**(两张面答两个问题)。
+- **G-30**:把 auto 完全**不武装**跑一轮 —— 状态那一行**不出现**(不是渲成「分类器正常」);
+  「没武装」这件事仍由既有的 arm 那一格自己回答。
+- **G-31**:构造一条熔断记录,把合闩时刻写成一个**荒谬的大数**(或把次数写成 `0`、成因写成空串)
+  —— **整个界面不崩**(渲染路径不许抛),而那条坏记录**一个字节都不上屏**:这条腿要是没武装,
+  诊断行整行不出现;要是武装着,诊断行就只说**「在跑」**那一句、**不带**任何历史片段。
+  🔴 判据是「坏记录零呈现 + 不崩」,**不是**「整行消失」—— 后者只在没武装那一支成立。
+  同样把 `breaker` 直接写成 `null` 或一个字符串,结果一样。
+- **G-32**:构造一条**这一端没见过的**熔断成因词 —— 那一行**仍出现**,句子里**原样带着那个词**,
+  且与三句已知成因的话**逐字不同**。
+
+---
+
+### 28h. 常驻门
+
+| 门 | 守什么 |
+|---|---|
+| 🆕 `scripts/run-model-capability-probe-test.mjs` | ① 七词方言表对实装 core 双向等值 / 试关序按 `send` 桩调用序列逐格钉死 / 每方言一格正控 + 「顶层关不掉、模板形才关得掉」的真实序列格 / 「正文空」不算关掉了 / `inconclusive` 结果里没有 `reasoning` 这一格且落笔原样退回同一只条目 / `cannot_disable` 删掉被证伪的拼法 / 证据零正文 / 包内零 fetch 零 URL 零凭证键;🆕 **I 段**(件⑤)真跑一次 settings-schema 的 `ModelEntry` 解析拿真产物对照 + 两个「必须被拒」的正控 + 夹具自证 |
+| 🆕 `scripts/run-classifier-status-test.mjs` | ② 熔断记录四键对实装 core 的 `AutoModeBreakerTrip` 逐键对账 + 挂点真字节 / 三键承重一键可缺、`lastCause` 开集读、`openedAtMs` 按 `Date` 值域收 / 投影臂与状态读器共用同一只窄读(逐键相等)、坏记录只丢自己、缺席不铸 `null` / 熔断记录与 `armed`·`reason` 零互证 / 三态优先序 + 没武装与段缺席都判 `undefined` / 三句逐字互异且与卡面四句零重合 / 归层反向钉(窄读住在零 import 的叶子里,状态面刻意留在内核闭包外) |
+| `scripts/run-gate-vocabulary-test.mjs` | 🆕 **D 段**(件③)`DecisionReason`+`read_only` 的 uplift 锚:sdk 端与 devDep core 端**各断言一次缺席**;红了 = 该铸第三张措辞表,不是删锚 |
+| `scripts/run-client-core-pure-test.mjs` | 🆕 G-20 段加一格(件④):逐字断言投影产物的 agent 行**没有** `displayStatus` |
+| `scripts/run-client-core-portability-test.mjs` | 内核闭包上限 9 → **10**(件② 的零 import 叶,逐件记账);index 闭包上限 155 → **157**(件①② 各一件) |
+| `scripts/run-public-surface-test.mjs` | 公面导出基线 **905 → 918** |
+| `scripts/run-integration-doc-freshness-test.mjs` | 本节新增坐标在盘 + 入库;§0a/§2/§2b 计数与基线等值;①c 表长登记 +4 |
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.63.2",
+  "version": "0.64.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",
@@ -37,6 +37,7 @@
     "@sema-agent/agent-types": "^0.2.0",
     "@sema-agent/core": "~7.10.0",
     "@sema-agent/sdk": "^8.8.0",
+    "@sema-agent/settings-schema": "^1.10.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }