From e183efbc841cde5bf9c689e5e4e6b3b080979ae4 Mon Sep 17 00:00:00 2001
From: can1357 <me@can.ac>
Date: Fri, 12 Jun 2026 03:46:03 +0200
Subject: [PATCH] feat(packages/mnemopi): added runtime debug switch for
 verbose diagnostics

- Added `debug` to `MnemopiRuntimeOptions` and resolved runtime options.
- Added `mnemopiDebugEnabled()` to expose runtime-scope verbose diagnostic checks.
---
 packages/mnemopi/src/core/runtime-options.ts | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/packages/mnemopi/src/core/runtime-options.ts b/packages/mnemopi/src/core/runtime-options.ts
index 3e940c57f..56f002272 100644
--- a/packages/mnemopi/src/core/runtime-options.ts
+++ b/packages/mnemopi/src/core/runtime-options.ts
@@ -51,6 +51,8 @@ export interface MnemopiLlmRuntimeOptions {
 export interface MnemopiRuntimeOptions {
 	embeddings?: false | MnemopiEmbeddingRuntimeOptions;
 	llm?: false | MnemopiLlmRuntimeOptions | Model<Api> | MnemopiLlmCompletion;
+	/** Verbose diagnostics: escalates best-effort failure logs from debug to warn. */
+	debug?: boolean;
 }
 
 export interface ResolvedMnemopiEmbeddingRuntimeOptions {
@@ -75,6 +77,7 @@ export interface ResolvedMnemopiLlmRuntimeOptions {
 export interface ResolvedMnemopiRuntimeOptions {
 	embeddings?: ResolvedMnemopiEmbeddingRuntimeOptions;
 	llm?: ResolvedMnemopiLlmRuntimeOptions;
+	debug?: boolean;
 }
 
 const runtimeOptionsStorage = new AsyncLocalStorage<ResolvedMnemopiRuntimeOptions>();
@@ -90,6 +93,11 @@ export function getMnemopiRuntimeOptions(): ResolvedMnemopiRuntimeOptions | unde
 	return runtimeOptionsStorage.getStore();
 }
 
+/** Whether the active runtime scope requested verbose diagnostics (`mnemopi.debug`). */
+export function mnemopiDebugEnabled(): boolean {
+	return runtimeOptionsStorage.getStore()?.debug === true;
+}
+
 export function resolveEmbeddingProvider(
 	provider:
 		| MnemopiEmbeddingProvider