@kilnai/runtime 0.1.1

package/dist/a2a/a2a-client.d.ts

@@ -0,0 +1,6 @@
+import type { AgentCard, A2ATask, A2AMessage } from "@kilnai/core";
+export declare class A2AClient {
+    discoverAgent(agentUrl: string): Promise<AgentCard>;
+    sendTask(agentUrl: string, message: A2AMessage, timeout?: number): Promise<A2ATask>;
+}
+//# sourceMappingURL=a2a-client.d.ts.map

package/dist/a2a/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../src/a2a/a2a-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnE,qBAAa,SAAS;IACd,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA6CnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAyE1F"}

package/dist/a2a/a2a-client.js

@@ -0,0 +1,112 @@
+// A2AClient: discovers remote agents via Agent Card and sends tasks
+import { KilnError } from "@kilnai/core";
+export class A2AClient {
+    async discoverAgent(agentUrl) {
+        const cardUrl = `${agentUrl.replace(/\/$/, "")}/.well-known/agent.json`;
+        let response;
+        try {
+            response = await fetch(cardUrl);
+        }
+        catch (err) {
+            throw new KilnError("A2A_CLIENT_FAILED", `Failed to fetch agent card from ${cardUrl}: ${err}`, {
+                context: { agentUrl, cardUrl },
+                cause: err,
+            });
+        }
+        if (!response.ok) {
+            throw new KilnError("A2A_CLIENT_FAILED", `Agent card request failed with status ${response.status}`, {
+                context: { agentUrl, cardUrl, status: response.status },
+            });
+        }
+        let data;
+        try {
+            data = await response.json();
+        }
+        catch (err) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Failed to parse agent card JSON", {
+                context: { agentUrl, cardUrl },
+                cause: err,
+            });
+        }
+        if (typeof data !== "object" || data === null) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Agent card response is not a valid object", {
+                context: { agentUrl, cardUrl },
+            });
+        }
+        const card = data;
+        if (!card.name || !card.url || !card.version || !card.capabilities) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Agent card is missing required fields", {
+                context: { agentUrl, cardUrl, card },
+            });
+        }
+        return card;
+    }
+    async sendTask(agentUrl, message, timeout) {
+        const endpoint = agentUrl.replace(/\/$/, "");
+        const requestBody = {
+            jsonrpc: "2.0",
+            method: "tasks/send",
+            params: { message },
+            id: crypto.randomUUID(),
+        };
+        const controller = new AbortController();
+        const timeoutId = timeout ? setTimeout(() => controller.abort(), timeout) : undefined;
+        let response;
+        try {
+            response = await fetch(endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(requestBody),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new KilnError("A2A_CLIENT_FAILED", `Task request timed out after ${timeout}ms`, {
+                    context: { agentUrl, timeout },
+                });
+            }
+            throw new KilnError("A2A_CLIENT_FAILED", `Failed to send task to ${endpoint}: ${err}`, {
+                context: { agentUrl },
+                cause: err,
+            });
+        }
+        if (timeoutId)
+            clearTimeout(timeoutId);
+        if (!response.ok) {
+            throw new KilnError("A2A_CLIENT_FAILED", `Task request failed with status ${response.status}`, {
+                context: { agentUrl, status: response.status },
+            });
+        }
+        let data;
+        try {
+            data = await response.json();
+        }
+        catch (err) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Failed to parse task response JSON", {
+                context: { agentUrl },
+                cause: err,
+            });
+        }
+        if (typeof data !== "object" || data === null) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Task response is not a valid object", {
+                context: { agentUrl },
+            });
+        }
+        const jsonRpc = data;
+        if (jsonRpc.error) {
+            throw new KilnError("A2A_CLIENT_FAILED", `Remote agent error: ${jsonRpc.error.message}`, {
+                context: { agentUrl, error: jsonRpc.error },
+            });
+        }
+        if (!jsonRpc.result) {
+            throw new KilnError("A2A_CLIENT_FAILED", "Task response missing 'result' field", {
+                context: { agentUrl, response: data },
+            });
+        }
+        return jsonRpc.result;
+    }
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/a2a/a2a-client.js.map

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

package/dist/a2a/index.d.ts

@@ -0,0 +1,2 @@
+export { A2AClient } from "./a2a-client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/a2a/index.js

@@ -0,0 +1,3 @@
+// A2A bounded context -- Agent-to-Agent protocol (client only)
+export { A2AClient } from "./a2a-client.js";
+//# sourceMappingURL=index.js.map

