pilotlynx 0.1.2 → 0.2.0

package/dist/lib/relay/platforms/slack.js

@@ -0,0 +1,240 @@
+// ── Slack Platform Adapter ──
+// Implements ChatPlatform via @slack/bolt (Socket Mode or HTTP).
+export class SlackAdapter {
+    config;
+    name = 'slack';
+    capabilities = {
+        nativeStreaming: true,
+        maxStreamUpdateHz: 10,
+        supportsReactions: true,
+        supportsSlashCommands: true,
+        supportsThreads: true,
+        maxMessageLength: 4000,
+    };
+    onMessage = async () => { };
+    onReaction = async () => { };
+    onCommand = async () => '';
+    app; // Bolt App – dynamically imported
+    botUserId;
+    userCache = new Map(); // userId → displayName
+    reconnectBackoff = 1000;
+    lastEventTime = Date.now();
+    healthTimer;
+    processedRetries = new Set(); // dedup x-slack-retry-num
+    constructor(config) {
+        this.config = config;
+    }
+    async start() {
+        const { App } = await import('@slack/bolt');
+        this.app = new App({
+            token: this.config.botToken,
+            appToken: this.config.appToken,
+            signingSecret: this.config.signingSecret,
+            socketMode: this.config.mode === 'socket',
+            port: this.config.port,
+        });
+        // ── Event: app_mention ──
+        this.app.event('app_mention', async ({ event, context }) => {
+            if (this.shouldSkipRetry(context))
+                return;
+            this.lastEventTime = Date.now();
+            const msg = await this.slackEventToChatMessage(event);
+            if (!msg.isBot)
+                await this.onMessage(msg);
+        });
+        // ── Event: message ──
+        this.app.event('message', async ({ event, context }) => {
+            if (this.shouldSkipRetry(context))
+                return;
+            if (event.subtype && event.subtype !== 'file_share')
+                return;
+            this.lastEventTime = Date.now();
+            const msg = await this.slackEventToChatMessage(event);
+            if (!msg.isBot)
+                await this.onMessage(msg);
+        });
+        // ── Event: reaction_added ──
+        this.app.event('reaction_added', async ({ event, context }) => {
+            if (this.shouldSkipRetry(context))
+                return;
+            this.lastEventTime = Date.now();
+            await this.onReaction(event.item.channel, event.item.ts, event.user, event.reaction);
+        });
+        // ── Slash command: /pilotlynx-bind ──
+        this.app.command('/pilotlynx-bind', async ({ command, ack }) => {
+            await ack();
+            this.lastEventTime = Date.now();
+            const response = await this.onCommand(command.channel_id, command.user_id, 'bind', command.text);
+            return { text: response };
+        });
+        await this.app.start();
+        // Resolve bot user ID for self-filtering
+        const authResult = await this.app.client.auth.test();
+        this.botUserId = authResult.user_id;
+        // Health check timer – force reconnect if no events for 90s
+        this.healthTimer = setInterval(() => {
+            if (Date.now() - this.lastEventTime > 90_000) {
+                this.attemptReconnect();
+            }
+        }, 30_000);
+    }
+    async stop() {
+        if (this.healthTimer) {
+            clearInterval(this.healthTimer);
+            this.healthTimer = undefined;
+        }
+        if (this.app) {
+            await this.app.stop();
+        }
+    }
+    async sendMessage(channelId, text, threadId) {
+        const result = await this.app.client.chat.postMessage({
+            channel: channelId,
+            text,
+            thread_ts: threadId,
+        });
+        return result.ts;
+    }
+    async updateMessage(channelId, messageId, text) {
+        await this.app.client.chat.update({
+            channel: channelId,
+            ts: messageId,
+            text,
+        });
+    }
+    async startStream(channelId, threadId) {
+        const initialTs = await this.sendMessage(channelId, 'Working on it\u2026', threadId);
+        let accumulated = '';
+        let pending;
+        const debounceMs = 300;
+        const flush = async (text) => {
+            await this.updateMessage(channelId, initialTs, text);
+        };
+        return {
+            append: async (text) => {
+                accumulated += text;
+                if (pending)
+                    clearTimeout(pending);
+                pending = setTimeout(() => {
+                    void flush(accumulated);
+                }, debounceMs);
+            },
+            stop: async (finalText) => {
+                if (pending)
+                    clearTimeout(pending);
+                await flush(finalText ?? accumulated);
+            },
+        };
+    }
+    async uploadFile(channelId, content, filename, threadId) {
+        await this.app.client.files.uploadV2({
+            channel_id: channelId,
+            content,
+            filename,
+            thread_ts: threadId,
+        });
+    }
+    async getThreadHistory(channelId, threadId, afterTs) {
+        const result = await this.app.client.conversations.replies({
+            channel: channelId,
+            ts: threadId,
+            oldest: afterTs,
+        });
+        const messages = [];
+        for (const msg of result.messages ?? []) {
+            messages.push(await this.slackMsgToChatMessage(channelId, msg));
+        }
+        return messages;
+    }
+    // ── Helpers ──
+    shouldSkipRetry(context) {
+        const retryNum = context?.retryNum;
+        if (retryNum == null)
+            return false;
+        const key = `${retryNum}`;
+        if (this.processedRetries.has(key))
+            return true;
+        this.processedRetries.add(key);
+        // Prevent memory leak – prune old entries periodically
+        if (this.processedRetries.size > 1000) {
+            const entries = Array.from(this.processedRetries);
+            this.processedRetries = new Set(entries.slice(-500));
+        }
+        return false;
+    }
+    async resolveUserName(userId) {
+        const cached = this.userCache.get(userId);
+        if (cached)
+            return cached;
+        try {
+            const result = await this.app.client.users.info({ user: userId });
+            const name = result.user?.profile?.display_name ||
+                result.user?.real_name ||
+                result.user?.name ||
+                userId;
+            this.userCache.set(userId, name);
+            return name;
+        }
+        catch {
+            return userId;
+        }
+    }
+    async slackEventToChatMessage(event) {
+        const isBot = !!(event.bot_id || event.user === this.botUserId);
+        const userName = isBot
+            ? 'bot'
+            : await this.resolveUserName(event.user ?? '');
+        return {
+            platform: 'slack',
+            channelId: event.channel,
+            conversationId: event.thread_ts ?? event.ts,
+            messageId: event.ts,
+            userId: event.user ?? event.bot_id ?? '',
+            userName,
+            text: slackMrkdwnToMarkdown(event.text ?? ''),
+            timestamp: event.ts,
+            isBot,
+        };
+    }
+    async slackMsgToChatMessage(channelId, msg) {
+        const isBot = !!(msg.bot_id || msg.user === this.botUserId);
+        const userName = isBot
+            ? 'bot'
+            : await this.resolveUserName(msg.user ?? '');
+        return {
+            platform: 'slack',
+            channelId,
+            conversationId: msg.thread_ts ?? msg.ts,
+            messageId: msg.ts,
+            userId: msg.user ?? msg.bot_id ?? '',
+            userName,
+            text: slackMrkdwnToMarkdown(msg.text ?? ''),
+            timestamp: msg.ts,
+            isBot,
+        };
+    }
+    attemptReconnect() {
+        this.reconnectBackoff = Math.min(this.reconnectBackoff * 2, 30_000);
+        setTimeout(async () => {
+            try {
+                await this.app.stop();
+                await this.app.start();
+                this.reconnectBackoff = 1000;
+                this.lastEventTime = Date.now();
+            }
+            catch {
+                // Will retry on next health check interval
+            }
+        }, this.reconnectBackoff);
+    }
+}
+// ── Slack mrkdwn → Markdown conversion ──
+function slackMrkdwnToMarkdown(text) {
+    return text
+        .replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, '**$1**') // *bold* → **bold**
+        .replace(/(?<!_)_([^_]+)_(?!_)/g, '*$1*') // _italic_ → *italic*
+        .replace(/~([^~]+)~/g, '~~$1~~') // ~strike~ → ~~strike~~
+        .replace(/<(https?:\/\/[^|>]+)\|([^>]+)>/g, '[$2]($1)') // <url|text> → [text](url)
+        .replace(/<(https?:\/\/[^>]+)>/g, '$1'); // <url> → url
+}
+//# sourceMappingURL=slack.js.map

