@chozzz/vargos 2.0.5 → 2.0.7

package/dist/services/channels/contracts.js

@@ -0,0 +1,6 @@
+/**
+ * Channel adapter contracts — defines what every channel provider must implement.
+ * These interfaces form the boundary between core policy and adapter implementations.
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/services/channels/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../services/channels/contracts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/channels/debounce.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Per-key message debouncer
+ * Accumulates rapid messages from the same sender, flushes after a delay
+ * Prevents partial messages from triggering separate agent runs
+ */
+import type { NormalizedInboundMessage } from './contracts.js';
+export interface DebounceConfig {
+    /** Delay in ms before flushing accumulated messages (default: 1500) */
+    delayMs?: number;
+    /** Maximum messages to batch before force-flushing (default: 20) */
+    maxBatch?: number;
+}
+export interface MessageDebouncer {
+    /** Add a message for a given key. Resets the flush timer. */
+    push(key: string, message: string, metadata?: NormalizedInboundMessage): void;
+    /** Immediately flush pending messages for a key */
+    flush(key: string): void;
+    /** Immediately flush all pending keys */
+    flushAll(): void;
+}
+export declare function createMessageDebouncer(onFlush: (key: string, messages: string[], metadata?: NormalizedInboundMessage) => void, opts?: DebounceConfig): MessageDebouncer;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/services/channels/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../../services/channels/debounce.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC9E,mDAAmD;IACnD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,wBAAwB,KAAK,IAAI,EACvF,IAAI,GAAE,cAAmB,GACxB,gBAAgB,CAkDlB"}

package/dist/services/channels/debounce.js

@@ -0,0 +1,53 @@
+/**
+ * Per-key message debouncer
+ * Accumulates rapid messages from the same sender, flushes after a delay
+ * Prevents partial messages from triggering separate agent runs
+ */
+export function createMessageDebouncer(onFlush, opts = {}) {
+    const delayMs = opts.delayMs ?? 1500;
+    const maxBatch = opts.maxBatch ?? 20;
+    const pending = new Map();
+    function flush(key) {
+        const entry = pending.get(key);
+        if (!entry)
+            return;
+        pending.delete(key);
+        clearTimeout(entry.timer);
+        if (entry.messages.length > 0) {
+            onFlush(key, entry.messages, entry.metadata);
+        }
+    }
+    return {
+        flush,
+        flushAll() {
+            const keys = [...pending.keys()];
+            for (const key of keys)
+                flush(key);
+        },
+        push(key, message, metadata) {
+            let entry = pending.get(key);
+            if (!entry) {
+                entry = {
+                    messages: [],
+                    metadata,
+                    timer: setTimeout(() => flush(key), delayMs),
+                };
+                pending.set(key, entry);
+            }
+            else {
+                // Reset timer on each new message
+                clearTimeout(entry.timer);
+                entry.timer = setTimeout(() => flush(key), delayMs);
+                // Update metadata if provided (latest metadata wins)
+                if (metadata)
+                    entry.metadata = metadata;
+            }
+            entry.messages.push(message);
+            // Force flush if batch is full
+            if (entry.messages.length >= maxBatch) {
+                flush(key);
+            }
+        },
+    };
+}
+//# sourceMappingURL=debounce.js.map

package/dist/services/channels/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../../services/channels/debounce.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,UAAU,sBAAsB,CACpC,OAAuF,EACvF,OAAuB,EAAE;IAEzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6G,CAAC;IAErI,SAAS,KAAK,CAAC,GAAW;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QAEL,QAAQ;YACN,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,GAAW,EAAE,OAAe,EAAE,QAAmC;YACpE,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG;oBACN,QAAQ,EAAE,EAAE;oBACZ,QAAQ;oBACR,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;iBAC7C,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,kCAAkC;gBAClC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1B,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;gBACpD,qDAAqD;gBACrD,IAAI,QAAQ;oBAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC1C,CAAC;YAED,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE7B,+BAA+B;YAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBACtC,KAAK,CAAC,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/channels/dedupe.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Message deduplication cache
+ * Prevents processing the same message twice within a TTL window
+ */
+export interface DedupeConfig {
+    /** Time-to-live in milliseconds (default: 60_000) */
+    ttlMs?: number;
+    /** Max entries before oldest are evicted (default: 10_000) */
+    maxSize?: number;
+}
+export interface DedupeCache {
+    /** Returns true if the key was already seen (still within TTL) */
+    has(key: string): boolean;
+    /** Mark key as seen; returns true if it was new */
+    add(key: string): boolean;
+    size: number;
+}
+export declare function createDedupeCache(opts?: DedupeConfig): DedupeCache;
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/services/channels/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../../../services/channels/dedupe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,mDAAmD;IACnD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,YAAiB,GAAG,WAAW,CA8CtE"}

