@sofagent/rules 1.3.0 → 1.3.2

package/dist/approval-mode.d.ts

@@ -0,0 +1,24 @@
+/** 工具审批四模式 */
+export type ApprovalMode = 'allow-with-audit' | 'deny-all' | 'read-only' | 'always-ask';
+/** 审批判定结果 */
+export interface ApprovalResult {
+    /** 是否放行（false 时调用方应走人工确认或拒绝） */
+    allow: boolean;
+    /** 人类可读判定理由（写审计日志） */
+    reason: string;
+    /** 本次判定所用的模式 */
+    mode: ApprovalMode;
+}
+/**
+ * 按审批模式 + 工具权限判定是否放行。
+ *
+ * 注意：本函数只做「模式级」判定——read-only 遇 rw 工具、always-ask 遇任何工具
+ * 返回 allow:false + reason='待人工确认'，实际人工确认由 middleware 层
+ *（approvalCallback）执行；无回调时由 middleware 按保守默认拒绝处理。
+ *
+ * @param mode 审批模式
+ * @param permission 工具权限标记（'r' 只读 / 'rw' 读写）
+ * @returns ApprovalResult
+ */
+export declare function shouldApprove(mode: ApprovalMode, permission: 'r' | 'rw'): ApprovalResult;
+//# sourceMappingURL=approval-mode.d.ts.map

package/dist/approval-mode.js

@@ -0,0 +1,51 @@
+"use strict";
+// ============================================================
+// approval-mode.ts · 工具审批四模式（v1.3.2 交付 10）
+//
+// 设计来源：PenguinHarness CLI --approve 四模式
+//（allow-all / deny-all / read-only / always-ask）。
+//
+// 四种模式行为：
+//   allow-with-audit  全部放行 + 写审计日志（默认模式 = v1.3.2 行为，不破坏既有）
+//   deny-all          全部拦截（调试/安全演练）
+//   read-only         只读工具（permission='r'）自动放行，读写需人工确认（Benchmark 评测）
+//   always-ask        每次工具调用都问人（危险操作密集场景）
+//
+// 保守默认拒绝（安全铁律 #7）：需要人工确认的场景（read-only 遇 rw /
+// always-ask）若 SDK 未提供审批回调 → 默认拒绝一切，不是放行。
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldApprove = shouldApprove;
+/**
+ * 按审批模式 + 工具权限判定是否放行。
+ *
+ * 注意：本函数只做「模式级」判定——read-only 遇 rw 工具、always-ask 遇任何工具
+ * 返回 allow:false + reason='待人工确认'，实际人工确认由 middleware 层
+ *（approvalCallback）执行；无回调时由 middleware 按保守默认拒绝处理。
+ *
+ * @param mode 审批模式
+ * @param permission 工具权限标记（'r' 只读 / 'rw' 读写）
+ * @returns ApprovalResult
+ */
+function shouldApprove(mode, permission) {
+    switch (mode) {
+        case 'allow-with-audit':
+            return { allow: true, reason: '放行（审计日志已写）', mode };
+        case 'deny-all':
+            return { allow: false, reason: 'deny-all 模式拦截', mode };
+        case 'read-only':
+            if (permission === 'r') {
+                return { allow: true, reason: 'read-only 放行只读', mode };
+            }
+            return { allow: false, reason: 'read-only 拦截读写（待人工确认）', mode };
+        case 'always-ask':
+            // 需人工确认——交给 HITL 回调（middleware 层）
+            return { allow: false, reason: 'always-ask 待人工确认', mode };
+        default: {
+            // 未知模式 → 保守默认拒绝（安全铁律：宁可错杀不可放行）
+            const exhaustive = mode;
+            return { allow: false, reason: `未知审批模式 ${String(exhaustive)} → 保守拒绝`, mode };
+        }
+    }
+}
+//# sourceMappingURL=approval-mode.js.map

package/dist/engine.js

@@ -1,7 +1,7 @@
 "use strict";
 // ============================================================
 // engine.ts · RulesEngine 纯函数入口
-// v1.3.0：P3 编排引擎内嵌——规则引擎核心
+// v1.3.2：P3 编排引擎内嵌——规则引擎核心
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RulesEngine = void 0;

package/dist/index.d.ts

