@oh-my-pi/pi-coding-agent 15.5.15 → 15.7.0

package/dist/types/config/settings-schema.d.ts

@@ -105,6 +105,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly setupVersion: {
+        readonly type: "number";
+        readonly default: 0;
+    };
     readonly "auth.broker.url": {
         readonly type: "string";
         readonly default: undefined;
@@ -462,7 +466,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "tools";
             readonly label: "Artifact head size (KB)";
-            readonly description: "Amount of head content kept inline alongside the tail when output spills to artifact (middle elision). 0 disables \u2014 keep tail only.";
+            readonly description: "Amount of head content kept inline alongside the tail when output spills to artifact (middle elision). 0 disables — keep tail only.";
             readonly options: readonly [{
                 readonly value: "0";
                 readonly label: "0 KB";
@@ -1142,6 +1146,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Skip welcome screen and startup status messages";
         };
     };
+    readonly "startup.setupWizard": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Setup Wizard";
+            readonly description: "Show newly added onboarding steps once per setup version";
+        };
+    };
     readonly "startup.checkUpdate": {
         readonly type: "boolean";
         readonly default: true;
@@ -1597,12 +1610,12 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "memory.backend": {
         readonly type: "enum";
-        readonly values: readonly ["off", "local", "hindsight"];
+        readonly values: readonly ["off", "local", "hindsight", "mnemosyne"];
         readonly default: "off";
         readonly ui: {
             readonly tab: "memory";
             readonly label: "Memory Backend";
-            readonly description: "Off, local memory pipeline, or Hindsight remote memory";
+            readonly description: "Off, local summary pipeline, Mnemosyne SQLite, or Hindsight remote memory";
             readonly options: readonly [{
                 readonly value: "off";
                 readonly label: "Off";
@@ -1615,9 +1628,195 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "hindsight";
                 readonly label: "Hindsight";
                 readonly description: "Vectorize Hindsight remote memory service";
+            }, {
+                readonly value: "mnemosyne";
+                readonly label: "Mnemosyne";
+                readonly description: "Local SQLite recall/retain backend with optional embeddings";
+            }];
+        };
+    };
+    readonly "mnemosyne.dbPath": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne DB Path";
+            readonly description: "Optional SQLite DB path. Defaults to the agent memories directory.";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.bank": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Bank";
+            readonly description: "Optional shared bank base name. Per-project modes derive project-local banks from it.";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.scoping": {
+        readonly type: "enum";
+        readonly values: readonly ["global", "per-project", "per-project-tagged"];
+        readonly default: "per-project";
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Scoping";
+            readonly description: "global = one shared bank; per-project = isolated bank per cwd; per-project-tagged = project-local writes plus global recall visibility";
+            readonly options: readonly [{
+                readonly value: "global";
+                readonly label: "Global";
+                readonly description: "One shared Mnemosyne bank for every project";
+            }, {
+                readonly value: "per-project";
+                readonly label: "Per project";
+                readonly description: "Project-local Mnemosyne bank per cwd basename";
+            }, {
+                readonly value: "per-project-tagged";
+                readonly label: "Per project (tagged)";
+                readonly description: "Write to a project-local bank but merge project + shared recall results";
             }];
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.autoRecall": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Auto Recall";
+            readonly description: "Recall local memories into the first turn of each session";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.autoRetain": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Auto Retain";
+            readonly description: "Retain completed conversation turns into local Mnemosyne memory";
+            readonly condition: "mnemosyneActive";
         };
     };
