@kilnai/runtime 0.1.1

package/dist/channels/event-bridge.js

@@ -0,0 +1,83 @@
+// EventBridge: converts EventBus synchronous push -> AsyncIterable pull
+// Bridges KilnEvent (orchestrator internal) to EngineEvent (channel primitive)
+import { EVENT_LEVEL_MAP, LEVEL_HIERARCHY } from "@kilnai/core";
+/** Convert a KilnEvent to an EngineEvent for channel consumption */
+export function toEngineEvent(event) {
+    const { type, timestamp, sessionId, ...rest } = event;
+    return {
+        type,
+        timestamp,
+        payload: { sessionId, ...rest },
+    };
+}
+/**
+ * Bridge between EventBus (synchronous push) and Channel.stream() (AsyncIterable pull).
+ * Subscribes to EventBus.onAny(), converts events, and yields them as an async generator.
+ * Bounded queue prevents unbounded memory growth if consumer is slower than producer.
+ */
+export class EventBridge {
+    queue = [];
+    maxQueueSize;
+    resolve = null;
+    done = false;
+    unsubscribe = null;
+    constructor(maxQueueSize = 1000) {
+        this.maxQueueSize = maxQueueSize;
+    }
+    /**
+     * Subscribe to an EventBus and start bridging events.
+     * If level is provided, only events matching that level or coarser are bridged.
+     */
+    connect(eventBus, level) {
+        const handler = (event) => {
+            if (this.done)
+                return;
+            if (level) {
+                const eventLevel = EVENT_LEVEL_MAP[event.type];
+                const allowedLevels = LEVEL_HIERARCHY[level];
+                if (!allowedLevels.includes(eventLevel)) {
+                    return;
+                }
+            }
+            const engineEvent = toEngineEvent(event);
+            if (this.queue.length < this.maxQueueSize) {
+                this.queue.push(engineEvent);
+            }
+            // Wake up the async generator if it's waiting
+            if (this.resolve) {
+                this.resolve();
+                this.resolve = null;
+            }
+        };
+        eventBus.onAny(handler);
+        this.unsubscribe = () => eventBus.offAny(handler);
+    }
+    /** Stop bridging and signal the async generator to complete */
+    disconnect() {
+        this.done = true;
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        // Wake up pending consumer so it can exit
+        if (this.resolve) {
+            this.resolve();
+            this.resolve = null;
+        }
+    }
+    /** Async generator that yields EngineEvents as they arrive */
+    async *events() {
+        while (!this.done || this.queue.length > 0) {
+            if (this.queue.length > 0) {
+                yield this.queue.shift();
+            }
+            else if (!this.done) {
+                // Wait for next event or disconnect
+                await new Promise((r) => {
+                    this.resolve = r;
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/channels/event-bridge.js.map

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

package/dist/channels/index.d.ts

@@ -0,0 +1,17 @@
+export { EventBridge, toEngineEvent } from "./event-bridge.js";
+export { ChannelRegistry } from "./channel-registry.js";
+export { formatForChannel } from "./message-formatter.js";
+export type { ChannelConfig, ChannelStatus, IdentityMapping, IdentityResolver } from "./types.js";
+export { InMemoryIdentityResolver } from "./types.js";
+export { CliChannel } from "./cli-channel.js";
+export { WebChannel } from "./web-channel.js";
+export type { WebSocketLike } from "./web-channel.js";
+export { ChannelRouter } from "./channel-router.js";
+export type { RouteResult, ChannelRouterRule } from "./channel-router.js";
+export { WhatsAppChannel } from "./whatsapp-channel.js";
+export type { WhatsAppConfig } from "./whatsapp-channel.js";
+export { SlackChannel } from "./slack-channel.js";
+export type { SlackConfig } from "./slack-channel.js";
+export { ApiChannel } from "./api-channel.js";
+export type { SseWriter } from "./api-channel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/channels/index.js

@@ -0,0 +1,12 @@
+// Channel adapters -- multi-platform message delivery
+export { EventBridge, toEngineEvent } from "./event-bridge.js";
+export { ChannelRegistry } from "./channel-registry.js";
+export { formatForChannel } from "./message-formatter.js";
+export { InMemoryIdentityResolver } from "./types.js";
+export { CliChannel } from "./cli-channel.js";
+export { WebChannel } from "./web-channel.js";
+export { ChannelRouter } from "./channel-router.js";
+export { WhatsAppChannel } from "./whatsapp-channel.js";
+export { SlackChannel } from "./slack-channel.js";
+export { ApiChannel } from "./api-channel.js";
+//# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { MessageFormat } from "@kilnai/core";
+/** Adapt content for a specific channel format */
+export declare function formatForChannel(content: string, format: MessageFormat): string;
+//# sourceMappingURL=message-formatter.d.ts.map

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

@@ -0,0 +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"}

package/dist/channels/message-formatter.js

@@ -0,0 +1,32 @@
+// MessageFormatter: unified channel output formatting
+// 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;
+/** Adapt content for a specific channel format */
+export function formatForChannel(content, format) {
+    switch (format) {
+        case "short":
+            // Strip markdown, truncate for messaging platforms (WhatsApp, SMS)
+            return stripMarkdown(content).slice(0, WHATSAPP_MAX_MESSAGE_LENGTH);
+        case "full":
+            // Keep full markdown (web, Slack)
+            return content;
+        case "structured":
+            // Return as-is (REST API consumers parse it)
+            return content;
+        default:
+            return content;
+    }
+}
+/** Strip basic markdown formatting for plain text channels */
+function stripMarkdown(text) {
+    return text
+        .replace(/```[\s\S]*?```/g, "[code block]") // code blocks
+        .replace(/`([^`]+)`/g, "$1") // inline code
+        .replace(/\*\*([^*]+)\*\*/g, "$1") // bold
+        .replace(/\*([^*]+)\*/g, "$1") // italic
+        .replace(/#+\s/g, "") // headers
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // links
+        .replace(/^[-*]\s/gm, "- "); // list items
+}
+//# sourceMappingURL=message-formatter.js.map

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

@@ -0,0 +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,mEAAmE;YACnE,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,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"}

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

@@ -0,0 +1,32 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+export interface SlackConfig {
+    readonly botToken: string;
+    readonly signingSecret: string;
+}
+/**
+ * Channel adapter for Slack Bot Events API + Web API.
+ * receive() accepts parsed event payloads from Slack Events API.
+ * send() posts messages via chat.postMessage with optional thread_ts.
+ * stream() posts each engine event as a message.
+ * verifyRequest() validates Slack request signatures using HMAC-SHA256.
+ */
+export declare class SlackChannel implements Channel {
+    readonly name = "slack";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly config;
+    private messageHandler;
+    constructor(config: SlackConfig);
+    /** Register a handler for incoming messages (from parsed Slack event payloads) */
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+    /**
+     * Verify a Slack request signature.
+     * Computes HMAC-SHA256 of "v0:{timestamp}:{body}" with the signing secret
+     * and compares it to the provided signature using a timing-safe comparison.
+     */
+    verifyRequest(timestamp: string, body: string, signature: string): boolean;
+}
+//# sourceMappingURL=slack-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack-channel.d.ts","sourceRoot":"","sources":["../../src/channels/slack-channel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAKpH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;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,CAA6B;IAE9E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,cAAc,CAAqD;gBAE/D,MAAM,EAAE,WAAW;IAI/B,kFAAkF;IAClF,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;IAuB9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAK3E"}

package/dist/channels/slack-channel.js

@@ -0,0 +1,71 @@
+// SlackChannel: Slack Bot Events API + Web API adapter
+// Uses Slack Web API (slack.com/api) via native fetch -- no SDK dependency
+// Request signature verification uses shared HMAC-SHA256 utility
+import { extractText, textParts } from "@kilnai/core";
+import { formatForChannel } from "./message-formatter.js";
+import { verifyHmacSha256 } from "../utils/hmac.js";
+/**
+ * Channel adapter for Slack Bot Events API + Web API.
+ * receive() accepts parsed event payloads from Slack Events API.
+ * send() posts messages via chat.postMessage with optional thread_ts.
+ * stream() posts each engine event as a message.
+ * verifyRequest() validates Slack request signatures using HMAC-SHA256.
+ */
+export class SlackChannel {
+    name = "slack";
+    defaultFormat = "full";
+    supportedModalities = ["text", "image", "file"];
+    config;
+    messageHandler = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Register a handler for incoming messages (from parsed Slack event payloads) */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        const text = extractText(response.parts);
+        const formatted = formatForChannel(text, response.format ?? this.defaultFormat);
+        const body = {
+            channel: response.target,
+            text: formatted,
+        };
+        if (response.threadId !== undefined) {
+            body.thread_ts = response.threadId;
+        }
+        await fetch("https://slack.com/api/chat.postMessage", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.config.botToken}`,
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    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,
+            });
+        }
+    }
+    /**
+     * Verify a Slack request signature.
+     * Computes HMAC-SHA256 of "v0:{timestamp}:{body}" with the signing secret
+     * and compares it to the provided signature using a timing-safe comparison.
+     */
+    verifyRequest(timestamp, body, signature) {
+        const payload = `v0:${timestamp}:${body}`;
+        const sig = signature.startsWith("v0=") ? signature.slice(3) : signature;
+        return verifyHmacSha256(this.config.signingSecret, payload, sig);
+    }
+}
+//# sourceMappingURL=slack-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack-channel.js","sourceRoot":"","sources":["../../src/channels/slack-channel.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,2EAA2E;AAC3E,iEAAiE;AAGjE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IACf,aAAa,GAAkB,MAAM,CAAC;IACtC,mBAAmB,GAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE7D,MAAM,CAAc;IAC7B,cAAc,GAAgD,IAAI,CAAC;IAE3E,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,kFAAkF;IAClF,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,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC;QAEhF,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,QAAQ,CAAC,MAAM;YACxB,IAAI,EAAE,SAAS;SAChB,CAAC;QAEF,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACrC,CAAC;QAED,MAAM,KAAK,CAAC,wCAAwC,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;aAChD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,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;IAED;;;;OAIG;IACH,aAAa,CAAC,SAAiB,EAAE,IAAY,EAAE,SAAiB;QAC9D,MAAM,OAAO,GAAG,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/channels/types.d.ts

@@ -0,0 +1,27 @@
+import type { MessageFormat } from "@kilnai/core";
+/** Configuration for a channel adapter */
+export interface ChannelConfig {
+    readonly name: string;
+    readonly defaultFormat: MessageFormat;
+    readonly maxMessageLength?: number;
+    readonly rateLimitPerMinute?: number;
+}
+/** Runtime status of a channel adapter */
+export type ChannelStatus = "connected" | "disconnected" | "error";
+/** Maps a platform-specific user ID to an engine user ID */
+export interface IdentityMapping {
+    readonly platformUserId: string;
+    readonly channelName: string;
+    readonly engineUserId: string;
+}
+/** Resolves platform user identities to engine user IDs */
+export interface IdentityResolver {
+    resolve(channelName: string, platformUserId: string): Promise<string | null>;
+}
+/** In-memory identity resolver for development and testing */
+export declare class InMemoryIdentityResolver implements IdentityResolver {
+    private readonly mappings;
+    addMapping(channelName: string, platformUserId: string, engineUserId: string): void;
+    resolve(channelName: string, platformUserId: string): Promise<string | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,0CAA0C;AAC1C,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED,8DAA8D;AAC9D,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI7E,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGnF"}

package/dist/channels/types.js

@@ -0,0 +1,12 @@
+// Channel adapter types: configuration, status, and identity mapping
+/** In-memory identity resolver for development and testing */
+export class InMemoryIdentityResolver {
+    mappings = new Map();
+    addMapping(channelName, platformUserId, engineUserId) {
+        this.mappings.set(`${channelName}:${platformUserId}`, engineUserId);
+    }
+    async resolve(channelName, platformUserId) {
+        return this.mappings.get(`${channelName}:${platformUserId}`) ?? null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AA2BrE,8DAA8D;AAC9D,MAAM,OAAO,wBAAwB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD,UAAU,CAAC,WAAmB,EAAE,cAAsB,EAAE,YAAoB;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,IAAI,cAAc,EAAE,EAAE,YAAY,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,cAAsB;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC,IAAI,IAAI,CAAC;IACvE,CAAC;CACF"}

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

@@ -0,0 +1,37 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+/** Minimal WebSocket interface (compatible with Hono WSContext) */
+export interface WebSocketLike {
+    send(data: string): void;
+    readonly readyState: number;
+}
+/**
+ * Channel adapter for WebSocket connections.
+ * Clients are tracked per sessionId for targeted delivery.
+ * send()  -- delivers to the session matching response.userId, or all sessions if absent.
+ * stream() -- always broadcasts to all sessions (engine events are global).
+ * receive() -- delegates to the registered onMessage handler.
+ */
+export declare class WebChannel implements Channel {
+    readonly name = "web";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly sessions;
+    private messageHandler;
+    /** Register a handler for incoming WebSocket messages */
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    /** Add a WebSocket client to the given session */
+    addClient(ws: WebSocketLike, sessionId: string): void;
+    /** Remove a WebSocket client from whichever session contains it */
+    removeClient(ws: WebSocketLike): void;
+    /** Total number of connected clients across all sessions */
+    get clientCount(): number;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+    /** Send to clients in a specific session */
+    private sendToSession;
+    /** Send to all clients across all sessions */
+    private broadcastAll;
+    private trySend;
+}
+//# sourceMappingURL=web-channel.d.ts.map

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

@@ -0,0 +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"}

package/dist/channels/web-channel.js

@@ -0,0 +1,112 @@
+// WebChannel: wraps Hono WebSocket connections as a Channel adapter
+// Session-scoped delivery: send() targets a session by userId, stream() is global.
+import { extractText } from "@kilnai/core";
+import { formatForChannel } from "./message-formatter.js";
+/**
+ * Channel adapter for WebSocket connections.
+ * Clients are tracked per sessionId for targeted delivery.
+ * send()  -- delivers to the session matching response.userId, or all sessions if absent.
+ * stream() -- always broadcasts to all sessions (engine events are global).
+ * receive() -- delegates to the registered onMessage handler.
+ */
+export class WebChannel {
+    name = "web";
+    defaultFormat = "full";
+    supportedModalities = ["text", "image", "audio", "file"];
+    sessions = new Map();
+    messageHandler = null;
+    /** Register a handler for incoming WebSocket messages */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /** Add a WebSocket client to the given session */
+    addClient(ws, sessionId) {
+        let set = this.sessions.get(sessionId);
+        if (!set) {
+            set = new Set();
+            this.sessions.set(sessionId, set);
+        }
+        set.add(ws);
+    }
+    /** Remove a WebSocket client from whichever session contains it */
+    removeClient(ws) {
+        for (const [sessionId, set] of this.sessions) {
+            if (set.delete(ws)) {
+                if (set.size === 0) {
+                    this.sessions.delete(sessionId);
+                }
+                return;
+            }
+        }
+    }
+    /** Total number of connected clients across all sessions */
+    get clientCount() {
+        let total = 0;
+        for (const set of this.sessions.values()) {
+            total += set.size;
+        }
+        return total;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        const text = extractText(response.parts);
+        const formatted = formatForChannel(text, response.format ?? this.defaultFormat);
+        const payload = JSON.stringify({
+            type: "output",
+            text: formatted,
+            parts: response.parts,
+            target: response.target,
+            userId: response.userId,
+            threadId: response.threadId,
+        });
+        if (response.userId) {
+            this.sendToSession(response.userId, payload);
+        }
+        else {
+            this.broadcastAll(payload);
+        }
+    }
+    async stream(events) {
+        for await (const event of events) {
+            const payload = JSON.stringify({
+                type: "event",
+                event: event.type,
+                data: event.payload,
+                timestamp: event.timestamp,
+            });
+            this.broadcastAll(payload);
+        }
+    }
+    /** Send to clients in a specific session */
+    sendToSession(sessionId, payload) {
+        const set = this.sessions.get(sessionId);
+        if (!set)
+            return;
+        for (const client of set) {
+            this.trySend(set, client, payload);
+        }
+    }
+    /** Send to all clients across all sessions */
+    broadcastAll(payload) {
+        for (const set of this.sessions.values()) {
+            for (const client of set) {
+                this.trySend(set, client, payload);
+            }
+        }
+    }
+    trySend(set, client, payload) {
+        try {
+            if (client.readyState === 1) {
+                client.send(payload);
+            }
+        }
+        catch {
+            set.delete(client);
+        }
+    }
+}
+//# sourceMappingURL=web-channel.js.map

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

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

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

@@ -0,0 +1,20 @@
+/** WhatsApp Cloud API version */
+export declare const WHATSAPP_GRAPH_API_VERSION = "v21.0";
+/** Build the WhatsApp Cloud API messages endpoint URL */
+export declare function whatsappMessagesUrl(phoneNumberId: string): string;
+/**
+ * Build the Graph API URL for retrieving WhatsApp media by ID.
+ * The caller must include a valid access token in the Authorization header to fetch the actual binary.
+ */
+export declare function whatsappMediaUrl(mediaId: string): string;
+/**
+ * Send a message via the WhatsApp Cloud API.
+ *
+ * @param phoneNumberId - The WhatsApp Business phone number ID
+ * @param accessToken - The access token for authentication
+ * @param to - The recipient phone number
+ * @param body - The message payload (type, text, image, audio, document, etc.)
+ * @returns The fetch Response
+ */
+export declare function sendWhatsAppMessage(phoneNumberId: string, accessToken: string, to: string, body: Record<string, unknown>): Promise<Response>;
+//# sourceMappingURL=whatsapp-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-api.d.ts","sourceRoot":"","sources":["../../src/channels/whatsapp-api.ts"],"names":[],"mappings":"AAGA,iCAAiC;AACjC,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAElD,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAkBnB"}

package/dist/channels/whatsapp-api.js

@@ -0,0 +1,44 @@
+// Shared WhatsApp Cloud API client
+// Single source of truth for graph.facebook.com URL construction, headers, and POST logic
+/** WhatsApp Cloud API version */
+export const WHATSAPP_GRAPH_API_VERSION = "v21.0";
+/** Build the WhatsApp Cloud API messages endpoint URL */
+export function whatsappMessagesUrl(phoneNumberId) {
+    return `https://graph.facebook.com/${WHATSAPP_GRAPH_API_VERSION}/${phoneNumberId}/messages`;
+}
+/**
+ * Build the Graph API URL for retrieving WhatsApp media by ID.
+ * The caller must include a valid access token in the Authorization header to fetch the actual binary.
+ */
+export function whatsappMediaUrl(mediaId) {
+    return `https://graph.facebook.com/${WHATSAPP_GRAPH_API_VERSION}/${mediaId}`;
+}
+/**
+ * Send a message via the WhatsApp Cloud API.
+ *
+ * @param phoneNumberId - The WhatsApp Business phone number ID
+ * @param accessToken - The access token for authentication
+ * @param to - The recipient phone number
+ * @param body - The message payload (type, text, image, audio, document, etc.)
+ * @returns The fetch Response
+ */
+export async function sendWhatsAppMessage(phoneNumberId, accessToken, to, body) {
+    const res = await fetch(whatsappMessagesUrl(phoneNumberId), {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({
+            messaging_product: "whatsapp",
+            to,
+            ...body,
+        }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "(unreadable)");
+        throw new Error(`WhatsApp API error ${res.status}: ${text}`);
+    }
+    return res;
+}
+//# sourceMappingURL=whatsapp-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-api.js","sourceRoot":"","sources":["../../src/channels/whatsapp-api.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,0FAA0F;AAE1F,iCAAiC;AACjC,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACvD,OAAO,8BAA8B,0BAA0B,IAAI,aAAa,WAAW,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,8BAA8B,0BAA0B,IAAI,OAAO,EAAE,CAAC;AAC/E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,aAAqB,EACrB,WAAmB,EACnB,EAAU,EACV,IAA6B;IAE7B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE;QAC1D,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,iBAAiB,EAAE,UAAU;YAC7B,EAAE;YACF,GAAG,IAAI;SACR,CAAC;KACH,CAAC,CAAC;IACH,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,sBAAsB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+export interface WhatsAppConfig {
+    readonly phoneNumberId: string;
+    readonly accessToken: string;
+    readonly verifyToken: string;
+}
+/**
+ * Channel adapter for WhatsApp Business API.
+ * receive() accepts parsed webhook messages from WhatsApp Cloud API.
+ * send() posts text messages via graph.facebook.com.
+ * stream() sends each engine event as a summarized text message.
+ * verifyWebhook() handles the one-time webhook verification handshake.
+ */
+export declare class WhatsAppChannel implements Channel {
+    readonly name = "whatsapp";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly config;
+    private messageHandler;
+    constructor(config: WhatsAppConfig);
+    /** Register a handler for incoming messages (from parsed webhook payloads) */
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+    /**
+     * Verify a WhatsApp webhook subscription request.
+     * Returns the challenge string if mode is "subscribe" and token matches, else null.
+     */
+    verifyWebhook(mode: string, token: string, challenge: string): string | null;
+}
+//# sourceMappingURL=whatsapp-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-channel.d.ts","sourceRoot":"","sources":["../../src/channels/whatsapp-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,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAW;IAChD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAsC;IAEvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAqD;gBAE/D,MAAM,EAAE,cAAc;IAIlC,8EAA8E;IAC9E,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;IAmC9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/D;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAM7E"}