@kaelio/ktx 0.4.0 → 0.5.0

package/dist/text-ingest.js

@@ -1,7 +1,7 @@
 import { readFile as fsReadFile } from 'node:fs/promises';
 import { basename, resolve } from 'node:path';
-import { createLocalProjectMemoryIngest } from '@ktx/context/memory';
-import { loadKtxProject } from '@ktx/context/project';
+import { createLocalProjectMemoryIngest } from './context/memory/local-memory.js';
+import { loadKtxProject } from './context/project/project.js';
 import { createRepainter, initViewState, renderContextBuildView } from './context-build-view.js';
 import { formatDuration } from './demo-metrics.js';
 const INLINE_TEXT_LABEL_MAX_LENGTH = 50;

package/dist/tree-picker-state.d.ts

@@ -39,16 +39,19 @@ export type PickerCommand = 'cursor-up' | 'cursor-down' | 'cursor-left' | 'curso
     value: string;
 } | 'save-request' | 'save-confirm' | 'save-cancel' | 'quit';
 type PickerEffect = null | 'save' | 'quit-without-save';
+/** @internal */
 export declare function clearExpiredTransientHint(state: PickerState, now?: number): PickerState;
 export declare function buildPickerTree(inputs: TreePickerNodeInput[]): TreePickerNode[];
 export declare function isAncestorChecked(nodeId: string, checked: Set<string>, byId: Map<string, TreePickerNode>): boolean;
 export declare function hasPartialChildren(nodeId: string, checked: Set<string>, byId: Map<string, TreePickerNode>): boolean;
+/** @internal */
 export declare function canToggle(nodeId: string, state: PickerState): {
     ok: true;
 } | {
     ok: false;
     reason: string;
 };
+/** @internal */
 export declare function toggleChecked(state: PickerState, nodeId: string, now?: number): PickerState;
 export declare function flattenSelection(checked: Set<string>, byId: Map<string, TreePickerNode>): string[];
 export declare function filterTree(state: PickerState): {
@@ -56,8 +59,11 @@ export declare function filterTree(state: PickerState): {
     autoExpand: Set<string>;
 };
 export declare function visibleNodeIds(state: PickerState): string[];
+/** @internal */
 export declare function selectAllVisible(state: PickerState): PickerState;
+/** @internal */
 export declare function selectNone(state: PickerState): PickerState;
+/** @internal */
 export declare function moveCursor(state: PickerState, dir: 'up' | 'down' | 'left' | 'right'): PickerState;
 export declare function buildInitialState(args: {
     tree: TreePickerNode[];

package/dist/tree-picker-state.js

@@ -18,6 +18,7 @@ function cloneState(state, patch) {
 function transientHint(text, now) {
     return { text, expiresAt: now + TRANSIENT_HINT_DURATION_MS };
 }
+/** @internal */
 export function clearExpiredTransientHint(state, now = Date.now()) {
     if (!state.transientHint || state.transientHint.expiresAt > now) {
         return state;
@@ -150,6 +151,7 @@ function checkedAncestor(nodeId, state) {
     }
     return null;
 }
+/** @internal */
 export function canToggle(nodeId, state) {
     if (!state.byId.has(nodeId)) {
         return { ok: false, reason: 'Node not found' };
@@ -160,6 +162,7 @@ export function canToggle(nodeId, state) {
     }
     return { ok: true };
 }
+/** @internal */
 export function toggleChecked(state, nodeId, now = Date.now()) {
     const toggle = canToggle(nodeId, state);
     if (!toggle.ok) {
@@ -228,6 +231,7 @@ export function visibleNodeIds(state) {
     }
     return result;
 }
+/** @internal */
 export function selectAllVisible(state) {
     const candidates = state.search.query.trim().length > 0 ? matchingIds(state) : new Set(visibleNodeIds(state));
     const checked = new Set(state.checked);
@@ -248,6 +252,7 @@ export function selectAllVisible(state) {
         transientHint: null,
     });
 }
+/** @internal */
 export function selectNone(state) {
     return cloneState(state, { checked: new Set(), transientHint: null });
 }
@@ -270,6 +275,7 @@ function setExpanded(state, nodeId, value) {
     }
     return cloneState(state, { expanded });
 }
+/** @internal */
 export function moveCursor(state, dir) {
     const node = state.byId.get(state.cursorId);
     if (!node) {

package/dist/tree-picker-tui.d.ts

@@ -47,11 +47,13 @@ interface TreePickerAppProps extends TreePickerRenderInput {
     env?: NodeJS.ProcessEnv;
     onExit(result: TreePickerResult): void;
 }
+/** @internal */
 export interface TreePickerInkInstance {
     rerender(tree: ReactNode): void;
     unmount(): void;
     waitUntilExit(): Promise<void>;
 }
+/** @internal */
 export interface TreePickerInkRenderOptions {
     stdin?: TreePickerTuiIo['stdin'];
     stdout: TreePickerTuiIo['stdout'];
@@ -61,14 +63,20 @@ export interface TreePickerInkRenderOptions {
     maxFps: number;
     alternateScreen: boolean;
 }
+/** @internal */
 export declare function resolveTreePickerWidth(columns: number | undefined): number;
+/** @internal */
 export declare function sanitizeTreePickerTuiError(error: unknown): string;
+/** @internal */
 export declare function windowOffset(count: number, selected: number, visible: number): number;
+/** @internal */
 export declare function windowItems<T>(items: T[], selected: number, visible: number): {
     items: T[];
     offset: number;
 };
+/** @internal */
 export declare function treePickerCommandForInkInput(input: string, key: InkKey, search: PickerState['search'], pendingConfirm: PickerState['pendingConfirm']): PickerCommand | null;
+/** @internal */
 export declare function TreePickerApp(props: TreePickerAppProps): ReactNode;
 export interface RenderTreePickerOptions {
     renderInk?: (tree: ReactNode, options: TreePickerInkRenderOptions) => TreePickerInkInstance;

package/dist/tree-picker-tui.js

@@ -22,6 +22,7 @@ const DEFAULT_SKIP_EMPTY_MESSAGE = 'Nothing selected. Skip this step? Press Ente
 function resolveTheme(env = process.env) {
     return env.NO_COLOR || env.TERM === 'dumb' ? NO_COLOR_THEME : COLOR_THEME;
 }
+/** @internal */
 export function resolveTreePickerWidth(columns) {
     const resolvedColumns = columns ?? 100;
     return Math.max(60, Math.min(120, resolvedColumns - 4));
@@ -37,17 +38,20 @@ function rowMatchesSearch(state, nodeId) {
     }
     return node.title.toLocaleLowerCase().includes(query) || node.path.toLocaleLowerCase().includes(query);
 }
+/** @internal */
 export function sanitizeTreePickerTuiError(error) {
     const message = error instanceof Error ? error.message : String(error);
     return message
         .replace(/[a-z][a-z0-9+.-]*:\/\/[^\s]+/gi, '[redacted-url]')
         .replace(/\b(api[_-]?key|password|token|secret)=\S+/gi, '[redacted]');
 }
+/** @internal */
 export function windowOffset(count, selected, visible) {
     if (count <= visible)
         return 0;
     return Math.max(0, Math.min(count - visible, selected - Math.floor(visible / 2)));
 }
+/** @internal */
 export function windowItems(items, selected, visible) {
     const offset = windowOffset(items.length, selected, visible);
     return { items: items.slice(offset, offset + visible), offset };
@@ -59,6 +63,7 @@ function truncateText(value, width) {
         return value.slice(0, width);
     return `${value.slice(0, width - 3)}...`;
 }
+/** @internal */
 export function treePickerCommandForInkInput(input, key, search, pendingConfirm) {
     if (pendingConfirm) {
         if (input === 'y' || key.return)
@@ -127,6 +132,7 @@ function PickerRow(props) {
     const title = truncateText(node.title, Math.max(10, props.width - prefixWidth));
     return (_jsxs(Text, { children: [_jsxs(Text, { color: glyphColor, children: [indent, glyph] }), _jsxs(Text, { color: titleColor, strikethrough: node.archived, bold: focused, children: [' ', _jsx(Text, { inverse: inverse, children: title })] }), childAffordance.length > 0 ? _jsx(Text, { color: props.theme.muted, children: childAffordance }) : null] }));
 }
+/** @internal */
 export function TreePickerApp(props) {
     const app = useApp();
     const [state, setState] = useState(props.initialState);

package/dist/viz-fallback.d.ts

@@ -24,5 +24,6 @@ type KtxVizFallbackDecision = {
 export declare function resolveVizFallback(io: KtxVizFallbackIo, env?: NodeJS.ProcessEnv, options?: KtxVizFallbackOptions): KtxVizFallbackDecision;
 export declare function rendererUnavailableVizFallback(): KtxVizFallbackDecision;
 export declare function warnVizFallbackOnce(io: KtxVizFallbackIo, decision: KtxVizFallbackDecision): void;
+/** @internal */
 export declare function resetVizFallbackWarningsForTest(): void;
 export {};

package/dist/viz-fallback.js

@@ -46,6 +46,7 @@ export function warnVizFallbackOnce(io, decision) {
     warnedFallbackReasons.add(decision.reason);
     io.stderr.write(`Visualization requested but ${decision.message}; printing plain output.\n`);
 }
+/** @internal */
 export function resetVizFallbackWarningsForTest() {
     warnedFallbackReasons.clear();
 }

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@kaelio/ktx",
-  "version": "0.4.0",
-  "description": "Standalone KTX context layer for database agents",
-  "private": false,
+  "version": "0.5.0",
+  "description": "Standalone ktx context layer for data agents",
   "type": "module",
   "engines": {
     "node": ">=22.0.0"
@@ -24,6 +23,10 @@
     "dist",
     "assets"
   ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.77",
     "@ai-sdk/devtools": "0.0.17",
@@ -51,30 +54,50 @@
     "openai": "^6.37.0",
     "p-limit": "^7.3.0",
     "pg": "^8.20.0",
+    "posthog-node": "^5.0.0",
     "react": "^19.2.6",
     "simple-git": "3.36.0",
     "snowflake-sdk": "^2.4.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
-  "bundledDependencies": [
-    "@ktx/llm",
-    "@ktx/context",
-    "@ktx/connector-bigquery",
-    "@ktx/connector-clickhouse",
-    "@ktx/connector-mysql",
-    "@ktx/connector-postgres",
-    "@ktx/connector-snowflake",
-    "@ktx/connector-sqlite",
-    "@ktx/connector-sqlserver"
-  ],
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.4.5",
+    "@electric-sql/pglite-socket": "^0.1.5",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/mssql": "^12.3.0",
+    "@types/node": "^25.7.0",
+    "@types/pg": "^8.20.0",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.1.6",
+    "ajv": "8.20.0",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Kaelio/ktx"
+    "url": "https://github.com/Kaelio/ktx",
+    "directory": "packages/cli"
   },
   "bugs": {
     "url": "https://github.com/Kaelio/ktx/issues"
   },
-  "homepage": "https://github.com/Kaelio/ktx#readme"
+  "homepage": "https://github.com/Kaelio/ktx#readme",
+  "scripts": {
+    "assets:demo": "node scripts/build-demo-assets.mjs",
+    "build": "tsc -p tsconfig.json && node dist/telemetry/schema-writer.js src/telemetry/events.schema.json ../../python/ktx-daemon/src/ktx_daemon/telemetry/events.schema.json && node scripts/copy-runtime-assets.mjs && node ../../scripts/prepare-cli-bin.mjs",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
+    "docs:commands": "pnpm run build && node dist/print-command-tree.js",
+    "smoke": "vitest run src/standalone-smoke.test.ts src/example-smoke.test.ts --testTimeout 30000",
+    "test": "vitest run --exclude src/standalone-smoke.test.ts --exclude src/example-smoke.test.ts --exclude src/setup-databases.test.ts --exclude src/scan.test.ts --exclude src/commands/connection-metabase-setup.test.ts --exclude src/setup-models.test.ts --exclude src/setup-sources.test.ts --exclude src/setup.test.ts --exclude src/connection.test.ts --exclude src/setup-embeddings.test.ts --exclude src/ingest.test.ts --exclude src/commands/connection-mapping.test.ts --exclude src/ingest-viz.test.ts --exclude src/demo.test.ts --exclude src/setup-project.test.ts --exclude src/sl.test.ts --exclude src/local-scan-connectors.test.ts --exclude src/commands/connection-notion.test.ts --exclude src/context/scan/local-scan.test.ts --exclude src/context/mcp/local-project-ports.test.ts --exclude src/context/ingest/local-stage-ingest.test.ts --exclude src/context/sl/pglite-sl-search-prototype.test.ts --exclude src/context/core/git.service.test.ts --exclude src/context/ingest/local-adapters.test.ts --exclude src/context/ingest/local-bundle-ingest.test.ts --exclude src/context/ingest/local-metabase-ingest.test.ts --exclude src/context/sl/local-sl.test.ts --exclude src/context/search/pglite-owner-process.test.ts --exclude src/context/scan/local-enrichment-artifacts.test.ts --exclude src/context/search/pglite-spike.test.ts --exclude src/context/wiki/local-knowledge.test.ts --exclude src/context/sl/local-query.test.ts --exclude src/context/scan/relationship-review-decisions.test.ts --exclude src/context/scan/relationship-profiling.test.ts",
+    "test:slow": "vitest run src/setup-databases.test.ts src/scan.test.ts src/commands/connection-metabase-setup.test.ts src/setup-models.test.ts src/setup-sources.test.ts src/setup.test.ts src/connection.test.ts src/setup-embeddings.test.ts src/ingest.test.ts src/commands/connection-mapping.test.ts src/ingest-viz.test.ts src/demo.test.ts src/setup-project.test.ts src/sl.test.ts src/local-scan-connectors.test.ts src/commands/connection-notion.test.ts src/context/scan/local-scan.test.ts src/context/mcp/local-project-ports.test.ts src/context/ingest/local-stage-ingest.test.ts src/context/sl/pglite-sl-search-prototype.test.ts src/context/core/git.service.test.ts src/context/ingest/local-adapters.test.ts src/context/ingest/local-bundle-ingest.test.ts src/context/ingest/local-metabase-ingest.test.ts src/context/sl/local-sl.test.ts src/context/search/pglite-owner-process.test.ts src/context/scan/local-enrichment-artifacts.test.ts src/context/search/pglite-spike.test.ts src/context/wiki/local-knowledge.test.ts src/context/sl/local-query.test.ts src/context/scan/relationship-review-decisions.test.ts src/context/scan/relationship-profiling.test.ts --testTimeout 30000",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "relationships:benchmarks": "pnpm --silent run build && node ../../scripts/relationship-benchmark-report.mjs",
+    "relationships:benchmarks:test": "KTX_RUN_RELATIONSHIP_BENCHMARKS=1 vitest run src/context/scan/relationship-benchmarks.test.ts",
+    "search:pglite-spike": "node ../../scripts/pglite-hybrid-search-spike.mjs",
+    "search:pglite-owner-prototype": "node ../../scripts/pglite-owner-process-prototype.mjs",
+    "search:pglite-sl-prototype": "node ../../scripts/pglite-sl-search-prototype.mjs"
+  }
 }

package/dist/cli-project.d.ts

@@ -1,18 +0,0 @@
-import { loadKtxProject, type KtxLocalProject } from '@ktx/context/project';
-import type { KtxProjectConfig } from '@ktx/context/project';
-import type { KtxCliIo } from './cli-runtime.js';
-import { ensureManagedLocalEmbeddingsDaemon, type ManagedLocalEmbeddingsDaemon } from './managed-local-embeddings.js';
-import type { KtxManagedPythonInstallPolicy } from './managed-python-command.js';
-export interface LoadKtxCliProjectOptions {
-    projectDir: string;
-    cliVersion: string;
-    installPolicy: KtxManagedPythonInstallPolicy;
-    io: KtxCliIo;
-}
-export interface LoadKtxCliProjectDeps {
-    loadProject?: typeof loadKtxProject;
-    ensureLocalEmbeddings?: (options: Parameters<typeof ensureManagedLocalEmbeddingsDaemon>[0]) => Promise<ManagedLocalEmbeddingsDaemon>;
-}
-export declare function loadKtxCliProject(options: LoadKtxCliProjectOptions, deps?: LoadKtxCliProjectDeps): Promise<KtxLocalProject>;
-export declare function projectNeedsManagedLocalEmbeddings(config: KtxProjectConfig): boolean;
-export declare function substituteManagedLocalEmbeddingsUrl(config: KtxProjectConfig, baseUrl: string): KtxProjectConfig;

package/dist/cli-project.js

@@ -1,52 +0,0 @@
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
-import { loadKtxProject } from '@ktx/context/project';
-import { ensureManagedLocalEmbeddingsDaemon, } from './managed-local-embeddings.js';
-export async function loadKtxCliProject(options, deps = {}) {
-    const loadProject = deps.loadProject ?? loadKtxProject;
-    const ensureLocalEmbeddings = deps.ensureLocalEmbeddings ?? ensureManagedLocalEmbeddingsDaemon;
-    const project = await loadProject({ projectDir: options.projectDir });
-    if (!projectNeedsManagedLocalEmbeddings(project.config)) {
-        return project;
-    }
-    const daemon = await ensureLocalEmbeddings({
-        cliVersion: options.cliVersion,
-        projectDir: options.projectDir,
-        installPolicy: options.installPolicy,
-        io: options.io,
-    });
-    return {
-        ...project,
-        config: substituteManagedLocalEmbeddingsUrl(project.config, daemon.baseUrl),
-    };
-}
-export function projectNeedsManagedLocalEmbeddings(config) {
-    return (embeddingUsesManagedSentinel(config.ingest.embeddings) ||
-        embeddingUsesManagedSentinel(config.scan.enrichment.embeddings));
-}
-export function substituteManagedLocalEmbeddingsUrl(config, baseUrl) {
-    const ingestEmbeddings = rewriteManagedEmbeddingConfig(config.ingest.embeddings, baseUrl);
-    const scanEnrichmentEmbeddings = rewriteManagedEmbeddingConfig(config.scan.enrichment.embeddings, baseUrl);
-    return {
-        ...config,
-        ingest: { ...config.ingest, embeddings: ingestEmbeddings },
-        scan: {
-            ...config.scan,
-            enrichment: { ...config.scan.enrichment, embeddings: scanEnrichmentEmbeddings },
-        },
-    };
-}
-function embeddingUsesManagedSentinel(embedding) {
-    return embedding?.sentenceTransformers?.base_url === MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
-}
-function rewriteManagedEmbeddingConfig(embedding, baseUrl) {
-    if (!embedding || !embeddingUsesManagedSentinel(embedding)) {
-        return embedding;
-    }
-    return {
-        ...embedding,
-        sentenceTransformers: {
-            ...embedding.sentenceTransformers,
-            base_url: baseUrl,
-        },
-    };
-}

package/dist/cli-project.test.js

@@ -1,149 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
-import { buildDefaultKtxProjectConfig } from '@ktx/context/project';
-import { loadKtxCliProject, projectNeedsManagedLocalEmbeddings, substituteManagedLocalEmbeddingsUrl, } from './cli-project.js';
-const RESOLVED_BASE_URL = 'http://127.0.0.1:51234';
-function makeIo() {
-    let stderr = '';
-    return {
-        io: {
-            stdout: { write: (_chunk) => { } },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stderr: () => stderr,
-    };
-}
-function projectWithConfig(config) {
-    return {
-        projectDir: '/work/proj',
-        configPath: '/work/proj/ktx.yaml',
-        config,
-        coreConfig: {},
-        git: {},
-        fileStore: {},
-    };
-}
-function withManagedIngestEmbedding(config) {
-    return {
-        ...config,
-        ingest: {
-            ...config.ingest,
-            embeddings: {
-                backend: 'sentence-transformers',
-                model: 'all-MiniLM-L6-v2',
-                dimensions: 384,
-                sentenceTransformers: { base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, pathPrefix: '' },
-            },
-        },
-    };
-}
-function withManagedScanEnrichmentEmbedding(config) {
-    return {
-        ...config,
-        scan: {
-            ...config.scan,
-            enrichment: {
-                ...config.scan.enrichment,
-                embeddings: {
-                    backend: 'sentence-transformers',
-                    model: 'all-MiniLM-L6-v2',
-                    dimensions: 384,
-                    sentenceTransformers: { base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, pathPrefix: '' },
-                },
-            },
-        },
-    };
-}
-const fakeDaemon = {
-    baseUrl: RESOLVED_BASE_URL,
-    stdoutLog: '/work/proj/.ktx/runtime/daemon.stdout.log',
-    stderrLog: '/work/proj/.ktx/runtime/daemon.stderr.log',
-};
-describe('projectNeedsManagedLocalEmbeddings', () => {
-    it('returns false when neither ingest nor scan embeddings reference the managed sentinel', () => {
-        expect(projectNeedsManagedLocalEmbeddings(buildDefaultKtxProjectConfig())).toBe(false);
-    });
-    it('returns true when ingest.embeddings uses the managed sentinel', () => {
-        expect(projectNeedsManagedLocalEmbeddings(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()))).toBe(true);
-    });
-    it('returns true when scan.enrichment.embeddings uses the managed sentinel', () => {
-        expect(projectNeedsManagedLocalEmbeddings(withManagedScanEnrichmentEmbedding(buildDefaultKtxProjectConfig()))).toBe(true);
-    });
-});
-describe('substituteManagedLocalEmbeddingsUrl', () => {
-    it('rewrites the managed sentinel in both ingest.embeddings and scan.enrichment.embeddings', () => {
-        const config = withManagedScanEnrichmentEmbedding(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
-        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
-        expect(resolved.ingest.embeddings.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
-        expect(resolved.scan.enrichment.embeddings?.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
-    });
-    it('returns the input unchanged when no sentinel is present', () => {
-        const config = buildDefaultKtxProjectConfig();
-        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
-        expect(resolved.ingest.embeddings).toEqual(config.ingest.embeddings);
-        expect(resolved.scan.enrichment.embeddings).toEqual(config.scan.enrichment.embeddings);
-    });
-    it('does not touch non-sentinel sentence-transformers URLs', () => {
-        const config = {
-            ...buildDefaultKtxProjectConfig(),
-            ingest: {
-                ...buildDefaultKtxProjectConfig().ingest,
-                embeddings: {
-                    backend: 'sentence-transformers',
-                    model: 'all-MiniLM-L6-v2',
-                    dimensions: 384,
-                    sentenceTransformers: { base_url: 'http://localhost:9999', pathPrefix: '' },
-                },
-            },
-        };
-        const resolved = substituteManagedLocalEmbeddingsUrl(config, RESOLVED_BASE_URL);
-        expect(resolved.ingest.embeddings.sentenceTransformers?.base_url).toBe('http://localhost:9999');
-    });
-});
-describe('loadKtxCliProject', () => {
-    it('returns the project unchanged and does not start the daemon when no sentinel is present', async () => {
-        const io = makeIo();
-        const project = projectWithConfig(buildDefaultKtxProjectConfig());
-        const loadProject = vi.fn(async () => project);
-        const ensureLocalEmbeddings = vi.fn(async () => fakeDaemon);
-        const result = await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject, ensureLocalEmbeddings });
-        expect(result).toBe(project);
-        expect(ensureLocalEmbeddings).not.toHaveBeenCalled();
-    });
-    it('starts the daemon and substitutes the resolved URL when ingest.embeddings uses the sentinel', async () => {
-        const io = makeIo();
-        const project = projectWithConfig(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
-        const loadProject = vi.fn(async () => project);
-        const ensureLocalEmbeddings = vi.fn(async () => fakeDaemon);
-        const result = await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject, ensureLocalEmbeddings });
-        expect(ensureLocalEmbeddings).toHaveBeenCalledWith({
-            cliVersion: '0.2.0',
-            projectDir: '/work/proj',
-            installPolicy: 'never',
-            io: io.io,
-        });
-        expect(result.config.ingest.embeddings.sentenceTransformers?.base_url).toBe(RESOLVED_BASE_URL);
-    });
-    it('does not mutate process.env', async () => {
-        const io = makeIo();
-        const before = process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
-        delete process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
-        try {
-            const project = projectWithConfig(withManagedIngestEmbedding(buildDefaultKtxProjectConfig()));
-            await loadKtxCliProject({ projectDir: '/work/proj', cliVersion: '0.2.0', installPolicy: 'never', io: io.io }, { loadProject: vi.fn(async () => project), ensureLocalEmbeddings: vi.fn(async () => fakeDaemon) });
-            expect(process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL).toBeUndefined();
-        }
-        finally {
-            if (before === undefined) {
-                delete process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL;
-            }
-            else {
-                process.env.KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL = before;
-            }
-        }
-    });
-});

package/node_modules/@ktx/connector-bigquery/dist/connector.d.ts

@@ -1,141 +0,0 @@
-import { type TableField } from '@google-cloud/bigquery';
-import { type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaSnapshot, type KtxTableListEntry, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '@ktx/context/scan';
-export interface KtxBigQueryConnectionConfig {
-    driver?: string;
-    dataset_id?: string;
-    dataset_ids?: string[];
-    credentials_json?: string;
-    location?: string;
-    max_bytes_billed?: number | string;
-    job_timeout_ms?: number;
-    [key: string]: unknown;
-}
-export interface KtxBigQueryResolvedConnectionConfig {
-    projectId: string;
-    credentials: Record<string, unknown>;
-    datasetIds: string[];
-    location?: string;
-}
-export interface KtxBigQueryReadOnlyQueryInput extends KtxReadOnlyQueryInput {
-    params?: Record<string, unknown>;
-}
-export interface KtxBigQueryColumnDistinctValuesOptions {
-    maxCardinality: number;
-    limit: number;
-    sampleSize?: number;
-}
-export interface KtxBigQueryColumnDistinctValuesResult {
-    values: string[] | null;
-    cardinality: number;
-}
-export interface KtxBigQueryQueryJob {
-    getQueryResults(): Promise<[
-        Array<Record<string, unknown>>,
-        unknown,
-        {
-            schema?: {
-                fields?: TableField[];
-            };
-        }?,
-        ...unknown[]
-    ]>;
-}
-export interface KtxBigQueryTableRef {
-    id?: string;
-    metadata?: {
-        type?: string;
-    };
-    get(): Promise<[
-        {
-            metadata: {
-                type?: string;
-                numRows?: string | number;
-                description?: string;
-                schema?: {
-                    fields?: TableField[];
-                };
-            };
-        },
-        ...unknown[]
-    ]>;
-}
-export interface KtxBigQueryDataset {
-    get(): Promise<unknown>;
-    getTables(): Promise<[KtxBigQueryTableRef[], ...unknown[]]>;
-}
-export interface KtxBigQueryClient {
-    getDatasets(input?: {
-        maxResults?: number;
-    }): Promise<[Array<{
-        id?: string;
-    }>, ...unknown[]]>;
-    dataset(datasetId: string): KtxBigQueryDataset;
-    createQueryJob(input: {
-        query: string;
-        location?: string;
-        params?: Record<string, unknown>;
-        maximumBytesBilled?: string;
-        jobTimeoutMs?: number;
-    }): Promise<[KtxBigQueryQueryJob, ...unknown[]]>;
-}
-export interface KtxBigQueryClientFactory {
-    createClient(input: {
-        projectId: string;
-        credentials: Record<string, unknown>;
-    }): KtxBigQueryClient;
-}
-export interface KtxBigQueryScanConnectorOptions {
-    connectionId: string;
-    connection: KtxBigQueryConnectionConfig | undefined;
-    clientFactory?: KtxBigQueryClientFactory;
-    env?: NodeJS.ProcessEnv;
-    now?: () => Date;
-    maxBytesBilled?: number | string;
-    queryTimeoutMs?: number;
-}
-export declare function isKtxBigQueryConnectionConfig(connection: KtxBigQueryConnectionConfig | undefined): connection is KtxBigQueryConnectionConfig;
-export declare function bigQueryConnectionConfigFromConfig(input: {
-    connectionId: string;
-    connection: KtxBigQueryConnectionConfig | undefined;
-    env?: NodeJS.ProcessEnv;
-}): KtxBigQueryResolvedConnectionConfig;
-export declare class KtxBigQueryScanConnector implements KtxScanConnector {
-    readonly id: string;
-    readonly driver: "bigquery";
-    readonly capabilities: import("@ktx/context/scan").KtxConnectorCapabilities;
-    private readonly connectionId;
-    private readonly resolved;
-    private readonly clientFactory;
-    private readonly now;
-    private readonly maxBytesBilled?;
-    private readonly queryTimeoutMs?;
-    private readonly dialect;
-    private client;
-    constructor(options: KtxBigQueryScanConnectorOptions);
-    testConnection(): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    introspect(input: KtxScanInput, _ctx: KtxScanContext): Promise<KtxSchemaSnapshot>;
-    sampleTable(input: KtxTableSampleInput, _ctx: KtxScanContext): Promise<KtxTableSampleResult & {
-        headerTypes?: string[];
-    }>;
-    sampleColumn(input: KtxColumnSampleInput, _ctx: KtxScanContext): Promise<KtxColumnSampleResult>;
-    columnStats(_input: KtxColumnStatsInput, _ctx: KtxScanContext): Promise<KtxColumnStatsResult | null>;
-    executeReadOnly(input: KtxBigQueryReadOnlyQueryInput, _ctx: KtxScanContext): Promise<KtxQueryResult>;
-    getColumnDistinctValues(table: KtxTableRef, columnName: string, options: KtxBigQueryColumnDistinctValuesOptions): Promise<KtxBigQueryColumnDistinctValuesResult | null>;
-    getTableRowCount(tableName: string, datasetId?: string): Promise<number>;
-    qTableName(table: Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>): string;
-    quoteIdentifier(identifier: string): string;
-    listDatasets(): Promise<string[]>;
-    listTables(datasetIds?: string[]): Promise<KtxTableListEntry[]>;
-    cleanup(): Promise<void>;
-    private getClient;
-    private query;
-    private queryRaw;
-    private singleNumber;
-    private introspectDataset;
-    private primaryKeys;
-    private toSchemaColumn;
-    private assertConnection;
-}