@0xmaxma/claude-gateway 1.8.13 → 2.0.0

package/dist/orchestration/delivery.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryOutbox = void 0;
+exports.channelSender = channelSender;
+exports.speechFailureNotice = speechFailureNotice;
+const line_pure_1 = require("../agent/line-pure");
+const errors_1 = require("../voice/errors");
+const markdown_1 = require("../telegram/markdown");
+const chunks_1 = require("../telegram/chunks");
+const line_request_order_1 = require("../shared/line-request-order");
+const channel_speech_1 = require("./channel-speech");
+const crypto_1 = require("crypto");
+const file_delivery_1 = require("./file-delivery");
+/** A transport receipt means provider acceptance, never that a human read it.
+ * Ambiguous network failures are retained for reconciliation, not blind retry. */
+function channelSender(config, request = fetch, speechEnabled = () => true, linkedSender) {
+    return async (binding, text, id, file, speech, textFormat) => {
+        const agent = typeof config === 'function' ? config() : config;
+        if (speech)
+            return (0, channel_speech_1.sendChannelSpeech)(agent, binding, speech, id, request, undefined, () => speechEnabled(binding, speech));
+        if (['whatsapp', 'wechat'].includes(String(binding.channel))) {
+            if (!linkedSender)
+                return { state: 'failed', code: 'DELIVERY_NOT_CONFIGURED' };
+            return linkedSender(binding, text, id, file, speech, textFormat);
+        }
+        if (file)
+            return (0, file_delivery_1.sendChannelFile)(agent, binding, file, id, request);
+        const source = String(binding.channel), chat = String(binding.chat_id), thread = String(binding.thread_key);
+        let url, body;
+        const headers = { 'Content-Type': 'application/json' };
+        if (source === 'telegram' && agent.telegram?.botToken) {
+            url = `https://api.telegram.org/bot${agent.telegram.botToken}/sendMessage`;
+            const formatted = textFormat ? { sendText: text, parseMode: textFormat === 'HTML' ? 'HTML' : undefined } : (0, markdown_1.resolveTelegramReplyFormat)(text);
+            body = { chat_id: chat, text: formatted.sendText, ...(formatted.parseMode ? { parse_mode: formatted.parseMode } : {}), ...(thread ? { message_thread_id: Number(thread) } : {}) };
+        }
+        else if (source === 'discord' && agent.discord?.botToken) {
+            url = `https://discord.com/api/v10/channels/${encodeURIComponent(chat)}/messages`;
+            headers.Authorization = `Bot ${agent.discord.botToken}`;
+            body = { content: text, nonce: id.replace(/-/g, '').slice(0, 25), enforce_nonce: true, allowed_mentions: { parse: [] } };
+        }
+        else if (source === 'line' && agent.line?.channelAccessToken) {
+            url = 'https://api.line.me/v2/bot/message/push';
+            headers.Authorization = `Bearer ${agent.line.channelAccessToken}`;
+            headers['X-Line-Retry-Key'] = id;
+            body = { to: chat, messages: [{ type: 'text', text: textFormat === 'text' ? text : (0, line_pure_1.stripMarkdownPreservingUrls)(text) }] };
+        }
+        else if (source === 'slack' && agent.slack?.botToken) {
+            url = 'https://slack.com/api/chat.postMessage';
+            headers.Authorization = `Bearer ${agent.slack.botToken}`;
+            body = { channel: chat, text, ...(thread ? { thread_ts: thread } : {}), unfurl_links: false, unfurl_media: false };
+        }
+        else if (source === 'whatsapp_cloud' && agent.whatsapp_cloud?.accessToken && agent.whatsapp_cloud.phoneNumberId) {
+            url = `https://graph.facebook.com/v20.0/${encodeURIComponent(agent.whatsapp_cloud.phoneNumberId)}/messages`;
+            headers.Authorization = `Bearer ${agent.whatsapp_cloud.accessToken}`;
+            body = { messaging_product: 'whatsapp', to: chat, type: 'text', text: { body: text } };
+        }
+        else
+            return { state: 'failed', code: 'DELIVERY_NOT_CONFIGURED' };
+        try {
+            const send = () => request(url, { method: 'POST', headers, body: JSON.stringify(body), signal: AbortSignal.timeout(10000) });
+            let response = await (source === 'line' ? (0, line_request_order_1.orderLineRequest)(agent.id, chat, send) : send());
+            if (source === 'telegram' && response.status === 400 && 'parse_mode' in body) {
+                const rejection = await response.clone().json().catch(() => ({}));
+                if (/can't parse entities/i.test(rejection.description ?? '')) {
+                    // A definite parse rejection was not delivered; only this case permits a plain retry.
+                    const { parse_mode: _format, ...plain } = body;
+                    body = { ...plain, text: (0, chunks_1.htmlToPlain)(plain.text) };
+                    response = await send();
+                }
+            }
+            if (source === 'line' && response.status === 409 && response.headers.get('x-line-accepted-request-id'))
+                return { state: 'delivered', providerId: response.headers.get('x-line-accepted-request-id') };
+            if (!response.ok)
+                return { state: response.status >= 500 ? 'unknown' : 'failed', code: `PROVIDER_HTTP_${response.status}` };
+            const result = await response.json();
+            if (result.ok === false || result.error)
+                return { state: 'failed', code: 'PROVIDER_REJECTED' };
+            if (source === 'whatsapp_cloud' && !result.messages?.[0]?.id)
+                return { state: 'unknown', code: 'PROVIDER_RECEIPT_UNKNOWN' };
+            return { state: 'delivered', providerId: result.messages?.[0]?.id ?? result.id ?? result.ts ?? (result.result?.message_id === undefined ? undefined : String(result.result.message_id)) ?? result.sentMessages?.[0]?.id };
+        }
+        catch {
+            return { state: 'unknown', code: 'PROVIDER_RECEIPT_UNKNOWN' };
+        }
+    };
+}
+/** Channel notices share one provider-independent vocabulary; details stay in logs. */
+function speechFailureNotice(code) {
+    const diagnostic = (0, errors_1.describeVoiceError)(code);
+    const messages = {
+        quota: ['Voice quota exhausted', 'Try again after the quota resets'],
+        daily_quota: ['Voice quota exhausted', 'Try again after the quota resets'],
+        quota_or_rate_limit: ['Voice rate limit or quota reached', 'Check provider usage'],
+        rate_limit: ['Voice rate limit reached', 'Try again later'],
+        payment: ['Voice credits or billing required', 'Check provider billing'],
+        authentication: ['Voice authentication failed', 'Check your API key'],
+        permission: ['Voice access denied', 'Check provider permissions'],
+        unavailable: ['Voice provider unavailable', 'Try again later'],
+        timeout: ['Voice request timed out', 'Try again later'],
+        network: ['Voice connection failed', 'Try again later'],
+        language: ['Voice language not supported', 'Check voice settings'],
+        model: ['Voice model or voice unavailable', 'Check voice settings'],
+        invalid_request: ['Voice request rejected', 'Check voice settings'],
+        invalid_response: ['Voice audio could not be created', 'Try again later'],
+        cancelled: ['Voice request cancelled', 'Try again'],
+        unknown: ['Voice audio unavailable', 'Try again later'],
+    };
+    const [reason, action] = messages[diagnostic.category] ?? messages.unknown;
+    return `${reason}${diagnostic.httpStatus ? ` (HTTP ${diagnostic.httpStatus})` : ''}. ${action}, or use /voice off.`;
+}
+class DeliveryOutbox {
+    constructor(store, send) {
+        this.store = store;
+        this.send = send;
+    }
+    /** Called inside the decision commit transaction. Each chunk has its own receipt. */
+    enqueue(responseId, bindingId, text) {
+        const binding = this.store.get('SELECT channel FROM conversation_bindings WHERE id=?', bindingId);
+        // Normalize the complete reply so Markdown delimiters never straddle chunks.
+        if (binding?.channel === 'line')
+            text = (0, line_pure_1.stripMarkdownPreservingUrls)(text);
+        let formatted = binding?.channel === 'telegram' ? (0, markdown_1.resolveTelegramReplyFormat)(text) : { sendText: text, parseMode: undefined };
+        // Format before splitting so code fences and emphasis can span receipts.
+        let chunks = binding?.channel === 'telegram'
+            ? (0, chunks_1.chunkText)(formatted.sendText, 1900, formatted.parseMode === 'HTML')
+            : Array.from(text).reduce((parts, character) => {
+                if (!parts.length || parts[parts.length - 1].length + character.length > 1900)
+                    parts.push('');
+                parts[parts.length - 1] += character;
+                return parts;
+            }, []);
+        if (formatted.parseMode && chunks.some(part => part.length > 1900)) {
+            formatted = { sendText: (0, chunks_1.htmlToPlain)(formatted.sendText), parseMode: undefined };
+            chunks = (0, chunks_1.chunkText)(formatted.sendText, 1900);
+        }
+        for (const [index, content] of chunks.filter(part => part.length > 0).entries()) {
+            const id = (0, crypto_1.randomUUID)();
+            this.store.run('INSERT INTO deliveries VALUES(?,?,?,?,?,?,?,?,?,?)', id, responseId, null, bindingId, 'text', 'pending', null, content, null, Date.now());
+            this.store.enqueue('delivery', `delivery:${responseId}:${index}`, { deliveryId: id, textFormat: binding?.channel === 'telegram' ? formatted.parseMode ?? 'text' : binding?.channel === 'line' ? 'text' : undefined });
+        }
+        for (const file of this.store.all('SELECT * FROM task_files WHERE response_id=? ORDER BY created_at,id', responseId)) {
+            const id = (0, crypto_1.randomUUID)();
+            this.store.run('INSERT INTO deliveries VALUES(?,?,?,?,?,?,?,?,?,?)', id, responseId, null, bindingId, String(file.kind), 'pending', null, JSON.stringify({ path: file.path, name: file.name, kind: file.kind, caption: file.caption }), null, Date.now());
+            this.store.enqueue('delivery', `file:${responseId}:${file.id}`, { deliveryId: id });
+        }
+    }
+    enqueueSpeech(responseId, bindingId, speech) {
+        if (!speech.text.trim() || speech.text.length > 600 || speech.text.includes('```'))
+            return;
+        const key = `speech:${responseId}`;
+        if (this.store.get('SELECT id FROM outbox WHERE dedup_key=?', key))
+            return;
+        const id = (0, crypto_1.randomUUID)();
+        this.store.run('INSERT INTO deliveries VALUES(?,?,?,?,?,?,?,?,?,?)', id, responseId, null, bindingId, 'speech', 'pending', null, JSON.stringify(speech), null, Date.now());
+        this.store.enqueue('delivery', key, { deliveryId: id });
+    }
+    tick() {
+        if (this.active)
+            return this.active;
+        this.active = this.run().finally(() => { this.active = undefined; });
+        return this.active;
+    }
+    async run() {
+        // Page past blocked responses without retrying ambiguous provider receipts.
+        // A fixed high-water mark also bounds this tick when new work arrives mid-send.
+        const ceiling = Number(this.store.get('SELECT COALESCE(MAX(rowid),0) n FROM outbox').n);
+        let cursor = 0, sent = 0;
+        while (sent < 20) {
+            const rows = this.store.all("SELECT rowid AS sequence,* FROM outbox WHERE kind='delivery' AND state='pending' AND rowid>? AND rowid<=? ORDER BY rowid LIMIT 20", cursor, ceiling);
+            if (!rows.length)
+                break;
+            for (const row of rows) {
+                cursor = Number(row.sequence);
+                const payload = JSON.parse(String(row.payload_json));
+                const id = payload.deliveryId;
+                const delivery = this.store.get('SELECT * FROM deliveries WHERE id=?', id);
+                const binding = this.store.get('SELECT * FROM conversation_bindings WHERE id=?', delivery.binding_id);
+                if (delivery.modality === 'speech') {
+                    const textRows = this.store.all("SELECT state FROM deliveries WHERE response_id=? AND modality='text'", delivery.response_id);
+                    if (!textRows.length || textRows.some(text => text.state !== 'delivered'))
+                        continue;
+                }
+                // Text must never wait behind an early speech row (including rows from older runtimes).
+                const earlier = payload.speechFailureFor ? undefined : this.store.get(`SELECT id FROM deliveries WHERE response_id=? AND rowid < (SELECT rowid FROM deliveries WHERE id=?)
+          AND state!='delivered' AND NOT (modality='speech' AND (state IN ('failed','unknown') OR ?!='speech')) LIMIT 1`, delivery.response_id, id, delivery.modality);
+                if (earlier)
+                    continue;
+                sent++;
+                this.store.transaction(() => {
+                    this.store.run("UPDATE outbox SET state='processing',attempt_count=attempt_count+1 WHERE id=?", row.id);
+                    this.store.run("UPDATE deliveries SET state='sending' WHERE id=?", id);
+                });
+                const result = await (delivery.modality === 'speech'
+                    ? this.send(binding, '', id, undefined, JSON.parse(String(delivery.delivered_text)))
+                    : this.send(binding, delivery.modality === 'text' ? String(delivery.delivered_text) : '', id, delivery.modality === 'text' ? undefined : JSON.parse(String(delivery.delivered_text)), undefined, payload.textFormat)).catch(() => ({ state: 'unknown', code: 'PROVIDER_RECEIPT_UNKNOWN' }));
+                this.store.transaction(() => {
+                    this.store.run('UPDATE deliveries SET state=?,provider_message_id=?,updated_at=? WHERE id=?', result.state, result.state === 'delivered' ? result.providerId ?? null : null, Date.now(), id);
+                    this.store.run('UPDATE outbox SET state=?,last_error=? WHERE id=?', result.state === 'delivered' ? 'completed' : result.state, result.state === 'delivered' ? null : result.code, row.id);
+                    if (delivery.modality === 'speech' && result.state === 'failed' && result.speechSynthesisFailed) {
+                        const key = `speech-failure:${id}`;
+                        if (!this.store.get('SELECT id FROM outbox WHERE dedup_key=?', key)) {
+                            const noticeId = (0, crypto_1.randomUUID)();
+                            const diagnostic = (0, errors_1.describeVoiceError)(result.code);
+                            const text = speechFailureNotice(result.code);
+                            this.store.run('INSERT INTO deliveries VALUES(?,?,?,?,?,?,?,?,?,?)', noticeId, delivery.response_id, null, delivery.binding_id, 'text', 'pending', null, text, null, Date.now());
+                            this.store.enqueue('delivery', key, { deliveryId: noticeId, textFormat: 'text', speechFailureFor: id });
+                            const speech = JSON.parse(String(delivery.delivered_text));
+                            console.warn(JSON.stringify({ ts: new Date().toISOString(), level: 'warn', event: 'Speech synthesis failed', agentId: this.store.agentId, channel: binding.channel, referenceId: id, provider: speech.provider, model: speech.model, code: result.code, ...diagnostic }));
+                        }
+                    }
+                });
+                if (sent >= 20)
+                    break;
+            }
+        }
+    }
+}
+exports.DeliveryOutbox = DeliveryOutbox;
+//# sourceMappingURL=delivery.js.map

