@sema-agent/server 7.52.0 → 7.53.0

package/dist/http/send.d.ts

@@ -1,5 +1,5 @@
 /**
- * design/158 A9 seam — response senders, extracted VERBATIM out of `http/server.ts` so the per-domain route
+ * [ref] A9 seam — response senders, extracted VERBATIM out of `http/server.ts` so the per-domain route
  * modules under `http/routes/` can call them without a value edge back into `server.ts` (that edge would close
  * a runtime import cycle — see `test/module-cycle-gate.test.ts`).
  *
@@ -9,7 +9,7 @@
  */
 import type { ServerResponse } from "node:http";
 /**
- * #118(黑板 [5371]②)—— 一条响应「是 SSE 流」的**在场标记**。
+ * [ref](黑板 [ref]②)—— 一条响应「是 SSE 流」的**在场标记**。
  *
  * 引擎附着租约把**打开着的 SSE 流**当作壳的附着租约来数,于是 `handle()` 需要判「这条响应是不是流」。
  * 🔴 **不能靠读回 content-type**(本机 node v24.2.0 实测):`res.writeHead(status, headersObject)` 直接
@@ -27,7 +27,7 @@ export declare function sseHeaders(res: ServerResponse, extra?: Record<string, s
  * 一条 SSE 连接的墙钟上限。到点发一帧 `error`/`STREAM_MAX_DURATION`(**不是**静默关闭 —— 客户端分不出
  * 「到帽了请重连」和「跑完了」)然后收流。
  *
- * 🔴 为什么共享(2026-08-08,#176 二轮扫描 finding):这个数与下面的心跳间隔此前在**三处**各手抄一份
+ * 🔴 为什么共享(2026-08-08,[ref] 二轮扫描 finding):这个数与下面的心跳间隔此前在**三处**各手抄一份
  * —— `http/sse-log.ts`(task_run + image_bake 共用的那台泵)、`http/routes/trace-usage.ts`、
  * `http/routes/approvals-assistant.ts`(它的顶注还自称「parity with streamTaskTrace」)。三处各自有测试
  * 钉着**自己那一份**,没有任何跨副本的一致性钉 ⇒ 单边调帽后「parity」只剩注释里那句话。
@@ -40,14 +40,14 @@ export declare const SSE_MAX_STREAM_MS: number;
  * 长时间无事件时的心跳间隔(防中继的 idle timeout 掐流)。与 {@link SSE_MAX_STREAM_MS} 同批收口。
  *
  * ⚠️ 收口的只有**间隔**,**不含帧形**:`sse-log` / `trace-usage` 发 `data: {}`,`approvals-assistant`
- * 发 `data: {"type":"heartbeat"}`。这是真分歧不是笔误 —— trace-usage 自己的 meta 帧还引着 [2373]C-12
+ * 发 `data: {"type":"heartbeat"}`。这是真分歧不是笔误 —— trace-usage 自己的 meta 帧还引着 [ref]C-12
  * 「每个 data payload 都带 type」的约定,而它的心跳帧没有 type(probe-sse-1 的注释把这条记成「按
  * data.type 分派的客户端会拿到 undefined」)。统一帧形是**行为面**改动(要么给两处加 type=多发一个键,
  * 要么给 approvals 减 type=消费端破坏),属候裁,不在本批的零行为码范围内。
  */
 export declare const SSE_HEARTBEAT_IDLE_MS = 15000;
 export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
-/** A6(design/158 lens1 §C3/lens3 §C3a): canonical error-response sender for sites that already carry a
+/** A6([ref] lens1 §C3/lens3 §C3a): canonical error-response sender for sites that already carry a
  *  machine `errorCode` — `errorCode` is a required positional arg (not optional-bag) so a call site
  *  cannot regress to the "code but no errorCode" shape the error-code-key-gate forbids. Body shape is
  *  `{ error: message, errorCode, ...extra }`; a site that used to ALSO emit a legacy `code` key keeps it
@@ -56,7 +56,7 @@ export declare function sendJson(res: ServerResponse, status: number, body: unkn
  *  where `error`/`errorCode` aren't cleanly separable from the rest of the body, are left on raw
  *  `sendJson` (see the A6 migration notes for the callers still doing that on purpose). */
 export declare function sendError(res: ServerResponse, status: number, errorCode: string, message: string, extra?: Record<string, unknown>): void;
-/** B7(design/158 lens1 §C3):`HttpError` 的兜底 catch-all 站点没有自己的语义分支——`err.code` 在 42 个
+/** B7([ref] lens1 §C3):`HttpError` 的兜底 catch-all 站点没有自己的语义分支——`err.code` 在 42 个
  *  throw 点里只有 3 个带。为了让「errorCode 恒在」在这些站点也成立(而不是靠豁免表放行),按**状态码**
  *  给一个诚实的粗码:它只声明「这类拒绝」,不冒充比 throw 点更细的语义。带 `code` 的 throw 点原样优先。 */
 export declare function httpErrorCode(status: number, code?: string): string;

package/dist/http/server.d.ts

@@ -1,6 +1,6 @@
 import http from "node:http";
 import type { IncomingMessage } from "node:http";
-import { type Runner, type TaskSpec, type TaskResult, type WorkflowRunStore, type MemoryEntry, type MemoryExportBundle, type MemoryImportReport, type EntryProvenanceAccount, type MemoryErasureAttestation, type MemoryEntryOrigin, type OriginClearanceRow, type ConsolidationRunReceipt, type ConsolidationDriverRunRow, type SideQuerySpec, type SideQueryResult, type Brain } from "@sema-agent/core";
+import { type Runner, type TaskSpec, type TaskResult, type WorkflowRunStore, type MemoryEntry, type MemoryExportBundle, type MemoryImportReport, type EntryProvenanceAccount, type MemoryErasureAttestation, type MemoryEntryOrigin, type OriginClearanceRow, type SessionMemoryStatus, type ConsolidationRunReceipt, type ConsolidationDriverRunRow, type SideQuerySpec, type SideQueryResult, type Brain } from "@sema-agent/core";
 import type { TaskRequestBody } from "./wire-types.js";
 import type { ServiceConfig } from "../config-types.js";
 import { type RestartSignal, type SessionMirrorRuling } from "../config-center/facade.js";
