@xmoxmo/bncr 0.5.6 → 0.5.8

package/src/messaging/outbound/durable-message-adapter.ts

@@ -1,121 +0,0 @@
-import type {
-  ChannelMessageAdapterShape,
-  ChannelMessageSendMediaContext,
-  ChannelMessageSendPayloadContext,
-  ChannelMessageSendResult,
-  ChannelMessageSendTextContext,
-} from 'openclaw/plugin-sdk/channel-message';
-import { defineChannelMessageAdapter } from 'openclaw/plugin-sdk/channel-message';
-import type { OpenClawConfig } from 'openclaw/plugin-sdk/core';
-
-import {
-  buildFileTransferOutboxEntry,
-  buildTextOutboxEntry,
-} from '../../core/outbox-entry-builders.ts';
-import type { BncrRoute, OutboxEntry } from '../../core/types.ts';
-import { buildBncrDurableQueuedResult } from './durable-queue-adapter.ts';
-
-export type BncrDurableMessageQueuedAdapterDeps = {
-  enqueueText: (
-    ctx: ChannelMessageSendTextContext<OpenClawConfig>,
-  ) => Promise<OutboxEntry> | OutboxEntry;
-  enqueueMedia?: (
-    ctx: ChannelMessageSendMediaContext<OpenClawConfig>,
-  ) => Promise<OutboxEntry> | OutboxEntry;
-  enqueuePayload?: (
-    ctx: ChannelMessageSendPayloadContext<OpenClawConfig>,
-  ) => Promise<OutboxEntry> | OutboxEntry;
-  now?: () => number;
-};
-
-export type BncrDurableMessageQueuedAdapterBuilderDeps = {
-  createMessageId: () => string;
-  now: () => number;
-  normalizeAccountId: (accountId?: string | null) => string;
-  normalizeReplyToId: (value?: string | null) => string;
-  resolveTarget: (ctx: ChannelMessageSendTextContext<OpenClawConfig>) => {
-    route: BncrRoute;
-    sessionKey: string;
-    accountId?: string | null;
-  };
-  filePushEvent?: string;
-};
-
-// This adapter intentionally models only the OpenClaw -> bncr-plugin handoff.
-// Once a message is accepted into bncr's own outbox, OpenClaw should stop managing it;
-// client/platform ACK, retry, and deadLetter remain owned by the bncr service framework.
-export function createBncrDurableMessageQueuedAdapter(
-  deps: BncrDurableMessageQueuedAdapterDeps,
-): ChannelMessageAdapterShape<OpenClawConfig, ChannelMessageSendResult> {
-  return defineChannelMessageAdapter({
-    id: 'bncr-queued-outbox',
-    receive: {
-      defaultAckPolicy: 'manual',
-      supportedAckPolicies: ['manual'],
-    },
-    send: {
-      text: async (ctx) => toChannelMessageSendResult(await deps.enqueueText(ctx), deps.now),
-      media: deps.enqueueMedia
-        ? async (ctx) => toChannelMessageSendResult(await deps.enqueueMedia?.(ctx), deps.now)
-        : undefined,
-      payload: deps.enqueuePayload
-        ? async (ctx) => toChannelMessageSendResult(await deps.enqueuePayload?.(ctx), deps.now)
-        : undefined,
-    },
-  });
-}
-
-export function createBncrDurableMessageQueuedAdapterFromBuilders(
-  deps: BncrDurableMessageQueuedAdapterBuilderDeps,
-): ChannelMessageAdapterShape<OpenClawConfig, ChannelMessageSendResult> {
-  return createBncrDurableMessageQueuedAdapter({
-    now: deps.now,
-    enqueueText: (ctx) => {
-      const resolved = deps.resolveTarget(ctx);
-      return buildTextOutboxEntry({
-        createMessageId: deps.createMessageId,
-        now: deps.now,
-        normalizeAccountId: deps.normalizeAccountId,
-        normalizeReplyToId: deps.normalizeReplyToId,
-        accountId: resolved.accountId ?? ctx.accountId ?? '',
-        sessionKey: resolved.sessionKey,
-        route: resolved.route,
-        text: ctx.text,
-        kind: 'final',
-        replyToId: ctx.replyToId ?? undefined,
-      });
-    },
-    enqueueMedia: (ctx) => {
-      const resolved = deps.resolveTarget(ctx);
-      return buildFileTransferOutboxEntry({
-        createMessageId: deps.createMessageId,
-        now: deps.now,
-        normalizeAccountId: deps.normalizeAccountId,
-        pushEvent: deps.filePushEvent ?? 'bncr.file.push',
-        accountId: resolved.accountId ?? ctx.accountId ?? '',
-        sessionKey: resolved.sessionKey,
-        route: resolved.route,
-        mediaUrl: ctx.mediaUrl,
-        mediaLocalRoots: ctx.mediaLocalRoots,
-        text: ctx.text,
-        asVoice: ctx.audioAsVoice,
-        audioAsVoice: ctx.audioAsVoice,
-        kind: 'final',
-        replyToId: ctx.replyToId ?? undefined,
-      });
-    },
-  });
-}
-
-function toChannelMessageSendResult(
-  entry: OutboxEntry | undefined,
-  now?: () => number,
-): ChannelMessageSendResult {
-  if (!entry) throw new Error('bncr durable message adapter did not receive an outbox entry');
-  const queued = buildBncrDurableQueuedResult({ entry, sentAt: now?.() });
-  const receipt: ChannelMessageSendResult['receipt'] = queued.receipt;
-  return {
-    receipt,
-    messageId: queued.receipt.primaryPlatformMessageId,
-  };
-}