package/dist/orchestration/delivery.js.map

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

package/dist/orchestration/display-stream.d.ts

@@ -0,0 +1,4 @@
+/** Extract only the display string from an incomplete flat speech JSON object.
+ * Incomplete escapes/surrogate pairs are held until the next provider chunk. */
+export declare function partialDisplay(raw: string): string;
+//# sourceMappingURL=display-stream.d.ts.map

package/dist/orchestration/display-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-stream.d.ts","sourceRoot":"","sources":["../../src/orchestration/display-stream.ts"],"names":[],"mappings":"AAAA;gFACgF;AAChF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuClD"}

package/dist/orchestration/display-stream.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.partialDisplay = partialDisplay;
+/** Extract only the display string from an incomplete flat speech JSON object.
+ * Incomplete escapes/surrogate pairs are held until the next provider chunk. */
+function partialDisplay(raw) {
+    let i = 0;
+    const space = () => { while (/\s/.test(raw[i] ?? '') && i < raw.length)
+        i++; };
+    const string = () => {
+        if (raw[i++] !== '"')
+            return;
+        let text = '';
+        let encoded = '';
+        while (i < raw.length) {
+            encoded = '';
+            const ch = raw[i++];
+            if (ch === '"')
+                return { text, complete: true };
+            if (ch === '\\') {
+                const escape = raw[i++];
+                if (!escape)
+                    break;
+                if (escape === 'u') {
+                    const hex = raw.slice(i, i + 4);
+                    if (!/^[0-9a-f]{4}$/i.test(hex))
+                        break;
+                    encoded += '\\u' + hex;
+                    i += 4;
+                }
+                else if ('"\\/bfnrt'.includes(escape))
+                    encoded += '\\' + escape;
+                else
+                    return;
+            }
+            else {
+                if (ch.charCodeAt(0) < 32)
+                    return;
+                encoded += ch;
+            }
+            try {
+                text += JSON.parse('"' + encoded + '"');
+            }
+            catch {
+                return;
+            }
+        }
+        if (/[\uD800-\uDBFF]$/.test(text))
+            text = text.slice(0, -1);
+        return { text, complete: false };
+    };
+    space();
+    if (raw[i++] !== '{')
+        return '';
+    for (let fields = 0; fields < 2; fields++) {
+        space();
+        const key = string();
+        if (!key?.complete)
+            return '';
+        space();
+        if (raw[i++] !== ':')
+            return '';
+        space();
+        const value = string();
+        if (!value)
+            return '';
+        if (key.text === 'display_text')
+            return value.text;
+        if (!value.complete)
+            return '';
+        space();
+        if (raw[i++] !== ',')
+            return '';
+    }
+    return '';
+}
+//# sourceMappingURL=display-stream.js.map

