@sema-agent/server 7.3.0 → 7.4.0

package/dist/trace/project.js

@@ -349,13 +349,22 @@ export function workspaceChangedEventData(ev) {
  * resume 账本)都是租户可读面,而 operator 投影是 #154 的独立大件——按 core 写死的失败方向,**没有投影
  * 就不得披露**,所以本批先把整段剥掉止泄(此前 sync 腿的裸 catch-all 会把它连同 `lockedConfig` /
  * `compliance` / `memoryAdmission` / `retention` 四个治理面在场位原样透传给任意订阅者)。
- * 哪天 operator 投影落地,它是**另一个**构造器(按调用方身份分叉),不是往这里加键。
+ * operator 投影是**另一个**构造器({@link wiringManifestOperatorEventData},live 腿按调用方身份挑),
+ * 不是往这里加键 —— 两条 durable 腿没有调用方身份可挑,所以它们恒用本构造器。
  * ⚠️ 剥段还必须连**对该段取的哈希**一起剥:`configFingerprint` 同样不投影,理由见下方它那一行的旁注
  * (无盐哈希 + 4 布尔 = 16 组合的谕示器,把「结构上藏起来」的段原样还原出来)。
  *
  * 其余段逐键挑(禁 `{...manifest}`:1.72 task_progress 教训——未来 core 加段必须由人显式处置,而不是
  * 顺着 spread 裸上线,尤其当新段可能又是一个 audience 受限面时)。所有值都是引擎派生的闭枚举/布尔/
  * 有限数/不透明摘要串,**非用户内容 ⇒ 不脱敏**;畸形值一律按缺席处理(不铸假值,与 compacted 同规)。
