@soleri/core 2.9.0 → 2.11.0

package/dist/chat/chat-session.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Chat Session Manager — per-conversation history with disk persistence.
+ *
+ * Ported from Salvador's session-manager.ts with improvements:
+ * - Transport-agnostic (no Telegram coupling)
+ * - Synchronous persistence (matches Soleri's better-sqlite3 heritage)
+ * - Simpler compaction (no personality tracking)
+ * - TTL-based reaping with unref'd timer
+ */
+import type { ChatSession, ChatSessionConfig, ChatMessage } from './types.js';
+export declare class ChatSessionManager {
+    private sessions;
+    private config;
+    private reaperTimer;
+    constructor(config: ChatSessionConfig);
+    /**
+     * Get or create a session. Loads from disk if not in memory.
+     */
+    getOrCreate(sessionId: string): ChatSession;
+    /**
+     * Get a session without creating one.
+     */
+    get(sessionId: string): ChatSession | undefined;
+    /**
+     * Check if a session exists (memory or disk).
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Append a message and persist.
+     */
+    appendMessage(sessionId: string, message: ChatMessage): void;
+    /**
+     * Append multiple messages (e.g. assistant response + tool blocks).
+     */
+    appendMessages(sessionId: string, messages: ChatMessage[]): void;
+    /**
+     * Get message count for a session.
+     */
+    messageCount(sessionId: string): number;
+    /**
+     * Clear session history (keep session alive, wipe messages).
+     */
+    clear(sessionId: string): void;
+    /**
+     * Delete a session entirely (memory + disk).
+     */
+    delete(sessionId: string): void;
+    /**
+     * List all active session IDs (memory only — disk sessions not loaded).
+     */
+    listActive(): string[];
+    /**
+     * List all session IDs (memory + disk).
+     */
+    listAll(): string[];
+    /**
+     * Number of active (in-memory) sessions.
+     */
+    get size(): number;
+    /**
+     * Update session metadata.
+     */
+    setMeta(sessionId: string, meta: Record<string, unknown>): void;
+    /**
+     * Start periodic TTL-based session cleanup.
+     */
+    startReaper(): void;
+    /**
+     * Stop the reaper.
+     */
+    stopReaper(): void;
+    /**
+     * Reap expired sessions. Returns number of sessions reaped.
+     */
+    reap(): number;
+    /**
+     * Close all sessions and stop reaper.
+     */
+    close(): void;
+    private compact;
+    private sessionPath;
+    private persistToDisk;
+    private loadFromDisk;
+    private removeFromDisk;
+}
+//# sourceMappingURL=chat-session.d.ts.map

package/dist/chat/chat-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.d.ts","sourceRoot":"","sources":["../../src/chat/chat-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9E,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,WAAW,CAA+C;gBAEtD,MAAM,EAAE,iBAAiB;IAarC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IA4B3C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI/C;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAO/B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAa5D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAYhE;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAOvC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAY9B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAenB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ/D;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,IAAI,IAAI,MAAM;IAkBd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/chat/chat-session.js

@@ -0,0 +1,252 @@
+/**
+ * Chat Session Manager — per-conversation history with disk persistence.
+ *
+ * Ported from Salvador's session-manager.ts with improvements:
+ * - Transport-agnostic (no Telegram coupling)
+ * - Synchronous persistence (matches Soleri's better-sqlite3 heritage)
+ * - Simpler compaction (no personality tracking)
+ * - TTL-based reaping with unref'd timer
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_TTL_MS = 7_200_000; // 2 hours
+const DEFAULT_COMPACTION_THRESHOLD = 100;
+const DEFAULT_COMPACTION_KEEP = 40;
+const REAPER_INTERVAL_MS = 60_000; // 1 minute
+export class ChatSessionManager {
+    sessions = new Map();
+    config;
+    reaperTimer = null;
+    constructor(config) {
+        this.config = {
+            storageDir: config.storageDir,
+            ttlMs: config.ttlMs ?? DEFAULT_TTL_MS,
+            compactionThreshold: config.compactionThreshold ?? DEFAULT_COMPACTION_THRESHOLD,
+            compactionKeep: config.compactionKeep ?? DEFAULT_COMPACTION_KEEP,
+        };
+        mkdirSync(this.config.storageDir, { recursive: true });
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────
+    /**
+     * Get or create a session. Loads from disk if not in memory.
+     */
+    getOrCreate(sessionId) {
+        let session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActiveAt = Date.now();
+            return session;
+        }
+        // Try loading from disk
+        session = this.loadFromDisk(sessionId);
+        if (session) {
+            session.lastActiveAt = Date.now();
+            this.sessions.set(sessionId, session);
+            return session;
+        }
+        // Create new
+        const now = Date.now();
+        session = {
+            id: sessionId,
+            messages: [],
+            createdAt: now,
+            lastActiveAt: now,
+        };
+        this.sessions.set(sessionId, session);
+        this.persistToDisk(session);
+        return session;
+    }
+    /**
+     * Get a session without creating one.
+     */
+    get(sessionId) {
+        return this.sessions.get(sessionId) ?? this.loadFromDisk(sessionId);
+    }
+    /**
+     * Check if a session exists (memory or disk).
+     */
+    has(sessionId) {
+        if (this.sessions.has(sessionId))
+            return true;
+        return existsSync(this.sessionPath(sessionId));
+    }
+    // ─── Message Management ─────────────────────────────────────────
+    /**
+     * Append a message and persist.
+     */
+    appendMessage(sessionId, message) {
+        const session = this.getOrCreate(sessionId);
+        session.messages.push(message);
+        session.lastActiveAt = Date.now();
+        // Auto-compact if threshold exceeded
+        if (session.messages.length > this.config.compactionThreshold) {
+            this.compact(session);
+        }
+        this.persistToDisk(session);
+    }
+    /**
+     * Append multiple messages (e.g. assistant response + tool blocks).
+     */
+    appendMessages(sessionId, messages) {
+        const session = this.getOrCreate(sessionId);
+        session.messages.push(...messages);
+        session.lastActiveAt = Date.now();
+        if (session.messages.length > this.config.compactionThreshold) {
+            this.compact(session);
+        }
+        this.persistToDisk(session);
+    }
+    /**
+     * Get message count for a session.
+     */
+    messageCount(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session?.messages.length ?? 0;
+    }
+    // ─── Session Operations ─────────────────────────────────────────
+    /**
+     * Clear session history (keep session alive, wipe messages).
+     */
+    clear(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.messages = [];
+            session.lastActiveAt = Date.now();
+            this.persistToDisk(session);
+        }
+        else {
+            // Remove from disk
+            this.removeFromDisk(sessionId);
+        }
+    }
+    /**
+     * Delete a session entirely (memory + disk).
+     */
+    delete(sessionId) {
+        this.sessions.delete(sessionId);
+        this.removeFromDisk(sessionId);
+    }
+    /**
+     * List all active session IDs (memory only — disk sessions not loaded).
+     */
+    listActive() {
+        return [...this.sessions.keys()];
+    }
+    /**
+     * List all session IDs (memory + disk).
+     */
+    listAll() {
+        const memoryIds = new Set(this.sessions.keys());
+        try {
+            const files = readdirSync(this.config.storageDir);
+            for (const f of files) {
+                if (f.endsWith('.json')) {
+                    memoryIds.add(f.replace('.json', ''));
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet
+        }
+        return [...memoryIds];
+    }
+    /**
+     * Number of active (in-memory) sessions.
+     */
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Update session metadata.
+     */
+    setMeta(sessionId, meta) {
+        const session = this.getOrCreate(sessionId);
+        session.meta = { ...session.meta, ...meta };
+        this.persistToDisk(session);
+    }
+    // ─── Reaping (TTL cleanup) ─────────────────────────────────────
+    /**
+     * Start periodic TTL-based session cleanup.
+     */
+    startReaper() {
+        if (this.reaperTimer)
+            return;
+        this.reaperTimer = setInterval(() => this.reap(), REAPER_INTERVAL_MS);
+        this.reaperTimer.unref();
+    }
+    /**
+     * Stop the reaper.
+     */
+    stopReaper() {
+        if (this.reaperTimer) {
+            clearInterval(this.reaperTimer);
+            this.reaperTimer = null;
+        }
+    }
+    /**
+     * Reap expired sessions. Returns number of sessions reaped.
+     */
+    reap() {
+        if (this.config.ttlMs <= 0)
+            return 0;
+        const now = Date.now();
+        const cutoff = now - this.config.ttlMs;
+        let reaped = 0;
+        for (const [id, session] of this.sessions) {
+            if (session.lastActiveAt < cutoff) {
+                this.sessions.delete(id);
+                this.removeFromDisk(id);
+                reaped++;
+            }
+        }
+        return reaped;
+    }
+    /**
+     * Close all sessions and stop reaper.
+     */
+    close() {
+        this.stopReaper();
+        this.sessions.clear();
+    }
+    // ─── Private ───────────────────────────────────────────────────
+    compact(session) {
+        const keep = this.config.compactionKeep;
+        if (session.messages.length <= keep)
+            return;
+        session.messages = session.messages.slice(-keep);
+    }
+    sessionPath(sessionId) {
+        // Sanitize ID for filesystem safety
+        const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return join(this.config.storageDir, `${safe}.json`);
+    }
+    persistToDisk(session) {
+        try {
+            writeFileSync(this.sessionPath(session.id), JSON.stringify(session), 'utf-8');
+        }
+        catch {
+            // Disk write failure is non-critical — session lives in memory
+        }
+    }
+    loadFromDisk(sessionId) {
+        const path = this.sessionPath(sessionId);
+        if (!existsSync(path))
+            return undefined;
+        try {
+            const data = readFileSync(path, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    removeFromDisk(sessionId) {
+        const path = this.sessionPath(sessionId);
+        try {
+            rmSync(path, { force: true });
+        }
+        catch {
+            // Removal failure is non-critical
+        }
+    }
+}
+//# sourceMappingURL=chat-session.js.map

package/dist/chat/chat-session.js.map

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

package/dist/chat/file-handler.d.ts

@@ -0,0 +1,63 @@
+/**
+ * File Handler — intent detection and multimodal message building for chat transports.
+ *
+ * Provides transport-agnostic utilities for handling files sent by users:
+ * - Intent detection: should this file be viewed (vision), read as text, or ingested?
+ * - Multimodal message building for Anthropic API (ImageBlock, DocumentBlock)
+ * - Temp file management
+ *
+ * The actual file download is transport-specific (Telegram, Discord, etc.)
+ * and belongs in forge templates.
+ */
+/** Maximum file size in bytes (Telegram limit). */
+export declare const MAX_FILE_SIZE: number;
+/** File extensions treated as readable text. */
+export declare const TEXT_EXTENSIONS: Set<string>;
+/** MIME types supported for vision (ImageBlock). */
+export declare const IMAGE_MIME_TYPES: Set<string>;
+/** Keywords that indicate the user wants to ingest/learn from the file. */
+export declare const INTAKE_KEYWORDS: string[];
+export type FileIntent = 'vision' | 'text' | 'intake';
+export interface FileInfo {
+    /** Original filename. */
+    name: string;
+    /** MIME type. */
+    mimeType: string;
+    /** File size in bytes. */
+    size: number;
+    /** File content as Buffer. */
+    data: Buffer;
+}
+export interface MultimodalContent {
+    type: 'image' | 'document' | 'text';
+    /** For image: base64 data. For document: base64 data. For text: the text content. */
+    content: string;
+    /** MIME type (for image/document). */
+    mimeType?: string;
+    /** Source filename. */
+    filename?: string;
+}
+/**
+ * Detect what the user wants to do with a file based on its type and
+ * any accompanying text message.
+ */
+export declare function detectFileIntent(filename: string, mimeType: string, userText?: string): FileIntent;
+/**
+ * Build multimodal content from a file for the Anthropic API.
+ */
+export declare function buildMultimodalContent(file: FileInfo, intent: FileIntent): MultimodalContent;
+/**
+ * Save a file to a temp directory with timestamp prefix.
+ * Returns the full path.
+ */
+export declare function saveTempFile(uploadDir: string, filename: string, data: Buffer): string;
+/**
+ * Clean up temp files older than maxAgeMs.
+ */
+export declare function cleanupTempFiles(uploadDir: string, maxAgeMs?: number): number;
+/**
+ * Strip base64 data from multimodal content for session persistence.
+ * Replaces binary content with a size placeholder to prevent session bloat.
+ */
+export declare function sanitizeForPersistence(content: MultimodalContent): MultimodalContent;
+//# sourceMappingURL=file-handler.d.ts.map

package/dist/chat/file-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-handler.d.ts","sourceRoot":"","sources":["../../src/chat/file-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,mDAAmD;AACnD,eAAO,MAAM,aAAa,QAAmB,CAAC;AAE9C,gDAAgD;AAChD,eAAO,MAAM,eAAe,aAuC1B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,aAAkE,CAAC;AAEhG,2EAA2E;AAC3E,eAAO,MAAM,eAAe,UAY3B,CAAC;AAIF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACpC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CA0BZ;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,iBAAiB,CA2B5F;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkB,GAAG,MAAM,CAqBxF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAQpF"}

package/dist/chat/file-handler.js

@@ -0,0 +1,182 @@
+/**
+ * File Handler — intent detection and multimodal message building for chat transports.
+ *
+ * Provides transport-agnostic utilities for handling files sent by users:
+ * - Intent detection: should this file be viewed (vision), read as text, or ingested?
+ * - Multimodal message building for Anthropic API (ImageBlock, DocumentBlock)
+ * - Temp file management
+ *
+ * The actual file download is transport-specific (Telegram, Discord, etc.)
+ * and belongs in forge templates.
+ */
+import { mkdirSync, writeFileSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join, extname } from 'node:path';
+// ─── Constants ────────────────────────────────────────────────────────
+/** Maximum file size in bytes (Telegram limit). */
+export const MAX_FILE_SIZE = 20 * 1024 * 1024; // 20MB
+/** File extensions treated as readable text. */
+export const TEXT_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.py',
+    '.rb',
+    '.rs',
+    '.go',
+    '.java',
+    '.kt',
+    '.swift',
+    '.c',
+    '.cpp',
+    '.h',
+    '.cs',
+    '.php',
+    '.sh',
+    '.bash',
+    '.zsh',
+    '.fish',
+    '.md',
+    '.txt',
+    '.json',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.xml',
+    '.html',
+    '.css',
+    '.scss',
+    '.sql',
+    '.graphql',
+    '.prisma',
+    '.env',
+    '.gitignore',
+    '.dockerfile',
+    '.csv',
+    '.log',
+]);
+/** MIME types supported for vision (ImageBlock). */
+export const IMAGE_MIME_TYPES = new Set(['image/jpeg', 'image/png', 'image/gif', 'image/webp']);
+/** Keywords that indicate the user wants to ingest/learn from the file. */
+export const INTAKE_KEYWORDS = [
+    'learn',
+    'ingest',
+    'absorb',
+    'study',
+    'memorize',
+    'remember',
+    'read this',
+    'save this',
+    'store this',
+    'add to vault',
+    'add to knowledge',
+];
+// ─── Intent Detection ─────────────────────────────────────────────────
+/**
+ * Detect what the user wants to do with a file based on its type and
+ * any accompanying text message.
+ */
+export function detectFileIntent(filename, mimeType, userText) {
+    const ext = extname(filename).toLowerCase();
+    const textLower = userText?.toLowerCase() ?? '';
+    // Check for intake keywords first
+    if (userText && INTAKE_KEYWORDS.some((kw) => textLower.includes(kw))) {
+        return 'intake';
+    }
+    // Text files → read as text
+    if (TEXT_EXTENSIONS.has(ext)) {
+        return 'text';
+    }
+    // Images → vision
+    if (IMAGE_MIME_TYPES.has(mimeType) || mimeType.startsWith('image/')) {
+        return 'vision';
+    }
+    // PDFs → vision (DocumentBlock)
+    if (mimeType === 'application/pdf' || ext === '.pdf') {
+        return 'vision';
+    }
+    // Default: try vision
+    return 'vision';
+}
+// ─── Multimodal Message Building ──────────────────────────────────────
+/**
+ * Build multimodal content from a file for the Anthropic API.
+ */
+export function buildMultimodalContent(file, intent) {
+    const ext = extname(file.name).toLowerCase();
+    if (intent === 'text' || TEXT_EXTENSIONS.has(ext)) {
+        return {
+            type: 'text',
+            content: file.data.toString('utf-8'),
+            filename: file.name,
+        };
+    }
+    if (IMAGE_MIME_TYPES.has(file.mimeType)) {
+        return {
+            type: 'image',
+            content: file.data.toString('base64'),
+            mimeType: file.mimeType,
+            filename: file.name,
+        };
+    }
+    // PDF and other documents
+    return {
+        type: 'document',
+        content: file.data.toString('base64'),
+        mimeType: file.mimeType,
+        filename: file.name,
+    };
+}
+// ─── Temp File Management ─────────────────────────────────────────────
+/**
+ * Save a file to a temp directory with timestamp prefix.
+ * Returns the full path.
+ */
+export function saveTempFile(uploadDir, filename, data) {
+    mkdirSync(uploadDir, { recursive: true });
+    const safeName = filename.replace(/[^\w.-]/g, '_');
+    const path = join(uploadDir, `${Date.now()}-${safeName}`);
+    writeFileSync(path, data);
+    return path;
+}
+/**
+ * Clean up temp files older than maxAgeMs.
+ */
+export function cleanupTempFiles(uploadDir, maxAgeMs = 3_600_000) {
+    let removed = 0;
+    try {
+        const cutoff = Date.now() - maxAgeMs;
+        const files = readdirSync(uploadDir);
+        for (const file of files) {
+            const filePath = join(uploadDir, file);
+            try {
+                const stat = statSync(filePath);
+                if (stat.mtimeMs < cutoff) {
+                    rmSync(filePath);
+                    removed++;
+                }
+            }
+            catch {
+                // Skip files we can't stat
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return removed;
+}
+/**
+ * Strip base64 data from multimodal content for session persistence.
+ * Replaces binary content with a size placeholder to prevent session bloat.
+ */
+export function sanitizeForPersistence(content) {
+    if (content.type === 'text')
+        return content;
+    const sizeKb = Math.round(Buffer.byteLength(content.content, 'base64') / 1024);
+    return {
+        ...content,
+        content: `[${content.type}: ${content.filename ?? 'file'}, ${sizeKb}KB]`,
+    };
+}
+//# sourceMappingURL=file-handler.js.map

package/dist/chat/file-handler.js.map

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

package/dist/chat/fragment-buffer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Fragment Buffer — merges split messages from chat platforms.
+ *
+ * Telegram, Discord, and other platforms split long pastes into multiple
+ * messages (e.g. Telegram's 4096 char limit). This buffer detects near-limit
+ * messages and waits briefly for follow-up parts before flushing as one unit.
+ *
+ * Ported from Salvador's handler-messages.ts with improvements:
+ * - Transport-agnostic (works for any chat platform)
+ * - Callback-based flush (no transport dependency)
+ * - Configurable thresholds
+ */
+import type { Fragment, FragmentBufferConfig } from './types.js';
+export declare class FragmentBuffer {
+    private buffers;
+    private config;
+    private onFlush;
+    constructor(config: FragmentBufferConfig | undefined, onFlush: (key: string, merged: string) => void);
+    /**
+     * Receive a message. Returns true if the message was buffered (caller should wait),
+     * false if the message should be processed immediately.
+     */
+    receive(key: string, fragment: Fragment): boolean;
+    /**
+     * Force-flush a specific buffer. Returns the merged text or null if no buffer.
+     */
+    flush(key: string): string | null;
+    /**
+     * Force-flush all pending buffers.
+     */
+    flushAll(): void;
+    /**
+     * Number of keys with pending fragments.
+     */
+    get pendingCount(): number;
+    /**
+     * Check if a key has pending fragments.
+     */
+    hasPending(key: string): boolean;
+    /**
+     * Close the buffer — flush all and clean up timers.
+     */
+    close(): void;
+    private startBuffer;
+    private appendToBuffer;
+    private autoFlush;
+    private mergeFragments;
+}
+//# sourceMappingURL=fragment-buffer.d.ts.map

package/dist/chat/fragment-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-buffer.d.ts","sourceRoot":"","sources":["../../src/chat/fragment-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAcjE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAwC;gBAGrD,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAWhD;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAkBjD;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAUjC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAShB;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,cAAc;CAGvB"}