@diegoaltoworks/chatter 0.60.0 → 0.62.0

package/dist/channels/matrix/sync.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The `/sync` long-poll loop, isolated from both the HTTP client and the
+ * channel so its failure behaviour is testable without either — the same
+ * shape as `../telegram/poll.ts`'s `runLongPoll`, adapted to Matrix's
+ * `since`-token pagination instead of an acknowledged offset.
+ *
+ * The property that matters: a homeserver that is down, rate-limiting, or
+ * rejecting the token must never turn into a tight retry loop. Every
+ * failure backs off exponentially, and `M_LIMIT_EXCEEDED`'s own
+ * `retry_after_ms` wins over that backoff when the homeserver sends one.
+ */
+import { type Logger } from "../../core/logger";
+import { type MatrixSyncResponse } from "./api";
+/** Exponential backoff: 2s, 4s, 8s ... capped at a minute. `failures` is the count including the one just seen. */
+export declare function syncBackoffMs(failures: number): number;
+/**
+ * How long to wait after a failed sync. `M_LIMIT_EXCEEDED`'s
+ * `retry_after_ms` is an instruction, not a hint — honour it verbatim even
+ * when it exceeds the backoff cap, because syncing again sooner just
+ * extends the rate-limit window.
+ */
+export declare function retryDelayMs(error: unknown, failures: number): number;
+export interface MatrixSyncLoopDeps {
+    /** One `/sync` call. Rejections are backed off; they never end the loop. */
+    sync(since: string | undefined): Promise<MatrixSyncResponse>;
+    /** Per-batch work. A throw is logged and skipped — one bad batch never stops the loop. */
+    handleSync(response: MatrixSyncResponse): Promise<void>;
+    /** Checked before every sync, and again after a failure, so `stop()` cuts the loop instead of sleeping out a backoff first. */
+    isStopped(): boolean;
+    /** Overridable for tests; a real channel passes a `setTimeout`-based sleep. */
+    sleep(ms: number): Promise<void>;
+    /** Where this loop's `since` token resumes from. Omitted = an initial full sync. */
+    initialSince?: string;
+    /** Called with each newly acknowledged `since` token, for a host that persists it. */
+    onSince?(since: string): void;
+    logger?: Logger;
+    /** Prefix for log lines, e.g. `Matrix[@bot:example.org]`. */
+    label?: string;
+}
+/**
+ * Syncs until `isStopped()`, resolving with the last `since` token reached
+ * (what a restart would resume from).
+ *
+ * The token advances BEFORE the batch is handled, matching the Telegram
+ * poll loop's offset-first ordering: a handler that throws on one bad
+ * batch must not make the homeserver redeliver it forever, which would
+ * wedge the loop on a single poison event and starve every later one. It
+ * advances only for a batch this loop is actually going to handle, though:
+ * a stop that lands between the sync and the handler leaves the token where
+ * it was, so a restart resumes at the unhandled batch rather than past it.
+ */
+export declare function runMatrixSyncLoop(deps: MatrixSyncLoopDeps): Promise<string | undefined>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/channels/matrix/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/channels/matrix/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAKhE,mHAAmH;AACnH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7D,0FAA0F;IAC1F,UAAU,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,+HAA+H;IAC/H,SAAS,IAAI,OAAO,CAAC;IACrB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoC7F"}

