truthguard-ai 0.2.0 → 0.3.0

package/dist-npm/Rules/intents.js

@@ -0,0 +1,242 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Multilingual aggregation intent keywords
+// ---------------------------------------------------------------------------
+// Covers top 10 world languages by speakers + Serbian:
+//   English, Mandarin Chinese, Hindi, Spanish, French, Arabic,
+//   Bengali, Portuguese, Russian, Japanese, Serbian
+//
+// To add a new language: append keywords to the relevant `keywords` array.
+// To add a new operation: add a new entry to AGGREGATION_INTENTS.
+//
+// Guidelines:
+//   • Latin-script words use \b word boundaries (e.g. \bsum\b)
+//   • CJK / Cyrillic / Devanagari / Arabic / Bengali — no \b (JS \b
+//     doesn't match non-ASCII word boundaries), just literal characters
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFORMATIONAL_INTENTS = exports.GROUPING_INTENTS = exports.AGGREGATION_INTENTS = void 0;
+// ── helpers ──────────────────────────────────────────────────────────────────
+/** Wrap a Latin-script keyword with \b word boundaries. */
+function wb(word) {
+    return `\\b${word}\\b`;
+}
+/**
+ * Build a case-insensitive regex from a list of raw keyword strings.
+ * Latin-script entries are automatically wrapped with \b boundaries.
+ */
+function buildPattern(keywords) {
+    const parts = keywords.map((kw) => 
+    // If keyword is purely ASCII-Latin (with optional accents in capture),
+    // wrap in \b. Otherwise use as-is for CJK/Cyrillic/Devanagari/Arabic/Bengali.
+    /^[\x20-\x7F\u00C0-\u024F\\[\]().+*?|{}^$]+$/.test(kw) ? wb(kw) : kw);
+    return new RegExp(`(?:${parts.join('|')})`, 'i');
+}
+// ── intent definitions ───────────────────────────────────────────────────────
+exports.AGGREGATION_INTENTS = [
+    {
+        op: 'sum',
+        pattern: buildPattern([
+            // English
+            'sum', 'total', 'altogether', 'combined', 'in total', 'all together',
+            // Serbian
+            'zbir', 'zbirno', 'ukupno', 'ukupan', 'ukupna', 'sveukupno',
+            // Chinese (Simplified + Traditional)
+            '合计', '总计', '总共', '总和', '合計', '合算',
+            // Hindi
+            'कुल', 'जोड़', 'योग',
+            // Spanish
+            'suma', 'en total',
+            // French
+            'somme', 'au total',
+            // Arabic
+            'مجموع', 'إجمالي', 'المجموع',
+            // Bengali
+            'মোট', 'যোগফল',
+            // Portuguese
+            'soma', 'no total',
+            // Russian
+            'итого', 'сумма', 'всего',
+            // Japanese (shares CJK characters above)
+        ]),
+    },
+    {
+        op: 'average',
+        pattern: buildPattern([
+            // English
+            'average', 'mean', 'avg',
+            // Serbian
+            'prosek', 'prose[čc]n[aoie]',
+            // Chinese
+            '平均', '平均值',
+            // Hindi
+            'औसत',
+            // Spanish
+            'promedio',
+            // French
+            'moyenne',
+            // Arabic
+            'متوسط', 'معدل',
+            // Bengali
+            'গড়',
+            // Portuguese
+            'm[eé]dia',
+            // Russian
+            'среднее', 'средн',
+            // Japanese
+            '平均値',
+        ]),
+    },
+    {
+        op: 'max',
+        pattern: buildPattern([
+            // English
+            'highest', 'maximum', 'most', 'largest', 'top', 'biggest', 'greatest',
+            // Serbian
+            'najv[ei][cć][aie]', 'najvi[sš]e',
+            // Chinese
+            '最高', '最大', '最多',
+            // Hindi
+            'सबसे ज्यादा', 'सबसे अधिक',
+            // Spanish
+            'm[aá]ximo', 'mayor',
+            // French
+            'le plus',
+            // Arabic
+            'الأعلى', 'الأكثر', 'أقصى',
+            // Bengali
+            'সবচেয়ে বেশি', 'সর্বোচ্চ',
+            // Portuguese
+            'maior',
+            // Russian
+            'максимум', 'наибольш',
+            // Japanese
+            '一番',
+        ]),
+    },
+    {
+        op: 'min',
+        pattern: buildPattern([
+            // English
+            'lowest', 'minimum', 'least', 'smallest', 'fewest',
+            // Serbian
+            'najm[ae]nj[aie]', 'najmanje',
+            // Chinese
+            '最低', '最小', '最少',
+            // Hindi
+            'सबसे कम', 'सबसे न्यून',
+            // Spanish
+            'm[ií]nimo', 'menor',
+            // French
+            'le moins',
+            // Arabic
+            'الأقل', 'الأدنى', 'أقل',
+            // Bengali
+            'সবচেয়ে কম', 'সর্বনিম্ন',
+            // Russian
+            'минимум', 'наименьш',
+        ]),
+    },
+    {
+        op: 'difference',
+        pattern: buildPattern([
+            // English
+            'difference', 'differ', 'gap between',
+            // Serbian
+            'razlika',
+            // Chinese
+            '差异', '差别', '差距',
+            // Hindi
+            'अंतर', 'फर्क',
+            // Spanish
+            'diferencia',
+            // French
+            'diff[eé]rence',
+            // Arabic
+            'الفرق',
+            // Bengali
+            'পার্থক্য',
+            // Portuguese
+            'diferen[cç]a',
+            // Russian
+            'разниц',
+            // Japanese
+            '違い',
+        ]),
+    },
+];
+exports.GROUPING_INTENTS = [
+    // English
+    { label: 'by X', pattern: /\b(?:by|per|for each|for every|grouped by|group by|broken down by|breakdown by|split by|segmented by)\s+/i },
+    // Serbian
+    { label: 'po X', pattern: /\b(?:po|za svak[oiue]g?|po svakom|prema|grupisano po|grupi[sš]i po|podeljeno po|razbijeno po)\s+/i },
+    // Chinese
+    { label: '按X', pattern: /(?:按|每个|分[类別别]|各个?|逐个?)/ },
+    // Hindi
+    { label: 'प्रति X', pattern: /(?:प्रति|हर\s*एक|के\s*अनुसार|विभाग\s*के)/ },
+    // Spanish
+    { label: 'por X', pattern: /\b(?:por|para cada|agrupado por|desglosado por)\s+/i },
+    // French
+    { label: 'par X', pattern: /\b(?:par|pour chaque|group[eé] par|ventil[eé] par)\s+/i },
+    // Arabic
+    { label: 'لكل X', pattern: /(?:لكل|حسب|بحسب|وفق)/ },
+    // Bengali
+    { label: 'প্রতি X', pattern: /(?:প্রতি|প্রত্যেক|অনুসারে)/ },
+    // Portuguese
+    { label: 'por X', pattern: /\b(?:por|para cada|agrupado por|dividido por)\s+/i },
+    // Russian
+    { label: 'по X', pattern: /(?:по каждому|по каждой|по\s+(?!\d)|для каждого|для каждой|в разрезе|сгруппирован)/i },
+    // Japanese
+    { label: 'ごとに', pattern: /(?:ごとに|別に|毎に|分類)/ },
+];
+exports.TRANSFORMATIONAL_INTENTS = [
+    {
+        label: 'net_vs_gross',
+        pattern: buildPattern([
+            // English
+            'net', 'gross', 'after[- ]?tax', 'before[- ]?tax', 'take[- ]?home',
+            'pre[- ]?tax', 'post[- ]?tax', 'after deductions',
+            // Serbian
+            'neto', 'bruto', 'nakon poreza', 'pre poreza', 'posle poreza',
+            'nakon odbitaka', 'posle odbitaka', 'čist[ao]',
+            // Chinese
+            '净', '毛', '税后', '税前', '到手',
+            // Hindi
+            'शुद्ध', 'सकल', 'कर के बाद', 'कर से पहले',
+            // Spanish
+            'neto', 'bruto', 'despu[eé]s de impuestos', 'antes de impuestos',
+            // French
+            'apr[eè]s imp[oô]ts?', 'avant imp[oô]ts?',
+            // Russian
+            'чист', 'после налог', 'до налог', 'на руки',
+        ]),
+    },
+    {
+        label: 'discount_adjustment',
+        pattern: buildPattern([
+            'discounted', 'with discount', 'after discount', 'adjusted',
+            'normalized', 'annualized', 'prorated', 'pro[- ]?rata',
+            // Serbian
+            'sa popustom', 'sa rabatom', 'korigovano', 'anualizirano',
+            'srazmer[ao]', 'proporcionalno',
+            // Chinese
+            '折扣后', '调整后', '年化',
+            // Russian
+            'со скидкой', 'скорректирован', 'аннуализирован',
+        ]),
+    },
+    {
+        label: 'derived_metric',
+        pattern: buildPattern([
+            'margin', 'ratio', 'rate of', 'percentage of', 'share of',
+            'turnover rate', 'attrition rate', 'retention rate', 'utilization',
+            // Serbian
+            'mar[žz]a', 'stopa', 'procenat', 'u[čc]e[sš][ćc]e', 'fluktuacija',
+            // Chinese
+            '利润率', '比率', '百分比', '周转率', '流失率',
+            // Russian
+            'маржа', 'коэффициент', 'доля', 'текучесть',
+        ]),
+    },
+];
+//# sourceMappingURL=intents.js.map