package/src/messaging/outbound/send-params.ts

@@ -1,114 +0,0 @@
-import { normalizeAccountId } from '../../core/accounts.ts';
-import { readOpenClawBooleanParam, readOpenClawStringParam } from '../../openclaw/sdk-helpers.ts';
-import { extractConsumptionFields, parseBncrMarker } from './marker-parser.ts';
-
-export type NormalizedBncrSendParams = {
-  to: string;
-  accountId: string;
-  message: string;
-  caption: string;
-  mediaUrl?: string;
-  mediaUrls?: string[];
-  asVoice: boolean;
-  audioAsVoice: boolean;
-  type?: string;
-  downloadMedia?: boolean;
-  extra?: Record<string, unknown>;
-};
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-export function normalizeBncrSendParams(input: {
-  params: unknown;
-  accountId: string;
-}): NormalizedBncrSendParams {
-  const paramsObj = isPlainObject(input.params) ? input.params : {};
-  const to = readOpenClawStringParam(paramsObj, 'to', { required: true });
-  const resolvedAccountId = normalizeAccountId(
-    readOpenClawStringParam(paramsObj, 'accountId') ?? input.accountId,
-  );
-
-  const rawMessage = readOpenClawStringParam(paramsObj, 'message', { allowEmpty: true }) ?? '';
-  const rawCaption = readOpenClawStringParam(paramsObj, 'caption', { allowEmpty: true }) ?? '';
-  // Parse [BncrParam:...] markers from message and caption text
-  const { cleanText: parsedMessage, params: msgMarker } = parseBncrMarker(rawMessage);
-  const { cleanText: parsedCaption, params: capMarker } = parseBncrMarker(rawCaption);
-  const message = parsedMessage;
-  const caption = parsedCaption;
-  const mediaUrl =
-    readOpenClawStringParam(paramsObj, 'media', { trim: false }) ??
-    readOpenClawStringParam(paramsObj, 'path', { trim: false }) ??
-    readOpenClawStringParam(paramsObj, 'filePath', { trim: false }) ??
-    readOpenClawStringParam(paramsObj, 'mediaUrl', { trim: false });
-  const rawMediaUrls = paramsObj.mediaUrls;
-  const mediaUrls = Array.isArray(rawMediaUrls)
-    ? Array.from(
-        new Set(rawMediaUrls.map((v) => (typeof v === 'string' ? v.trim() : '')).filter(Boolean)),
-      )
-    : undefined;
-  // 如果 mediaUrl 已经在 mediaUrls 中，去重避免重复发送
-  const dedupedMediaUrls = mediaUrls?.length
-    ? mediaUrl && mediaUrls.includes(mediaUrl)
-      ? mediaUrls
-      : mediaUrl
-        ? [mediaUrl, ...mediaUrls]
-        : mediaUrls
-    : undefined;
-  const asVoice = readOpenClawBooleanParam(paramsObj, 'asVoice') ?? false;
-  const audioAsVoice = readOpenClawBooleanParam(paramsObj, 'audioAsVoice') ?? false;
-  const type = readOpenClawStringParam(paramsObj, 'type') || undefined;
-  const rawExtra = paramsObj.extra;
-  const paramsExtra = isPlainObject(rawExtra) ? { ...rawExtra } : {};
-  // Merge marker params into extra (marker takes priority over direct extra)
-  const mergedExtra = { ...paramsExtra, ...msgMarker, ...capMarker };
-  const extra = Object.keys(mergedExtra).length > 0 ? mergedExtra : undefined;
-
-  // Extract consumption fields from merged extra - marker-specified values override params
-  const { consumed, remaining } = extractConsumptionFields(
-    Object.keys(mergedExtra).length > 0 ? mergedExtra : undefined,
-  );
-  const effectiveAsVoice = consumed.asVoice ?? asVoice;
-  const effectiveAudioAsVoice = consumed.audioAsVoice ?? audioAsVoice;
-  const effectiveDownloadMedia = consumed.downloadMedia === true;
-  const effectiveType = consumed.type ?? type;
-  const cleanedExtra = Object.keys(remaining).length > 0 ? remaining : undefined;
-
-  const hasMedia = Boolean(mediaUrl || dedupedMediaUrls?.length);
-
-  if (effectiveAsVoice && !hasMedia) throw new Error('send voice requires media path');
-
-  const normalizedMessage = hasMedia ? '' : message || caption || '';
-  const normalizedCaption = hasMedia ? caption || message || '' : '';
-
-  if (!normalizedMessage.trim() && !normalizedCaption.trim() && !hasMedia && !extra) {
-    throw new Error('send requires message, media, or extra params');
-  }
-  console.log(
-    '[bncr] normalizeBncrSendParams rawMessage=' +
-      JSON.stringify(rawMessage) +
-      '|msgMarker=' +
-      JSON.stringify(msgMarker) +
-      '|consumed=' +
-      JSON.stringify(consumed) +
-      '|effectiveDownloadMedia=' +
-      effectiveDownloadMedia +
-      '|mediaUrl=' +
-      JSON.stringify(mediaUrl),
-  );
-
-  return {
-    to,
-    accountId: resolvedAccountId,
-    message: normalizedMessage,
-    caption: normalizedCaption,
-    mediaUrl: dedupedMediaUrls?.length ? undefined : mediaUrl || undefined,
-    mediaUrls: dedupedMediaUrls,
-    asVoice: effectiveAsVoice,
-    ...(effectiveDownloadMedia ? { downloadMedia: true } : {}),
-    audioAsVoice: effectiveAudioAsVoice,
-    ...(effectiveType ? { type: effectiveType } : {}),
-    ...(cleanedExtra ? { extra: cleanedExtra } : {}),
-  };
-}