package/dist/channels/matrix/updates.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Matrix room event -> {@link ChannelMessage}: the transport's own half of
+ * the channel contract (see docs/build-a-channel.md), kept pure so mention,
+ * reply-to and DM detection are testable without a network or a running
+ * channel.
+ *
+ * Addressing parity with the other built-in channels is the point of this
+ * module. WhatsApp and Telegram both resolve "was the bot addressed?" from
+ * transport-native structures; Matrix resolves it from the stable
+ * `m.mentions` field (MSC3952, in the spec since v1.7) with a pill-in-HTML
+ * fallback for clients that only set that. The gate policy that consumes
+ * those booleans (`decideChannelAction`) is identical for every channel.
+ */
+import type { ChannelMessage } from "../gates";
+import type { MatrixAccountDataEvent, MatrixEvent, MatrixInvitedRoom } from "./api";
+/** The bot's own identity, as `whoami` reports it. */
+export interface MatrixIdentity {
+    userId: string;
+}
+interface MatrixMentions {
+    user_ids?: string[];
+    room?: boolean;
+}
+interface MatrixInReplyTo {
+    event_id?: string;
+}
+interface MatrixRelatesTo {
+    /** `m.replace` for an edit, `m.annotation` for a reaction, `m.thread` for a threaded message. Absent on a plain reply. */
+    rel_type?: string;
+    event_id?: string;
+    "m.in_reply_to"?: MatrixInReplyTo;
+}
+interface MatrixMessageContent {
+    msgtype?: string;
+    body?: string;
+    format?: string;
+    formatted_body?: string;
+    "m.mentions"?: MatrixMentions;
+    "m.relates_to"?: MatrixRelatesTo;
+}
+/** The message text, or "" for an event this channel doesn't render as text (a redaction, a non-text msgtype with no body). */
+export declare function messageText(content: MatrixMessageContent): string;
+export declare function mentionsBot(content: MatrixMessageContent, me: MatrixIdentity): boolean;
+/**
+ * Was this message a reply to one the bot sent? `sentEventIds` is the
+ * session's own record of event ids it has sent (see `./channel`) — Matrix
+ * has no cheap "who sent event X" lookup without fetching that event, and a
+ * bot only ever needs to recognise its OWN messages, which it already knows
+ * without asking the server.
+ */
+export declare function isReplyToBot(content: MatrixMessageContent, sentEventIds: ReadonlySet<string>): boolean;
+/** How many of the session's own sent event ids {@link isReplyToBot} remembers — bounded so a long-running bot's memory doesn't grow with every message it ever sent. */
+export declare const MAX_TRACKED_SENT_EVENTS = 500;
+/** Records `eventId` as one of ours, evicting the oldest entry first once the set is at capacity (`Set` iterates in insertion order, so the first value is the oldest). */
+export declare function recordSentEventId(sentEventIds: Set<string>, eventId: string): void;
+/**
+ * The `m.direct` account-data document: peer user id -> the rooms that are
+ * direct messages with that peer. Matrix has no per-room "this is a DM"
+ * flag, so this mapping is the only thing that tells one from a group.
+ */
+export type MatrixDirectMapping = Record<string, string[]>;
+/** Raw `m.direct` content (whatever the homeserver stored) narrowed to peer -> room ids, dropping any entry that isn't a non-empty array of strings. */
+export declare function toDirectMapping(content: Record<string, unknown> | undefined): MatrixDirectMapping;
+/** Every room id in a mapping, across every peer. A room absent from it is treated as a group and needs addressing, the safer default. */
+export declare function directMappingRooms(mapping: MatrixDirectMapping): Set<string>;
+/** The `m.direct` mapping carried by a sync batch's account data, or `undefined` when this batch says nothing about it (an unrelated account-data change must not be read as "no DMs"). */
+export declare function directMappingFromEvents(accountDataEvents: MatrixAccountDataEvent[]): MatrixDirectMapping | undefined;
+/** Room ids the homeserver's `m.direct` account data lists as direct messages, across every peer. */
+export declare function directRoomIds(accountDataEvents: MatrixAccountDataEvent[]): Set<string>;
+/**
+ * `mapping` with `roomId` recorded against `peer`, or `undefined` when it is
+ * already there, which the caller uses to skip a pointless account-data
+ * write. Never mutates the input: `m.direct` is a whole-document PUT, so the
+ * merged copy is what gets sent.
+ */
+export declare function withDirectRoom(mapping: MatrixDirectMapping, peer: string, roomId: string): MatrixDirectMapping | undefined;
+/**
+ * The inviting user id when this invite is for a direct-message room, else
+ * `undefined`.
+ *
+ * A client opening a DM sets `is_direct: true` on the `m.room.member` invite
+ * it sends the bot, and records the room in ITS OWN `m.direct`, never in the
+ * bot's. The invite is therefore the only moment the bot is told a room is a
+ * DM; `./handler` seeds its DM set from this and writes the room into the
+ * bot's own `m.direct` so a later restart still knows.
+ */
+export declare function directInviteFrom(room: MatrixInvitedRoom, me: MatrixIdentity): string | undefined;
+/**
+ * The {@link ChannelMessage} for a timeline event, or `undefined` when
+ * there is nothing for a chat pipeline to look at: not an `m.room.message`
+ * (a reaction, a membership change, an encrypted event this channel can't
+ * decrypt), one with no `msgtype` at all (a redacted message), or an edit of
+ * a message that was already delivered (see below).
+ */
+export declare function toChannelMessage(roomId: string, event: MatrixEvent, me: MatrixIdentity, directRooms: ReadonlySet<string>, sentEventIds: ReadonlySet<string>): ChannelMessage | undefined;
+/**
+ * A stable identity key for `bucketsFor`/`personaResolver`/`answerFn`.
+ * Namespaced so a bare Matrix user id (which is itself already `@user:
+ * server.tld`, unlike Telegram's bare numeral) never collides with another
+ * channel's key when a host shares persona/spend state across channels.
+ */
+export declare function matrixSenderKey(userId: string): string;
+export {};
+//# sourceMappingURL=updates.d.ts.map

