daemora 1.0.0-alpha.0

package/dist/channels/StreamingEditor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * StreamingEditor — throttled message edit loop.
+ *
+ * Caller buffers streaming text and calls `update(text)` with the full
+ * accumulated snapshot. The loop schedules throttled flushes, coalesces
+ * in-flight sends, and never overlaps API calls — so the external
+ * messaging platform (Discord, Slack, Telegram) is not rate-limited.
+ *
+ * First send creates the message; subsequent sends edit it in place.
+ * The caller's `sendOrEdit` callback owns that distinction.
+ */
+export interface StreamingLoopParams {
+    /** Minimum ms between edits. Discord ≈1200, Slack/Telegram ≈1000. */
+    readonly throttleMs: number;
+    /** Return false on failure — the loop restores pendingText and stops. */
+    readonly sendOrEdit: (text: string) => Promise<boolean | void>;
+    /** If true, update() becomes a no-op and flush() returns immediately. */
+    readonly isStopped: () => boolean;
+}
+export interface StreamingLoop {
+    /** Replace pending snapshot with the latest accumulated text. */
+    update(text: string): void;
+    /** Drain any pending text. Blocks until the queue is empty or stopped. */
+    flush(): Promise<void>;
+    /** Cancel pending timers and clear buffer. Safe to call multiple times. */
+    stop(): void;
+    /** Wait for an in-flight send to finish (if any). */
+    waitForInFlight(): Promise<void>;
+}
+export declare function createStreamingLoop(params: StreamingLoopParams): StreamingLoop;
+/**
+ * Split a message into chunks at paragraph / line / word boundaries so
+ * each chunk fits under `maxLen`. Used as a fallback when streaming is
+ * unavailable or the platform enforces a hard message length cap.
+ */
+export declare function splitMessage(text: string, maxLen: number): string[];
+//# sourceMappingURL=StreamingEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingEditor.d.ts","sourceRoot":"","sources":["../../src/channels/StreamingEditor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/D,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0EAA0E;IAC1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,2EAA2E;IAC3E,IAAI,IAAI,IAAI,CAAC;IACb,qDAAqD;IACrD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAoE9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAcnE"}

package/dist/channels/StreamingEditor.js

@@ -0,0 +1,108 @@
+/**
+ * StreamingEditor — throttled message edit loop.
+ *
+ * Caller buffers streaming text and calls `update(text)` with the full
+ * accumulated snapshot. The loop schedules throttled flushes, coalesces
+ * in-flight sends, and never overlaps API calls — so the external
+ * messaging platform (Discord, Slack, Telegram) is not rate-limited.
+ *
+ * First send creates the message; subsequent sends edit it in place.
+ * The caller's `sendOrEdit` callback owns that distinction.
+ */
+export function createStreamingLoop(params) {
+    let lastSentAt = 0;
+    let pendingText = "";
+    let inFlight;
+    let timer;
+    const flush = async () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+        while (!params.isStopped()) {
+            if (inFlight) {
+                await inFlight;
+                continue;
+            }
+            const text = pendingText;
+            if (!text.trim()) {
+                pendingText = "";
+                return;
+            }
+            pendingText = "";
+            const current = params.sendOrEdit(text).finally(() => {
+                if (inFlight === current)
+                    inFlight = undefined;
+            });
+            inFlight = current;
+            const sent = await current;
+            if (sent === false) {
+                pendingText = text;
+                return;
+            }
+            lastSentAt = Date.now();
+            if (!pendingText)
+                return;
+        }
+    };
+    const schedule = () => {
+        if (timer)
+            return;
+        const delay = Math.max(0, params.throttleMs - (Date.now() - lastSentAt));
+        timer = setTimeout(() => void flush(), delay);
+    };
+    return {
+        update(text) {
+            if (params.isStopped())
+                return;
+            pendingText = text;
+            if (inFlight) {
+                schedule();
+                return;
+            }
+            if (!timer && Date.now() - lastSentAt >= params.throttleMs) {
+                void flush();
+                return;
+            }
+            schedule();
+        },
+        flush,
+        stop() {
+            pendingText = "";
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+        },
+        async waitForInFlight() {
+            if (inFlight)
+                await inFlight;
+        },
+    };
+}
+/**
+ * Split a message into chunks at paragraph / line / word boundaries so
+ * each chunk fits under `maxLen`. Used as a fallback when streaming is
+ * unavailable or the platform enforces a hard message length cap.
+ */
+export function splitMessage(text, maxLen) {
+    if (text.length <= maxLen)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > maxLen) {
+        let cut = remaining.lastIndexOf("\n\n", maxLen);
+        if (cut < maxLen / 2)
+            cut = remaining.lastIndexOf("\n", maxLen);
+        if (cut < maxLen / 2)
+            cut = remaining.lastIndexOf(" ", maxLen);
+        if (cut <= 0)
+            cut = maxLen;
+        chunks.push(remaining.slice(0, cut).trimEnd());
+        remaining = remaining.slice(cut).trimStart();
+    }
+    if (remaining)
+        chunks.push(remaining);
+    return chunks;
+}
+//# sourceMappingURL=StreamingEditor.js.map

