structural-codes-viewer 0.1.0-alpha.2 → 0.1.0-alpha.3

package/package-dist/chatntc/responseContract.js

@@ -1,73 +0,0 @@
-const classifications = ["direct-reference", "combined-reference", "interpretation", "no-direct-reference", "external-source"];
-const nonEmptyString = { type: "string", pattern: "\\S" };
-/**
- * Minimal provider wire schema. Canonical citation metadata is reconstructed server-side.
- * The global classification plus explicit prose distinctions are intentional: another provider
- * assertion would not give the server deterministic semantic-entailment verification.
- */
-export const CHATNTC_RESPONSE_JSON_SCHEMA = {
-    $schema: "http://json-schema.org/draft-07/schema#",
-    title: "ChatNTCProviderOutput v2",
-    type: "object", additionalProperties: false,
-    required: ["formatVersion", "evidencePackageId", "answerMarkdown", "references", "classification", "status", "needsMoreEvidence", "externalResearchSuggested"],
-    properties: {
-        formatVersion: { const: 2 }, evidencePackageId: nonEmptyString,
-        answerMarkdown: Object.assign(Object.assign({}, nonEmptyString), { description: "Risposta utile e naturale: distingue prescrizioni sostenute dal testo disponibile, letture coordinate e ragionamento ingegneristico generale senza etichettare ogni frase." }),
-        references: { type: "array", maxItems: 24, items: nonEmptyString,
-            description: "Riferimenti testuali da risolvere canonicamente. Un riferimento reale o pertinente non prova da solo che sostenga semanticamente la conclusione." },
-        classification: { enum: classifications,
-            description: "Base epistemica conservativa della conclusione centrale: direct-reference solo per una conclusione normativa esplicitamente sostenuta e nel medesimo scope; combined-reference per più proposizioni direttamente sostenute da più riferimenti senza nuova inferenza; interpretation per coordinamento o inferenza tra disposizioni; no-direct-reference per una conclusione tecnica non formulata direttamente dalla norma, compatibile con status answered; external-source non è abilitata." },
-        status: { enum: ["answered", "partial", "abstained"] },
-        needsMoreEvidence: { type: "boolean" }, externalResearchSuggested: { type: "boolean" },
-    },
-};
-const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const text = (value) => typeof value === "string" && value.trim().length > 0;
-const strings = (value) => Array.isArray(value) && value.every(text);
-const keys = (value, allowed) => Object.keys(value).every((key) => allowed.includes(key));
-const classification = (value) => typeof value === "string" && classifications.includes(value);
-export function isChatNTCProviderOutput(value) {
-    return object(value) && keys(value, ["formatVersion", "evidencePackageId", "answerMarkdown", "references", "classification", "status", "needsMoreEvidence", "externalResearchSuggested"])
-        && value.formatVersion === 2 && text(value.evidencePackageId) && text(value.answerMarkdown)
-        && strings(value.references) && value.references.length <= 24
-        && classification(value.classification) && ["answered", "partial", "abstained"].includes(String(value.status))
-        && typeof value.needsMoreEvidence === "boolean" && typeof value.externalResearchSuggested === "boolean";
-}
-function isCitation(value) {
-    return object(value) && keys(value, ["evidenceId", "unitId", "document", "numbering", "blockId", "assetId", "assetNumber"])
-        && text(value.evidenceId) && text(value.unitId) && text(value.numbering)
-        && (value.document === "ntc2018" || value.document === "circ2019")
-        && (value.blockId === undefined || text(value.blockId))
-        && (value.assetId === undefined || text(value.assetId))
-        && (value.assetNumber === undefined || value.assetNumber === null || text(value.assetNumber));
-}
-function isVerifiedReference(value) {
-    return object(value) && keys(value, ["unitId", "document", "numbering", "kind", "blockId", "assetId", "assetNumber"])
-        && text(value.unitId) && text(value.numbering)
-        && (value.document === "ntc2018" || value.document === "circ2019")
-        && ["unit", "block", "formula", "table", "figure"].includes(String(value.kind))
-        && (value.blockId === undefined || text(value.blockId))
-        && (value.assetId === undefined || text(value.assetId))
-        && (value.assetNumber === undefined || value.assetNumber === null || text(value.assetNumber));
-}
-/** Reusable structural check for adapters that do not run retrieval. */
-export function isChatNTCResponse(value) {
-    if (object(value) && value.formatVersion === 3) {
-        return keys(value, ["formatVersion", "evidencePackageId", "answerMarkdown", "classification", "status", "verifiedReferences", "referenceWarning", "warnings", "needsMoreEvidence", "externalResearchSuggested"])
-            && text(value.evidencePackageId) && text(value.answerMarkdown) && classification(value.classification)
-            && ["answered", "partial", "abstained"].includes(String(value.status))
-            && Array.isArray(value.verifiedReferences) && value.verifiedReferences.every(isVerifiedReference)
-            && (value.referenceWarning === undefined || ["some-references-omitted", "no-references-verified"].includes(String(value.referenceWarning)))
-            && strings(value.warnings) && typeof value.needsMoreEvidence === "boolean" && typeof value.externalResearchSuggested === "boolean";
-    }
-    return object(value) && keys(value, ["formatVersion", "evidencePackageId", "answer", "classification", "status", "claims", "usedEvidenceIds", "warnings", "needsMoreEvidence", "externalResearchSuggested"])
-        && (value.formatVersion === 1 ? value.status === undefined
-            : value.formatVersion === 2 && ["answered", "partial", "abstained"].includes(String(value.status)))
-        && text(value.evidencePackageId) && text(value.answer)
-        && classification(value.classification) && strings(value.usedEvidenceIds) && strings(value.warnings)
-        && typeof value.needsMoreEvidence === "boolean" && typeof value.externalResearchSuggested === "boolean"
-        && Array.isArray(value.claims) && value.claims.every((claim) => object(claim)
-        && keys(claim, ["id", "text", "classification", "citations"]) && text(claim.id) && text(claim.text)
-        && classification(claim.classification) && Array.isArray(claim.citations) && claim.citations.every(isCitation));
-}
-//# sourceMappingURL=responseContract.js.map

