@messenger-box/platform-server 10.0.3-alpha.196 → 10.0.3-alpha.201

package/lib/channels/ack-reactions.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Ack Reactions system - inspired by openclaw's ack-reactions,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides scoped acknowledgement reactions for posts/messages,
+ * supporting different behaviors for direct messages, groups,
+ * and mention-based triggers.
+ */
+export type AckReactionScope = 'all' | 'direct' | 'group-all' | 'group-mentions' | 'off' | 'none';
+export interface IAckReactionProps {
+    /** Whether ack reactions are enabled */
+    enabled: boolean;
+    /** Default emoji for acknowledgement */
+    defaultEmoji: string;
+    /** Scope of ack reactions */
+    scope: AckReactionScope;
+    /** Whether to remove the ack reaction after reply */
+    removeAfterReply: boolean;
+}
+export declare const DEFAULT_ACK_REACTION_PROPS: IAckReactionProps;
+export interface IAckReactionGateParams {
+    scope: AckReactionScope | undefined;
+    isDirect: boolean;
+    isGroup: boolean;
+    isMentionableGroup: boolean;
+    requireMention: boolean;
+    canDetectMention: boolean;
+    effectiveWasMentioned: boolean;
+    shouldBypassMention?: boolean;
+}
+/**
+ * Determines whether an ack reaction should be sent based on scope and context
+ * (mirrors openclaw's shouldAckReaction)
+ */
+export declare function shouldAckReaction(params: IAckReactionGateParams): boolean;
+/**
+ * Handles removing an ack reaction after a reply has been sent
+ * (mirrors openclaw's removeAckReactionAfterReply)
+ */
+export declare function removeAckReactionAfterReply(params: {
+    removeAfterReply: boolean;
+    ackReactionPromise: Promise<boolean> | null;
+    ackReactionValue: string | null;
+    remove: () => Promise<void>;
+    onError?: (err: unknown) => void;
+}): void;

package/lib/channels/ack-reactions.js

@@ -0,0 +1,48 @@
+/**
+ * Ack Reactions system - inspired by openclaw's ack-reactions,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides scoped acknowledgement reactions for posts/messages,
+ * supporting different behaviors for direct messages, groups,
+ * and mention-based triggers.
+ */
+const DEFAULT_ACK_REACTION_PROPS = {
+  enabled: false,
+  defaultEmoji: '👀',
+  scope: 'group-mentions',
+  removeAfterReply: true
+};
+/**
+ * Determines whether an ack reaction should be sent based on scope and context
+ * (mirrors openclaw's shouldAckReaction)
+ */
+function shouldAckReaction(params) {
+  const scope = params.scope ?? 'group-mentions';
+  if (scope === 'off' || scope === 'none') return false;
+  if (scope === 'all') return true;
+  if (scope === 'direct') return params.isDirect;
+  if (scope === 'group-all') return params.isGroup;
+  if (scope === 'group-mentions') {
+    if (!params.isMentionableGroup) return false;
+    if (!params.requireMention) return false;
+    if (!params.canDetectMention) return false;
+    return params.effectiveWasMentioned || params.shouldBypassMention === true;
+  }
+  return false;
+}
+// ---------------------------------------------------------------------------
+// Ack Reaction Lifecycle
+// ---------------------------------------------------------------------------
+/**
+ * Handles removing an ack reaction after a reply has been sent
+ * (mirrors openclaw's removeAckReactionAfterReply)
+ */
+function removeAckReactionAfterReply(params) {
+  if (!params.removeAfterReply) return;
+  if (!params.ackReactionPromise) return;
+  if (!params.ackReactionValue) return;
+  void params.ackReactionPromise.then(didAck => {
+    if (!didAck) return;
+    params.remove().catch(err => params.onError?.(err));
+  });
+}export{DEFAULT_ACK_REACTION_PROPS,removeAckReactionAfterReply,shouldAckReaction};//# sourceMappingURL=ack-reactions.js.map

package/lib/channels/ack-reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack-reactions.js","sources":["../../src/channels/ack-reactions.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;AAOG;AAmBI,MAAM,0BAA0B,GAAsB;AACzD,EAAA,OAAA,EAAO,KAAE;AACT,EAAA,YAAA,EAAY,IAAE;AACd,EAAA,KAAA,EAAK,gBAAE;AACP,EAAA,gBAAA,EAAgB;;AAkBpB;;;AAGG;AACG,SAAU,iBAAiB,CAAC,MAA8B,EAAA;AAC5D,EAAA,MAAA,QAAW,MAAG,CAAA,KAAO,IAAK;AAC1B,EAAA,IAAA,UAAS,KAAK,IAAK,KAAI,WAAU,EAAM,OAAA,KAAA;AAAE,EAAA,IAAA,KAAA,UAAa,EAAA,OAAA,IAAA;MACtD,KAAI,aAAe,EAAA,OAAA,MAAA,CAAA,QAAA;AAAE,EAAA,IAAA,KAAA,gBAAY,EAAA,OAAA,MAAA,CAAA,OAAA;MACjC,KAAI,qBAAkB,EAAA;QAAE,CAAA,MAAO,CAAA,kBAAgB,EAAA,OAAA,KAAA;IAC/C,IAAI,CAAA,qBAAqB,EAAA,OAAA,KAAA;QAAE,CAAA,MAAO,CAAA,gBAAe,EAAA,OAAA,KAAA;AACjD,IAAA,OAAI,MAAK,CAAK,qBAAmB,IAAA,MAAA,CAAA,mBAAA,KAAA,IAAA;;AACG,EAAA,OAAA,KAAA;;AACJ;;AACE;;;AAGlC;AACJ;AAEA,SAAA,2BAAA,CAAA,MAAA,EAAA;AACA,EAAA,IAAA,CAAA,MAAA,CAAA,gBAAyB,EAAA;AACzB,EAAA,IAAA,CAAA,MAAA,CAAA,kBAAA,EAAA;AAEA,EAAA,IAAA,CAAA,MAAA,CAAA,gBAAA,EAAA;;;AAGG,IAAA,MAAA,CAAA,MAAA,EAAA,CAAA,KAAA,CAAA,GAAA,IAAA,MAAA,CAAA,OAAA,GAAA,GAAA,CAAA,CAAA;AACH,EAAA,CAAA,CAAA;"}