package/src/messaging/outbound/send.ts

@@ -1,127 +0,0 @@
-import type { BncrRoute } from '../../core/types.ts';
-
-function normalizeReplyKind(value: unknown): 'tool' | 'block' | 'final' | undefined {
-  return value === 'tool' || value === 'block' || value === 'final' ? value : undefined;
-}
-
-export async function sendBncrText(params: {
-  channelId: string;
-  extra?: Record<string, unknown>;
-  accountId: string;
-  to: string;
-  text: string;
-  kind?: string;
-  replyToId?: string;
-  mediaLocalRoots?: readonly string[];
-  resolveVerifiedTarget: (
-    to: string,
-    accountId: string,
-  ) => { sessionKey: string; route: BncrRoute; displayScope: string };
-  rememberSessionRoute: (sessionKey: string, accountId: string, route: BncrRoute) => void;
-  enqueueFromReply: (args: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    payload: {
-      text?: string;
-      mediaUrl?: string;
-      mediaUrls?: string[];
-      kind?: 'tool' | 'block' | 'final';
-      extra?: Record<string, unknown>;
-      replyToId?: string;
-    };
-    mediaLocalRoots?: readonly string[];
-  }) => Promise<void>;
-  createMessageId: () => string;
-}) {
-  const verified = params.resolveVerifiedTarget(params.to, params.accountId);
-  params.rememberSessionRoute(verified.sessionKey, params.accountId, verified.route);
-
-  await params.enqueueFromReply({
-    accountId: params.accountId,
-    sessionKey: verified.sessionKey,
-    route: verified.route,
-    payload: {
-      text: params.text,
-      kind: normalizeReplyKind(params.kind),
-      replyToId: params.replyToId,
-      extra: params.extra,
-    },
-    mediaLocalRoots: params.mediaLocalRoots,
-  });
-
-  return {
-    channel: params.channelId,
-    messageId: params.createMessageId(),
-    chatId: verified.sessionKey,
-  };
-}
-
-export async function sendBncrMedia(params: {
-  channelId: string;
-  accountId: string;
-  to: string;
-  text?: string;
-  mediaUrl?: string;
-  mediaUrls?: string[];
-  asVoice?: boolean;
-  audioAsVoice?: boolean;
-  type?: string;
-  downloadMedia?: boolean;
-  extra?: Record<string, unknown>;
-  kind?: string;
-  replyToId?: string;
-  mediaLocalRoots?: readonly string[];
-  resolveVerifiedTarget: (
-    to: string,
-    accountId: string,
-  ) => { sessionKey: string; route: BncrRoute; displayScope: string };
-  rememberSessionRoute: (sessionKey: string, accountId: string, route: BncrRoute) => void;
-  enqueueFromReply: (args: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    payload: {
-      text?: string;
-      mediaUrl?: string;
-      mediaUrls?: string[];
-      asVoice?: boolean;
-      audioAsVoice?: boolean;
-      type?: string;
-      downloadMedia?: boolean;
-      extra?: Record<string, unknown>;
-      kind?: 'tool' | 'block' | 'final';
-      replyToId?: string;
-    };
-    mediaLocalRoots?: readonly string[];
-  }) => Promise<void>;
-  createMessageId: () => string;
-}) {
-  const verified = params.resolveVerifiedTarget(params.to, params.accountId);
-  params.rememberSessionRoute(verified.sessionKey, params.accountId, verified.route);
-
-  await params.enqueueFromReply({
-    accountId: params.accountId,
-    sessionKey: verified.sessionKey,
-    route: verified.route,
-    payload: {
-      text: params.text || '',
-      mediaUrl: params.mediaUrl || '',
-      mediaUrls: params.mediaUrls?.length ? params.mediaUrls : undefined,
-      asVoice: params.asVoice === true ? true : undefined,
-      audioAsVoice: params.audioAsVoice === true ? true : undefined,
-      downloadMedia: params.downloadMedia === true ? true : undefined,
-      type: params.type,
-      extra: params.extra,
-      kind: normalizeReplyKind(params.kind),
-      replyToId: params.replyToId,
-    },
-    mediaLocalRoots: params.mediaLocalRoots,
-  });
-
-  return {
-    channel: params.channelId,
-    messageId: params.createMessageId(),
-    chatId: verified.sessionKey,
-  };
-}

