@sema-agent/sdk 8.3.0 → 8.4.0
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.
- package/README.md +126 -0
- package/dist/events.d.ts +91 -28
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/resources/tasks.d.ts +5 -2
- package/dist/resources/tasks.d.ts.map +1 -1
- package/dist/resources/tasks.js +5 -2
- package/dist/resources/tasks.js.map +1 -1
- package/dist/resources/tool-approvals.d.ts +19 -5
- package/dist/resources/tool-approvals.d.ts.map +1 -1
- package/dist/resources/tool-approvals.js.map +1 -1
- package/dist/types.d.ts +364 -22
- package/dist/types.d.ts.map +1 -1
- package/openapi.yaml +748 -63
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-approvals.js","sourceRoot":"","sources":["../../src/resources/tool-approvals.ts"],"names":[],"mappings":"AA+DA;;;;;;kEAMkE;AAClE;;;uCAGuC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,SAAS;IACT,MAAM;IACN,aAAa;IACb,kBAAkB;IAClB,8CAA8C;IAC9C,sBAAsB;IACtB,QAAQ;IACR,cAAc;IACd,aAAa;IACb,aAAa;IACb,aAAa;IACb,iBAAiB;IACjB,YAAY;IACZ,mBAAmB;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,SAAS;CACD,CAAC;AAoBX,sGAAsG;AACtG,qFAAqF;AACrF,EAAE;AACF,2EAA2E;AAC3E,4FAA4F;AAC5F,oFAAoF;AACpF,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,wDAAwD;AACxD,sGAAsG;AAEtG,mEAAmE;AACnE,gGAAgG;AAChG,yEAAyE;AACzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAGtF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,SAAS,EAAE,eAAe,CAAU,CAAC;AAanF,MAAM,gBAAgB,GAAmB,IAAI,CAAC;AAC9C,KAAK,gBAAgB,CAAC;AAEtB;0EAC0E;AAC1E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,CAAU,CAAC;AAUrG,sGAAsG;AACtG,wEAAwE;AACxE,yFAAyF;AACzF,sGAAsG;AAEtG;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,mBAAmB,CAAU,CAAC;AAGlG,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,OAAO,CAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"tool-approvals.js","sourceRoot":"","sources":["../../src/resources/tool-approvals.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -57,7 +57,7 @@
|
|
|
57
57
|
* null" may be correct — check for a normalizer at the boundary before widening it to `| null`.
|
|
58
58
|
*/
|
|
59
59
|
import type { SemaSettings } from "./settings.js";
|
|
60
|
-
import type { RuleOffer } from "./resources/tool-approvals.js";
|
|
60
|
+
import type { AskOrigin, RuleOffer } from "./resources/tool-approvals.js";
|
|
61
61
|
/** Authenticated end-user identity. Opaque to the service (used as memory scope + session owner). The SDK
|
|
62
62
|
* normalizes; the service does NOT validate the format. Convention: `user:` / `org:` / `ai:` / `anon:`. */
|
|
63
63
|
export type Principal = string;
|
|
@@ -699,11 +699,94 @@ export interface PendingGateMaterial {
|
|
|
699
699
|
decidePath: string;
|
|
700
700
|
governanceForced?: true;
|
|
701
701
|
}
|
|
702
|
+
/**
|
|
703
|
+
* 🔴 **BREAKING(server ≥ 7.64.0,core 7.6.0 design/390 D-8)—— 终局是一条带标因由,不再是八个平面键。**
|
|
704
|
+
*
|
|
705
|
+
* 7.63.0 及以前,一次 run 怎么结束的要从并列的八个可选键里拼:`status` / `errorCode` / `errorMessage` /
|
|
706
|
+
* `blockedReason` / `checkpointToken` / `checkpointId` / `checkpointGate` / `workspaceRestoreMode`。哪些组合
|
|
707
|
+
* 合法(「`suspended` ⇔ 有 token」「review park 与 approval park 不同时置位」)只活在引擎那条 if/else 阶梯的
|
|
708
|
+
* 顺序里,读的人只能靠**缺席**推断。现在它是**形状**:paused 因由带着它的门,completed 因由**写不出**码。
|
|
709
|
+
*
|
|
710
|
+
* **怎么读**:分诊读 `terminal.kind`。要旧的五词 `status`,调引擎导出的 `terminalProjection(terminal)` ——
|
|
711
|
+
* 那是**唯一**一条 因由→平面 的派生。🔴 **本 SDK 刻意不提供兼容投影**:提供一条就等于同一个事实在这条
|
|
712
|
+
* wire 上有了两个真源,而消费端会分成「读因由的」和「读投影的」两派(下一次形变时后者全部无声地错)。
|
|
713
|
+
* 「哪个 park 读作 `suspended`、哪个读作 `needs_review`」由引擎的 pause registry 决定,不是本服务的表。
|
|
714
|
+
*
|
|
715
|
+
* 🔴 **没有变的是 server 自己的列与信封**(它们不是引擎结果):`GET /v1/runs/:id` 行上的 `status` /
|
|
716
|
+
* `errorCode` 列、任务列表行的 `status`、`/decide` 200 体的三键、fleet 行的终态词 —— 照旧说五词,只是
|
|
717
|
+
* 数据源改成从因由投影一次。
|
|
718
|
+
*/
|
|
719
|
+
export type TerminalCause = {
|
|
720
|
+
kind: "completed";
|
|
721
|
+
} | {
|
|
722
|
+
kind: "failed";
|
|
723
|
+
/** 这次失败带的**机器码**——退役的平面 `errorCode` 那一席,现在**结构上**只属于失败臂
|
|
724
|
+
* (「码属于失败」成了形状,不再是一条跨字段口头约定)。**开集**,点分命名空间可按族前缀匹配:
|
|
725
|
+
* `limits.max_tokens_exceeded` / `limits.max_cost_exceeded` / `limits.max_turns_exceeded` /
|
|
726
|
+
* `limits.max_walltime_exceeded` / `config.*` / `resume_at.*`;brain 码(`auth`/`network`/
|
|
727
|
+
* `rate_limit`/…)与 `conflict` 仍是扁平词。
|
|
728
|
+
* ⚠️ 两个**外因**停因刻意**不在** `limits.*` 族(重试要的是新环境 / 等窗口放开,不是更小的预算):
|
|
729
|
+
* `env.lifetime_expired` 与 `usage.window_exhausted`。
|
|
730
|
+
* 治理码同样落这里,而**哪条腿把它改写成 HTTP 状态逐码不同**,别互相推广:
|
|
731
|
+
* · `memory.admission_denied` / `memory.admission_required` **只**在同步 `POST /v1/tasks` 上被改写成
|
|
732
|
+
* 403/503;异步轮询腿与 `done` 帧上它们骑 200;
|
|
733
|
+
* · `usage.window_exhausted` 只有**进场前**那道门是 429,进场后竞态窗内的拒**任何腿都不改写**。
|
|
734
|
+
* 嵌套编排器遇到自己驱动不了的耐久 park 时盖 `unexpected.suspended` / `unexpected.needs_review`,
|
|
735
|
+
* 并把那次 park 整只带在 {@link nestedPause}。
|
|
736
|
+
* 🔴 消费端必须带 `default` 臂;缺席 = 这次失败本来就没有码。 */
|
|
737
|
+
code?: string;
|
|
738
|
+
/** 人类可读的失败文本;没有就缺席。 */
|
|
739
|
+
message?: string;
|
|
740
|
+
/** 这次失败**顶替的那次耐久暂停** —— 只在**嵌套硬边界**(verify / cascade)上出现:嵌套腿停在一道
|
|
741
|
+
* 耐久门上,而编排器从内部驱动不了 resume,于是在**它的**边界上如实报 failed,同时把那次 park 的
|
|
742
|
+
* 因由整只带在这里,顶层调用方据此仍能恢复。
|
|
743
|
+
* 🔴 wire 上它同样**不带 `token`**(与顶层 paused 臂同一条摘除规则);`gate` / `checkpointId` 照常在。
|
|
744
|
+
* 引擎自己组装的失败上恒缺席。 */
|
|
745
|
+
nestedPause?: PausedCause;
|
|
746
|
+
} | {
|
|
747
|
+
kind: "blocked";
|
|
748
|
+
/** agent 为什么完不成(治理判决不是失败)。 */
|
|
749
|
+
reason: string;
|
|
750
|
+
} | PausedCause;
|
|
751
|
+
/**
|
|
752
|
+
* 一次耐久暂停的因由(`TerminalCause` 的 paused 臂)—— 提交了 checkpoint,这条 run 可恢复。
|
|
753
|
+
*
|
|
754
|
+
* 🔴 **`token` 席位永不上 wire**:它是恢复**能力凭据**(token-as-auth),永不离开服务边界 —— 与 7.63.0
|
|
755
|
+
* 之前的 `checkpointToken` 从不上 wire 是**同一条纪律**,只是凭据换了住址(server `src/terminal.ts` 的
|
|
756
|
+
* `stripResumeToken` 在**两条**够得着的路径上摘它:本臂与 `failed.nestedPause`)。要动这次暂停:走
|
|
757
|
+
* `POST /v1/approvals/{sessionId}/decide`,凭 `checkpointId` 对账。
|
|
758
|
+
*/
|
|
759
|
+
export interface PausedCause {
|
|
760
|
+
kind: "paused";
|
|
761
|
+
/** **哪一道**暂停 —— 谁/什么必须来恢复它。与 park 行的 `gate.kind` 是同一个词。 */
|
|
762
|
+
gate: CheckpointGate;
|
|
763
|
+
/** 这次暂停的**非密**稳定身份 —— token 不能去的地方可以记/可以渲的那个对账键。
|
|
764
|
+
* pre-identity 的老 checkpoint 上缺席。 */
|
|
765
|
+
checkpointId?: string;
|
|
766
|
+
/** 被暂停任务的远端工作区**怎么回来**,只要这次暂停捕获了远端工作区就在场。两种模式计费与行为差得远:
|
|
767
|
+
* · `"snapshot"` —— VM 被挂起成快照(供应商侧计费通常停,进程内存态被捕获,resume 复原);
|
|
768
|
+
* · `"park_only"` —— 环境自陈不可挂起(SSH 主机 / ADB 设备),于是**什么都没被暂停**:机器继续跑、
|
|
769
|
+
* 继续花钱,进程内存态听凭那头处置,resume 只是重新连上还在那儿的工作区。
|
|
770
|
+
* **缺席** = 进程内暂停(静态的、调用方自有的环境:没有远端工作区被捕获)。
|
|
771
|
+
* 🔴 把「paused ⇒ 空闲且免费」当成不变量的调度器必须看得见这一位。 */
|
|
772
|
+
restoreMode?: "snapshot" | "park_only";
|
|
773
|
+
}
|
|
702
774
|
/** Synchronous task result (`POST /v1/tasks`). */
|
|
703
775
|
export interface TaskResult {
|
|
704
776
|
taskId: string;
|
|
705
777
|
sessionId: string;
|
|
706
|
-
|
|
778
|
+
/** 🔴 **server ≥ 7.64.0** —— 这条 run 的**唯一**终局记录。分诊读 `terminal.kind`;退役的八个平面键
|
|
779
|
+
* (`status` / `errorCode` / `errorMessage` / `blockedReason` / `checkpointToken` / `checkpointId` /
|
|
780
|
+
* `checkpointGate` / `workspaceRestoreMode`)已从本型面**整删**,**不留可选兼容键**(同一条 wire 上
|
|
781
|
+
* 两种拼法 = 一个语义面两个写者)。要五词 `status` 的消费方自己调引擎的 `terminalProjection(terminal)`。
|
|
782
|
+
*
|
|
783
|
+
* ⚠️ **跨代偏斜,如实登记**(与 8.0.0 的 `CcImportResult` 换形同款处置):本 SDK 的 server 支持地板是
|
|
784
|
+
* **3.0.0**,而 `terminal` 只有 **≥7.64.0** 的 server 才发。对着一台更老的 server,这一座在运行期
|
|
785
|
+
* **缺席**(而型面上它是必填)—— 旧的平面键则仍在 wire 上,经开集索引读得到但**无类型**。
|
|
786
|
+
* 🔴 要同时吃两代 server 的消费方:先用 `"terminal" in result` 判形,别把型面的必填当成运行期保证。
|
|
787
|
+
* ⚠️ 本座**不**做成可选来「表达这件事」:可选会让 7.64.0 之后的每一个读点都被迫处理一个**不存在**的
|
|
788
|
+
* 缺席分支,而真正的判别位是对端版本,不是这个键。 */
|
|
789
|
+
terminal: TerminalCause;
|
|
707
790
|
result?: string;
|
|
708
791
|
/** [2255]① 拒绝形材料(server ≥3.21:SSE 车道 409 conflict.session_active_run 的 done 帧 result 携带;
|
|
709
792
|
* 普通终态帧不带)。activeTaskId 其实自 [1833] G10 起就在 wire 上,此前 SDK 侧漏登记——一并补。
|
|
@@ -711,8 +794,6 @@ export interface TaskResult {
|
|
|
711
794
|
activeTaskId?: string | null;
|
|
712
795
|
activeTaskStatus?: string;
|
|
713
796
|
pendingGate?: PendingGateMaterial;
|
|
714
|
-
errorCode?: string;
|
|
715
|
-
errorMessage?: string;
|
|
716
797
|
/** 🔴 **等待提示的 2xx 形**(复审车 C,2026-08-05)—— 引擎 result 里的等待提示,**毫秒、未换算**
|
|
717
798
|
* (与错误体的 `retryAfterSec`(**秒**)不同单位,别混用)。
|
|
718
799
|
* ⚠️「带等待提示」≠「transient」:引擎把 `memory.admission_required` 判为 **transient**(目录答上来后
|
|
@@ -741,17 +822,15 @@ export interface TaskResult {
|
|
|
741
822
|
};
|
|
742
823
|
/** [1543] SDK-M 补键(core 真域逐字,engine 一直在发、此前封闭接口读不到):
|
|
743
824
|
* salvagedOutput = degenerate/timeout 终态抢救出的最后模型文本(render as partial);
|
|
744
|
-
* blockedReason = 任务被策略/门挡下的人类可读因;
|
|
745
|
-
* checkpointGate = suspended 时挂起的门(与 events 的 `suspended.gate` 同源——poller 面读这里);
|
|
746
825
|
* degraded = 模型降级链实录(from/to/reason/atTurn);
|
|
747
|
-
* structuredOutput = outputSchema 任务的结构化产出(0.0.74 的 outputRetries 旋钮所服务的产物)。
|
|
826
|
+
* structuredOutput = outputSchema 任务的结构化产出(0.0.74 的 outputRetries 旋钮所服务的产物)。
|
|
827
|
+
* (7.64.0 删:`blockedReason` → `terminal.blocked.reason`;`checkpointGate` → `terminal.paused.gate`,
|
|
828
|
+
* 而且不再是 `unknown` —— 因由形下它是 typed 的 {@link CheckpointGate}。) */
|
|
748
829
|
salvagedOutput?: string;
|
|
749
|
-
|
|
750
|
-
checkpointGate?: unknown;
|
|
751
|
-
/** [4913](server 7.41+)—— durable park(status suspended/needs_review)时**待批工具调用**的 id,
|
|
830
|
+
/** [4913](server 7.41+)—— durable park(`terminal.kind === "paused"`)时**待批工具调用**的 id,
|
|
752
831
|
* 与 tool_approval 帧的 `toolCallId` 同键同义(server ≥1.307)。缺席形照 core [1995]② OMITTED 契约:
|
|
753
832
|
* tool-less park(resource_limit / plan_review / task_done)或 server 侧读失败时**键整个缺席**,
|
|
754
|
-
* 绝不编 null——消费方测 presence
|
|
833
|
+
* 绝不编 null——消费方测 presence。非 paused 的因由上恒缺席。 */
|
|
755
834
|
toolCallId?: string;
|
|
756
835
|
degraded?: {
|
|
757
836
|
from: string;
|
|
@@ -776,7 +855,10 @@ export interface TaskResult {
|
|
|
776
855
|
* }
|
|
777
856
|
* ```
|
|
778
857
|
* 或直接按机器码 `ev.result.errorCode === "conflict.session_active_run"`。
|
|
779
|
-
*
|
|
858
|
+
* 🔴 **server ≥ 7.64.0 起两形靠键分家**:正常终态带 `terminal`(带标因由)、**没有** `status`;拒绝形带扁平
|
|
859
|
+
* `status: "failed"` + `errorCode`,因为它是 **server 自己的**拒绝信封、不是引擎结果,这次形变没动它。
|
|
860
|
+
* 于是 `status` 现在只在其中一形上 —— 但判别位仍按 server 钉的那两个来(`stats` 在场性 / `errorCode`),
|
|
861
|
+
* 别改判成 `status` 缺席(那是拿「另一形没有的键」当判据,方向脆)。
|
|
780
862
|
*
|
|
781
863
|
* 出路材料([2255]①/[2257]):`activeTaskStatus` 分「插话/取消」(running)与「决议/取消」(parked)两族;
|
|
782
864
|
* `pendingGate.decidePath` 是 parked run 的**那一个**正确 resume 入口(sessionId 寻址,checkpoint token
|
|
@@ -1381,13 +1463,53 @@ export interface SupervisorCostBreakdown {
|
|
|
1381
1463
|
};
|
|
1382
1464
|
totalMicroUsd: number;
|
|
1383
1465
|
}
|
|
1466
|
+
/**
|
|
1467
|
+
* 🔴 **盘上的那一形** —— server 7.63.0 及以前写下的任务结果,退役的**平面**形。
|
|
1468
|
+
*
|
|
1469
|
+
* 它只出现在**回放持久字节**的那几张脸上,而且只在跨过 7.64.0 升级过的部署上:`GET /v1/runs/:id` 的
|
|
1470
|
+
* `result`(server 对存储 blob 是**逐字透传**,只过一次脱敏,**不补** `terminal` —— `src/http/routes/runs.ts`)
|
|
1471
|
+
* 与 durable 账本回放出来的 `done` 帧。**没有任何东西会再写出它**:写口只铸一种形({@link TaskResult})。
|
|
1472
|
+
*
|
|
1473
|
+
* 🔴 **这不是兼容孪生键**。「同一条 wire 上一个事实两种拼法」禁的是**写者**:一个语义面两个生产者。这里
|
|
1474
|
+
* 只有**一个**写者,外加一张**读盘**面认盘上那个已停产的写者真留下的字节 —— 与 server 自己那只两代读器
|
|
1475
|
+
* (`persistedPlaneOf`)划的是同一条线,而那个函数的顶注逐字记着「删掉它」造成的两条可复现回归:历史 run 的
|
|
1476
|
+
* `GET /v1/runs/:id` 整个 500,以及旧账本行回放时凭据重新明文外发。
|
|
1477
|
+
*
|
|
1478
|
+
* **判别位** = `"terminal" in result`:在场 = 现行因由形,缺席 = 本形。🔴 **别只按 `status` 判** ——
|
|
1479
|
+
* SSE 的拒绝信封({@link ActiveRunConflictDoneResult})也带 `status`。
|
|
1480
|
+
*/
|
|
1481
|
+
export interface LegacyPlaneTaskResult {
|
|
1482
|
+
taskId: string;
|
|
1483
|
+
sessionId: string;
|
|
1484
|
+
/** 退役的五词平面状态。它的继任是 {@link TaskResult.terminal} 的 `kind`(经引擎的 `terminalProjection` 派生)。 */
|
|
1485
|
+
status: RunStatus;
|
|
1486
|
+
result?: string;
|
|
1487
|
+
stats: TaskStats;
|
|
1488
|
+
/** 退役的平面终局码。继任者 = `terminal.failed.code`。 */
|
|
1489
|
+
errorCode?: string;
|
|
1490
|
+
/** 退役的平面失败文本。继任者 = `terminal.failed.message`。 */
|
|
1491
|
+
errorMessage?: string;
|
|
1492
|
+
/** 退役的平面治理因由。继任者 = `terminal.blocked.reason`。 */
|
|
1493
|
+
blockedReason?: string;
|
|
1494
|
+
/** 退役的平面暂停门 —— **刻意留 `unknown`**:这是上一代写下的字节,本契约不替它重新裁定形状。
|
|
1495
|
+
* 继任者 = `terminal.paused.gate`(typed 的 {@link CheckpointGate})。 */
|
|
1496
|
+
checkpointGate?: unknown;
|
|
1497
|
+
salvagedOutput?: string;
|
|
1498
|
+
model?: string;
|
|
1499
|
+
toolCallId?: string;
|
|
1500
|
+
retryAfterMs?: number;
|
|
1501
|
+
}
|
|
1384
1502
|
/** Run state (`GET /v1/runs/:id`) — LIVE shape (service Drift 2): `result` is the NESTED TaskResult
|
|
1385
1503
|
* (output text = result.result, stats = result.stats; no top-level stats); error text field is `error`. */
|
|
1386
1504
|
export interface RunRecord {
|
|
1387
1505
|
taskId: string;
|
|
1388
1506
|
sessionId: string;
|
|
1389
1507
|
status: RunStatus;
|
|
1390
|
-
|
|
1508
|
+
/** 🔴 **读盘面 ⇒ 两代字节**(server ≥7.64.0 起;见 {@link LegacyPlaneTaskResult}):server 对存储 blob 是
|
|
1509
|
+
* 逐字透传、**不补** `terminal`,所以一台跨 7.64.0 升级过的部署上,升级前的历史行读出来仍是旧的平面形。
|
|
1510
|
+
* 判别位 `"terminal" in run.result`。 */
|
|
1511
|
+
result?: TaskResult | LegacyPlaneTaskResult;
|
|
1512
|
+
/** 本**行的列**,7.64.0 未变(照旧说五词);只是数据源改成从 `result.terminal` 投影一次(旧行则直接读平面键)。 */
|
|
1391
1513
|
errorCode?: string;
|
|
1392
1514
|
error?: string;
|
|
1393
1515
|
/** Work-view correlation. Present when the run has a jobId (omitted when null). LIVE server-side
|
|
@@ -1594,6 +1716,156 @@ export interface TraceTurn {
|
|
|
1594
1716
|
};
|
|
1595
1717
|
[k: string]: unknown;
|
|
1596
1718
|
}
|
|
1719
|
+
/**
|
|
1720
|
+
* **谁拒的** —— 判决是这次 deny 的那一**层**(core 7.6.0 `DENIED_BY_VALUES`,闭八词)。
|
|
1721
|
+
* deny 引出的另一个问题「谁**问**的」由 {@link AskOrigin} 回答;7.6.0 之前两者共用一张七词表
|
|
1722
|
+
* (`PermissionDeniedSource`),其中 `classifier` 同时兼任「分类器提的问」与「分类器拒的」两义。
|
|
1723
|
+
* · `policy` —— 部署 `ToolPolicy` 拒(直接拒,或复查一次被批准的编辑),或审批-编辑链撞了轮次上限;
|
|
1724
|
+
* · `hook` —— PreToolUse hook 拒 / 抛 / 从未作答(对「没作决定的 hook」的 fail-closed 拦阻按 hook 层归因);
|
|
1725
|
+
* · `org` —— 组织策略规则拒;
|
|
1726
|
+
* · `classifier` —— auto 模式分类器**直接**拒(它的 ASK 侧角色是 `origin: "denial_limit_fallback"`);
|
|
1727
|
+
* · `plan_mode` —— plan 模式对写工具的只读拦阻;
|
|
1728
|
+
* · `compliance` —— 合规的调用期锁;
|
|
1729
|
+
* · `write_protection` —— 一次被批准的编辑被限制链改写到了**没有任何审批覆盖**的写保护路径上;
|
|
1730
|
+
* · `ask_resolution` —— 这次 ask 的**结算本身**就是拒(有人说了不 / 窗到期 / 没人可问……),细节在
|
|
1731
|
+
* {@link GateOutcome.settlement}。
|
|
1732
|
+
* 🔴 **本词表在这条 wire 上是真闭集,所以类型也闭**(与 {@link McpFailureKind} 那种「只是眼下十个词」的开集
|
|
1733
|
+
* 不同,这条差别有出处):引擎的 `screenGateOutcome` 把「`deniedBy` 出闭集」列为记录**缺陷**,而 server 对
|
|
1734
|
+
* 有缺陷的记录是**整条不上帧**(report + withhold)。⇒ 一个词表外的 `deniedBy` **结构上到不了消费端** ——
|
|
1735
|
+
* 它到达的形式是 `gate` **整键缺席**,而不是一个陌生的词。给这里加一条 `(string & {})` 只会造出一个永远
|
|
1736
|
+
* 走不到的分支,同时把消费端本可以拿到的**编译期穷尽性**弄丢。
|
|
1737
|
+
* {@link Settlement} 的 `kind` 与 {@link GateOutcome.origin} 走同一只筛子,同样是这条纪律。
|
|
1738
|
+
*/
|
|
1739
|
+
export type DeniedBy = "policy" | "hook" | "org" | "classifier" | "plan_mode" | "compliance" | "write_protection" | "ask_resolution";
|
|
1740
|
+
/**
|
|
1741
|
+
* 这次门通过的**最终处置**:放行,或被哪一层拒。deny 臂**必须**点名那一层 —— 这正是它与 allow 臂
|
|
1742
|
+
* 在类型上分家的理由(「拒了但说不出谁拒的」写不出来)。
|
|
1743
|
+
*/
|
|
1744
|
+
export type GateDisposition = {
|
|
1745
|
+
kind: "allowed";
|
|
1746
|
+
} | {
|
|
1747
|
+
kind: "denied";
|
|
1748
|
+
deniedBy: DeniedBy;
|
|
1749
|
+
};
|
|
1750
|
+
/**
|
|
1751
|
+
* 一只 ask 在等的那次等待**怎么结束的** —— 按 `kind` 判别的联合(core 7.6.0 `SETTLEMENT_KINDS`,闭十二词)。
|
|
1752
|
+
*
|
|
1753
|
+
* 🔴 它**刻意不是** `kind × who` 的自由积:自由积表达得出「human_allowed,由引擎的窗结束」——一条结构完整
|
|
1754
|
+
* 却自相矛盾的记录,而消费端随后就得自己记住这张配对表。这里 `who` 的形**由词决定**:两个 human 词带人,
|
|
1755
|
+
* 两条窗词说是谁的窗,park 词说是宿主,fail-closed 那一族谁也不是。
|
|
1756
|
+
* 🔴 **单铸律**:每一个词都由**引擎**在那次等待结束的地方铸出来。宿主永不铸词,只报**事实**(同步 approver
|
|
1757
|
+
* 报 `human`/`timeout`,耐久 decide 报 `decidedBy: "person" | "sla_timeout"`),core 据此铸词。
|
|
1758
|
+
* ⚠️ server 侧投影:`who.approver`(宿主派生的身份串)与 `note`(拒批人自己写的自由文本)在上 wire 前
|
|
1759
|
+
* 都过脱敏,`note` 另有长度上界。
|
|
1760
|
+
*/
|
|
1761
|
+
export type Settlement = {
|
|
1762
|
+
/** 人(或代他行事的 approver)做了决定;`human_refused` 可带决策者自己写的那句话。 */
|
|
1763
|
+
kind: "human_allowed" | "human_refused";
|
|
1764
|
+
who: {
|
|
1765
|
+
party: "person";
|
|
1766
|
+
approver?: string;
|
|
1767
|
+
};
|
|
1768
|
+
/** epoch ms,写在结算发生的那一处。 */
|
|
1769
|
+
when: number;
|
|
1770
|
+
/** 拒批人附的那句话。**没有 note 的拒 = 一句干脆的「不」**,不是「没说理由的 bug」。 */
|
|
1771
|
+
note?: string;
|
|
1772
|
+
} | {
|
|
1773
|
+
/** 审批窗走完了没人答:引擎自己的审批工厂窗,或同步宿主 approver 报「我的窗到了」。 */
|
|
1774
|
+
kind: "approval_window_expired";
|
|
1775
|
+
who: {
|
|
1776
|
+
party: "engine";
|
|
1777
|
+
window: "approval_factory";
|
|
1778
|
+
} | {
|
|
1779
|
+
party: "host";
|
|
1780
|
+
};
|
|
1781
|
+
when: number;
|
|
1782
|
+
} | {
|
|
1783
|
+
/** 分类器拒绝上限回落的自动拒窗(core 在同步腿上自己的计时器)走完了没人答。 */
|
|
1784
|
+
kind: "denial_limit_window_expired";
|
|
1785
|
+
who: {
|
|
1786
|
+
party: "engine";
|
|
1787
|
+
window: "denial_limit";
|
|
1788
|
+
};
|
|
1789
|
+
when: number;
|
|
1790
|
+
} | {
|
|
1791
|
+
/** 一次**耐久 park** 的 SLA 到期,宿主的扫把它判成拒。店的 `expire`/`reap` 不产 `tool_end`,
|
|
1792
|
+
* 因此也不产结算。 */
|
|
1793
|
+
kind: "park_sla_expired";
|
|
1794
|
+
who: {
|
|
1795
|
+
party: "host";
|
|
1796
|
+
approver?: string;
|
|
1797
|
+
};
|
|
1798
|
+
when: number;
|
|
1799
|
+
} | {
|
|
1800
|
+
/** fail-closed 一族 —— 结束这次等待的不是某个人,是处境本身。
|
|
1801
|
+
* `no_approver`(headless:没接 approver / 问答面,或就是拒的姿态串)/ `approver_unavailable`
|
|
1802
|
+
* (approver 对**路由**问题答了「没人可达」,且没有 park 接住)/ `approver_error`(它抛了)/
|
|
1803
|
+
* `approver_contract`(它答在契约之外)/ `presentation_failed`(参数或编辑没法安全呈现/采纳)/
|
|
1804
|
+
* `blanket_allow_refused`(整体放行撞上 `requiresRealApproval` 的 ask)/ `task_aborted`
|
|
1805
|
+
* (等待的中止信号结束了它)。 */
|
|
1806
|
+
kind: "no_approver" | "approver_unavailable" | "approver_error" | "approver_contract" | "presentation_failed" | "blanket_allow_refused" | "task_aborted";
|
|
1807
|
+
who: {
|
|
1808
|
+
party: "none";
|
|
1809
|
+
};
|
|
1810
|
+
when: number;
|
|
1811
|
+
};
|
|
1812
|
+
/**
|
|
1813
|
+
* 🔴 **BREAKING(server ≥ 7.64.0,core 7.6.0 design/390 S6-A)—— 一次工具门通过的整条记录。**
|
|
1814
|
+
*
|
|
1815
|
+
* 它取代了 7.63.0 及以前的四个正交词(`settledBy` / `resolution` / `autoDenied` / `approver`,**四键全删,
|
|
1816
|
+
* 无 alias**):那四个词的配对规则只活在注释里,消费端要靠**缺席**推语义(「有 `timeout` 没有 `resolution`
|
|
1817
|
+
* ⇒ 耐久 park 过期」)。现在配对规则是引擎的四条不变量,判据是引擎的一只筛子。
|
|
1818
|
+
*
|
|
1819
|
+
* **铸一次,投三面**(门的出口;耐久 park 走 decide 车道)—— `permissionDenied` 观察者的载荷、这次调用的
|
|
1820
|
+
* `tool_end` 帧、耐久行的 resolved outcome。三面是同一张对象图,所以讲不出三个故事。
|
|
1821
|
+
*
|
|
1822
|
+
* 三个成员正交,但被引擎的四条不变量绑住:
|
|
1823
|
+
* · **I1** `settlement` 在场 ⇔ `origin` 在场(它们说的是同一只 ask);
|
|
1824
|
+
* · **I2** `deniedBy === "ask_resolution"` ⇒ `settlement` 在场且是拒绝类词;
|
|
1825
|
+
* · **I3** `human_allowed` 结算旁边出现 `denied` 处置 ⇒ 那是**人批了之后的复查**否决,`deniedBy` 必是可否决层
|
|
1826
|
+
* (`policy` / `hook` / `org` / `write_protection`),而 approver 留在结算上(这不是 approver 的拒);
|
|
1827
|
+
* · **I4** `allowed` 处置 ⇒ `settlement` 缺席或恰是 `human_allowed`。
|
|
1828
|
+
*
|
|
1829
|
+
* 🔴 **没有任何一项从缺席读出来**:普通放行是 `{ disposition: { kind: "allowed" } }`,直接策略拒是
|
|
1830
|
+
* `{ disposition: { kind: "denied", deniedBy: "policy" } }`,两者都不带结算 —— 因为两者都没结算过什么。
|
|
1831
|
+
* 🔴 **server 对过不了引擎不变量筛的记录整条不投**(report + withhold,计数 `server.trace.gate-outcome-defective`),
|
|
1832
|
+
* 所以「本该有 `gate` 却缺席」除了「门没看见这次调用」(未武装的门 / 延后重发 / reconcile 捡回的孤儿)之外
|
|
1833
|
+
* 还有第四种成因:那条记录坏了。四者在 wire 上不可分辨 ⇒ 一律退回 `isError` + 文案。
|
|
1834
|
+
*/
|
|
1835
|
+
export interface GateOutcome {
|
|
1836
|
+
disposition: GateDisposition;
|
|
1837
|
+
/** 只在**这次通过真的结算了一只 ask** 时在场。与 {@link origin} 同在同缺(I1)。 */
|
|
1838
|
+
settlement?: Settlement;
|
|
1839
|
+
/** 谁**问**的。与 {@link settlement} 同在同缺(I1)。 */
|
|
1840
|
+
origin?: AskOrigin;
|
|
1841
|
+
}
|
|
1842
|
+
/**
|
|
1843
|
+
* 一次失败的 MCP 请求**到没到那台服务器**(core 7.6.0 `MCP_DELIVERY_VERDICTS`,闭三词)。
|
|
1844
|
+
* · `yes` —— 服务器答了(`protocol` 型拒绝本身就证明交换发生过);
|
|
1845
|
+
* · `no` —— **可证**没发出去(connect 相 errno / spawn 失败 / 声明畸形 / 已知死掉的服务器)⇒ 直接重试或
|
|
1846
|
+
* 放弃都安全,什么都没执行;
|
|
1847
|
+
* · `unknown` —— 客户端在交换中途不等了或丢了管道(超时 / 在飞关闭 / reset / 前置网关给的 HTTP 状态)⇒
|
|
1848
|
+
* 请求**可能**已经执行,带写副作用的工具必须先核实再重试。
|
|
1849
|
+
*
|
|
1850
|
+
* 🔴 **与 `errorCode` 合读,别单读**:同一个 `connection_closed`,`no` 可以直接重试、`unknown` 必须先去查 ——
|
|
1851
|
+
* 这正是判词自成一格、不折进失败类的理由。
|
|
1852
|
+
* ⚠️ `no` 说的是**调用方的工具调用**没发出去,**不**保证「那台服务器一个字节都没收到」(dial 期的
|
|
1853
|
+
* elicitation 可能已经跨过连接)—— core 的契约原话,逐字透传。
|
|
1854
|
+
*/
|
|
1855
|
+
export type McpDelivered = "yes" | "no" | "unknown";
|
|
1856
|
+
/**
|
|
1857
|
+
* MCP 失败的**类**(core 7.6.0 `MCP_FAILURE_KINDS`,闭十词)—— `tool_end.errorCode` 与
|
|
1858
|
+
* `wiring_manifest.mcp[].errorCode` 上 MCP 那一族的取值。
|
|
1859
|
+
* `connect_refused`(连接相 errno:请求**可证**从未离开)/ `connection_failed`(其他 errno:可能跑过了)/
|
|
1860
|
+
* `connection_closed`(SDK 报传输已关:在飞时命运不可知,对已知死掉的服务器则从未尝试——两者靠
|
|
1861
|
+
* {@link McpDelivered} 分辨)/ `http_status`(HTTP 端点回了状态而不是 MCP 响应;数字在 `httpStatus`)/
|
|
1862
|
+
* `not_mcp_response` / `spawn_failed`(stdio 子进程起不来)/ `timeout` / `protocol`(服务器**答**了一个
|
|
1863
|
+
* MCP/JSON-RPC 错:交换发生过)/ `invalid_config`(声明本身拨不出去 —— 要改 spec,不是等它恢复)/ `unknown`。
|
|
1864
|
+
* 🔴 core 7.6.0 起**退役** `MCP_FAILURE_CODES` 那张十词表,`network` 与 `http_<status>` **两种拼法一并作废**
|
|
1865
|
+
* (HTTP 状态从此走结构位 `httpStatus`,不再编进码里)。
|
|
1866
|
+
* 🔴 `tool_end.errorCode` 整体仍是**开集**(词表属主是工具);本类型只描述其中 MCP 这一族,按开集读。
|
|
1867
|
+
*/
|
|
1868
|
+
export type McpFailureKind = "connect_refused" | "connection_failed" | "connection_closed" | "http_status" | "not_mcp_response" | "spawn_failed" | "timeout" | "protocol" | "invalid_config" | "unknown" | (string & {});
|
|
1597
1869
|
/** Open set — render unknown types generically, never crash.
|
|
1598
1870
|
*
|
|
1599
1871
|
* design/99 §E1/§E2 (SHIPPED, service `TraceBlock`/`projectEvents` project.ts:69-73,160-165): the action-card
|
|
@@ -1630,16 +1902,18 @@ export type TraceBlock = {
|
|
|
1630
1902
|
/** `label` 同 `tool-call`(`toolResultFieldsOf`,`trace/project.ts:603`);`totalChars` = **截断前的可信总量**
|
|
1631
1903
|
* (core 1.442 / RB-210,`:604`)—— `truncated:true` 时「还剩多少没显示」= `totalChars` 减已渲染长度。
|
|
1632
1904
|
* 与 `honest-absence-not-fabricated-zero` 同族:缺席 = 旧 core / 未截断场景,**不要当 0 读**。 */
|
|
1633
|
-
/**
|
|
1634
|
-
* `
|
|
1635
|
-
*
|
|
1636
|
-
*
|
|
1637
|
-
* 🔴
|
|
1638
|
-
*
|
|
1905
|
+
/** 🔴 **server ≥7.64.0 BREAKING**:`gate` = 这次调用**整条门记录**({@link GateOutcome})—— 它取代了退役的
|
|
1906
|
+
* 四个正交词 `settledBy` / `resolution` / `autoDenied` / `approver`(四键全删,无 alias)。与
|
|
1907
|
+
* `AgentEvent.tool_end.gate` **同一个值**:server 的共享挑键器 `toolResultFieldsOf` 把它同时喂给 turns 面
|
|
1908
|
+
* 与 SSE 面,所以三处同形(历史教训:此前只补 tool_end、两条 trace 面漏声明 = 运行时给了值、类型上拿不到)。
|
|
1909
|
+
* 🔴 **读腿是独立的一道筛**:账本行可以来自任何引擎世代或第三方 producer,所以坏记录在读面同样被扣下 ——
|
|
1910
|
+
* 缺席不是关于这次调用的事实。
|
|
1911
|
+
* `delivered` = MCP 投递判词({@link McpDelivered}),与 `errorCode` **合读**;非 MCP 失败上恒缺席。
|
|
1912
|
+
* `gatedCallId` = 耐久 park 正扣着哪个 call(core ≥5.55.0);tool-less park 上缺席。 */
|
|
1639
1913
|
/** `errorCode` = core ≥5.9.0(W3 / [2535],#191 件三补):这次调用**为什么失败**的机器可判别短码。
|
|
1640
1914
|
* 与 `AgentEvent.tool_end.errorCode` **同一个值**(server 的共享挑键器 `toolResultFieldsOf` 同时喂 turns 面
|
|
1641
1915
|
* 与 SSE 面),完整语义见那一处的长注。
|
|
1642
|
-
* 🔴
|
|
1916
|
+
* 🔴 **开集**:词表属主在**工具**那一侧,任意 `ToolResult.details.code`
|
|
1643
1917
|
* 都可能到达 —— 分支已知值、永远带 `default`。与 HTTP 错误体上的 `errorCode` 是两个不同的命名空间,只是
|
|
1644
1918
|
* 同名;**两者都可增补**,差别在属主与兜底手段(HTTP 那张属 server、按前缀/状态码兜底;本键属工具、
|
|
1645
1919
|
* 只能靠 `default`)—— 完整口径见 `AgentEvent.tool_end.errorCode` 的长注。 */
|
|
@@ -1652,7 +1926,9 @@ export type TraceBlock = {
|
|
|
1652
1926
|
truncated?: boolean;
|
|
1653
1927
|
totalChars?: number;
|
|
1654
1928
|
structured?: unknown;
|
|
1655
|
-
|
|
1929
|
+
gate?: GateOutcome;
|
|
1930
|
+
delivered?: McpDelivered;
|
|
1931
|
+
gatedCallId?: string;
|
|
1656
1932
|
errorCode?: string;
|
|
1657
1933
|
eventId?: string;
|
|
1658
1934
|
parentToolCallId?: string;
|
|
@@ -1750,7 +2026,9 @@ export type TraceStreamEvent = {
|
|
|
1750
2026
|
truncated?: boolean;
|
|
1751
2027
|
totalChars?: number;
|
|
1752
2028
|
structured?: unknown;
|
|
1753
|
-
|
|
2029
|
+
gate?: GateOutcome;
|
|
2030
|
+
delivered?: McpDelivered;
|
|
2031
|
+
gatedCallId?: string;
|
|
1754
2032
|
errorCode?: string;
|
|
1755
2033
|
eventId?: string;
|
|
1756
2034
|
parentToolCallId?: string;
|
|
@@ -2580,6 +2858,51 @@ export interface Capabilities {
|
|
|
2580
2858
|
denial: "entitlement_resolver_absent" | (string & {}) | null;
|
|
2581
2859
|
[k: string]: unknown;
|
|
2582
2860
|
};
|
|
2861
|
+
/** **写保护名表**的姿态(server ≥7.63.0 / S-138;`routes/capabilities.ts` = `projectWriteProtectionCapability`)。
|
|
2862
|
+
* 引擎的**字面名表**把落在表行上的可定路径写(Write/Edit/NotebookEdit)从 `allow` 降级成 `ask`,所以壳
|
|
2863
|
+
* 可以**事先**知道这些路径会弹卡。
|
|
2864
|
+
* 🔴 **三项刻意不合成一个布尔**:合成之后「引擎缺省表在岗」与「运维换了一张自己的表」同为 true,而两者
|
|
2865
|
+
* 对运维说的是两件事。
|
|
2866
|
+
* 🔴 **最小披露**:逐行 name/kind **不在**这一位 —— 部署自定义行可能含内部路径名,列出来等于告诉想绕过的人
|
|
2867
|
+
* 「哪些名字不受保护」。行内容在 operator 面 `GET /v1/diagnostics/wiring` 的 `writeProtection.rows`。
|
|
2868
|
+
* 🔴 与 `SENSITIVE_WRITE_PATTERNS`(**模式型** write deny)是**并列机制**,两个读面分开报、绝不合成一位:
|
|
2869
|
+
* 两者的解法不同(一套改模式,一套改名表)。
|
|
2870
|
+
* `null` = 这个进程说不出来(非 composition root 装配的夹具形)。**老 worker 上整键缺席,而「没有这个键」
|
|
2871
|
+
* 不是「没有表」** —— 引擎侧座位缺席恰恰是**缺省表在岗**(按键名 grep 推断「没装」会推错,B-023 F2 真案)。 */
|
|
2872
|
+
writeProtection?: WriteProtectionCapability | null;
|
|
2873
|
+
[k: string]: unknown;
|
|
2874
|
+
}
|
|
2875
|
+
/** 写保护名表的**租户面**窄投影(`GET /v1/capabilities.writeProtection`)。**不含行内容**。 */
|
|
2876
|
+
export interface WriteProtectionCapability {
|
|
2877
|
+
/** 生效表非空 ⇒ 引擎真会对表行弹卡。 */
|
|
2878
|
+
armed: boolean;
|
|
2879
|
+
/** 生效表的**行数**(内容只上 operator 面)。 */
|
|
2880
|
+
rows: number;
|
|
2881
|
+
/** 整表替换旋钮被写 ⇒ 缺省表不再原样在岗。与 {@link armed} 刻意不合成。
|
|
2882
|
+
* ⚠️ 「整表替换成**空**表」也算 —— 报 false 会把「运维亲手关掉了表」说成「缺省表没被动过」。 */
|
|
2883
|
+
replaced: boolean;
|
|
2884
|
+
[k: string]: unknown;
|
|
2885
|
+
}
|
|
2886
|
+
/** 写保护表的**一行**(core `WriteProtectedRow`):一个**字面**名字 + 它怎么匹配。
|
|
2887
|
+
* `name` 同时是这一行的稳定身份 —— 拒绝/询问文案里引用的就是这个串。 */
|
|
2888
|
+
export interface WriteProtectedRow {
|
|
2889
|
+
name: string;
|
|
2890
|
+
/** `basename` = 目标的**最后一段**等于行名;`segment` = **任意**一段等于行名;
|
|
2891
|
+
* `segment-run` = **连续若干段**等于行名按 `/` 切出的那几段。 */
|
|
2892
|
+
kind: "basename" | "segment" | "segment-run" | (string & {});
|
|
2893
|
+
[k: string]: unknown;
|
|
2894
|
+
}
|
|
2895
|
+
/** 写保护表的 **operator 面**(`GET /v1/diagnostics/wiring` 的 `writeProtection`;server ≥7.63.0 / S-138)。
|
|
2896
|
+
* 与租户面能力位**同一份 boot 产物** ⇒ 两面不可能各说各话;本面多出来的是**行内容**。 */
|
|
2897
|
+
export interface WriteProtectionPosture {
|
|
2898
|
+
/** 生效表逐行,逐字来自引擎自己的编译产物(server 零重算)。空数组 = 显式无表。 */
|
|
2899
|
+
rows: WriteProtectedRow[];
|
|
2900
|
+
/** `default` = 两根旋钮都没写(引擎缺省表在岗;server **不复制**那张表,属主在引擎)/ `extra` = 缺省表 + 增量 /
|
|
2901
|
+
* `replace` = 整表替换 / `off` = 整表替换成空表(合法,且响亮)。 */
|
|
2902
|
+
source: "default" | "extra" | "replace" | "off" | (string & {});
|
|
2903
|
+
/** 整表替换**丢掉**的缺省行名;只在替换族在场(`extra`/`default` 结构上丢不掉行)。
|
|
2904
|
+
* 行的身份判据借**引擎自己**的折叠规则,所以大小写变体不会被误报成「你丢了一行」。 */
|
|
2905
|
+
droppedDefaultRows?: string[];
|
|
2583
2906
|
[k: string]: unknown;
|
|
2584
2907
|
}
|
|
2585
2908
|
/** One scenario's detail card (`GET /v1/capabilities/scenarios/:name` — server handler = the
|
|
@@ -3358,6 +3681,25 @@ export interface ServerWiringGates {
|
|
|
3358
3681
|
export interface WiringDiagnostics {
|
|
3359
3682
|
static: WiringManifest;
|
|
3360
3683
|
serverGates: ServerWiringGates;
|
|
3684
|
+
/** **写保护名表**,带**行内容**(server ≥7.63.0 / S-138;operator 面独有 —— 租户面
|
|
3685
|
+
* `capabilities.writeProtection` 只有计数)。与那一位是**同一份 boot 产物**。
|
|
3686
|
+
* `null` = 这个进程说不出来。 */
|
|
3687
|
+
writeProtection?: WriteProtectionPosture | null;
|
|
3688
|
+
/** 记忆面姿态(server ≥7.30 / #252):backend / vector 模式 / 点亮态与 dark 成因 / embedder 身份 ——
|
|
3689
|
+
* 此前只活在启动日志里(不可查询、跨副本不可聚合)。
|
|
3690
|
+
* 🔴 **本代 SDK 尚未逐键镜像**:声明在这里是为了让严格消费端停止拒收真实的 operator 响应,按不透明读。 */
|
|
3691
|
+
memoryPosture?: Record<string, unknown> | null;
|
|
3692
|
+
/** 本部署的 SQL 引擎姿态(server ≥7.60 / S-131):引擎 / 版本 / 会话隔离级 / TiDB 事务模式,读的是驱动在
|
|
3693
|
+
* 真连接上 `SET` 完之后**回读**的值,不是 env 里写了什么。`null` = 无 SQL 后端。
|
|
3694
|
+
* 🔴 **本代 SDK 尚未逐键镜像** —— 按不透明读。 */
|
|
3695
|
+
sqlEngine?: Record<string, unknown> | null;
|
|
3696
|
+
/** 配置世代账的 operator 面(server ≥7.5x / #322):按组的 appliedVersion / deferredKeys+铸因 /
|
|
3697
|
+
* **消毒形** lastRejected(只有键名与判据文案,值从不进读面)。`/health` 那三键是同一份读数的窄投影。
|
|
3698
|
+
* 🔴 **本代 SDK 尚未逐键镜像** —— 按不透明读。 */
|
|
3699
|
+
configApply?: Record<string, unknown> | null;
|
|
3700
|
+
/** mid-turn MCP 撤销名单(server ≥7.5x / #324,design/338)。`null` = 本进程没有配置管道(说不出来)。
|
|
3701
|
+
* 🔴 **本代 SDK 尚未逐键镜像** —— 按不透明读。 */
|
|
3702
|
+
mcpRevocations?: Record<string, unknown> | null;
|
|
3361
3703
|
}
|
|
3362
3704
|
export {};
|
|
3363
3705
|
//# sourceMappingURL=types.d.ts.map
|