@linxin666/dsh-usage 0.4.3 → 0.4.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: 2397df7cc658e2f6f5f447312723de5bee7cb490
-README.zh.md: 34535e95511e0d66198e801d37ef5ba6b5d1a288
+README.md: ce35e9cda06a1c0d34c1c37170eece47ffa2a80c
+README.zh.md: 4199ceccb73a627ba4bef72c4857d4a80c144020

package/README.md

@@ -24,7 +24,7 @@ It covers the official DeepSeek routes only — relay traffic billed elsewhere (
 
 ## Install
 
-Requires DSH 0.1.7-rc.2 or later: the plugin is developed against the 0.1.7-rc.2 DSH cohort (its settings page is the Host-generated page of the plugin's own Config schema) and its `@deepseek-ai/*` runtime imports are provided by the host itself.
+Requires DSH 0.2.0-rc.1 or later: the plugin is developed against the 0.2.0-rc.1 DSH cohort (its settings page is the Host-generated page of the plugin's own Config schema) and its `@deepseek-ai/*` runtime imports are provided by the host itself.
 
 In your profile (e.g. `~/.dsh/profiles/web`):
 

package/README.zh.md

@@ -24,7 +24,7 @@ dsh Web GUI 的使用统计插件：多 provider 余额与编程套餐用量检
 
 ## 安装
 
-要求 DSH 0.1.7-rc.2 或更高：插件基于 0.1.7-rc.2 DSH cohort 开发（其设置页即宿主根据插件自身 Config schema 生成的页面），`@deepseek-ai/*` 运行时导入由宿主本体提供。
+要求 DSH 0.2.0-rc.1 或更高：插件基于 0.2.0-rc.1 DSH cohort 开发（其设置页即宿主根据插件自身 Config schema 生成的页面），`@deepseek-ai/*` 运行时导入由宿主本体提供。
 
 在 profile（如 `~/.dsh/profiles/web`）中：
 

package/lib/index.js

@@ -118,7 +118,7 @@ function mountOnce(packageName, fn) {
 	return mount;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+dsh-brand@0.1.7-rc.2_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-brand/lib/index.js
+//#region ../../node_modules/.pnpm/@deepseek-ai+dsh-brand@0.2.0-rc.1_@deepseek-ai+cordis@4.0.4/node_modules/@deepseek-ai/dsh-brand/lib/index.js
 /**
 * Duplicate-install-safe nominal primitive helpers.
 *
@@ -141,7 +141,7 @@ function brandString(value) {
 	return value;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@deepseek-ai+dsh-credentials@0.1.7-rc.2_@deepseek-ai+cordis@4.0.4_@deepseek-ai+dsh-inva_98fa173416f048996704a605a96a2b0e/node_modules/@deepseek-ai/dsh-credentials/lib/index.js
+//#region ../../node_modules/.pnpm/@deepseek-ai+dsh-credentials@0.2.0-rc.1_@deepseek-ai+cordis@4.0.4_@deepseek-ai+dsh-inva_1a647ad178a224e363f109a5f72e2237/node_modules/@deepseek-ai/dsh-credentials/lib/index.js
 /**
 * Service Definition for the credential-reference capability seam (`ctx.credentials`). Settings and composition files carry
 * *references* to secrets — environment-variable names — while providers own
@@ -1098,16 +1098,71 @@ async function writeJsonAtomic(path, value) {
 		throw error;
 	}
 }
+function unwrapVolatiles(value) {
+	if (value === null || value === void 0) return value;
+	if (typeof value === "object") {
+		if (typeof value.get === "function") return unwrapVolatiles(value.get());
+		if (Array.isArray(value)) return value.map(unwrapVolatiles);
+		const result = {};
+		for (const [k, v] of Object.entries(value)) result[k] = unwrapVolatiles(v);
+		return result;
+	}
+	return value;
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepMerge(base, patch) {
+	if (!isPlainObject(base) || !isPlainObject(patch)) return patch !== void 0 ? patch : base;
+	const result = { ...base };
+	for (const [key, value] of Object.entries(patch)) {
+		if (value === void 0) continue;
+		result[key] = isPlainObject(value) && isPlainObject(result[key]) ? deepMerge(result[key], value) : value;
+	}
+	return result;
+}
 /**
 * Read a foreign settings namespace's resolved value (the llm adapter
-* profiles, the agent default model). Unregistered namespaces read as
-* undefined; nothing here throws into the poll loop.
+* profiles, the agent default model). Resolves across pre-0.1.7 settings.get(),
+* 0.1.7 SettingsForms.describe(), live loader entries, and configEditor.
+* Unregistered namespaces read as undefined; nothing here throws into the poll loop.
 */
 function readNamespace(ctx, ns) {
 	try {
 		const settings = service(ctx, "settings");
-		if (settings === void 0) return void 0;
-		return settings.get(ns);
+		if (settings !== void 0) {
+			if (typeof settings.get === "function") {
+				const value = settings.get(ns);
+				if (value !== void 0) return unwrapVolatiles(value);
+			}
+			if (typeof settings.describe === "function") {
+				const descriptors = settings.describe({ redactSecrets: false });
+				if (Array.isArray(descriptors)) {
+					const match = descriptors.find((d) => d.ns === ns || ns === "llm-pi-ai" && (d.ns === "llm" || isPlainObject(d.value?.providers)) || ns === "llm-deepseek" && (d.ns === "llm-deepseek" || d.ns === "llm-deepseek-api-key"));
+					if (match !== void 0 && match.value !== void 0) return unwrapVolatiles(match.value);
+				}
+			}
+		}
+		const loader = ctx.root?.loader ?? ctx.loader;
+		if (loader !== void 0 && typeof loader.entries === "function") for (const entry of loader.entries()) {
+			const id = entry.options?.id;
+			const name = entry.options?.name;
+			if (id === ns || name === `@deepseek-ai/dsh-${ns}` || name?.endsWith(`/${ns}`) || ns === "llm-pi-ai" && (id === "llm" || name === "@deepseek-ai/dsh-llm-pi-ai") || ns === "llm-deepseek" && (id === "llm-deepseek-api-key" || name === "@deepseek-ai/dsh-llm-deepseek-api-key")) {
+				if (entry.fiber?.config !== void 0) return unwrapVolatiles(entry.fiber.config);
+			}
+		}
+		const editor = service(ctx, "configEditor");
+		if (editor !== void 0 && typeof editor.configuration === "function") {
+			const match = editor.configuration().find((r) => {
+				const id = r.entry.options.id;
+				const name = r.entry.options.name;
+				return id === ns || name === `@deepseek-ai/dsh-${ns}` || name?.endsWith(`/${ns}`) || ns === "llm-pi-ai" && (id === "llm" || name === "@deepseek-ai/dsh-llm-pi-ai") || ns === "llm-deepseek" && (id === "llm-deepseek-api-key" || name === "@deepseek-ai/dsh-llm-deepseek-api-key");
+			});
+			if (match !== void 0) {
+				if (match.entry.fiber?.config !== void 0) return unwrapVolatiles(match.entry.fiber.config);
+				return unwrapVolatiles(deepMerge(match.inherited, match.override));
+			}
+		}
 	} catch {
 		return;
 	}
@@ -1188,8 +1243,8 @@ var UsageService = class {
 				displayName: route.displayName || adapter?.displayName || route.id,
 				credential: snapshot?.credential ?? "none",
 				supported: adapter !== void 0 && (adapter.balance !== void 0 || adapter.plan !== void 0),
-				...adapter?.balance !== void 0 && balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL) ? { balanceSupported: true } : {},
-				...adapter?.balance !== void 0 && !balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL) ? { balanceSupported: false } : {},
+				...adapter?.balance !== void 0 && balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id)) ? { balanceSupported: true } : {},
+				...adapter?.balance !== void 0 && !balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id)) ? { balanceSupported: false } : {},
 				...adapter?.plan !== void 0 ? { planSupported: true } : {},
 				...snapshot?.balance !== void 0 ? { balance: snapshot.balance } : {},
 				...snapshot?.plan !== void 0 ? { plan: snapshot.plan } : {},
