@kilnai/runtime 0.1.15 → 0.9.0

package/dist/gateway/messenger-webhook-routes.js

@@ -0,0 +1,394 @@
+// Gateway: Messenger webhook routes -- Hono sub-app for Facebook Messenger Platform
+// Resolves tenant by Messenger Page ID, processes messages via Mode B orchestrator, replies via Messenger Send API
+import { Hono } from "hono";
+import { join } from "node:path";
+import { mkdirSync } from "node:fs";
+import { extractText, SqliteMemoryStore } from "@kilnai/core";
+import { toMessengerFormat } from "../channels/message-formatter.js";
+import { resolveAgentContextAsync } from "../tenant/agent-resolver.js";
+import { sendMessengerMessage } from "../channels/messenger-api.js";
+import { checkBudget, reportUsage } from "./budget-middleware.js";
+import { requireWebhookSignature } from "./auth-middleware.js";
+import { verifyMetaWebhook } from "./meta-webhook-foundation.js";
+import { TraceContext } from "./trace-context.js";
+import { preprocessAudio, createGenericMediaDownloader } from "./audio-preprocessor.js";
+import { formatKnowledgeContext, formatContactContext, mergeContextSources } from "./context-formatter.js";
+/** Lazily-opened per-tenant memory stores. Keyed by tenantId. */
+const memoryStores = new Map();
+function getMemoryStore(memoryBasePath, tenantId) {
+    let store = memoryStores.get(tenantId);
+    if (store)
+        return store;
+    const dir = join(memoryBasePath, "memory");
+    mkdirSync(dir, { recursive: true });
+    store = new SqliteMemoryStore({
+        dbPath: join(dir, `${tenantId}.db`),
+        layer: "user",
+        tenantId,
+    });
+    memoryStores.set(tenantId, store);
+    return store;
+}
+/** Tool definition for knowledge_search -- injected when knowledge mode is "tool" */
+const KNOWLEDGE_SEARCH_TOOL = {
+    name: "knowledge_search",
+    description: "Search the knowledge base for relevant information. Use this when the user asks a question that may be answered by stored documents or knowledge.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "The search query to find relevant knowledge.",
+            },
+        },
+        required: ["query"],
+    },
+    tags: new Set(["builtin"]),
+};
+/** Parse a Messenger messaging entry into ContentPart[] */
+function parseMessengerMessageParts(entry) {
+    const msg = entry.message;
+    if (!msg)
+        return null;
+    const parts = [];
+    if (msg.text) {
+        parts.push({ type: "text", text: msg.text });
+    }
+    if (msg.attachments) {
+        for (const att of msg.attachments) {
+            if (att.type === "image" && att.payload.url) {
+                parts.push({ type: "image", mimeType: "image/jpeg", url: att.payload.url });
+            }
+            else if (att.type === "audio" && att.payload.url) {
+                parts.push({ type: "audio", mimeType: "audio/mp4", url: att.payload.url });
+            }
+        }
+    }
+    return parts.length > 0 ? parts : null;
+}
+export function createMessengerWebhookRoutes(config) {
+    const app = new Hono();
+    // GET /webhook -- Meta verification handshake
+    app.get("/webhook", (c) => verifyMetaWebhook(c, config.verifyToken));
+    // HMAC-SHA256 signature validation for POST webhooks
+    if (config.appSecret) {
+        app.use("/webhook", requireWebhookSignature(config.appSecret, "x-hub-signature-256"));
+    }
+    // POST /webhook -- Incoming messages from Messenger
+    app.post("/webhook", async (c) => {
+        let payload;
+        try {
+            payload = await c.req.json();
+        }
+        catch {
+            return c.text("OK", 200);
+        }
+        if (payload.object !== "page" || !payload.entry) {
+            return c.text("OK", 200);
+        }
+        const processPromises = [];
+        for (const entry of payload.entry) {
+            for (const messaging of entry.messaging) {
+                // Filter echo messages (business-sent messages echoed back)
+                if (messaging.message?.is_echo)
+                    continue;
+                // Deduplicate -- Meta uses at-least-once delivery
+                if (messaging.message?.mid && config.dedup?.isDuplicate(messaging.message.mid)) {
+                    console.debug(`[messenger] Skipping duplicate message ${messaging.message.mid}`);
+                    continue;
+                }
+                const senderId = messaging.sender.id;
+                const recipientPageId = messaging.recipient.id;
+                // Resolve tenant by Messenger Page ID
+                const tenant = config.tenantRegistry.resolveByMessengerPageId(recipientPageId, config.appName);
+                if (!tenant) {
+                    const trace = new TraceContext();
+                    trace.warn("messenger", "No tenant found", { recipientPageId, appName: config.appName });
+                    continue;
+                }
+                const msgParts = parseMessengerMessageParts(messaging);
+                if (!msgParts)
+                    continue;
+                const promise = processMessengerMessage(config, tenant.tenantId, senderId, msgParts, tenant.messengerAccessToken);
+                processPromises.push(promise);
+            }
+        }
+        // Fire and forget -- log any failures from settled promises
+        Promise.allSettled(processPromises).then((results) => {
+            for (const result of results) {
+                if (result.status === "rejected") {
+                    const failTrace = new TraceContext();
+                    failTrace.warn("messenger", "Message processing failed", { error: String(result.reason) });
+                }
+            }
+        });
+        return c.text("OK", 200);
+    });
+    return app;
+}
+async function processMessengerMessage(config, tenantId, senderId, messageParts, accessToken) {
+    const trace = new TraceContext();
+    trace.log("messenger", "Processing message", { tenantId, from: senderId });
+    const tenant = config.tenantRegistry.get(tenantId);
+    if (!tenant)
+        return;
+    const resolvedAccessToken = accessToken
+        ? (process.env[accessToken] ?? accessToken)
+        : "";
+    // Preprocess audio parts via STT (fail-open) -- Messenger CDN URLs don't need auth
+    let processedParts = messageParts;
+    if (config.sttAdapter) {
+        try {
+            const downloader = createGenericMediaDownloader();
+            processedParts = await preprocessAudio(messageParts, config.sttAdapter, downloader);
+        }
+        catch (err) {
+            trace.warn("messenger", "Audio preprocessing failed", { error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    const messageText = extractText(processedParts);
+    // --- Memory: recall past context about this user ---
+    let recalledMemory;
+    if (config.memoryBasePath) {
+        try {
+            const store = getMemoryStore(config.memoryBasePath, tenantId);
+            const query = `${senderId} ${messageText}`;
+            recalledMemory = await store.recall(query, 500) || undefined;
+        }
+        catch (err) {
+            trace.warn("messenger", "Memory recall failed", { tenantId, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    // --- Knowledge: retrieve relevant context ---
+    let knowledgeContext;
+    if (config.knowledgePipeline && messageText.length > 0) {
+        const knowledgeMode = config.knowledgeMode ?? "auto";
+        if (knowledgeMode === "auto") {
+            try {
+                const results = await config.knowledgePipeline.retrieve(messageText, { topK: 5 });
+                knowledgeContext = formatKnowledgeContext(results);
+            }
+            catch (err) {
+                trace.warn("messenger", "Knowledge retrieval failed", { error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+    }
+    // --- Contact memory: recall persistent facts about this user ---
+    let contactContext;
+    if (config.contactMemoryService) {
+        try {
+            const facts = await config.contactMemoryService.recall(senderId, tenantId);
+            contactContext = formatContactContext(facts);
+        }
+        catch (err) {
+            trace.warn("messenger", "Contact memory recall failed", { tenantId, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+    const combinedMemory = mergeContextSources(recalledMemory, knowledgeContext, contactContext);
+    // --- Tools: build per-call builtin tools ---
+    const callTools = new Map();
+    // Register knowledge_search tool for "tool" mode
+    if (config.knowledgePipeline && (config.knowledgeMode ?? "auto") === "tool") {
+        callTools.set("knowledge_search", async (input) => {
+            const query = String(input.query ?? "");
+            const results = await config.knowledgePipeline.retrieve(query, { topK: 5 });
+            return results.map((r) => ({ content: r.content, score: r.score }));
+        });
+        const hasKnowledgeTool = config.orchestrator.tools?.some((t) => t.name === "knowledge_search");
+        if (!hasKnowledgeTool) {
+            config.orchestrator.registerTools([KNOWLEDGE_SEARCH_TOOL]);
+        }
+    }
+    // Get or create session first (needed for ping-pong guard)
+    const session = await config.sessionRegistry.getOrCreate({
+        appName: config.appName,
+        tenantId,
+        userId: senderId,
+        systemPrompt: "",
+        idleTimeoutMs: tenant.idleTimeoutMs,
+    });
+    // Resolve agent context (multi-agent routing with ping-pong guard)
+    const agentCtx = await resolveAgentContextAsync(tenant, processedParts, session, { handoffSummarizer: config.handoffSummarizer, eventBus: config.eventBus }, "messenger", callTools);
+    // Update session with resolved prompt and agent
+    session.setSystemPrompt(agentCtx.systemPrompt);
+    if (agentCtx.activeAgentId) {
+        session.setActiveAgent(agentCtx.activeAgentId, agentCtx.handoffBrief);
+    }
+    const tenantToolCtx = agentCtx.tenantToolContext;
+    // Register webhook tool definitions on the orchestrator
+    if (tenantToolCtx.toolDefinitions.length > 0) {
+        config.orchestrator.registerTools(tenantToolCtx.toolDefinitions);
+    }
+    const perCallConfig = {
+        toolAllowlist: tenantToolCtx.toolAllowlist,
+        rateLimiter: tenantToolCtx.rateLimiter,
+        tenantId: tenant.tenantId,
+        additionalTools: tenantToolCtx.toolDefinitions.length > 0 ? tenantToolCtx.toolDefinitions : undefined,
+    };
+    // --- Budget check ---
+    const activeBilling = tenant.billing?.budgetEndpoint
+        ? tenant.billing
+        : config.billing;
+    if (activeBilling) {
+        const budgetResult = await checkBudget(activeBilling, tenantId);
+        if (!budgetResult.allowed) {
+            const overBudgetMsg = tenant.billing?.overBudgetMessage
+                ?? activeBilling.overBudgetMessage ?? "Budget exhausted.";
+            trace.log("messenger", "Budget exhausted", { tenantId, sender: senderId });
+            try {
+                await sendMessengerMessage(resolvedAccessToken, senderId, overBudgetMsg);
+            }
+            catch (err) {
+                trace.warn("messenger", "Failed to send over-budget reply", { error: err instanceof Error ? err.message : String(err) });
+            }
+            return;
+        }
+    }
+    // Emit MESSAGE_RECEIVED event (fire-and-forget)
+    if (config.eventEmitter) {
+        config.eventEmitter.emit({
+            eventType: "MESSAGE_RECEIVED",
+            tenantId,
+            channel: "messenger",
+            externalUserId: senderId,
+            messageContent: messageText,
+            messageRole: "USER",
+            traceId: trace.traceId,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    let replyText;
+    try {
+        const result = await config.orchestrator.processMessage(session, processedParts, combinedMemory, tenantToolCtx.callBuiltinTools.size > 0 ? tenantToolCtx.callBuiltinTools : undefined, perCallConfig);
+        // Persist mutated session
+        await config.sessionRegistry.save(session);
+        // Emit handoff events when message was queued
+        if (result.queued && config.eventEmitter) {
+            config.eventEmitter.emit({
+                eventType: "HANDOFF_MESSAGE_QUEUED",
+                tenantId,
+                channel: "messenger",
+                externalUserId: senderId,
+                sessionMode: session.sessionMode,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Emit escalation event when detected
+        if (result.escalation && config.eventEmitter) {
+            config.eventEmitter.emit({
+                eventType: "ESCALATION_DETECTED",
+                tenantId,
+                channel: "messenger",
+                externalUserId: senderId,
+                escalationReason: result.escalation.reason,
+                escalationDetail: result.escalation.detail,
+                summary: result.contextSummary,
+                sessionMode: session.sessionMode,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Emit TOOL_EXECUTED events
+        if (result.toolExecutions && config.eventEmitter) {
+            for (const exec of result.toolExecutions) {
+                config.eventEmitter.emit({
+                    eventType: "TOOL_EXECUTED",
+                    tenantId,
+                    channel: "messenger",
+                    externalUserId: senderId,
+                    toolName: exec.toolName,
+                    durationMs: exec.durationMs,
+                    success: exec.success,
+                    resultSummary: exec.resultSummary,
+                    traceId: trace.traceId,
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+        // Emit AGENT_ROUTED when multi-agent routing is active
+        if (agentCtx.activeAgentId && config.eventEmitter) {
+            config.eventEmitter.emit({
+                eventType: "AGENT_ROUTED",
+                tenantId,
+                channel: "messenger",
+                externalUserId: senderId,
+                activeAgentId: agentCtx.activeAgentId,
+                activeAgentName: agentCtx.activeAgentName,
+                routingTier: agentCtx.routingResult?.tier,
+                routingConfidence: agentCtx.routingResult?.confidence,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Emit AGENT_HANDOFF when an agent switch occurred (or was blocked)
+        if ((agentCtx.isHandoff || agentCtx.pingPongBlocked) && config.eventEmitter) {
+            const fromAgent = tenant.agents?.find((a) => a.id === agentCtx.previousAgentId);
+            const toAgent = tenant.agents?.find((a) => a.id === agentCtx.activeAgentId);
+            config.eventEmitter.emit({
+                eventType: "AGENT_HANDOFF",
+                tenantId,
+                channel: "messenger",
+                externalUserId: senderId,
+                fromAgentId: agentCtx.previousAgentId,
+                fromAgentName: fromAgent?.name,
+                toAgentId: agentCtx.activeAgentId,
+                toAgentName: toAgent?.name,
+                handoffBrief: agentCtx.handoffBrief,
+                handoffBlocked: agentCtx.pingPongBlocked,
+                handoffBlockReason: agentCtx.pingPongReason,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        replyText = toMessengerFormat(extractText(result.parts));
+        // Report usage (fire-and-forget)
+        if (activeBilling) {
+            reportUsage(activeBilling, {
+                tenantId,
+                messages: 1,
+                tokens: result.inputTokens + result.outputTokens,
+                model: config.orchestrator.model ?? "unknown",
+            });
+        }
+        // Emit MESSAGE_SENT event (fire-and-forget)
+        if (config.eventEmitter) {
+            config.eventEmitter.emit({
+                eventType: "MESSAGE_SENT",
+                tenantId,
+                channel: "messenger",
+                externalUserId: senderId,
+                messageContent: replyText,
+                messageRole: "ASSISTANT",
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    catch (err) {
+        trace.error("messenger", "Orchestrator error", { tenantId, error: err instanceof Error ? err.message : String(err) });
+        replyText = "Something went wrong. Please try again.";
+    }
+    // Reply via Messenger Send API
+    try {
+        await sendMessengerMessage(resolvedAccessToken, senderId, replyText);
+    }
+    catch (err) {
+        trace.warn("messenger", "Failed to send reply", { recipient: senderId, error: err instanceof Error ? err.message : String(err) });
+    }
+    // --- Memory: save what was learned from this exchange ---
+    if (config.memoryBasePath && messageText.length > 5) {
+        try {
+            const store = getMemoryStore(config.memoryBasePath, tenantId);
+            await store.save({
+                layer: "user",
+                content: `[${senderId}] User: ${messageText}\nAssistant: ${replyText}`,
+                tags: [senderId],
+            });
+        }
+        catch (err) {
+            trace.warn("messenger", "Memory save failed", { tenantId, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+}
+//# sourceMappingURL=messenger-webhook-routes.js.map

package/dist/gateway/messenger-webhook-routes.js.map

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

package/dist/gateway/meta-webhook-foundation.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from "hono";
+/**
+ * Handle Meta's GET verification handshake.
+ * Returns hub.challenge on valid subscribe requests; 403 otherwise.
+ */
+export declare function verifyMetaWebhook(c: Context, verifyToken: string): Response;
+/**
+ * Validate Meta's HMAC-SHA256 signature from `X-Hub-Signature-256` header.
+ * Strips the `sha256=` prefix before comparison.
+ */
+export declare function validateMetaSignature(body: string, signature: string, appSecret: string): boolean;
+//# sourceMappingURL=meta-webhook-foundation.d.ts.map

package/dist/gateway/meta-webhook-foundation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-webhook-foundation.d.ts","sourceRoot":"","sources":["../../src/gateway/meta-webhook-foundation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAS3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGjG"}

package/dist/gateway/meta-webhook-foundation.js

@@ -0,0 +1,25 @@
+// Meta Webhook Foundation -- shared verification, HMAC validation, and entry dispatch
+// Used by WhatsApp, Instagram, and Messenger webhook handlers
+import { verifyHmacSha256 } from "../utils/hmac.js";
+/**
+ * Handle Meta's GET verification handshake.
+ * Returns hub.challenge on valid subscribe requests; 403 otherwise.
+ */
+export function verifyMetaWebhook(c, verifyToken) {
+    const mode = c.req.query("hub.mode");
+    const token = c.req.query("hub.verify_token");
+    const challenge = c.req.query("hub.challenge");
+    if (mode === "subscribe" && token === verifyToken) {
+        return c.text(challenge ?? "", 200);
+    }
+    return c.text("Forbidden", 403);
+}
+/**
+ * Validate Meta's HMAC-SHA256 signature from `X-Hub-Signature-256` header.
+ * Strips the `sha256=` prefix before comparison.
+ */
+export function validateMetaSignature(body, signature, appSecret) {
+    const sig = signature.startsWith("sha256=") ? signature.slice(7) : signature;
+    return verifyHmacSha256(appSecret, body, sig);
+}
+//# sourceMappingURL=meta-webhook-foundation.js.map

package/dist/gateway/meta-webhook-foundation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-webhook-foundation.js","sourceRoot":"","sources":["../../src/gateway/meta-webhook-foundation.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,8DAA8D;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAU,EAAE,WAAmB;IAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAE/C,IAAI,IAAI,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAClD,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB;IACtF,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,OAAO,gBAAgB,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC"}

package/dist/gateway/mode-b-routes.d.ts

@@ -1,7 +1,10 @@
 import { Hono } from "hono";
+import type { TenantConfig, RetrievalPipeline } from "@kilnai/core";
 import type { ModeBOrchestrator } from "../session/mode-b-orchestrator.js";
 import type { SessionRegistry } from "../session/session-registry.js";
 import type { BillingConfig } from "./budget-middleware.js";
+import type { AgentHandoffSummarizer } from "../session/agent-handoff-summarizer.js";
+import type { EventBus } from "@kilnai/core";
 /** Runtime configuration for a Mode B App */
 export interface ModeBAppRuntime {
     readonly appName: string;
@@ -10,6 +13,11 @@ export interface ModeBAppRuntime {
     readonly billing?: BillingConfig;
     readonly systemPrompt: string;
     readonly apiKey?: string;
+    readonly knowledgePipeline?: RetrievalPipeline;
+    readonly knowledgeMode?: "auto" | "tool";
+    readonly tenant?: TenantConfig;
+    readonly handoffSummarizer?: AgentHandoffSummarizer;
+    readonly eventBus?: EventBus;
 }
 export declare function createModeBRoutes(runtime: ModeBAppRuntime): Hono;
 //# sourceMappingURL=mode-b-routes.d.ts.map

package/dist/gateway/mode-b-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode-b-routes.d.ts","sourceRoot":"","sources":["../../src/gateway/mode-b-routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAuGhE"}
+{"version":3,"file":"mode-b-routes.d.ts","sourceRoot":"","sources":["../../src/gateway/mode-b-routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAe,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAUD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA6IhE"}

package/dist/gateway/mode-b-routes.js

@@ -2,8 +2,11 @@
 // Handles message processing, session listing, and session removal
 import { Hono } from "hono";
 import { textParts, extractText } from "@kilnai/core";
-import { checkBudget, reportUsage, checkTier } from "./budget-middleware.js";
+import { formatKnowledgeContext } from "./context-formatter.js";
+import { checkTier } from "./budget-middleware.js";
 import { requireApiKey } from "./auth-middleware.js";
+import { processInboundMessage } from "./message-pipeline.js";
+import { resolveAgentContextAsync } from "../tenant/agent-resolver.js";
 export function createModeBRoutes(runtime) {
     const app = new Hono();
     if (runtime.apiKey) {
@@ -27,60 +30,95 @@ export function createModeBRoutes(runtime) {
         if (!body.userId || typeof body.userId !== "string") {
             return c.json({ error: "userId is required" }, 400);
         }
-        // Budget check
-        if (runtime.billing) {
-            const budgetResult = await checkBudget(runtime.billing, body.userId);
-            if (!budgetResult.allowed) {
+        // Tier enforcement (Mode B specific -- not in the pipeline)
+        if (runtime.billing?.tiers && body.plan) {
+            const tierResult = checkTier(runtime.billing, body.plan, "fast");
+            if (!tierResult.allowed) {
                 return c.json({
-                    content: runtime.billing.overBudgetMessage,
-                    budgetExhausted: true,
+                    content: `Tier "fast" is not available on your "${body.plan}" plan. Allowed tiers: ${tierResult.allowedTiers.join(", ")}`,
+                    tierRestricted: true,
                 });
             }
-            // Tier enforcement
-            if (runtime.billing.tiers && body.plan) {
-                const tierResult = checkTier(runtime.billing, body.plan, "fast");
-                if (!tierResult.allowed) {
-                    return c.json({
-                        content: `Tier "fast" is not available on your "${body.plan}" plan. Allowed tiers: ${tierResult.allowedTiers.join(", ")}`,
-                        tierRestricted: true,
-                    });
+        }
+        // Knowledge retrieval (auto mode)
+        let knowledgeContext;
+        if (runtime.knowledgePipeline && (runtime.knowledgeMode ?? "auto") === "auto") {
+            const queryText = extractText(userParts);
+            if (queryText.length > 0) {
+                try {
+                    const results = await runtime.knowledgePipeline.retrieve(queryText, { topK: 5 });
+                    knowledgeContext = formatKnowledgeContext(results);
+                }
+                catch {
+                    // fail-open
                 }
             }
         }
-        // Get or create session
-        const session = runtime.sessionRegistry.getOrCreate({
-            appName: runtime.appName,
-            userId: body.userId,
-            systemPrompt: runtime.systemPrompt,
-        });
-        // Process message
-        let result;
+        // Resolve agent context if tenant has multi-agent config
+        let systemPrompt = runtime.systemPrompt;
+        let activeAgentId;
+        let activeAgentName;
+        let routingTier;
+        let routingConfidence;
+        if (runtime.tenant) {
+            // Get or create session for ping-pong guard context
+            const session = await runtime.sessionRegistry.getOrCreate({
+                appName: runtime.appName,
+                userId: body.userId,
+                systemPrompt: "",
+            });
+            const agentCtx = await resolveAgentContextAsync(runtime.tenant, userParts, session, { handoffSummarizer: runtime.handoffSummarizer, eventBus: runtime.eventBus });
+            systemPrompt = agentCtx.systemPrompt;
+            activeAgentId = agentCtx.activeAgentId;
+            activeAgentName = agentCtx.activeAgentName;
+            routingTier = agentCtx.routingResult?.tier;
+            routingConfidence = agentCtx.routingResult?.confidence;
+            // Update session with resolved prompt and agent
+            session.setSystemPrompt(agentCtx.systemPrompt);
+            if (agentCtx.activeAgentId) {
+                session.setActiveAgent(agentCtx.activeAgentId, agentCtx.handoffBrief);
+            }
+            await runtime.sessionRegistry.save(session);
+        }
+        let processResult;
         try {
-            result = await runtime.orchestrator.processMessage(session, userParts);
+            processResult = await processInboundMessage({
+                orchestrator: runtime.orchestrator,
+                sessionRegistry: runtime.sessionRegistry,
+                appName: runtime.appName,
+                userId: body.userId,
+                systemPrompt,
+                userParts,
+                billing: runtime.billing,
+                channel: "api",
+                knowledgeContext,
+                activeAgentId,
+                activeAgentName,
+                routingTier,
+                routingConfidence,
+            });
         }
         catch (err) {
             console.error(`[${runtime.appName}] processMessage error:`, err);
             return c.json({ error: String(err) }, 500);
         }
-        // Report token usage to billing (fire-and-forget)
-        if (runtime.billing) {
-            reportUsage(runtime.billing, {
-                tenantId: body.userId,
-                messages: 1,
-                tokens: result.inputTokens + result.outputTokens,
-                model: runtime.orchestrator.model ?? "unknown",
+        if (!processResult.ok) {
+            return c.json({
+                content: processResult.budgetDenied.message,
+                budgetExhausted: true,
             });
         }
+        const result = processResult.result;
         return c.json({
             content: extractText(result.parts),
             parts: result.parts,
             inputTokens: result.inputTokens,
             outputTokens: result.outputTokens,
-            sessionId: session.id,
+            sessionId: result.sessionId,
         });
     });
-    app.get("/sessions", (c) => {
-        const sessions = runtime.sessionRegistry.activeSessions();
+    app.get("/sessions", async (c) => {
+        const sessions = await runtime.sessionRegistry.activeSessions();
         return c.json({
             sessions: sessions.map((s) => ({
                 id: s.id,
@@ -91,9 +129,9 @@ export function createModeBRoutes(runtime) {
             })),
         });
     });
-    app.delete("/sessions/:userId", (c) => {
+    app.delete("/sessions/:userId", async (c) => {
         const userId = c.req.param("userId");
-        const removed = runtime.sessionRegistry.remove(runtime.appName, userId);
+        const removed = await runtime.sessionRegistry.remove(runtime.appName, userId);
         return c.json({ removed });
     });
     return app;