package/lib/channels/allowlist-match.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Allowlist matching - inspired by openclaw's allowlist-match,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides user/sender allowlists for channels, enabling
+ * per-channel access control with wildcard, ID, name, and
+ * username-based matching.
+ */
+export type AllowlistMatchSource = 'wildcard' | 'id' | 'name' | 'tag' | 'username' | 'email' | 'prefixed-id' | 'prefixed-user' | 'prefixed-name';
+export interface IAllowlistMatch<TSource extends string = AllowlistMatchSource> {
+    allowed: boolean;
+    matchKey?: string;
+    matchSource?: TSource;
+}
+export interface IAllowlistProps {
+    /** Whether allowlist is enabled */
+    enabled: boolean;
+    /** List of allowed senders (IDs, names, emails, or '*' for wildcard) */
+    allowFrom: Array<string | number>;
+    /** Whether to block messages from unknown senders */
+    blockUnknown: boolean;
+}
+export declare const DEFAULT_ALLOWLIST_PROPS: IAllowlistProps;
+export declare function formatAllowlistMatchMeta(match?: {
+    matchKey?: string;
+    matchSource?: string;
+} | null): string;
+/**
+ * Resolves whether a sender is allowed based on the allowlist
+ * (mirrors openclaw's resolveAllowlistMatchSimple)
+ */
+export declare function resolveAllowlistMatch(params: {
+    allowFrom: Array<string | number>;
+    senderId: string;
+    senderName?: string | null;
+    senderEmail?: string | null;
+    senderUsername?: string | null;
+}): IAllowlistMatch<'wildcard' | 'id' | 'name' | 'email' | 'username'>;

package/lib/channels/allowlist-match.js

@@ -0,0 +1,67 @@
+/**
+ * Allowlist matching - inspired by openclaw's allowlist-match,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides user/sender allowlists for channels, enabling
+ * per-channel access control with wildcard, ID, name, and
+ * username-based matching.
+ */
+const DEFAULT_ALLOWLIST_PROPS = {
+  enabled: false,
+  allowFrom: [],
+  blockUnknown: false
+};
+// ---------------------------------------------------------------------------
+// Match Resolution (mirrors openclaw's resolveAllowlistMatchSimple)
+// ---------------------------------------------------------------------------
+function formatAllowlistMatchMeta(match) {
+  return `matchKey=${match?.matchKey ?? 'none'} matchSource=${match?.matchSource ?? 'none'}`;
+}
+/**
+ * Resolves whether a sender is allowed based on the allowlist
+ * (mirrors openclaw's resolveAllowlistMatchSimple)
+ */
+function resolveAllowlistMatch(params) {
+  const allowFrom = params.allowFrom.map(entry => String(entry).trim().toLowerCase()).filter(Boolean);
+  if (allowFrom.length === 0) return {
+    allowed: false
+  };
+  if (allowFrom.includes('*')) return {
+    allowed: true,
+    matchKey: '*',
+    matchSource: 'wildcard'
+  };
+  const senderId = params.senderId.toLowerCase();
+  if (allowFrom.includes(senderId)) return {
+    allowed: true,
+    matchKey: senderId,
+    matchSource: 'id'
+  };
+  const senderName = params.senderName?.toLowerCase();
+  if (senderName && allowFrom.includes(senderName)) {
+    return {
+      allowed: true,
+      matchKey: senderName,
+      matchSource: 'name'
+    };
+  }
+  const senderEmail = params.senderEmail?.toLowerCase();
+  if (senderEmail && allowFrom.includes(senderEmail)) {
+    return {
+      allowed: true,
+      matchKey: senderEmail,
+      matchSource: 'email'
+    };
+  }
+  const senderUsername = params.senderUsername?.toLowerCase();
+  if (senderUsername && allowFrom.includes(senderUsername)) {
+    return {
+      allowed: true,
+      matchKey: senderUsername,
+      matchSource: 'username'
+    };
+  }
+  return {
+    allowed: false
+  };
+}export{DEFAULT_ALLOWLIST_PROPS,formatAllowlistMatchMeta,resolveAllowlistMatch};//# sourceMappingURL=allowlist-match.js.map

