oma-coding-agent 1.1.4

package/src/tiny/title-protocol.ts

@@ -0,0 +1,56 @@
+import type { TinyLocalModelKey, TinyTitleLocalModelKey } from "./models";
+
+export type TinyTitleProgressStatus =
+	| "initiate"
+	| "download"
+	| "progress"
+	| "progress_total"
+	| "done"
+	| "ready"
+	| "error";
+
+export interface TinyTitleProgressFileState {
+	loaded: number;
+	total: number;
+}
+
+export interface TinyTitleProgressEvent {
+	modelKey: TinyLocalModelKey;
+	status: TinyTitleProgressStatus;
+	name?: string;
+	file?: string;
+	progress?: number;
+	loaded?: number;
+	total?: number;
+	files?: Record<string, TinyTitleProgressFileState>;
+	task?: string;
+	model?: string;
+}
+
+export type TinyTitleWorkerInbound =
+	| { type: "ping"; id: string }
+	| { type: "generate"; id: string; modelKey: TinyTitleLocalModelKey; message: string; systemPrompt?: string }
+	| { type: "complete"; id: string; modelKey: TinyLocalModelKey; prompt: string; maxTokens?: number }
+	| { type: "download"; id: string; modelKey: TinyLocalModelKey };
+
+export type TinyTitleWorkerOutbound =
+	| { type: "pong"; id: string }
+	| { type: "title"; id: string; title: string | null }
+	| { type: "completion"; id: string; text: string | null }
+	| { type: "downloaded"; id: string }
+	| { type: "error"; id: string; error: string }
+	| { type: "progress"; id: string; event: TinyTitleProgressEvent }
+	| { type: "log"; level: "debug" | "warn" | "error"; msg: string; meta?: Record<string, unknown> };
+
+/**
+ * Wire transport between the parent (`TinyTitleClient`) and the tiny-model
+ * subprocess. The parent owns the subprocess lifecycle (graceful work, hard
+ * kill on shutdown); the protocol therefore carries no explicit close
+ * handshake — once the parent decides to terminate, it signals the OS to
+ * reap the child so `onnxruntime-node`'s NAPI finalizer never runs in any
+ * shared address space. See `title-client.ts` for the spawn/kill glue.
+ */
+export interface TinyTitleTransport {
+	send(message: TinyTitleWorkerOutbound): void;
+	onMessage(handler: (message: TinyTitleWorkerInbound) => void): () => void;
+}

package/src/tiny/worker.ts

