openclaw/src/shared/silent-reply-policy.ts

import { normalizeLowercaseStringOrEmpty } from "./string-coerce.js";

export type SilentReplyPolicy = "allow" | "disallow";
export type SilentReplyMode = "allow" | "rewrite";
export type SilentReplyConversationType = "direct" | "group" | "internal";
export type SilentReplyPolicyShape = Partial<
  Record<SilentReplyConversationType, SilentReplyPolicy>
>;
export type SilentReplyRewriteShape = Partial<Record<SilentReplyConversationType, boolean>>;

export const DEFAULT_SILENT_REPLY_POLICY: Record<SilentReplyConversationType, SilentReplyPolicy> = {
  direct: "disallow",
  group: "allow",
  internal: "allow",
};

export const DEFAULT_SILENT_REPLY_REWRITE: Record<SilentReplyConversationType, boolean> = {
  direct: true,
  group: false,
  internal: false,
};

const SILENT_REPLY_REWRITE_TEXTS = [
  "Nothing to add right now.",
  "All quiet on my side.",
  "No extra notes from me.",
  "Standing by.",
  "No update from me on this one.",
  "Nothing further to report.",
  "I have nothing else to add.",
  "No follow-up needed from me.",
  "No additional reply from me here.",
  "No extra comment on my end.",
  "No further note from me.",
  "That is all from me for now.",
  "No added response from me.",
  "Nothing else to say here.",
  "No extra message needed from me.",
  "No additional note on this one.",
  "No further response from me.",
  "Nothing new to add from my side.",
  "No extra update from me.",
  "I have no further reply here.",
  "Nothing additional from me.",
  "No added note from my side.",
  "No more to report from me.",
  "No extra reply needed here.",
  "No further word from me.",
  "Nothing further on my end.",
  "No extra answer from me.",
  "No additional response from my side.",
] as const;

function hashSeed(seed: string): number {
  let hash = 0;
  for (let index = 0; index < seed.length; index += 1) {
    hash = (hash * 31 + seed.charCodeAt(index)) >>> 0;
  }
  return hash;
}

export function classifySilentReplyConversationType(params: {
  sessionKey?: string;
  surface?: string;
  conversationType?: SilentReplyConversationType;
}): SilentReplyConversationType {
  if (params.conversationType) {
    return params.conversationType;
  }
  const normalizedSessionKey = normalizeLowercaseStringOrEmpty(params.sessionKey);
  if (normalizedSessionKey.includes(":group:") || normalizedSessionKey.includes(":channel:")) {
    return "group";
  }
  if (normalizedSessionKey.includes(":direct:") || normalizedSessionKey.includes(":dm:")) {
    return "direct";
  }
  const normalizedSurface = normalizeLowercaseStringOrEmpty(params.surface);
  if (normalizedSurface === "webchat") {
    return "direct";
  }
  return "internal";
}

export function resolveSilentReplyPolicyFromPolicies(params: {
  conversationType: SilentReplyConversationType;
  defaultPolicy?: SilentReplyPolicyShape;
  surfacePolicy?: SilentReplyPolicyShape;
}): SilentReplyPolicy {
  return (
    params.surfacePolicy?.[params.conversationType] ??
    params.defaultPolicy?.[params.conversationType] ??
    DEFAULT_SILENT_REPLY_POLICY[params.conversationType]
  );
}

export function resolveSilentReplyRewriteFromPolicies(params: {
  conversationType: SilentReplyConversationType;
  defaultRewrite?: SilentReplyRewriteShape;
  surfaceRewrite?: SilentReplyRewriteShape;
}): boolean {
  return (
    params.surfaceRewrite?.[params.conversationType] ??
    params.defaultRewrite?.[params.conversationType] ??
    DEFAULT_SILENT_REPLY_REWRITE[params.conversationType]
  );
}

export function resolveSilentReplyRewriteText(params: { seed?: string }): string {
  const seed = params.seed?.trim() || "silent-reply";
  const index = hashSeed(seed) % SILENT_REPLY_REWRITE_TEXTS.length;
  return SILENT_REPLY_REWRITE_TEXTS[index] ?? SILENT_REPLY_REWRITE_TEXTS[0];
}