@sema-agent/server 7.43.0 → 7.44.0

package/dist/tool-approval.d.ts

@@ -327,12 +327,36 @@ export type RuleRefusalReason = Extract<CardRulePersisted, {
  *  这个说的是「规则车道好好的,只是**这一只** ask 归 operator 管」—— 折成同一个词会让壳把一台正常
  *  部署整条车道判死。 */
  | "rule_governance_forced";
+/**
+ * #340([4763])—— `persistRule` 的**两个显式臂**在 wire 上的解析产物。
+ *
+ * `edited` 是判别位而不是「一个可选的第二字段」:候选臂的 `rule` 是**卡上那条候选的逐字文本**(定位键),
+ * 编辑臂的 `rule` 是**人自己写的规则**。同一个字段两种含义,判别位必须显式带在同一个对象上。
+ */
+export interface ParsedPersistRule {
+    readonly rule: string;
+    readonly edited: boolean;
+}
+/** #340:`persistRule.rule` 的形/上限拒句(wire 可见文案的**唯一**成形口 —— 冻结在
+ *  `test/api-error-text-freeze.test.ts` 的常量锚格,与 `src/http/` 桶里的 `sendError` 站点同纪律)。 */
+export declare const PERSIST_RULE_TEXT_ERROR = "persistRule.rule must be a non-empty string of at most 512 characters";
+/** #340:`persistRule.edited` 的形拒句。非 boolean **绝不静默当 false** —— 那会把一次「我要落自由文本」
+ *  悄悄折回候选臂,回来一句 `rule_not_offered`,而人以为自己写的规则被拒了。 */
+export declare const PERSIST_RULE_EDITED_FLAG_ERROR = "persistRule.edited must be a boolean when present";
+/**
+ * #340 定界5:回决体**不收 scope**。
+ *
+ * 规则落在哪个 scope 由 server 从**授权发生地**自铸(`ruleScopeRootFor` 在铸卡时咨询一次)。让携带方
+ * 指定 scope = 让一次「在项目 A 里点的同意」写成一条覆盖项目 B(或全局)的常驻放行 —— 那是这条轴上
+ * 最贵的一次扩权。静默忽略同样不行:客户端会以为自己设上了。响亮拒,一句话说清谁拥有这一格。
+ */
+export declare const PERSIST_RULE_SCOPE_REFUSED = "this endpoint does not accept a rule scope \u2014 the server mints it from where the approval happened (send neither `scope` nor `persistRule.scope`)";
 /** Validate the respond body — the closed three-choice enum (rationale in the module header). */
 export declare function parseToolApprovalResponse(body: unknown): {
     ok: true;
     value: ToolApprovalDecision;
     updatedInput?: unknown;
-    persistRule?: string;
+    persistRule?: ParsedPersistRule;
     note?: string;
 } | {
     ok: false;
@@ -858,6 +882,9 @@ export declare class ToolApprovalCoordinator {
         status: number;
         body: unknown;
     }>;
+    /** #340:回执上两个新键的**唯一**成形口 —— 只在这次请求真的走了**自由文本臂**时铸。
+     *  候选臂的回执因此逐字节不变(老壳按固定键集解析,多一个键就是一次没人要的 wire 变更)。 */
+    private editedArmEcho;
     /** #329:`tool_approval.not_pending` 的**唯一**成形口。文案逐字不变(存量壳/SDK 按它认这条 404),
      *  只 additive 加判别位;`cause` 缺席 = 这台部署没有行可判(D1 无店)或行形不可信(见各调用点)。 */
     private notPending;