@kilnai/core 0.1.0

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

@@ -0,0 +1,33 @@
+import type { ObservabilityConfig } from "./observability-config.js";
+/** Channel binding for a specific platform adapter */
+export interface GatewayChannelBinding {
+    readonly type: string;
+    readonly path?: string;
+    readonly phoneNumber?: string;
+    readonly botToken?: string;
+    readonly multiTenant?: boolean;
+    readonly verifyTokenEnv?: string;
+    readonly adminTokenEnv?: string;
+    readonly [key: string]: unknown;
+}
+/** App binding: name, config path, optional workspace, and channel bindings */
+export interface GatewayAppBinding {
+    readonly name: string;
+    readonly config: string;
+    readonly workspace?: string;
+    readonly channels: readonly GatewayChannelBinding[];
+}
+/** Top-level gateway configuration: port + multiple app bindings + optional observability */
+export interface GatewayConfig {
+    readonly port: number;
+    readonly apps: readonly GatewayAppBinding[];
+    readonly observability?: ObservabilityConfig;
+}
+/** Validation error for gateway configuration */
+export interface GatewayValidationError {
+    readonly field: string;
+    readonly message: string;
+}
+/** Validate a GatewayConfig. Returns array of errors; empty means valid. */
+export declare function validateGatewayConfig(config: GatewayConfig): GatewayValidationError[];
+//# sourceMappingURL=gateway-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-config.d.ts","sourceRoot":"","sources":["../../../src/engine/gateway/gateway-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACrD;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAC9C;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,sBAAsB,EAAE,CA6DrF"}

package/dist/engine/gateway/gateway-config.js

