agent-life-bridge 0.1.1

package/dist/channels/draft-stream-loop.js

@@ -0,0 +1,60 @@
+/**
+ * Manages the streaming reply lifecycle:
+ * 1. First chunk → sendMessage (creates the message, gets message_id)
+ * 2. Subsequent chunks → editMessageText (updates in place, debounced)
+ * 3. On complete → final editMessageText with full content
+ */
+export class DraftStreamLoop {
+    messageId = null;
+    buffer = '';
+    debounceTimer = null;
+    opts;
+    constructor(opts) {
+        this.opts = {
+            debounceMs: 1000,
+            ...opts,
+        };
+    }
+    async push(chunk) {
+        this.buffer += chunk;
+        if (this.messageId === null) {
+            // First chunk: send initial message, capture message_id
+            this.messageId = await this.opts.send(this.buffer);
+            return;
+        }
+        // Schedule debounced edit
+        this.scheduleEdit();
+    }
+    async complete() {
+        // Cancel pending debounce
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        // Final edit with complete content
+        if (this.messageId !== null && this.buffer) {
+            await this.opts.edit(this.messageId, this.buffer);
+        }
+    }
+    scheduleEdit() {
+        if (this.debounceTimer)
+            return;
+        if (this.messageId === null)
+            return;
+        this.debounceTimer = setTimeout(async () => {
+            this.debounceTimer = null;
+            if (this.messageId !== null) {
+                try {
+                    await this.opts.edit(this.messageId, this.buffer);
+                }
+                catch (err) {
+                    this.opts.logger.warn({ err }, 'Failed to edit message in stream');
+                }
+            }
+        }, this.opts.debounceMs);
+    }
+    getBuffer() {
+        return this.buffer;
+    }
+}
+//# sourceMappingURL=draft-stream-loop.js.map

package/dist/channels/draft-stream-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-stream-loop.js","sourceRoot":"","sources":["../../src/channels/draft-stream-loop.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAClB,SAAS,GAAkB,IAAI,CAAA;IAC/B,MAAM,GAAG,EAAE,CAAA;IACX,aAAa,GAA0B,IAAI,CAAA;IAClC,IAAI,CAA2B;IAEhD,YAAY,IAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG;YACV,UAAU,EAAE,IAAI;YAChB,GAAG,IAAI;SACR,CAAA;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAA;QAEpB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5B,wDAAwD;YACxD,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClD,OAAM;QACR,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,0BAA0B;QAC1B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;QAC3B,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACnD,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,aAAa;YAAE,OAAM;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;YAAE,OAAM;QAEnC,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;YACzB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBACnD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,kCAAkC,CAAC,CAAA;gBACpE,CAAC;YACH,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF"}

package/dist/channels/mention-gating.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detects whether a message is directed at a specific bot via @mention.
+ * In group/multi_bot chats, agents should only respond when mentioned.
+ */
+export interface MentionGatingOpts {
+    /** The bot's username (without @) */
+    botUsername: string;
+    /** Chat type */
+    chatType: 'private' | 'group' | 'multi_bot';
+    /** Extracted @mentions from the message */
+    mentions: string[];
+}
+export declare function isMentioned(opts: MentionGatingOpts): boolean;
+/**
+ * Strip @mention prefix from message text for cleaner agent input.
+ */
+export declare function stripMentions(text: string, mentions: string[]): string;
+//# sourceMappingURL=mention-gating.d.ts.map

package/dist/channels/mention-gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-gating.d.ts","sourceRoot":"","sources":["../../src/channels/mention-gating.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB;IAChB,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;IAC3C,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAM5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAQtE"}

package/dist/channels/mention-gating.js

@@ -0,0 +1,20 @@
+export function isMentioned(opts) {
+    // In private chats, always respond
+    if (opts.chatType === 'private')
+        return true;
+    const botUsernameLower = opts.botUsername.toLowerCase();
+    return opts.mentions.some(m => m.toLowerCase() === botUsernameLower);
+}
+/**
+ * Strip @mention prefix from message text for cleaner agent input.
+ */
+export function stripMentions(text, mentions) {
+    let result = text;
+    for (const mention of mentions) {
+        // Escape special regex characters in username to prevent ReDoS
+        const escaped = mention.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        result = result.replace(new RegExp(`@${escaped}\\s*`, 'gi'), '');
+    }
+    return result.trim();
+}
+//# sourceMappingURL=mention-gating.js.map

