kiokuko-dsh 0.1.0

package/dist/dsh/user-interaction.js

@@ -0,0 +1,92 @@
+import { KiokukoError } from '../errors.js';
+import { renderPlanStartRecovery } from '../enno-oduno/plan-recovery.js';
+function conflict(message) {
+    throw new KiokukoError('CONFLICT', message);
+}
+/** Adapt the dsh user-question service to one exact Akinator question at a time. */
+export function createDshIntakeAnswerer(service) {
+    return {
+        async ask(question, signal) {
+            const result = await service.ask({
+                questions: [{
+                        id: question.id,
+                        question: question.prompt,
+                        ...(question.options === null ? {} : { options: question.options.map((label) => ({ label })) }),
+                    }],
+                ...(signal === undefined ? {} : { signal }),
+            });
+            const answer = result.answers[0];
+            if (answer === undefined || answer.id !== question.id)
+                conflict('User answer does not match the current Akinator question');
+            const value = answer.custom?.trim() || answer.selected[0]?.trim();
+            if (!value)
+                conflict('Akinator requires a non-empty user answer');
+            return value;
+        },
+    };
+}
+function confirmationText(confirmation) {
+    const lines = [
+        confirmation.title,
+        `Summary [${confirmation.summary.basis}]: ${confirmation.summary.text}`,
+        `Scope [${confirmation.scope.basis}]: ${confirmation.scope.paths.join(', ') || '(none)'}`,
+        `Exclusions [${confirmation.exclusions.basis}]: ${confirmation.exclusions.paths.join(', ') || '(none)'}`,
+        `Completion [${confirmation.completion.basis}]:`,
+        ...confirmation.completion.items.map((item, index) => `  ${index + 1}. ${item}`),
+        'Skills:',
+        ...confirmation.skills.map((skill) => `  - ${skill.label} [${skill.basis}] required=${skill.required} referenceOnly=${skill.referenceOnly} purposes=${skill.purposes.join(', ')}`),
+        'Work items:',
+        ...confirmation.workItems.flatMap((item) => [
+            `  ${item.number}. ${item.summary}`,
+            `     paths: ${item.paths.join(', ') || '(none)'}`,
+            `     dependsOn: ${item.dependsOn.join(', ') || '(none)'}`,
+            `     doneWhen: ${item.doneWhen.join(' | ') || '(none)'}`,
+            ...item.checks.map((check) => `     check: ${check.executable} ${check.arguments.join(' ')} [directory=${check.directory}, timeoutMs=${check.timeoutMs}]`),
+            ...item.expertise.map((expertise) => `     expertise: ${expertise.area} [${expertise.basis}] ${expertise.reason}`),
+        ]),
+        'Final checks:',
+        ...confirmation.finalChecks.checks.map((check) => `  - ${check.executable} ${check.arguments.join(' ')} [directory=${check.directory}, timeoutMs=${check.timeoutMs}]`),
+        `Attempt limit [${confirmation.attemptLimit.basis}]: ${confirmation.attemptLimit.maxAttempts}`,
+        'Choose one: approve, revise, cancel.',
+    ];
+    return lines.join('\n');
+}
+/** Render only the public confirmation projection; internal directive fields never cross this boundary. */
+export function renderDshConfirmation(confirmation) {
+    return confirmationText(confirmation);
+}
+/** Keep plan-recovery choices user-facing and free of machine identity fields. */
+export function renderDshPlanRecovery(recovery) {
+    return renderPlanStartRecovery(recovery);
+}
+/** Adapt one explicit confirmation choice to dsh UserQuestions. */
+export function createDshConfirmationAnswerer(service) {
+    return {
+        async ask(confirmation, signal) {
+            const result = await service.ask({
+                questions: [{
+                        id: 'kiokuko-plan-confirmation',
+                        question: renderDshConfirmation(confirmation),
+                        options: confirmation.actions.map((label) => ({ label })),
+                        multiSelect: false,
+                        intent: 'plan-confirmation',
+                    }],
+                ...(signal === undefined ? {} : { signal }),
+            });
+            const answer = result.answers[0];
+            if (answer === undefined || answer.id !== 'kiokuko-plan-confirmation')
+                conflict('Confirmation answer does not match the current request');
+            const selected = answer.selected.filter((value) => confirmation.actions.includes(value));
+            if (selected.length !== 1)
+                conflict('Confirmation requires exactly one supported action');
+            const action = selected[0];
+            const requestedChanges = answer.custom?.trim();
+            if (action === 'revise' && !requestedChanges)
+                conflict('Revision requires a non-empty description of the requested changes');
+            if (action !== 'revise' && requestedChanges !== undefined && requestedChanges.length > 0)
+                conflict('Only a revision may carry requested changes');
+            return { action, ...(requestedChanges === undefined ? {} : { requestedChanges }) };
+        },
+    };
+}
+//# sourceMappingURL=user-interaction.js.map