package/dist/channels/StreamingEditor.js.map

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

package/dist/channels/TelegramChannel.d.ts

@@ -0,0 +1,84 @@
+/**
+ * TelegramChannel — Telegram Bot API integration.
+ *
+ * Uses raw fetch against the Bot API — no external packages.
+ * Supports both long-polling (getUpdates) and webhook modes.
+ * Handles text, voice, audio, photo, video, and document updates. Voice
+ * and audio are downloaded and transcribed via Whisper so the agent
+ * receives usable text; media files are saved to a temp dir and their
+ * paths are embedded so the agent can read / analyse them with its
+ * normal tools.
+ */
+import type { ConfigManager } from "../config/ConfigManager.js";
+import { BaseChannel, type ChannelMeta, type IncomingMessage } from "./BaseChannel.js";
+export interface TelegramChannelOpts {
+    /** Bot token from @BotFather. */
+    token: string;
+    /** Callback when an incoming message is received. */
+    onMessage: (msg: IncomingMessage) => void;
+    /** Optional: webhook URL. If omitted, uses long polling. */
+    webhookUrl?: string;
+    /** Optional: allowed user IDs. Empty = allow all. */
+    allowedUsers?: readonly string[];
+    /** Optional: polling interval in ms (default 1000). */
+    pollInterval?: number;
+    /** Config manager — needed to reach the vault for STT API keys. */
+    cfg: ConfigManager;
+}
+export declare class TelegramChannel extends BaseChannel {
+    readonly id: "telegram";
+    readonly name: "Telegram";
+    readonly supportsStreaming = true;
+    readonly supportsFiles = true;
+    readonly maxMessageLength = 4090;
+    private readonly token;
+    private readonly onMessage;
+    private readonly webhookUrl;
+    private readonly allowedUsers;
+    private readonly pollInterval;
+    private readonly cfg;
+    private offset;
+    private polling;
+    private pollTimer;
+    private downloadDir;
+    constructor(opts: TelegramChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    sendOrEditStream(meta: ChannelMeta, text: string, prevMessageId: string | null): Promise<string | null>;
+    sendTyping(meta: ChannelMeta): Promise<void>;
+    /**
+     * Upload a local file to a Telegram chat. Routes to the best-fit
+     * endpoint: photos → sendPhoto (renders inline), videos → sendVideo,
+     * audio → sendAudio, everything else → sendDocument. Uses multipart
+     * form so the raw bytes are uploaded — no need for a public URL.
+     */
+    sendFile(meta: ChannelMeta, path: string, caption?: string): Promise<void>;
+    editMessage(meta: ChannelMeta, messageId: string, text: string): Promise<void>;
+    deleteMessage(meta: ChannelMeta, messageId: string): Promise<void>;
+    isAllowed(userId: string): boolean;
+    /**
+     * Process a raw webhook update body. Call this from your HTTP route
+     * handler when Telegram POSTs to the webhook URL.
+     */
+    handleWebhookUpdate(body: unknown): void;
+    private setWebhook;
+    private poll;
+    private getUpdates;
+    private processUpdate;
+    private processUpdateAsync;
+    /** Returns the transcript or null when STT isn't configured / fails. */
+    private safelyTranscribe;
+    private ensureDownloadDir;
+    /**
+     * Download a Telegram-hosted file by `file_id`. Telegram's two-step
+     * flow: getFile → returns relative file_path → fetch from /file/bot<TOKEN>/<path>.
+     * Returns the absolute local path on disk.
+     */
+    private downloadFile;
+    private sendChatAction;
+    /** Plain-text reply used for error paths where MarkdownV2 escaping is overkill. */
+    private sendReplyRaw;
+    private apiCall;
+}
+//# sourceMappingURL=TelegramChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramChannel.d.ts","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAA0B,MAAM,kBAAkB,CAAC;AA6B/G,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,GAAG,EAAE,aAAa,CAAC;CACpB;AA+CD,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,EAAE,EAAG,UAAU,CAAU;IAClC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,SAAkB,iBAAiB,QAAQ;IAC3C,SAAkB,aAAa,QAAQ;IACvC,SAAkB,gBAAgB,QAAQ;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IAEpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,WAAW,CAAuB;gBAE9B,IAAI,EAAE,mBAAmB;IAY/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWZ,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD,gBAAgB,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuBV,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;OAKG;IACY,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1E,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9E,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAO3C;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;YAO1B,UAAU;IAIxB,OAAO,CAAC,IAAI;YAoBE,UAAU;IASxB,OAAO,CAAC,aAAa;YAQP,kBAAkB;IA0IhC,wEAAwE;YAC1D,gBAAgB;YAUhB,iBAAiB;IAQ/B;;;;OAIG;YACW,YAAY;YAgBZ,cAAc;IAI5B,mFAAmF;YACrE,YAAY;YAQZ,OAAO;CA+BtB"}