@@ -0,0 +1,491 @@
+import { createRequire } from "node:module";
+import * as path from "node:path";
+import type {
+	ProgressInfo,
+	TextGenerationPipeline,
+	TextGenerationStringOutput,
+	StoppingCriteria as TransformersStoppingCriteria,
+} from "@huggingface/transformers";
+import {
+	ensureRuntimeInstalled,
+	getTinyModelsCacheDir,
+	installRuntimeModuleResolver,
+	isCompiledBinary,
+	prompt,
+	resolveRuntimeModule,
+} from "@oh-my-pi/pi-utils";
+import packageJson from "../../package.json" with { type: "json" };
+import tinyTitleSystemPrompt from "../prompts/system/tiny-title-system.md" with { type: "text" };
+import { resolveTinyModelDevicePreference, type TinyModelDevice, tinyModelDeviceLoadOrder } from "./device";
+import { resolveTinyModelDtypeOverride, type TinyModelDtype } from "./dtype";
+import {
+	getTinyLocalModelSpec,
+	type TinyLocalModelKey,
+	type TinyTitleLocalModelKey,
+	type TinyTitleLocalModelSpec,
+} from "./models";
+import { formatTitleUserMessage, normalizeGeneratedTitle } from "./text";
+import type { TinyTitleProgressEvent, TinyTitleTransport, TinyTitleWorkerInbound } from "./title-protocol";
+
+const TITLE_PREFILL = "<title>";
+const TITLE_CLOSE = "</title>";
+const TITLE_MAX_NEW_TOKENS = 20;
+const STOP_DECODE_WINDOW_TOKENS = 32;
+const MEMORY_COMPLETION_DEFAULT_MAX_NEW_TOKENS = 256;
+const COMPLETION_MAX_NEW_TOKENS = 1024;
+const TINY_TITLE_SYSTEM_PROMPT = prompt.render(tinyTitleSystemPrompt);
+const TRANSFORMERS_PACKAGE = "@huggingface/transformers";
+const COMPILED_TRANSFORMERS_VERSION = process.env.PI_TINY_TRANSFORMERS_VERSION;
+const sourceRequire = createRequire(import.meta.url);
+
+const tinyModelDevicePreference = resolveTinyModelDevicePreference();
+const tinyModelDtypeOverride = resolveTinyModelDtypeOverride();
+
+interface TransformersRuntime {
+	env: {
+		cacheDir?: string;
+		allowLocalModels?: boolean;
+		logLevel?: unknown;
+	};
+	LogLevel: {
+		ERROR: unknown;
+	};
+	StoppingCriteria: new () => TransformersStoppingCriteria;
+	pipeline: (
+		task: "text-generation",
+		model: string,
+		options: {
+			device: TinyModelDevice;
+			dtype: TinyModelDtype;
+			progress_callback: (info: ProgressInfo) => void;
+		},
+	) => Promise<TextGenerationPipeline>;
+}
+
+const pipelines = new Map<TinyLocalModelKey, Promise<TextGenerationPipeline>>();
+
+function resolveTransformersVersionSpec(): string {
+	const manifest = packageJson as {
+		optionalDependencies?: Record<string, string>;
+		dependencies?: Record<string, string>;
+	};
+	const versionSpec =
+		manifest.optionalDependencies?.[TRANSFORMERS_PACKAGE] ?? manifest.dependencies?.[TRANSFORMERS_PACKAGE];
+	if (!versionSpec) throw new Error(`${TRANSFORMERS_PACKAGE} is missing from package.json optionalDependencies`);
+	if (!versionSpec.startsWith("catalog:")) return versionSpec;
+	if (COMPILED_TRANSFORMERS_VERSION) return COMPILED_TRANSFORMERS_VERSION;
+	const installed = sourceRequire(`${TRANSFORMERS_PACKAGE}/package.json`) as { version: string };
+	return installed.version;
+}
+let cachedTransformersVersionSpec: string | undefined;
+/**
+ * Lazily resolve (and memoize) the transformers version spec. In the
+ * `catalog:` case {@link resolveTransformersVersionSpec} `require`s the
+ * installed `@huggingface/transformers/package.json`, so touching it forces
+ * the dependency to exist. Defer it to the compiled-binary runtime-install
+ * path — which only runs when a local title model is actually generated or
+ * downloaded — so loading this worker (smoke-test ping, online title path)
+ * never triggers the transformers resolve/install dance.
+ */
+function getTransformersVersionSpec(): string {
+	cachedTransformersVersionSpec ??= resolveTransformersVersionSpec();
+	return cachedTransformersVersionSpec;
+}
+function getTransformersRuntimeKey(): string {
+	return getTransformersVersionSpec().replace(/[^A-Za-z0-9._-]/g, "_");
+}
+let generateQueue = Promise.resolve();
+let transformersRuntime: Promise<TransformersRuntime> | null = null;
+
+function errorText(error: unknown): string {
+	return error instanceof Error ? (error.stack ?? error.message) : String(error);
+}
+
+function sendLog(
+	transport: TinyTitleTransport,
+	level: "debug" | "warn" | "error",
+	msg: string,
+	meta?: Record<string, unknown>,
+): void {
+	transport.send({ type: "log", level, msg, meta });
+}
+
+function getTinyTitleRuntimeDir(): string {
+	return path.join(
+		path.dirname(getTinyModelsCacheDir()),
+		"tiny-title-runtime",
+		`transformers-${getTransformersRuntimeKey()}`,
+	);
+}
+
+function sendRuntimeInstallProgress(
+	transport: TinyTitleTransport,
+	requestId: string,
+	modelKey: TinyLocalModelKey,
+	status: "initiate" | "download" | "done",
+): void {
+	transport.send({
+		type: "progress",
+		id: requestId,
+		event: {
+			modelKey,
+			status,
+			name: `${TRANSFORMERS_PACKAGE}@${getTransformersVersionSpec()}`,
+		},
+	});
+}
+
+/**
+ * Prepare the freshly-installed compiled runtime for loading: stub `sharp`
+ * (the tiny models are text-generation only, so the native image pipeline is
+ * dead weight) and patch the module resolver so Transformers.js's bare requires
+ * (`onnxruntime-node`, `onnxruntime-common`) resolve against the cache. Returns
+ * the absolute Transformers.js entrypoint to `require`.
+ */
+async function prepareCompiledRuntime(runtimeDir: string): Promise<string> {
+	const nodeModules = path.join(runtimeDir, "node_modules");
+	const sharpStub = path.join(runtimeDir, "omp-sharp-stub.cjs");
+	await Bun.write(sharpStub, "module.exports = {};\n");
+	installRuntimeModuleResolver({ runtimeNodeModules: nodeModules, stubs: { sharp: sharpStub } });
+	const entry = resolveRuntimeModule(nodeModules, TRANSFORMERS_PACKAGE);
+	if (!entry) throw new Error(`Unable to resolve ${TRANSFORMERS_PACKAGE} in compiled runtime at ${nodeModules}`);
+	return entry;
+}
+
+function configureTransformers(transformers: TransformersRuntime): TransformersRuntime {
+	transformers.env.cacheDir = getTinyModelsCacheDir();
+	transformers.env.allowLocalModels = false;
+	transformers.env.logLevel = transformers.LogLevel.ERROR;
+	return transformers;
+}
+
+async function loadTransformers(
+	transport: TinyTitleTransport,
+	requestId: string,
+	modelKey: TinyLocalModelKey,
+): Promise<TransformersRuntime> {
+	if (transformersRuntime) return transformersRuntime;
+	transformersRuntime = (async () => {
+		if (!isCompiledBinary()) return configureTransformers(sourceRequire(TRANSFORMERS_PACKAGE) as TransformersRuntime);
+		const runtimeDir = await ensureRuntimeInstalled({
+			runtimeDir: getTinyTitleRuntimeDir(),
+			install: {
+				dependencies: { [TRANSFORMERS_PACKAGE]: getTransformersVersionSpec() },
+				trustedDependencies: ["onnxruntime-node"],
+			},
+			probePackage: TRANSFORMERS_PACKAGE,
+			onPhase: phase => sendRuntimeInstallProgress(transport, requestId, modelKey, phase),
+		});
+		const entry = await prepareCompiledRuntime(runtimeDir);
+		const require_ = createRequire(entry);
+		return configureTransformers(require_(entry) as TransformersRuntime);
+	})().catch(error => {
+		transformersRuntime = null;
+		throw error;
+	});
+	return transformersRuntime;
+}
+
+function createStopOnTextCriteria(
+	transformers: TransformersRuntime,
+	tokenizer: TextGenerationPipeline["tokenizer"],
+	text: string,
+): TransformersStoppingCriteria {
+	class StopOnTextCriteria extends transformers.StoppingCriteria {
+		#tokenizer: TextGenerationPipeline["tokenizer"];
+		#text: string;
+
+		constructor() {
+			super();
+			this.#tokenizer = tokenizer;
+			this.#text = text;
+		}
+
+		_call(inputIds: number[][]): boolean[] {
+			return inputIds.map(ids => {
+				const tail = ids.slice(-STOP_DECODE_WINDOW_TOKENS);
+				const decoded = this.#tokenizer.decode(tail, {
+					skip_special_tokens: false,
+					clean_up_tokenization_spaces: false,
+				});
+				return decoded.includes(this.#text);
+			});
+		}
+	}
+	return new StopOnTextCriteria();
+}
+
+function toProgressEvent(modelKey: TinyLocalModelKey, info: ProgressInfo): TinyTitleProgressEvent {
+	if (info.status === "ready") {
+		return { modelKey, status: info.status, task: info.task, model: info.model };
+	}
+	if (info.status === "progress_total") {
+		return {
+			modelKey,
+			status: info.status,
+			name: info.name,
+			progress: info.progress,
+			loaded: info.loaded,
+			total: info.total,
+			files: info.files,
+		};
+	}
+	if (info.status === "progress") {
+		return {
+			modelKey,
+			status: info.status,
+			name: info.name,
+			file: info.file,
+			progress: info.progress,
+			loaded: info.loaded,
+			total: info.total,
+		};
+	}
+	return { modelKey, status: info.status, name: info.name, file: info.file };
+}
+
+function sendProgress(
+	transport: TinyTitleTransport,
+	id: string,
+	modelKey: TinyLocalModelKey,
+	info: ProgressInfo,
+): void {
+	transport.send({ type: "progress", id, event: toProgressEvent(modelKey, info) });
+}
+
+function errorMessage(error: unknown): string {
+	return error instanceof Error ? error.message : String(error);
+}
+
+async function loadPipelineOnDevice(
+	transformers: TransformersRuntime,
+	spec: TinyTitleLocalModelSpec,
+	modelKey: TinyLocalModelKey,
+	transport: TinyTitleTransport,
+	requestId: string,
+	device: TinyModelDevice,
+): Promise<TextGenerationPipeline> {
+	return transformers.pipeline("text-generation", spec.repo, {
+		device,
+		dtype: tinyModelDtypeOverride ?? spec.dtype,
+		progress_callback: info => sendProgress(transport, requestId, modelKey, info),
+	});
+}
+
+async function loadPipelineWithDeviceFallback(
+	transformers: TransformersRuntime,
+	spec: TinyTitleLocalModelSpec,
+	modelKey: TinyLocalModelKey,
+	transport: TinyTitleTransport,
+	requestId: string,
+): Promise<{ generator: TextGenerationPipeline; device: TinyModelDevice }> {
+	const devices = tinyModelDeviceLoadOrder(tinyModelDevicePreference);
+	if (devices[0] !== tinyModelDevicePreference.device) {
+		sendLog(transport, "warn", "tiny-model: requested device is unsafe in the worker; using CPU", {
+			modelKey,
+			repo: spec.repo,
+			requestedDevice: tinyModelDevicePreference.device,
+			device: devices[0],
+		});
+	}
+	for (let i = 0; i < devices.length; i += 1) {
+		const device = devices[i]!;
+		try {
+			return {
+				generator: await loadPipelineOnDevice(transformers, spec, modelKey, transport, requestId, device),
+				device,
+			};
+		} catch (error) {
+			if (i === devices.length - 1) throw error;
+			const fallbackDevice = devices[i + 1]!;
+			sendLog(transport, "warn", "tiny-model: accelerated device failed; falling back", {
+				modelKey,
+				repo: spec.repo,
+				device,
+				fallbackDevice,
+				error: errorMessage(error),
+			});
+		}
+	}
+	throw new Error("No tiny model devices configured");
+}
+
+async function loadPipeline(
+	modelKey: TinyLocalModelKey,
+	transport: TinyTitleTransport,
+	requestId: string,
+): Promise<TextGenerationPipeline> {
+	const spec = getTinyLocalModelSpec(modelKey);
+	if (!spec) throw new Error(`Unknown tiny local model: ${modelKey}`);
+	const cached = pipelines.get(modelKey);
+	if (cached) {
+		void cached
+			.then(() => {
+				transport.send({
+					type: "progress",
+					id: requestId,
+					event: { modelKey, status: "ready", task: "text-generation", model: spec.repo },
+				});
+			})
+			.catch(() => undefined);
+		return cached;
+	}
+
+	const transformers = await loadTransformers(transport, requestId, modelKey);
+	const startedAt = performance.now();
+	const loaded = loadPipelineWithDeviceFallback(transformers, spec, modelKey, transport, requestId).then(
+		({ generator, device }) => {
+			sendLog(transport, "debug", "tiny-model: local model loaded", {
+				modelKey,
+				repo: spec.repo,
+				device,
+				requestedDevice: tinyModelDevicePreference.device,
+				dtype: tinyModelDtypeOverride ?? spec.dtype,
+				elapsedMs: Math.round(performance.now() - startedAt),
+			});
+			transport.send({
+				type: "progress",
+				id: requestId,
+				event: { modelKey, status: "ready", task: "text-generation", model: spec.repo },
+			});
+			return generator;
+		},
+		error => {
+			pipelines.delete(modelKey);
+			throw error;
+		},
+	);
+	pipelines.set(modelKey, loaded);
+	return loaded;
+}
+
+function buildPrompt(generator: TextGenerationPipeline, message: string, systemPrompt?: string): string {
+	const selectedSystemPrompt = systemPrompt?.trim() || TINY_TITLE_SYSTEM_PROMPT;
+	const chat = [
+		{ role: "system", content: selectedSystemPrompt },
+		{ role: "user", content: formatTitleUserMessage(message) },
+	];
+	const chatTemplateOptions = {
+		add_generation_prompt: true,
+		tokenize: false,
+		enable_thinking: false,
+	};
+	return `${generator.tokenizer.apply_chat_template(chat, chatTemplateOptions)}${TITLE_PREFILL}`;
+}
+
+function extractTinyTitle(text: string): string | null {
+	const titleStart = text.lastIndexOf(TITLE_PREFILL);
+	const withoutPrefix = titleStart >= 0 ? text.slice(titleStart + TITLE_PREFILL.length) : text;
+	const closeIndex = withoutPrefix.indexOf(TITLE_CLOSE);
+	const withoutClose = closeIndex >= 0 ? withoutPrefix.slice(0, closeIndex) : withoutPrefix;
+	const tagIndex = withoutClose.indexOf("<");
+	const withoutTag = tagIndex >= 0 ? withoutClose.slice(0, tagIndex) : withoutClose;
+	return normalizeGeneratedTitle(withoutTag);
+}
+
+async function generateTitle(
+	transport: TinyTitleTransport,
+	requestId: string,
+	modelKey: TinyTitleLocalModelKey,
+	message: string,
+	systemPrompt?: string,
+): Promise<string | null> {
+	const generator = await loadPipeline(modelKey, transport, requestId);
+	const promptText = buildPrompt(generator, message, systemPrompt);
+	const transformers = await loadTransformers(transport, requestId, modelKey);
+	const output = (await generator(promptText, {
+		max_new_tokens: TITLE_MAX_NEW_TOKENS,
+		do_sample: false,
+		return_full_text: false,
+		stopping_criteria: createStopOnTextCriteria(transformers, generator.tokenizer, TITLE_CLOSE),
+	})) as TextGenerationStringOutput;
+	return extractTinyTitle(output[0]?.generated_text ?? "");
+}
+
+function buildCompletionPrompt(generator: TextGenerationPipeline, promptText: string): string {
+	const chat = [{ role: "user", content: promptText }];
+	const chatTemplateOptions = {
+		add_generation_prompt: true,
+		tokenize: false,
+		enable_thinking: false,
+	};
+	return `${generator.tokenizer.apply_chat_template(chat, chatTemplateOptions)}`;
+}
+
+/**
+ * Generic single-turn completion used by Mnemopi memory tasks (fact extraction
+ * and consolidation). The caller (Mnemopi) supplies the full task prompt; we
+ * wrap it as the user turn, decode greedily, and return the raw text for the
+ * caller's own parser. Output is capped to keep local inference latency bounded.
+ */
+async function generateCompletion(
+	transport: TinyTitleTransport,
+	requestId: string,
+	modelKey: TinyLocalModelKey,
+	promptText: string,
+	maxTokens: number | undefined,
+): Promise<string | null> {
+	const generator = await loadPipeline(modelKey, transport, requestId);
+	const text = buildCompletionPrompt(generator, promptText);
+	const requested = maxTokens ?? MEMORY_COMPLETION_DEFAULT_MAX_NEW_TOKENS;
+	const maxNewTokens = Math.min(Math.max(1, requested), COMPLETION_MAX_NEW_TOKENS);
+	const output = (await generator(text, {
+		max_new_tokens: maxNewTokens,
+		do_sample: false,
+		return_full_text: false,
+	})) as TextGenerationStringOutput;
+	const generated = (output[0]?.generated_text ?? "").trim();
+	return generated === "" ? null : generated;
+}
+
+function enqueueRequest(
+	transport: TinyTitleTransport,
+	request: Extract<TinyTitleWorkerInbound, { type: "generate" | "complete" | "download" }>,
+): void {
+	generateQueue = generateQueue.then(
+		async () => {
+			await handleQueuedRequest(transport, request);
+		},
+		async () => {
+			await handleQueuedRequest(transport, request);
+		},
+	);
+}
+
+async function handleQueuedRequest(
+	transport: TinyTitleTransport,
+	request: Extract<TinyTitleWorkerInbound, { type: "generate" | "complete" | "download" }>,
+): Promise<void> {
+	try {
+		if (request.type === "download") {
+			await loadPipeline(request.modelKey, transport, request.id);
+			transport.send({ type: "downloaded", id: request.id });
+			return;
+		}
+		if (request.type === "complete") {
+			const text = await generateCompletion(
+				transport,
+				request.id,
+				request.modelKey,
+				request.prompt,
+				request.maxTokens,
+			);
+			transport.send({ type: "completion", id: request.id, text });
+			return;
+		}
+		const title = await generateTitle(transport, request.id, request.modelKey, request.message, request.systemPrompt);
+		transport.send({ type: "title", id: request.id, title });
+	} catch (error) {
+		transport.send({ type: "error", id: request.id, error: errorText(error) });
+	}
+}
+
+export function startTinyTitleWorker(transport: TinyTitleTransport): void {
+	transport.onMessage(message => {
+		if (message.type === "ping") {
+			transport.send({ type: "pong", id: message.id });
+			return;
+		}
+		enqueueRequest(transport, message);
+	});
+}

