@xmoxmo/bncr 0.3.6 → 0.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -27,10 +27,12 @@
   "scripts": {
     "build": "npx -y esbuild@0.28.0 index.ts --bundle --platform=node --format=esm --target=node22 --packages=external --outfile=dist/index.js",
     "selfcheck": "node ./scripts/selfcheck.mjs",
-    "test": "node --import ./tests/register-ts-hooks.mjs --test ./tests/*.test.mjs",
+    "test": "node --import ./tests/register-ts-hooks.mjs --test ./tests/**/*.test.mjs",
     "check-register-drift": "node ./scripts/check-register-drift.mjs",
     "check-pack": "node ./scripts/check-pack.mjs",
-    "format:check": "biome format --check .",
+    "typecheck": "node ./node_modules/typescript/lib/tsc.js -p tsconfig.typecheck.json",
+    "fullcheck": "npm run typecheck && npm run check && npm test && npm run selfcheck && npm run check-pack && npm run format:check",
+    "format:check": "biome check --formatter-enabled=true --linter-enabled=false --assist-enabled=false .",
     "format": "biome format --write .",
     "lint": "biome lint .",
     "check": "biome check ."
@@ -40,8 +42,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.16",
+    "@types/node": "^24.13.2",
     "esbuild": "^0.28.0",
-    "openclaw": ">=2026.5.27"
+    "openclaw": ">=2026.5.27",
+    "typescript": "^6.0.3"
   },
   "openclaw": {
     "extensions": [

package/scripts/check-pack.mjs

@@ -16,9 +16,15 @@ const requiredScriptFiles = [
 ];
 
 const requiredSourceFiles = [
+  'src/bootstrap/channel-plugin-runtime.ts',
+  'src/bootstrap/cli.ts',
+  'src/bootstrap/register-runtime-helpers.ts',
+  'src/bootstrap/register-runtime.ts',
+  'src/bootstrap/runtime-discovery.ts',
+  'src/bootstrap/runtime-loader.ts',
   'src/channel.ts',
-  'src/core/types.ts',
   'src/core/accounts.ts',
+  'src/core/config-schema.ts',
   'src/core/connection-capability.ts',
   'src/core/connection-reachability.ts',
   'src/core/dead-letter-diagnostics.ts',
@@ -44,40 +50,46 @@ const requiredSourceFiles = [
   'src/core/outbox-text-push-guards.ts',
   'src/core/outbox-text-push-prep.ts',
   'src/core/outbox-text-push-success.ts',
+  'src/core/permissions.ts',
   'src/core/persisted-outbox-entry.ts',
-  'src/core/targets.ts',
-  'src/core/status.ts',
-  'src/core/status-meta.ts',
-  'src/core/probe.ts',
-  'src/core/config-schema.ts',
   'src/core/policy.ts',
-  'src/core/permissions.ts',
+  'src/core/probe.ts',
   'src/core/register-trace.ts',
+  'src/core/status-meta.ts',
+  'src/core/status.ts',
+  'src/core/targets.ts',
+  'src/core/types.ts',
   'src/messaging/inbound/commands.ts',
   'src/messaging/inbound/context-facts.ts',
-  'src/messaging/inbound/parse.ts',
-  'src/messaging/inbound/gate.ts',
+  'src/messaging/inbound/dispatch-prep.ts',
   'src/messaging/inbound/dispatch.ts',
+  'src/messaging/inbound/gate.ts',
   'src/messaging/inbound/last-route.ts',
+  'src/messaging/inbound/media-url-download.ts',
   'src/messaging/inbound/native-command.ts',
   'src/messaging/inbound/native-reply-delivery.ts',
+  'src/messaging/inbound/parse.ts',
+  'src/messaging/inbound/remote-media.ts',
   'src/messaging/inbound/reply-config.ts',
+  'src/messaging/inbound/reply-dispatch.ts',
   'src/messaging/inbound/runtime-compat.ts',
   'src/messaging/inbound/session-label.ts',
-  'src/messaging/outbound/send.ts',
-  'src/messaging/outbound/media.ts',
+  'src/messaging/inbound/turn-context.ts',
   'src/messaging/outbound/actions.ts',
   'src/messaging/outbound/build-send-action.ts',
   'src/messaging/outbound/diagnostics.ts',
+  'src/messaging/outbound/diagnostics-debug-builders.ts',
   'src/messaging/outbound/durable-message-adapter.ts',
   'src/messaging/outbound/durable-queue-adapter.ts',
   'src/messaging/outbound/media-dedupe.ts',
+  'src/messaging/outbound/media.ts',
   'src/messaging/outbound/queue-selectors.ts',
   'src/messaging/outbound/reasons.ts',
   'src/messaging/outbound/reply-enqueue.ts',
   'src/messaging/outbound/reply-target-policy.ts',
   'src/messaging/outbound/retry-policy.ts',
   'src/messaging/outbound/send-params.ts',
+  'src/messaging/outbound/send.ts',
   'src/messaging/outbound/session-route.ts',
   'src/messaging/outbound/target-resolver.ts',
   'src/openclaw/config-runtime.ts',
@@ -89,16 +101,73 @@ const requiredSourceFiles = [
   'src/openclaw/runtime-surface.ts',
   'src/openclaw/sdk-helpers.ts',
   'src/openclaw/session-route-runtime.ts',
+  'src/plugin/ack-outbox-runtime-group.ts',
+  'src/plugin/bridge-surface-handlers-group.ts',
+  'src/plugin/bridge-surface-helpers.ts',
   'src/plugin/capabilities.ts',
+  'src/plugin/channel-components.ts',
+  'src/plugin/channel-inbound-helpers.ts',
+  'src/plugin/channel-plugin-bridge-group.ts',
+  'src/plugin/channel-plugin-surface-group.ts',
+  'src/plugin/channel-runtime-constants.ts',
+  'src/plugin/channel-runtime-builders.ts',
+  'src/plugin/channel-send-runtime-group.ts',
+  'src/plugin/channel-runtime-types.ts',
+  'src/plugin/channel-send.ts',
+  'src/plugin/channel-utils.ts',
   'src/plugin/config.ts',
+  'src/plugin/connection-handlers.ts',
+  'src/plugin/connection-state.ts',
+  'src/plugin/connection-state-runtime-group.ts',
+  'src/plugin/diagnostics-handlers.ts',
+  'src/plugin/file-ack-runtime.ts',
+  'src/plugin/file-inbound-abort.ts',
+  'src/plugin/file-inbound-chunk.ts',
+  'src/plugin/file-inbound-complete.ts',
+  'src/plugin/file-inbound-handlers.ts',
+  'src/plugin/file-inbound-init.ts',
+  'src/plugin/file-inbound-runtime.ts',
+  'src/plugin/file-inbound-state.ts',
+  'src/plugin/file-transfer-logs.ts',
+  'src/plugin/media-dedupe-runtime.ts',
+  'src/plugin/file-transfer-orchestrator.ts',
+  'src/plugin/media-orchestrators-runtime-group.ts',
+  'src/plugin/file-transfer-runtime-group.ts',
+  'src/plugin/file-transfer-send.ts',
+  'src/plugin/file-transfer-setup.ts',
+  'src/plugin/gateway-event-context.ts',
   'src/plugin/gateway-methods.ts',
   'src/plugin/gateway-runtime.ts',
+  'src/plugin/inbound-acceptance.ts',
+  'src/plugin/inbound-surface-handlers-group.ts',
+  'src/plugin/inbound-handlers.ts',
+  'src/plugin/message-ack-runtime.ts',
   'src/plugin/message-policy.ts',
   'src/plugin/message-send.ts',
   'src/plugin/messaging.ts',
   'src/plugin/meta.ts',
   'src/plugin/outbound.ts',
+  'src/plugin/outbox-ack-logs.ts',
+  'src/plugin/outbox-ack-outcome.ts',
+  'src/plugin/outbox-drain-ack.ts',
+  'src/plugin/outbox-drain-failure.ts',
+  'src/plugin/outbox-drain-loop.ts',
+  'src/plugin/outbox-drain-post-push.ts',
+  'src/plugin/outbox-drain-runtime.ts',
+  'src/plugin/outbox-drain-schedule.ts',
+  'src/plugin/outbox-file-push-flow.ts',
+  'src/plugin/outbox-push-route-runtime-group.ts',
+  'src/plugin/outbox-push.ts',
+  'src/plugin/outbox-route.ts',
+  'src/plugin/outbox-text-push-flow.ts',
+  'src/plugin/runtime-diagnostics-snapshot.ts',
   'src/plugin/setup.ts',
+  'src/plugin/state-transient-runtime-group.ts',
+  'src/plugin/state-store.ts',
+  'src/plugin/target-runtime.ts',
+  'src/plugin/target-status-runtime-group.ts',
+  'src/plugin/transient-state-runtime.ts',
+  'src/plugin/status-runtime.ts',
   'src/plugin/status.ts',
   'src/runtime/log-dedupe.ts',
   'src/runtime/outbound-ack-timeout.ts',
@@ -128,29 +197,35 @@ const [pack] = JSON.parse(output);
 const packedFiles = new Set((pack?.files ?? []).map((file) => file.path));
 const missing = requiredPackFiles.filter((file) => !packedFiles.has(file));
 const channelSource = fs.readFileSync(path.join(root, 'src/channel.ts'), 'utf8');
+const channelPluginSurfaceSource = fs.readFileSync(
+  path.join(root, 'src/plugin/channel-plugin-surface-group.ts'),
+  'utf8',
+);
 const messagePolicySource = fs.readFileSync(
   path.join(root, 'src/plugin/message-policy.ts'),
   'utf8',
 );
 const messageSendSource = fs.readFileSync(path.join(root, 'src/plugin/message-send.ts'), 'utf8');
+const channelPluginSurfaceCombined = `${channelSource}\n${channelPluginSurfaceSource}`;
 const channelMessageChecks = {
-  registered: channelSource.includes('message: {'),
+  registered: channelPluginSurfaceCombined.includes('message: {'),
   text:
-    channelSource.includes('createBncrMessageSend') &&
+    channelPluginSurfaceCombined.includes('createBncrMessageSend') &&
     messageSendSource.includes('channelMessageSendText'),
   media:
-    channelSource.includes('createBncrMessageSend') &&
+    channelPluginSurfaceCombined.includes('createBncrMessageSend') &&
     messageSendSource.includes('channelMessageSendMedia'),
   payload:
-    channelSource.includes('createBncrMessageSend') &&
+    channelPluginSurfaceCombined.includes('createBncrMessageSend') &&
     messageSendSource.includes('channelMessageSendPayload'),
   manualAck:
-    channelSource.includes('BNCR_MESSAGE_RECEIVE_POLICY') &&
+    channelPluginSurfaceCombined.includes('BNCR_MESSAGE_RECEIVE_POLICY') &&
     messagePolicySource.includes("defaultAckPolicy: 'manual'") &&
     messagePolicySource.includes("supportedAckPolicies: ['manual']"),
-  genericActionsPreserved: channelSource.includes('actions: messageActions'),
+  genericActionsPreserved: channelPluginSurfaceCombined.includes('actions: messageActions'),
   noDurableFinal:
-    !channelSource.includes('durableFinal:') && !messagePolicySource.includes('durableFinal:'),
+    !channelPluginSurfaceCombined.includes('durableFinal:') &&
+    !messagePolicySource.includes('durableFinal:'),
 };
 const channelMessageOk = Object.values(channelMessageChecks).every(Boolean);
 

package/scripts/check-register-drift.mjs

@@ -16,6 +16,7 @@ const DEFAULT_OPTIONS = {
   intervalSec: 15,
   accountId: 'Primary',
   gatewayBin: 'openclaw',
+  gatewayTimeoutMs: 30_000,
 };
 
 export function parseCheckRegisterDriftOptions(args, defaults = DEFAULT_OPTIONS) {
@@ -28,6 +29,8 @@ export function parseCheckRegisterDriftOptions(args, defaults = DEFAULT_OPTIONS)
       options.intervalSec = readNumber(args[++i], options.intervalSec);
     else if (arg === '--account-id') options.accountId = readText(args[++i], options.accountId);
     else if (arg === '--gateway-bin') options.gatewayBin = readText(args[++i], options.gatewayBin);
+    else if (arg === '--gateway-timeout-ms')
+      options.gatewayTimeoutMs = readNumber(args[++i], options.gatewayTimeoutMs);
     else if (arg === '--help' || arg === '-h') options.help = true;
   }
 
@@ -36,25 +39,44 @@ export function parseCheckRegisterDriftOptions(args, defaults = DEFAULT_OPTIONS)
 
 const printHelp = () => {
   console.log(
-    'Usage: node ./scripts/check-register-drift.mjs [--duration-sec 300] [--interval-sec 15] [--account-id Primary] [--gateway-bin openclaw]\n\nSamples bncr.diagnostics over time and reports whether register counters drift after warmup.',
+    'Usage: node ./scripts/check-register-drift.mjs [--duration-sec 300] [--interval-sec 15] [--account-id Primary] [--gateway-bin openclaw] [--gateway-timeout-ms 30000]\n\nSamples bncr.diagnostics over time and reports whether register counters drift after warmup.',
   );
 };
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
+const summarizeExecOutput = (value) =>
+  String(value || '')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, 500);
+
 const fetchDiagnostics = (options) => {
-  const raw = execFileSync(
-    options.gatewayBin,
-    [
-      'gateway',
-      'call',
-      'bncr.diagnostics',
-      '--json',
-      '--params',
-      JSON.stringify({ accountId: options.accountId }),
-    ],
-    { encoding: 'utf8' },
-  );
+  let raw;
+  try {
+    raw = execFileSync(
+      options.gatewayBin,
+      [
+        'gateway',
+        'call',
+        'bncr.diagnostics',
+        '--json',
+        '--timeout',
+        String(options.gatewayTimeoutMs),
+        '--params',
+        JSON.stringify({ accountId: options.accountId }),
+      ],
+      { encoding: 'utf8' },
+    );
+  } catch (error) {
+    const detail = [
+      `gatewayTimeoutMs=${options.gatewayTimeoutMs}`,
+      `status=${error?.status ?? 'unknown'}`,
+      `stderr=${summarizeExecOutput(error?.stderr) || '-'}`,
+      `stdout=${summarizeExecOutput(error?.stdout) || '-'}`,
+    ].join(' ');
+    throw new Error(`bncr.diagnostics gateway call failed (${detail})`, { cause: error });
+  }
   const parsed = JSON.parse(raw);
   const reg = parsed?.diagnostics?.register || {};
   const summary = reg?.traceSummary || {};

package/scripts/selfcheck.mjs

@@ -12,8 +12,14 @@ const requiredRootFiles = ['index.ts', 'openclaw.plugin.json'];
 
 const requiredSourceFiles = [
   'src/channel.ts',
-  'src/core/types.ts',
+  'src/bootstrap/channel-plugin-runtime.ts',
+  'src/bootstrap/cli.ts',
+  'src/bootstrap/register-runtime-helpers.ts',
+  'src/bootstrap/register-runtime.ts',
+  'src/bootstrap/runtime-discovery.ts',
+  'src/bootstrap/runtime-loader.ts',
   'src/core/accounts.ts',
+  'src/core/config-schema.ts',
   'src/core/connection-capability.ts',
   'src/core/connection-reachability.ts',
   'src/core/dead-letter-diagnostics.ts',
@@ -39,40 +45,46 @@ const requiredSourceFiles = [
   'src/core/outbox-text-push-guards.ts',
   'src/core/outbox-text-push-prep.ts',
   'src/core/outbox-text-push-success.ts',
+  'src/core/permissions.ts',
   'src/core/persisted-outbox-entry.ts',
-  'src/core/targets.ts',
-  'src/core/status.ts',
-  'src/core/status-meta.ts',
-  'src/core/probe.ts',
-  'src/core/config-schema.ts',
   'src/core/policy.ts',
-  'src/core/permissions.ts',
+  'src/core/probe.ts',
   'src/core/register-trace.ts',
+  'src/core/status-meta.ts',
+  'src/core/status.ts',
+  'src/core/targets.ts',
+  'src/core/types.ts',
   'src/messaging/inbound/commands.ts',
   'src/messaging/inbound/context-facts.ts',
-  'src/messaging/inbound/parse.ts',
-  'src/messaging/inbound/gate.ts',
+  'src/messaging/inbound/dispatch-prep.ts',
   'src/messaging/inbound/dispatch.ts',
+  'src/messaging/inbound/gate.ts',
   'src/messaging/inbound/last-route.ts',
+  'src/messaging/inbound/media-url-download.ts',
   'src/messaging/inbound/native-command.ts',
   'src/messaging/inbound/native-reply-delivery.ts',
+  'src/messaging/inbound/parse.ts',
+  'src/messaging/inbound/remote-media.ts',
   'src/messaging/inbound/reply-config.ts',
+  'src/messaging/inbound/reply-dispatch.ts',
   'src/messaging/inbound/runtime-compat.ts',
   'src/messaging/inbound/session-label.ts',
-  'src/messaging/outbound/send.ts',
-  'src/messaging/outbound/media.ts',
+  'src/messaging/inbound/turn-context.ts',
   'src/messaging/outbound/actions.ts',
   'src/messaging/outbound/build-send-action.ts',
   'src/messaging/outbound/diagnostics.ts',
+  'src/messaging/outbound/diagnostics-debug-builders.ts',
   'src/messaging/outbound/durable-message-adapter.ts',
   'src/messaging/outbound/durable-queue-adapter.ts',
   'src/messaging/outbound/media-dedupe.ts',
+  'src/messaging/outbound/media.ts',
   'src/messaging/outbound/queue-selectors.ts',
   'src/messaging/outbound/reasons.ts',
   'src/messaging/outbound/reply-enqueue.ts',
   'src/messaging/outbound/reply-target-policy.ts',
   'src/messaging/outbound/retry-policy.ts',
   'src/messaging/outbound/send-params.ts',
+  'src/messaging/outbound/send.ts',
   'src/messaging/outbound/session-route.ts',
   'src/messaging/outbound/target-resolver.ts',
   'src/openclaw/config-runtime.ts',
@@ -84,16 +96,73 @@ const requiredSourceFiles = [
   'src/openclaw/runtime-surface.ts',
   'src/openclaw/sdk-helpers.ts',
   'src/openclaw/session-route-runtime.ts',
+  'src/plugin/ack-outbox-runtime-group.ts',
+  'src/plugin/bridge-surface-handlers-group.ts',
+  'src/plugin/bridge-surface-helpers.ts',
   'src/plugin/capabilities.ts',
+  'src/plugin/channel-components.ts',
+  'src/plugin/channel-inbound-helpers.ts',
+  'src/plugin/channel-plugin-bridge-group.ts',
+  'src/plugin/channel-plugin-surface-group.ts',
+  'src/plugin/channel-runtime-constants.ts',
+  'src/plugin/channel-runtime-builders.ts',
+  'src/plugin/channel-send-runtime-group.ts',
+  'src/plugin/channel-runtime-types.ts',
+  'src/plugin/channel-send.ts',
+  'src/plugin/channel-utils.ts',
   'src/plugin/config.ts',
+  'src/plugin/connection-handlers.ts',
+  'src/plugin/connection-state.ts',
+  'src/plugin/connection-state-runtime-group.ts',
+  'src/plugin/diagnostics-handlers.ts',
+  'src/plugin/file-ack-runtime.ts',
+  'src/plugin/file-inbound-abort.ts',
+  'src/plugin/file-inbound-chunk.ts',
+  'src/plugin/file-inbound-complete.ts',
+  'src/plugin/file-inbound-handlers.ts',
+  'src/plugin/file-inbound-init.ts',
+  'src/plugin/file-inbound-runtime.ts',
+  'src/plugin/file-inbound-state.ts',
+  'src/plugin/file-transfer-logs.ts',
+  'src/plugin/media-dedupe-runtime.ts',
+  'src/plugin/file-transfer-orchestrator.ts',
+  'src/plugin/media-orchestrators-runtime-group.ts',
+  'src/plugin/file-transfer-runtime-group.ts',
+  'src/plugin/file-transfer-send.ts',
+  'src/plugin/file-transfer-setup.ts',
+  'src/plugin/gateway-event-context.ts',
   'src/plugin/gateway-methods.ts',
   'src/plugin/gateway-runtime.ts',
+  'src/plugin/inbound-acceptance.ts',
+  'src/plugin/inbound-surface-handlers-group.ts',
+  'src/plugin/inbound-handlers.ts',
+  'src/plugin/message-ack-runtime.ts',
   'src/plugin/message-policy.ts',
   'src/plugin/message-send.ts',
   'src/plugin/messaging.ts',
   'src/plugin/meta.ts',
   'src/plugin/outbound.ts',
+  'src/plugin/outbox-ack-logs.ts',
+  'src/plugin/outbox-ack-outcome.ts',
+  'src/plugin/outbox-drain-ack.ts',
+  'src/plugin/outbox-drain-failure.ts',
+  'src/plugin/outbox-drain-loop.ts',
+  'src/plugin/outbox-drain-post-push.ts',
+  'src/plugin/outbox-drain-runtime.ts',
+  'src/plugin/outbox-drain-schedule.ts',
+  'src/plugin/outbox-file-push-flow.ts',
+  'src/plugin/outbox-push-route-runtime-group.ts',
+  'src/plugin/outbox-push.ts',
+  'src/plugin/outbox-route.ts',
+  'src/plugin/outbox-text-push-flow.ts',
+  'src/plugin/runtime-diagnostics-snapshot.ts',
   'src/plugin/setup.ts',
+  'src/plugin/state-transient-runtime-group.ts',
+  'src/plugin/state-store.ts',
+  'src/plugin/target-runtime.ts',
+  'src/plugin/target-status-runtime-group.ts',
+  'src/plugin/transient-state-runtime.ts',
+  'src/plugin/status-runtime.ts',
   'src/plugin/status.ts',
   'src/runtime/log-dedupe.ts',
   'src/runtime/outbound-ack-timeout.ts',

package/src/bootstrap/channel-plugin-runtime.ts

@@ -0,0 +1,81 @@
+type ChannelModule = typeof import('../channel.ts');
+type BridgeSingleton = ReturnType<ChannelModule['createBncrBridge']>;
+type ChannelPlugin = ReturnType<ChannelModule['createBncrChannelPlugin']>;
+
+type LoadedRuntime = {
+  createBncrBridge: ChannelModule['createBncrBridge'];
+  createBncrChannelPlugin: ChannelModule['createBncrChannelPlugin'];
+};
+
+export function createDynamicChannelPlugin(args: {
+  loaded: LoadedRuntime;
+  getCurrentBridge: () => BridgeSingleton;
+}): ChannelPlugin {
+  const { loaded, getCurrentBridge } = args;
+  const base = loaded.createBncrChannelPlugin(() => getCurrentBridge());
+  const plugin = { ...base } as ChannelPlugin;
+  const outbound = base.outbound as ChannelPlugin['outbound'];
+  const baseStatus = base.status;
+  const baseGateway = base.gateway;
+
+  type StatusBuildChannelSummaryArgs = Parameters<typeof baseStatus.buildChannelSummary>[0];
+  type StatusBuildAccountSnapshotArgs = Parameters<typeof baseStatus.buildAccountSnapshot>[0];
+  type StatusResolveAccountStateArgs = Parameters<typeof baseStatus.resolveAccountState>[0];
+  type GatewayStartAccountArgs = Parameters<NonNullable<typeof baseGateway.startAccount>>[0];
+  type GatewayStopAccountArgs = Parameters<NonNullable<typeof baseGateway.stopAccount>>[0];
+
+  plugin.outbound = {
+    ...outbound,
+    sendText: (async (ctx: Parameters<typeof outbound.sendText>[0]) =>
+      (await getCurrentBridge().channelSendText(ctx)) as Awaited<
+        ReturnType<typeof outbound.sendText>
+      >) as typeof outbound.sendText,
+    sendMedia: (async (ctx: Parameters<typeof outbound.sendMedia>[0]) =>
+      (await getCurrentBridge().channelSendMedia(ctx)) as Awaited<
+        ReturnType<typeof outbound.sendMedia>
+      >) as typeof outbound.sendMedia,
+  };
+
+  plugin.status = {
+    ...baseStatus,
+    buildChannelSummary: async ({ defaultAccountId }: StatusBuildChannelSummaryArgs) =>
+      getCurrentBridge().getChannelSummary(defaultAccountId || 'Primary'),
+    buildAccountSnapshot: async ({ account, runtime }: StatusBuildAccountSnapshotArgs) => {
+      const bridgeNow = getCurrentBridge();
+      return baseStatus.buildAccountSnapshot({
+        account,
+        runtime: runtime || bridgeNow.getAccountRuntimeSnapshot(account?.accountId || 'Primary'),
+      });
+    },
+    resolveAccountState: ({
+      enabled,
+      configured,
+      account,
+      cfg,
+      runtime,
+    }: StatusResolveAccountStateArgs) => {
+      const bridgeNow = getCurrentBridge();
+      return baseStatus.resolveAccountState({
+        enabled,
+        configured,
+        account,
+        cfg,
+        runtime: runtime || bridgeNow.getAccountRuntimeSnapshot(account?.accountId || 'Primary'),
+      });
+    },
+  };
+
+  plugin.gateway = {
+    ...baseGateway,
+    startAccount: (ctx: GatewayStartAccountArgs) =>
+      getCurrentBridge().channelStartAccount(
+        ctx as Parameters<BridgeSingleton['channelStartAccount']>[0],
+      ),
+    stopAccount: (ctx: GatewayStopAccountArgs) =>
+      getCurrentBridge().channelStopAccount(
+        ctx as Parameters<BridgeSingleton['channelStopAccount']>[0],
+      ),
+  };
+
+  return plugin;
+}

package/src/bootstrap/cli.ts

@@ -0,0 +1,97 @@
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk/core';
+import type { BncrConfigSchema } from '../core/config-schema.ts';
+import {
+  getOpenClawRuntimeConfig,
+  mutateOpenClawRuntimeConfigFile,
+} from '../openclaw/config-runtime.ts';
+
+type BncrCliProgramLike = {
+  command: (name: string) => BncrCliProgramLike;
+  description: (text: string) => BncrCliProgramLike;
+  action: (handler: () => Promise<void> | void) => BncrCliProgramLike;
+};
+
+type BncrCliRegistrarLike = {
+  registerCli?: (
+    register: (ctx: { program: BncrCliProgramLike }) => void,
+    options?: { commands?: string[] },
+  ) => void;
+};
+
+type BncrCliConfigRoot = {
+  channels?: Record<string, unknown> & {
+    bncr?: Record<string, unknown> & {
+      enabled?: boolean;
+      allowTool?: boolean;
+    };
+  };
+};
+
+const isPlainObject = (value: unknown): value is Record<string, unknown> =>
+  !!value && typeof value === 'object' && !Array.isArray(value);
+
+export type BncrRegistrationApi = OpenClawPluginApi &
+  BncrCliRegistrarLike & {
+    registrationMode?: string;
+    configSchema?: typeof BncrConfigSchema;
+  };
+
+export function registerBncrCli(api: BncrRegistrationApi) {
+  if (typeof api.registerCli !== 'function') return;
+  api.registerCli(
+    ({ program }: { program: BncrCliProgramLike }) => {
+      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) as BncrCliConfigRoot | null | undefined) || {};
+          const channels = isPlainObject(cfg.channels) ? cfg.channels : {};
+          const existing = isPlainObject(channels.bncr) ? channels.bncr : {};
+          const added: string[] = [];
+
+          if (existing.enabled === undefined) {
+            added.push('enabled=true');
+          }
+
+          if (existing.allowTool === undefined) {
+            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: Record<string, unknown>) {
+              if (!isPlainObject(draft.channels)) draft.channels = {};
+              const draftChannels = draft.channels as Record<string, unknown>;
+              const draftExisting = isPlainObject(draftChannels.bncr) ? draftChannels.bncr : {};
+              const draftBncrCfg: Record<string, unknown> = { ...draftExisting };
+
+              if (draftBncrCfg.enabled === undefined) {
+                draftBncrCfg.enabled = true;
+              }
+
+              if (draftBncrCfg.allowTool === undefined) {
+                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'] },
+  );
+}
+
+export const shouldSkipNonRuntimeRegister = (mode?: string) =>
+  mode === 'cli-metadata' || mode === 'discovery';