@kilnai/runtime 0.1.15 → 0.9.0

package/README.md

@@ -18,7 +18,7 @@
 `@kilnai/runtime` is the production runtime for [Kiln](https://github.com/sequelcore/kiln). It turns your YAML-configured AI apps into a running server with:
 
 - **Multi-app gateway** -- host multiple Kiln apps in one Bun/Hono process
-- **5 channel adapters** -- Web (WebSocket), WhatsApp, Slack, REST API, CLI
+- **8 channel adapters** -- CLI, Web (WebSocket), WhatsApp, Instagram, Messenger, Slack, Email, REST API
 - **Multi-tenant isolation** -- per-tenant memory, system prompts, billing, and channel credentials
 - **Budget middleware** -- per-tenant token budgets with fail-open enforcement
 - **Trigger runtime** -- webhooks (HMAC-SHA256), event listeners, cron scheduler
@@ -86,10 +86,10 @@ await startDevServer("app.yaml", { port: 3000 });
 | Module | Exports |
 |--------|---------|
 | Gateway | `startGateway()`, `startDevServer()`, `createGatewayApp()`, `resolveApps()` |
-| Session | `ModeBOrchestrator`, `ModeBSession`, `SessionRegistry` |
+| Session | `ModeBOrchestrator`, `ModeBSession`, `SessionRegistry`, `SessionMode`, `SessionStore`, `InMemorySessionStore`, `RedisSessionStore`, `serializeSession`, `deserializeSession` |
 | Tenant | `TenantRegistry`, `buildTenantSystemPrompt()`, `extractSuggestions()` |
 | Triggers | `TriggerRegistry`, `createWebhookHandler()`, `EventListener`, `Scheduler` |
-| Channels | `WebChannel`, `WhatsAppChannel`, `SlackChannel`, `CliChannel`, `ApiChannel` |
+| Channels | `WebChannel`, `WhatsAppChannel`, `InstagramChannel`, `MessengerChannel`, `SlackChannel`, `EmailChannel`, `CliChannel`, `ApiChannel` |
 | Budget | `checkBudget()`, `reportUsage()` |
 
 ## Endpoints
@@ -105,6 +105,10 @@ When the gateway starts, it automatically mounts:
 | `POST /whatsapp/{name}/webhook` | WhatsApp webhook |
 | `POST /webhooks/{name}/{path}` | Webhook triggers |
 | `POST /admin/{name}/tenants` | Tenant CRUD (admin API) |
+| `POST /{path}/handoff` | Initiate handoff (transition to queued/human_active) |
+| `POST /{path}/release` | Release session back to ai_active |
+| `POST /{path}/operator-message` | Send operator message to end user |
+| `GET /{path}/session-history` | Retrieve full conversation history |
 | `GET /api/memory` | Memory read API |
 
 ## Documentation

package/dist/channels/email-api.d.ts

@@ -0,0 +1,29 @@
+/** Outbound email envelope */
+export interface OutboundEmail {
+    readonly from: string;
+    readonly fromName?: string;
+    readonly to: string;
+    readonly subject: string;
+    readonly htmlBody: string;
+    readonly textBody: string;
+    readonly inReplyTo?: string;
+    readonly references?: string;
+    readonly headers?: Record<string, string>;
+}
+/** Result of sending an email */
+export interface EmailSendResult {
+    readonly messageId: string;
+}
+/** Transport interface for sending emails */
+export interface EmailTransport {
+    send(email: OutboundEmail): Promise<EmailSendResult>;
+}
+/** Configuration for creating an email transport */
+export interface EmailTransportConfig {
+    readonly provider: "postmark" | "resend" | "sendgrid" | "generic";
+    readonly apiKey: string;
+    readonly endpoint?: string;
+}
+/** Create an email transport from configuration */
+export declare function createEmailTransport(config: EmailTransportConfig): EmailTransport;
+//# sourceMappingURL=email-api.d.ts.map

package/dist/channels/email-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-api.d.ts","sourceRoot":"","sources":["../../src/channels/email-api.ts"],"names":[],"mappings":"AAGA,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACtD;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAuHD,mDAAmD;AACnD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAYjF"}

package/dist/channels/email-api.js

@@ -0,0 +1,133 @@
+// Email transport abstraction with pluggable providers
+// Raw fetch only, no SDK dependencies
+/** Postmark transactional email transport */
+class PostmarkTransport {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async send(email) {
+        const from = email.fromName ? `${email.fromName} <${email.from}>` : email.from;
+        const headers = [
+            { Name: "Auto-Submitted", Value: "auto-generated" },
+            { Name: "X-Auto-Response-Suppress", Value: "OOF, AutoReply" },
+        ];
+        if (email.inReplyTo)
+            headers.push({ Name: "In-Reply-To", Value: email.inReplyTo });
+        if (email.references)
+            headers.push({ Name: "References", Value: email.references });
+        const res = await fetch("https://api.postmarkapp.com/email", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                "X-Postmark-Server-Token": this.apiKey,
+            },
+            body: JSON.stringify({
+                From: from,
+                To: email.to,
+                Subject: email.subject,
+                HtmlBody: email.htmlBody,
+                TextBody: email.textBody,
+                Headers: headers,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "(unreadable)");
+            throw new Error(`Postmark API error ${res.status}: ${body}`);
+        }
+        const json = (await res.json());
+        return { messageId: json.MessageID ?? "" };
+    }
+}
+/** Resend email transport */
+class ResendTransport {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async send(email) {
+        const from = email.fromName ? `${email.fromName} <${email.from}>` : email.from;
+        const headers = {
+            "Auto-Submitted": "auto-generated",
+            "X-Auto-Response-Suppress": "OOF, AutoReply",
+            ...email.headers,
+        };
+        if (email.inReplyTo)
+            headers["In-Reply-To"] = email.inReplyTo;
+        if (email.references)
+            headers["References"] = email.references;
+        const res = await fetch("https://api.resend.com/emails", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                from,
+                to: email.to,
+                subject: email.subject,
+                html: email.htmlBody,
+                text: email.textBody,
+                headers,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "(unreadable)");
+            throw new Error(`Resend API error ${res.status}: ${body}`);
+        }
+        const json = (await res.json());
+        return { messageId: json.id ?? "" };
+    }
+}
+/** Generic API email transport with configurable endpoint */
+class GenericApiTransport {
+    apiKey;
+    endpoint;
+    constructor(apiKey, endpoint) {
+        this.apiKey = apiKey;
+        this.endpoint = endpoint;
+    }
+    async send(email) {
+        const res = await fetch(this.endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                from: email.from,
+                fromName: email.fromName,
+                to: email.to,
+                subject: email.subject,
+                htmlBody: email.htmlBody,
+                textBody: email.textBody,
+                inReplyTo: email.inReplyTo,
+                references: email.references,
+                headers: email.headers,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "(unreadable)");
+            throw new Error(`Email API error ${res.status}: ${body}`);
+        }
+        const json = (await res.json());
+        return { messageId: json.messageId ?? "" };
+    }
+}
+/** Create an email transport from configuration */
+export function createEmailTransport(config) {
+    switch (config.provider) {
+        case "postmark":
+            return new PostmarkTransport(config.apiKey);
+        case "resend":
+            return new ResendTransport(config.apiKey);
+        case "sendgrid":
+            return new ResendTransport(config.apiKey); // SendGrid uses same Bearer auth pattern
+        case "generic":
+            if (!config.endpoint)
+                throw new Error("Generic email transport requires an endpoint");
+            return new GenericApiTransport(config.apiKey, config.endpoint);
+    }
+}
+//# sourceMappingURL=email-api.js.map