package/src/openclaw/ingress-runtime.ts

@@ -1,25 +0,0 @@
-import {
-  defineStableChannelIngressIdentity as sdkDefineStableChannelIngressIdentity,
-  resolveChannelMessageIngress as sdkResolveChannelMessageIngress,
-} from 'openclaw/plugin-sdk/channel-ingress-runtime';
-
-type StableChannelIngressIdentityParams = Parameters<
-  typeof sdkDefineStableChannelIngressIdentity
->[0];
-
-type ResolveChannelMessageIngressParams = Parameters<typeof sdkResolveChannelMessageIngress>[0];
-type ResolveChannelMessageIngressResult = Awaited<
-  ReturnType<typeof sdkResolveChannelMessageIngress>
->;
-
-export function defineOpenClawStableChannelIngressIdentity(
-  params: StableChannelIngressIdentityParams,
-) {
-  return sdkDefineStableChannelIngressIdentity(params);
-}
-
-export async function resolveOpenClawChannelMessageIngress(
-  params: ResolveChannelMessageIngressParams,
-): Promise<ResolveChannelMessageIngressResult> {
-  return sdkResolveChannelMessageIngress(params);
-}

package/src/plugin/bridge-file-transfer-push-facade.ts

@@ -1,142 +0,0 @@
-import {
-  buildFileTransferPushOkArgs,
-  buildFileTransferPushSuccessArgs,
-} from '../core/outbox-file-transfer-bookkeeping.ts';
-import {
-  buildFileTransferBroadcastPayload,
-  buildFileTransferRouteSelectArgs,
-} from '../core/outbox-file-transfer-success.ts';
-import type { BncrConnection, BncrRoute, OutboxEntry } from '../core/types.ts';
-
-export function createBncrBridgeFileTransferPushFacade(runtime: {
-  pushEvent: string;
-  getGatewayContext: () => {
-    broadcastToConnIds: (event: string, payload: unknown, connIds: ReadonlySet<string>) => void;
-  } | null;
-  transferMediaToBncrClient: (params: {
-    accountId: string;
-    sessionKey: string;
-    route: BncrRoute;
-    mediaUrl: string;
-    mediaLocalRoots?: readonly string[];
-    downloadMedia?: boolean;
-  }) => Promise<{
-    mode: 'base64' | 'chunk';
-    mimeType?: string;
-    fileName?: string;
-    base64?: string;
-    path?: string;
-  }>;
-  buildFileTransferOutboundFrame: (params: {
-    entry: OutboxEntry;
-    meta: Record<string, unknown>;
-    media: { fileName?: string; mimeType?: string; path?: string; base64?: string; type?: string };
-    mediaUrl: string;
-  }) => Record<string, unknown>;
-  logOutboxRouteSelect: (args: {
-    messageId: string;
-    accountId: string;
-    kind?: 'file-transfer';
-    routeReason: string;
-    connIds: Iterable<string>;
-    ownerConnId: string;
-    ownerClientId: string;
-    recentInboundReachable: boolean;
-    event: string;
-  }) => void;
-  recordOutboxPushSuccess: (args: {
-    entry: OutboxEntry;
-    connIds: Iterable<string>;
-    ownerConnId?: string;
-    ownerClientId?: string;
-    clearLastError?: boolean;
-  }) => void;
-  logOutboxPushOkSummary: (messageId: string) => void;
-  logOutboxPushOk: (args: {
-    messageId: string;
-    accountId: string;
-    kind?: 'file-transfer';
-    connIds: Iterable<string>;
-    ownerConnId: string;
-    ownerClientId: string;
-    recentInboundReachable: boolean;
-    event: string;
-  }) => void;
-  handleFileTransferPushFailure: (args: { entry: OutboxEntry; error: unknown }) => void;
-  handleFileTransferPushGuardFailure: (args: {
-    entry: OutboxEntry;
-    guard: {
-      reason: 'media-url-missing' | 'no-gateway-context' | 'no-active-connection';
-      lastError: string;
-      recentInboundReachable?: boolean;
-    };
-  }) => void;
-}) {
-  const pushFileTransferSuccessPath = async (args: {
-    entry: OutboxEntry;
-    meta: Record<string, unknown>;
-    owner: BncrConnection | null;
-    connIds: Iterable<string>;
-    recentInboundReachable: boolean;
-    routeReason: string;
-    mediaUrl: string;
-  }): Promise<void> => {
-    const media = await runtime.transferMediaToBncrClient({
-      accountId: args.entry.accountId,
-      sessionKey: args.entry.sessionKey,
-      route: args.entry.route,
-      mediaUrl: args.mediaUrl,
-      mediaLocalRoots: Array.isArray(args.meta.mediaLocalRoots)
-        ? args.meta.mediaLocalRoots.filter((v): v is string => typeof v === 'string')
-        : undefined,
-      downloadMedia: args.meta.downloadMedia === true,
-    });
-    const frame = runtime.buildFileTransferOutboundFrame({
-      entry: args.entry,
-      meta: args.meta,
-      media,
-      mediaUrl: args.mediaUrl,
-    });
-
-    runtime.getGatewayContext()!.broadcastToConnIds(
-      runtime.pushEvent,
-      buildFileTransferBroadcastPayload({
-        frame,
-        messageId: args.entry.messageId,
-      }),
-      new Set(args.connIds),
-    );
-    runtime.logOutboxRouteSelect(
-      buildFileTransferRouteSelectArgs({
-        entry: args.entry,
-        connIds: args.connIds,
-        routeReason: args.routeReason,
-        recentInboundReachable: args.recentInboundReachable,
-        owner: args.owner,
-        event: runtime.pushEvent,
-      }),
-    );
-    runtime.recordOutboxPushSuccess(
-      buildFileTransferPushSuccessArgs({
-        entry: args.entry,
-        connIds: args.connIds,
-        owner: args.owner,
-      }),
-    );
-    runtime.logOutboxPushOkSummary(args.entry.messageId);
-    runtime.logOutboxPushOk(
-      buildFileTransferPushOkArgs({
-        entry: args.entry,
-        connIds: args.connIds,
-        recentInboundReachable: args.recentInboundReachable,
-        event: runtime.pushEvent,
-      }),
-    );
-  };
-
-  return {
-    pushFileTransferSuccessPath,
-    handleFileTransferPushFailure: runtime.handleFileTransferPushFailure,
-    handleFileTransferPushGuardFailure: runtime.handleFileTransferPushGuardFailure,
-  };
-}

