@kaelio/ktx 0.3.0 → 0.4.1

package/dist/index.test.js

@@ -6,6 +6,8 @@ import { initKtxProject } from '@ktx/context/project';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { getKtxCliPackageInfo, packageInfoFromJson, rendererUnavailableVizFallback, renderMemoryFlowTui, resolveVizFallback, runKtxCli, sanitizeMemoryFlowTuiError, startLiveMemoryFlowTui, warnVizFallbackOnce, } from './index.js';
 const require = createRequire(import.meta.url);
+const cliPackageJson = require('@ktx/cli/package.json');
+const cliVersion = cliPackageJson.version;
 function makeIo(options = {}) {
     let stdout = '';
     let stderr = '';
@@ -31,7 +33,7 @@ describe('getKtxCliPackageInfo', () => {
     it('identifies the CLI package and its context dependency', () => {
         expect(getKtxCliPackageInfo()).toEqual({
             name: '@ktx/cli',
-            version: '0.0.0-private',
+            version: cliVersion,
             contextPackageName: '@ktx/context',
         });
     });
@@ -39,8 +41,9 @@ describe('getKtxCliPackageInfo', () => {
         const packageJson = require('@ktx/cli/package.json');
         expect(packageJson).toMatchObject({
             name: '@ktx/cli',
-            version: '0.0.0-private',
+            version: cliVersion,
         });
+        expect(cliVersion).toMatch(/^\d+\.\d+\.\d+/);
     });
     it('normalizes public package metadata from package.json contents', () => {
         expect(packageInfoFromJson({
@@ -86,7 +89,7 @@ describe('runKtxCli', () => {
     it('prints version information', async () => {
         const testIo = makeIo();
         await expect(runKtxCli(['--version'], testIo.io)).resolves.toBe(0);
-        expect(testIo.stdout()).toBe('@ktx/cli 0.0.0-private\n');
+        expect(testIo.stdout()).toBe(`@ktx/cli ${cliVersion}\n`);
         expect(testIo.stderr()).toBe('');
     });
     it('prints the public command surface in root help', async () => {
@@ -114,41 +117,41 @@ describe('runKtxCli', () => {
         const listIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'wiki', '--json'], listIo.io, { knowledge }))
             .resolves.toBe(0);
-        expect(knowledge).toHaveBeenCalledWith({
+        expect(knowledge).toHaveBeenCalledWith(expect.objectContaining({
             command: 'list',
             projectDir: tempDir,
             userId: 'local',
             json: true,
-        }, listIo.io);
+        }), listIo.io);
         const searchIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'wiki', 'revenue', '--limit', '5'], searchIo.io, { knowledge })).resolves.toBe(0);
-        expect(knowledge).toHaveBeenLastCalledWith({
+        expect(knowledge).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'search',
             projectDir: tempDir,
             query: 'revenue',
             userId: 'local',
             json: false,
             limit: 5,
-        }, searchIo.io);
+        }), searchIo.io);
         const debugSearchIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, '--debug', 'wiki', 'revenue'], debugSearchIo.io, { knowledge })).resolves.toBe(0);
-        expect(knowledge).toHaveBeenLastCalledWith({
+        expect(knowledge).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'search',
             projectDir: tempDir,
             query: 'revenue',
             userId: 'local',
             json: false,
             debug: true,
-        }, debugSearchIo.io);
+        }), debugSearchIo.io);
         const multiWordIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'wiki', 'revenue', 'policy'], multiWordIo.io, { knowledge })).resolves.toBe(0);