@@ -3,4 +3,6 @@ export type { ToolRule, ToolCallContext, InterceptVerdict, RuleStatus, RuleClass
 export { defaultToolRules } from './rules';
 export { shouldAllow } from './should-allow';
 export type { ShouldAllowResult } from './should-allow';
+export { shouldApprove } from './approval-mode';
+export type { ApprovalMode, ApprovalResult } from './approval-mode';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,15 +1,18 @@
 "use strict";
 // ============================================================
 // index.ts · @sofagent/rules barrel export
-// v1.3.0：只导出 5 个公开符号，内部实现不外露
+// v1.3.2：只导出 5 个公开符号，内部实现不外露
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldAllow = exports.defaultToolRules = exports.RulesEngine = void 0;
+exports.shouldApprove = exports.shouldAllow = exports.defaultToolRules = exports.RulesEngine = void 0;
 var engine_1 = require("./engine");
 Object.defineProperty(exports, "RulesEngine", { enumerable: true, get: function () { return engine_1.RulesEngine; } });
 var rules_1 = require("./rules");
 Object.defineProperty(exports, "defaultToolRules", { enumerable: true, get: function () { return rules_1.defaultToolRules; } });
-// v1.3.0 (交付 2)：tool-gate 便捷判定 API
+// v1.3.2 (交付 2)：tool-gate 便捷判定 API
 var should_allow_1 = require("./should-allow");
 Object.defineProperty(exports, "shouldAllow", { enumerable: true, get: function () { return should_allow_1.shouldAllow; } });
+// v1.3.2 (交付 10)：工具审批四模式
+var approval_mode_1 = require("./approval-mode");
+Object.defineProperty(exports, "shouldApprove", { enumerable: true, get: function () { return approval_mode_1.shouldApprove; } });
 //# sourceMappingURL=index.js.map

package/dist/rules/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // ============================================================
 // rules/index.ts · 默认规则注册表
-// v1.3.0：P3 编排引擎内嵌——默认 tool 规则集合
+// v1.3.2：P3 编排引擎内嵌——默认 tool 规则集合
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultToolRules = void 0;

package/dist/rules/tool-injection.js

@@ -1,7 +1,7 @@
 "use strict";
 // ============================================================
 // tool-injection.ts · 移植 audit rule-a9（prompt injection 检测）
-// v1.3.0：tool 视角——扫 args 里的 prompt injection 模式
+// v1.3.2：tool 视角——扫 args 里的 prompt injection 模式
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toolInjection = void 0;

package/dist/rules/tool-secret-leak.js

@@ -1,8 +1,8 @@
 "use strict";
 // ============================================================
 // tool-secret-leak.ts · 移植 audit rule-a2（密钥泄漏检测）
-// v1.3.0：tool 视角——扫 args 字面量里的密钥模式
-// v1.3.0 SECRET_PATTERNS 抽到 @sofagent/core 共享——此前本文件用严格
+// v1.3.2：tool 视角——扫 args 字面量里的密钥模式
+// v1.3.2 SECRET_PATTERNS 抽到 @sofagent/core 共享——此前本文件用严格
 //   48 位 sk- 模式导致 32-47 位密钥被 ToolGate 放行（与 A2 漂移互补成洞）。
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/rules/tool-sensitive-file.js

@@ -1,7 +1,7 @@
 "use strict";
 // ============================================================
 // tool-sensitive-file.ts · 移植 audit rule-a1（敏感文件保护）
-// v1.3.0：tool 视角——校验 args 里的文件路径
+// v1.3.2：tool 视角——校验 args 里的文件路径
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toolSensitiveFile = void 0;

package/dist/should-allow.js

@@ -1,6 +1,6 @@
 "use strict";
 // ============================================================
-// should-allow.ts · tool-gate 便捷 API（v1.3.0 交付 2）
+// should-allow.ts · tool-gate 便捷 API（v1.3.2 交付 2）
 //
 // shouldAllow()——编排层/运行时 wrapper 判定「本次工具调用是否放行」。
 // 聚合 RulesEngine.check + aggregate，并额外暴露 requireApproval：

package/dist/types.d.ts

@@ -33,6 +33,8 @@ export interface InterceptVerdict {
     suggestion: string;
     /** v1.3.0 新增：需要人工批准（HITL 挂起，交付 3 消费） */
     requireApproval?: boolean;
+    /** v1.3.1 交付 10：工具权限标记——'r' = 只读，'rw' = 读写（审批模式判定消费） */
+    permission?: 'r' | 'rw';
 }
 /**
  * Tool 视角规则接口

package/dist/types.js

@@ -1,7 +1,7 @@
 "use strict";
 // ============================================================
 // types.ts · P3 编排引擎内嵌——tool call 拦截器类型定义
-// v1.3.0：从 audit 规则抽出为纯函数，零 fs/git 依赖
+// v1.3.2：从 audit 规则抽出为纯函数，零 fs/git 依赖
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sofagent/rules",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "sofagent 规则引擎纯函数包——从 audit 抽出，零 fs/git 依赖，供编排引擎 tool call 事前拦截",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -28,6 +28,6 @@
     "README.md"
   ],
   "dependencies": {
-    "@sofagent/core": "1.3.0"
+    "@sofagent/core": "1.3.2"
   }
 }