@sema-agent/server 7.133.0 → 7.135.0

package/dist/trace/self-minted-wire.d.ts

@@ -8,7 +8,7 @@ export interface SelfMintedRetiredMember extends SelfMintedWireMember {
     readonly until: string;
 }
 export declare const SELF_MINTED_WIRE: {
-    /** [ref](7.55.0)起的终态成因注;S-929(7.108.0)+`shutdown_before_park`。 */
+    /** [ref](7.55.0)起的终态成因注;[ref](7.108.0)+`shutdown_before_park`。 */
     readonly crashConvergedCause: {
         readonly at: "GET /v1/approvals crashConverged[].cause";
         readonly members: {
@@ -23,7 +23,7 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * S-928(7.110.0):`engine_notice` `task.user_steer_undrained` 上**本仓铸**的那一臂。词表属主是 core(`USER_INPUT_UNDRAINED_CAUSES`,两族共用;
+     * [ref](7.110.0):`engine_notice` `task.user_steer_undrained` 上**本仓铸**的那一臂。词表属主是 core(`USER_INPUT_UNDRAINED_CAUSES`,两族共用;
      * `leg_end` 由引擎铸、逐字过境,不在本表);本表登记的是「这个值自哪一版起由本服务出现在 wire 上」。`satisfies Record<CrashedCause, …>`:
      * core 删掉 `crashed` ⇒ `CrashedCause` 成 never ⇒ 本行编译红。码按受理时的车道选(`user-input-ledger.ts` `acceptedInputKindOf`,车道 = core `injectionLaneOf`,码 = core `USER_INPUT_UNDRAINED_FAMILIES`):本行 = steer 车道。
      */
@@ -36,7 +36,7 @@ export declare const SELF_MINTED_WIRE: {
             };
         };
     };
-    /** S-1122(7.118.0,core 7.44.0 #1362):同一臂在 follow-up 车道(`later` 档)上的那一族。7.110.0–7.117.x 的这类丢失报在 steer 一族里。 */
+    /** [ref](7.118.0,core 7.44.0 [ref]):同一臂在 follow-up 车道(`later` 档)上的那一族。7.110.0–7.117.x 的这类丢失报在 steer 一族里。 */
     readonly userFollowupUndrainedServerCause: {
         readonly at: "engine_notice task.user_followup_undrained detail.cause(本服务铸的臂;`later` 档受理的崩溃丢失,下一条同会话 run 开通告口那一拍)";
         readonly members: {
@@ -47,7 +47,7 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * S-961(7.111.0):`wiring_manifest.instructions.selected[]` 的成员值 = 指令文件链的成员(相对 cwd 的拼写)。属主是 `project-memory.ts`
+     * [ref](7.111.0):`wiring_manifest.instructions.selected[]` 的成员值 = 指令文件链的成员(相对 cwd 的拼写)。属主是 `project-memory.ts`
      * 的 `INSTRUCTION_FILE_CHAIN`([ref] 序:CLAUDE 族先、AGENTS 族后,首中即选)—— 链加 / 删一员 ⇒ 本行 `satisfies` 编译红,登记跟着动。
      * 段本身(键)登记在 `wire-projection-faces.ts` 的 `wiring_manifest_tenant.minted`。
      */
@@ -73,7 +73,7 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * S-947(7.112.0):server 发起的中止在取消终局上留下的机读成因 —— `PersistedTaskResult.abortCause`,与 `cancelContext` 同住、同铸点、
+     * [ref](7.112.0):server 发起的中止在取消终局上留下的机读成因 —— `PersistedTaskResult.abortCause`,与 `cancelContext` 同住、同铸点、
      * 同在场闸(在场 ⇔ 这条终局就是 server 那次中止铸出来的取消终局)。逐词站点见契约 §5.0d。键本身是 run 结果上的 server 侧记键
      * (`store-contracts.ts` 的 `PersistedResultSideKeys`),不是事件投影面的键 ⇒ 不在 `wire-projection-faces.ts`。
      */
@@ -95,7 +95,7 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * 会话所有者自助抹除面的**已分类拒** → HTTP 状态(S-930 起与 operator 面 `POST /v1/memory/erase` 同一只映射;`since` 记的是**本面**
+     * 会话所有者自助抹除面的**已分类拒** → HTTP 状态([ref] 起与 operator 面 `POST /v1/memory/erase` 同一只映射;`since` 记的是**本面**
      * 自哪一版起这样答 —— 7.107.0 及以前本面只认前两只,其余落 500 `internal.error`)。
      */
     readonly sessionMemoryEraseStatus: {
@@ -492,7 +492,7 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * S-667(7.133.0):`GET /health` 的 `centerIdentityNotice.code` —— 中心凭证换人后的两态通告(最近一条)。词表属主 = `center-config-tier.ts` 的
+     * [ref](7.133.0):`GET /health` 的 `centerIdentityNotice.code` —— 中心凭证换人后的两态通告(最近一条)。词表属主 = `center-config-tier.ts` 的
      * `CENTER_IDENTITY_NOTICE_CODES`(`satisfies Record<…>`:加词而本行没跟 / 多一个词 ⇒ tsc 红);冻结句 `CENTER_IDENTITY_NOTICE_MESSAGE` 进
      * `test/api-notice-text-freeze.test.ts` §8。这两只码不在 core 的 `EngineNotice` 码册里(那是 core 的闭集)—— 它们是本服务自铸的 `/health` 值,契约 §0.4 成文。
      */
@@ -509,7 +509,7 @@ export declare const SELF_MINTED_WIRE: {
             };
         };
     };
-    /** S-667(7.133.0):`demoted` 通告上的 `retained[]` —— 降档没能降到底的组(世代账组闭集;`satisfies Record<ConfigApplyGroup, …>`)。 */
+    /** [ref](7.133.0):`demoted` 通告上的 `retained[]` —— 降档没能降到底的组(世代账组闭集;`satisfies Record<ConfigApplyGroup, …>`)。 */
     readonly centerIdentityNoticeRetained: {
         readonly at: "GET /health centerIdentityNotice.retained[]";
         readonly members: {
@@ -623,6 +623,10 @@ export declare const SELF_MINTED_WIRE: {
                 attr: string;
                 since: string;
             };
+            approval_feedback: {
+                attr: string;
+                since: string;
+            };
         };
     };
     /**
@@ -753,9 +757,25 @@ export declare const SELF_MINTED_WIRE: {
         };
     };
     /**
-     * S-527(7.133.0):`GET /v1/config/catalog` 行上**对 `effectiveValue` 的判词位**(闭集 `CatalogValueVerdict`,属主 `config-catalog.ts`;行接口经映射型声明,
+     * [ref](7.135.0):场景卡技能清单一条的来处(`factory` = 本部署技能目录 · `center` = 配置源交来的)。钉 test/scenario-skills-read-face.test.ts ②。
+     */
+    readonly scenarioSkillSource: {
+        readonly at: "GET /v1/capabilities/scenarios/:name#skills[].source";
+        readonly members: {
+            factory: {
+                attr: string;
+                since: string;
+            };
+            center: {
+                attr: string;
+                since: string;
+            };
+        };
+    };
+    /**
+     * [ref](7.133.0):`GET /v1/config/catalog` 行上**对 `effectiveValue` 的判词位**(闭集 `CatalogValueVerdict`,属主 `config-catalog.ts`;行接口经映射型声明,
      * 每一位只取 `true`)。属性 = 在场律 `present-iff`:只在为真时出键,恒不铸 `false`,缺席 = 没有这件事(老 server 上也缺席 —— 对消费方两者的下一步相同:按值原样渲染)。
-     * `satisfies Record<CatalogValueVerdict, …>`:判词位加一员而本表没跟 ⇒ 编译红。`effectiveValueInvalid` 自 7.70.0(S-100)在 wire 上、本版补登记;
+     * `satisfies Record<CatalogValueVerdict, …>`:判词位加一员而本表没跟 ⇒ 编译红。`effectiveValueInvalid` 自 7.70.0([ref])在 wire 上、本版补登记;
      * `effectiveValueWithheld`(url 型行:展示铸点扣下了一段)本版新上。
      */
     readonly configCatalogValueVerdict: {
@@ -774,8 +794,9 @@ export declare const SELF_MINTED_WIRE: {
     /**
      * `GET /v1/models` 应答体的顶层键(闭集;`src/http/routes/capabilities.ts` 的 `sendJson(res, 200, {…})` 字面量)。属性 = 在场律:`always` 恒在场(零条也出键),`present-iff` 条件成立才出键
      * (缺席不下「无」的结论——也可能是更早的 server)。`since` = 该键上 wire 的起始版本(`models` / `default` / `defaultModel` 在本仓首个 tag 就有)。
-     * 7.126.0:`candidateRejected`(S-1457,present-iff:当前生效的配置是因判官整拒了最近一份候选而回落的那一份;契约 §A.1d)。
-     * 7.133.0:`modelPlane`(S-1716,always:服务哪张表 / 最近一份目录候选的结局 / 起服路由判官的判决;契约 §A.1d)。
+     * 7.126.0:`candidateRejected`([ref],present-iff:当前生效的配置是因判官整拒了最近一份候选而回落的那一份;契约 §A.1d)。
+     * 7.133.0:`modelPlane`([ref],always:服务哪张表 / 最近一份目录候选的结局 / 起服路由判官的判决;契约 §A.1d)。
+     * 7.135.0:`aliases`([ref],always:选择面认、`models` 行不列的词 —— 受理口那一张可选目录的划分;契约 §A.1d)。
      */
     readonly modelsResponseKey: {
         readonly at: "GET /v1/models 应答体顶层键(<键> → 在场律)";
@@ -804,18 +825,22 @@ export declare const SELF_MINTED_WIRE: {
                 readonly attr: "always";
                 readonly since: "7.133.0";
             };
+            readonly aliases: {
+                readonly attr: "always";
+                readonly since: "7.135.0";
+            };
         };
     };
     /** 本仓在出口对 core 值做的变换(值变、键不变)。 */
     readonly wireValueRule: {
         readonly at: "出口值变换(<端点>#<键> → 变换)";
         readonly members: {
-            /** S-105(7.57.0):run 读面的终态错误文案脱敏(钉 test/run-failure-visibility.test.ts)。 */
+            /** [ref](7.57.0):run 读面的终态错误文案脱敏(钉 test/run-failure-visibility.test.ts)。 */
             readonly "GET /v1/runs/:id#result.errorMessage": {
                 readonly attr: "redactErrorMessage";
                 readonly since: "7.57.0";
             };
-            /** S-922(7.108.0):side-query 200 体 `errorMessage` 与任务面同一只脱敏口(钉 test/side-query-provider-echo.test.ts)。 */
+            /** [ref](7.108.0):side-query 200 体 `errorMessage` 与任务面同一只脱敏口(钉 test/side-query-provider-echo.test.ts)。 */
             readonly "POST /v1/side-query#errorMessage": {
                 readonly attr: "redactErrorMessage";
                 readonly since: "7.108.0";

package/dist/trace/self-minted-wire.js

@@ -210,6 +210,7 @@ export const SELF_MINTED_WIRE = {
             plan_mode_after: { attr: "-", since: "7.133.0" },
             bound_call_door: { attr: "-", since: "7.133.0" },
             remember_decision: { attr: "-", since: "7.133.0" },
+            approval_feedback: { attr: "-", since: "7.134.0" },
         },
     },
     limitRefusalReason: {
@@ -260,6 +261,13 @@ export const SELF_MINTED_WIRE = {
             repo: { attr: "-", since: "1.214.2" },
         },
     },
+    scenarioSkillSource: {
+        at: "GET /v1/capabilities/scenarios/:name#skills[].source",
+        members: {
+            factory: { attr: "-", since: "7.135.0" },
+            center: { attr: "-", since: "7.135.0" },
+        },
+    },
     configCatalogValueVerdict: {
         at: "GET /v1/config/catalog rows[] 的判词位(<键> → 在场律)",
         members: {
@@ -276,6 +284,7 @@ export const SELF_MINTED_WIRE = {
             droppedEntries: { attr: "always", since: "7.123.0" },
             candidateRejected: { attr: "present-iff", since: "7.126.0" },
             modelPlane: { attr: "always", since: "7.133.0" },
+            aliases: { attr: "always", since: "7.135.0" },
         },
     },
     wireValueRule: {

package/dist/trace/sema-provenance.d.ts

@@ -26,7 +26,7 @@ export declare const SEMA_PROVENANCE_KINDS: readonly ["agent_message"];
  *    (core-keyset-guard.ts ① 的同名排除键)一同候 [ref] 表态。放进 EXCLUDED 而不是 PROJECTED,是**沿用**上一行的
  *    裁定而不是新增特判:表态未出前放行一个 lane 词,等于替它预先声明一种 cli 渲染形。表态落定那天三处(本簿、
  *    载体键、①-nested 的 `peerMeta`)同批翻。
- *  · `inbox_notice` —— core 7.30.0 #1036(S-616 提货;本闭集当拍真红出它)。**同一条车道的第三个载体**(收件箱通告,
+ *  · `inbox_notice` —— core 7.30.0 [ref]([ref] 提货;本闭集当拍真红出它)。**同一条车道的第三个载体**(收件箱通告,
  *    `crossSessionMessage` / `crossSessionNotice` 之后),同一个 session-box drain 铸;载体键 `inboxNotice` 在
  *    core-keyset-guard.ts ① 同批进 EXCLUDED。沿用上两行的裁定,不是新判据:[ref] 表态落定那天四处同批翻。
  */

package/dist/trace/task-notification-facets.d.ts

@@ -1,13 +1,13 @@
 /**
- * S-616(core 7.30.0 提货):`task_notification` 帧上 7.30.0 新到的五枚键的**单点**投影判据 —— live 三腿
+ * [ref](core 7.30.0 提货):`task_notification` 帧上 7.30.0 新到的五枚键的**单点**投影判据 —— live 三腿
  * (`trace/project.ts` 的 `taskNotificationEventData`)与 park 半场(`orchestration/workflow-completion-inbox.ts` 的
  * `taskNotificationInboxEntry`)共用,两腿字节同判(形照 `sema-provenance.ts` / `injection-tier.ts` 的先例:
  * park 腿的 drain 直接 spread extras 成帧、不再经 project.ts,判据必须在入库前做,而且只能有一份)。
  *
  * 五枚键分两组,判据各一只函数:
- *  · {@link terminalFrameFacetFields} —— 委派终态帧的三枚 facet([ref] S1 / #1034),core 在产生者一侧由
+ *  · {@link terminalFrameFacetFields} —— 委派终态帧的三枚 facet([ref] S1 / [ref]),core 在产生者一侧由
  *    `terminalFrameFacets` 统一铸:`spawnName` / `handback` / `compaction`;
- *  · {@link resupplyFields} —— 重供两键(#1036):`resupplied` / `attempt`。
+ *  · {@link resupplyFields} —— 重供两键([ref]):`resupplied` / `attempt`。
  * 全部是引擎铸的闭形值(身份键 / 闭集词 / 计数 / 布尔),零模型自由文本 ⇒ 不过 `redactSecrets`;判不过形 ⇒ 那一键
  * 缺席(不折默认、不编值)。同一只会话箱车道的**载体** `inboxNotice` 不在这里 —— 它在 EXCLUDED 簿
  * (`core-keyset-guard.ts` ①,理由逐字在那里)。
@@ -50,7 +50,7 @@ export declare function terminalFrameFacetFields(n: TaskNotificationFacetInput):
     compaction?: CompactionFacet;
 };
 /**
- * 重供两键(core 7.30.0 #1036;判据档 F1 原句点名「@server trace/inbox allowlist」)。一条会话箱记录的帧被压缩摘要掉之后,
+ * 重供两键(core 7.30.0 [ref];判据档 F1 原句点名「@server trace/inbox allowlist」)。一条会话箱记录的帧被压缩摘要掉之后,
  * 引擎把同一条记录再交一次 —— 同 `task_id` / `status` / `seq`,多这两枚键:
  *  · `resupplied` —— **只有真一形**(core 逐字「there is no `false` form」)⇒ 只放行 `true`,别的一律缺席;
  *  · `attempt` —— 这是第几次投递(缺席 = 1,「没有 0」)⇒ 只放行 ≥1 的整数,verbatim,不补默认。

package/dist/trace/wire-projection-faces.d.ts

@@ -1,5 +1,5 @@
 /**
- * S-545 —— **wire 帧投影面的登记表**([ref]「手抄投影全面下线,改由源头机器派生」在本仓第一处落点)。
+ * [ref] —— **wire 帧投影面的登记表**([ref]「手抄投影全面下线,改由源头机器派生」在本仓第一处落点)。
  *
  * ## 这张表是什么(以及它**不是**什么)
  * 每一行登记一只把 core 帧投到 wire 的构造器,只写三样**人必须裁定**的东西:
@@ -21,7 +21,7 @@
  * `NotificationExcluded` 直接读成本表这一行的 `excluded`,于是「哪几个键有意不上 wire」全仓**只有一个写者**。
  * 旧形是两个:守卫文件一簿、`test/wire-whitelist-exhaustiveness.test.ts` 的 `KnownExcluded` 一簿,那份门注
  * 自己写着「两处必须同时改」—— 而「必须同时改」正是 [ref] 要下线的东西(对账门不算替代,单写者才算)。
- * 本表是纯数据、无行为(唯一的派生是 `wiring_manifest_operator` 行的两只取值器:`excluded` = 租户行减具名常量,S-724;`minted` = 租户行,S-961),
+ * 本表是纯数据、无行为(唯一的派生是 `wiring_manifest_operator` 行的两只取值器:`excluded` = 租户行减具名常量,[ref];`minted` = 租户行,[ref]),
  * 被守卫文件以 `typeof import(...)` 的**类型查询**读取(编译期擦除,零运行期边);唯一的运行期读者是清单行的解释器
  * (`observability/prompt-manifest.ts`,读 `keys` 声明)与机器清单生成器(转译本文件、求值、只读数据)—— 两者都不改表。
  *
@@ -226,7 +226,7 @@ export declare const WIRE_PROJECTION_FACES: {
     readonly wiring_manifest_tenant: {
         readonly projector: "wiringManifestEventData";
         readonly coreType: `WiringManifest & ${string}`;
-        readonly excluded: readonly ["governance", "configFingerprint", "autoConsolidation", "readDeny", "peerPresence"];
+        readonly excluded: readonly ["governance", "configFingerprint", "autoConsolidation", "readDeny", "peerPresence", "advisor"];
         readonly unwrapped: readonly ["manifest"];
         readonly minted: readonly ["instructions"];
     };
@@ -268,6 +268,12 @@ export declare const WIRE_PROJECTION_FACES: {
         readonly excluded: readonly [];
         readonly minted: readonly [];
     };
+    readonly cross_boundary_taint: {
+        readonly projector: "crossBoundaryTaintEventData";
+        readonly coreType: "Extract<TraceEvent, { kind: \"permission.cross_boundary_taint\" }>";
+        readonly excluded: readonly ["kind", "version", "taskId", "ts"];
+        readonly minted: readonly [];
+    };
     readonly prompt_manifest: {
         readonly projector: "promptManifestRecordOf";
         readonly coreType: "Extract<TraceEvent, { kind: \"prompt.assembled\" }>";

package/dist/trace/wire-projection-faces.js

@@ -51,7 +51,7 @@ export const WIRE_PROJECTION_FACES = {
     wiring_manifest_tenant: {
         projector: "wiringManifestEventData",
         coreType: `WiringManifest & ${arm("wiring_manifest")}`,
-        excluded: ["governance", "configFingerprint", "autoConsolidation", "readDeny", "peerPresence"],
+        excluded: ["governance", "configFingerprint", "autoConsolidation", "readDeny", "peerPresence", "advisor"],
         unwrapped: ["manifest"],
         minted: ["instructions"],
     },
@@ -77,6 +77,12 @@ export const WIRE_PROJECTION_FACES = {
     },
     origin_clearance_origin: { projector: "buildClearanceRowWire", coreType: "MemoryEntryOrigin", excluded: [], minted: [] },
     origin_clearance_event: { projector: "buildClearanceRowWire", coreType: "OriginClearanceEvent", excluded: [], minted: [] },
+    cross_boundary_taint: {
+        projector: "crossBoundaryTaintEventData",
+        coreType: `Extract<TraceEvent, { kind: "permission.cross_boundary_taint" }>`,
+        excluded: ["kind", "version", "taskId", "ts"],
+        minted: [],
+    },
     prompt_manifest: {
         projector: "promptManifestRecordOf",
         coreType: MANIFEST_FRAME,

package/dist/unattended-permission-mode.d.ts

@@ -1,5 +1,5 @@
 /**
- * S-934 ①(S-906 / clay 裁 [ref];core 7.37.0 #1214,`docs/INTEGRATION-CORE.md` §4.6e)—— **无人值守腿:`default` 模式 + 按类作答的 onAsk**。
+ * [ref] ①([ref] / clay 裁 [ref];core 7.37.0 [ref],`docs/INTEGRATION-CORE.md` §4.6e)—— **无人值守腿:`default` 模式 + 按类作答的 onAsk**。
  *
  * ## 规则(一句)
  * 本仓**自己铸** spec、**没有调用方**能在请求上表态模式的腿 —— leader worker(`src/leader/wire.ts` provisionWorker 两车道)、leader 的
@@ -9,7 +9,7 @@
  * 它自建 spec 的出生点盖下的运维 `AUTONOMY=plan` 地板、续跑重建读到的存储体的 `plan` 都是天花板,本腿的 `default` 落在它下面就是 `plan`,
  * 不把它降回去)与 `onAsk` = {@link createUnattendedOnAsk}。
  * 那只 onAsk 读 `AskRequest.classes` **整体**:集非空且每一类都在 {@link UNATTENDED_ANSWERED_CLASSES}(= `{ordinary}`,常量,不是旋钮)⇒ 答 yes
- * —— **以策略的名义**(S-953 / core 7.39.0 #1265:`{allow:true, settledBy:"policy", approver:"unattended_class_answer"}` ⇒ core 结算 `policy_allowed` /
+ * —— **以策略的名义**([ref] / core 7.39.0 [ref]:`{allow:true, settledBy:"policy", approver:"unattended_class_answer"}` ⇒ core 结算 `policy_allowed` /
  * `who.party:"policy"`;修前是裸 `true`,core 把机器的放行记成**人**批 `human_allowed` / `person`);
  * 否则不答 —— 本腿**有席**(run-local 的 `createLocalApprover`:有 TTY 问人、无 TTY 当场拒;续跑腿的协调器席)⇒ 交给席;**无席** ⇒ 答
  * `"unavailable"` = 交回 core 的缺席路(本腿武装了 durable park ⇒ park,等人经 `/decide` 答;否则 headless 拒 —— fail-closed)。
@@ -35,7 +35,7 @@
  *
  * ## 退役(硬破坏,零别名 / 零双读 / 零过渡臂)
  * `UNATTENDED_PERMISSION_MODE` 旋钮(`config-catalog` 行 / `config` 解析 / `ServiceConfig.unattendedPermissionMode`)、`createUnattendedWriteProtectionPolicy`
- * (#1211 的 `pathDenyRules` 过渡形)、`createUnattendedLeg` 的模式 / Runner 座参数、写面钉 `writeFace: "roots"`(那一钉只为不拿 bypass 的开放写面;
+ * ([ref] 的 `pathDenyRules` 过渡形)、`createUnattendedLeg` 的模式 / Runner 座参数、写面钉 `writeFace: "roots"`(那一钉只为不拿 bypass 的开放写面;
  * `default` 模式行不给写面 ⇒ 引擎缺省 roots,与 7.105.0 同)、P-DEBT 臂 `server.unattended-leg.mode-releases-protective-asks`(FAIL-OPEN-CENSUS 第 101 行终态)。
  *
  * ## 射程外(成文)
@@ -52,7 +52,7 @@ import type { AskClass, AskRequest, OnAsk, PermissionMode, TaskSpec } from "@sem
  */
 export declare const UNATTENDED_ANSWERED_CLASSES: ReadonlySet<AskClass>;
 /**
- * S-953(core 7.39.0 #1265):按类作答层这只席的**名字** —— 本仓自己的闭词(core 只把它转录到结算记录的 `who.approver`,不认证、不回读;
+ * [ref](core 7.39.0 [ref]):按类作答层这只席的**名字** —— 本仓自己的闭词(core 只把它转录到结算记录的 `who.approver`,不认证、不回读;
  * `AskOutcome.approver` 契约逐字「a closed word the host owns, never a person」)。审计读者按它认出「这一次放行是无人值守腿按类答的」。
  */
 export declare const UNATTENDED_POLICY_APPROVER = "unattended_class_answer";
@@ -61,7 +61,7 @@ export type UnattendedSeat = Extract<OnAsk, (req: AskRequest, signal?: AbortSign
 /** 这一问是不是机器答得了的:读 `classes` **整体** —— 在场、非空、且每一类都在答集;缺席 / 空 / 任一类在答集外 ⇒ 否。 */
 export declare function unattendedAnswers(req: Pick<AskRequest, "classes">): boolean;
 /**
- * 按类作答的 onAsk(活对象 ⇒ `create*`)。答得了 ⇒ 策略的 yes(这一次调用的答,记在策略名下 —— S-953);答不了 ⇒ 有席交席(席的答原样返回,席自己的
+ * 按类作答的 onAsk(活对象 ⇒ `create*`)。答得了 ⇒ 策略的 yes(这一次调用的答,记在策略名下 —— [ref]);答不了 ⇒ 有席交席(席的答原样返回,席自己的
  * fail-closed 语义不动),无席 ⇒ `"unavailable"`(core G1:这一问此刻没有人够得着 ⇒ 改道 durable park;本腿没武装 park ⇒ headless 拒)。
  * 不答的臂**从不**自己拒成 `false`:那会把「交给 park 的人」折成「机器拒了」,durable 审批块的 leader worker 就再也 park 不下来。
  */

package/dist/url-credential.d.ts

@@ -0,0 +1,52 @@
+/** 拒因词(闭集;判序 = 本数组序)。wire 上即 `request.field_invalid` 拒体的 `reason`。 */
+export declare const URL_CREDENTIAL_REASONS: readonly ["url_userinfo", "url_credential_param"];
+export type UrlCredentialReason = (typeof URL_CREDENTIAL_REASONS)[number];
+/** 一处命中:`url_userinfo`,或 `url_credential_param` + 它在哪一段、表里的哪个词(小写;不是调用方的原字节)。 */
+export type UrlCredential = {
+    readonly reason: "url_userinfo";
+} | {
+    readonly reason: "url_credential_param";
+    readonly at: "query" | "fragment";
+    readonly name: string;
+};
+/**
+ * 判:这个值作为 URL 读出来(WHATWG),带不带 **userinfo**(判官的第一问,也是 {@link findUrlCredential} 的第一步)。只问这一件的座位 —— 运行时本就拒带 userinfo 的 URL、
+ * 而凭据名参数不由它拒的载体(搜索后端的部署 env 与续跑重放读法)—— 问这一只,不在座位里另写一份 userinfo 谓词。纯函数。
+ */
+export declare function findUrlUserinfo(raw: string): Extract<UrlCredential, {
+    readonly reason: "url_userinfo";
+}> | undefined;
+/**
+ * 判:这个值作为 URL 读出来(WHATWG),带不带凭据。首个命中;没有(含不透明 / 解析不了的值)⇒ `undefined`。纯函数。
+ */
+export declare function findUrlCredential(raw: string): UrlCredential | undefined;
+/** 一处命中的规则句(穷举;新拒因词不补 = 编译红)。只说规则与表词,不含值。 */
+export declare function urlCredentialRule(c: UrlCredential): string;
+/** 拒体上的机读位(加性键:直接当 `request.field_invalid` 的附加键用)。 */
+export type UrlCredentialFacts = {
+    readonly field: string;
+    readonly reason: UrlCredentialReason;
+};
+/** 机读位的唯一铸点:`field` 是座位给的体内全坐标,`reason` 是判官的拒因词(不另造)。 */
+export declare function urlCredentialFacts(field: string, credential: UrlCredential): UrlCredentialFacts;
+/**
+ * 出路句(停驻封签的位是请求头):凭据改写进这一条的 `headers`(停驻任务的续跑上下文里只以封签存在)。MCP `transport.headers` · A2A 对端 `headers` ·
+ * http 钩子条目 `headers` 三座同一句骨架,`place` 是那一条的 `headers` 在请求体里的坐标。
+ */
+export declare function urlCredentialHeaderExit(place: string): string;
+/**
+ * 原因句骨架(四座同一句,值不回显):规则句 + 「URL 原样存」的事实 + 出路。`exit` 是座位给的出路句(`urlCredentialHeaderExit` 或座位自己的)。
+ * 为什么说「原样存」:封签闭集刻意不收 URL 一类自由文本,所以 URL 照原样进停驻上下文、日志与读面 —— 凭据只许走为它设的座。
+ */
+export declare function urlCredentialRefusalReason(credential: UrlCredential, exit: string): string;
+/** 一处请求面拒的整句 + 机读位({@link buildRequestUrlCredentialRefusal} 的产物)。 */
+export interface UrlCredentialRefusal {
+    readonly message: string;
+    readonly facts: UrlCredentialFacts;
+}
+/**
+ * 请求面 URL 座位的拒(整句 + 机读位),`<field>[ (<subject>)] <原因句>`。`subject` 是座位给的条目指认(MCP 的 server 名 / A2A 的 peer 名;坐标本身唯一的座位不带)。
+ * MCP 座的整句要接它自己的条目键律尾句,所以 MCP 直接取 {@link urlCredentialRefusalReason} + {@link urlCredentialFacts},另三座走这一只。
+ */
+export declare function buildRequestUrlCredentialRefusal(field: string, credential: UrlCredential, exit: string, subject?: string): UrlCredentialRefusal;
+//# sourceMappingURL=url-credential.d.ts.map

package/dist/url-credential.js

@@ -0,0 +1,49 @@
+import { httpUrlFlaws, httpUrlRule, isHierarchicalUrl } from "@sema-agent/settings-schema";
+import { isCredentialParamName } from "./trace/redact.js";
+export const URL_CREDENTIAL_REASONS = ["url_userinfo", "url_credential_param"];
+function credentialParamIn(params) {
+    for (const name of new URLSearchParams(params).keys()) {
+        if (isCredentialParamName(name))
+            return name.replace(/[A-Z]/g, (c) => c.toLowerCase());
+    }
+    return undefined;
+}
+export function findUrlUserinfo(raw) {
+    return isHierarchicalUrl(raw) && httpUrlFlaws(raw, ["userinfo"]).includes("userinfo") ? { reason: "url_userinfo" } : undefined;
+}
+export function findUrlCredential(raw) {
+    if (!isHierarchicalUrl(raw))
+        return undefined;
+    const userinfo = findUrlUserinfo(raw);
+    if (userinfo !== undefined)
+        return userinfo;
+    const u = new URL(raw);
+    const inQuery = credentialParamIn(u.search);
+    if (inQuery !== undefined)
+        return { reason: "url_credential_param", at: "query", name: inQuery };
+    const inFragment = credentialParamIn(u.hash.slice(1));
+    if (inFragment !== undefined)
+        return { reason: "url_credential_param", at: "fragment", name: inFragment };
+    return undefined;
+}
+export function urlCredentialRule(c) {
+    switch (c.reason) {
+        case "url_userinfo":
+            return httpUrlRule("userinfo");
+        case "url_credential_param":
+            return `must not carry a credential parameter (the ${c.at} names "${c.name}", a name the service's log redactor treats as a credential)`;
+    }
+}
+export function urlCredentialFacts(field, credential) {
+    return { field, reason: credential.reason };
+}
+export function urlCredentialHeaderExit(place) {
+    return `${place} is stored sealed: send the credential as a header in ${place} (for example "Authorization": "Bearer …")`;
+}
+export function urlCredentialRefusalReason(credential, exit) {
+    return `${urlCredentialRule(credential)} — the URL is kept as written (a parked task's resume context, logs), while ${exit}`;
+}
+export function buildRequestUrlCredentialRefusal(field, credential, exit, subject) {
+    return { message: `${field}${subject === undefined ? "" : ` (${subject})`} ${urlCredentialRefusalReason(credential, exit)}`, facts: urlCredentialFacts(field, credential) };
+}
+//# sourceMappingURL=url-credential.js.map

package/dist/url-refusal.d.ts

@@ -1,5 +1,5 @@
 /**
- * **「交给 `fetch` 的 http(s) URL」的拒句铸点**(S-1269 的展示半场)。判官本身 —— 这个值是不是层级式 http(s) URL、座位禁的部件
+ * **「交给 `fetch` 的 http(s) URL」的拒句铸点**([ref] 的展示半场)。判官本身 —— 这个值是不是层级式 http(s) URL、座位禁的部件
  * (userinfo / query / fragment)在不在、每个拒因词的规则句 —— 是 settings-schema 的 URL 形判官(`httpUrlFlaws` / `httpUrlRule` /
  * `HTTP_URL_SHAPE_RULE` / `isHierarchicalUrl`,11.0.0 由本仓的那一只 lift 过去、规则与拒因词闭集逐字搬);本仓**零第二份**形规则,
  * 只留本仓自己的展示律:拒句里值的样子({@link buildRefusalShownUrl})与拒句的唯一铸点({@link buildHttpUrlRefusal})。
@@ -14,9 +14,11 @@
  * ## 读者
  * 中心基址三席 + 公告地址 + 请求期 `centerFetch`(`web-admin-client/center-request.ts` `pathBaseUrlRefusal`:禁 userinfo / query / fragment)·
  * 续签 issuer(只问形)· 模型路由三键(`model-route-url.ts`:禁 userinfo / fragment,query 照收)· `MEMORY_EMBEDDER_ENDPOINT` 与
- * `A2A_SERVE_URL`(禁 userinfo)。「scheme 只有判官与展示铸点读」由 `test/config-url-display-safe.test.ts` 的读者普查门钉住。
+ * `A2A_SERVE_URL`(禁 userinfo)· `SANDBOX_PKG_SOURCE=custom` 六只地址(形 + 带凭据,后者的判官是 `url-credential.ts`,拒句经 {@link buildUrlCredentialRefusal})。
+ * 「scheme 只有判官与展示铸点读」由 `test/config-url-display-safe.test.ts` 的读者普查门钉住。
  */
 import { type HttpUrlFlaw } from "@sema-agent/settings-schema";
+import { type UrlCredential } from "./url-credential.js";
 /**
  * 拒句里值的样子(纯函数):合格的 http(s) 形 ⇒ 只到 origin(`scheme://host[:port]`,过展示铸点),origin 之后还有东西(userinfo /
  * 路径 / query / fragment)⇒ 接一枚 `/…`;其余(不透明 / 不可解析 / 层级式非 http(s))⇒ 展示铸点的占位 `«redacted:url»` ——
@@ -32,4 +34,6 @@ export declare function buildRefusalShownUrl(raw: string): string;
  * 值只经 {@link buildRefusalShownUrl} 出现;`flaws` 来自 settings-schema 的 `httpUrlFlaws`(调用方按首个拒因选自己的码与出路句)。
  */
 export declare function buildHttpUrlRefusal(subject: string, raw: string, flaws: readonly HttpUrlFlaw[]): string;
+/** 「带凭据」那一形的拒句([ref];判官 `url-credential.ts` 的 `findUrlCredential`):同一只铸点形,规则句换成凭据判官的那一句。 */
+export declare function buildUrlCredentialRefusal(subject: string, raw: string, credential: UrlCredential): string;
 //# sourceMappingURL=url-refusal.d.ts.map

package/dist/url-refusal.js

@@ -1,5 +1,6 @@
 import { httpUrlRule, isHierarchicalUrl } from "@sema-agent/settings-schema";
 import { DISPLAY_SAFE_URL_TOKEN, buildDisplaySafeUrl } from "./trace/redact.js";
+import { urlCredentialRule } from "./url-credential.js";
 export function buildRefusalShownUrl(raw) {
     if (!isHierarchicalUrl(raw))
         return DISPLAY_SAFE_URL_TOKEN;
@@ -12,6 +13,12 @@ export function buildRefusalShownUrl(raw) {
     return `${buildDisplaySafeUrl(origin)}${u.href === `${origin}/` ? "" : "/…"}`;
 }
 export function buildHttpUrlRefusal(subject, raw, flaws) {
-    return `${subject} ${flaws.map(httpUrlRule).join("; ")}; got ${JSON.stringify(buildRefusalShownUrl(raw))}`;
+    return composeUrlRefusal(subject, raw, flaws.map(httpUrlRule));
+}
+export function buildUrlCredentialRefusal(subject, raw, credential) {
+    return composeUrlRefusal(subject, raw, [urlCredentialRule(credential)]);
+}
+function composeUrlRefusal(subject, raw, rules) {
+    return `${subject} ${rules.join("; ")}; got ${JSON.stringify(buildRefusalShownUrl(raw))}`;
 }
 //# sourceMappingURL=url-refusal.js.map

package/dist/usage-analytics.d.ts

@@ -75,7 +75,7 @@ export type UsageGranularity = "hour" | "day";
 /**
  * GET /v1/usage/series — 时间序列(UTC 桶;空桶不发行,消费方按需补零)。
  *
- * 🔴 **行带 `estimated`**(S-228):与 {@link usageSummary} / {@link usageBreakdown} **同轴同谓词** ——
+ * 🔴 **行带 `estimated`**([ref]):与 {@link usageSummary} / {@link usageBreakdown} **同轴同谓词** ——
  * 三个读面的桶都是同一只 {@link UsageTotals},由同一条 {@link foldRow} 折出来,所以「这个数字不精确」
  * 的四个来源(旧行 fallback / per-model echo 缺键 / 缺 `usageBasis` 的 legacy 口径 / 行自陈
  * `usageMissing` 的下界)在三面上是**同一句话**。修前只有 series 的出口把这一位扔了:桶里塞进一条
@@ -96,7 +96,7 @@ export declare function usageBreakdown(rows: UsageRow[], dimension: UsageDimensi
 /**
  * store 行投影 helper:**已解码的** result 体 → UsageRow.stats。三个后端复用(方言只在 SQL)。
  *
- * 🔴 **本函数不解码**(S-550 车③b 删掉了它的 `typeof result === "string" ? JSON.parse(result) : result`
+ * 🔴 **本函数不解码**([ref] 车③b 删掉了它的 `typeof result === "string" ? JSON.parse(result) : result`
  * 那一跳):那正是设计稿点名的歧义臂 ——「体是串就再解一次」在一列真 `JSON`/`JSONB` 上等于**解第二次**,
  * 于是一个双重编码的 `task_run.result`(解一次得到的是串)会被解回好体、当成真的用量端出去。三个调用点
  * 逐行亲核过,今天**一处都不递串**: