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

package/package-dist/chatntc-history/indexedDb.js

@@ -0,0 +1,258 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { migrateConversationV1, readConversation } from "./schema.js";
+import { ChatHistoryError } from "./types.js";
+const DATABASE_VERSION = 2;
+const STORES = ["conversations", "state"];
+function stored(value) {
+    try {
+        return readConversation(value);
+    }
+    catch (_a) {
+        throw new ChatHistoryError("CORRUPT");
+    }
+}
+const summary = (_a) => {
+    var { messages } = _a, conversation = __rest(_a, ["messages"]);
+    return (Object.assign(Object.assign({}, conversation), { messageCount: messages.length }));
+};
+/** Opt-in and lazy: importing or constructing this adapter does not open a database. */
+export class IndexedDbChatHistoryStore {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    open() {
+        if (this.opening)
+            return this.opening;
+        const opening = new Promise((resolve, reject) => {
+            var _a, _b;
+            let factory;
+            try {
+                factory = (_a = this.options.indexedDB) !== null && _a !== void 0 ? _a : globalThis.indexedDB;
+            }
+            catch ( /* Browser storage policy. */_c) { /* Browser storage policy. */ }
+            if (!factory) {
+                reject(new ChatHistoryError("UNAVAILABLE"));
+                return;
+            }
+            let request;
+            try {
+                request = factory.open((_b = this.options.name) !== null && _b !== void 0 ? _b : "structural-codes-chatntc", DATABASE_VERSION);
+            }
+            catch (_d) {
+                reject(new ChatHistoryError("UNAVAILABLE"));
+                return;
+            }
+            let failed = false;
+            let upgradeFailed = false;
+            request.onblocked = () => { failed = true; reject(new ChatHistoryError("BLOCKED")); };
+            request.onupgradeneeded = (event) => {
+                const db = request.result;
+                const tx = request.transaction;
+                const abort = () => { upgradeFailed = true; tx.abort(); };
+                if (failed) {
+                    abort();
+                    return;
+                }
+                try {
+                    if (event.oldVersion === 0) {
+                        db.createObjectStore("conversations", { keyPath: "id" }).createIndex("updatedAt", "updatedAt");
+                        db.createObjectStore("state");
+                    }
+                    else if (event.oldVersion === 1) {
+                        if (!STORES.every((name) => db.objectStoreNames.contains(name))) {
+                            abort();
+                            return;
+                        }
+                        const conversations = tx.objectStore("conversations");
+                        if (!conversations.indexNames.contains("updatedAt"))
+                            conversations.createIndex("updatedAt", "updatedAt");
+                        const cursor = conversations.openCursor();
+                        cursor.onsuccess = () => {
+                            try {
+                                if (!cursor.result)
+                                    return;
+                                cursor.result.update(migrateConversationV1(cursor.result.value));
+                                cursor.result.continue();
+                            }
+                            catch (_a) {
+                                abort();
+                            }
+                        };
+                    }
+                    else
+                        abort();
+                }
+                catch (_a) {
+                    abort();
+                }
+            };
+            request.onerror = () => { var _a; failed = true; reject(new ChatHistoryError(upgradeFailed || ((_a = request.error) === null || _a === void 0 ? void 0 : _a.name) === "VersionError" ? "UPGRADE_FAILED" : "UNAVAILABLE")); };
+            request.onsuccess = () => {
+                const db = request.result;
+                if (failed) {
+                    db.close();
+                    return;
+                }
+                if (!STORES.every((name) => db.objectStoreNames.contains(name))) {
+                    db.close();
+                    reject(new ChatHistoryError("CORRUPT"));
+                    return;
+                }
+                db.onversionchange = () => { db.close(); this.opening = undefined; };
+                db.onclose = () => { this.opening = undefined; };
+                resolve(db);
+            };
+        });
+        this.opening = opening;
+        void opening.catch(() => { if (this.opening === opening)
+            this.opening = undefined; });
+        return opening;
+    }
+    async close() { const db = await this.opening; db === null || db === void 0 ? void 0 : db.close(); this.opening = undefined; }
+    /** Resolve only after commit. All IDB requests are queued synchronously in request handlers. */
+    async transaction(mode, work) {
+        const db = await this.open();
+        return new Promise((resolve, reject) => {
+            let tx;
+            try {
+                tx = db.transaction(STORES, mode);
+            }
+            catch (_a) {
+                reject(new ChatHistoryError("UNAVAILABLE"));
+                return;
+            }
+            let result;
+            let failure;
+            const guard = (callback) => () => {
+                try {
+                    callback();
+                }
+                catch (error) {
+                    failure = error instanceof ChatHistoryError ? error : new ChatHistoryError(mode === "readonly" ? "CORRUPT" : "WRITE_FAILED");
+                    tx.abort();
+                }
+            };
+            tx.oncomplete = () => resolve(result);
+            tx.onabort = () => reject(failure !== null && failure !== void 0 ? failure : new ChatHistoryError(mode === "readonly" ? "CORRUPT" : "WRITE_FAILED"));
+            guard(() => work(tx, (value) => { result = value; }, guard))();
+        });
+    }
+    listConversations() {
+        return this.transaction("readonly", (tx, done, guard) => {
+            const request = tx.objectStore("conversations").openCursor();
+            const rows = [];
+            request.onsuccess = guard(() => {
+                if (request.result) {
+                    rows.push(summary(stored(request.result.value)));
+                    request.result.continue();
+                }
+                else
+                    done(rows.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt) || a.id.localeCompare(b.id)));
+            });
+        });
+    }
+    getConversation(id) {
+        return this.transaction("readonly", (tx, done, guard) => {
+            const request = tx.objectStore("conversations").get(id);
+            request.onsuccess = guard(() => done(request.result === undefined ? null : stored(request.result)));
+        });
+    }
+    async createConversation(input) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const now = ((_c = (_b = (_a = this.options).now) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : new Date()).toISOString();
+        const conversation = readConversation(Object.assign(Object.assign({}, input), { id: (_f = (_e = (_d = this.options).id) === null || _e === void 0 ? void 0 : _e.call(_d)) !== null && _f !== void 0 ? _f : crypto.randomUUID(), schemaVersion: 2, revision: 1, createdAt: now, updatedAt: now, messages: (_g = input.messages) !== null && _g !== void 0 ? _g : [] }));
+        return this.transaction("readwrite", (tx, done) => { tx.objectStore("conversations").add(conversation); done(conversation); });
+    }
+    updateConversation(id, patch, expectedRevision) {
+        // Validate/copy the caller's data before an asynchronous transaction can observe mutations.
+        if (Object.keys(patch).some((key) => key !== "title" && key !== "messages"))
+            return Promise.reject(new ChatHistoryError("INVALID_DATA"));
+        const snapshot = structuredClone(patch);
+        return this.transaction("readwrite", (tx, done, guard) => {
+            const store = tx.objectStore("conversations");
+            const request = store.get(id);
+            request.onsuccess = guard(() => {
+                var _a, _b, _c;
+                if (!request.result)
+                    throw new ChatHistoryError("CONFLICT");
+                const previous = stored(request.result);
+                if (previous.revision !== expectedRevision)
+                    throw new ChatHistoryError("CONFLICT");
+                const updatedAt = new Date(Math.max(((_c = (_b = (_a = this.options).now) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : new Date()).getTime(), Date.parse(previous.updatedAt) + 1)).toISOString();
+                const next = readConversation(Object.assign(Object.assign(Object.assign({}, previous), snapshot), { updatedAt, revision: previous.revision + 1 }));
+                store.put(next);
+                done(next);
+            });
+        });
+    }
+    deleteConversation(id, expectedRevision) {
+        return this.transaction("readwrite", (tx, done, guard) => {
+            const store = tx.objectStore("conversations");
+            const request = store.get(id);
+            request.onsuccess = guard(() => {
+                if (!request.result || stored(request.result).revision !== expectedRevision)
+                    throw new ChatHistoryError("CONFLICT");
+                store.delete(id);
+                const active = tx.objectStore("state").get("activeConversationId");
+                active.onsuccess = guard(() => { if (active.result === id)
+                    tx.objectStore("state").put(null, "activeConversationId"); done(); });
+            });
+        });
+    }
+    deleteAllConversations(expected) {
+        const snapshot = structuredClone(expected);
+        return this.transaction("readwrite", (tx, done, guard) => {
+            const store = tx.objectStore("conversations");
+            const request = store.getAll();
+            request.onsuccess = guard(() => {
+                const current = request.result.map(stored);
+                if (new Set(snapshot.map((c) => c.id)).size !== snapshot.length || current.length !== snapshot.length
+                    || current.some((c) => !snapshot.some((s) => s.id === c.id && s.revision === c.revision)))
+                    throw new ChatHistoryError("CONFLICT");
+                store.clear();
+                tx.objectStore("state").put(null, "activeConversationId");
+                done();
+            });
+        });
+    }
+    getActiveConversationId() {
+        return this.transaction("readonly", (tx, done, guard) => {
+            const request = tx.objectStore("state").get("activeConversationId");
+            request.onsuccess = guard(() => {
+                if (request.result === undefined || request.result === null) {
+                    done(null);
+                    return;
+                }
+                if (typeof request.result !== "string")
+                    throw new ChatHistoryError("CORRUPT");
+                const id = request.result;
+                const conversation = tx.objectStore("conversations").get(id);
+                conversation.onsuccess = guard(() => { if (!conversation.result)
+                    throw new ChatHistoryError("CORRUPT"); stored(conversation.result); done(id); });
+            });
+        });
+    }
+    setActiveConversationId(id) {
+        return this.transaction("readwrite", (tx, done, guard) => {
+            const save = () => { tx.objectStore("state").put(id, "activeConversationId"); done(); };
+            if (id === null) {
+                save();
+                return;
+            }
+            const request = tx.objectStore("conversations").get(id);
+            request.onsuccess = guard(() => { if (!request.result)
+                throw new ChatHistoryError("CONFLICT"); stored(request.result); save(); });
+        });
+    }
+}
+//# sourceMappingURL=indexedDb.js.map