package/dist/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2a/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+/** Minimal SSE writer interface (compatible with Hono and Node.js writable streams) */
+export interface SseWriter {
+    write(data: string): void;
+    close(): void;
+}
+interface ApiChannelConfig {
+    apiKey?: string;
+}
+/**
+ * Channel adapter for REST API consumers with SSE streaming.
+ * receive() accepts incoming API messages and invokes the registered handler.
+ * send() queues responses for polling and broadcasts to SSE clients.
+ * stream() forwards engine events to all connected SSE clients.
+ */
+export declare class ApiChannel implements Channel {
+    readonly name = "api";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private readonly config;
+    private readonly responseQueue;
+    private readonly sseClients;
+    private messageHandler;
+    constructor(config?: ApiChannelConfig);
+    /** Register a handler for incoming API messages */
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+    /** Add an SSE client connection */
+    addSseClient(writer: SseWriter): void;
+    /** Remove an SSE client connection */
+    removeSseClient(writer: SseWriter): void;
+    /** Number of connected SSE clients */
+    get sseClientCount(): number;
+    /** Returns and clears all queued responses (for REST polling) */
+    pollResponses(): OutgoingMessage[];
+    /** Returns true if no apiKey configured, or if key matches */
+    validateApiKey(key: string): boolean;
+    private broadcastSse;
+}
+export {};
+//# sourceMappingURL=api-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-channel.d.ts","sourceRoot":"","sources":["../../src/channels/api-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAMpH,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAgB;IACrD,QAAQ,CAAC,mBAAmB,EAAE,SAAS,QAAQ,EAAE,CAAsC;IAEvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,cAAc,CAAqD;gBAE/D,MAAM,GAAE,gBAAqB;IAIzC,mDAAmD;IACnD,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;IAqB9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D,mCAAmC;IACnC,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIrC,sCAAsC;IACtC,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIxC,sCAAsC;IACtC,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,iEAAiE;IACjE,aAAa,IAAI,eAAe,EAAE;IAIlC,8DAA8D;IAC9D,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAOpC,OAAO,CAAC,YAAY;CASrB"}

package/dist/channels/api-channel.js

@@ -0,0 +1,95 @@
+// ApiChannel: wraps REST API + Server-Sent Events as a Channel adapter
+// Supports polling via response queue and real-time streaming via SSE connections
+import { extractText } from "@kilnai/core";
+import { formatForChannel } from "./message-formatter.js";
+const MAX_QUEUE_SIZE = 100;
+/**
+ * Channel adapter for REST API consumers with SSE streaming.
+ * receive() accepts incoming API messages and invokes the registered handler.
+ * send() queues responses for polling and broadcasts to SSE clients.
+ * stream() forwards engine events to all connected SSE clients.
+ */
+export class ApiChannel {
+    name = "api";
+    defaultFormat = "structured";
+    supportedModalities = ["text", "image", "audio", "file"];
+    config;
+    responseQueue = [];
+    sseClients = new Set();
+    messageHandler = null;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /** Register a handler for incoming API messages */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        // Bounded queue: discard oldest when full
+        if (this.responseQueue.length >= MAX_QUEUE_SIZE) {
+            this.responseQueue.shift();
+        }
+        this.responseQueue.push(response);
+        const text = extractText(response.parts);
+        const formatted = formatForChannel(text, response.format ?? this.defaultFormat);
+        const payload = `data: ${JSON.stringify({
+            type: "message",
+            content: formatted,
+            parts: response.parts,
+            target: response.target,
+            userId: response.userId,
+            threadId: response.threadId,
+        })}\n\n`;
+        this.broadcastSse(payload);
+    }
+    async stream(events) {
+        for await (const event of events) {
+            const payload = `data: ${JSON.stringify({
+                type: "event",
+                event: event.type,
+                payload: event.payload,
+                timestamp: event.timestamp,
+            })}\n\n`;
+            this.broadcastSse(payload);
+        }
+    }
+    /** Add an SSE client connection */
+    addSseClient(writer) {
+        this.sseClients.add(writer);
+    }
+    /** Remove an SSE client connection */
+    removeSseClient(writer) {
+        this.sseClients.delete(writer);
+    }
+    /** Number of connected SSE clients */
+    get sseClientCount() {
+        return this.sseClients.size;
+    }
+    /** Returns and clears all queued responses (for REST polling) */
+    pollResponses() {
+        return this.responseQueue.splice(0);
+    }
+    /** Returns true if no apiKey configured, or if key matches */
+    validateApiKey(key) {
+        if (!this.config.apiKey) {
+            return true;
+        }
+        return key === this.config.apiKey;
+    }
+    broadcastSse(payload) {
+        for (const client of this.sseClients) {
+            try {
+                client.write(payload);
+            }
+            catch {
+                this.sseClients.delete(client);
+            }
+        }
+    }
+}
+//# sourceMappingURL=api-channel.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { Channel, OutgoingMessage, EngineEvent } from "@kilnai/core";
+/**
+ * Registry for managing multiple Channel instances.
+ * Provides broadcast (send to all) and targeted (send to one) delivery.
+ */
+export declare class ChannelRegistry {
+    private readonly channels;
+    /** Register a channel adapter */
+    register(channel: Channel): void;
+    /** Unregister a channel by name */
+    unregister(name: string): boolean;
+    /** Get a specific channel by name */
+    get(name: string): Channel | undefined;
+    /** Get all registered channels */
+    getAll(): readonly Channel[];
+    /** Number of registered channels */
+    get size(): number;
+    /** Send a response to a specific channel by name */
+    sendTo(name: string, message: OutgoingMessage): Promise<boolean>;
+    /** Broadcast a response to all registered channels */
+    broadcast(message: OutgoingMessage): Promise<void>;
+    /** Start streaming events to a specific channel */
+    streamTo(name: string, events: AsyncIterable<EngineEvent>): Promise<void>;
+}
+//# sourceMappingURL=channel-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-registry.d.ts","sourceRoot":"","sources":["../../src/channels/channel-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1E;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC,mCAAmC;IACnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC,kCAAkC;IAClC,MAAM,IAAI,SAAS,OAAO,EAAE;IAI5B,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oDAAoD;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAOtE,sDAAsD;IAChD,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,mDAAmD;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhF"}

