@sema-agent/client-core 0.23.1 → 0.24.1

package/README.md

@@ -23,7 +23,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-**Version:** 0.23.1
+**Version:** 0.24.1
 
 - **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
@@ -53,7 +53,7 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
     `SseIdleError`, `probeHealth`, `APIError` and `TaskStopConflictError` are imported as values in
     five modules, and the browser bundle really bundles the SDK through (the portability guard would
     exit 3 rather than quietly mark it external).
-  - The declared floor is `>=6.9.0`, and it is *witnessed*: the guard checks that an actually
+  - The declared floor is `>=6.11.0`, and it is *witnessed*: the guard checks that an actually
     installed SDK at that line still exports every value-level symbol this package imports and still
     declares `TaskStats.costMicroUsd` (the key `costOrNull` reads). A floor nobody ever ran is a
     promise, not a contract.

package/dist/agentsWireCaps.d.ts

@@ -76,8 +76,8 @@ export declare function projectAgentsForWire(defs: readonly AgentDefLike[], deps
  *           解析 —— SDK 对这些统一抛错,catch 归一)⇒ 调用层 fail-soft 照发(旧 server 静默剥字段
  *           无害;引擎真死 stream 自己 fail-loud)。
  * 等价性:3s 预算改经 client timeoutMs;maxRetries=0 单发(否则 503 会按 SDK 缺省重试,探测预算
- * 语义变形)。差分:SDK 恒 stamp x-agent-principal(缺省 'anon:shell-live'),原手抄缺 principal
- * 时省略该头——principal-first 宪法姿势,fail-open 改善(engineWireSdk 头注记账)。
+ * 语义变形)。principal 头:SDK 6.11 起值检查删头——缺席不发(与原手抄同义;F-011 停发后
+ * 单机形恒缺席,owner-null)。
  */
 export declare function engineSupportsTaskAgents(baseUrl: string, opts?: EngineProbeOpts): Promise<boolean | undefined>;
 export type WireConfig = {

package/dist/agentsWireCaps.js

@@ -195,8 +195,8 @@ export function projectAgentsForWire(defs, deps) {
  *           解析 —— SDK 对这些统一抛错,catch 归一)⇒ 调用层 fail-soft 照发(旧 server 静默剥字段
  *           无害;引擎真死 stream 自己 fail-loud)。
  * 等价性:3s 预算改经 client timeoutMs;maxRetries=0 单发(否则 503 会按 SDK 缺省重试,探测预算
- * 语义变形)。差分:SDK 恒 stamp x-agent-principal(缺省 'anon:shell-live'),原手抄缺 principal
- * 时省略该头——principal-first 宪法姿势,fail-open 改善(engineWireSdk 头注记账)。
+ * 语义变形)。principal 头:SDK 6.11 起值检查删头——缺席不发(与原手抄同义;F-011 停发后
+ * 单机形恒缺席,owner-null)。
  */
 export async function engineSupportsTaskAgents(baseUrl, opts) {
     const client = makeEngineWireClient({

package/dist/detachWire.d.ts

@@ -137,7 +137,9 @@ export interface DetachCancelArm {
     authToken: string | {
         mode: 'loopback-unauthed';
     };
-    principal: string;
+    /** SDK Principal。缺席(undefined)=消费方不发 x-agent-principal 头(owner-null 单机形)——
+     *  与 SDK 6.11 Transport 的值检查删头语义一致;绝不在此铸哨兵值。 */
+    principal: string | undefined;
     /** Reads the durable taskId early-captured off the X-Task-Id response header; null before capture. */
     getTaskId: () => string | null;
 }

package/dist/engineWireSdk.d.ts

@@ -17,7 +17,7 @@
  * fail-closed worker 都是 401,对 owner-gated 路由都是 owner 不匹配,行为面等价。
  *
  * 缺省 maxRetries=0:raw fetch 原语义是单发不重试(探针有自己的预算窗;fire-and-forget 不该静默
- * 翻倍打点)。要 SDK 缺省重试的调用方显式传。principal 缺省 'anon:shell-live'(replEntry live 车道
+ * 翻倍打点)。要 SDK 缺省重试的调用方显式传。principal 缺席=不发头(F-011 停发,replEntry live 车道
  * 同款)——SDK Transport 恒 stamp x-agent-principal(principal-first 宪法);旧 raw fetch 在缺
  * principal 时省略该头,迁移后恒出示,对 requirePrincipal 部署是 fail-open 改善,已记账。
  */
@@ -69,8 +69,9 @@ export type EngineWireClientConfig = {
     baseUrl: string;
     /** 真 token 串;缺省经 wireAuthTokenFor 三态解析(loopback-unauthed / 'anon')。 */
     token?: string;
-    /** 缺省 'anon:shell-live'(replEntry live 车道同款)。 */
-    principal?: string;
+    /** 缺席/undefined=不发 x-agent-principal 头(owner-null;F-011 停发,replEntry live 车道同闸口
+     *  语义;显式 `| undefined` 让 EngineWireTarget.principal 直传合法——exactOptionalPropertyTypes)。 */
+    principal?: string | undefined;
     /** 每次请求的超时预算(SDK 缺省 60s)。 */
     timeoutMs?: number;
     /** 缺省 0(raw fetch 单发语义);要 SDK 重试的调用方显式传。 */

package/dist/engineWireSdk.js

@@ -17,7 +17,7 @@
  * fail-closed worker 都是 401,对 owner-gated 路由都是 owner 不匹配,行为面等价。
  *
  * 缺省 maxRetries=0:raw fetch 原语义是单发不重试(探针有自己的预算窗;fire-and-forget 不该静默
- * 翻倍打点)。要 SDK 缺省重试的调用方显式传。principal 缺省 'anon:shell-live'(replEntry live 车道
+ * 翻倍打点)。要 SDK 缺省重试的调用方显式传。principal 缺席=不发头(F-011 停发,replEntry live 车道
  * 同款)——SDK Transport 恒 stamp x-agent-principal(principal-first 宪法);旧 raw fetch 在缺
  * principal 时省略该头,迁移后恒出示,对 requirePrincipal 部署是 fail-open 改善,已记账。
  */
@@ -75,7 +75,8 @@ export function makeEngineWireClient(cfg) {
         return new AgentClient({
             baseUrl: cfg.baseUrl,
             authToken: resolveWireAuth(cfg.baseUrl, cfg.token),
-            principal: cfg.principal ?? 'anon:shell-live',
+            // F-011 停发:缺席/空串=不给键(SDK 6.11 缺席=不发 x-agent-principal 头,owner-null)。
+            ...(cfg.principal !== undefined && cfg.principal !== '' ? { principal: cfg.principal } : {}),
             ...(cfg.timeoutMs !== undefined ? { timeoutMs: cfg.timeoutMs } : {}),
             maxRetries: cfg.maxRetries ?? 0,
             ...(cfg.fetchImpl ? { fetch: cfg.fetchImpl } : {}),

package/dist/engineWireTarget.d.ts

@@ -1,7 +1,8 @@
 export interface EngineWireTarget {
     baseUrl: string;
     token?: string;
-    principal: string;
+    /** 缺席=不发 x-agent-principal 头(owner-null,F-011 停发);显式装配/env 值恒赢。 */
+    principal?: string;
 }
 /** 装/卸引擎 wire 目标。传 null 卸回 env 派生。返回还原函数。 */
 export declare function installEngineWireTarget(t: EngineWireTarget | null): () => void;

package/dist/engineWireTarget.js

@@ -1,6 +1,6 @@
 /**
  * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6):子代 wire 族里**逐字重复**的 `wireConfig()`
- *    (SEMA_LIVE_BASEURL / SEMA_LIVE_TOKEN / SEMA_LIVE_PRINCIPAL 三读 + 'anon:shell-live' 缺省)
+ *    (SEMA_LIVE_BASEURL / SEMA_LIVE_TOKEN / SEMA_LIVE_PRINCIPAL 三读;principal 缺席=不发头,F-011 停发)
  *    收成一份。
  *
  * 🔴 收编前的事实(壳 HEAD 2aa1d3e 实测,`grep -rln 'function wireConfig' src/sema/`):
@@ -56,9 +56,10 @@ export function engineWireTargetFor(sessionKey) {
     return {
         baseUrl,
         // principal must match the run's owner (stamped by the live stream) — the owner-gated routes answer
-        // 404 for non-owners (no existence oracle), so a missing header reads as "run not found".
+        // 404 for non-owners (no existence oracle). F-011 停发([3279]):缺席=不发头,owner-null 两侧
+        // 对齐(server 7.8.1 读写面窄互认盖存量);显式 SEMA_LIVE_PRINCIPAL 恒赢,绝不铸哨兵值。
         ...(env.SEMA_LIVE_TOKEN ? { token: env.SEMA_LIVE_TOKEN } : {}),
-        principal: env.SEMA_LIVE_PRINCIPAL ?? 'anon:shell-live',
+        ...(env.SEMA_LIVE_PRINCIPAL ? { principal: env.SEMA_LIVE_PRINCIPAL } : {}),
     };
 }
 /** 诊断开关(壳侧 `process.env.SEMA_DEBUG` 的等价读;本包零 process)。 */

package/dist/liveInitToolFace.d.ts

@@ -78,7 +78,7 @@ export declare function _resetLiveInitToolFaceForTest(): void;
  *  同 wire 同 encodeURIComponent)→ { tools(场景附加段), toolset }。fail-soft:任何失败(网络/404/
  *  形状不符/超时)返回 null,调用层回退缺省词表。等价性记账:超时经 client timeoutMs(缺省 2s 同预算,
  *  maxRetries=0 单发同原语义);ScenarioDetail 类型面之外仍保留逐字段运行时校验(引擎回什么不轻信)。
- *  差分:SDK Transport 恒 stamp x-agent-principal(缺省 'anon:shell-live')——原手抄在无 principal
+ *  principal 头:SDK 6.11 起值检查删头(缺席不发;F-011 停发后单机形恒缺席)——原手抄在无 principal
  *  时省略该头;principal-first 宪法姿势,对 requirePrincipal 部署是 fail-open 改善。 */
 export declare function probeScenarioTools(baseUrl: string, scenario: string, opts?: EngineProbeOpts): Promise<{
     tools: string[];

package/dist/liveInitToolFace.js

@@ -126,7 +126,7 @@ export function _resetLiveInitToolFaceForTest() {
  *  同 wire 同 encodeURIComponent)→ { tools(场景附加段), toolset }。fail-soft:任何失败(网络/404/
  *  形状不符/超时)返回 null,调用层回退缺省词表。等价性记账:超时经 client timeoutMs(缺省 2s 同预算,
  *  maxRetries=0 单发同原语义);ScenarioDetail 类型面之外仍保留逐字段运行时校验(引擎回什么不轻信)。
- *  差分:SDK Transport 恒 stamp x-agent-principal(缺省 'anon:shell-live')——原手抄在无 principal
+ *  principal 头:SDK 6.11 起值检查删头(缺席不发;F-011 停发后单机形恒缺席)——原手抄在无 principal
  *  时省略该头;principal-first 宪法姿势,对 requirePrincipal 部署是 fail-open 改善。 */
 export async function probeScenarioTools(baseUrl, scenario, opts) {
     const client = makeEngineWireClient({

package/dist/workflowClient.d.ts

@@ -41,8 +41,9 @@ export interface LiveWorkflowController {
 export interface LiveWorkflowConfig {
     baseUrl: string;
     authToken: string;
-    /** SDK Principal — e.g. 'anon:sema' (workflows are owner-scoped by principal). */
-    principal: string;
+    /** SDK Principal(workflows are owner-scoped by principal)。缺席=不发 x-agent-principal 头
+     *  (owner-null,F-011 停发;两侧同缺席仍对齐)。 */
+    principal: string | undefined;
     /** explicit workflow run id; when absent the source picks the first RUNNING run from list() (else the first). */
     workflowId?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.23.1",
+  "version": "0.24.1",
   "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",
@@ -28,12 +28,12 @@
   },
   "peerDependencies": {
     "@sema-agent/agent-types": ">=0.2.0",
-    "@sema-agent/sdk": ">=6.9.0"
+    "@sema-agent/sdk": ">=6.11.0"
   },
   "devDependencies": {
     "@sema-agent/agent-types": "^0.2.0",
     "@sema-agent/core": "^5.20.0",
-    "@sema-agent/sdk": "^6.9.0",
+    "@sema-agent/sdk": "^6.11.0",
     "esbuild": "^0.27.4",
     "typescript": "^6.0.2"
   }