@xmoxmo/bncr 0.2.6 → 0.2.8

package/README.md

@@ -34,7 +34,7 @@ openclaw plugins update bncr
 openclaw gateway restart
 ```
 
-> 兼容范围：`openclaw >= 2026.5.3-1`
+> 兼容范围：`openclaw >= 2026.5.27`
 >
 > 如果你是从精确版本升级，或本地安装记录仍钉在旧版本，也可以显式执行：
 >
@@ -95,6 +95,10 @@ bncr 当前采用两层模型：
    - 在 OpenClaw 内部按正式 `channel plugin` 建模
    - 负责入站解析、消息分发、出站适配、状态与治理
 
+出站可靠投递的边界：bncr 后面仍有自己的服务框架和 outbox / ACK / retry / deadLetter 体系。对 OpenClaw 宿主来说，消息成功交给 bncr 插件并进入 bncr 自管 outbox，即表示频道 handoff 完成；这不等价于客户端 ACK 或目标平台最终送达。后续可靠投递由 bncr 自身负责。
+
+当前已注册生产 `channel.message` 作为 bncr 的频道专用 handoff adapter：`text` / `media` / `payload` 会转换为 bncr outbox entry。原有通用 `message.send` / `channel.actions.send` 发送能力继续保留；`channel.message` 是频道专用入口，不替代通用发送入口。该 adapter 仍不启用 `durableFinal`；进入 outbox 后的客户端 ACK、目标平台送达、retry、deadLetter 继续由 bncr 服务框架负责。
+
 当前代码结构：
 
 ```text
@@ -246,6 +250,7 @@ npm root -g
 cd plugins/bncr
 npm test
 npm run selfcheck