package/dist/channels/channel-registry.js

@@ -0,0 +1,49 @@
+// ChannelRegistry: manages multiple Channel instances for multi-channel apps
+/**
+ * Registry for managing multiple Channel instances.
+ * Provides broadcast (send to all) and targeted (send to one) delivery.
+ */
+export class ChannelRegistry {
+    channels = new Map();
+    /** Register a channel adapter */
+    register(channel) {
+        this.channels.set(channel.name, channel);
+    }
+    /** Unregister a channel by name */
+    unregister(name) {
+        return this.channels.delete(name);
+    }
+    /** Get a specific channel by name */
+    get(name) {
+        return this.channels.get(name);
+    }
+    /** Get all registered channels */
+    getAll() {
+        return [...this.channels.values()];
+    }
+    /** Number of registered channels */
+    get size() {
+        return this.channels.size;
+    }
+    /** Send a response to a specific channel by name */
+    async sendTo(name, message) {
+        const channel = this.channels.get(name);
+        if (!channel)
+            return false;
+        await channel.send(message);
+        return true;
+    }
+    /** Broadcast a response to all registered channels */
+    async broadcast(message) {
+        const sends = [...this.channels.values()].map((ch) => ch.send(message));
+        await Promise.allSettled(sends);
+    }
+    /** Start streaming events to a specific channel */
+    async streamTo(name, events) {
+        const channel = this.channels.get(name);
+        if (!channel)
+            return;
+        await channel.stream(events);
+    }
+}
+//# sourceMappingURL=channel-registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-registry.js","sourceRoot":"","sources":["../../src/channels/channel-registry.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAI7E;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEvD,iCAAiC;IACjC,QAAQ,CAAC,OAAgB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,mCAAmC;IACnC,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,qCAAqC;IACrC,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,kCAAkC;IAClC,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,oCAAoC;IACpC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAwB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,SAAS,CAAC,OAAwB;QACtC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,MAAkC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+import type { IncomingMessage, OutgoingMessage } from "@kilnai/core";
+import type { IdentityResolver } from "./types.js";
+import type { ChannelRegistry } from "./channel-registry.js";
+/** Result of routing an incoming message */
+export interface RouteResult {
+    readonly team: string;
+    readonly engineUserId: string | null;
+    readonly channelName: string;
+    readonly message: IncomingMessage;
+}
+/** Router rules for pattern-based team selection */
+export interface ChannelRouterRule {
+    readonly match: RegExp;
+    readonly team: string;
+}
+/**
+ * Routes incoming channel messages through identity resolution and pattern matching.
+ *
+ * Flow: IncomingMessage -> IdentityResolver -> pattern rules -> fallback team
+ *
+ * After routing, the message can be dispatched to the correct team for processing,
+ * and the response sent back through the originating channel.
+ */
+export declare class ChannelRouter {
+    private readonly rules;
+    private readonly fallbackTeam;
+    private readonly identityResolver;
+    private readonly registry;
+    private routeHandler;
+    constructor(options: {
+        rules?: ChannelRouterRule[];
+        fallbackTeam: string;
+        identityResolver?: IdentityResolver;
+        registry: ChannelRegistry;
+    });
+    /** Register a handler that processes routed messages and returns a response */
+    onRoute(handler: (result: RouteResult) => Promise<OutgoingMessage | null>): void;
+    /** Route an incoming message from a named channel */
+    route(channelName: string, message: IncomingMessage): Promise<RouteResult>;
+    /** Resolve team name for a message content string */
+    resolveTeam(content: string): string;
+}
+//# sourceMappingURL=channel-router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-router.d.ts","sourceRoot":"","sources":["../../src/channels/channel-router.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,YAAY,CAA2E;gBAEnF,OAAO,EAAE;QACnB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,QAAQ,EAAE,eAAe,CAAC;KAC3B;IAOD,+EAA+E;IAC/E,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,IAAI;IAIhF,qDAAqD;IAC/C,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAsChF,qDAAqD;IACrD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAQrC"}

