@sema-agent/server 7.2.0 → 7.4.0

package/dist/http/routes/tasks.js

@@ -6,12 +6,16 @@ import { defaultSubagentTailBus, projectTailFrame } from "../../fleet/subagent-t
 import { emitPendingWorkflowCompletions, taskNotificationInboxEntry, taskNotificationStreamKey, NotifiedKeys } from "../../orchestration/workflow-completion-inbox.js";
 import { createLedgerSink } from "../../trace/ledger-sink.js";
 import { redactSecrets } from "../../trace/redact.js";
-import { contextUsageEventData, toolStartEventData, toolEndEventData, taskProgressEventData, taskNotificationEventData, compactedEventData, diagnosticsEventData, brainStatusEventData, steeringInjectedEventData, compactionOutcomeEventData, workspaceChangedEventData, appendModelUsageDelta, attachModelUsage } from "../../trace/project.js";
+import { contextUsageEventData, toolStartEventData, toolEndEventData, taskProgressEventData, taskNotificationEventData, compactedEventData, diagnosticsEventData, brainStatusEventData, steeringInjectedEventData, compactionOutcomeEventData, workspaceChangedEventData, wiringManifestEventData, wiringManifestOperatorEventData, humanInputEventData, appendModelUsageDelta, attachModelUsage } from "../../trace/project.js";
 import { cascadeConfig, runMeta } from "../run-meta.js";
 import { scopedIdempotencyKey } from "../idempotency.js";
 import { sendJson, sendError, sseHeaders } from "../send.js";
+import { collectSsePreamble } from "../sse-log.js";
+import { buildApprovalPreamble, buildApprovalPreambleSseFrames } from "../../approval-card.js";
+import { createApprovalCardEmitter, resolveApprovalLeg, resolveStreamApprovalGate } from "../../tool-approval.js";
 import { buildActiveRunConflict, toDoneFrameResult } from "../active-run-conflict.js";