@@ -41,13 +41,13 @@ export interface RequestAuth {
     sessionId: string;
     memoryScope?: string;
     /** 142-S4:the SHAPE-VALIDATED **且已归一(小写)** 的 `body.projectId`(authorizer 的 core
-     *  `PROJECT_ID_REGEX` 门通过后折小写回传;A-033.1/#256 宽读严写)。main.ts 拿它查 config.projects 的
+     *  `PROJECT_ID_REGEX` 门通过后折小写回传;[ref]/[ref] 宽读严写)。main.ts 拿它查 config.projects 的
      *  defaultScopes(memory.scopes 种子)。resume 腿(checkpoint 重建 auth)缺席 — 回落持久化的
      *  body.projectId(原始提交已验形),那条回落腿自己再折一次小写,两腿查同一个键。 */
     resolvedProjectId?: string;
 }
 /**
- * design/158 A8 —— ServiceDeps 的**分组窄接口**。
+ * [ref] A8 —— ServiceDeps 的**分组窄接口**。
  *
  * 病:69 个平铺可选字段里 29 个只被单一路由域读、跨 ≥9 域的只有 4 个(config/logger/runStore/metrics)。
  * 平铺形的直接后果 = main.ts 一个上千行的装配字面量,键与键之间没有任何「属于同一件事」的编译期表达,
@@ -67,7 +67,7 @@ export interface RequestAuth {
 export interface ServiceCoreDeps {
     runner: Runner;
     /**
-     * #303:`POST /v1/side-query` 的 brain 出口。**不是** `runner.sideQuery` —— core 的 `SideQuerySpec`
+     * [ref]:`POST /v1/side-query` 的 brain 出口。**不是** `runner.sideQuery` —— core 的 `SideQuerySpec`
      * 结构性没有 key 座位,经 Runner 那条路走的 side-query 恒用 brain 构造时的网关 key 打**模型自己的**
      * baseUrl(上游 401 + 凭据外泄形)。装配点 `boot/side-query-lane.ts` 给它一只 per-model key 注入
      * 的 brain wrapper,models/roles 与 Runner 同源。
@@ -86,7 +86,7 @@ export interface ServiceCoreDeps {
      *  task). The disposition lives INSIDE resolveSpec because only it derives the effective scenario (principal
      *  ruling + defaultScenario) and holds the center-pack snapshot the provider pick uses — an HTTP-side probe
      *  could disagree with the actual assembly (scenario mismatch / centerPrompts refresh TOCTOU). */
-    /** `opts.liveStream` (S-46 件C):这条腿是不是 `POST /v1/tasks/stream` —— **唯一**挂 HITL 活流投递面
+    /** `opts.liveStream` ([ref] 件C):这条腿是不是 `POST /v1/tasks/stream` —— **唯一**挂 HITL 活流投递面
      *  (`question.runWithContext`)的腿。resolveSpec 拿它做逐腿 `interactionPosture` 判据(判据全文见
      *  `boot/resolve-spec.ts` 的 `declaresInteractivePosture`)。缺席/false ⇒ 无人腿,不声明 posture ——
      *  bg(`POST /v1/runs`)、A2A、resume、cron/wake 一律走这一侧,行为字节不变。
@@ -96,9 +96,9 @@ export interface ServiceCoreDeps {
         liveStream?: boolean;
     }) => TaskSpec | Promise<TaskSpec>;
     /**
-     * #196 场景 hands lane 选路:按 `resolveSpec` 刚产出的 TaskSpec 取本任务的执行 Runner。
+     * [ref] 场景 hands lane 选路:按 `resolveSpec` 刚产出的 TaskSpec 取本任务的执行 Runner。
      * 装配点(main.ts)把「场景判别位 → Runner 对」的映射整只闭包传进来 —— 本层不解释场景,只取用。
-     * 缺席 ⇒ 恒 {@link ServiceDeps.runner}(单 Runner 部署形 = #196 之前的行为,逐字不变;测试桩即此形)。
+     * 缺席 ⇒ 恒 {@link ServiceDeps.runner}(单 Runner 部署形 = [ref] 之前的行为,逐字不变;测试桩即此形)。
      */
     runnerFor?: (spec: TaskSpec) => Runner;
 }