+ *
+ * 🔴 **未标签面的准入裁定逐面记录在此,缺省不是「放行」**(#154 裁定 C)。core 只给 `governance` 标了
+ * audience,其余段没有标签 —— 没标签**不等于**可以默认投给租户,每一段都要有一次人的裁定,写在这里:
+ *  · `interaction.posture`(三值:interactive / headless / absent)—— **裁:租户可见**。它是部署形的
+ *    自述(这条腿有没有人能答问题),消费端据此决定渲不渲交互面;不是治理秘密,也不构成任何治理位的
+ *    侧信道(它不参与 governance 那 4 个布尔的还原)。
+ * 未来 core 加一段而它没有 audience 标签时,**先在这里补一条裁定再决定挑不挑键** —— 段级完备性钉
+ * (test/wiring-manifest-projection.test.ts)会在那一刻先把人拦下来。
  */
 export function wiringManifestEventData(ev) {
     // 形参照 `compactionOutcomeEventData` / `contextUsageEventData` 先例:全可选 `unknown` + 内部逐层窄化。
@@ -424,10 +433,54 @@ export function wiringManifestEventData(ev) {
         // 「结构上藏起来、经哈希谕示器泄出去」仍然是泄出去,core 写死的失败方向(no projection ⇒ do not
         // disclose)对侧信道一样适用。它的广告用途(判两条腿是不是同一套装配)在本仓与 SDK **今天零消费端**,
         // 所以直接不发,而不是另铸一个「只对已投影字段取哈希」的服务端自造值(那是新 wire 语义,要跨仓对表)。
-        // 回补点:#154 的 operator 投影按调用方身份分叉,那条腿才带 core 的真 fingerprint。
+        // 带 core 真 fingerprint 的是 {@link wiringManifestOperatorEventData}(explicitOperatorOk 为真的 live
+        // 连接才走那条),对那个受众而言四布尔本就在同一份产物里,哈希不再是侧信道。
         ...identityFields(ev),
     };
 }
+/**
+ * `wiring_manifest` 的 **operator 投影**(#154 件一)—— {@link wiringManifestEventData} 的租户形加上
+ * `governance` 段与 core 的真 `configFingerprint`。
+ *
+ * 🔴 分叉发生在**读口**,不在账本:两条 durable 腿(ledger-sink / resume)恒存剥后形,因为账本写的那一刻
+ * 不知道未来的读者是谁(`GET /v1/runs/:id/events` 任何 run owner 都读得到),往账本存全量 = 把 operator-only
+ * 面写进租户可读介质;存两份则是双写漂移源。所以只有 live 腿在**知道调用方身份**的那一刻挑构造器。
+ * 代价是 operator 看不到历史腿的 governance 段 —— 治理四布尔是部署形事实(不随 leg 漂),静态自检面
+ * (`GET /v1/diagnostics/wiring`)随时给出当前真值。
+ *
+ * 准入判据是 `explicitOperatorOk`(**不是** `isOperator`):空 `OPERATOR_PRINCIPALS` 必须是「没有人是
+ * operator」,不能是「所有人都是」—— 后者会让一个没配 operator 名单的部署把治理面发给每一个订阅者。
+ *
+ * `configFingerprint` 只在本构造器里透传:它是 `sha256(canonicalize(manifest 去 leg/去两个 provenance))`
+ * 前 16 hex,**无盐**且输入含整个 governance 段,而 governance 只有 4 个布尔 ⇒ 16 种组合。租户手里已有其余
+ * 全部哈希输入,发给租户等于把剥掉的四位原样还原(谕示器);发给 operator 无损 —— 同一份产物里四布尔本就
+ * 在场。
+ *
+ * governance **逐键挑**(禁 `{...governance}`):core 往这个段里加第五键时必须由人显式处置,而不是顺着
+ * spread 裸上线 —— 这个段的每一键都是部署治理面,新键的默认待遇必须是「不发」。
+ */
+export function wiringManifestOperatorEventData(ev) {
+    // 租户形整体复用(不是复制一份键表):operator 面 ⊇ 租户面 是结构性的,两个构造器不可能在共有段上漂。
+    const tenant = wiringManifestEventData(ev);
+    // 窄读器与租户构造器内的孪生同形而独立 —— 那只构造器被 16 组合谕示器钉钉着,本件不改它一个字节。
+    const str = (v) => (typeof v === "string" && v.length > 0 ? v : undefined);
+    const bool = (v) => (typeof v === "boolean" ? v : undefined);
+    const sec = (v) => (typeof v === "object" && v !== null && !Array.isArray(v) ? { ...v } : undefined);
+    const m = sec(ev.manifest) ?? {};
+    const g = sec(m.governance) ?? {};
+    const governance = {
+        ...(str(g.audience) !== undefined ? { audience: g.audience } : {}),
+        ...(bool(g.lockedConfig) !== undefined ? { lockedConfig: g.lockedConfig } : {}),
+        ...(bool(g.compliance) !== undefined ? { compliance: g.compliance } : {}),
+        ...(bool(g.memoryAdmission) !== undefined ? { memoryAdmission: g.memoryAdmission } : {}),
+        ...(bool(g.retention) !== undefined ? { retention: g.retention } : {}),
+    };
+    return {
+        ...tenant,
+        ...(Object.keys(governance).length > 0 ? { governance } : {}),
+        ...(str(m.configFingerprint) !== undefined ? { configFingerprint: m.configFingerprint } : {}),
+    };
+}
 /**
  * `human_input`(core 5.14.0 design/171 新 `TaskEvent` 臂)—— 「谁把什么喂进了这条 run」的生命周期账本
  * 帧(objective / 实时 steer / nextTurn / parked-steer 续跑 / wake 五个载体共用一个投影点)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/server",
-  "version": "7.3.0",
+  "version": "7.4.0",
   "description": "Sema Server — the server/API implementation layer for Sema, wiring core, registry, model providers, and cloud agent execution. Built on @sema-agent/core.",
   "type": "module",
   "license": "BUSL-1.1",
@@ -54,7 +54,7 @@
     "build:binary:run-local:darwin-arm64": "bun build --compile --target=bun-darwin-arm64 src/run-local.ts --outfile dist/run-local-darwin-arm64"
   },
   "dependencies": {
-    "@sema-agent/core": "^5.14.0",
+    "@sema-agent/core": "^5.16.0",
     "@sema-agent/registry-core": "^0.16.0",
     "e2b": "^2.28.0",
     "libsodium-wrappers": "^0.8.4",
@@ -69,7 +69,7 @@
     "sharp": "^0.35.3"
   },
   "devDependencies": {
-    "@sema-agent/sdk": "^6.6.0",
+    "@sema-agent/sdk": "^6.7.0",
     "@types/libsodium-wrappers": "^0.7.14",
     "@types/node": "22.10.2",
     "@types/pg": "^8.20.0",