@xmoxmo/bncr 0.4.1 → 0.4.3

package/dist/index.js

@@ -1,73 +1,129 @@
 // index.ts
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
+import path3 from "node:path";
 
-// src/core/config-schema.ts
-var BncrConfigSchema = {
-  schema: {
-    type: "object",
-    additionalProperties: true,
-    properties: {
-      enabled: { type: "boolean" },
-      dmPolicy: {
-        type: "string",
-        enum: ["open", "allowlist", "disabled"]
-      },
-      groupPolicy: {
-        type: "string",
-        enum: ["open", "allowlist", "disabled"]
-      },
-      allowFrom: {
-        type: "array",
-        items: { type: "string" }
-      },
-      groupAllowFrom: {
-        type: "array",
-        items: { type: "string" }
-      },
-      debug: {
-        type: "object",
-        additionalProperties: true,
-        properties: {
-          verbose: {
-            type: "boolean",
-            default: false,
-            description: "Enable verbose debug logs for bncr channel runtime."
-          }
-        }
-      },
-      allowTool: {
-        type: "boolean",
-        default: false,
-        description: "Allow tool messages to be forwarded when streaming is enabled. Defaults to false; only explicit true enables forwarding. When enabled, bncr also requests upstream tool summaries/results."
-      },
-      requireMention: {
-        type: "boolean",
-        default: false,
-        description: "Whether group messages must explicitly mention the bot before bncr handles them. Default false. Current version keeps this as a reserved field and does not enforce it yet."
-      },
-      outboundRequireAck: {
-        type: "boolean",
-        default: true,
-        description: "Whether outbound text waits for bncr.ack before leaving the retry queue. Default true to preserve current ack/dead-letter behavior."
-      },
-      accounts: {
-        type: "object",
-        additionalProperties: {
-          type: "object",
-          additionalProperties: true,
-          properties: {
-            enabled: { type: "boolean" },
-            name: { type: "string" }
-          }
-        }
-      }
+// src/bootstrap/channel-plugin-runtime.ts
+function createDynamicChannelPlugin(args) {
+  const { loaded, getCurrentBridge: getCurrentBridge2 } = args;
+  const base = loaded.createBncrChannelPlugin(() => getCurrentBridge2());
+  const plugin2 = { ...base };
+  const outbound = base.outbound;
+  const baseStatus = base.status;
+  const baseGateway = base.gateway;
+  plugin2.outbound = {
+    ...outbound,
+    sendText: (async (ctx) => await getCurrentBridge2().channelSendText(ctx)),
+    sendMedia: (async (ctx) => await getCurrentBridge2().channelSendMedia(ctx))
+  };
+  plugin2.status = {
+    ...baseStatus,
+    buildChannelSummary: async ({ defaultAccountId }) => getCurrentBridge2().getChannelSummary(defaultAccountId || "Primary"),
+    buildAccountSnapshot: async ({ account, runtime: runtime2 }) => {
+      const bridgeNow = getCurrentBridge2();
+      return baseStatus.buildAccountSnapshot({
+        account,
+        runtime: runtime2 || bridgeNow.getAccountRuntimeSnapshot(account?.accountId || "Primary")
+      });
+    },
+    resolveAccountState: ({
+      enabled,
+      configured,
+      account,
+      cfg,
+      runtime: runtime2
+    }) => {
+      const bridgeNow = getCurrentBridge2();
+      return baseStatus.resolveAccountState({
+        enabled,
+        configured,
+        account,
+        cfg,
+        runtime: runtime2 || bridgeNow.getAccountRuntimeSnapshot(account?.accountId || "Primary")
+      });
     }
+  };
+  plugin2.gateway = {
+    ...baseGateway,
+    startAccount: (ctx) => getCurrentBridge2().channelStartAccount(
+      ctx
+    ),
+    stopAccount: (ctx) => getCurrentBridge2().channelStopAccount(
+      ctx
+    )
+  };
+  return plugin2;
+}
+
+// src/openclaw/config-runtime.ts
+function resolveConfigApi(api) {
+  const config = api?.runtime?.config;
+  if (!config || typeof config !== "object") {
+    throw new Error("OpenClaw runtime config API is unavailable");
   }
-};
+  return config;
+}
+function getOpenClawRuntimeConfig(api) {
+  const config = resolveConfigApi(api);
+  if (typeof config.current === "function") return config.current();
+  if (typeof config.get === "function") return config.get();
+  throw new Error("OpenClaw runtime config read API is unavailable");
+}
+async function mutateOpenClawRuntimeConfigFile(api, params) {
+  const config = resolveConfigApi(api);
+  if (typeof config.mutateConfigFile !== "function") {
+    throw new Error("OpenClaw runtime config mutate API is unavailable");
+  }
+  return config.mutateConfigFile(params);
+}
+
+// src/bootstrap/cli.ts
+var isPlainObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+function registerBncrCli(api) {
+  if (typeof api.registerCli !== "function") return;
+  api.registerCli(
+    ({ program }) => {
+      const bncr = program.command("bncr").description("Bncr channel utilities");
+      bncr.command("miniconfig").description(
+        "Seed minimal channels.bncr config (adds enabled=true and allowTool=false only when missing)"
+      ).action(async () => {
+        const cfg = getOpenClawRuntimeConfig(api) || {};
+        const channels = isPlainObject(cfg.channels) ? cfg.channels : {};
+        const existing = isPlainObject(channels.bncr) ? channels.bncr : {};
+        const added = [];
+        if (existing.enabled === void 0) {
+          added.push("enabled=true");
+        }
+        if (existing.allowTool === void 0) {
+          added.push("allowTool=false");
+        }
+        if (added.length === 0) {
+          console.log("Minimal bncr config already present. No changes made.");
+          return;
+        }
+        await mutateOpenClawRuntimeConfigFile(api, {
+          afterWrite: { mode: "auto" },
+          mutate(draft) {
+            if (!isPlainObject(draft.channels)) draft.channels = {};
+            const draftChannels = draft.channels;
+            const draftExisting = isPlainObject(draftChannels.bncr) ? draftChannels.bncr : {};
+            const draftBncrCfg = { ...draftExisting };
+            if (draftBncrCfg.enabled === void 0) {
+              draftBncrCfg.enabled = true;
+            }
+            if (draftBncrCfg.allowTool === void 0) {
+              draftBncrCfg.allowTool = false;
+            }
+            draftChannels.bncr = draftBncrCfg;
+          }
+        });
+        console.log("Seeded minimal bncr config at channels.bncr.");
+        console.log(`Added missing fields: ${added.join(", ")}`);
+        console.log("Gateway will apply the config using the host afterWrite policy.");
+      });
+    },
+    { commands: ["bncr"] }
+  );
+}
+var shouldSkipNonRuntimeRegister = (mode) => mode === "cli-metadata" || mode === "discovery";
 
 // src/core/logging.ts
 var BNCR_PREFIX = "[bncr]";
@@ -102,34 +158,244 @@ function emitBncrLogLine(level, line, options, isDebugEnabled) {
   emitConsole(resolveConsoleMethod(level), normalizeBncrLogLine(line));
 }
 
-// src/openclaw/config-runtime.ts
-function resolveConfigApi(api) {
-  const config = api?.runtime?.config;
-  if (!config) throw new Error("OpenClaw runtime config API is unavailable");
-  return config;
+// src/bootstrap/register-runtime-gateway.ts
+function createBncrGatewayMethodRegistry(runtime2) {
+  const dispatchGatewayMethod = (name, opts) => {
+    const gatewayRuntime = runtime2.getGatewayRuntime();
+    const bridge = gatewayRuntime.currentBridge;
+    if (!bridge) {
+      throw new Error(`bncr gateway runtime unavailable for ${name}`);
+    }
+    try {
+      return runtime2.gatewayMethodDispatchers[name](bridge, opts);
+    } catch (error) {
+      const state = runtime2.getBridgeRegisterStateCarrier(bridge);
+      const detail = error instanceof Error ? { name: error.name, message: error.message, stack: error.stack || null } : { name: "NonError", message: String(error), stack: null };
+      emitBncrLogLine(
+        "error",
+        `[bncr] gateway method error method=${name}|bridgeId=${state.getBridgeId?.() || "-"}|gatewayPid=${state.gatewayPid ?? "-"}|err=${detail.message}`
+      );
+      emitBncrLogLine(
+        "error",
+        `[bncr] gateway method error ${JSON.stringify({
+          method: name,
+          bridgeId: state.getBridgeId?.() || null,
+          gatewayPid: state.gatewayPid ?? null,
+          detail
+        })}`,
+        { debugOnly: true },
+        () => false
+      );
+      throw error;
+    }
+  };
+  const mirrorGatewayMethodForMockApi = (api, name) => {
+    if (!Array.isArray(api?.methods)) return;
+    if (api.methods.some((item) => item?.name === name)) return;
+    api.methods.push({ name, handler: (opts) => dispatchGatewayMethod(name, opts) });
+  };
+  const ensureGatewayMethodRegistered2 = (api, name, debugLog) => {
+    const meta = runtime2.getRegisterMeta(api);
+    const gatewayRuntime = runtime2.getGatewayRuntime();
+    const registryFingerprint = meta.registryFingerprint || runtime2.getRegistryFingerprint(api);
+    let registryMethods = gatewayRuntime.registeredMethodsByRegistry.get(registryFingerprint);
+    if (!registryMethods) {
+      registryMethods = /* @__PURE__ */ new Set();
+      gatewayRuntime.registeredMethodsByRegistry.set(registryFingerprint, registryMethods);
+    }
+    if (meta.methods?.has(name)) {
+      debugLog(`register method skip ${name} (already registered on this api)`);
+      return;
+    }
+    if (registryMethods.has(name)) {
+      mirrorGatewayMethodForMockApi(api, name);
+      meta.methods?.add(name);
+      debugLog(`register method reuse ${name} (already registered in registry)`);
+      return;
+    }
+    api.registerGatewayMethod(
+      name,
+      (opts) => dispatchGatewayMethod(name, opts)
+    );
+    mirrorGatewayMethodForMockApi(api, name);
+    registryMethods.add(name);
+    meta.methods?.add(name);
+    debugLog(`register method ok ${name}`);
+  };
+  return {
+    dispatchGatewayMethod,
+    ensureGatewayMethodRegistered: ensureGatewayMethodRegistered2
+  };
 }
-function getOpenClawRuntimeConfig(api) {
-  const config = resolveConfigApi(api);
-  if (typeof config.current === "function") return config.current();
-  if (typeof config.get === "function") return config.get();
-  throw new Error("OpenClaw runtime config read API is unavailable");
+
+// src/bootstrap/register-runtime-helpers.ts
+function getProcessOwnerApiInstanceId(args) {
+  return args.serviceOwnerApiInstanceId || args.channelOwnerApiInstanceId || void 0;
 }
-async function mutateOpenClawRuntimeConfigFile(api, params) {
-  const config = resolveConfigApi(api);
-  if (typeof config.mutateConfigFile !== "function") {
-    throw new Error("OpenClaw runtime config mutate API is unavailable");
+function sameBridgeOwner(left, right) {
+  if (!left || !right) return false;
+  return left.moduleEpoch === right.moduleEpoch && left.bridgeFactoryId === right.bridgeFactoryId && left.apiInstanceId === right.apiInstanceId && left.registryFingerprint === right.registryFingerprint;
+}
+function snapshotBridgeRegisterState(bridge) {
+  if (!bridge) return null;
+  return {
+    registerCount: Number(bridge.registerCount || 0),
+    apiGeneration: Number(bridge.apiGeneration || 0),
+    firstRegisterAt: typeof bridge.firstRegisterAt === "number" ? bridge.firstRegisterAt : bridge.firstRegisterAt ?? null,
+    lastRegisterAt: typeof bridge.lastRegisterAt === "number" ? bridge.lastRegisterAt : bridge.lastRegisterAt ?? null,
+    lastApiRebindAt: typeof bridge.lastApiRebindAt === "number" ? bridge.lastApiRebindAt : bridge.lastApiRebindAt ?? null,
+    pluginSource: typeof bridge.pluginSource === "string" ? bridge.pluginSource : null,
+    pluginVersion: typeof bridge.pluginVersion === "string" ? bridge.pluginVersion : null,
+    lastApiInstanceId: typeof bridge.lastApiInstanceId === "string" ? bridge.lastApiInstanceId : null,
+    lastRegistryFingerprint: typeof bridge.lastRegistryFingerprint === "string" ? bridge.lastRegistryFingerprint : null,
+    lastDriftSnapshot: bridge.lastDriftSnapshot ?? null,
+    registerTraceRecent: Array.isArray(bridge.registerTraceRecent) ? bridge.registerTraceRecent.map((trace) => ({ ...trace })) : []
+  };
+}
+function hydrateBridgeRegisterState(bridge, snapshot) {
+  if (!snapshot) return bridge;
+  bridge.registerCount = snapshot.registerCount;
+  bridge.apiGeneration = snapshot.apiGeneration;
+  bridge.firstRegisterAt = snapshot.firstRegisterAt;
+  bridge.lastRegisterAt = snapshot.lastRegisterAt;
+  bridge.lastApiRebindAt = snapshot.lastApiRebindAt;
+  bridge.pluginSource = snapshot.pluginSource;
+  bridge.pluginVersion = snapshot.pluginVersion;
+  bridge.lastApiInstanceId = snapshot.lastApiInstanceId;
+  bridge.lastRegistryFingerprint = snapshot.lastRegistryFingerprint;
+  bridge.lastDriftSnapshot = snapshot.lastDriftSnapshot;
+  bridge.registerTraceRecent = snapshot.registerTraceRecent.map((trace) => ({ ...trace }));
+  return bridge;
+}
+function shouldAdoptProcessOwner(args) {
+  const existingOwnerApiInstanceId = getProcessOwnerApiInstanceId({
+    serviceOwnerApiInstanceId: args.serviceOwnerApiInstanceId,
+    channelOwnerApiInstanceId: args.channelOwnerApiInstanceId
+  });
+  const hasSingletonOwner = Boolean(args.serviceRegistered) || Boolean(args.channelRegistered);
+  if (!hasSingletonOwner) {
+    return {
+      adoptOwner: true,
+      existingOwnerApiInstanceId,
+      reason: "no-singleton-owner"
+    };
   }
-  return config.mutateConfigFile(params);
+  if (existingOwnerApiInstanceId && existingOwnerApiInstanceId === args.apiInstanceId) {
+    return {
+      adoptOwner: true,
+      existingOwnerApiInstanceId,
+      reason: "same-owner-api"
+    };
+  }
+  return {
+    adoptOwner: false,
+    existingOwnerApiInstanceId,
+    reason: "singleton-owned-by-other-api"
+  };
 }
 
-// index.ts
-var pluginFile = fileURLToPath(import.meta.url);
-var pluginDir = path.dirname(pluginFile);
-var pluginRequire = createRequire(import.meta.url);
+// src/bootstrap/register-runtime-singleton.ts
+function isBridgeOwner(value) {
+  return Boolean(
+    value && typeof value === "object" && "moduleEpoch" in value && "bridgeFactoryId" in value && "apiInstanceId" in value && "registryFingerprint" in value
+  );
+}
+function getBridgeOwnedCarrier(bridge) {
+  return bridge;
+}
+function getBridgeRegisterStateCarrier(bridge) {
+  return bridge;
+}
+function createBncrBridgeSingletonManager(runtime2) {
+  const assignBridgeOwner = (bridge, owner) => {
+    getBridgeOwnedCarrier(bridge)[runtime2.bridgeOwnerSymbol] = owner;
+    return bridge;
+  };
+  const getBridgeSingleton2 = (api) => {
+    const loaded = runtime2.loadBncrRuntimeSync();
+    const g = globalThis;
+    const owner = runtime2.getBridgeOwner(api, loaded);
+    const previousOwnerRaw = g.__bncrBridge ? getBridgeOwnedCarrier(g.__bncrBridge)[runtime2.bridgeOwnerSymbol] : void 0;
+    const previousOwner = isBridgeOwner(previousOwnerRaw) ? previousOwnerRaw : void 0;
+    let created = false;
+    let rebuilt = false;
+    if (g.__bncrBridge) {
+      const mustRebuild = !sameBridgeOwner(previousOwner, owner) && (previousOwner?.moduleEpoch !== owner.moduleEpoch || previousOwner?.bridgeFactoryId !== owner.bridgeFactoryId || previousOwner?.registrationMode !== owner.registrationMode || previousOwner?.apiInstanceId !== owner.apiInstanceId || previousOwner?.registryFingerprint !== owner.registryFingerprint);
+      if (mustRebuild) {
+        const registerState = snapshotBridgeRegisterState(
+          getBridgeRegisterStateCarrier(g.__bncrBridge)
+        );
+        try {
+          g.__bncrBridge.stopService?.();
+        } catch {
+        }
+        const rebuiltBridge = assignBridgeOwner(
+          loaded.createBncrBridge(api, {
+            pluginRoot: runtime2.pluginRoot,
+            pluginFile: runtime2.pluginFile
+          }),
+          owner
+        );
+        hydrateBridgeRegisterState(getBridgeRegisterStateCarrier(rebuiltBridge), registerState);
+        g.__bncrBridge = rebuiltBridge;
+        created = true;
+        rebuilt = true;
+      } else {
+        g.__bncrBridge.bindApi?.(api);
+        assignBridgeOwner(g.__bncrBridge, owner);
+      }
+    } else {
+      g.__bncrBridge = assignBridgeOwner(
+        loaded.createBncrBridge(api, {
+          pluginRoot: runtime2.pluginRoot,
+          pluginFile: runtime2.pluginFile
+        }),
+        owner
+      );
+      created = true;
+    }
+    g.__bncrBridge?.bindRuntimePaths?.({
+      pluginRoot: runtime2.pluginRoot,
+      pluginFile: runtime2.pluginFile
+    });
+    return { bridge: g.__bncrBridge, runtime: loaded, created, rebuilt, owner, previousOwner };
+  };
+  const getExistingBridgeSingleton2 = () => {
+    const g = globalThis;
+    return g.__bncrBridge;
+  };
+  const getBridgeOwnerFromBridge2 = (bridge) => {
+    if (!bridge) return void 0;
+    const bridgeCarrier = getBridgeOwnedCarrier(bridge);
+    for (const symbol of Object.getOwnPropertySymbols(bridge)) {
+      const owner = bridgeCarrier[symbol];
+      if (isBridgeOwner(owner)) return owner;
+    }
+    return void 0;
+  };
+  return {
+    assignBridgeOwner,
+    getBridgeRegisterStateCarrier,
+    getBridgeSingleton: getBridgeSingleton2,
+    getExistingBridgeSingleton: getExistingBridgeSingleton2,
+    getBridgeOwnerFromBridge: getBridgeOwnerFromBridge2
+  };
+}
+
+// src/bootstrap/runtime-loader.ts
+import fs2 from "node:fs";
+import { createRequire } from "node:module";
+import path2 from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/bootstrap/runtime-discovery.ts
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
 var pluginPackageName = "@xmoxmo/bncr";
 var sdkCoreSpecifier = "openclaw/plugin-sdk/core";
 var linkType = process.platform === "win32" ? "junction" : "dir";
-var resolvePluginRoot = (filePath) => {
+function resolveBncrPluginRoot(filePath) {
   let current = fs.existsSync(filePath) && fs.statSync(filePath).isDirectory() ? filePath : path.dirname(filePath);
   while (true) {
     const pkgPath = path.join(current, "package.json");
@@ -145,17 +411,8 @@ var resolvePluginRoot = (filePath) => {
     if (parent === current) return path.dirname(filePath);
     current = parent;
   }
-};
-var pluginRoot = resolvePluginRoot(pluginFile);
-var BNCR_REGISTER_META = /* @__PURE__ */ Symbol.for("bncr.register.meta");
-var BNCR_GLOBAL_REGISTER_TRACE = /* @__PURE__ */ Symbol.for("bncr.global.register.trace");
-var BNCR_BRIDGE_OWNER = /* @__PURE__ */ Symbol.for("bncr.bridge.owner");
-var BNCR_GATEWAY_RUNTIME = /* @__PURE__ */ Symbol.for("bncr.gateway.runtime");
-var MODULE_EPOCH = `${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-var runtime = null;
-var identityIds = /* @__PURE__ */ new WeakMap();
-var identitySeq = 0;
-var tryExec = (command, args) => {
+}
+function tryExec(command, args) {
   try {
     return execFileSync(command, args, {
       encoding: "utf8",
@@ -164,8 +421,8 @@ var tryExec = (command, args) => {
   } catch {
     return "";
   }
-};
-var readOpenClawPackageName = (pkgPath) => {
+}
+function readOpenClawPackageName(pkgPath) {
   try {
     const raw = fs.readFileSync(pkgPath, "utf8");
     const parsed = JSON.parse(raw);
@@ -173,18 +430,20 @@ var readOpenClawPackageName = (pkgPath) => {
   } catch {
     return "";
   }
-};
-var readPluginVersion = (rootDir = pluginRoot) => {
-  try {
-    const raw = fs.readFileSync(path.join(rootDir, "package.json"), "utf8");
-    const parsed = JSON.parse(raw);
-    return typeof parsed?.version === "string" ? parsed.version : "unknown";
-  } catch {
-    return "unknown";
+}
+function unique(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of items) {
+    if (!item) continue;
+    const normalized = path.normalize(item);
+    if (seen.has(normalized)) continue;
+    seen.add(normalized);
+    out.push(normalized);
   }
-};
-var pluginVersion = readPluginVersion();
-var findOpenClawPackageRoot = (startPath) => {
+  return out;
+}
+function findOpenClawPackageRoot(startPath) {
   let current = startPath;
   try {
     current = fs.realpathSync(startPath);
@@ -202,22 +461,10 @@ var findOpenClawPackageRoot = (startPath) => {
     cursor = parent;
   }
   return "";
-};
-var unique = (items) => {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const item of items) {
-    if (!item) continue;
-    const normalized = path.normalize(item);
-    if (seen.has(normalized)) continue;
-    seen.add(normalized);
-    out.push(normalized);
-  }
-  return out;
-};
-var collectOpenClawCandidates = () => {
+}
+function collectOpenClawCandidates(pluginDir2) {
   const directCandidates = [
-    path.join(pluginDir, "node_modules", "openclaw"),
+    path.join(pluginDir2, "node_modules", "openclaw"),
     path.join("/usr/lib/node_modules", "openclaw"),
     path.join("/usr/local/lib/node_modules", "openclaw"),
     path.join("/opt/homebrew/lib/node_modules", "openclaw"),
@@ -241,17 +488,17 @@ var collectOpenClawCandidates = () => {
     const pkgJson = path.join(candidate, "package.json");
     return fs.existsSync(pkgJson) && readOpenClawPackageName(pkgJson) === "openclaw";
   });
-};
-var canResolveSdkCore = () => {
+}
+function canResolveSdkCore(pluginRequire2) {
   try {
-    pluginRequire.resolve(sdkCoreSpecifier);
+    pluginRequire2.resolve(sdkCoreSpecifier);
     return true;
   } catch {
     return false;
   }
-};
-var ensurePluginNodeModulesLink = (targetRoot) => {
-  const nodeModulesDir = path.join(pluginDir, "node_modules");
+}
+function ensurePluginNodeModulesLink(pluginDir2, targetRoot) {
+  const nodeModulesDir = path.join(pluginDir2, "node_modules");
   const linkPath = path.join(nodeModulesDir, "openclaw");
   fs.mkdirSync(nodeModulesDir, { recursive: true });
   try {
@@ -268,22 +515,25 @@ var ensurePluginNodeModulesLink = (targetRoot) => {
   } catch {
   }
   fs.symlinkSync(targetRoot, linkPath, linkType);
-};
-var runtimeSourceDir = (() => {
-  const direct = path.join(pluginDir, "src");
+}
+function resolveBncrRuntimeSourceDir(pluginDir2) {
+  const pluginRoot2 = resolveBncrPluginRoot(pluginDir2);
+  const rootSource = path.join(pluginRoot2, "src");
+  if (fs.existsSync(path.join(rootSource, "channel.ts"))) return rootSource;
+  const direct = path.join(pluginDir2, "src");
   if (fs.existsSync(path.join(direct, "channel.ts"))) return direct;
-  const parent = path.join(pluginDir, "..", "src");
+  const parent = path.join(pluginDir2, "..", "src");
   if (fs.existsSync(path.join(parent, "channel.ts"))) return parent;
   return direct;
-})();
-var ensureOpenClawSdkResolution = () => {
-  if (canResolveSdkCore()) return;
+}
+function ensureBncrOpenClawSdkResolution(pluginDir2, pluginRequire2) {
+  if (canResolveSdkCore(pluginRequire2)) return;
   let lastError = "";
-  const candidates = collectOpenClawCandidates();
+  const candidates = collectOpenClawCandidates(pluginDir2);
   for (const candidate of candidates) {
     try {
-      ensurePluginNodeModulesLink(candidate);
-      if (canResolveSdkCore()) return;
+      ensurePluginNodeModulesLink(pluginDir2, candidate);
+      if (canResolveSdkCore(pluginRequire2)) return;
     } catch (error) {
       lastError = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
     }
@@ -291,14 +541,47 @@ var ensureOpenClawSdkResolution = () => {
   const suffix = candidates.length ? ` Tried candidates: ${candidates.join(", ")}.` : " No openclaw package root candidates were found from npm root, NODE_PATH, common global paths, or the openclaw binary path.";
   const extra = lastError ? ` Last repair error: ${lastError}.` : "";
   throw new Error(
-    `bncr failed to resolve ${sdkCoreSpecifier} from ${pluginDir}.${suffix}${extra} You can repair manually with: mkdir -p ${path.join(pluginDir, "node_modules")} && ln -s "$(npm root -g)/openclaw" ${path.join(pluginDir, "node_modules", "openclaw")}`
+    `bncr failed to resolve ${sdkCoreSpecifier} from ${pluginDir2}.${suffix}${extra} You can repair manually with: mkdir -p ${path.join(pluginDir2, "node_modules")} && ln -s "$(npm root -g)/openclaw" ${path.join(pluginDir2, "node_modules", "openclaw")}`
   );
+}
+
+// src/bootstrap/runtime-loader.ts
+function resolvePluginEntryFileFromModule(moduleUrl) {
+  const currentFile = fileURLToPath(moduleUrl);
+  const pluginRoot2 = resolveBncrPluginRoot(currentFile);
+  const currentDir = path2.dirname(currentFile);
+  const distEntry = path2.join(pluginRoot2, "dist", "index.js");
+  if (currentFile === distEntry && fs2.existsSync(distEntry)) return distEntry;
+  const sourceEntry = path2.join(pluginRoot2, "index.ts");
+  if (fs2.existsSync(sourceEntry)) return sourceEntry;
+  if (fs2.existsSync(distEntry)) return distEntry;
+  if (path2.basename(currentDir) === "dist") return distEntry;
+  return sourceEntry;
+}
+function resolvePluginEntryFile() {
+  return resolvePluginEntryFileFromModule(import.meta.url);
+}
+var pluginFile = resolvePluginEntryFile();
+var pluginDir = path2.dirname(pluginFile);
+var pluginRequire = createRequire(pluginFile);
+var pluginRoot = resolveBncrPluginRoot(pluginFile);
+var runtimeSourceDir = resolveBncrRuntimeSourceDir(pluginDir);
+var runtime = null;
+var readPluginVersion = (rootDir = pluginRoot) => {
+  try {
+    const raw = fs2.readFileSync(path2.join(rootDir, "package.json"), "utf8");
+    const parsed = JSON.parse(raw);
+    return typeof parsed?.version === "string" ? parsed.version : "unknown";
+  } catch {
+    return "unknown";
+  }
 };
-var loadRuntimeSync = () => {
+var pluginVersion = readPluginVersion();
+var loadBncrRuntimeSync = () => {
   if (runtime) return runtime;
-  ensureOpenClawSdkResolution();
+  ensureBncrOpenClawSdkResolution(pluginDir, pluginRequire);
   try {
-    const mod = pluginRequire(path.join(runtimeSourceDir, "channel.ts"));
+    const mod = pluginRequire(path2.join(runtimeSourceDir, "channel.ts"));
     runtime = {
       createBncrBridge: mod.createBncrBridge,
       createBncrChannelPlugin: mod.createBncrChannelPlugin
@@ -311,10 +594,19 @@ var loadRuntimeSync = () => {
     );
   }
 };
+
+// src/bootstrap/register-runtime.ts
+var registerMetaSymbol = /* @__PURE__ */ Symbol.for("bncr.register.meta");
+var globalRegisterTraceSymbol = /* @__PURE__ */ Symbol.for("bncr.global.register.trace");
+var bridgeOwnerSymbol = /* @__PURE__ */ Symbol.for("bncr.bridge.owner");
+var gatewayRuntimeSymbol = /* @__PURE__ */ Symbol.for("bncr.gateway.runtime");
+var moduleEpoch = `${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+var identityIds = /* @__PURE__ */ new WeakMap();
+var identitySeq = 0;
 var getIdentityId = (obj, prefix) => {
   const existing = identityIds.get(obj);
   if (existing) return existing;
-  const next = `${prefix}_${MODULE_EPOCH}_${++identitySeq}`;
+  const next = `${prefix}_${moduleEpoch}_${++identitySeq}`;
   identityIds.set(obj, next);
   return next;
 };
@@ -324,324 +616,194 @@ var getRegistryFingerprint = (api) => {
   const methodId = getIdentityId(api.registerGatewayMethod, "mth");
   return `${serviceId}:${channelId}:${methodId}`;
 };
-var getRegisterMeta = (api) => {
-  const host = api;
-  if (!host[BNCR_REGISTER_META]) {
-    host[BNCR_REGISTER_META] = { methods: /* @__PURE__ */ new Set() };
-  }
-  if (!host[BNCR_REGISTER_META].methods) {
-    host[BNCR_REGISTER_META].methods = /* @__PURE__ */ new Set();
-  }
-  if (!host[BNCR_REGISTER_META].apiInstanceId) {
-    host[BNCR_REGISTER_META].apiInstanceId = getIdentityId(api, "api");
-  }
-  if (!host[BNCR_REGISTER_META].registryFingerprint) {
-    host[BNCR_REGISTER_META].registryFingerprint = getRegistryFingerprint(api);
-  }
-  return host[BNCR_REGISTER_META];
-};
 var getProcessStore = () => {
   const p = process;
   return p;
 };
-var getGlobalRegisterTrace = () => {
-  const p = getProcessStore();
-  if (!p[BNCR_GLOBAL_REGISTER_TRACE]) {
-    p[BNCR_GLOBAL_REGISTER_TRACE] = {
-      seenRegistryFingerprints: /* @__PURE__ */ new Set(),
-      seenApiInstanceIds: /* @__PURE__ */ new Set()
-    };
-  }
-  return p[BNCR_GLOBAL_REGISTER_TRACE];
-};
-var getGatewayRuntime = () => {
-  const p = getProcessStore();
-  if (!p[BNCR_GATEWAY_RUNTIME]) {
-    p[BNCR_GATEWAY_RUNTIME] = {
-      registeredMethodsByRegistry: /* @__PURE__ */ new Map(),
-      serviceRegistered: false,
-      channelRegistered: false
-    };
-  }
-  return p[BNCR_GATEWAY_RUNTIME];
-};
-var getProcessOwnerApiInstanceId = (gatewayRuntime) => gatewayRuntime.serviceOwnerApiInstanceId || gatewayRuntime.channelOwnerApiInstanceId || void 0;
-var shouldAdoptProcessOwner = (apiInstanceId, gatewayRuntime) => {
-  const existingOwnerApiInstanceId = getProcessOwnerApiInstanceId(gatewayRuntime);
-  const hasSingletonOwner = Boolean(gatewayRuntime.serviceRegistered) || Boolean(gatewayRuntime.channelRegistered);
-  if (!hasSingletonOwner) {
-    return {
-      adoptOwner: true,
-      existingOwnerApiInstanceId,
-      reason: "no-singleton-owner"
-    };
-  }
-  if (existingOwnerApiInstanceId && existingOwnerApiInstanceId === apiInstanceId) {
+function createBncrRegisterRuntime() {
+  const gatewayMethodDispatchers = {
+    "bncr.connect": (bridge, opts) => bridge.handleConnect(opts),
+    "bncr.inbound": (bridge, opts) => bridge.handleInbound(opts),
+    "bncr.activity": (bridge, opts) => bridge.handleActivity(opts),
+    "bncr.ack": (bridge, opts) => bridge.handleAck(opts),
+    "bncr.diagnostics": (bridge, opts) => bridge.handleDiagnostics(opts),
+    "bncr.deadLetter.inspect": (bridge, opts) => bridge.handleDeadLetterInspect(opts),
+    "bncr.deadLetter.prune": (bridge, opts) => bridge.handleDeadLetterPrune(opts),
+    "bncr.file.init": (bridge, opts) => bridge.handleFileInit(opts),
+    "bncr.file.chunk": (bridge, opts) => bridge.handleFileChunk(opts),
+    "bncr.file.complete": (bridge, opts) => bridge.handleFileComplete(opts),
+    "bncr.file.abort": (bridge, opts) => bridge.handleFileAbort(opts),
+    "bncr.file.ack": (bridge, opts) => bridge.handleFileAck(opts)
+  };
+  const getRegisterMeta2 = (api) => {
+    const host = api;
+    if (!host[registerMetaSymbol]) {
+      host[registerMetaSymbol] = { methods: /* @__PURE__ */ new Set() };
+    }
+    if (!host[registerMetaSymbol].methods) {
+      host[registerMetaSymbol].methods = /* @__PURE__ */ new Set();
+    }
+    if (!host[registerMetaSymbol].apiInstanceId) {
+      host[registerMetaSymbol].apiInstanceId = getIdentityId(api, "api");
+    }
+    if (!host[registerMetaSymbol].registryFingerprint) {
+      host[registerMetaSymbol].registryFingerprint = getRegistryFingerprint(api);
+    }
+    return host[registerMetaSymbol];
+  };
+  const getGlobalRegisterTrace2 = () => {
+    const p = getProcessStore();
+    if (!p[globalRegisterTraceSymbol]) {
+      p[globalRegisterTraceSymbol] = {
+        seenRegistryFingerprints: /* @__PURE__ */ new Set(),
+        seenApiInstanceIds: /* @__PURE__ */ new Set()
+      };
+    }
+    return p[globalRegisterTraceSymbol];
+  };
+  const getGatewayRuntime2 = () => {
+    const p = getProcessStore();
+    if (!p[gatewayRuntimeSymbol]) {
+      p[gatewayRuntimeSymbol] = {
+        registeredMethodsByRegistry: /* @__PURE__ */ new Map(),
+        serviceRegistered: false,
+        channelRegistered: false
+      };
+    }
+    return p[gatewayRuntimeSymbol];
+  };
+  const getBridgeRegisterStateCarrier2 = (bridge) => bridge;
+  const gatewayMethodRegistry = createBncrGatewayMethodRegistry({
+    getRegisterMeta: getRegisterMeta2,
+    getRegistryFingerprint,
+    getGatewayRuntime: getGatewayRuntime2,
+    gatewayMethodDispatchers,
+    getBridgeRegisterStateCarrier: getBridgeRegisterStateCarrier2
+  });
+  const getBridgeOwner = (api, loaded) => {
+    const meta = getRegisterMeta2(api);
     return {
-      adoptOwner: true,
-      existingOwnerApiInstanceId,
-      reason: "same-owner-api"
+      moduleEpoch,
+      bridgeFactoryId: getIdentityId(loaded.createBncrBridge, "bridgeFactory"),
+      apiInstanceId: meta.apiInstanceId || "unknown",
+      registryFingerprint: meta.registryFingerprint || "unknown",
+      registrationMode: meta.registrationMode
     };
-  }
-  return {
-    adoptOwner: false,
-    existingOwnerApiInstanceId,
-    reason: "singleton-owned-by-other-api"
   };
-};
-var gatewayMethodDispatchers = {
-  "bncr.connect": (bridge, opts) => bridge.handleConnect(opts),
-  "bncr.inbound": (bridge, opts) => bridge.handleInbound(opts),
-  "bncr.activity": (bridge, opts) => bridge.handleActivity(opts),
-  "bncr.ack": (bridge, opts) => bridge.handleAck(opts),
-  "bncr.diagnostics": (bridge, opts) => bridge.handleDiagnostics(opts),
-  "bncr.deadLetter.inspect": (bridge, opts) => bridge.handleDeadLetterInspect(opts),
-  "bncr.deadLetter.prune": (bridge, opts) => bridge.handleDeadLetterPrune(opts),
-  "bncr.file.init": (bridge, opts) => bridge.handleFileInit(opts),
-  "bncr.file.chunk": (bridge, opts) => bridge.handleFileChunk(opts),
-  "bncr.file.complete": (bridge, opts) => bridge.handleFileComplete(opts),
-  "bncr.file.abort": (bridge, opts) => bridge.handleFileAbort(opts),
-  "bncr.file.ack": (bridge, opts) => bridge.handleFileAck(opts)
-};
-var dispatchGatewayMethod = (name, opts) => {
-  const gatewayRuntime = getGatewayRuntime();
-  const bridge = gatewayRuntime.currentBridge;
-  if (!bridge) {
-    throw new Error(`bncr gateway runtime unavailable for ${name}`);
-  }
-  try {
-    return gatewayMethodDispatchers[name](bridge, opts);
-  } catch (error) {
-    const detail = error instanceof Error ? {
-      name: error.name,
-      message: error.message,
-      stack: error.stack || null
-    } : { name: "NonError", message: String(error), stack: null };
-    emitBncrLogLine(
-      "error",
-      `[bncr] gateway method error ${JSON.stringify({
-        method: name,
-        bridgeId: bridge.getBridgeId?.() || null,
-        gatewayPid: bridge.gatewayPid || null,
-        detail
-      })}`,
-      { debugOnly: true },
-      () => true
-    );
-    throw error;
-  }
-};
-var mirrorGatewayMethodForMockApi = (api, name) => {
-  const host = api;
-  if (!Array.isArray(host.methods)) return;
-  if (host.methods.some((item) => item?.name === name)) return;
-  host.methods.push({ name, handler: (opts) => dispatchGatewayMethod(name, opts) });
-};
-var ensureGatewayMethodRegistered = (api, name, debugLog) => {
-  const meta = getRegisterMeta(api);
-  const gatewayRuntime = getGatewayRuntime();
-  const registryFingerprint = meta.registryFingerprint || getRegistryFingerprint(api);
-  let registryMethods = gatewayRuntime.registeredMethodsByRegistry.get(registryFingerprint);
-  if (!registryMethods) {
-    registryMethods = /* @__PURE__ */ new Set();
-    gatewayRuntime.registeredMethodsByRegistry.set(registryFingerprint, registryMethods);
-  }
-  if (meta.methods?.has(name)) {
-    debugLog(`register method skip ${name} (already registered on this api)`);
-    return;
-  }
-  if (registryMethods.has(name)) {
-    mirrorGatewayMethodForMockApi(api, name);
-    meta.methods?.add(name);
-    debugLog(`register method reuse ${name} (already registered in registry)`);
-    return;
-  }
-  api.registerGatewayMethod(name, (opts) => dispatchGatewayMethod(name, opts));
-  mirrorGatewayMethodForMockApi(api, name);
-  registryMethods.add(name);
-  meta.methods?.add(name);
-  debugLog(`register method ok ${name}`);
-};
-var getBridgeOwner = (api, loaded) => {
-  const meta = getRegisterMeta(api);
-  return {
-    moduleEpoch: MODULE_EPOCH,
-    bridgeFactoryId: getIdentityId(loaded.createBncrBridge, "bridgeFactory"),
-    apiInstanceId: meta.apiInstanceId || "unknown",
-    registryFingerprint: meta.registryFingerprint || "unknown",
-    registrationMode: meta.registrationMode
+  const bridgeSingletonManager = createBncrBridgeSingletonManager({
+    bridgeOwnerSymbol,
+    pluginRoot,
+    pluginFile,
+    loadBncrRuntimeSync,
+    getBridgeOwner
+  });
+  const getCurrentBridge2 = () => {
+    const bridge = getGatewayRuntime2().currentBridge;
+    if (!bridge) throw new Error("bncr current bridge unavailable");
+    return bridge;
   };
-};
-var sameBridgeOwner = (left, right) => {
-  if (!left || !right) return false;
-  return left.moduleEpoch === right.moduleEpoch && left.bridgeFactoryId === right.bridgeFactoryId && left.apiInstanceId === right.apiInstanceId && left.registryFingerprint === right.registryFingerprint;
-};
-var snapshotBridgeRegisterState = (bridge) => {
-  if (!bridge) return null;
   return {
-    registerCount: Number(bridge.registerCount || 0),
-    apiGeneration: Number(bridge.apiGeneration || 0),
-    firstRegisterAt: typeof bridge.firstRegisterAt === "number" ? bridge.firstRegisterAt : bridge.firstRegisterAt ?? null,
-    lastRegisterAt: typeof bridge.lastRegisterAt === "number" ? bridge.lastRegisterAt : bridge.lastRegisterAt ?? null,
-    lastApiRebindAt: typeof bridge.lastApiRebindAt === "number" ? bridge.lastApiRebindAt : bridge.lastApiRebindAt ?? null,
-    pluginSource: typeof bridge.pluginSource === "string" ? bridge.pluginSource : null,
-    pluginVersion: typeof bridge.pluginVersion === "string" ? bridge.pluginVersion : null,
-    lastApiInstanceId: typeof bridge.lastApiInstanceId === "string" ? bridge.lastApiInstanceId : null,
-    lastRegistryFingerprint: typeof bridge.lastRegistryFingerprint === "string" ? bridge.lastRegistryFingerprint : null,
-    lastDriftSnapshot: bridge.lastDriftSnapshot ?? null,
-    registerTraceRecent: Array.isArray(bridge.registerTraceRecent) ? bridge.registerTraceRecent.map((trace) => ({ ...trace })) : []
+    getRegisterMeta: getRegisterMeta2,
+    getGlobalRegisterTrace: getGlobalRegisterTrace2,
+    getGatewayRuntime: getGatewayRuntime2,
+    shouldAdoptProcessOwner: (apiInstanceId, gatewayRuntime) => shouldAdoptProcessOwner({
+      apiInstanceId,
+      serviceRegistered: gatewayRuntime.serviceRegistered,
+      channelRegistered: gatewayRuntime.channelRegistered,
+      serviceOwnerApiInstanceId: gatewayRuntime.serviceOwnerApiInstanceId,
+      channelOwnerApiInstanceId: gatewayRuntime.channelOwnerApiInstanceId
+    }),
+    ensureGatewayMethodRegistered: gatewayMethodRegistry.ensureGatewayMethodRegistered,
+    getBridgeSingleton: bridgeSingletonManager.getBridgeSingleton,
+    getBridgeOwnerFromBridge: bridgeSingletonManager.getBridgeOwnerFromBridge,
+    getExistingBridgeSingleton: bridgeSingletonManager.getExistingBridgeSingleton,
+    getCurrentBridge: getCurrentBridge2
   };
-};
-var hydrateBridgeRegisterState = (bridge, snapshot) => {
-  if (!snapshot) return bridge;
-  bridge.registerCount = snapshot.registerCount;
-  bridge.apiGeneration = snapshot.apiGeneration;
-  bridge.firstRegisterAt = snapshot.firstRegisterAt;
-  bridge.lastRegisterAt = snapshot.lastRegisterAt;
-  bridge.lastApiRebindAt = snapshot.lastApiRebindAt;
-  bridge.pluginSource = snapshot.pluginSource;
-  bridge.pluginVersion = snapshot.pluginVersion;
-  bridge.lastApiInstanceId = snapshot.lastApiInstanceId;
-  bridge.lastRegistryFingerprint = snapshot.lastRegistryFingerprint;
-  bridge.lastDriftSnapshot = snapshot.lastDriftSnapshot;
-  bridge.registerTraceRecent = snapshot.registerTraceRecent.map((trace) => ({ ...trace }));
-  return bridge;
-};
-var assignBridgeOwner = (bridge, owner) => {
-  bridge[BNCR_BRIDGE_OWNER] = owner;
-  return bridge;
-};
-var getBridgeSingleton = (api) => {
-  const loaded = loadRuntimeSync();
-  const g = globalThis;
-  const owner = getBridgeOwner(api, loaded);
-  const previousOwner = g.__bncrBridge?.[BNCR_BRIDGE_OWNER];
-  let created = false;
-  let rebuilt = false;
-  if (g.__bncrBridge) {
-    const mustRebuild = !sameBridgeOwner(previousOwner, owner) && (previousOwner?.moduleEpoch !== owner.moduleEpoch || previousOwner?.bridgeFactoryId !== owner.bridgeFactoryId || previousOwner?.registrationMode !== owner.registrationMode || previousOwner?.apiInstanceId !== owner.apiInstanceId || previousOwner?.registryFingerprint !== owner.registryFingerprint);
-    if (mustRebuild) {
-      const registerState = snapshotBridgeRegisterState(g.__bncrBridge);
-      try {
-        g.__bncrBridge.stopService?.();
-      } catch {
-      }
-      g.__bncrBridge = hydrateBridgeRegisterState(
-        assignBridgeOwner(loaded.createBncrBridge(api, { pluginRoot, pluginFile }), owner),
-        registerState
-      );
-      created = true;
-      rebuilt = true;
-    } else {
-      g.__bncrBridge.bindApi?.(api);
-      assignBridgeOwner(g.__bncrBridge, owner);
-      created = false;
-      rebuilt = false;
-    }
-  } else {
-    g.__bncrBridge = assignBridgeOwner(
-      loaded.createBncrBridge(api, { pluginRoot, pluginFile }),
-      owner
-    );
-    created = true;
-  }
-  g.__bncrBridge.bindRuntimePaths?.({ pluginRoot, pluginFile });
-  return { bridge: g.__bncrBridge, runtime: loaded, created, rebuilt, owner, previousOwner };
-};
-var getExistingBridgeSingleton = () => {
-  const g = globalThis;
-  return g.__bncrBridge;
-};
-var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var getCurrentBridge = () => {
-  const bridge = getGatewayRuntime().currentBridge;
-  if (!bridge) throw new Error("bncr current bridge unavailable");
-  return bridge;
-};
-var createDynamicChannelPlugin = (loaded) => {
-  const base = loaded.createBncrChannelPlugin(() => getCurrentBridge());
-  return {
-    ...base,
-    outbound: {
-      ...base.outbound,
-      sendText: (ctx) => getCurrentBridge().channelSendText(ctx),
-      sendMedia: (ctx) => getCurrentBridge().channelSendMedia(ctx)
-    },
-    status: {
-      ...base.status,
-      buildChannelSummary: async ({ defaultAccountId }) => getCurrentBridge().getChannelSummary(defaultAccountId || "Primary"),
-      buildAccountSnapshot: async ({ account, runtime: runtime2 }) => {
-        const bridgeNow = getCurrentBridge();
-        return base.status.buildAccountSnapshot({
-          account,
-          runtime: runtime2 || bridgeNow.getAccountRuntimeSnapshot(account?.accountId)
-        });
+}
+
+// src/core/config-schema.ts
+var BncrConfigSchema = {
+  schema: {
+    type: "object",
+    additionalProperties: true,
+    properties: {
+      enabled: { type: "boolean" },
+      dmPolicy: {
+        type: "string",
+        enum: ["open", "allowlist", "disabled"]
       },
-      resolveAccountState: ({ enabled, configured, account, cfg, runtime: runtime2 }) => {
-        const bridgeNow = getCurrentBridge();
-        return base.status.resolveAccountState({
-          enabled,
-          configured,
-          account,
-          cfg,
-          runtime: runtime2 || bridgeNow.getAccountRuntimeSnapshot(account?.accountId)
-        });
-      }
-    },
-    gateway: {
-      ...base.gateway,
-      startAccount: (ctx) => getCurrentBridge().channelStartAccount(ctx),
-      stopAccount: (ctx) => getCurrentBridge().channelStopAccount(ctx)
-    }
-  };
-};
-var registerBncrCli = (api) => {
-  if (typeof api.registerCli !== "function") return;
-  api.registerCli(
-    ({ program }) => {
-      const bncr = program.command("bncr").description("Bncr channel utilities");
-      bncr.command("miniconfig").description(
-        "Seed minimal channels.bncr config (adds enabled=true and allowTool=false only when missing)"
-      ).action(async () => {
-        const cfg = getOpenClawRuntimeConfig(api);
-        const channels = isPlainObject(cfg.channels) ? cfg.channels : {};
-        const existing = isPlainObject(channels.bncr) ? channels.bncr : {};
-        const added = [];
-        if (existing.enabled === void 0) {
-          added.push("enabled=true");
-        }
-        if (existing.allowTool === void 0) {
-          added.push("allowTool=false");
-        }
-        if (added.length === 0) {
-          console.log("Minimal bncr config already present. No changes made.");
-          return;
+      groupPolicy: {
+        type: "string",
+        enum: ["open", "allowlist", "disabled"]
+      },
+      allowFrom: {
+        type: "array",
+        items: { type: "string" }
+      },
+      groupAllowFrom: {
+        type: "array",
+        items: { type: "string" }
+      },
+      debug: {
+        type: "object",
+        additionalProperties: true,
+        properties: {
+          verbose: {
+            type: "boolean",
+            default: false,
+            description: "Enable verbose debug logs for bncr channel runtime."
+          }
         }
-        await mutateOpenClawRuntimeConfigFile(api, {
-          afterWrite: { mode: "auto" },
-          mutate(draft) {
-            if (!isPlainObject(draft.channels)) draft.channels = {};
-            const draftChannels = draft.channels;
-            const draftExisting = isPlainObject(draftChannels.bncr) ? draftChannels.bncr : {};
-            const draftBncrCfg = { ...draftExisting };
-            if (draftBncrCfg.enabled === void 0) {
-              draftBncrCfg.enabled = true;
-            }
-            if (draftBncrCfg.allowTool === void 0) {
-              draftBncrCfg.allowTool = false;
-            }
-            draftChannels.bncr = draftBncrCfg;
+      },
+      allowTool: {
+        type: "boolean",
+        default: false,
+        description: "Allow tool messages to be forwarded when streaming is enabled. Defaults to false; only explicit true enables forwarding. When enabled, bncr also requests upstream tool summaries/results."
+      },
+      requireMention: {
+        type: "boolean",
+        default: false,
+        description: "Whether group messages must explicitly mention the bot before bncr handles them. Default false. Current version keeps this as a reserved field and does not enforce it yet."
+      },
+      outboundRequireAck: {
+        type: "boolean",
+        default: true,
+        description: "Whether outbound text waits for bncr.ack before leaving the retry queue. Default true to preserve current ack/dead-letter behavior."
+      },
+      accounts: {
+        type: "object",
+        additionalProperties: {
+          type: "object",
+          additionalProperties: true,
+          properties: {
+            enabled: { type: "boolean" },
+            name: { type: "string" }
           }
-        });
-        console.log("Seeded minimal bncr config at channels.bncr.");
-        console.log(`Added missing fields: ${added.join(", ")}`);
-        console.log("Gateway will apply the config using the host afterWrite policy.");
-      });
-    },
-    { commands: ["bncr"] }
-  );
+        }
+      }
+    }
+  }
 };
-var shouldSkipNonRuntimeRegister = (mode) => mode === "cli-metadata" || mode === "discovery";
+
+// index.ts
+var readPluginVersion2 = (rootDir = pluginRoot) => {
+  const packageJsonPath = path3.join(rootDir, "package.json");
+  void packageJsonPath;
+  return pluginVersion;
+};
+var pluginVersion2 = readPluginVersion2();
+var registerRuntime = createBncrRegisterRuntime();
+var {
+  ensureGatewayMethodRegistered,
+  getBridgeSingleton,
+  getBridgeOwnerFromBridge,
+  getCurrentBridge,
+  getExistingBridgeSingleton,
+  getGatewayRuntime,
+  getGlobalRegisterTrace,
+  getRegisterMeta,
+  shouldAdoptProcessOwner: shouldAdoptProcessOwner2
+} = registerRuntime;
 var plugin = {
   id: "bncr",
   name: "Bncr",
@@ -662,7 +824,7 @@ var plugin = {
     const firstSeenApi = !globalTrace.seenApiInstanceIds.has(apiInstanceId);
     const firstSeenRegistry = !globalTrace.seenRegistryFingerprints.has(registryFingerprint);
     const gatewayRuntime = getGatewayRuntime();
-    const ownerDecision = shouldAdoptProcessOwner(apiInstanceId, gatewayRuntime);
+    const ownerDecision = shouldAdoptProcessOwner2(apiInstanceId, gatewayRuntime);
     let bridge;
     let runtime2;
     let created = false;
@@ -679,9 +841,9 @@ var plugin = {
       previousOwner = adopted.previousOwner;
       gatewayRuntime.currentBridge = bridge;
     } else {
-      runtime2 = loadRuntimeSync();
+      runtime2 = loadBncrRuntimeSync();
       bridge = gatewayRuntime.currentBridge || getExistingBridgeSingleton();
-      previousOwner = getExistingBridgeSingleton()?.[BNCR_BRIDGE_OWNER];
+      previousOwner = getBridgeOwnerFromBridge(bridge);
       owner = previousOwner;
       if (bridge && !gatewayRuntime.currentBridge) {
         gatewayRuntime.currentBridge = bridge;
@@ -693,7 +855,7 @@ var plugin = {
     globalTrace.lastRegistryFingerprint = registryFingerprint;
     bridge?.noteRegister?.({
       source: "@xmoxmo/bncr",
-      pluginVersion,
+      pluginVersion: pluginVersion2,
       apiRebound: ownerDecision.adoptOwner ? !created && !rebuilt : false,
       apiInstanceId: meta.apiInstanceId,
       registryFingerprint: meta.registryFingerprint
@@ -756,7 +918,9 @@ var plugin = {
       );
     }
     if (!gatewayRuntime.channelRegistered) {
-      api.registerChannel({ plugin: createDynamicChannelPlugin(runtime2) });
+      api.registerChannel({
+        plugin: createDynamicChannelPlugin({ loaded: runtime2, getCurrentBridge })
+      });
       gatewayRuntime.channelRegistered = true;
       gatewayRuntime.channelOwnerApiInstanceId = apiInstanceId;
       meta.channel = true;