+npm run check-pack
 npm pack
 ```
 
@@ -253,6 +258,7 @@ npm pack
 
 - `npm test`：跑回归测试
 - `npm run selfcheck`：检查插件骨架是否完整
+- `npm run check-pack`：执行 `npm pack --dry-run --json`，确认发布包包含关键入口与 OpenClaw adapter 文件
 - `npm pack`：确认当前版本可正常打包
 - `npm run check-register-drift -- --duration-sec 300 --interval-sec 15`：静置采样 `bncr.diagnostics`，观察 `registerCount / apiGeneration / postWarmupRegisterCount` 是否在 warmup 后继续增长
 

package/index.ts

@@ -5,6 +5,10 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { BncrConfigSchema } from './src/core/config-schema.ts';
 import { emitBncrLogLine } from './src/core/logging.ts';
+import {
+  getOpenClawRuntimeConfig,
+  mutateOpenClawRuntimeConfigFile,
+} from './src/openclaw/config-runtime.ts';
 
 const pluginFile = fileURLToPath(import.meta.url);
 const pluginDir = path.dirname(pluginFile);
@@ -660,35 +664,46 @@ const registerBncrCli = (api: OpenClawPluginApi & { registerCli?: (...args: any[
           'Seed minimal channels.bncr config (adds enabled=true and allowTool=false only when missing)',
         )
         .action(async () => {
-          const cfg = api.runtime.config.current() as Record<string, unknown>;
-          const next = structuredClone(cfg);
-          if (!isPlainObject(next.channels)) next.channels = {};
-
-          const existing = isPlainObject(next.channels.bncr) ? next.channels.bncr : {};
-          const bncrCfg: Record<string, unknown> = { ...existing };
+          const cfg = getOpenClawRuntimeConfig(api) as Record<string, unknown>;
+          const channels = isPlainObject(cfg.channels) ? cfg.channels : {};
+          const existing = isPlainObject(channels.bncr) ? channels.bncr : {};
           const added: string[] = [];
 
-          if (bncrCfg.enabled === undefined) {
-            bncrCfg.enabled = true;
+          if (existing.enabled === undefined) {
             added.push('enabled=true');
           }
 
-          if (bncrCfg.allowTool === undefined) {
-            bncrCfg.allowTool = false;
+          if (existing.allowTool === undefined) {
             added.push('allowTool=false');
           }
 
-          next.channels.bncr = bncrCfg;
-
           if (added.length === 0) {
             console.log('Minimal bncr config already present. No changes made.');
             return;
           }
 
-          await api.runtime.config.writeConfigFile(next);
+          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('Restart the gateway to apply changes.');
+          console.log('Gateway will apply the config using the host afterWrite policy.');
         });
     },
     { commands: ['bncr'] },
@@ -801,7 +816,7 @@ const plugin = {
 
     const resolveDebug = async () => {
       try {
-        const cfg = api.runtime.config.current();
+        const cfg = getOpenClawRuntimeConfig(api);
         return Boolean((cfg as any)?.channels?.bncr?.debug?.verbose);
       } catch {
         return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -27,17 +27,18 @@
     "selfcheck": "node ./scripts/selfcheck.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 .",
     "format": "biome format --write .",
     "lint": "biome lint .",
     "check": "biome check ."
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.3-1"
+    "openclaw": ">=2026.5.27"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
-    "openclaw": ">=2026.5.3-1"
+    "openclaw": ">=2026.5.27"
   },
   "openclaw": {
     "extensions": [

package/scripts/check-pack.mjs

@@ -0,0 +1,77 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const root = path.resolve(__dirname, '..');
+
+const requiredPackFiles = [
+  'README.md',
+  'index.ts',
+  'openclaw.plugin.json',
+  'package.json',
+  'scripts/selfcheck.mjs',
+  'scripts/check-register-drift.mjs',
+  'src/channel.ts',
+  'src/plugin/config.ts',
+  'src/plugin/message-policy.ts',
+  'src/plugin/messaging.ts',
+  'src/plugin/gateway-runtime.ts',
+  'src/plugin/message-send.ts',
+  'src/plugin/outbound.ts',
+  'src/plugin/setup.ts',
+  'src/plugin/status.ts',
+  'src/runtime/outbound-ack-timeout.ts',
+  'src/runtime/outbound-flags.ts',
+  'src/runtime/outbox-transitions.ts',
+  'src/messaging/outbound/durable-message-adapter.ts',
+  'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/openclaw/config-runtime.ts',
+  'src/openclaw/inbound-session-runtime.ts',
+  'src/openclaw/ingress-runtime.ts',
+  'src/openclaw/media-runtime.ts',
+  'src/openclaw/reply-runtime.ts',
+  'src/openclaw/routing-runtime.ts',
+  'src/openclaw/sdk-helpers.ts',
+  'src/openclaw/session-route-runtime.ts',
+];
+
+const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+const output = execFileSync('npm', ['pack', '--dry-run', '--json'], {
+  cwd: root,
+  encoding: 'utf8',
+  stdio: ['ignore', 'pipe', 'pipe'],
+});
+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 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 channelMessageChecks = {
+  registered: channelSource.includes('message: {'),
+  text: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendText'),
+  media: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendMedia'),
+  payload: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendPayload'),
+  manualAck:
+    channelSource.includes('BNCR_MESSAGE_RECEIVE_POLICY') &&
+    messagePolicySource.includes("defaultAckPolicy: 'manual'") &&
+    messagePolicySource.includes("supportedAckPolicies: ['manual']"),
+  genericActionsPreserved: channelSource.includes('actions: messageActions'),
+  noDurableFinal: !channelSource.includes('durableFinal:') && !messagePolicySource.includes('durableFinal:'),
+};
+const channelMessageOk = Object.values(channelMessageChecks).every(Boolean);
+
+const result = {
+  ok: missing.length === 0 && pkg.peerDependencies?.openclaw === '>=2026.5.27' && channelMessageOk,
+  package: pack?.id,
+  entryCount: pack?.entryCount,
+  missing,
+  openclaw: pkg.peerDependencies?.openclaw,
+  channelMessageChecks,
+};
+
+console.log(JSON.stringify(result, null, 2));
+if (!result.ok) process.exit(1);

package/scripts/selfcheck.mjs

@@ -24,6 +24,16 @@ const requiredFiles = [
   'src/messaging/outbound/send.ts',
   'src/messaging/outbound/media.ts',
   'src/messaging/outbound/actions.ts',
+  'src/messaging/outbound/durable-message-adapter.ts',
+  'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/openclaw/config-runtime.ts',
+  'src/openclaw/inbound-session-runtime.ts',
+  'src/openclaw/ingress-runtime.ts',
+  'src/openclaw/media-runtime.ts',
+  'src/openclaw/reply-runtime.ts',
+  'src/openclaw/routing-runtime.ts',
+  'src/openclaw/sdk-helpers.ts',
+  'src/openclaw/session-route-runtime.ts',
 ];
 
 const readPackageVersion = () => {