@xmoxmo/bncr 0.3.5 → 0.3.7

package/src/messaging/inbound/session-label.ts

@@ -1,10 +1,17 @@
 import { emitBncrLogLine } from '../../core/logging.ts';
+import type { OpenClawChannelRuntimeContext } from '../../openclaw/channel-runtime-contracts.ts';
 import {
   recordBncrSessionMetaFromInbound,
   updateBncrSessionStoreEntry,
 } from '../../openclaw/inbound-session-runtime.ts';
 
-type RecordInboundSessionFn = (args: any) => Promise<unknown> | unknown;
+type RecordInboundSessionFn = (args: {
+  storePath?: string;
+  sessionKey?: string;
+  [key: string]: unknown;
+}) => Promise<unknown> | unknown;
+
+type SessionStoreEntryLike = { label?: string | null; [key: string]: unknown };
 
 export function buildBncrInboundSessionIdentityPatch(args: {
   channelId: string;
@@ -60,7 +67,7 @@ export async function correctBncrInboundSessionLabel(args: {
     await updateBncrSessionStoreEntry({
       storePath,
       sessionKey,
-      update: (entry: any) => {
+      update: (entry: SessionStoreEntryLike) => {
         if (entry?.label === expectedLabel) return null;
         return { label: expectedLabel };
       },
@@ -73,7 +80,7 @@ export async function correctBncrInboundSessionLabel(args: {
 export async function recordAndPatchBncrInboundSessionEntry(args: {
   storePath: string;
   sessionKey: string;
-  ctx?: Record<string, unknown>;
+  ctx?: OpenClawChannelRuntimeContext;
   patch: Record<string, unknown>;
 }) {
   const storePath = normalizeNonEmptyString(args.storePath);
@@ -85,7 +92,7 @@ export async function recordAndPatchBncrInboundSessionEntry(args: {
       await recordBncrSessionMetaFromInbound({
         storePath,
         sessionKey,
-        ctx: args.ctx as any,
+        ctx: args.ctx,
         createIfMissing: true,
       });
     }
@@ -103,11 +110,12 @@ export function wrapBncrInboundRecordSessionLabelCorrection(args: {
   recordInboundSession: RecordInboundSessionFn;
   expectedLabel: string;
 }): RecordInboundSessionFn {
-  return async (recordArgs: any) => {
+  return async (recordArgs) => {
     const result = await args.recordInboundSession(recordArgs);
+    if (!recordArgs?.storePath || !recordArgs?.sessionKey) return result;
     await correctBncrInboundSessionLabel({
-      storePath: recordArgs?.storePath,
-      sessionKey: recordArgs?.sessionKey,
+      storePath: recordArgs.storePath,
+      sessionKey: recordArgs.sessionKey,
       expectedLabel: args.expectedLabel,
     });
     return result;

package/src/messaging/inbound/turn-context.ts

@@ -0,0 +1,131 @@
+import {
+  buildBncrPromptVisibleContextFacts,
+  buildBncrStructuredContextFactsFromInboundParts,
+} from './context-facts.ts';
+import type { BncrInboundApi, BncrInboundContextPayload } from './contracts.ts';
+import type {
+  BncrInboundConversationResolution,
+  BncrPreparedInboundSessionContext,
+  ParsedInbound,
+} from './dispatch-prep.ts';
+import { resolveBncrChannelInboundRuntime } from './runtime-compat.ts';
+
+export function buildBncrInboundTurnContext(args: {
+  api: BncrInboundApi;
+  channelId: string;
+  parsed: ParsedInbound;
+  msgId?: string | null;
+  mimeType?: string;
+  mediaPath?: string;
+  peer: ParsedInbound['peer'];
+  senderIdForContext: string;
+  senderDisplayName: string;
+  resolution: BncrInboundConversationResolution;
+  prepared: BncrPreparedInboundSessionContext;
+}): BncrInboundContextPayload | Promise<BncrInboundContextPayload> {
+  const {
+    api,
+    channelId,
+    parsed,
+    msgId,
+    mimeType,
+    mediaPath,
+    peer,
+    senderIdForContext,
+    senderDisplayName,
+    resolution,
+    prepared,
+  } = args;
+  const structuredContextFacts = buildBncrStructuredContextFactsFromInboundParts({
+    channelId,
+    parsed,
+    resolution,
+    prepared: {
+      rawBody: prepared.rawBody,
+      body: prepared.body,
+      mediaPath,
+      mediaContentType: mimeType,
+    },
+    senderIdForContext,
+    senderDisplayName,
+  });
+  const promptVisibleContextFacts = buildBncrPromptVisibleContextFacts(structuredContextFacts);
+  const supplementalUntrustedContext = Object.keys(promptVisibleContextFacts).length
+    ? [
+        {
+          label: 'Bncr inbound context',
+          source: channelId,
+          type: 'bncr.inbound_context',
+          payload: promptVisibleContextFacts,
+        },
+      ]
+    : [];
+
+  return resolveBncrChannelInboundRuntime(api).buildContext({
+    channel: channelId,
+    provider: channelId,
+    surface: channelId,
+    accountId: resolution.accountId,
+    messageId: msgId,
+    timestamp: Date.now(),
+    from: senderIdForContext,
+    sender: {
+      id: senderIdForContext,
+      name: senderDisplayName,
+      username: senderDisplayName,
+    },
+    conversation: {
+      kind: resolution.chatType,
+      id: peer.id,
+      label: resolution.canonicalTo,
+      routePeer: {
+        kind: peer.kind,
+        id: peer.id,
+      },
+    },
+    route: {
+      agentId: resolution.resolvedRoute.agentId,
+      accountId: resolution.accountId,
+      routeSessionKey: resolution.resolvedRoute.sessionKey,
+      dispatchSessionKey: resolution.dispatchSessionKey,
+      mainSessionKey: resolution.resolvedRoute.mainSessionKey,
+    },
+    reply: {
+      to: resolution.canonicalTo,
+      originatingTo: resolution.originatingTo,
+    },
+    message: {
+      inboundEventKind: 'user_request',
+      body: prepared.body,
+      rawBody: prepared.rawBody,
+      bodyForAgent: prepared.rawBody,
+      commandBody: prepared.rawBody,
+      envelopeFrom: resolution.originatingTo,
+      senderLabel: senderDisplayName,
+    },
+    media: mediaPath
+      ? [
+          {
+            path: mediaPath,
+            contentType: mimeType,
+            kind: mimeType?.startsWith('image/')
+              ? 'image'
+              : mimeType?.startsWith('video/')
+                ? 'video'
+                : mimeType?.startsWith('audio/')
+                  ? 'audio'
+                  : 'document',
+            messageId: msgId ?? undefined,
+          },
+        ]
+      : [],
+    supplemental: {
+      untrustedContext: supplementalUntrustedContext,
+    },
+    extra: {
+      OriginatingChannel: channelId,
+      BncrStructuredContextFacts: structuredContextFacts,
+      StructuredContextFacts: structuredContextFacts,
+    },
+  });
+}

package/src/messaging/outbound/actions.ts

@@ -1,15 +1,29 @@
+type BncrReplyActionSendTextParams = {
+  accountId: string;
+  to: string;
+  text: string;
+  replyToMessageId?: string;
+};
+
+type BncrReplyActionResult = {
+  channel: string;
+  messageId: string;
+  chatId: string;
+};
+
+type BncrUnsupportedActionResult = {
+  ok: false;
+  unsupported: true;
+  reason: string;
+};
+
 export async function sendBncrReplyAction(params: {
   accountId: string;
   to: string;
   text: string;
   replyToMessageId?: string;
-  sendText: (params: {
-    accountId: string;
-    to: string;
-    text: string;
-    replyToMessageId?: string;
-  }) => Promise<any>;
-}) {
+  sendText: (params: BncrReplyActionSendTextParams) => Promise<BncrReplyActionResult>;
+}): Promise<BncrReplyActionResult> {
   return params.sendText({
     accountId: params.accountId,
     to: params.to,
@@ -21,7 +35,7 @@ export async function sendBncrReplyAction(params: {
 export async function deleteBncrMessageAction(_params: {
   accountId: string;
   targetMessageId: string;
-}) {
+}): Promise<BncrUnsupportedActionResult> {
   return { ok: false, unsupported: true, reason: 'delete not implemented yet' };
 }
 
@@ -29,7 +43,7 @@ export async function reactBncrMessageAction(_params: {
   accountId: string;
   targetMessageId: string;
   emoji: string;
-}) {
+}): Promise<BncrUnsupportedActionResult> {
   return { ok: false, unsupported: true, reason: 'react not implemented yet' };
 }
 
@@ -37,6 +51,6 @@ export async function editBncrMessageAction(_params: {
   accountId: string;
   targetMessageId: string;
   text: string;
-}) {
+}): Promise<BncrUnsupportedActionResult> {
   return { ok: false, unsupported: true, reason: 'edit not implemented yet' };
 }

package/src/messaging/outbound/diagnostics-debug-builders.ts

@@ -0,0 +1,365 @@
+import type { BncrConnection } from '../../core/types.ts';
+import { OUTBOUND_TERMINAL_REASON, type OutboundScheduleSource } from './reasons.ts';
+import type { RetryRerouteDecision } from './retry-policy.ts';
+
+type BncrConnectionDebugView = BncrConnection & {
+  outboundReadyUntil?: number;
+  preferredForOutboundUntil?: number;
+  lastAckOkAt?: number;
+  lastPushTimeoutAt?: number;
+  pushFailureScore?: number;
+};
+
+function asConnectionDebugView(connection: BncrConnection): BncrConnectionDebugView {
+  return connection as BncrConnectionDebugView;
+}
+
+export function buildOutboxScheduleDebugInfo(args: {
+  bridgeId: string;
+  accountId?: string | null;
+  localNextDelay?: number | null;
+  globalNextDelay?: number | null;
+  wait?: number | null;
+  source: OutboundScheduleSource;
+  messageId?: string;
+}) {
+  return {
+    bridge: args.bridgeId,
+    ...(args.accountId ? { accountId: args.accountId } : {}),
+    ...(args.messageId ? { messageId: args.messageId } : {}),
+    source: args.source,
+    ...(typeof args.wait === 'number' ? { wait: args.wait } : {}),
+    ...(typeof args.localNextDelay === 'number' ? { localNextDelay: args.localNextDelay } : {}),
+    ...(typeof args.globalNextDelay === 'number' ? { globalNextDelay: args.globalNextDelay } : {}),
+  };
+}
+
+export function buildOutboxPushSkipDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  reason: string;
+  recentInboundReachable?: boolean;
+  kind?: string;
+  routeReason?: string;
+  connIds?: Iterable<string>;
+  ownerConnId?: string;
+  ownerClientId?: string;
+  activeConnectionCount?: number;
+  connections?: Iterable<BncrConnection>;
+}) {
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    ...(args.kind ? { kind: args.kind } : {}),
+    reason: args.reason,
+    ...(args.routeReason ? { routeReason: args.routeReason } : {}),
+    ...(args.connIds ? { connIds: Array.from(args.connIds) } : {}),
+    ...(args.ownerConnId ? { ownerConnId: args.ownerConnId } : {}),
+    ...(args.ownerClientId ? { ownerClientId: args.ownerClientId } : {}),
+    ...(typeof args.activeConnectionCount === 'number'
+      ? { activeConnectionCount: args.activeConnectionCount }
+      : {}),
+    ...(args.connections
+      ? {
+          connections: Array.from(args.connections)
+            .filter((c) => c.accountId === args.accountId)
+            .slice(0, 8)
+            .map((c) => {
+              const view = asConnectionDebugView(c);
+              return {
+                connId: c.connId,
+                clientId: c.clientId,
+                lastSeenAt: c.lastSeenAt,
+                outboundReadyUntil: view.outboundReadyUntil,
+                preferredForOutboundUntil: view.preferredForOutboundUntil,
+                inboundOnly: view.inboundOnly,
+                lastAckOkAt: view.lastAckOkAt,
+                lastPushTimeoutAt: view.lastPushTimeoutAt,
+                pushFailureScore: view.pushFailureScore,
+              };
+            }),
+        }
+      : {}),
+    ...(typeof args.recentInboundReachable === 'boolean'
+      ? { recentInboundReachable: args.recentInboundReachable }
+      : {}),
+  };
+}
+
+export function buildOutboxRouteSelectDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  routeReason: string;
+  connIds: Iterable<string>;
+  ownerConnId?: string;
+  ownerClientId?: string;
+  recentInboundReachable: boolean;
+  event: string;
+  kind?: string;
+}) {
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    ...(args.kind ? { kind: args.kind } : {}),
+    routeReason: args.routeReason,
+    connIds: Array.from(args.connIds),
+    ownerConnId: args.ownerConnId || '',
+    ownerClientId: args.ownerClientId || '',
+    recentInboundReachable: args.recentInboundReachable,
+    event: args.event,
+  };
+}
+
+export function buildOutboxPushOkDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  connIds: Iterable<string>;
+  ownerConnId?: string;
+  ownerClientId?: string;
+  recentInboundReachable: boolean;
+  event: string;
+  kind?: string;
+}) {
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    ...(args.kind ? { kind: args.kind } : {}),
+    connIds: Array.from(args.connIds),
+    ownerConnId: args.ownerConnId || '',
+    ownerClientId: args.ownerClientId || '',
+    recentInboundReachable: args.recentInboundReachable,
+    event: args.event,
+  };
+}
+
+export function buildFlushDebugInfo(args: {
+  bridgeId: string;
+  accountId: string | null;
+  targetAccounts: string[];
+  outboxSize: number;
+  trigger: string;
+  reason?: string;
+}) {
+  return {
+    bridge: args.bridgeId,
+    accountId: args.accountId,
+    targetAccounts: [...args.targetAccounts],
+    outboxSize: args.outboxSize,
+    trigger: args.trigger,
+    reason: args.reason,
+  };
+}
+
+export function buildOutboxDrainSkipDebugInfo(args: {
+  bridgeId: string;
+  accountId: string;
+  reason: string;
+  outboxSize: number;
+  trigger: string;
+}) {
+  return {
+    bridge: args.bridgeId,
+    accountId: args.accountId,
+    reason: args.reason,
+    outboxSize: args.outboxSize,
+    trigger: args.trigger,
+  };
+}
+
+export function buildOutboxDrainStuckDebugInfo(args: {
+  bridgeId: string;
+  accountId: string;
+  reason: string;
+  trigger: string;
+  outboxSize: number;
+  pending: number;
+  runningMs: number;
+  runningSince?: number | null;
+  hasGatewayContext: boolean;
+  activeConnectionCount: number;
+  messageAckWaiters: number;
+  fileAckWaiters: number;
+  pendingEntries?: Iterable<{
+    messageId?: string;
+    retryCount?: number;
+    nextAttemptAt?: number;
+    lastAttemptAt?: number;
+    lastError?: string;
+    lastPushAt?: number;
+    lastPushConnId?: string;
+    routeAttemptConnIds?: string[];
+  }>;
+  connections?: Iterable<BncrConnection>;
+}) {
+  return {
+    bridge: args.bridgeId,
+    accountId: args.accountId,
+    reason: args.reason,
+    trigger: args.trigger,
+    outboxSize: args.outboxSize,
+    pending: args.pending,
+    runningMs: args.runningMs,
+    runningSince: args.runningSince ?? null,
+    hasGatewayContext: args.hasGatewayContext,
+    activeConnectionCount: args.activeConnectionCount,
+    waiters: {
+      messageAck: args.messageAckWaiters,
+      fileAck: args.fileAckWaiters,
+    },
+    ...(args.pendingEntries
+      ? {
+          pendingEntries: Array.from(args.pendingEntries)
+            .slice(0, 8)
+            .map((entry) => ({
+              messageId: entry.messageId || '',
+              retryCount: entry.retryCount,
+              nextAttemptAt: entry.nextAttemptAt,
+              lastAttemptAt: entry.lastAttemptAt,
+              lastError: entry.lastError,
+              lastPushAt: entry.lastPushAt,
+              lastPushConnId: entry.lastPushConnId,
+              routeAttemptConnIds: entry.routeAttemptConnIds,
+            })),
+        }
+      : {}),
+    ...(args.connections
+      ? {
+          connections: Array.from(args.connections)
+            .filter((c) => c.accountId === args.accountId)
+            .slice(0, 8)
+            .map((c) => {
+              const view = asConnectionDebugView(c);
+              return {
+                connId: c.connId,
+                clientId: c.clientId,
+                connectedAt: c.connectedAt,
+                lastSeenAt: c.lastSeenAt,
+                outboundReadyUntil: view.outboundReadyUntil,
+                preferredForOutboundUntil: view.preferredForOutboundUntil,
+                inboundOnly: view.inboundOnly,
+                lastAckOkAt: view.lastAckOkAt,
+                lastPushTimeoutAt: view.lastPushTimeoutAt,
+                pushFailureScore: view.pushFailureScore,
+              };
+            }),
+        }
+      : {}),
+  };
+}
+
+export function buildOutboxAckDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  requireAck: boolean;
+  ackResult: 'acked' | 'timeout';
+  onlineNow: boolean;
+  recentInboundReachable: boolean;
+  connIds?: Iterable<string>;
+  ownerConnId?: string;
+  ownerClientId?: string;
+  sessionKey?: string;
+  to?: string;
+  ackStage?: string;
+  ackOutcome?: string;
+  reason?: string;
+  kind?: string;
+  event?: string;
+  ackTimeoutMs?: number;
+  adaptiveAckTimeoutEnabled?: boolean;
+}) {
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    ...(args.sessionKey ? { sessionKey: args.sessionKey } : {}),
+    ...(args.to ? { to: args.to } : {}),
+    ...(args.kind ? { kind: args.kind } : {}),
+    requireAck: args.requireAck,
+    ackResult: args.ackResult,
+    ackStage: args.ackStage || 'message',
+    ackOutcome: args.ackOutcome || args.ackResult,
+    ...(args.reason ? { reason: args.reason } : {}),
+    ...(typeof args.ackTimeoutMs === 'number' ? { ackTimeoutMs: args.ackTimeoutMs } : {}),
+    ...(typeof args.adaptiveAckTimeoutEnabled === 'boolean'
+      ? { adaptiveAckTimeoutEnabled: args.adaptiveAckTimeoutEnabled }
+      : {}),
+    onlineNow: args.onlineNow,
+    recentInboundReachable: args.recentInboundReachable,
+    ...(args.connIds ? { connIds: Array.from(args.connIds) } : {}),
+    ...(args.ownerConnId ? { ownerConnId: args.ownerConnId } : {}),
+    ...(args.ownerClientId ? { ownerClientId: args.ownerClientId } : {}),
+    ...(args.event ? { event: args.event } : {}),
+  };
+}
+
+export function buildRetryRerouteDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  currentConnId: string;
+  decision: RetryRerouteDecision;
+  availableConnIds: string[];
+}) {
+  if (args.decision.kind !== 'retry') {
+    return {
+      messageId: args.messageId,
+      accountId: args.accountId,
+      currentConnId: args.currentConnId,
+      availableConnIds: [...args.availableConnIds],
+      kind: args.decision.kind,
+      terminalReason: args.decision.terminalReason,
+      nextRetryCount: args.decision.nextRetryCount,
+      lastAttemptAt: args.decision.lastAttemptAt,
+    };
+  }
+
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    currentConnId: args.currentConnId,
+    attemptedConnIds: [...args.decision.attemptedConnIds],
+    availableConnIds: [...args.availableConnIds],
+    revalidatedConnIds: [...args.decision.revalidatedConnIds],
+    hasUntriedAlternative: args.decision.hasUntriedAlternative,
+    shouldFastReroute: args.decision.shouldFastReroute,
+    routeAttemptRound: args.decision.routeAttemptRound,
+    nextAttemptAt: args.decision.nextAttemptAt,
+    fastReroutePending: args.decision.fastReroutePending,
+    nextRetryCount: args.decision.nextRetryCount,
+    lastAttemptAt: args.decision.lastAttemptAt,
+    lastError: args.decision.lastError,
+    kind: args.decision.kind,
+  };
+}
+
+export function buildPushFailureDebugInfo(args: {
+  messageId: string;
+  accountId: string;
+  retryCount: number;
+  lastError?: string;
+  retryable?: boolean;
+  kind?: string;
+}) {
+  return {
+    messageId: args.messageId,
+    accountId: args.accountId,
+    ...(args.kind ? { kind: args.kind } : {}),
+    ...(typeof args.retryable === 'boolean' ? { retryable: args.retryable } : {}),
+    retryCount: args.retryCount,
+    error:
+      (typeof args.lastError === 'string' && args.lastError) || OUTBOUND_TERMINAL_REASON.PUSH_RETRY,
+  };
+}
+
+export function buildReplyMediaFallbackDebugInfo(args: {
+  sessionKey: string;
+  mediaUrl: string;
+  replyToId: string;
+  fallback: { text: string; reason: string };
+}) {
+  return {
+    sessionKey: args.sessionKey,
+    mediaUrl: args.mediaUrl,
+    replyToId: args.replyToId || undefined,
+    fallbackText: args.fallback.text,
+    reason: args.fallback.reason,
+  };
+}