package/package-dist/chatntc/responseContract.js.map

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

package/package-dist/chatntc/retrieval.d.ts

@@ -1,5 +0,0 @@
-import type { ChatNTCEvidencePackage, ChatNTCRepository, ChatNTCRetrievalOptions } from "./types.js";
-export declare class ChatNTCContextError extends Error {
-    constructor();
-}
-export declare function retrieveChatNTCEvidence(repository: ChatNTCRepository, question: string, input?: ChatNTCRetrievalOptions): Promise<ChatNTCEvidencePackage>;

package/package-dist/chatntc/retrieval.js

@@ -1,220 +0,0 @@
-import { findCrossReferences } from "../crossReferences.js";
-import { tokenizeSearchText } from "../searchEngine.js";
-import { CHATNTC_DEFAULT_RETRIEVAL, CHATNTC_EPISTEMIC_POLICY } from "./policy.js";
-import { evidencePackageId, evidenceUnitSelectionLength, projectEvidenceBlock, projectEvidenceHierarchy, projectEvidenceUnit, stableJson } from "./evidence.js";
-const compare = (a, b) => a < b ? -1 : a > b ? 1 : 0;
-export class ChatNTCContextError extends Error {
-    constructor() { super("ChatNTC: contesto non corrispondente al corpus."); this.name = "ChatNTCContextError"; }
-}
-function optionsFor(input) {
-    const configured = Object.assign({}, input);
-    delete configured.queryContext;
-    delete configured.requiredReferences;
-    const options = Object.assign(Object.assign({}, CHATNTC_DEFAULT_RETRIEVAL), configured);
-    for (const key of ["maxPrimaryUnits", "maxRelatedUnits", "maxChildrenPerUnit", "maxEvidenceCharacters", "maxUnitCharacters"]) {
-        const minimum = key === "maxRelatedUnits" || key === "maxChildrenPerUnit" ? 0 : 1;
-        const maximum = key.endsWith("Characters") ? 1000000 : 50;
-        if (!Number.isSafeInteger(options[key]) || options[key] < minimum || options[key] > maximum)
-            throw new Error(`ChatNTC: opzione non valida: ${key}`);
-    }
-    for (const key of ["includeParents", "includeCrossReferences", "includeExplicitRelations", "includeProposedRelations"]) {
-        if (typeof options[key] !== "boolean")
-            throw new Error(`ChatNTC: opzione non valida: ${key}`);
-    }
-    if (options.document && options.document !== "ntc2018" && options.document !== "circ2019")
-        throw new Error("ChatNTC: documento non valido.");
-    return options;
-}
-function selectUnit(record, hierarchy, candidate, question, budget) {
-    const projected = record.unit.blocks.map((block) => projectEvidenceBlock(block, record));
-    const base = Object.assign(Object.assign({}, projectEvidenceUnit(record, hierarchy)), { reasons: candidate.reasons });
-    const build = (positions) => (Object.assign(Object.assign({}, base), { blocks: [...positions].sort((a, b) => a - b).map((position) => projected[position]), selection: { complete: positions.length === projected.length, omittedBlocks: projected.length - positions.length } }));
-    const full = build(projected.map((_, position) => position));
-    if (evidenceUnitSelectionLength(full) <= budget)
-        return full;
-    const terms = new Set(tokenizeSearchText(question));
-    const priority = projected.map((block, position) => {
-        var _a, _b;
-        const tokens = tokenizeSearchText((_b = (_a = block.text) === null || _a === void 0 ? void 0 : _a.normalized) !== null && _b !== void 0 ? _b : "");
-        const termScore = new Set(tokens.filter((term) => terms.has(term))).size;
-        return { position, score: candidate.targetBlocks.has(block.blockId) ? 1000000
-                : termScore * 100 + (block.kind === "heading" ? 1 : 0) };
-    }).sort((a, b) => b.score - a.score || a.position - b.position);
-    const positions = [];
-    for (const { position } of priority) {
-        // Whole blocks/assets only. A large table is omitted, never cut into misleading cells.
-        if (evidenceUnitSelectionLength(build([...positions, position])) <= budget)
-            positions.push(position);
-    }
-    return positions.length ? build(positions) : null;
-}
-function relationScore(relation) {
-    if (relation.kind === "explicit-relation")
-        return relation.reviewStatus === "confirmed" ? 900 : 800;
-    if (relation.kind === "cross-reference")
-        return relation.direction === "incoming" ? 600 : 700;
-    return relation.kind === "parent" ? 500 : 400;
-}
-export async function retrieveChatNTCEvidence(repository, question, input = {}) {
-    var _a, _b, _c, _d, _e;
-    if (typeof question !== "string" || !question.trim())
-        throw new Error("ChatNTC: domanda vuota.");
-    if (input.queryContext && (!Array.isArray(input.queryContext) || input.queryContext.some((item) => typeof item !== "string" || !item.trim())))
-        throw new Error("ChatNTC: contesto query non valido.");
-    if (input.requiredReferences && (!Array.isArray(input.requiredReferences) || input.requiredReferences.length > 12
-        || input.requiredReferences.some((item) => typeof item !== "string" || !item.trim() || item.length > 120)))
-        throw new Error("ChatNTC: riferimenti richiesti non validi.");
-    const options = optionsFor(input);
-    const queryContext = [...((_a = input.queryContext) !== null && _a !== void 0 ? _a : [])].slice(-3);
-    const retrievalQuery = [question, ...queryContext].join("\n");
-    const corpus = await repository.identity();
-    const warnings = [];
-    let reduced = false;
-    const exact = await repository.resolveExact(question, options.document);
-    let hits = exact !== null && exact !== void 0 ? exact : [];
-    const explicitUnitIds = new Set((exact !== null && exact !== void 0 ? exact : []).map((hit) => hit.unitId));
-    if ((exact === null || exact === void 0 ? void 0 : exact.length) === 0)
-        warnings.push({ code: "unresolved-reference" });
-    if (exact === null) {
-        const references = findCrossReferences(question);
-        if (references.length > 12)
-            reduced = true;
-        for (const reference of references.slice(0, 12)) {
-            const resolved = await repository.resolveExact(reference.text, options.document);
-            if ((resolved === null || resolved === void 0 ? void 0 : resolved.length) === 0)
-                warnings.push({ code: "unresolved-reference" });
-            for (const hit of resolved !== null && resolved !== void 0 ? resolved : [])
-                explicitUnitIds.add(hit.unitId);
-            hits.push(...(resolved !== null && resolved !== void 0 ? resolved : []));
-        }
-        for (const contextualReference of findCrossReferences(queryContext.join("\n")).slice(0, 12)) {
-            hits.push(...((_b = await repository.resolveExact(contextualReference.text, options.document)) !== null && _b !== void 0 ? _b : []));
-        }
-        // Existing full-text ranking is authoritative for text hits; no new search index.
-        hits.push(...await repository.search(retrievalQuery, Math.min(50, options.maxPrimaryUnits + 4), options.document));
-    }
-    for (const reference of (_c = input.requiredReferences) !== null && _c !== void 0 ? _c : []) {
-        const resolved = await repository.resolveExact(reference, options.document);
-        if ((resolved === null || resolved === void 0 ? void 0 : resolved.length) === 0)
-            warnings.push({ code: "unresolved-reference" });
-        for (const hit of resolved !== null && resolved !== void 0 ? resolved : [])
-            explicitUnitIds.add(hit.unitId);
-        hits.push(...(resolved !== null && resolved !== void 0 ? resolved : []));
-    }
-    hits = [...hits].sort((a, b) => { var _a, _b; return b.score - a.score || compare(a.unitId, b.unitId) || compare((_a = a.blockId) !== null && _a !== void 0 ? _a : "", (_b = b.blockId) !== null && _b !== void 0 ? _b : ""); });
-    const primaryCandidates = new Map();
-    if (options.context) {
-        const context = options.context;
-        explicitUnitIds.add(context.unitId);
-        const record = await repository.getUnit(context.unitId);
-        const block = record === null || record === void 0 ? void 0 : record.unit.blocks.find((item) => context.blockId ? item.blockId === context.blockId : context.assetId && item.assetId === context.assetId);
-        if (!record || record.unit.document !== context.documentId || record.unit.numbering.official !== context.numbering
-            || (options.document && context.documentId !== options.document)
-            || (context.blockId && !block) || (context.assetId && (block === null || block === void 0 ? void 0 : block.assetId) !== context.assetId))
-            throw new ChatNTCContextError();
-        // Reserve one bounded primary slot for the explicit user hint; search above still runs unchanged.
-        primaryCandidates.set(context.unitId, { unitId: context.unitId, score: 0,
-            reasons: [{ kind: "viewer-context", score: 0 }], targetBlocks: new Map(block ? [[block.blockId, block.assetId]] : []) });
-    }
-    for (const hit of hits) {
-        const candidate = (_d = primaryCandidates.get(hit.unitId)) !== null && _d !== void 0 ? _d : { unitId: hit.unitId, score: hit.score, reasons: [], targetBlocks: new Map() };
-        const reason = { kind: hit.match === "exact-reference" || hit.match === "number-exact" ? "exact-reference" : "full-text", score: hit.score };
-        if (!candidate.reasons.some((item) => stableJson(item) === stableJson(reason)))
-            candidate.reasons.push(reason);
-        if (hit.assetId && !hit.blockId)
-            throw new Error("ChatNTC: target asset senza blocco proprietario.");
-        if (hit.blockId)
-            candidate.targetBlocks.set(hit.blockId, hit.assetId);
-        primaryCandidates.set(hit.unitId, candidate);
-    }
-    if (primaryCandidates.size > options.maxPrimaryUnits)
-        reduced = true;
-    let remaining = options.maxEvidenceCharacters;
-    const primaryUnits = [];
-    const relatedUnits = [];
-    async function collect(candidate, output) {
-        const record = await repository.getUnit(candidate.unitId);
-        if (!record)
-            throw new Error(`ChatNTC: target dell'indice assente: ${candidate.unitId}`);
-        if (options.document && record.unit.document !== options.document)
-            return;
-        for (const [blockId, assetId] of candidate.targetBlocks) {
-            const block = record.unit.blocks.find((entry) => entry.blockId === blockId);
-            if (!block || (assetId && block.assetId !== assetId))
-                throw new Error(`ChatNTC: target del rimando incoerente con il corpus: ${blockId}`);
-        }
-        const hierarchy = await projectEvidenceHierarchy(record, (unitId) => repository.getUnit(unitId));
-        const selected = selectUnit(record, hierarchy, candidate, question, Math.min(remaining, options.maxUnitCharacters));
-        if (!selected) {
-            reduced = true;
-            return;
-        }
-        if (!selected.selection.complete)
-            reduced = true;
-        remaining -= evidenceUnitSelectionLength(selected);
-        output.push(selected);
-    }
-    const rankedPrimary = [...primaryCandidates.values()].sort((a, b) => Number(explicitUnitIds.has(b.unitId)) - Number(explicitUnitIds.has(a.unitId))
-        || b.score - a.score || compare(a.unitId, b.unitId));
-    const explicitCount = rankedPrimary.filter((candidate) => explicitUnitIds.has(candidate.unitId)).length;
-    for (const candidate of rankedPrimary.slice(0, Math.max(options.maxPrimaryUnits, explicitCount)))
-        await collect(candidate, primaryUnits);
-    const relatedCandidates = new Map();
-    const primaryIds = new Set(primaryUnits.map((unit) => unit.unitId));
-    for (const primary of options.maxRelatedUnits > 0 ? primaryUnits : []) {
-        let children = 0;
-        const usefulChildren = primary.reasons.some((reason) => reason.kind === "exact-reference" || reason.kind === "viewer-context") || primary.blocks.every((block) => block.kind === "heading");
-        const links = [...await repository.related(primary.unitId)]
-            .sort((a, b) => relationScore(b) - relationScore(a) || compare(stableJson(a), stableJson(b)));
-        for (const relation of links) {
-            if (primaryIds.has(relation.unitId))
-                continue;
-            // Canonical URNs encode the document; filter before consuming relation/child slots.
-            if (options.document && !relation.unitId.startsWith(`urn:structural-codes:it:unit:${options.document}:`))
-                continue;
-            if (relation.kind === "parent" && !options.includeParents)
-                continue;
-            if (relation.kind === "child") {
-                if (!usefulChildren || options.maxChildrenPerUnit === 0)
-                    continue;
-                if (children++ >= options.maxChildrenPerUnit) {
-                    reduced = true;
-                    continue;
-                }
-            }
-            if (relation.kind === "cross-reference" && !options.includeCrossReferences)
-                continue;
-            if (relation.kind === "explicit-relation" && (!options.includeExplicitRelations || relation.reviewStatus === "rejected"
-                || (relation.reviewStatus !== "confirmed" && !options.includeProposedRelations)))
-                continue;
-            const candidate = (_e = relatedCandidates.get(relation.unitId)) !== null && _e !== void 0 ? _e : { unitId: relation.unitId, score: relationScore(relation), reasons: [], targetBlocks: new Map() };
-            if (!candidate.reasons.some((reason) => stableJson(reason) === stableJson(relation)))
-                candidate.reasons.push(relation);
-            candidate.score = Math.max(candidate.score, relationScore(relation));
-            if (relation.blockId)
-                candidate.targetBlocks.set(relation.blockId, relation.assetId);
-            relatedCandidates.set(relation.unitId, candidate);
-        }
-    }
-    const ranked = [...relatedCandidates.values()].sort((a, b) => b.score - a.score || compare(a.unitId, b.unitId));
-    if (ranked.length > options.maxRelatedUnits)
-        reduced = true;
-    for (const candidate of ranked.slice(0, options.maxRelatedUnits))
-        await collect(candidate, relatedUnits);
-    for (const unit of [...primaryUnits, ...relatedUnits]) {
-        if (unit.blocks.some((block) => { var _a; return ((_a = block.asset) === null || _a === void 0 ? void 0 : _a.kind) === "figure"; }))
-            warnings.push({ code: "figure-metadata-only", unitId: unit.unitId });
-    }
-    if (!primaryUnits.length)
-        warnings.push({ code: "no-evidence" });
-    if (reduced)
-        warnings.push({ code: "evidence-reduced" });
-    const value = {
-        formatVersion: 1, policyVersion: CHATNTC_EPISTEMIC_POLICY.version, question, corpus, primaryUnits, relatedUnits,
-        retrieval: { options, query: retrievalQuery, evidenceCharacters: options.maxEvidenceCharacters - remaining, reduced },
-        warnings: [...new Map(warnings.map((warning) => [stableJson(warning), warning])).values()],
-    };
-    // Detach the returned package from cached corpus objects; consumers cannot mutate the corpus through it.
-    return JSON.parse(JSON.stringify(Object.assign(Object.assign({}, value), { packageId: await evidencePackageId(value) })));
-}
-//# sourceMappingURL=retrieval.js.map

