@sema-agent/sdk 16.0.0 → 16.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +45 -0
  2. package/dist/resources/sessions.d.ts +10 -2
  3. package/dist/resources/sessions.d.ts.map +1 -1
  4. package/dist/resources/sessions.js +10 -2
  5. package/dist/resources/sessions.js.map +1 -1
  6. package/dist/settings.d.ts +15 -4
  7. package/dist/settings.d.ts.map +1 -1
  8. package/openapi.yaml +35 -2
  9. package/package.json +2 -2
package/README.md CHANGED
@@ -109,6 +109,51 @@ The registry's 409 carries two opposite meanings, split by one reader (`classify
109
109
  `ScopeGoneError` on the registry subpath — the target scope was deleted or re-created under the same name, nothing was
110
110
  written, **never** retry it as a conflict).
111
111
 
112
+ ## 16.0.1 — patch(2026-10-04;对表 server **7.114.0**〔shasum `98113acc27e3db3dec8cbf66adf212460d8b9ad8`,tag `e89bb2d4`,随装 core 7.39.2 + settings-schema 7.0.1〕;K-48 锁步 + K-45 + K-47;车SD156)—— 公开类型面零变化、spec 无 schema 成员变化(补两口 500 响应臂与描述句);**server 支持底线 `3.0.0` 不变**
113
+
114
+ **版本判法(写明依据)**:`docs/RELEASE.md` 第 12–14 行 ——「**patch** = 纯修复/文档/注释,公开类型面零变化;**minor** = 新面;**major** = 任何 BREAKING」。本版:① TS 公开型面**零变化**(`settings.ts` / `resources/sessions.ts` 只改注);② spec **没有任何 schema 加员 / 删改**(属性、enum 词、新 schema 一个没有),改的是:两口 operation 补登**既存**的 500 响应臂(体引既有 `ErrorResponse`)· 一口 422 臂的描述点名**既存**的码 —— 都是对 server 既有行为的登记;`spec-shipped-lockstep-gate` 要求「spec 字节变了就得 bump」⇒ 至少 patch ⇒ **16.0.1**(先例:9.8.1 spec-only patch、15.0.1)。K-47 新门在当前树上**零不相等**,没有逼出任何型 / spec 改动,所以没有别的东西把版号推高。⚠️ 候裁:若把「新增 response 臂」算 spec 加员(minor),则本车应为 16.1.0 —— 改法只是版本三处,无他。
115
+
116
+ **一句话:server 7.114.0 的 `wire-changes` 机器清单是 0 / 0 / 0 / 0(生成器读不到请求体键 / 值变更 / 受理面判据),四条用户可见变化本车对发布字节逐件重核 —— 与 sdk 有关的是三处文档面(matcher 型注两句旧说法已被判据变宽取代、坏会话规则文件的 500 `corrupt` 两口没登记、同步口 422 臂没点 `rewind_snapshot.unresolvable`),其余零动作;同车收 K-45(锁步钉的判据工具收一只)与 K-47(字面量联合 ≡ 同名 spec enum 的集合相等门,当前树零不相等)。**
117
+
118
+ ### 逐件(7.114.0 的四条 → 本包 → 三问;每件红先 → 绿,读数见各提交)
119
+
120
+ - **① `settings.hooks` 工具事件 matcher(S-995)**:*改了*:受理面 400 `request.field_invalid` 的拒放集合变宽(码不变、体形不变)、运行期读法变宽(空白 / 逗号容忍,CC 2.1.280 同形)。*本包*:`SettingsHookMatcher.matcher` 型注原来写的是 7.112.0 的读法(「纯名字交替」才拒、「正则形不判」放行)—— 两句都已不成立,按发布字节改准:**选中别名而选不中正名 ⇒ 400**(正则 / 空白 / 逗号 / 含空段形同拒)· 放行集 · 不问作者本意(顺带选中别名的正则也拒,出路写进注)· 两条车道两档(单用户真求值 / 多租户只判字面、不执行调用方正则)· 未判(超 8 192 / 预算 / 编不过)照旧受理 · resume 不判 · 运行期 `[|,]` 拆 / 逐段 trim / 区分大小写 / 词内空白不剥 / 别的字符整体锚定正则。spec 里没有 matcher 读法(零命中),不动。钉 `server-7114-wire` H1–H5:**真 `deadToolMatcherIssue` × 语料**(两档 × 三工具事件 × 8 192 边界 × 错误句只回显目录名)· 多租户档 0 次 `new RegExp`(计数桩,regex 档正控)· **真 `hookMatcherMatches` / `matcherLiteralNames` × 语料** · AST:运行期没有第二只读法(`hookMatcherMatches` 恰三处调用点)· 型注点名 + 两句旧说法不在。*谁需要*:按别名写 matcher 的调用方(400 的句子即改法)与读本注判「我的 matcher 会不会触发」的壳;*谁受伤*:以前因空白永不触发的钩子升级后会触发(作者本意;注里写明);*补偿*:无需旋钮。
121
+ - **② local 车道坏会话规则文件(core 7.39.2 #1299)**:*改了*:规则文件**在但坏** ⇒ 按键读(`GET` / `PUT /v1/sessions/:id/policy` 的读)拒 500 `corrupt`(此前按「无规则」,SQL 店本就拒);文件不存在照旧 = 无规则。*本包*:码与重试臂早就认(`NON_RETRYABLE_CODES`,K-24;裸 `APIError`)—— **spec 这两口没登记 500 臂(既存缺口,本版补)**:`GET` / `PUT` 各 +`'500'`(体引 `ErrorResponse`,描述点名在但坏 ⇒ 拒而不读成无规则 / 确定性不自动重试 / 句子无盘上路径 / 缺席不是这一臂 / PUT 不覆盖坏文件);`getPolicy` / `putPolicy` 型注同步。🚧 **如实披露一处例外**:写路径上**高水位侧车**(`.hwm.json`)读不出也是同一个 500 `corrupt`,但那一句 server 7.114.0 **仍带盘上路径**(core #1307 / #1309 候 core 7.41.0 收口;server CHANGELOG 7.114.0「未随本版」点名)—— 注与 spec 都写了,表征钉 `server-7114-wire` C1d 在收口后翻。钉 C1–C4:**真 `FileSessionPolicyStore`(core 7.39.2)× 真 `handleSessions`**(缺席 / 好行 / 三种坏形 × GET·PUT / 删文件后 / 侧车坏;PUT 前后坏文件字节逐字不变;句子无 root 路径;体对 `ErrorResponse` 与 spec 内联 200 schema 合规)· 真字节过真 verb ⇒ 裸 `APIError`、恰一次。
122
+ - **③ 被拒的 `resumeAt`(core 7.39.2 #1298)**:*改了*:被拒的 `resumeAt` 请求不再挪会话叶(7.113.x 及以前挪;核心自陈,**本车未在引擎里复现,不写进 spec**)。同步口 `422 rewind_snapshot.unresolvable` 是既有码。*本包*:叶位置不在任何 sdk 面上 ⇒ 型零动作;**spec 同步口 `POST /v1/tasks` 的 422 臂与操作首段的分诊码表没点这个码(既存缺口)** ⇒ 各补一处(点名码、零工作闸、做过工作则 200 + failed 体)。钉 R1–R2:真 `resumeAtHttpStatus` / `syncRefusalHttpStatus`(422 · 零工作闸 · 唯一调用点 = 同步口)· spec 两处点名。
123
+ - **④ 契约 hooks 事件集 / 车道词表改读 settings-schema 正本(wire 不变)**:sdk **没有** hooks 事件集镜像(`SettingsHooks` = 三成员 + 开集索引;spec 的 `settings` 开集)⇒ 零动作,H5 保持格钉住「StopFailure / PreCompact 条目 + 带空白 matcher 仍合规」;车道词 spec / 型 / server 三方相等(L1:server 真 `ALL_EXECUTION_LANES` 八词 == spec `Capabilities.executionLane.provider.enum` == 型的字面量词〔编译器读成员位〕,`remote-docker` 三处皆无)⇒ 零动作。拒启文案改形、`config.d/remote-exec.json` 写 `remote-docker` 拒启、`lanes.json` 生成物、`MEMORY_ENGINE_BACKEND` 句形 —— server 部署面,本包零读点。
124
+ - **同车随带(门读数逼出,非发车帖项)**:`@sema-agent/settings-schema` 同源锚 devDep `^6.4.0` → **`^7.0.1`**(`registry-auth` S-472 地板门:锚的 major.minor 不得落后于钉版 server 依赖的 7.0;锚的消费方 `registry-auth` / `registry-scopes-effective` / `control-resources` / `core-514-pickup` / `server-7104-wire` 对新物全绿)· `server-7106-wire` T1 / T4 的读点随真读法改(server 7.114.0 不再自持 `DB_BACKEND_WORDS` / `EXECUTION_LANE_WORDS`,改读 settings-schema `STORE_BACKENDS` / `EXECUTION_LANE_WORDS` 正本;词表内容与 sdk 型 / spec 逐词同,不是回归)。
125
+ - **K-45 判据工具收一只**:`test/_spec-pin.ts`(spec 判据 · server 发布字节腿 · 真 handler 壳三段)取代 `server-7111` / `7112` / `7113` 各抄的一套,新 7114 不抄第四遍。**行为零变化**:抽前 / 抽后同一棵树 21 / 19 / 46(45 过 1 跳)逐份同、格标题逐条同。
126
+ - **K-47 字面量联合 ≡ 同名 spec enum 门**(`test/spec-literal-union-gate.test.ts` + `_literal-union-surface.ts`):TS 一侧用 `TypeChecker` 读顶层别名的声明类型(`(typeof W)[number]` / `Exclude<…>` / 别名套别名都读得出,不手抄名单);规则:同名 spec 是字符串 `enum` ⇒ spec 一侧必须是纯字符串词表(`type` 收字符串、enum 不混别的成员;`null` 仅在可空 `type` 下放行 —— codex r1 [medium] 后补)且 TS 必须是闭集字面量联合、词集合**相等**(被拓宽 / 换形 / 带开集尾都红);spec 无 enum 而 TS 是联合 ⇒ 必须在**开集登记表**逐条写理由(四条:`Scenario` / `RoutePairingStatus` / `WorkflowRunStatus` / `AskOrigin`;仓内此前没有这张表,本门新立;登记项 spec 一侧须是裸 `type: string`,陈旧登记会红);同名多处声明红;非空转地板。范围 `src/**`(任务书写 `types.ts`;`resources/` 的 22 对同一条规则按类并入,`types.ts` 占 9 对)。红先:15.4.0 的 `RunStatus` 形(真 TS 六词 × 真 spec 删 `blocked`)⇒ 恰一条红;**一次性整树读数**:对 15.4.0 提交 `8ce1faa` 的 `src/` + spec 跑同一只判据 ⇒ 恰一条 `RunStatus`(TS 有 `blocked`、spec 没有)。**当前树抓到的不相等:零**(31 对全等、4 条开集全登记)。范围边界如实写在门文件头注:按名配对,成员位上的内联联合(`BakeRecordView.state` ↔ `BakeState` 一类)不在本门,一次性核过那三处相等,未入门。
127
+ - **校准**:`CALIBRATED_SERVER_HEAD` 7.113.0 → **7.114.0**;根 devDep `@sema-agent/server` 7.114.0(随装 core 7.39.2;lock sha512 `lrs3TuLv…` = registry `dist.integrity`,tarball sha1 `98113acc…` 对拍过)。门 6 对 16.0.0 基线首跑(clean env)**只红校准格一格**(`1 failed | 150 passed | 1 skipped`)—— 上述文档面三处契约套里没有任何一格抓得到,由 `server-7114-wire` 抓。
128
+
129
+ ### 读数
130
+
131
+ - 一律 clean env(`env -i PATH HOME AGENT_DATA_DIR=$(mktemp -d)`):根 typecheck rc=0;`npm run prepublishOnly`(build + typecheck + 默认全量 + prepack)rc=0 —— **116 文件 1865 过 · 2 跳过**(1 = A.1e 契约原文腿〔`SEMA_SERVER_SRC` 缺席响亮 SKIP〕;1 = `server-7104-wire` 既有的老 server 分臂)。带 server 树(`SEMA_SERVER_SRC` = v7.114.0 源)另跑:`server-7113-wire` **46/46 零跳过** · `server-7106-wire` 43/43 · `server-keyset-parity` 45/45 · `server-7114-wire` 21/21。`npm pack --dry-run`:`@sema-agent/sdk@16.0.1`,249 文件,含 `openapi.yaml` / `registry-openapi.yaml` / `LICENSE`;`npm ci --dry-run` 对改后的 lockfile 绿。
132
+ - 契约套 `node scripts/run-live-contract.mjs` 对 7.114.0 发布字节(匿名新装 fixture,tarball sha1 = registry `98113acc…`;根 devDep 目录作 fixture 亦同 —— 包自身文件 `diff -rq --exclude=node_modules` 零差):**`FENCE-VERDICT kind=in-range version=7.114.0`,10 文件 151 过 · 1 跳过 · 零红**(校准格绿;跳过 = `live/server-7109-faces` 老 server 分臂)。改前(16.0.0 基线 × 7.114.0 fixture)只红校准格一格(`1 failed | 150 passed | 1 skipped`)。
133
+ - 红先读数:`server-7114-wire`(基线 `ed9c4c0` 的型 / spec / 注 + devDep 7.114.0 已装)19 格 **13 过 · 6 红**(H4 / H4b / H4c matcher 型注 · C2 spec 500 臂 · C3 getPolicy/putPolicy 型注 · R2 spec 422 臂;另 13 格是发布字节事实钉 / 保持钉,基线上本就绿 —— 钉的是文档句必须对齐的事实);增补 C1d + C3 需点名侧车例外 ⇒ C3 再红;查漏 H2c;K-45 前后 21 / 19 / 46 逐份同。整套 `prepublishOnly` 在 feat 的注 / spec / 版本改完、而同源锚 / 7106 读点 / 门③ 尚未修时首跑 **4 红**(`engineering-gates` 门③ · `registry-auth` S-472 · `server-7106-wire` T1 / T4)—— 全是 7.114.0 提货面逼出的,同车收(见「同车随带」)。
134
+ - K-47 红先:fixture F1(15.4.0 `RunStatus` 形)恰一条红点名 `blocked`;**一次性整树读数**(`git archive 8ce1faa` 的 `src/` + spec 跑同一只判据):555 声明 / 30 对相等 / 4 条开集 / **恰 1 条违例 = `RunStatus`**。当前树:560 声明 / 67 个字面量联合 / 31 对相等 / 4 条开集全登记 / 0 违例。
135
+ - ⚠️ 环境:`_fence.ts` 的 spawn 仍继承宿主 env(16.0.0 候裁 ⑥ 未动),本版读数全在 `env -i` 下取。
136
+
137
+ ### 复审(codex `adversarial-review --model gpt-6.1-sol --base ed9c4c0 --scope branch`,一轮)
138
+
139
+ - verdict needs-attention,一条 [medium],**验真、采纳**:K-47 门的 `specEnumWords` 把 enum 里的非字符串成员静默滤掉、也从不看 schema 的 `type` —— TS `"x" | "y"` 对 `enum: ["x","y",42,null]` 与 `type: integer` + `enum: ["x","y"]` 都读成「相等对」零违例(codex 的原型复现;读码一致)。**红先**:F7(混 42 / `type: integer` / `null` 无可空 type / 可空串正控 / 开集登记项 spec type 非 string)修前 1 红;**修**:`specEnumReading` —— spec 一侧只在「type 收字符串且 enum 只含字符串词」时读词,`null` 仅当 type 数组含 `"null"` 才放行,其余形 ⇒ 违例(不再滤);开集登记项另要求 spec `type === "string"`。真树 G1 仍零违例(只有 `BakeState` / `BakeErrorCode` 两个带 null 的 enum,无同名 TS 联合,不在门内)。codex 同时自陈「公开型与 schema 成员保持不变」,与本版判 patch 一致。未再跑第二轮(任务书一轮)。codex 的 broker 簇按 PID 清(cwd = sema-sdk 那一簇 3 个进程,其余会话的 broker 未动)。
140
+
141
+ ### 去幻觉轮 / 查漏轮(C-R24 两道,本车自查;异源复核 = 上面 codex 一轮)
142
+
143
+ - **去幻觉(逐条回核坐标 / 断言,订正处)**:① 红先钉头注把 `http/routes/sessions.js` 的 policy 块写成 757–815,核发布字节是 731–815(错误映射 768 / 810)—— 订正。② 我首版 spec / 型注把「句子不带盘上路径」写成对这两口一律成立 —— 读 core `readSessionPolicyMark` 与真链实测推翻:**写路径高水位侧车读不出的那一句带盘上路径**,首版措辞是错的,改成按臂写(C1d 🚧);同一处我曾把「丢谱系」一并算进「带路径」,核 core 码那一臂的句子**不带**路径 —— 该臂我只读了码、没跑,所以从注里删掉而不是写成事实。③ 首版 H3b 的调用点次序按「运行期先」写,核文件序是 `if` 条件名部(262)→ 运行期(715)→ PreToolUse(864)—— 订正。④ 「与 CC 2.1.280 同形」「那正是作者本意」是 server 自陈 / 判断,本包只核了 server 一侧 —— 注里改写成归属。⑤ 「7.112.0 只拒字面形」「7.113.x 把坏行读成无规则」取自 server CHANGELOG / MIGRATION / core CHANGELOG,**未**对旧发布字节重核(本机只装了 7.114.0)—— 推断标记。
144
+ - **查漏(扫面 / 未闭环)**:扫出发车卡四条之外的三面,同车收:写路径侧车那一句(C1d)· 型注里「预算用尽 ⇒ 未判」首版没有格(H2c)· 门读数逼出的同源锚地板 / 7106 读点 / 门③。**扫了没发现**:`Capabilities` 键集 / 码册 / 通告白名单(门绿)· `wire-changes` 0/0/0/0 · settings-schema 7.0.0 删 `remote-docker` 词(sdk `src/` 与 spec 零 `remote-docker` 命中)· hooks 事件集(sdk 无镜像,开集索引)。**未闭环**见下节。
145
+
146
+ ### 未闭环 / 候裁
147
+
148
+ - ① **版号**:判 16.0.1(依据见段首)。若主会话把「新增 response 臂」算 spec 加员 ⇒ 16.1.0,改法只是版本三处(`packages/sdk/package.json` / lock 的 `packages/sdk` 条目 / README 段标题)。根 `package.json` 的 `version`(`2.3.0`)沿先例不动;`spec-shipped-lockstep-gate` 的 `SHIPPED` 发版后由主会话更新(本车不碰)。
149
+ - ② **K-47 范围**:任务书写 `types.ts`,本门按类并入 `src/**`(`resources/` 22 对,零违例)。若只要 `types.ts`,把 `scanTypeDecls` 的过滤收窄即可;但「同一条规则、同一张 spec」下按文件切是人为的。
150
+ - ③ **开集登记表是本门新立**:仓内此前没有「开集表」(grep 零命中;`x-open-enum` 只是 spec 侧意图标记且只两处挂着)。四条理由写在 `_literal-union-surface.ts`;`Scenario` / `WorkflowRunStatus` 的 spec 一侧没有 `x-open-enum` 标记(只有 prose)。
151
+ - ④ **同源锚版本**:devDep 抬到 `^7.0.1`(钉版 server 依赖线);registry 现头是 `8.0.0`(2026-10-03 发,当前没有任何钉版 server 依赖它)。是否抬到 8.x 由主会话与属主侧定(S-472 门只管「不落后于钉版 server」)。
152
+ - ⑤ 🚧 **高水位侧车那一句仍带盘上路径**(core #1307 / #1309 候 core 7.41.0):`server-7114-wire` C1d 是表征钉,收口后翻成 `not.toContain(root)`,同批删 `putPolicy` 注与 spec PUT 500 臂里的那句例外。
153
+ - ⑥ **被拒 `resumeAt` 不挪叶**:属 server 状态、不在 sdk 面;core 自陈,本车未在引擎里复现 ⇒ 没写进 spec。需要 sdk 对 UI 说「被拒后可原样重试」的话,先要一格引擎黑盒。
154
+ - ⑦ **既存的文档缺口,本车看到但未动**(不属 7.114.0 引入):spec `POST /v1/tasks` 422 描述写「`resume_at.*` also land here」,而 server 表里 `resume_at.not_found` 是 404;`resumeAtMode` 的 JSDoc / spec 把 `rewind_snapshot.unresolvable` 写成「配 `rewindFiles` 时」(退役拼法,现行触发是 `restoreFiles`;server 自己的 `wire-types.d.ts` 也还是这句);`SettingsHooks` 注里「v1 = 3 事件 / DEFERRED 生命周期事件」落后于 server 的 33 事件契约集(型是开集索引,不影响编译)。
155
+ - ⑧ **K-47 的范围边界**(门文件头注已写):按名配对 —— 成员位的内联联合(`BakeRecordView.state` / `status` / `errorCode` ↔ spec `BakeState` / `BakeStatus` / `BakeErrorCode`)不在门内;一次性核过三处相等,未入门,另票。
156
+
112
157
  ## 16.0.0 — BREAKING changes(2026-10-03;对表 server **7.113.0**〔shasum `0bc904dd474b89e5344632d499422fa5dee91bd1`,tag `cb479065`,随装 core 7.39.1〕;K-44 + K-43 + K-24 同名常量;车SD155;codex 一轮见下)—— 型面硬 breaking:删 `TaskRequest.attachments.planModeReminder`(请求面,server 7.113.0 起提交即 400);其余全 additive / 文档 / 封闭对象补键 / 枚举加词;**server 支持底线 `3.0.0` 不变**;版本按 `docs/RELEASE.md`「删字段 = major」
113
158
 
114
159
  **版本判法(写明依据)**:`docs/RELEASE.md` 第 14 行 ——「**major** = 任何 BREAKING:删/改名导出符号或字段、收窄类型、抬高 server 支持底线」。本版删了公开型 `TaskRequest.attachments` 的一个**成员**(`planModeReminder`),同批删 spec `TaskRequest.attachments.properties.planModeReminder` ⇒ **major ⇒ 16.0.0**(先例同判:14.0.0 删 `TaskRequest.approverPosture`、15.0.0 删两只能力位成员)。同车其余件(新型 / 新键 / 新常量 / 文档句 / 封闭对象补键 / 枚举加词)单看都只是 minor —— 整车仍是 16.0.0,**不是** 15.5.0。底线不抬:删键不抬支持底线(与 14.0.0 / 15.0.0 同口径),≤7.112.x 的 server 仍在支持区间内,只是本包不再替人铺它们那条 `planModeReminder` 路。
package/dist/resources/sessions.d.ts CHANGED
@@ -284,7 +284,11 @@ export declare class SessionsResource {
284
284
  * per-session tool-permission rules core reads at prepare-time (SUBTRACT-only). Owner-scoped (non-owner → 404);
285
285
  * ownerless session → 409; 501 without a session-policy store. Read-only snapshot — the renderer shows the
286
286
  * effective narrowing, never re-decides (enforcement is 100% core-side). Backs the shell's permissionMode panel
287
- * (MF-22). */
287
+ * (MF-22).
288
+ *
289
+ * 🔴 **500 `corrupt`**(server ≥7.114.0 / core 7.39.2 起本地文件店也如此;SQL 店的坏行本就同码):这位会话的规则**在但读不出**(撕尾 / 手改坏的规则文件)⇒ **拒,不当作「无规则」** ——
290
+ * 会话规则只收紧,把坏行读成空 = 静默丢掉收紧。落**裸 `APIError`**(`.errorCode === "corrupt"`,非任何子类);**确定性失败,本包不自动重试**(`transport.ts` `NON_RETRYABLE_CODES`);
291
+ * 句子带损坏等级(`unreadable` / `unparseable` / `malformed`)与「修好文件 / 删掉它(删 = 显式无规则)」两条出路,**不带盘上路径**。文件**不存在**照旧 = `{ rules: { rev: 0 } }`(那一臂不是上面这一格)。 */
288
292
  getPolicy(sessionId: string, opts?: {
289
293
  signal?: AbortSignal;
290
294
  }): Promise<{
@@ -295,7 +299,11 @@ export declare class SessionsResource {
295
299
  * `loosen_forbidden` (only an operator may loosen). Pass `expectedRev` for optimistic-concurrency (CAS) — a
296
300
  * stale rev → 409 `conflict` (typed ConflictError). Validation: each of the 5 rule fields must be `string[]` →
297
301
  * malformed body 400. ownerless session → 409; non-owner → 404. Not a submit (CAS, not retry-equivalent) →
298
- * no SDK retry. */
302
+ * no SDK retry.
303
+ *
304
+ * 🔴 **500 `corrupt`**(同 {@link getPolicy},server ≥7.114.0):写前那一读读到「在但坏」的规则行 ⇒ 拒,**不覆盖坏文件**(覆盖 = 丢证据;先修好或删掉再写);确定性失败,`PUT` 本就不重试。
305
+ * 同一个码也可来自写路径上的**高水位侧车**(`.hwm.json`)读不出 —— ⚠️ 那一句在 server 7.114.0 里**仍带盘上路径**(core 既有形;core #1307 / #1309 候 core 7.41.0 同口径收口;
306
+ * `server-7114-wire` C1d 🚧 表征钉,收口后翻成「不带路径」)。 */
299
307
  putPolicy(sessionId: string, body: {
300
308
  rules: SessionPermissionRules;
301
309
  expectedRev?: number;
package/dist/resources/sessions.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
package/dist/resources/sessions.js CHANGED
@@ -216,7 +216,11 @@ export class SessionsResource {
216
216
  * per-session tool-permission rules core reads at prepare-time (SUBTRACT-only). Owner-scoped (non-owner → 404);
217
217
  * ownerless session → 409; 501 without a session-policy store. Read-only snapshot — the renderer shows the
218
218
  * effective narrowing, never re-decides (enforcement is 100% core-side). Backs the shell's permissionMode panel
219
- * (MF-22). */
219
+ * (MF-22).
220
+ *
221
+ * 🔴 **500 `corrupt`**(server ≥7.114.0 / core 7.39.2 起本地文件店也如此;SQL 店的坏行本就同码):这位会话的规则**在但读不出**(撕尾 / 手改坏的规则文件)⇒ **拒,不当作「无规则」** ——
222
+ * 会话规则只收紧,把坏行读成空 = 静默丢掉收紧。落**裸 `APIError`**(`.errorCode === "corrupt"`,非任何子类);**确定性失败,本包不自动重试**(`transport.ts` `NON_RETRYABLE_CODES`);
223
+ * 句子带损坏等级(`unreadable` / `unparseable` / `malformed`)与「修好文件 / 删掉它(删 = 显式无规则)」两条出路,**不带盘上路径**。文件**不存在**照旧 = `{ rules: { rev: 0 } }`(那一臂不是上面这一格)。 */
220
224
  async getPolicy(sessionId, opts) {
221
225
  return this.t.request({
222
226
  method: "GET",
@@ -229,7 +233,11 @@ export class SessionsResource {
229
233
  * `loosen_forbidden` (only an operator may loosen). Pass `expectedRev` for optimistic-concurrency (CAS) — a
230
234
  * stale rev → 409 `conflict` (typed ConflictError). Validation: each of the 5 rule fields must be `string[]` →
231
235
  * malformed body 400. ownerless session → 409; non-owner → 404. Not a submit (CAS, not retry-equivalent) →
232
- * no SDK retry. */
236
+ * no SDK retry.
237
+ *
238
+ * 🔴 **500 `corrupt`**(同 {@link getPolicy},server ≥7.114.0):写前那一读读到「在但坏」的规则行 ⇒ 拒,**不覆盖坏文件**(覆盖 = 丢证据;先修好或删掉再写);确定性失败,`PUT` 本就不重试。
239
+ * 同一个码也可来自写路径上的**高水位侧车**(`.hwm.json`)读不出 —— ⚠️ 那一句在 server 7.114.0 里**仍带盘上路径**(core 既有形;core #1307 / #1309 候 core 7.41.0 同口径收口;
240
+ * `server-7114-wire` C1d 🚧 表征钉,收口后翻成「不带路径」)。 */
233
241
  async putPolicy(sessionId, body, opts) {
234
242
  return this.t.request({
235
243
  method: "PUT",
package/dist/resources/sessions.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAgCxD,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAsG/E,SAAS,eAAe,CAAC,MAAyB;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,sBAAsB,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,OAAO,gBAAgB;IAME;IAL7B;;0EAEsE;IAC7D,IAAI,CAAsB;IAEnC,YAA6B,CAAY;QAAZ,MAAC,GAAD,CAAC,CAAW;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;4HAQwH;IACxH,KAAK,CAAC,GAAG,CACP,SAAiB,EACjB,IAAkD;QAElD,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgB;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE;YAC7E,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;4HAMwH;IACxH,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA8C;QAC1E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/B,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO;YAC1D,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAK,CAAC,IAAK,EAAE,CAAC;QACrE,kCAAkC;QAClC,qGAAqG;QACrG,gFAAgF;QAChF,oFAAoF;QACpF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiD,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAChH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;yEA4BqE;IACrE,KAAK,CAAC,CAAC,KAAK,CACV,SAAiB,EACjB,IAAsF;QAEtF,IAAI,MAAM,GAA8B,IAAI,EAAE,UAAU,CAAC;QACzD,MAAM,IAAI,GAAG,GAAsB,EAAE,CACnC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACb,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,UAAU,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,kBAAkB,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAChJ,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC,CAAC;QACL,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,gBAAgB,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;YACxK,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS,CAAC,UAAU;YAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAiD,CAAC;YACpF,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO;YAC7B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;IAED;;oCAEgC;IAChC,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA+B;QAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7H,CAAC;IAED;;uEAEmE;IACnE,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAA+B;QAC/D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjI,CAAC;IAED;;;;;kCAK8B;IAC9B,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,IAAuB,EACvB,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtI,CAAC;IAED;;;;yFAIqF;IACrF,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA2B,EAAE,IAA+B;QACxF,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAChJ,CAAC;IAED;;;+EAG2E;IAC3E,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,KAAa,EACb,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAyB;YAC5C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,YAAY,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE;YAClG,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;6DAIyD;IACzD,KAAK,CAAC,IAAI,CACR,MAAwE,EACxE,IAA+B;QAE/B,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,EAAE,MAAM;YAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,KAAK;YAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,uGAAuG;QACvG,IAAI,MAAM,EAAE,CAAC;YAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAkB;YACrC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;2FAGuF;IACvF,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAA+B;QAC3D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAwB;YAC3C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,OAAO;YAC1D,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;sBAsBkB;IAClB,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,IAA+B;QAC7D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAuB;YAC1C,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE;YACrD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;mBAIe;IACf,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAA+B;QAChE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgC;YACnD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;wBAKoB;IACpB,KAAK,CAAC,SAAS,CACb,SAAiB,EACjB,IAA6D,EAC7D,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAgC;YACnD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,SAAS;YAC5D,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;oHAIgH;IAChH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,IAA+B;QAC1D,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAiB;YACpC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,MAAM;YACzD,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;mEAc+D;IAC/D,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,IAA+B;QACnE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAA8B;YACjD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,gBAAgB;YACnE,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,IAA+B,EAAE,IAA+B;QACnG,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAA2B;YAC9C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,eAAe;YAClE,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,YAAY,CAChB,SAAiB,EACjB,MAAc,EACd,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAA4B;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,gBAAgB;YACnE,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,IAA+B;QACjE,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAAwB;YAC3C,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,aAAa;YAChE,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,cAAc,CAClB,SAAiB,EACjB,IAAkC,EAClC,IAA+B;QAE/B,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,CAA8B;YACjD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,kBAAkB;YACrE,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;CACF"}
1
+ {"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/resources/sessions.ts"],"names":[],"mappings":"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"}
package/dist/settings.d.ts CHANGED
@@ -39,11 +39,22 @@ export interface SettingsHookMatcher {
39
39
  /** Tool-name pattern (e.g. `"Bash"`, `"Bash|Edit"`, `"Write"`). Omitted/empty ⇒ matches every tool.
40
40
  * UserPromptSubmit hooks have no tool → matcher is ignored there.
41
41
  *
42
- * 🔴 **工具事件(PreToolUse / PostToolUse / PostToolUseFailure)的 matcher 按工具的 wire 名匹配,不按别名**(server ≥7.112.0 / S-924;clay C-R214 ③)。
42
+ * 🔴 **工具事件(PreToolUse / PostToolUse / PostToolUseFailure)的 matcher 按工具的 wire 名匹配,不按别名**(server ≥7.112.0 / S-924;clay C-R214 ③;判据 server ≥7.114.0 / S-995 收口)。
43
43
  * 引擎自带工具有别名时(今天只有一条:`ListPeers` → 正名 `ListAgents`),只写别名的 matcher **永不命中、一句话都没有**(PostToolUse 两事件自 server 7.107.0、PreToolUse 一直如此)。
44
- * server ≥7.112.0 在**fresh 提交**面当场拒:`settings.hooks.<事件>` 的 matcher 是纯名字交替(`A` / `A|B`)、其中某一支是引擎别名、且它的正名不在同一 matcher 里
45
- * ⇒ **400 `request.field_invalid`**(`BadRequestError`;零新码),错误句点名别名与正名 —— 句子即改法。放行:正名(`ListAgents`)· `正名|别名`(`ListAgents|ListPeers`,滚动期两名都写的补偿形)·
46
- * 正则形(模式不是名字,不判)· 空 / `*` / 缺省 · 非工具事件。**resume 重放不拒**:存量 body 里的别名 matcher 整只 hooks 照常采纳(别名那一组继续永不命中,其余 hook 照跑)。
44
+ * **fresh 提交**面当场拒:server 对引擎工具目录里**每一条别名**问「这只 matcher 选不选它 / 选不选它的正名」,**选中别名而选不中正名 ⇒ 400 `request.field_invalid`**(`BadRequestError`;零新码),
45
+ * 错误句点名别名与正名 —— 句子即改法(只回显目录里的名字,不回显你写的原字节)。server 7.112.0 只拒字面形(`ListPeers` / `Read|ListPeers`);**server ≥7.114.0 同一个错误写成什么形都拒**:
46
+ * 正则形(`^ListPeers$` / `ListPeers.*` / `(ListPeers)`)· 带空白(` ListPeers` / `Read | ListPeers`)· 逗号分隔(`Read,ListPeers`)· 含空段(`ListPeers|`)。
47
+ * **放行**:选中正名的(`ListAgents` / `ListAgents|ListPeers`〔滚动期两名都写的补偿形〕/ `List.*`)· 两边都选不中的(含 MCP / 嵌入方的工具名、大小写错的 `listpeers`)· 空 / `*` / 缺省 · 非工具事件。
48
+ * ⚠️ 规则问的是「选不选」,**不问作者本意**:一只写来匹配目录外工具、只是顺带选中别名的正则(`.*Peers`)同样 400 —— 出路是在正则里把别名排除掉(`(?!ListPeers$).*Peers`)。
49
+ * **两条车道、两档判法**:单用户车道(`settings.hooks` 会被采纳;探 `capabilities.taskSettings.hooks`,`true` = 本车道)对正则形**真求值**(一次受理共享一份 100 ms 墙钟预算);
50
+ * 多租户车道(server 整只忽略 `settings.hooks`)只判字面 / 名字表读法、**不执行调用方的正则**(正则形照旧受理)。
51
+ * **「未判」照旧受理**:matcher 超 8 192 字符 · 正则求值用尽预算 · 正则编不过 —— server 记一笔 F 类 fail-open 计数,不拒。
52
+ * **resume 重放不判**:存量 body 里的别名 matcher 整只 hooks 照常采纳(别名那一组继续永不命中,其余 hook 照跑)。
53
+ *
54
+ * 🔴 **运行期读法**(server ≥7.114.0;server 自陈与 CC 2.1.280 同形,本包只核了 server 一侧):matcher 只含名字字符(`[A-Za-z0-9_-]`)、`|`、`,`、空格时,按 `[|,]` 拆、**每段 trim**、丢空段、成员判 ——
55
+ * 容忍两端 / 分隔符两侧的空白与逗号分隔(`" Bash"` / `"Read | Bash"` / `"Read,Bash"` 都命中 `Bash`);**区分大小写、不剥词内空白**(`bash` / `"Ba sh"` 不命中)。
56
+ * 含任何别的字符(`.` / `*` / 括号 / 制表 …)⇒ **整体当锚定正则**(`^(?:matcher)$`),不 trim。
57
+ * ⚠️ 升级后,以前因空白永不触发的钩子**会触发**(server 判:那正是作者本意;PreToolUse 的 deny 钩子也真拦)。
47
58
  * 别名表是引擎的工具目录,本包不抄;型不拦它(本字段仍是 `string`),拦的是 server 受理门。 */
48
59
  matcher?: string;
49
60
  /** The hook commands to run when `matcher` hits (the runner handles dedup/parallel-precedence/timeout). */
package/dist/settings.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8GAA8G;AAC9G,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB;2HACuH;IACvH,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;gEAQ4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2GAA2G;IAC3G,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED;;0HAE0H;AAC1H,MAAM,WAAW,aAAa;IAC5B;sHACkH;IAClH,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,gIAAgI;IAChI,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,iIAAiI;IACjI,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,oDAAoD;IACpD,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAAC;CACpD;AAED;;sHAEsH;AACtH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,0GAA0G;IAC1G,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;iFA2B6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAChF,iHAAiH;IACjH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,sHAAsH;AACtH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;gHAMgH;AAChH,MAAM,WAAW,iBAAiB;IAChC,uHAAuH;IACvH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,mHAAmH;IACnH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;wHAEwH;AACxH,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,kHAAkH;IAClH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;mHAC+G;IAC/G,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;;;;;;yGASqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;;;qEAaiE;IACjE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;oEAIgE;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;;;;;2DAUuD;IACvD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}
1
+ {"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,8GAA8G;AAC9G,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB;2HACuH;IACvH,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;;;gEAmB4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2GAA2G;IAC3G,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED;;0HAE0H;AAC1H,MAAM,WAAW,aAAa;IAC5B;sHACkH;IAClH,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACnC,gIAAgI;IAChI,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,iIAAiI;IACjI,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,oDAAoD;IACpD,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAAC;CACpD;AAED;;sHAEsH;AACtH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,0GAA0G;IAC1G,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;iFA2B6E;IAC7E,WAAW,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAChF,iHAAiH;IACjH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,sHAAsH;AACtH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;gHAMgH;AAChH,MAAM,WAAW,iBAAiB;IAChC,uHAAuH;IACvH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1C,mHAAmH;IACnH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qHAAqH;IACrH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;wHAEwH;AACxH,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,kHAAkH;IAClH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;mHAC+G;IAC/G,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;;;;;;yGASqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;;;;;qEAaiE;IACjE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;oEAIgE;IAChE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;;;;;;2DAUuD;IACvD,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB"}
package/openapi.yaml CHANGED
@@ -415,8 +415,8 @@ paths:
415
415
  For anything that may take minutes or hit a HITL gate, use `/v1/runs` instead (this call blocks).
416
416
  🔴 PREPARE-TIME REFUSALS ARE TRIAGED ON WORK DONE (server >= 7.104.0 / S-271, one rule for the whole table): a
417
417
  prepare-time refusal code that HAS a status in the server's per-code triage table (`resume_at.*`, governance codes,
418
- `rewind.store_unconfigured` / `rewind.capture_disabled` / `rewind.child_scope_unsupported`, the registered `config.*`
419
- codes incl. the three roster-bound ones, `corrupt_session`; codes outside the table, e.g. `rewind.invalid_spec`, stay
418
+ `rewind.store_unconfigured` / `rewind.capture_disabled` / `rewind.child_scope_unsupported` / `rewind_snapshot.unresolvable`, the
419
+ registered `config.*` codes incl. the three roster-bound ones, `corrupt_session`; codes outside the table, e.g. `rewind.invalid_spec`, stay
420
420
  200 with a failed body) answers its 4xx / 5xx ERROR BODY only when the whole submission did ZERO WORK (cumulative
421
421
  `stats.turns === 0` AND `stats.tokens === 0` — the common case: nothing billed, not idempotency-cached). When a
422
422
  `verify` / `cascade` run's earlier tier already ran turns and only the last tier is refused, the SAME code arrives
@@ -461,6 +461,10 @@ paths:
461
461
  history off (`fileHistory: "disabled"`) and asks to restore in the same breath; this server's request face
462
462
  refuses that combination earlier (400 `request.field_conflict`), so only a host building a TaskSpec directly can
463
463
  reach this code. `rewind.child_scope_unsupported` / `resume_at.*` also land here.
464
+ `rewind_snapshot.unresolvable` (server 7.114.0 `dist/runs.js` `resumeAtHttpStatus`: a `resumeAt` file restore —
465
+ `restoreFiles` — that finds no file-history boundary at / above the branch point) is in the same per-code table and lands
466
+ here too, on the same ZERO WORK condition (turns 0, tokens 0: nothing ran, nothing billed); a submission that already ran
467
+ turns gets 200 + a failed body carrying the code in `terminal.code` instead.
464
468
  content:
465
469
  application/json:
466
470
  schema: { $ref: '#/components/schemas/ErrorResponse' }
@@ -2300,6 +2304,20 @@ paths:
2300
2304
  '401': { $ref: '#/components/responses/Unauthorized' }
2301
2305
  '404': { $ref: '#/components/responses/NotFound' }
2302
2306
  '409': { $ref: '#/components/responses/Conflict' }
2307
+ '500':
2308
+ description: >-
2309
+ `corrupt` (server >= 7.114.0 / core 7.39.2 on the local file-backed lane; the SQL-backed store already refuses a bad row
2310
+ with the same code): this session's stored rules are PRESENT BUT UNREADABLE (a torn or hand-edited rules file). The door
2311
+ REFUSES instead of answering "no rules" — session rules only ever tighten, so the row IS the restriction and reading a
2312
+ damaged one as empty would silently drop it. DETERMINISTIC: a retry cannot change it (the SDK does not auto-retry this
2313
+ code; it arrives as a bare `APIError` with `errorCode: "corrupt"`); the repair is the operator's — fix the file or
2314
+ delete it (deleting = an explicit "no rules"). `error` names the session, the damage grade (`unreadable` /
2315
+ `unparseable` / `malformed`) and both exits, with NO on-disk path (it reaches the end user; the path goes to the
2316
+ operator's log). A rules file that is ABSENT is not this arm: it answers 200 `{ rules: { rev: 0 } }`.
2317
+ Also `internal.error` (unclassified).
2318
+ content:
2319
+ application/json:
2320
+ schema: { $ref: '#/components/schemas/ErrorResponse' }
2303
2321
  '501': { $ref: '#/components/responses/NotImplemented' }
2304
2322
  put:
2305
2323
  tags: [sessions]
@@ -2342,6 +2360,21 @@ paths:
2342
2360
  schema: { $ref: '#/components/schemas/ErrorResponse' }
2343
2361
  '404': { $ref: '#/components/responses/NotFound' }
2344
2362
  '409': { $ref: '#/components/responses/Conflict' }
2363
+ '500':
2364
+ description: >-
2365
+ `corrupt` (server >= 7.114.0 / core 7.39.2 on the local file-backed lane; the SQL-backed store already refuses a bad row
2366
+ with the same code): the read this write makes first finds the session's stored rules PRESENT BUT UNREADABLE (a torn or
2367
+ hand-edited rules file). The door REFUSES instead of treating it as "no rules" — session rules only ever tighten, so
2368
+ the row IS the restriction — and `PUT` never overwrites the damaged bytes (overwriting = losing the evidence): nothing is
2369
+ written. DETERMINISTIC: a retry cannot change it (the SDK does not auto-retry this code; it arrives as a bare `APIError`
2370
+ with `errorCode: "corrupt"`); the repair is the operator's — fix the file or delete it (deleting = an explicit "no
2371
+ rules"). For a damaged rules row `error` names the session, the damage grade and both exits, with NO on-disk path.
2372
+ ⚠️ The same code also comes from the write path's high-water-mark sidecar (`.hwm.json`) being unreadable, and that one
2373
+ sentence STILL names the sidecar's on-disk path (server 7.114.0 discloses it as a known gap: core #1307 / #1309, core
2374
+ 7.41.0). Also `internal.error` (unclassified).
2375
+ content:
2376
+ application/json:
2377
+ schema: { $ref: '#/components/schemas/ErrorResponse' }
2345
2378
  '501': { $ref: '#/components/responses/NotImplemented' }
2346
2379
 
2347
2380
  /v1/sessions/{sessionId}/mcp:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema-agent/sdk",
3
- "version": "16.0.0",
3
+ "version": "16.0.1",
4
4
  "description": "Typed, zero-runtime-dependency SDK for the Sema agent fleet usage plane. The shared substrate for all doors (CC/Codex MCP façade + web). Server-side only — tokens never enter the browser.",
5
5
  "type": "module",
6
6
  "license": "BUSL-1.1",
@@ -52,6 +52,6 @@
52
52
  "prepublishOnly": "rm -f tsconfig.tsbuildinfo && npm run build && npm run typecheck --workspaces=false --prefix ../.. && npm test --workspaces=false --prefix ../.. && npm run prepack"
53
53
  },
54
54
  "devDependencies": {
55
- "@sema-agent/settings-schema": "^6.4.0"
55
+ "@sema-agent/settings-schema": "^7.0.1"
56
56
  }
57
57
  }