package/package-dist/chatntc-history/indexedDb.js.map

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

package/package-dist/chatntc-history/schema.d.ts

@@ -0,0 +1,5 @@
+import { type ChatConversation } from "./types.js";
+/** Closed fields at every boundary prevent accidentally persisting config, keys or whole evidence. */
+export declare function readConversation(value: unknown): ChatConversation;
+/** Fixture/legacy v1 had the same messages and timestamps but no optimistic revision. */
+export declare function migrateConversationV1(value: unknown): ChatConversation;

package/package-dist/chatntc-history/schema.js

@@ -0,0 +1,102 @@
+import { isChatNTCResponse } from "../chatntc/responseContract.js";
+import { ChatHistoryError } from "./types.js";
+const object = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+const text = (value) => typeof value === "string" && value.length > 0;
+const nullableText = (value) => value === null || text(value);
+const date = (value) => text(value) && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
+const keys = (value, allowed) => Object.keys(value).every((key) => allowed.includes(key));
+const optionalText = (value) => value === undefined || text(value);
+/** Closed fields at every boundary prevent accidentally persisting config, keys or whole evidence. */
+export function readConversation(value) {
+    var _a;
+    value = adaptLegacyV3References(value);
+    function invalid() { throw new ChatHistoryError("INVALID_DATA"); }
+    if (!object(value) || !keys(value, ["id", "schemaVersion", "revision", "title", "createdAt", "updatedAt", "messages"])
+        || value.schemaVersion !== 2 || !text(value.id) || !text(value.title) || value.title.length > 144
+        || !Number.isSafeInteger(value.revision) || value.revision < 1
+        || !date(value.createdAt) || !date(value.updatedAt) || String(value.updatedAt) < String(value.createdAt)
+        || !Array.isArray(value.messages))
+        return invalid();
+    const ids = new Set();
+    for (let i = 0; i < value.messages.length; i++) {
+        const message = value.messages[i];
+        if (!object(message) || !text(message.id) || ids.has(message.id) || !text(message.content) || !date(message.timestamp))
+            return invalid();
+        ids.add(message.id);
+        if (message.role === "user") {
+            if (!keys(message, ["id", "role", "content", "timestamp", "context", "status", "error"])
+                || !["pending", "complete", "error", "cancelled"].includes(String(message.status)) || !optionalText(message.error))
+                return invalid();
+            const context = message.context;
+            if (context !== undefined && (!object(context) || !keys(context, ["documentId", "unitId", "numbering", "blockId", "assetId"])
+                || !["ntc2018", "circ2019"].includes(String(context.documentId)) || !text(context.unitId) || !text(context.numbering)
+                || !optionalText(context.blockId) || !optionalText(context.assetId)))
+                return invalid();
+            if (message.status === "complete" && ((_a = value.messages[i + 1]) === null || _a === void 0 ? void 0 : _a.role) !== "assistant")
+                return invalid();
+        }
+        else if (message.role === "assistant") {
+            const previous = value.messages[i - 1];
+            const hydrated = object(message.answer) && message.answer.formatVersion === 3
+                ? Object.assign(Object.assign({}, message.answer), { answerMarkdown: message.content }) : object(message.answer) ? Object.assign(Object.assign({}, message.answer), { answer: message.content }) : null;
+            if (!keys(message, ["id", "role", "turnId", "content", "timestamp", "answer", "provenance", "evidenceWarnings", "evidenceReduced"])
+                || (previous === null || previous === void 0 ? void 0 : previous.role) !== "user" || previous.id !== message.turnId || previous.status !== "complete"
+                || !object(message.answer) || "answer" in message.answer || "answerMarkdown" in message.answer
+                || !hydrated || !isChatNTCResponse(hydrated))
+                return invalid();
+            // The core response guard rejects unknown fields in claims and citations as well.
+            const p = message.provenance;
+            if (!object(p) || !keys(p, ["provider", "model", "structuralCodesVersion", "corpusFingerprint", "artifactFingerprint", "policyVersion", "outcome", "aiGenerated", "validation"])
+                || !nullableText(p.provider) || !nullableText(p.model) || !nullableText(p.structuralCodesVersion)
+                || !text(p.corpusFingerprint) || !text(p.artifactFingerprint) || !text(p.policyVersion)
+                || !["generated", "abstained"].includes(String(p.outcome)) || (p.aiGenerated !== undefined && p.aiGenerated !== true) || !object(p.validation)
+                || !keys(p.validation, ["valid", "scope", "stage"]) || p.validation.valid !== true
+                || !["integrity-provenance-claim-coverage", "integrity-provenance-reference-resolution"].includes(String(p.validation.scope))
+                || (p.validation.stage !== undefined && !["GENERATED", "NORMALIZED", "REFERENCES_RESOLVED", "EXPANDED", "REPAIRED", "CONSERVATIVE_REGENERATED", "PARTIALLY_SANITIZED", "DEGRADED", "HARD_REJECTED"].includes(String(p.validation.stage)))
+                || typeof message.evidenceReduced !== "boolean" || !Array.isArray(message.evidenceWarnings)
+                || !message.evidenceWarnings.every((w) => object(w) && keys(w, ["code", "unitId"]) && text(w.code) && optionalText(w.unitId)))
+                return invalid();
+            if (!isChatNTCResponse(hydrated))
+                return invalid();
+            if (hydrated.formatVersion !== 3) {
+                const cited = new Set(hydrated.claims.flatMap((claim) => claim.citations.map((citation) => citation.evidenceId)));
+                if (cited.size !== hydrated.usedEvidenceIds.length || hydrated.usedEvidenceIds.some((id) => !cited.has(id)))
+                    return invalid();
+            }
+        }
+        else
+            return invalid();
+    }
+    return structuredClone(value);
+}
+/** Read early v3 snapshots whose verified references still reused the retrieval citation shape. */
+function adaptLegacyV3References(value) {
+    if (!object(value) || !Array.isArray(value.messages))
+        return value;
+    const clone = structuredClone(value);
+    if (!object(clone) || !Array.isArray(clone.messages))
+        return value;
+    for (const message of clone.messages) {
+        if (!object(message) || message.role !== "assistant" || !object(message.answer)
+            || message.answer.formatVersion !== 3 || !Array.isArray(message.answer.verifiedReferences))
+            continue;
+        message.answer.verifiedReferences = message.answer.verifiedReferences.map((reference) => {
+            if (!object(reference) || typeof reference.evidenceId !== "string" || reference.kind !== undefined)
+                return reference;
+            const current = Object.assign({}, reference);
+            delete current.evidenceId;
+            const assetId = typeof current.assetId === "string" ? current.assetId : "";
+            const kind = assetId.includes(":asset:formula:") ? "formula" : assetId.includes(":asset:table:") ? "table"
+                : assetId.includes(":asset:figure:") ? "figure" : typeof current.blockId === "string" ? "block" : "unit";
+            return Object.assign(Object.assign({}, current), { kind });
+        });
+    }
+    return clone;
+}
+/** Fixture/legacy v1 had the same messages and timestamps but no optimistic revision. */
+export function migrateConversationV1(value) {
+    if (!object(value) || value.schemaVersion !== 1 || "revision" in value)
+        throw new ChatHistoryError("INVALID_DATA");
+    return readConversation(Object.assign(Object.assign({}, value), { schemaVersion: 2, revision: 1 }));
+}
+//# sourceMappingURL=schema.js.map

