@kilnai/runtime 0.1.15 → 0.9.0

package/dist/gateway/handoff-routes.js

@@ -0,0 +1,253 @@
+// 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 { sendInstagramMessage } from "../channels/instagram-api.js";
+import { sendMessengerMessage } from "../channels/messenger-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);
+            }
+        }
+        else if (body.channel === "instagram") {
+            const tenant = config.tenantRegistry.get(body.tenantId);
+            if (!tenant || !tenant.instagramPageId || !tenant.instagramAccessToken) {
+                return c.json({ success: false, error: "Tenant has no Instagram credentials configured" }, 422);
+            }
+            const accessToken = tenant.instagramAccessToken.startsWith("$")
+                ? (process.env[tenant.instagramAccessToken.slice(1)] ?? tenant.instagramAccessToken)
+                : tenant.instagramAccessToken;
+            try {
+                await sendInstagramMessage(tenant.instagramPageId, accessToken, body.userId, body.message);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return c.json({ success: false, error: `Instagram delivery failed: ${message}` }, 502);
+            }
+        }
+        else if (body.channel === "messenger") {
+            const tenant = config.tenantRegistry.get(body.tenantId);
+            if (!tenant || !tenant.messengerPageId || !tenant.messengerAccessToken) {
+                return c.json({ success: false, error: "Tenant has no Messenger credentials configured" }, 422);
+            }
+            const accessToken = tenant.messengerAccessToken.startsWith("$")
+                ? (process.env[tenant.messengerAccessToken.slice(1)] ?? tenant.messengerAccessToken)
+                : tenant.messengerAccessToken;
+            try {
+                await sendMessengerMessage(accessToken, body.userId, body.message);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return c.json({ success: false, error: `Messenger delivery failed: ${message}` }, 502);
+            }
+        }
+        else if (body.channel === "email") {
+            // Email operator messages are injected into session history but not auto-delivered.
+            // Email is async -- operators reply directly via their email client.
+            trace.log("handoff", "Email operator message recorded in session (delivery via email client)");
+        }
+        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/instagram-webhook-routes.d.ts

@@ -0,0 +1,30 @@
+import { Hono } from "hono";
+import type { ModeBOrchestrator } from "../session/mode-b-orchestrator.js";
+import type { SessionRegistry } from "../session/session-registry.js";
+import type { TenantRegistry } from "../tenant/tenant-registry.js";
+import type { AgentHandoffSummarizer } from "../session/agent-handoff-summarizer.js";
+import type { EventBus } from "@kilnai/core";
+import type { BillingConfig } from "./budget-middleware.js";
+import type { ConversationEventEmitter } from "./conversation-event-emitter.js";
+import type { WebhookDedup } from "./webhook-dedup.js";
+import type { SttAdapter, RetrievalPipeline, ContactMemoryService } from "@kilnai/core";
+export interface InstagramWebhookConfig {
+    readonly appName: string;
+    readonly orchestrator: ModeBOrchestrator;
+    readonly sessionRegistry: SessionRegistry;
+    readonly tenantRegistry: TenantRegistry;
+    readonly verifyToken: string;
+    readonly appSecret?: string;
+    readonly billing?: BillingConfig;
+    readonly eventEmitter?: ConversationEventEmitter;
+    readonly memoryBasePath?: string;
+    readonly sttAdapter?: SttAdapter;
+    readonly knowledgePipeline?: RetrievalPipeline;
+    readonly knowledgeMode?: "auto" | "tool";
+    readonly contactMemoryService?: ContactMemoryService;
+    readonly dedup?: WebhookDedup;
+    readonly handoffSummarizer?: AgentHandoffSummarizer;
+    readonly eventBus?: EventBus;
+}
+export declare function createInstagramWebhookRoutes(config: InstagramWebhookConfig): Hono;
+//# sourceMappingURL=instagram-webhook-routes.d.ts.map

package/dist/gateway/instagram-webhook-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram-webhook-routes.d.ts","sourceRoot":"","sources":["../../src/gateway/instagram-webhook-routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,mCAAmC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAIhF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIxF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAuFD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CA6EjF"}