@kilnai/runtime 0.1.15 → 0.9.0

package/dist/channels/message-formatter.js

@@ -2,6 +2,10 @@
 // Single source of truth for adapting content to channel-specific formats
 /** WhatsApp Cloud API enforces a 4096-character limit per text message */
 const WHATSAPP_MAX_MESSAGE_LENGTH = 4096;
+/** Instagram Messaging API enforces a 1000-character limit per text message */
+const INSTAGRAM_MAX_MESSAGE_LENGTH = 1000;
+/** Messenger Send API enforces a 2000-character limit per text message */
+const MESSENGER_MAX_MESSAGE_LENGTH = 2000;
 /** Adapt content for a specific channel format */
 export function formatForChannel(content, format) {
     switch (format) {
@@ -33,6 +37,29 @@ export function formatForChannel(content, format) {
 export function toWhatsAppFormat(text) {
     return convertMarkdownToWhatsApp(text).slice(0, WHATSAPP_MAX_MESSAGE_LENGTH);
 }
+/**
+ * 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 function toInstagramFormat(text) {
+    return stripMarkdown(text).slice(0, INSTAGRAM_MAX_MESSAGE_LENGTH);
+}
+/**
+ * Convert content to Messenger-compatible plain text.
+ * Messenger supports plain text only (no markdown).
+ * Truncates to 2000-char API limit.
+ */
+export function toMessengerFormat(text) {
+    return stripMarkdown(text).slice(0, MESSENGER_MAX_MESSAGE_LENGTH);
+}
+/**
+ * Format content for email -- keep full markdown (email supports rich formatting).
+ * No character truncation (email has no message length limit).
+ */
+export function toEmailFormat(text) {
+    return text;
+}
 /** Strip basic markdown formatting for plain text channels */
 function stripMarkdown(text) {
     return text

package/dist/channels/message-formatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-formatter.js","sourceRoot":"","sources":["../../src/channels/message-formatter.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,0EAA0E;AAI1E,0EAA0E;AAC1E,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAqB;IACrE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,qDAAqD;YACrD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACtE,KAAK,MAAM;YACT,kCAAkC;YAClC,OAAO,OAAO,CAAC;QACjB,KAAK,YAAY;YACf,6CAA6C;YAC7C,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAC/E,CAAC;AAED,8DAA8D;AAC9D,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC,cAAc;SACzD,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,cAAc;SAC1C,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,OAAO;SACzC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS;SACvC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,UAAU;SAC/B,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,QAAQ;SAChD,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;AAC9C,CAAC;AAED,6EAA6E;AAC7E,yDAAyD;AACzD,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,SAAS,yBAAyB,CAAC,IAAY;IAC7C,OAAO,CACL,IAAI;QACF,+DAA+D;SAC9D,OAAO,CAAC,+BAA+B,EAAE,UAAU,CAAC;QACrD,mCAAmC;SAClC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC;QAClC,2EAA2E;SAC1E,OAAO,CAAC,kBAAkB,EAAE,GAAG,SAAS,KAAK,UAAU,EAAE,CAAC;QAC3D,2CAA2C;SAC1C,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,mDAAmD;SAClD,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;QACvC,mCAAmC;SAClC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,iDAAiD;SAChD,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,kCAAkC;SACjC,OAAO,CAAC,0BAA0B,EAAE,SAAS,CAAC;QAC/C,8CAA8C;SAC7C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"message-formatter.js","sourceRoot":"","sources":["../../src/channels/message-formatter.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,0EAA0E;AAI1E,0EAA0E;AAC1E,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C,0EAA0E;AAC1E,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAqB;IACrE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,qDAAqD;YACrD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QACtE,KAAK,MAAM;YACT,kCAAkC;YAClC,OAAO,OAAO,CAAC;QACjB,KAAK,YAAY;YACf,6CAA6C;YAC7C,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8DAA8D;AAC9D,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC,cAAc;SACzD,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,cAAc;SAC1C,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,OAAO;SACzC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,SAAS;SACvC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,UAAU;SAC/B,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,QAAQ;SAChD,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;AAC9C,CAAC;AAED,6EAA6E;AAC7E,yDAAyD;AACzD,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,SAAS,yBAAyB,CAAC,IAAY;IAC7C,OAAO,CACL,IAAI;QACF,+DAA+D;SAC9D,OAAO,CAAC,+BAA+B,EAAE,UAAU,CAAC;QACrD,mCAAmC;SAClC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC;QAClC,2EAA2E;SAC1E,OAAO,CAAC,kBAAkB,EAAE,GAAG,SAAS,KAAK,UAAU,EAAE,CAAC;QAC3D,2CAA2C;SAC1C,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,mDAAmD;SAClD,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC;QACvC,mCAAmC;SAClC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,iDAAiD;SAChD,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;QACrC,kCAAkC;SACjC,OAAO,CAAC,0BAA0B,EAAE,SAAS,CAAC;QAC/C,8CAA8C;SAC7C,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CACpC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+/** Messenger Graph API version */
+export declare const MESSENGER_GRAPH_API_VERSION = "v21.0";
+/** Build the Messenger Send API endpoint URL */
+export declare function messengerMessagesUrl(): string;
+/** Response from Messenger Send API */
+export interface MessengerSendResult {
+    readonly recipientId: string;
+    readonly messageId: string;
+}
+/**
+ * Send a text message via Messenger Send API.
+ *
+ * @param accessToken - Page access token
+ * @param recipientId - Page-scoped user ID (PSID)
+ * @param text - Message text (max 2000 chars)
+ */
+export declare function sendMessengerMessage(accessToken: string, recipientId: string, text: string): Promise<MessengerSendResult>;
+/**
+ * Send a media message (image) via Messenger Send API.
+ *
+ * @param accessToken - Page access token
+ * @param recipientId - Page-scoped user ID (PSID)
+ * @param mediaUrl - Public URL of the media
+ * @param mediaType - Type of media ("image")
+ */
+export declare function sendMessengerMediaMessage(accessToken: string, recipientId: string, mediaUrl: string, mediaType: "image"): Promise<MessengerSendResult>;
+//# sourceMappingURL=messenger-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-api.d.ts","sourceRoot":"","sources":["../../src/channels/messenger-api.ts"],"names":[],"mappings":"AAGA,kCAAkC;AAClC,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD,gDAAgD;AAChD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B"}

package/dist/channels/messenger-api.js

@@ -0,0 +1,75 @@
+// Facebook Messenger Send API client
+// Uses the Messenger Platform Graph API for page-scoped messaging
+/** Messenger Graph API version */
+export const MESSENGER_GRAPH_API_VERSION = "v21.0";
+/** Build the Messenger Send API endpoint URL */
+export function messengerMessagesUrl() {
+    return `https://graph.facebook.com/${MESSENGER_GRAPH_API_VERSION}/me/messages`;
+}
+/**
+ * Send a text message via Messenger Send API.
+ *
+ * @param accessToken - Page access token
+ * @param recipientId - Page-scoped user ID (PSID)
+ * @param text - Message text (max 2000 chars)
+ */
+export async function sendMessengerMessage(accessToken, recipientId, text) {
+    const res = await fetch(messengerMessagesUrl(), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({
+            messaging_type: "RESPONSE",
+            recipient: { id: recipientId },
+            message: { text },
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(unreadable)");
+        throw new Error(`Messenger 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 Messenger Send API.
+ *
+ * @param accessToken - Page access token
+ * @param recipientId - Page-scoped user ID (PSID)
+ * @param mediaUrl - Public URL of the media
+ * @param mediaType - Type of media ("image")
+ */
+export async function sendMessengerMediaMessage(accessToken, recipientId, mediaUrl, mediaType) {
+    const res = await fetch(messengerMessagesUrl(), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({
+            messaging_type: "RESPONSE",
+            recipient: { id: recipientId },
+            message: {
+                attachment: {
+                    type: mediaType,
+                    payload: { url: mediaUrl },
+                },
+            },
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "(unreadable)");
+        throw new Error(`Messenger API error ${res.status}: ${body}`);
+    }
+    const json = (await res.json());
+    return {
+        recipientId: json.recipient_id ?? recipientId,
+        messageId: json.message_id ?? "",
+    };
+}
+//# sourceMappingURL=messenger-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-api.js","sourceRoot":"","sources":["../../src/channels/messenger-api.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,kEAAkE;AAElE,kCAAkC;AAClC,MAAM,CAAC,MAAM,2BAA2B,GAAG,OAAO,CAAC;AAEnD,gDAAgD;AAChD,MAAM,UAAU,oBAAoB;IAClC,OAAO,8BAA8B,2BAA2B,cAAc,CAAC;AACjF,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,WAAmB,EACnB,IAAY;IAEZ,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,EAAE,EAAE;QAC9C,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,cAAc,EAAE,UAAU;YAC1B,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;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,WAAmB,EACnB,QAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,EAAE,EAAE;QAC9C,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,cAAc,EAAE,UAAU;YAC1B,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/messenger-channel.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-channel.d.ts","sourceRoot":"","sources":["../../src/channels/messenger-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,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/messenger-channel.js

@@ -0,0 +1,55 @@
+// MessengerChannel: Facebook Messenger Platform adapter
+// Uses Messenger Send API via shared API client
+import { extractText, textParts } from "@kilnai/core";
+import { toMessengerFormat } from "./message-formatter.js";
+import { sendMessengerMessage, sendMessengerMediaMessage } from "./messenger-api.js";
+/**
+ * Channel adapter for Facebook Messenger.
+ * receive() accepts parsed webhook messages from Messenger Platform.
+ * send() posts text/image messages via graph.facebook.com/me/messages.
+ * stream() sends each engine event as a summarized text message.
+ */
+export class MessengerChannel {
+    name = "messenger";
+    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 { accessToken } = this.config;
+        const to = response.target;
+        // Send image parts first
+        for (const part of response.parts) {
+            if (part.type === "image" && part.url) {
+                await sendMessengerMediaMessage(accessToken, to, part.url, "image");
+            }
+        }
+        // Send text content
+        const text = extractText(response.parts);
+        if (text) {
+            const formatted = toMessengerFormat(text);
+            await sendMessengerMessage(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=messenger-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messenger-channel.js","sourceRoot":"","sources":["../../src/channels/messenger-channel.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,gDAAgD;AAGhD,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;AAMrF;;;;;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,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACpC,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,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACtE,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,WAAW,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACzD,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/web-channel.d.ts

@@ -28,6 +28,8 @@ export declare class WebChannel implements Channel {
     receive(message: IncomingMessage): Promise<void>;
     send(response: OutgoingMessage): Promise<void>;
     stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+    /** Send a payload to all WebSocket clients for a given user/session */
+    sendToUser(userId: string, payload: string): void;
     /** Send to clients in a specific session */
     private sendToSession;
     /** Send to all clients across all sessions */

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

@@ -1 +1 @@
-{"version":3,"file":"web-channel.d.ts","sourceRoot":"","sources":["../../src/channels/web-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIpH,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAU;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAsC;IAEvF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,cAAc,CAAqD;IAE3E,yDAAyD;IACzD,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI5D,kDAAkD;IAClD,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IASrD,mEAAmE;IACnE,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAWrC,4DAA4D;IAC5D,IAAI,WAAW,IAAI,MAAM,CAMxB;IAEK,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;IAY/D,4CAA4C;IAC5C,OAAO,CAAC,aAAa;IAQrB,8CAA8C;IAC9C,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,OAAO;CAShB"}
+{"version":3,"file":"web-channel.d.ts","sourceRoot":"","sources":["../../src/channels/web-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIpH,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAU;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAsC;IAEvF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,cAAc,CAAqD;IAE3E,yDAAyD;IACzD,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI5D,kDAAkD;IAClD,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IASrD,mEAAmE;IACnE,YAAY,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAWrC,4DAA4D;IAC5D,IAAI,WAAW,IAAI,MAAM,CAMxB;IAEK,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;IAY/D,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjD,4CAA4C;IAC5C,OAAO,CAAC,aAAa;IAQrB,8CAA8C;IAC9C,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,OAAO;CAShB"}

package/dist/channels/web-channel.js

@@ -81,6 +81,15 @@ export class WebChannel {
             this.broadcastAll(payload);
         }
     }
+    /** Send a payload to all WebSocket clients for a given user/session */
+    sendToUser(userId, payload) {
+        const set = this.sessions.get(userId);
+        if (!set)
+            return;
+        for (const client of set) {
+            this.trySend(set, client, payload);
+        }
+    }
     /** Send to clients in a specific session */
     sendToSession(sessionId, payload) {
         const set = this.sessions.get(sessionId);

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

@@ -1 +1 @@
-{"version":3,"file":"web-channel.js","sourceRoot":"","sources":["../../src/channels/web-channel.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mFAAmF;AAGnF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ1D;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,KAAK,CAAC;IACb,aAAa,GAAkB,MAAM,CAAC;IACtC,mBAAmB,GAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEtE,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,cAAc,GAAgD,IAAI,CAAC;IAE3E,yDAAyD;IACzD,SAAS,CAAC,OAA2C;QACnD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,kDAAkD;IAClD,SAAS,CAAC,EAAiB,EAAE,SAAiB;QAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,mEAAmE;IACnE,YAAY,CAAC,EAAiB;QAC5B,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAClC,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,WAAW;QACb,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,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,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkC;QAC7C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,IAAI,EAAE,KAAK,CAAC,OAAO;gBACnB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,4CAA4C;IACpC,aAAa,CAAC,SAAiB,EAAE,OAAe;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,8CAA8C;IACtC,YAAY,CAAC,OAAe;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,KAAK,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,GAAuB,EAAE,MAAqB,EAAE,OAAe;QAC7E,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"web-channel.js","sourceRoot":"","sources":["../../src/channels/web-channel.ts"],"names":[],"mappings":"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"}

package/dist/enrichment/enrichment-runner.d.ts

@@ -0,0 +1,17 @@
+import type { ConversationEnricher, CompletedSession, EnrichmentStore } from "@kilnai/core";
+import type { ConversationEventEmitter } from "../gateway/conversation-event-emitter.js";
+export interface EnrichmentRunnerConfig {
+    readonly enricher: ConversationEnricher;
+    readonly store: EnrichmentStore;
+    readonly eventEmitter?: ConversationEventEmitter;
+    readonly timeoutMs?: number;
+}
+export declare class EnrichmentRunner {
+    private readonly config;
+    private readonly timeoutMs;
+    constructor(config: EnrichmentRunnerConfig);
+    /** Run enrichment for a completed session. Fire-and-forget. */
+    runPostConversation(session: CompletedSession): void;
+    private executeEnrichment;
+}
+//# sourceMappingURL=enrichment-runner.d.ts.map

package/dist/enrichment/enrichment-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment-runner.d.ts","sourceRoot":"","sources":["../../src/enrichment/enrichment-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAEzF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,sBAAsB;IAK1C,+DAA+D;IAC/D,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;YAMtC,iBAAiB;CAkChC"}

package/dist/enrichment/enrichment-runner.js

@@ -0,0 +1,45 @@
+export class EnrichmentRunner {
+    config;
+    timeoutMs;
+    constructor(config) {
+        this.config = config;
+        this.timeoutMs = config.timeoutMs ?? 10_000;
+    }
+    /** Run enrichment for a completed session. Fire-and-forget. */
+    runPostConversation(session) {
+        this.executeEnrichment(session).catch((err) => {
+            console.warn("[enrichment] Post-conversation enrichment failed:", err);
+        });
+    }
+    async executeEnrichment(session) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const enrichment = await Promise.race([
+                this.config.enricher.enrich(session),
+                new Promise((_, reject) => {
+                    controller.signal.addEventListener("abort", () => reject(new Error("Enrichment timeout")));
+                }),
+            ]);
+            if (enrichment) {
+                await this.config.store.save(enrichment);
+                // Emit CONVERSATION_ENRICHED conversation event
+                if (this.config.eventEmitter) {
+                    this.config.eventEmitter.emit({
+                        eventType: "CONVERSATION_ENRICHED",
+                        tenantId: session.tenantId,
+                        channel: "unknown",
+                        externalUserId: "",
+                        sessionId: session.sessionId,
+                        schemaVersion: "1",
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=enrichment-runner.js.map

package/dist/enrichment/enrichment-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment-runner.js","sourceRoot":"","sources":["../../src/enrichment/enrichment-runner.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAyB;IAC/B,SAAS,CAAS;IAEnC,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,CAAC;IAED,+DAA+D;IAC/D,mBAAmB,CAAC,OAAyB;QAC3C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC5C,OAAO,CAAC,IAAI,CAAC,mDAAmD,EAAE,GAAG,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,OAAyB;QACvD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;gBACpC,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC/B,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAC/C,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CACxC,CAAC;gBACJ,CAAC,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAEzC,gDAAgD;gBAChD,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAC7B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;wBAC5B,SAAS,EAAE,uBAAuB;wBAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,OAAO,EAAE,SAAS;wBAClB,cAAc,EAAE,EAAE;wBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,aAAa,EAAE,GAAG;wBAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/enrichment/sqlite-enrichment-store.d.ts

@@ -0,0 +1,14 @@
+import type { EnrichmentStore, ConversationEnrichment } from "@kilnai/core";
+export declare class SqliteEnrichmentStore implements EnrichmentStore {
+    private readonly db;
+    constructor(dbPath?: string);
+    save(enrichment: ConversationEnrichment): Promise<void>;
+    get(sessionId: string): Promise<ConversationEnrichment | undefined>;
+    listByTenant(tenantId: string, limit?: number, cursor?: string): Promise<{
+        readonly enrichments: readonly ConversationEnrichment[];
+        readonly nextCursor?: string;
+    }>;
+    delete(sessionId: string): Promise<boolean>;
+    close(): void;
+}
+//# sourceMappingURL=sqlite-enrichment-store.d.ts.map

package/dist/enrichment/sqlite-enrichment-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-enrichment-store.d.ts","sourceRoot":"","sources":["../../src/enrichment/sqlite-enrichment-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,cAAc,CAAC;AAGtB,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;gBAElB,MAAM,GAAE,MAAmB;IAkBjC,IAAI,CAAC,UAAU,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD,GAAG,CACP,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAUxC,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAK,EACV,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QACT,QAAQ,CAAC,WAAW,EAAE,SAAS,sBAAsB,EAAE,CAAC;QACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IA4BI,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAejD,KAAK,IAAI,IAAI;CAGd"}

package/dist/enrichment/sqlite-enrichment-store.js

@@ -0,0 +1,69 @@
+import { Database } from "bun:sqlite";
+export class SqliteEnrichmentStore {
+    db;
+    constructor(dbPath = ":memory:") {
+        this.db = new Database(dbPath);
+        this.db.exec("PRAGMA journal_mode=WAL;");
+        this.db.exec("PRAGMA busy_timeout=5000;");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS conversation_enrichments (
+        session_id TEXT PRIMARY KEY,
+        tenant_id TEXT NOT NULL,
+        enrichment_json TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_enrichments_tenant_created
+      ON conversation_enrichments (tenant_id, created_at);
+    `);
+    }
+    async save(enrichment) {
+        this.db
+            .prepare("INSERT OR REPLACE INTO conversation_enrichments (session_id, tenant_id, enrichment_json, created_at) VALUES (?, ?, ?, ?)")
+            .run(enrichment.sessionId, enrichment.tenantId, JSON.stringify(enrichment), enrichment.enrichedAt);
+    }
+    async get(sessionId) {
+        const row = this.db
+            .prepare("SELECT enrichment_json FROM conversation_enrichments WHERE session_id = ?")
+            .get(sessionId);
+        if (!row)
+            return undefined;
+        return JSON.parse(row.enrichment_json);
+    }
+    async listByTenant(tenantId, limit = 50, cursor) {
+        let rows;
+        if (cursor) {
+            rows = this.db
+                .prepare("SELECT enrichment_json FROM conversation_enrichments WHERE tenant_id = ? AND created_at < ? ORDER BY created_at DESC LIMIT ?")
+                .all(tenantId, cursor, limit + 1);
+        }
+        else {
+            rows = this.db
+                .prepare("SELECT enrichment_json FROM conversation_enrichments WHERE tenant_id = ? ORDER BY created_at DESC LIMIT ?")
+                .all(tenantId, limit + 1);
+        }
+        const hasMore = rows.length > limit;
+        const trimmed = hasMore ? rows.slice(0, limit) : rows;
+        const enrichments = trimmed.map((r) => JSON.parse(r.enrichment_json));
+        const nextCursor = hasMore
+            ? enrichments[enrichments.length - 1]?.enrichedAt
+            : undefined;
+        return { enrichments, nextCursor };
+    }
+    async delete(sessionId) {
+        const existing = this.db
+            .prepare("SELECT 1 FROM conversation_enrichments WHERE session_id = ?")
+            .get(sessionId);
+        if (!existing)
+            return false;
+        this.db
+            .prepare("DELETE FROM conversation_enrichments WHERE session_id = ?")
+            .run(sessionId);
+        return true;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-enrichment-store.js.map

package/dist/enrichment/sqlite-enrichment-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-enrichment-store.js","sourceRoot":"","sources":["../../src/enrichment/sqlite-enrichment-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,OAAO,qBAAqB;IACf,EAAE,CAAW;IAE9B,YAAY,SAAiB,UAAU;QACrC,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOZ,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;KAGZ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkC;QAC3C,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,0HAA0H,CAC3H;aACA,GAAG,CACF,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,QAAQ,EACnB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAC1B,UAAU,CAAC,UAAU,CACtB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CACP,SAAiB;QAEjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN,2EAA2E,CAC5E;aACA,GAAG,CAAC,SAAS,CAAuC,CAAC;QACxD,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAA2B,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,QAAgB,EAChB,KAAK,GAAG,EAAE,EACV,MAAe;QAKf,IAAI,IAAmC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,GAAG,IAAI,CAAC,EAAE;iBACX,OAAO,CACN,8HAA8H,CAC/H;iBACA,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,CAAkC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,EAAE;iBACX,OAAO,CACN,2GAA2G,CAC5G;iBACA,GAAG,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAkC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAA2B,CAC/D,CAAC;QACF,MAAM,UAAU,GAAG,OAAO;YACxB,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,UAAU;YACjD,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;aACrB,OAAO,CACN,6DAA6D,CAC9D;aACA,GAAG,CAAC,SAAS,CAAC,CAAC;QAClB,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5B,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,2DAA2D,CAC5D;aACA,GAAG,CAAC,SAAS,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/gateway/audio-preprocessor.d.ts

@@ -0,0 +1,11 @@
+import type { ContentPart, SttAdapter } from "@kilnai/core";
+export interface MediaDownloader {
+    download(url: string): Promise<{
+        data: Uint8Array;
+        mimeType: string;
+    }>;
+}
+export declare function createWhatsAppMediaDownloader(accessToken: string): MediaDownloader;
+export declare function createGenericMediaDownloader(): MediaDownloader;
+export declare function preprocessAudio(parts: readonly ContentPart[], stt: SttAdapter, downloader: MediaDownloader): Promise<readonly ContentPart[]>;
+//# sourceMappingURL=audio-preprocessor.d.ts.map

package/dist/gateway/audio-preprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-preprocessor.d.ts","sourceRoot":"","sources":["../../src/gateway/audio-preprocessor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAwBlF;AAED,wBAAgB,4BAA4B,IAAI,eAAe,CAY9D;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAuCjC"}

package/dist/gateway/audio-preprocessor.js

@@ -0,0 +1,76 @@
+// Audio preprocessor -- transcribes AudioParts to TextParts before orchestration
+export function createWhatsAppMediaDownloader(accessToken) {
+    return {
+        async download(url) {
+            // Step 1: Resolve media URL from Graph API (url is graph.facebook.com/.../mediaId)
+            const metaRes = await fetch(url, {
+                headers: { Authorization: `Bearer ${accessToken}` },
+            });
+            if (!metaRes.ok) {
+                throw new Error(`WhatsApp media metadata fetch failed: ${metaRes.status}`);
+            }
+            const meta = (await metaRes.json());
+            // Step 2: Download actual media binary
+            const mediaRes = await fetch(meta.url, {
+                headers: { Authorization: `Bearer ${accessToken}` },
+            });
+            if (!mediaRes.ok) {
+                throw new Error(`WhatsApp media download failed: ${mediaRes.status}`);
+            }
+            const buffer = await mediaRes.arrayBuffer();
+            return { data: new Uint8Array(buffer), mimeType: meta.mime_type };
+        },
+    };
+}
+export function createGenericMediaDownloader() {
+    return {
+        async download(url) {
+            const res = await fetch(url);
+            if (!res.ok) {
+                throw new Error(`Media download failed: ${res.status}`);
+            }
+            const buffer = await res.arrayBuffer();
+            const mimeType = res.headers.get("content-type") ?? "audio/ogg";
+            return { data: new Uint8Array(buffer), mimeType };
+        },
+    };
+}
+export async function preprocessAudio(parts, stt, downloader) {
+    const result = [];
+    for (const part of parts) {
+        if (part.type !== "audio") {
+            result.push(part);
+            continue;
+        }
+        try {
+            let data;
+            let mimeType;
+            if (part.url) {
+                const downloaded = await downloader.download(part.url);
+                data = downloaded.data;
+                mimeType = downloaded.mimeType;
+            }
+            else if (part.data) {
+                // Base64-encoded audio
+                const binary = atob(part.data);
+                const bytes = new Uint8Array(binary.length);
+                for (let i = 0; i < binary.length; i++) {
+                    bytes[i] = binary.charCodeAt(i);
+                }
+                data = bytes;
+                mimeType = part.mimeType;
+            }
+            else {
+                result.push({ type: "text", text: "[Voice note: transcription unavailable]" });
+                continue;
+            }
+            const transcription = await stt.transcribe(data, mimeType);
+            result.push({ type: "text", text: `[Voice note transcription]: ${transcription.text}` });
+        }
+        catch {
+            result.push({ type: "text", text: "[Voice note: transcription unavailable]" });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=audio-preprocessor.js.map

package/dist/gateway/audio-preprocessor.js.map

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

package/dist/gateway/auth-middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../src/gateway/auth-middleware.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQ/F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQjG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAetD;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAYlG"}
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../../src/gateway/auth-middleware.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQ/F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CASjG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAetD;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAYlG"}

package/dist/gateway/auth-middleware.js

@@ -1,13 +1,20 @@
 // Composable auth middleware for gateway routes
 // Each function returns a Hono middleware or utility for a specific auth mechanism
+import { timingSafeEqual } from "node:crypto";
 import { verifyHmacSha256 } from "../utils/hmac.js";
+/** Timing-safe string comparison. Returns false immediately for different lengths (safe — no content leak). */
+function safeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return timingSafeEqual(Buffer.from(a), Buffer.from(b));
+}
 /**
  * Require API key via X-Api-Key header. Returns 401 if missing or invalid.
  */
 export function requireApiKey(key) {
     return async (c, next) => {
         const provided = c.req.header("x-api-key");
-        if (!provided || provided !== key) {
+        if (!provided || !safeEqual(provided, key)) {
             return c.json({ error: "unauthorized", message: "Invalid or missing API key" }, 401);
         }
         return next();
@@ -19,7 +26,8 @@ export function requireApiKey(key) {
 export function requireBearer(token) {
     return async (c, next) => {
         const auth = c.req.header("authorization");
-        if (!auth || auth !== `Bearer ${token}`) {
+        const expected = `Bearer ${token}`;
+        if (!auth || !safeEqual(auth, expected)) {
             return c.json({ error: "unauthorized", message: "Invalid or missing Bearer token" }, 401);
         }
         return next();

package/dist/gateway/auth-middleware.js.map

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