package/dist/channels/channel-router.js

@@ -0,0 +1,72 @@
+// ChannelRouter: routes incoming channel messages to teams via Router composite
+// Bridges Channel.receive() -> IdentityResolver -> Router pattern matching -> Team dispatch
+import { extractText } from "@kilnai/core";
+/**
+ * Routes incoming channel messages through identity resolution and pattern matching.
+ *
+ * Flow: IncomingMessage -> IdentityResolver -> pattern rules -> fallback team
+ *
+ * After routing, the message can be dispatched to the correct team for processing,
+ * and the response sent back through the originating channel.
+ */
+export class ChannelRouter {
+    rules;
+    fallbackTeam;
+    identityResolver;
+    registry;
+    routeHandler = null;
+    constructor(options) {
+        this.rules = options.rules ?? [];
+        this.fallbackTeam = options.fallbackTeam;
+        this.identityResolver = options.identityResolver ?? null;
+        this.registry = options.registry;
+    }
+    /** Register a handler that processes routed messages and returns a response */
+    onRoute(handler) {
+        this.routeHandler = handler;
+    }
+    /** Route an incoming message from a named channel */
+    async route(channelName, message) {
+        // 1. Resolve identity
+        let engineUserId = null;
+        if (this.identityResolver && message.userId) {
+            engineUserId = await this.identityResolver.resolve(channelName, message.userId);
+        }
+        // 2. Match pattern rules against message text content
+        const text = extractText(message.parts);
+        let team = this.fallbackTeam;
+        for (const rule of this.rules) {
+            if (rule.match.test(text)) {
+                team = rule.team;
+                break;
+            }
+        }
+        const result = {
+            team,
+            engineUserId,
+            channelName,
+            message,
+        };
+        // 3. Dispatch to handler and send response back
+        if (this.routeHandler) {
+            const response = await this.routeHandler(result);
+            if (response) {
+                const channel = this.registry.get(channelName);
+                if (channel) {
+                    await channel.send(response);
+                }
+            }
+        }
+        return result;
+    }
+    /** Resolve team name for a message content string */
+    resolveTeam(content) {
+        for (const rule of this.rules) {
+            if (rule.match.test(content)) {
+                return rule.team;
+            }
+        }
+        return this.fallbackTeam;
+    }
+}
+//# sourceMappingURL=channel-router.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-router.js","sourceRoot":"","sources":["../../src/channels/channel-router.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4FAA4F;AAG5F,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkB3C;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IACP,KAAK,CAAsB;IAC3B,YAAY,CAAS;IACrB,gBAAgB,CAA0B;IAC1C,QAAQ,CAAkB;IACnC,YAAY,GAAsE,IAAI,CAAC;IAE/F,YAAY,OAKX;QACC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,+EAA+E;IAC/E,OAAO,CAAC,OAAiE;QACvE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,OAAwB;QACvD,sBAAsB;QACtB,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,IAAI,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC5C,YAAY,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAClF,CAAC;QAED,sDAAsD;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACjB,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAgB;YAC1B,IAAI;YACJ,YAAY;YACZ,WAAW;YACX,OAAO;SACR,CAAC;QAEF,gDAAgD;QAChD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC/C,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qDAAqD;IACrD,WAAW,CAAC,OAAe;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import type { Channel, IncomingMessage, OutgoingMessage, EngineEvent, MessageFormat, Modality } from "@kilnai/core";
+/**
+ * Channel adapter for CLI stdin/stdout.
+ * receive() stores the message for the orchestrator to consume.
+ * send() writes formatted output to stdout/stderr.
+ * stream() writes each event as a formatted line to stdout.
+ */
+export declare class CliChannel implements Channel {
+    readonly name = "cli";
+    readonly defaultFormat: MessageFormat;
+    readonly supportedModalities: readonly Modality[];
+    private messageHandler;
+    /** Register a handler for incoming messages (from stdin) */
+    onMessage(handler: (message: IncomingMessage) => void): void;
+    receive(message: IncomingMessage): Promise<void>;
+    send(response: OutgoingMessage): Promise<void>;
+    stream(events: AsyncIterable<EngineEvent>): Promise<void>;
+}
+//# sourceMappingURL=cli-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-channel.d.ts","sourceRoot":"","sources":["../../src/channels/cli-channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIpH;;;;;GAKG;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,CAAY;IAE7D,OAAO,CAAC,cAAc,CAAqD;IAE3E,4DAA4D;IAC5D,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;IAM9C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhE"}

