New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

@sofagent/rules

Package Overview
Dependencies
Maintainers
1
Versions
41
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@sofagent/rules

sofagent 规则模块——从 audit 抽出,零 git 依赖,供编排模块 tool call 事前拦截;v1.3.9 起含官方 AST 规则引擎(sofagent-ruleset-ast,经临时文件驱动 TS 编译器,无仓库 fs 依赖)

npmnpm
Version
1.5.7
Version published
Weekly downloads
109
-88.69%
Maintainers
1
Weekly downloads
 
Created
Source

@sofagent/rules

sofagent 规则引擎纯函数包——从 audit 包抽出,零 fs/git 依赖,供编排模块 tool call 事前拦截。

安装

npm install @sofagent/rules

库包(无 CLI),随编排模块引用。Node.js 18+。

API

  • RulesEngine — 规则引擎类,接受规则集 + tool call context,返回拦截裁决
  • defaultToolRules — 默认规则集
  • InterceptVerdict / ToolCallContext / ToolRule — 核心类型定义

文档

  • 架构总览 — rules 在约束层中的位置
  • 使用手册(WIKI) — 面向 FDE 的完整用法

判定规则只有一个事实源

本包是 tool-level 触发时机的适配层,不独立维护规则正则在跨引擎共用规则定义(A1 敏感文件 / A2 密钥泄漏 / A9 注入)上,与 git-diff 审计引擎(engine/audit)共用 @sofagent/core 的同一套定义(shared/rule-definitions.ts 的身份目录 + shared/rule-patterns.ts 的检测正则)——两处 import 同一来源,而非各写一份结构相同的定义。

纪律外延:判定规则只有一个事实源。企业侧若另建判定点(自建模型网关 / 代理做流量侧 PII 过滤与敏感度分流),必须集成本引擎的同一套规则与检测器(经 v1.4.9 第八章检测器插槽嵌入组件),不得另起一套——每多一处独立实现,就是一次口径分裂风险。

v1.5.2:网络出口治理面——host 白名单声明面(默认空全拒 opt-in)+ 裁决事件契约可导出(判定底座消费源)。

Keywords

rules-engine

FAQs

Package last updated on 08 Oct 2026

Related posts