@kilnai/runtime 0.1.14 → 0.1.16

package/dist/gateway/handoff-routes.js

@@ -0,0 +1,214 @@
+// Gateway: Handoff routes -- Hono sub-app for operator message injection and session mode transitions
+// Enables human-in-the-loop workflows: escalate to human, send operator messages, release back to AI
+import { Hono } from "hono";
+import { KilnError, textParts } from "@kilnai/core";
+import { sendWhatsAppMessage } from "../channels/whatsapp-api.js";
+import { requireBearer } from "./auth-middleware.js";
+import { TraceContext } from "./trace-context.js";
+export function createHandoffRoutes(config) {
+    const app = new Hono();
+    if (config.adminToken) {
+        app.use("*", requireBearer(config.adminToken));
+    }
+    else {
+        console.warn("[handoff-routes] No adminToken configured -- handoff endpoints are unauthenticated");
+    }
+    // POST /handoff -- Initiate handoff (transition to queued or human_active)
+    app.post("/handoff", async (c) => {
+        const trace = new TraceContext();
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ success: false, error: "Invalid JSON body" }, 400);
+        }
+        if (!body.tenantId || !body.userId || !body.targetMode) {
+            return c.json({ success: false, error: "Missing required fields: tenantId, userId, targetMode" }, 400);
+        }
+        trace.log("handoff", "Initiating handoff", { tenantId: body.tenantId, userId: body.userId, targetMode: body.targetMode });
+        const session = await config.sessionRegistry.get(config.appName, body.userId, body.tenantId);
+        if (!session) {
+            return c.json({ success: false, error: "Session not found" }, 404);
+        }
+        const previousMode = session.sessionMode;
+        try {
+            session.setSessionMode(body.targetMode);
+            await config.sessionRegistry.save(session);
+        }
+        catch (err) {
+            if (err instanceof KilnError && (err.code === "INVALID_SESSION_TRANSITION" || err.code === "CONCURRENT_SESSION_MODIFICATION")) {
+                return c.json({ success: false, error: err.message }, 409);
+            }
+            throw err;
+        }
+        if (config.eventEmitter && session.tenantId) {
+            config.eventEmitter.emit({
+                eventType: "HANDOFF_INITIATED",
+                tenantId: session.tenantId,
+                channel: "api",
+                externalUserId: body.userId,
+                sessionMode: session.sessionMode,
+                escalationReason: body.reason,
+                operatorId: body.operatorId,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        trace.log("handoff", "Handoff complete", { sessionId: session.id, previousMode, newMode: session.sessionMode });
+        return c.json({
+            success: true,
+            sessionId: session.id,
+            previousMode,
+            newMode: session.sessionMode,
+        });
+    });
+    // POST /release -- Release session back to AI
+    app.post("/release", async (c) => {
+        const trace = new TraceContext();
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ success: false, error: "Invalid JSON body" }, 400);
+        }
+        if (!body.tenantId || !body.userId) {
+            return c.json({ success: false, error: "Missing required fields: tenantId, userId" }, 400);
+        }
+        trace.log("handoff", "Releasing session to AI", { tenantId: body.tenantId, userId: body.userId });
+        const session = await config.sessionRegistry.get(config.appName, body.userId, body.tenantId);
+        if (!session) {
+            return c.json({ success: false, error: "Session not found" }, 404);
+        }
+        const previousMode = session.sessionMode;
+        try {
+            session.setSessionMode("ai_active");
+            if (body.contextSummary) {
+                session.addUserMessage(textParts("[Handoff context] " + body.contextSummary));
+            }
+            await config.sessionRegistry.save(session);
+        }
+        catch (err) {
+            if (err instanceof KilnError && (err.code === "INVALID_SESSION_TRANSITION" || err.code === "CONCURRENT_SESSION_MODIFICATION")) {
+                return c.json({ success: false, error: err.message }, 409);
+            }
+            throw err;
+        }
+        if (config.eventEmitter && session.tenantId) {
+            config.eventEmitter.emit({
+                eventType: "HANDOFF_RELEASED",
+                tenantId: session.tenantId,
+                channel: "api",
+                externalUserId: body.userId,
+                sessionMode: "ai_active",
+                summary: body.contextSummary,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        trace.log("handoff", "Release complete", { sessionId: session.id, previousMode });
+        return c.json({
+            success: true,
+            sessionId: session.id,
+            previousMode,
+            newMode: "ai_active",
+        });
+    });
+    // POST /operator-message -- Send human-authored message to end user
+    app.post("/operator-message", async (c) => {
+        const trace = new TraceContext();
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ success: false, error: "Invalid JSON body" }, 400);
+        }
+        if (!body.tenantId || !body.userId || !body.message || !body.channel) {
+            return c.json({ success: false, error: "Missing required fields: tenantId, userId, message, channel" }, 400);
+        }
+        trace.log("handoff", "Sending operator message", { tenantId: body.tenantId, userId: body.userId, channel: body.channel });
+        const session = await config.sessionRegistry.get(config.appName, body.userId, body.tenantId);
+        if (!session) {
+            return c.json({ success: false, error: "Session not found" }, 404);
+        }
+        if (session.sessionMode === "ai_active" || session.sessionMode === "resolved") {
+            return c.json({ success: false, error: `Cannot send operator message in ${session.sessionMode} mode` }, 409);
+        }
+        // Inject message into session history as assistant message
+        session.injectOperatorMessage(textParts(body.message));
+        await config.sessionRegistry.save(session);
+        // Deliver via channel
+        if (body.channel === "web") {
+            if (config.webChannel) {
+                const payload = JSON.stringify({
+                    type: "output",
+                    text: body.message,
+                    parts: textParts(body.message),
+                    target: "session",
+                    userId: body.userId,
+                });
+                config.webChannel.sendToUser(body.userId, payload);
+            }
+        }
+        else if (body.channel === "whatsapp") {
+            const tenant = config.tenantRegistry.get(body.tenantId);
+            if (!tenant || !tenant.whatsappPhoneNumberId || !tenant.whatsappAccessToken) {
+                return c.json({ success: false, error: "Tenant has no WhatsApp credentials configured" }, 422);
+            }
+            const accessToken = tenant.whatsappAccessToken.startsWith("$")
+                ? (process.env[tenant.whatsappAccessToken.slice(1)] ?? tenant.whatsappAccessToken)
+                : tenant.whatsappAccessToken;
+            try {
+                await sendWhatsAppMessage(tenant.whatsappPhoneNumberId, accessToken, body.userId, {
+                    type: "text",
+                    text: { body: body.message },
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return c.json({ success: false, error: `WhatsApp delivery failed: ${message}` }, 502);
+            }
+        }
+        if (config.eventEmitter && session.tenantId) {
+            config.eventEmitter.emit({
+                eventType: "OPERATOR_MESSAGE_SENT",
+                tenantId: session.tenantId,
+                channel: body.channel,
+                externalUserId: body.userId,
+                messageContent: body.message,
+                messageRole: "operator",
+                operatorId: body.operatorId,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        trace.log("handoff", "Operator message delivered", { channel: body.channel });
+        return c.json({ success: true, delivered: true });
+    });
+    // GET /session-history -- Get full conversation history
+    app.get("/session-history", async (c) => {
+        const trace = new TraceContext();
+        const tenantId = c.req.query("tenantId");
+        const userId = c.req.query("userId");
+        if (!tenantId || !userId) {
+            return c.json({ success: false, error: "Missing required query params: tenantId, userId" }, 400);
+        }
+        trace.log("handoff", "Retrieving session history", { tenantId, userId });
+        const session = await config.sessionRegistry.get(config.appName, userId, tenantId);
+        if (!session) {
+            return c.json({ success: false, error: "Session not found" }, 404);
+        }
+        return c.json({
+            sessionId: session.id,
+            mode: session.sessionMode,
+            messageCount: session.messageCount,
+            history: session.conversationHistory,
+            createdAt: session.createdAt.toISOString(),
+            lastActivityAt: session.lastActivityAt.toISOString(),
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=handoff-routes.js.map

package/dist/gateway/handoff-routes.js.map

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

package/dist/gateway/message-pipeline.d.ts

@@ -0,0 +1,49 @@
+import type { ContentPart } 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 { ConversationEventEmitter } from "./conversation-event-emitter.js";
+import type { SessionMode } from "../session/session-mode.js";
+import type { EscalationSignal } from "../session/escalation-detector.js";
+export interface InboundMessageContext {
+    readonly orchestrator: ModeBOrchestrator;
+    readonly sessionRegistry: SessionRegistry;
+    readonly appName: string;
+    readonly tenantId?: string;
+    readonly userId: string;
+    readonly systemPrompt: string;
+    readonly userParts: readonly ContentPart[];
+    readonly billing?: BillingConfig;
+    readonly eventEmitter?: ConversationEventEmitter;
+    readonly channel: string;
+    readonly idleTimeoutMs?: number;
+    readonly recalledMemory?: string;
+    readonly callBuiltinTools?: ReadonlyMap<string, (input: Record<string, unknown>) => Promise<unknown>>;
+    readonly traceId?: string;
+}
+export interface InboundMessageResult {
+    readonly parts: readonly ContentPart[];
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly queued: boolean;
+    readonly sessionId: string;
+    readonly sessionMode: SessionMode;
+    readonly escalation?: EscalationSignal;
+    readonly contextSummary?: string;
+    readonly traceId: string;
+}
+export interface BudgetDeniedResult {
+    readonly budgetExhausted: true;
+    readonly message: string;
+}
+export type ProcessResult = {
+    ok: true;
+    result: InboundMessageResult;
+} | {
+    ok: false;
+    budgetDenied: BudgetDeniedResult;
+};
+export declare function processInboundMessage(ctx: InboundMessageContext): Promise<ProcessResult>;
+//# sourceMappingURL=message-pipeline.d.ts.map

package/dist/gateway/message-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-pipeline.d.ts","sourceRoot":"","sources":["../../src/gateway/message-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,mCAAmC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAG1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAC1C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEpD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8G9F"}

package/dist/gateway/message-pipeline.js

@@ -0,0 +1,99 @@
+import { checkBudget, reportUsage } from "./budget-middleware.js";
+import { TraceContext } from "./trace-context.js";
+export async function processInboundMessage(ctx) {
+    const trace = new TraceContext(ctx.traceId);
+    trace.log("pipeline", "Processing inbound message", { appName: ctx.appName, userId: ctx.userId, channel: ctx.channel });
+    // Budget check
+    if (ctx.billing) {
+        const budgetResult = await checkBudget(ctx.billing, ctx.tenantId ?? ctx.userId);
+        if (!budgetResult.allowed) {
+            trace.log("pipeline", "Budget denied");
+            return {
+                ok: false,
+                budgetDenied: {
+                    budgetExhausted: true,
+                    message: ctx.billing.overBudgetMessage ?? "Budget exhausted.",
+                },
+            };
+        }
+    }
+    // Get or create session
+    const session = await ctx.sessionRegistry.getOrCreate({
+        appName: ctx.appName,
+        tenantId: ctx.tenantId,
+        userId: ctx.userId,
+        systemPrompt: ctx.systemPrompt,
+        idleTimeoutMs: ctx.idleTimeoutMs,
+    });
+    trace.log("pipeline", "Session ready", { sessionId: session.id, sessionMode: session.sessionMode });
+    // Process message
+    const result = await ctx.orchestrator.processMessage(session, ctx.userParts, ctx.recalledMemory, ctx.callBuiltinTools);
+    // Persist mutated session (required for non-reference stores like Redis)
+    await ctx.sessionRegistry.save(session);
+    // Report usage (fire-and-forget)
+    if (ctx.billing) {
+        reportUsage(ctx.billing, {
+            tenantId: ctx.tenantId ?? ctx.userId,
+            messages: 1,
+            tokens: result.inputTokens + result.outputTokens,
+            model: ctx.orchestrator.model ?? "unknown",
+        });
+    }
+    // Emit events (fire-and-forget)
+    if (ctx.eventEmitter && ctx.tenantId) {
+        ctx.eventEmitter.emit({
+            eventType: "MESSAGE_RECEIVED",
+            tenantId: ctx.tenantId,
+            channel: ctx.channel,
+            externalUserId: ctx.userId,
+            traceId: trace.traceId,
+            timestamp: new Date().toISOString(),
+        });
+        // Emit HANDOFF_MESSAGE_QUEUED when message was queued (session not ai_active)
+        if (result.queued) {
+            ctx.eventEmitter.emit({
+                eventType: "HANDOFF_MESSAGE_QUEUED",
+                tenantId: ctx.tenantId,
+                channel: ctx.channel,
+                externalUserId: ctx.userId,
+                sessionMode: session.sessionMode,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // Emit ESCALATION_DETECTED when escalation signal is present
+        if (result.escalation) {
+            trace.warn("pipeline", "Escalation detected", { reason: result.escalation.reason });
+            ctx.eventEmitter.emit({
+                eventType: "ESCALATION_DETECTED",
+                tenantId: ctx.tenantId,
+                channel: ctx.channel,
+                externalUserId: ctx.userId,
+                escalationReason: result.escalation.reason,
+                escalationDetail: result.escalation.detail,
+                summary: result.contextSummary,
+                sessionMode: session.sessionMode,
+                traceId: trace.traceId,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    trace.log("pipeline", "Message processed", { queued: result.queued, tokens: result.inputTokens + result.outputTokens });
+    return {
+        ok: true,
+        result: {
+            parts: result.parts,
+            inputTokens: result.inputTokens,
+            outputTokens: result.outputTokens,
+            cacheReadTokens: result.cacheReadTokens,
+            cacheWriteTokens: result.cacheWriteTokens,
+            queued: result.queued,
+            sessionId: session.id,
+            sessionMode: session.sessionMode,
+            escalation: result.escalation,
+            contextSummary: result.contextSummary,
+            traceId: trace.traceId,
+        },
+    };
+}
+//# sourceMappingURL=message-pipeline.js.map

package/dist/gateway/message-pipeline.js.map

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

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;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;AAI5D,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,CA2FhE"}

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

@@ -2,8 +2,9 @@
 // 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 { checkTier } from "./budget-middleware.js";
 import { requireApiKey } from "./auth-middleware.js";
+import { processInboundMessage } from "./message-pipeline.js";
 export function createModeBRoutes(runtime) {
     const app = new Hono();
     if (runtime.apiKey) {
@@ -27,60 +28,50 @@ 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,
-                    });
-                }
-            }
         }
-        // Get or create session
-        const session = runtime.sessionRegistry.getOrCreate({
-            appName: runtime.appName,
-            userId: body.userId,
-            systemPrompt: runtime.systemPrompt,
-        });
-        // Process message
-        let result;
+        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: runtime.systemPrompt,
+                userParts,
+                billing: runtime.billing,
+                channel: "api",
+            });
         }
         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 +82,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;

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

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

package/dist/gateway/outbound-routes.d.ts

@@ -0,0 +1,9 @@
+import { Hono } from "hono";
+import type { TenantRegistry } from "../tenant/tenant-registry.js";
+export interface OutboundRoutesConfig {
+    readonly tenantRegistry: TenantRegistry;
+    readonly appName: string;
+    readonly adminToken?: string;
+}
+export declare function createOutboundRoutes(config: OutboundRoutesConfig): Hono;
+//# sourceMappingURL=outbound-routes.d.ts.map

package/dist/gateway/outbound-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-routes.d.ts","sourceRoot":"","sources":["../../src/gateway/outbound-routes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAeD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CA8EvE"}

package/dist/gateway/outbound-routes.js

@@ -0,0 +1,66 @@
+// Gateway: Outbound send routes -- Hono sub-app for business-initiated messages
+// Generic mechanism: product backends call this to send messages through any channel.
+// Kilvo (and future products) own the policy (when to send, to whom, compliance).
+import { Hono } from "hono";
+import { sendWhatsAppMessage, sendWhatsAppTemplate } from "../channels/whatsapp-api.js";
+import { requireBearer } from "./auth-middleware.js";
+export function createOutboundRoutes(config) {
+    const app = new Hono();
+    if (config.adminToken) {
+        app.use("*", requireBearer(config.adminToken));
+    }
+    app.post("/send", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ success: false, error: "Invalid JSON body" }, 400);
+        }
+        if (!body.tenantId || !body.channel || !body.to || !body.type) {
+            return c.json({ success: false, error: "Missing required fields: tenantId, channel, to, type" }, 400);
+        }
+        if (body.channel !== "whatsapp") {
+            return c.json({ success: false, error: `Unsupported channel: ${body.channel}` }, 400);
+        }
+        const tenant = config.tenantRegistry.get(body.tenantId);
+        if (!tenant || tenant.appName !== config.appName) {
+            return c.json({ success: false, error: "Tenant not found" }, 404);
+        }
+        if (!tenant.whatsappPhoneNumberId || !tenant.whatsappAccessToken) {
+            return c.json({ success: false, error: "Tenant has no WhatsApp credentials configured" }, 422);
+        }
+        const accessToken = tenant.whatsappAccessToken.startsWith("$")
+            ? (process.env[tenant.whatsappAccessToken.slice(1)] ?? tenant.whatsappAccessToken)
+            : tenant.whatsappAccessToken;
+        try {
+            let result;
+            if (body.type === "template") {
+                if (!body.template?.name || !body.template?.language) {
+                    return c.json({ success: false, error: "Template sends require template.name and template.language" }, 400);
+                }
+                result = await sendWhatsAppTemplate(tenant.whatsappPhoneNumberId, accessToken, body.to, body.template.name, body.template.language, body.template.components);
+            }
+            else {
+                if (!body.text) {
+                    return c.json({ success: false, error: "Text sends require text field" }, 400);
+                }
+                const res = await sendWhatsAppMessage(tenant.whatsappPhoneNumberId, accessToken, body.to, { type: "text", text: { body: body.text } });
+                const json = (await res.json());
+                const messageId = json.messages?.[0]?.id;
+                if (!messageId) {
+                    throw new Error("WhatsApp API returned no message ID");
+                }
+                result = { whatsappMessageId: messageId };
+            }
+            return c.json({ success: true, whatsappMessageId: result.whatsappMessageId });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[outbound] Send failed tenant=${body.tenantId} to=${body.to}: ${message}`);
+            return c.json({ success: false, error: message }, 502);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=outbound-routes.js.map

package/dist/gateway/outbound-routes.js.map

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