@governed-ai/runtime 1.0.0

package/dist/src/orchestrator.js

@@ -0,0 +1,355 @@
+export async function runGovernance(query, context, llmCall, config, domain, sessionId) {
+    const activeDomain = domain ?? "health";
+    let sessionState = null;
+    if (config.stateManager && sessionId) {
+        sessionState = config.stateManager.getSessionState(sessionId);
+        if (!sessionState) {
+            sessionState = config.stateManager.createSession(sessionId, activeDomain);
+        }
+        config.stateManager.updateSessionState(sessionId, {
+            domain: activeDomain,
+            conversationEntry: {
+                timestamp: new Date().toISOString(),
+                role: "user",
+                content: query,
+                blocked: false,
+            },
+        });
+    }
+    const classification = config.queryClassifier.classify(query);
+    const preInteraction = await config.preInteractionGovernance.evaluate(query, context.sessionPatientId);
+    if (!preInteraction.allowed) {
+        const decisionRecord = {
+            timestamp: new Date().toISOString(),
+            query,
+            outcome: "pre_blocked",
+            blockedReason: preInteraction.blockedReason,
+            classification: preInteraction.classification,
+            domain: activeDomain,
+        };
+        config.governanceLogger.log({
+            timestamp: decisionRecord.timestamp,
+            query,
+            classification: preInteraction.classification,
+            preInteraction: {
+                allowed: false,
+                blockedReason: preInteraction.blockedReason,
+                entityFound: preInteraction.entityValidation.found,
+                patientId: preInteraction.entityValidation.patientId,
+            },
+            llmCalled: false,
+            llmResponseSummary: null,
+            postInteraction: null,
+            finalOutcome: "pre_blocked",
+            domain: activeDomain,
+            sessionId: sessionId ?? null,
+            retrievalConfidence: context.retrievalContext?.retrievalConfidence ?? null,
+        });
+        const safeResponse = preInteraction.safeResponse || "Request blocked by governance policy.";
+        if (config.stateManager && sessionId) {
+            config.stateManager.updateSessionState(sessionId, {
+                governanceDecision: decisionRecord,
+                conversationEntry: {
+                    timestamp: decisionRecord.timestamp,
+                    role: "governance",
+                    content: safeResponse,
+                    blocked: true,
+                },
+            });
+        }
+        return {
+            finalResponse: safeResponse,
+            blocked: true,
+            blockedStage: "pre_interaction",
+            blockedReason: preInteraction.blockedReason,
+            classification: preInteraction.classification,
+            preInteraction,
+            postInteraction: null,
+            normalization: null,
+            violations: [],
+            llmCalled: false,
+            domain: activeDomain,
+            sessionId: sessionId ?? null,
+            toolGuardResults: [],
+            traceValidation: null,
+        };
+    }
+    if (config.stateManager && sessionId && preInteraction.entityValidation.found) {
+        config.stateManager.updateSessionState(sessionId, {
+            entity: {
+                entityId: preInteraction.entityValidation.patientId,
+                entityName: preInteraction.entityValidation.patientName,
+            },
+        });
+    }
+    const toolGuardResults = [];
+    if (config.toolGuard && context.toolCalls && context.toolCalls.length > 0) {
+        for (const toolCall of context.toolCalls) {
+            const result = config.toolGuard.evaluate({
+                toolName: toolCall.toolName,
+                parameters: toolCall.parameters,
+                sessionId: sessionId,
+                domain: activeDomain,
+            });
+            toolGuardResults.push(result);
+        }
+        const blockedTools = toolGuardResults.filter((r) => !r.allowed);
+        if (blockedTools.length > 0) {
+            const blockedDescriptions = blockedTools
+                .map((t) => `[${t.toolName}] ${t.blockedReason}`)
+                .join("; ");
+            const decisionRecord = {
+                timestamp: new Date().toISOString(),
+                query,
+                outcome: "pre_blocked",
+                blockedReason: `Tool governance blocked: ${blockedDescriptions}`,
+                classification,
+                domain: activeDomain,
+            };
+            config.governanceLogger.log({
+                timestamp: decisionRecord.timestamp,
+                query,
+                classification,
+                preInteraction: {
+                    allowed: true,
+                    blockedReason: null,
+                    entityFound: preInteraction.entityValidation.found,
+                    patientId: preInteraction.entityValidation.patientId,
+                },
+                llmCalled: false,
+                llmResponseSummary: null,
+                postInteraction: null,
+                finalOutcome: "tool_blocked",
+                domain: activeDomain,
+                sessionId: sessionId ?? null,
+                toolGuardBlocked: blockedTools.length,
+                retrievalConfidence: context.retrievalContext?.retrievalConfidence ?? null,
+            });
+            const safeResponse = `Tool access blocked by governance policy. ${blockedTools.length} tool request(s) violated policy rules: ${blockedDescriptions}`;
+            if (config.stateManager && sessionId) {
+                config.stateManager.updateSessionState(sessionId, {
+                    governanceDecision: decisionRecord,
+                    conversationEntry: {
+                        timestamp: decisionRecord.timestamp,
+                        role: "governance",
+                        content: safeResponse,
+                        blocked: true,
+                    },
+                });
+            }
+            return {
+                finalResponse: safeResponse,
+                blocked: true,
+                blockedStage: "tool_guard",
+                blockedReason: decisionRecord.blockedReason,
+                classification,
+                preInteraction,
+                postInteraction: null,
+                normalization: null,
+                violations: [],
+                llmCalled: false,
+                domain: activeDomain,
+                sessionId: sessionId ?? null,
+                toolGuardResults,
+                traceValidation: null,
+            };
+        }
+    }
+    const llmResult = await llmCall(query, context);
+    let traceValidation = null;
+    if (config.traceValidator) {
+        traceValidation = config.traceValidator.validate({
+            query,
+            response: llmResult.response,
+            reasoning: llmResult.reasoning,
+            evidence: llmResult.evidence,
+            confidence: llmResult.confidence,
+            confidenceLabel: llmResult.confidenceLabel,
+            missingData: llmResult.missingData,
+        });
+        if (traceValidation.shouldBlock) {
+            const traceBlockReason = traceValidation.violations
+                .filter((v) => v.severity === "critical" || v.severity === "high")
+                .map((v) => v.description)
+                .join("; ");
+            const decisionRecord = {
+                timestamp: new Date().toISOString(),
+                query,
+                outcome: "post_blocked",
+                blockedReason: `Trace validation failed: ${traceBlockReason}`,
+                classification,
+                domain: activeDomain,
+            };
+            config.governanceLogger.log({
+                timestamp: decisionRecord.timestamp,
+                query,
+                classification,
+                preInteraction: {
+                    allowed: true,
+                    blockedReason: null,
+                    entityFound: preInteraction.entityValidation.found,
+                    patientId: preInteraction.entityValidation.patientId,
+                },
+                llmCalled: true,
+                llmResponseSummary: llmResult.response.substring(0, 120),
+                postInteraction: null,
+                finalOutcome: "trace_blocked",
+                domain: activeDomain,
+                sessionId: sessionId ?? null,
+                retrievalConfidence: context.retrievalContext?.retrievalConfidence ?? null,
+            });
+            const blockedResponse = "I'm unable to provide a reliable answer to this query. " +
+                "The response was blocked by trace validation due to reasoning integrity issues: " +
+                traceBlockReason +
+                ". Please consult a qualified professional for guidance.";
+            if (config.stateManager && sessionId) {
+                config.stateManager.updateSessionState(sessionId, {
+                    governanceDecision: decisionRecord,
+                    conversationEntry: {
+                        timestamp: decisionRecord.timestamp,
+                        role: "governance",
+                        content: blockedResponse,
+                        blocked: true,
+                    },
+                });
+            }
+            return {
+                finalResponse: blockedResponse,
+                blocked: true,
+                blockedStage: "trace_validation",
+                blockedReason: decisionRecord.blockedReason,
+                classification,
+                preInteraction,
+                postInteraction: null,
+                normalization: null,
+                violations: [],
+                llmCalled: true,
+                domain: activeDomain,
+                sessionId: sessionId ?? null,
+                toolGuardResults,
+                traceValidation,
+            };
+        }
+        llmResult.confidence = traceValidation.adjustedConfidence;
+        llmResult.confidenceLabel = traceValidation.adjustedConfidenceLabel;
+    }
+    const postInteraction = config.postInteractionGovernance.evaluate(query, llmResult.response, context.retrievalContext, classification.type);
+    if (!postInteraction.approved) {
+        const decisionRecord = {
+            timestamp: new Date().toISOString(),
+            query,
+            outcome: "post_blocked",
+            blockedReason: postInteraction.violations.map((v) => v.description).join("; "),
+            classification,
+            domain: activeDomain,
+        };
+        config.governanceLogger.log({
+            timestamp: decisionRecord.timestamp,
+            query,
+            classification,
+            preInteraction: {
+                allowed: true,
+                blockedReason: null,
+                entityFound: preInteraction.entityValidation.found,
+                patientId: preInteraction.entityValidation.patientId,
+            },
+            llmCalled: true,
+            llmResponseSummary: llmResult.response.substring(0, 120),
+            postInteraction: {
+                approved: false,
+                violations: postInteraction.violations,
+            },
+            finalOutcome: "post_blocked",
+            domain: activeDomain,
+            sessionId: sessionId ?? null,
+            retrievalConfidence: context.retrievalContext?.retrievalConfidence ?? null,
+        });
+        const blockedResponse = postInteraction.revisedResponse || "Response blocked by governance policy.";
+        if (config.stateManager && sessionId) {
+            config.stateManager.updateSessionState(sessionId, {
+                governanceDecision: decisionRecord,
+                conversationEntry: {
+                    timestamp: decisionRecord.timestamp,
+                    role: "governance",
+                    content: blockedResponse,
+                    blocked: true,
+                },
+            });
+        }
+        return {
+            finalResponse: blockedResponse,
+            blocked: true,
+            blockedStage: "post_interaction",
+            blockedReason: decisionRecord.blockedReason,
+            classification,
+            preInteraction,
+            postInteraction,
+            normalization: null,
+            violations: postInteraction.violations,
+            llmCalled: true,
+            domain: activeDomain,
+            sessionId: sessionId ?? null,
+            toolGuardResults,
+            traceValidation,
+        };
+    }
+    const normalized = config.responseNormalizer.normalize(llmResult, query, context.retrievalContext);
+    const finalResponse = postInteraction.revisedResponse || normalized.responseText;
+    const decisionRecord = {
+        timestamp: new Date().toISOString(),
+        query,
+        outcome: "allowed",
+        blockedReason: null,
+        classification,
+        domain: activeDomain,
+    };
+    config.governanceLogger.log({
+        timestamp: decisionRecord.timestamp,
+        query,
+        classification,
+        preInteraction: {
+            allowed: true,
+            blockedReason: null,
+            entityFound: preInteraction.entityValidation.found,
+            patientId: preInteraction.entityValidation.patientId,
+        },
+        llmCalled: true,
+        llmResponseSummary: llmResult.response.substring(0, 120),
+        postInteraction: {
+            approved: true,
+            violations: [],
+        },
+        finalOutcome: "allowed",
+        domain: activeDomain,
+        sessionId: sessionId ?? null,
+        retrievalConfidence: context.retrievalContext?.retrievalConfidence ?? null,
+    });
+    if (config.stateManager && sessionId) {
+        config.stateManager.updateSessionState(sessionId, {
+            governanceDecision: decisionRecord,
+            conversationEntry: {
+                timestamp: decisionRecord.timestamp,
+                role: "governance",
+                content: finalResponse,
+                blocked: false,
+            },
+        });
+    }
+    return {
+        finalResponse,
+        blocked: false,
+        blockedStage: null,
+        blockedReason: null,
+        classification,
+        preInteraction,
+        postInteraction,
+        normalization: normalized,
+        violations: [],
+        llmCalled: true,
+        domain: activeDomain,
+        sessionId: sessionId ?? null,
+        toolGuardResults,
+        traceValidation,
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/policy/index.d.ts

@@ -0,0 +1,3 @@
+export { PolicyEngine } from "./policy_engine";
+export type { IPolicyEngine, BlockedQueryPolicy, PrivacyRule, SafetyRule, PolicyDefinition, } from "./policy_engine";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/policy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/policy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/src/policy/index.js

@@ -0,0 +1,2 @@
+export { PolicyEngine } from "./policy_engine.js";
+//# sourceMappingURL=index.js.map

package/dist/src/policy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/policy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/policy/policy_engine.d.ts

@@ -0,0 +1,47 @@
+export interface BlockedQueryPolicy {
+    action: "block" | "warn";
+    response: string;
+}
+export interface PrivacyRule {
+    id: string;
+    description: string;
+    severity: "critical" | "high" | "medium" | "low";
+}
+export interface SafetyRule {
+    id: string;
+    description: string;
+    severity: "critical" | "high" | "medium" | "low";
+}
+export interface PolicyDefinition {
+    domain: string;
+    version: string;
+    blocked_query_types: Record<string, BlockedQueryPolicy>;
+    privacy_rules: PrivacyRule[];
+    safety_rules: SafetyRule[];
+}
+export interface IPolicyEngine {
+    getBlockedQueryTypes(): Record<string, BlockedQueryPolicy>;
+    getBlockedResponse(queryType: string): string | null;
+    isQueryTypeBlocked(queryType: string): boolean;
+    getPrivacyRules(): PrivacyRule[];
+    getSafetyRules(): SafetyRule[];
+    getPrivacyRulesBySeverity(severity: string): PrivacyRule[];
+    getSafetyRulesBySeverity(severity: string): SafetyRule[];
+    getDomain(): string;
+    getVersion(): string;
+}
+export declare class PolicyEngine implements IPolicyEngine {
+    private policy;
+    constructor(policyPathOrDefinition?: string | PolicyDefinition);
+    private validate;
+    getBlockedQueryTypes(): Record<string, BlockedQueryPolicy>;
+    getBlockedResponse(queryType: string): string | null;
+    isQueryTypeBlocked(queryType: string): boolean;
+    getPrivacyRules(): PrivacyRule[];
+    getSafetyRules(): SafetyRule[];
+    getPrivacyRulesBySeverity(severity: string): PrivacyRule[];
+    getSafetyRulesBySeverity(severity: string): SafetyRule[];
+    getDomain(): string;
+    getVersion(): string;
+}
+//# sourceMappingURL=policy_engine.d.ts.map

package/dist/src/policy/policy_engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy_engine.d.ts","sourceRoot":"","sources":["../../../src/policy/policy_engine.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAClD;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACxD,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,eAAe,IAAI,WAAW,EAAE,CAAC;IACjC,cAAc,IAAI,UAAU,EAAE,CAAC;IAC/B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAAC;IAC3D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IACzD,SAAS,IAAI,MAAM,CAAC;IACpB,UAAU,IAAI,MAAM,CAAC;CACtB;AAQD,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,MAAM,CAAmB;gBAErB,sBAAsB,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAW9D,OAAO,CAAC,QAAQ;IAiDhB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAI1D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMpD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAK9C,eAAe,IAAI,WAAW,EAAE;IAIhC,cAAc,IAAI,UAAU,EAAE;IAI9B,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAI1D,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAIxD,SAAS,IAAI,MAAM;IAInB,UAAU,IAAI,MAAM;CAGrB"}

package/dist/src/policy/policy_engine.js

@@ -0,0 +1,100 @@
+import { readFileSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { parse as parseYaml } from "yaml";
+const currentDir = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_POLICY_PATH = resolve(currentDir, "../../config/policies.yaml");
+export class PolicyEngine {
+    policy;
+    constructor(policyPathOrDefinition) {
+        if (typeof policyPathOrDefinition === "object" && policyPathOrDefinition !== null) {
+            this.policy = this.validate(policyPathOrDefinition);
+        }
+        else {
+            const filePath = policyPathOrDefinition ?? DEFAULT_POLICY_PATH;
+            const raw = readFileSync(filePath, "utf-8");
+            const parsed = parseYaml(raw);
+            this.policy = this.validate(parsed);
+        }
+    }
+    validate(raw) {
+        if (!raw || typeof raw !== "object") {
+            throw new Error("Policy file must be a YAML object");
+        }
+        if (typeof raw.domain !== "string" || raw.domain.length === 0) {
+            throw new Error("Policy must define a 'domain' string");
+        }
+        if (typeof raw.version !== "string" || raw.version.length === 0) {
+            throw new Error("Policy must define a 'version' string");
+        }
+        if (!raw.blocked_query_types || typeof raw.blocked_query_types !== "object") {
+            throw new Error("Policy must define 'blocked_query_types'");
+        }
+        const validActions = new Set(["block", "warn"]);
+        const validSeverities = new Set(["critical", "high", "medium", "low"]);
+        for (const [key, val] of Object.entries(raw.blocked_query_types)) {
+            const entry = val;
+            if (!entry.action || !entry.response) {
+                throw new Error(`blocked_query_types.${key} must have 'action' and 'response'`);
+            }
+            if (!validActions.has(entry.action)) {
+                throw new Error(`blocked_query_types.${key}.action must be 'block' or 'warn', got '${entry.action}'`);
+            }
+        }
+        if (!Array.isArray(raw.privacy_rules)) {
+            throw new Error("Policy must define 'privacy_rules' as an array");
+        }
+        for (const rule of raw.privacy_rules) {
+            if (!rule.id || !rule.severity) {
+                throw new Error("Each privacy_rule must have 'id' and 'severity'");
+            }
+            if (!validSeverities.has(rule.severity)) {
+                throw new Error(`privacy_rules '${rule.id}' has invalid severity '${rule.severity}'`);
+            }
+        }
+        if (!Array.isArray(raw.safety_rules)) {
+            throw new Error("Policy must define 'safety_rules' as an array");
+        }
+        for (const rule of raw.safety_rules) {
+            if (!rule.id || !rule.severity) {
+                throw new Error("Each safety_rule must have 'id' and 'severity'");
+            }
+            if (!validSeverities.has(rule.severity)) {
+                throw new Error(`safety_rules '${rule.id}' has invalid severity '${rule.severity}'`);
+            }
+        }
+        return raw;
+    }
+    getBlockedQueryTypes() {
+        return this.policy.blocked_query_types;
+    }
+    getBlockedResponse(queryType) {
+        const entry = this.policy.blocked_query_types[queryType];
+        if (!entry || entry.action !== "block")
+            return null;
+        return entry.response;
+    }
+    isQueryTypeBlocked(queryType) {
+        const entry = this.policy.blocked_query_types[queryType];
+        return !!entry && entry.action === "block";
+    }
+    getPrivacyRules() {
+        return this.policy.privacy_rules;
+    }
+    getSafetyRules() {
+        return this.policy.safety_rules;
+    }
+    getPrivacyRulesBySeverity(severity) {
+        return this.policy.privacy_rules.filter((r) => r.severity === severity);
+    }
+    getSafetyRulesBySeverity(severity) {
+        return this.policy.safety_rules.filter((r) => r.severity === severity);
+    }
+    getDomain() {
+        return this.policy.domain;
+    }
+    getVersion() {
+        return this.policy.version;
+    }
+}
+//# sourceMappingURL=policy_engine.js.map

package/dist/src/policy/policy_engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy_engine.js","sourceRoot":"","sources":["../../../src/policy/policy_engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAuC1C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,MAAM,mBAAmB,GAAG,OAAO,CACjC,UAAU,EACV,4BAA4B,CAC7B,CAAC;AAEF,MAAM,OAAO,YAAY;IACf,MAAM,CAAmB;IAEjC,YAAY,sBAAkD;QAC5D,IAAI,OAAO,sBAAsB,KAAK,QAAQ,IAAI,sBAAsB,KAAK,IAAI,EAAE,CAAC;YAClF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,sBAAsB,IAAI,mBAAmB,CAAC;YAC/D,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,GAAQ;QACvB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,GAAG,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACvE,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACjE,MAAM,KAAK,GAAG,GAAU,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,oCAAoC,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,2CAA2C,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YACxG,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,EAAE,2BAA2B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,EAAE,2BAA2B,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;QACD,OAAO,GAAuB,CAAC;IACjC,CAAC;IAED,oBAAoB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACzC,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC;IAC7C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IACnC,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;IAClC,CAAC;IAED,yBAAyB,CAAC,QAAgB;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED,wBAAwB,CAAC,QAAgB;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;CACF"}

package/dist/src/reasoning/index.d.ts

@@ -0,0 +1,2 @@
+export { PostInteractionGovernance, type Violation, type PostInteractionResult, type IPostInteractionGovernance, } from "./reasoning_validator";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/reasoning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/reasoning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC"}

package/dist/src/reasoning/index.js

@@ -0,0 +1,2 @@
+export { PostInteractionGovernance, } from "./reasoning_validator.js";
+//# sourceMappingURL=index.js.map

package/dist/src/reasoning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/reasoning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAI1B,MAAM,uBAAuB,CAAC"}

package/dist/src/reasoning/reasoning_validator.d.ts

@@ -0,0 +1,28 @@
+import type { GovernanceRetrievalContext as RetrievalContext } from "../types";
+import type { QueryType } from "../classification/query_classifier";
+export interface Violation {
+    type: "hallucination" | "missing_evidence" | "unsafe_content" | "privacy_leak";
+    severity: "critical" | "high" | "medium";
+    description: string;
+}
+export interface PostInteractionResult {
+    approved: boolean;
+    violations: Violation[];
+    revisedResponse: string | null;
+}
+export interface IPostInteractionGovernance {
+    evaluate(query: string, response: string, retrievalContext: RetrievalContext | undefined, queryType: QueryType): PostInteractionResult;
+}
+export declare class PostInteractionGovernance implements IPostInteractionGovernance {
+    evaluate(query: string, response: string, retrievalContext: RetrievalContext | undefined, queryType: QueryType): PostInteractionResult;
+    private checkHallucinations;
+    private checkUnsafeContent;
+    private checkPrivacyLeak;
+    private enrichMissingDataResponse;
+    private ensureClinicalCaveat;
+    private enrichCausalSpeculationCaveat;
+    private enrichPopulationStatisticsCaveat;
+    private addRetrievalConfidenceCaveat;
+    private responseAcknowledgesNoData;
+}
+//# sourceMappingURL=reasoning_validator.d.ts.map

package/dist/src/reasoning/reasoning_validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning_validator.d.ts","sourceRoot":"","sources":["../../../src/reasoning/reasoning_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC/E,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,SAAS,EAAE,SAAS,GACnB,qBAAqB,CAAC;CAC1B;AAuCD,qBAAa,yBAA0B,YAAW,0BAA0B;IAC1E,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,SAAS,EAAE,SAAS,GACnB,qBAAqB;IAoCxB,OAAO,CAAC,mBAAmB;IAoE3B,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,yBAAyB;IAsDjC,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,6BAA6B;IAiBrC,OAAO,CAAC,gCAAgC;IA2BxC,OAAO,CAAC,4BAA4B;IAepC,OAAO,CAAC,0BAA0B;CASnC"}