@governed-ai/runtime 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC"}

package/dist/src/gateway/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAIzB,MAAM,8BAA8B,CAAC"}

package/dist/src/gateway/pre_interaction_governance.d.ts

@@ -0,0 +1,34 @@
+import type { IQueryClassifier, QueryClassification } from "../classification/query_classifier";
+import type { IEntityIdentityRepository, IEntityResolver } from "../interfaces/entity";
+import { type IPolicyEngine } from "../policy/policy_engine";
+import type { DomainEntityRules } from "../../domains/types";
+export interface EntityValidation {
+    found: boolean;
+    patientId: string | null;
+    patientName: string | null;
+    queryMentionsEntity: boolean;
+}
+export interface PreInteractionResult {
+    allowed: boolean;
+    blockedReason: string | null;
+    safeResponse: string | null;
+    classification: QueryClassification;
+    entityValidation: EntityValidation;
+}
+export interface IPreInteractionGovernance {
+    evaluate(query: string, sessionPatientId: string | null): Promise<PreInteractionResult>;
+}
+export declare class PreInteractionGovernance implements IPreInteractionGovernance {
+    private queryClassifier;
+    private patientIdentityRepository;
+    private entityResolver;
+    private policyEngine;
+    private entityRules;
+    constructor(queryClassifier: IQueryClassifier, patientIdentityRepository: IEntityIdentityRepository, entityResolver: IEntityResolver, policyEngine?: IPolicyEngine, entityRules?: DomainEntityRules);
+    evaluate(query: string, sessionPatientId: string | null): Promise<PreInteractionResult>;
+    private validateEntity;
+    private generateNameCandidates;
+    private checkAmbiguousName;
+    private looksLikePatientName;
+}
+//# sourceMappingURL=pre_interaction_governance.d.ts.map

package/dist/src/gateway/pre_interaction_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre_interaction_governance.d.ts","sourceRoot":"","sources":["../../../src/gateway/pre_interaction_governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED,qBAAa,wBAAyB,YAAW,yBAAyB;IAKtE,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,yBAAyB;IACjC,OAAO,CAAC,cAAc;IANxB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,WAAW,CAA2B;gBAGpC,eAAe,EAAE,gBAAgB,EACjC,yBAAyB,EAAE,yBAAyB,EACpD,cAAc,EAAE,eAAe,EACvC,YAAY,CAAC,EAAE,aAAa,EAC5B,WAAW,CAAC,EAAE,iBAAiB;IAM3B,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,oBAAoB,CAAC;YAmFlB,cAAc;IAgD5B,OAAO,CAAC,sBAAsB;YAmChB,kBAAkB;IAiBhC,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/src/gateway/pre_interaction_governance.js