package/dist/orchestration/display-stream.js.map

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

package/dist/orchestration/events.d.ts

@@ -0,0 +1,30 @@
+import { OrchestrationStore } from './store';
+import { OrchestrationEvent } from './types';
+export interface EventCursor {
+    streamId: string;
+    seq: number;
+}
+export type EventPage = {
+    snapshotRequired: false;
+    cursor: EventCursor;
+    events: OrchestrationEvent[];
+} | {
+    snapshotRequired: true;
+    cursor: EventCursor;
+    tasks: unknown[];
+};
+/** Internal subscribers only. This is not a new public task-management API. */
+export declare class ConversationEvents {
+    private readonly store;
+    private readonly maxBufferBytes;
+    private readonly stops;
+    constructor(store: OrchestrationStore, maxBufferBytes?: number);
+    read(conversationId: string, principalId: string, cursor?: EventCursor, limit?: number): EventPage;
+    subscribe(conversationId: string, principalId: string, cursor?: EventCursor): {
+        pages: AsyncIterable<EventPage>;
+        close(): void;
+    };
+    prune(retentionDays: number): void;
+    close(): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/orchestration/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/orchestration/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAsB,MAAM,SAAS,CAAC;AAGjE,MAAM,WAAW,WAAW;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;CAAE;AAC/D,MAAM,MAAM,SAAS,GAAG;IAAE,gBAAgB,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,GACpG;IAAE,gBAAgB,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAEpE,+EAA+E;AAC/E,qBAAa,kBAAkB;IAEjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAsB,OAAO,CAAC,QAAQ,CAAC,cAAc;IADvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;gBAClB,KAAK,EAAE,kBAAkB,EAAmB,cAAc,SAAU;IACjG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,SAAM,GAAG,SAAS;IAY/F,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAAC,KAAK,IAAI,IAAI,CAAA;KAAE;IAgBhI,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAQlC,KAAK,IAAI,IAAI;CACd"}

package/dist/orchestration/events.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationEvents = void 0;
+const types_1 = require("./types");
+const bounded_queue_1 = require("./bounded-queue");
+/** Internal subscribers only. This is not a new public task-management API. */
+class ConversationEvents {
+    constructor(store, maxBufferBytes = 1048576) {
+        this.store = store;
+        this.maxBufferBytes = maxBufferBytes;
+        this.stops = new Set();
+    }
+    read(conversationId, principalId, cursor, limit = 100) {
+        const conversation = this.store.assertMember(conversationId, principalId);
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1000)
+            throw new types_1.OrchestrationError('INVALID_CURSOR');
+        const latest = { streamId: String(conversation.stream_id), seq: Number(conversation.last_event_seq) };
+        const earliest = Number(this.store.get('SELECT MIN(seq) seq FROM conversation_events WHERE conversation_id=?', conversationId)?.seq ?? latest.seq + 1);
+        if (!cursor || cursor.streamId !== latest.streamId || cursor.seq < earliest - 1 || cursor.seq > latest.seq) {
+            return { snapshotRequired: true, cursor: latest, tasks: this.store.all('SELECT snapshot_json FROM tasks WHERE conversation_id=? ORDER BY created_at DESC LIMIT 100', conversationId).map(row => JSON.parse(String(row.snapshot_json))) };
+        }
+        if (!Number.isSafeInteger(cursor.seq) || cursor.seq < 0)
+            throw new types_1.OrchestrationError('INVALID_CURSOR');
+        const events = this.store.all('SELECT payload_json FROM conversation_events WHERE conversation_id=? AND seq>? ORDER BY seq LIMIT ?', conversationId, cursor.seq, limit).map(row => JSON.parse(String(row.payload_json)));
+        return { snapshotRequired: false, cursor: { streamId: latest.streamId, seq: events.at(-1)?.seq ?? cursor.seq }, events };
+    }
+    subscribe(conversationId, principalId, cursor) {
+        if (this.stops.size >= 100)
+            throw new types_1.OrchestrationError('SUBSCRIBER_CAPACITY_EXCEEDED');
+        this.store.assertMember(conversationId, principalId);
+        const queue = new bounded_queue_1.BoundedQueue(this.maxBufferBytes, page => Buffer.byteLength(JSON.stringify(page)));
+        let current = cursor;
+        const close = () => { clearInterval(timer); queue.close(); this.stops.delete(close); };
+        const poll = () => {
+            try {
+                const page = this.read(conversationId, principalId, current);
+                if (page.snapshotRequired || page.events.length)
+                    queue.push(page);
+                current = page.cursor;
+            }
+            catch (error) {
+                queue.close(error instanceof Error ? error : new types_1.OrchestrationError('SUBSCRIBER_FAILED'));
+                close();
+            }
+        };
+        const timer = setInterval(poll, 100);
+        timer.unref();
+        this.stops.add(close);
+        poll();
+        return { pages: queue, close };
+    }
+    prune(retentionDays) {
+        if (!Number.isSafeInteger(retentionDays) || retentionDays < 1)
+            throw new types_1.OrchestrationError('INVALID_CONFIG');
+        const cutoff = Date.now() - retentionDays * 86400000;
+        this.store.transaction(() => {
+            this.store.run('DELETE FROM conversation_events WHERE occurred_at<?', cutoff);
+            this.store.run("DELETE FROM outbox WHERE state='completed' AND created_at<?", cutoff);
+        });
+    }
+    close() { for (const stop of this.stops)
+        stop(); }
+}
+exports.ConversationEvents = ConversationEvents;
+//# sourceMappingURL=events.js.map

