@sema-agent/client-core 0.22.0 → 0.23.0

package/README.md

@@ -23,7 +23,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.22.0
+**Version:** 0.23.0
 
 - **Today** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver

package/dist/adapter/downstream/eventToSdkMessage.d.ts

@@ -35,6 +35,18 @@
  */
 import type { AgentEvent, CheckpointGate } from '@sema-agent/sdk';
 import { type SDKMessage, type EmitContext, type ModelUsage } from '../types.js';
+/**
+ * 本适配器铸出的**内部臂** `type` 全集(A-004.4 上游半场,2026-08-08)——「内部臂」= 桥面
+ * (bridge-facing)消息,**不是** CC SDK stdout 联合体里的帧形(那些是 assistant/stream_event/
+ * system 等真帧)。消费方(壳 REPL 桥、`-p` print 出口、web/desktop 座位层)对内部臂只有两种
+ * 合法处置:**吞**(不外泄)或**转成真 CC 帧**;顺着兜底裸透传到 stdout/wire = 病族⑥投影缺口
+ * (cli A-004.11/12 实翻:human_input/diagnostics/workspace_changed 曾漏进 `-p` stream-json)。
+ *
+ * 这张表是**唯一权威源**:消费方的吞/转名单必须对账本表(全覆盖,禁手抄子集——A-004.4 的病形
+ * 就是壳手抄了 4 词的子集);本包 pure 门有源码对账腿(armBody 铸点抽取 ≡ 本表),加臂不登记
+ * 即红。`turn_usage` 的铸点在 runStream.ts(usage 聚合腿),不在本文件的 switch 里,同属本表。
+ */
+export declare const INTERNAL_SDK_ARM_TYPES: ReadonlySet<string>;
 /** 「本切片不投影这条臂」的**如实分类**(REF-CC-058 / xlate-04)。 */
 export type EventProjectionNoneReason = 
 /** `turn_end`:usage 折叠是 run driver 的活(`turnEndUsage`),本层无独立可渲染臂。 */

package/dist/adapter/downstream/eventToSdkMessage.js