+    readonly "mnemosyne.noEmbeddings": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Disable Embeddings";
+            readonly description: "Force deterministic FTS-only recall instead of vector embeddings";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.embeddingModel": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Embedding Model";
+            readonly description: "Optional embedding model override passed to Mnemosyne";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.embeddingApiUrl": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Embedding API URL";
+            readonly description: "Optional OpenAI-compatible embedding endpoint passed to Mnemosyne";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.embeddingApiKey": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne Embedding API Key";
+            readonly description: "Optional embedding API key passed to Mnemosyne";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.llmMode": {
+        readonly type: "enum";
+        readonly values: readonly ["none", "smol", "remote"];
+        readonly default: "smol";
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne LLM Mode";
+            readonly description: "Use no LLM, the configured smol model, or a remote OpenAI-compatible endpoint";
+            readonly condition: "mnemosyneActive";
+            readonly options: readonly [{
+                readonly value: "none";
+                readonly label: "None";
+                readonly description: "Disable Mnemosyne LLM-backed extraction";
+            }, {
+                readonly value: "smol";
+                readonly label: "Smol";
+                readonly description: "Use the configured pi-ai smol model";
+            }, {
+                readonly value: "remote";
+                readonly label: "Remote";
+                readonly description: "Use the Mnemosyne remote LLM settings below";
+            }];
+        };
+    };
+    readonly "mnemosyne.llmBaseUrl": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne LLM Base URL";
+            readonly description: "Optional OpenAI-compatible LLM endpoint for Mnemosyne remote mode";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.llmApiKey": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne LLM API Key";
+            readonly description: "Optional LLM API key for Mnemosyne remote mode";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.llmModel": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Mnemosyne LLM Model";
+            readonly description: "Optional LLM model name for Mnemosyne remote mode";
+            readonly condition: "mnemosyneActive";
+        };
+    };
+    readonly "mnemosyne.retainEveryNTurns": {
+        readonly type: "number";
+        readonly default: 4;
+    };
+    readonly "mnemosyne.recallLimit": {
+        readonly type: "number";
+        readonly default: 8;
+    };
+    readonly "mnemosyne.recallContextTurns": {
+        readonly type: "number";
+        readonly default: 3;
+    };
+    readonly "mnemosyne.recallMaxQueryChars": {
+        readonly type: "number";
+        readonly default: 4000;
+    };
+    readonly "mnemosyne.injectionTokenLimit": {
+        readonly type: "number";
+        readonly default: 5000;
+    };
+    readonly "mnemosyne.debug": {
+        readonly type: "boolean";
+        readonly default: false;
+    };
     readonly "hindsight.apiUrl": {
         readonly type: "string";
         readonly default: "http://localhost:8888";
@@ -1657,11 +1856,11 @@ export declare const SETTINGS_SCHEMA: {
             readonly options: readonly [{
                 readonly value: "global";
                 readonly label: "Global";
-                readonly description: "One shared bank \u2014 every project sees the same memories";
+                readonly description: "One shared bank — every project sees the same memories";
             }, {
                 readonly value: "per-project";
                 readonly label: "Per project";
-                readonly description: "Isolated bank per cwd basename \u2014 projects cannot see each other's memories";
+                readonly description: "Isolated bank per cwd basename — projects cannot see each other's memories";
             }, {
                 readonly value: "per-project-tagged";
                 readonly label: "Per project (tagged)";
@@ -1761,7 +1960,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "memory";
             readonly label: "Hindsight Mental Models";
-            readonly description: "Read curated reflect summaries (mental models) into developer instructions at boot. Loads existing models on the bank \u2014 does not write. Pair with hindsight.mentalModelAutoSeed to also auto-create the built-in seed set.";
+            readonly description: "Read curated reflect summaries (mental models) into developer instructions at boot. Loads existing models on the bank — does not write. Pair with hindsight.mentalModelAutoSeed to also auto-create the built-in seed set.";
             readonly condition: "hindsightActive";
         };
     };
@@ -1864,6 +2063,24 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "ttsr.builtinRules": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Builtin Rules";
+            readonly description: "Load the default rules shipped with the agent (override individually with ttsr.disabledRules)";
+        };
+    };
+    readonly "ttsr.disabledRules": {
+        readonly type: "array";
+        readonly default: string[];
+        readonly ui: {
+            readonly tab: "context";
+            readonly label: "Disabled Rules";
+            readonly description: "Rule names to ignore entirely (applies to bundled defaults and your own rules)";
+        };
+    };
     readonly "edit.mode": {
         readonly type: "enum";
         readonly values: import("..").EditMode[];
@@ -1942,7 +2159,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "editing";
             readonly label: "Hash Lines";
-            readonly description: "Include snapshot-tag headers and line numbers in read output for hashline edit mode (\u00B6PATH#tag plus LINE:content)";
+            readonly description: "Include snapshot-tag headers and line numbers in read output for hashline edit mode (¶PATH#tag plus LINE:content)";
         };
     };
     readonly "read.defaultLimit": {
@@ -2177,7 +2394,7 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "write";
                 readonly label: "Write";
-                readonly description: "Auto-approve read-only and write tools; require confirmation for exec tools such as bash, eval, browser, task, recipe, and ssh.";
+                readonly description: "Auto-approve read-only and write tools; require confirmation for exec tools such as bash, eval, browser, task, and ssh.";
             }, {
                 readonly value: "yolo";
                 readonly label: "Yolo";
@@ -2384,15 +2601,6 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the tts tool for xAI Grok Voice speech synthesis";
         };
     };