package/dist/channels/mention-gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-gating.js","sourceRoot":"","sources":["../../src/channels/mention-gating.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,WAAW,CAAC,IAAuB;IACjD,mCAAmC;IACnC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAE5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAA;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC,CAAA;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAkB;IAC5D,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,+DAA+D;QAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;QAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;AACtB,CAAC"}

package/dist/channels/registry.d.ts

@@ -0,0 +1,5 @@
+import type { ChannelPlugin } from '../types/index.js';
+export declare function registerChannel(plugin: ChannelPlugin): void;
+export declare function getChannel(id: string): ChannelPlugin | undefined;
+export declare function getAllChannels(): ChannelPlugin[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/channels/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAK3D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE;AAED,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAEhD"}

package/dist/channels/registry.js

@@ -0,0 +1,14 @@
+const registry = new Map();
+export function registerChannel(plugin) {
+    if (registry.has(plugin.id)) {
+        throw new Error(`Channel plugin "${plugin.id}" is already registered`);
+    }
+    registry.set(plugin.id, plugin);
+}
+export function getChannel(id) {
+    return registry.get(id);
+}
+export function getAllChannels() {
+    return Array.from(registry.values());
+}
+//# sourceMappingURL=registry.js.map

package/dist/channels/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/channels/registry.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEjD,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,EAAE,yBAAyB,CAAC,CAAA;IACxE,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;AACtC,CAAC"}

package/dist/channels/run-state-machine.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from '../types/index.js';
+/**
+ * Channel lifecycle states.
+ *
+ * Transitions:
+ *   idle → connecting → polling → disconnected → connecting (retry loop)
+ *                                 ↓
+ *                              stopped
+ */
+export type ChannelState = 'idle' | 'connecting' | 'polling' | 'disconnected' | 'stopped';
+export type StateChangeHandler = (from: ChannelState, to: ChannelState) => void;
+export declare class ChannelStateMachine {
+    private state;
+    private readonly logger;
+    private readonly handlers;
+    constructor(logger: Logger);
+    getState(): ChannelState;
+    onStateChange(handler: StateChangeHandler): void;
+    transition(to: ChannelState): void;
+}
+//# sourceMappingURL=run-state-machine.d.ts.map

package/dist/channels/run-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state-machine.d.ts","sourceRoot":"","sources":["../../src/channels/run-state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAA;AAEzF,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,KAAK,IAAI,CAAA;AAE/E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAExC,MAAM,EAAE,MAAM;IAI1B,QAAQ,IAAI,YAAY;IAIxB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIhD,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;CAqBnC"}

package/dist/channels/run-state-machine.js

@@ -0,0 +1,41 @@
+export class ChannelStateMachine {
+    state = 'idle';
+    logger;
+    handlers = [];
+    constructor(logger) {
+        this.logger = logger;
+    }
+    getState() {
+        return this.state;
+    }
+    onStateChange(handler) {
+        this.handlers.push(handler);
+    }
+    transition(to) {
+        const from = this.state;
+        // Validate transitions
+        const valid = TRANSITIONS[from];
+        if (!valid?.includes(to)) {
+            this.logger.warn({ from, to }, 'Invalid state transition attempted');
+            return;
+        }
+        this.state = to;
+        this.logger.info({ from, to }, 'Channel state transition');
+        for (const handler of this.handlers) {
+            try {
+                handler(from, to);
+            }
+            catch (err) {
+                this.logger.warn({ err }, 'State change handler error');
+            }
+        }
+    }
+}
+const TRANSITIONS = {
+    idle: ['connecting'],
+    connecting: ['polling', 'disconnected', 'stopped'],
+    polling: ['disconnected', 'stopped'],
+    disconnected: ['connecting', 'stopped'],
+    stopped: [],
+};
+//# sourceMappingURL=run-state-machine.js.map

package/dist/channels/run-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state-machine.js","sourceRoot":"","sources":["../../src/channels/run-state-machine.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAiB,MAAM,CAAA;IACnB,MAAM,CAAQ;IACd,QAAQ,GAAyB,EAAE,CAAA;IAEpD,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,aAAa,CAAC,OAA2B;QACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAED,UAAU,CAAC,EAAgB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAA;QAEvB,uBAAuB;QACvB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,oCAAoC,CAAC,CAAA;YACpE,OAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,0BAA0B,CAAC,CAAA;QAE1D,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,4BAA4B,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,WAAW,GAAyC;IACxD,IAAI,EAAE,CAAC,YAAY,CAAC;IACpB,UAAU,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC;IAClD,OAAO,EAAE,CAAC,cAAc,EAAE,SAAS,CAAC;IACpC,YAAY,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;IACvC,OAAO,EAAE,EAAE;CACZ,CAAA"}

package/dist/channels/session-envelope.d.ts

@@ -0,0 +1,5 @@
+import type { SessionEnvelope } from '../types/index.js';
+export type { SessionEnvelope };
+export declare function makeSessionId(botToken: string, chatId: number | string, messageThreadId?: number): string;
+export declare function isValidEnvelope(envelope: unknown): envelope is SessionEnvelope;
+//# sourceMappingURL=session-envelope.d.ts.map

package/dist/channels/session-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-envelope.d.ts","sourceRoot":"","sources":["../../src/channels/session-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAKR;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,eAAe,CAS9E"}

package/dist/channels/session-envelope.js

@@ -0,0 +1,16 @@
+export function makeSessionId(botToken, chatId, messageThreadId) {
+    if (typeof messageThreadId === 'number' && Number.isFinite(messageThreadId)) {
+        return `${botToken}:${chatId}:thread:${messageThreadId}`;
+    }
+    return `${botToken}:${chatId}`;
+}
+export function isValidEnvelope(envelope) {
+    if (!envelope || typeof envelope !== 'object')
+        return false;
+    const e = envelope;
+    return (typeof e.sessionId === 'string' &&
+        typeof e.source === 'object' &&
+        typeof e.content === 'object' &&
+        typeof e.meta === 'object');
+}
+//# sourceMappingURL=session-envelope.js.map

package/dist/channels/session-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-envelope.js","sourceRoot":"","sources":["../../src/channels/session-envelope.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,MAAuB,EACvB,eAAwB;IAExB,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,OAAO,GAAG,QAAQ,IAAI,MAAM,WAAW,eAAe,EAAE,CAAA;IAC1D,CAAC;IACD,OAAO,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3D,MAAM,CAAC,GAAG,QAAmC,CAAA;IAC7C,OAAO,CACL,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAC3B,CAAA;AACH,CAAC"}

package/dist/channels/session-id.d.ts

@@ -0,0 +1,3 @@
+export declare function generateRuntimeSessionId(now?: number): string;
+export declare function isRuntimeSessionId(value: string): boolean;
+//# sourceMappingURL=session-id.d.ts.map

package/dist/channels/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/channels/session-id.ts"],"names":[],"mappings":"AAIA,wBAAgB,wBAAwB,CAAC,GAAG,SAAa,GAAG,MAAM,CAIjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/channels/session-id.js

@@ -0,0 +1,11 @@
+import { randomBytes } from 'node:crypto';
+const SESSION_ID_PATTERN = /^sess_[0-9a-z]{10,18}_[0-9A-Za-z_-]{8}$/;
+export function generateRuntimeSessionId(now = Date.now()) {
+    const timestamp = Math.max(0, Math.floor(now)).toString(36).padStart(10, '0');
+    const randomPart = randomBytes(6).toString('base64url').slice(0, 8);
+    return `sess_${timestamp}_${randomPart}`;
+}
+export function isRuntimeSessionId(value) {
+    return SESSION_ID_PATTERN.test(value);
+}
+//# sourceMappingURL=session-id.js.map

package/dist/channels/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","sourceRoot":"","sources":["../../src/channels/session-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,kBAAkB,GAAG,yCAAyC,CAAA;AAEpE,MAAM,UAAU,wBAAwB,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC7E,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACnE,OAAO,QAAQ,SAAS,IAAI,UAAU,EAAE,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACvC,CAAC"}

package/dist/channels/session.d.ts

@@ -0,0 +1,18 @@
+import type { Logger, SessionEnvelope } from '../types/index.js';
+export interface Session {
+    id: string;
+    chatId: number | string;
+    chatType: 'private' | 'group' | 'multi_bot';
+    createdAt: number;
+    lastActivityAt: number;
+}
+export declare class SessionManager {
+    private sessions;
+    private readonly logger;
+    constructor(logger: Logger);
+    getOrCreate(envelope: SessionEnvelope): Session;
+    get(sessionId: string): Session | undefined;
+    delete(sessionId: string): void;
+    size(): number;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/channels/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEhE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,EAAE,MAAM;IAI1B,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAoB/C,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B,IAAI,IAAI,MAAM;CAGf"}

package/dist/channels/session.js

@@ -0,0 +1,35 @@
+export class SessionManager {
+    sessions = new Map();
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    getOrCreate(envelope) {
+        const existing = this.sessions.get(envelope.sessionId);
+        if (existing) {
+            existing.lastActivityAt = Date.now();
+            return existing;
+        }
+        const session = {
+            id: envelope.sessionId,
+            chatId: envelope.source.chatId,
+            chatType: envelope.source.chatType,
+            createdAt: Date.now(),
+            lastActivityAt: Date.now(),
+        };
+        this.sessions.set(session.id, session);
+        this.logger.info({ sessionId: session.id, chatType: session.chatType }, 'New session created');
+        return session;
+    }
+    get(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    delete(sessionId) {
+        this.sessions.delete(sessionId);
+        this.logger.info({ sessionId }, 'Session deleted');
+    }
+    size() {
+        return this.sessions.size;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/channels/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/channels/session.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC5B,MAAM,CAAQ;IAE/B,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,WAAW,CAAC,QAAyB;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACpC,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,QAAQ,CAAC,SAAS;YACtB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;YAC9B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;YAClC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;SAC3B,CAAA;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,qBAAqB,CAAC,CAAA;QAC9F,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,iBAAiB,CAAC,CAAA;IACpD,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAA;IAC3B,CAAC;CACF"}

package/dist/channels/typing-lifecycle.d.ts

@@ -0,0 +1,16 @@
+import type { Logger } from '../types/index.js';
+export type SendTypingFn = () => Promise<void>;
+/**
+ * Sends periodic "typing" indicators while an agent is working.
+ * Most platforms require the typing action to be re-sent every ~5s.
+ */
+export declare class TypingLifecycle {
+    private timer;
+    private readonly sendTyping;
+    private readonly intervalMs;
+    private readonly logger;
+    constructor(sendTyping: SendTypingFn, intervalMs?: number, logger?: Logger);
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=typing-lifecycle.d.ts.map

package/dist/channels/typing-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-lifecycle.d.ts","sourceRoot":"","sources":["../../src/channels/typing-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;AAE9C;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,UAAU,EAAE,YAAY,EAAE,UAAU,SAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IAMxE,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;CAMb"}

package/dist/channels/typing-lifecycle.js

@@ -0,0 +1,31 @@
+/**
+ * Sends periodic "typing" indicators while an agent is working.
+ * Most platforms require the typing action to be re-sent every ~5s.
+ */
+export class TypingLifecycle {
+    timer = null;
+    sendTyping;
+    intervalMs;
+    logger;
+    constructor(sendTyping, intervalMs = 4000, logger) {
+        this.sendTyping = sendTyping;
+        this.intervalMs = intervalMs;
+        this.logger = logger ?? { warn: () => { }, info: () => { } };
+    }
+    start() {
+        if (this.timer)
+            return;
+        // Send immediately, then repeat
+        this.sendTyping().catch(err => this.logger.warn({ err }, 'Failed to send typing indicator'));
+        this.timer = setInterval(() => {
+            this.sendTyping().catch(err => this.logger.warn({ err }, 'Failed to send typing indicator'));
+        }, this.intervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=typing-lifecycle.js.map

package/dist/channels/typing-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-lifecycle.js","sourceRoot":"","sources":["../../src/channels/typing-lifecycle.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,KAAK,GAA0B,IAAI,CAAA;IAC1B,UAAU,CAAc;IACxB,UAAU,CAAQ;IAClB,MAAM,CAAQ;IAE/B,YAAY,UAAwB,EAAE,UAAU,GAAG,IAAI,EAAE,MAAe;QACtE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAwB,CAAA;IACnF,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QACtB,gCAAgC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC,CAAA;QAC5F,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC,CAAA;QAC9F,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IACrB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/cli/cmd-add-agent.d.ts

@@ -0,0 +1,19 @@
+import { type AppConfig } from '../config/zod-schema.js';
+import type { CliArgs } from './run-main.js';
+export interface AddAgentInput {
+    id: string;
+    name?: string;
+    model?: string;
+    workspace?: string;
+    cliSessionId?: string;
+    default?: boolean;
+    accountId?: string;
+    account?: {
+        id: string;
+        gatewayUrl: string;
+        botToken: string;
+    };
+}
+export declare function addAgentToConfig(config: AppConfig, input: AddAgentInput): AppConfig;
+export declare function cmdAddAgent(args: CliArgs): Promise<void>;
+//# sourceMappingURL=cmd-add-agent.d.ts.map

package/dist/cli/cmd-add-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-add-agent.d.ts","sourceRoot":"","sources":["../../src/cli/cmd-add-agent.ts"],"names":[],"mappings":"AAQA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AA0DD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,CA4FnF;AAyPD,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E9D"}