package/dist/dsh/user-interaction.js.map

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

package/dist/embedding/backend.d.ts

@@ -0,0 +1,27 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type ConnectionOptions } from '../db/connection.js';
+import { KiokukoError } from '../errors.js';
+import { type SqliteVecLoader } from './sqlite-vec-loader.js';
+import type { EmbeddingConfig, VectorSearchBackend } from './types.js';
+export type EmbeddingDatabaseOpener = (databasePath: string, options?: ConnectionOptions) => SqliteDatabase | PromiseLike<SqliteDatabase>;
+export interface OpenEmbeddingDatabaseOptions {
+    readonly config?: EmbeddingConfig;
+    readonly openDatabase?: EmbeddingDatabaseOpener;
+    readonly createLoader?: () => Promise<SqliteVecLoader | null>;
+    readonly backend?: VectorSearchBackend;
+}
+export interface OpenEmbeddingDatabaseResult {
+    readonly database: SqliteDatabase;
+    readonly backend: VectorSearchBackend | undefined;
+}
+/** A forced backend could not be selected; doctor may convert this to a finding. */
+export declare class EmbeddingBackendUnavailableError extends KiokukoError {
+    constructor();
+}
+/**
+ * Open one owned database connection and select the backend that is actually
+ * usable on that connection. Only the package-owned sqlite-vec loader can
+ * create an extension-enabled connection.
+ */
+export declare function openEmbeddingDatabase(databasePath: string, options: OpenEmbeddingDatabaseOptions): Promise<OpenEmbeddingDatabaseResult>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/embedding/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/embedding/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAsC,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,MAAM,uBAAuB,GAAG,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,iBAAiB,KACxB,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;AAElD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACnD;AAED,oFAAoF;AACpF,qBAAa,gCAAiC,SAAQ,YAAY;;CAKjE;AAMD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAyCtC"}

package/dist/embedding/backend.js

