@hahnfeld/teams-adapter 1.2.0 → 1.3.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,eAAe,iBAAiB,EAAE,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,eAAe,iBAAiB,EAAE,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/message-composer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Message composer — manages a single "main message" per session in Teams.
+ *
+ * The main message has four zones:
+ *   TITLE   (persistent, bold) — session name, survives finalize
+ *   HEADER  (ephemeral, italic) — tool_call, tool_update, thought
+ *   BODY    (persistent, streamed) — text, attachments
+ *   FOOTER  (persistent, italic) — usage, session_end
+ *
+ * All zones are composed into a single markdown string and sent/updated
+ * as one Teams message via the rate limiter.
+ */
+import type { TurnContext } from "@microsoft/agents-hosting";
+import type { ConversationRateLimiter } from "./rate-limiter.js";
+export interface MessageRef {
+    activityId: string;
+    conversationId: string;
+    serviceUrl: string;
+}
+export type AcquireBotToken = () => Promise<string | null>;
+/**
+ * A single main message with title/header/body/footer zones.
+ */
+export declare class SessionMessage {
+    private context;
+    private conversationId;
+    private sessionId;
+    private rateLimiter;
+    private acquireBotToken;
+    private title;
+    private header;
+    private body;
+    private footer;
+    private ref;
+    private lastSent;
+    private stallTimer?;
+    constructor(context: TurnContext, conversationId: string, sessionId: string, rateLimiter: ConversationRateLimiter, acquireBotToken: AcquireBotToken);
+    updateContext(context: TurnContext): void;
+    getRef(): MessageRef | null;
+    getBody(): string;
+    getFooter(): string | null;
+    /** Set the persistent session title (bold, survives finalize). */
+    setTitle(text: string): void;
+    /** Max header length — keeps the message compact; tool diffs can be huge. */
+    private static readonly MAX_HEADER_LENGTH;
+    /** Replace the ephemeral header (tool_call, thought, etc.). */
+    setHeader(text: string): void;
+    /** Clear the ephemeral header and flush the update. */
+    clearHeader(): void;
+    /** Append text to the body (streaming text chunks). */
+    appendBody(text: string): void;
+    /** Set the persistent footer (usage, completion). */
+    setFooter(text: string): void;
+    /** Append to the existing footer (e.g., adding "Task completed" after usage). */
+    appendFooter(text: string): void;
+    /**
+     * Close any unclosed code fences in the body.
+     * If the body has an odd number of ``` markers, the footer would
+     * be swallowed into the code block — append a closing fence.
+     */
+    private static closeCodeFences;
+    /** Compose the four zones into a single markdown string. */
+    compose(): string;
+    /** Request a flush through the rate limiter. */
+    requestFlush(): void;
+    private flush;
+    private updateViaRest;
+    /** Split: finalize current message at body limit, start fresh. */
+    private split;
+    private resetStallTimer;
+    /** Finalize: clear stall timer, clear ephemeral header, do a last flush. */
+    finalize(): Promise<MessageRef | null>;
+    stripPattern(pattern: RegExp): Promise<void>;
+}
+/**
+ * Manages SessionMessage instances and plan refs across sessions.
+ */
+export declare class SessionMessageManager {
+    private rateLimiter;
+    private acquireBotToken;
+    private messages;
+    private planRefs;
+    constructor(rateLimiter: ConversationRateLimiter, acquireBotToken: AcquireBotToken);
+    getOrCreate(sessionId: string, context: TurnContext): SessionMessage;
+    get(sessionId: string): SessionMessage | undefined;
+    has(sessionId: string): boolean;
+    /** Finalize and remove a session's message and plan ref. */
+    finalize(sessionId: string): Promise<MessageRef | null>;
+    /** Get or set the plan message ref for a session. */
+    getPlanRef(sessionId: string): MessageRef | undefined;
+    setPlanRef(sessionId: string, ref: MessageRef): void;
+    cleanup(sessionId: string): void;
+}
+//# sourceMappingURL=message-composer.d.ts.map