@@ -113,20 +113,20 @@ export interface ServiceStoreDeps {
     /** Per-session approval exemption store — enables decide body `remember:"session"` + the
      *  exemptions list/revoke surfaces on /v1/approvals. The ask-gate probe is wired separately (main.ts). */
     approvalExemptionStore?: ApprovalExemptionStore;
-    /** Durable-checkpoint store (design/45, core 1.67): durable F4 suspend/resume. When present, the resume
+    /** Durable-checkpoint store ([ref], core 1.67): durable F4 suspend/resume. When present, the resume
      *  endpoint + suspended-run surfacing are active. Set only when DURABLE_APPROVAL + a TiDB pool. */
     checkpointStore?: CheckpointStoreFull;
     /** E6 durable SessionPolicyStore (operator-tightened per-session tool rules). Enables PUT/GET /v1/sessions/:id/policy
      *  when present; core reads the rules at prepare-time (subtract-only) via RunnerDeps.sessionPolicyStore (wired separately). */
     sessionPolicyStore?: ServiceSessionPolicyStore;
-    /** [3321] tool-results 读面([3315] 请求,core [3322] `buildToolResultRef` 到货):`GET /v1/tasks/:id/
+    /** [ref] tool-results 读面([ref] 请求,core [ref] `buildToolResultRef` 到货):`GET /v1/tasks/:id/
      *  tool-results/:ref` 的数据源 —— 与 RunnerDeps 侧的 offload 店**同实例**(main.ts 的 `toolResultStore`,
      *  即「durable 后端在场」那一只;无 backend 部署里 Runner 用的内存兜底 `runnerOffloadStore` **不接**这里)。
      *  🔴 缺席 ⇒ 路由回 404 而不是 501:501 会向一个无权 caller 暴露「这台机器配没配 durable 店」的部署形,
-     *  与 unknown-ref / 归属不符两臂**同形** 404 才是防 oracle 的收口([3321] 的「另定」项按防 oracle 收紧)。
+     *  与 unknown-ref / 归属不符两臂**同形** 404 才是防 oracle 的收口([ref] 的「另定」项按防 oracle 收紧)。
      *  这是本组「absent ⇒ 501 诚实缺席」通例的**唯一具名例外**,例外理由即上一句。 */
     toolResultStore?: ToolResultStoreFull;
-    /** S-15 per-edited-file rewind history store. Present ⇒ the rewind capabilities are advertised; core uses it
+    /** [ref] per-edited-file rewind history store. Present ⇒ the rewind capabilities are advertised; core uses it
      *  via RunnerDeps.fileHistoryStore (first-touch tracking + per-turn boundaries + tracked-set restore, ANY
      *  env). Also the 2c history-transfer store (exportHistory/importHistory + blob negotiation faces). */
     fileHistoryStore?: ServiceFileHistoryStore;
@@ -134,7 +134,7 @@ export interface ServiceStoreDeps {
      *  POST/GET/DELETE /v1/attachments*。缺席 ⇒ 501(与其他可选 store 面同姿)。绑定/物化半场在
      *  main.ts(resolveSpec + env factory 包装);本面只管上传/取回/删除三动词 + server 权威上限。 */
     taskAttachmentStore?: TaskAttachmentStore;
-    /** design/153 件3d(/decide parked 赎回腿)——与 RunnerDeps/scenarioDeps **同实例**:durable bg
+    /** [ref] 件3d(/decide parked 赎回腿)——与 RunnerDeps/scenarioDeps **同实例**:durable bg
      *  行店 + boot 期从生产装配(buildScenarios)取的裸 Agent ToolSpec。**这两件**与 checkpointStore
      *  齐备时,POST /v1/approvals/:sessionId/decide 对 parked 后台子代的 pending checkpoint 走
      *  claim→execute 赎回腿(src/parked-decide.ts);任一缺席=分支不存在(legacy 腿现状:getCtx
@@ -145,12 +145,12 @@ export interface ServiceStoreDeps {
      *  `task_run` runs ledger. When it carries `listSessions`, GET /v1/sessions sources sessions from the session
      *  store (task_run only joins for run preview); `fork`/`deleteSession` enable the fork/delete routes. */
     sessionStorage?: OwnerAwareSessionStore;
-    /** S8 workflow-run store (design/97/98): enables GET /v1/workflows (list) + /v1/workflows/:id (detail).
+    /** S8 workflow-run store ([ref]/98): enables GET /v1/workflows (list) + /v1/workflows/:id (detail).
      *  Set when SELF_ORCHESTRATION_ENABLED. Live progress (/v1/workflows/:id/stream) is in-process
      *  (subscribeWorkflow) and works whenever self-orchestration is on, store or not. Runs are owner-gated by
      *  `scope` (= the creating principal). Also drives `capabilities.workflowsList` (= "can durably LIST runs"). */
     workflowRunStore?: WorkflowRunStore;
-    /** [1402] journal 读面(PAIR-REVIEW 修车批):GET /v1/workflows/:runId/journal 的数据源——与 runner 侧
+    /** [ref] journal 读面(PAIR-REVIEW 修车批):GET /v1/workflows/:runId/journal 的数据源——与 runner 侧
      *  workflowJournalStore 同一实例(main.ts backend.workflowJournal());缺席=501(与 workflowRunStore 同门)。 */
     workflowJournalStore?: import("@sema-agent/core").WorkflowJournalStore;
     /** Sandbox-image-pool index (IMAGE-API-DESIGN.md §2, pool design §8): enables /v1/images* (query + select).
@@ -162,7 +162,7 @@ export interface ServiceStoreDeps {
      *  together). 🔴 main.ts boot-asserts `operatorPrincipals` is non-empty when this is on (never a
      *  unrestricted-write build-host exec door, §P2.4a). */
     imageBakes?: ImageBake;
-    /** P2 (design/73 §7.2): the outcome-fact sink, for the `GET /v1/outcomes` read aggregate. `summary` is
+    /** P2 ([ref] §7.2): the outcome-fact sink, for the `GET /v1/outcomes` read aggregate. `summary` is
      *  present on the SQL ledgers; a File sink (no query surface) → the endpoint 501s honestly. */
     outcomeSink?: import("../plugins/file-outcome-sink.js").OutcomeSink;
     /** SendUserFile 账本(多租户治理面):scope↔object 映射的读面 GET /v1/sendfile-links。present ⇔ 签发面
@@ -182,7 +182,7 @@ export interface ServiceStoreDeps {
      *  `backend.session()`/`fileHistory()`/`sessionPolicy()`/`resumeAnchor()` must come from ONE backend). Present
      *  whenever a durable backend (tidb/pg/local) is; absent on the env-only/no-backend worker (the routes 501). */
     backend?: StoreBackend;
-    /** #154 车二:**持久化权限规则的同意车道**(core design/179 三步协议的宿主半场)。
+    /** [ref] 车二:**持久化权限规则的同意车道**(core [ref] 三步协议的宿主半场)。
      *  在场 ⇔ 规则店真装配(`backend.permissionRule()` 有值)⇒ `POST /v1/rules/cc-import/{prepare,redeem}`
      *  可用、ask 帧才投 `ruleOffers`;缺席 ⇒ 两口 501、帧上零候选(发一格无处可兑的「不再询问」
      *  = wire 谎言,比缺席更坏)。 */
@@ -199,12 +199,12 @@ export interface ServiceCoordinatorDeps {
      *  seam AND consumed here by `POST /v1/questions/:id/respond` + the per-run ALS wraps on the streaming legs. Absent ⇒
      *  the capability is false + the AskUserQuestion tool headless-defaults (never a live human). */
     question?: QuestionCoordinator;
-    /** [816]/[820]②: live tool-approval coordinator (core onAsk → CC three-choice card). Set when
+    /** [ref]/[ref]②: live tool-approval coordinator (core onAsk → CC three-choice card). Set when
      *  TOOL_APPROVAL_ENABLED. Wired onto the runner's onAsk seam AND consumed here by
      *  `POST /v1/tool-approvals/:id/respond` + the per-run ALS wrap on the SYNC streaming leg (live-only by design —
-     *  every other leg keeps core's fail-closed headless auto-deny, [819]⑤/[820]④). */
+     *  every other leg keeps core's fail-closed headless auto-deny, [ref]⑤/[ref]④). */
     toolApproval?: ToolApprovalCoordinator;
-    /** SVC-5 (design/97 CORE-5 #6): the process-local registry of STEERABLE workflow-agent handles
+    /** SVC-5 ([ref] CORE-5 #6): the process-local registry of STEERABLE workflow-agent handles
      *  (`ctx.agentStream`) live on THIS replica. Enables POST /v1/workflows/:id/agents/:label/steer. See
      *  workflow-agent-steer.ts for the handle-visibility seam status (the registry is real + ready; core does not
      *  yet hand the deployment a handle to register, so the route returns steering.not_running until it does). */
@@ -224,11 +224,11 @@ export interface ServiceCoordinatorDeps {
      *  (the live multi-row task/workflow fleet view: status/elapsed/tokens/doneCount transitions pushed over time).
      *  Present when wired in main.ts; the run + workflow lifecycle publish their per-row deltas to it. */
     fleetBus?: FleetEventBus;
-    /** [3193] 病理1:boot recover(判死前世 running 行并回灌 fleet)完成屏障——`/v1/fleet/stream` 快照组装
+    /** [ref] 病理1:boot recover(判死前世 running 行并回灌 fleet)完成屏障——`/v1/fleet/stream` 快照组装
      *  对它做**有界**等待(3s cap,routes/fleet.ts),SIGKILL 后壳重连不再与 recover 赛跑。缺席或已
      *  resolve=立即组装(memory 后端、无 notify gate 的部署);main.ts 铸(recover 收官即落,失败也落)。 */
     fleetRecoveryDone?: Promise<void>;
-    /** [1196] session-watch registry(SSE 订阅共享探针面)。present ⇔ sessionStorage 有 getLeafId/ownerOf
+    /** [ref] session-watch registry(SSE 订阅共享探针面)。present ⇔ sessionStorage 有 getLeafId/ownerOf
      *  (main.ts 建);absent ⇒ /v1/sessions/:id/events 501(capabilities.sessionEvents 同谓词,永不漂)。 */
     sessionWatch?: import("../session-watch.js").SessionWatchRegistry;
     /** asyncRewake wake 管道 holder(main.ts 建壳,server 启动装 deliver=session→本副本活流 steer)。 */
@@ -237,7 +237,7 @@ export interface ServiceCoordinatorDeps {
     };
     /** SendUserFile(切片2):per-run file_link 帧发射 ALS;undefined ⇒ 工具未建(非 host lane / 未配签发面)。 */
     sendUserFile?: import("../capabilities/send-user-file-tool.js").SendUserFileEmitter;
-    /** v2 leader endpoint (design/50): enables POST /v1/leader (async) + GET /v1/leader/:id. Set when
+    /** v2 leader endpoint ([ref]): enables POST /v1/leader (async) + GET /v1/leader/:id. Set when
      *  LEADER_ENABLED + the leader wiring (e2b workers + git push) is configured. */
     leaderEndpoint?: LeaderEndpoint;
     /** Fire-and-forget session auto-titler (first-submit hook; absent = feature dark). */
@@ -276,7 +276,7 @@ export interface ServiceSeamDeps {
     } | {
         active: string;
     }>;
-    /** [1488]③(b): read a BACKGROUND agent-handle child's final report / current status out of the core
+    /** [ref]③(b): read a BACKGROUND agent-handle child's final report / current status out of the core
      *  TaskRegistry (the same face the TaskOutput tool reads — agent handles are NEVER in the run store).
      *  Wired in main.ts to `defaultTaskRegistry.pollTask` (non-blocking). Access is the REGISTRATION tuple:
      *  owner = the parent run's taskId (resume legs register children under the sessionId — the registry's
@@ -289,7 +289,7 @@ export interface ServiceSeamDeps {
         content: string;
         details: unknown;
     }>;
-    /** [1499] CC TaskOutput 人侧对位 — the GENERIC task-handle read (background_bash cursor-consuming stdout /
+    /** [ref] CC TaskOutput 人侧对位 — the GENERIC task-handle read (background_bash cursor-consuming stdout /
      *  monitor batches / background_agent final report; `workflow` refused at the seam — journal face owns it).
      *  Same registration-tuple access derivation as subagentTaskOutput. Wired in main.ts to the seam over
      *  defaultTaskRegistry.pollTask. */
@@ -301,7 +301,7 @@ export interface ServiceSeamDeps {
         content: string;
         details: unknown;
     }>;
-    /** [1499] CC TaskStop 人侧对位 — stop a background task handle (bash kill / monitor stop / agent abort),
+    /** [ref] CC TaskStop 人侧对位 — stop a background task handle (bash kill / monitor stop / agent abort),
      *  attributed "user". Same kind gate + access derivation as taskHandleOutput. */
     taskHandleStop?: (handle: string, access: {
         owner: string;
@@ -316,9 +316,9 @@ export interface ServiceSeamDeps {
      *  pg|tidb); absent / file posture ⇒ 501 (single-user file memory exports by copying the memory dir). */
     memoryExport?: (scope: string) => Promise<MemoryEntry[]>;
     /**
-     * #345(core 5.57.0 `routePairingStatus`)—— **key↔URL 配对读面**:`GET /v1/models` 每行的
+     * [ref](core 5.57.0 `routePairingStatus`)—— **key↔URL 配对读面**:`GET /v1/models` 每行的
      * `routePairing` 标注就是拿这一只判的。main.ts 接的是**装配好的那只 brain 本身**(不是摘出来的
-     * 函数引用:A-057.2 那条「裸摘引用丢接收者」的教训同款,且 core 的装饰器族是按 `stream` 的同一条
+     * 函数引用:[ref] 那条「裸摘引用丢接收者」的教训同款,且 core 的装饰器族是按 `stream` 的同一条
      * 路再分派 `adjudicateRoute` 的,整只传才不会跳过路由/快切层)。
      *
      * 🔴 缺席 ⇒ 该面每行标 `"unknown"`,**绝不猜**:一只没有 `adjudicateRoute` 面的自定义 brain 是
@@ -332,7 +332,7 @@ export interface ServiceSeamDeps {
      *  (MEMORY_ENGINE_BACKEND=pg|tidb); absent / file posture ⇒ 501 honestly (a single-user file plane
      *  IS the TOC side of a sync — it has no central-authority half to serve). */
     memorySync?: (scope: string, syncReq: MemorySyncRequest) => Promise<MemorySyncResponse>;
-    /** #264 v2-c(core 5.40.0 `MemoryEngine.exportMemoryScopes`):治理完备包的**携出**面。main.ts 把它接到
+    /** [ref] v2-c(core 5.40.0 `MemoryEngine.exportMemoryScopes`):治理完备包的**携出**面。main.ts 把它接到
      *  装配好的 memory engine 上。启用 `POST /v1/memory/export`(operator-only)。
      *  🔴 缺席 = 这个部署**没有记忆引擎**(`MEMORY_ENGINE=off` / 多租 file 底座等暗态)⇒ 501
      *  `capability.memory_engine_required`。注意与 {@link memoryExport} 的**方向相反**:那条要 DB 记忆
@@ -340,13 +340,13 @@ export interface ServiceSeamDeps {
      *  实装,SQL 孪生上引擎会自己响亮拒(`memory.export_incomplete` 原样上 wire)。理由全文见
      *  routes/memory-bundle.ts 的「能力面的诚实形」。 */
     memoryBundleExport?: (scopes: readonly string[]) => Promise<MemoryExportBundle>;
-    /** #264 v2-c(core 5.40.0 `MemoryEngine.importMemoryBundle`):治理完备包的**导入**面(治理写面)。
+    /** [ref] v2-c(core 5.40.0 `MemoryEngine.importMemoryBundle`):治理完备包的**导入**面(治理写面)。
      *  启用 `POST /v1/memory/import`(operator-only)。缺席语义与 {@link memoryBundleExport} 逐字相同 ——
      *  两口共用一个能力判据,因为它们是同一个引擎面的两半(一个部署不可能只有其中一半)。 */
     memoryBundleImport?: (bundle: unknown, opts?: {
         expectedScopes?: readonly string[];
     }) => Promise<MemoryImportReport>;
-    /** design/316 件③(core 5.57.0 `MemoryEngine.provenanceOf` / `eraseMemoryEntries`):出处 / 抹除合规面。
+    /** [ref] 件③(core 5.57.0 `MemoryEngine.provenanceOf` / `eraseMemoryEntries`):出处 / 抹除合规面。
      *  启用 `GET /v1/memory/entries/:entryId/provenance` 与 `POST /v1/memory/erase`(两口 operator-only)。
      *  main.ts 把它接到 `createMemoryComplianceFaces` 的产物上。
      *  🔴 缺席有两个成因,与 {@link memoryBundleExport} **同码不同判据**(同码是因为消费端分支相同:换部署
@@ -363,7 +363,20 @@ export interface ServiceSeamDeps {
             allowedScopes?: readonly string[];
         }) => Promise<MemoryErasureAttestation>;
     };
-    /** design/316 件②(core 5.59.0 `MemoryEngine.listExternalOriginEntries` / `listOriginClearances` /
+    /** [ref] seam①([ref] §S-7,core 7.0.2 [ref] 件1):**会话记忆状态读面**。启用
+     *  `GET /v1/sessions/:id/memory-status`(owner 门,tenant 自助读 —— 不是 operator 面)。
+     *  main.ts 把它接到 `createSessionMemoryStatusFace` 的产物上(单实例引擎,SQL capture 店同座喂入)。
+     *  🔴 缺席的两个成因与 {@link memoryCompliance} **同码**(`capability.memory_engine_required`,消费端分支
+     *  相同:换部署形态):①记忆引擎没接线;②引擎接了但后端**不自带控制面归属**(`controlPlaneRoot`)——
+     *  committedCount/foldedCount/lastCaptureAt 读的是引擎控制面的 lineage 台账,控制面落在副本本地盘的
+     *  部署上,一个「可读的空目录」会把三键铸成**说谎的 0**(可读零必须是真零),所以②在挂载期判掉
+     *  (工厂返 undefined),与 compliance/origin 两族同一条 F-9 裁。
+     *  🔴 face 的五键**全可选**(core `SessionMemoryStatus`):absent = 该事实源不可读,路由逐键透传缺席,
+     *  恒不铸 false/0 替身;`optOutSource:"fault"` = capture 态 indeterminate(383 片2/3 轴直投)。 */
+    sessionMemoryStatus?: {
+        status: (sessionId: string) => Promise<SessionMemoryStatus>;
+    };
+    /** [ref] 件②(core 5.59.0 `MemoryEngine.listExternalOriginEntries` / `listOriginClearances` /
      *  `clearEntryOrigin`):**外源标记人面**。启用 `GET /v1/memory/origin/external`、
      *  `GET /v1/memory/origin/clearances`、`POST /v1/memory/origin/entries/:entryId/clear`(三口 operator-only)。
      *  main.ts 把它接到 `createMemoryOriginFaces` 的产物上。
@@ -393,7 +406,7 @@ export interface ServiceSeamDeps {
             landedSlug: string;
         }>;
     };
-    /** design/378(core 5.58.0 `runMemoryConsolidationDriver`):记忆 **consolidation 阀门**的操作面。
+    /** [ref](core 5.58.0 `runMemoryConsolidationDriver`):记忆 **consolidation 阀门**的操作面。
      *  启用 `POST /v1/admin/memory/consolidation/run` 与 `GET /v1/admin/memory/consolidation`(两口 operator-only)。
      *  main.ts 把它接到 `createMemoryConsolidationFaces` 的产物上。
      *  🔴 缺席的**唯一**成因是「阀门没开」(`MEMORY_CONSOLIDATION_DRIVER` 不是 `on` —— 出厂缺省):
@@ -410,18 +423,18 @@ export interface ServiceSeamDeps {
         run(scope: string): Promise<ConsolidationRunReceipt>;
         lastRun(scope: string): ConsolidationDriverRunRow | undefined;
     };
-    /** design/383 §3.1 / S-50 §1.3(S-49 S-2):per-principal memory-capture opt-out 授权表的管理面
+    /** [ref] §3.1 / [ref] §1.3([ref] S-2):per-principal memory-capture opt-out 授权表的管理面
      *  (`/v1/admin/memory-optout` 四口,operator-only)—— `backend.memoryOptOutGrant()` 的同一只(与
      *  `RuntimeCaps.allowMemoryOptOut` 的 resolver 腿读同一张表,零缓存直读 ⇒ 写后下一次 prepare 即生效)。
      *  缺席 = 本部署没有 SQL 后端(local 车道刻意无源)⇒ 四口 501 `capability.memory_optout_grant_required`
      *  (「换部署形态」族;与 consolidation 阀门的 404 分家:这里不是旋钮没开,是店在本部署上不存在)。 */
     memoryOptOutGrant?: import("../plugins/memory-optout-grant-store-sql.js").MemoryOptOutGrantStore;
-    /** design/170 件A §7 —— org 记忆授权目录,`boot/org-memory.ts` 装配的**同一个实例**(准入 seam 与
+    /** [ref] 件A §7 —— org 记忆授权目录,`boot/org-memory.ts` 装配的**同一个实例**(准入 seam 与
      *  本面共享它的 TTL 缓存/退避窗/gen 高水位)。memory-policy 面的 `org:` 属主门用它回答成员性:
      *  读面要该 scope 在授权表里、写面另要条目 `write === true`。缺席=本部署没有目录源 ⇒ `org:` 键
      *  逐字保持 operator-only(收编前行为),绝不因目录不接线而放宽。 */
     orgMemoryDirectory?: import("../org-memory-admission.js").OrgMemoryDirectory;
-    /** design/177 —— org 共享记忆库的供给面(与 core `RunnerDeps.sharedMemoryStores` **同一个实例**:
+    /** [ref] —— org 共享记忆库的供给面(与 core `RunnerDeps.sharedMemoryStores` **同一个实例**:
      *  HTTP 只读面看到的库集合按定义等于模型面看到的那一份,两面不可能分歧)。
      *  🔴 缺席 ⇒ `/v1/shared-memory/*` 整域不挂载(诚实缺席);挂载还另要 {@link orgMemoryDirectory}
      *  在场 —— 没有成员性判据的读面只能全放或全拒,两个都比「这个面不存在」差。 */
@@ -437,7 +450,7 @@ export interface ServiceSeamDeps {
     /** Degenerate-output a/b instrument: on errorCode=output.degenerate, inspect the session's turns to
      *  classify where the salvageable answer was (counter + log). Fire-and-forget; no-op otherwise. */
     instrumentDegenerate?: (result: TaskResult) => void;
-    /** [1469] side-query 记账 seam(budget.ts createSideQueryAccountant——与 createTracer 同一装配点、
+    /** [ref] side-query 记账 seam(budget.ts createSideQueryAccountant——与 createTracer 同一装配点、
      *  同一组 sink 实例:costQuota/model_cost 指标/fleetUsage/fleetLease,四路同语义)。缺席=零记账
      *  (手搭测试 deps;生产 main.ts 恒传)。 */
     sideQueryAccounting?: (principal: string | undefined, r: {
@@ -454,15 +467,15 @@ export interface ServiceSeamDeps {
         };
     }) => void;
     parkedReviveTool?: import("@sema-agent/core").ToolSpec;
-    /** 可选第三件:revive args 的 `subagent_type` roster 成员集([1588] Q1 成员性规则)。当前生产装配
+    /** 可选第三件:revive args 的 `subagent_type` roster 成员集([ref] Q1 成员性规则)。当前生产装配
      *  **恒缺席**(boot 内建 default 无自定义 agents roster,per-request 的 spec.agents 不进 boot 工具)
-     *  = 恒省略 subagent_type,typed 子代按 general-purpose 形复活(保真度 caveat 已报 core,[1588]
+     *  = 恒省略 subagent_type,typed 子代按 general-purpose 形复活(保真度 caveat 已报 core,[ref]
      *  批复审 G-F1;center roster 接线是候件,字段先留给它与测试口)。 */
     parkedKnownAgentTypes?: ReadonlySet<string>;
-    /** [1596]/[1597] 跨进程父约束重供:decide 腿按部署配置重建 host 任务的同语义父策略链(exempt 锚=
+    /** [ref]/[ref] 跨进程父约束重供:decide 腿按部署配置重建 host 任务的同语义父策略链(exempt 锚=
      *  row.rootSessionId),经 core 1.396 的 `parkedResume.inheritedGate` 席位透传——缺席时重启后带
      *  requiresParentConstraint 的 parked checkpoint 恒被 core pre-CAS 门诚实拒(不可赎回)。
-     *  ⚠️ **async**(A-010.1):重建要按本行 principal 现解 entitlement——理由在 parked-decide.ts 的
+     *  ⚠️ **async**([ref]):重建要按本行 principal 现解 entitlement——理由在 parked-decide.ts 的
      *  `rebuildInheritedGate` 头注。 */
     parkedReviveInheritedGate?: (row: import("@sema-agent/core").BackgroundAgentRecord, identity: {
         principal: string | undefined;
@@ -477,10 +490,10 @@ export interface ServiceObservabilityDeps {
     /** E8 (shell-host contract): per-task × per-model usage accumulator fed by the cost tracer. Shared with `createTracer`
      *  so the durable run lifecycle drains it into `model_usage` events → the `TaskStats.modelUsage` echo. */
     modelUsage?: ModelUsageTracker;
-    /** [998]②: the shared prompt-manifest accumulator (tracer records at prepare; the durable legs drain it
+    /** [ref]②: the shared prompt-manifest accumulator (tracer records at prepare; the durable legs drain it
      *  into `prompt_assembled` events for turns/stream). Same register-fence lifecycle as modelUsage. */
     promptManifests?: PromptManifestTracker;
-    /** Plan-cache recurrence probe (core design/42): per-scope objective recurrence rate, dumped at
+    /** Plan-cache recurrence probe (core [ref]): per-scope objective recurrence rate, dumped at
      *  GET /metrics/plan-cache. Pure in-memory; recorded per finished task on both result paths. */
     planCacheProbe?: PlanCacheProbe;
 }
@@ -508,7 +521,7 @@ export interface ServiceGovernanceDeps {
     costQuota?: QuotaTracker;
     /** D4 AP:worker 侧 quota-lease admission(协商式;center lane 未配 = 缺席 = 零行为)。 */
     fleetLease?: FleetLeaseManager;
-    /** design/166-T1:治理窗账本店(USAGE_WINDOWS 配置时在场,与 config.usageWindows 成对)——提交面
+    /** [ref]-T1:治理窗账本店(USAGE_WINDOWS 配置时在场,与 config.usageWindows 成对)——提交面
      *  pre-admission 读窗用(主力 /v1/runs 是 202 异步,core 进场拒发生在 202 之后永远变不成 429;
      *  这里是异步车道唯一的 429 出路)。enforcement 真源在 core(RunnerDeps 同店),此门是快速座。 */
     usageWindowStore?: import("@sema-agent/core").UsageWindowStore;
@@ -540,7 +553,7 @@ export interface ServiceDeploymentDeps {
      *  • `inflight` is ASSIGNED BY createServer (a live union of this replica's in-flight legs: durable bg/resume
      *    `inflightRuns` + live sync/resume streams `steerableRuns`) — main.ts polls it to know when drain is done.
      *  • /health carries `draining:true` (k8s readiness 摘流信号) + `version` (build self-description).
-     *  • #118:`attachedStreams` 同样 ASSIGNED BY createServer —— 本副本当前打开着的 SSE 流条数
+     *  • [ref]:`attachedStreams` 同样 ASSIGNED BY createServer —— 本副本当前打开着的 SSE 流条数
      *    (= 引擎附着租约集的大小)。消费方是 `boot/engine-lease.ts` 的自退判据;与 `inflight` 同族,
      *    同一个共享盒子,不另开第二条 main↔server 的通道。
      */
@@ -563,20 +576,24 @@ export interface ServiceDeploymentDeps {
      *  auto rolling-restart the worker. Change-detected (not presence) — absent when nothing baked-at-boot
      *  changed, so polling it never causes a restart loop. */
     restartState?: () => RestartSignal | undefined;
-    /** #322 世代账(design/322 §2):本副本的配置收敛状态 —— `/health` 取三键
+    /** [ref] 世代账([ref] §2):本副本的配置收敛状态 —— `/health` 取三键
      *  (configTargetVersion / configAppliedVersion / configApplyStaleMs),`GET /v1/diagnostics/wiring` 取整份
      *  (按组的 appliedVersion / deferredKeys+铸因 / lastRejected 消毒形)。缺席 = 这个进程没有配置管道
      *  (纯 env 部署 / 测试夹具)⇒ 两个面的形状逐字不变(additive)。 */
     configApplyState?: () => import("../config-center/apply-ledger.js").ConfigApplyLedgerView | undefined;
-    /** #322 追加件:`POST /v1/admin/config/refresh` 的实现面 —— 触发**一次既有**的 refresh 拍(在飞则 join)。
+    /** [ref] 追加件:`POST /v1/admin/config/refresh` 的实现面 —— 触发**一次既有**的 refresh 拍(在飞则 join)。
      *  缺席 / 回 `"not-wired"` = 本部署没有配置管道 ⇒ 该口诚实 4xx(绝不吞成 200)。 */
     configRefreshNow?: () => Promise<"triggered" | "not-wired" | "failed">;
-    /** #324(core 5.50 design/338):mid-turn MCP 撤销台账读口 —— GET /v1/sessions/:id/mcp 的展示面与
+    /** DESIGN-278 §5 S2([ref]):center **当前在管**的 ServiceConfig 键集 —— `GET /v1/config/catalog`
+     *  判 `effectiveLane`(env 占位/center 在管/默认)的 center 半场。缺席或返回 undefined = 本部署
+     *  没有配置管道(纯 env worker / 测试夹具)⇒ 目录把每条 center 腿如实标「不在管」(additive)。 */
+    configCenterManagedKeys?: () => ReadonlySet<string> | undefined;
+    /** [ref](core 5.50 [ref]):mid-turn MCP 撤销台账读口 —— GET /v1/sessions/:id/mcp 的展示面与
      *  引擎执行面同一权威(被撤服务器的工具不再进面板)。缺席 = 无中心撤销面(pre-338 展示语义)。 */
     mcpRevocations?: {
         isRevoked(serverName: string): boolean;
     };
-    /** #324 诊断投影:当前被撤销的 MCP 服务器名单(`GET /v1/diagnostics/wiring` 的 mcpRevocations 段)。
+    /** [ref] 诊断投影:当前被撤销的 MCP 服务器名单(`GET /v1/diagnostics/wiring` 的 mcpRevocations 段)。
      *  缺席/返回 undefined = 无配置管道 ⇒ 读面报 null(additive,不铸空壳)。 */
     mcpRevocationState?: () => {
         revoked: string[];
@@ -596,19 +613,19 @@ export interface ServiceDeploymentDeps {
      *  (「探过且活」与「没接线」机读可分),顶层告警键 `storeLive:false` 只在死时出现。status 恒 "ok"
      *  ——liveness≠readiness,DB 死不是进程死;摘流语义留给读键的编排器(与 durable/ready 同姿势,
      *  披露不代裁)。钉:test/health-store-live.test.ts。
-     *  🔴 #305:座席给的 `error` 是**驱动原始 message**(DSN/主机/账号常在其中),而 /health 在鉴权门
+     *  🔴 [ref]:座席给的 `error` 是**驱动原始 message**(DSN/主机/账号常在其中),而 /health 在鉴权门
      *  之前 ⇒ 路由把它过 `publicStoreProbeError` 换成闭集词才上线;原文只走日志轴。 */
     storeLiveState?: () => {
         live: boolean;
         ageMs: number;
         error?: string;
     } | undefined;
-    /** #154 件三:core `describeStaticWiring(deps, specTemplate)` 的 boot 产物 —— `GET /v1/diagnostics/wiring`
+    /** [ref] 件三:core `describeStaticWiring(deps, specTemplate)` 的 boot 产物 —— `GET /v1/diagnostics/wiring`
      *  的 `static` 半场,**与启动期拒启自检读的是同一份**(诊断页与拒启判据结构性同源)。
      *  operator-only 面,故整份原样下发(含 `governance` 段:本面就是那个段的受众)。
      *  缺席 = 这个进程不是由 composition root 装起来的(测试夹具形)⇒ 该路由诚实地不存在(404)。 */
     staticWiring?: import("@sema-agent/core").WiringManifest;
-    /** #252 件2/件3:记忆面姿态(boot/stores.ts 的 `buildMemoryPosture` 产物 —— 与启动日志同一份)。
+    /** [ref] 件2/件3:记忆面姿态(boot/stores.ts 的 `buildMemoryPosture` 产物 —— 与启动日志同一份)。
      *  两个读面共用:`GET /v1/diagnostics/wiring` 的 `memoryPosture` 段(operator-only,全量)与
      *  `GET /v1/capabilities` 的 `memoryEngine` 位(窄投影)。缺席 = 这个进程不是由 composition root 装
      *  起来的(测试夹具形)⇒ 诊断面报 null、能力位取诚实下限 false。 */
@@ -618,7 +635,7 @@ export interface ServiceDeploymentDeps {
      *  proxy. Orthogonal to `workflowsList` (the durable-list axis = `workflowRunStore`). Falls back to the store
      *  proxy when absent (older callers / tests that don't pass it). */
     workflowsCapable?: boolean;
-    /** [5673]③ + codex R1-[medium]:`capabilities.workflowModels` 的**引擎快照席**。main.ts 在 boot 期用
+    /** [ref]③ + codex R1-[medium]:`capabilities.workflowModels` 的**引擎快照席**。main.ts 在 boot 期用
      *  `workflowModelAllowlistFor(config)` 算一次(与 createRunnerDeps 喂给 core `workflowGovernanceBaseline.
      *  workflowModelAllowlist` 的同一只函数、同一 config 代际),多租户 fail-closed 的 undefined 在装配点
      *  折 `[]` ⇒ 生产装配下本席**恒在场**。为什么不让能力面每请求活派生:core 5.49 起 models plane 经
@@ -635,11 +652,11 @@ export interface ServiceKnobDeps {
      *  形无帽)。为什么在 HTTP 面重复店里的检查:店的 never-throw 结果形把一切写失败折成 502,而 502
      *  语义=可重试,对端会对一个永远过不去的 blob 无限重试——413 才是「别再送了」的诚实形。 */
     snapshotBlobSqlCapBytes?: number;
-    /** [1196] SSE 连接帽(缺省 256/副本;超限 503+Retry-After=消费方回落 /head 轮询)。 */
+    /** [ref] SSE 连接帽(缺省 256/副本;超限 503+Retry-After=消费方回落 /head 轮询)。 */
     sessionEventsMaxConnections?: number;
-    /** [1196] SSE 心跳/owner 复核拍距 ms(缺省 25s;测试注入用)。 */
+    /** [ref] SSE 心跳/owner 复核拍距 ms(缺省 25s;测试注入用)。 */
     sessionEventsHeartbeatMs?: number;
-    /** [1196] 背压阻塞断流阈 ms(缺省 60s;write 持续 false 超过即断——僵消费者不无界积压)。 */
+    /** [ref] 背压阻塞断流阈 ms(缺省 60s;write 持续 false 超过即断——僵消费者不无界积压)。 */
     sessionEventsStallMs?: number;
 }
 /** 组槽本身。每组可选:一个只跑 env-only 的 worker 可以一组都不给。 */
@@ -663,8 +680,8 @@ export declare function flattenServiceDeps(deps: ServiceDeps): FlatServiceDeps;
 export declare const MAX_USER_SKILLS = 10;
 /** = core `SKILL_CONTENT_MAX_CHARS`(1MB 加载门,core 1.293 起 invoke 全文零截断、超 1MB 整拒;常量在
  *  dist/core/runner/synthetic-tools.js:84,未从 core 包根导出,故钉本地孪生+本出处注记)。修7 曾对齐旧
- *  20k 截断门([845] 飞轮考据:20k 是压缩保留区口径,invoke 时刻用错),core 1.293 撤门后本门跟随回收
- *  ([853]① 收口)——HTTP 面与引擎加载门同值,超限 400 fail-loud 而非引擎侧整拒后难诊断。 */
+ *  20k 截断门([ref] 飞轮考据:20k 是压缩保留区口径,invoke 时刻用错),core 1.293 撤门后本门跟随回收
+ *  ([ref]① 收口)——HTTP 面与引擎加载门同值,超限 400 fail-loud 而非引擎侧整拒后难诊断。 */
 export declare const MAX_SKILL_CONTENT_CHARS = 1048576;
 export declare const MAX_SYSTEM_PROMPT_CHARS = 16384;
 /** Cap on a request's `outputSchema` (JSON-serialized) — an uncapped schema bloats the prompt + the per-turn
@@ -680,20 +697,20 @@ export declare function validateUserSkills(skills: unknown): string | null;
  *   POST /v1/runs             → async: 202 {taskId, sessionId, status}, runs in background (S1)
  *   GET  /v1/runs/:id         → run status + result (poll)
  *   GET  /v1/runs/:id/events  → SSE replay from Last-Event-ID, then tail to terminal (S2)
- *   POST /v1/sessions/:id/notify → inject an out-of-session event (design/144 §2): live stream ⇒ core
+ *   POST /v1/sessions/:id/notify → inject an out-of-session event ([ref] §2): live stream ⇒ core
  *                                  `TaskStream.notify()`; idle ⇒ parked in the session inbox, drained
  *                                  as a `task_notification` on the next stream open
  *   POST /v1/sessions/:id/wake   → wake a `task_done` pure park with a message and resume it
- *                                  (design/144 §3). NOT a gate decision — a pending gate is refused
+ *                                  ([ref] §3). NOT a gate decision — a pending gate is refused
  *                                  (`wake.gate_pending`). Goes through `resumeWake`, which reuses the
  *                                  resume family's lease/CAS/run-log leg, so it BURNS MODEL TOKENS and
  *                                  is subject to the billable-submit gates (`SESSION_WAKE_RE`).
- *   (both live in `http/routes/notify-wake.ts` — design/158 A9 domain split)
+ *   (both live in `http/routes/notify-wake.ts` — [ref] A9 domain split)
  */
 export declare function createHttpServer(rawDeps: ServiceDeps): http.Server & {
     denyExpiredApprovals: (now: number) => Promise<void>;
     isRunLiveOnThisReplica: (taskId: string) => boolean;
-    /** #329:live 回决腿的 PARKED 赎回席(装配层把它接进协调器的晚绑座,见 {@link redeemParkedAsk})。 */
+    /** [ref]:live 回决腿的 PARKED 赎回席(装配层把它接进协调器的晚绑座,见 {@link redeemParkedAsk})。 */
     redeemParkedAsk: ParkedAskRedeem;
 };
 /** POST endpoints that trigger BILLABLE work — the fail-closed auth guard must cover ALL of them (council: the
@@ -717,12 +734,12 @@ export declare function createHttpServer(rawDeps: ServiceDeps): http.Server & {
  */
 export declare function isMethodDispatchedSubmitPath(url: string): boolean;
 /** 「这台部署配了任何一把 service 凭证吗」—— fail-closed 写门族的真值源。**单一属主**:`handle()` 的
- *  凭证门、#329 的 parked 赎回席、以及 design/378 的 consolidation 阀门启动期告警读同一句(手抄迟早
+ *  凭证门、[ref] 的 parked 赎回席、以及 [ref] 的 consolidation 阀门启动期告警读同一句(手抄迟早
  *  只改一处,而这条判据决定的是「无凭证部署上写口开不开」)。导出仅为最后一个消费点(main.ts)。 */
 export declare function hasServiceAuth(config: ServiceConfig): boolean;
 export declare function isBillableSubmitPath(url: string): boolean;
 /**
- * A-010.23(#209 件5)—— **改写门**:不烧模型、但在**没有任何 service credential** 的部署形下必须与
+ * [ref]([ref] 件5)—— **改写门**:不烧模型、但在**没有任何 service credential** 的部署形下必须与
  * billable / bake 两族一样 fail-closed 的写门。谓词与 `isBillableSubmitPath` **刻意分开**:这几扇门
  * `billable=false`(零模型工作),塞进那张名单会让它们连带吃 drain 与 model-roster-pending 两道 503 ——
  * 而收编与规则读写在排空期/roster 未落时做完全无害。
@@ -731,7 +748,7 @@ export declare function isBillableSubmitPath(url: string): boolean;
  *  · `POST /v1/adoption` —— operator-only 的一次性部署级动作,把一个 principal 名下**每一行**重写到另一个
  *    身份;授权判据 `explicitOperatorOk(gatedPrincipal(...))`。
  *  · `POST /v1/rules/cc-import/*` —— principal lane 的**持久 allow 规则**铸造口;一条持久 allow 规则对后续
- *    同命令的 classify 档 ask 常驻消音(core #144 之后仍然如此,只是不再消 mandated 的那些)。
+ *    同命令的 classify 档 ask 常驻消音(core [ref] 之后仍然如此,只是不再消 mandated 的那些)。
  *  · `DELETE /v1/rules` —— 同一个规则店的**撤销**口。方向相反(收紧)但同样是持久改写,而且它多一条
  *    operator 超范围域(`?principal=` / body 的 `principal` 让 operator 收回**任一**租户的规则)⇒ 自造一个
  *    列在 `OPERATOR_PRINCIPALS` 里的头,就能把每一位租户的规则一次清空。
@@ -745,8 +762,8 @@ export declare function isBillableSubmitPath(url: string): boolean;
  * 当年被抓到的同一形。签名因此收方法,与那只谓词逐字同形。
  * 🔴 读面**原则上**不进本表:`GET /v1/adoption/:id` 与 `GET /v1/rules` 各有自己的**属主门**兜底,本门只拦写。
  *
- * 🔴 **第二个合取项的加宽**(codex 交叉复审 [high],#277 提货批,验真后修)——判据现在是
- * 「持久改写 **或** 授权唯一输入是 principal 头的**跨租户治理读**」。加宽是为了收进 #264 v2-c 的两口:
+ * 🔴 **第二个合取项的加宽**(codex 交叉复审 [high],[ref] 提货批,验真后修)——判据现在是
+ * 「持久改写 **或** 授权唯一输入是 principal 头的**跨租户治理读**」。加宽是为了收进 [ref] v2-c 的两口:
  *  · `POST /v1/memory/import` —— 直接落在**原**判据上,而且是本仓最深的那一种持久改写:它把别处铸的
  *    条目 / 挑战 / 污染标记 / 托管链落进本部署的记忆平面。自造一个在册 operator 头 ⇒ 一份**不当调用方自制的
  *    治理史**成为本店的账;而记忆是模型**每次挂载都读**的面,比种一条常驻 allow 规则更深(那条只影响
@@ -760,7 +777,7 @@ export declare function isBillableSubmitPath(url: string): boolean;
  */
 export declare function isCredentialGatedRewrite(method: string, url: string): boolean;
 /** Stable, low-cardinality route label for metrics/logs (ids collapsed to `:id`).
- *  [#104] 字面量**先于**模式:此前模式先查,五条精确路由被形状桶吞掉(`/v1/approvals/stream`
+ *  [[ref]] 字面量**先于**模式:此前模式先查,五条精确路由被形状桶吞掉(`/v1/approvals/stream`
  *  落 ":id"、`/v1/images/{bakes,select,register}` 落 ":profile"、`/v1/images/bakes/claim` 落
  *  "bakes/:id")——长连接 stream 的 duration 混进 :id 桶正是 fleet/stream 案的同族错桶病。
  *  精确匹配恒比形状匹配更对,序修零反例(billable-route-declaration 门逐样本钉)。 */