@krischoichoi/channel-telegram 0.6.0

package/README.md

@@ -0,0 +1,129 @@
+# @krischoichoi/channel-telegram
+
+Telegram Bot API channel adapter for DeepSeek Harness.
+
+## Install
+
+```bash
+pnpm add @krischoichoi/channel-telegram
+```
+
+## Bundled community channel
+
+This package is part of the community-maintained `@krischoichoi/dsh-channels` bundle.
+It is not an official DeepSeek Harness or Telegram package.
+It implements the same Channel Contract as weixin / qq / dingtalk / lark,
+with no changes to channel-core, channel-harness or the other adapters.
+Setup and credentials go through the Channel Control Plane; the bot token is
+stored via `ctx.credentials` (`tokenRef`), never in profile config.
+
+> The bundle patch inserts this adapter as `channels-telegram` and the Web settings
+> panel shows it with the other bundled channels.
+
+
+Contract coverage:
+
+- `ChannelAdapter` contract (`start` / `stop` / `send` / `getHealth` / capabilities)
+- `runChannelAdapterContract` — the testkit's full contract suite passes
+- Cordis plugin shape (`name` / `inject` / `apply` via `ctx.effect`)
+- Schemastery `Config` with an injectable `HttpTransport` (offline fake in tests)
+- Fixture-driven mapper tests (`fixtures/telegram/*.json`, Bot API 10.2 shapes)
+- M4 governance: `readonly manifest` class field + `manifest.ts` for
+  `channels doctor` compatibility checks
+
+The adapter remains `experimental` until its real-platform live gate passes;
+offline contract tests and fixtures do not by themselves justify `tested`.
+
+## Pointing it at a real bot
+
+In your profile config:
+
+```json
+{
+  "plugins": {
+    "channel-telegram": {
+      "enabled": true,
+      "accountId": "main",
+      "baseUrl": "https://api.telegram.org",
+      "tokenRef": "TELEGRAM_BOT_TOKEN",
+      "longPollTimeoutMs": 25000
+    }
+  }
+}
+```
+
+The token is a **secret** resolved through `ctx.credentials` (`tokenRef`): it is never logged (bearer-style path segments are
+redacted in transport error messages) and it only ever appears in the Bot API
+request path built by the upstream driver. It is never written into fixture
+files.
+
+Inbound delivery currently uses Telegram Bot API long polling (`getUpdates`),
+matching OpenClaw's local-install default. Startup removes an existing webhook
+before polling because Telegram makes webhook and `getUpdates` delivery mutually
+exclusive. This is an operational takeover of the Bot's update receiver: do not
+reuse the same Bot for another webhook consumer. A hosted webhook transport is
+not implemented yet.
+
+## Capabilities
+
+| capability   | value     |
+| ------------ | --------- |
+| text / image / file / audio / video | ✅ |
+| markdown     | ✅ Rich Markdown |
+| reactions    | ❌        |
+| cards        | ❌        |
+| threads      | ✅        |
+| interactive actions | ✅ (inline keyboard buttons via `callback_query`) |
+| streaming    | DM Rich Draft; group plain preview + rich final edit; set `streaming.enabled: false` for buffered |
+
+## Known limits
+
+- Minimum supported upstream is Telegram Bot API 10.2. Older or pinned custom
+  Bot API servers are not supported; use `formatting.mode: plain` only as an
+  explicit presentation choice, not as an old-server compatibility mode.
+- `getUpdates` subscribes to `message` and `callback_query`. Button interactions
+  are currently intended only for callback queries carrying `message.chat`;
+  inline-message callbacks without chat context are not a supported routing
+  surface and require a mapper hardening change before release.
+- The ordinary message mapper still needs a complete zod trust-boundary schema;
+  the current partial envelope validation and TypeScript casts are an identified
+  release blocker, not evidence that arbitrary Telegram updates are supported.
+- Media sends validate the Bot API `ok` envelope and returned `message_id`; an
+  `ok: false` response is surfaced as a delivery failure. Offline coverage does
+  not replace the required real-bot live gate.
+- Inbound image, file, audio, and video media hydrate bytes through
+  `getFile`/download when declared as byte-capable. Failures retain
+  `resourceRef` plus ingress-failure metadata.
+- Telegram albums (`media_group_id`) are intentionally delivered one update at
+  a time. Each image is downloaded, dispatched, retried and acknowledged
+  independently; no cross-update buffering or delayed album aggregation is
+  performed.
+- Media captions are preserved as a text part before the image or document, so
+  the model receives both the caption and the shared attachment representation.
+- Media outbound accepts trusted `localData` via `multipart/form-data`, a
+  public `url`, or a platform `file_id` (`resourceRef`). Multiple supported
+  media parts are sent sequentially; an unsupported part fails the send rather
+  than being silently dropped.
+- Inbound media maps Telegram `file_id` to the contract's `resourceRef` carrier
+  (an opaque platform handle), never to `url` — `url` is reserved for real
+  `http(s)` URLs.
+- `beginAuth`/`pollAuth` are omitted: auth is token-driven (getMe() check at start).
+- Forum topics preserve `message_thread_id`; `chat.type === 'channel'`
+  currently maps to a `dm` conversation.
+
+## Development
+
+```bash
+pnpm --filter @krischoichoi/channel-telegram build
+pnpm --filter @krischoichoi/channel-telegram typecheck
+pnpm --filter @krischoichoi/channel-telegram test
+```
+
+## Related
+
+- [Repository root](../../README.md)
+- [Adapter authoring guide](../../docs/adapter-authoring.md)
+
+## License
+
+[MIT](../../LICENSE)