-    readonly "recipe.enabled": {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "Recipe";
-            readonly description: "Enable the recipe tool when a justfile / package.json / Cargo.toml / Makefile / Taskfile is present";
-        };
-    };
     readonly "inspect_image.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -3151,6 +3359,179 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "providers.tinyModel": {
+        readonly type: "enum";
+        readonly values: readonly ["online", "lfm2-350m", "qwen3-0.6b", "gemma-270m", "qwen2.5-0.5b", "lfm2-700m"];
+        readonly default: "online";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Tiny Model";
+            readonly description: "Session-title model: online pi/smol by default, or a local on-device model";
+            readonly options: ({
+                value: "online";
+                label: string;
+                description: string;
+            } | {
+                value: "gemma-270m" | "lfm2-350m" | "lfm2-700m" | "qwen2.5-0.5b" | "qwen3-0.6b";
+                label: "Gemma 270M" | "LFM2 350M" | "LFM2 700M" | "Qwen2.5 0.5B" | "Qwen3 0.6B";
+                description: "Balanced local fallback; moderate quality and cache footprint." | "Highest-quality local option; larger and slower than LFM2 350M." | "Most robust local option; slower first load, about 500 MB cached." | "Recommended local model; best speed/quality balance, about 212 MB cached." | "Smallest viable local option; lower quality, lowest cache footprint.";
+            })[];
+        };
+    };
+    readonly "providers.tinyModelDevice": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "gpu", "cpu", "metal", "webgpu", "cuda", "dml", "coreml", "auto", "wasm", "webnn", "webnn-gpu", "webnn-cpu", "webnn-npu"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Tiny Model Device";
+            readonly description: "ONNX execution provider for local tiny models (titles + memory). Default picks DirectML on Windows, CUDA on Linux x64, CPU elsewhere. The PI_TINY_DEVICE env var overrides this.";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "DirectML on Windows, CUDA on Linux x64, CPU elsewhere";
+            }, {
+                readonly value: "gpu";
+                readonly label: "GPU";
+                readonly description: "Accelerated provider (WebGPU/Metal, CUDA, or DirectML)";
+            }, {
+                readonly value: "cpu";
+                readonly label: "CPU";
+                readonly description: "CPU-only inference";
+            }, {
+                readonly value: "metal";
+                readonly label: "Metal";
+                readonly description: "WebGPU alias for Apple GPUs";
+            }, {
+                readonly value: "webgpu";
+                readonly label: "WebGPU";
+                readonly description: "WebGPU/Metal backend";
+            }, {
+                readonly value: "cuda";
+                readonly label: "CUDA";
+                readonly description: "NVIDIA CUDA (Linux x64)";
+            }, {
+                readonly value: "dml";
+                readonly label: "DirectML";
+                readonly description: "DirectML backend (Windows)";
+            }, {
+                readonly value: "coreml";
+                readonly label: "CoreML";
+                readonly description: "Apple CoreML (opt-in; can fail to load)";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Let ONNX Runtime choose a provider";
+            }, {
+                readonly value: "wasm";
+                readonly label: "WASM";
+                readonly description: "WebAssembly backend";
+            }, {
+                readonly value: "webnn";
+                readonly label: "WebNN";
+                readonly description: "WebNN backend";
+            }, {
+                readonly value: "webnn-gpu";
+                readonly label: "WebNN GPU";
+                readonly description: "WebNN GPU device";
+            }, {
+                readonly value: "webnn-cpu";
+                readonly label: "WebNN CPU";
+                readonly description: "WebNN CPU device";
+            }, {
+                readonly value: "webnn-npu";
+                readonly label: "WebNN NPU";
+                readonly description: "WebNN NPU device";
+            }];
+        };
+    };
+    readonly "providers.tinyModelDtype": {
+        readonly type: "enum";
+        readonly values: readonly ["default", "q4", "q4f16", "q8", "fp16", "fp32", "int8", "uint8", "bnb4", "q2", "q2f16", "q1", "q1f16", "auto"];
+        readonly default: "default";
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Tiny Model Precision";
+            readonly description: "ONNX quantization/precision for local tiny models. Default uses each model's shipped dtype (q4); lower precision is faster, higher is more faithful. The PI_TINY_DTYPE env var overrides this.";
+            readonly options: readonly [{
+                readonly value: "default";
+                readonly label: "Default";
+                readonly description: "Each model's shipped dtype (currently q4)";
+            }, {
+                readonly value: "q4";
+                readonly label: "q4";
+                readonly description: "4-bit weights; smallest and fastest";
+            }, {
+                readonly value: "q4f16";
+                readonly label: "q4f16";
+                readonly description: "4-bit weights with fp16 activations";
+            }, {
+                readonly value: "q8";
+                readonly label: "q8";
+                readonly description: "8-bit quantization";
+            }, {
+                readonly value: "fp16";
+                readonly label: "fp16";
+                readonly description: "16-bit float; higher fidelity, larger";
+            }, {
+                readonly value: "fp32";
+                readonly label: "fp32";
+                readonly description: "Full precision; largest and slowest";
+            }, {
+                readonly value: "int8";
+                readonly label: "int8";
+                readonly description: "Signed 8-bit integer";
+            }, {
+                readonly value: "uint8";
+                readonly label: "uint8";
+                readonly description: "Unsigned 8-bit integer";
+            }, {
+                readonly value: "bnb4";
+                readonly label: "bnb4";
+                readonly description: "bitsandbytes 4-bit";
+            }, {
+                readonly value: "q2";
+                readonly label: "q2";
+                readonly description: "2-bit weights";
+            }, {
+                readonly value: "q2f16";
+                readonly label: "q2f16";
+                readonly description: "2-bit weights with fp16 activations";
+            }, {
+                readonly value: "q1";
+                readonly label: "q1";
+                readonly description: "1-bit weights";
+            }, {
+                readonly value: "q1f16";
+                readonly label: "q1f16";
+                readonly description: "1-bit weights with fp16 activations";
+            }, {
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Let transformers.js choose per device";
+            }];
+        };
+    };
+    readonly "providers.memoryModel": {
+        readonly type: "enum";
+        readonly values: readonly ["online", "qwen3-1.7b", "gemma-3-1b", "qwen2.5-1.5b", "lfm2-1.2b"];
+        readonly default: "online";
+        readonly ui: {
+            readonly tab: "memory";
+            readonly label: "Memory Model";
+            readonly description: "Mnemosyne LLM for fact extraction + consolidation: online (smol/remote) by default, or a local on-device model";
+            readonly condition: "mnemosyneActive";
+            readonly options: ({
+                value: "online";
+                label: string;
+                description: string;
+            } | {
+                value: "gemma-3-1b" | "lfm2-1.2b" | "qwen2.5-1.5b" | "qwen3-1.7b";
+                label: "Gemma 3 1B" | "LFM2 1.2B" | "Qwen2.5 1.5B" | "Qwen3 1.7B";
+                description: "Best consolidation/dedup; lighter footprint, but leaks small talk during extraction." | "Best extraction granularity (atomic facts); weaker consolidation." | "Fastest load; solid all-rounder, slightly noisier extraction labels." | "Recommended; most disciplined extraction (ignores chit-chat), good consolidation, about 1.1 GB cached.";
+            })[];
+        };
+    };
     readonly "providers.kimiApiFormat": {
         readonly type: "enum";
         readonly values: readonly ["openai", "anthropic"];
@@ -3518,6 +3899,10 @@ export interface TtsrSettings {
     interruptMode: "never" | "prose-only" | "tool-only" | "always";
     repeatMode: "once" | "after-gap";
     repeatGap: number;
+    /** Bucketing-only (read by bucketRules, not the TtsrManager). */
+    builtinRules?: boolean;
+    /** Bucketing-only (read by bucketRules, not the TtsrManager). */
+    disabledRules?: string[];
 }
 export interface ExaSettings {
     enabled: boolean;

package/dist/types/discovery/builtin-defaults.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/discovery/builtin-rules/index.d.ts

@@ -0,0 +1,7 @@
+/** A bundled rule's stable name and raw markdown (frontmatter + body). */
+export interface BuiltinRuleSource {
+    name: string;
+    content: string;
+}
+/** All bundled default rules, ordered by name. */
+export declare const BUILTIN_RULE_SOURCES: readonly BuiltinRuleSource[];

package/dist/types/discovery/helpers.d.ts

@@ -10,7 +10,7 @@ export declare const SOURCE_PATHS: {
     readonly native: {
         readonly userBase: string;
         readonly userAgent: string;
-        projectDir: string;
+        readonly projectDir: string;
     };
     readonly claude: {
         readonly userBase: ".claude";

package/dist/types/discovery/index.d.ts

@@ -20,6 +20,7 @@ import "../capability/system-prompt";
 import "../capability/tool";
 import "./agents-md";
 import "./builtin";
+import "./builtin-defaults";
 import "./claude";
 import "./claude-plugins";
 import "./cline";

package/dist/types/discovery/substitute-plugin-root.d.ts

@@ -1,5 +1 @@
-/**
- * Recursively substitute ${CLAUDE_PLUGIN_ROOT} and ${OMP_PLUGIN_ROOT}
- * with the actual plugin root path in strings, arrays, and plain objects.
- */
 export declare function substitutePluginRoot<T>(value: T, rootPath: string): T;

package/dist/types/edit/hashline/block-resolver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tree-sitter-backed {@link BlockResolver} for the hashline `replace block N:`
+ * operator. Bridges the pure hashline seam to the native `blockRangeAt`
+ * primitive in `@oh-my-pi/pi-natives`, which infers the language from the file
+ * path and returns the 1-indexed line span of the syntactic block beginning on
+ * the requested line (or `null` when none can be resolved).
+ */
+import type { BlockResolver } from "@oh-my-pi/hashline";
+export declare const nativeBlockResolver: BlockResolver;

package/dist/types/edit/hashline/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./block-resolver";
 export * from "./diff";
 export * from "./execute";
 export * from "./filesystem";

package/dist/types/eval/js/shared/rewrite-imports.d.ts

@@ -2,9 +2,24 @@ export declare function rewriteImports(code: string): string;
 export declare function collectModuleSourceSpecifiers(code: string): string[];
 export declare function rewriteModuleSourceSpecifiers(code: string, replacer: (source: string) => string): string;
 export declare function rewriteDynamicImports(code: string, callee?: string): string;
-export declare function stripTypeScriptSyntax(code: string): string;
+/**
+ * Strip TypeScript syntax (type annotations, type-only imports/exports, `interface`, `as`,
+ * `satisfies`, generics in call expressions, etc.) before the import/lexical rewriters parse
+ * the code. Bun's native transpiler preserves `import`/`export` declarations, so downstream
+ * Babel rewrites still control module resolution.
+ *
+ * Eval cells use a cheap "looks like TS" heuristic to avoid transpiling ordinary JS. Known
+ * TypeScript modules pass `force` because a file can contain TS-only module syntax such as
+ * `import type` without any value-level type annotations.
+ */
+type TypeScriptStripLoader = "ts" | "tsx";
+export declare function stripTypeScriptSyntax(code: string, options?: {
+    force?: boolean;
+    loader?: TypeScriptStripLoader;
+}): string;
 export declare function wrapCode(code: string): {
     source: string;
     asyncWrapped: boolean;
     finalExpressionReturned: boolean;
 };
+export {};

package/dist/types/eval/py/kernel.d.ts

@@ -1,4 +1,5 @@
 import { type KernelDisplayOutput } from "./display";
+import { type PythonRuntime } from "./runtime";
 export type { KernelDisplayOutput, PythonStatusEvent } from "./display";
 export { renderKernelDisplay } from "./display";
 export type KernelRuntimeEnv = Record<string, string | null>;
@@ -53,6 +54,8 @@ export interface PythonKernelAvailability {
     ok: boolean;
     pythonPath?: string;
     reason?: string;
+    /** The probed-working runtime, when one was found. */
+    runtime?: PythonRuntime;
 }
 export declare function checkPythonKernelAvailability(cwd: string): Promise<PythonKernelAvailability>;
 export declare class PythonKernel {

package/dist/types/eval/py/runtime.d.ts

@@ -16,6 +16,16 @@ export declare function filterEnv(env: Record<string, string | undefined>): Reco
  */
 export declare function resolveVenvPath(cwd: string): string | undefined;
 /**
- * Resolve Python runtime including executable path, environment, and venv detection.
+ * Enumerate candidate Python runtimes in priority order: an active/project venv,
+ * the managed `~/.omp/python-env`, then the system interpreter on PATH. Every
+ * candidate that physically exists is returned so callers can probe each in turn
+ * rather than committing to the first — a managed env left behind by a removed
+ * `uv` install no longer shadows a working system Python.
+ */
+export declare function enumeratePythonRuntimes(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime[];
+/**
+ * Resolve the highest-priority Python runtime. Prefer {@link enumeratePythonRuntimes}
+ * when you can probe candidates; this returns only the first one and throws when
+ * no interpreter exists.
  */
 export declare function resolvePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime;