@kilnai/runtime 0.1.1

package/dist/channels/whatsapp-channel.js

@@ -0,0 +1,85 @@
+// WhatsAppChannel: WhatsApp Business API adapter
+// Uses WhatsApp Cloud API (graph.facebook.com) via shared API client
+import { extractText, textParts } from "@kilnai/core";
+import { formatForChannel } from "./message-formatter.js";
+import { sendWhatsAppMessage } from "./whatsapp-api.js";
+/**
+ * Channel adapter for WhatsApp Business API.
+ * receive() accepts parsed webhook messages from WhatsApp Cloud API.
+ * send() posts text messages via graph.facebook.com.
+ * stream() sends each engine event as a summarized text message.
+ * verifyWebhook() handles the one-time webhook verification handshake.
+ */
+export class WhatsAppChannel {
+    name = "whatsapp";
+    defaultFormat = "short";
+    supportedModalities = ["text", "image", "audio", "file"];
+    config;
+    messageHandler = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Register a handler for incoming messages (from parsed webhook payloads) */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async receive(message) {
+        if (this.messageHandler) {
+            this.messageHandler(message);
+        }
+    }
+    async send(response) {
+        const { phoneNumberId, accessToken } = this.config;
+        const to = response.target;
+        // Send media parts first, then text
+        for (const part of response.parts) {
+            if (part.type === "image" && part.url) {
+                await sendWhatsAppMessage(phoneNumberId, accessToken, to, {
+                    type: "image",
+                    image: { link: part.url },
+                });
+            }
+            else if (part.type === "audio" && part.url) {
+                await sendWhatsAppMessage(phoneNumberId, accessToken, to, {
+                    type: "audio",
+                    audio: { link: part.url },
+                });
+            }
+            else if (part.type === "file" && part.url) {
+                await sendWhatsAppMessage(phoneNumberId, accessToken, to, {
+                    type: "document",
+                    document: { link: part.url, filename: part.filename },
+                });
+            }
+        }
+        // Send text content
+        const text = extractText(response.parts);
+        if (text) {
+            const formatted = formatForChannel(text, response.format ?? this.defaultFormat);
+            await sendWhatsAppMessage(phoneNumberId, accessToken, to, {
+                type: "text",
+                text: { body: formatted },
+            });
+        }
+    }
+    async stream(events) {
+        for await (const event of events) {
+            await this.send({
+                parts: textParts(`[${event.type}] ${JSON.stringify(event.payload)}`),
+                target: "stream",
+                format: this.defaultFormat,
+            });
+        }
+    }
+    /**
+     * Verify a WhatsApp webhook subscription request.
+     * Returns the challenge string if mode is "subscribe" and token matches, else null.
+     */
+    verifyWebhook(mode, token, challenge) {
+        if (mode === "subscribe" && token === this.config.verifyToken) {
+            return challenge;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=whatsapp-channel.js.map

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

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

package/dist/gateway/app-resolver.d.ts

@@ -0,0 +1,11 @@
+import type { App, ModeBConfig } from "@kilnai/core";
+import type { GatewayConfig, GatewayAppBinding } from "@kilnai/core";
+export interface ResolvedApp {
+    readonly name: string;
+    readonly app: App;
+    readonly binding: GatewayAppBinding;
+    readonly memoryBasePath: string;
+    readonly modeBConfig?: ModeBConfig;
+}
+export declare function resolveApps(config: GatewayConfig, gatewayYamlDir: string): ResolvedApp[];
+//# sourceMappingURL=app-resolver.d.ts.map

package/dist/gateway/app-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-resolver.d.ts","sourceRoot":"","sources":["../../src/gateway/app-resolver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,EAAE,CAmCxF"}

package/dist/gateway/app-resolver.js

@@ -0,0 +1,36 @@
+// Gateway: AppResolver -- resolves GatewayConfig app bindings to loaded App composites
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parseAppYaml, parseModeBConfig, KilnError } from "@kilnai/core";
+export function resolveApps(config, gatewayYamlDir) {
+    return config.apps.map((binding) => {
+        const configPath = join(gatewayYamlDir, binding.config);
+        let content;
+        try {
+            content = readFileSync(configPath, "utf-8");
+        }
+        catch {
+            throw new KilnError("CONFIG_INVALID", `Failed to load App config at ${binding.config}: file not found`, {
+                context: { configPath: binding.config },
+            });
+        }
+        let app;
+        try {
+            app = parseAppYaml(content);
+        }
+        catch (err) {
+            throw new KilnError("CONFIG_INVALID", `Failed to parse App config at ${binding.config}: ${err instanceof Error ? err.message : String(err)}`, { context: { configPath: binding.config }, cause: err });
+        }
+        const memoryBasePath = join(homedir(), ".kiln", "gateway", binding.name);
+        let modeBConfig;
+        try {
+            modeBConfig = parseModeBConfig(content) ?? undefined;
+        }
+        catch {
+            // Mode B parse failure is non-fatal: app may be Mode A
+        }
+        return { name: binding.name, app, binding, memoryBasePath, modeBConfig };
+    });
+}
+//# sourceMappingURL=app-resolver.js.map

package/dist/gateway/app-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-resolver.js","sourceRoot":"","sources":["../../src/gateway/app-resolver.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAYzE,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,cAAsB;IACvE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAExD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,gCAAgC,OAAO,CAAC,MAAM,kBAAkB,EAAE;gBACtG,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;aACxC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CACjB,gBAAgB,EAChB,iCAAiC,OAAO,CAAC,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACtG,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CACxD,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEzE,IAAI,WAAoC,CAAC;QACzC,IAAI,CAAC;YACH,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/gateway/approval-registry.d.ts

@@ -0,0 +1,19 @@
+export interface ApprovalTarget {
+    readonly approve: () => void;
+    readonly reject: (reason: string) => void;
+    readonly status: () => string;
+}
+export declare class ApprovalGateRegistry {
+    private readonly targets;
+    register(sessionId: string, target: ApprovalTarget): void;
+    unregister(sessionId: string): void;
+    approve(sessionId?: string): {
+        ok: boolean;
+        error?: string;
+    };
+    reject(reason: string, sessionId?: string): {
+        ok: boolean;
+        error?: string;
+    };
+}
+//# sourceMappingURL=approval-registry.d.ts.map

package/dist/gateway/approval-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-registry.d.ts","sourceRoot":"","sources":["../../src/gateway/approval-registry.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAIzD,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAqB5D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAoB5E"}

package/dist/gateway/approval-registry.js

@@ -0,0 +1,49 @@
+// ApprovalGateRegistry -- tracks approval targets (orchestrators) by session ID
+export class ApprovalGateRegistry {
+    targets = new Map();
+    register(sessionId, target) {
+        this.targets.set(sessionId, target);
+    }
+    unregister(sessionId) {
+        this.targets.delete(sessionId);
+    }
+    approve(sessionId) {
+        if (sessionId !== undefined) {
+            const target = this.targets.get(sessionId);
+            if (!target)
+                return { ok: false, error: `Session not found: ${sessionId}` };
+            if (target.status() !== "awaiting_approval") {
+                return { ok: false, error: `Session ${sessionId} is not awaiting approval` };
+            }
+            target.approve();
+            return { ok: true };
+        }
+        for (const target of this.targets.values()) {
+            if (target.status() === "awaiting_approval") {
+                target.approve();
+                return { ok: true };
+            }
+        }
+        return { ok: false, error: "No approval pending" };
+    }
+    reject(reason, sessionId) {
+        if (sessionId !== undefined) {
+            const target = this.targets.get(sessionId);
+            if (!target)
+                return { ok: false, error: `Session not found: ${sessionId}` };
+            if (target.status() !== "awaiting_approval") {
+                return { ok: false, error: `Session ${sessionId} is not awaiting approval` };
+            }
+            target.reject(reason);
+            return { ok: true };
+        }
+        for (const target of this.targets.values()) {
+            if (target.status() === "awaiting_approval") {
+                target.reject(reason);
+                return { ok: true };
+            }
+        }
+        return { ok: false, error: "No approval pending" };
+    }
+}
+//# sourceMappingURL=approval-registry.js.map

package/dist/gateway/approval-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-registry.js","sourceRoot":"","sources":["../../src/gateway/approval-registry.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAQhF,MAAM,OAAO,oBAAoB;IACd,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE7D,QAAQ,CAAC,SAAiB,EAAE,MAAsB;QAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,SAAkB;QACxB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC;YAC5E,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,SAAS,2BAA2B,EAAE,CAAC;YAC/E,CAAC;YACD,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC5C,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,SAAkB;QACvC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,SAAS,EAAE,EAAE,CAAC;YAC5E,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,SAAS,2BAA2B,EAAE,CAAC;YAC/E,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,mBAAmB,EAAE,CAAC;gBAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IACrD,CAAC;CACF"}

package/dist/gateway/budget-middleware.d.ts

@@ -0,0 +1,47 @@
+/** Budget check result */
+export interface BudgetCheckResult {
+    readonly allowed: boolean;
+    readonly remaining: number;
+    readonly unit: string;
+    readonly overBudgetMessage?: string;
+}
+/** Tier enforcement check result */
+export interface TierCheckResult {
+    readonly allowed: boolean;
+    readonly requestedTier: string;
+    readonly allowedTiers: readonly string[];
+}
+/** Billing configuration (matches ModeBConfig.billing from @kilnai/core) */
+export interface BillingConfig {
+    readonly budgetEndpoint: string;
+    readonly usageEndpoint: string;
+    readonly overBudgetMessage: string;
+    readonly tiers?: Readonly<Record<string, {
+        readonly agents: readonly string[];
+    }>>;
+}
+/** Usage report sent to product API */
+interface UsageReport {
+    readonly tokens: number;
+    readonly model: string;
+    readonly role: string;
+}
+/**
+ * Check if the user has remaining budget.
+ * Interpolates {userId} in the budget endpoint URL.
+ * Fail-open: returns allowed=true on any fetch error or when circuit is open.
+ */
+export declare function checkBudget(billing: BillingConfig, userId: string): Promise<BudgetCheckResult>;
+/**
+ * Report token usage to the product API.
+ * Interpolates {userId} in the usage endpoint URL.
+ * Fire-and-forget: errors are logged but not thrown.
+ */
+export declare function reportUsage(billing: BillingConfig, userId: string, usage: UsageReport): Promise<void>;
+/**
+ * Check if the requested agent tier is allowed for the user's plan.
+ * Fail-open: returns allowed=true if no tiers configured or plan not found.
+ */
+export declare function checkTier(billing: BillingConfig, userPlan: string, requestedTier: string): TierCheckResult;
+export {};
+//# sourceMappingURL=budget-middleware.d.ts.map

package/dist/gateway/budget-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-middleware.d.ts","sourceRoot":"","sources":["../../src/gateway/budget-middleware.ts"],"names":[],"mappings":"AAcA,0BAA0B;AAC1B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;CACnF;AAQD,uCAAuC;AACvC,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CA6B5B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,eAAe,CAWjB"}

package/dist/gateway/budget-middleware.js

@@ -0,0 +1,88 @@
+// Budget enforcement middleware for Mode B apps
+// Checks remaining budget before LLM calls and reports usage after
+//
+// DESIGN RATIONALE (Fail-Open):
+// This middleware intentionally fails OPEN (allows requests when budget API is unavailable).
+// This prevents billing infrastructure issues from blocking user access to the service.
+// If the budget API is down, users can continue using the service - revenue/budget
+// tracking may be temporarily affected but service availability is preserved.
+//
+// Use case: Multi-tenant SaaS where service availability is prioritized over
+// strict budget enforcement. For strict budget enforcement, use a different pattern.
+import { CircuitBreaker } from "@kilnai/core";
+/** Shared circuit breaker for budget API calls */
+const budgetCircuitBreaker = new CircuitBreaker({
+    failureThreshold: 5,
+    resetTimeoutMs: 30000,
+    halfOpenMaxAttempts: 1,
+});
+/**
+ * Check if the user has remaining budget.
+ * Interpolates {userId} in the budget endpoint URL.
+ * Fail-open: returns allowed=true on any fetch error or when circuit is open.
+ */
+export async function checkBudget(billing, userId) {
+    // If circuit is open, fail open immediately (consistent with current behavior)
+    if (budgetCircuitBreaker.currentState === "open") {
+        return { allowed: true, remaining: -1, unit: "unknown" };
+    }
+    try {
+        return await budgetCircuitBreaker.execute(async () => {
+            const url = billing.budgetEndpoint.replace("{userId}", userId);
+            const res = await fetch(url);
+            if (!res.ok) {
+                // Fail-open: billing failures should not block users
+                return { allowed: true, remaining: -1, unit: "unknown" };
+            }
+            const data = (await res.json());
+            if (data.remaining <= 0) {
+                return {
+                    allowed: false,
+                    remaining: data.remaining,
+                    unit: data.unit,
+                    overBudgetMessage: billing.overBudgetMessage,
+                };
+            }
+            return { allowed: true, remaining: data.remaining, unit: data.unit };
+        });
+    }
+    catch {
+        // Fail-open on network/fetch errors or circuit open
+        return { allowed: true, remaining: -1, unit: "unknown" };
+    }
+}
+/**
+ * Report token usage to the product API.
+ * Interpolates {userId} in the usage endpoint URL.
+ * Fire-and-forget: errors are logged but not thrown.
+ */
+export async function reportUsage(billing, userId, usage) {
+    const url = billing.usageEndpoint.replace("{userId}", userId);
+    try {
+        await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(usage),
+        });
+    }
+    catch {
+        // Fire-and-forget: errors logged but not thrown
+    }
+}
+/**
+ * Check if the requested agent tier is allowed for the user's plan.
+ * Fail-open: returns allowed=true if no tiers configured or plan not found.
+ */
+export function checkTier(billing, userPlan, requestedTier) {
+    if (!billing.tiers) {
+        return { allowed: true, requestedTier, allowedTiers: [] };
+    }
+    const tier = billing.tiers[userPlan];
+    if (!tier) {
+        // Fail-open: unknown plan allows everything
+        return { allowed: true, requestedTier, allowedTiers: [] };
+    }
+    const allowed = tier.agents.includes(requestedTier);
+    return { allowed, requestedTier, allowedTiers: tier.agents };
+}
+//# sourceMappingURL=budget-middleware.js.map