package/lib/channels/allowlist-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist-match.js","sources":["../../src/channels/allowlist-match.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;AAOG;AAoCI,MAAM,uBAAuB,GAAoB;AACpD,EAAA,OAAA,EAAO,KAAE;AACT,EAAA,SAAA,EAAS,EAAE;AACX,EAAA,YAAA,EAAY;;AAGhB;AACA;AACA;AAEM,SAAU,wBAAwB,CAAC,KAA0D,EAAA;AAC/F,EAAA,OAAA,CAAA,SAAO,EAAA,KAAY,EAAK,QAAE,IAAQ,MAAI,CAAA,aAAM,EAAA,KAAgB,EAAK,WAAE,IAAW,MAAI,CAAA,CAAM;AAC5F;AAEA;;;AAGG;AACG,SAAU,qBAAqB,CAAC,MAMrC,EAAA;AACG,EAAA,MAAA,SAAM,GAAS,MAAG,CAAA,SAAO,CAAA,GAAU,CAAA,KAAK,IAAK,MAAK,CAAA,KAAO,CAAA,CAAA,IAAO,EAAA,CAAA,WAAO,EAAA,CAAA,CAAW,MAAI,CAAA,OAAO,CAAA;AAE7F,EAAA,IAAA,SAAI,CAAA,MAAU,KAAM,CAAA,EAAM,OAAA;AAAE,IAAA,OAAA,EAAA;AAC5B,GAAA;AAA6B,EAAA,IAAA,SAAO,CAAA,QAAS,CAAA,GAAE,CAAA,EAAI,OAAE;IAErD,OAAM,EAAA,IAAA;AACN,IAAA,QAAI,EAAA,GAAS;AAAqB,IAAA,WAAO,EAAE;;QAGvC,QAAA,SAAc,CAAA,oBAAmB,EAAA;AACjC,EAAA,IAAA,SAAO,CAAA,QAAS,CAAA,QAAQ,CAAA,EAAA,OAAU;IACtC,OAAC,EAAA,IAAA;IAED,QAAM,EAAA;IACN,WAAI,EAAA;AACA,GAAA;QACH,UAAA,GAAA,MAAA,CAAA,UAAA,EAAA,WAAA,EAAA;MAED,UAAM,IAAA,SAAiB,CAAA,mBAAqB,CAAE,EAAA;IAC9C,OAAI;AACA,MAAA,OAAA,EAAO,IAAE;MACZ,QAAA,EAAA,UAAA;AAED,MAAA,WAAS,EAAA;AACb,KAAC;;;;;;;;;;;;;;;;;;;;;"}

package/lib/channels/channel-config.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Channel configuration - inspired by openclaw's channel-config,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides channel configuration matching, slug normalization,
+ * and entry resolution for per-channel settings.
+ */
+export type ChannelMatchSource = 'direct' | 'parent' | 'wildcard';
+export interface IChannelEntryMatch<T> {
+    entry?: T;
+    key?: string;
+    wildcardEntry?: T;
+    wildcardKey?: string;
+    parentEntry?: T;
+    parentKey?: string;
+    matchKey?: string;
+    matchSource?: ChannelMatchSource;
+}
+export interface IChannelConfigProps {
+    /** Channel-level notification settings override */
+    notifyOverride?: 'default' | 'all' | 'mentions' | 'none';
+    /** Whether to auto-join the channel */
+    autoJoin?: boolean;
+    /** Channel priority (higher = more prominent) */
+    priority?: number;
+    /** Custom channel category */
+    category?: string;
+    /** Whether channel is archived */
+    archived?: boolean;
+    /** Whether channel is muted */
+    muted?: boolean;
+    /** Custom theme for the channel */
+    theme?: string;
+}
+export declare const DEFAULT_CHANNEL_CONFIG_PROPS: IChannelConfigProps;
+export declare function normalizeChannelSlug(value: string): string;
+export declare function buildChannelKeyCandidates(...keys: Array<string | undefined | null>): string[];
+export declare function resolveChannelEntryMatch<T>(params: {
+    entries?: Record<string, T>;
+    keys: string[];
+    wildcardKey?: string;
+}): IChannelEntryMatch<T>;
+export declare function applyChannelMatchMeta<TResult extends {
+    matchKey?: string;
+    matchSource?: ChannelMatchSource;
+}>(result: TResult, match: IChannelEntryMatch<unknown>): TResult;

package/lib/channels/channel-config.js

