@soleri/core 2.10.0 → 2.11.0

package/dist/chat/output-compressor.js

@@ -0,0 +1,95 @@
+/**
+ * Output Compressor — compress verbose tool outputs for chat contexts.
+ *
+ * Unlike Salvador's 30+ domain-specific compressors, this provides:
+ * 1. A generic JSON compressor (extracts key fields, truncates arrays)
+ * 2. A registry for domain-specific compressors (pluggable)
+ *
+ * Domain packs can register their own compressors for their tools.
+ */
+const DEFAULT_MAX_LENGTH = 4000;
+const DEFAULT_MAX_ARRAY_ITEMS = 5;
+const DEFAULT_MAX_STRING_LENGTH = 500;
+const compressorRegistry = new Map();
+/**
+ * Register a compressor for a specific tool name (or prefix).
+ */
+export function registerCompressor(toolNameOrPrefix, compressor) {
+    compressorRegistry.set(toolNameOrPrefix, compressor);
+}
+/**
+ * Clear all registered compressors.
+ */
+export function clearCompressors() {
+    compressorRegistry.clear();
+}
+// ─── Generic Compressor ─────────────────────────────────────────────
+/**
+ * Create a generic output compressor. Uses registered compressors for known tools,
+ * falls back to JSON-aware truncation.
+ */
+export function createOutputCompressor(options) {
+    const maxLength = options?.maxLength ?? DEFAULT_MAX_LENGTH;
+    const maxArrayItems = options?.maxArrayItems ?? DEFAULT_MAX_ARRAY_ITEMS;
+    const maxStringLength = options?.maxStringLength ?? DEFAULT_MAX_STRING_LENGTH;
+    return (toolName, output, overrideMax) => {
+        const limit = overrideMax ?? maxLength;
+        // Check registered compressors (exact match, then prefix match)
+        const exact = compressorRegistry.get(toolName);
+        if (exact)
+            return exact(output, limit);
+        for (const [prefix, compressor] of compressorRegistry) {
+            if (toolName.startsWith(prefix)) {
+                return compressor(output, limit);
+            }
+        }
+        // Already short enough
+        if (output.length <= limit)
+            return output;
+        // Try JSON-aware compression
+        try {
+            const parsed = JSON.parse(output);
+            const compressed = compressValue(parsed, maxArrayItems, maxStringLength);
+            const result = JSON.stringify(compressed, null, 2);
+            if (result.length <= limit)
+                return result;
+            return result.slice(0, limit) + '\n... (compressed, truncated)';
+        }
+        catch {
+            // Not JSON — plain text truncation
+            return output.slice(0, limit) + '\n... (truncated)';
+        }
+    };
+}
+// ─── JSON Compression ───────────────────────────────────────────────
+function compressValue(value, maxArrayItems, maxStringLength) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'string') {
+        if (value.length > maxStringLength) {
+            return value.slice(0, maxStringLength) + `... (+${value.length - maxStringLength} chars)`;
+        }
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (Array.isArray(value)) {
+        const truncated = value
+            .slice(0, maxArrayItems)
+            .map((item) => compressValue(item, maxArrayItems, maxStringLength));
+        if (value.length > maxArrayItems) {
+            truncated.push(`... +${value.length - maxArrayItems} more`);
+        }
+        return truncated;
+    }
+    if (typeof value === 'object') {
+        const obj = value;
+        const result = {};
+        for (const [key, val] of Object.entries(obj)) {
+            result[key] = compressValue(val, maxArrayItems, maxStringLength);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=output-compressor.js.map

package/dist/chat/output-compressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-compressor.js","sourceRoot":"","sources":["../../src/chat/output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAMtC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA0B,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,gBAAwB,EAAE,UAA0B;IACrF,kBAAkB,CAAC,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAItC;IACC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,kBAAkB,CAAC;IAC3D,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,uBAAuB,CAAC;IACxE,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,yBAAyB,CAAC;IAE9E,OAAO,CAAC,QAAgB,EAAE,MAAc,EAAE,WAAoB,EAAE,EAAE;QAChE,MAAM,KAAK,GAAG,WAAW,IAAI,SAAS,CAAC;QAEvC,gEAAgE;QAChE,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEvC,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,kBAAkB,EAAE,CAAC;YACtD,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC;QAE1C,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;gBAAE,OAAO,MAAM,CAAC;YAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,+BAA+B,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,mBAAmB,CAAC;QACtD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,uEAAuE;AAEvE,SAAS,aAAa,CAAC,KAAc,EAAE,aAAqB,EAAE,eAAuB;IACnF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAExD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,SAAS,KAAK,CAAC,MAAM,GAAG,eAAe,SAAS,CAAC;QAC5F,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAE1E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK;aACpB,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;aACvB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,MAAM,GAAG,aAAa,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/chat/queue.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 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
+ */
+export interface QueuedMessage {
+    /** Unique message ID: `{chatId}-{timestamp}`. */
+    id: string;
+    /** Chat/channel ID. */
+    chatId: string;
+    /** Sender user ID. */
+    userId: string;
+    /** Sender username (if available). */
+    username?: string;
+    /** Message type. */
+    type: 'text' | 'voice' | 'photo';
+    /** Text content (for text messages or transcribed voice). */
+    text?: string;
+    /** Voice metadata. */
+    voice?: {
+        fileId: string;
+        duration: number;
+    };
+    /** Photo metadata. */
+    photo?: {
+        fileId: string;
+        caption?: string;
+    };
+    /** ISO timestamp. */
+    timestamp: string;
+}
+export interface QueuedResponse {
+    /** Original message ID this responds to. */
+    messageId: string;
+    /** Target chat ID. */
+    chatId: string;
+    /** Response text. */
+    text: string;
+    /** ISO timestamp. */
+    timestamp: string;
+}
+export interface QueueConfig {
+    /** Base directory for queue (e.g., ~/.{agentId}/queue). */
+    queueDir: string;
+}
+export declare class MessageQueue {
+    private readonly inboxDir;
+    private readonly outboxDir;
+    constructor(config: QueueConfig);
+    /**
+     * Enqueue an incoming message to inbox.
+     */
+    enqueue(msg: Omit<QueuedMessage, 'id' | 'timestamp'>): QueuedMessage;
+    /**
+     * Read all pending inbox messages, sorted by timestamp.
+     */
+    readInbox(): QueuedMessage[];
+    /**
+     * Get the number of pending inbox messages.
+     */
+    inboxCount(): number;
+    /**
+     * Remove a message from inbox (after processing).
+     */
+    removeFromInbox(messageId: string): boolean;
+    /**
+     * Write a response to outbox.
+     */
+    sendResponse(messageId: string, chatId: string, text: string): QueuedResponse;
+    /**
+     * Read and remove all pending outbox responses.
+     */
+    drainOutbox(): QueuedResponse[];
+    /**
+     * Get outbox count.
+     */
+    outboxCount(): number;
+    /**
+     * Format inbox as readable text (for MCP tool output).
+     */
+    formatInbox(): string;
+    private listJsonFiles;
+}
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/chat/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,sBAAsB;IACtB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,WAAW;IAO/B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,aAAa;IASpE;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;IAkB5B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAY3C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;IAc7E;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAoB/B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAkBrB,OAAO,CAAC,aAAa;CAStB"}

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"}