@xmoxmo/bncr 0.0.6 → 0.0.7

package/README.md

@@ -37,7 +37,20 @@ openclaw gateway restart
 
 ---
 
-## 3. 当前能力
+## 3. 客户端接入流程（最简）
+
+1. 在客户端插件配置中，将 **OpenClaw Token** 填写为 **gateway token**，并正确填写 host / port / ssl 后启用插件。
+2. 启动（或重启）bncr 客户端后，在 OpenClaw 侧执行：
+
+```bash
+openclaw devices approve --latest
+```
+
+完成后，客户端会使用自己的身份并自动保存后续授权。
+
+---
+
+## 4. 当前能力
 
 - 文本
 - 图片
@@ -54,7 +67,7 @@ openclaw gateway restart
 
 ---
 
-## 4. 架构定位
+## 5. 架构定位
 
 bncr 当前采用两层模型：
 
@@ -77,7 +90,7 @@ plugins/bncr/src/
 
 ---
 
-## 5. 配置项总览
+## 6. 配置项总览
 
 当前主要配置字段：
 
@@ -98,7 +111,7 @@ plugins/bncr/src/
 
 ---
 
-## 6. 状态与诊断
+## 7. 状态与诊断
 
 常用检查：
 
@@ -116,7 +129,7 @@ openclaw health --json
 
 ---
 