package/dist/lib/relay/platforms/slack.js.map

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

package/dist/lib/relay/platforms/telegram.d.ts

@@ -0,0 +1,29 @@
+import type { ChatPlatform, ChatMessage, PlatformCapabilities, StreamHandle } from '../platform.js';
+export interface TelegramAdapterConfig {
+    botToken: string;
+    streamMode: 'edit' | 'chunked' | 'final-only';
+    editIntervalMs: number;
+}
+export declare class TelegramAdapter implements ChatPlatform {
+    private config;
+    readonly name = "telegram";
+    readonly capabilities: PlatformCapabilities;
+    onMessage: (msg: ChatMessage) => Promise<void>;
+    onReaction: (channelId: string, messageId: string, userId: string, emoji: string) => Promise<void>;
+    onCommand: (channelId: string, userId: string, command: string, args: string) => Promise<string>;
+    private bot;
+    private InputFile;
+    constructor(config: TelegramAdapterConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(channelId: string, text: string, threadId?: string): Promise<string>;
+    updateMessage(channelId: string, messageId: string, text: string): Promise<void>;
+    startStream(channelId: string, threadId?: string): Promise<StreamHandle>;
+    uploadFile(channelId: string, content: string, filename: string, threadId?: string): Promise<void>;
+    getThreadHistory(_channelId: string, _threadId: string, _afterTs?: string): Promise<ChatMessage[]>;
+    private streamEdit;
+    private streamChunked;
+    private streamFinalOnly;
+    private telegramToChatMessage;
+    private resolveConversationId;
+}

package/dist/lib/relay/platforms/telegram.js

@@ -0,0 +1,193 @@
+// ── Telegram Platform Adapter ──
+// Implements ChatPlatform via grammy Bot framework.
+export class TelegramAdapter {
+    config;
+    name = 'telegram';
+    capabilities = {
+        nativeStreaming: false,
+        maxStreamUpdateHz: 0.08,
+        supportsReactions: true,
+        supportsSlashCommands: false,
+        supportsThreads: false,
+        maxMessageLength: 4096,
+    };
+    onMessage = async () => { };
+    onReaction = async () => { };
+    onCommand = async () => '';
+    bot; // grammy Bot – dynamically imported
+    InputFile; // grammy InputFile constructor
+    constructor(config) {
+        this.config = config;
+    }
+    async start() {
+        const grammy = await import('grammy');
+        const { Bot } = grammy;
+        this.InputFile = grammy.InputFile;
+        this.bot = new Bot(this.config.botToken);
+        // ── Text messages ──
+        this.bot.on('message:text', async (ctx) => {
+            const msg = ctx.message;
+            // Handle /command messages
+            if (msg.text.startsWith('/')) {
+                const [cmdRaw, ...rest] = msg.text.split(' ');
+                const command = cmdRaw.slice(1).replace(/@.*$/, ''); // strip /prefix and @botname
+                const args = rest.join(' ');
+                const response = await this.onCommand(String(msg.chat.id), String(msg.from.id), command, args);
+                if (response) {
+                    await ctx.reply(response);
+                }
+                return;
+            }
+            const chatMessage = this.telegramToChatMessage(msg);
+            await this.onMessage(chatMessage);
+        });
+        // ── Callback queries (inline keyboard feedback) ──
+        this.bot.on('callback_query:data', async (ctx) => {
+            const query = ctx.callbackQuery;
+            await ctx.answerCallbackQuery();
+            await this.onReaction(String(query.message?.chat?.id ?? ''), String(query.message?.message_id ?? ''), String(query.from.id), query.data);
+        });
+        await this.bot.start();
+    }
+    async stop() {
+        if (this.bot) {
+            this.bot.stop();
+        }
+    }
+    async sendMessage(channelId, text, threadId) {
+        const opts = {};
+        if (threadId) {
+            opts.reply_to_message_id = parseInt(threadId, 10);
+        }
+        const escaped = escapeMarkdownV2(text);
+        const result = await this.bot.api.sendMessage(channelId, escaped, { ...opts, parse_mode: 'MarkdownV2' });
+        return String(result.message_id);
+    }
+    async updateMessage(channelId, messageId, text) {
+        const escaped = escapeMarkdownV2(text);
+        await this.bot.api.editMessageText(channelId, parseInt(messageId, 10), escaped, { parse_mode: 'MarkdownV2' });
+    }
+    async startStream(channelId, threadId) {
+        const mode = this.config.streamMode;
+        const intervalMs = this.config.editIntervalMs;
+        if (mode === 'final-only') {
+            return this.streamFinalOnly(channelId, threadId);
+        }
+        if (mode === 'chunked') {
+            return this.streamChunked(channelId, threadId);
+        }
+        // Default: 'edit' mode
+        return this.streamEdit(channelId, threadId, intervalMs);
+    }
+    async uploadFile(channelId, content, filename, threadId) {
+        const opts = {};
+        if (threadId) {
+            opts.reply_to_message_id = parseInt(threadId, 10);
+        }
+        const inputFile = new this.InputFile(Buffer.from(content), filename);
+        await this.bot.api.sendDocument(channelId, inputFile, opts);
+    }
+    async getThreadHistory(_channelId, _threadId, _afterTs) {
+        // Telegram has no thread history API – rely on SQLite cache
+        return [];
+    }
+    // ── Stream mode implementations ──
+    async streamEdit(channelId, threadId, intervalMs) {
+        const msgId = await this.sendMessage(channelId, 'Working on it\u2026', threadId);
+        let accumulated = '';
+        let lastUpdate = 0;
+        let pending;
+        const flush = async (text) => {
+            const now = Date.now();
+            if (now - lastUpdate < intervalMs)
+                return;
+            lastUpdate = now;
+            try {
+                await this.updateMessage(channelId, msgId, text);
+            }
+            catch {
+                // Telegram rate limit or identical content – ignore
+            }
+        };
+        return {
+            append: async (text) => {
+                accumulated += text;
+                if (pending)
+                    clearTimeout(pending);
+                pending = setTimeout(() => {
+                    void flush(accumulated);
+                }, intervalMs);
+            },
+            stop: async (finalText) => {
+                if (pending)
+                    clearTimeout(pending);
+                await this.updateMessage(channelId, msgId, finalText ?? accumulated);
+            },
+        };
+    }
+    async streamChunked(channelId, threadId) {
+        const chunkSize = 2000;
+        let accumulated = '';
+        let sentLength = 0;
+        return {
+            append: async (text) => {
+                accumulated += text;
+                while (accumulated.length - sentLength >= chunkSize) {
+                    const chunk = accumulated.slice(sentLength, sentLength + chunkSize);
+                    await this.sendMessage(channelId, chunk, threadId);
+                    sentLength += chunkSize;
+                }
+            },
+            stop: async (finalText) => {
+                const remaining = finalText ?? accumulated.slice(sentLength);
+                if (remaining.length > 0) {
+                    await this.sendMessage(channelId, remaining, threadId);
+                }
+            },
+        };
+    }
+    streamFinalOnly(channelId, threadId) {
+        let accumulated = '';
+        return {
+            append: async (text) => {
+                accumulated += text;
+            },
+            stop: async (finalText) => {
+                const content = finalText ?? accumulated;
+                if (content.length > 0) {
+                    await this.sendMessage(channelId, content, threadId);
+                }
+            },
+        };
+    }
+    // ── Helpers ──
+    telegramToChatMessage(msg) {
+        const conversationId = this.resolveConversationId(msg);
+        return {
+            platform: 'telegram',
+            channelId: String(msg.chat.id),
+            conversationId,
+            messageId: String(msg.message_id),
+            userId: String(msg.from.id),
+            userName: msg.from.username ||
+                [msg.from.first_name, msg.from.last_name].filter(Boolean).join(' ') ||
+                String(msg.from.id),
+            text: msg.text ?? '',
+            timestamp: String(msg.date),
+            isBot: msg.from.is_bot ?? false,
+        };
+    }
+    resolveConversationId(msg) {
+        // Walk reply chain to find root message ID
+        let current = msg;
+        while (current.reply_to_message) {
+            current = current.reply_to_message;
+        }
+        return String(current.message_id);
+    }
+}
+// ── Telegram MarkdownV2 escaping ──
+function escapeMarkdownV2(text) {
+    return text.replace(/([_*\[\]()~`>#+\-=|{}.!\\])/g, '\\$1');
+}
+//# sourceMappingURL=telegram.js.map

package/dist/lib/relay/platforms/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../../src/lib/relay/platforms/telegram.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,oDAAoD;AAepD,MAAM,OAAO,eAAe;IA4BN;IA3BX,IAAI,GAAG,UAAU,CAAC;IAClB,YAAY,GAAyB;QAC5C,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,IAAI;QACvB,iBAAiB,EAAE,IAAI;QACvB,qBAAqB,EAAE,KAAK;QAC5B,eAAe,EAAE,KAAK;QACtB,gBAAgB,EAAE,IAAI;KACvB,CAAC;IAEF,SAAS,GAAwC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IAChE,UAAU,GAKW,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC;IACpC,SAAS,GAKc,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IAE9B,GAAG,CAAM,CAAC,oCAAoC;IAC9C,SAAS,CAAM,CAAC,+BAA+B;IAEvD,YAAoB,MAA6B;QAA7B,WAAM,GAAN,MAAM,CAAuB;IAAG,CAAC;IAErD,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAElC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEzC,sBAAsB;QACtB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;YAExB,2BAA2B;YAC3B,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,6BAA6B;gBAClF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CACnC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EACnB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EACnB,OAAO,EACP,IAAI,CACL,CAAC;gBACF,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC5B,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,oDAAoD;QACpD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAQ,EAAE,EAAE;YACpD,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;YAChC,MAAM,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,UAAU,CACnB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EACrC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC,EACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EACrB,KAAK,CAAC,IAAI,CACX,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,IAAY,EACZ,QAAiB;QAEjB,MAAM,IAAI,GAAQ,EAAE,CAAC;QACrB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAC3C,SAAS,EACT,OAAO,EACP,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,CACtC,CAAC;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,SAAiB,EACjB,SAAiB,EACjB,IAAY;QAEZ,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAChC,SAAS,EACT,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,EACvB,OAAO,EACP,EAAE,UAAU,EAAE,YAAY,EAAE,CAC7B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,QAAiB;QAEjB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;QAE9C,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QACD,uBAAuB;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,OAAe,EACf,QAAgB,EAChB,QAAiB;QAEjB,MAAM,IAAI,GAAQ,EAAE,CAAC;QACrB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrE,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAAkB,EAClB,SAAiB,EACjB,QAAiB;QAEjB,4DAA4D;QAC5D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,oCAAoC;IAE5B,KAAK,CAAC,UAAU,CACtB,SAAiB,EACjB,QAA4B,EAC5B,UAAkB;QAElB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAClC,SAAS,EACT,qBAAqB,EACrB,QAAQ,CACT,CAAC;QACF,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,OAAmC,CAAC;QAExC,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,UAAU,GAAG,UAAU;gBAAE,OAAO;YAC1C,UAAU,GAAG,GAAG,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,KAAK,EAAE,IAAY,EAAiB,EAAE;gBAC5C,WAAW,IAAI,IAAI,CAAC;gBACpB,IAAI,OAAO;oBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBACxB,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC1B,CAAC,EAAE,UAAU,CAAC,CAAC;YACjB,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAiB,EAAE;gBAChD,IAAI,OAAO;oBAAE,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnC,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,WAAW,CAAC,CAAC;YACvE,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,SAAiB,EACjB,QAA4B;QAE5B,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,OAAO;YACL,MAAM,EAAE,KAAK,EAAE,IAAY,EAAiB,EAAE;gBAC5C,WAAW,IAAI,IAAI,CAAC;gBACpB,OAAO,WAAW,CAAC,MAAM,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC;oBACpD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;oBACpE,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;oBACnD,UAAU,IAAI,SAAS,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAiB,EAAE;gBAChD,MAAM,SAAS,GAAG,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,eAAe,CACrB,SAAiB,EACjB,QAA4B;QAE5B,IAAI,WAAW,GAAG,EAAE,CAAC;QAErB,OAAO;YACL,MAAM,EAAE,KAAK,EAAE,IAAY,EAAiB,EAAE;gBAC5C,WAAW,IAAI,IAAI,CAAC;YACtB,CAAC;YACD,IAAI,EAAE,KAAK,EAAE,SAAkB,EAAiB,EAAE;gBAChD,MAAM,OAAO,GAAG,SAAS,IAAI,WAAW,CAAC;gBACzC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,gBAAgB;IAER,qBAAqB,CAAC,GAAQ;QACpC,MAAM,cAAc,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,cAAc;YACd,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;YACjC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,QAAQ,EACN,GAAG,CAAC,IAAI,CAAC,QAAQ;gBACjB,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACpB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAC3B,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK;SAChC,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,GAAQ;QACpC,2CAA2C;QAC3C,IAAI,OAAO,GAAG,GAAG,CAAC;QAClB,OAAO,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAChC,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF;AAED,qCAAqC;AAErC,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/dist/lib/relay/poster.d.ts

@@ -0,0 +1,24 @@
+import type { RelayRunResult } from './types.js';
+/**
+ * Split a long response into parts that fit within maxLen.
+ * Splits at paragraph boundaries first, then line boundaries, then hard-splits.
+ * Numbers parts "[1/N]", "[2/N]" when there are multiple.
+ */
+export declare function formatResponse(text: string, maxLen: number): string[];
+/**
+ * Build a cost/usage footer for a relay run result.
+ */
+export declare function addCostFooter(result: RelayRunResult): string;
+/**
+ * Run `git diff --stat` in a project directory.
+ * Returns the output or null if not a git repo / no changes.
+ */
+export declare function getGitDiffSummary(projectDir: string): string | null;
+/**
+ * Multi-stage sanitization of agent output before posting to chat.
+ *
+ * Stage 1: Pattern-based secret detection (redact matched patterns)
+ * Stage 2: Literal env value replacement
+ * Stage 3: Length cap
+ */
+export declare function sanitizeAgentOutput(text: string, projectEnv: Record<string, string>): string;

package/dist/lib/relay/poster.js

@@ -0,0 +1,136 @@
+import { execFileSync } from 'node:child_process';
+const MAX_OUTPUT_CHARS = 40_000;
+const TRUNCATION_THRESHOLD = 12_000;
+/**
+ * Split a long response into parts that fit within maxLen.
+ * Splits at paragraph boundaries first, then line boundaries, then hard-splits.
+ * Numbers parts "[1/N]", "[2/N]" when there are multiple.
+ */
+export function formatResponse(text, maxLen) {
+    if (text.length > TRUNCATION_THRESHOLD) {
+        text = text.slice(0, TRUNCATION_THRESHOLD) +
+            '\n\n_Response truncated. Full output available as file._';
+    }
+    if (text.length <= maxLen) {
+        return [text];
+    }
+    const chunks = [];
+    // Split at paragraph boundaries (double newline)
+    const paragraphs = text.split(/\n\n+/);
+    let current = '';
+    for (const para of paragraphs) {
+        if (para.length > maxLen) {
+            // Flush current buffer
+            if (current.length > 0) {
+                chunks.push(current.trimEnd());
+                current = '';
+            }
+            // Split long paragraph at line boundaries
+            const lines = para.split('\n');
+            for (const line of lines) {
+                if (line.length > maxLen) {
+                    // Flush current
+                    if (current.length > 0) {
+                        chunks.push(current.trimEnd());
+                        current = '';
+                    }
+                    // Hard-split
+                    for (let i = 0; i < line.length; i += maxLen) {
+                        chunks.push(line.slice(i, i + maxLen));
+                    }
+                }
+                else if (current.length + line.length + 1 > maxLen) {
+                    chunks.push(current.trimEnd());
+                    current = line;
+                }
+                else {
+                    current += (current.length > 0 ? '\n' : '') + line;
+                }
+            }
+        }
+        else if (current.length + para.length + 2 > maxLen) {
+            chunks.push(current.trimEnd());
+            current = para;
+        }
+        else {
+            current += (current.length > 0 ? '\n\n' : '') + para;
+        }
+    }
+    if (current.length > 0) {
+        chunks.push(current.trimEnd());
+    }
+    // Number parts if multiple
+    if (chunks.length > 1) {
+        const total = chunks.length;
+        return chunks.map((c, i) => `[${i + 1}/${total}]\n${c}`);
+    }
+    return chunks;
+}
+/**
+ * Build a cost/usage footer for a relay run result.
+ */
+export function addCostFooter(result) {
+    const dur = Math.round(result.durationMs / 1000);
+    const cost = result.costUsd.toFixed(4);
+    const model = result.model ?? 'unknown';
+    return `_Model: ${model} | Cost: $${cost} | Tokens: ${result.inputTokens} in / ${result.outputTokens} out | Duration: ${dur}s | Turns: ${result.numTurns}_`;
+}
+/**
+ * Run `git diff --stat` in a project directory.
+ * Returns the output or null if not a git repo / no changes.
+ */
+export function getGitDiffSummary(projectDir) {
+    try {
+        const diff = execFileSync('git', ['diff', '--stat'], {
+            cwd: projectDir,
+            timeout: 5000,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return diff.length > 0 ? diff : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Multi-stage sanitization of agent output before posting to chat.
+ *
+ * Stage 1: Pattern-based secret detection (redact matched patterns)
+ * Stage 2: Literal env value replacement
+ * Stage 3: Length cap
+ */
+export function sanitizeAgentOutput(text, projectEnv) {
+    let sanitized = text;
+    // Stage 1: Pattern-based secret detection — always run all patterns
+    const patterns = [
+        /(?:sk|pk|api|key|token|secret|password|auth)[-_]?[a-zA-Z0-9]{20,}/gi,
+        /AIza[0-9A-Za-z_-]{35}/g,
+        /ghp_[0-9a-zA-Z]{36}/g,
+        /(?:AKIA|ASIA)[0-9A-Z]{16}/g,
+        /xox[bporas]-[0-9a-zA-Z-]{10,}/g,
+        /-----BEGIN (?:RSA |EC )?PRIVATE KEY-----/g,
+        /sk-ant-[a-zA-Z0-9_-]{20,}/g,
+        /eyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+/g,
+        /[a-z]+:\/\/[^:]+:[^@]+@[^\s]+/g,
+        /xapp-[0-9a-zA-Z-]{10,}/g,
+    ];
+    for (const pattern of patterns) {
+        sanitized = sanitized.replace(pattern, '[REDACTED]');
+    }
+    // Stage 2: Literal env value replacement
+    for (const [key, value] of Object.entries(projectEnv)) {
+        if (value.length > 3) {
+            // Use split/join for literal replacement (no regex special chars issues)
+            while (sanitized.includes(value)) {
+                sanitized = sanitized.split(value).join(`[ENV:${key}]`);
+            }
+        }
+    }
+    // Stage 3: Length cap
+    if (sanitized.length > MAX_OUTPUT_CHARS) {
+        sanitized = sanitized.slice(0, MAX_OUTPUT_CHARS) + '\n[output truncated]';
+    }
+    return sanitized;
+}
+//# sourceMappingURL=poster.js.map

package/dist/lib/relay/poster.js.map

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