feat(signal): add chunkDelay for realistic typing delays between message chunks

When a long message is split into multiple chunks, this adds configurable
delays between sends to simulate natural typing speed.

Config example:
  channels.signal.chunkDelay = { mode: 'natural' }

Options:
  - mode: 'off' | 'natural' | 'custom' (default: 'off')
  - perCharMs: ms per character (default: 30, ~40 WPM)
  - baseMs: minimum delay between chunks (default: 500ms)
  - maxMs: delay cap (default: 5000ms)
  - jitter: randomness factor 0-1 (default: 0.2)

During the delay, a typing indicator is sent so the recipient
sees 'typing...' between chunks.

Closes #TBD
This commit is contained in:
Claire 2026-01-30 08:53:22 +00:00
parent 445b58550c
commit 3f26c87156
7 changed files with 81 additions and 3 deletions

View File

@ -47,6 +47,14 @@ export type HumanDelayConfig = {
maxMs?: number; maxMs?: number;
}; };
export type ChunkDelayConfig = {
mode?: "off" | "natural" | "custom";
perCharMs?: number;
baseMs?: number;
maxMs?: number;
jitter?: number;
};
export type SessionSendPolicyAction = "allow" | "deny"; export type SessionSendPolicyAction = "allow" | "deny";
export type SessionSendPolicyMatch = { export type SessionSendPolicyMatch = {
channel?: string; channel?: string;

View File

@ -1,5 +1,6 @@
import type { import type {
BlockStreamingCoalesceConfig, BlockStreamingCoalesceConfig,
ChunkDelayConfig,
DmPolicy, DmPolicy,
GroupPolicy, GroupPolicy,
MarkdownConfig, MarkdownConfig,
@ -66,6 +67,8 @@ export type SignalAccountConfig = {
reactionAllowlist?: Array<string | number>; reactionAllowlist?: Array<string | number>;
/** Heartbeat visibility settings for this channel. */ /** Heartbeat visibility settings for this channel. */
heartbeat?: ChannelHeartbeatVisibilityConfig; heartbeat?: ChannelHeartbeatVisibilityConfig;
/** Chunk delay config for realistic typing delays between message chunks. */
chunkDelay?: ChunkDelayConfig;
}; };
export type SignalConfig = { export type SignalConfig = {

View File

@ -221,6 +221,16 @@ export const HumanDelaySchema = z
}) })
.strict(); .strict();
export const ChunkDelaySchema = z
.object({
mode: z.union([z.literal("off"), z.literal("natural"), z.literal("custom")]).optional(),
perCharMs: z.number().int().nonnegative().optional(),
baseMs: z.number().int().nonnegative().optional(),
maxMs: z.number().int().nonnegative().optional(),
jitter: z.number().min(0).max(1).optional(),
})
.strict();
export const CliBackendSchema = z export const CliBackendSchema = z
.object({ .object({
command: z.string(), command: z.string(),

View File

@ -3,6 +3,7 @@ import { z } from "zod";
import { import {
BlockStreamingChunkSchema, BlockStreamingChunkSchema,
BlockStreamingCoalesceSchema, BlockStreamingCoalesceSchema,
ChunkDelaySchema,
DmConfigSchema, DmConfigSchema,
DmPolicySchema, DmPolicySchema,
ExecutableTokenSchema, ExecutableTokenSchema,
@ -430,6 +431,7 @@ export const SignalAccountSchemaBase = z
reactionNotifications: z.enum(["off", "own", "all", "allowlist"]).optional(), reactionNotifications: z.enum(["off", "own", "all", "allowlist"]).optional(),
reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(), reactionAllowlist: z.array(z.union([z.string(), z.number()])).optional(),
heartbeat: ChannelHeartbeatVisibilitySchema, heartbeat: ChannelHeartbeatVisibilitySchema,
chunkDelay: ChunkDelaySchema.optional(),
}) })
.strict(); .strict();

View File

@ -1,6 +1,7 @@
import { chunkText, resolveTextChunkLimit } from "../auto-reply/chunk.js"; import { chunkText, resolveTextChunkLimit } from "../auto-reply/chunk.js";
import { DEFAULT_GROUP_HISTORY_LIMIT, type HistoryEntry } from "../auto-reply/reply/history.js"; import { DEFAULT_GROUP_HISTORY_LIMIT, type HistoryEntry } from "../auto-reply/reply/history.js";
import type { ReplyPayload } from "../auto-reply/types.js"; import type { ReplyPayload } from "../auto-reply/types.js";
import type { ChunkDelayConfig } from "../config/types.base.js";
import type { ClawdbotConfig } from "../config/config.js"; import type { ClawdbotConfig } from "../config/config.js";
import { loadConfig } from "../config/config.js"; import { loadConfig } from "../config/config.js";
import type { SignalReactionNotificationMode } from "../config/types.js"; import type { SignalReactionNotificationMode } from "../config/types.js";
@ -13,7 +14,7 @@ import { signalCheck, signalRpcRequest } from "./client.js";
import { spawnSignalDaemon } from "./daemon.js"; import { spawnSignalDaemon } from "./daemon.js";
import { isSignalSenderAllowed, type resolveSignalSender } from "./identity.js"; import { isSignalSenderAllowed, type resolveSignalSender } from "./identity.js";
import { createSignalEventHandler } from "./monitor/event-handler.js"; import { createSignalEventHandler } from "./monitor/event-handler.js";
import { sendMessageSignal } from "./send.js"; import { sendMessageSignal, sendTypingSignal } from "./send.js";
import { runSignalSseLoop } from "./sse-reconnect.js"; import { runSignalSseLoop } from "./sse-reconnect.js";
type SignalReactionMessage = { type SignalReactionMessage = {
@ -205,6 +206,37 @@ async function fetchAttachment(params: {
return { path: saved.path, contentType: saved.contentType }; return { path: saved.path, contentType: saved.contentType };
} }
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
const CHUNK_DELAY_DEFAULTS = {
perCharMs: 30,
baseMs: 500,
maxMs: 5000,
jitter: 0.2,
};
function computeChunkDelay(config: ChunkDelayConfig, chunkLength: number): number {
const mode = config.mode ?? "off";
if (mode === "off") return 0;
const perCharMs = config.perCharMs ?? CHUNK_DELAY_DEFAULTS.perCharMs;
const baseMs = config.baseMs ?? CHUNK_DELAY_DEFAULTS.baseMs;
const maxMs = config.maxMs ?? CHUNK_DELAY_DEFAULTS.maxMs;
const jitter = config.jitter ?? CHUNK_DELAY_DEFAULTS.jitter;
let delayMs = baseMs + chunkLength * perCharMs;
delayMs = Math.min(delayMs, maxMs);
// Apply jitter: random variance within ±jitter range
if (jitter > 0) {
const variance = delayMs * jitter;
delayMs += (Math.random() * 2 - 1) * variance;
delayMs = Math.max(0, Math.round(delayMs));
}
return delayMs;
}
async function deliverReplies(params: { async function deliverReplies(params: {
replies: ReplyPayload[]; replies: ReplyPayload[];
target: string; target: string;
@ -214,14 +246,31 @@ async function deliverReplies(params: {
runtime: RuntimeEnv; runtime: RuntimeEnv;
maxBytes: number; maxBytes: number;
textLimit: number; textLimit: number;
chunkDelay?: ChunkDelayConfig;
}) { }) {
const { replies, target, baseUrl, account, accountId, runtime, maxBytes, textLimit } = params; const { replies, target, baseUrl, account, accountId, runtime, maxBytes, textLimit, chunkDelay } =
params;
for (const payload of replies) { for (const payload of replies) {
const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []); const mediaList = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
const text = payload.text ?? ""; const text = payload.text ?? "";
if (!text && mediaList.length === 0) continue; if (!text && mediaList.length === 0) continue;
if (mediaList.length === 0) { if (mediaList.length === 0) {
for (const chunk of chunkText(text, textLimit)) { const chunks = chunkText(text, textLimit);
let isFirst = true;
for (const chunk of chunks) {
if (!isFirst && chunkDelay) {
const delayMs = computeChunkDelay(chunkDelay, chunk.length);
if (delayMs > 0) {
// Send typing indicator during delay
try {
await sendTypingSignal(target, { baseUrl, account, accountId });
} catch {
/* typing failure is non-fatal */
}
await sleep(delayMs);
}
}
isFirst = false;
await sendMessageSignal(target, chunk, { await sendMessageSignal(target, chunk, {
baseUrl, baseUrl,
account, account,
@ -280,6 +329,7 @@ export async function monitorSignalProvider(opts: MonitorSignalOpts = {}): Promi
const mediaMaxBytes = (opts.mediaMaxMb ?? accountInfo.config.mediaMaxMb ?? 8) * 1024 * 1024; const mediaMaxBytes = (opts.mediaMaxMb ?? accountInfo.config.mediaMaxMb ?? 8) * 1024 * 1024;
const ignoreAttachments = opts.ignoreAttachments ?? accountInfo.config.ignoreAttachments ?? false; const ignoreAttachments = opts.ignoreAttachments ?? accountInfo.config.ignoreAttachments ?? false;
const sendReadReceipts = Boolean(opts.sendReadReceipts ?? accountInfo.config.sendReadReceipts); const sendReadReceipts = Boolean(opts.sendReadReceipts ?? accountInfo.config.sendReadReceipts);
const chunkDelay = accountInfo.config.chunkDelay;
const autoStart = opts.autoStart ?? accountInfo.config.autoStart ?? !accountInfo.config.httpUrl; const autoStart = opts.autoStart ?? accountInfo.config.autoStart ?? !accountInfo.config.httpUrl;
const readReceiptsViaDaemon = Boolean(autoStart && sendReadReceipts); const readReceiptsViaDaemon = Boolean(autoStart && sendReadReceipts);
@ -339,6 +389,7 @@ export async function monitorSignalProvider(opts: MonitorSignalOpts = {}): Promi
ignoreAttachments, ignoreAttachments,
sendReadReceipts, sendReadReceipts,
readReceiptsViaDaemon, readReceiptsViaDaemon,
chunkDelay,
fetchAttachment, fetchAttachment,
deliverReplies, deliverReplies,
resolveSignalReactionTargets, resolveSignalReactionTargets,

View File

@ -207,6 +207,7 @@ export function createSignalEventHandler(deps: SignalEventHandlerDeps) {
runtime: deps.runtime, runtime: deps.runtime,
maxBytes: deps.mediaMaxBytes, maxBytes: deps.mediaMaxBytes,
textLimit: deps.textLimit, textLimit: deps.textLimit,
chunkDelay: deps.chunkDelay,
}); });
}, },
onError: (err, info) => { onError: (err, info) => {

View File

@ -1,6 +1,7 @@
import type { HistoryEntry } from "../../auto-reply/reply/history.js"; import type { HistoryEntry } from "../../auto-reply/reply/history.js";
import type { ReplyPayload } from "../../auto-reply/types.js"; import type { ReplyPayload } from "../../auto-reply/types.js";
import type { ClawdbotConfig } from "../../config/config.js"; import type { ClawdbotConfig } from "../../config/config.js";
import type { ChunkDelayConfig } from "../../config/types.base.js";
import type { DmPolicy, GroupPolicy, SignalReactionNotificationMode } from "../../config/types.js"; import type { DmPolicy, GroupPolicy, SignalReactionNotificationMode } from "../../config/types.js";
import type { RuntimeEnv } from "../../runtime.js"; import type { RuntimeEnv } from "../../runtime.js";
import type { SignalSender } from "../identity.js"; import type { SignalSender } from "../identity.js";
@ -78,6 +79,7 @@ export type SignalEventHandlerDeps = {
ignoreAttachments: boolean; ignoreAttachments: boolean;
sendReadReceipts: boolean; sendReadReceipts: boolean;
readReceiptsViaDaemon: boolean; readReceiptsViaDaemon: boolean;
chunkDelay?: ChunkDelayConfig;
fetchAttachment: (params: { fetchAttachment: (params: {
baseUrl: string; baseUrl: string;
account?: string; account?: string;
@ -95,6 +97,7 @@ export type SignalEventHandlerDeps = {
runtime: RuntimeEnv; runtime: RuntimeEnv;
maxBytes: number; maxBytes: number;
textLimit: number; textLimit: number;
chunkDelay?: ChunkDelayConfig;
}) => Promise<void>; }) => Promise<void>;
resolveSignalReactionTargets: (reaction: SignalReactionMessage) => SignalReactionTarget[]; resolveSignalReactionTargets: (reaction: SignalReactionMessage) => SignalReactionTarget[];
isSignalReactionMessage: ( isSignalReactionMessage: (