@@ -1518,7 +1573,7 @@ var UsageService = class {
 	async probeRoute(route, adapter) {
 		const credential = await this.resolveCredential(route.id);
 		const previous = this.snapshots.get(route.id);
-		const balanceApplies = balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL);
+		const balanceApplies = balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id));
 		if (credential.key === void 0) {
 			this.snapshots.set(route.id, {
 				provider: route.id,
@@ -1633,6 +1688,14 @@ var UsageService = class {
 	deepseekApiKeyEnv() {
 		return readNamespace(this.ctx, "llm-deepseek")?.apiKeyEnv ?? "DEEPSEEK_API_KEY";
 	}
+	/** The DeepSeek official adapter's configured baseURL. */
+	deepseekBaseUrl() {
+		return readNamespace(this.ctx, "llm-deepseek")?.baseURL;
+	}
+	/** The effective base URL for a provider route (pi-ai or deepseek). */
+	routeBaseUrl(provider) {
+		return this.piAiProfile(provider)?.baseURL ?? (isDeepSeekProviderRoute(provider) ? this.deepseekBaseUrl() : void 0);
+	}
 };
 //#endregion
 //#region src/host/loopback.ts

package/lib/types/host/usage-service.d.ts

@@ -153,4 +153,8 @@ export declare class UsageService {
     private piAiProfile;
     /** The DeepSeek official adapter's credential reference name. */
     private deepseekApiKeyEnv;
+    /** The DeepSeek official adapter's configured baseURL. */
+    private deepseekBaseUrl;
+    /** The effective base URL for a provider route (pi-ai or deepseek). */
+    private routeBaseUrl;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@linxin666/dsh-usage",
   "description": "Usage statistics plugin for the dsh web GUI: per-provider balance and coding-plan quota detection plus a live token usage ledger, with a compact price glance card above the sidebar's Settings row",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "icon": "icon.svg",
   "type": "module",
   "engines": {
@@ -33,7 +33,7 @@
   "license": "Apache-2.0",
   "dsh": {
     "engines": {
-      "dsh": ">=0.1.7-rc.2"
+      "dsh": ">=0.2.0-rc.1"
     },
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -53,22 +53,22 @@
     "@deepseek-ai/schemastery": "^3.18.4"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh": ">=0.2.0-rc.1",
     "react": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-credentials": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.2.0-rc.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^22.20.0",

package/src/host/usage-service.ts

@@ -103,19 +103,129 @@ async function writeJsonAtomic(path: string, value: unknown): Promise<void> {
   }
 }
 
+function unwrapVolatiles(value: unknown): unknown {
+  if (value === null || value === undefined) return value
+  if (typeof value === 'object') {
+    if (typeof (value as { get?: unknown }).get === 'function') {
+      return unwrapVolatiles((value as { get(): unknown }).get())
+    }
+    if (Array.isArray(value)) {
+      return value.map(unwrapVolatiles)
+    }
+    const result: Record<string, unknown> = {}
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = unwrapVolatiles(v)
+    }
+    return result
+  }
+  return value
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+function deepMerge(base: unknown, patch: unknown): unknown {
+  if (!isPlainObject(base) || !isPlainObject(patch)) return patch !== undefined ? patch : base
+  const result: Record<string, unknown> = { ...base }
+  for (const [key, value] of Object.entries(patch)) {
+    if (value === undefined) continue
+    result[key] = isPlainObject(value) && isPlainObject(result[key]) ? deepMerge(result[key], value) : value
+  }
+  return result
+}
+
 /**
  * Read a foreign settings namespace's resolved value (the llm adapter
- * profiles, the agent default model). Unregistered namespaces read as
- * undefined; nothing here throws into the poll loop.
+ * profiles, the agent default model). Resolves across pre-0.1.7 settings.get(),
+ * 0.1.7 SettingsForms.describe(), live loader entries, and configEditor.
+ * Unregistered namespaces read as undefined; nothing here throws into the poll loop.
  */
 function readNamespace(ctx: Context, ns: string): unknown {
   try {
-    const settings = service<{ get(ns: unknown): unknown }>(ctx, 'settings')
-    if (settings === undefined) return undefined
-    return settings.get(ns)
+    // 1. Try legacy settings.get(ns) or 0.1.7 settings.describe()
+    const settings = service<{
+      get?(ns: unknown): unknown
+      describe?(options?: unknown): Array<{ ns: string; value: unknown }>
+    }>(ctx, 'settings')
+    if (settings !== undefined) {
+      if (typeof settings.get === 'function') {
+        const value = settings.get(ns)
+        if (value !== undefined) return unwrapVolatiles(value)
+      }
+      if (typeof settings.describe === 'function') {
+        const descriptors = settings.describe({ redactSecrets: false })
+        if (Array.isArray(descriptors)) {
+          const match = descriptors.find((d) =>
+            d.ns === ns
+            || (ns === 'llm-pi-ai' && (d.ns === 'llm' || isPlainObject((d.value as { providers?: unknown })?.providers)))
+            || (ns === 'llm-deepseek' && (d.ns === 'llm-deepseek' || d.ns === 'llm-deepseek-api-key'))
+          )
+          if (match !== undefined && match.value !== undefined) {
+            return unwrapVolatiles(match.value)
+          }
+        }
+      }
+    }
+
+    // 2. Try ctx.root.loader or ctx.loader entries
+    const loader = (ctx as unknown as {
+      root?: { loader?: { entries(): Iterable<{ options: { id: string; name?: string }; fiber?: { config?: unknown } }> } }
+      loader?: { entries(): Iterable<{ options: { id: string; name?: string }; fiber?: { config?: unknown } }> }
+    }).root?.loader
+      ?? (ctx as unknown as {
+        loader?: { entries(): Iterable<{ options: { id: string; name?: string }; fiber?: { config?: unknown } }> }
+      }).loader
+    if (loader !== undefined && typeof loader.entries === 'function') {
+      for (const entry of loader.entries()) {
+        const id = entry.options?.id
+        const name = entry.options?.name
+        if (
+          id === ns
+          || name === `@deepseek-ai/dsh-${ns}`
+          || name?.endsWith(`/${ns}`)
+          || (ns === 'llm-pi-ai' && (id === 'llm' || name === '@deepseek-ai/dsh-llm-pi-ai'))
+          || (ns === 'llm-deepseek' && (id === 'llm-deepseek-api-key' || name === '@deepseek-ai/dsh-llm-deepseek-api-key'))
+        ) {
+          if (entry.fiber?.config !== undefined) {
+            return unwrapVolatiles(entry.fiber.config)
+          }
+        }
+      }
+    }
+
+    // 3. Try configEditor service
+    const editor = service<{
+      configuration?(): Array<{
+        entry: { options: { id: string; name?: string }; fiber?: { config?: unknown } }
+        inherited: Record<string, unknown>
+        override: Record<string, unknown>
+      }>
+    }>(ctx, 'configEditor')
+    if (editor !== undefined && typeof editor.configuration === 'function') {
+      const rows = editor.configuration()
+      const match = rows.find((r) => {
+        const id = r.entry.options.id
+        const name = r.entry.options.name
+        return (
+          id === ns
+          || name === `@deepseek-ai/dsh-${ns}`
+          || name?.endsWith(`/${ns}`)
+          || (ns === 'llm-pi-ai' && (id === 'llm' || name === '@deepseek-ai/dsh-llm-pi-ai'))
+          || (ns === 'llm-deepseek' && (id === 'llm-deepseek-api-key' || name === '@deepseek-ai/dsh-llm-deepseek-api-key'))
+        )
+      })
+      if (match !== undefined) {
+        if (match.entry.fiber?.config !== undefined) {
+          return unwrapVolatiles(match.entry.fiber.config)
+        }
+        return unwrapVolatiles(deepMerge(match.inherited, match.override))
+      }
+    }
   } catch {
     return undefined
   }
+  return undefined
 }
 
 export class UsageService {
@@ -206,10 +316,10 @@ export class UsageService {
         // THIS route's account: it is supported by the adapter but not
         // applicable here, and the UI renders it as unsupported rather than
         // showing the other account's number (issue #1688).
-        ...(adapter?.balance !== undefined && balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL)
+        ...(adapter?.balance !== undefined && balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id))
           ? { balanceSupported: true }
           : {}),
-        ...(adapter?.balance !== undefined && !balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL)
+        ...(adapter?.balance !== undefined && !balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id))
           ? { balanceSupported: false }
           : {}),
         ...(adapter?.plan !== undefined ? { planSupported: true } : {}),
@@ -587,7 +697,7 @@ export class UsageService {
     // account, and probing the official endpoint would print this account's
     // money under that route's name (issue #1688). Such a route reports the
     // balance as unsupported instead.
-    const balanceApplies = balanceAppliesToRoute(adapter, this.piAiProfile(route.id)?.baseURL)
+    const balanceApplies = balanceAppliesToRoute(adapter, this.routeBaseUrl(route.id))
     if (credential.key === undefined) {
       // Nothing to probe with (oauth grant, no credential): retained facts
       // would never refresh again, so the row resets to its credential
@@ -705,4 +815,15 @@ export class UsageService {
     return section?.apiKeyEnv ?? 'DEEPSEEK_API_KEY'
   }
 
+  /** The DeepSeek official adapter's configured baseURL. */
+  private deepseekBaseUrl(): string | undefined {
+    const section = readNamespace(this.ctx, 'llm-deepseek') as { baseURL?: string } | undefined
+    return section?.baseURL
+  }
+
+  /** The effective base URL for a provider route (pi-ai or deepseek). */
+  private routeBaseUrl(provider: string): string | undefined {
+    return this.piAiProfile(provider)?.baseURL ?? (isDeepSeekProviderRoute(provider) ? this.deepseekBaseUrl() : undefined)
+  }
+
 }

package/lib/types/host/run-guarded.d.ts

@@ -1,39 +0,0 @@
-/**
- * Async-boundary guard shared by the plugin family's Host halves: every
- * fire-and-forget promise chain and callback the host runtime does not own
- * (route handlers, timers, event listeners, spawned work) funnels through
- * these helpers. The dsh host installs a process-level fail-loud guard that
- * turns ANY unhandled promise rejection into a whole-process exit — one
- * plugin's stray rejection would otherwise take every plugin down. These
- * helpers exist so that failure mode is structurally impossible in family
- * code: the rejection becomes a logged error at the plugin boundary instead.
- *
- * Complements the aggregate's shell isolation (packages/dsh-web-all): the
- * shell contains import/activation failures at boot; runGuarded contains
- * run-time failures after activation.
- * @module dsh-web-shared/host/run-guarded
- */
-/**
- * Run one async operation, logging (never propagating) a rejection. Use for
- * promises whose lifecycle the caller does not await: spawned work, retry
- * loops, background flushes. Returns the original promise so callers can
- * still chain when they want to.
- * @param promise - the work to shield; any thenable.
- * @param label - log prefix naming the work site.
- * @param log - error sink; defaults to console.error.
- * @returns the input promise (rejection already consumed).
- */
-export declare function runGuarded<T>(promise: PromiseLike<T>, label: string, log?: (error: unknown) => void): PromiseLike<T>;
-/**
- * Wrap one callback so every invocation is individually guarded: a rejection
- * inside one call is logged and swallowed instead of escaping into whatever
- * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
- * Sync throws are caught identically; a returned promise is replaced by
- * `undefined` after guarding (callers that need the original rejection should
- * await inside their own try/catch instead).
- * @param label - log prefix naming the callback site.
- * @param handler - the work to guard.
- * @param log - error sink; defaults to console.error.
- * @returns a wrapped callback with the same parameter list.
- */
-export declare function guardedHandler<A extends unknown[]>(label: string, handler: (...args: A) => unknown, log?: (error: unknown) => void): (...args: A) => unknown;

package/src/host/run-guarded.ts

@@ -1,76 +0,0 @@
-// Generated by scripts/sync-shared.mjs from shared/host/run-guarded.ts. Do not edit this copy; edit the shared source and run "node scripts/sync-shared.mjs".
-/**
- * Async-boundary guard shared by the plugin family's Host halves: every
- * fire-and-forget promise chain and callback the host runtime does not own
- * (route handlers, timers, event listeners, spawned work) funnels through
- * these helpers. The dsh host installs a process-level fail-loud guard that
- * turns ANY unhandled promise rejection into a whole-process exit — one
- * plugin's stray rejection would otherwise take every plugin down. These
- * helpers exist so that failure mode is structurally impossible in family
- * code: the rejection becomes a logged error at the plugin boundary instead.
- *
- * Complements the aggregate's shell isolation (packages/dsh-web-all): the
- * shell contains import/activation failures at boot; runGuarded contains
- * run-time failures after activation.
- * @module dsh-web-shared/host/run-guarded
- */
-
-/** Format one failure line for logging. */
-function formatFailure(label: string, error: unknown): Error {
-  return new Error(`[${label}] unhandled async failure: ${error instanceof Error ? error.stack ?? error.message : String(error)}`)
-}
-
-/**
- * Run one async operation, logging (never propagating) a rejection. Use for
- * promises whose lifecycle the caller does not await: spawned work, retry
- * loops, background flushes. Returns the original promise so callers can
- * still chain when they want to.
- * @param promise - the work to shield; any thenable.
- * @param label - log prefix naming the work site.
- * @param log - error sink; defaults to console.error.
- * @returns the input promise (rejection already consumed).
- */
-export function runGuarded<T>(promise: PromiseLike<T>, label: string, log: (error: unknown) => void = console.error): PromiseLike<T> {
-  void Promise.resolve(promise).catch(error => {
-    log(formatFailure(label, error))
-  })
-  return promise
-}
-
-/**
- * Wrap one callback so every invocation is individually guarded: a rejection
- * inside one call is logged and swallowed instead of escaping into whatever
- * infrastructure invoked the callback (HTTP server, EventEmitter, interval).
- * Sync throws are caught identically; a returned promise is replaced by
- * `undefined` after guarding (callers that need the original rejection should
- * await inside their own try/catch instead).
- * @param label - log prefix naming the callback site.
- * @param handler - the work to guard.
- * @param log - error sink; defaults to console.error.
- * @returns a wrapped callback with the same parameter list.
- */
-export function guardedHandler<A extends unknown[]>(
-  label: string,
-  handler: (...args: A) => unknown,
-  log: (error: unknown) => void = console.error,
-): (...args: A) => unknown {
-  return (...args: A) => {
-    try {
-      const result = handler(...args)
-      if (isPromiseLike(result)) {
-        void Promise.resolve(result).catch(error => {
-          log(formatFailure(label, error))
-        })
-        return undefined
-      }
-      return result
-    } catch (error) {
-      log(formatFailure(label, error))
-      return undefined
-    }
-  }
-}
-
-function isPromiseLike(value: unknown): value is PromiseLike<unknown> {
-  return typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'
-}