feat: npm-managed Python runtime for @kaelio/ktx (#7)

* docs: add npm managed python runtime design

* build: add bundled python runtime wheel builder

* build: make local embedding dependencies optional

* build: bundle python runtime wheel in cli artifacts

* build: track bundled python runtime release artifact

* test: verify bundled python runtime wheel

* docs: add plan for bundled python runtime wheel

* test: cover managed python runtime lifecycle

* feat: add managed python runtime installer

* feat: add runtime command runner

* feat: expose runtime management commands

* test: verify managed python runtime commands

* docs: add plan for managed python runtime installer

* feat: add managed python command helper

* feat: use managed runtime for sl query compute

* feat: route sl query managed runtime policy

* docs: add plan for managed runtime sl query integration

* feat: add managed runtime daemon metadata

* feat: manage python daemon lifecycle

* feat: add runtime daemon start stop commands

* fix: verify managed runtime daemon lifecycle

* docs: add plan for managed runtime daemon lifecycle

* feat: add managed local embeddings config marker

* feat: add managed local embeddings daemon helper

* feat: use managed runtime for local embedding setup

* feat: pass managed runtime policy through setup

* docs: add plan for managed local embeddings runtime

* feat: read CLI package metadata dynamically

* feat: assemble public kaelio ktx npm package

* feat: release one public kaelio ktx npm artifact

* test: cover public kaelio ktx package invocations

* chore: verify public kaelio ktx package artifacts

* docs: add plan for public kaelio ktx npm package

* test: verify managed runtime in public package smoke

* test: finalize managed runtime release smoke

* docs: add plan for managed runtime release smoke

* test: specify local embeddings release smoke

* feat: add local embeddings runtime smoke

* chore: register local embeddings smoke

* fix: verify local embeddings smoke

* fix: restore artifact smoke python env helper

* docs: add plan for managed local embeddings release smoke

* refactor: share managed runtime install policy parsing

* feat: use managed runtime for agent semantic queries

* feat: use managed runtime for MCP semantic compute

* docs: add plan for managed agent and MCP semantic runtime

* feat(cli): add managed daemon HTTP helpers

* feat(cli): route local adapters through managed daemon

* feat(cli): use managed daemon for ingest helpers

* feat(cli): pass managed daemon options to scan

* feat(context): pass MCP ingest pull config options

* feat(cli): pass managed daemon options to serve ingest

* test: verify managed local ingest daemon runtime

* docs: add plan for managed local ingest daemon runtime

* docs: align managed runtime examples

* docs: add plan for managed runtime docs cleanup

* test: cover published package runtime smoke commands

* test: validate published package smoke outputs

* docs: add plan for published package runtime smoke

* build: stamp public npm package version

* release: add npm public release policy

* release: add guarded npm publish script

* release: document public npm release handoff

* docs: add plan for public npm release handoff

* test: cover managed runtime prune in package smoke

* docs: document managed runtime prune

* docs: add plan for managed runtime prune smoke and docs

* chore: encode uv runtime prerequisite policy

* fix: clarify missing uv runtime error

* docs: document uv runtime prerequisite

* docs: add plan for uv runtime prerequisite contract

* refactor: limit release artifacts to public package runtime

* chore: align release policy with bundled runtime wheel

* docs: describe single public runtime artifact surface

* test: verify single public runtime artifact contract

* docs: add plan for single public runtime artifact cleanup

* fix: align local embeddings smoke with public version

* docs: add plan for local embeddings smoke public version

* release: soft-launch as @kaelio/ktx@0.1.0-rc.0 on next tag

Publish target moves to the pre-release version 0.1.0-rc.0 under the next
dist-tag so npm install @kaelio/ktx (which resolves to latest) does not
pick up the soft-launch build. Users opt in via @kaelio/ktx@next.

* Fix release script boundary checks

* Remove PostHog from public package bundle

packages/cli/src/agent-runtime.ts

@@ -1,9 +1,13 @@
 import { readFile } from 'node:fs/promises';
 import { createDefaultLocalQueryExecutor, type KtxSqlQueryExecutorPort } from '@ktx/context/connections';
-import { createPythonSemanticLayerComputePort, type KtxSemanticLayerComputePort } from '@ktx/context/daemon';
+import type { KtxSemanticLayerComputePort } from '@ktx/context/daemon';
 import { createLocalProjectMcpContextPorts, type KtxMcpContextPorts } from '@ktx/context/mcp';
 import { type KtxLocalProject, loadKtxProject } from '@ktx/context/project';
 import type { KtxCliIo } from './cli-runtime.js';
+import {
+  createManagedPythonSemanticLayerComputePort,
+  type KtxManagedPythonInstallPolicy,
+} from './managed-python-command.js';
 
 export const KTX_AGENT_MAX_ROWS_CAP = 1000;
 
@@ -11,6 +15,9 @@ export interface KtxAgentRuntimeOptions {
   projectDir: string;
   enableSemanticCompute: boolean;
   enableQueryExecution: boolean;
+  cliVersion?: string;
+  runtimeInstallPolicy?: KtxManagedPythonInstallPolicy;
+  io?: KtxCliIo;
 }
 
 export interface KtxAgentRuntime {
@@ -24,6 +31,7 @@ export interface KtxAgentRuntimeDeps {
   loadProject?: typeof loadKtxProject;
   createContextTools?: typeof createLocalProjectMcpContextPorts;
   createSemanticLayerCompute?: () => KtxSemanticLayerComputePort;
+  createManagedSemanticLayerCompute?: typeof createManagedPythonSemanticLayerComputePort;
   createQueryExecutor?: () => KtxSqlQueryExecutorPort;
 }
 
@@ -57,14 +65,34 @@ export function parseAgentMaxRows(value: number | undefined): number {
   return value;
 }
 
+async function createAgentSemanticLayerCompute(
+  options: KtxAgentRuntimeOptions,
+  deps: KtxAgentRuntimeDeps,
+): Promise<KtxSemanticLayerComputePort | undefined> {
+  if (!options.enableSemanticCompute) {
+    return undefined;
+  }
+  if (deps.createSemanticLayerCompute) {
+    return deps.createSemanticLayerCompute();
+  }
+  if (!options.cliVersion || !options.runtimeInstallPolicy || !options.io) {
+    throw new Error('Managed Python semantic compute requires cliVersion, runtimeInstallPolicy, and io.');
+  }
+  const createManagedSemanticLayerCompute =
+    deps.createManagedSemanticLayerCompute ?? createManagedPythonSemanticLayerComputePort;
+  return createManagedSemanticLayerCompute({
+    cliVersion: options.cliVersion,
+    installPolicy: options.runtimeInstallPolicy,
+    io: options.io,
+  });
+}
+
 export async function createKtxAgentRuntime(
   options: KtxAgentRuntimeOptions,
   deps: KtxAgentRuntimeDeps = {},
 ): Promise<KtxAgentRuntime> {
   const project = await (deps.loadProject ?? loadKtxProject)({ projectDir: options.projectDir });
-  const semanticLayerCompute = options.enableSemanticCompute
-    ? (deps.createSemanticLayerCompute ?? createPythonSemanticLayerComputePort)()
-    : undefined;
+  const semanticLayerCompute = await createAgentSemanticLayerCompute(options, deps);
   const queryExecutor = options.enableQueryExecution
     ? (deps.createQueryExecutor ?? createDefaultLocalQueryExecutor)()
     : undefined;