@@ -0,0 +1,63 @@
+/**
+ * Channel configuration - inspired by openclaw's channel-config,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides channel configuration matching, slug normalization,
+ * and entry resolution for per-channel settings.
+ */
+const DEFAULT_CHANNEL_CONFIG_PROPS = {
+  notifyOverride: 'default',
+  autoJoin: false,
+  priority: 0,
+  archived: false,
+  muted: false
+};
+// ---------------------------------------------------------------------------
+// Channel Slug Normalization (mirrors openclaw's normalizeChannelSlug)
+// ---------------------------------------------------------------------------
+function normalizeChannelSlug(value) {
+  return value.trim().toLowerCase().replace(/^#/, '').replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+// ---------------------------------------------------------------------------
+// Channel Key Candidates (mirrors openclaw's buildChannelKeyCandidates)
+// ---------------------------------------------------------------------------
+function buildChannelKeyCandidates(...keys) {
+  const seen = new Set();
+  const candidates = [];
+  for (const key of keys) {
+    if (typeof key !== 'string') continue;
+    const trimmed = key.trim();
+    if (!trimmed || seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    candidates.push(trimmed);
+  }
+  return candidates;
+}
+// ---------------------------------------------------------------------------
+// Channel Entry Resolution (mirrors openclaw's resolveChannelEntryMatch)
+// ---------------------------------------------------------------------------
+function resolveChannelEntryMatch(params) {
+  const entries = params.entries ?? {};
+  const match = {};
+  for (const key of params.keys) {
+    if (!Object.prototype.hasOwnProperty.call(entries, key)) continue;
+    match.entry = entries[key];
+    match.key = key;
+    break;
+  }
+  if (params.wildcardKey && Object.prototype.hasOwnProperty.call(entries, params.wildcardKey)) {
+    match.wildcardEntry = entries[params.wildcardKey];
+    match.wildcardKey = params.wildcardKey;
+  }
+  return match;
+}
+// ---------------------------------------------------------------------------
+// Match Metadata Application
+// ---------------------------------------------------------------------------
+function applyChannelMatchMeta(result, match) {
+  if (match.matchKey && match.matchSource) {
+    result.matchKey = match.matchKey;
+    result.matchSource = match.matchSource;
+  }
+  return result;
+}export{DEFAULT_CHANNEL_CONFIG_PROPS,applyChannelMatchMeta,buildChannelKeyCandidates,normalizeChannelSlug,resolveChannelEntryMatch};//# sourceMappingURL=channel-config.js.map

package/lib/channels/channel-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-config.js","sources":["../../src/channels/channel-config.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AAwCI,MAAM,4BAA4B,GAAwB;AAC7D,EAAA,cAAA,EAAc,SAAE;AAChB,EAAA,QAAA,EAAQ,KAAE;AACV,EAAA,QAAA,EAAQ;AACR,EAAA,QAAA,EAAQ,KAAE;AACV,EAAA,KAAA,EAAK;;AAGT;AACA;AACA;AAEM,SAAU,oBAAoB,CAAC,KAAa,EAAA;AAC9C,EAAA,OAAA,KAAO,CAAA,IAAK,EAAA,CAAA,WAAA,EAAA,CAAA,OAAA,CAAA,IAAA,EAAA,EAAA,CAAA,CAAA,OAAA,CAAA,aAAA,EAAA,GAAA,CAAA,CAAA,OAAA,CAAA,UAAA,EAAA,EAAA,CAAA;AACP;AACA;AACA;AACA;AACA,SAAO,yBAAiB,CAAA,GAAA,IAAA,EAAA;AACjC,EAAC,MAAA,IAAA,GAAA,IAAA,GAAA,EAAA;AAED,EAAA,MAAA,UAAA,GAAA,EAAA;AACA,EAAA,KAAA,MAAA,GAAA,IAAA,IAAA,EAAA;AACA,IAAA,IAAA,OAAA,GAAA,KAAA,QAAA,EAAA;AAEA,IAAA,MAAM,OAAU,GAAA,GAAA,CAAA,IAAA,EAAA;AACZ,IAAA,IAAA,CAAA,OAAU,IAAG,IAAO,IAAW,CAAA,OAAA,CAAA,EAAA;IAC/B,IAAA,CAAA,GAAM,CAAA,OAAU,CAAA;AAChB,IAAA,UAAK,CAAM,IAAG,CAAA,QAAU;;mBACS;AAC7B;;;AAEA;AACA,SAAA,wBAAyB,CAAA,MAAA,EAAA;QAC5B,OAAA,GAAA,MAAA,CAAA,OAAA,IAAA,EAAA;AACD,EAAA,MAAA;AACJ,EAAC,KAAA,MAAA,GAAA,IAAA,MAAA,CAAA,IAAA,EAAA;AAED,IAAA,IAAA,CAAA,MAAA,CAAA,SAAA,CAAA,cAAA,CAAA,IAAA,CAAA,OAAA,EAAA,GAAA,CAAA,EAAA;AACA,IAAA,KAAA,CAAA,KAAA,GAAA,OAAA,CAAA,GAAA,CAAA;AACA,IAAA,KAAA,CAAA,GAAA,GAAA,GAAA;AAEA,IAAA;AAKI,EAAA;MACA,MAAM,CAAA,WAAkC,IAAA,MAAA,CAAA,SAAA,CAAA,cAAA,CAAA,IAAA,CAAA,OAAA,EAAA,MAAA,CAAA,WAAA,CAAA,EAAA;AAExC,IAAA,KAAK,wBAAwB,OAAG,CAAA,WAAA,CAAA;AAC5B,IAAA,KAAA,CAAA,WAAY,GAAA,MAAU,CAAA,WAAA;;AACtB,EAAA,OAAA,KAAM;AACN;;;AAIJ;8BACiC,CAAC,MAAM,EAAC,KAAA,EAAA;AACrC,EAAA,IAAA,KAAA,CAAA,QAAM,IAAA,KAAc,CAAA;IACxB,MAAC,CAAA,QAAA,GAAA,KAAA,CAAA,QAAA;AAED,IAAA,MAAA,CAAO,WAAM,GAAA,KAAA,CAAA,WAAA;AACjB,EAAC;AAED,EAAA,OAAA,MAAA;AACA"}

package/lib/channels/command-gating.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Command gating - inspired by openclaw's command-gating,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides access control for commands within channels, supporting
+ * access groups, per-user authorization, and text command filtering.
+ */
+export interface ICommandAuthorizer {
+    configured: boolean;
+    allowed: boolean;
+}
+export type CommandGatingMode = 'allow' | 'deny' | 'configured';
+export interface ICommandGatingProps {
+    /** Whether text commands are allowed */
+    allowTextCommands: boolean;
+    /** Whether access groups are used for authorization */
+    useAccessGroups: boolean;
+    /** Default mode when access groups are off */
+    modeWhenAccessGroupsOff: CommandGatingMode;
+    /** List of allowed command prefixes */
+    allowedPrefixes: string[];
+    /** List of blocked commands */
+    blockedCommands: string[];
+}
+export declare const DEFAULT_COMMAND_GATING_PROPS: ICommandGatingProps;
+/**
+ * Resolves whether a command is authorized based on authorizers and config
+ */
+export declare function resolveCommandAuthorized(params: {
+    useAccessGroups: boolean;
+    authorizers: ICommandAuthorizer[];
+    modeWhenAccessGroupsOff?: CommandGatingMode;
+}): boolean;
+/**
+ * Resolves whether a control command should be blocked
+ * (mirrors openclaw's resolveControlCommandGate)
+ */
+export declare function resolveControlCommandGate(params: {
+    useAccessGroups: boolean;
+    authorizers: ICommandAuthorizer[];
+    allowTextCommands: boolean;
+    hasControlCommand: boolean;
+    modeWhenAccessGroupsOff?: CommandGatingMode;
+}): {
+    commandAuthorized: boolean;
+    shouldBlock: boolean;
+};

package/lib/channels/command-gating.js

@@ -0,0 +1,52 @@
+/**
+ * Command gating - inspired by openclaw's command-gating,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Provides access control for commands within channels, supporting
+ * access groups, per-user authorization, and text command filtering.
+ */
+const DEFAULT_COMMAND_GATING_PROPS = {
+  allowTextCommands: true,
+  useAccessGroups: false,
+  modeWhenAccessGroupsOff: 'allow',
+  allowedPrefixes: ['/'],
+  blockedCommands: []
+};
+// ---------------------------------------------------------------------------
+// Authorization Resolution (mirrors openclaw's resolveCommandAuthorizedFromAuthorizers)
+// ---------------------------------------------------------------------------
+/**
+ * Resolves whether a command is authorized based on authorizers and config
+ */
+function resolveCommandAuthorized(params) {
+  const {
+    useAccessGroups,
+    authorizers
+  } = params;
+  const mode = params.modeWhenAccessGroupsOff ?? 'allow';
+  if (!useAccessGroups) {
+    if (mode === 'allow') return true;
+    if (mode === 'deny') return false;
+    // mode === 'configured'
+    const anyConfigured = authorizers.some(entry => entry.configured);
+    if (!anyConfigured) return true;
+    return authorizers.some(entry => entry.configured && entry.allowed);
+  }
+  return authorizers.some(entry => entry.configured && entry.allowed);
+}
+/**
+ * Resolves whether a control command should be blocked
+ * (mirrors openclaw's resolveControlCommandGate)
+ */
+function resolveControlCommandGate(params) {
+  const commandAuthorized = resolveCommandAuthorized({
+    useAccessGroups: params.useAccessGroups,
+    authorizers: params.authorizers,
+    modeWhenAccessGroupsOff: params.modeWhenAccessGroupsOff
+  });
+  const shouldBlock = params.allowTextCommands && params.hasControlCommand && !commandAuthorized;
+  return {
+    commandAuthorized,
+    shouldBlock
+  };
+}export{DEFAULT_COMMAND_GATING_PROPS,resolveCommandAuthorized,resolveControlCommandGate};//# sourceMappingURL=command-gating.js.map

package/lib/channels/command-gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-gating.js","sources":["../../src/channels/command-gating.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AA8BI,MAAM,4BAA4B,GAAwB;AAC7D,EAAA,iBAAA,EAAiB,IAAE;AACnB,EAAA,eAAA,EAAe,KAAE;AACjB,EAAA,uBAAA,EAAuB,OAAE;iBACzB,EAAe,CAAA,GAAG,CAAA;AAClB,EAAA,eAAA,EAAe;;AAGnB;AACA;AACA;AAEA;;AAEG;AACG,SAAU,wBAAwB,CAAC,MAIxC,EAAA;AACG,EAAA,MAAA;AACA,IAAA,eAAa;IAEb;YACQ;AAAkB,EAAA,MAAA,IAAA,GAAA,8BAAY,IAAA,OAAA;sBACrB,EAAA;AAAQ,IAAA,IAAA,IAAA,KAAA,OAAY,EAAC,OAAA,IAAA;QAClC,IAAA,KAAA,MAAA,EAAA,OAAwB,KAAA;AACxB;AACA,IAAA,MAAA,aAAK,GAAa,WAAA,CAAA,IAAA,CAAA,KAAA,IAAA,KAAA,CAAA,UAAA,CAAA;AAAE,IAAA,IAAA,CAAA,eAAY,OAAA,IAAA;AAChC,IAAA,OAAA,gBAAmB,CAAA,KAAM,SAAS,CAAC,UAAM,IAAA,KAAU,CAAI,OAAM,CAAA;;AAGjE,EAAA,OAAA,gBAAmB,CAAA,SAAW,KAAK,CAAA,UAAM,IAAU,aAAU,CAAA;AACjE;AAEA;;;AAGG;AACG,SAAU,yBAAyB,CAAC,MAMzC,EAAA;QACG,iBAAM,GAAiB,wBAAG,CAAA;mBACtB,EAAA,MAAiB,CAAA,eAAO;eACxB,EAAA,MAAa,CAAA,WAAO;2BACpB,EAAA,MAAyB,CAAA;AAC5B,GAAA,CAAA;AAED,EAAA,MAAA,WAAM,GAAW,MAAG,CAAA,iBAAO,IAAiB,MAAI,CAAA,iBAAO,IAAiB,CAAA,iBAAK;AAC7E,EAAA,OAAA;AACJ,IAAC,iBAAA;;;"}

package/lib/channels/conversation-label.d.ts

@@ -0,0 +1,23 @@
+export interface IConversationContext {
+    /** Explicit conversation label override */
+    conversationLabel?: string;
+    /** Thread label */
+    threadLabel?: string;
+    /** Chat type (direct, group, channel, thread) */
+    chatType?: string;
+    /** Sender name */
+    senderName?: string;
+    /** From identifier */
+    from?: string;
+    /** Group channel name */
+    groupChannel?: string;
+    /** Group subject */
+    groupSubject?: string;
+    /** Channel title */
+    channelTitle?: string;
+}
+/**
+ * Resolves a human-readable conversation label from context
+ * (mirrors openclaw's resolveConversationLabel)
+ */
+export declare function resolveConversationLabel(ctx: IConversationContext): string | undefined;

package/lib/channels/conversation-label.js

@@ -0,0 +1,43 @@
+import {normalizeChatType}from'./types.js';/**
+ * Conversation label resolution - inspired by openclaw's conversation-label,
+ * adapted to messenger-box's domain model.
+ *
+ * Resolves human-readable labels for conversations from channel/post context,
+ * handling direct messages, groups, threads, and public channels.
+ */
+// ---------------------------------------------------------------------------
+// Label Resolution
+// ---------------------------------------------------------------------------
+function extractConversationId(from) {
+  const trimmed = from?.trim();
+  if (!trimmed) return undefined;
+  const parts = trimmed.split(':').filter(Boolean);
+  return parts.length > 0 ? parts[parts.length - 1] : trimmed;
+}
+function shouldAppendId(id) {
+  // Append numeric IDs or special identifiers
+  if (/^[0-9]+$/.test(id)) return true;
+  return false;
+}
+/**
+ * Resolves a human-readable conversation label from context
+ * (mirrors openclaw's resolveConversationLabel)
+ */
+function resolveConversationLabel(ctx) {
+  const explicit = ctx.conversationLabel?.trim();
+  if (explicit) return explicit;
+  const threadLabel = ctx.threadLabel?.trim();
+  if (threadLabel) return threadLabel;
+  const chatType = normalizeChatType(ctx.chatType);
+  if (chatType === 'direct') {
+    return ctx.senderName?.trim() || ctx.from?.trim() || undefined;
+  }
+  const base = ctx.groupChannel?.trim() || ctx.groupSubject?.trim() || ctx.channelTitle?.trim() || ctx.from?.trim() || '';
+  if (!base) return undefined;
+  const id = extractConversationId(ctx.from);
+  if (!id) return base;
+  if (!shouldAppendId(id)) return base;
+  if (base === id) return base;
+  if (base.includes(id)) return base;
+  return `${base} id:${id}`;
+}export{resolveConversationLabel};//# sourceMappingURL=conversation-label.js.map

package/lib/channels/conversation-label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-label.js","sources":["../../src/channels/conversation-label.ts"],"sourcesContent":[null],"names":[],"mappings":"2CAAA;;;;;;AAMG;AA0BH;AACA;AACA;AAEA,SAAS,qBAAqB,CAAC,IAAa,EAAA;AACxC,EAAA,MAAA,UAAa,IAAG,EAAI,IAAE,EAAI;AAC1B,EAAA,IAAA,CAAA,OAAK,EAAO,OAAA,SAAA;AAAE,EAAA,MAAA,KAAA,WAAgB,KAAC,CAAA,GAAA,CAAA,CAAA,MAAA,CAAA,OAAA,CAAA;AAC/B,EAAA,OAAA,KAAM,CAAK,MAAG,GAAA,CAAO,GAAC,KAAM,CAAA,KAAK,CAAA,MAAO,GAAA,CAAA,CAAO,GAAE,OAAA;;AAErD,SAAC,cAAA,CAAA,EAAA,EAAA;AAED;MACI,UAAA,CAAA,IAAA,CAAA,EAAA,CAAA,EAAA,OAAA,IAAA;AACA,EAAA,OAAI,KAAA;AAAqB;AACzB;AACJ;AAEA;;;AAGG,EAAA,MAAA,QAAA,GAAA,GAAA,CAAA,iBAAA,EAAA,IAAA,EAAA;AACH,EAAA,IAAM,QAAA,EAAU,OAAA,QAAA;QACZ,cAAiB,GAAI,kBAAiB,EAAE;AACxC,EAAA,IAAA,WAAY,EAAA,OAAA,WAAA;AAAE,EAAA,MAAA,4BAAgB,CAAA,GAAA,CAAA,QAAA,CAAA;MAE9B,QAAM,KAAA,QAAiB;AACvB,IAAA,OAAI,GAAA,CAAA,UAAW,EAAA,IAAA,EAAA,IAAA,GAAA,CAAA,IAAA,EAAA,IAAA,EAAA,IAAA,SAAA;AAAE,EAAA;QAEjB,IAAM,GAAA,GAAQ,aAAG,EAAA,IAAA,EAAkB,IAAI,GAAA,CAAA,YAAU,EAAA,IAAA,EAAA,IAAA,GAAA,CAAA,YAAA,EAAA,IAAA,EAAA,IAAA,GAAA,CAAA,IAAA,EAAA,IAAA,EAAA,IAAA,EAAA;AACjD,EAAA,IAAA,CAAA,IAAI,EAAA,OAAQ,SAAa;AACrB,EAAA,MAAA,EAAA,GAAA,sBAA2B,GAAE,CAAA,IAAI,CAAG;MACvC,CAAA,EAAA,EAAA,OAAA,IAAA;AAED,EAAA,IAAA,CAAA,cACQ,CAAA,EAAA,CAAA,EAAA,OAAY,IAAE;AACtB,EAAA,IAAA,IAAK,KAAI,EAAA,EAAA,OAAA,IAAA;AAAE,EAAA,IAAA,IAAA,CAAA,cAAiB,OAAA,IAAA;SAE5B,CAAM,EAAE,IAAG,CAAA,IAAA,EAAA,EAAA,CAAA,CAAA;AACX"}

package/lib/channels/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Channels module - barrel export
+ *
+ * Provides openclaw-inspired channel features adapted to
+ * messenger-box's Props architecture. All channel-related
+ * types, utilities, and configuration are exported from here.
+ */
+export * from './types';
+export * from './registry';
+export * from './typing';
+export * from './ack-reactions';
+export * from './conversation-label';
+export * from './sender-identity';
+export * from './command-gating';
+export * from './allowlist-match';
+export * from './mention-gating';
+export * from './session';
+export * from './channel-config';

package/lib/channels/mention-gating.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Mention gating - inspired by openclaw's mention-gating,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Controls how @mentions interact with message routing in group channels,
+ * supporting require-mention, bypass, and detection logic.
+ */
+export interface IMentionGatingProps {
+    /** Whether @mention is required in groups for message processing */
+    requireMentionInGroups: boolean;
+    /** Whether to strip mentions from message text before processing */
+    stripMentions: boolean;
+    /** Patterns to strip from mentions (regex strings) */
+    stripPatterns: string[];
+    /** Whether unmentioned group messages are silently ignored */
+    silentIgnoreUnmentioned: boolean;
+}
+export declare const DEFAULT_MENTION_GATING_PROPS: IMentionGatingProps;
+export interface IMentionCheckParams {
+    /** The message text */
+    messageText: string;
+    /** Self user ID to check mentions against */
+    selfUserId?: string;
+    /** Self username to check mentions against */
+    selfUsername?: string;
+    /** Additional patterns to match as mentions */
+    additionalPatterns?: string[];
+}
+/**
+ * Checks whether the current user was mentioned in the message
+ */
+export declare function wasMentioned(params: IMentionCheckParams): boolean;
+/**
+ * Strips mention patterns from message text
+ */
+export declare function stripMentionsFromText(text: string, patterns: string[]): string;
+export interface IMentionGateParams {
+    /** Whether group mention is required */
+    requireMention: boolean;
+    /** Whether the current context is a group */
+    isGroup: boolean;
+    /** Whether mention was detected */
+    wasMentioned: boolean;
+    /** Whether to bypass mention requirement */
+    bypassMention?: boolean;
+}
+/**
+ * Determines whether a message should be processed based on mention gating
+ */
+export declare function shouldProcessMessage(params: IMentionGateParams): boolean;

package/lib/channels/mention-gating.js

@@ -0,0 +1,72 @@
+/**
+ * Mention gating - inspired by openclaw's mention-gating,
+ * adapted to messenger-box's Props architecture.
+ *
+ * Controls how @mentions interact with message routing in group channels,
+ * supporting require-mention, bypass, and detection logic.
+ */
+const DEFAULT_MENTION_GATING_PROPS = {
+  requireMentionInGroups: true,
+  stripMentions: true,
+  stripPatterns: [],
+  silentIgnoreUnmentioned: true
+};
+/**
+ * Checks whether the current user was mentioned in the message
+ */
+function wasMentioned(params) {
+  const {
+    messageText,
+    selfUserId,
+    selfUsername,
+    additionalPatterns
+  } = params;
+  if (!messageText) return false;
+  const text = messageText.toLowerCase();
+  // Check for @userId mention
+  if (selfUserId && text.includes(`@${selfUserId.toLowerCase()}`)) {
+    return true;
+  }
+  // Check for @username mention
+  if (selfUsername && text.includes(`@${selfUsername.toLowerCase()}`)) {
+    return true;
+  }
+  // Check additional patterns
+  if (additionalPatterns) {
+    for (const pattern of additionalPatterns) {
+      try {
+        const regex = new RegExp(pattern, 'i');
+        if (regex.test(messageText)) return true;
+      } catch {
+        // Skip invalid patterns
+      }
+    }
+  }
+  return false;
+}
+/**
+ * Strips mention patterns from message text
+ */
+function stripMentionsFromText(text, patterns) {
+  let result = text;
+  for (const pattern of patterns) {
+    try {
+      const regex = new RegExp(pattern, 'gi');
+      result = result.replace(regex, '').trim();
+    } catch {
+      // Skip invalid patterns
+    }
+  }
+  return result.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Determines whether a message should be processed based on mention gating
+ */
+function shouldProcessMessage(params) {
+  // Non-group messages always proceed
+  if (!params.isGroup) return true;
+  // If mentions aren't required, always proceed
+  if (!params.requireMention) return true;
+  // If mentioned or bypassed, proceed
+  return params.wasMentioned || params.bypassMention === true;
+}export{DEFAULT_MENTION_GATING_PROPS,shouldProcessMessage,stripMentionsFromText,wasMentioned};//# sourceMappingURL=mention-gating.js.map

package/lib/channels/mention-gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-gating.js","sources":["../../src/channels/mention-gating.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AAiBI,MAAM,4BAA4B,GAAwB;AAC7D,EAAA,sBAAA,EAAsB,IAAE;AACxB,EAAA,aAAA,EAAa,IAAE;AACf,EAAA,aAAA,EAAa,EAAE;AACf,EAAA,uBAAA,EAAuB;;AAkB3B;;AAEG;AACG,SAAU,YAAY,CAAC,MAA2B,EAAA;QACpD;AACA,IAAA,WAAK;AAAa,IAAA,UAAA;AAElB,IAAA,YAAU;IAEV;AACA,GAAA,GAAA,MAAI;AACA,EAAA,IAAA,CAAA,aAAY,OAAA,KAAA;QACf,IAAA,GAAA,WAAA,CAAA,WAAA,EAAA;;AAGD,EAAA,IAAA,UAAI,IAAY,IAAI,CAAA,aAAc,UAAI,CAAA,WAAa,EAAA,CAAA,CAAA,CAAA,EAAW;AAC1D,IAAA,OAAA,IAAO;;;MAIX,YAAI,IAAA,IAAkB,SAAG,CAAA,CAAA,CAAA,EAAA,YAAA,CAAA,WAAA,EAAA,CAAA,CAAA,CAAA,EAAA;AACrB,IAAA,OAAA,IAAK;AACD,EAAA;;AAEI,EAAA,IAAA,kBAAI,EAAM;AAAmB,IAAA,KAAA,MAAA,OAAA,IAAA,kBAAY,EAAA;;AAC3C,QAAA,MAAA,KAAO,GAAA,IAAA,MAAA,CAAA,OAAA,EAAA,GAAA,CAAA;iBACL,CAAA,IAAA,CAAA,WAAA,CAAA,EAAA,OAAwB,IAAA;cAC3B;;MAER;AAED,IAAA;AACJ,EAAC;AAED,EAAA,OAAA,KAAA;;AAEG;AACH;;AAEI,SAAW,qBAAsB,CAAA,IAAA,EAAA,QAAA,EAAA;AAC7B,EAAA,IAAA,MAAI,GAAC,IAAA;aACD,OAAM,YAAY,EAAA;AAClB,IAAA,IAAA;YACH,KAAA,GAAA,IAAA,MAAA,CAAA,OAAA,EAAA,IAAA,CAAA;AAAC,MAAA,MAAA,GAAO,MAAA,CAAA,OAAA,CAAA,KAAA,EAAA,EAAA,CAAA,CAAA,IAAA,EAAA;YACL;;IAER;;AAEJ,EAAC,OAAA,MAAA,CAAA,OAAA,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,IAAA,EAAA;AAiBD;;AAEG;AACH;AACI,SAAA,oBAAA,CAAA,MAAoC,EAAA;;AACf,EAAA,IAAA,CAAA,MAAA,CAAA,OAAY,EAAA,OAAA,IAAA;;MAGjC,CAAA,MAAK,CAAA,cAAO,EAAc,OAAA,IAAA;AAAE;SAE5B,MAAA,CAAA,YAAA,IAAA,MAAA,CAAA,aAAoC,KAAA,IAAA;"}