package/lib/adapter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Telegram channel adapter.
+ *
+ * Maps the Telegram Bot API (through the upstream driver) to the Channel
+ * Contract. All network/lifecycle resources live behind the upstream driver
+ * and are aborted via the adapter context signal. The adapter never touches
+ * Harness Agent APIs.
+ *
+ * Auth is token-driven: when a token is resolved (via `deps.token`, the
+ * credential seam, or the deprecated plaintext `config.token`), `start`
+ * verifies it with getMe() and launches the long-poll receive loop; without a
+ * token the adapter reports health 'down' and skips the loop entirely.
+ * `beginAuth`/`pollAuth` are intentionally not implemented — there is no
+ * interactive flow in V1; token rotation can slot in behind the same optional
+ * contract methods later.
+ *
+ * Streaming is `edit`: ReplyRouter opens a `TelegramStreamingReply` which sends
+ * one message and edits it in place with `editMessageText` as full-text
+ * previews arrive. Set `config.streaming.enabled: false` to force the buffered
+ * send-once strategy.
+ */
+import type { ChannelAdapter, ChannelAdapterContext, ChannelCapabilities, ChannelHealth, ChannelTarget, CreateReplyOptions, OutboundMessage, ReplyHandle, SendResult, StreamingMode } from '@krischoichoi/channel-core';
+import type { TelegramConfig } from './config.js';
+import { type HttpTransport } from './transport.js';
+import { type TelegramManifest } from './manifest.js';
+export interface TelegramAdapterDeps {
+    transport?: HttpTransport;
+    /**
+     * Resolved Telegram Bot API token. The plugin resolves it via
+     * `ctx.credentials` and hands it in; profile config never carries it.
+     */
+    token?: string;
+    /** Injectable clock (tests). */
+    now?: () => number;
+}
+export declare class TelegramAdapter implements ChannelAdapter {
+    private readonly config;
+    readonly id = "telegram";
+    /** Upstream compatibility manifest (read structurally by `channels doctor`). */
+    readonly manifest: TelegramManifest;
+    readonly capabilities: ChannelCapabilities;
+    readonly outboxCapabilities: {
+        proactiveText: boolean;
+        proactiveMedia: boolean;
+    };
+    private ctx?;
+    private upstream;
+    private inbound;
+    private outbound;
+    private started;
+    private stopped;
+    private receiveLoop?;
+    private receiveAbort?;
+    private removeContextAbortListener?;
+    /** One start/refresh lifecycle per chat/topic target, including in-flight starts. */
+    private readonly typingStates;
+    private connected;
+    private authState;
+    /** Public bot identity used only for reliable inbound mention activation. */
+    private botIdentity?;
+    /** getUpdates acknowledgement cursor, shared with the driver across retries. */
+    private readonly cursor;
+    private readonly now;
+    /** Resolved token used by the upstream driver (deps credential wins over legacy config). */
+    private readonly token;
+    /** Resolved once so outbound, streaming and explicit edits use one policy. */
+    private readonly formattingMode;
+    constructor(config: TelegramConfig, deps?: TelegramAdapterDeps);
+    start(ctx: ChannelAdapterContext): Promise<void>;
+    private createInboundProcessor;
+    stop(): Promise<void>;
+    send(target: ChannelTarget, message: OutboundMessage): Promise<SendResult>;
+    /** Start Telegram's transient typing indicator and refresh it per chat/topic. */
+    startTypingForTarget(target: ChannelTarget): Promise<void>;
+    /** Telegram has no explicit stop action; clearing refresh lets it expire. */
+    stopTypingForTarget(target: ChannelTarget): Promise<void>;
+    private sendTyping;
+    private clearTypingStates;
+    resolveStreamingMode(target: ChannelTarget): StreamingMode;
+    createReply(target: ChannelTarget, _options?: CreateReplyOptions): Promise<ReplyHandle>;
+    /**
+     * Optional in-place edit of an already-sent message (plan §15.3): either
+     * update the interactive keyboard (`editMessageReplyMarkup`) or the text
+     * (`editMessageText`).
+     */
+    edit(target: ChannelTarget, messageId: string, message: OutboundMessage): Promise<SendResult>;
+    getHealth(): Promise<ChannelHealth>;
+    /** Long-poll receive loop with exponential backoff on failure. */
+    private startReceiveLoop;
+    private runReceiveLoop;
+    private emitAuth;
+    private emitConnection;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

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

package/lib/adapter.js

@@ -0,0 +1,417 @@
+import { ChannelError } from '@krischoichoi/channel-core';
+import { FetchTransport } from './transport.js';
+import { HttpTelegramUpstream, } from './upstream.js';
+import { InboundProcessor } from './inbound.js';
+import { OutboundSender } from './outbound.js';
+import { TelegramStreamingReply } from './streaming-reply.js';
+import { TelegramRichStreamingReply } from './rich-streaming-reply.js';
+import { actionsToReplyMarkup } from './outbound.js';
+import { manifest as telegramManifest } from './manifest.js';
+import { resolveMode } from './render/index.js';
+export class TelegramAdapter {
+    config;
+    id = 'telegram';
+    /** Upstream compatibility manifest (read structurally by `channels doctor`). */
+    manifest = telegramManifest;
+    capabilities = {
+        text: true,
+        image: true,
+        file: true,
+        audio: true,
+        video: true,
+        // Rich Markdown (Bot API 10.1/10.2 sendRichMessage / HTML / MarkdownV2) is
+        // genuinely rendered, not just parse_mode in a body (plan §Phase 3).
+        markdown: true,
+        cards: false,
+        reactions: false,
+        threads: true,
+        // Inline buttons + callback_query interactions are supported (plan §5).
+        interactiveActions: true,
+        // Telegram can edit sent messages with editMessageText and can stream rich
+        // drafts natively for DMs; `resolveStreamingMode` picks per target.
+        streaming: 'edit',
+        maxTextLength: 4096,
+        // Directional media precision. Inbound:
+        // every binary kind is hydrated to real bytes (`resourceRef` -> getFile ->
+        // /file/bot... -> localData) before emit. Outbound: sendPhoto /
+        // sendDocument / sendAudio / sendVideo all accept byte uploads
+        // (multipart) or references, so every kind can send real bytes.
+        // Platform-level size limits (e.g. Bot API cloud upload caps) are a
+        // separate concern from this directional declaration.
+        media: {
+            inbound: {
+                image: 'bytes',
+                file: 'bytes',
+                audio: 'bytes',
+                video: 'bytes',
+            },
+            outbound: {
+                image: 'bytes',
+                file: 'bytes',
+                audio: 'bytes',
+                video: 'bytes',
+            },
+        },
+    };
+    outboxCapabilities = { proactiveText: true, proactiveMedia: true };
+    ctx;
+    upstream;
+    inbound;
+    outbound;
+    started = false;
+    stopped = false;
+    receiveLoop;
+    receiveAbort;
+    removeContextAbortListener;
+    /** One start/refresh lifecycle per chat/topic target, including in-flight starts. */
+    typingStates = new Map();
+    connected = false;
+    authState = 'unauthenticated';
+    /** Public bot identity used only for reliable inbound mention activation. */
+    botIdentity;
+    /** getUpdates acknowledgement cursor, shared with the driver across retries. */
+    cursor = { offset: 0 };
+    now;
+    /** Resolved token used by the upstream driver (deps credential wins over legacy config). */
+    token;
+    /** Resolved once so outbound, streaming and explicit edits use one policy. */
+    formattingMode;
+    constructor(config, deps = {}) {
+        this.config = config;
+        this.now = deps.now ?? Date.now;
+        const transport = deps.transport ?? new FetchTransport(config.baseUrl, { timeoutMs: config.timeoutMs });
+        const token = deps.token ?? config.token;
+        this.upstream = new HttpTelegramUpstream({
+            transport,
+            token,
+            longPollTimeoutMs: config.longPollTimeoutMs,
+        });
+        this.token = token;
+        this.formattingMode = resolveMode(config.formatting.mode);
+    }
+    async start(ctx) {
+        if (this.started)
+            return;
+        this.ctx = ctx;
+        this.stopped = false;
+        this.connected = false;
+        this.botIdentity = undefined;
+        this.cursor.offset = 0;
+        this.inbound = this.createInboundProcessor();
+        this.receiveAbort = new AbortController();
+        const abortReceive = () => this.receiveAbort?.abort();
+        if (ctx.signal.aborted)
+            abortReceive();
+        else {
+            ctx.signal.addEventListener('abort', abortReceive, { once: true });
+            this.removeContextAbortListener = () => ctx.signal.removeEventListener('abort', abortReceive);
+        }
+        this.outbound = new OutboundSender(this.upstream, ctx.logger, {
+            formatting: { ...this.config.formatting, mode: this.formattingMode },
+        });
+        if (this.token) {
+            try {
+                const bot = await this.upstream.getMe();
+                this.botIdentity = {
+                    id: bot.id,
+                    ...(bot.username ? { username: bot.username } : {}),
+                };
+                // Polling starts only after getMe, so replace the pre-auth processor
+                // with one carrying the trusted identity used by mention detection.
+                this.inbound = this.createInboundProcessor();
+                this.authState = 'authenticated';
+                this.emitAuth('authenticated');
+            }
+            catch (error) {
+                this.authState = 'failed';
+                this.emitAuth('failed');
+                this.ctx.logger.error('[channel-telegram] auth check failed; receive loop disabled', error instanceof Error ? error.message : error);
+                this.started = true;
+                return;
+            }
+            try {
+                // getUpdates and webhooks are mutually exclusive. Preserve queued
+                // updates while switching this bot to the local polling transport.
+                await this.upstream.deleteWebhook();
+                this.emitConnection('connecting');
+                this.startReceiveLoop();
+            }
+            catch (error) {
+                this.ctx.logger.error('[channel-telegram] polling setup failed; receive loop disabled', error instanceof Error ? error.message : error);
+                this.emitConnection('disconnected');
+            }
+        }
+        else {
+            this.authState = 'unauthenticated';
+            this.emitAuth('unknown');
+        }
+        this.started = true;
+    }
+    createInboundProcessor() {
+        return new InboundProcessor({
+            ctx: this.ctx,
+            meta: {
+                channel: this.id,
+                accountId: this.config.accountId,
+                ...(this.botIdentity ? { bot: this.botIdentity } : {}),
+            },
+            dedupEnabled: this.config.dedup.enabled,
+            dedupWindowMs: this.config.dedup.windowMs,
+            files: this.upstream,
+            maxDownloadBytes: this.config.maxDownloadBytes,
+            now: this.now,
+            // Best-effort callback ACK (clears the button spinner; never blocks on
+            // agent resolution — plan §12.2).
+            ackCallback: (callbackId) => this.upstream.answerCallbackQuery({ callback_query_id: callbackId }),
+        });
+    }
+    async stop() {
+        if (!this.started || this.stopped)
+            return;
+        this.stopped = true;
+        this.started = false;
+        this.connected = false;
+        this.clearTypingStates();
+        this.receiveAbort?.abort();
+        this.receiveAbort = undefined;
+        this.removeContextAbortListener?.();
+        this.removeContextAbortListener = undefined;
+        const loop = this.receiveLoop;
+        this.receiveLoop = undefined;
+        if (loop)
+            await loop.catch(() => undefined);
+        this.emitConnection('closed');
+    }
+    async send(target, message) {
+        if (!this.started || !this.outbound) {
+            throw new ChannelError('CHANNEL_NOT_STARTED', 'telegram adapter is not started');
+        }
+        return this.outbound.send(target, message);
+    }
+    /** Start Telegram's transient typing indicator and refresh it per chat/topic. */
+    async startTypingForTarget(target) {
+        if (!this.started || this.stopped || !this.config.typing.enabled)
+            return;
+        const key = typingKey(target);
+        if (this.typingStates.has(key))
+            return;
+        const state = {};
+        this.typingStates.set(key, state);
+        // Let the lifecycle caller decide how to handle an immediate failure. Do
+        // not create a refresh timer unless Telegram accepted the initial action.
+        try {
+            await this.sendTyping(target);
+            if (!this.started || this.stopped || this.typingStates.get(key) !== state)
+                return;
+            state.timer = setInterval(() => {
+                // Refresh failures are isolated from the timer; the harness owns the
+                // best-effort boundary for the immediate action below.
+                void this.sendTyping(target).catch((error) => {
+                    this.ctx?.logger.debug('[channel-telegram] typing refresh failed', error instanceof Error ? error.message : error);
+                });
+            }, this.config.typing.refreshMs);
+        }
+        catch (error) {
+            if (this.typingStates.get(key) === state)
+                this.typingStates.delete(key);
+            throw error;
+        }
+    }
+    /** Telegram has no explicit stop action; clearing refresh lets it expire. */
+    async stopTypingForTarget(target) {
+        const key = typingKey(target);
+        const state = this.typingStates.get(key);
+        if (!state)
+            return;
+        this.typingStates.delete(key);
+        if (state.timer)
+            clearInterval(state.timer);
+    }
+    async sendTyping(target) {
+        await this.upstream.sendChatAction(target.conversationId, 'typing', {
+            ...(target.threadId ? { messageThreadId: target.threadId } : {}),
+        });
+    }
+    clearTypingStates() {
+        for (const state of this.typingStates.values()) {
+            if (state.timer)
+                clearInterval(state.timer);
+        }
+        this.typingStates.clear();
+    }
+    resolveStreamingMode(target) {
+        // `streaming.enabled: false` is a hard off-switch: it forces the buffered
+        // send-once strategy even though streaming is available.
+        if (!this.config.streaming.enabled)
+            return 'buffered';
+        // Private DMs with rich output use the native sendRichMessageDraft flow.
+        const rich = this.formattingMode === 'rich-markdown';
+        if (rich && target.conversationType === 'dm')
+            return 'native';
+        // Everything else edits one message in place.
+        return 'edit';
+    }
+    async createReply(target, _options) {
+        if (!this.started || !this.ctx) {
+            throw new ChannelError('CHANNEL_NOT_STARTED', 'telegram adapter is not started');
+        }
+        const mode = this.formattingMode;
+        const rich = mode === 'rich-markdown';
+        // Native rich draft streaming for private DMs (plan §6.1).
+        if (rich && target.conversationType === 'dm') {
+            const reply = new TelegramRichStreamingReply(this.upstream, target, this.config.streaming.placeholder, { formatting: { mode } });
+            await reply.start();
+            return reply;
+        }
+        // Group (or plain config): plain edit preview; finish upgrades the same
+        // message to a Rich Message when rich output is active (plan §6.2).
+        const reply = new TelegramStreamingReply(this.upstream, target, this.config.streaming.placeholder, { formatting: { mode }, richFinal: rich && target.conversationType !== 'dm' });
+        // Send the placeholder immediately so the user sees the bot is working;
+        // subsequent full-text previews edit this same message in place.
+        await reply.start();
+        return reply;
+    }
+    /**
+     * Optional in-place edit of an already-sent message (plan §15.3): either
+     * update the interactive keyboard (`editMessageReplyMarkup`) or the text
+     * (`editMessageText`).
+     */
+    async edit(target, messageId, message) {
+        if (!this.started) {
+            throw new ChannelError('CHANNEL_NOT_STARTED', 'telegram adapter is not started');
+        }
+        if (message.text !== undefined) {
+            const markup = message.actions === undefined
+                ? undefined
+                : actionsToReplyMarkup(message.actions) ?? { inline_keyboard: [] };
+            const mode = this.formattingMode;
+            const raw = mode === 'rich-markdown'
+                ? await this.upstream.editMessageRich(target.conversationId, messageId, { markdown: message.text }, markup)
+                : await this.upstream.editMessageText(target.conversationId, messageId, message.text, markup ? { replyMarkup: markup } : undefined);
+            return { delivered: true, raw };
+        }
+        if (message.actions !== undefined) {
+            const markup = actionsToReplyMarkup(message.actions) ?? { inline_keyboard: [] };
+            const raw = await this.upstream.editMessageReplyMarkup(target.conversationId, messageId, markup);
+            return { delivered: true, raw };
+        }
+        return { delivered: true };
+    }
+    async getHealth() {
+        if (!this.started) {
+            return { status: 'down', detail: 'telegram adapter is not started', authenticated: false };
+        }
+        if (this.authState === 'authenticated' && this.connected) {
+            return { status: 'ok', detail: 'connected', connection: 'connected', authenticated: true };
+        }
+        if (this.authState === 'authenticated') {
+            return {
+                status: 'down',
+                detail: 'authenticated but receive loop down',
+                connection: 'disconnected',
+                authenticated: true,
+            };
+        }
+        if (this.authState === 'failed') {
+            return { status: 'down', detail: 'authentication failed', authenticated: false };
+        }
+        return { status: 'down', detail: 'not configured: no bot token', authenticated: false };
+    }
+    /** Long-poll receive loop with exponential backoff on failure. */
+    startReceiveLoop() {
+        if (this.receiveLoop)
+            return;
+        this.receiveLoop = this.runReceiveLoop();
+    }
+    async runReceiveLoop() {
+        let attempt = 0;
+        const signal = this.receiveAbort?.signal;
+        if (!signal)
+            return;
+        while (!this.stopped && !signal.aborted) {
+            try {
+                await this.upstream.getUpdates(this.cursor, signal, async (raw) => {
+                    try {
+                        await this.inbound.handle(raw);
+                    }
+                    catch (error) {
+                        // Reset transient processor state before retrying the unacked
+                        // update after the receive loop reconnects.
+                        this.inbound = this.createInboundProcessor();
+                        throw error;
+                    }
+                }, () => {
+                    if (!this.connected) {
+                        this.connected = true;
+                        this.emitConnection('connected');
+                    }
+                });
+                attempt = 0;
+            }
+            catch (error) {
+                if (this.stopped || signal.aborted)
+                    break;
+                attempt += 1;
+                this.connected = false;
+                this.emitConnection('reconnecting');
+                if (!this.config.reconnect.enabled || attempt > this.config.reconnect.maxRetries) {
+                    this.ctx.logger.warn('[channel-telegram] reconnect budget exhausted');
+                    this.emitConnection('disconnected');
+                    break;
+                }
+                const delay = Math.min(this.config.reconnect.baseDelayMs * 2 ** Math.min(attempt - 1, 8), this.config.reconnect.maxDelayMs);
+                this.ctx.logger.warn(`[channel-telegram] receive loop error; retry in ${delay}ms`, error);
+                await sleep(delay, signal);
+            }
+        }
+        this.connected = false;
+        if (!this.stopped && !signal.aborted) {
+            this.emitConnection('disconnected');
+        }
+    }
+    emitAuth(state) {
+        if (!this.ctx)
+            return;
+        void this.ctx
+            .emit({
+            type: 'auth.changed',
+            channel: this.id,
+            accountId: this.config.accountId,
+            state,
+        })
+            .catch(() => undefined);
+    }
+    emitConnection(state) {
+        if (!this.ctx)
+            return;
+        void this.ctx
+            .emit({
+            type: 'connection.changed',
+            channel: this.id,
+            accountId: this.config.accountId,
+            state,
+        })
+            .catch(() => undefined);
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve();
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function typingKey(target) {
+    return JSON.stringify([target.conversationId, target.threadId ?? null]);
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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