package/src/tool-discovery/mode.ts

@@ -0,0 +1,24 @@
+import type { Settings } from "../config/settings";
+import type { SettingValue } from "../config/settings-schema";
+
+export const TOOL_DISCOVERY_AUTO_THRESHOLD = 40;
+export const TOOL_DISCOVERY_SEARCH_TOOL_NAME = "search_tool_bm25";
+
+export type ToolDiscoveryModeSetting = SettingValue<"tools.discoveryMode">;
+export type EffectiveToolDiscoveryMode = Exclude<ToolDiscoveryModeSetting, "auto">;
+
+export function countToolsForAutoDiscovery(toolNames: Iterable<string>): number {
+	let count = 0;
+	for (const name of toolNames) {
+		if (name !== TOOL_DISCOVERY_SEARCH_TOOL_NAME) count++;
+	}
+	return count;
+}
+
+export function resolveEffectiveToolDiscoveryMode(settings: Settings, toolCount: number): EffectiveToolDiscoveryMode {
+	const configuredMode = settings.get("tools.discoveryMode");
+	if (configuredMode === "all" || configuredMode === "mcp-only") return configuredMode;
+	if (settings.get("mcp.discoveryMode")) return "mcp-only";
+	if (configuredMode === "auto" && toolCount > TOOL_DISCOVERY_AUTO_THRESHOLD) return "mcp-only";
+	return "off";
+}