package/src/plugin/channel-send-runtime-group.ts

@@ -1,37 +0,0 @@
-import type { BncrRoute } from '../core/types.ts';
-import { createBncrChannelSendRuntimeComponent } from './channel-components.ts';
-
-export function createBncrChannelSendRuntimeGroup(runtime: {
-  channelId: string;
-  asString: (value: unknown, fallback?: string) => string;
-  syncDebugFlag: () => Promise<void>;
-  logInfo: (scope: string, message: string, options?: Record<string, unknown>) => void;
-  resolveVerifiedTarget: (
-    to: string,
-    accountId: string,
-  ) => {
-    sessionKey: string;
-    route: BncrRoute;
-    displayScope: string;
-  };
-  rememberSessionRoute: (sessionKey: string, accountId: string, route: BncrRoute) => void;
-  enqueueFromReply: Parameters<typeof createBncrChannelSendRuntimeComponent>[0]['enqueueFromReply'];
-  listOutboxEntries: Parameters<
-    typeof createBncrChannelSendRuntimeComponent
-  >[0]['listOutboxEntries'];
-}) {
-  const channelSendRuntime = createBncrChannelSendRuntimeComponent({
-    channelId: runtime.channelId,
-    asString: runtime.asString,
-    syncDebugFlag: runtime.syncDebugFlag,
-    logInfo: runtime.logInfo,
-    resolveVerifiedTarget: runtime.resolveVerifiedTarget,
-    rememberSessionRoute: runtime.rememberSessionRoute,
-    enqueueFromReply: runtime.enqueueFromReply,
-    listOutboxEntries: runtime.listOutboxEntries,
-  });
-
-  return {
-    channelSendRuntime,
-  };
-}