package/dist/orchestration/events.js.map

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

package/dist/orchestration/execution-observation.d.ts

@@ -0,0 +1,38 @@
+import type { ProcessSample } from './process-activity';
+export interface ToolOutcome {
+    name: string;
+    status: 'returned' | 'error';
+    observedAt: number;
+    exitCode?: number;
+}
+/** Protocol metadata only: never infer outcomes from arbitrary tool output. */
+export declare function toolOutcome(name: string, result: {
+    is_error?: unknown;
+    exit_code?: unknown;
+}, observedAt: number): ToolOutcome;
+export interface TurnObservation {
+    observedAt: number;
+    lastProgressAt: number;
+    phase: string;
+    activeTools: string[];
+    quiet: boolean;
+    lastTool?: ToolOutcome;
+}
+export interface ExecutionObservation extends TurnObservation {
+    attemptId: string;
+    process: ProcessSample;
+    lastActivityAt: number;
+    status: 'observing' | 'process_activity' | 'waiting_for_tool' | 'waiting_for_model' | 'telemetry_unavailable';
+}
+export declare function executionDetails(e: ExecutionObservation): {
+    observationStatus: string;
+    process: ProcessSample;
+    lastTool: ToolOutcome | undefined;
+    quiet: boolean;
+    status: string;
+    counters: string;
+    age: number;
+    activeTools: string[];
+};
+export declare function executionDescription(e: ExecutionObservation): string;
+//# sourceMappingURL=execution-observation.d.ts.map