package/dist/services/channels/dedupe.js

@@ -0,0 +1,52 @@
+/**
+ * Message deduplication cache
+ * Prevents processing the same message twice within a TTL window
+ */
+export function createDedupeCache(opts = {}) {
+    const ttlMs = opts.ttlMs ?? 60_000;
+    const maxSize = opts.maxSize ?? 10_000;
+    const entries = new Map();
+    function evictExpired() {
+        const now = Date.now();
+        for (const [key, ts] of entries) {
+            if (now - ts > ttlMs)
+                entries.delete(key);
+        }
+    }
+    function evictOldest() {
+        if (entries.size <= maxSize)
+            return;
+        const toRemove = entries.size - maxSize;
+        let removed = 0;
+        for (const key of entries.keys()) {
+            if (removed >= toRemove)
+                break;
+            entries.delete(key);
+            removed++;
+        }
+    }
+    return {
+        has(key) {
+            const ts = entries.get(key);
+            if (ts === undefined)
+                return false;
+            if (Date.now() - ts > ttlMs) {
+                entries.delete(key);
+                return false;
+            }
+            return true;
+        },
+        add(key) {
+            if (this.has(key))
+                return false;
+            entries.set(key, Date.now());
+            evictOldest();
+            return true;
+        },
+        get size() {
+            evictExpired();
+            return entries.size;
+        },
+    };
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/services/channels/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../../../services/channels/dedupe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,UAAU,iBAAiB,CAAC,OAAqB,EAAE;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,SAAS,YAAY;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;YAChC,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO;YAAE,OAAO;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;QACxC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,IAAI,OAAO,IAAI,QAAQ;gBAAE,MAAM;YAC/B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAC,GAAW;YACb,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;gBAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,GAAW;YACb,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC7B,WAAW,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI;YACN,YAAY,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/services/channels/delivery.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reply delivery with chunking and retry
+ * Splits long responses on paragraph/sentence boundaries
+ */
+export type SendFn = (text: string) => Promise<void>;
+export declare function deliverReply(send: SendFn, text: string, opts?: {
+    maxChunkSize?: number;
+    chunkDelayMs?: number;
+    maxRetries?: number;
+    retryBaseMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/services/channels/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../services/channels/delivery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AA6BrD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrG,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/services/channels/delivery.js

@@ -0,0 +1,53 @@
+/**
+ * Reply delivery with chunking and retry
+ * Splits long responses on paragraph/sentence boundaries
+ */
+import { createLogger } from '../../lib/logger.js';
+import { sleep } from '../../lib/sleep.js';
+import { withRetry } from '../../lib/retry.js';
+const log = createLogger('delivery');
+function chunkText(text, maxSize) {
+    if (text.length <= maxSize)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxSize) {
+            chunks.push(remaining);
+            break;
+        }
+        let splitAt = remaining.lastIndexOf('\n\n', maxSize);
+        if (splitAt <= 0)
+            splitAt = remaining.lastIndexOf('\n', maxSize);
+        if (splitAt <= 0) {
+            splitAt = remaining.lastIndexOf('. ', maxSize);
+            if (splitAt > 0)
+                splitAt += 1;
+        }
+        if (splitAt <= 0)
+            splitAt = maxSize;
+        chunks.push(remaining.slice(0, splitAt).trimEnd());
+        remaining = remaining.slice(splitAt).trimStart();
+    }
+    return chunks.filter((c) => c.length > 0);
+}
+export async function deliverReply(send, text, opts = {}) {
+    const maxChunkSize = opts.maxChunkSize ?? 4000;
+    const chunkDelayMs = opts.chunkDelayMs ?? 500;
+    const maxRetries = opts.maxRetries ?? 3;
+    const retryBaseMs = opts.retryBaseMs ?? 1000;
+    log.debug(`deliverReply: received text of ${text.length} chars`);
+    if (text.length === 0) {
+        log.warn(`deliverReply: empty text, skipping delivery`);
+        return;
+    }
+    const chunks = chunkText(text, maxChunkSize);
+    log.debug(`delivering ${text.length} chars in ${chunks.length} chunk(s)`);
+    for (let i = 0; i < chunks.length; i++) {
+        log.debug(`  chunk[${i}]: ${chunks[i].length} chars`);
+        await withRetry(() => send(chunks[i]), { maxRetries, baseMs: retryBaseMs, jitter: false });
+        if (i < chunks.length - 1)
+            await sleep(chunkDelayMs);
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/services/channels/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../services/channels/delivery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;AAIrC,SAAS,SAAS,CAAC,IAAY,EAAE,OAAe;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;QAED,IAAI,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjE,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/C,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,IAAI,CAAC;YAAE,OAAO,GAAG,OAAO,CAAC;QAEpC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,IAAY,EACZ,OAAoG,EAAE;IAEtG,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IAE7C,GAAG,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,MAAM,aAAa,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IAE1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC;QACtD,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3F,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/services/channels/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Channel service — manages external messaging adapters.
+ *
+ * Callable: channel.send, channel.sendMedia, channel.search, channel.get, channel.register
+ * Pure events emitted: channel.onConnected, channel.onDisconnected
+ * Pure events subscribed: agent.onDelta, agent.onTool, agent.onCompleted
+ *
+ * Inbound flow:
+ *   adapter → normalizer → pipeline → expand links → whitelist check → agent.execute
+ *   agent.onTool updates reaction phase
+ *   agent.onCompleted stops typing + seals reaction + delivers reply
+ *
+ * Reply routing:
+ *   - Channel-triggered: agent.onCompleted looks up activeSessions, delivers to source
+ *   - Non-channel (cron, etc): agent.onCompleted ignored — caller is responsible for reply delivery
+ *
+ * Outbound flow: channel.send → strip markdown → chunk → adapter.send
+ */
+import type { Bus } from '../../gateway/bus.js';
+import type { EventMap } from '../../gateway/events.js';
+import type { AppConfig } from '../../services/config/index.js';
+import type { NormalizedInboundMessage } from './contracts.js';
+export declare class ChannelService {
+    private readonly bus;
+    private readonly config;
+    private adapters;
+    private activeSessions;
+    private registry;
+    private pipeline;
+    constructor(bus: Bus, config: AppConfig);
+    start(): Promise<void>;
+    private registerProviders;
+    stop(): Promise<void>;
+    send(params: EventMap['channel.send']['params']): Promise<EventMap['channel.send']['result']>;
+    sendMedia(params: EventMap['channel.sendMedia']['params']): Promise<EventMap['channel.sendMedia']['result']>;
+    search(params: EventMap['channel.search']['params']): Promise<EventMap['channel.search']['result']>;
+    get(params: EventMap['channel.get']['params']): Promise<EventMap['channel.get']['result']>;
+    register(params: EventMap['channel.register']['params']): Promise<void>;
+    private onAgentTool;
+    private onAgentCompleted;
+    /**
+     * Process a normalized inbound message from an adapter.
+     * Called by adapters after normalizing their raw message format.
+     */
+    onInboundMessage(sessionKey: string, message: NormalizedInboundMessage): Promise<void>;
+    private startChannel;
+    private createAdapter;
+    private startAllConfigured;
+}
+export declare function boot(bus: Bus): Promise<{
+    stop(): Promise<void>;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../services/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,gCAAgC,CAAC;AAM9E,OAAO,KAAK,EAAmC,wBAAwB,EAAe,MAAM,gBAAgB,CAAC;AA6B7G,qBAAa,cAAc;IAOvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAyB;gBAGtB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,SAAS;IAK9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAKd,iBAAiB;IAOzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC;IA6C7F,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAqB5G,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAkBnG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC;IAqB1F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7E,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,gBAAgB;IAuDxB;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC;YAoBF,YAAY;YAmBZ,aAAa;YAcb,kBAAkB;CAiBjC;AAID,wBAAsB,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAMvE"}