package/dist/gateway/budget-middleware.js.map

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

package/dist/gateway/config-validator.d.ts

@@ -0,0 +1,31 @@
+export interface ConfigValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly {
+        field: string;
+        message: string;
+    }[];
+}
+/**
+ * Validate all required configuration at gateway startup.
+ * Checks environment variables, config values, and service URLs.
+ * Returns all errors at once -- does not fail on first error.
+ */
+export declare function validateStartupConfig(config: {
+    modeBApps?: readonly {
+        provider: string;
+        apiKeyEnv: string;
+    }[];
+    whatsapp?: {
+        verifyTokenEnv: string;
+        accessTokenEnv: string;
+    };
+    tenantAdmin?: {
+        adminTokenEnv: string;
+    };
+}): ConfigValidationResult;
+/**
+ * Validate startup config and throw if invalid.
+ * Call this during gateway startup before creating providers.
+ */
+export declare function assertValidStartupConfig(config: Parameters<typeof validateStartupConfig>[0]): void;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/gateway/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../src/gateway/config-validator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,SAAS,CAAC,EAAE,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,QAAQ,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,WAAW,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,GAAG,sBAAsB,CAoDzB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAYlG"}

package/dist/gateway/config-validator.js

@@ -0,0 +1,68 @@
+import { KilnError } from "@kilnai/core";
+/**
+ * Validate all required configuration at gateway startup.
+ * Checks environment variables, config values, and service URLs.
+ * Returns all errors at once -- does not fail on first error.
+ */
+export function validateStartupConfig(config) {
+    const errors = [];
+    // Validate app provider API keys for Mode B apps
+    if (config.modeBApps) {
+        for (const modeBApp of config.modeBApps) {
+            if (modeBApp.apiKeyEnv) {
+                const value = process.env[modeBApp.apiKeyEnv];
+                if (!value || value.trim() === "") {
+                    errors.push({
+                        field: `modeBApps.${modeBApp.provider}.apiKeyEnv`,
+                        message: `Environment variable '${modeBApp.apiKeyEnv}' is required but not set`,
+                    });
+                }
+            }
+        }
+    }
+    // Validate WhatsApp configuration if present
+    if (config.whatsapp) {
+        const verifyValue = process.env[config.whatsapp.verifyTokenEnv];
+        if (!verifyValue || verifyValue.trim() === "") {
+            errors.push({
+                field: "whatsapp.verifyTokenEnv",
+                message: `Environment variable '${config.whatsapp.verifyTokenEnv}' is required but not set`,
+            });
+        }
+        const accessValue = process.env[config.whatsapp.accessTokenEnv];
+        if (!accessValue || accessValue.trim() === "") {
+            errors.push({
+                field: "whatsapp.accessTokenEnv",
+                message: `Environment variable '${config.whatsapp.accessTokenEnv}' is required but not set`,
+            });
+        }
+    }
+    // Validate tenant admin configuration if present
+    if (config.tenantAdmin) {
+        const adminValue = process.env[config.tenantAdmin.adminTokenEnv];
+        if (!adminValue || adminValue.trim() === "") {
+            errors.push({
+                field: "tenantAdmin.adminTokenEnv",
+                message: `Environment variable '${config.tenantAdmin.adminTokenEnv}' is required but not set`,
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Validate startup config and throw if invalid.
+ * Call this during gateway startup before creating providers.
+ */
+export function assertValidStartupConfig(config) {
+    const result = validateStartupConfig(config);
+    if (!result.valid) {
+        throw new KilnError("CONFIG_MISSING_ENV", `Startup configuration invalid:\n${result.errors.map((e) => `  ${e.field}: ${e.message}`).join("\n")}`, {
+            context: { errors: result.errors },
+            retryable: false,
+        });
+    }
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/gateway/config-validator.js.map

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

package/dist/gateway/delegation-handler.d.ts

@@ -0,0 +1,53 @@
+import type { ProviderAdapter, A2AMessage } from "@kilnai/core";
+import type { AppDelegation, AppDelegationResult, DelegationError } from "@kilnai/core";
+import { A2AClient } from "../a2a/a2a-client.js";
+/** Minimal info about a loaded app available as delegation target */
+export interface DelegationTarget {
+    readonly appName: string;
+    readonly provider: ProviderAdapter;
+    readonly systemPrompt: string;
+}
+/** Registry of apps available for delegation */
+export interface DelegationRegistry {
+    readonly targets: ReadonlyMap<string, DelegationTarget>;
+}
+/** Configuration for A2A delegation */
+export interface A2ADelegationConfig {
+    readonly type: "a2a";
+    readonly agentUrl: string;
+    readonly message: A2AMessage;
+    readonly timeout?: number;
+}
+/** Extended delegation type for A2A routing */
+export interface ExtendedDelegation extends AppDelegation {
+    readonly delegationType?: "a2a";
+    readonly agentUrl?: string;
+    readonly a2aMessage?: A2AMessage;
+}
+/** Result of lightweight JSON Schema validation */
+export interface SchemaValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Validate response data against a simplified JSON Schema subset.
+ * Checks type, required fields, and property types.
+ */
+export declare function validateResponseSchema(data: unknown, schema: Record<string, unknown>): SchemaValidationResult;
+/**
+ * Execute a delegation request.
+ * Routes to A2A or Kiln-native delegation based on delegationType field.
+ * Returns AppDelegationResult on success, DelegationError on failure.
+ */
+export declare function executeDelegation(delegation: ExtendedDelegation, registry: DelegationRegistry, a2aClient?: A2AClient): Promise<AppDelegationResult | DelegationError>;
+/**
+ * Execute a Kiln-native delegation request.
+ * Returns AppDelegationResult on success, DelegationError on failure.
+ */
+export declare function executeKilnDelegation(delegation: AppDelegation, registry: DelegationRegistry): Promise<AppDelegationResult | DelegationError>;
+/**
+ * Execute an A2A delegation request to a remote agent.
+ * Returns AppDelegationResult on success, DelegationError on failure.
+ */
+export declare function executeA2ADelegation(a2aConfig: A2ADelegationConfig, fromApp: string, client?: A2AClient): Promise<AppDelegationResult | DelegationError>;
+//# sourceMappingURL=delegation-handler.d.ts.map

package/dist/gateway/delegation-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-handler.d.ts","sourceRoot":"","sources":["../../src/gateway/delegation-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMjD,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACzD;AAED,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,sBAAsB,CAmExB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,mBAAmB,GAAG,eAAe,CAAC,CAwBhD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,mBAAmB,GAAG,eAAe,CAAC,CAyGhD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,mBAAmB,GAAG,eAAe,CAAC,CA0EhD"}