package/dist/channels/email-api.js.map

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

package/dist/channels/email-channel.d.ts

@@ -0,0 +1,26 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+import type { EmailTransport } from "./email-api.js";
+export interface EmailChannelConfig {
+    readonly transport: EmailTransport;
+    readonly fromAddress: string;
+    readonly fromName?: string;
+}
+/**
+ * Channel adapter for email.
+ * receive() accepts parsed inbound emails (from webhook providers).
+ * send() renders HTML + plain text and delivers via the configured transport.
+ * stream() buffers events and sends as a single email (email is non-streaming).
+ */
+export declare class EmailChannel implements Channel {
+    readonly name = "email";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly config;
+    private messageHandler;
+    constructor(config: EmailChannelConfig);
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+}
+//# sourceMappingURL=email-channel.d.ts.map

package/dist/channels/email-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-channel.d.ts","sourceRoot":"","sources":["../../src/channels/email-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAGpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAU;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAoB;IAErE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAAqD;gBAE/D,MAAM,EAAE,kBAAkB;IAItC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAItD,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAShE"}

package/dist/channels/email-channel.js

@@ -0,0 +1,59 @@
+// EmailChannel: Email adapter for AI-powered email replies
+// Uses pluggable EmailTransport for outbound delivery
+import { extractText, textParts } from "@kilnai/core";
+import { renderEmailHtml, renderEmailPlainText } from "./email-template.js";
+/**
+ * Channel adapter for email.
+ * receive() accepts parsed inbound emails (from webhook providers).
+ * send() renders HTML + plain text and delivers via the configured transport.
+ * stream() buffers events and sends as a single email (email is non-streaming).
+ */
+export class EmailChannel {
+    name = "email";
+    defaultFormat = "full";
+    supportedModalities = ["text", "file"];
+    config;
+    messageHandler = null;
+    constructor(config) {
+        this.config = config;
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        const text = extractText(response.parts);
+        if (!text)
+            return;
+        const to = response.metadata?.to;
+        const subject = response.metadata?.subject ?? "Re: Your message";
+        const inReplyTo = response.metadata?.inReplyTo;
+        const references = response.metadata?.references;
+        const branding = response.metadata?.branding;
+        const email = {
+            from: this.config.fromAddress,
+            fromName: this.config.fromName,
+            to: to ?? response.target,
+            subject,
+            htmlBody: renderEmailHtml(text, branding),
+            textBody: renderEmailPlainText(text),
+            inReplyTo,
+            references,
+        };
+        await this.config.transport.send(email);
+    }
+    async stream(events) {
+        for await (const event of events) {
+            await this.send({
+                parts: textParts(`[${event.type}] ${JSON.stringify(event.payload)}`),
+                target: "stream",
+                format: this.defaultFormat,
+            });
+        }
+    }
+}
+//# sourceMappingURL=email-channel.js.map

