@soleri/core 2.10.0 → 2.12.0

package/dist/chat/queue.js

@@ -0,0 +1,146 @@
+/**
+ * Message Queue — disk-based message passing for zero-cost chat relay.
+ *
+ * The queue bot writes incoming messages to inbox/. Claude Code (or any
+ * processor) reads them, generates responses, and writes to outbox/.
+ * The outbox poller sends replies back through the chat transport.
+ *
+ * Directory structure:
+ *   ~/.{agentId}/queue/
+ *     inbox/    ← bot writes, processor reads
+ *     outbox/   ← processor writes, bot reads and sends
+ */
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, unlinkSync, existsSync, } from 'node:fs';
+import { join } from 'node:path';
+// ─── Queue Manager ───────────────────────────────────────────────────
+export class MessageQueue {
+    inboxDir;
+    outboxDir;
+    constructor(config) {
+        this.inboxDir = join(config.queueDir, 'inbox');
+        this.outboxDir = join(config.queueDir, 'outbox');
+        mkdirSync(this.inboxDir, { recursive: true });
+        mkdirSync(this.outboxDir, { recursive: true });
+    }
+    /**
+     * Enqueue an incoming message to inbox.
+     */
+    enqueue(msg) {
+        const timestamp = new Date().toISOString();
+        const id = `${msg.chatId}-${Date.now()}`;
+        const queued = { ...msg, id, timestamp };
+        const filename = `${id}.json`;
+        writeFileSync(join(this.inboxDir, filename), JSON.stringify(queued, null, 2), 'utf-8');
+        return queued;
+    }
+    /**
+     * Read all pending inbox messages, sorted by timestamp.
+     */
+    readInbox() {
+        const files = this.listJsonFiles(this.inboxDir);
+        const messages = [];
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(this.inboxDir, file), 'utf-8');
+                messages.push(JSON.parse(raw));
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+        return messages.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    /**
+     * Get the number of pending inbox messages.
+     */
+    inboxCount() {
+        return this.listJsonFiles(this.inboxDir).length;
+    }
+    /**
+     * Remove a message from inbox (after processing).
+     */
+    removeFromInbox(messageId) {
+        const filename = `${messageId}.json`;
+        const filepath = join(this.inboxDir, filename);
+        if (!existsSync(filepath))
+            return false;
+        try {
+            unlinkSync(filepath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Write a response to outbox.
+     */
+    sendResponse(messageId, chatId, text) {
+        const response = {
+            messageId,
+            chatId,
+            text,
+            timestamp: new Date().toISOString(),
+        };
+        const filename = `${chatId}-${Date.now()}.json`;
+        writeFileSync(join(this.outboxDir, filename), JSON.stringify(response, null, 2), 'utf-8');
+        // Remove from inbox
+        this.removeFromInbox(messageId);
+        return response;
+    }
+    /**
+     * Read and remove all pending outbox responses.
+     */
+    drainOutbox() {
+        const files = this.listJsonFiles(this.outboxDir);
+        const responses = [];
+        for (const file of files) {
+            const filepath = join(this.outboxDir, file);
+            try {
+                const raw = readFileSync(filepath, 'utf-8');
+                responses.push(JSON.parse(raw));
+                unlinkSync(filepath);
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+        return responses.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    }
+    /**
+     * Get outbox count.
+     */
+    outboxCount() {
+        return this.listJsonFiles(this.outboxDir).length;
+    }
+    /**
+     * Format inbox as readable text (for MCP tool output).
+     */
+    formatInbox() {
+        const messages = this.readInbox();
+        if (messages.length === 0)
+            return 'No pending messages.';
+        return messages
+            .map((m) => {
+            const age = Math.round((Date.now() - new Date(m.timestamp).getTime()) / 1000);
+            const content = m.type === 'text'
+                ? m.text
+                : m.type === 'voice'
+                    ? `[Voice: ${m.voice?.duration}s]`
+                    : `[Photo: ${m.photo?.caption ?? 'no caption'}]`;
+            return `[${m.id}] ${m.username ?? m.userId} (${age}s ago): ${content}`;
+        })
+            .join('\n');
+    }
+    listJsonFiles(dir) {
+        try {
+            return readdirSync(dir)
+                .filter((f) => f.endsWith('.json'))
+                .sort();
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/chat/queue.js.map

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

package/dist/chat/response-chunker.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Response Chunker — splits long agent responses for chat platforms.
+ *
+ * Two capabilities:
+ * 1. Markdown → HTML conversion (for Telegram-style HTML parse mode)
+ * 2. Smart chunking at natural boundaries (paragraphs, sentences, words)
+ *
+ * Ported from Salvador's response-chunker.ts with improvements:
+ * - Cleaner code block protection (no sentinel characters)
+ * - Supports multiple output formats (HTML, Markdown passthrough, plain)
+ * - Better heading handling
+ */
+import type { ChunkConfig, MarkupFormat } from './types.js';
+/**
+ * Convert Markdown to the target format and split into chunks.
+ */
+export declare function chunkResponse(text: string, config?: ChunkConfig): string[];
+/**
+ * Convert Markdown to the target markup format.
+ */
+export declare function convertMarkup(text: string, format: MarkupFormat): string;
+/**
+ * Convert Markdown to Telegram-compatible HTML.
+ *
+ * Handles: headings, bold, italic, strikethrough, code, links,
+ * blockquotes, lists, and fenced code blocks.
+ */
+export declare function markdownToHtml(text: string): string;
+//# sourceMappingURL=response-chunker.d.ts.map

package/dist/chat/response-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-chunker.d.ts","sourceRoot":"","sources":["../../src/chat/response-chunker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM5D;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAS1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAUxE;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6CnD"}

package/dist/chat/response-chunker.js

@@ -0,0 +1,163 @@
+/**
+ * Response Chunker — splits long agent responses for chat platforms.
+ *
+ * Two capabilities:
+ * 1. Markdown → HTML conversion (for Telegram-style HTML parse mode)
+ * 2. Smart chunking at natural boundaries (paragraphs, sentences, words)
+ *
+ * Ported from Salvador's response-chunker.ts with improvements:
+ * - Cleaner code block protection (no sentinel characters)
+ * - Supports multiple output formats (HTML, Markdown passthrough, plain)
+ * - Better heading handling
+ */
+const DEFAULT_MAX_CHUNK_SIZE = 4000;
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Convert Markdown to the target format and split into chunks.
+ */
+export function chunkResponse(text, config) {
+    const maxSize = config?.maxChunkSize ?? DEFAULT_MAX_CHUNK_SIZE;
+    const format = config?.format ?? 'html';
+    const converted = convertMarkup(text, format);
+    if (converted.length <= maxSize)
+        return [converted];
+    return splitAtBoundaries(converted, maxSize);
+}
+/**
+ * Convert Markdown to the target markup format.
+ */
+export function convertMarkup(text, format) {
+    switch (format) {
+        case 'html':
+            return markdownToHtml(text);
+        case 'plain':
+            return markdownToPlain(text);
+        case 'markdown':
+        default:
+            return text;
+    }
+}
+// ─── Markdown → HTML ────────────────────────────────────────────────
+/**
+ * Convert Markdown to Telegram-compatible HTML.
+ *
+ * Handles: headings, bold, italic, strikethrough, code, links,
+ * blockquotes, lists, and fenced code blocks.
+ */
+export function markdownToHtml(text) {
+    // Protect fenced code blocks first
+    const codeBlocks = [];
+    let processed = text.replace(/```(\w*)\n([\s\S]*?)```/g, (_match, lang, code) => {
+        const escaped = escapeHtml(code.trimEnd());
+        const langAttr = lang ? ` class="language-${escapeHtml(lang)}"` : '';
+        codeBlocks.push(`<pre><code${langAttr}>${escaped}</code></pre>`);
+        return `<<CODEBLOCK_${codeBlocks.length - 1}>>`;
+    });
+    // Inline code
+    processed = processed.replace(/`([^`]+)`/g, (_m, code) => `<code>${escapeHtml(code)}</code>`);
+    // Headings → bold
+    processed = processed.replace(/^#{1,6}\s+(.+)$/gm, '<b>$1</b>');
+    // Bold + italic
+    processed = processed.replace(/\*\*\*(.+?)\*\*\*/g, '<b><i>$1</i></b>');
+    // Bold
+    processed = processed.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>');
+    // Italic
+    processed = processed.replace(/(?<!\*)\*([^*]+?)\*(?!\*)/g, '<i>$1</i>');
+    // Strikethrough
+    processed = processed.replace(/~~(.+?)~~/g, '<s>$1</s>');
+    // Links
+    processed = processed.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+    // Blockquotes
+    processed = processed.replace(/^>\s?(.*)$/gm, '<blockquote>$1</blockquote>');
+    // Merge consecutive blockquotes
+    processed = processed.replace(/<\/blockquote>\n<blockquote>/g, '\n');
+    // Unordered lists
+    processed = processed.replace(/^[-*]\s+(.+)$/gm, '• $1');
+    // Ordered lists
+    processed = processed.replace(/^\d+\.\s+(.+)$/gm, '• $1');
+    // Horizontal rules
+    processed = processed.replace(/^---+$/gm, '─'.repeat(20));
+    // Restore code blocks
+    processed = processed.replace(/<<CODEBLOCK_(\d+)>>/g, (_m, i) => codeBlocks[Number(i)]);
+    return processed.trim();
+}
+// ─── Markdown → Plain ───────────────────────────────────────────────
+function markdownToPlain(text) {
+    let plain = text;
+    // Remove fenced code block markers (keep content)
+    plain = plain.replace(/```\w*\n?/g, '');
+    // Remove inline formatting
+    plain = plain.replace(/\*\*\*(.+?)\*\*\*/g, '$1');
+    plain = plain.replace(/\*\*(.+?)\*\*/g, '$1');
+    plain = plain.replace(/(?<!\*)\*([^*]+?)\*(?!\*)/g, '$1');
+    plain = plain.replace(/~~(.+?)~~/g, '$1');
+    plain = plain.replace(/`([^`]+)`/g, '$1');
+    // Headings → plain text
+    plain = plain.replace(/^#{1,6}\s+/gm, '');
+    // Links → text (URL)
+    plain = plain.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1 ($2)');
+    // Blockquotes
+    plain = plain.replace(/^>\s?/gm, '');
+    // Lists
+    plain = plain.replace(/^[-*]\s+/gm, '• ');
+    return plain.trim();
+}
+// ─── Chunking ───────────────────────────────────────────────────────
+function splitAtBoundaries(text, maxSize) {
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > maxSize) {
+        const cutPoint = findCutPoint(remaining, maxSize);
+        chunks.push(remaining.slice(0, cutPoint).trimEnd());
+        remaining = remaining.slice(cutPoint).trimStart();
+    }
+    if (remaining.length > 0) {
+        chunks.push(remaining.trimEnd());
+    }
+    return chunks;
+}
+/**
+ * Find the best cut point, prioritizing natural boundaries:
+ * 1. Paragraph break (double newline)
+ * 2. Line break
+ * 3. Sentence boundary (. ! ?)
+ * 4. Word boundary (space)
+ * 5. Hard cut at maxSize
+ */
+function findCutPoint(text, maxSize) {
+    const window = text.slice(0, maxSize);
+    // Try paragraph break (must be at least 30% into the chunk to be useful)
+    const minUseful = Math.floor(maxSize * 0.3);
+    const paragraphBreak = window.lastIndexOf('\n\n');
+    if (paragraphBreak >= minUseful)
+        return paragraphBreak + 2;
+    // Try line break
+    const lineBreak = window.lastIndexOf('\n');
+    if (lineBreak >= minUseful)
+        return lineBreak + 1;
+    // Try sentence boundary
+    const sentenceEnd = findLastSentenceEnd(window, minUseful);
+    if (sentenceEnd > 0)
+        return sentenceEnd;
+    // Try word boundary
+    const spaceBreak = window.lastIndexOf(' ');
+    if (spaceBreak >= minUseful)
+        return spaceBreak + 1;
+    // Hard cut
+    return maxSize;
+}
+function findLastSentenceEnd(text, minPos) {
+    // Look for ". " or "! " or "? " from the end
+    for (let i = text.length - 1; i >= minPos; i--) {
+        const ch = text[i];
+        if ((ch === '.' || ch === '!' || ch === '?') && i + 1 < text.length && text[i + 1] === ' ') {
+            return i + 2;
+        }
+    }
+    return -1;
+}
+// ─── Helpers ────────────────────────────────────────────────────────
+function escapeHtml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=response-chunker.js.map

package/dist/chat/response-chunker.js.map

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

package/dist/chat/self-update.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Self-Update Manager — restart context persistence for chat-driven updates.
+ *
+ * Manages the restart lifecycle: save context before exit, load on startup,
+ * confirm success or trigger rollback. The actual process exit and rebuild
+ * are handled by the supervisor — this module only manages the context.
+ *
+ * Exit code 75 signals the supervisor to rebuild before restarting.
+ */
+/** Exit code that tells the supervisor to rebuild before restart. */
+export declare const RESTART_EXIT_CODE = 75;
+export interface RestartContext {
+    /** Why the restart was requested. */
+    reason: 'self-update' | 'rebuild' | 'manual';
+    /** Chat ID to send confirmation to after restart. */
+    chatId: string;
+    /** Git commit SHA that triggered the update (if applicable). */
+    commitSha?: string;
+    /** Unix timestamp ms when restart was requested. */
+    requestedAt: number;
+}
+export interface RestartResult {
+    /** Whether the restart was initiated. */
+    initiated: boolean;
+    /** The saved context. */
+    context?: RestartContext;
+    /** Error message if failed. */
+    error?: string;
+}
+export declare class SelfUpdateManager {
+    private readonly contextPath;
+    constructor(contextPath: string);
+    /**
+     * Save restart context and exit with code 75.
+     * The supervisor handles rebuild + restart.
+     * Returns the context (useful for testing — in production, process.exit fires).
+     */
+    requestRestart(chatId: string, reason?: RestartContext['reason'], commitSha?: string): RestartResult;
+    /**
+     * Save restart context to disk.
+     */
+    saveContext(context: RestartContext): void;
+    /**
+     * Load restart context from disk (if any).
+     * Returns null if no pending restart context exists.
+     */
+    loadContext(): RestartContext | null;
+    /**
+     * Clear restart context (call after successful startup confirmation).
+     */
+    clearContext(): void;
+    /**
+     * Check if there's a pending restart context.
+     */
+    hasPendingRestart(): boolean;
+    /**
+     * Sanitize a commit message for safe shell usage.
+     * Allows alphanumeric, spaces, basic punctuation. Max 120 chars.
+     */
+    static sanitizeCommitMessage(msg: string): string;
+}
+//# sourceMappingURL=self-update.d.ts.map

package/dist/chat/self-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.d.ts","sourceRoot":"","sources":["../../src/chat/self-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB;IACzB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAEhD;;;;OAIG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,cAAc,CAAC,QAAQ,CAAY,EAC3C,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa;IAmBhB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAK1C;;;OAGG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI;IASpC;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAMlD"}

package/dist/chat/self-update.js

@@ -0,0 +1,90 @@
+/**
+ * Self-Update Manager — restart context persistence for chat-driven updates.
+ *
+ * Manages the restart lifecycle: save context before exit, load on startup,
+ * confirm success or trigger rollback. The actual process exit and rebuild
+ * are handled by the supervisor — this module only manages the context.
+ *
+ * Exit code 75 signals the supervisor to rebuild before restarting.
+ */
+import { readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+/** Exit code that tells the supervisor to rebuild before restart. */
+export const RESTART_EXIT_CODE = 75;
+export class SelfUpdateManager {
+    contextPath;
+    constructor(contextPath) {
+        this.contextPath = contextPath;
+    }
+    /**
+     * Save restart context and exit with code 75.
+     * The supervisor handles rebuild + restart.
+     * Returns the context (useful for testing — in production, process.exit fires).
+     */
+    requestRestart(chatId, reason = 'manual', commitSha) {
+        const context = {
+            reason,
+            chatId,
+            commitSha,
+            requestedAt: Date.now(),
+        };
+        try {
+            this.saveContext(context);
+            return { initiated: true, context };
+        }
+        catch (e) {
+            return {
+                initiated: false,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+    }
+    /**
+     * Save restart context to disk.
+     */
+    saveContext(context) {
+        mkdirSync(dirname(this.contextPath), { recursive: true });
+        writeFileSync(this.contextPath, JSON.stringify(context, null, 2), 'utf-8');
+    }
+    /**
+     * Load restart context from disk (if any).
+     * Returns null if no pending restart context exists.
+     */
+    loadContext() {
+        try {
+            const raw = readFileSync(this.contextPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Clear restart context (call after successful startup confirmation).
+     */
+    clearContext() {
+        try {
+            unlinkSync(this.contextPath);
+        }
+        catch {
+            // File doesn't exist — that's fine
+        }
+    }
+    /**
+     * Check if there's a pending restart context.
+     */
+    hasPendingRestart() {
+        return this.loadContext() !== null;
+    }
+    /**
+     * Sanitize a commit message for safe shell usage.
+     * Allows alphanumeric, spaces, basic punctuation. Max 120 chars.
+     */
+    static sanitizeCommitMessage(msg) {
+        return msg
+            .replace(/[^\w\s.,!?:;()\-/'"#@]/g, '')
+            .trim()
+            .slice(0, 120);
+    }
+}
+//# sourceMappingURL=self-update.js.map

package/dist/chat/self-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../src/chat/self-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAsBpC,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEpD;;;;OAIG;IACH,cAAc,CACZ,MAAc,EACd,SAAmC,QAAQ,EAC3C,SAAkB;QAElB,MAAM,OAAO,GAAmB;YAC9B,MAAM;YACN,MAAM;YACN,SAAS;YACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAuB;QACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAW;QACtC,OAAO,GAAG;aACP,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC;aACtC,IAAI,EAAE;aACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/chat/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Chat transport types — generic primitives for conversational agent transports.
+ *
+ * Works for Telegram, Discord, Slack, or any chat-based interface.
+ * Transport-specific wiring (Grammy, discord.js, etc.) belongs in forge templates.
+ */
+export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+    /** Optional structured content blocks (e.g. tool_use, tool_result, image). */
+    blocks?: unknown[];
+    /** Unix timestamp ms. */
+    timestamp: number;
+    /** Transport-specific metadata (message ID, chat ID, etc.). */
+    meta?: Record<string, unknown>;
+}
+export interface ChatSession {
+    /** Unique session ID (typically the chat/channel ID from the transport). */
+    id: string;
+    /** Conversation messages. */
+    messages: ChatMessage[];
+    /** Unix timestamp ms when the session was created. */
+    createdAt: number;
+    /** Unix timestamp ms of the last activity. */
+    lastActiveAt: number;
+    /** Custom metadata (personality state, counters, etc.). */
+    meta?: Record<string, unknown>;
+}
+export interface ChatSessionConfig {
+    /** Directory for session persistence. */
+    storageDir: string;
+    /** TTL in ms for inactivity expiry. Default: 7_200_000 (2 hours). */
+    ttlMs?: number;
+    /** Max messages before compaction triggers. Default: 100. */
+    compactionThreshold?: number;
+    /** Messages to keep after compaction. Default: 40. */
+    compactionKeep?: number;
+}
+export interface Fragment {
+    /** The message text. */
+    text: string;
+    /** Transport message ID (for ordering). */
+    messageId: number | string;
+    /** Unix timestamp ms when received. */
+    receivedAt: number;
+}
+export interface FragmentBufferConfig {
+    /** Character threshold to start buffering. Default: 4000. */
+    startThreshold?: number;
+    /** Max gap in ms between fragments before auto-flush. Default: 1500. */
+    maxGapMs?: number;
+    /** Maximum number of fragments to merge. Default: 12. */
+    maxParts?: number;
+    /** Maximum total bytes before force-flush. Default: 50_000. */
+    maxTotalBytes?: number;
+}
+export type MarkupFormat = 'html' | 'markdown' | 'plain';
+export interface ChunkConfig {
+    /** Max characters per chunk. Default: 4000. */
+    maxChunkSize?: number;
+    /** Output markup format. Default: 'html'. */
+    format?: MarkupFormat;
+}
+export interface ChatAuthConfig {
+    /** Path to auth persistence file. */
+    storagePath: string;
+    /** Passphrase required for authentication. If unset, auth is disabled. */
+    passphrase?: string;
+    /** Allowed user IDs. If empty or unset, any authenticated user is allowed. */
+    allowedUsers?: (string | number)[];
+    /** Rate limit: max failed attempts before temporary lockout. Default: 5. */
+    maxFailedAttempts?: number;
+    /** Lockout duration in ms. Default: 300_000 (5 minutes). */
+    lockoutMs?: number;
+}
+export interface AuthRecord {
+    userId: string | number;
+    authenticatedAt: number;
+}
+export interface AuthState {
+    authenticated: AuthRecord[];
+    failedAttempts: Map<string, {
+        count: number;
+        lastAttempt: number;
+    }>;
+}
+export interface ChatManagerConfig {
+    session: ChatSessionConfig;
+    fragment?: FragmentBufferConfig;
+    chunk?: ChunkConfig;
+    auth?: ChatAuthConfig;
+}
+export interface ChatManagerStatus {
+    activeSessions: number;
+    authenticatedUsers: number;
+    pendingFragments: number;
+    config: {
+        ttlMs: number;
+        compactionThreshold: number;
+        maxChunkSize: number;
+        authEnabled: boolean;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/chat/types.d.ts.map

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

package/dist/chat/types.js

@@ -0,0 +1,8 @@
+/**
+ * Chat transport types — generic primitives for conversational agent transports.
+ *
+ * Works for Telegram, Discord, Slack, or any chat-based interface.
+ * Transport-specific wiring (Grammy, discord.js, etc.) belongs in forge templates.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/chat/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/chat/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}