@farukada/langchain-ts-rms 0.1.0

package/dist/app/governance/guardrails.js

@@ -0,0 +1,68 @@
+/**
+ * Research guardrails: policy enforcement for research queries.
+ *
+ * Mirrors GMS's governance/guardrails.ts pattern but adapted for
+ * research operations (subject filtering, result count limits, HITL gating).
+ */
+/**
+ * Default forbidden patterns (case-insensitive) that block research queries.
+ * These prevent the system from searching for harmful or inappropriate content.
+ */
+export const DEFAULT_FORBIDDEN_PATTERNS = [
+    "how to hack",
+    "exploit vulnerability",
+    "bypass security",
+    "create malware",
+    "illegal drugs",
+    "weapons manufacturing",
+    "personal information",
+    "doxxing",
+];
+/** Default maximum search result count before requiring human approval. */
+export const DEFAULT_MAX_SEARCH_COUNT = 50;
+/** Default threshold for low-confidence summarizations that trigger review. */
+export const DEFAULT_MIN_CONFIDENCE = 0.3;
+/**
+ * Policy guardrail: checks a research subject against forbidden patterns.
+ * Returns { allowed: false, reason } if the subject violates policy.
+ */
+export function checkGuardrail(subject, options = {}) {
+    const patterns = options.forbiddenPatterns ?? DEFAULT_FORBIDDEN_PATTERNS;
+    const lowerSubject = subject.toLowerCase();
+    for (const pattern of patterns) {
+        if (lowerSubject.includes(pattern.toLowerCase())) {
+            return {
+                allowed: false,
+                reason: `Research subject violates policy: "${pattern}" detected in "${subject}"`,
+            };
+        }
+    }
+    return { allowed: true };
+}
+/**
+ * Determines if a research operation requires human approval.
+ * Triggers on high result counts or low confidence scores.
+ */
+export function requiresHumanApproval(resultCount, confidenceScore, options = {}) {
+    const maxCount = options.maxSearchCount ?? DEFAULT_MAX_SEARCH_COUNT;
+    if (resultCount > maxCount)
+        return true;
+    if (confidenceScore !== undefined) {
+        const minConf = options.minConfidence ?? DEFAULT_MIN_CONFIDENCE;
+        if (confidenceScore < minConf)
+            return true;
+    }
+    return false;
+}
+/**
+ * Evaluate both policy guardrails and human-approval requirements
+ * for a research operation.
+ */
+export function evaluateGuardrails(subject, resultCount, guardOpts = {}, approvalOpts = {}, confidenceScore) {
+    const check = checkGuardrail(subject, guardOpts);
+    const needsHumanApproval = check.allowed
+        ? requiresHumanApproval(resultCount, confidenceScore, approvalOpts)
+        : false;
+    return { check, needsHumanApproval };
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/app/governance/guardrails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.js","sourceRoot":"","sources":["../../../src/app/governance/guardrails.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,aAAa;IACb,uBAAuB;IACvB,iBAAiB;IACjB,gBAAgB;IAChB,eAAe;IACf,uBAAuB;IACvB,sBAAsB;IACtB,SAAS;CACV,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAgB1C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,UAA4B,EAAE;IAC5E,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;IACzE,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACjD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,sCAAsC,OAAO,kBAAkB,OAAO,GAAG;aAClF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,eAAwB,EACxB,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IACpE,IAAI,WAAW,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;QAChE,IAAI,eAAe,GAAG,OAAO;YAAE,OAAO,IAAI,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,WAAmB,EACnB,YAA8B,EAAE,EAChC,eAAqC,EAAE,EACvC,eAAwB;IAExB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO;QACtC,CAAC,CAAC,qBAAqB,CAAC,WAAW,EAAE,eAAe,EAAE,YAAY,CAAC;QACnE,CAAC,CAAC,KAAK,CAAC;IACV,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;AACvC,CAAC"}