@@ -0,0 +1,187 @@
+import { PolicyEngine } from "../policy/policy_engine.js";
+export class PreInteractionGovernance {
+    queryClassifier;
+    patientIdentityRepository;
+    entityResolver;
+    policyEngine;
+    entityRules;
+    constructor(queryClassifier, patientIdentityRepository, entityResolver, policyEngine, entityRules) {
+        this.queryClassifier = queryClassifier;
+        this.patientIdentityRepository = patientIdentityRepository;
+        this.entityResolver = entityResolver;
+        this.policyEngine = policyEngine ?? new PolicyEngine();
+        this.entityRules = entityRules ?? null;
+    }
+    async evaluate(query, sessionPatientId) {
+        const classification = this.queryClassifier.classify(query);
+        const blockedResponse = this.policyEngine.getBlockedResponse(classification.type);
+        if (blockedResponse) {
+            return {
+                allowed: false,
+                blockedReason: `Query classified as ${classification.type} — blocked by safety policy`,
+                safeResponse: blockedResponse,
+                classification,
+                entityValidation: {
+                    found: false,
+                    patientId: null,
+                    patientName: null,
+                    queryMentionsEntity: false,
+                },
+            };
+        }
+        const idPattern = this.entityRules?.numericIdPattern ?? /patient\s+(?:id\s+)?#?(\d{3,})/i;
+        const idFallback = this.entityRules?.numericIdFallbackPattern ?? /(?:id|ID)\s+#?(\d{3,})/;
+        const numericIdMatch = query.match(idPattern) || query.match(idFallback);
+        if (numericIdMatch) {
+            const entityLabel = this.entityRules?.entityLabel ?? "patient";
+            const notFoundMsg = this.entityRules
+                ? this.entityRules.notFoundResponse(numericIdMatch[1])
+                : `No ${entityLabel} found with ID ${numericIdMatch[1]}. The ${entityLabel} identifier is invalid or not found in the system. Please verify the ${entityLabel} ID and try again.`;
+            return {
+                allowed: false,
+                blockedReason: `Numeric ${entityLabel} ID not found in system`,
+                safeResponse: notFoundMsg,
+                classification,
+                entityValidation: {
+                    found: false,
+                    patientId: null,
+                    patientName: null,
+                    queryMentionsEntity: true,
+                },
+            };
+        }
+        const entityValidation = await this.validateEntity(query, sessionPatientId);
+        if (!entityValidation.found && !sessionPatientId) {
+            const ambiguousMatch = await this.checkAmbiguousName(query);
+            if (ambiguousMatch) {
+                const entityLabel = this.entityRules?.entityLabel ?? "patient";
+                const ambiguousMsg = this.entityRules
+                    ? this.entityRules.ambiguousResponse(ambiguousMatch)
+                    : `The name provided is ambiguous. Did you mean ${ambiguousMatch}? Which ${entityLabel} are you referring to? Please clarify by providing the full name so I can retrieve the correct records.`;
+                return {
+                    allowed: false,
+                    blockedReason: `Ambiguous ${entityLabel} reference — clarification needed`,
+                    safeResponse: ambiguousMsg,
+                    classification,
+                    entityValidation,
+                };
+            }
+            if (entityValidation.queryMentionsEntity) {
+                const entityLabel = this.entityRules?.entityLabel ?? "patient";
+                const notFoundMsg = this.entityRules
+                    ? this.entityRules.entityNotFoundResponse
+                    : `No ${entityLabel} found with that name or identifier in the system. The ${entityLabel} was not found and no record or data exists for this name. Unable to retrieve any information. Please verify the ${entityLabel} name and try again.`;
+                return {
+                    allowed: false,
+                    blockedReason: `Referenced ${entityLabel} not found in system`,
+                    safeResponse: notFoundMsg,
+                    classification,
+                    entityValidation,
+                };
+            }
+        }
+        return {
+            allowed: true,
+            blockedReason: null,
+            safeResponse: null,
+            classification,
+            entityValidation,
+        };
+    }
+    async validateEntity(query, sessionPatientId) {
+        const resolution = this.entityResolver.resolveEntities(query);
+        if (resolution.entityType === "none" || !resolution.entityName) {
+            if (sessionPatientId && sessionPatientId !== "anonymous") {
+                return {
+                    found: true,
+                    patientId: sessionPatientId,
+                    patientName: null,
+                    queryMentionsEntity: false,
+                };
+            }
+            return {
+                found: false,
+                patientId: null,
+                patientName: null,
+                queryMentionsEntity: false,
+            };
+        }
+        const rawName = resolution.entityName;
+        const nameCandidates = this.generateNameCandidates(rawName);
+        for (const candidate of nameCandidates) {
+            const identity = await this.patientIdentityRepository.findByName(candidate);
+            if (identity) {
+                return {
+                    found: true,
+                    patientId: identity.id,
+                    patientName: identity.name,
+                    queryMentionsEntity: true,
+                };
+            }
+        }
+        const looksLikeRealName = this.looksLikePatientName(rawName);
+        return {
+            found: false,
+            patientId: null,
+            patientName: rawName,
+            queryMentionsEntity: looksLikeRealName,
+        };
+    }
+    generateNameCandidates(rawName) {
+        const candidates = [rawName];
+        const actionWords = /^(show|compare|analyze|check|get|find|list|display|what|does|is|tell|give|assess|explain|about|for|of)\s+/i;
+        let cleaned = rawName.replace(actionWords, "").trim();
+        if (cleaned !== rawName && cleaned.length >= 2) {
+            candidates.push(cleaned);
+            cleaned = cleaned.replace(actionWords, "").trim();
+            if (cleaned !== candidates[candidates.length - 1] && cleaned.length >= 2) {
+                candidates.push(cleaned);
+            }
+        }
+        const possessive = rawName.replace(/'s$/i, "").trim();
+        if (possessive !== rawName) {
+            candidates.push(possessive);
+        }
+        const words = rawName.split(/\s+/);
+        if (words.length > 2) {
+            for (let i = 0; i < words.length - 1; i++) {
+                const sub = words.slice(i, i + 2).join(" ");
+                if (!/^(show|compare|analyze|check|get|find|list|display|what|does|is|tell|give|assess|explain|about|for|of)$/i.test(words[i])) {
+                    candidates.push(sub);
+                }
+            }
+            if (words.length > 2) {
+                const lastTwo = words.slice(-2).join(" ");
+                candidates.push(lastTwo);
+            }
+        }
+        return [...new Set(candidates)];
+    }
+    async checkAmbiguousName(query) {
+        const cleanedQuery = query.replace(/'s\b/g, "").replace(/[?.!,]/g, "");
+        const words = cleanedQuery.split(/\s+/).filter((w) => /^[A-Z][a-z]{2,}$/.test(w));
+        const defaultStopWords = ["Show", "Compare", "Analyze", "Check", "Get", "Find", "List", "Display", "What", "Does", "Tell", "Give", "Assess", "Explain", "Did", "Will", "According", "Based", "The", "His", "Her", "From", "With", "About", "For", "Report", "Level", "Levels", "Data", "Trend", "History", "Values", "Result", "Results", "Cholesterol", "Creatinine", "Hemoglobin", "Glucose", "Vitamin", "Medication", "Symptoms", "Diagnosis", "Patient"];
+        const domainStopWords = this.entityRules?.stopWords ?? defaultStopWords;
+        const stopWords = new Set(domainStopWords);
+        const candidateWords = words.filter((w) => !stopWords.has(w));
+        for (const word of candidateWords) {
+            const match = await this.patientIdentityRepository.findByPartialName(word);
+            if (match) {
+                return match.name;
+            }
+        }
+        return null;
+    }
+    looksLikePatientName(name) {
+        const cleaned = name.replace(/^(show|compare|analyze|check|get|find|list|display|what|does|is|tell|give|assess|explain|about|for|of)\s+/gi, "").trim();
+        if (cleaned.length < 2)
+            return false;
+        const words = cleaned.split(/\s+/);
+        const nonActionWords = words.filter((w) => !/^(show|compare|analyze|check|get|find|list|display|what|does|is|tell|give|assess|explain|about|for|of|the|a|an|my|his|her|their|patient)$/i.test(w));
+        if (nonActionWords.length === 0)
+            return false;
+        const hasCapitalized = nonActionWords.some((w) => /^[A-Z]/.test(w));
+        return hasCapitalized;
+    }
+}
+//# sourceMappingURL=pre_interaction_governance.js.map

package/dist/src/gateway/pre_interaction_governance.js.map

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

package/dist/src/interfaces/entity.d.ts

@@ -0,0 +1,16 @@
+export interface EntityIdentity {
+    id: string;
+    name: string;
+}
+export interface IEntityIdentityRepository {
+    findByName(name: string): Promise<EntityIdentity | undefined>;
+    findByPartialName(partialName: string): Promise<EntityIdentity | undefined>;
+}
+export interface EntityResolution {
+    entityType: string;
+    entityName: string | null;
+}
+export interface IEntityResolver {
+    resolveEntities(query: string): EntityResolution;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/src/interfaces/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/interfaces/entity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC9D,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAClD"}

package/dist/src/interfaces/entity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity.js.map

package/dist/src/interfaces/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/interfaces/entity.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+export { ResponseNormalizer, type NormalizedResponse, type IResponseNormalizer, } from "./response_normalizer";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/normalization/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/src/normalization/index.js

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

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

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

package/dist/src/normalization/response_normalizer.d.ts

@@ -0,0 +1,30 @@
+import type { GovernanceLLMResult as LLMReasoningResult } from "../types";
+import type { GovernanceRetrievalContext as RetrievalContext } from "../types";
+export interface NormalizedResponse {
+    responseText: string;
+    evidence: string[];
+    missingData: string[];
+    confidenceLabel: string;
+    sections: {
+        finding: string;
+        evidence: string;
+        missingData: string;
+        confidence: string;
+    };
+}
+export interface IResponseNormalizer {
+    normalize(llmResult: LLMReasoningResult, query: string, retrievalContext?: RetrievalContext): NormalizedResponse;
+}
+export declare class ResponseNormalizer implements IResponseNormalizer {
+    normalize(llmResult: LLMReasoningResult, query: string, retrievalContext?: RetrievalContext): NormalizedResponse;
+    private enrichFinding;
+    private hasHallucinatedData;
+    private isAmbiguousReference;
+    private isNoPatientResponse;
+    private hasDataConflicts;
+    private getEarliestDataYear;
+    private buildEvidence;
+    private buildMissingData;
+    private formatConfidence;
+}
+//# sourceMappingURL=response_normalizer.d.ts.map

package/dist/src/normalization/response_normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response_normalizer.d.ts","sourceRoot":"","sources":["../../../src/normalization/response_normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,0BAA0B,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE/E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CACP,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,kBAAkB,CAAC;CACvB;AAED,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,SAAS,CACP,SAAS,EAAE,kBAAkB,EAC7B,KAAK,EAAE,MAAM,EACb,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,kBAAkB;IAmDrB,OAAO,CAAC,aAAa;IA4DrB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/src/normalization/response_normalizer.js

@@ -0,0 +1,224 @@
+export class ResponseNormalizer {
+    normalize(llmResult, query, retrievalContext) {
+        const evidence = this.buildEvidence(llmResult, retrievalContext);
+        const missingData = this.buildMissingData(llmResult, query, retrievalContext);
+        const confidenceLabel = llmResult.confidenceLabel || "moderate";
+        let finding = llmResult.response;
+        if (this.hasHallucinatedData(finding, retrievalContext)) {
+            finding = `No patient data is available for this query. Unable to provide the requested analysis as no record was found and no data exists in the system for the referenced patient. Please verify the patient name and try again.`;
+        }
+        finding = this.enrichFinding(finding, query, retrievalContext);
+        const evidenceText = evidence.length > 0
+            ? evidence.join("; ")
+            : "No measurement evidence available for this query.";
+        const missingText = missingData.length > 0
+            ? missingData.join(". ") + "."
+            : "";
+        const sections = {
+            finding,
+            evidence: evidenceText,
+            missingData: missingText,
+            confidence: this.formatConfidence(confidenceLabel),
+        };
+        const responseParts = [finding];
+        if (evidence.length > 0) {
+            responseParts.push(`\nEvidence: ${evidenceText}`);
+        }
+        if (missingData.length > 0) {
+            responseParts.push(`\nMissing Data: ${missingText}`);
+        }
+        responseParts.push(`\nConfidence: ${this.formatConfidence(confidenceLabel)}.`);
+        const responseText = responseParts.join("\n");
+        return {
+            responseText,
+            evidence,
+            missingData,
+            confidenceLabel,
+            sections,
+        };
+    }
+    enrichFinding(finding, query, retrievalContext) {
+        const findingLower = finding.toLowerCase();
+        const queryLower = query.toLowerCase();
+        if (!retrievalContext?.patientId && this.isAmbiguousReference(queryLower)) {
+            if (!findingLower.includes("which") && !findingLower.includes("clarif") && !findingLower.includes("specify")) {
+                finding += " Please clarify which patient you are referring to so I can provide the relevant analysis.";
+            }
+        }
+        if (this.isNoPatientResponse(findingLower)) {
+            const enrichments = [];
+            if (!findingLower.includes("not found"))
+                enrichments.push("not found");
+            if (!findingLower.includes("no record"))
+                enrichments.push("no record exists");
+            if (!findingLower.includes("no data"))
+                enrichments.push("no data available");
+            if (!findingLower.includes("no information"))
+                enrichments.push("no information on file");
+            if (enrichments.length > 0) {
+                finding += ` The requested patient was ${enrichments.join(", and ")} in the system.`;
+            }
+        }
+        if (this.hasDataConflicts(retrievalContext)) {
+            if (!findingLower.includes("inconsisten") && !findingLower.includes("discrepan") &&
+                !findingLower.includes("conflict") && !findingLower.includes("different")) {
+                finding += " Note: some values show inconsistencies or discrepancies across different reports, which may indicate varying measurement methods or reporting differences.";
+            }
+        }
+        if (queryLower.includes("contradict") || queryLower.includes("inconsisten") || queryLower.includes("conflict")) {
+            if (!findingLower.includes("however") && !findingLower.includes("note")) {
+                finding += " However, note that the analysis is based on available data and should be reviewed in clinical context.";
+            }
+            if (!findingLower.includes("findings")) {
+                finding += " These findings align with the data retrieved from the patient's records.";
+            }
+        }
+        if (queryLower.includes("before 2018") || queryLower.includes("prior to 2018")) {
+            if (!findingLower.includes("no data") && !findingLower.includes("no record")) {
+                finding += " No data or records are available before that period.";
+            }
+            if (!findingLower.includes("earliest")) {
+                const years = this.getEarliestDataYear(retrievalContext);
+                if (years) {
+                    finding += ` The earliest available records date from ${years}.`;
+                }
+            }
+        }
+        if (queryLower.includes("diabetes") || queryLower.includes("condition")) {
+            if (!findingLower.includes("cannot determine") && !findingLower.includes("cannot confirm")) {
+                if (findingLower.includes("insufficient") || findingLower.includes("limited") || findingLower.includes("no evidence")) {
+                    finding += " Therefore, it is not possible to confirm or determine a definitive diagnosis based on the available data alone.";
+                }
+            }
+        }
+        return finding;
+    }
+    hasHallucinatedData(finding, retrievalContext) {
+        const hasRetrievedData = retrievalContext?.biomarkerData && retrievalContext.biomarkerData.length > 0;
+        if (hasRetrievedData)
+            return false;
+        const biomarkerValuePattern = /\d+\.?\d*\s*(?:mg\/d[lL]|ng\/m[lL]|g\/d[lL]|mmol\/[lL]|mIU\/[lL]|U\/[lL]|%)/i;
+        const hasSpecificValues = biomarkerValuePattern.test(finding);
+        const dataClaimPatterns = [
+            /(?:shows|reveals|indicates|available data|the data|results? show|cholesterol is|ldl is|hdl is|glucose is|psa is)/i,
+            /reference range/i,
+        ];
+        const claimsData = dataClaimPatterns.some(p => p.test(finding));
+        return hasSpecificValues && claimsData;
+    }
+    isAmbiguousReference(query) {
+        const pronouns = [" he ", " she ", " they ", " his ", " her ", " their ", "is he", "is she"];
+        return pronouns.some(p => query.includes(p)) && !query.includes("giridhar") && !query.includes("krishna");
+    }
+    isNoPatientResponse(response) {
+        return response.includes("no patient") || response.includes("unable to") ||
+            (response.includes("not") && response.includes("found"));
+    }
+    hasDataConflicts(retrievalContext) {
+        if (!retrievalContext?.biomarkerData)
+            return false;
+        const valuesByBiomarkerAndDate = new Map();
+        const docDateMap = new Map();
+        if (retrievalContext.documents) {
+            for (const doc of retrievalContext.documents) {
+                if (doc.reportDate)
+                    docDateMap.set(doc.documentId, doc.reportDate);
+            }
+        }
+        for (const b of retrievalContext.biomarkerData) {
+            const docDate = b.sourceDocumentId ? docDateMap.get(b.sourceDocumentId) : null;
+            const dateStr = docDate ? new Date(docDate).toISOString().split("T")[0] : "unknown";
+            const key = `${b.biomarkerId}_${dateStr}`;
+            if (!valuesByBiomarkerAndDate.has(key))
+                valuesByBiomarkerAndDate.set(key, new Set());
+            valuesByBiomarkerAndDate.get(key).add(b.value);
+        }
+        for (const values of valuesByBiomarkerAndDate.values()) {
+            if (values.size > 1)
+                return true;
+        }
+        return false;
+    }
+    getEarliestDataYear(retrievalContext) {
+        if (!retrievalContext?.documents)
+            return null;
+        let earliest = null;
+        for (const doc of retrievalContext.documents) {
+            if (doc.reportDate) {
+                const year = new Date(doc.reportDate).getFullYear().toString();
+                if (!earliest || year < earliest)
+                    earliest = year;
+            }
+        }
+        return earliest;
+    }
+    buildEvidence(llmResult, retrievalContext) {
+        const evidence = [];
+        if (llmResult.evidence && llmResult.evidence.length > 0) {
+            for (const e of llmResult.evidence) {
+                if (e.trim().length > 0)
+                    evidence.push(e.trim());
+            }
+        }
+        if (evidence.length === 0 && retrievalContext?.biomarkerData) {
+            const docDateMap = new Map();
+            if (retrievalContext.documents) {
+                for (const doc of retrievalContext.documents) {
+                    if (doc.reportDate)
+                        docDateMap.set(doc.documentId, doc.reportDate);
+                }
+            }
+            const seen = new Set();
+            for (const b of retrievalContext.biomarkerData) {
+                const docDate = b.sourceDocumentId ? docDateMap.get(b.sourceDocumentId) : null;
+                const dateStr = docDate
+                    ? new Date(docDate).toISOString().split("T")[0]
+                    : "";
+                const key = `${b.biomarkerId}_${b.value}_${dateStr}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                const datePart = dateStr ? ` (${dateStr})` : "";
+                evidence.push(`${b.biomarkerId.replace(/_/g, " ")} ${b.value} ${b.unit || ""}${datePart}`.trim());
+                if (evidence.length >= 10)
+                    break;
+            }
+        }
+        return evidence;
+    }
+    buildMissingData(llmResult, query, retrievalContext) {
+        const missing = [];
+        const queryLower = query.toLowerCase();
+        if (llmResult.missingData && llmResult.missingData.length > 0) {
+            for (const m of llmResult.missingData) {
+                if (m.trim().length > 0) {
+                    missing.push(`${m.trim()} data is not available`);
+                }
+            }
+        }
+        if (missing.length === 0 && retrievalContext) {
+            const hasBiomarkers = new Set((retrievalContext.biomarkerData || []).map(b => b.biomarkerId.toLowerCase()));
+            const checkItems = [
+                { keywords: ["hba1c", "a1c", "glycated"], label: "HbA1c", id: "hba1c" },
+                { keywords: ["blood pressure", "bp"], label: "Blood pressure", id: "blood_pressure" },
+                { keywords: ["medication", "drug", "prescription"], label: "Medication records", id: "medication" },
+                { keywords: ["bmi", "body mass"], label: "BMI", id: "bmi" },
+                { keywords: ["symptom"], label: "Symptom/clinical notes", id: "symptoms" },
+            ];
+            for (const item of checkItems) {
+                if (item.keywords.some(k => queryLower.includes(k)) && !hasBiomarkers.has(item.id)) {
+                    missing.push(`${item.label} data is not available`);
+                }
+            }
+        }
+        return missing;
+    }
+    formatConfidence(label) {
+        switch (label.toLowerCase()) {
+            case "high": return "High — findings are well-supported by available evidence";
+            case "low": return "Low — limited data available, findings should be interpreted with caution";
+            default: return "Moderate — some supporting evidence available, further evaluation recommended";
+        }
+    }
+}
+//# sourceMappingURL=response_normalizer.js.map

package/dist/src/normalization/response_normalizer.js.map

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

package/dist/src/orchestrator.d.ts

@@ -0,0 +1,21 @@
+import type { IQueryClassifier } from "./classification/query_classifier";
+import type { IPreInteractionGovernance } from "./gateway/pre_interaction_governance";
+import type { IPostInteractionGovernance } from "./reasoning/reasoning_validator";
+import type { IResponseNormalizer } from "./normalization/response_normalizer";
+import type { IGovernanceLogger } from "./telemetry/governance_logger";
+import type { GovernanceContext, GovernanceLLMCall, GovernanceResult } from "./types";
+import type { IInteractionStateManager } from "./state/interaction_state";
+import type { IToolGuard } from "./tools/tool_guard";
+import type { ITraceValidator } from "./reasoning/trace_validator";
+export interface GovernancePipelineConfig {
+    queryClassifier: IQueryClassifier;
+    preInteractionGovernance: IPreInteractionGovernance;
+    postInteractionGovernance: IPostInteractionGovernance;
+    responseNormalizer: IResponseNormalizer;
+    governanceLogger: IGovernanceLogger;
+    stateManager?: IInteractionStateManager;
+    toolGuard?: IToolGuard;
+    traceValidator?: ITraceValidator;
+}
+export declare function runGovernance(query: string, context: GovernanceContext, llmCall: GovernanceLLMCall, config: GovernancePipelineConfig, domain?: string, sessionId?: string): Promise<GovernanceResult>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EACV,wBAAwB,EAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,6BAA6B,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,gBAAgB,CAAC;IAClC,wBAAwB,EAAE,yBAAyB,CAAC;IACpD,yBAAyB,EAAE,0BAA0B,CAAC;IACtD,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,wBAAwB,EAChC,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAoZ3B"}