package/dist/channels/email-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-channel.js","sourceRoot":"","sources":["../../src/channels/email-channel.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,sDAAsD;AAGtD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAQ5E;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IACf,aAAa,GAAkB,MAAM,CAAC;IACtC,mBAAmB,GAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpD,MAAM,CAAqB;IACpC,cAAc,GAAgD,IAAI,CAAC;IAE3E,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,OAA2C;QACnD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAyB;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAwB,CAAC;QACvD,MAAM,OAAO,GAAI,QAAQ,CAAC,QAAQ,EAAE,OAA8B,IAAI,kBAAkB,CAAC;QACzF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAA+B,CAAC;QACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAgC,CAAC;QACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAA8C,CAAC;QAEnF,MAAM,KAAK,GAAkB;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,EAAE,EAAE,EAAE,IAAI,QAAQ,CAAC,MAAM;YACzB,OAAO;YACP,QAAQ,EAAE,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC;YACzC,QAAQ,EAAE,oBAAoB,CAAC,IAAI,CAAC;YACpC,SAAS;YACT,UAAU;SACX,CAAC;QAEF,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkC;QAC7C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpE,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,IAAI,CAAC,aAAa;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/channels/email-template.d.ts

@@ -0,0 +1,10 @@
+export interface EmailBranding {
+    readonly businessName?: string;
+    readonly primaryColor?: string;
+    readonly unsubscribeUrl?: string;
+}
+/** Render text content into a responsive HTML email template */
+export declare function renderEmailHtml(text: string, branding?: EmailBranding): string;
+/** Render text as a plain text email body, stripping markdown */
+export declare function renderEmailPlainText(text: string): string;
+//# sourceMappingURL=email-template.d.ts.map

package/dist/channels/email-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-template.d.ts","sourceRoot":"","sources":["../../src/channels/email-template.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CA6B9E;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/channels/email-template.js

