@xmoxmo/bncr 0.3.2 → 0.3.4

package/README.md

@@ -193,6 +193,20 @@ openclaw gateway call message.action --params '{
 
 后续如果在其他 OpenClaw 版本上完成验证，应继续在本节追加对应版本的验证过程与结论，不直接外推复用 `2026.5.18` 的验证口径。
 
+### 2026.6.1 验证说明
+
+以下口径已在 OpenClaw `2026.6.1` 与 bncr `0.3.2` 上完成基础验证：
+
+1. 普通文本入站与 assistant 文本回复正常。
+2. Agent 回复中的图片附件可通过 `MEDIA:<path>` 投递。
+3. Agent 回复中的 `ogg(opus)` voice 附件可通过 `MEDIA:<path>` 搭配 voice 发送提示投递。
+4. 入站 prompt 中只出现 OpenClaw 官方 `Conversation info` / `Sender` untrusted metadata，未重复注入 bncr 自定义 context block。
+
+仍需分开判断：
+
+- `MEDIA:<path>` 成功代表宿主 reply-media / attachment 链路和 bncr 下行媒体投递在该场景下可用。
+- `message.action` / `send` 仍应作为显式目标发送链单独验证，特别是跨会话、跨账号、文件传输 ACK 与 outbox 重试场景。
+
 ---
 
 ## 8. 状态与诊断
@@ -257,7 +271,7 @@ npm pack
 用途：
 
 - `npm test`：跑回归测试
-- `npm run selfcheck`：检查插件骨架是否完整
+- `npm run selfcheck`：检查插件骨架是否完整，并验证关键 OpenClaw SDK subpath 可解析
 - `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

@@ -111,7 +111,6 @@ type BncrGatewayRuntime = {
 };
 
 let runtime: LoadedRuntime | null = null;
-let activeServiceStop: (() => Promise<void>) | null = null;
 const identityIds = new WeakMap<object, string>();
 let identitySeq = 0;
 
@@ -297,7 +296,9 @@ const loadRuntimeSync = (): LoadedRuntime => {
     return runtime;
   } catch (error) {
     const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-    throw new Error(`bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`);
+    throw new Error(
+      `bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`,
+    );
   }
 };
 
@@ -365,14 +366,9 @@ const getGatewayRuntime = (): BncrGatewayRuntime => {
 };
 
 const getProcessOwnerApiInstanceId = (gatewayRuntime: BncrGatewayRuntime) =>
-  gatewayRuntime.serviceOwnerApiInstanceId ||
-  gatewayRuntime.channelOwnerApiInstanceId ||
-  undefined;
+  gatewayRuntime.serviceOwnerApiInstanceId || gatewayRuntime.channelOwnerApiInstanceId || undefined;
 
-const shouldAdoptProcessOwner = (
-  apiInstanceId: string,
-  gatewayRuntime: BncrGatewayRuntime,
-) => {
+const shouldAdoptProcessOwner = (apiInstanceId: string, gatewayRuntime: BncrGatewayRuntime) => {
   const existingOwnerApiInstanceId = getProcessOwnerApiInstanceId(gatewayRuntime);
   const hasSingletonOwner =
     Boolean(gatewayRuntime.serviceRegistered) || Boolean(gatewayRuntime.channelRegistered);
@@ -845,7 +841,6 @@ const plugin = {
         },
         stop: serviceStopHandler,
       });
-      activeServiceStop = serviceStopHandler;
       gatewayRuntime.serviceRegistered = true;
       gatewayRuntime.serviceOwnerApiInstanceId = apiInstanceId;
       meta.service = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -39,9 +39,9 @@
     "openclaw": ">=2026.5.27"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
-    "openclaw": ">=2026.5.27",
-    "esbuild": "^0.28.0"
+    "@biomejs/biome": "^2.4.16",
+    "esbuild": "^0.28.0",
+    "openclaw": ">=2026.5.27"
   },
   "openclaw": {
     "extensions": [

package/scripts/check-pack.mjs

@@ -48,19 +48,29 @@ 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 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'),
+  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:'),
+  noDurableFinal:
+    !channelSource.includes('durableFinal:') && !messagePolicySource.includes('durableFinal:'),
 };
 const channelMessageOk = Object.values(channelMessageChecks).every(Boolean);
 

package/scripts/selfcheck.mjs

@@ -1,10 +1,12 @@
 import fs from 'node:fs';
+import { createRequire } from 'node:module';
 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 require = createRequire(import.meta.url);
 
 const requiredFiles = [
   'index.ts',
@@ -43,6 +45,29 @@ const readPackageVersion = () => {
   return typeof pkg?.version === 'string' ? pkg.version.trim() : '';
 };
 
+const requiredOpenClawSdkSubpaths = [
+  'openclaw/plugin-sdk/channel-outbound',
+  'openclaw/plugin-sdk/channel-message',
+  'openclaw/plugin-sdk/routing',
+  'openclaw/plugin-sdk/conversation-runtime',
+  'openclaw/plugin-sdk/session-store-runtime',
+  'openclaw/plugin-sdk/core',
+];
+
+const resolveOpenClawSdkSubpaths = () => {
+  return requiredOpenClawSdkSubpaths.map((specifier) => {
+    try {
+      return { specifier, ok: true, path: require.resolve(specifier) };
+    } catch (err) {
+      return {
+        specifier,
+        ok: false,
+        error: err && typeof err === 'object' && 'code' in err ? err.code : String(err),
+      };
+    }
+  });
+};
+
 const validateVersionPolicy = (version) => {
   const match = version.match(/^(\d+)\.(\d+)\.(\d+)$/);
   if (!match) {
@@ -68,14 +93,17 @@ const validateVersionPolicy = (version) => {
 const missing = requiredFiles.filter((rel) => !fs.existsSync(path.join(root, rel)));
 const version = readPackageVersion();
 const versionPolicy = validateVersionPolicy(version);
+const sdkSubpaths = resolveOpenClawSdkSubpaths();
+const missingSdkSubpaths = sdkSubpaths.filter((entry) => !entry.ok);
 const result = {
-  ok: missing.length === 0 && versionPolicy.ok,
+  ok: missing.length === 0 && versionPolicy.ok && missingSdkSubpaths.length === 0,
   checkedRoot: root,
   requiredCount: requiredFiles.length,
   missing,
   version,
   versionPolicy,
+  sdkSubpaths,
 };
 
 console.log(JSON.stringify(result, null, 2));
-if (missing.length > 0 || !versionPolicy.ok) process.exit(1);
+if (missing.length > 0 || !versionPolicy.ok || missingSdkSubpaths.length > 0) process.exit(1);