-import { headerStr, gatedPrincipal } from "../principal-gate.js";
+import { headerStr, gatedPrincipal, explicitOperatorOk } from "../principal-gate.js";
+import { failOpenTagForDroppedFrame, recordFailOpen } from "../../observability/fail-open.js";
 /** #135([C95]/[C96]):live 腿 SSE 数据帧的**唯一**出口 —— 载荷带账本可锚 `eventId`(非空 string)的帧
  *  前缀 `id: <eventId>` 行(SSE 游标=账本 eventId,壳/SDK 拿它锚进账本或断线换道 events tail 续读);
  *  无 eventId 的帧**不发行**,EventSource 沿用上一游标 —— 绝不合成占位 id(那会把不可锚的位置伪装成可锚)。
@@ -196,6 +200,54 @@ async function handleTasksBody(req, res, url, ctx, miss) {
                 if (!res.writableEnded)
                     onDisconnect();
             });
+            // #154 件一:本连接的 `wiring_manifest` 帧投哪一形。判据 = `explicitOperatorOk`(**不是** `isOperator`:
+            // 空 `OPERATOR_PRINCIPALS` 必须是「没有人是 operator」;把它读成「所有人都是」会让未配名单的部署把
+            // 治理面发给每一个订阅者)。**每连接求一次**、不逐帧求:身份在一条连接内不会变,而逐帧调用会让
+            // 每帧都重跑一遍凭证解析 —— 更重要的是,身份只在这一处判,帧循环里没有第二个可漂的判据。
+            const wiringOperatorFace = explicitOperatorOk(gatedPrincipal(req, deps.config), deps.config.operatorPrincipals);
+            // #151 车3 §5.1:sync 腿的**开流重放**——`sseHeaders` + meta 帧之后、`streamBody` 之前,把同一
+            // (owner, session) 的未决审批卡投成 `approval_request` preamble 帧。
+            //
+            // 🔴 位置:必须排在**上面那套断连接线之后**(codex 复审 2026-08-06 的 high)。Node 的 `'close'`
+            // 只发一次 —— preamble 的 ≤2s 等待窗若插在接线之前,窗内断连的 close 事件在监听器注册前就烧掉了,
+            // `closed` 恒 false、`ac` 从不 abort ⇒ 模型腿在一条已断的连接上照常起跑并烧 token,「断连即杀 run」
+            // 这条既有契约在窗口内失效。排在接线之后 = 窗内断连照常 abort,腿拿到的是已 abort 的 signal
+            // (与「断连发生在起跑之后」同一条既有路径,不新增早退分支)。
+            //
+            // 🔴 为什么按 **session** 读而不是按 taskId:sync 腿每次开流都是**新 taskId**;它要接的未决卡来自
+            // 「同一 (owner, session) 的上一条腿 / 长命 bg 子代」——正是 `boundAsk` broker 的
+            // `["session", owner, sessionId]` 键域。按 taskId 读永远读不到它们。
+            //
+            // `sessionId` 缺席的 adhoc 流**不重放**:那条腿的行上 task_id/session_id 都是客户端永远看不到的
+            // 一次性 uuid,没有「重连回同一条腿」的概念(§5.1 表:这不是缺陷,是该腿形本来的语义)。
+            //
+            // owner = **verified** principal(与下方 `askOwner`、与 respond 的 owner gate 同一姿势)——重放面是
+            // 跨腿投递,租户门必须带上,不能让 A 租户的开流看到 B 租户的卡。
+            // 有界(2s)+ fail-open:store 抛或挂起都只记一次 warn、零卡继续开流(§5.3)。
+            // 🔴 开关谓词与 runs.ts 同源同理由(codex 复审第二轮 high:回滚下表里可能有残留 STREAM_PENDING
+            // 行,无谓词会破「默认关 = 逐字零变化」;顺带省掉关闭态每次开流的一次 store 往返)。钉:场景9。
+            const replaySessionId = deps.config.streamApproval.enabled ? prepared.spec.sessionId : undefined;
+            if (replaySessionId) {
+                const replayOwner = gatedPrincipal(req, deps.config) ?? null;
+                const preambleFrames = await collectSsePreamble(async (signal) => {
+                    const store = deps.backend?.approvalAsk();
+                    if (!store)
+                        return [];
+                    const rows = await store.listPendingBySession(replaySessionId, replayOwner, signal);
+                    const { frames, skipped, dropped } = buildApprovalPreamble(rows, Date.now(), deps.config.streamApproval.replayMax);
+                    if (skipped > 0)
+                        deps.logger?.warn?.("approval_preamble_row_skipped", { sessionId: replaySessionId, skipped, face: "tasks.stream" });
+                    if (dropped > 0)
+                        deps.logger?.warn?.("approval_preamble_capped", { sessionId: replaySessionId, dropped, replayMax: deps.config.streamApproval.replayMax, face: "tasks.stream" });
+                    return buildApprovalPreambleSseFrames(frames);
+                }, (reason, err) => deps.logger?.warn?.("approval_preamble_failed", { sessionId: replaySessionId, reason, face: "tasks.stream", error: err instanceof Error ? err.message : String(err ?? "") }));
+                // 具名事件、**无 `id:` 行**:preamble 不是账本行,不参与 live 腿的 eventId 游标(sseData 的契约)。
+                // 等待窗里断连了就别再写(与心跳的 `!res.writableEnded && !res.destroyed` 同一判据)。
+                if (!res.writableEnded && !res.destroyed) {
+                    for (const f of preambleFrames)
+                        res.write(`event: ${f.event}\ndata: ${JSON.stringify(f.data)}\n\n`);
+                }
+            }
             // Heartbeat so a long no-token gap (e.g. a debate phase) doesn't trip a mesh/ingress idle timeout on
             // the relay (center). SSE comment lines are ignored by EventSource but keep the socket alive.
             const hb = setInterval(() => {
@@ -704,6 +756,25 @@ async function handleTasksBody(req, res, url, ctx, miss) {
                                     // 与两条 durable 腿同源(它曾是唯一不走 builder 的内容帧=三方普查共同盲区)。
                                     sseData(res, { type: "compaction_outcome", ...compactionOutcomeEventData(ev) });
                                 }
+                                else if (ev.type === "wiring_manifest") {
+                                    // 🔴 core 5.14.0 design/173 新臂。`manifest.governance` 盖着 `audience:"operator"`,core 把
+                                    // 失败方向写死成「no projection ⇒ do not disclose」——所以默认(租户)形整段剥除,含**对该段
+                                    // 取的哈希** `configFingerprint`(无盐 + 4 布尔 = 16 组合谕示器)。
+                                    // #154 件一:分叉只在这条 live 腿(**唯一知道调用方身份的腿**),两条 durable 腿恒存剥后形
+                                    // ——账本写时不知道未来读者是谁,存全量 = 把 operator-only 面写进租户可读介质。
+                                    sseData(res, {
+                                        type: "wiring_manifest",
+                                        ...(wiringOperatorFace
+                                            ? wiringManifestOperatorEventData(ev)
+                                            : wiringManifestEventData(ev)),
+                                    });
+                                }
+                                else if (ev.type === "human_input") {
+                                    // core 5.14.0 design/171 新臂:谁把什么喂进了这条 run(本帧不带正文,只带载体/署名)。
+                                    // 同上——离开裸 catch-all:`issuer`/`actor.*` 是宿主派生的身份串(自由文本形)⇒ 构造器
+                                    // 内过 redactSecrets;`principal` 刻意不投影(帧本就走 owner-scoped 流)。
+                                    sseData(res, { type: "human_input", ...humanInputEventData(ev) });
+                                }
                                 else if (ev.type === "text_delta" || ev.type === "turn_end" || ev.type === "message_committed" || ev.type === "context_usage") {
                                     // 裸 catch-all 白名单化收官(probe-wire-1 表征钉的根治半场):最后四个已知臂离开
                                     // `JSON.stringify(ev)`。**零字节变化**白名单——已知键(含 E2 四 identity 键:live 现状
@@ -743,8 +814,18 @@ async function handleTasksBody(req, res, url, ctx, miss) {
                     const askTaskId = durableTaskId ?? uuidv7();
                     const askOwner = gatedPrincipal(req, deps.config) ?? null;
                     const emitAsk = (frame) => {
-                        if (!res.writableEnded)
-                            res.write(`event: ${frame.type}\ndata: ${JSON.stringify(frame)}\n\n`);
+                        // #157(codex R2 复审 HIGH):流已断时这里是**静默 no-op** —— 上游 coordinator 的 try/catch
+                        // 因此拿不到任何信号,一次断连就被记成"投递成功",问题挂到 TTL 才按无人应答结算。方向本批
+                        // 不动(改成 throw 是既有的刻意决定,见下面 drain 包装处的注释),但**必须留痕**:否则
+                        // `open-frame-undelivered` 只覆盖"持久化抛错",覆盖不到真正常见的那条路。
+                        // `destroyed` 与 `writableEnded` 一起判——emitApproval 用的就是这对谓词。
+                        // 分类按帧型走(`failOpenTagForDroppedFrame`):这条闭包同时驮着 open 帧、完成面包屑与
+                        // 其它运行流帧,一刀切会让**一次**断连把保护型计数记两次,真 open 失败率被面包屑盖住。
+                        if (res.writableEnded || res.destroyed) {
+                            recordFailOpen(failOpenTagForDroppedFrame(frame.type), `frame=${frame.type}`);
+                            return;
+                        }
+                        res.write(`event: ${frame.type}\ndata: ${JSON.stringify(frame)}\n\n`);
                     };
                     // P1 ①②: this new turn is a stream-open for the session — push any async-workflow completions that
                     // finished since (frames ride the SAME connection, before the run's own events; the shell dedups by
@@ -800,22 +881,104 @@ async function handleTasksBody(req, res, url, ctx, miss) {
                             throw new Error("live stream ended — approval card undeliverable");
                         emitAsk(frame);
                     };
+                    // ── #151 车3 刀 3b:sync 腿的流内审批协议装配 ────────────────────────────────────────────
+                    // 上场判据走**单一谓词**(与协调器注入 / `/v1/capabilities` / 回决端点 501 同一个符号)。
+                    // 关着 ⇒ 下面三样(呈卡口 / 腿轴真值 / windowZero 分支)全部不接,本腿字节逐字不变(A-1)。
+                    const streamApprovalOn = resolveStreamApprovalGate({
+                        toolApprovalEnabled: Boolean(deps.toolApproval),
+                        streamApprovalEnabled: deps.config.streamApproval?.enabled === true,
+                        backend: deps.backend,
+                        parkFacility: deps.checkpointStore !== undefined,
+                    }).active;
+                    const legWalltimeMs = typeof prepared.spec.limits?.maxWalltimeMs === "number" ? prepared.spec.limits.maxWalltimeMs : undefined;
+                    // §7.3 + §8.3:本腿的「上不上场 / 窗是不是 0 / leg deadline 真值」走**三腿共用**的那一份判据
+                    // (`resolveApprovalLeg` 顶注记着为什么必须是一个函数:第一版只写在本腿上,bg/resume 两腿因此
+                    // 在开关关时行为变了、窗=0 也不生效)。取值点 = **本腿开始执行的时刻**(这里就是 `streamBody`
+                    // 进入前的最后一站),误差方向偏短=安全侧。
+                    const approvalLeg = resolveApprovalLeg({
+                        streamApprovalOn,
+                        windowMs: deps.config.streamApproval?.windowMs ?? 0,
+                        windowMarginMs: deps.config.streamAskWindowMarginMs,
+                        ...(legWalltimeMs !== undefined ? { legWalltimeMs } : {}),
+                        nowMonotonicMs: performance.now(),
+                    });
+                    const legDeadlineMonotonic = approvalLeg.legDeadlineMonotonic;
+                    // 🔴 ①`forceDurableGate` principal 这一源**本装配点读不到**(`runtimeCapsResolver` 是 core 在
+                    // prepare 内部按 principal 异步解析的 deps 级 seam)。按 §14 §12-5 亲裁:不可读则该源不做 ——
+                    // core 自己兜得住(`prepare-task.js:3330` 的 `runtimeCaps?.forceDurableGate !== true` 让
+                    // suspendAsk 不退位 ⇒ 结构性 park)。代价只是这类 principal 可能先收到一张必被 park 的卡,
+                    // 已写进 wire 契约文档。
+                    const windowZero = approvalLeg.windowZero;
+                    // §4.3(a)+(c):呈卡帧的投递口 —— live SSE **与** detach 车道的 durable 账本**双写**。
+                    // 🔴 codex round2 R2-1 修:两个 sink 的成败判定收进**唯一属主** `createApprovalCardEmitter`
+                    // (顶注写着为什么「两路都没接下就必须抛」——静默成功会压住 park 路由,把一只没人能回答的 ask
+                    // 挂到窗到期)。本处只负责把两个 sink 交出去;`writeLive` 在流已结束时**缺席**(不是 no-op),
+                    // 于是「socket 已死 ∧ 账本写失败」如实成为一次投递失败。
+                    const emitCard = createApprovalCardEmitter({
+                        ...(ledgerSink
+                            ? {
+                                appendDurable: async (frame) => {
+                                    const { type, ...rest } = frame;
+                                    await ledgerSink.append(type, rest);
+                                },
+                            }
+                            : {}),
+                        writeLive: (frame) => {
+                            if (res.writableEnded || res.destroyed)
+                                throw new Error("live stream ended");
+                            emitAsk(frame);
+                        },
+                    });
+                    // 车6 撤卡帧:**live only**(不进 durable tail —— 收敛器/reaper 那类调用点没有 seq 可分配,
+                    // 硬塞进账本会铸一条序号伪造的行;丢帧的结构补偿恒是重连 preamble 的全量对账基准)。
+                    const emitRevokeLive = (frame) => {
+                        if (!res.writableEnded && !res.destroyed)
+                            emitAsk(frame);
+                    };
                     // [1535] server 半场([1539] 定谳断点①的修):同一 ctx 双装——ALS 包裹(宿主自身 ask 的
                     // 既有路)+ **spec.onAsk = boundAsk(ctx)**(core 1.294 继承链 parentConstraints 冻结
                     // `spec.onAsk ?? deps.onAsk` 逐 ancestor 传给每个委派子代:bg 子代 lane 无 ALS ctx 时不再
                     // 「unavailable/零帧 fail-closed deny」,权限卡带 sourceTaskId 浮到宿主本流)。suspendAsk
                     // 退位条件的「onAsk 在场」真值不变(deps.onAsk 恒 wire),durable 部署行为零漂移。
-                    const approvalCtx = deps.toolApproval
-                        ? { taskId: askTaskId, owner: askOwner, emit: emitApproval, abortSignal: ac.signal, ...(prepared.spec.sessionId ? { sessionId: prepared.spec.sessionId } : {}) }
+                    // #151 车3 刀 3b:`windowZero` ⇒ **不包 ALS**(ALS 腿一并让位,`withApproval` 退化成
+                    // `withQuestion`),且下面的 `spec.onAsk` 换成 immediate-unavailable 闭包 —— 两件必须同时做,
+                    // 只做一件的话另一条路仍会呈卡(ALS 腿是 `deps.onAsk` 的到达路)。
+                    const approvalCtx = deps.toolApproval && !windowZero
+                        ? {
+                            taskId: askTaskId,
+                            owner: askOwner,
+                            emit: emitApproval,
+                            abortSignal: ac.signal,
+                            ...(prepared.spec.sessionId ? { sessionId: prepared.spec.sessionId } : {}),
+                            // 协议上场才接新协议族的两个口与两条腿轴;关着时逐字保持既有四键形。
+                            ...(streamApprovalOn
+                                ? {
+                                    emitCard,
+                                    emitRevoke: emitRevokeLive,
+                                    // sync 腿恒是**首腿**:它不经 checkpoint token 复活(那条是 resume 腿的形),
+                                    // 空串是首腿的**真值**而不是「未知」(见 ToolApprovalRunContext.legKey 顶注)。
+                                    legKey: "",
+                                    ...(legDeadlineMonotonic !== undefined ? { legDeadlineMonotonic } : {}),
+                                }
+                                : {}),
+                        }
                         : undefined;
-                    if (approvalCtx && deps.toolApproval) {
+                    if (deps.toolApproval) {
                         // [1546] HIGH-1:闭包只携身份——emit 经 broker 取「当前」活跃流(宿主重连的新 SSE 在
                         // runWithContext 注册时覆盖指针),internalsSnapshot 冻结的闭包不再携死 response/死 signal。
-                        prepared.spec.onAsk = deps.toolApproval.boundAsk({
-                            owner: askOwner,
-                            taskId: askTaskId,
-                            ...(prepared.spec.sessionId ? { sessionId: prepared.spec.sessionId } : {}),
-                        });
+                        // #151 车3 刀 3b(§8.3 ⑦):`windowZero` ⇒ 换成**立即** `"unavailable"` 的闭包。为什么不是
+                        // 「不装 onAsk」:`deps.onAsk` 恒 wire(boot/runner-deps.ts)且 core 取 `spec.onAsk ?? deps.onAsk`,
+                        // per-task 的「缺席」结构上不可达;而 core 的 `approverUnavailable === true` 分支
+                        // (prepare-task.js:3328-3335)**直接绕过** onAsk 在场判定去铸 checkpoint —— 与「onAsk 缺席」
+                        // 在 park 结局上逐字等价,且可 per-task 表达。
+                        prepared.spec.onAsk = windowZero
+                            ? () => Promise.resolve("unavailable")
+                            : deps.toolApproval.boundAsk({
+                                owner: askOwner,
+                                taskId: askTaskId,
+                                ...(prepared.spec.sessionId ? { sessionId: prepared.spec.sessionId } : {}),
+                                ...(streamApprovalOn ? { legKey: "", ...(legDeadlineMonotonic !== undefined ? { legDeadlineMonotonic } : {}) } : {}),
+                            });
                     }
                     const withApproval = () => approvalCtx && deps.toolApproval ? deps.toolApproval.runWithContext(approvalCtx, withQuestion) : withQuestion();
                     // SendUserFile:sync 腿 file_link 走 live out-of-band 帧面(emitAsk)。detach 车道([1840]§五

package/dist/http/server.d.ts

@@ -16,7 +16,7 @@ import type { FleetLeaseManager } from "../fleet-lease.js";
 import { type FleetEventBus } from "../fleet/fleet-bus.js";
 import type { ElicitationCoordinator } from "../elicitation.js";
 import type { QuestionCoordinator } from "../question.js";
-import type { ToolApprovalCoordinator } from "../tool-approval.js";
+import { type ToolApprovalCoordinator } from "../tool-approval.js";
 import type { PlanCacheProbe } from "../plan-cache-probe.js";
 import type { Logger } from "../observability/logger.js";
 import type { Metrics } from "../observability/metrics.js";
@@ -413,6 +413,11 @@ export interface ServiceDeploymentDeps {
         ageMs: number;
         error?: string;
     } | undefined;
+    /** #154 件三:core `describeStaticWiring(deps, specTemplate)` 的 boot 产物 —— `GET /v1/diagnostics/wiring`
+     *  的 `static` 半场,**与启动期拒启自检读的是同一份**(诊断页与拒启判据结构性同源)。
+     *  operator-only 面,故整份原样下发(含 `governance` 段:本面就是那个段的受众)。
+     *  缺席 = 这个进程不是由 composition root 装起来的(测试夹具形)⇒ 该路由诚实地不存在(404)。 */
+    staticWiring?: import("@sema-agent/core").WiringManifest;
     /** ① core ruling — SPLIT: `capabilities.workflows` = the ENGINE-CAN axis, boot-computed from core's own
      *  `workflowsCapability(deps)` (hardened script runner ∧ governance), NOT the `Boolean(workflowRunStore)` store
      *  proxy. Orthogonal to `workflowsList` (the durable-list axis = `workflowRunStore`). Falls back to the store

package/dist/http/server.js

@@ -18,9 +18,10 @@ import {} from "../orchestration/workflow-agent-steer.js";
 import { emitPendingWorkflowCompletions, taskNotificationInboxEntry, taskNotificationStreamKey, NotifiedKeys } from "../orchestration/workflow-completion-inbox.js";
 import { fleetRunPublisher, fleetRunLabels, fleetRunResiduals, isFleetAgentTerminalNotification } from "../fleet/fleet-bus.js";
 import { defaultSubagentTailBus, projectTailFrame } from "../fleet/subagent-tail-bus.js";
+import { createApprovalCardEmitter, resolveApprovalLeg, resolveStreamApprovalGate } from "../tool-approval.js";
 import {} from "../observability/rate-limit.js";
 import { withPrincipal } from "../observability/principal-context.js";
-import { turnEndEventData, contextUsageEventData, toolStartEventData, toolEndEventData, taskProgressEventData, taskNotificationEventData, compactedEventData, diagnosticsEventData, brainStatusEventData, steeringInjectedEventData, compactionOutcomeEventData, workspaceChangedEventData, appendModelUsageDelta, appendPromptManifest, attachModelUsage } from "../trace/project.js";
+import { turnEndEventData, contextUsageEventData, toolStartEventData, toolEndEventData, taskProgressEventData, taskNotificationEventData, compactedEventData, diagnosticsEventData, brainStatusEventData, steeringInjectedEventData, compactionOutcomeEventData, workspaceChangedEventData, wiringManifestEventData, humanInputEventData, appendModelUsageDelta, appendPromptManifest, attachModelUsage } from "../trace/project.js";
 import { redactSecrets } from "../trace/redact.js";
 import { IdempotencyCache, scopedIdempotencyKey } from "./idempotency.js";
 export { scopedIdempotencyKey };
@@ -28,6 +29,7 @@ import { streamSseLog } from "./sse-log.js";
 import { clampVerifyRounds, verifyRoundsFromBody } from "./verify-rounds.js"; // design/97 R9: the shape's neutral leaf (route-ctx.ts type-imports VerifyRoundsSpec from here, not from this file)
 import { handleCapabilities } from "./routes/capabilities.js";
 import { handleObservability } from "./routes/observability.js";
+import { handleDiagnostics } from "./routes/diagnostics.js";
 import { handleMemoryPolicy } from "./routes/memory-policy.js";
 import { handleSessionsList } from "./routes/sessions-list.js";
 import { handleSessions, createSessionsLocal } from "./routes/sessions.js";
@@ -270,7 +272,10 @@ export function createHttpServer(rawDeps) {
                 return await cs.setPendingSteer(token, scope, { text, trusted: false });
             }
             catch {
-                return false; // park 面任何失败=诚实 false(调用方按 dropped 记账),绝不 throw 回 hook 收尾路径
+                // park 面任何失败=诚实 false(调用方按 dropped 记账),绝不 throw 回 hook 收尾路径。
+                // core 5.14.0(#147)新增的 `steering.queue_full` 也落这里:队列满 ⇒ 这条 hook 输出确实没投出去,
+                // `false` 就是它的真实结局。**不给它 wire 码**——本通道是进程内 hook 收尾,没有 HTTP 应答面。
+                return false;
             }
         };
     }
@@ -587,6 +592,9 @@ export function createHttpServer(rawDeps) {
         // design/158 A9:观测只读面(routes/observability.ts):/v1/outcomes + /v1/usage。
         if (await handleObservability(req, res, url, ctx))
             return;
+        // #154 件三:装配自证只读面(routes/diagnostics.ts):GET /v1/diagnostics/wiring(operator-only)。
+        if (await handleDiagnostics(req, res, url, ctx))
+            return;
         // design/158 A9:memory 导出/同步 + /v1/policy 只读面(routes/memory-policy.ts)。
         if (await handleMemoryPolicy(req, res, url, ctx))
             return;
@@ -733,6 +741,13 @@ export function createHttpServer(rawDeps) {
                 return null;
             }
             const perms = st.permissions;
+            // F1(#157 复审车B 留裁,裁修 2026-08-05):出现但形错(数组/标量)⇒ 400,与 settings 自身门(上方
+            // :1097)同姿势——此前数组形被本门与 #157-③ 枚举门的 `!Array.isArray` 双双跳过、parse 层再静默
+            // drop = 保护型配置(deny 规则)端到端无效且无声。null 保持「容器缺席」不咬(既有钉)。
+            if (perms !== undefined && perms !== null && (typeof perms !== "object" || Array.isArray(perms))) {
+                sendError(res, 400, "request.field_invalid", "settings.permissions must be an object");
+                return null;
+            }
             if (perms !== null && typeof perms === "object" && !Array.isArray(perms)) {
                 for (const k of ["allow", "deny", "ask"]) {
                     const arr = perms[k];
@@ -1065,6 +1080,44 @@ export function createHttpServer(rawDeps) {
                 return null;
             }
         }
+        // [2856]② toolMaterializeStrategy:枚举 fail-loud(邻居 promptProfile 同款,同一条理由——静默折缺省
+        // 会让调用方以为切了策略却没切,而这个键的整个存在理由就是 #181 那条「缺省下无界循环」)。
+        {
+            const v = body.toolMaterializeStrategy;
+            if (v !== undefined && v !== "static" && v !== "swap") {
+                sendError(res, 400, "request.field_invalid", 'toolMaterializeStrategy must be "static" or "swap"');
+                return null;
+            }
+        }
+        // #157-② permissionMode:枚举 fail-loud(邻居 promptProfile 同款)。此前开放 string + coercePermissionMode
+        // 未知词静默折 "default"(最爱问档)——方向对(收紧)但静默:拼错(大小写 "Plan")的调用方以为进了 plan
+        // 模式,实拿恒询问,silent-drop 病灶同族([2759] cli settings.json 同源病)。RESUME 重放持久化 body 不过
+        // 此门(coercePermissionMode 宽容层护存量,双层与 [854]/outputStyle 同姿势);bundle 的
+        // settings.permissions.defaultMode drop 臂本批不动(候 [2759] 跨仓对表统一裁,task-settings.ts:216 注)。
+        {
+            const v = body.permissionMode;
+            if (v !== undefined && v !== "default" && v !== "acceptEdits" && v !== "plan" && v !== "bypassPermissions" && v !== "auto") {
+                sendError(res, 400, "request.field_invalid", 'permissionMode must be one of "default" | "acceptEdits" | "plan" | "bypassPermissions" | "auto"');
+                return null;
+            }
+        }
+        // #157-③([2766] cli 对表裁决):bundle 的 settings.permissions.defaultMode 与顶层同形 400 —— 经壳的
+        // 流量上 wire 前已过闭集校验(壳侧对人手编辑面走「降级+响亮」b979f74),server 收到未知词只可能来自
+        // 旧版壳或第三方直连=程序化入口,严格拒合理。parseTaskSettings 的 drop 臂保留护 RESUME 存量
+        // (task-settings.ts:216 双层,同 permissionMode/outputStyle 姿势)。
+        {
+            const s = body.settings;
+            if (s !== null && typeof s === "object" && !Array.isArray(s)) {
+                const p = s.permissions;
+                if (p !== null && typeof p === "object" && !Array.isArray(p)) {
+                    const m = p.defaultMode;
+                    if (m !== undefined && m !== "default" && m !== "acceptEdits" && m !== "plan" && m !== "bypassPermissions" && m !== "auto") {
+                        sendError(res, 400, "request.field_invalid", 'settings.permissions.defaultMode must be one of "default" | "acceptEdits" | "plan" | "bypassPermissions" | "auto"');
+                        return null;
+                    }
+                }
+            }
+        }
         // [865]② fresh-submit 未知模型 400 fail-loud(clay 生产实锤:未知 body.model 静默落 default = 用户不知情
         // 换模型)。🔴 门目录必须与 resolveSpec 同源 = expandTiers 增广视图(codex H1:裸 config.models 会把合法
         // 档位词 "pro"/CC alias "sonnet" 当未知 400 误杀——SDK 契约明确允许它们;增广后 matchCatalogModel 对
@@ -1467,6 +1520,32 @@ export function createHttpServer(rawDeps) {
      */
     async function driveResumeIntoRunLog(args) {
         const { token, sessionId, principal, fleetScope, taskConfig, resumeObjective, outcome, verifyRounds } = args;
+        // ── #151 车3 刀 3b:resume 腿的 `legKey` 真值(设计稿 §3.2′)──────────────────────────────────
+        // 一次 park→resume 的 checkpoint token **就是**这条腿的天然身份:同一 token 重投 = 同一条腿(幂等,
+        // askId 不变);新 park ⇒ 新 token ⇒ 新腿 ⇒ 新 askId ⇒ **重新征询**(§3.3「resume 只重放未完成兄弟」)。
+        // 🔴 存**摘要**不存原文:token 是能力凭据(本仓有 `stripCheckpointToken` 专门把它从可重放账本/结果里
+        // 剥掉),而 `askId` 是 wire 可见值 —— 摘要单向,原始 token 不进任何行、不进任何帧。
+        // 入口算一次(这里就是唯一持有 `args.token` 的地方),下面随 ctx 走。
+        const legKey = createHash("sha256").update(String(token)).digest("hex");
+        // §7.3:本 leg 的 walltime deadline —— 取值点 = 本腿开始执行之前(`resumeStream` 调用在下方)。
+        // 与 sync/bg 两腿同一条判据:只在协议上场时供值,误差方向偏短(安全侧),理由见 routes/tasks.ts 同处注。
+        const streamApprovalOn = resolveStreamApprovalGate({
+            toolApprovalEnabled: Boolean(deps.toolApproval),
+            streamApprovalEnabled: deps.config.streamApproval?.enabled === true,
+            backend: deps.backend,
+            parkFacility: deps.checkpointStore !== undefined,
+        }).active;
+        // 🔴 codex 交叉复审 F4(2026-08-06 真 finding)的修:本腿此前**无条件**包 approval ALS(只把新协议的
+        // 口与轴挂在 `streamApprovalOn` 后面)⇒ ①协议关时本腿凭空多了一条活卡投递路(此前恒 park,A-1 破)、
+        // ②窗=0 在本腿上不生效。裁定走**三腿共用**的 `resolveApprovalLeg`,一份判据三处消费。
+        const approvalLeg = resolveApprovalLeg({
+            streamApprovalOn,
+            windowMs: deps.config.streamApproval?.windowMs ?? 0,
+            windowMarginMs: deps.config.streamAskWindowMarginMs,
+            ...(typeof taskConfig.limits?.maxWalltimeMs === "number" ? { legWalltimeMs: taskConfig.limits.maxWalltimeMs } : {}),
+            nowMonotonicMs: performance.now(),
+        });
+        const legDeadlineMonotonic = approvalLeg.legDeadlineMonotonic;
         // 🔴 复审 C2:lease admission for EVERY resume family (/decide, /answer, /plan_review, preempt-resume)
         // funnels through here — keyed on `principal` = the CHECKPOINT OWNER, the SAME identity the resumed model spend
         // is billed to via `withPrincipal(principal)` below. The route guards deliberately do NOT lease-gate (they'd
@@ -1870,6 +1949,14 @@ export function createHttpServer(rawDeps) {
                                 await flush();
                                 await append("workspace_changed", workspaceChangedEventData(ev));
                                 break; // [1559]二: cwd move (bash cd/EnterWorktree) — shared whitelist builder, §E1 redact — resume twin of the sync + ledger-sink legs
+                            case "wiring_manifest":
+                                await flush();
+                                await append("wiring_manifest", wiringManifestEventData(ev));
+                                break; // 🔴 core 5.14.0 design/173:resume 腿自证清单(每条腿发自己那份)。**同一个**构造器剥 `governance` 段(audience:"operator",no projection ⇒ do not disclose)——三腿同源,分头挑键即下一次泄露
+                            case "human_input":
+                                await flush();
+                                await append("human_input", humanInputEventData(ev));
+                                break; // core 5.14.0 design/171:人类输入生命周期账本(parked-steer 续跑帧正是在这条腿上出现);身份串脱敏在共享构造器里
                             case "message_committed":
                                 await anchor.onMessageCommitted(ev.role, ev.entryId);
                                 break; // R8: USER-message rewind anchor (CC "rewind to the prompt")
@@ -1952,9 +2039,33 @@ export function createHttpServer(rawDeps) {
                     }
                     return safe;
                 };
+                // #151 车3 刀 3b(design/172 §4.3(b)):resume 腿的**审批 ALS** —— 此前这条腿只有 elicitation ctx,
+                // 审批 ask 恒 `"unavailable"` ⇒ 恒 park,一张卡都不产。投递面 = 本腿的 durable events tail
+                // (与 bg 腿同形:`append(type, rest)`,`emitCard` 同口;撤卡帧 live-only 故不接)。
+                // `legKey` = 上面算好的 token 摘要 —— 这是 resume 腿与 sync/bg 首腿的唯一区别,也正是「新 park ⇒
+                // 新腿 ⇒ 重新征询」这条安全语义的承载轴。
+                const approvalEmit = (frame) => {
+                    const { type, ...rest } = frame;
+                    return append(type, rest);
+                };
+                // 包 ALS ⟺ 协议在本腿上场且窗不为 0(F4 修;`windowZero` 在没有 per-task `spec.onAsk` 装配点的
+                // 腿上,「不包 ALS」就是 immediate-unavailable 闭包的等价形,见 resolveApprovalLeg 顶注)。
+                const withApproval = () => deps.toolApproval && taskId && approvalLeg.active && !approvalLeg.windowZero
+                    ? deps.toolApproval.runWithContext({
+                        taskId,
+                        owner: principal ?? null,
+                        emit: approvalEmit,
+                        abortSignal: cancelCtrl.signal,
+                        sessionId,
+                        // 同 bg 腿:唯一 sink 是本腿的 durable tail,append 失败如实算未送达(R2-1)。
+                        emitCard: createApprovalCardEmitter({ appendDurable: (f) => approvalEmit(f) }),
+                        legKey,
+                        ...(legDeadlineMonotonic !== undefined ? { legDeadlineMonotonic } : {}),
+                    }, driveResume)
+                    : driveResume();
                 return await (deps.elicitation && taskId
-                    ? deps.elicitation.runWithContext({ taskId, owner: principal ?? null, emit: (frame) => { const { type, ...rest } = frame; return append(type, rest); }, abortSignal: cancelCtrl.signal }, driveResume)
-                    : driveResume());
+                    ? deps.elicitation.runWithContext({ taskId, owner: principal ?? null, emit: (frame) => { const { type, ...rest } = frame; return append(type, rest); }, abortSignal: cancelCtrl.signal }, withApproval)
+                    : withApproval());
             });
         }
         catch (e) {
@@ -2624,6 +2735,9 @@ const ROUTE_LABEL_PATTERNS = [
     [/^\/v1\/workflows\/[^/]+\/agents\/[^/]+\/steer$/, "/v1/workflows/:id/agents/:aid/steer"],
     [/^\/v1\/workflows\/[^/]+\/(stream|journal)$/, "/v1/workflows/:id/$sub"],
     [/^\/v1\/workflows\/[^/]+$/, "/v1/workflows/:id"],
+    // #151 车4:durable 回决口。必须排在 `/v1/tasks/:id/$sub` **之前**?—— 不必(那条只认三个字面动词),
+    // 但仍按「具体先于泛化」的表序纪律放在它前面,免得日后 $sub 放宽成 `[^/]+` 时静默吞掉本条。
+    [/^\/v1\/tasks\/[^/]+\/asks\/[^/]+\/decision$/, "/v1/tasks/:id/asks/:askId/decision"],
     [/^\/v1\/tasks\/[^/]+\/(turns|stream|artifacts)$/, "/v1/tasks/:id/$sub"],
     [/^\/v1\/leader\/[^/]+$/, "/v1/leader/:id"],
     [/^\/v1\/attachments\/[^/]+$/, "/v1/attachments/:id"],
@@ -2643,6 +2757,8 @@ const ROUTE_LABEL_LITERALS = new Set([
     // 名册门的枚举器当时只认 `url === …`,整条路由对门隐形(枚举器已一并补上)。
     "/v1/fleet/stream",
     "/v1/memory/export", "/v1/sendfile-links",
+    // #154:装配自证读面(operator-only)。低频但**每次都在排障现场被打**,落进 `other` 桶等于排障时看不见。
+    "/v1/diagnostics/wiring",
 ]);
 /** Stable, low-cardinality route label for metrics/logs (ids collapsed to `:id`).
  *  [#104] 字面量**先于**模式:此前模式先查,五条精确路由被形状桶吞掉(`/v1/approvals/stream`

package/dist/http/sse-log.d.ts

@@ -30,7 +30,58 @@ export interface SseLogProvider<E extends {
         event: string;
         data: unknown;
     };
+    /**
+     * #151 车3 §5:**开流 preamble** —— 在 416 判定与 `sseHeaders` **之后**、日志 tail **之前**写的
+     * 一批**非账本**帧(今天唯一的用户 = 审批未决卡的全量对账基准)。
+     *
+     * 🔴 为什么必须是这里的内部 hook,而不是调用方在 `streamSseLog` **之前**自己写:本 helper 的判序是
+     * ①读 `last-event-id`/`?from=` → ②保留期比对、超界直接 `sendError(416)` → ③`sseHeaders` → ④tail。
+     * 在 ① 之前写任何字节 = 提前提交 200 头 ⇒ ② 的 416 分支**结构上不可能再触发**(或触发
+     * headers-already-sent),而调用方自己先调 `sseHeaders` 又会被本 helper 重复写头。
+     *
+     * 返回帧**不带 `id:`** —— 它不是账本行,不参与 `Last-Event-ID` 游标(壳的规则:preamble 给的是
+     * 权威全量卡集,账本重放里的同 id 帧只用于时间线渲染)。
+     *
+     * 缺席 = 零影响(其余 provider 不实现)。失败/挂起的处置见 {@link collectSsePreamble}。
+     *
+     * `signal`(#151 车3 刀 3b,§14.2 遗留记账):有界窗到点时**被 abort** —— 实现方应把它传进自己的
+     * store 读口,让那次读当场以 abort 拒绝,而不是留一个「结果已被丢弃、调用链却还在飞」的悬挂读。
+     * 可达到的语义与残留边界见 `ApprovalAskStore.listPendingBySession` 的 `signal` 注(驱动无取消 seam)。
+     */
+    preamble?(signal: AbortSignal): Promise<Array<{
+        event: string;
+        data: unknown;
+    }>>;
+    /**
+     * `preamble` 被有界超时掐断("timeout")或抛出("error")时的**观测**钩(fail-open,已经决定不挡
+     * 开流了,这里只让域模块用自己的 logger 记一条 warn —— 本叶子模块没有、也不该有 logger)。
+     */
+    onPreambleFailure?(reason: "timeout" | "error", err?: unknown): void;
 }
+/** #151 车3 §5.3:preamble 的**有界**等待上限。挂起的 store 不许拖住开流——开流是壳的主路径,
+ *  而 preamble 只是一个锦上添花的对账基准。超时即按「无卡集基准」继续(与今天等同)。 */
+export declare const SSE_PREAMBLE_TIMEOUT_MS = 2000;
+/**
+ * 跑一次 preamble,**有界 + fail-open**(#151 车3 §5.3)。
+ *
+ * 🔴 只 catch throw 是不够的:store **挂起**(不抛)会把整条开流一起拖住。所以这里是 `Promise.race`
+ * 而不是 try/catch —— 两种失败形(抛 / 不返回)各自有一条出路,都落到「零帧 + 一次 warn + 继续开流」。
+ *
+ * 🔴 #151 车3 刀 3b(§14.2 遗留记账兑现):超时**同时 abort** 一个交给 `preamble` 的 `AbortSignal`。
+ * 此前只是「丢结果」,原 promise 仍在飞 —— DB 挂死时的重连风暴会一轮轮往连接池里堆等待者。现在读口
+ * 拿到 abort 会当场拒绝,调用链不再累积;库那侧的那条查询仍会跑完(驱动无取消 seam,残留边界见
+ * `ApprovalAskStore.listPendingBySession` 的注)。丢结果这条语义不变:preamble 只读,丢弃零副作用。
+ *
+ * 导出给 `routes/tasks.ts` 的 sync 腿直接用 —— 那条腿不走 `streamSseLog`(它不是账本 tail),但
+ * 「有界 + fail-open」这条判据必须是**同一份实现**,不能各腿各写一遍。
+ */
+export declare function collectSsePreamble(preamble: (signal: AbortSignal) => Promise<Array<{
+    event: string;
+    data: unknown;
+}>>, onFailure?: (reason: "timeout" | "error", err?: unknown) => void, timeoutMs?: number): Promise<Array<{
+    event: string;
+    data: unknown;
+}>>;
 /** The shared resumable SSE pump (P2.8) — provider supplies the log-specific differences; the liveness/
  *  heartbeat/416/terminal-re-fetch/15-min-cap logic is identical for task_run + image_bake. */
 export declare function streamSseLog<E extends {

package/dist/http/sse-log.js

@@ -1,4 +1,51 @@
 import { sendJson, sendError, sseHeaders } from "./send.js";
+/** #151 车3 §5.3:preamble 的**有界**等待上限。挂起的 store 不许拖住开流——开流是壳的主路径,
+ *  而 preamble 只是一个锦上添花的对账基准。超时即按「无卡集基准」继续(与今天等同)。 */
+export const SSE_PREAMBLE_TIMEOUT_MS = 2_000;
+/**
+ * 跑一次 preamble,**有界 + fail-open**(#151 车3 §5.3)。
+ *
+ * 🔴 只 catch throw 是不够的:store **挂起**(不抛)会把整条开流一起拖住。所以这里是 `Promise.race`
+ * 而不是 try/catch —— 两种失败形(抛 / 不返回)各自有一条出路,都落到「零帧 + 一次 warn + 继续开流」。
+ *
+ * 🔴 #151 车3 刀 3b(§14.2 遗留记账兑现):超时**同时 abort** 一个交给 `preamble` 的 `AbortSignal`。
+ * 此前只是「丢结果」,原 promise 仍在飞 —— DB 挂死时的重连风暴会一轮轮往连接池里堆等待者。现在读口
+ * 拿到 abort 会当场拒绝,调用链不再累积;库那侧的那条查询仍会跑完(驱动无取消 seam,残留边界见
+ * `ApprovalAskStore.listPendingBySession` 的注)。丢结果这条语义不变:preamble 只读,丢弃零副作用。
+ *
+ * 导出给 `routes/tasks.ts` 的 sync 腿直接用 —— 那条腿不走 `streamSseLog`(它不是账本 tail),但
+ * 「有界 + fail-open」这条判据必须是**同一份实现**,不能各腿各写一遍。
+ */
+export async function collectSsePreamble(preamble, onFailure, timeoutMs = SSE_PREAMBLE_TIMEOUT_MS) {
+    const timedOut = Symbol("preamble-timeout");
+    let timer;
+    const ac = new AbortController();
+    try {
+        const raced = await Promise.race([
+            preamble(ac.signal),
+            new Promise((resolve) => {
+                timer = setTimeout(() => {
+                    ac.abort(); // 先掐读,再回空集——两件事的顺序无关紧要,但都要发生
+                    resolve(timedOut);
+                }, timeoutMs);
+                timer.unref?.(); // 别让这只表把进程钉住(测试进程里尤其明显)
+            }),
+        ]);
+        if (raced === timedOut) {
+            onFailure?.("timeout");
+            return [];
+        }
+        return raced;
+    }
+    catch (err) {
+        onFailure?.("error", err);
+        return [];
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
 /** The shared resumable SSE pump (P2.8) — provider supplies the log-specific differences; the liveness/
  *  heartbeat/416/terminal-re-fetch/15-min-cap logic is identical for task_run + image_bake. */
 export async function streamSseLog(req, res, provider, id, staleMs) {
@@ -14,10 +61,27 @@ export async function streamSseLog(req, res, provider, id, staleMs) {
         }
     }
     sseHeaders(res);
+    // 🔴 断连接线必须**先于** preamble 的等待窗接上(codex 复审 2026-08-06 的 medium):Node 的 `'close'`
+    // 只发一次,在等待窗里断连的客户端其 close 事件会在监听器注册之前烧掉 ⇒ `closed` 恒 false ⇒ 泵照常
+    // 进轮询循环,对着已死的 res 反复 getEvents/statusOf 直到终态/stale/15 分钟帽。本行原本紧跟
+    // sseHeaders,是 preamble 插进来才多出这个窗 —— 所以搬接线、不搬 preamble。
     let closed = false;
     req.on("close", () => {
         closed = true;
     });
+    // #151 车3 §5.1:preamble 排在 416 判定与 sseHeaders **之后**、日志 tail 之前。有界 + fail-open,
+    // 见 collectSsePreamble 顶注;`id:` 行故意不写(非账本行,不推进 Last-Event-ID 游标)。
+    const preamble = provider.preamble?.bind(provider); // bind:接口按方法签名声明,实现方允许用 `this`
+    if (preamble) {
+        const frames = await collectSsePreamble(preamble, (reason, err) => provider.onPreambleFailure?.(reason, err));
+        // 等待窗里断连了就别再写(`closed` 由上面的 close 监听器置;`writableEnded`/`destroyed` 是
+        // 第二道 —— codex 复审第二轮 medium 指出 res 侧的 close 面本 helper 没听,那半条见终报的存疑单,
+        // 这里先把「往已死的 res 写」这半堵掉,判据与 routes/tasks.ts 心跳处逐字同源)。
+        if (!closed && !res.writableEnded && !res.destroyed) {
+            for (const f of frames)
+                res.write(`event: ${f.event}\ndata: ${JSON.stringify(f.data)}\n\n`);
+        }
+    }
     const start = Date.now();
     const MAX_MS = 15 * 60 * 1000;
     let lastBeat = Date.now();