@@ -0,0 +1,63 @@
+// Email HTML template rendering with inline CSS
+// Produces responsive, client-safe HTML for email delivery
+/** Render text content into a responsive HTML email template */
+export function renderEmailHtml(text, branding) {
+    const primaryColor = branding?.primaryColor ?? "#333333";
+    const fontStack = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";
+    const header = branding?.businessName
+        ? `<tr><td style="padding:24px 32px 16px;background:${primaryColor};color:#ffffff;font-family:${fontStack};font-size:18px;font-weight:600;border-radius:8px 8px 0 0;">${escapeHtml(branding.businessName)}</td></tr>`
+        : "";
+    const topRadius = branding?.businessName ? "0" : "8px";
+    const footer = branding?.unsubscribeUrl
+        ? `<tr><td style="padding:16px 32px;text-align:center;font-family:${fontStack};font-size:12px;color:#999999;"><a href="${escapeHtml(branding.unsubscribeUrl)}" style="color:#999999;text-decoration:underline;">Unsubscribe</a></td></tr>`
+        : "";
+    const bodyHtml = textToHtml(text);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"></head>
+<body style="margin:0;padding:0;background:#f4f4f7;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f4f4f7;padding:32px 16px;">
+<tr><td align="center">
+<table role="presentation" width="600" cellpadding="0" cellspacing="0" style="max-width:600px;width:100%;background:#ffffff;border-radius:8px;box-shadow:0 1px 3px rgba(0,0,0,0.08);">
+${header}<tr><td style="padding:24px 32px;font-family:${fontStack};font-size:15px;line-height:1.6;color:#333333;border-radius:${topRadius} ${topRadius} 0 0;">${bodyHtml}</td></tr>
+${footer}</table>
+</td></tr>
+</table>
+</body>
+</html>`;
+}
+/** Render text as a plain text email body, stripping markdown */
+export function renderEmailPlainText(text) {
+    return stripMarkdown(text);
+}
+/** Convert newlines to HTML, wrapping in paragraphs */
+function textToHtml(text) {
+    const paragraphs = text.split(/\n{2,}/);
+    return paragraphs
+        .map((p) => {
+        const inner = escapeHtml(p.trim()).replace(/\n/g, "<br>");
+        return `<p style="margin:0 0 16px 0;">${inner}</p>`;
+    })
+        .filter((p) => p !== '<p style="margin:0 0 16px 0;"></p>')
+        .join("\n");
+}
+/** Escape HTML special characters */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Strip basic markdown formatting for plain text */
+function stripMarkdown(text) {
+    return text
+        .replace(/```[\s\S]*?```/g, "[code block]")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/\*([^*]+)\*/g, "$1")
+        .replace(/#+\s/g, "")
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+        .replace(/^[-*]\s/gm, "- ");
+}
+//# sourceMappingURL=email-template.js.map

package/dist/channels/email-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-template.js","sourceRoot":"","sources":["../../src/channels/email-template.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,2DAA2D;AAQ3D,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAwB;IACpE,MAAM,YAAY,GAAG,QAAQ,EAAE,YAAY,IAAI,SAAS,CAAC;IACzD,MAAM,SAAS,GAAG,qFAAqF,CAAC;IAExG,MAAM,MAAM,GAAG,QAAQ,EAAE,YAAY;QACnC,CAAC,CAAC,oDAAoD,YAAY,8BAA8B,SAAS,+DAA+D,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY;QACrN,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,SAAS,GAAG,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IAEvD,MAAM,MAAM,GAAG,QAAQ,EAAE,cAAc;QACrC,CAAC,CAAC,kEAAkE,SAAS,4CAA4C,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,8EAA8E;QAC1O,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO;;;;;;;EAOP,MAAM,gDAAgD,SAAS,+DAA+D,SAAS,IAAI,SAAS,UAAU,QAAQ;EACtK,MAAM;;;;QAIA,CAAC;AACT,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,uDAAuD;AACvD,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,iCAAiC,KAAK,MAAM,CAAC;IACtD,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,oCAAoC,CAAC;SACzD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,qCAAqC;AACrC,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,qDAAqD;AACrD,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC;SAC1C,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC;SACjC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/channels/instagram-api.d.ts

@@ -0,0 +1,29 @@
+/** Instagram/Meta Graph API version */
+export declare const INSTAGRAM_GRAPH_API_VERSION = "v21.0";
+/** Build the Instagram Graph API messages endpoint URL */
+export declare function instagramMessagesUrl(pageId: string): string;
+/** Response from Instagram messaging API */
+export interface InstagramSendResult {
+    readonly recipientId: string;
+    readonly messageId: string;
+}
+/**
+ * Send a text message via Instagram Messaging API.
+ *
+ * @param pageId - The Instagram-connected Page ID
+ * @param accessToken - Page access token
+ * @param recipientId - Instagram-scoped user ID (IGSID)
+ * @param text - Message text (max 1000 chars)
+ */
+export declare function sendInstagramMessage(pageId: string, accessToken: string, recipientId: string, text: string): Promise<InstagramSendResult>;
+/**
+ * Send a media message (image) via Instagram Messaging API.
+ *
+ * @param pageId - The Instagram-connected Page ID
+ * @param accessToken - Page access token
+ * @param recipientId - Instagram-scoped user ID (IGSID)
+ * @param mediaUrl - Public URL of the media
+ * @param mediaType - Type of media ("image")
+ */
+export declare function sendInstagramMediaMessage(pageId: string, accessToken: string, recipientId: string, mediaUrl: string, mediaType: "image"): Promise<InstagramSendResult>;
+//# sourceMappingURL=instagram-api.d.ts.map

package/dist/channels/instagram-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-api.d.ts","sourceRoot":"","sources":["../../src/channels/instagram-api.ts"],"names":[],"mappings":"AAGA,uCAAuC;AACvC,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,mBAAmB,CAAC,CA4B9B"}

package/dist/channels/instagram-api.js

@@ -0,0 +1,75 @@
+// Instagram Messaging API client
+// Uses the Instagram Graph API (same version as WhatsApp) for DM replies
+/** Instagram/Meta Graph API version */
+export const INSTAGRAM_GRAPH_API_VERSION = "v21.0";
+/** Build the Instagram Graph API messages endpoint URL */
+export function instagramMessagesUrl(pageId) {
+    return `https://graph.facebook.com/${INSTAGRAM_GRAPH_API_VERSION}/${pageId}/messages`;
+}
+/**
+ * Send a text message via Instagram Messaging API.
+ *
+ * @param pageId - The Instagram-connected Page ID
+ * @param accessToken - Page access token
+ * @param recipientId - Instagram-scoped user ID (IGSID)
+ * @param text - Message text (max 1000 chars)
+ */
+export async function sendInstagramMessage(pageId, accessToken, recipientId, text) {
+    const res = await fetch(instagramMessagesUrl(pageId), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({
+            recipient: { id: recipientId },
+            message: { text },
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(unreadable)");
+        throw new Error(`Instagram API error ${res.status}: ${body}`);
+    }
+    const json = (await res.json());
+    return {
+        recipientId: json.recipient_id ?? recipientId,
+        messageId: json.message_id ?? "",
+    };
+}
+/**
+ * Send a media message (image) via Instagram Messaging API.
+ *
+ * @param pageId - The Instagram-connected Page ID
+ * @param accessToken - Page access token
+ * @param recipientId - Instagram-scoped user ID (IGSID)
+ * @param mediaUrl - Public URL of the media
+ * @param mediaType - Type of media ("image")
+ */
+export async function sendInstagramMediaMessage(pageId, accessToken, recipientId, mediaUrl, mediaType) {
+    const res = await fetch(instagramMessagesUrl(pageId), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({
+            recipient: { id: recipientId },
+            message: {
+                attachment: {
+                    type: mediaType,
+                    payload: { url: mediaUrl },
+                },
+            },
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(unreadable)");
+        throw new Error(`Instagram API error ${res.status}: ${body}`);
+    }
+    const json = (await res.json());
+    return {
+        recipientId: json.recipient_id ?? recipientId,
+        messageId: json.message_id ?? "",
+    };
+}
+//# sourceMappingURL=instagram-api.js.map

package/dist/channels/instagram-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-api.js","sourceRoot":"","sources":["../../src/channels/instagram-api.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yEAAyE;AAEzE,uCAAuC;AACvC,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,8BAA8B,2BAA2B,IAAI,MAAM,WAAW,CAAC;AACxF,CAAC;AAQD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,WAAmB,EACnB,WAAmB,EACnB,IAAY;IAEZ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE;QACpD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,WAAW,EAAE;SACvC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE;YAC9B,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmD,CAAC;IAClF,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,YAAY,IAAI,WAAW;QAC7C,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAc,EACd,WAAmB,EACnB,WAAmB,EACnB,QAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE;QACpD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,WAAW,EAAE;SACvC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE;YAC9B,OAAO,EAAE;gBACP,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;iBAC3B;aACF;SACF,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmD,CAAC;IAClF,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,YAAY,IAAI,WAAW;QAC7C,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC"}

package/dist/channels/instagram-channel.d.ts

@@ -0,0 +1,24 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+export interface InstagramConfig {
+    readonly pageId: string;
+    readonly accessToken: string;
+}
+/**
+ * Channel adapter for Instagram DM API.
+ * receive() accepts parsed webhook messages from Instagram.
+ * send() posts text/image messages via graph.facebook.com.
+ * stream() sends each engine event as a summarized text message.
+ */
+export declare class InstagramChannel implements Channel {
+    readonly name = "instagram";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly config;
+    private messageHandler;
+    constructor(config: InstagramConfig);
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+}
+//# sourceMappingURL=instagram-channel.d.ts.map

package/dist/channels/instagram-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-channel.d.ts","sourceRoot":"","sources":["../../src/channels/instagram-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKpH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,OAAO;IAC9C,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAW;IAChD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAqB;IAEtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAqD;gBAE/D,MAAM,EAAE,eAAe;IAInC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAItD,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAShE"}

package/dist/channels/instagram-channel.js

@@ -0,0 +1,55 @@
+// InstagramChannel: Instagram DM API adapter
+// Uses Instagram Graph API via shared API client
+import { extractText, textParts } from "@kilnai/core";
+import { toInstagramFormat } from "./message-formatter.js";
+import { sendInstagramMessage, sendInstagramMediaMessage } from "./instagram-api.js";
+/**
+ * Channel adapter for Instagram DM API.
+ * receive() accepts parsed webhook messages from Instagram.
+ * send() posts text/image messages via graph.facebook.com.
+ * stream() sends each engine event as a summarized text message.
+ */
+export class InstagramChannel {
+    name = "instagram";
+    defaultFormat = "short";
+    supportedModalities = ["text", "image"];
+    config;
+    messageHandler = null;
+    constructor(config) {
+        this.config = config;
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        const { pageId, accessToken } = this.config;
+        const to = response.target;
+        // Send image parts first
+        for (const part of response.parts) {
+            if (part.type === "image" && part.url) {
+                await sendInstagramMediaMessage(pageId, accessToken, to, part.url, "image");
+            }
+        }
+        // Send text content
+        const text = extractText(response.parts);
+        if (text) {
+            const formatted = toInstagramFormat(text);
+            await sendInstagramMessage(pageId, accessToken, to, formatted);
+        }
+    }
+    async stream(events) {
+        for await (const event of events) {
+            await this.send({
+                parts: textParts(`[${event.type}] ${JSON.stringify(event.payload)}`),
+                target: "stream",
+                format: this.defaultFormat,
+            });
+        }
+    }
+}
+//# sourceMappingURL=instagram-channel.js.map

package/dist/channels/instagram-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-channel.js","sourceRoot":"","sources":["../../src/channels/instagram-channel.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,iDAAiD;AAGjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAOrF;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,WAAW,CAAC;IACnB,aAAa,GAAkB,OAAO,CAAC;IACvC,mBAAmB,GAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,CAAkB;IACjC,cAAc,GAAgD,IAAI,CAAC;IAE3E,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,OAA2C;QACnD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAyB;QAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC;QAE3B,yBAAyB;QACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACtC,MAAM,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkC;QAC7C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,IAAI,CAAC;gBACd,KAAK,EAAE,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpE,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,IAAI,CAAC,aAAa;aAC3B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/channels/message-formatter.d.ts

@@ -14,4 +14,21 @@ export declare function formatForChannel(content: string, format: MessageFormat)
  * truncates to the 4096-char Cloud API limit.
  */
 export declare function toWhatsAppFormat(text: string): string;
+/**
+ * Convert content to Instagram-compatible plain text.
+ * Instagram DM API supports plain text only (no markdown, no formatting).
+ * Truncates to 1000-char API limit.
+ */
+export declare function toInstagramFormat(text: string): string;
+/**
+ * Convert content to Messenger-compatible plain text.
+ * Messenger supports plain text only (no markdown).
+ * Truncates to 2000-char API limit.
+ */
+export declare function toMessengerFormat(text: string): string;
+/**
+ * Format content for email -- keep full markdown (email supports rich formatting).
+ * No character truncation (email has no message length limit).
+ */
+export declare function toEmailFormat(text: string): string;
 //# sourceMappingURL=message-formatter.d.ts.map

package/dist/channels/message-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../src/channels/message-formatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAc/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../src/channels/message-formatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAWlD,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAc/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}