package/package-dist/chatntc-history/schema.js.map

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

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

@@ -0,0 +1,78 @@
+import type { ChatNTCRetrievalContext, ChatNTCResponse } from "../chatntc/types.js";
+import type { ChatResult } from "../chatntc-ui/transport.js";
+export declare const CHAT_HISTORY_SCHEMA_VERSION: 2;
+export interface ChatHistoryUserMessage {
+    id: string;
+    role: "user";
+    content: string;
+    timestamp: string;
+    context?: ChatNTCRetrievalContext;
+    status: "pending" | "complete" | "error" | "cancelled";
+    error?: string;
+}
+/** A compact historical snapshot of a server-validated result, not fresh normative evidence. */
+export interface ChatHistoryAssistantMessage {
+    id: string;
+    role: "assistant";
+    turnId: string;
+    content: string;
+    timestamp: string;
+    answer: ChatHistoryAnswer;
+    provenance: {
+        provider: string | null;
+        model: string | null;
+        structuralCodesVersion: string | null;
+        corpusFingerprint: string;
+        artifactFingerprint: string;
+        policyVersion: string;
+        outcome: ChatResult["generation"]["outcome"];
+        aiGenerated?: true;
+        validation: ChatResult["validation"];
+    };
+    evidenceWarnings: ChatResult["evidence"]["warnings"];
+    evidenceReduced: boolean;
+}
+type StoredResponse<T> = T extends {
+    formatVersion: 3;
+} ? Omit<T, "answerMarkdown"> : Omit<T, "answer">;
+export type ChatHistoryAnswer = StoredResponse<ChatNTCResponse>;
+export type ChatHistoryMessage = ChatHistoryUserMessage | ChatHistoryAssistantMessage;
+export interface ChatConversation {
+    id: string;
+    schemaVersion: typeof CHAT_HISTORY_SCHEMA_VERSION;
+    revision: number;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: ChatHistoryMessage[];
+}
+export type ChatConversationSummary = Omit<ChatConversation, "messages"> & {
+    messageCount: number;
+};
+export interface ChatHistoryStore {
+    listConversations(): Promise<ChatConversationSummary[]>;
+    getConversation(id: string): Promise<ChatConversation | null>;
+    createConversation(input: {
+        title: string;
+        messages?: ChatHistoryMessage[];
+    }): Promise<ChatConversation>;
+    /** Compare-and-swap: stale revisions must fail instead of overwriting another tab's work. */
+    updateConversation(id: string, patch: {
+        title?: string;
+        messages?: ChatHistoryMessage[];
+    }, expectedRevision: number): Promise<ChatConversation>;
+    deleteConversation(id: string, expectedRevision: number): Promise<void>;
+    /** The confirmed snapshot prevents clearing conversations created/edited in another tab meanwhile. */
+    deleteAllConversations(expected: {
+        id: string;
+        revision: number;
+    }[]): Promise<void>;
+    getActiveConversationId(): Promise<string | null>;
+    setActiveConversationId(id: string | null): Promise<void>;
+}
+export declare class ChatHistoryError extends Error {
+    readonly code: "UNAVAILABLE" | "BLOCKED" | "UPGRADE_FAILED" | "CORRUPT" | "WRITE_FAILED" | "CONFLICT" | "INVALID_DATA";
+    constructor(code: "UNAVAILABLE" | "BLOCKED" | "UPGRADE_FAILED" | "CORRUPT" | "WRITE_FAILED" | "CONFLICT" | "INVALID_DATA");
+}
+export declare function titleFromQuestion(question: string): string;
+export {};

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

