@cogitator-ai/channels 0.2.1

package/dist/gateway.js

@@ -0,0 +1,347 @@
+import { SessionManager, CompactionService } from '@cogitator-ai/memory';
+import { StreamBuffer } from './stream-buffer';
+import { adaptMarkdown, chunkMessage, getPlatformLimit } from './formatters/markdown';
+import { StatusReactionTracker } from './status-reactions';
+import { InboundDebouncer } from './inbound-debounce';
+import { formatEnvelope } from './envelope';
+import { MessageQueue } from './message-queue';
+export class Gateway {
+    config;
+    channels;
+    sessionManager;
+    compactionService;
+    middlewares;
+    streamConfig;
+    debouncer;
+    messageQueue;
+    hooks;
+    lastMessageTime = new Map();
+    running = false;
+    startedAt = null;
+    messageCount = 0;
+    constructor(config) {
+        this.config = config;
+        this.channels = config.channels;
+        this.middlewares = config.middleware ?? [];
+        this.streamConfig = config.stream ?? { flushInterval: 500, minChunkSize: 20 };
+        if (config.memory) {
+            this.sessionManager = config.sessionManager ? null : new SessionManager(config.memory);
+            this.compactionService = config.session?.compaction
+                ? new CompactionService({
+                    adapter: config.memory,
+                    summarize: this.createSummarizeFn(),
+                })
+                : null;
+        }
+        else {
+            this.sessionManager = null;
+            this.compactionService = null;
+        }
+        this.hooks = config.hooks ?? null;
+        this.debouncer = config.debounce?.enabled
+            ? new InboundDebouncer(config.debounce, (merged) => this.processMessage(merged))
+            : null;
+        this.messageQueue =
+            config.queueMode && config.queueMode !== 'parallel'
+                ? new MessageQueue(config.queueMode, (msg) => this.processMessage(msg))
+                : null;
+        for (const channel of this.channels) {
+            channel.onMessage((msg) => this.handleIncoming(msg));
+        }
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.startedAt = Date.now();
+        await Promise.all(this.channels.map((ch) => ch.start()));
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.debouncer)
+            await this.debouncer.flushAll();
+        this.messageQueue?.dispose();
+        await Promise.all(this.channels.map((ch) => ch.stop()));
+    }
+    get stats() {
+        return {
+            uptime: this.startedAt ? Date.now() - this.startedAt : 0,
+            activeSessions: 0,
+            totalSessions: 0,
+            messagesToday: this.messageCount,
+            connectedChannels: this.channels.map((ch) => ch.type),
+        };
+    }
+    async injectMessage(msg) {
+        return this.handleIncoming(msg);
+    }
+    async handleIncoming(msg) {
+        if (this.debouncer) {
+            this.debouncer.enqueue(msg);
+        }
+        else if (this.messageQueue) {
+            const threadId = this.getThreadId(msg);
+            this.messageQueue.push(msg, threadId);
+        }
+        else {
+            await this.processMessage(msg);
+        }
+    }
+    async processMessage(msg) {
+        try {
+            const channel = this.channels.find((ch) => ch.type === msg.channelType);
+            if (!channel)
+                return;
+            const user = {
+                id: msg.userId,
+                channelType: msg.channelType,
+                name: msg.userName,
+            };
+            const threadId = this.getThreadId(msg);
+            const ctx = this.createMiddlewareContext(threadId, user, channel);
+            let middlewarePassed = true;
+            if (this.middlewares.length > 0) {
+                let nextCalled = false;
+                const runAll = async (index) => {
+                    if (index >= this.middlewares.length) {
+                        nextCalled = true;
+                        return;
+                    }
+                    await this.middlewares[index].handle(msg, ctx, () => runAll(index + 1));
+                };
+                await runAll(0);
+                middlewarePassed = nextCalled;
+            }
+            if (!middlewarePassed)
+                return;
+            await this.hooks?.emit('message:received', { msg, threadId, user });
+            this.messageCount++;
+            if (this.config.envelope?.enabled) {
+                const prevTime = this.lastMessageTime.get(threadId);
+                msg = { ...msg, text: formatEnvelope(msg, this.config.envelope, prevTime) };
+                this.lastMessageTime.set(threadId, Date.now());
+            }
+            if (this.sessionManager) {
+                const session = await this.sessionManager.getOrCreate({
+                    userId: msg.userId,
+                    channelType: msg.channelType,
+                    channelId: msg.channelId,
+                    agentId: this.getAgentName(),
+                });
+                await this.sessionManager.incrementMessageCount(session.id);
+                if (this.compactionService && this.config.session?.compaction) {
+                    const compaction = this.config.session.compaction;
+                    if (session.messageCount >= compaction.threshold) {
+                        await this.compactionService.compact(session.id, compaction);
+                    }
+                }
+            }
+            const agent = await this.resolveAgent(user);
+            const reactionsEnabled = this.config.reactions?.enabled && channel.setReaction;
+            let tracker;
+            if (reactionsEnabled) {
+                tracker = new StatusReactionTracker(channel, msg.channelId, msg.id, this.config.reactions);
+                tracker.setPhase('queued');
+            }
+            await channel.sendTyping(msg.channelId);
+            const typingInterval = setInterval(() => {
+                channel.sendTyping(msg.channelId).catch(() => { });
+            }, 4000);
+            try {
+                tracker?.setPhase('thinking');
+                if (this.config.stream) {
+                    await this.runStreaming(agent, msg, channel, threadId);
+                }
+                else {
+                    await this.runDirect(agent, msg, channel, threadId);
+                }
+                tracker?.setPhase('done');
+            }
+            catch (error) {
+                tracker?.setPhase('error');
+                throw error;
+            }
+            finally {
+                clearInterval(typingInterval);
+                tracker?.dispose();
+            }
+        }
+        catch (error) {
+            if (this.config.onError) {
+                this.config.onError(error instanceof Error ? error : new Error(String(error)), msg);
+            }
+        }
+    }
+    async extractMedia(msg, agent) {
+        let input = msg.text;
+        let images;
+        if (this.config.mediaProcessor && msg.attachments?.length) {
+            console.log(`[gateway] Processing ${msg.attachments.length} attachment(s), types: ${msg.attachments.map((a) => a.type).join(', ')}`);
+            const result = await this.config.mediaProcessor.process(msg.attachments, agent.model);
+            console.log(`[gateway] Media result: images=${result.images.length}, text=${!!result.transcribedText}, notes=${result.systemNotes.length}`);
+            if (result.images.length > 0)
+                images = result.images;
+            if (result.transcribedText) {
+                input = result.transcribedText + (input ? `\n${input}` : '');
+            }
+            if (result.systemNotes.length > 0) {
+                input = (input || '') + '\n' + result.systemNotes.join('\n');
+            }
+        }
+        if (!input && !images?.length) {
+            input = '[empty message]';
+        }
+        return { input, images };
+    }
+    async runDirect(agent, msg, channel, threadId) {
+        const { input, images } = await this.extractMedia(msg, agent);
+        const replyTo = msg.raw?.scheduled ? undefined : msg.id;
+        await this.hooks?.emit('agent:before_run', { msg, threadId, agent: agent.name });
+        let result;
+        try {
+            result = await this.config.cogitator.run(agent, {
+                input,
+                threadId,
+                useMemory: !!this.config.memory,
+                userId: msg.userId,
+                channelType: msg.channelType,
+                channelId: msg.channelId,
+                ...(images ? { images } : {}),
+            });
+        }
+        catch (error) {
+            await this.hooks?.emit('agent:error', { msg, threadId, error });
+            throw error;
+        }
+        await this.hooks?.emit('agent:after_run', { msg, threadId, output: result.output });
+        const output = adaptMarkdown(result.output, msg.channelType);
+        await this.hooks?.emit('message:sending', {
+            msg,
+            threadId,
+            text: output,
+            channelId: msg.channelId,
+        });
+        const limit = getPlatformLimit(msg.channelType);
+        const chunks = chunkMessage(output, limit);
+        let sentId = '';
+        for (let i = 0; i < chunks.length; i++) {
+            sentId = await channel.sendText(msg.channelId, chunks[i], {
+                ...(i === 0 && replyTo ? { replyTo } : {}),
+                format: 'markdown',
+            });
+        }
+        await this.hooks?.emit('message:sent', {
+            msg,
+            threadId,
+            text: output,
+            messageId: sentId,
+        });
+    }
+    async runStreaming(agent, msg, channel, threadId) {
+        const { input, images } = await this.extractMedia(msg, agent);
+        console.log(`[gateway] Running LLM, input: "${input.slice(0, 200)}", images: ${images?.length ?? 0}`);
+        const replyTo = msg.raw?.scheduled ? undefined : msg.id;
+        const useDraft = !!channel.sendDraft;
+        const streamCfg = {
+            ...this.streamConfig,
+            maxMessageChars: this.streamConfig.maxMessageChars ?? getPlatformLimit(msg.channelType),
+        };
+        const stream = new StreamBuffer(channel, msg.channelId, streamCfg, replyTo, useDraft);
+        stream.start();
+        await this.hooks?.emit('agent:before_run', { msg, threadId, agent: agent.name });
+        await this.hooks?.emit('stream:started', { msg, threadId });
+        try {
+            let tokenCount = 0;
+            const runPromise = this.config.cogitator.run(agent, {
+                input,
+                threadId,
+                useMemory: !!this.config.memory,
+                userId: msg.userId,
+                channelType: msg.channelType,
+                channelId: msg.channelId,
+                stream: true,
+                onToken: (token) => {
+                    tokenCount++;
+                    stream.append(token);
+                },
+                ...(images ? { images } : {}),
+            });
+            const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error('LLM response timeout (90s)')), 90_000));
+            const result = await Promise.race([runPromise, timeout]);
+            if (tokenCount > 0) {
+                await stream.finish();
+            }
+            else {
+                await stream.abort();
+                if (result.output) {
+                    const output = adaptMarkdown(result.output, msg.channelType);
+                    const limit = getPlatformLimit(msg.channelType);
+                    const chunks = chunkMessage(output, limit);
+                    for (let i = 0; i < chunks.length; i++) {
+                        await channel.sendText(msg.channelId, chunks[i], {
+                            ...(i === 0 && replyTo ? { replyTo } : {}),
+                            format: 'markdown',
+                        });
+                    }
+                }
+            }
+            await this.hooks?.emit('agent:after_run', { msg, threadId, output: result.output });
+            await this.hooks?.emit('stream:finished', {
+                msg,
+                threadId,
+                messageIds: stream.getMessageIds(),
+            });
+        }
+        catch (error) {
+            console.error('[gateway] LLM run error:', error.message);
+            await stream.abort();
+            await this.hooks?.emit('agent:error', { msg, threadId, error });
+            throw error;
+        }
+    }
+    getThreadId(msg) {
+        if (this.config.session?.threadKey) {
+            return this.config.session.threadKey(msg);
+        }
+        return `${msg.channelType}:${msg.userId}`;
+    }
+    async resolveAgent(user) {
+        const agentOrFactory = this.config.agent;
+        if (typeof agentOrFactory === 'function') {
+            return agentOrFactory(user);
+        }
+        return agentOrFactory;
+    }
+    getAgentName() {
+        const agentOrFactory = this.config.agent;
+        if (typeof agentOrFactory === 'function') {
+            return 'dynamic';
+        }
+        return agentOrFactory.name;
+    }
+    createMiddlewareContext(threadId, user, channel) {
+        const store = new Map();
+        return {
+            threadId,
+            user,
+            channel,
+            set(key, value) {
+                store.set(key, value);
+            },
+            get(key) {
+                return store.get(key);
+            },
+        };
+    }
+    createSummarizeFn() {
+        return async (messages) => {
+            const text = messages
+                .map((m) => `${m.role}: ${typeof m.content === 'string' ? m.content : JSON.stringify(m.content)}`)
+                .join('\n');
+            return `[Summary of ${messages.length} messages]: ${text.slice(0, 500)}`;
+        };
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,28 @@
+import type { ChannelMessage, TimerStore, TimerEntry } from '@cogitator-ai/types';
+export interface HeartbeatConfig {
+    onFire: (msg: ChannelMessage) => Promise<void> | void;
+    pollInterval?: number;
+    getNextCronMs?: (cron: string) => number;
+    maxRetries?: number;
+    staggerMs?: number;
+    onRunComplete?: (entry: TimerEntry, status: 'ok' | 'error', error?: string, durationMs?: number) => void;
+}
+export declare class HeartbeatScheduler {
+    private store;
+    private config;
+    private timer;
+    private processing;
+    private readonly maxRetries;
+    constructor(store: TimerStore, config: HeartbeatConfig);
+    start(): void;
+    stop(): void;
+    listJobs(): Promise<TimerEntry[]>;
+    getJob(id: string): Promise<TimerEntry | null>;
+    cancelJob(id: string): Promise<void>;
+    enableJob(id: string): Promise<void>;
+    disableJob(id: string): Promise<void>;
+    private processOverdue;
+    private reschedule;
+    private rescheduleInterval;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,IAAI,GAAG,OAAO,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAC;CACX;AAED,qBAAa,kBAAkB;IAM3B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAG1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe;IAKjC,KAAK,IAAI,IAAI;IAkBb,IAAI,IAAI,IAAI;IAON,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAIjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAI7B,cAAc;YA2Ed,UAAU;YAiBV,kBAAkB;CAejC"}

package/dist/heartbeat.js

@@ -0,0 +1,143 @@
+export class HeartbeatScheduler {
+    store;
+    config;
+    timer = null;
+    processing = false;
+    maxRetries;
+    constructor(store, config) {
+        this.store = store;
+        this.config = config;
+        this.maxRetries = config.maxRetries ?? 5;
+    }
+    start() {
+        const stagger = this.config.staggerMs ? Math.floor(Math.random() * this.config.staggerMs) : 0;
+        const begin = () => {
+            void this.processOverdue();
+            this.timer = setInterval(() => void this.processOverdue(), this.config.pollInterval ?? 30_000);
+        };
+        if (stagger > 0) {
+            setTimeout(begin, stagger);
+        }
+        else {
+            begin();
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async listJobs() {
+        return this.store.list();
+    }
+    async getJob(id) {
+        return this.store.get(id);
+    }
+    async cancelJob(id) {
+        return this.store.cancel(id);
+    }
+    async enableJob(id) {
+        await this.store.update(id, { enabled: true, consecutiveErrors: 0 });
+    }
+    async disableJob(id) {
+        await this.store.update(id, { enabled: false });
+    }
+    async processOverdue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        let overdue;
+        try {
+            overdue = await this.store.getOverdue();
+        }
+        catch {
+            this.processing = false;
+            return;
+        }
+        for (const entry of overdue) {
+            if (entry.enabled === false)
+                continue;
+            if ((entry.consecutiveErrors ?? 0) >= this.maxRetries) {
+                await this.store.update(entry.id, { lastRunStatus: 'skipped' });
+                continue;
+            }
+            const meta = (entry.metadata ?? {});
+            const description = meta.description ?? '';
+            const msg = {
+                id: `heartbeat_${entry.id}`,
+                channelType: meta.channel ?? 'system',
+                channelId: meta.channelId ?? meta.userId ?? 'system',
+                userId: meta.userId ?? 'system',
+                text: `[SCHEDULED TASK] Execute this task that was scheduled earlier: "${description}". If it's a reminder — deliver it in a friendly way. If it's an action (e.g. check something, fetch data, run a tool) — do it and report the result.`,
+                raw: { scheduled: true, taskId: entry.id },
+            };
+            const startedAt = Date.now();
+            let status = 'ok';
+            let errorMsg;
+            try {
+                await this.config.onFire(msg);
+            }
+            catch (err) {
+                status = 'error';
+                errorMsg = err instanceof Error ? err.message : String(err);
+            }
+            const durationMs = Date.now() - startedAt;
+            const patch = {
+                lastRunAt: startedAt,
+                lastRunStatus: status,
+            };
+            if (status === 'error') {
+                patch.lastError = errorMsg;
+                if (meta.bestEffort) {
+                    patch.consecutiveErrors = 0;
+                }
+                else {
+                    patch.consecutiveErrors = (entry.consecutiveErrors ?? 0) + 1;
+                }
+            }
+            else {
+                patch.consecutiveErrors = 0;
+                patch.lastError = undefined;
+            }
+            await this.store.update(entry.id, patch);
+            await this.store.markFired(entry.id);
+            this.config.onRunComplete?.(entry, status, errorMsg, durationMs);
+            if (entry.cron) {
+                await this.reschedule(entry, meta);
+            }
+            else if (entry.type === 'recurring' && entry.interval) {
+                await this.rescheduleInterval(entry, meta);
+            }
+        }
+        this.processing = false;
+    }
+    async reschedule(entry, meta) {
+        const nextFire = this.config.getNextCronMs
+            ? this.config.getNextCronMs(entry.cron)
+            : Date.now() + 60_000;
+        await this.store.schedule({
+            workflowId: 'heartbeat',
+            runId: 'scheduler',
+            nodeId: 'task',
+            firesAt: nextFire,
+            type: 'cron',
+            cron: entry.cron,
+            metadata: meta,
+            name: entry.name,
+        });
+    }
+    async rescheduleInterval(entry, meta) {
+        await this.store.schedule({
+            workflowId: 'heartbeat',
+            runId: 'scheduler',
+            nodeId: 'task',
+            firesAt: Date.now() + entry.interval,
+            type: 'recurring',
+            interval: entry.interval,
+            metadata: meta,
+            name: entry.name,
+        });
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,4 @@
+import type { HookName, HookHandler, HookRegistry } from '@cogitator-ai/types';
+export type { HookName, HookHandler, HookRegistry };
+export declare function createHookRegistry(): HookRegistry;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/E,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAEpD,wBAAgB,kBAAkB,IAAI,YAAY,CA6BjD"}

package/dist/hooks.js

@@ -0,0 +1,30 @@
+export function createHookRegistry() {
+    const hooks = new Map();
+    return {
+        on(hook, handler) {
+            let set = hooks.get(hook);
+            if (!set) {
+                set = new Set();
+                hooks.set(hook, set);
+            }
+            set.add(handler);
+        },
+        off(hook, handler) {
+            hooks.get(hook)?.delete(handler);
+        },
+        async emit(hook, event) {
+            const set = hooks.get(hook);
+            if (!set)
+                return;
+            for (const handler of set) {
+                try {
+                    await handler(event);
+                }
+                catch (err) {
+                    console.error(`[hooks] Error in "${hook}" handler:`, err);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEpD,OAAO;QACL,EAAE,CAAC,IAAc,EAAE,OAAoB;YACrC,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;gBAChB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACvB,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;QAED,GAAG,CAAC,IAAc,EAAE,OAAoB;YACtC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAc,EAAE,KAAc;YACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,GAAG;gBAAE,OAAO;YACjB,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,YAAY,EAAE,GAAG,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/inbound-debounce.d.ts

@@ -0,0 +1,13 @@
+import type { ChannelMessage, DebounceConfig } from '@cogitator-ai/types';
+export declare class InboundDebouncer {
+    private readonly config;
+    private readonly onFlush;
+    private buffers;
+    private readonly defaultDelay;
+    constructor(config: DebounceConfig, onFlush: (merged: ChannelMessage) => Promise<void>);
+    enqueue(msg: ChannelMessage): void;
+    flushAll(): Promise<void>;
+    dispose(): void;
+    private flush;
+}
+//# sourceMappingURL=inbound-debounce.d.ts.map

package/dist/inbound-debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-debounce.d.ts","sourceRoot":"","sources":["../src/inbound-debounce.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1E,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC;IAKrE,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAe5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,OAAO,IAAI,IAAI;YAOD,KAAK;CA2BpB"}