package/dist/orchestration/execution-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-observation.d.ts","sourceRoot":"","sources":["../../src/orchestration/execution-observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAAE;AACnH,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAG9H;AACD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AACD,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;CAC/G;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB;;;;;;;;;EASvD;AACD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAGpE"}

package/dist/orchestration/execution-observation.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolOutcome = toolOutcome;
+exports.executionDetails = executionDetails;
+exports.executionDescription = executionDescription;
+/** Protocol metadata only: never infer outcomes from arbitrary tool output. */
+function toolOutcome(name, result, observedAt) {
+    return { name: name.slice(0, 128), status: result.is_error === true ? 'error' : 'returned', observedAt,
+        ...(typeof result.exit_code === 'number' && Number.isSafeInteger(result.exit_code) ? { exitCode: result.exit_code } : {}) };
+}
+function executionDetails(e) {
+    const status = e.status === 'observing' ? 'Collecting process baseline; no movement comparison yet.' : e.status === 'process_activity' ? 'Process activity detected (not proof of task progress).'
+        : e.status === 'telemetry_unavailable' ? 'Process telemetry unavailable; silence does not prove a stall.'
+            : e.activeTools.length ? 'Waiting for tool; no process activity observed in the last sample.'
+                : 'Waiting for model output; no process activity observed in the last sample.';
+    const age = Math.max(0, Math.floor((Date.now() - e.lastActivityAt) / 1000));
+    const counters = e.process.available && e.process.cpuTicksDelta !== undefined
+        ? ` Processes: ${e.process.processCount}; CPU +${e.process.cpuTicksDelta} ticks (children +${e.process.childCpuTicksDelta ?? 0}); logical I/O ${e.process.ioAvailable ? `read +${e.process.readBytesDelta ?? 0}, write +${e.process.writeBytesDelta ?? 0} bytes` : 'partially unavailable'}.` : '';
+    return { observationStatus: status, process: e.process, lastTool: e.lastTool, quiet: e.quiet, status: `${status}${e.quiet ? ' No recent tool/model progress; task retained for inspection or cancellation.' : ''}`, counters: counters.trim(), age, activeTools: e.activeTools };
+}
+function executionDescription(e) {
+    const details = executionDetails(e);
+    return `${details.status}${details.counters ? ` ${details.counters}` : ''}\nLast activity: ${details.age}s ago.${details.activeTools.length ? `\nActive tools: ${details.activeTools.join(', ')}.` : ''}`;
+}
+//# sourceMappingURL=execution-observation.js.map