@@ -0,0 +1,23 @@
+export const CHAT_HISTORY_SCHEMA_VERSION = 2;
+export class ChatHistoryError extends Error {
+    constructor(code) {
+        const messages = {
+            UNAVAILABLE: "La cronologia locale non è disponibile in questo browser.",
+            BLOCKED: "Chiudi le altre schede del viewer e riprova per aggiornare la cronologia.",
+            UPGRADE_FAILED: "Aggiornamento della cronologia non riuscito. I dati esistenti non sono stati cancellati.",
+            CORRUPT: "La cronologia contiene dati non leggibili. I dati sono stati conservati; nessun ripristino automatico è stato eseguito.",
+            WRITE_FAILED: "Salvataggio locale non riuscito. Mantieni aperta questa pagina e riprova.",
+            CONFLICT: "La conversazione è cambiata in un'altra scheda. I dati locali non sono stati sovrascritti.",
+            INVALID_DATA: "I dati della conversazione non rispettano il formato della cronologia.",
+        };
+        super(messages[code]);
+        this.code = code;
+        this.name = "ChatHistoryError";
+    }
+}
+export function titleFromQuestion(question) {
+    const text = question.replace(/\s+/gu, " ").trim();
+    const chars = Array.from(text);
+    return chars.length > 72 ? `${chars.slice(0, 71).join("")}…` : text || "Nuova chat";
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../shared/chatntc-history/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAU,CAAC;AA0CtD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAqB,IAA6G;QAChI,MAAM,QAAQ,GAAG;YACf,WAAW,EAAE,2DAA2D;YACxE,OAAO,EAAE,2EAA2E;YACpF,cAAc,EAAE,0FAA0F;YAC1G,OAAO,EAAE,yHAAyH;YAClI,YAAY,EAAE,2EAA2E;YACzF,QAAQ,EAAE,4FAA4F;YACtG,YAAY,EAAE,wEAAwE;SACvF,CAAC;QACF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAVH,SAAI,GAAJ,IAAI,CAAyG;QAUzG,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACxD,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,YAAY,CAAC;AACtF,CAAC"}

package/package-dist/chatntc-ui/ChatNTCHistoryPanel.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import { type ChatHistoryStore } from "../chatntc-history/types.js";
+import { type ChatNTCPanelProps } from "./ChatNTCPanel.js";
+export interface ChatNTCHistoryPanelProps extends Omit<ChatNTCPanelProps, "initialTurns" | "onTurnsChange" | "onNewChat" | "historyEnabled" | "disabled"> {
+    historyStore: ChatHistoryStore;
+    settings?: ReactNode;
+}
+/** This component knows only ChatHistoryStore. No IndexedDB, provider, HTTP or key configuration. */
+export declare function ChatNTCHistoryPanel({ historyStore: store, settings, ...panelProps }: ChatNTCHistoryPanelProps): import("react/jsx-runtime").JSX.Element;