truthguard-ai 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,498 @@
+/**
+ * AI Reliability Control Plane — Shared Domain Types
+ *
+ * These types define the core domain model for V1:
+ * Trace, Claims, Grounding Verdicts, Reports, and Tolerances.
+ */
+/** A unique identifier string. */
+export type TraceId = string;
+/** Supported step roles within a trace. */
+export type TraceStepRole = 'system_prompt' | 'user_input' | 'tool_call' | 'tool_output' | 'llm_call' | 'final_response';
+/** A single tool call made during an agent step. */
+export interface ToolCall {
+    /** Name of the tool / function called. */
+    toolName: string;
+    /** Parameters passed to the tool. */
+    parameters: Record<string, unknown>;
+    /** ISO-8601 timestamp when the call was made. */
+    calledAt?: string;
+}
+/** The output returned by a tool. */
+export interface ToolOutput {
+    /** Name of the tool that produced this output. */
+    toolName: string;
+    /** The raw output value. May be any JSON-serialisable shape. */
+    output: unknown;
+    /** ISO-8601 timestamp when the output was received. */
+    receivedAt?: string;
+}
+/** One logical step within an agent execution trace. */
+export interface TraceStep {
+    /** Unique identifier for this step (auto-assigned if not provided). */
+    stepId: string;
+    /** Role of the step. */
+    role: TraceStepRole;
+    /** The human-readable or LLM-generated content for this step. */
+    content: string;
+    /** Tool calls associated with this step (for tool_call steps). */
+    toolCalls?: ToolCall[];
+    /** Tool outputs associated with this step (for tool_output steps). */
+    toolOutputs?: ToolOutput[];
+    /** Latency in milliseconds for this step. */
+    latencyMs?: number;
+    /** Token usage for LLM steps. */
+    tokens?: {
+        prompt: number;
+        completion: number;
+        total: number;
+        /** Provider finish reason: 'stop' = natural, 'length' = token limit hit. */
+        finishReason?: string;
+        /** The max_tokens parameter sent in the API request. */
+        maxTokens?: number;
+    };
+    /** Rate limit info from provider response headers (if captured). */
+    rateLimitInfo?: {
+        /** Remaining requests in the current window. */
+        remainingRequests?: number;
+        /** Remaining tokens in the current window. */
+        remainingTokens?: number;
+        /** Seconds until the rate limit resets. */
+        resetSeconds?: number;
+    };
+    /** ISO-8601 timestamp when this step started. */
+    startedAt?: string;
+    /** ISO-8601 timestamp when this step ended. */
+    endedAt?: string;
+    /** Arbitrary metadata. */
+    metadata?: Record<string, unknown>;
+}
+/** A complete captured agent execution trace. */
+export interface Trace {
+    /** Unique trace identifier. */
+    traceId: TraceId;
+    /** Ordered list of steps in this trace. */
+    steps: TraceStep[];
+    /** ISO-8601 timestamp when the trace started. */
+    startedAt?: string;
+    /** ISO-8601 timestamp when the trace ended. */
+    endedAt?: string;
+    /** Total latency in milliseconds for the full trace. */
+    totalLatencyMs?: number;
+    /** Arbitrary metadata (e.g., session ID, user ID, model version). */
+    metadata?: Record<string, unknown>;
+}
+/** Types of extractable claims. L1: number, date, name, count. L2: boolean, enum, list_items, key_value, aggregation, range. */
+export type ClaimType = 'number' | 'date' | 'name' | 'count' | 'boolean' | 'enum' | 'list_items' | 'key_value' | 'aggregation' | 'range';
+/**
+ * Canonical unit-of-measure values.
+ * Time · Distance · Mass · Data · Percentage · Angle.
+ * L1 extraction stores whichever UNIT_WORDS form was matched;
+ * the Matchers layer normalises aliases via `normaliseUnit()`.
+ */
+export type UnitType = 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years' | 'mm' | 'cm' | 'meters' | 'km' | 'miles' | 'kg' | 'lbs' | 'bytes' | 'kb' | 'mb' | 'gb' | 'usd' | 'eur' | 'gbp' | 'rsd' | 'chf' | 'jpy' | 'cny' | 'rub' | 'inr' | 'brl' | 'percent' | 'degrees';
+/** Where in the trace a claim was extracted from. */
+export interface ClaimSource {
+    /** The step from which the claim was extracted. */
+    stepId: string;
+    /** Role of the source step. */
+    role: TraceStepRole;
+    /** Verbatim text segment containing the claim. */
+    rawText: string;
+}
+/** A single factual claim extracted from the agent's final response. */
+export interface Claim {
+    /** Unique identifier for this claim within a report. */
+    claimId: string;
+    /** The type of the claim. */
+    type: ClaimType;
+    /** The normalised value of the claim (number, ISO date string, string). */
+    value: number | string;
+    /** Original text from which the claim was extracted. */
+    rawText: string;
+    /** Source location in the trace. */
+    source: ClaimSource;
+    /** Unit of measurement (e.g. "hours", "minutes") — set when a number is paired with a unit word. */
+    unit?: UnitType;
+    /** Entity/subject associated with the claim (e.g. "Danica") — the nearest proper noun. */
+    entity?: string;
+    /** JSON field name from tool output that this claim relates to (L2 structured context). */
+    fieldName?: string;
+    /** The original tool output value that this claim was extracted against (L2). */
+    sourceFieldValue?: unknown;
+    /** For list_items claims: the full set of expected items from tool output. */
+    expectedItems?: string[];
+    /** For list_items claims: items mentioned in the response. */
+    mentionedItems?: string[];
+    /** For aggregation claims: the operation performed (sum, avg, count, min, max). */
+    aggregationOp?: 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max' | 'pct_of_total';
+    /** For aggregation claims: the computed correct value. */
+    computedValue?: number;
+    /** Metric/measure name derived from tool output field (e.g. "late_count", "overtime_hours"). */
+    metric?: string;
+    /** Time period context for this claim (e.g. "2024-01", "Q1 2024"), extracted from tool call params or text. */
+    period?: string;
+    /** Whether the claim is negated ("nema kašnjenja" → true, value implicitly 0). */
+    negated?: boolean;
+    /** Comparison operator when claim is a bound, not an exact ("više od 50" → ">"). */
+    comparisonOp?: '>' | '<' | '>=' | '<=' | '==' | '!=';
+    /** Direction of percentage/value change ("rast od 12%" → "increase"). */
+    changeDirection?: 'increase' | 'decrease';
+    /** Superlative rank claim ("najkritičniji" → 1, "top 3" → 3). */
+    rank?: number;
+    /** Status transition: the prior state before the change. */
+    transitionFrom?: string;
+    /** Status transition: the new state after the change. */
+    transitionTo?: string;
+    /**
+     * Scope classification from sibling-family relevance filtering.
+     * - `in_scope`: active sibling group, normal verification.
+     * - `weak_scope`: weakly activated sibling (single mention), reduced penalty on UNGROUNDED.
+     * - `suppressed`: dormant sibling when active siblings exist — verdict forced to GROUNDED.
+     * Only set on `list_items` claims from keyed containers.
+     */
+    siblingScope?: 'in_scope' | 'weak_scope' | 'suppressed';
+    /**
+     * Debug: the sibling family pattern this claim belongs to (e.g. "by_date.*.people").
+     * Only set when sibling-scope filtering was applied.
+     */
+    siblingFamilyPattern?: string;
+}
+/** Possible verdicts for a single claim grounding check. */
+export type VerdictType = 'GROUNDED' | 'APPROXIMATE_MATCH' | 'UNGROUNDED' | 'UNVERIFIABLE' | 'MULTI_STEP';
+/** Severity levels for claim verdicts. */
+export type ClaimSeverity = 'HIGH' | 'MEDIUM' | 'LOW';
+/** Grounding failure type codes (V1). */
+export type FailureType = 'grounding.empty_fabrication' | 'grounding.no_tool_call' | 'grounding.unverified_value' | 'grounding.math_error' | 'grounding.data_ignored' | 'grounding.wrong_query' | 'grounding.incomplete_response' | 'grounding.contradictory_claims' | 'grounding.tool_error_ignored' | 'grounding.excessive_tool_calls' | 'grounding.stale_knowledge' | 'grounding.irrelevant_context' | 'reasoning.scope_mismatch' | 'reasoning.overconfident_language' | 'reasoning.language_mismatch' | 'grounding.hallucinated_entity' | 'grounding.question_not_answered' | 'orchestration.malformed_tool_input' | 'orchestration.raw_output_leak' | 'orchestration.intermediate_response_leak' | 'orchestration.token_limit_truncation' | 'orchestration.rate_limit_degradation' | 'orchestration.quota_exhaustion' | 'orchestration.model_fallback' | 'safety.prompt_leak' | 'safety.sensitive_data_exposure' | 'grounding.entity_value_swap' | 'reasoning.instruction_violation' | 'instrumentation.duplicate_user_input' | 'orchestration.tool_budget_exhaustion' | 'orchestration.tool_period_mismatch' | 'grounding.stale_cross_turn_reuse' | 'orchestration.tool_capability_gap' | 'grounding.period_label_mismatch' | 'grounding.aggregation_scope_error' | 'grounding.missing_grouping' | 'reasoning.transformational_intent' | 'grounding.metric_mismatch' | 'reasoning.partial_period_risk' | 'orchestration.ai_unavailable' | 'orchestration.answer_refusal' | 'orchestration.tool_selection_error' | 'orchestration.tool_output_error' | 'orchestration.fabricated_tool_input' | 'reasoning.percentage_error' | 'reasoning.ratio_error' | 'reasoning.multiplication_error';
+/** The result of grounding a single claim against tool outputs. */
+export interface ClaimVerdict {
+    /** The claim that was evaluated. */
+    claim: Claim;
+    /** The grounding verdict. */
+    verdict: VerdictType;
+    /** The tool output value that was matched against (if found). */
+    sourceValue?: unknown;
+    /** Which tool output step provided the evidence. */
+    sourceStepId?: string;
+    /** Numeric deviation (e.g., 0.02 = 2%). Populated for number/count claims. */
+    deviation?: number;
+    /** The grounding rule that produced this verdict. */
+    ruleUsed?: string;
+    /** Human-readable explanation. */
+    explanation: string;
+    /** Failure type, if the verdict is UNGROUNDED. */
+    failureType?: FailureType;
+    /** Severity of the verdict (HIGH = exact mismatch on count/date, MEDIUM = numeric deviation, LOW = approximate match or name). */
+    severity?: ClaimSeverity;
+}
+/** Configurable tolerances for grounding checks. */
+export interface ToleranceConfig {
+    /** Relative tolerance for numeric values (e.g. 0.05 = 5%). Default: 0.05. */
+    numericRelativeTolerance: number;
+    /** Whether count claims require exact match. Default: true. */
+    countExactMatch: boolean;
+    /** Whether date claims require exact match. Default: true. */
+    dateExactMatch: boolean;
+    /**
+     * Threshold for fuzzy name matching (0–1, Jaro-Winkler-like score).
+     * Default: 0.85.
+     */
+    nameSimilarityThreshold: number;
+}
+/** Default tolerance configuration. */
+export declare const DEFAULT_TOLERANCES: ToleranceConfig;
+/** How much the user should trust the entire grounding report. */
+export type ReportConfidenceLevel = 'high' | 'medium' | 'low';
+/**
+ * Meta-assessment of the grounding report's own reliability.
+ *
+ * This is NOT the same as `groundingScore`:
+ * - `groundingScore` = how well the AI's claims match tool data
+ * - `reportConfidence` = how much we trust the analysis itself
+ *
+ * Example: groundingScore=0.95 on 1 claim with no tool_outputs → low confidence.
+ */
+export interface ReportConfidence {
+    /** Tier for display: high = show normally, medium = show with caveat, low = hide or disclaimer. */
+    level: ReportConfidenceLevel;
+    /** Internal composite score (0–1). Do NOT display to end-users as a percentage. */
+    score: number;
+    /** Human-readable explanation for the confidence level. */
+    note: string;
+    /** Machine-readable reason codes for frontend badges, analytics, and future AI routing. */
+    reasons: string[];
+}
+/** Confidence level for a detected failure. */
+export type FailureConfidence = 'high' | 'medium' | 'low';
+/** Severity level assigned by the failure registry + confidence. */
+export type FailureSeverity = 'critical' | 'high' | 'medium' | 'low';
+/** Role of a failure within an orchestrated report. */
+export type FailureRole = 'primary' | 'secondary' | 'suppressed';
+/** Detected failure summary in a grounding report. */
+export interface DetectedFailure {
+    /** The failure type code. */
+    type: FailureType;
+    /** Human-readable description. */
+    description: string;
+    /** Related claim IDs. */
+    claimIds: string[];
+    /**
+     * How confident the detection is.
+     * - high: deterministic / strong structural signal (date mismatch, empty output)
+     * - medium: plausible heuristic (math error proximity)
+     * - low: hypothesis only — may be a false positive (entity name not in params)
+     */
+    confidence: FailureConfidence;
+    /**
+     * Severity computed from failure type + confidence.
+     * Derived from the failure registry's defaultSeverity, demoted for lower confidence.
+     */
+    severity: FailureSeverity;
+    /**
+     * Role assigned by the orchestration layer.
+     * - primary: root-cause failure
+     * - secondary: consequence of a primary failure
+     * - suppressed: redundant, hidden from default view
+     */
+    role: FailureRole;
+    /**
+     * If this failure is secondary or suppressed, the primary failure type that caused it.
+     */
+    suppressedBy?: FailureType;
+    /**
+     * Root-cause diagnosis derived from trace structure analysis.
+     * Explains *why* this failure occurred (e.g., "Agent loop exhausted after 4 iterations").
+     */
+    diagnosis?: string;
+    /**
+     * Actionable fix suggestion for the agent developer.
+     * Explains what to change to prevent this failure pattern.
+     */
+    suggestedFix?: string;
+}
+/** The full grounding report for a single trace. */
+export interface GroundingReport {
+    /** The trace that was evaluated. */
+    traceId: TraceId;
+    /** ISO-8601 timestamp when the report was generated. */
+    generatedAt: string;
+    /** Total number of claims found in the final response. */
+    claimsTotal: number;
+    /** Number of claims that were verified (GROUNDED or APPROXIMATE_MATCH). */
+    claimsVerified: number;
+    /** Number of claims that were skipped (UNVERIFIABLE or MULTI_STEP). */
+    claimsSkipped: number;
+    /** Number of claims that failed grounding (UNGROUNDED). */
+    claimsFailed: number;
+    /**
+     * Overall grounding score (0–1).
+     * Computed as claimsVerified / (claimsTotal - claimsSkipped),
+     * or 1.0 when there are no verifiable claims.
+     */
+    groundingScore: number;
+    /** Per-claim verdicts. */
+    verdicts: ClaimVerdict[];
+    /**
+     * Confirmed grounding failures (high/medium confidence).
+     * Suitable for CI gates and blocking decisions.
+     */
+    detectedFailures: DetectedFailure[];
+    /**
+     * Low-confidence hypotheses — possible issues that need human review.
+     * Should NOT block CI or trigger hard alerts.
+     */
+    hypotheses: DetectedFailure[];
+    /** Aggregate counts by confidence level. */
+    failureCounts: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+    /** Tolerances used during evaluation. */
+    tolerancesUsed: ToleranceConfig;
+    /**
+     * Root cause — one-sentence explanation of the primary failure.
+     * Derived from the highest-severity primary detected failure.
+     * Undefined when there are no failures.
+     */
+    rootCause?: string;
+    /**
+     * Human-readable narrative summarising all detected issues,
+     * their causal relationships, and suggested remediations.
+     * Undefined when there are no failures.
+     */
+    summary?: string;
+    /**
+     * Ordered list of failure types to fix, root causes first.
+     * Derived from the suppression graph — fixing earlier items
+     * may automatically resolve later ones.
+     */
+    repairSequence?: {
+        type: FailureType;
+        reason: string;
+    }[];
+    /**
+     * Trace quality assessment — tells the user how complete their trace is
+     * and what CANNOT be verified given missing elements.
+     * Always populated by GroundingEngine.evaluate().
+     */
+    traceQuality?: import('../TraceReadiness').TraceQualityReport;
+    /**
+     * Whether the user's question was resolved.
+     * Derived from detected failures — false when critical completeness
+     * failures (answer_refusal, question_not_answered, etc.) are detected.
+     */
+    resolved?: boolean;
+    /**
+     * Short explanation of the resolution status.
+     * E.g. "AI explicitly refused to answer" or "All claims grounded".
+     */
+    resolutionNote?: string;
+    /**
+     * Meta-assessment of the report's own reliability.
+     * Combines trace completeness, claim coverage, and disabled-check penalties
+     * into a single tier + score that tells the frontend how to present results.
+     */
+    reportConfidence: ReportConfidence;
+    /** Number of conversation turns (1 = single-turn). Present when multi-turn. */
+    turnCount?: number;
+    /** Zero-based index of the turn that was evaluated. Present when multi-turn. */
+    activeTurnIndex?: number;
+}
+/** A single test case in a golden dataset (one line in a JSONL file). */
+export interface DatasetEntry {
+    /** Human-readable label for this test case. */
+    name: string;
+    /** The trace to evaluate. */
+    trace: Trace;
+    /**
+     * Optional: expected grounding score (0–1).
+     * If provided, the runner checks that the actual score meets or beats this expectation.
+     */
+    expectedScore?: number;
+    /**
+     * Optional: failure types that MUST be detected.
+     * If provided, the runner verifies all listed types appear in detectedFailures.
+     */
+    expectedFailures?: FailureType[];
+    /**
+     * Optional: failure types that MUST NOT be detected.
+     * If provided, the runner verifies none of these types appear in detectedFailures.
+     */
+    forbiddenFailures?: FailureType[];
+}
+/** Result of evaluating a single dataset entry. */
+export interface DatasetEntryResult {
+    /** Name from the dataset entry. */
+    name: string;
+    /** Whether all assertions passed. */
+    passed: boolean;
+    /** The full grounding report. */
+    report: GroundingReport;
+    /** Per-assertion results. */
+    assertions: AssertionResult[];
+}
+/** Result of a single assertion within a dataset entry. */
+export interface AssertionResult {
+    /** What was checked. */
+    check: string;
+    /** Whether it passed. */
+    passed: boolean;
+    /** Human-readable detail on failure. */
+    detail?: string;
+}
+/** Aggregate result of running an entire dataset. */
+export interface DatasetRunResult {
+    /** Total entries evaluated. */
+    totalEntries: number;
+    /** Entries where all assertions passed. */
+    passedEntries: number;
+    /** Entries where at least one assertion failed. */
+    failedEntries: number;
+    /** Average grounding score across all entries. */
+    averageScore: number;
+    /** Per-entry results. */
+    entries: DatasetEntryResult[];
+}
+/** A single assertion in a gate configuration. */
+export interface GateAssertion {
+    /** The metric to check. */
+    metric: 'grounding_score' | 'failure_count' | 'pass_rate';
+    /** Comparison operator. */
+    operator: '>=' | '<=' | '==' | '>' | '<';
+    /** Threshold value. */
+    threshold: number;
+}
+/** Configuration for a CI quality gate. */
+export interface GateConfig {
+    /** Human-readable name for the gate. */
+    name: string;
+    /** Assertions that must all pass for the gate to pass. */
+    assertions: GateAssertion[];
+}
+/** Result of evaluating a gate against a dataset run. */
+export interface GateResult {
+    /** Gate name. */
+    name: string;
+    /** Whether the gate passed (all assertions met). */
+    passed: boolean;
+    /** Per-assertion evaluation. */
+    assertions: GateAssertionResult[];
+}
+/** Result of a single gate assertion. */
+export interface GateAssertionResult {
+    /** The assertion that was evaluated. */
+    assertion: GateAssertion;
+    /** Actual value observed. */
+    actualValue: number;
+    /** Whether it passed. */
+    passed: boolean;
+}
+/** Snapshot of key metrics from a dataset run, saved as a baseline. */
+export interface BaselineSnapshot {
+    /** ISO-8601 timestamp when the baseline was created. */
+    createdAt: string;
+    /** Label (e.g. branch name, commit SHA, "main"). */
+    label: string;
+    /** Average grounding score across the dataset. */
+    averageScore: number;
+    /** Total detected failures (high + medium confidence). */
+    totalFailures: number;
+    /** Dataset pass rate. */
+    passRate: number;
+    /** Per-entry scores for drill-down. */
+    entryScores: Array<{
+        name: string;
+        score: number;
+        failureCount: number;
+    }>;
+}
+/** Comparison between a current run and a baseline snapshot. */
+export interface BaselineComparison {
+    /** The baseline label that was compared against. */
+    baselineLabel: string;
+    /** Delta in average grounding score (current - baseline). Positive = improvement. */
+    scoreDelta: number;
+    /** Delta in total failure count. Negative = improvement. */
+    failureDelta: number;
+    /** Delta in pass rate. Positive = improvement. */
+    passRateDelta: number;
+    /** Whether the run is within an acceptable tolerance of the baseline. */
+    withinTolerance: boolean;
+    /** The tolerance that was used. */
+    tolerance: number;
+    /** Per-entry regressions (entries that got worse). */
+    regressions: Array<{
+        name: string;
+        baselineScore: number;
+        currentScore: number;
+        delta: number;
+    }>;
+    /** Per-entry improvements (entries that got better). */
+    improvements: Array<{
+        name: string;
+        baselineScore: number;
+        currentScore: number;
+        delta: number;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * AI Reliability Control Plane — Shared Domain Types
+ *
+ * These types define the core domain model for V1:
+ * Trace, Claims, Grounding Verdicts, Reports, and Tolerances.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOLERANCES = void 0;
+/** Default tolerance configuration. */
+exports.DEFAULT_TOLERANCES = {
+    numericRelativeTolerance: 0.05,
+    countExactMatch: true,
+    dateExactMatch: true,
+    nameSimilarityThreshold: 0.92,
+};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgTH,uCAAuC;AAC1B,QAAA,kBAAkB,GAAoB;IACjD,wBAAwB,EAAE,IAAI;IAC9B,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,uBAAuB,EAAE,IAAI;CAC9B,CAAC"}

package/dist-npm/Alerting/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Alert Dispatchers — notify when grounding scores drop.
+ *
+ * Used by warn and block modes to send notifications
+ * through various channels (webhook, console, custom).
+ */
+import type { GroundingReport, Trace } from '../types';
+/** Abstract alert dispatcher. */
+export interface AlertDispatcher {
+    /** Dispatch an alert for a low-scoring evaluation. */
+    dispatch(report: GroundingReport, trace: Trace): Promise<void>;
+}
+/** Logs alerts to stderr with color. */
+export declare class ConsoleAlertDispatcher implements AlertDispatcher {
+    dispatch(report: GroundingReport, _trace: Trace): Promise<void>;
+}
+export interface WebhookConfig {
+    /** The URL to POST the alert payload to. */
+    url: string;
+    /** Optional headers (e.g., Authorization). */
+    headers?: Record<string, string>;
+}
+/** Posts alert payloads to a webhook URL (Slack, Discord, PagerDuty, custom). */
+export declare class WebhookAlertDispatcher implements AlertDispatcher {
+    private readonly config;
+    constructor(config: WebhookConfig);
+    dispatch(report: GroundingReport, trace: Trace): Promise<void>;
+}
+/** Calls a user-provided function. */
+export declare class CallbackAlertDispatcher implements AlertDispatcher {
+    private readonly fn;
+    constructor(fn: (report: GroundingReport, trace: Trace) => Promise<void> | void);
+    dispatch(report: GroundingReport, trace: Trace): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist-npm/Alerting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Alerting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAMvD,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAMD,wCAAwC;AACxC,qBAAa,sBAAuB,YAAW,eAAe;IACtD,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAWtE;AAMD,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,iFAAiF;AACjF,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,EAAE,aAAa;IAI3B,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAkCrE;AAMD,sCAAsC;AACtC,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAGO;gBAGxB,EAAE,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK/D,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrE"}

package/dist-npm/Alerting/index.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Alert Dispatchers — notify when grounding scores drop.
+ *
+ * Used by warn and block modes to send notifications
+ * through various channels (webhook, console, custom).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackAlertDispatcher = exports.WebhookAlertDispatcher = exports.ConsoleAlertDispatcher = void 0;
+// ---------------------------------------------------------------------------
+// ConsoleAlertDispatcher
+// ---------------------------------------------------------------------------
+/** Logs alerts to stderr with color. */
+class ConsoleAlertDispatcher {
+    async dispatch(report, _trace) {
+        const score = (report.groundingScore * 100).toFixed(0);
+        const failures = report.detectedFailures
+            .map((f) => f.type)
+            .join(', ');
+        console.error(`[TruthGuard WARN] Trace ${report.traceId} scored ${score}% | ` +
+            `${report.claimsFailed} ungrounded claims | ` +
+            `Failures: ${failures || 'none'}`);
+    }
+}
+exports.ConsoleAlertDispatcher = ConsoleAlertDispatcher;
+/** Posts alert payloads to a webhook URL (Slack, Discord, PagerDuty, custom). */
+class WebhookAlertDispatcher {
+    constructor(config) {
+        this.config = config;
+    }
+    async dispatch(report, trace) {
+        const payload = {
+            event: 'truthguard.grounding.alert',
+            timestamp: new Date().toISOString(),
+            traceId: report.traceId,
+            groundingScore: report.groundingScore,
+            claimsTotal: report.claimsTotal,
+            claimsFailed: report.claimsFailed,
+            detectedFailures: report.detectedFailures.map((f) => ({
+                type: f.type,
+                confidence: f.confidence,
+                description: f.description,
+            })),
+            trace: {
+                traceId: trace.traceId,
+                stepsCount: trace.steps.length,
+            },
+        };
+        const res = await fetch(this.config.url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...this.config.headers,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            console.error(`[TruthGuard] Webhook alert failed: ${res.status} ${res.statusText}`);
+        }
+    }
+}
+exports.WebhookAlertDispatcher = WebhookAlertDispatcher;
+// ---------------------------------------------------------------------------
+// CallbackAlertDispatcher — for custom integrations
+// ---------------------------------------------------------------------------
+/** Calls a user-provided function. */
+class CallbackAlertDispatcher {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    async dispatch(report, trace) {
+        await this.fn(report, trace);
+    }
+}
+exports.CallbackAlertDispatcher = CallbackAlertDispatcher;
+//# sourceMappingURL=index.js.map

package/dist-npm/Alerting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Alerting/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAcH,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,wCAAwC;AACxC,MAAa,sBAAsB;IACjC,KAAK,CAAC,QAAQ,CAAC,MAAuB,EAAE,MAAa;QACnD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,KAAK,CACX,2BAA2B,MAAM,CAAC,OAAO,WAAW,KAAK,MAAM;YAC7D,GAAG,MAAM,CAAC,YAAY,uBAAuB;YAC7C,aAAa,QAAQ,IAAI,MAAM,EAAE,CACpC,CAAC;IACJ,CAAC;CACF;AAZD,wDAYC;AAaD,iFAAiF;AACjF,MAAa,sBAAsB;IAGjC,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAuB,EAAE,KAAY;QAClD,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,4BAA4B;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpD,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;YACH,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;aAC/B;SACF,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;aACvB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CACX,sCAAsC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CACrE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAzCD,wDAyCC;AAED,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E;AAE9E,sCAAsC;AACtC,MAAa,uBAAuB;IAMlC,YACE,EAAmE;QAEnE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAuB,EAAE,KAAY;QAClD,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AAfD,0DAeC"}