package/package-dist/chatntc/retrieval.js.map

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

package/package-dist/chatntc/types.d.ts

@@ -1,240 +0,0 @@
-import type { AssetBundle, CorpusBlock, CorpusManifest, CorpusUnit, DocumentId, FigureAsset, FormulaAsset, TableAsset, SearchMatchKind } from "../corpusData.js";
-export type ChatNTCClassification = "direct-reference" | "combined-reference" | "interpretation" | "no-direct-reference" | "external-source";
-export type ChatNTCAnswerStatus = "answered" | "partial" | "abstained";
-export interface ChatNTCCorpusIdentity {
-    sourceOfTruth: "structural-codes";
-    version: string;
-    schemaVersion: string;
-    assetSchemaVersion: string;
-    fingerprint: string;
-    artifactFingerprint: string;
-    status: string;
-    disclaimer: string;
-    documents: Record<DocumentId, Pick<CorpusManifest["documents"][DocumentId], "shortLabel" | "sourceId" | "sourceUrl" | "sourceSha256" | "publicationUrl">>;
-}
-export interface ChatNTCTarget {
-    unitId: string;
-    blockId?: string;
-    assetId?: string;
-}
-export interface ChatNTCRetrievalContext extends ChatNTCTarget {
-    documentId: DocumentId;
-    numbering: string;
-}
-export interface ChatNTCHit extends ChatNTCTarget {
-    score: number;
-    match: "exact-reference" | SearchMatchKind;
-}
-export interface ChatNTCRelation extends ChatNTCTarget {
-    kind: "parent" | "child" | "explicit-relation" | "cross-reference";
-    fromUnitId: string;
-    sourceBlockId?: string;
-    direction?: "outgoing" | "incoming";
-    relationId?: string;
-    relationType?: string;
-    basis?: string;
-    reviewStatus?: string;
-    evidenceBlockIds?: string[];
-}
-/** A repository instance represents one immutable corpus snapshot. */
-export interface ChatNTCRepository {
-    identity(): Promise<ChatNTCCorpusIdentity>;
-    /** null = not exact syntax; [] = recognized reference, absent from this snapshot. */
-    resolveExact(query: string, document?: DocumentId): Promise<ChatNTCHit[] | null>;
-    search(query: string, limit: number, document?: DocumentId): Promise<ChatNTCHit[]>;
-    getUnit(unitId: string): Promise<ChatNTCUnitRecord | null>;
-    related(unitId: string): Promise<ChatNTCRelation[]>;
-}
-export interface ChatNTCUnitRecord {
-    unit: CorpusUnit;
-    assets: AssetBundle;
-    provenance: {
-        chunkPath: string;
-        chunkFingerprint: string;
-    };
-}
-export type ChatNTCEvidenceAsset = {
-    kind: "formula";
-    data: FormulaAsset;
-} | {
-    kind: "table";
-    data: TableAsset;
-} | {
-    kind: "figure";
-    data: FigureAsset;
-    contentAvailability: "metadata-only";
-};
-export interface ChatNTCEvidenceBlock {
-    /** Canonical block ID, stable across retrievals of the same snapshot. */
-    evidenceId: string;
-    blockId: string;
-    kind: string;
-    origin: string;
-    listMarker?: CorpusBlock["listMarker"];
-    listLevel?: number;
-    indentLevel?: number;
-    text?: Pick<NonNullable<CorpusBlock["text"]>, "normalized" | "inline">;
-    assetId?: string;
-    asset?: ChatNTCEvidenceAsset;
-    provenance?: Pick<NonNullable<CorpusBlock["evidence"]>, "sourceId" | "pdfPage" | "printedPage" | "region" | "normalizedSha256">;
-}
-export interface ChatNTCEvidenceHierarchyEntry {
-    numbering: string;
-    title: string;
-}
-export interface ChatNTCEvidenceUnit {
-    /** Unit citations refer only to the selected blocks, never omitted content. */
-    evidenceId: string;
-    unitId: string;
-    document: DocumentId;
-    numbering: string;
-    title: string;
-    /** Canonical ancestors from the document root through the immediate parent. */
-    hierarchy: ChatNTCEvidenceHierarchyEntry[];
-    editorial: CorpusUnit["review"];
-    validity: CorpusUnit["validity"];
-    provenance: ChatNTCUnitRecord["provenance"];
-    reasons: Array<{
-        kind: "exact-reference" | "full-text" | "viewer-context";
-        score: number;
-    } | ChatNTCRelation>;
-    blocks: ChatNTCEvidenceBlock[];
-    selection: {
-        complete: boolean;
-        omittedBlocks: number;
-    };
-}
-export interface ChatNTCRetrievalOptions {
-    /** Additional candidate, verified against the repository. Does not filter search. */
-    context?: ChatNTCRetrievalContext;
-    document?: DocumentId;
-    maxPrimaryUnits?: number;
-    maxRelatedUnits?: number;
-    maxChildrenPerUnit?: number;
-    /** UTF-16 selection length, including established unit metadata and assets but excluding additive hierarchy scope. Not tokens. */
-    maxEvidenceCharacters?: number;
-    maxUnitCharacters?: number;
-    includeParents?: boolean;
-    includeCrossReferences?: boolean;
-    includeExplicitRelations?: boolean;
-    includeProposedRelations?: boolean;
-    /** Previous USER messages only. They guide ranking but never become normative evidence. */
-    queryContext?: readonly string[];
-    /** Canonical textual references requested by the validator for one bounded expansion. */
-    requiredReferences?: readonly string[];
-}
-export interface ChatNTCWarning {
-    code: "no-evidence" | "evidence-reduced" | "figure-metadata-only" | "unresolved-reference";
-    unitId?: string;
-}
-export interface ChatNTCEvidencePackage {
-    formatVersion: 1;
-    packageId: string;
-    policyVersion: "chatntc-epistemic-v2";
-    question: string;
-    corpus: ChatNTCCorpusIdentity;
-    primaryUnits: ChatNTCEvidenceUnit[];
-    relatedUnits: ChatNTCEvidenceUnit[];
-    retrieval: {
-        options: Required<Omit<ChatNTCRetrievalOptions, "document" | "context" | "queryContext" | "requiredReferences">> & Pick<ChatNTCRetrievalOptions, "document" | "context">;
-        /** Deterministic retrieval query. Conversation text here is context, never evidence. */
-        query: string;
-        evidenceCharacters: number;
-        reduced: boolean;
-    };
-    warnings: ChatNTCWarning[];
-}
-export interface ChatNTCCitation extends ChatNTCTarget {
-    evidenceId: string;
-    document: DocumentId;
-    /** Official unit numbering; an asset's number is a separate field. */
-    numbering: string;
-    assetNumber?: string | null;
-}
-/**
- * Canonical post-hoc reference. Unlike a legacy citation, it is independent from the
- * Evidence Package selected before generation and therefore never invents an evidenceId.
- */
-export interface ChatNTCVerifiedReference extends ChatNTCTarget {
-    document: DocumentId;
-    /** Official unit numbering; an asset's number is a separate field. */
-    numbering: string;
-    kind: "unit" | "block" | "formula" | "table" | "figure";
-    assetNumber?: string | null;
-}
-export type ChatNTCReference = ChatNTCCitation | ChatNTCVerifiedReference;
-export type ChatNTCReferenceWarning = "some-references-omitted" | "no-references-verified";
-export interface ChatNTCClaim {
-    id: string;
-    text: string;
-    classification: ChatNTCClassification;
-    citations: ChatNTCCitation[];
-}
-/** Minimal provider wire output. References are textual; canonical metadata is server-owned. */
-export interface ChatNTCProviderOutput {
-    formatVersion: 2;
-    evidencePackageId: string;
-    answerMarkdown: string;
-    references: string[];
-    /**
-     * Conservative, response-level description of the epistemic basis of the central conclusion.
-     * It is not proof that references semantically entail the answer; the provider must express
-     * mixed normative, interpretative and engineering content clearly in answerMarkdown.
-     * A claim array is intentionally not part of the current provider contract.
-     */
-    classification: ChatNTCClassification;
-    status: ChatNTCAnswerStatus;
-    needsMoreEvidence: boolean;
-    externalResearchSuggested: boolean;
-}
-/** Historical public response retained for saved v1/v2 conversations. */
-export interface ChatNTCLegacyResponseBody {
-    evidencePackageId: string;
-    answer: string;
-    classification: ChatNTCClassification;
-    claims: ChatNTCClaim[];
-    usedEvidenceIds: string[];
-    warnings: string[];
-    needsMoreEvidence: boolean;
-    externalResearchSuggested: boolean;
-}
-/** v1 remains readable for saved history; providers generate the semantically explicit v2. */
-export type ChatNTCLegacyResponse = ChatNTCLegacyResponseBody & ({
-    formatVersion: 1;
-    status?: never;
-} | {
-    formatVersion: 2;
-    status: ChatNTCAnswerStatus;
-});
-/** Rich response produced by the server and consumed by current UI clients. */
-export interface CanonicalChatNTCResponse {
-    formatVersion: 3;
-    evidencePackageId: string;
-    answerMarkdown: string;
-    classification: ChatNTCClassification;
-    status: ChatNTCAnswerStatus;
-    verifiedReferences: ChatNTCVerifiedReference[];
-    referenceWarning?: ChatNTCReferenceWarning;
-    warnings: string[];
-    needsMoreEvidence: boolean;
-    externalResearchSuggested: boolean;
-}
-export type ChatNTCResponse = ChatNTCLegacyResponse | CanonicalChatNTCResponse;
-export type ChatNTCProcessingStage = "GENERATED" | "NORMALIZED" | "REFERENCES_RESOLVED" | "EXPANDED" | "REPAIRED" | "CONSERVATIVE_REGENERATED" | "PARTIALLY_SANITIZED" | "DEGRADED" | "HARD_REJECTED";
-export interface ChatNTCValidationIssue {
-    code: string;
-    path: string;
-    message: string;
-    category: "integrity" | "bookkeeping" | "discovery";
-    reference?: string;
-    targets?: ChatNTCTarget[];
-}
-export interface ChatNTCValidationResult {
-    valid: boolean;
-    issues: ChatNTCValidationIssue[];
-}
-export interface ChatNTCCanonicalizationResult {
-    response: CanonicalChatNTCResponse;
-    issues: ChatNTCValidationIssue[];
-    normalized: boolean;
-}

package/package-dist/chatntc/types.js

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

package/package-dist/chatntc/types.js.map

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

package/package-dist/chatntc/validation.d.ts

@@ -1,8 +0,0 @@
-import type { ChatNTCEvidencePackage, ChatNTCRepository, ChatNTCValidationResult } from "./types.js";
-/**
- * The package is supplied by the application, never by the provider. Provider output is unknown.
- * Current v3 responses are checked for package/corpus integrity and canonical references only.
- * Legacy claim accounting remains readable for saved v1/v2 responses. Success does NOT establish semantic support.
- * Repository I/O failures reject the promise, never turn into successful validation.
- */
-export declare function validateChatNTCResponse(response: unknown, evidence: ChatNTCEvidencePackage, repository: ChatNTCRepository): Promise<ChatNTCValidationResult>;