package/src/plugin/outbox-file-push-flow.ts

@@ -1,69 +0,0 @@
-import { resolveFileTransferGuard } from '../core/outbox-file-transfer-guards.ts';
-import { prepareFileTransferRouteSelection } from '../core/outbox-file-transfer-prep.ts';
-import type { BncrConnection, OutboxEntry } from '../core/types.ts';
-import { selectOutboxFileTransferRouteCandidates } from '../messaging/outbound/queue-selectors.ts';
-
-export async function runBncrFileTransferOutboxPush(args: {
-  entry: OutboxEntry;
-  meta: Record<string, unknown>;
-  gatewayContext: unknown;
-  owner: BncrConnection | null;
-  resolvePushConnIds: (accountId: string) => Set<string>;
-  resolveRecentInboundConnIds: (accountId: string) => Set<string>;
-  hasRecentInboundReachability: (accountId: string) => boolean;
-  isRevalidatedAttemptedConn: (connId: string) => boolean;
-  handleFileTransferPushGuardFailure: (args: {
-    entry: OutboxEntry;
-    guard: Exclude<ReturnType<typeof resolveFileTransferGuard>, { ok: true }>;
-  }) => void;
-  pushFileTransferSuccessPath: (args: {
-    entry: OutboxEntry;
-    meta: Record<string, unknown>;
-    owner: BncrConnection | null;
-    connIds: Iterable<string>;
-    recentInboundReachable: boolean;
-    routeReason: string;
-    mediaUrl: string;
-  }) => Promise<void>;
-  handleFileTransferPushFailure: (args: { entry: OutboxEntry; error: unknown }) => void;
-}) {
-  const selection = prepareFileTransferRouteSelection({
-    entry: args.entry,
-    owner: args.owner,
-    resolvePushConnIds: args.resolvePushConnIds,
-    resolveRecentInboundConnIds: args.resolveRecentInboundConnIds,
-    hasRecentInboundReachability: args.hasRecentInboundReachability,
-    isRevalidatedAttemptedConn: args.isRevalidatedAttemptedConn,
-    selectOutboxFileTransferRouteCandidates,
-  });
-  const guard = resolveFileTransferGuard({
-    gatewayContext: args.gatewayContext,
-    entry: args.entry,
-    owner: args.owner,
-    routeSelection: selection,
-    mediaUrl: String(args.meta.mediaUrl || '').trim(),
-  });
-  if (!guard.ok) {
-    args.handleFileTransferPushGuardFailure({
-      entry: args.entry,
-      guard,
-    });
-    return false;
-  }
-
-  try {
-    await args.pushFileTransferSuccessPath({
-      entry: args.entry,
-      meta: args.meta,
-      owner: args.owner,
-      connIds: guard.connIds,
-      recentInboundReachable: guard.recentInboundReachable,
-      routeReason: guard.routeReason,
-      mediaUrl: guard.mediaUrl,
-    });
-    return true;
-  } catch (error) {
-    args.handleFileTransferPushFailure({ entry: args.entry, error });
-    return false;
-  }
-}