@governed-ai/runtime 1.0.0

package/dist/domains/registry.js

@@ -0,0 +1,65 @@
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { existsSync } from "fs";
+import { PolicyEngine } from "../src/policy/policy_engine.js";
+import { healthEntityRules } from "./health/entity_rules.js";
+import { financeEntityRules } from "./finance/entity_rules.js";
+import { insuranceEntityRules } from "./insurance/entity_rules.js";
+const currentDir = dirname(fileURLToPath(import.meta.url));
+const BUILTIN_ENTITY_RULES = {
+    health: healthEntityRules,
+    finance: financeEntityRules,
+    insurance: insuranceEntityRules,
+};
+export class DomainRegistry {
+    domains = new Map();
+    defaultDomain;
+    constructor(defaultDomain = "health") {
+        this.defaultDomain = defaultDomain;
+        this.loadBuiltinDomains();
+    }
+    loadBuiltinDomains() {
+        const domainNames = ["health", "finance", "insurance"];
+        for (const name of domainNames) {
+            const policyPath = resolve(currentDir, name, "policy.yaml");
+            if (!existsSync(policyPath)) {
+                console.warn(`[domain-registry] Policy file not found for domain '${name}': ${policyPath}`);
+                continue;
+            }
+            const policyEngine = new PolicyEngine(policyPath);
+            const entityRules = BUILTIN_ENTITY_RULES[name];
+            if (!entityRules) {
+                console.warn(`[domain-registry] Entity rules not found for domain '${name}'`);
+                continue;
+            }
+            this.domains.set(name, { policyEngine, entityRules });
+        }
+    }
+    registerDomain(name, config) {
+        this.domains.set(name, config);
+    }
+    getDomain(name) {
+        const domainName = name || this.defaultDomain;
+        const config = this.domains.get(domainName);
+        if (!config) {
+            throw new Error(`Domain '${domainName}' is not registered. Available domains: ${this.listDomains().join(", ")}`);
+        }
+        return config;
+    }
+    hasDomain(name) {
+        return this.domains.has(name);
+    }
+    listDomains() {
+        return [...this.domains.keys()];
+    }
+    getDefaultDomain() {
+        return this.defaultDomain;
+    }
+    getPolicyEngine(domain) {
+        return this.getDomain(domain).policyEngine;
+    }
+    getEntityRules(domain) {
+        return this.getDomain(domain).entityRules;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/domains/registry.js.map

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

package/dist/domains/types.d.ts

@@ -0,0 +1,12 @@
+export interface DomainEntityRules {
+    domain: string;
+    entityLabel: string;
+    entityLabelPlural: string;
+    numericIdPattern: RegExp;
+    numericIdFallbackPattern: RegExp;
+    notFoundResponse: (id: string) => string;
+    ambiguousResponse: (suggestion: string) => string;
+    entityNotFoundResponse: string;
+    stopWords: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/domains/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../domains/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/domains/types.js

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

package/dist/domains/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export { runGovernance } from "./src/orchestrator";
+export type { GovernancePipelineConfig } from "./src/orchestrator";
+export type { GovernanceContext, GovernanceLLMCall, GovernanceLLMResult, GovernanceResult, GovernanceRetrievalContext, GovernanceToolCall, } from "./src/types";
+export { governance, createGovernance } from "./sdk/governance";
+export type { GovernanceRunContext, GovernanceRunResult, GovernanceViolation, GovernanceSDKOptions, GovernanceToolCallInput, GovernanceToolGuardResult, GovernanceTraceViolation, GovernanceTraceValidationResult, } from "./sdk/governance";
+export type { EntityIdentity, IEntityIdentityRepository, EntityResolution, IEntityResolver, } from "./src/interfaces/entity";
+export { DomainRegistry } from "./domains/registry";
+export type { DomainConfig } from "./domains/registry";
+export type { DomainEntityRules } from "./domains/types";
+export { PolicyEngine } from "./src/policy/policy_engine";
+export type { IPolicyEngine, PolicyDefinition, BlockedQueryPolicy, PrivacyRule, SafetyRule, } from "./src/policy/policy_engine";
+export { QueryClassifier } from "./src/classification/query_classifier";
+export type { IQueryClassifier } from "./src/classification/query_classifier";
+export { PreInteractionGovernance } from "./src/gateway/pre_interaction_governance";
+export type { IPreInteractionGovernance } from "./src/gateway/pre_interaction_governance";
+export { PostInteractionGovernance } from "./src/reasoning/reasoning_validator";
+export type { IPostInteractionGovernance } from "./src/reasoning/reasoning_validator";
+export { ResponseNormalizer } from "./src/normalization/response_normalizer";
+export type { IResponseNormalizer } from "./src/normalization/response_normalizer";
+export { GovernanceLogger } from "./src/telemetry/governance_logger";
+export type { IGovernanceLogger, GovernanceLogEntry } from "./src/telemetry/governance_logger";
+export { InteractionStateManager } from "./src/state/interaction_state";
+export type { IInteractionStateManager, InteractionSessionState, SessionStateUpdate, GovernanceDecisionRecord, ReferencedEntity, ConversationEntry, } from "./src/state/interaction_state";
+export { ToolGuard } from "./src/tools/tool_guard";
+export type { IToolGuard, ToolRequest, ToolGuardResult, ToolViolation, ToolPolicyRule, } from "./src/tools/tool_guard";
+export { GovernanceMetricsAggregator } from "./src/telemetry/metrics";
+export type { IGovernanceMetricsAggregator, GovernanceMetrics, DomainMetrics, } from "./src/telemetry/metrics";
+export { CertificationTestRunner } from "./src/certification/test_runner";
+export type { ICertificationTestRunner, UATScenario, ScenarioResult, CertificationReport, CertificationOptions, CategoryScore, DomainScore, } from "./src/certification/test_runner";
+export { TraceValidator } from "./src/reasoning/trace_validator";
+export type { ITraceValidator, TraceInput, TraceViolation, TraceValidationResult, } from "./src/reasoning/trace_validator";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,YAAY,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAE1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,YAAY,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,YAAY,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EACV,wBAAwB,EACxB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { runGovernance } from "./src/orchestrator.js";
+export { governance, createGovernance } from "./sdk/governance.js";
+export { DomainRegistry } from "./domains/registry.js";
+export { PolicyEngine } from "./src/policy/policy_engine.js";
+export { QueryClassifier } from "./src/classification/query_classifier.js";
+export { PreInteractionGovernance } from "./src/gateway/pre_interaction_governance.js";
+export { PostInteractionGovernance } from "./src/reasoning/reasoning_validator.js";
+export { ResponseNormalizer } from "./src/normalization/response_normalizer.js";
+export { GovernanceLogger } from "./src/telemetry/governance_logger.js";
+export { InteractionStateManager } from "./src/state/interaction_state.js";
+export { ToolGuard } from "./src/tools/tool_guard.js";
+export { GovernanceMetricsAggregator } from "./src/telemetry/metrics.js";
+export { CertificationTestRunner } from "./src/certification/test_runner.js";
+export { TraceValidator } from "./src/reasoning/trace_validator.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmBhE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAS1D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAGpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAGrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAUxE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAOtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAW1E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/sdk/governance.d.ts

@@ -0,0 +1,121 @@
+export interface GovernanceToolCallInput {
+    toolName: string;
+    parameters: Record<string, any>;
+}
+export interface GovernanceToolGuardResult {
+    allowed: boolean;
+    blockedReason: string | null;
+    violations: Array<{
+        rule: string;
+        severity: string;
+        description: string;
+    }>;
+    toolName: string;
+    sanitizedParameters: Record<string, any> | null;
+}
+export interface GovernanceRunContext {
+    sessionPatientId?: string | null;
+    retrievalContext?: {
+        patientId?: string | null;
+        patientName?: string | null;
+        biomarkerData?: Array<{
+            biomarkerId: string;
+            value: number;
+            unit?: string;
+            sourceDocumentId?: string;
+            name?: string;
+        }>;
+        documents?: Array<{
+            documentId: string;
+            reportDate?: string;
+            rawText?: string;
+        }>;
+        extractedData?: any;
+        retrievalConfidence?: number;
+    };
+    reasoningMode?: string;
+    isRefinement?: boolean;
+    previousResponse?: string | null;
+    conversationSummary?: string | null;
+    activeTopic?: string | null;
+    patientSnapshotSummary?: string | null;
+}
+export interface GovernanceViolation {
+    type: string;
+    severity: string;
+    description: string;
+}
+export interface GovernanceTraceViolation {
+    type: string;
+    severity: string;
+    description: string;
+}
+export interface GovernanceTraceValidationResult {
+    valid: boolean;
+    violations: GovernanceTraceViolation[];
+    adjustedConfidence: number;
+    adjustedConfidenceLabel: string;
+    shouldBlock: boolean;
+}
+export interface GovernanceRunResult {
+    status: "allowed" | "blocked";
+    answer: string;
+    evidence: string[];
+    confidence: string;
+    violations: GovernanceViolation[];
+    classification: {
+        type: string;
+        confidence: number;
+        triggers: string[];
+    };
+    blockedStage: string | null;
+    blockedReason: string | null;
+    llmCalled: boolean;
+    domain: string;
+    sessionId: string | null;
+    toolGuardResults: GovernanceToolGuardResult[];
+    traceValidation: GovernanceTraceValidationResult | null;
+}
+export interface GovernanceSDKOptions {
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+declare class GovernanceSDK {
+    private baseUrl;
+    private timeoutMs;
+    constructor(options?: GovernanceSDKOptions);
+    run(query: string, context?: GovernanceRunContext, domain?: string, sessionId?: string, toolCalls?: GovernanceToolCallInput[]): Promise<GovernanceRunResult>;
+    checkTool(toolName: string, parameters?: Record<string, any>, sessionId?: string, domain?: string): Promise<GovernanceToolGuardResult>;
+    certifyAgent(options?: {
+        domain?: string;
+        categories?: string[];
+        scenarioIds?: string[];
+        scenarios?: Array<{
+            id: string;
+            name: string;
+            description?: string;
+            domain?: string;
+            category?: string;
+            query: string;
+            context?: Record<string, any>;
+            expectedOutcome?: string;
+            expectedBlockStage?: string | null;
+            forbiddenPatterns?: string[];
+            requiredPatterns?: string[];
+            toolCalls?: Array<{
+                toolName: string;
+                parameters: Record<string, any>;
+            }>;
+        }>;
+        timeoutMs?: number;
+    }): Promise<Record<string, any>>;
+    metrics(): Promise<Record<string, any>>;
+    health(): Promise<{
+        status: string;
+        service: string;
+    }>;
+}
+export declare function createGovernance(options?: GovernanceSDKOptions): GovernanceSDK;
+export declare const governance: GovernanceSDK;
+export {};
+//# sourceMappingURL=governance.d.ts.map

package/dist/sdk/governance.d.ts.map

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

package/dist/sdk/governance.js

@@ -0,0 +1,219 @@
+const DEFAULT_BASE_URL = "http://localhost:8000";
+const DEFAULT_TIMEOUT_MS = 30_000;
+class GovernanceSDK {
+    baseUrl;
+    timeoutMs;
+    constructor(options) {
+        this.baseUrl = (options?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    async run(query, context, domain, sessionId, toolCalls) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/governed-query`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    query,
+                    context: {
+                        sessionPatientId: context?.sessionPatientId ?? null,
+                        retrievalContext: context?.retrievalContext,
+                        reasoningMode: context?.reasoningMode,
+                        isRefinement: context?.isRefinement,
+                        previousResponse: context?.previousResponse,
+                        conversationSummary: context?.conversationSummary,
+                        activeTopic: context?.activeTopic,
+                        patientSnapshotSummary: context?.patientSnapshotSummary,
+                    },
+                    domain,
+                    sessionId,
+                    toolCalls,
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new Error(`Governance API returned HTTP ${res.status}${body ? `: ${body}` : ""}`);
+            }
+            const data = await res.json();
+            if (typeof data.response !== "string") {
+                throw new Error("Governance API returned malformed response: missing 'response' field");
+            }
+            if (typeof data.blocked !== "boolean") {
+                throw new Error("Governance API returned malformed response: missing 'blocked' field");
+            }
+            return {
+                status: data.blocked ? "blocked" : "allowed",
+                answer: data.response,
+                evidence: data.normalization?.evidence ?? [],
+                confidence: data.normalization?.confidenceLabel ?? "unknown",
+                violations: (data.violations ?? []).map((v) => ({
+                    type: v.type ?? "unknown",
+                    severity: v.severity ?? "medium",
+                    description: v.description ?? "",
+                })),
+                classification: {
+                    type: data.classification?.type ?? "unknown",
+                    confidence: data.classification?.confidence ?? 0,
+                    triggers: data.classification?.triggers ?? [],
+                },
+                blockedStage: data.blockedStage ?? null,
+                blockedReason: data.blockedReason ?? null,
+                llmCalled: data.llmCalled ?? false,
+                domain: data.domain,
+                sessionId: data.sessionId ?? null,
+                toolGuardResults: (data.toolGuardResults ?? []).map((t) => ({
+                    allowed: t.allowed ?? true,
+                    blockedReason: t.blockedReason ?? null,
+                    violations: (t.violations ?? []).map((v) => ({
+                        rule: v.rule ?? "unknown",
+                        severity: v.severity ?? "medium",
+                        description: v.description ?? "",
+                    })),
+                    toolName: t.toolName ?? "unknown",
+                    sanitizedParameters: t.sanitizedParameters ?? null,
+                })),
+                traceValidation: data.traceValidation
+                    ? {
+                        valid: data.traceValidation.valid ?? true,
+                        violations: (data.traceValidation.violations ?? []).map((v) => ({
+                            type: v.type ?? "unknown",
+                            severity: v.severity ?? "medium",
+                            description: v.description ?? "",
+                        })),
+                        adjustedConfidence: data.traceValidation.adjustedConfidence ?? 0,
+                        adjustedConfidenceLabel: data.traceValidation.adjustedConfidenceLabel ?? "unknown",
+                        shouldBlock: data.traceValidation.shouldBlock ?? false,
+                    }
+                    : null,
+            };
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Governance API request timed out after ${this.timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async checkTool(toolName, parameters, sessionId, domain) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/tool-check`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    toolName,
+                    parameters: parameters ?? {},
+                    sessionId,
+                    domain,
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new Error(`Governance API tool-check returned HTTP ${res.status}${body ? `: ${body}` : ""}`);
+            }
+            const data = await res.json();
+            return {
+                allowed: data.allowed ?? true,
+                blockedReason: data.blockedReason ?? null,
+                violations: (data.violations ?? []).map((v) => ({
+                    rule: v.rule ?? "unknown",
+                    severity: v.severity ?? "medium",
+                    description: v.description ?? "",
+                })),
+                toolName: data.toolName ?? toolName,
+                sanitizedParameters: data.sanitizedParameters ?? null,
+            };
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Governance API tool-check timed out after ${this.timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async certifyAgent(options) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), Math.max(this.timeoutMs, 120_000));
+        try {
+            const res = await fetch(`${this.baseUrl}/certify-agent`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(options ?? {}),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new Error(`Certification request failed with HTTP ${res.status}${body ? `: ${body}` : ""}`);
+            }
+            return res.json();
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Governance API certification request timed out`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async metrics() {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/governance-metrics`, {
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                throw new Error(`Metrics request failed with HTTP ${res.status}`);
+            }
+            return res.json();
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Governance API metrics request timed out after ${this.timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async health() {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/health`, {
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                throw new Error(`Health check failed with HTTP ${res.status}`);
+            }
+            return res.json();
+        }
+        catch (err) {
+            if (err.name === "AbortError") {
+                throw new Error(`Governance API health check timed out after ${this.timeoutMs}ms`);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+export function createGovernance(options) {
+    return new GovernanceSDK(options);
+}
+export const governance = new GovernanceSDK();
+//# sourceMappingURL=governance.js.map

package/dist/sdk/governance.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/api/index.js

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

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

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

package/dist/src/certification/test_runner.d.ts

@@ -0,0 +1,86 @@
+import { type GovernancePipelineConfig } from "../orchestrator";
+import type { GovernanceContext, GovernanceLLMCall } from "../types";
+export interface UATScenario {
+    id: string;
+    name: string;
+    description: string;
+    domain: string;
+    category: "safety" | "hallucination" | "privacy" | "boundary" | "accuracy" | "tool_governance";
+    query: string;
+    context: GovernanceContext;
+    expectedOutcome: "blocked" | "allowed";
+    expectedBlockStage?: string | null;
+    forbiddenPatterns?: RegExp[];
+    requiredPatterns?: RegExp[];
+    toolCalls?: Array<{
+        toolName: string;
+        parameters: Record<string, any>;
+    }>;
+}
+export interface ScenarioResult {
+    scenarioId: string;
+    scenarioName: string;
+    category: string;
+    domain: string;
+    passed: boolean;
+    expectedOutcome: string;
+    actualOutcome: string;
+    blocked: boolean;
+    blockedStage: string | null;
+    violations: Array<{
+        type: string;
+        severity: string;
+        description: string;
+    }>;
+    traceValid: boolean | null;
+    failureReasons: string[];
+    durationMs: number;
+}
+export interface CertificationReport {
+    certificationId: string;
+    timestamp: string;
+    durationMs: number;
+    totalScenarios: number;
+    passed: number;
+    failed: number;
+    passRate: number;
+    safetyViolations: number;
+    hallucinationRate: number;
+    overallReliabilityScore: number;
+    byCategory: Record<string, CategoryScore>;
+    byDomain: Record<string, DomainScore>;
+    scenarios: ScenarioResult[];
+    verdict: "certified" | "conditional" | "failed";
+}
+export interface CategoryScore {
+    total: number;
+    passed: number;
+    failed: number;
+    passRate: number;
+}
+export interface DomainScore {
+    total: number;
+    passed: number;
+    failed: number;
+    passRate: number;
+}
+export interface ICertificationTestRunner {
+    loadScenarios(scenarios: UATScenario[]): void;
+    getScenarios(): UATScenario[];
+    run(agentCall: GovernanceLLMCall, pipelineConfig: GovernancePipelineConfig, options?: CertificationOptions): Promise<CertificationReport>;
+}
+export interface CertificationOptions {
+    domain?: string;
+    categories?: string[];
+    scenarioIds?: string[];
+    timeoutMs?: number;
+}
+export declare class CertificationTestRunner implements ICertificationTestRunner {
+    private scenarios;
+    loadScenarios(scenarios: UATScenario[]): void;
+    getScenarios(): UATScenario[];
+    run(agentCall: GovernanceLLMCall, pipelineConfig: GovernancePipelineConfig, options?: CertificationOptions): Promise<CertificationReport>;
+    private executeScenario;
+    private buildReport;
+}
+//# sourceMappingURL=test_runner.d.ts.map

package/dist/src/certification/test_runner.d.ts.map

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