-        expect(knowledge).toHaveBeenLastCalledWith({
+        expect(knowledge).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'search',
             projectDir: tempDir,
             query: 'revenue policy',
             userId: 'local',
             json: false,
-        }, multiWordIo.io);
+        }), multiWordIo.io);
     });
     it('rejects unknown write-style flags on the flattened wiki and sl commands', async () => {
         const knowledge = vi.fn(async () => 0);
@@ -166,7 +169,7 @@ describe('runKtxCli', () => {
         const sl = vi.fn(async () => 0);
         const searchIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', 'revenue', '--connection-id', 'warehouse', '--limit', '5', '--json'], searchIo.io, { sl })).resolves.toBe(0);
-        expect(sl).toHaveBeenCalledWith({
+        expect(sl).toHaveBeenCalledWith(expect.objectContaining({
             command: 'search',
             projectDir: tempDir,
             connectionId: 'warehouse',
@@ -174,16 +177,16 @@ describe('runKtxCli', () => {
             limit: 5,
             json: true,
             output: undefined,
-        }, searchIo.io);
+        }), searchIo.io);
         const bareIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', '--connection-id', 'warehouse', '--json'], bareIo.io, { sl })).resolves.toBe(0);
-        expect(sl).toHaveBeenLastCalledWith({
+        expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'list',
             projectDir: tempDir,
             connectionId: 'warehouse',
             json: true,
             output: undefined,
-        }, bareIo.io);
+        }), bareIo.io);
         const unknownIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', '--query', 'revenue'], unknownIo.io, { sl })).resolves.toBe(1);
         expect(unknownIo.stderr()).toContain("unknown option '--query'");
@@ -206,32 +209,32 @@ describe('runKtxCli', () => {
         await expect(runKtxCli(['admin', 'runtime', 'prune', '--dry-run'], pruneIo.io, { runtime })).resolves.toBe(1);
         expect(runtime).toHaveBeenNthCalledWith(1, {
             command: 'install',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             feature: 'local-embeddings',
             force: true,
         }, installIo.io);
         expect(runtime).toHaveBeenNthCalledWith(2, {
             command: 'start',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             projectDir: expect.any(String),
             feature: 'local-embeddings',
             force: true,
         }, startIo.io);
         expect(runtime).toHaveBeenNthCalledWith(3, {
             command: 'stop',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             projectDir: expect.any(String),
             all: false,
         }, stopIo.io);
         expect(runtime).toHaveBeenNthCalledWith(4, {
             command: 'stop',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             projectDir: expect.any(String),
             all: true,
         }, stopAllIo.io);
         expect(runtime).toHaveBeenNthCalledWith(5, {
             command: 'status',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             json: true,
         }, statusIo.io);
         expect(runtime).toHaveBeenCalledTimes(5);
@@ -278,7 +281,7 @@ describe('runKtxCli', () => {
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
             command: 'query',
             projectDir: tempDir,
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'prompt',
             query: expect.objectContaining({ measures: ['orders.order_count'], dimensions: [] }),
         }), promptIo.io);
@@ -287,13 +290,13 @@ describe('runKtxCli', () => {
             sl,
         })).resolves.toBe(0);
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'auto',
         }), autoIo.io);
         const noInputIo = makeIo();
         await expect(runKtxCli(['--project-dir', tempDir, 'sl', 'query', '--measure', 'orders.order_count', '--no-input'], noInputIo.io, { sl })).resolves.toBe(0);
         expect(sl).toHaveBeenLastCalledWith(expect.objectContaining({
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'never',
         }), noInputIo.io);
     });
@@ -403,7 +406,7 @@ describe('runKtxCli', () => {
                 skipAgents: false,
                 inputMode: 'auto',
                 yes: false,
-                cliVersion: '0.0.0-private',
+                cliVersion,
                 skipLlm: false,
                 skipEmbeddings: false,
                 databaseSchemas: [],
@@ -512,7 +515,7 @@ describe('runKtxCli', () => {
             inputMode: 'disabled',
             depth: 'fast',
             queryHistory: 'default',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'never',
         }, testIo.io);
         expect(testIo.stderr()).toBe(`Project: ${tempDir}\n`);
@@ -531,7 +534,7 @@ describe('runKtxCli', () => {
             inputMode: 'auto',
             depth: 'deep',
             queryHistory: 'default',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'prompt',
         }, testIo.io);
         expect(testIo.stderr()).toBe('');
@@ -580,7 +583,7 @@ describe('runKtxCli', () => {
             json: false,
             inputMode: 'disabled',
             queryHistory: 'default',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'never',
         }, testIo.io);
     });
@@ -798,7 +801,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
             llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
@@ -825,7 +828,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             llmBackend: 'vertex',
             vertexProject: 'local-gcp-project',
             vertexLocation: 'us-east5',