@@ -19,6 +19,30 @@ function armBody(body) {
 const SUGGESTION_BATCH_CAP = 8;
 /** 单条建议的字符上界;超出截断并留可见痕迹(尾部 `…`)。 */
 const SUGGESTION_CHARS_CAP = 200;
+/**
+ * 本适配器铸出的**内部臂** `type` 全集(A-004.4 上游半场,2026-08-08)——「内部臂」= 桥面
+ * (bridge-facing)消息,**不是** CC SDK stdout 联合体里的帧形(那些是 assistant/stream_event/
+ * system 等真帧)。消费方(壳 REPL 桥、`-p` print 出口、web/desktop 座位层)对内部臂只有两种
+ * 合法处置:**吞**(不外泄)或**转成真 CC 帧**;顺着兜底裸透传到 stdout/wire = 病族⑥投影缺口
+ * (cli A-004.11/12 实翻:human_input/diagnostics/workspace_changed 曾漏进 `-p` stream-json)。
+ *
+ * 这张表是**唯一权威源**:消费方的吞/转名单必须对账本表(全覆盖,禁手抄子集——A-004.4 的病形
+ * 就是壳手抄了 4 词的子集);本包 pure 门有源码对账腿(armBody 铸点抽取 ≡ 本表),加臂不登记
+ * 即红。`turn_usage` 的铸点在 runStream.ts(usage 聚合腿),不在本文件的 switch 里,同属本表。
+ */
+export const INTERNAL_SDK_ARM_TYPES = new Set([
+    'workflow_complete',
+    'tool_end_result',
+    'retry_status',
+    'task_progress',
+    'task_notification',
+    'diagnostics',
+    'steering_injected',
+    'workspace_changed',
+    'prompt_suggestions',
+    'human_input',
+    'turn_usage',
+]);
 /** Wrap neutral content blocks in the CC `assistant` message envelope. */
 function assistantArm(ctx, content) {
     return stamp(ctx, armBody({
@@ -91,9 +115,19 @@ export function eventToSdkMessage(ev, ctx) {
             if (typeof ev.runId !== 'string' || ev.runId.length === 0) {
                 return dropped('malformed', 'workflow_complete');
             }
+            // A-004.9(病族⑤ default-arm-lie,2026-08-08):status 的**合同**是闭集 'completed'|'failed'
+            // (server workflow-completion-inbox.d.ts `status: "completed" | "failed"` 直证;sdk events.d.ts
+            // 宽成 string 只是类型面松),但 wire 是 JSON 开集——此前 `=== 'failed' ? failed : completed`
+            // 把任何第三词(上游未来加终态/坏帧垃圾值)**谎成 completed**。诚实形=与本臂 runId 缺失同款
+            // malformed 处置(dropped 留痕):第三词到达=上游换了合同,提货跟车该在这里翻红显形,而
+            // server 的 WorkflowStatus poll floor 对被丢的完成推送有结构性兜底(inbox 头注明写)。
+            if (ev.status !== 'completed' && ev.status !== 'failed') {
+                return dropped('malformed', 'workflow_complete');
+            }
             return projected(stamp(ctx, armBody({
                 type: 'workflow_complete',
                 runId: ev.runId,
+                // 卫后二值闭集,三元只在 known 词间选路(TS 不从 string 否定收窄字面量,故保留三元形)。
                 status: ev.status === 'failed' ? 'failed' : 'completed',
                 summary: typeof ev.summary === 'string' ? ev.summary : '',
             })));

package/dist/agentSession/backgroundView.js

@@ -16,8 +16,9 @@ export function backgroundStatusFromAssistant(s) {
         default: {
             const exhaustive = s; // 上游加词 ⇒ 这里编译红(闭集穷举卫兵)
             void exhaustive;
-            // wire 开集回落:assistant.tasks 只列活跃调度行,未知新词按「活着」渲(同 workflowClient coerce 族)。
-            return 'running';
+            // A-004.10:wire 开集回落改诚实形——此前未知新词按「活着」渲 'running',上游若加的是
+            // 终态词就是幽灵活跃行(#182 同病)。'unknown' = 不编造任何一头。
+            return 'unknown';
         }
     }
 }
@@ -45,9 +46,9 @@ export function backgroundStatusFromFleet(s) {
         case 'killed':
             return 'stopped';
         default: {
-            const exhaustive = s; // 上游加词 ⇒ 编译红;wire 未知词(读侧开集)⇒ 按活跃行回落
+            const exhaustive = s; // 上游加词 ⇒ 编译红;wire 未知词(读侧开集)⇒ 'unknown' 诚实回落(A-004.10)
             void exhaustive;
-            return 'running';
+            return 'unknown';
         }
     }
 }

package/dist/agentSession/contract.d.ts

@@ -117,7 +117,7 @@ export type BackgroundSource = 'assistant' | 'fleet';
 /** not-configured = assistant 无 TiDB 时的 `{tasks:[]}` 形 —— 与「真没有任务」必须可区分。 */
 export type BackgroundSourceHealth = 'ok' | 'unavailable' | 'not-configured';
 /** 第三套中性词表(不用任一方词表:3 值压不住 9 值,9 值会造 assistant 侧不存在的态)。 */
-export type BackgroundStatus = 'running' | 'waiting-on-human' | 'queued' | 'stopping' | 'done' | 'failed' | 'stopped';
+export type BackgroundStatus = 'running' | 'waiting-on-human' | 'queued' | 'stopping' | 'done' | 'failed' | 'stopped' | 'unknown';
 export interface BackgroundRow {
     /** 带来源判别;fleet 复合 id("<runId> <taskId>")不拆 —— 裸 id union 会重复计数。 */
     readonly key: {

package/dist/toolResult.js

@@ -95,6 +95,13 @@ export const STRUCTURED_DETAIL_TYPES = new Set([
     'agent-transcript',
     'a2a',
     'document',
+    // ── core 5.20.0 跟车两词(A-004.5,2026-08-08;engine-vocab 等值门对 5.20.0 实装物直证)──────
+    // 本条的病根不在词表本身,在**对账物**:门锚的是本仓 devDep core,而 devDep 停在 5.10.0 ⇒
+    // 生态已 5.17.0+(ask-question 已实发)门仍恒绿。修 = devDep 升 5.20.0(门自然翻红显出全部
+    // 漂移)+ 补词。`ask-question` = AskUserQuestion 卡;`bash_invalid_timeout` 与
+    // `path_not_in_root`/`readonly_out_of_root` 同族(参数拒绝的结构化错误卡)。
+    'ask-question',
+    'bash_invalid_timeout',
 ]);
 // 🔴 同批**删三词**(core 5.10.0 BREAKING「幽灵卡」清仓):`multiedit` / `memory-saved` /
 //    `memory-recall` —— 全树零铸点(MultiEdit/批量重放铸的是 `type:"edit"` 带 `edits[]`;core

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.22.0",
+  "version": "0.23.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. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
-    "@sema-agent/core": "^5.10.0",
+    "@sema-agent/core": "^5.20.0",
     "@sema-agent/sdk": "^6.9.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"