-## 7. 自检与测试
+## 8. 自检与测试
 
 ```bash
 cd plugins/bncr
@@ -133,11 +146,12 @@ npm pack
 
 ---
 
-## 8. 上线前检查
+## 9. 上线前检查
 
 上线前建议至少确认：
 
 - README 与当前实现一致
+- **隐私清理**：测试/示例/日志中的 scope、ID、账号等做去标识化（必要时用占位值）
 - 配置 schema 与实际字段一致
 - 测试通过
 - 自检通过

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "license": "MIT",

package/src/channel.ts

@@ -6,6 +6,7 @@ import type {
   OpenClawPluginServiceContext,
   GatewayRequestHandlerOptions,
   ChatType,
+  ChannelMessageActionAdapter,
 } from 'openclaw/plugin-sdk';
 import {
   createDefaultChannelRuntimeState,
@@ -13,6 +14,10 @@ import {
   applyAccountNameToChannelSection,
   writeJsonFileAtomically,
   readJsonFileWithFallback,
+  readStringParam,
+  readBooleanParam,
+  extractToolSend,
+  jsonResult,
 } from 'openclaw/plugin-sdk';
 import { CHANNEL_ID, BNCR_DEFAULT_ACCOUNT_ID, normalizeAccountId, resolveDefaultDisplayName, resolveAccount, listAccountIds } from './core/accounts.js';
 import type { BncrRoute, BncrConnection, OutboxEntry } from './core/types.js';
@@ -290,11 +295,17 @@ class BncrBridgeRuntime {
     return map.get(normalizeAccountId(accountId)) || 0;
   }
 
-  private syncDebugFlag() {
-    const next = this.isDebugEnabled();
-    if (next !== BNCR_DEBUG_VERBOSE) {
-      BNCR_DEBUG_VERBOSE = next;
-      this.api.logger.info?.(`[bncr-debug] verbose=${BNCR_DEBUG_VERBOSE}`);
+  private async syncDebugFlag() {
+    try {
+      const cfg = await this.api.runtime.config.loadConfig();
+      const raw = (cfg as any)?.channels?.[CHANNEL_ID]?.debug?.verbose;
+      if (typeof raw !== 'boolean') return;
+      if (raw !== BNCR_DEBUG_VERBOSE) {
+        BNCR_DEBUG_VERBOSE = raw;
+        this.api.logger.info?.(`[bncr-debug] verbose=${BNCR_DEBUG_VERBOSE}`);
+      }
+    } catch {
+      // ignore config read errors
     }
   }
 
@@ -1593,11 +1604,11 @@ class BncrBridgeRuntime {
     };
   }
 
-  private async enqueueFromReply(params: {
+  public async enqueueFromReply(params: {
     accountId: string;
     sessionKey: string;
     route: BncrRoute;
-    payload: { text?: string; mediaUrl?: string; mediaUrls?: string[] };
+    payload: { text?: string; mediaUrl?: string; mediaUrls?: string[]; asVoice?: boolean; audioAsVoice?: boolean };
     mediaLocalRoots?: readonly string[];
   }) {
     const { accountId, sessionKey, route, payload, mediaLocalRoots } = params;
@@ -1620,6 +1631,7 @@ class BncrBridgeRuntime {
         });
         const messageId = randomUUID();
         const mediaMsg = first ? asString(payload.text || '') : '';
+        const wantsVoice = payload.asVoice === true || payload.audioAsVoice === true;
         const frame = buildBncrMediaOutboundFrame({
           messageId,
           sessionKey,
@@ -1632,6 +1644,7 @@ class BncrBridgeRuntime {
             fileName: media.fileName,
             mimeType: media.mimeType,
           }),
+          hintedType: wantsVoice ? 'voice' : undefined,
           now: now(),
         });
 
@@ -1785,7 +1798,7 @@ class BncrBridgeRuntime {
   };
 
   handleActivity = async ({ params, respond, client, context }: GatewayRequestHandlerOptions) => {
-    this.syncDebugFlag();
+    void this.syncDebugFlag();
     const accountId = normalizeAccountId(asString(params?.accountId || ''));
     const connId = asString(client?.connId || '').trim() || `no-conn-${Date.now()}`;
     const clientId = asString((params as any)?.clientId || '').trim() || undefined;
@@ -2287,6 +2300,8 @@ class BncrBridgeRuntime {
   channelSendMedia = async (ctx: any) => {
     const accountId = normalizeAccountId(ctx.accountId);
     const to = asString(ctx.to || '').trim();
+    const asVoice = ctx?.asVoice === true;
+    const audioAsVoice = ctx?.audioAsVoice === true;
 
     if (BNCR_DEBUG_VERBOSE) {
       this.api.logger.info?.(
@@ -2296,6 +2311,8 @@ class BncrBridgeRuntime {
           text: asString(ctx?.text || ''),
           mediaUrl: asString(ctx?.mediaUrl || ''),
           mediaUrls: Array.isArray(ctx?.mediaUrls) ? ctx.mediaUrls : undefined,
+          asVoice,
+          audioAsVoice,
           sessionKey: asString(ctx?.sessionKey || ''),
           mirrorSessionKey: asString(ctx?.mirror?.sessionKey || ''),
           rawCtx: {
@@ -2314,6 +2331,8 @@ class BncrBridgeRuntime {
       to,
       text: asString(ctx.text || ''),
       mediaUrl: asString(ctx.mediaUrl || ''),
+      asVoice,
+      audioAsVoice,
       mediaLocalRoots: ctx.mediaLocalRoots,
       resolveVerifiedTarget: (to, accountId) => this.resolveVerifiedTarget(to, accountId),
       rememberSessionRoute: (sessionKey, accountId, route) => this.rememberSessionRoute(sessionKey, accountId, route),
@@ -2328,6 +2347,58 @@ export function createBncrBridge(api: OpenClawPluginApi) {
 }
 
 export function createBncrChannelPlugin(bridge: BncrBridgeRuntime) {
+  const messageActions: ChannelMessageActionAdapter = {
+    listActions: () => ['send'],
+    supportsAction: ({ action }) => action === 'send',
+    extractToolSend: ({ args }) => extractToolSend(args, 'sendMessage'),
+    handleAction: async ({ action, params, accountId, mediaLocalRoots }) => {
+      if (action !== 'send') throw new Error(`Action ${action} is not supported for provider ${CHANNEL_ID}.`);
+      const to = readStringParam(params, 'to', { required: true });
+      const message = readStringParam(params, 'message', { allowEmpty: true }) ?? '';
+      const caption = readStringParam(params, 'caption', { allowEmpty: true }) ?? '';
+      const content = message || caption || '';
+      const mediaUrl =
+        readStringParam(params, 'media', { trim: false }) ??
+        readStringParam(params, 'path', { trim: false }) ??
+        readStringParam(params, 'filePath', { trim: false }) ??
+        readStringParam(params, 'mediaUrl', { trim: false });
+      const asVoice = readBooleanParam(params, 'asVoice') ?? false;
+      const audioAsVoice = readBooleanParam(params, 'audioAsVoice') ?? false;
+      const resolvedAccountId = normalizeAccountId(readStringParam(params, 'accountId') ?? accountId);
+
+      if (!content.trim() && !mediaUrl) throw new Error('send requires text or media');
+
+      const result = mediaUrl
+        ? await sendBncrMedia({
+          channelId: CHANNEL_ID,
+          accountId: resolvedAccountId,
+          to,
+          text: content,
+          mediaUrl,
+          asVoice,
+          audioAsVoice,
+          mediaLocalRoots,
+          resolveVerifiedTarget: (to, accountId) => bridge.resolveVerifiedTarget(to, accountId),
+          rememberSessionRoute: (sessionKey, accountId, route) => bridge.rememberSessionRoute(sessionKey, accountId, route),
+          enqueueFromReply: (args) => bridge.enqueueFromReply(args as any),
+          createMessageId: () => randomUUID(),
+        })
+        : await sendBncrText({
+          channelId: CHANNEL_ID,
+          accountId: resolvedAccountId,
+          to,
+          text: content,
+          mediaLocalRoots,
+          resolveVerifiedTarget: (to, accountId) => bridge.resolveVerifiedTarget(to, accountId),
+          rememberSessionRoute: (sessionKey, accountId, route) => bridge.rememberSessionRoute(sessionKey, accountId, route),
+          enqueueFromReply: (args) => bridge.enqueueFromReply(args as any),
+          createMessageId: () => randomUUID(),
+        });
+
+      return jsonResult({ ok: true, ...result });
+    },
+  };
+
   const plugin = {
     id: CHANNEL_ID,
     meta: {
@@ -2338,6 +2409,7 @@ export function createBncrChannelPlugin(bridge: BncrBridgeRuntime) {
       blurb: 'Bncr Channel.',
       aliases: ['bncr'],
     },
+    actions: messageActions,
     capabilities: {
       chatTypes: ['direct'] as ChatType[],
       media: true,

package/src/messaging/inbound/commands.ts

@@ -113,7 +113,7 @@ export async function handleBncrNativeCommand(params: {
       disableBlockStreaming: true,
     },
     dispatcherOptions: {
-      deliver: async (payload: { text?: string; mediaUrl?: string; mediaUrls?: string[] }, info?: { kind?: 'tool' | 'block' | 'final' }) => {
+      deliver: async (payload: { text?: string; mediaUrl?: string; mediaUrls?: string[]; audioAsVoice?: boolean }, info?: { kind?: 'tool' | 'block' | 'final' }) => {
         if (info?.kind && info.kind !== 'final') return;
         const hasPayload = Boolean(payload?.text || payload?.mediaUrl || (Array.isArray(payload?.mediaUrls) && payload.mediaUrls.length > 0));
         if (!hasPayload) return;

package/src/messaging/inbound/dispatch.ts

@@ -151,7 +151,7 @@ export async function dispatchBncrInbound(params: {
     },
     dispatcherOptions: {
       deliver: async (
-        payload: { text?: string; mediaUrl?: string; mediaUrls?: string[] },
+        payload: { text?: string; mediaUrl?: string; mediaUrls?: string[]; audioAsVoice?: boolean },
         info?: { kind?: 'tool' | 'block' | 'final' },
       ) => {
         if (info?.kind && info.kind !== 'final') return;

package/src/messaging/outbound/media.ts

@@ -4,6 +4,11 @@ function asString(v: unknown, fallback = ''): string {
   return String(v);
 }
 
+function isAudioMimeType(mimeType?: string): boolean {
+  const mt = asString(mimeType || '').toLowerCase();
+  return mt.startsWith('audio/');
+}
+
 export function resolveBncrOutboundMessageType(params: { mimeType?: string; fileName?: string; hintedType?: string; hasPayload?: boolean }): 'text' | 'image' | 'video' | 'voice' | 'audio' | 'file' {
   const hinted = asString(params.hintedType || '').toLowerCase();
   const hasPayload = !!params.hasPayload;
@@ -12,6 +17,11 @@ export function resolveBncrOutboundMessageType(params: { mimeType?: string; file
   const isStandard = hinted === 'text' || hinted === 'image' || hinted === 'video' || hinted === 'voice' || hinted === 'audio' || hinted === 'file';
 
   if (hasPayload && major === 'text' && (hinted === 'text' || !isStandard)) return 'file';
+  if (hinted === 'voice') {
+    if (isAudioMimeType(mt)) return 'voice';
+    if (major === 'text' || major === 'image' || major === 'video' || major === 'audio') return major as any;
+    return 'file';
+  }
   if (isStandard) return hinted as any;
   if (major === 'text' || major === 'image' || major === 'video' || major === 'audio') return major as any;
   return 'file';
@@ -25,6 +35,7 @@ export function buildBncrMediaOutboundFrame(params: {
   mediaUrl: string;
   mediaMsg: string;
   fileName: string;
+  hintedType?: string;
   now: number;
 }) {
   return {
@@ -40,6 +51,7 @@ export function buildBncrMediaOutboundFrame(params: {
         mimeType: params.media.mimeType,
         fileName: params.media.fileName,
         hasPayload: !!(params.media.path || params.media.mediaBase64),
+        hintedType: params.hintedType,
       }),
       mimeType: params.media.mimeType || '',
       msg: params.mediaMsg,

package/src/messaging/outbound/send.ts

@@ -37,6 +37,8 @@ export async function sendBncrMedia(params: {
   to: string;
   text?: string;
   mediaUrl?: string;
+  asVoice?: boolean;
+  audioAsVoice?: boolean;
   mediaLocalRoots?: readonly string[];
   resolveVerifiedTarget: (to: string, accountId: string) => { sessionKey: string; route: any; displayScope: string };
   rememberSessionRoute: (sessionKey: string, accountId: string, route: any) => void;
@@ -44,7 +46,7 @@ export async function sendBncrMedia(params: {
     accountId: string;
     sessionKey: string;
     route: any;
-    payload: { text?: string; mediaUrl?: string; mediaUrls?: string[] };
+    payload: { text?: string; mediaUrl?: string; mediaUrls?: string[]; asVoice?: boolean; audioAsVoice?: boolean };
     mediaLocalRoots?: readonly string[];
   }) => Promise<void>;
   createMessageId: () => string;
@@ -59,6 +61,8 @@ export async function sendBncrMedia(params: {
     payload: {
       text: params.text || '',
       mediaUrl: params.mediaUrl || '',
+      asVoice: params.asVoice === true ? true : undefined,
+      audioAsVoice: params.audioAsVoice === true ? true : undefined,
     },
     mediaLocalRoots: params.mediaLocalRoots,
   });