@@ -850,7 +853,7 @@ describe('runKtxCli', () => {
             command: 'run',
             projectDir: tempDir,
             inputMode: 'disabled',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             llmBackend: 'claude-code',
             llmModel: 'opus',
             skipLlm: false,
@@ -925,7 +928,7 @@ describe('runKtxCli', () => {
             projectDir: '/tmp/project',
             inputMode: 'disabled',
             yes: true,
-            cliVersion: '0.0.0-private',
+            cliVersion,
             skipLlm: true,
             skipEmbeddings: true,
             databaseDrivers: ['postgres'],
@@ -1143,7 +1146,7 @@ describe('runKtxCli', () => {
             queryFile: '/tmp/query.json',
             execute: false,
             format: 'json',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'auto',
         }, autoIo.io);
         expect(sl).toHaveBeenNthCalledWith(2, {
@@ -1153,7 +1156,7 @@ describe('runKtxCli', () => {
             queryFile: '/tmp/query.json',
             execute: false,
             format: 'json',
-            cliVersion: '0.0.0-private',
+            cliVersion,
             runtimeInstallPolicy: 'never',
         }, neverIo.io);
         expect(conflictIo.stderr()).toContain('Choose only one runtime install mode: --yes or --no-input');

package/dist/ingest.js

@@ -1,5 +1,6 @@
 import { buildMemoryFlowViewModel, createMemoryFlowLiveBuffer, formatMemoryFlowFinalSummary, getLatestLocalIngestStatus, getLocalIngestStatus, ingestReportToMemoryFlowReplay, renderMemoryFlowReplay, runLocalIngest, runLocalMetabaseIngest, savedMemoryCountsForReport, sanitizeMemoryFlowError, } from '@ktx/context/ingest';
-import { loadKtxCliProject } from './cli-project.js';
+import { loadKtxProject } from '@ktx/context/project';
+import { resolveProjectEmbeddingProvider } from './embedding-resolution.js';
 import { createKtxCliIngestQueryExecutor } from './ingest-query-executor.js';
 import { readIngestReportSnapshotFile } from './ingest-report-file.js';
 import { createCliOperationalLogger } from './io/logger.js';
@@ -470,16 +471,16 @@ async function writeReportRecord(report, outputMode, io, options = {}) {
 }
 export async function runKtxIngest(args, io = process, deps = {}) {
     try {
-        const cliVersion = args.command === 'run' ? args.cliVersion : undefined;
-        const runtimeInstallPolicy = args.command === 'run' ? args.runtimeInstallPolicy : undefined;
-        const project = await loadKtxCliProject({
-            projectDir: args.projectDir,
-            cliVersion: cliVersion ?? '0.0.0-private',
-            installPolicy: runtimeInstallPolicy ?? 'never',
-            io,
-        });
+        const project = await loadKtxProject({ projectDir: args.projectDir });
         const env = deps.env ?? process.env;
         if (args.command === 'run') {
+            const resolution = await resolveProjectEmbeddingProvider(project, {
+                mode: 'ensure',
+                installPolicy: args.runtimeInstallPolicy ?? 'never',
+                cliVersion: args.cliVersion ?? '0.0.0-private',
+                io,
+            });
+            const embeddingProvider = resolution.kind === 'disabled' || resolution.kind === 'managed-unavailable' ? null : resolution.provider;
             const ingestProject = args.allowImplicitAdapter && !project.config.ingest.adapters.includes(args.adapter)
                 ? {
                     ...project,
@@ -550,6 +551,7 @@ export async function runKtxIngest(args, io = process, deps = {}) {
                         queryExecutor,
                         trigger: 'manual_resync',
                         jobIdFactory: deps.jobIdFactory,
+                        embeddingProvider,
                         ...(memoryFlow ? { memoryFlow } : {}),
                         ...(progress ? { progress } : {}),
                     });
@@ -617,6 +619,7 @@ export async function runKtxIngest(args, io = process, deps = {}) {
                     ...localIngestOptions,
                     queryExecutor,
                     pullConfigOptions: adapterOptions,
+                    embeddingProvider,
                     ...(args.debugLlmRequestFile ? { llmDebugRequestFile: args.debugLlmRequestFile } : {}),
                     ...(memoryFlow ? { memoryFlow } : {}),
                 });

package/dist/knowledge.d.ts

@@ -1,10 +1,13 @@
-import { createLocalKtxEmbeddingProviderFromConfig, type KtxEmbeddingPort } from '@ktx/context';
+import { type KtxEmbeddingPort } from '@ktx/context';
+import { searchLocalKnowledgePages as defaultSearchLocalKnowledgePages } from '@ktx/context/wiki';
+import { resolveProjectEmbeddingProvider } from './embedding-resolution.js';
 export type KtxKnowledgeArgs = {
     command: 'list';
     projectDir: string;
     userId: string;
     output?: string;
     json?: boolean;
+    cliVersion: string;
 } | {
     command: 'search';
     projectDir: string;
@@ -14,11 +17,13 @@ export type KtxKnowledgeArgs = {
     json?: boolean;
     limit?: number;
     debug?: boolean;
+    cliVersion: string;
 };
 type KtxKnowledgeIo = import('./cli-runtime.js').KtxCliIo;
 interface KtxKnowledgeDeps {
     embeddingService?: KtxEmbeddingPort | null;
-    createEmbeddingProvider?: typeof createLocalKtxEmbeddingProviderFromConfig;
+    resolveEmbeddingProvider?: typeof resolveProjectEmbeddingProvider;
+    searchLocalKnowledgePages?: typeof defaultSearchLocalKnowledgePages;
 }
 export declare function runKtxKnowledge(args: KtxKnowledgeArgs, io?: KtxKnowledgeIo, deps?: KtxKnowledgeDeps): Promise<number>;
 export {};

package/dist/knowledge.js

@@ -1,6 +1,7 @@
-import { createLocalKtxEmbeddingProviderFromConfig, KtxIngestEmbeddingPortAdapter, } from '@ktx/context';
+import { KtxIngestEmbeddingPortAdapter } from '@ktx/context';
 import { loadKtxProject } from '@ktx/context/project';
-import { listLocalKnowledgePages, searchLocalKnowledgePages, } from '@ktx/context/wiki';
+import { listLocalKnowledgePages, searchLocalKnowledgePages as defaultSearchLocalKnowledgePages, } from '@ktx/context/wiki';
+import { resolveProjectEmbeddingProvider, } from './embedding-resolution.js';
 import { resolveOutputMode } from './io/mode.js';
 import { createRankBadgeFormatter, printList } from './io/print-list.js';
 const WIKI_LIST_COLUMNS = [
@@ -23,12 +24,24 @@ function wikiSearchColumns(rows) {
         { key: 'summary', label: 'SUMMARY', plain: '', optional: true, dim: true },
     ];
 }
-function wikiSearchEmbeddingService(project, deps) {
+function resolutionToEmbeddingPort(resolution) {
+    if (resolution.kind === 'configured' ||
+        resolution.kind === 'managed-running' ||
+        resolution.kind === 'managed-started') {
+        return new KtxIngestEmbeddingPortAdapter(resolution.provider);
+    }
+    return null;
+}
+async function wikiSearchEmbeddingService(project, deps, args, io) {
     if ('embeddingService' in deps) {
         return deps.embeddingService ?? null;
     }
-    const provider = (deps.createEmbeddingProvider ?? createLocalKtxEmbeddingProviderFromConfig)(project.config.ingest.embeddings);
-    return provider ? new KtxIngestEmbeddingPortAdapter(provider) : null;
+    const resolution = await (deps.resolveEmbeddingProvider ?? resolveProjectEmbeddingProvider)(project, {
+        mode: 'use-if-running',
+        cliVersion: args.cliVersion,
+        io,
+    });
+    return resolutionToEmbeddingPort(resolution);
 }
 function writeWikiSearchDebug(io, input) {
     io.stderr.write(`[debug] wiki search mode=${input.mode} embedding=${input.embeddingConfigured ? 'configured' : 'unconfigured'} results=${input.results.length}\n`);
@@ -58,8 +71,9 @@ export async function runKtxKnowledge(args, io = process, deps = {}) {
             return 0;
         }
         if (args.command === 'search') {
-            const embeddingService = wikiSearchEmbeddingService(project, deps);
-            const results = await searchLocalKnowledgePages(project, {
+            const embeddingService = await wikiSearchEmbeddingService(project, deps, { cliVersion: args.cliVersion }, io);
+            const search = deps.searchLocalKnowledgePages ?? defaultSearchLocalKnowledgePages;
+            const results = await search(project, {
                 query: args.query,
                 userId: args.userId,
                 embeddingService,

package/dist/knowledge.test.js

@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import { stripVTControlCharacters } from 'node:util';
 import { initKtxProject, loadKtxProject } from '@ktx/context/project';
 import { writeLocalKnowledgePage } from '@ktx/context/wiki';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { runKtxKnowledge } from './knowledge.js';
 function makeIo() {
     let stdout = '';
@@ -62,10 +62,10 @@ describe('runKtxKnowledge', () => {
         await initKtxProject({ projectDir });
         await seedWikiPage(projectDir);
         const listIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'list', projectDir, userId: 'local' }, listIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({ command: 'list', projectDir, userId: 'local', cliVersion: '0.0.0-test' }, listIo.io)).resolves.toBe(0);
         expect(listIo.stdout()).toContain('GLOBAL\tmetrics-revenue\tRevenue');
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'paid order', userId: 'local' }, searchIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'paid order', userId: 'local', cliVersion: '0.0.0-test' }, searchIo.io)).resolves.toBe(0);
         expect(searchIo.stdout()).toContain('metrics-revenue');
     });
     it('prints wiki search rank badges in pretty output', async () => {
@@ -73,7 +73,14 @@ describe('runKtxKnowledge', () => {
         await initKtxProject({ projectDir });
         await seedWikiPage(projectDir);
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'paid order', userId: 'local', output: 'pretty' }, searchIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({
+            command: 'search',
+            projectDir,
+            query: 'paid order',
+            userId: 'local',
+            output: 'pretty',
+            cliVersion: '0.0.0-test',
+        }, searchIo.io)).resolves.toBe(0);
         const stdout = stripVTControlCharacters(searchIo.stdout());
         expect(stdout).toMatch(/#1\s+metrics-revenue/);
         expect(stdout).not.toContain('%');
@@ -83,14 +90,22 @@ describe('runKtxKnowledge', () => {
         await initKtxProject({ projectDir });
         await seedWikiPage(projectDir);
         const listIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'list', projectDir, userId: 'local', json: true }, listIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({ command: 'list', projectDir, userId: 'local', json: true, cliVersion: '0.0.0-test' }, listIo.io)).resolves.toBe(0);
         expect(JSON.parse(listIo.stdout())).toMatchObject({
             kind: 'list',
             data: { items: [expect.objectContaining({ key: 'metrics-revenue', summary: 'Revenue' })] },
             meta: { command: 'wiki list' },
         });
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'paid order', userId: 'local', json: true, limit: 5 }, searchIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({
+            command: 'search',
+            projectDir,
+            query: 'paid order',
+            userId: 'local',
+            json: true,
+            limit: 5,
+            cliVersion: '0.0.0-test',
+        }, searchIo.io)).resolves.toBe(0);
         expect(JSON.parse(searchIo.stdout())).toMatchObject({
             kind: 'list',
             data: { items: [expect.objectContaining({ key: 'metrics-revenue', summary: 'Revenue' })] },
@@ -101,7 +116,7 @@ describe('runKtxKnowledge', () => {
         const projectDir = join(tempDir, 'empty-project');
         await initKtxProject({ projectDir });
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'revenue', userId: 'local' }, searchIo.io)).resolves.toBe(0);
+        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'revenue', userId: 'local', cliVersion: '0.0.0-test' }, searchIo.io)).resolves.toBe(0);
         expect(searchIo.stdout()).toBe('');
         expect(searchIo.stderr()).toContain('No local wiki pages found');
         expect(searchIo.stderr()).toContain('ktx ingest <connectionId>');
@@ -117,16 +132,45 @@ describe('runKtxKnowledge', () => {
             slRefs: [],
         });
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'revenue', userId: 'local' }, searchIo.io, { embeddingService: new FakeEmbeddingPort() })).resolves.toBe(0);
+        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'revenue', userId: 'local', cliVersion: '0.0.0-test' }, searchIo.io, { embeddingService: new FakeEmbeddingPort() })).resolves.toBe(0);
         expect(searchIo.stdout()).toContain('active-contract-arr-open-tickets');
         expect(searchIo.stderr()).toBe('');
     });
+    it('routes wiki search through resolveEmbeddingProvider when no embeddingService is injected', async () => {
+        const projectDir = join(tempDir, 'resolver-project');
+        await initKtxProject({ projectDir });
+        const search = vi.fn(async () => []);
+        const searchIo = makeIo();
+        await expect(runKtxKnowledge({
+            command: 'search',
+            projectDir,
+            query: 'income',
+            userId: 'local',
+            cliVersion: '0.5.0',
+        }, searchIo.io, {
+            resolveEmbeddingProvider: async () => ({
+                kind: 'managed-running',
+                provider: { id: 'fake' },
+                baseUrl: 'http://127.0.0.1:51234',
+            }),
+            searchLocalKnowledgePages: search,
+        })).resolves.toBe(0);
+        expect(search).toHaveBeenCalledWith(expect.anything(), expect.objectContaining({ embeddingService: expect.any(Object) }));
+    });
     it('writes wiki search lane diagnostics to stderr when debug is enabled', async () => {
         const projectDir = join(tempDir, 'debug-project');
         await initKtxProject({ projectDir });
         await seedWikiPage(projectDir);
         const searchIo = makeIo();
-        await expect(runKtxKnowledge({ command: 'search', projectDir, query: 'paid order', userId: 'local', json: true, debug: true }, searchIo.io, { embeddingService: new FakeEmbeddingPort() })).resolves.toBe(0);
+        await expect(runKtxKnowledge({
+            command: 'search',
+            projectDir,
+            query: 'paid order',
+            userId: 'local',
+            json: true,
+            debug: true,
+            cliVersion: '0.0.0-test',
+        }, searchIo.io, { embeddingService: new FakeEmbeddingPort() })).resolves.toBe(0);
         expect(JSON.parse(searchIo.stdout())).toMatchObject({
             kind: 'list',
             data: { items: [expect.objectContaining({ key: 'metrics-revenue' })] },

package/dist/managed-local-embeddings.d.ts

@@ -1,8 +1,7 @@
-import type { KtxProjectEmbeddingConfig } from '@ktx/context/project';
 import type { KtxEmbeddingConfig } from '@ktx/llm';
 import type { KtxCliIo } from './cli-runtime.js';
 import { type KtxManagedPythonInstallPolicy, type ManagedPythonCommandRuntime } from './managed-python-command.js';
-import { type ManagedPythonDaemonStartResult } from './managed-python-daemon.js';
+import { readManagedPythonDaemonStatus, type ManagedPythonDaemonStartResult } from './managed-python-daemon.js';
 export interface ManagedLocalEmbeddingsDaemon {
     baseUrl: string;
     stdoutLog: string;
@@ -26,13 +25,15 @@ export interface ManagedLocalEmbeddingsOptions {
         force: boolean;
     }) => Promise<ManagedPythonDaemonStartResult>;
 }
-export declare function managedLocalEmbeddingProjectConfig(input: {
-    model: string;
-    dimensions: number;
-}): KtxProjectEmbeddingConfig;
 export declare function managedLocalEmbeddingHealthConfig(input: {
     baseUrl: string;
     model: string;
     dimensions: number;
 }): KtxEmbeddingConfig;
 export declare function ensureManagedLocalEmbeddingsDaemon(options: ManagedLocalEmbeddingsOptions): Promise<ManagedLocalEmbeddingsDaemon>;
+export interface TryUseManagedLocalEmbeddingsOptions {
+    cliVersion: string;
+    projectDir: string;
+    readStatus?: typeof readManagedPythonDaemonStatus;
+}
+export declare function tryUseManagedLocalEmbeddingsDaemon(options: TryUseManagedLocalEmbeddingsOptions): Promise<ManagedLocalEmbeddingsDaemon | null>;

package/dist/managed-local-embeddings.js

@@ -1,17 +1,5 @@
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
 import { ensureManagedPythonCommandRuntime, } from './managed-python-command.js';
-import { startManagedPythonDaemon } from './managed-python-daemon.js';
-export function managedLocalEmbeddingProjectConfig(input) {
-    return {
-        backend: 'sentence-transformers',
-        model: input.model,
-        dimensions: input.dimensions,
-        sentenceTransformers: {
-            base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL,
-            pathPrefix: '',
-        },
-    };
-}
+import { readManagedPythonDaemonStatus, startManagedPythonDaemon, } from './managed-python-daemon.js';
 export function managedLocalEmbeddingHealthConfig(input) {
     return {
         backend: 'sentence-transformers',
@@ -46,3 +34,21 @@ export async function ensureManagedLocalEmbeddingsDaemon(options) {
         stderrLog: daemon.state.stderrLog,
     };
 }
+export async function tryUseManagedLocalEmbeddingsDaemon(options) {
+    const readStatus = options.readStatus ?? readManagedPythonDaemonStatus;
+    const status = await readStatus({
+        cliVersion: options.cliVersion,
+        projectDir: options.projectDir,
+    });
+    if (status.kind !== 'running') {
+        return null;
+    }
+    if (!status.state.features.includes('local-embeddings')) {
+        return null;
+    }
+    return {
+        baseUrl: status.baseUrl,
+        stdoutLog: status.state.stdoutLog,
+        stderrLog: status.state.stderrLog,
+    };
+}