package/dist-npm/Rules/intents.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * Trace Readiness Check — assesses trace quality before evaluation.
+ *
+ * Answers two fundamental questions:
+ *   1. Is this trace complete enough for reliable grounding analysis?
+ *   2. What CANNOT be verified given the missing elements?
+ *
+ * The goal is to help users distinguish "no evidence of error" from
+ * "we found evidence of an error" — the CT-scan analogy.
+ */
+import type { Trace } from '../types';
+export type TraceElement = 'system_prompt' | 'user_input' | 'tool_calls' | 'tool_outputs' | 'final_response';
+export interface ContractElement {
+    element: TraceElement;
+    /** Is this element required for any evaluation at all? */
+    required: boolean;
+    /** What grounding capabilities depend on this element? */
+    enables: string[];
+}
+export declare const TRACE_CONTRACT: ContractElement[];
+export type TraceQuality = 'HIGH' | 'MEDIUM' | 'LOW';
+export interface ChecklistItem {
+    element: TraceElement;
+    present: boolean;
+    required: boolean;
+}
+export interface TraceQualityReport {
+    /** Overall quality assessment. */
+    quality: TraceQuality;
+    /** Completeness percentage (0–100). */
+    completeness: number;
+    /** Per-element checklist. */
+    checklist: ChecklistItem[];
+    /** Whether the trace has enough data for reliable grounding. */
+    groundingReady: boolean;
+    /** Specific capabilities that CANNOT be verified due to missing elements. */
+    cannotVerify: string[];
+    /** Human-readable recommendation for what to add. */
+    recommendations: string[];
+}
+export declare function assessTraceQuality(trace: Trace): TraceQualityReport;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/TraceReadiness/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,UAAU,CAAC;AAOrD,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,eAAe,EA0B3C,CAAC;AAMF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,gEAAgE;IAChE,cAAc,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA2CD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAwGnE"}