package/dist/message-composer.d.ts.map

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

package/dist/message-composer.js

@@ -0,0 +1,331 @@
+import { log } from "@openacp/plugin-sdk";
+import { sendText } from "./send-utils.js";
+const MAX_BODY_LENGTH = 25_000;
+const STALL_TIMEOUT = 30_000;
+/** Escape asterisks to prevent breaking markdown italic/bold spans. */
+function escapeEmphasis(text) {
+    return text.replace(/\*/g, "\\*");
+}
+/**
+ * Normalize newlines for Teams rendering.
+ * Teams collapses single \n in markdown — use \n\n for line breaks.
+ */
+function teamsNewlines(text) {
+    return text.replace(/(?<!\n)\n(?!\n)/g, "\n\n");
+}
+/**
+ * A single main message with title/header/body/footer zones.
+ */
+export class SessionMessage {
+    context;
+    conversationId;
+    sessionId;
+    rateLimiter;
+    acquireBotToken;
+    title = null;
+    header = null;
+    body = "";
+    footer = null;
+    ref = null;
+    lastSent = "";
+    stallTimer;
+    constructor(context, conversationId, sessionId, rateLimiter, acquireBotToken) {
+        this.context = context;
+        this.conversationId = conversationId;
+        this.sessionId = sessionId;
+        this.rateLimiter = rateLimiter;
+        this.acquireBotToken = acquireBotToken;
+    }
+    updateContext(context) {
+        this.context = context;
+    }
+    getRef() {
+        return this.ref;
+    }
+    getBody() {
+        return this.body;
+    }
+    getFooter() {
+        return this.footer;
+    }
+    /** Set the persistent session title (bold, survives finalize). */
+    setTitle(text) {
+        this.title = text;
+        this.requestFlush();
+    }
+    /** Max header length — keeps the message compact; tool diffs can be huge. */
+    static MAX_HEADER_LENGTH = 120;
+    /** Replace the ephemeral header (tool_call, thought, etc.). */
+    setHeader(text) {
+        // Truncate to first line, then cap length — headers are status indicators, not content
+        const firstLine = text.split("\n")[0];
+        this.header = firstLine.length > SessionMessage.MAX_HEADER_LENGTH
+            ? firstLine.slice(0, SessionMessage.MAX_HEADER_LENGTH) + "..."
+            : firstLine;
+        this.requestFlush();
+    }
+    /** Clear the ephemeral header and flush the update. */
+    clearHeader() {
+        if (this.header === null)
+            return;
+        this.header = null;
+        this.requestFlush();
+    }
+    /** Append text to the body (streaming text chunks). */
+    appendBody(text) {
+        if (!text)
+            return;
+        this.body += text;
+        this.resetStallTimer();
+        // Check if body needs splitting
+        if (this.body.length > MAX_BODY_LENGTH && this.ref) {
+            this.split();
+            return;
+        }
+        this.requestFlush();
+    }
+    /** Set the persistent footer (usage, completion). */
+    setFooter(text) {
+        this.footer = text;
+        this.requestFlush();
+    }
+    /** Append to the existing footer (e.g., adding "Task completed" after usage). */
+    appendFooter(text) {
+        this.footer = this.footer ? `${this.footer} · ${text}` : text;
+        this.requestFlush();
+    }
+    /**
+     * Close any unclosed code fences in the body.
+     * If the body has an odd number of ``` markers, the footer would
+     * be swallowed into the code block — append a closing fence.
+     */
+    static closeCodeFences(text) {
+        const fenceCount = (text.match(/^```/gm) || []).length;
+        if (fenceCount % 2 !== 0) {
+            return text + "\n```";
+        }
+        return text;
+    }
+    /** Compose the four zones into a single markdown string. */
+    compose() {
+        const parts = [];
+        if (this.title) {
+            parts.push(`**${escapeEmphasis(this.title)}**`);
+        }
+        if (this.header) {
+            parts.push(`*${escapeEmphasis(this.header)}*`);
+        }
+        if (this.title || this.header) {
+            parts.push("---");
+        }
+        if (this.body) {
+            parts.push(SessionMessage.closeCodeFences(this.body));
+        }
+        if (this.footer) {
+            if (this.body)
+                parts.push("---");
+            parts.push(`*${escapeEmphasis(this.footer)}*`);
+        }
+        return parts.join("\n\n");
+    }
+    /** Request a flush through the rate limiter. */
+    requestFlush() {
+        const composed = this.compose();
+        if (!composed)
+            return;
+        if (composed === this.lastSent)
+            return;
+        // Coalescing key: activityId for updates, session for new sends
+        const key = this.ref ? `update:${this.ref.activityId}` : `new:${this.sessionId}`;
+        this.rateLimiter.enqueue(this.conversationId, () => this.flush(), key).catch((err) => {
+            log.warn({ err, sessionId: this.sessionId }, "[SessionMessage] flush failed");
+        });
+    }
+    async flush() {
+        const composed = this.compose();
+        if (!composed || composed === this.lastSent)
+            return;
+        if (!this.ref) {
+            // First send — create the message
+            const result = await sendText(this.context, composed);
+            if (result?.id) {
+                this.ref = {
+                    activityId: result.id,
+                    conversationId: this.context.activity.conversation?.id,
+                    serviceUrl: this.context.activity.serviceUrl,
+                };
+            }
+            this.lastSent = composed;
+        }
+        else {
+            // Update existing message via REST
+            const success = await this.updateViaRest(composed);
+            if (success) {
+                this.lastSent = composed;
+            }
+        }
+        // Check if state changed during the flush (new chunks arrived while we were awaiting)
+        const current = this.compose();
+        if (current && current !== this.lastSent) {
+            this.requestFlush();
+        }
+    }
+    async updateViaRest(text) {
+        if (!this.ref)
+            return false;
+        const token = await this.acquireBotToken();
+        if (!token)
+            return false;
+        const url = `${this.ref.serviceUrl}/v3/conversations/${encodeURIComponent(this.ref.conversationId)}/activities/${encodeURIComponent(this.ref.activityId)}`;
+        try {
+            const response = await fetch(url, {
+                method: "PUT",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${token}`,
+                },
+                body: JSON.stringify({
+                    type: "message",
+                    text: teamsNewlines(text),
+                    textFormat: "markdown",
+                }),
+            });
+            if (!response.ok) {
+                log.warn({ status: response.status, sessionId: this.sessionId }, "[SessionMessage] REST update failed");
+                return false;
+            }
+            return true;
+        }
+        catch (err) {
+            log.warn({ err, sessionId: this.sessionId }, "[SessionMessage] REST update error");
+            return false;
+        }
+    }
+    /** Split: finalize current message at body limit, start fresh. */
+    split() {
+        const finalBody = this.body.slice(0, MAX_BODY_LENGTH);
+        const overflow = this.body.slice(MAX_BODY_LENGTH);
+        log.info({ sessionId: this.sessionId, finalLen: finalBody.length, overflowLen: overflow.length }, "[SessionMessage] splitting");
+        // Clear ephemeral header on the finalized message; footer stays per spec
+        this.header = null;
+        this.body = finalBody;
+        // Final flush of the current message (with footer preserved)
+        const composed = this.compose();
+        if (this.ref && composed !== this.lastSent) {
+            this.rateLimiter.enqueue(this.conversationId, () => this.updateViaRest(composed).then(() => { }), `update:${this.ref.activityId}`).catch(() => { });
+        }
+        // Reset for a new message — footer carries over to new message
+        this.ref = null;
+        this.lastSent = "";
+        this.body = overflow;
+        if (overflow) {
+            this.requestFlush();
+        }
+    }
+    resetStallTimer() {
+        if (this.stallTimer)
+            clearTimeout(this.stallTimer);
+        this.stallTimer = setTimeout(() => {
+            if (this.body && !this.footer) {
+                log.warn({ sessionId: this.sessionId }, "[SessionMessage] Stream stalled — adding cutoff notice");
+                this.header = null;
+                // Use appendBody so split check is applied
+                this.appendBody("\n\n---\n_Response was cut short — the model likely reached its output token limit. Send a follow-up message to continue._");
+            }
+        }, STALL_TIMEOUT);
+        if (this.stallTimer.unref)
+            this.stallTimer.unref();
+    }
+    /** Finalize: clear stall timer, clear ephemeral header, do a last flush. */
+    async finalize() {
+        if (this.stallTimer) {
+            clearTimeout(this.stallTimer);
+            this.stallTimer = undefined;
+        }
+        // Clear ephemeral header on finalize; title and footer persist
+        this.header = null;
+        // Final flush
+        const composed = this.compose();
+        if (composed && composed !== this.lastSent) {
+            if (!this.ref) {
+                const result = await sendText(this.context, composed);
+                if (result?.id) {
+                    this.ref = {
+                        activityId: result.id,
+                        conversationId: this.context.activity.conversation?.id,
+                        serviceUrl: this.context.activity.serviceUrl,
+                    };
+                }
+            }
+            else {
+                await this.updateViaRest(composed);
+            }
+            this.lastSent = composed;
+        }
+        return this.ref;
+    }
+    async stripPattern(pattern) {
+        if (!this.body)
+            return;
+        try {
+            this.body = this.body.replace(pattern, "").trim();
+        }
+        catch { /* leave unchanged */ }
+    }
+}
+/**
+ * Manages SessionMessage instances and plan refs across sessions.
+ */
+export class SessionMessageManager {
+    rateLimiter;
+    acquireBotToken;
+    messages = new Map();
+    planRefs = new Map();
+    constructor(rateLimiter, acquireBotToken) {
+        this.rateLimiter = rateLimiter;
+        this.acquireBotToken = acquireBotToken;
+    }
+    getOrCreate(sessionId, context) {
+        let msg = this.messages.get(sessionId);
+        if (!msg) {
+            const conversationId = context.activity.conversation?.id;
+            msg = new SessionMessage(context, conversationId, sessionId, this.rateLimiter, this.acquireBotToken);
+            this.messages.set(sessionId, msg);
+        }
+        else {
+            msg.updateContext(context);
+        }
+        return msg;
+    }
+    get(sessionId) {
+        return this.messages.get(sessionId);
+    }
+    has(sessionId) {
+        return this.messages.has(sessionId);
+    }
+    /** Finalize and remove a session's message and plan ref. */
+    async finalize(sessionId) {
+        const msg = this.messages.get(sessionId);
+        if (!msg)
+            return null;
+        this.messages.delete(sessionId);
+        this.planRefs.delete(sessionId);
+        return msg.finalize();
+    }
+    /** Get or set the plan message ref for a session. */
+    getPlanRef(sessionId) {
+        return this.planRefs.get(sessionId);
+    }
+    setPlanRef(sessionId, ref) {
+        this.planRefs.set(sessionId, ref);
+    }
+    cleanup(sessionId) {
+        const msg = this.messages.get(sessionId);
+        if (msg) {
+            msg.finalize().catch(() => { });
+        }
+        this.messages.delete(sessionId);
+        this.planRefs.delete(sessionId);
+    }
+}
+//# sourceMappingURL=message-composer.js.map

package/dist/message-composer.js.map

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

package/dist/rate-limiter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Manages per-conversation rate-limited queues.
+ *
+ * Usage:
+ *   const limiter = new ConversationRateLimiter();
+ *   await limiter.enqueue(conversationId, () => sendText(ctx, text), "main-msg");
+ */
+export declare class ConversationRateLimiter {
+    private queues;
+    /** Enqueue an operation for a conversation. Key enables coalescing. */
+    enqueue<T>(conversationId: string, fn: () => Promise<T>, key?: string): Promise<T | undefined>;
+    /** Clean up a conversation's queue (e.g., on session end). */
+    cleanup(conversationId: string): void;
+    /** Clean up all queues. */
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAqLA;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAwC;IAEtD,uEAAuE;IACvE,OAAO,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAS9F,8DAA8D;IAC9D,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAQrC,2BAA2B;IAC3B,OAAO,IAAI,IAAI;CAIhB"}

package/dist/rate-limiter.js

@@ -0,0 +1,201 @@
+/**
+ * Per-conversation rate limiter for Teams Bot Framework API.
+ *
+ * Teams enforces rate limits per bot per conversation thread:
+ *   7 ops/1s, 8 ops/2s, 60 ops/30s, 1800 ops/3600s
+ *
+ * This limiter tracks sliding windows and queues operations when any
+ * window would be exceeded. Supports coalescing — queued operations
+ * with the same key replace earlier ones (e.g., rapid message edits
+ * collapse into a single PUT).
+ */
+import { log } from "@openacp/plugin-sdk";
+/** Our targets — slightly under Teams limits to leave headroom. */
+const RATE_WINDOWS = [
+    { windowMs: 1_000, max: 6 },
+    { windowMs: 2_000, max: 7 },
+    { windowMs: 30_000, max: 55 },
+    { windowMs: 3_600_000, max: 1_700 },
+];
+/** Per-conversation queue state. */
+class ConversationQueue {
+    /** Timestamps of completed operations (for sliding window tracking). */
+    timestamps = [];
+    queue = [];
+    draining = false;
+    destroyed = false;
+    pausedUntil = 0;
+    drainTimer;
+    /** Resolves the inner drain-wait promise on destroy, preventing coroutine leak. */
+    drainWaitResolve;
+    /** Enqueue an operation. If key matches a pending op, replace it (coalescing). */
+    enqueue(fn, key) {
+        if (this.destroyed)
+            return Promise.resolve(undefined);
+        return new Promise((resolve, reject) => {
+            if (key) {
+                const idx = this.queue.findIndex((op) => op.key === key);
+                if (idx !== -1) {
+                    // Coalesce: resolve the old op as undefined (skipped), replace with new
+                    this.queue[idx].resolve(undefined);
+                    this.queue[idx] = { fn, key, resolve: resolve, reject };
+                    return;
+                }
+            }
+            this.queue.push({ fn, key, resolve: resolve, reject });
+            this.scheduleDrain();
+        });
+    }
+    get pending() {
+        return this.queue.length;
+    }
+    destroy() {
+        this.destroyed = true;
+        if (this.drainTimer) {
+            clearTimeout(this.drainTimer);
+            this.drainTimer = undefined;
+        }
+        // Unblock any suspended drain-wait so the coroutine can exit
+        if (this.drainWaitResolve) {
+            this.drainWaitResolve();
+            this.drainWaitResolve = undefined;
+        }
+        // Resolve all pending as undefined
+        for (const op of this.queue)
+            op.resolve(undefined);
+        this.queue.length = 0;
+    }
+    scheduleDrain() {
+        if (this.draining)
+            return;
+        if (this.drainTimer)
+            return;
+        const delay = this.getDelay();
+        this.drainTimer = setTimeout(() => {
+            this.drainTimer = undefined;
+            this.drain();
+        }, delay);
+    }
+    /** Calculate how long to wait before next op is allowed. */
+    getDelay() {
+        const now = Date.now();
+        // Respect 429 pause
+        if (now < this.pausedUntil) {
+            return this.pausedUntil - now;
+        }
+        let maxDelay = 0;
+        for (const { windowMs, max } of RATE_WINDOWS) {
+            const cutoff = now - windowMs;
+            // Timestamps are in ascending order — find the first one in the window
+            const firstIdx = this.timestamps.findIndex((t) => t > cutoff);
+            if (firstIdx === -1)
+                continue;
+            const opsInWindow = this.timestamps.length - firstIdx;
+            if (opsInWindow >= max) {
+                const oldest = this.timestamps[firstIdx];
+                const wait = oldest + windowMs - now + 1;
+                maxDelay = Math.max(maxDelay, wait);
+            }
+        }
+        return maxDelay;
+    }
+    async drain() {
+        if (this.draining)
+            return;
+        this.draining = true;
+        try {
+            while (this.queue.length > 0 && !this.destroyed) {
+                const delay = this.getDelay();
+                if (delay > 0) {
+                    await new Promise((r) => {
+                        this.drainWaitResolve = r;
+                        this.drainTimer = setTimeout(() => {
+                            this.drainTimer = undefined;
+                            this.drainWaitResolve = undefined;
+                            r();
+                        }, delay);
+                    });
+                    // Check if destroyed while waiting
+                    if (this.destroyed)
+                        break;
+                    continue;
+                }
+                const op = this.queue.shift();
+                try {
+                    const result = await op.fn();
+                    // Record timestamp only on success — 429s should not consume quota
+                    const now = Date.now();
+                    this.timestamps.push(now);
+                    this.pruneTimestamps(now);
+                    op.resolve(result);
+                }
+                catch (err) {
+                    const statusCode = err?.statusCode;
+                    if (statusCode === 429) {
+                        // Do NOT record a timestamp — the call was rejected
+                        const retryAfterRaw = err?.headers?.["retry-after"];
+                        const retryAfterSec = retryAfterRaw ? parseInt(retryAfterRaw, 10) : NaN;
+                        const retryMs = !isNaN(retryAfterSec) && retryAfterSec > 0
+                            ? retryAfterSec * 1000
+                            : 2000;
+                        log.warn({ retryMs }, "[RateLimiter] 429 received, pausing");
+                        this.pausedUntil = Date.now() + retryMs;
+                        // Re-queue the failed op at the front
+                        this.queue.unshift(op);
+                        continue;
+                    }
+                    // Non-429 errors still consumed a slot
+                    const now = Date.now();
+                    this.timestamps.push(now);
+                    this.pruneTimestamps(now);
+                    op.reject(err);
+                }
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    /** Remove timestamps older than the largest window. */
+    pruneTimestamps(now) {
+        const maxWindow = RATE_WINDOWS[RATE_WINDOWS.length - 1].windowMs;
+        const cutoff = now - maxWindow;
+        while (this.timestamps.length > 0 && this.timestamps[0] <= cutoff) {
+            this.timestamps.shift();
+        }
+    }
+}
+/**
+ * Manages per-conversation rate-limited queues.
+ *
+ * Usage:
+ *   const limiter = new ConversationRateLimiter();
+ *   await limiter.enqueue(conversationId, () => sendText(ctx, text), "main-msg");
+ */
+export class ConversationRateLimiter {
+    queues = new Map();
+    /** Enqueue an operation for a conversation. Key enables coalescing. */
+    enqueue(conversationId, fn, key) {
+        let queue = this.queues.get(conversationId);
+        if (!queue) {
+            queue = new ConversationQueue();
+            this.queues.set(conversationId, queue);
+        }
+        return queue.enqueue(fn, key);
+    }
+    /** Clean up a conversation's queue (e.g., on session end). */
+    cleanup(conversationId) {
+        const queue = this.queues.get(conversationId);
+        if (queue) {
+            queue.destroy();
+            this.queues.delete(conversationId);
+        }
+    }
+    /** Clean up all queues. */
+    destroy() {
+        for (const queue of this.queues.values())
+            queue.destroy();
+        this.queues.clear();
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map