@xmoxmo/bncr 0.5.6 → 0.5.8

package/src/openclaw/routing-runtime.ts

@@ -1,4 +1,3 @@
-import { buildChannelOutboundSessionRoute } from 'openclaw/plugin-sdk/core';
 import { resolveInboundLastRouteSessionKey } from 'openclaw/plugin-sdk/routing';
 import type { BncrChannelConfigRoot } from '../plugin/channel-runtime-types.ts';
 import type {
@@ -17,10 +16,6 @@ type OpenClawRoutingApi = {
   }) => OpenClawResolvedAgentRoute;
 };
 
-type BuildChannelOutboundSessionRouteParams = Parameters<
-  typeof buildChannelOutboundSessionRoute
->[0];
-
 function resolveRoutingApi(api: OpenClawChannelRuntimeApiHolder): OpenClawRoutingApi {
   const routing = api?.runtime?.channel?.routing;
   if (!routing || typeof routing !== 'object') {
@@ -56,9 +51,3 @@ export function resolveOpenClawInboundLastRouteSessionKey(params: {
     },
   );
 }
-
-export function buildOpenClawChannelOutboundSessionRoute(
-  params: BuildChannelOutboundSessionRouteParams,
-) {
-  return buildChannelOutboundSessionRoute(params);
-}

package/src/openclaw/sdk-helpers.ts

@@ -1,4 +1,3 @@
-import { readBooleanParam as sdkReadBooleanParam } from 'openclaw/plugin-sdk/boolean-param';
 import {
   applyAccountNameToChannelSection as sdkApplyAccountNameToChannelSection,
   jsonResult as sdkJsonResult,
@@ -15,7 +14,6 @@ import { extractToolSend as sdkExtractToolSend } from 'openclaw/plugin-sdk/tool-
 
 export type OpenClawChannelToolSend = ChannelToolSend;
 
-export const readOpenClawBooleanParam = sdkReadBooleanParam;
 export const readOpenClawStringParam = sdkReadStringParam;
 export const readOpenClawJsonFileWithFallback = sdkReadJsonFileWithFallback;
 export const writeOpenClawJsonFileAtomically = sdkWriteJsonFileAtomically;

package/src/plugin/bridge-media-facade.ts

@@ -2,7 +2,6 @@ import type { BncrRoute, FileSendTransferState } from '../core/types.ts';
 import type {
   NormalizedReplyPayload,
   OutboundReplyTargetPolicy,
-  ReplyMediaEntriesParams,
   ReplyPayloadInput,
 } from '../messaging/outbound/reply-enqueue.ts';
 import type { OpenClawLoadedMedia } from '../openclaw/media-runtime.ts';
@@ -61,7 +60,6 @@ export function createBncrBridgeMediaFacade(runtime: {
       mediaLocalRoots?: readonly string[];
       replyTargetPolicy?: OutboundReplyTargetPolicy;
     }) => void;
-    enqueueReplyMediaEntries: (params: ReplyMediaEntriesParams) => void;
   };
   logInfoJson: (
     scope: string | undefined,
@@ -161,7 +159,6 @@ export function createBncrBridgeMediaFacade(runtime: {
   const loadOutboundTransferMedia = async (params: {
     mediaUrl: string;
     mediaLocalRoots?: readonly string[];
-    downloadMedia?: boolean;
   }): Promise<{
     loaded: OpenClawLoadedMedia;
     size: number;
@@ -211,7 +208,6 @@ export function createBncrBridgeMediaFacade(runtime: {
     waitCompleteAck: runtime.fileTransferOrchestrator.waitCompleteAck,
     transferMediaToBncrClient: runtime.fileTransferOrchestrator.transferMediaToBncrClient,
     enqueueFromReply: runtime.replyMediaOrchestrator.enqueueFromReply,
-    enqueueReplyMediaEntries: runtime.replyMediaOrchestrator.enqueueReplyMediaEntries,
     logEnqueueFromReply,
     logFileChunkDiag: runtime.fileTransferLogs.logFileChunkDiag,
     logFileTransferStart: runtime.fileTransferLogs.logFileTransferStart,

package/src/plugin/bridge-outbox-facade.ts

@@ -126,7 +126,6 @@ export function createBncrBridgeOutboxFacade(runtime: {
       ),
       { debugOnly: true },
     );
-    runtime.logOutboundSummary(entry);
     const accountId = runtime.normalizeAccountId(entry.accountId);
     runtime.incrementCounter(runtime.outboundEnqueueCountByAccount, accountId);
     runtime.lastOutboundEnqueueAtByAccount.set(accountId, runtime.now());

package/src/plugin/channel-components.ts

@@ -11,7 +11,6 @@ import { OUTBOUND_FLUSH_REASON, OUTBOUND_FLUSH_TRIGGER } from '../messaging/outb
 import type { ReplyPayloadInput } from '../messaging/outbound/reply-enqueue.ts';
 import { getOpenClawRuntimeConfig } from '../openclaw/config-runtime.ts';
 import { saveOpenClawChannelMediaBuffer } from '../openclaw/media-runtime.ts';
-import { createBncrChannelSendRuntime } from './channel-send.ts';
 import { createBncrConnectionHandlers } from './connection-handlers.ts';
 import { createBncrDiagnosticsHandlers } from './diagnostics-handlers.ts';
 import { createBncrFileInboundHandlers } from './file-inbound-handlers.ts';
@@ -23,12 +22,6 @@ export function createBncrConnectionHandlersComponent(
   return createBncrConnectionHandlers(runtime);
 }
 
-export function createBncrDiagnosticsHandlersComponent(
-  runtime: Parameters<typeof createBncrDiagnosticsHandlers>[0],
-) {
-  return createBncrDiagnosticsHandlers(runtime);
-}
-
 export function createBncrBridgeDiagnosticsHandlersComponent(runtime: {
   getApi: () => OpenClawPluginApi;
   channelId: string;
@@ -312,12 +305,6 @@ export function createBncrInboundHandlersComponent(runtime: {
   });
 }
 
-export function createBncrChannelSendRuntimeComponent(
-  runtime: Parameters<typeof createBncrChannelSendRuntime>[0],
-) {
-  return createBncrChannelSendRuntime(runtime);
-}
-
 export function resolveBncrChannelRoot(pluginRoot: string) {
   return pluginRoot || path.join(process.cwd(), 'plugins', 'bncr');
 }

package/src/plugin/channel-plugin-surface-group.ts

@@ -1,15 +1,14 @@
-import { randomUUID } from 'node:crypto';
 import type { ChannelMessageSendResult } from 'openclaw/plugin-sdk/channel-message';
-import { listAccountIds, resolveAccount } from '../core/accounts.ts';
+import { listAccountIds, normalizeAccountId, resolveAccount } from '../core/accounts.ts';
 import { BncrConfigSchema } from '../core/config-schema.ts';
 import { resolveBncrChannelPolicy } from '../core/policy.ts';
 import type { ReplyPayloadInput } from '../messaging/outbound/reply-enqueue.ts';
 import type { OutboundReplyTargetPolicy } from '../messaging/outbound/reply-target-policy.ts';
-import { sendBncrMedia, sendBncrText } from '../messaging/outbound/send.ts';
-import { normalizeBncrSendParams } from '../messaging/outbound/send-params.ts';
 import type { OpenClawChannelToolSend, openClawJsonResult } from '../openclaw/sdk-helpers.ts';
+import { readOpenClawStringParam } from '../openclaw/sdk-helpers.ts';
 import type {
   BncrChannelConfigRoot,
+  BncrChannelSendContext,
   BncrSceneRecord,
   BncrStatusRuntimeSnapshot,
   BncrVerifiedTarget,
@@ -139,71 +138,59 @@ export function createBncrChannelPluginSurfaceGroup(runtime: {
       if (action !== 'send') {
         throw new Error(`Action ${action} is not supported for provider ${runtime.channelId}.`);
       }
-      const normalized = normalizeBncrSendParams({ params, accountId: accountId || '' });
-      console.log(
-        '[bncr] handleAction normalized.downloadMedia=' +
-          JSON.stringify(normalized.downloadMedia) +
-          '|mediaUrl=' +
-          JSON.stringify(normalized.mediaUrl) +
-          '|hasMedia=' +
-          Boolean(normalized.mediaUrl || normalized.mediaUrls?.length),
+
+      /* -- extract raw params (no normalization) ----------------------- */
+      const paramsObj = (params && typeof params === 'object' ? params : {}) as Record<
+        string,
+        unknown
+      >;
+      const to = readOpenClawStringParam(paramsObj, 'to', { required: true });
+      const resolvedAccountId = normalizeAccountId(
+        (readOpenClawStringParam(paramsObj, 'accountId') ?? accountId) || '',
       );
+      const toolMediaUrl =
+        (typeof paramsObj.mediaUrl === 'string' ? paramsObj.mediaUrl : '') ||
+        (typeof paramsObj.media === 'string' ? paramsObj.media : '') ||
+        (typeof paramsObj.path === 'string' ? paramsObj.path : '') ||
+        (typeof paramsObj.filePath === 'string' ? paramsObj.filePath : '');
+      const rawExtra = paramsObj.extra;
+      const extra =
+        rawExtra && typeof rawExtra === 'object' && !Array.isArray(rawExtra)
+          ? (rawExtra as Record<string, unknown>)
+          : undefined;
+      const rawMediaUrls = paramsObj.mediaUrls;
+      const mediaUrls = Array.isArray(rawMediaUrls)
+        ? rawMediaUrls.filter((u): u is string => typeof u === 'string')
+        : undefined;
+
+      const toolMessage = readOpenClawStringParam(paramsObj, 'message', { allowEmpty: true }) ?? '';
+      const toolCaption = readOpenClawStringParam(paramsObj, 'caption', { allowEmpty: true }) ?? '';
+      const text = toolCaption || toolMessage || '';
+      const ctx: BncrChannelSendContext = {
+        to,
+        accountId: resolvedAccountId,
+        text,
+        mediaUrl: toolMediaUrl || undefined,
+        mediaUrls: mediaUrls?.length ? mediaUrls : undefined,
+        asVoice: paramsObj.asVoice === true,
+        audioAsVoice: paramsObj.audioAsVoice === true,
+        downloadMedia: paramsObj.downloadMedia as boolean | undefined,
+        type: typeof paramsObj.type === 'string' ? paramsObj.type : undefined,
+        extra,
+        forceDocument: paramsObj.forceDocument === true,
+        gifPlayback: paramsObj.gifPlayback === true,
+        silent: paramsObj.silent === true,
+        mediaLocalRoots,
+      };
 
-      // Priority: marker → scene config → global default → false
-      if (normalized.downloadMedia === undefined) {
-        const parts = normalized.to.split(':');
-        if (parts.length >= 3) {
-          const sceneKey = `${parts[1]}:${parts[2]}`;
-          const scene = runtime.sceneRegistry.get(sceneKey);
-          if (scene?.downloadMedia === true) {
-            normalized.downloadMedia = true;
-          }
-          if (normalized.downloadMedia === undefined) {
-            const globalScene = runtime.sceneRegistry.get('__global__');
-            if (globalScene?.downloadMedia === true) {
-              normalized.downloadMedia = true;
-            }
-          }
-        }
+      const hasContent = Boolean(text?.trim() || toolMediaUrl || mediaUrls?.length || extra);
+      if (!hasContent) {
+        throw new Error('send requires message, media, or extra params');
       }
 
-      const toolActionBridge = runtime.getToolActionBridge();
-      const result =
-        normalized.mediaUrl || normalized.mediaUrls?.length
-          ? await sendBncrMedia({
-              channelId: runtime.channelId,
-              accountId: normalized.accountId,
-              to: normalized.to,
-              text: normalized.caption,
-              mediaUrl: normalized.mediaUrl,
-              mediaUrls: normalized.mediaUrls,
-              asVoice: normalized.asVoice,
-              audioAsVoice: normalized.audioAsVoice,
-              type: normalized.type,
-              downloadMedia: normalized.downloadMedia,
-              extra: normalized.extra,
-              mediaLocalRoots,
-              resolveVerifiedTarget: (to, accountId) =>
-                toolActionBridge.resolveVerifiedTarget(to, accountId),
-              rememberSessionRoute: (sessionKey, accountId, route) =>
-                toolActionBridge.rememberSessionRoute(sessionKey, accountId, route),
-              enqueueFromReply: (args) => toolActionBridge.enqueueFromReply(args),
-              createMessageId: () => randomUUID(),
-            })
-          : await sendBncrText({
-              channelId: runtime.channelId,
-              accountId: normalized.accountId,
-              to: normalized.to,
-              text: normalized.message,
-              extra: normalized.extra,
-              mediaLocalRoots,
-              resolveVerifiedTarget: (to, accountId) =>
-                toolActionBridge.resolveVerifiedTarget(to, accountId),
-              rememberSessionRoute: (sessionKey, accountId, route) =>
-                toolActionBridge.rememberSessionRoute(sessionKey, accountId, route),
-              enqueueFromReply: (args) => toolActionBridge.enqueueFromReply(args),
-              createMessageId: () => randomUUID(),
-            });
+      /* -- bridge to sendDispatch (normalization + routing inside) ----- */
+      const outboundBridge = runtime.getOutboundBridge();
+      const result = await outboundBridge.channelSendText(ctx);
 
       return runtime.openClawJsonResult({ ok: true, ...result });
     },

package/src/plugin/channel-runtime-builders-delivery.ts

@@ -1,18 +1,8 @@
 import type { GatewayRequestHandlerOptions } from 'openclaw/plugin-sdk/core';
-import type { RegisterDriftSnapshot } from '../core/register-trace.ts';
-import type { normalizeStoredSessionKey as normalizeStoredSessionKeyFromRuntime } from '../core/targets.ts';
-import type {
-  BncrConnection,
-  BncrRoute,
-  FileSendTransferState,
-  OutboxEntry,
-} from '../core/types.ts';
+import type { BncrRoute, OutboxEntry } from '../core/types.ts';
 import type { BncrGroupHistoryMap } from '../messaging/inbound/group-history.ts';
 import type { parseBncrInboundParams } from '../messaging/inbound/parse.ts';
-import type {
-  NormalizedReplyPayload,
-  ReplyPayloadInput,
-} from '../messaging/outbound/reply-enqueue.ts';
+import type { ReplyPayloadInput } from '../messaging/outbound/reply-enqueue.ts';
 import type { OutboundReplyTargetPolicy } from '../messaging/outbound/reply-target-policy.ts';
 import type { createBncrInboundHandlersComponent } from './channel-components.ts';
 import type {
@@ -26,14 +16,7 @@ import type {
 } from './channel-runtime-types.ts';
 import type { LeaseEventPayload } from './connection-handlers.ts';
 import type { BncrActiveConnectionDebugEntry } from './connection-state.ts';
-import type { FileAckPayloadState, FileAckWaiter } from './file-ack-runtime.ts';
 import type { createBncrFileInboundHandlers } from './file-inbound-handlers.ts';
-import type { BncrFileTransferOrchestratorRuntime } from './file-transfer-orchestrator.ts';
-import type { BncrFileTransferRouteDiagnostics } from './file-transfer-setup.ts';
-import type { MessageAckWaiter } from './message-ack-runtime.ts';
-
-type StoredRouteRecord = { accountId: string; route: BncrRoute; updatedAt: number };
-type StoredLastSessionRecord = { sessionKey: string; scope: string; updatedAt: number };
 
 // Delivery-side wiring catalog.
 //
@@ -42,349 +25,6 @@ type StoredLastSessionRecord = { sessionKey: string; scope: string; updatedAt: n
 // 2) outbound + file-transfer state machines
 // 3) inbound/public send surfaces
 
-export function buildBncrConnectionStateRuntime(deps: {
-  bridgeId: string;
-  now: () => number;
-  asString: (value: unknown, fallback?: string) => string;
-  connectTtlMs: number;
-  recentInboundSendWindowMs: number;
-  outboundReadyTtlMs: number;
-  preferredOutboundTtlMs: number;
-  connections: Map<string, BncrConnection>;
-  activeConnectionByAccount: Map<string, string>;
-  lastInboundByAccount: Map<string, number>;
-  lastActivityByAccount: Map<string, number>;
-  gcTransientState: () => void;
-  connectionKey: (accountId: string, clientId?: string) => string;
-  buildActiveConnectionDebugList: (
-    accountId: string,
-    options?: { includeOutboundState?: boolean },
-  ) => BncrActiveConnectionDebugEntry[];
-  rememberGatewayContext: (context: GatewayRequestHandlerOptions['context']) => void;
-  markActivity: (accountId: string, at?: number) => void;
-  logInfo: (scope: string, message: string, options?: { debugOnly?: boolean }) => void;
-  logInfoDedupJson: (
-    scope: string,
-    label: string,
-    payload: unknown,
-    options?: { key?: string; sig?: string; debugOnly?: boolean },
-  ) => void;
-}) {
-  return { ...deps };
-}
-
-export function buildBncrFileTransferRuntime(deps: {
-  bridgeId: string;
-  now: () => number;
-  asString: (value: unknown, fallback?: string) => string;
-  clampFiniteNumber: (value: unknown, fallback: number, min?: number, max?: number) => number;
-  fileAckTimeoutMs: number;
-  maxEarlyFileAcks: number;
-  fileAckWaiters: Map<string, FileAckWaiter>;
-  earlyFileAcks: Map<string, FileAckPayloadState>;
-  getFileAckOwnerInfo: (transferId: string) => Record<string, unknown>;
-  fileForceChunk: boolean;
-  fileInlineThreshold: number;
-  normalizeAccountId: (accountId: string) => string;
-  loadOutboundTransferMedia: (args: {
-    mediaUrl: string;
-    mediaLocalRoots?: readonly string[];
-  }) => Promise<{ loaded: { buffer: Buffer }; size: number; mimeType?: string; fileName: string }>;
-  resolveOutboxPushOwner: (accountId: string) => { connId?: string; clientId?: string } | null;
-  hasRecentInboundReachability: (accountId: string) => boolean;
-  buildTransferRouteDiagnostics: (args: {
-    accountId: string;
-    recentInboundReachable: boolean;
-  }) => BncrFileTransferRouteDiagnostics;
-  selectTransferConnIds: (args: {
-    directConnIds: Set<string>;
-    recentConnIds: Set<string>;
-    recentInboundReachable: boolean;
-  }) => Set<string>;
-  broadcastToConnIds: (event: string, payload: unknown, connIds: ReadonlySet<string>) => void;
-  chunkEvent: string;
-  completeEvent: string;
-  logInfo: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-  logWarn: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-}) {
-  return { ...deps };
-}
-
-export function buildBncrStateTransientRuntime(deps: {
-  bridgeId: string;
-  getStatePath: () => string | null;
-  now: () => number;
-  asString: (value: unknown, fallback?: string) => string;
-  finiteNumberOr: (value: unknown, fallback: number) => number;
-  normalizeAccountId: (accountId: string) => string;
-  normalizeStoredSessionKey: typeof normalizeStoredSessionKeyFromRuntime;
-  parseRouteLike: (value: unknown) => BncrRoute | null;
-  routeKey: (accountId: string, route: BncrRoute) => string;
-  formatDisplayScope: (route: BncrRoute) => string;
-  canonicalAgentId: () => string;
-  normalizePersistedOutboxEntry: (entry: unknown) => OutboxEntry | null;
-  maxDeadLetterEntries: number;
-  maxSessionRouteEntries: number;
-  maxAccountActivityEntries: number;
-  sceneRegistry: Map<string, BncrSceneRecord>;
-  groupHistories: Map<
-    string,
-    import('./channel-runtime-types.ts').BncrPersistedGroupHistoryEntry[]
-  >;
-  outbox: Map<string, OutboxEntry>;
-  getDeadLetter: () => OutboxEntry[];
-  setDeadLetter: (entries: OutboxEntry[]) => void;
-  sessionRoutes: Map<string, StoredRouteRecord>;
-  routeAliases: Map<string, StoredRouteRecord>;
-  lastSessionByAccount: Map<string, StoredLastSessionRecord>;
-  lastActivityByAccount: Map<string, number>;
-  lastInboundByAccount: Map<string, number>;
-  lastOutboundByAccount: Map<string, number>;
-  getLastDriftSnapshot: () => RegisterDriftSnapshot | null;
-  setLastDriftSnapshot: (value: RegisterDriftSnapshot | null) => void;
-  connectTtlMs: number;
-  fileTransferKeepMs: number;
-  fileTransferTerminalKeepMs: number;
-  fileTransferAckTtlMs: number;
-  connections: Map<string, BncrConnection>;
-  activeConnectionByAccount: Map<string, string>;
-  recentInbound: Map<string, number>;
-  fileSendTransfers: Map<string, { status: string; startedAt: number; terminalAt?: number }>;
-  fileRecvTransfers: Map<string, { status: string; startedAt: number; terminalAt?: number }>;
-  earlyFileAcks: Map<string, { at: number }>;
-  logInfo: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-}) {
-  return { ...deps };
-}
-
-export function buildBncrAckOutboxRuntime(deps: {
-  bridgeId: string;
-  pushEvent: string;
-  now: () => number;
-  asString: (value: unknown, fallback?: string) => string;
-  backoffMs: (retryCount: number) => number;
-  isPlainObject: (value: unknown) => value is Record<string, unknown>;
-  clampFiniteNumber: (value: unknown, fallback: number, min?: number, max?: number) => number;
-  normalizeAccountId: (accountId: string) => string;
-  formatDisplayScope: (route: BncrRoute) => string;
-  isFileTransferEntry: (entry: OutboxEntry) => boolean;
-  recommendedAckTimeoutMaxMs: number;
-  adaptiveAckTimeoutEnabled: boolean;
-  defaultAckTimeoutMs: number;
-  stopped: () => boolean;
-  outbox: Map<string, OutboxEntry>;
-  deadLetter: () => OutboxEntry[];
-  connectionsValues: () => IterableIterator<BncrConnection>;
-  gatewayContextAvailable: () => boolean;
-  messageAckWaiters: Map<string, MessageAckWaiter>;
-  fileAckWaiterCount: () => number;
-  activeConnectionCount: (accountId: string) => number;
-  getAccountPendingOutboxEntries: (accountId: string) => OutboxEntry[];
-  pushDrainRunningAccounts: Set<string>;
-  pushDrainRunningSinceByAccount: Map<string, number>;
-  pushDrainStuckWarnedAtByAccount: Map<string, number>;
-  isOnline: (accountId: string) => boolean;
-  hasRecentInboundReachability: (accountId: string) => boolean;
-  isOutboundAckRequired: (accountId?: string) => boolean;
-  resolveMessageAckTimeoutMs: (accountId: string) => number;
-  waitForMessageAck: (messageId: string, waitMs: number) => Promise<'acked' | 'timeout'>;
-  resolvePushConnIds: (accountId: string) => Iterable<string>;
-  sleepMs: (ms: number) => Promise<void>;
-  schedulePushDrain: (delayMs: number) => void;
-  tryPushEntry: (entry: OutboxEntry) => Promise<boolean>;
-  handleFileTransferPushFailure: (args: { entry: OutboxEntry; error: unknown }) => void;
-  handleTextPushFailure: (args: { entry: OutboxEntry; error: unknown }) => void;
-  isPrePushGuardDeferral: (entry: OutboxEntry) => boolean;
-  scheduleSave: () => void;
-  logInfo: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-  logWarn: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-  logError: (scope: string, message: string) => void;
-  observeLease: (
-    kind:
-      | 'connect'
-      | 'inbound'
-      | 'activity'
-      | 'ack'
-      | 'file.init'
-      | 'file.chunk'
-      | 'file.complete'
-      | 'file.abort',
-    payload: Record<string, unknown>,
-  ) => { stale: boolean };
-  rememberGatewayContext: (context: GatewayRequestHandlerOptions['context']) => void;
-  markSeen: (accountId: string, connId: string, clientId?: string) => void;
-  markOutboundCapability: (args: {
-    accountId: string;
-    connId: string;
-    clientId?: string;
-    outboundReady: boolean;
-    preferredForOutbound: boolean;
-  }) => void;
-  recordAckOkTelemetry: (args: {
-    accountId: string;
-    entry: OutboxEntry;
-    telemetryPatch: { queueLatencyMs?: number; pushLatencyMs?: number; lateAfterTimeout?: boolean };
-  }) => void;
-  deleteOutboxEntry: (messageId: string) => void;
-  setOutboxEntry: (messageId: string, entry: OutboxEntry) => void;
-  resolveMessageAck: (messageId: string, result: 'acked' | 'timeout') => boolean;
-  moveToDeadLetter: (entry: OutboxEntry, reason: string) => void;
-  recordAckTimeoutTelemetry: (accountId: string) => void;
-  degradeOutboundCapability: (args: {
-    accountId: string;
-    connId?: string;
-    clientId?: string;
-    reason: string;
-  }) => void;
-  flushPushQueueBestEffort: (args?: {
-    accountId?: string;
-    trigger?: string;
-    reason?: string;
-  }) => void;
-  flushTriggerTimer: string;
-  flushReasonScheduledDrain: string;
-  outboundFlushTriggerAckOk: string;
-  outboundFlushReasonMessageAcked: string;
-  pushDrainExceptionRetryLimit: number;
-  pushDrainExceptionRetryDelayMs: number;
-  pushDrainStuckWarnMs: number;
-  pushDrainIntervalMs: number;
-  pushDrainAccountTimeBudgetMs: number;
-  pushDrainAccountBudget: number;
-  pushAckTimeoutMs: number;
-  maxRetry: number;
-  prePushGuardRetryDelayMs: number;
-}) {
-  return { ...deps };
-}
-
-export function buildBncrOutboxPushRouteRuntime(deps: {
-  bridgeId: string;
-  pushEvent: string;
-  now: () => number;
-  connectTtlMs: number;
-  finiteNumberOr: (value: unknown, fallback: number) => number;
-  outboxSize: () => number;
-  gatewayBroadcastToConnIds: (
-    event: string,
-    payload: unknown,
-    connIds: ReadonlySet<string>,
-  ) => void;
-  recordOutboxPushSuccess: (args: {
-    entry: OutboxEntry;
-    connIds: Iterable<string>;
-    ownerConnId?: string;
-    ownerClientId?: string;
-    clearLastError?: boolean;
-  }) => void;
-  recordOutboxPushFailure: (args: {
-    entry: OutboxEntry;
-    error: unknown;
-    fallbackError: string;
-    persist?: boolean;
-  }) => void;
-  recordOutboxPrePushFailure: (args: {
-    entry: OutboxEntry;
-    lastError: string;
-    persist?: boolean;
-  }) => void;
-  recordPrePushGuardSkip: (args: { accountId: string; reason: string }) => void;
-  moveToDeadLetter: (entry: OutboxEntry, reason: string) => void;
-  activeConnectionCount: (accountId: string) => number;
-  connections: Map<string, BncrConnection>;
-  connectionsValues: () => Iterable<BncrConnection>;
-  activeConnectionByAccount: Map<string, string>;
-  resolveRecentInboundConnIds: (accountId: string) => Set<string>;
-  connectionKey: (accountId: string, clientId?: string) => string;
-  isRetryableFileTransferError: (value: unknown) => boolean;
-  logInfo: (scope: string, message: string, options?: { debugOnly?: boolean }) => void;
-  buildActiveConnectionDebugList: (
-    accountId: string,
-    options?: { includeOutboundState?: boolean },
-  ) => BncrActiveConnectionDebugEntry[];
-}) {
-  return { ...deps };
-}
-
-export function buildBncrMediaOrchestratorsRuntime(deps: {
-  now: () => number;
-  asString: (value: unknown, fallback?: string) => string;
-  fileSendTransfers: Map<string, FileSendTransferState>;
-  getGatewayContext: () => GatewayRequestHandlerOptions['context'] | null;
-  fileInitEvent: string;
-  fileAbortEvent: string;
-  prepareOutboundTransfer: BncrFileTransferOrchestratorRuntime['prepareOutboundTransfer'];
-  sendChunk: BncrFileTransferOrchestratorRuntime['sendChunk'];
-  sendComplete: BncrFileTransferOrchestratorRuntime['sendComplete'];
-  waitForFileAck: BncrFileTransferOrchestratorRuntime['waitForFileAck'];
-  logFileTransferChunkAck: BncrFileTransferOrchestratorRuntime['logFileTransferChunkAck'];
-  logFileTransferChunkAckFail: BncrFileTransferOrchestratorRuntime['logFileTransferChunkAckFail'];
-  logFileTransferCompleteAck: BncrFileTransferOrchestratorRuntime['logFileTransferCompleteAck'];
-  logInfo: (scope: string | undefined, message: string, options?: { debugOnly?: boolean }) => void;
-  logEnqueueFromReply: (args: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    payload: NormalizedReplyPayload;
-  }) => void;
-  enqueueOutbound: (entry: OutboxEntry) => void;
-  buildTextOutboxEntry: (args: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    text: string;
-    extra?: Record<string, unknown>;
-    kind?: 'tool' | 'block' | 'final';
-    replyToId?: string;
-    replyTargetPolicy?: OutboundReplyTargetPolicy;
-  }) => OutboxEntry;
-  buildFileTransferOutboxEntry: (args: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    mediaUrl: string;
-    mediaLocalRoots?: readonly string[];
-    text: string;
-    asVoice: boolean;
-    audioAsVoice: boolean;
-    type?: string;
-    extra?: Record<string, unknown>;
-    kind?: 'tool' | 'block' | 'final';
-    replyToId?: string;
-    replyTargetPolicy?: OutboundReplyTargetPolicy;
-    downloadMedia?: boolean;
-  }) => OutboxEntry;
-  rememberRecentMediaSend: (args: {
-    sessionKey: string;
-    mediaUrl: string;
-    text: string;
-    replyToId: string;
-    createdAt: number;
-  }) => void;
-  tryBuildMediaDedupeFallback: (args: {
-    sessionKey: string;
-    mediaUrl: string;
-    text: string;
-    replyToId: string;
-    currentTime: number;
-  }) => {
-    text: string;
-    reason: 'same-text-sent-checkmark' | 'text-changed-downgrade';
-  } | null;
-}) {
-  return {
-    ...deps,
-    getGatewayContext: () => {
-      const context = deps.getGatewayContext();
-      if (!context) return null;
-      return {
-        broadcastToConnIds: (event: string, payload: unknown, connIds: ReadonlySet<string>) =>
-          context.broadcastToConnIds(event, payload, connIds),
-      };
-    },
-  };
-}
-
 export function buildBncrInboundSurfaceRuntime(deps: {
   getApi: Parameters<typeof createBncrInboundHandlersComponent>[0]['getApi'];
   channelId: string;
@@ -535,6 +175,7 @@ export function buildBncrChannelSendRuntime(deps: {
     replyTargetPolicy?: OutboundReplyTargetPolicy;
   }) => Promise<void>;
   listOutboxEntries: () => OutboxEntry[];
+  resolveSceneDownloadMedia?: (to: string) => boolean | undefined;
 }) {
   return { ...deps };
 }