@oh-my-pi/pi-mnemopi 16.0.5 → 16.0.6

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [16.0.6] - 2026-06-18
+
+### Fixed
+
+- Forced the on-demand fastembed runtime install to override fastembed's archived `onnxruntime-node@1.21.0` transitive pin with Mnemopi's `onnxruntime-node@1.26.0` pin, fixing local embedding startup on macOS ARM64. ([#2920](https://github.com/can1357/oh-my-pi/issues/2920))
+
+### Changed
+
+- Updated OpenRouter request headers to use standard shared headers from the pi-ai package
+
 ## [16.0.5] - 2026-06-17
 
 ### Fixed

package/dist/types/core/fastembed-runtime.d.ts

@@ -1,4 +1,14 @@
+import { type RuntimeInstallSpec } from "@oh-my-pi/pi-utils";
 import type * as Fastembed from "fastembed";
 type FastembedModule = typeof Fastembed;
+/** Runtime install inputs for the optional fastembed embedding stack. */
+export interface FastembedRuntimeInstallPlan {
+    /** Cache directory key; changes when runtime resolution policy changes. */
+    versionKey: string;
+    /** Dependency graph written to the runtime cache package manifest. */
+    install: RuntimeInstallSpec;
+}
+/** Build the deterministic fastembed runtime install plan used by local embeddings. */
+export declare function fastembedRuntimeInstallPlan(): FastembedRuntimeInstallPlan;
 export declare function loadFastembed(): Promise<FastembedModule>;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-mnemopi",
-	"version": "16.0.5",
+	"version": "16.0.6",
 	"description": "Local SQLite memory engine for Oh My Pi agents",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -39,9 +39,9 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-ai": "16.0.5",
-		"@oh-my-pi/pi-catalog": "16.0.5",
-		"@oh-my-pi/pi-utils": "16.0.5",
+		"@oh-my-pi/pi-ai": "16.0.6",
+		"@oh-my-pi/pi-catalog": "16.0.6",
+		"@oh-my-pi/pi-utils": "16.0.6",
 		"lru-cache": "11.5.1"
 	},
 	"peerDependencies": {

package/src/core/embeddings.ts

@@ -1,5 +1,5 @@
 import { mkdirSync } from "node:fs";
-import { type ApiKey, ProviderHttpError, withAuth } from "@oh-my-pi/pi-ai";
+import { type ApiKey, getOpenRouterHeaders, ProviderHttpError, withAuth } from "@oh-my-pi/pi-ai";
 import { hostMatchesUrl } from "@oh-my-pi/pi-catalog/hosts";
 import {
 	$env,
@@ -11,7 +11,6 @@ import {
 } from "@oh-my-pi/pi-utils";
 import type { EmbeddingModel } from "fastembed";
 import { LRUCache } from "lru-cache/raw";
-import packageJson from "../../package.json" with { type: "json" };
 import { loadFastembed } from "./fastembed-runtime";
 import {
 	type EmbeddingOutput,
@@ -268,10 +267,7 @@ async function embedApi(texts: readonly string[]): Promise<EmbeddingMatrix | nul
 		const response = await withAuth(apiKey, async key => {
 			const headers: Record<string, string> = {
 				"Content-Type": "application/json",
-				"User-Agent": `Oh-My-Pi/${packageJson.version}`,
-				"HTTP-Referer": "https://omp.sh/",
-				"X-OpenRouter-Title": "Oh-My-Pi",
-				"X-OpenRouter-Categories": "cli-agent",
+				...getOpenRouterHeaders(),
 			};
 			if (key !== "") {
 				headers.Authorization = `Bearer ${key}`;

package/src/core/fastembed-runtime.ts

@@ -5,6 +5,7 @@ import {
 	getFastembedRuntimeDir,
 	installRuntimeModuleResolver,
 	logger,
+	type RuntimeInstallSpec,
 	resolveRuntimeModule,
 } from "@oh-my-pi/pi-utils";
 import type * as Fastembed from "fastembed";
@@ -12,13 +13,21 @@ import packageManifest from "../../package.json" with { type: "json" };
 
 type FastembedModule = typeof Fastembed;
 
+/** Runtime install inputs for the optional fastembed embedding stack. */
+export interface FastembedRuntimeInstallPlan {
+	/** Cache directory key; changes when runtime resolution policy changes. */
+	versionKey: string;
+	/** Dependency graph written to the runtime cache package manifest. */
+	install: RuntimeInstallSpec;
+}
+
 /**
  * `fastembed` and `onnxruntime-node` are optional peers (~270MB of native
  * assets across platforms), never bundled and never installed eagerly. When
  * the direct import cannot resolve — bundled `dist/cli.js`, compiled binary,
- * or a consumer that skipped the optional peers — the pinned pair is
- * `bun install`ed into a per-version runtime cache on first use and loaded
- * from there (#2389).
+ * a consumer that skipped the optional peers, or a native loader failure from
+ * fastembed's nested ORT — the pinned pair is `bun install`ed into a
+ * per-version runtime cache on first use and loaded from there (#2389, #2920).
  *
  * The pins live in `peerDependencies` as exact versions (not `catalog:`) so
  * this module reads concrete specs even when the workspace manifest is
@@ -27,6 +36,16 @@ type FastembedModule = typeof Fastembed;
 const FASTEMBED_SPEC = packageManifest.peerDependencies.fastembed;
 const ORT_SPEC = packageManifest.peerDependencies["onnxruntime-node"];
 
+/** Build the deterministic fastembed runtime install plan used by local embeddings. */
+export function fastembedRuntimeInstallPlan(): FastembedRuntimeInstallPlan {
+	return {
+		versionKey: `fastembed-${FASTEMBED_SPEC}_ort-${ORT_SPEC}_forced-ort`.replace(/[^A-Za-z0-9._-]/g, "_"),
+		install: {
+			dependencies: { fastembed: FASTEMBED_SPEC, "onnxruntime-node": ORT_SPEC },
+			overrides: { "onnxruntime-common": ORT_SPEC, "onnxruntime-node": ORT_SPEC },
+		},
+	};
+}
 let fastembedLoad: Promise<FastembedModule> | null = null;
 
 export function loadFastembed(): Promise<FastembedModule> {
@@ -42,15 +61,15 @@ async function loadFastembedOnce(): Promise<FastembedModule> {
 	// native addons and may be absent at runtime — a static import would load
 	// the addon at module-init and crash every consumer without the peers.
 	try {
-		// Preload ORT 1.24 before fastembed's nested ORT 1.21 — only on Windows,
+		// Preload the pinned ORT before fastembed's nested ORT — only on Windows,
 		// where loading the older binding first triggers a DLL-reuse crash.
 		if (process.platform === "win32") {
 			await import("onnxruntime-node");
 		}
 		return await import("fastembed");
 	} catch (error) {
-		if (!isModuleResolutionError(error)) throw error;
-		logger.debug("mnemopi: fastembed not resolvable, using on-demand runtime install", {
+		if (!isRecoverableFastembedLoadError(error)) throw error;
+		logger.debug("mnemopi: fastembed not loadable, using on-demand runtime install", {
 			error: String(error),
 		});
 		return loadFromRuntimeInstall();
@@ -58,10 +77,10 @@ async function loadFastembedOnce(): Promise<FastembedModule> {
 }
 
 async function loadFromRuntimeInstall(): Promise<FastembedModule> {
-	const versionKey = `fastembed-${FASTEMBED_SPEC}_ort-${ORT_SPEC}`.replace(/[^A-Za-z0-9._-]/g, "_");
+	const plan = fastembedRuntimeInstallPlan();
 	const runtimeDir = await ensureRuntimeInstalled({
-		runtimeDir: path.join(getFastembedRuntimeDir(), versionKey),
-		install: { dependencies: { fastembed: FASTEMBED_SPEC, "onnxruntime-node": ORT_SPEC } },
+		runtimeDir: path.join(getFastembedRuntimeDir(), plan.versionKey),
+		install: plan.install,
 		probePackage: "fastembed",
 	});
 	const nodeModules = path.join(runtimeDir, "node_modules");
@@ -80,10 +99,10 @@ async function loadFromRuntimeInstall(): Promise<FastembedModule> {
 	return requireRuntime(entry) as FastembedModule;
 }
 
-function isModuleResolutionError(error: unknown): boolean {
+function isRecoverableFastembedLoadError(error: unknown): boolean {
 	if (typeof error !== "object" || error === null) return false;
 	const { name, code, message } = error as { name?: unknown; code?: unknown; message?: unknown };
 	if (name === "ResolveMessage") return true;
-	if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") return true;
+	if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || code === "ERR_DLOPEN_FAILED") return true;
 	return typeof message === "string" && /cannot find (module|package)/i.test(message);
 }