@kaelio/ktx 0.3.0 → 0.4.1

package/node_modules/@ktx/context/dist/llm/local-config.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
 import { buildDefaultKtxProjectConfig, } from '../project/config.js';
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL, createLocalKtxEmbeddingProviderFromConfig, createLocalKtxLlmProviderFromConfig, resolveLocalKtxEmbeddingConfig, resolveLocalKtxLlmConfig, } from './local-config.js';
+import { createLocalKtxEmbeddingProviderFromConfig, createLocalKtxLlmProviderFromConfig, resolveLocalKtxEmbeddingConfig, resolveLocalKtxLlmConfig, } from './local-config.js';
 describe('local KTX LLM config', () => {
     it('resolves env and file references into a KtxLlmConfig', () => {
         const config = {
@@ -116,13 +116,13 @@ describe('local KTX embedding config', () => {
             batchSize: 16,
         });
     });
-    it('returns null when sentence-transformers base_url is still the unresolved managed sentinel', () => {
+    it('returns null when sentence-transformers has no base_url (managed daemon delegation)', () => {
         const config = {
             backend: 'sentence-transformers',
             model: 'all-MiniLM-L6-v2',
             dimensions: 384,
             sentenceTransformers: {
-                base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL,
+                base_url: '',
                 pathPrefix: '',
             },
         };

package/node_modules/@ktx/context/dist/mcp/local-project-ports.d.ts

@@ -10,7 +10,7 @@ interface CreateLocalProjectMcpContextPortsOptions {
     queryExecutor?: KtxSqlQueryExecutorPort;
     sqlAnalysis?: SqlAnalysisPort;
     localScan?: LocalScanMcpOptions;
-    embeddingService?: KtxEmbeddingPort | null;
+    embeddingService: KtxEmbeddingPort | null;
 }
-export declare function createLocalProjectMcpContextPorts(project: KtxLocalProject, options?: CreateLocalProjectMcpContextPortsOptions): KtxMcpContextPorts;
+export declare function createLocalProjectMcpContextPorts(project: KtxLocalProject, options: CreateLocalProjectMcpContextPortsOptions): KtxMcpContextPorts;
 export {};

package/node_modules/@ktx/context/dist/mcp/local-project-ports.js

@@ -1,5 +1,4 @@
 import { localConnectionInfoFromConfig } from '../connections/index.js';
-import { createLocalKtxEmbeddingProviderFromConfig, KtxIngestEmbeddingPortAdapter } from '../llm/index.js';
 import { createKtxEntityDetailsService } from '../scan/index.js';
 import { createKtxDiscoverDataService } from '../search/index.js';
 import { compileLocalSlQuery, createKtxDictionarySearchService } from '../sl/index.js';
@@ -99,10 +98,8 @@ async function executeValidatedReadOnlySql(project, options, input, onProgress)
         await cleanupConnector(connector);
     }
 }
-export function createLocalProjectMcpContextPorts(project, options = {}) {
-    const configuredEmbeddingProvider = createLocalKtxEmbeddingProviderFromConfig(project.config.ingest.embeddings);
-    const embeddingService = options.embeddingService ??
-        (configuredEmbeddingProvider ? new KtxIngestEmbeddingPortAdapter(configuredEmbeddingProvider) : null);
+export function createLocalProjectMcpContextPorts(project, options) {
+    const embeddingService = options.embeddingService;
     const ports = {
         connections: {
             async list() {

package/node_modules/@ktx/context/dist/mcp/local-project-ports.test.js

@@ -138,7 +138,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             driver: 'postgres',
             url: 'env:DATABASE_URL',
         };
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         expect(Object.keys(ports).sort()).toEqual([
             'connections',
             'dictionarySearch',
@@ -178,6 +178,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             localScan: {
                 createConnector,
             },
+            embeddingService: null,
         });
         expect(Object.keys(ports).sort()).toContain('sqlExecution');
         await expect(ports.sqlExecution?.execute({
@@ -224,6 +225,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             localScan: {
                 createConnector,
             },
+            embeddingService: null,
         });
         const result = await ports.sqlExecution?.execute({ connectionId: 'warehouse', sql: 'select id from public.orders', maxRows: 5 }, {
             onProgress: (event) => {
@@ -262,6 +264,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             localScan: {
                 createConnector: vi.fn(async () => connector),
             },
+            embeddingService: null,
         });
         await expect(ports.sqlExecution?.execute({
             connectionId: 'warehouse',
@@ -277,7 +280,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             url: 'env:DATABASE_URL',
         };
         await seedScanReport(project.projectDir);
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.entityDetails?.read({
             connectionId: 'warehouse',
             entities: [{ table: 'public.orders', columns: ['id'] }],
@@ -299,7 +302,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             driver: 'postgres',
             url: 'env:DATABASE_URL',
         };
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.entityDetails?.read({
             connectionId: 'warehouse',
             entities: [{ table: 'public.orders' }],
@@ -337,7 +340,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             },
             warnings: [],
         }, null, 2)}\n`, 'ktx', 'ktx@example.com', 'Seed dictionary profile');
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.dictionarySearch?.search({ values: ['paid'] })).resolves.toMatchObject({
             searched: [{ connectionId: 'warehouse', status: 'ready' }],
             results: [
@@ -355,7 +358,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             driver: 'postgres',
             url: 'env:DATABASE_URL',
         };
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.dictionarySearch?.search({ values: ['paid'] })).resolves.toEqual({
             searched: [
                 {
@@ -483,7 +486,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             enrichmentState: { resumedStages: [], completedStages: [], failedStages: [] },
             createdAt: '2026-05-14T09:00:00.000Z',
         }, null, 2), 'ktx', 'ktx@example.com', 'seed scan report');
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         const results = await ports.discover?.search({ query: 'paid orders', connectionId: 'warehouse', limit: 10 });
         expect(results).toEqual(expect.arrayContaining([
             expect.objectContaining({ kind: 'wiki', id: 'orders-playbook' }),
@@ -507,7 +510,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             'Revenue is net of refunds.',
             '',
         ].join('\n'), 'ktx', 'ktx@example.com', 'Seed wiki');
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.knowledge?.read({ userId: 'local-user', key: 'revenue' })).resolves.toMatchObject({
             key: 'revenue',
             scope: 'GLOBAL',
@@ -549,7 +552,7 @@ describe('createLocalProjectMcpContextPorts', () => {
                 '',
             ].join('\n'),
         });
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.semanticLayer?.readSource({ connectionId: 'warehouse', sourceName: 'orders' })).resolves.toMatchObject({
             sourceName: 'orders',
             yaml: expect.stringContaining('name: orders'),
@@ -557,7 +560,7 @@ describe('createLocalProjectMcpContextPorts', () => {
     });
     it('rejects path traversal keys before touching the project directory', async () => {
         const project = await initKtxProject({ projectDir: tempDir });
-        const ports = createLocalProjectMcpContextPorts(project);
+        const ports = createLocalProjectMcpContextPorts(project, { embeddingService: null });
         await expect(ports.knowledge?.read({
             userId: 'local-user',
             key: '../outside',
@@ -603,7 +606,7 @@ describe('createLocalProjectMcpContextPorts', () => {
             })),
             generateSources: vi.fn(),
         };
-        const ports = createLocalProjectMcpContextPorts(project, { semanticLayerCompute });
+        const ports = createLocalProjectMcpContextPorts(project, { semanticLayerCompute, embeddingService: null });
         await expect(ports.semanticLayer?.query({
             connectionId: 'warehouse',
             query: {
@@ -670,6 +673,7 @@ describe('createLocalProjectMcpContextPorts', () => {
         const ports = createLocalProjectMcpContextPorts(project, {
             semanticLayerCompute: compute,
             queryExecutor,
+            embeddingService: null,
         });
         const result = await ports.semanticLayer?.query({
             connectionId: 'warehouse',

package/node_modules/@ktx/context/dist/package-exports.test.js

@@ -123,7 +123,6 @@ describe('@ktx/context package exports', () => {
         expect(root.assertSearchBackendConformanceCase).toBeTypeOf('function');
         expect(root.assertSearchBackendCapabilities).toBeTypeOf('function');
         expect(root.createLocalKtxEmbeddingProviderFromConfig).toBeTypeOf('function');
-        expect(root.MANAGED_SENTENCE_TRANSFORMERS_BASE_URL).toBe('managed:local-embeddings');
         expect(agent).toBeDefined();
         expect(agent.AgentRunnerService).toBeTypeOf('function');
         expect(root.AgentRunnerService).toBeTypeOf('function');

package/node_modules/@ktx/context/dist/project/config.js

@@ -31,7 +31,7 @@ const vertexProviderSchema = z
     .describe('Google Vertex AI provider configuration.');
 const sentenceTransformersSchema = z
     .strictObject({
-    base_url: z.string().default('').describe('Base URL of the sentence-transformers HTTP server. Empty string uses the managed local runtime.'),
+    base_url: z.string().default('').describe('Base URL of the sentence-transformers HTTP server. Leave empty (or omit) to use the project-managed local daemon.'),
     pathPrefix: z.string().optional().describe('Optional URL path prefix prepended to embedding requests.'),
 })
     .describe('Sentence-transformers embedding server configuration.');

package/node_modules/@ktx/context/dist/scan/local-enrichment.test.js

@@ -736,16 +736,16 @@ describe('local scan enrichment', () => {
             executor.close();
         }
     });
-    it('resolves gateway LLM providers and OpenAI embeddings from local scan config', () => {
+    it('resolves gateway LLM providers and passes injected embedding provider through to scan enrichment', () => {
         const createKtxLlmProvider = vi.fn(() => ({
             getModel: vi.fn().mockReturnValue({ modelId: 'provider/language-model', provider: 'gateway' }),
         }));
-        const createKtxEmbeddingProvider = vi.fn(() => ({
+        const embeddingProvider = {
             dimensions: 1536,
             maxBatchSize: 8,
             embed: vi.fn(),
             [['embed', 'Many'].join('')]: vi.fn(),
-        }));
+        };
         const providers = createLocalScanEnrichmentProvidersFromConfig({
             mode: 'llm',
             embeddings: {
@@ -763,12 +763,11 @@ describe('local scan enrichment', () => {
             models: { default: 'provider/language-model' },
         }, {
             createKtxLlmProvider: createKtxLlmProvider,
-            createKtxEmbeddingProvider: createKtxEmbeddingProvider,
             env: { OPENAI_API_KEY: 'openai-key' }, // pragma: allowlist secret
+            embeddingProvider: embeddingProvider,
         });
         expect(providers?.embedding?.dimensions).toBe(1536);
         expect(providers?.embedding?.maxBatchSize).toBe(8);
         expect(createKtxLlmProvider).toHaveBeenCalledWith(expect.objectContaining({ backend: 'gateway', modelSlots: { default: 'provider/language-model' } }));
-        expect(createKtxEmbeddingProvider).toHaveBeenCalledWith(expect.objectContaining({ backend: 'openai', model: 'provider/embedding-model' }));
     });
 });

package/node_modules/@ktx/context/dist/scan/local-scan.d.ts

@@ -1,4 +1,4 @@
-import type { createKtxEmbeddingProvider, createKtxLlmProvider } from '@ktx/llm';
+import type { createKtxEmbeddingProvider, createKtxLlmProvider, KtxEmbeddingProvider } from '@ktx/llm';
 import { type LocalIngestRunRecord, type SourceAdapter } from '../ingest/index.js';
 import type { KtxProjectLlmConfig, KtxScanEnrichmentConfig } from '../project/config.js';
 import type { KtxLocalProject } from '../project/index.js';
@@ -21,6 +21,7 @@ export interface RunLocalScanOptions {
     enrichmentProviders?: KtxLocalScanEnrichmentProviders | null;
     enrichmentStateStore?: SqliteLocalScanEnrichmentStateStore | null;
     progress?: KtxProgressPort;
+    embeddingProvider?: KtxEmbeddingProvider | null;
 }
 export interface LocalScanRunResult {
     runId: string;
@@ -58,6 +59,7 @@ interface LocalScanEnrichmentProviderDeps {
     createKtxEmbeddingProvider?: typeof createKtxEmbeddingProvider;
     env?: NodeJS.ProcessEnv;
     projectDir?: string;
+    embeddingProvider?: KtxEmbeddingProvider | null;
 }
 export declare function createLocalScanEnrichmentProvidersFromConfig(config: KtxScanEnrichmentConfig, llmConfig: KtxProjectLlmConfig, deps?: LocalScanEnrichmentProviderDeps): KtxLocalScanEnrichmentProviders | null;
 export { filterSnapshotTables, resolveEnabledTables } from './enabled-tables.js';

package/node_modules/@ktx/context/dist/scan/local-scan.js

@@ -1,5 +1,5 @@
 import { createDefaultLocalIngestAdapters, getLocalStageOnlyIngestStatus, runLocalStageOnlyIngest, } from '../ingest/index.js';
-import { createLocalKtxEmbeddingProviderFromConfig, createLocalKtxLlmRuntimeFromConfig, KtxScanEmbeddingPortAdapter, } from '../llm/index.js';
+import { createLocalKtxLlmRuntimeFromConfig, KtxScanEmbeddingPortAdapter } from '../llm/index.js';
 import { ktxLocalStateDbPath } from '../project/local-state-db.js';
 import { redactKtxScanReport } from './credentials.js';
 import { filterSnapshotTables, resolveEnabledTables } from './enabled-tables.js';
@@ -65,7 +65,7 @@ export function createLocalScanEnrichmentProvidersFromConfig(config, llmConfig,
         ...deps,
         projectDir: deps.projectDir,
     });
-    const embeddingProvider = createLocalKtxEmbeddingProviderFromConfig(config.embeddings, deps);
+    const embeddingProvider = deps.embeddingProvider ?? null;
     if (!llmRuntime || !embeddingProvider) {
         return null;
     }
@@ -227,6 +227,7 @@ export async function runLocalScan(options) {
             ? options.enrichmentProviders
             : createLocalScanEnrichmentProvidersFromConfig(options.project.config.scan.enrichment, options.project.config.llm, {
                 projectDir: options.project.projectDir,
+                embeddingProvider: options.embeddingProvider ?? null,
             })
         : null;
     await options.progress?.update(0.15, 'Inspecting database schema');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaelio/ktx",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Standalone KTX context layer for database agents",
   "private": false,
   "type": "module",