package/dist/orchestration/execution-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-observation.js","sourceRoot":"","sources":["../../src/orchestration/execution-observation.ts"],"names":[],"mappings":";;AAGA,kCAGC;AAeD,4CASC;AACD,oDAGC;AAhCD,+EAA+E;AAC/E,SAAgB,WAAW,CAAC,IAAY,EAAE,MAAmD,EAAE,UAAkB;IAC/G,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU;QACnG,GAAG,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAChI,CAAC;AAeD,SAAgB,gBAAgB,CAAC,CAAuB;IACtD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,kBAAkB,CAAC,CAAC,CAAC,yDAAyD;QAChM,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,uBAAuB,CAAC,CAAC,CAAC,gEAAgE;YACzG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,oEAAoE;gBAC7F,CAAC,CAAC,4EAA4E,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;QAC3E,CAAC,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,YAAY,UAAU,CAAC,CAAC,OAAO,CAAC,aAAa,qBAAqB,CAAC,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAuB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrS,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,+EAA+E,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnR,CAAC;AACD,SAAgB,oBAAoB,CAAC,CAAuB;IAC1D,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC5M,CAAC"}

package/dist/orchestration/file-delivery.d.ts

@@ -0,0 +1,16 @@
+import type { AgentConfig } from '../types';
+import type { Row } from './store';
+import type { DeliveryOutcome } from './delivery';
+export interface ChannelFile {
+    path: string;
+    name: string;
+    kind: 'image' | 'file' | 'audio';
+    caption: string;
+    durationMs?: number;
+}
+export declare function resolveChannelFile(agent: AgentConfig, file: ChannelFile): {
+    path: string;
+    bytes: Buffer;
+};
+export declare function sendChannelFile(agent: AgentConfig, binding: Row, file: ChannelFile, id: string, request: typeof fetch, enabled?: () => boolean): Promise<DeliveryOutcome>;
+//# sourceMappingURL=file-delivery.d.ts.map

package/dist/orchestration/file-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-delivery.d.ts","sourceRoot":"","sources":["../../src/orchestration/file-delivery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAAE;AACpI,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAWvG;AACD,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,EAAE,OAAO,GAAE,MAAM,OAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2E3L"}