package/dist/channels/matrix/updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.d.ts","sourceRoot":"","sources":["../../../src/channels/matrix/updates.ts"],"names":[],"mappings":"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"}

package/dist/channels/pipeline.d.ts

@@ -14,15 +14,23 @@
  * re-derive it. See docs/build-a-channel.md for a worked example.
  */
 import type OpenAI from "openai";
-import type { AnswerFn, TransformReply } from "../core/answer";
-import type { BucketsFor } from "../core/buckets";
 import type { Logger } from "../core/logger";
-import { type RerankContext, type RewriteQuery } from "../core/pipeline";
 import type { PromptLoader } from "../core/prompts";
-import type { VectorStore } from "../core/retrieval";
+import type { Retriever } from "../core/retrieval";
 import type { HistoryCompactionOptions } from "../history/compaction";
 import type { HistoryStore } from "../history/types";
+import type { BrainHooks } from "../types";
 import { type ChannelMessage } from "./gates";
+/**
+ * Resolves the brain hooks (`answerFn`, `bucketsFor`, `rewriteQuery`,
+ * `rerankContext`, `fallbackFn`, `transformReply`) for one channel: each
+ * field from `config` wins when set, falling back to the matching field on
+ * `fallback` (typically `deps.config`, the server-level `ChatterConfig`).
+ * Every channel that layers its own hooks over the server's uses this
+ * instead of hand-rolling the same six `??` lines: see `../telegram`,
+ * `../matrix` and `../whatsapp/inbound`.
+ */
+export declare function resolveBrainHooks(config: BrainHooks, fallback?: BrainHooks): BrainHooks;
 /** Where a pipeline turn's output goes. Distinct from `ChannelSender` (`./senders`) — a transport implementing this may thread/quote the chat answer without doing the same for a plain gate acknowledgement. */
 export interface InboundReplySender {
     /** Deliver the chat answer for `chatId`. */
@@ -32,23 +40,15 @@ export interface InboundReplySender {
 }
 export interface InboundPipelineDeps {
     client: OpenAI;
-    store: VectorStore;
+    store: Retriever;
     prompts: PromptLoader;
 }
-export interface InboundPipelineConfig {
+export interface InboundPipelineConfig extends BrainHooks {
     /**
      * This channel's identity for `transformReply` — e.g. "whatsapp",
      * "telegram". @default "channel"
      */
     channel?: string;
-    answerFn?: AnswerFn;
-    bucketsFor?: BucketsFor;
-    /** Rewrites the retrieval query before it reaches the vector store — see `ChatterConfig.rewriteQuery`. */
-    rewriteQuery?: RewriteQuery;
-    /** Post-processes retrieved chunks before they're folded into the prompt — see `ChatterConfig.rerankContext`. */
-    rerankContext?: RerankContext;
-    /** Modifies or vetoes the produced reply before delivery — see `ChatterConfig.transformReply`. */
-    transformReply?: TransformReply;
     model?: string;
     /** Extra system-prompt section describing the delivery channel; passed through to `prepareChat`. */
     channelHint?: string;

package/dist/channels/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/channels/pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/channels/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CASvF;AAED,iNAAiN;AACjN,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,kFAAkF;IAClF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,gFAAgF;IAChF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;;;;WAMG;QACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE;;;;;WAKG;QACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;KACvC,CAAC;IACF,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CACpF;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAA;CAAE,GACzE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAiCrC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CA2IjB"}

package/dist/channels/polling.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared config surface for a long-poll style channel (Telegram, Matrix): the
+ * gates/persona/history/rate-limit knobs `createInboundPipeline` accepts, the
+ * brain hooks (via `BrainHooks`), and the sleep/now/logger overrides tests
+ * use. Each transport extends this with its own protocol specifics (poll
+ * timeout vs. sync timeout, bot token vs. homeserver credentials, ...): see
+ * `./telegram/channel.ts` and `./matrix/channel.ts`.
+ */
+import type { Logger } from "../core/logger";
+import type { HistoryCompactionOptions } from "../history/compaction";
+import type { HistoryStore } from "../history/types";
+import type { BrainHooks } from "../types";
+export interface PollingChannelConfig extends BrainHooks {
+    /** Channel and sender-registry name. Override to run more than one bot in one process. */
+    name?: string;
+    /** Group chats eligible for a reply. Empty (default) = every group/room. Has no effect on DMs, which always reply. */
+    allowedChats?: string[];
+    model?: string;
+    /** Extra system-prompt section describing the delivery channel; passed through to `prepareChat`. */
+    channelHint?: string;
+    /** A throw/rejection is treated as "no persona" for that turn. */
+    personaResolver?: (ctx: {
+        sender: string;
+        text: string;
+    }) => string | undefined | Promise<string | undefined>;
+    /** Off by default — the channel stays single-turn until a store is configured. */
+    history?: {
+        store: HistoryStore;
+        /** Most recent turns to load per reply. @default 20 */
+        limit?: number;
+        /**
+         * Excludes a sender from history entirely — see
+         * `InboundPipelineConfig.history.historyEnabledFor` in `./channels`.
+         * @default every sender is enabled
+         */
+        historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
+        /**
+         * Summarize-then-truncate compaction — see
+         * `InboundPipelineConfig.history.compaction` in `./channels`.
+         * @default off
+         */
+        compaction?: HistoryCompactionOptions;
+    };
+    muteRegex?: RegExp;
+    unmuteRegex?: RegExp;
+    /** Neutral, overridable acknowledgements — this module ships no bot personality; unset = silent mute/unmute. */
+    muteReply?: string;
+    unmuteReply?: string;
+    dmRateLimit?: {
+        max: number;
+        windowMs: number;
+    };
+    groupRateLimit?: {
+        max: number;
+        windowMs: number;
+    };
+    /** Overridable for tests and for hosts routing through a proxy; defaults to `globalThis.fetch`. */
+    fetch?: typeof fetch;
+    /** Overridable for tests; defaults to a `setTimeout`-based sleep. */
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    /** Logger for poll/gate diagnostics. Falls back to the host's `deps.logger`, then a console logger. */
+    logger?: Logger;
+}
+/** `setTimeout`-based sleep, `unref`'d where supported so a pending sleep never keeps the process alive on its own. */
+export declare function defaultSleep(ms: number): Promise<void>;
+//# sourceMappingURL=polling.d.ts.map

package/dist/channels/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/channels/polling.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sHAAsH;IACtH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;;WAIG;QACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE;;;;WAIG;QACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;KACvC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uHAAuH;AACvH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtD"}

package/dist/channels/telegram/channel.d.ts

@@ -20,30 +20,14 @@
  * Telegram's privacy mode means it only receives messages that address it —
  * which is the same policy `decideChannelAction` applies anyway.
  */
-import type { AnswerFn, TransformReply } from "../../core/answer";
-import type { BucketsFor } from "../../core/buckets";
-import { type Logger } from "../../core/logger";
-import type { RerankContext, RewriteQuery } from "../../core/pipeline";
-import type { HistoryCompactionOptions } from "../../history/compaction";
-import type { HistoryStore } from "../../history/types";
 import type { Channel } from "../index";
+import { type PollingChannelConfig } from "../polling";
 import { type TelegramApi } from "./api";
-export interface TelegramChannelConfig {
+export interface TelegramChannelConfig extends PollingChannelConfig {
     /** From @BotFather. A credential — pass it from the environment, never commit it. */
     botToken: string;
     /** Channel and sender-registry name. Override to run more than one bot in one process. @default "telegram" */
     name?: string;
-    /** Group chats eligible for a reply. Empty (default) = every group. Has no effect on DMs, which always reply. */
-    allowedChats?: string[];
-    answerFn?: AnswerFn;
-    bucketsFor?: BucketsFor;
-    /** Rewrites the retrieval query before it reaches the vector store — see `ChatterConfig.rewriteQuery`. Falls back to the server's own. */
-    rewriteQuery?: RewriteQuery;
-    /** Post-processes retrieved chunks before they're folded into the prompt — see `ChatterConfig.rerankContext`. Falls back to the server's own. */
-    rerankContext?: RerankContext;
-    /** Modifies or vetoes the produced reply before delivery — see `ChatterConfig.transformReply`. Falls back to the server's own. */
-    transformReply?: TransformReply;
-    model?: string;
     /** Extra system-prompt section describing the delivery channel; passed through to `prepareChat`. @default "Channel: Telegram." */
     channelHint?: string;
     /** A throw/rejection is treated as "no persona" for that turn. `sender` is the namespaced `tg:<id>` key. */
@@ -51,54 +35,16 @@ export interface TelegramChannelConfig {
         sender: string;
         text: string;
     }) => string | undefined | Promise<string | undefined>;
-    /** Off by default — the channel stays single-turn until a store is configured. */
-    history?: {
-        store: HistoryStore;
-        /** Most recent turns to load per reply. @default 20 */
-        limit?: number;
-        /**
-         * Excludes a sender from history entirely — see
-         * `InboundPipelineConfig.history.historyEnabledFor` in `./channels`.
-         * @default every sender is enabled
-         */
-        historyEnabledFor?: (sender: string) => boolean | Promise<boolean>;
-        /**
-         * Summarize-then-truncate compaction — see
-         * `InboundPipelineConfig.history.compaction` in `./channels`.
-         * @default off
-         */
-        compaction?: HistoryCompactionOptions;
-    };
-    muteRegex?: RegExp;
-    unmuteRegex?: RegExp;
-    /** Neutral, overridable acknowledgements — this module ships no bot personality; unset = silent mute/unmute. */
-    muteReply?: string;
-    unmuteReply?: string;
-    dmRateLimit?: {
-        max: number;
-        windowMs: number;
-    };
-    groupRateLimit?: {
-        max: number;
-        windowMs: number;
-    };
     /** @default 30 */
     pollTimeoutSeconds?: number;
     /** Resume point for `getUpdates`. Omitted = whatever Telegram still has queued (see docs/telegram.md). */
     initialOffset?: number;
     /** Called with each acknowledged offset, for a host that wants to persist it across restarts. */
     onOffset?: (offset: number) => void;
-    /** Overridable for tests and for hosts routing through a proxy; defaults to `globalThis.fetch`. */
-    fetch?: typeof fetch;
     /** Self-hosted Bot API server origin. */
     apiBaseUrl?: string;
     /** Overridable for tests, which fake the Bot API instead of calling it; defaults to a `fetch` client over {@link TelegramChannelConfig.botToken}. */
     api?: TelegramApi;
-    /** Overridable for tests; defaults to a `setTimeout`-based sleep. */
-    sleep?: (ms: number) => Promise<void>;
-    now?: () => number;
-    /** Logger for poll/gate diagnostics. Falls back to the host's `deps.logger`, then a console logger. */
-    logger?: Logger;
 }
 export declare function createTelegramChannel(config: TelegramChannelConfig): Channel;
 //# sourceMappingURL=channel.d.ts.map

package/dist/channels/telegram/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAQ5D,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0IAA0I;IAC1I,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iJAAiJ;IACjJ,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kIAAkI;IAClI,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kFAAkF;IAClF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,YAAY,CAAC;QACpB,uDAAuD;QACvD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;;WAIG;QACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE;;;;WAIG;QACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;KACvC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,cAAc,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,kBAAkB;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAuG5E"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAgB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAQ5D,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kIAAkI;IAClI,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,kBAAkB;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0GAA0G;IAC1G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qJAAqJ;IACrJ,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAmG5E"}

package/dist/channels/telegram/index.js

@@ -294,7 +294,8 @@ async function answerOnce({
 async function applyTransformReply(transformReply, input, logger) {
   if (!transformReply) return input.text;
   try {
-    return await transformReply(input);
+    const result = await transformReply(input);
+    return typeof result === "string" ? result : null;
   } catch (error) {
     logger?.error(
       `transformReply threw for channel "${input.channel}"; sending the original reply`,
@@ -356,6 +357,7 @@ async function prepareChat({
   sender,
   rewriteQuery,
   rerankContext,
+  fallbackFn,
   logger
 }) {
   const lastUserMsg = lastUserMessage(messages);
@@ -372,21 +374,39 @@ async function prepareChat({
       logger?.error("rewriteQuery threw; falling back to the original query", error);
     }
   }
-  let ctx = await store.query(query, topK, buckets ?? defaultBuckets(mode));
+  const resolvedBuckets = buckets ?? defaultBuckets(mode);
+  const retrievedChunks = await store.query(query, topK, resolvedBuckets);
+  let ctx = retrievedChunks;
   if (rerankContext) {
     try {
-      const reranked = await rerankContext({ query, chunks: ctx });
+      const reranked = await rerankContext({ query, chunks: [...ctx] });
       if (Array.isArray(reranked) && reranked.every((c) => typeof c === "string")) ctx = reranked;
     } catch (error) {
       logger?.error("rerankContext threw; falling back to the original chunks", error);
     }
   }
+  let fallback;
+  if (ctx.length === 0 && fallbackFn) {
+    try {
+      const guidance = await fallbackFn({
+        query,
+        mode,
+        buckets: resolvedBuckets,
+        sender,
+        retrievedChunks
+      });
+      if (typeof guidance === "string" && guidance.trim()) fallback = guidance.trim();
+    } catch (error) {
+      logger?.error("fallbackFn threw; proceeding without fallback guidance", error);
+    }
+  }
   const persona = personaLayer?.trim() || (mode === "private" ? prompts.privatePersona : prompts.publicPersona);
   const hint = channelHint?.trim();
   const system = [
     prompts.baseSystemRules,
     persona,
     ...hint ? [hint] : [],
+    ...fallback ? [fallback] : [],
     `${label}:
 ${ctx.join("\n\n")}`
   ].join("\n\n");
@@ -394,7 +414,7 @@ ${ctx.join("\n\n")}`
 }
 
 // src/history/compaction.ts
-var DEFAULT_TIMEOUT_MS = 8e3;
+var COMPACTION_TIMEOUT_MS = 8e3;
 var LOAD_ALL = Number.MAX_SAFE_INTEGER;
 var SUMMARY_PREFIX = "Summary of earlier conversation: ";
 function defaultSummarize(client, model) {
@@ -422,7 +442,7 @@ function createHistoryCompactor(deps, options) {
     throw new Error(`Invalid history compaction keep: ${keep}`);
   }
   const summarize = options.summarize ?? defaultSummarize(deps.client, options.model);
-  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const timeoutMs = options.timeoutMs ?? COMPACTION_TIMEOUT_MS;
   return {
     async maybeCompact(store, conversationId) {
       const turns = await store.load(conversationId, LOAD_ALL);
@@ -513,6 +533,16 @@ function underReplyRateLimit(msg, limiters) {
 }
 
 // src/channels/pipeline.ts
+function resolveBrainHooks(config, fallback) {
+  return {
+    answerFn: config.answerFn ?? fallback?.answerFn,
+    bucketsFor: config.bucketsFor ?? fallback?.bucketsFor,
+    rewriteQuery: config.rewriteQuery ?? fallback?.rewriteQuery,
+    rerankContext: config.rerankContext ?? fallback?.rerankContext,
+    fallbackFn: config.fallbackFn ?? fallback?.fallbackFn,
+    transformReply: config.transformReply ?? fallback?.transformReply
+  };
+}
 var DEFAULT_HISTORY_LIMIT = 20;
 var DEFAULT_GROUP_RATE_LIMIT = { max: 30, windowMs: 60 * 60 * 1e3 };
 var DEFAULT_DM_RATE_LIMIT = { max: 20, windowMs: 60 * 60 * 1e3 };
@@ -597,6 +627,7 @@ function createInboundPipeline(deps, config) {
       sender,
       rewriteQuery: config.rewriteQuery,
       rerankContext: config.rerankContext,
+      fallbackFn: config.fallbackFn,
       logger: config.logger
     });
     const { content: produced } = await answerOnce({
@@ -633,6 +664,14 @@ function createInboundPipeline(deps, config) {
   };
 }
 
+// src/channels/polling.ts
+function defaultSleep(ms) {
+  return new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    if (typeof timer === "object" && "unref" in timer) timer.unref();
+  });
+}
+
 // src/channels/telegram/updates.ts
 function messageText(message) {
   return message.text ?? message.caption ?? "";
@@ -711,11 +750,16 @@ function createTelegramSender(api) {
   };
 }
 
+// src/channels/backoff.ts
+function exponentialBackoffMs(baseMs, maxMs, n) {
+  return Math.min(baseMs * 2 ** Math.max(0, Math.min(n, 20)), maxMs);
+}
+
 // src/channels/telegram/poll.ts
 var BASE_DELAY_MS = 1e3;
 var MAX_DELAY_MS = 6e4;
 function pollBackoffMs(failures) {
-  return Math.min(BASE_DELAY_MS * 2 ** Math.min(failures, 20), MAX_DELAY_MS);
+  return exponentialBackoffMs(BASE_DELAY_MS, MAX_DELAY_MS, failures);
 }
 function retryDelayMs(error, failures) {
   const retryAfterMs = error instanceof TelegramApiError ? error.retryAfterMs : void 0;
@@ -740,9 +784,9 @@ async function runLongPoll(deps) {
     }
     failures = 0;
     for (const update of updates) {
+      if (deps.isStopped()) break;
       offset = nextOffset(update);
       deps.onOffset?.(offset);
-      if (deps.isStopped()) break;
       try {
         await deps.handleUpdate(update);
       } catch (error) {
@@ -755,12 +799,6 @@ async function runLongPoll(deps) {
 
 // src/channels/telegram/channel.ts
 var DEFAULT_POLL_TIMEOUT_SECONDS = 30;
-function defaultSleep(ms) {
-  return new Promise((resolve) => {
-    const timer = setTimeout(resolve, ms);
-    if (typeof timer === "object" && "unref" in timer) timer.unref();
-  });
-}
 function createTelegramChannel(config) {
   const channelName = config.name ?? "telegram";
   const allowedChats = config.allowedChats ?? [];
@@ -788,11 +826,7 @@ function createTelegramChannel(config) {
         { client: deps.client, store: deps.store, prompts: deps.prompts },
         {
           channel: channelName,
-          answerFn: config.answerFn ?? deps.config.answerFn,
-          bucketsFor: config.bucketsFor ?? deps.config.bucketsFor,
-          rewriteQuery: config.rewriteQuery ?? deps.config.rewriteQuery,
-          rerankContext: config.rerankContext ?? deps.config.rerankContext,
-          transformReply: config.transformReply ?? deps.config.transformReply,
+          ...resolveBrainHooks(config, deps.config),
           model: config.model,
           channelHint: config.channelHint ?? "Channel: Telegram.",
           personaResolver: config.personaResolver,
@@ -971,11 +1005,7 @@ function createTelegramWebhookRoute(config) {
       { client: deps.client, store: deps.store, prompts: deps.prompts },
       {
         channel: channelName,
-        answerFn: config.answerFn ?? deps.config.answerFn,
-        bucketsFor: config.bucketsFor ?? deps.config.bucketsFor,
-        rewriteQuery: config.rewriteQuery ?? deps.config.rewriteQuery,
-        rerankContext: config.rerankContext ?? deps.config.rerankContext,
-        transformReply: config.transformReply ?? deps.config.transformReply,
+        ...resolveBrainHooks(config, deps.config),
         model: config.model,
         channelHint: config.channelHint ?? "Channel: Telegram.",
         personaResolver: config.personaResolver,