package/dist-npm/TraceReadiness/index.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Trace Readiness Check — assesses trace quality before evaluation.
+ *
+ * Answers two fundamental questions:
+ *   1. Is this trace complete enough for reliable grounding analysis?
+ *   2. What CANNOT be verified given the missing elements?
+ *
+ * The goal is to help users distinguish "no evidence of error" from
+ * "we found evidence of an error" — the CT-scan analogy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACE_CONTRACT = void 0;
+exports.assessTraceQuality = assessTraceQuality;
+const Trace_1 = require("../Trace");
+exports.TRACE_CONTRACT = [
+    {
+        element: 'user_input',
+        required: true,
+        enables: ['query validation', 'wrong_query detection', 'scope verification'],
+    },
+    {
+        element: 'final_response',
+        required: true,
+        enables: ['claim extraction', 'all grounding checks'],
+    },
+    {
+        element: 'tool_calls',
+        required: false,
+        enables: ['query parameter verification', 'scope/period validation', 'wrong_query detection'],
+    },
+    {
+        element: 'tool_outputs',
+        required: false,
+        enables: ['data accuracy verification', 'numeric grounding', 'entity matching', 'date verification'],
+    },
+    {
+        element: 'system_prompt',
+        required: false,
+        enables: ['instruction compliance checks', 'name/entity grounding from prompt'],
+    },
+];
+// ---------------------------------------------------------------------------
+// Impact mapping — what each missing element prevents
+// ---------------------------------------------------------------------------
+const MISSING_IMPACT = {
+    user_input: [
+        'Cannot validate query correctness (wrong_query)',
+        'Cannot verify scope or period parameters',
+    ],
+    final_response: [
+        'Cannot extract claims — no response to evaluate',
+        'Cannot perform any grounding checks',
+    ],
+    tool_calls: [
+        'Cannot verify query parameters were correct',
+        'Cannot detect wrong_query errors',
+        'Cannot validate period/scope correctness',
+    ],
+    tool_outputs: [
+        'Cannot verify data accuracy (numbers, dates, names)',
+        'Cannot detect empty_fabrication',
+        'Cannot perform numeric grounding',
+        'Cannot detect entity mismatches',
+    ],
+    system_prompt: [
+        'Cannot verify instruction compliance',
+    ],
+};
+const MISSING_RECOMMENDATIONS = {
+    user_input: 'Store the user\'s original question/request as a step with role "user_input".',
+    final_response: 'Store the agent\'s final answer as a step with role "final_response".',
+    tool_calls: 'Store each tool/function call with role "tool_call", including toolCalls[{toolName, parameters}].',
+    tool_outputs: 'Store each tool response with role "tool_output", including toolOutputs[{toolName, output}].',
+    system_prompt: 'Optionally store the system prompt with role "system_prompt" for instruction compliance checks.',
+};
+// ---------------------------------------------------------------------------
+// Core assessment function
+// ---------------------------------------------------------------------------
+function assessTraceQuality(trace) {
+    const roles = new Set(trace.steps.map((s) => s.role));
+    // Check each contract element
+    const hasUserInput = roles.has('user_input');
+    const hasFinalResponse = roles.has('final_response');
+    const hasToolCalls = Trace_1.TraceUtils.hasToolCalls(trace);
+    const toolOutputSteps = Trace_1.TraceUtils.getToolOutputSteps(trace);
+    const hasToolOutputs = toolOutputSteps.some((s) => (s.toolOutputs ?? []).some((to) => to.output !== null && to.output !== undefined));
+    const hasSystemPrompt = roles.has('system_prompt');
+    const presence = {
+        user_input: hasUserInput,
+        final_response: hasFinalResponse,
+        tool_calls: hasToolCalls,
+        tool_outputs: hasToolOutputs,
+        system_prompt: hasSystemPrompt,
+    };
+    // Build checklist
+    const checklist = exports.TRACE_CONTRACT.map((ce) => ({
+        element: ce.element,
+        present: presence[ce.element],
+        required: ce.required,
+    }));
+    // Completeness: required elements count double
+    const weights = {
+        user_input: 2,
+        final_response: 2,
+        tool_calls: 3,
+        tool_outputs: 3,
+        system_prompt: 1,
+    };
+    let totalWeight = 0;
+    let presentWeight = 0;
+    for (const item of checklist) {
+        const w = weights[item.element];
+        totalWeight += w;
+        if (item.present)
+            presentWeight += w;
+    }
+    const completeness = Math.round((presentWeight / totalWeight) * 100);
+    // Grounding readiness: needs tool_outputs for reliable grounding
+    const groundingReady = hasToolOutputs && hasFinalResponse;
+    // Collect impacts of missing elements
+    const cannotVerify = [];
+    for (const [element, impact] of Object.entries(MISSING_IMPACT)) {
+        if (!presence[element]) {
+            cannotVerify.push(...impact);
+        }
+    }
+    // Detect tool-name-only outputs: steps that had content but it was just
+    // the function name, not actual data (set by normalizeTrace via _toolNameOnly metadata)
+    const toolNameOnlySteps = toolOutputSteps.filter((s) => s.metadata && typeof s.metadata._toolNameOnly === 'string');
+    const toolNameOnlyNames = toolNameOnlySteps.map((s) => s.metadata._toolNameOnly);
+    // Recommendations for missing elements
+    const recommendations = [];
+    // Highest priority: tool-name-only is a critical instrumentation problem
+    if (toolNameOnlyNames.length > 0) {
+        const examples = [...new Set(toolNameOnlyNames)].slice(0, 3).join(', ');
+        recommendations.push(`CRITICAL: Your tool_output steps contain only the function name (${examples}) instead of actual API response data. ` +
+            `The "content" field of tool_output must contain the real data returned by the tool (e.g., JSON with names, numbers, dates). ` +
+            `Without real data, TruthGuard cannot verify any claims. Fix your trace capture to store the tool's return value.`);
+    }
+    for (const [element, rec] of Object.entries(MISSING_RECOMMENDATIONS)) {
+        if (!presence[element]) {
+            // Skip system_prompt recommendation when everything else is present
+            if (element === 'system_prompt' && cannotVerify.length <= 1)
+                continue;
+            recommendations.push(rec);
+        }
+    }
+    // Quality level
+    let quality;
+    if (groundingReady && hasUserInput && hasToolCalls) {
+        quality = 'HIGH';
+    }
+    else if (hasFinalResponse && (hasToolOutputs || hasToolCalls)) {
+        quality = 'MEDIUM';
+    }
+    else {
+        quality = 'LOW';
+    }
+    return {
+        quality,
+        completeness,
+        checklist,
+        groundingReady,
+        cannotVerify,
+        recommendations,
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Centralized multilingual constants for TruthGuard.
+ *
+ * Single source of truth for month names, stop words, and query stop words.
+ * Imported by Claims, Rules, and other modules to avoid duplication.
+ *
+ * Covers 11 languages: English, Spanish, French, Portuguese, Serbian,
+ * Russian, Hindi, Arabic, Bengali, Mandarin Chinese, Japanese.
+ */
+/** English month names (full + abbreviated). */
+export declare const EN_MONTHS = "january|jan|february|feb|march|mar|april|apr|may|june|jun|july|jul|august|aug|september|sep|sept|october|oct|november|nov|december|dec";
+/** Serbian month names (nominative + genitive). */
+export declare const SR_MONTHS = "januar|januara|februar|februara|mart|marta|maj|maja|avgust|avgusta|septembar|septembra|oktobar|oktobra|novembar|novembra|decembar|decembra";
+/** Spanish month names. */
+export declare const ES_MONTHS = "enero|febrero|marzo|abril|mayo|junio|julio|agosto|septiembre|octubre|noviembre|diciembre";
+/** French month names (with and without accents). */
+export declare const FR_MONTHS = "janvier|f\u00E9vrier|fevrier|mars|avril|mai|juin|juillet|ao\u00FBt|aout|septembre|octobre|novembre|d\u00E9cembre|decembre";
+/** Portuguese month names (with and without accents). */
+export declare const PT_MONTHS = "janeiro|fevereiro|mar\u00E7o|marco|maio|junho|julho|setembro|outubro|novembro|dezembro";
+/** Russian month names (nominative + genitive). */
+export declare const RU_MONTHS = "\u044F\u043D\u0432\u0430\u0440\u044C|\u0444\u0435\u0432\u0440\u0430\u043B\u044C|\u043C\u0430\u0440\u0442|\u0430\u043F\u0440\u0435\u043B\u044C|\u043C\u0430\u0439|\u0438\u044E\u043D\u044C|\u0438\u044E\u043B\u044C|\u0430\u0432\u0433\u0443\u0441\u0442|\u0441\u0435\u043D\u0442\u044F\u0431\u0440\u044C|\u043E\u043A\u0442\u044F\u0431\u0440\u044C|\u043D\u043E\u044F\u0431\u0440\u044C|\u0434\u0435\u043A\u0430\u0431\u0440\u044C|\u044F\u043D\u0432\u0430\u0440\u044F|\u0444\u0435\u0432\u0440\u0430\u043B\u044F|\u043C\u0430\u0440\u0442\u0430|\u0430\u043F\u0440\u0435\u043B\u044F|\u043C\u0430\u044F|\u0438\u044E\u043D\u044F|\u0438\u044E\u043B\u044F|\u0430\u0432\u0433\u0443\u0441\u0442\u0430|\u0441\u0435\u043D\u0442\u044F\u0431\u0440\u044F|\u043E\u043A\u0442\u044F\u0431\u0440\u044F|\u043D\u043E\u044F\u0431\u0440\u044F|\u0434\u0435\u043A\u0430\u0431\u0440\u044F";
+/** Hindi month names. */
+export declare const HI_MONTHS = "\u091C\u0928\u0935\u0930\u0940|\u092B\u0930\u0935\u0930\u0940|\u092E\u093E\u0930\u094D\u091A|\u0905\u092A\u094D\u0930\u0948\u0932|\u092E\u0908|\u091C\u0942\u0928|\u091C\u0941\u0932\u093E\u0908|\u0905\u0917\u0938\u094D\u0924|\u0938\u093F\u0924\u0902\u092C\u0930|\u0905\u0915\u094D\u0924\u0942\u092C\u0930|\u0928\u0935\u0902\u092C\u0930|\u0926\u093F\u0938\u0902\u092C\u0930";
+/** Arabic month names. */
+export declare const AR_MONTHS = "\u064A\u0646\u0627\u064A\u0631|\u0641\u0628\u0631\u0627\u064A\u0631|\u0645\u0627\u0631\u0633|\u0623\u0628\u0631\u064A\u0644|\u0645\u0627\u064A\u0648|\u064A\u0648\u0646\u064A\u0648|\u064A\u0648\u0644\u064A\u0648|\u0623\u063A\u0633\u0637\u0633|\u0633\u0628\u062A\u0645\u0628\u0631|\u0623\u0643\u062A\u0648\u0628\u0631|\u0646\u0648\u0641\u0645\u0628\u0631|\u062F\u064A\u0633\u0645\u0628\u0631";
+/** Bengali month names. */
+export declare const BN_MONTHS = "\u099C\u09BE\u09A8\u09C1\u09AF\u09BC\u09BE\u09B0\u09BF|\u09AB\u09C7\u09AC\u09CD\u09B0\u09C1\u09AF\u09BC\u09BE\u09B0\u09BF|\u09AE\u09BE\u09B0\u09CD\u099A|\u098F\u09AA\u09CD\u09B0\u09BF\u09B2|\u09AE\u09C7|\u099C\u09C1\u09A8|\u099C\u09C1\u09B2\u09BE\u0987|\u0986\u0997\u09B8\u09CD\u099F|\u09B8\u09C7\u09AA\u09CD\u099F\u09C7\u09AE\u09CD\u09AC\u09B0|\u0985\u0995\u09CD\u099F\u09CB\u09AC\u09B0|\u09A8\u09AD\u09C7\u09AE\u09CD\u09AC\u09B0|\u09A1\u09BF\u09B8\u09C7\u09AE\u09CD\u09AC\u09B0";
+/** Chinese/Japanese month names (十二月 and 十一月 first to avoid prefix match). */
+export declare const ZH_JA_MONTHS = "\u5341\u4E8C\u6708|\u5341\u4E00\u6708|\u4E00\u6708|\u4E8C\u6708|\u4E09\u6708|\u56DB\u6708|\u4E94\u6708|\u516D\u6708|\u4E03\u6708|\u516B\u6708|\u4E5D\u6708|\u5341\u6708";
+/** All month names across all 11 languages (pipe-separated for regex). */
+export declare const ALL_MONTHS: string;
+export declare const MONTH_MAP: Record<string, string>;
+/**
+ * Common English words that frequently appear in section headers, labels,
+ * and bullet points when title-cased. Names composed entirely of these
+ * are almost certainly headings, not real entity names.
+ */
+export declare const HEADING_STOP_WORDS: Set<string>;
+/**
+ * Common function words to skip when extracting meaningful terms from text.
+ * Used by partial_answer detection and irrelevant_context detection.
+ */
+export declare const QUERY_STOP_WORDS: Set<string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,gDAAgD;AAChD,eAAO,MAAM,SAAS,2IAA2I,CAAC;AAClK,mDAAmD;AACnD,eAAO,MAAM,SAAS,+IAA+I,CAAC;AACtK,2BAA2B;AAC3B,eAAO,MAAM,SAAS,6FAA6F,CAAC;AACpH,qDAAqD;AACrD,eAAO,MAAM,SAAS,8HAA+G,CAAC;AACtI,yDAAyD;AACzD,eAAO,MAAM,SAAS,2FAAsF,CAAC;AAC7G,mDAAmD;AACnD,eAAO,MAAM,SAAS,w1BAAsK,CAAC;AAC7L,yBAAyB;AACzB,eAAO,MAAM,SAAS,wXAA4E,CAAC;AACnG,0BAA0B;AAC1B,eAAO,MAAM,SAAS,0YAA+E,CAAC;AACtG,2BAA2B;AAC3B,eAAO,MAAM,SAAS,oeAA8F,CAAC;AACrH,8EAA8E;AAC9E,eAAO,MAAM,YAAY,4KAA0C,CAAC;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,UAAU,QAA8H,CAAC;AAMtJ,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8C5C,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,aAc7B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAK3B,CAAC"}