pilotlynx 0.1.2 → 0.2.0

package/dist/lib/relay/feedback.js

@@ -0,0 +1,142 @@
+// ── Feedback Handler ──
+// Classifies chat reactions as feedback signals and persists them.
+import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { INSIGHTS_DIR, getProjectDir } from '../config.js';
+const FEEDBACK_FILE = () => join(INSIGHTS_DIR(), 'relay-feedback.jsonl');
+const MAX_ENTRIES = 1000;
+// ── Emoji Classification ──
+const POSITIVE_EMOJI = new Set(['thumbsup', '+1', 'white_check_mark', 'heavy_check_mark']);
+const NEGATIVE_EMOJI = new Set(['thumbsdown', '-1', 'x', 'negative_squared_cross_mark']);
+const SAVE_EMOJI = new Set(['star', 'star2', 'glowing_star']);
+const ACKNOWLEDGE_EMOJI = new Set(['eyes', 'mag']);
+/**
+ * Classify a reaction emoji into a feedback type.
+ * Returns null for unrecognized emoji.
+ */
+export function classifyReaction(emoji) {
+    const key = emoji.replace(/:/g, '').toLowerCase();
+    if (POSITIVE_EMOJI.has(key))
+        return 'positive';
+    if (NEGATIVE_EMOJI.has(key))
+        return 'negative';
+    if (SAVE_EMOJI.has(key))
+        return 'save';
+    if (ACKNOWLEDGE_EMOJI.has(key))
+        return 'acknowledge';
+    return null;
+}
+/**
+ * Convert a FeedbackSignal into a ChatFeedbackEntry.
+ */
+export function handleFeedback(signal, project, agentOutputSummary) {
+    return {
+        type: signal.type,
+        platform: signal.platform,
+        conversationId: signal.conversationId,
+        messageId: signal.messageId,
+        userId: signal.userId,
+        userName: signal.userName,
+        timestamp: signal.timestamp,
+        project,
+        agentOutputSummary,
+    };
+}
+/**
+ * Append a feedback entry to the relay feedback JSONL file.
+ * Caps at MAX_ENTRIES by trimming oldest entries when exceeded.
+ */
+export function appendRelayFeedback(entry) {
+    const filePath = FEEDBACK_FILE();
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    appendFileSync(filePath, JSON.stringify(entry) + '\n', 'utf8');
+    // Check if we need to trim
+    const lines = readFileSync(filePath, 'utf8').split('\n').filter(Boolean);
+    if (lines.length > MAX_ENTRIES) {
+        const trimmed = lines.slice(lines.length - MAX_ENTRIES);
+        writeFileSync(filePath, trimmed.join('\n') + '\n', 'utf8');
+    }
+}
+/**
+ * Read all feedback entries, optionally filtered by project.
+ */
+export function readRelayFeedback(project) {
+    const filePath = FEEDBACK_FILE();
+    if (!existsSync(filePath))
+        return [];
+    const lines = readFileSync(filePath, 'utf8').split('\n').filter(Boolean);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            if (!project || entry.project === project) {
+                entries.push(entry);
+            }
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return entries;
+}
+// ── Save to Memory ──
+/**
+ * Save a starred/saved response to the project's memory/ directory.
+ * Creates a timestamped markdown file with the thread context and bot response.
+ */
+export function saveFeedbackToMemory(project, entry, botResponse) {
+    let projectDir;
+    try {
+        projectDir = getProjectDir(project);
+    }
+    catch {
+        return; // project not found — skip silently
+    }
+    const memoryDir = join(projectDir, 'memory');
+    if (!existsSync(memoryDir))
+        mkdirSync(memoryDir, { recursive: true });
+    const ts = entry.timestamp.replace(/[:.]/g, '-').slice(0, 19);
+    const filename = `relay-saved-${ts}.md`;
+    const filePath = join(memoryDir, filename);
+    const lines = [
+        `# Saved Relay Response`,
+        ``,
+        `- **Platform**: ${entry.platform}`,
+        `- **User**: ${entry.userName}`,
+        `- **Date**: ${entry.timestamp}`,
+        `- **Conversation**: ${entry.conversationId}`,
+        ``,
+    ];
+    if (botResponse) {
+        lines.push(`## Response`, ``, botResponse, ``);
+    }
+    if (entry.agentOutputSummary) {
+        lines.push(`## Agent Context`, ``, entry.agentOutputSummary, ``);
+    }
+    writeFileSync(filePath, lines.join('\n'), 'utf8');
+}
+// ── Rate Limiting ──
+const reactionTimestamps = new Map();
+/**
+ * Check if a user has exceeded the reaction rate limit (sliding window, 1 hour).
+ */
+export function isReactionRateLimited(userId, maxPerHour) {
+    const now = Date.now();
+    const windowMs = 60 * 60 * 1000;
+    const cutoff = now - windowMs;
+    let timestamps = reactionTimestamps.get(userId);
+    if (!timestamps) {
+        timestamps = [];
+        reactionTimestamps.set(userId, timestamps);
+    }
+    // Prune old entries
+    const recent = timestamps.filter((t) => t > cutoff);
+    reactionTimestamps.set(userId, recent);
+    if (recent.length >= maxPerHour)
+        return true;
+    recent.push(now);
+    return false;
+}
+//# sourceMappingURL=feedback.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+import type { ChatPlatform } from './platform.js';
+import type { RunRecord } from '../types.js';
+import type { RelayConfig } from './types.js';
+export declare class RelayNotifier {
+    private platforms;
+    private db;
+    private config;
+    constructor(platforms: Map<string, ChatPlatform>, db: Database.Database, config: RelayConfig);
+    /**
+     * Notify bound channels about a scheduled workflow run result.
+     */
+    notifyScheduleResult(project: string, record: RunRecord): Promise<void>;
+    /**
+     * Notify bound channels about insights from the improve loop.
+     */
+    notifyImproveInsights(project: string, insights: string[]): Promise<void>;
+    /**
+     * Notify bound channels about budget threshold being approached.
+     */
+    notifyBudgetAlert(project: string, spent: number, limit: number): Promise<void>;
+    /**
+     * Notify bound channels when a project's health score drops.
+     */
+    notifyHealthDrop(project: string, oldScore: number, newScore: number): Promise<void>;
+    /**
+     * Send a message to all platforms that have a channel bound to the project.
+     */
+    private broadcast;
+}