package/dist/channels/cli-channel.js

@@ -0,0 +1,37 @@
+// CliChannel: wraps stdin/stdout as a Channel adapter
+// Formalizes the existing run.ts console output as a Channel implementation
+import { extractText } from "@kilnai/core";
+import { formatForChannel } from "./message-formatter.js";
+/**
+ * Channel adapter for CLI stdin/stdout.
+ * receive() stores the message for the orchestrator to consume.
+ * send() writes formatted output to stdout/stderr.
+ * stream() writes each event as a formatted line to stdout.
+ */
+export class CliChannel {
+    name = "cli";
+    defaultFormat = "full";
+    supportedModalities = ["text"];
+    messageHandler = null;
+    /** Register a handler for incoming messages (from stdin) */
+    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);
+        process.stdout.write(formatted + "\n");
+    }
+    async stream(events) {
+        for await (const event of events) {
+            const line = `[${event.type}] ${JSON.stringify(event.payload)}`;
+            process.stdout.write(line + "\n");
+        }
+    }
+}
+//# sourceMappingURL=cli-channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-channel.js","sourceRoot":"","sources":["../../src/channels/cli-channel.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,4EAA4E;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,KAAK,CAAC;IACb,aAAa,GAAkB,MAAM,CAAC;IACtC,mBAAmB,GAAwB,CAAC,MAAM,CAAC,CAAC;IAErD,cAAc,GAAgD,IAAI,CAAC;IAE3E,4DAA4D;IAC5D,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;QAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAkC;QAC7C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/channels/event-bridge.d.ts

@@ -0,0 +1,27 @@
+import type { KilnEvent, EventBus, StreamLevel } from "@kilnai/core";
+import type { EngineEvent } from "@kilnai/core";
+/** Convert a KilnEvent to an EngineEvent for channel consumption */
+export declare function toEngineEvent(event: KilnEvent): EngineEvent;
+/**
+ * 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 declare class EventBridge {
+    private readonly queue;
+    private readonly maxQueueSize;
+    private resolve;
+    private done;
+    private unsubscribe;
+    constructor(maxQueueSize?: number);
+    /**
+     * Subscribe to an EventBus and start bridging events.
+     * If level is provided, only events matching that level or coarser are bridged.
+     */
+    connect(eventBus: EventBus, level?: StreamLevel): void;
+    /** Stop bridging and signal the async generator to complete */
+    disconnect(): void;
+    /** Async generator that yields EngineEvents as they arrive */
+    events(): AsyncGenerator<EngineEvent>;
+}
+//# sourceMappingURL=event-bridge.d.ts.map

package/dist/channels/event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../../src/channels/event-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAO3D;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAA6B;gBAEpC,YAAY,SAAO;IAI/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI;IA2BtD,+DAA+D;IAC/D,UAAU,IAAI,IAAI;IAalB,8DAA8D;IACvD,MAAM,IAAI,cAAc,CAAC,WAAW,CAAC;CAY7C"}