@@ -0,0 +1,67 @@
+import { openConnection, SqliteVecLoadError } from '../db/connection.js';
+import { KiokukoError } from '../errors.js';
+import { JavaScriptVectorSearchBackend } from './javascript-backend.js';
+import { createSqliteVecLoader } from './sqlite-vec-loader.js';
+import { SqliteVecVectorSearchBackend } from './sqlite-vec-backend.js';
+import { defaultEmbeddingConfig, readPersistedEmbeddingSettings } from './settings.js';
+/** A forced backend could not be selected; doctor may convert this to a finding. */
+export class EmbeddingBackendUnavailableError extends KiokukoError {
+    constructor() {
+        super('SERVICE_UNAVAILABLE', 'The configured sqlite-vec backend is unavailable');
+        this.name = 'EmbeddingBackendUnavailableError';
+    }
+}
+function forcedSqliteVecUnavailable() {
+    throw new EmbeddingBackendUnavailableError();
+}
+/**
+ * Open one owned database connection and select the backend that is actually
+ * usable on that connection. Only the package-owned sqlite-vec loader can
+ * create an extension-enabled connection.
+ */
+export async function openEmbeddingDatabase(databasePath, options) {
+    const openDatabase = options.openDatabase ?? openConnection;
+    if (options.backend !== undefined) {
+        return { database: await openDatabase(databasePath), backend: options.backend };
+    }
+    let config = options.config;
+    if (config === undefined) {
+        const probe = await openDatabase(databasePath);
+        try {
+            try {
+                config = readPersistedEmbeddingSettings(probe);
+            }
+            catch {
+                config = defaultEmbeddingConfig();
+            }
+        }
+        finally {
+            probe.close();
+        }
+    }
+    if (config.mode === 'off') {
+        return { database: await openDatabase(databasePath), backend: undefined };
+    }
+    const javascriptBackend = new JavaScriptVectorSearchBackend();
+    if (config.vectorBackend === 'javascript') {
+        return { database: await openDatabase(databasePath), backend: javascriptBackend };
+    }
+    const loader = await (options.createLoader ?? createSqliteVecLoader)();
+    if (loader === null) {
+        if (config.vectorBackend === 'sqlite-vec')
+            forcedSqliteVecUnavailable();
+        return { database: await openDatabase(databasePath), backend: javascriptBackend };
+    }
+    try {
+        const database = await openDatabase(databasePath, { sqliteVecLoader: loader });
+        return { database, backend: new SqliteVecVectorSearchBackend() };
+    }
+    catch (error) {
+        if (!(error instanceof SqliteVecLoadError))
+            throw error;
+        if (config.vectorBackend === 'sqlite-vec')
+            forcedSqliteVecUnavailable();
+        return { database: await openDatabase(databasePath), backend: javascriptBackend };
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/embedding/backend.js.map

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

package/dist/embedding/config.d.ts

@@ -0,0 +1,10 @@
+import type { EmbeddingConfig, EnabledEmbeddingConfig } from './types.js';
+export declare const DEPRECATED_EMBEDDING_ENVIRONMENT_VARIABLES: readonly ["KIOKUKO_EMBEDDINGS", "KIOKUKO_EMBEDDING_PROVIDER", "KIOKUKO_EMBEDDING_BASE_URL", "KIOKUKO_EMBEDDING_MODEL", "KIOKUKO_EMBEDDING_DIMENSIONS", "KIOKUKO_EMBEDDING_DISTANCE_CEILING", "KIOKUKO_EMBEDDING_API_KEY", "KIOKUKO_EMBEDDING_ALLOW_REMOTE", "KIOKUKO_EMBEDDING_TIMEOUT_MS", "KIOKUKO_EMBEDDING_BATCH_SIZE", "KIOKUKO_VECTOR_BACKEND"];
+/** Report only deprecated setting names; never inspect or return their values. */
+export declare function findDeprecatedEmbeddingEnvironmentVariables(environment?: NodeJS.ProcessEnv): readonly string[];
+/** Normalize and validate an embedding endpoint without retaining credentials. */
+export declare function normalizeEmbeddingBaseUrl(value: string, allowRemote: boolean): string;
+export declare function isEnabledEmbeddingConfig(config: EmbeddingConfig): config is EnabledEmbeddingConfig;
+export declare function requireEnabledEmbeddingConfig(config: EmbeddingConfig): EnabledEmbeddingConfig;
+export declare function parseEmbeddingConfig(environment?: NodeJS.ProcessEnv): EmbeddingConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/embedding/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/embedding/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAiE,MAAM,YAAY,CAAC;AAQzI,eAAO,MAAM,0CAA0C,uVAY5C,CAAC;AAEZ,kFAAkF;AAClF,wBAAgB,2CAA2C,CACzD,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,SAAS,MAAM,EAAE,CAEnB;AAkDD,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,CAoBrF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,sBAAsB,CAMlG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,GAAG,sBAAsB,CAG7F;AAED,wBAAgB,oBAAoB,CAAC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CAgClG"}

package/dist/embedding/config.js

@@ -0,0 +1,142 @@
+import { KiokukoError } from '../errors.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_BATCH_SIZE = 16;
+const MAX_MODEL_LENGTH = 256;
+const MAX_API_KEY_LENGTH = 4_096;
+const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '::1']);
+export const DEPRECATED_EMBEDDING_ENVIRONMENT_VARIABLES = Object.freeze([
+    'KIOKUKO_EMBEDDINGS',
+    'KIOKUKO_EMBEDDING_PROVIDER',
+    'KIOKUKO_EMBEDDING_BASE_URL',
+    'KIOKUKO_EMBEDDING_MODEL',
+    'KIOKUKO_EMBEDDING_DIMENSIONS',
+    'KIOKUKO_EMBEDDING_DISTANCE_CEILING',
+    'KIOKUKO_EMBEDDING_API_KEY',
+    'KIOKUKO_EMBEDDING_ALLOW_REMOTE',
+    'KIOKUKO_EMBEDDING_TIMEOUT_MS',
+    'KIOKUKO_EMBEDDING_BATCH_SIZE',
+    'KIOKUKO_VECTOR_BACKEND',
+]);
+/** Report only deprecated setting names; never inspect or return their values. */
+export function findDeprecatedEmbeddingEnvironmentVariables(environment = process.env) {
+    return DEPRECATED_EMBEDDING_ENVIRONMENT_VARIABLES.filter((name) => Object.hasOwn(environment, name));
+}
+function invalid(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function enumValue(value, fallback, allowed, field) {
+    const selected = value === undefined ? fallback : value;
+    if (!allowed.includes(selected))
+        invalid(`${field} has an unsupported value`);
+    return selected;
+}
+function boundedText(value, field, maxLength) {
+    const normalized = value.normalize('NFKC').trim();
+    if (normalized.length === 0 || normalized.length > maxLength || /[\u0000-\u001f\u007f]/u.test(normalized)) {
+        invalid(`${field} is invalid`);
+    }
+    return normalized;
+}
+function optionalText(value, field, maxLength) {
+    return value === undefined || value.length === 0 ? undefined : boundedText(value, field, maxLength);
+}
+function integerValue(value, fallback, minimum, maximum, field) {
+    if (value === undefined)
+        return fallback;
+    if (!/^\d+$/u.test(value))
+        invalid(`${field} must be an integer in the supported range`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < minimum || parsed > maximum) {
+        invalid(`${field} must be an integer in the supported range`);
+    }
+    return parsed;
+}
+function distanceCeilingValue(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^(?:\d+\.?\d*|\.\d+)$/u.test(value))
+        invalid('KIOKUKO_EMBEDDING_DISTANCE_CEILING is invalid');
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0 || parsed >= 2) {
+        invalid('KIOKUKO_EMBEDDING_DISTANCE_CEILING is invalid');
+    }
+    return parsed;
+}
+function booleanValue(value, fallback, field) {
+    if (value === undefined)
+        return fallback;
+    if (value !== 'true' && value !== 'false')
+        invalid(`${field} must be true or false`);
+    return value === 'true';
+}
+/** Normalize and validate an embedding endpoint without retaining credentials. */
+export function normalizeEmbeddingBaseUrl(value, allowRemote) {
+    const input = boundedText(value, 'KIOKUKO_EMBEDDING_BASE_URL', 2_048);
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must be an absolute URL');
+    }
+    if (url.username !== '' || url.password !== '' || url.search !== '' || url.hash !== '') {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must not contain credentials, query, or fragment data');
+    }
+    const hostname = url.hostname.replace(/^\[|\]$/gu, '').toLowerCase();
+    if (url.protocol === 'http:') {
+        if (!LOOPBACK_HOSTS.has(hostname))
+            invalid('HTTP embedding endpoints must use a loopback host');
+    }
+    else if (url.protocol === 'https:') {
+        if (!allowRemote)
+            invalid('HTTPS embedding endpoints require explicit remote opt-in');
+    }
+    else {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must use HTTP or HTTPS');
+    }
+    return url.toString();
+}
+export function isEnabledEmbeddingConfig(config) {
+    return config.mode !== 'off'
+        && config.baseUrl !== undefined
+        && config.model !== undefined
+        && config.dimensions !== undefined
+        && config.distanceCeiling !== undefined;
+}
+export function requireEnabledEmbeddingConfig(config) {
+    if (!isEnabledEmbeddingConfig(config))
+        invalid('Embedding configuration is disabled or incomplete');
+    return config;
+}
+export function parseEmbeddingConfig(environment = process.env) {
+    const mode = enumValue(environment.KIOKUKO_EMBEDDINGS, 'off', ['off', 'optional', 'required'], 'KIOKUKO_EMBEDDINGS');
+    const provider = enumValue(environment.KIOKUKO_EMBEDDING_PROVIDER, 'openai-compatible', ['openai-compatible'], 'KIOKUKO_EMBEDDING_PROVIDER');
+    const allowRemote = booleanValue(environment.KIOKUKO_EMBEDDING_ALLOW_REMOTE, false, 'KIOKUKO_EMBEDDING_ALLOW_REMOTE');
+    const vectorBackend = enumValue(environment.KIOKUKO_VECTOR_BACKEND, 'auto', ['auto', 'javascript', 'sqlite-vec'], 'KIOKUKO_VECTOR_BACKEND');
+    const baseUrl = environment.KIOKUKO_EMBEDDING_BASE_URL === undefined
+        ? undefined
+        : normalizeEmbeddingBaseUrl(environment.KIOKUKO_EMBEDDING_BASE_URL, allowRemote);
+    const model = optionalText(environment.KIOKUKO_EMBEDDING_MODEL, 'KIOKUKO_EMBEDDING_MODEL', MAX_MODEL_LENGTH);
+    const dimensions = integerValue(environment.KIOKUKO_EMBEDDING_DIMENSIONS, 0, 2, 8_192, 'KIOKUKO_EMBEDDING_DIMENSIONS');
+    const configuredDistanceCeiling = distanceCeilingValue(environment.KIOKUKO_EMBEDDING_DISTANCE_CEILING);
+    const timeoutMs = integerValue(environment.KIOKUKO_EMBEDDING_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, 100, 120_000, 'KIOKUKO_EMBEDDING_TIMEOUT_MS');
+    const batchSize = integerValue(environment.KIOKUKO_EMBEDDING_BATCH_SIZE, DEFAULT_BATCH_SIZE, 1, 64, 'KIOKUKO_EMBEDDING_BATCH_SIZE');
+    const apiKey = optionalText(environment.KIOKUKO_EMBEDDING_API_KEY, 'KIOKUKO_EMBEDDING_API_KEY', MAX_API_KEY_LENGTH);
+    if (mode !== 'off' && (baseUrl === undefined || model === undefined || dimensions === 0 || configuredDistanceCeiling === undefined)) {
+        invalid('Enabled embeddings require base URL, model, dimensions, and distance ceiling');
+    }
+    return {
+        mode,
+        provider,
+        ...(baseUrl === undefined ? {} : { baseUrl }),
+        ...(model === undefined ? {} : { model }),
+        ...(dimensions === 0 ? {} : { dimensions }),
+        ...(configuredDistanceCeiling === undefined ? {} : { distanceCeiling: configuredDistanceCeiling }),
+        ...(apiKey === undefined ? {} : { apiKey }),
+        allowRemote,
+        vectorBackend,
+        timeoutMs,
+        batchSize,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/embedding/config.js.map

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

package/dist/embedding/diagnostics.d.ts

@@ -0,0 +1,34 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { EmbeddingConfig, EmbeddingMode, VectorSearchBackend } from './types.js';
+export interface EmbeddingStatus {
+    readonly mode: EmbeddingMode;
+    readonly activeProfileId: string | null;
+    readonly providerKind: string | null;
+    readonly model: string | null;
+    readonly dimensions: number | null;
+    readonly distanceMetric: string | null;
+    readonly distanceCeiling: number | null;
+    readonly backend: string | null;
+    readonly backendVersion: string | null;
+    readonly eligibleEntries: number;
+    readonly readyVectors: number;
+    readonly staleVectors: number;
+    readonly missingVectors: number;
+    readonly pendingJobs: number;
+    readonly leasedJobs: number;
+    readonly failedJobs: number;
+    readonly blockedJobs: number;
+    readonly coverageRatio: number;
+    readonly queryCacheRows: number;
+}
+export interface EmbeddingHealth {
+    readonly status: EmbeddingStatus;
+    readonly check: {
+        readonly ok: boolean;
+        readonly count: number;
+        readonly detail: string;
+    };
+}
+export declare function readEmbeddingStatus(database: SqliteDatabase, config?: EmbeddingConfig, backend?: VectorSearchBackend): EmbeddingStatus;
+export declare function inspectEmbeddingHealth(database: SqliteDatabase, environment?: NodeJS.ProcessEnv | EmbeddingConfig, backend?: VectorSearchBackend): EmbeddingHealth;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/embedding/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/embedding/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,kBAAkB,CAAC;AAMlE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAiBxG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AA+GD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,eAA0D,EAClE,OAAO,CAAC,EAAE,mBAAmB,GAC5B,eAAe,CAOjB;AAwGD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,WAAW,GAAE,MAAM,CAAC,UAAU,GAAG,eAA0D,EAC3F,OAAO,CAAC,EAAE,mBAAmB,GAC5B,eAAe,CAmDjB"}