package/dist/lib/relay/notifier.js

@@ -0,0 +1,78 @@
+// ── Relay Notifier ──
+// Sends proactive notifications to bound channels for scheduled runs,
+// improve insights, budget alerts, and health score changes.
+import { getChannelForProject } from './bindings.js';
+export class RelayNotifier {
+    platforms;
+    db;
+    config;
+    constructor(platforms, db, config) {
+        this.platforms = platforms;
+        this.db = db;
+        this.config = config;
+    }
+    /**
+     * Notify bound channels about a scheduled workflow run result.
+     */
+    async notifyScheduleResult(project, record) {
+        if (!this.config.notifications.scheduleFailures && !record.success)
+            return;
+        const start = new Date(record.startedAt).getTime();
+        const end = new Date(record.completedAt).getTime();
+        const dur = Math.round((end - start) / 1000);
+        const status = record.success ? 'Success' : 'Failed';
+        let message = `Scheduled run \`${record.workflow}\` for *${project}*: ${status}\nCost: $${record.costUsd.toFixed(4)} | Duration: ${dur}s`;
+        if (!record.success && record.error) {
+            message += `\n${record.error}`;
+        }
+        await this.broadcast(project, message);
+    }
+    /**
+     * Notify bound channels about insights from the improve loop.
+     */
+    async notifyImproveInsights(project, insights) {
+        if (!this.config.notifications.improveInsights)
+            return;
+        if (insights.length === 0)
+            return;
+        const bullets = insights.map((i) => `  - ${i}`).join('\n');
+        const message = `Improve loop found insights for *${project}*:\n${bullets}`;
+        await this.broadcast(project, message);
+    }
+    /**
+     * Notify bound channels about budget threshold being approached.
+     */
+    async notifyBudgetAlert(project, spent, limit) {
+        if (!this.config.notifications.budgetAlerts)
+            return;
+        const pct = Math.round((spent / limit) * 100);
+        const message = `Budget alert for *${project}*: $${spent.toFixed(2)} of $${limit.toFixed(2)} daily budget used (${pct}%)`;
+        await this.broadcast(project, message);
+    }
+    /**
+     * Notify bound channels when a project's health score drops.
+     */
+    async notifyHealthDrop(project, oldScore, newScore) {
+        if (newScore >= this.config.notifications.healthScoreThreshold)
+            return;
+        const message = `Health score dropped for *${project}*: ${oldScore} -> ${newScore}`;
+        await this.broadcast(project, message);
+    }
+    /**
+     * Send a message to all platforms that have a channel bound to the project.
+     */
+    async broadcast(project, message) {
+        for (const [platformName, platform] of this.platforms) {
+            const channelId = getChannelForProject(this.db, platformName, project);
+            if (!channelId)
+                continue;
+            try {
+                await platform.sendMessage(channelId, message);
+            }
+            catch (err) {
+                console.error(`[relay-notifier] Failed to send to ${platformName}/${channelId}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=notifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../../src/lib/relay/notifier.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,sEAAsE;AACtE,6DAA6D;AAM7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,OAAO,aAAa;IAEd;IACA;IACA;IAHV,YACU,SAAoC,EACpC,EAAqB,EACrB,MAAmB;QAFnB,cAAS,GAAT,SAAS,CAA2B;QACpC,OAAE,GAAF,EAAE,CAAmB;QACrB,WAAM,GAAN,MAAM,CAAa;IAC1B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAAe,EAAE,MAAiB;QAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAE3E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAErD,IAAI,OAAO,GAAG,mBAAmB,MAAM,CAAC,QAAQ,WAAW,OAAO,MAAM,MAAM,YAAY,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAC1I,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAe,EAAE,QAAkB;QAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe;YAAE,OAAO;QACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAElC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,oCAAoC,OAAO,OAAO,OAAO,EAAE,CAAC;QAE5E,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,KAAa,EAAE,KAAa;QACnE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY;YAAE,OAAO;QAEpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9C,MAAM,OAAO,GAAG,qBAAqB,OAAO,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,GAAG,IAAI,CAAC;QAE1H,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,QAAgB,EAAE,QAAgB;QACxE,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB;YAAE,OAAO;QAEvE,MAAM,OAAO,GAAG,6BAA6B,OAAO,MAAM,QAAQ,OAAO,QAAQ,EAAE,CAAC;QAEpF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,OAAe;QACtD,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtD,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YACvE,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CACX,sCAAsC,YAAY,IAAI,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvH,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -1,6 +1,5 @@
+import type { WebhookPayload } from './types.js';
 import type { RunRecord } from '../types.js';
-/**
- * Send a notification for a completed workflow run to all configured chats.
- * Uses stateless Bot.api (no running process needed).
- */
+export declare function sendWebhookNotification(payload: WebhookPayload): Promise<void>;
+/** Converts a RunRecord into a WebhookPayload and sends it to configured webhooks. */
 export declare function sendRunNotification(record: RunRecord): Promise<void>;

package/dist/lib/relay/notify.js

@@ -1,168 +1,52 @@
-import { Api } from 'grammy';
-import { mkdirSync, appendFileSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
-import { lock } from 'proper-lockfile';
-import { loadRelayConfig, getTelegramToken, getRelayDir } from './config.js';
-function isWebhookUrlSafe(url) {
-    try {
-        const parsed = new URL(url);
-        if (parsed.protocol !== 'https:')
-            return false;
-        const host = parsed.hostname.toLowerCase();
-        if (host === 'localhost' || host === '::1')
-            return false;
-        // Reject private IP ranges
-        if (/^127\./.test(host))
-            return false;
-        if (/^10\./.test(host))
-            return false;
-        if (/^172\.(1[6-9]|2\d|3[01])\./.test(host))
-            return false;
-        if (/^192\.168\./.test(host))
-            return false;
-        if (host === '0.0.0.0')
-            return false;
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function formatRunMessage(record) {
-    const icon = record.success ? '\u2705' : '\u274c';
-    const status = record.success ? 'Success' : 'Failed';
-    const duration = (() => {
-        const start = new Date(record.startedAt).getTime();
-        const end = new Date(record.completedAt).getTime();
-        const secs = Math.round((end - start) / 1000);
-        return secs < 60 ? `${secs}s` : `${Math.floor(secs / 60)}m ${secs % 60}s`;
-    })();
-    let msg = `${icon} *${record.project}/${record.workflow}* — ${status}\n`;
-    msg += `Duration: ${duration} | Cost: $${record.costUsd.toFixed(4)} | Turns: ${record.numTurns}\n`;
-    if (record.error) {
-        const truncated = record.error.length > 200 ? record.error.slice(0, 200) + '...' : record.error;
-        msg += `Error: ${truncated}`;
-    }
-    else if (record.summary) {
-        const truncated = record.summary.length > 300 ? record.summary.slice(0, 300) + '...' : record.summary;
-        msg += truncated;
-    }
-    return msg;
-}
-const MAX_DEAD_LETTERS = 1000;
-async function logDeadLetter(entry) {
-    const dir = getRelayDir();
-    mkdirSync(dir, { recursive: true });
-    const filePath = `${dir}/dead-letters.jsonl`;
-    if (!existsSync(filePath)) {
-        writeFileSync(filePath, '', 'utf8');
-    }
-    let release;
-    try {
-        release = await lock(filePath, { stale: 10_000, retries: { retries: 3, minTimeout: 100 } });
-        const content = readFileSync(filePath, 'utf8').trim();
-        const lines = content ? content.split('\n') : [];
-        lines.push(JSON.stringify(entry));
-        // Trim to last MAX_DEAD_LETTERS entries
-        const trimmed = lines.length > MAX_DEAD_LETTERS ? lines.slice(-MAX_DEAD_LETTERS) : lines;
-        writeFileSync(filePath, trimmed.join('\n') + '\n', 'utf8');
-    }
-    catch {
-        // Best-effort: fall back to simple append if locking fails
-        appendFileSync(filePath, JSON.stringify(entry) + '\n', 'utf8');
-    }
-    finally {
-        if (release)
-            await release();
-    }
-}
-async function sendWithRetry(fn, chatId, channel, payload, retries = 3) {
-    for (let attempt = 1; attempt <= retries; attempt++) {
+import { loadWebhookConfig } from './config.js';
+export async function sendWebhookNotification(payload) {
+    const config = loadWebhookConfig();
+    if (!config?.enabled)
+        return;
+    for (const webhook of config.webhooks) {
+        if (!webhook.events.includes(payload.event))
+            continue;
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': 'PilotLynx-Webhook/1.0',
+            ...webhook.headers,
+        };
+        if (webhook.secret) {
+            const crypto = await import('node:crypto');
+            const body = JSON.stringify(payload);
+            const signature = crypto.createHmac('sha256', webhook.secret)
+                .update(body)
+                .digest('hex');
+            headers['X-PilotLynx-Signature'] = `sha256=${signature}`;
+        }
         try {
-            await fn();
-            return;
+            await fetch(webhook.url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(10_000),
+            });
         }
         catch (err) {
-            const status = err?.error_code ?? err?.status;
-            // Don't retry 4xx errors (except 429 rate limits)
-            if (status && status >= 400 && status < 500 && status !== 429) {
-                await logDeadLetter({
-                    timestamp: new Date().toISOString(),
-                    chatId,
-                    channel,
-                    error: err instanceof Error ? err.message : String(err),
-                    payload,
-                });
-                return;
-            }
-            if (attempt === retries) {
-                await logDeadLetter({
-                    timestamp: new Date().toISOString(),
-                    chatId,
-                    channel,
-                    error: err instanceof Error ? err.message : String(err),
-                    payload,
-                });
-                return;
-            }
-            // Exponential backoff: 1s, 2s, 4s
-            await new Promise(r => setTimeout(r, 1000 * Math.pow(2, attempt - 1)));
+            console.error(`[pilotlynx] Webhook "${webhook.name}" failed: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
 }
-/**
- * Send a notification for a completed workflow run to all configured chats.
- * Uses stateless Bot.api (no running process needed).
- */
+/** Converts a RunRecord into a WebhookPayload and sends it to configured webhooks. */
 export async function sendRunNotification(record) {
-    const config = loadRelayConfig();
-    if (!config || !config.enabled)
-        return;
-    // Filter by notification preferences
-    const shouldNotify = record.success
-        ? config.notifications.onScheduleComplete
-        : config.notifications.onScheduleFailure;
-    if (!shouldNotify)
-        return;
-    const message = formatRunMessage(record);
-    for (const [chatId, chatConfig] of Object.entries(config.routing.chats)) {
-        if (!chatConfig.notifySchedule)
-            continue;
-        // Only notify chats mapped to this project (or unmapped chats)
-        if (chatConfig.project && chatConfig.project !== record.project)
-            continue;
-        if (chatId.startsWith('telegram:')) {
-            if (!config.channels.telegram.enabled)
-                continue;
-            const token = getTelegramToken();
-            if (!token)
-                continue;
-            const tgChatId = chatId.slice('telegram:'.length);
-            const api = new Api(token);
-            await sendWithRetry(() => api.sendMessage(tgChatId, message, { parse_mode: 'Markdown' }).then(() => { }), chatId, 'telegram', record);
-        }
-        else if (chatId.startsWith('webhook:')) {
-            if (!config.channels.webhook.enabled)
-                continue;
-            const url = chatId.slice('webhook:'.length);
-            if (!isWebhookUrlSafe(url)) {
-                await logDeadLetter({
-                    timestamp: new Date().toISOString(),
-                    chatId,
-                    channel: 'webhook',
-                    error: `Unsafe webhook URL rejected: ${url}`,
-                    payload: record,
-                });
-                continue;
-            }
-            await sendWithRetry(() => fetch(url, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify(record),
-            }).then(res => {
-                if (!res.ok)
-                    throw Object.assign(new Error(`HTTP ${res.status}`), { status: res.status });
-            }), chatId, 'webhook', record);
-        }
-    }
+    const start = new Date(record.startedAt).getTime();
+    const end = new Date(record.completedAt).getTime();
+    const payload = {
+        event: record.success ? 'run_complete' : 'run_failed',
+        timestamp: record.completedAt,
+        project: record.project,
+        workflow: record.workflow,
+        success: record.success,
+        summary: record.error ?? record.summary ?? '',
+        costUsd: record.costUsd,
+        durationMs: end - start,
+        model: record.model,
+    };
+    await sendWebhookNotification(payload);
 }
 //# sourceMappingURL=notify.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/lib/relay/notify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/lib/relay/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAuB;IACnE,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO;IAE7B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAgD,CAAC;YAAE,SAAS;QAEjG,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,uBAAuB;YACrC,GAAG,OAAO,CAAC,OAAO;SACnB,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;iBAC1D,MAAM,CAAC,IAAI,CAAC;iBACZ,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,CAAC,uBAAuB,CAAC,GAAG,UAAU,SAAS,EAAE,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;gBACvB,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAiB;IACzD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IAEnD,MAAM,OAAO,GAAmB;QAC9B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY;QACrD,SAAS,EAAE,MAAM,CAAC,WAAW;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,GAAG,GAAG,KAAK;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IAEF,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,52 @@
+export interface ChatMessage {
+    platform: string;
+    channelId: string;
+    conversationId: string;
+    messageId: string;
+    userId: string;
+    userName: string;
+    text: string;
+    timestamp: string;
+    isBot: boolean;
+    attachments?: ChatAttachment[];
+}
+export interface ChatAttachment {
+    type: string;
+    url: string;
+    content?: string;
+}
+export interface PlatformCapabilities {
+    nativeStreaming: boolean;
+    maxStreamUpdateHz: number;
+    supportsReactions: boolean;
+    supportsSlashCommands: boolean;
+    supportsThreads: boolean;
+    maxMessageLength: number;
+}
+export interface StreamHandle {
+    append(text: string): Promise<void>;
+    stop(finalText?: string): Promise<void>;
+}
+export interface ChatPlatform {
+    readonly name: string;
+    readonly capabilities: PlatformCapabilities;
+    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[]>;
+    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>;
+}
+export interface FeedbackSignal {
+    type: 'positive' | 'negative' | 'acknowledge' | 'save';
+    platform: string;
+    conversationId: string;
+    messageId: string;
+    userId: string;
+    userName: string;
+    timestamp: string;
+}

package/dist/lib/relay/platform.js

@@ -0,0 +1,5 @@
+// ── Chat Platform Abstraction ──
+// Platform-agnostic interface for bi-directional chat relay.
+// Slack and Telegram adapters implement this contract.
+export {};
+//# sourceMappingURL=platform.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../src/lib/relay/platform.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,6DAA6D;AAC7D,uDAAuD"}

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

@@ -0,0 +1,37 @@
+import type { ChatPlatform, ChatMessage, PlatformCapabilities, StreamHandle } from '../platform.js';
+export interface SlackAdapterConfig {
+    botToken: string;
+    appToken: string;
+    signingSecret: string;
+    mode: 'socket' | 'http';
+    port: number;
+    mainChannel?: string;
+}
+export declare class SlackAdapter implements ChatPlatform {
+    private config;
+    readonly name = "slack";
+    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 app;
+    private botUserId;
+    private userCache;
+    private reconnectBackoff;
+    private lastEventTime;
+    private healthTimer;
+    private processedRetries;
+    constructor(config: SlackAdapterConfig);
+    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 shouldSkipRetry;
+    private resolveUserName;
+    private slackEventToChatMessage;
+    private slackMsgToChatMessage;
+    private attemptReconnect;
+}