@@ -0,0 +1,61 @@
+// Engine type: GatewayConfig -- multi-app gateway configuration
+// Declares which Apps to host and how they bind to channels
+/** Validate a GatewayConfig. Returns array of errors; empty means valid. */
+export function validateGatewayConfig(config) {
+    const errors = [];
+    // Port must be a positive integer in valid TCP range
+    if (!Number.isInteger(config.port) || config.port < 1 || config.port > 65535) {
+        errors.push({ field: "port", message: "must be an integer between 1 and 65535" });
+    }
+    // Apps array must be non-empty
+    if (!config.apps || config.apps.length === 0) {
+        errors.push({ field: "apps", message: "must have at least one app" });
+        return errors;
+    }
+    const seenNames = new Set();
+    const seenPaths = new Set();
+    const seenPhoneNumbers = new Set();
+    for (let i = 0; i < config.apps.length; i++) {
+        const app = config.apps[i];
+        const prefix = `apps[${i}]`;
+        if (!app.name || typeof app.name !== "string") {
+            errors.push({ field: `${prefix}.name`, message: "must be a non-empty string" });
+        }
+        else if (seenNames.has(app.name)) {
+            errors.push({ field: `${prefix}.name`, message: `duplicate app name "${app.name}"` });
+        }
+        else {
+            seenNames.add(app.name);
+        }
+        if (!app.config || typeof app.config !== "string") {
+            errors.push({ field: `${prefix}.config`, message: "must be a non-empty string" });
+        }
+        if (!app.channels || app.channels.length === 0) {
+            errors.push({ field: `${prefix}.channels`, message: "must have at least one channel binding" });
+        }
+        else {
+            for (let j = 0; j < app.channels.length; j++) {
+                const channel = app.channels[j];
+                const channelPrefix = `${prefix}.channels[${j}]`;
+                if (channel.path && typeof channel.path === "string") {
+                    if (seenPaths.has(channel.path)) {
+                        errors.push({ field: `${channelPrefix}.path`, message: `duplicate API path "${channel.path}"` });
+                    }
+                    else {
+                        seenPaths.add(channel.path);
+                    }
+                }
+                if (channel.phoneNumber && typeof channel.phoneNumber === "string") {
+                    if (seenPhoneNumbers.has(channel.phoneNumber)) {
+                        errors.push({ field: `${channelPrefix}.phoneNumber`, message: `duplicate phone number "${channel.phoneNumber}"` });
+                    }
+                    else {
+                        seenPhoneNumbers.add(channel.phoneNumber);
+                    }
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=gateway-config.js.map

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

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

package/dist/engine/gateway/gateway-loader.d.ts

@@ -0,0 +1,10 @@
+import { KilnError } from "../errors.js";
+import type { GatewayConfig, GatewayValidationError } from "./gateway-config.js";
+/** Error class for gateway YAML loader failures, aggregating all validation errors */
+export declare class GatewayLoaderError extends KilnError {
+    readonly errors: readonly GatewayValidationError[];
+    constructor(errors: readonly GatewayValidationError[]);
+}
+/** Parse a YAML string into a typed GatewayConfig. Throws GatewayLoaderError if invalid. */
+export declare function parseGatewayYaml(content: string): GatewayConfig;
+//# sourceMappingURL=gateway-loader.d.ts.map

package/dist/engine/gateway/gateway-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-loader.d.ts","sourceRoot":"","sources":["../../../src/engine/gateway/gateway-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAA4C,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAK3H,sFAAsF;AACtF,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;gBAEvC,MAAM,EAAE,SAAS,sBAAsB,EAAE;CAStD;AAuFD,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA6E/D"}

package/dist/engine/gateway/gateway-loader.js

@@ -0,0 +1,150 @@
+// Engine loader: GatewayLoader -- parses gateway YAML into typed config
+// Does NOT load individual App YAML files
+import { parse } from "yaml";
+import { KilnError } from "../errors.js";
+import { validateGatewayConfig } from "./gateway-config.js";
+import { validateObservabilityConfig } from "./observability-config.js";
+/** Error class for gateway YAML loader failures, aggregating all validation errors */
+export class GatewayLoaderError extends KilnError {
+    errors;
+    constructor(errors) {
+        const msg = errors.map((e) => `  ${e.field}: ${e.message}`).join("\n");
+        super("GATEWAY_YAML_INVALID", `Invalid gateway YAML:\n${msg}`, {
+            context: { errors },
+            retryable: false,
+        });
+        this.name = "GatewayLoaderError";
+        this.errors = errors;
+    }
+}
+// ---------------------------------------------------------------------------
+// Mapping helpers
+// ---------------------------------------------------------------------------
+function mapChannelBinding(raw) {
+    const binding = {};
+    if (typeof raw.type === "string")
+        binding["type"] = raw.type;
+    else
+        binding["type"] = "";
+    if (typeof raw.path === "string")
+        binding["path"] = raw.path;
+    if (typeof raw.phoneNumber === "string")
+        binding["phoneNumber"] = raw.phoneNumber;
+    if (typeof raw.botToken === "string")
+        binding["botToken"] = raw.botToken;
+    // Preserve any additional channel-specific keys
+    for (const [key, value] of Object.entries(raw)) {
+        if (key !== "type" && key !== "path" && key !== "phoneNumber" && key !== "botToken") {
+            binding[key] = value;
+        }
+    }
+    return binding;
+}
+function mapAppBinding(raw, path) {
+    const errors = [];
+    if (!raw.name || typeof raw.name !== "string") {
+        errors.push({ field: `${path}.name`, message: "must be a non-empty string" });
+    }
+    if (!raw.config || typeof raw.config !== "string") {
+        errors.push({ field: `${path}.config`, message: "must be a non-empty string" });
+    }
+    const channels = [];
+    if (!raw.channels || !Array.isArray(raw.channels)) {
+        errors.push({ field: `${path}.channels`, message: "must be a non-empty array" });
+    }
+    else {
+        for (const ch of raw.channels) {
+            if (ch && typeof ch === "object" && !Array.isArray(ch)) {
+                channels.push(mapChannelBinding(ch));
+            }
+        }
+    }
+    const binding = {
+        name: typeof raw.name === "string" ? raw.name : "",
+        config: typeof raw.config === "string" ? raw.config : "",
+        ...(typeof raw.workspace === "string" ? { workspace: raw.workspace } : {}),
+        channels,
+    };
+    return { binding, errors };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Parse a YAML string into a typed GatewayConfig. Throws GatewayLoaderError if invalid. */
+export function parseGatewayYaml(content) {
+    let data;
+    try {
+        data = parse(content);
+    }
+    catch (err) {
+        throw new GatewayLoaderError([{ field: "yaml", message: String(err) }]);
+    }
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new GatewayLoaderError([{ field: "root", message: "must be a YAML object" }]);
+    }
+    const raw = data;
+    const errors = [];
+    // port defaults to 4800
+    let port = 4800;
+    if (raw.port !== undefined) {
+        if (typeof raw.port !== "number") {
+            errors.push({ field: "port", message: "must be a number" });
+        }
+        else {
+            port = raw.port;
+        }
+    }
+    // apps
+    const apps = [];
+    if (!raw.apps || !Array.isArray(raw.apps)) {
+        errors.push({ field: "apps", message: "must be a non-empty array" });
+    }
+    else {
+        for (let i = 0; i < raw.apps.length; i++) {
+            const rawApp = raw.apps[i];
+            if (!rawApp || typeof rawApp !== "object" || Array.isArray(rawApp)) {
+                errors.push({ field: `apps[${i}]`, message: "must be an object" });
+                continue;
+            }
+            const { binding, errors: appErrors } = mapAppBinding(rawApp, `apps[${i}]`);
+            apps.push(binding);
+            errors.push(...appErrors);
+        }
+    }
+    if (errors.length > 0)
+        throw new GatewayLoaderError(errors);
+    // Parse optional observability block
+    let observability;
+    if (raw.observability !== undefined) {
+        if (typeof raw.observability !== "object" || Array.isArray(raw.observability) || raw.observability === null) {
+            errors.push({ field: "observability", message: "must be an object" });
+        }
+        else {
+            const rawObs = raw.observability;
+            const parsed = {
+                enabled: typeof rawObs["enabled"] === "boolean" ? rawObs["enabled"] : true,
+                exporter: rawObs["exporter"] ?? "none",
+                ...(typeof rawObs["endpoint"] === "string" ? { endpoint: rawObs["endpoint"] } : {}),
+                serviceName: typeof rawObs["serviceName"] === "string" ? rawObs["serviceName"] : "",
+                ...(rawObs["attributes"] && typeof rawObs["attributes"] === "object" && !Array.isArray(rawObs["attributes"])
+                    ? { attributes: rawObs["attributes"] }
+                    : {}),
+            };
+            const obsErrors = validateObservabilityConfig(parsed);
+            if (obsErrors.length > 0) {
+                errors.push(...obsErrors);
+            }
+            else {
+                observability = parsed;
+            }
+        }
+    }
+    if (errors.length > 0)
+        throw new GatewayLoaderError(errors);
+    const config = { port, apps, ...(observability ? { observability } : {}) };
+    const validationErrors = validateGatewayConfig(config);
+    if (validationErrors.length > 0)
+        throw new GatewayLoaderError(validationErrors);
+    return config;
+}
+//# sourceMappingURL=gateway-loader.js.map

package/dist/engine/gateway/gateway-loader.js.map

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

package/dist/engine/gateway/mode-b-config.d.ts

@@ -0,0 +1,44 @@
+/** Runtime mode: "claude-code" for Mode A, "provider-adapter" for Mode B */
+export type RuntimeMode = "claude-code" | "provider-adapter";
+/** Provider configuration for Mode B Apps */
+export interface ProviderConfig {
+    readonly name: string;
+    readonly model?: string;
+    readonly apiKeyEnv?: string;
+}
+/** Billing tier: which agent tiers a plan level allows */
+export interface BillingTier {
+    readonly agents: readonly string[];
+}
+/** Billing configuration for budget enforcement */
+export interface BillingConfig {
+    readonly budgetEndpoint: string;
+    readonly usageEndpoint: string;
+    readonly overBudgetMessage: string;
+    readonly tiers?: Readonly<Record<string, BillingTier>>;
+}
+/** Budget response from product API */
+export interface BudgetResponse {
+    readonly remaining: number;
+    readonly unit: "tokens" | "requests";
+}
+/** Usage report sent to product API */
+export interface UsageReport {
+    readonly tokens: number;
+    readonly model: string;
+    readonly role: string;
+}
+/** Full Mode B configuration parsed from App YAML */
+export interface ModeBConfig {
+    readonly runtime: RuntimeMode;
+    readonly provider: ProviderConfig;
+    readonly billing?: BillingConfig;
+}
+/** Validation error for Mode B configuration */
+export interface ModeBValidationError {
+    readonly field: string;
+    readonly message: string;
+}
+/** Validate a ModeBConfig. Returns array of errors; empty means valid. */
+export declare function validateModeBConfig(config: ModeBConfig): ModeBValidationError[];
+//# sourceMappingURL=mode-b-config.d.ts.map

package/dist/engine/gateway/mode-b-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-b-config.d.ts","sourceRoot":"","sources":["../../../src/engine/gateway/mode-b-config.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAE7D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,mDAAmD;AACnD,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,WAAW,CAAC,CAAC,CAAC;CACxD;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;CACtC;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,oBAAoB,EAAE,CA8C/E"}

package/dist/engine/gateway/mode-b-config.js

@@ -0,0 +1,45 @@
+// Engine type: ModeBConfig -- provider-adapter runtime configuration
+// Parsed from the same App YAML as the App composite, by a separate parser
+/** Validate a ModeBConfig. Returns array of errors; empty means valid. */
+export function validateModeBConfig(config) {
+    const errors = [];
+    // runtime must be a valid value
+    if (config.runtime !== "claude-code" && config.runtime !== "provider-adapter") {
+        errors.push({ field: "runtime", message: 'must be "claude-code" or "provider-adapter"' });
+    }
+    // if runtime is "provider-adapter", provider.name must be non-empty
+    if (config.runtime === "provider-adapter") {
+        if (!config.provider.name || typeof config.provider.name !== "string") {
+            errors.push({ field: "provider.name", message: "must be a non-empty string" });
+        }
+    }
+    // billing validations
+    if (config.billing !== undefined) {
+        if (!config.billing.budgetEndpoint || typeof config.billing.budgetEndpoint !== "string") {
+            errors.push({ field: "billing.budgetEndpoint", message: "must be a non-empty string" });
+        }
+        if (!config.billing.usageEndpoint || typeof config.billing.usageEndpoint !== "string") {
+            errors.push({ field: "billing.usageEndpoint", message: "must be a non-empty string" });
+        }
+        if (!config.billing.overBudgetMessage || typeof config.billing.overBudgetMessage !== "string") {
+            errors.push({ field: "billing.overBudgetMessage", message: "must be a non-empty string" });
+        }
+        if (config.billing.tiers !== undefined) {
+            for (const [tierName, tier] of Object.entries(config.billing.tiers)) {
+                if (!tier.agents || tier.agents.length === 0) {
+                    errors.push({ field: `billing.tiers.${tierName}.agents`, message: "must be a non-empty array" });
+                }
+                else {
+                    for (let i = 0; i < tier.agents.length; i++) {
+                        const agent = tier.agents[i];
+                        if (!agent || typeof agent !== "string") {
+                            errors.push({ field: `billing.tiers.${tierName}.agents[${i}]`, message: "must be a non-empty string" });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=mode-b-config.js.map

package/dist/engine/gateway/mode-b-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-b-config.js","sourceRoot":"","sources":["../../../src/engine/gateway/mode-b-config.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,2EAA2E;AAmD3E,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,gCAAgC;IAChC,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,IAAI,MAAM,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,oEAAoE;IACpE,IAAI,MAAM,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YAC9F,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,QAAQ,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBACnG,CAAC;qBAAM,CAAC;oBACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;wBAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BACxC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,QAAQ,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;wBAC1G,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/gateway/mode-b-loader.d.ts

@@ -0,0 +1,14 @@
+import { KilnError } from "../errors.js";
+import type { ModeBConfig, ModeBValidationError } from "./mode-b-config.js";
+/** Error class for Mode B YAML loader failures */
+export declare class ModeBLoaderError extends KilnError {
+    readonly errors: readonly ModeBValidationError[];
+    constructor(errors: readonly ModeBValidationError[]);
+}
+/**
+ * Parse a YAML string and extract Mode B config fields.
+ * Returns null if the YAML does not have runtime: "provider-adapter" (it's a Mode A app).
+ * Throws ModeBLoaderError if runtime is "provider-adapter" but config is invalid.
+ */
+export declare function parseModeBConfig(content: string): ModeBConfig | null;
+//# sourceMappingURL=mode-b-loader.d.ts.map

package/dist/engine/gateway/mode-b-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-b-loader.d.ts","sourceRoot":"","sources":["../../../src/engine/gateway/mode-b-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAA8C,MAAM,oBAAoB,CAAC;AAGxH,kDAAkD;AAClD,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;gBAErC,MAAM,EAAE,SAAS,oBAAoB,EAAE;CASpD;AAiFD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4CpE"}

package/dist/engine/gateway/mode-b-loader.js

@@ -0,0 +1,104 @@
+// Engine loader: ModeBLoader -- parses Mode B config from App YAML
+// Extracts runtime, provider, and billing fields from the same YAML as parseAppYaml()
+import { parse } from "yaml";
+import { KilnError } from "../errors.js";
+import { validateModeBConfig } from "./mode-b-config.js";
+/** Error class for Mode B YAML loader failures */
+export class ModeBLoaderError extends KilnError {
+    errors;
+    constructor(errors) {
+        const msg = errors.map((e) => `  ${e.field}: ${e.message}`).join("\n");
+        super("MODE_B_CONFIG_INVALID", `Invalid Mode B config:\n${msg}`, {
+            context: { errors },
+            retryable: false,
+        });
+        this.name = "ModeBLoaderError";
+        this.errors = errors;
+    }
+}
+// ---------------------------------------------------------------------------
+// Mapping helpers
+// ---------------------------------------------------------------------------
+function mapProvider(raw) {
+    const provider = {
+        name: typeof raw.name === "string" ? raw.name : "",
+    };
+    if (typeof raw.model === "string")
+        provider.model = raw.model;
+    if (typeof raw.apiKeyEnv === "string")
+        provider.apiKeyEnv = raw.apiKeyEnv;
+    return provider;
+}
+function mapBillingTier(raw) {
+    const agents = [];
+    if (Array.isArray(raw.agents)) {
+        for (const agent of raw.agents) {
+            if (typeof agent === "string")
+                agents.push(agent);
+        }
+    }
+    return { agents };
+}
+function mapBilling(raw) {
+    const billing = {
+        budgetEndpoint: typeof raw.budgetEndpoint === "string" ? raw.budgetEndpoint : "",
+        usageEndpoint: typeof raw.usageEndpoint === "string" ? raw.usageEndpoint : "",
+        overBudgetMessage: typeof raw.overBudgetMessage === "string" ? raw.overBudgetMessage : "",
+    };
+    if (raw.tiers && typeof raw.tiers === "object" && !Array.isArray(raw.tiers)) {
+        const tiers = {};
+        for (const [tierName, tierValue] of Object.entries(raw.tiers)) {
+            if (tierValue && typeof tierValue === "object" && !Array.isArray(tierValue)) {
+                tiers[tierName] = mapBillingTier(tierValue);
+            }
+        }
+        billing.tiers = tiers;
+    }
+    return billing;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a YAML string and extract Mode B config fields.
+ * Returns null if the YAML does not have runtime: "provider-adapter" (it's a Mode A app).
+ * Throws ModeBLoaderError if runtime is "provider-adapter" but config is invalid.
+ */
+export function parseModeBConfig(content) {
+    let data;
+    try {
+        data = parse(content);
+    }
+    catch (err) {
+        throw new ModeBLoaderError([{ field: "yaml", message: String(err) }]);
+    }
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new ModeBLoaderError([{ field: "root", message: "must be a YAML object" }]);
+    }
+    const raw = data;
+    // runtime defaults to "claude-code"
+    const runtime = typeof raw.runtime === "string" ? raw.runtime : "claude-code";
+    // if not Mode B, return null
+    if (runtime !== "provider-adapter") {
+        return null;
+    }
+    // extract provider
+    const provider = raw.provider && typeof raw.provider === "object" && !Array.isArray(raw.provider)
+        ? mapProvider(raw.provider)
+        : { name: "" };
+    // extract billing if present
+    let billing;
+    if (raw.billing && typeof raw.billing === "object" && !Array.isArray(raw.billing)) {
+        billing = mapBilling(raw.billing);
+    }
+    const config = {
+        runtime: "provider-adapter",
+        provider,
+        ...(billing !== undefined ? { billing } : {}),
+    };
+    const errors = validateModeBConfig(config);
+    if (errors.length > 0)
+        throw new ModeBLoaderError(errors);
+    return config;
+}
+//# sourceMappingURL=mode-b-loader.js.map

package/dist/engine/gateway/mode-b-loader.js.map

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

package/dist/engine/gateway/observability-config.d.ts

@@ -0,0 +1,19 @@
+import type { GatewayValidationError } from "./gateway-config.js";
+/** Supported OTel exporter backends */
+export type ObservabilityExporter = "otlp" | "console" | "none";
+/** Top-level observability configuration for gateway.yaml */
+export interface ObservabilityConfig {
+    /** Whether observability is active. Defaults to true when the block is present. */
+    readonly enabled: boolean;
+    /** Which exporter to use: otlp (OTLP/HTTP), console (stdout), or none (disable). */
+    readonly exporter: ObservabilityExporter;
+    /** OTLP collector endpoint. Required when exporter is "otlp". */
+    readonly endpoint?: string;
+    /** Service name reported to the OTel backend. */
+    readonly serviceName: string;
+    /** Optional custom resource attributes attached to all spans. */
+    readonly attributes?: Record<string, string>;
+}
+/** Validate an ObservabilityConfig. Returns array of errors; empty means valid. */
+export declare function validateObservabilityConfig(config: ObservabilityConfig): GatewayValidationError[];
+//# sourceMappingURL=observability-config.d.ts.map

package/dist/engine/gateway/observability-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.d.ts","sourceRoot":"","sources":["../../../src/engine/gateway/observability-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,uCAAuC;AACvC,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,mFAAmF;AACnF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,sBAAsB,EAAE,CA4BjG"}

package/dist/engine/gateway/observability-config.js

@@ -0,0 +1,27 @@
+// Engine type: ObservabilityConfig -- optional top-level OTel observability configuration for gateway.yaml
+/** Validate an ObservabilityConfig. Returns array of errors; empty means valid. */
+export function validateObservabilityConfig(config) {
+    const errors = [];
+    const prefix = "observability";
+    if (!config.serviceName || typeof config.serviceName !== "string" || config.serviceName.trim() === "") {
+        errors.push({ field: `${prefix}.serviceName`, message: "must be a non-empty string" });
+    }
+    const validExporters = ["otlp", "console", "none"];
+    if (!validExporters.includes(config.exporter)) {
+        errors.push({ field: `${prefix}.exporter`, message: `must be one of: ${validExporters.join(", ")}` });
+    }
+    if (config.exporter === "otlp") {
+        if (!config.endpoint || typeof config.endpoint !== "string" || config.endpoint.trim() === "") {
+            errors.push({ field: `${prefix}.endpoint`, message: "required when exporter is \"otlp\"" });
+        }
+    }
+    if (config.attributes !== undefined) {
+        for (const [key, value] of Object.entries(config.attributes)) {
+            if (typeof value !== "string") {
+                errors.push({ field: `${prefix}.attributes.${key}`, message: "attribute values must be strings" });
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=observability-config.js.map

package/dist/engine/gateway/observability-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-config.js","sourceRoot":"","sources":["../../../src/engine/gateway/observability-config.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAqB3G,mFAAmF;AACnF,MAAM,UAAU,2BAA2B,CAAC,MAA2B;IACnE,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC;IAE/B,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpG,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,cAAc,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,cAAc,GAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5E,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,OAAO,EAAE,mBAAmB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3F,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,WAAW,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;QAChG,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,GAAG,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;YACvG,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/engine/gateway/tenant-config.d.ts

@@ -0,0 +1,59 @@
+/** A service offered by the tenant business */
+export interface TenantService {
+    readonly name: string;
+    readonly description?: string;
+    readonly price?: string;
+    readonly duration?: string;
+}
+/** A contact person for escalation */
+export interface TenantContact {
+    readonly name: string;
+    readonly phone?: string;
+    readonly email?: string;
+}
+/** Business operating hours, keyed by day name */
+export interface TenantHours {
+    readonly [day: string]: string;
+}
+/** FAQ entry: question and response */
+export interface TenantFaqEntry {
+    readonly q: string;
+    readonly r: string;
+}
+/** Tone of the AI assistant's responses */
+export type TenantTone = "formal" | "friendly" | "casual";
+/** Per-tenant billing configuration (overrides App-level billing) */
+export interface TenantBilling {
+    readonly budgetEndpoint?: string;
+    readonly usageEndpoint?: string;
+    readonly overBudgetMessage?: string;
+}
+/** Full tenant configuration for a business within a multi-tenant App */
+export interface TenantConfig {
+    readonly tenantId: string;
+    readonly appName: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly services?: readonly TenantService[];
+    readonly hours?: TenantHours;
+    readonly faqEntries?: readonly TenantFaqEntry[];
+    readonly escalationContact?: TenantContact;
+    readonly tone?: TenantTone;
+    readonly language?: string;
+    readonly whatsappPhoneNumberId?: string;
+    readonly whatsappAccessToken?: string;
+    readonly whatsappVerifyToken?: string;
+    readonly billing?: TenantBilling;
+    readonly idleTimeoutMs?: number;
+    readonly enabled: boolean;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** Validation error for tenant configuration */
+export interface TenantValidationError {
+    readonly field: string;
+    readonly message: string;
+}
+/** Validate a TenantConfig. Returns array of errors; empty means valid. */
+export declare function validateTenantConfig(config: TenantConfig): TenantValidationError[];
+//# sourceMappingURL=tenant-config.d.ts.map