@kilnai/runtime 0.1.15 → 0.9.0

package/dist/observability/prometheus-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prometheus-collector.d.ts","sourceRoot":"","sources":["../../src/observability/prometheus-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,oDAAoD;AACpD,UAAU,YAAY;IACpB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IAaxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZnC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAGT;IACP,OAAO,CAAC,UAAU,CAGX;IACP,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;gBAEpB,MAAM,GAAE,yBAA8B;YAIrD,UAAU;IAkFxB,4DAA4D;IACtD,WAAW,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK3C,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsFrC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAItD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1E,OAAO,CAAC,aAAa;CAWtB"}

package/dist/observability/prometheus-collector.js

@@ -0,0 +1,170 @@
+/**
+ * EventStore implementation that updates Prometheus counters and histograms.
+ * Requires `prom-client` as an optional peer dependency.
+ * Write-only: getBySession/getAfter are not supported.
+ */
+export class PrometheusCollector {
+    config;
+    registry = null;
+    counters = {};
+    histograms = {};
+    initialized = false;
+    initPromise = null;
+    constructor(config = {}) {
+        this.config = config;
+        this.initPromise = this.initialize();
+    }
+    async initialize() {
+        try {
+            const prom = await import("prom-client");
+            const prefix = this.config.prefix ?? "kiln";
+            const registry = new prom.Registry();
+            // Counters
+            this.counters.llm_requests = new prom.Counter({
+                name: `${prefix}_llm_requests_total`,
+                help: "Total LLM requests",
+                labelNames: ["provider", "model", "status"],
+                registers: [registry],
+            });
+            this.counters.llm_tokens = new prom.Counter({
+                name: `${prefix}_llm_tokens_total`,
+                help: "Total LLM tokens",
+                labelNames: ["direction", "provider", "model"],
+                registers: [registry],
+            });
+            this.counters.cost_usd = new prom.Counter({
+                name: `${prefix}_cost_usd_total`,
+                help: "Total cost in USD",
+                labelNames: ["provider", "model"],
+                registers: [registry],
+            });
+            this.counters.tool_calls = new prom.Counter({
+                name: `${prefix}_tool_calls_total`,
+                help: "Total tool calls",
+                labelNames: ["tool_name", "success"],
+                registers: [registry],
+            });
+            this.counters.tool_cache_hits = new prom.Counter({
+                name: `${prefix}_tool_cache_hits_total`,
+                help: "Total tool cache hits",
+                labelNames: ["tool_name"],
+                registers: [registry],
+            });
+            this.counters.errors = new prom.Counter({
+                name: `${prefix}_errors_total`,
+                help: "Total errors",
+                labelNames: ["code"],
+                registers: [registry],
+            });
+            this.counters.agent_routings = new prom.Counter({
+                name: `${prefix}_agent_routings_total`,
+                help: "Total agent routing decisions",
+                labelNames: ["agent_name", "routing_tier"],
+                registers: [registry],
+            });
+            this.counters.model_routings = new prom.Counter({
+                name: `${prefix}_model_routings_total`,
+                help: "Total model routing decisions",
+                labelNames: ["provider", "model", "routing_tier"],
+                registers: [registry],
+            });
+            // Histograms
+            this.histograms.llm_duration = new prom.Histogram({
+                name: `${prefix}_llm_request_duration_seconds`,
+                help: "LLM request duration in seconds",
+                labelNames: ["provider", "model"],
+                buckets: [0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0],
+                registers: [registry],
+            });
+            this.registry = registry;
+            this.initialized = true;
+        }
+        catch {
+            console.warn("[prometheus] prom-client not available, metrics disabled");
+            this.initialized = false;
+        }
+    }
+    /** Get the Prometheus registry for the /metrics endpoint */
+    async getRegistry() {
+        if (this.initPromise)
+            await this.initPromise;
+        return this.registry;
+    }
+    async save(event) {
+        if (!this.initialized)
+            return;
+        switch (event.type) {
+            case "cost_update": {
+                const e = event;
+                // Extract provider/model from byRole entries
+                for (const [, role] of Object.entries(e.byRole)) {
+                    const model = role.model;
+                    const provider = this.inferProvider(model);
+                    this.counters.llm_requests?.inc({
+                        provider,
+                        model,
+                        status: "success",
+                    });
+                    this.counters.cost_usd?.inc({ provider, model }, role.costUsd);
+                }
+                this.counters.llm_tokens?.inc({ direction: "input", provider: "", model: "" }, e.inputTokens);
+                this.counters.llm_tokens?.inc({ direction: "output", provider: "", model: "" }, e.outputTokens);
+                break;
+            }
+            case "tool_result": {
+                const e = event;
+                this.counters.tool_calls?.inc({
+                    tool_name: e.toolName,
+                    success: String(e.success),
+                });
+                break;
+            }
+            case "tool_cache_hit": {
+                const e = event;
+                this.counters.tool_cache_hits?.inc({ tool_name: e.toolName });
+                break;
+            }
+            case "error": {
+                const e = event;
+                this.counters.errors?.inc({ code: e.code });
+                break;
+            }
+            case "agent_routed": {
+                const e = event;
+                this.counters.agent_routings?.inc({
+                    agent_name: e.agentName,
+                    routing_tier: e.routingTier,
+                });
+                break;
+            }
+            case "model_routed": {
+                const e = event;
+                this.counters.model_routings?.inc({
+                    provider: e.provider,
+                    model: e.model,
+                    routing_tier: e.routingTier,
+                });
+                break;
+            }
+            // Other event types: no metrics to collect
+        }
+    }
+    async getBySession(_sessionId) {
+        throw new Error("PrometheusCollector is write-only");
+    }
+    async getAfter(_sessionId, _afterId) {
+        throw new Error("PrometheusCollector is write-only");
+    }
+    inferProvider(model) {
+        if (model.startsWith("claude"))
+            return "anthropic";
+        if (model.startsWith("gpt") ||
+            model.startsWith("o1") ||
+            model.startsWith("o3"))
+            return "openai";
+        if (model.startsWith("deepseek"))
+            return "deepseek";
+        return "ollama";
+    }
+}
+//# sourceMappingURL=prometheus-collector.js.map

package/dist/observability/prometheus-collector.js.map

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

package/dist/session/agent-handoff-summarizer.d.ts

@@ -0,0 +1,11 @@
+import type { ProviderAdapter } from "@kilnai/core";
+import type { ModeBSession } from "./mode-b-session.js";
+export interface AgentHandoffSummarizer {
+    summarize(session: ModeBSession, fromAgentName: string, toAgentName: string): Promise<string>;
+}
+export declare class DefaultAgentHandoffSummarizer implements AgentHandoffSummarizer {
+    private readonly provider;
+    constructor(provider: ProviderAdapter);
+    summarize(session: ModeBSession, fromAgentName: string, toAgentName: string): Promise<string>;
+}
+//# sourceMappingURL=agent-handoff-summarizer.d.ts.map

package/dist/session/agent-handoff-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handoff-summarizer.d.ts","sourceRoot":"","sources":["../../src/session/agent-handoff-summarizer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/F;AAKD,qBAAa,6BAA8B,YAAW,sBAAsB;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,QAAQ,EAAE,eAAe;IAI/B,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBpG"}

package/dist/session/agent-handoff-summarizer.js

@@ -0,0 +1,26 @@
+// Agent handoff summarizer: generates a brief context summary for warm agent handoffs.
+// Follows the same pattern as DefaultContextSummarizer.
+import { extractText } from "@kilnai/core";
+const HANDOFF_MAX_MESSAGES = 10;
+const HANDOFF_MAX_TOKENS = 150;
+export class DefaultAgentHandoffSummarizer {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async summarize(session, fromAgentName, toAgentName) {
+        const history = session.conversationHistory;
+        const recent = history.slice(-HANDOFF_MAX_MESSAGES);
+        if (recent.length === 0)
+            return "";
+        const systemPrompt = `You are generating a handoff brief from agent "${fromAgentName}" to agent "${toAgentName}". In 2-3 sentences, summarize: what the customer needs, what has been discussed so far, and any important context the next agent should know. Be concise and actionable.`;
+        const response = await this.provider.createMessage({
+            system: systemPrompt,
+            messages: recent,
+            maxTokens: HANDOFF_MAX_TOKENS,
+        });
+        const brief = extractText(response.parts);
+        return brief ? `[Handoff from ${fromAgentName}]: ${brief}` : "";
+    }
+}
+//# sourceMappingURL=agent-handoff-summarizer.js.map

package/dist/session/agent-handoff-summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handoff-summarizer.js","sourceRoot":"","sources":["../../src/session/agent-handoff-summarizer.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wDAAwD;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,OAAO,6BAA6B;IACvB,QAAQ,CAAkB;IAE3C,YAAY,QAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAqB,EAAE,aAAqB,EAAE,WAAmB;QAC/E,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;QAC5C,MAAM,MAAM,GAA4B,OAAO,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,YAAY,GAAG,kDAAkD,aAAa,eAAe,WAAW,2KAA2K,CAAC;QAE1R,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YACjD,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,iBAAiB,aAAa,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;CACF"}

package/dist/session/context-summarizer.d.ts

@@ -0,0 +1,11 @@
+import type { ProviderAdapter } from "@kilnai/core";
+import type { ModeBSession } from "./mode-b-session.js";
+export interface ContextSummarizer {
+    summarize(session: ModeBSession): Promise<string>;
+}
+export declare class DefaultContextSummarizer implements ContextSummarizer {
+    private readonly provider;
+    constructor(provider: ProviderAdapter);
+    summarize(session: ModeBSession): Promise<string>;
+}
+//# sourceMappingURL=context-summarizer.d.ts.map

package/dist/session/context-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-summarizer.d.ts","sourceRoot":"","sources":["../../src/session/context-summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAMD,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,QAAQ,EAAE,eAAe;IAI/B,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAcxD"}

package/dist/session/context-summarizer.js

@@ -0,0 +1,23 @@
+import { extractText } from "@kilnai/core";
+const SUMMARY_SYSTEM_PROMPT = "Summarize this customer conversation in 1-3 sentences for a human agent. Include: what the customer needs, what has been tried, and the current status.";
+const SUMMARY_MAX_MESSAGES = 10;
+const SUMMARY_MAX_TOKENS = 200;
+export class DefaultContextSummarizer {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async summarize(session) {
+        const history = session.conversationHistory;
+        const recent = history.slice(-SUMMARY_MAX_MESSAGES);
+        if (recent.length === 0)
+            return "No conversation history.";
+        const response = await this.provider.createMessage({
+            system: SUMMARY_SYSTEM_PROMPT,
+            messages: recent,
+            maxTokens: SUMMARY_MAX_TOKENS,
+        });
+        return extractText(response.parts);
+    }
+}
+//# sourceMappingURL=context-summarizer.js.map

package/dist/session/context-summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-summarizer.js","sourceRoot":"","sources":["../../src/session/context-summarizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C,MAAM,qBAAqB,GAAG,yJAAyJ,CAAC;AACxL,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,OAAO,wBAAwB;IAClB,QAAQ,CAAkB;IAE3C,YAAY,QAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAqB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;QAC5C,MAAM,MAAM,GAA4B,OAAO,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,0BAA0B,CAAC;QAE3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YACjD,MAAM,EAAE,qBAAqB;YAC7B,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/session/escalation-detector.d.ts

@@ -0,0 +1,27 @@
+import type { ContentPart } from "@kilnai/core";
+import type { ModeBSession } from "./mode-b-session.js";
+export interface EscalationSignal {
+    readonly reason: "keyword" | "loop" | "confidence" | "tool_failure" | "custom";
+    readonly confidence: number;
+    readonly detail: string;
+}
+export interface EscalationDetector {
+    checkPreLLM(userText: string): EscalationSignal | null;
+    checkPostLLM(session: ModeBSession, responseParts: readonly ContentPart[]): EscalationSignal | null;
+}
+export interface DefaultEscalationDetectorConfig {
+    readonly keywords?: readonly string[];
+    readonly loopThreshold?: number;
+    readonly loopWindowSize?: number;
+}
+export declare class DefaultEscalationDetector implements EscalationDetector {
+    private readonly keywords;
+    private readonly loopThreshold;
+    private readonly loopWindowSize;
+    constructor(config?: DefaultEscalationDetectorConfig);
+    checkPreLLM(userText: string): EscalationSignal | null;
+    checkPostLLM(session: ModeBSession, _responseParts: readonly ContentPart[]): EscalationSignal | null;
+}
+/** Simple word overlap similarity (Jaccard index on word sets) */
+export declare function wordOverlapSimilarity(a: string, b: string): number;
+//# sourceMappingURL=escalation-detector.d.ts.map

package/dist/session/escalation-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation-detector.d.ts","sourceRoot":"","sources":["../../src/session/escalation-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACvD,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,WAAW,EAAE,GAAG,gBAAgB,GAAG,IAAI,CAAC;CACrG;AAQD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,CAAC,EAAE,+BAA+B;IAMpD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IA+BtD,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,WAAW,EAAE,GAAG,gBAAgB,GAAG,IAAI;CAgBrG;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAclE"}

package/dist/session/escalation-detector.js

@@ -0,0 +1,75 @@
+const DEFAULT_KEYWORDS = [
+    "agent", "human", "person", "representative",
+    "agente", "humano", "persona", "representante",
+    "hablar con alguien", "talk to someone",
+];
+export class DefaultEscalationDetector {
+    keywords;
+    loopThreshold;
+    loopWindowSize;
+    constructor(config) {
+        this.keywords = config?.keywords ?? DEFAULT_KEYWORDS;
+        this.loopThreshold = config?.loopThreshold ?? 0.85;
+        this.loopWindowSize = config?.loopWindowSize ?? 3;
+    }
+    checkPreLLM(userText) {
+        const lower = userText.toLowerCase().trim();
+        // Check multi-word keywords first (they must match as full phrases)
+        for (const keyword of this.keywords) {
+            if (keyword.includes(" ")) {
+                if (lower.includes(keyword.toLowerCase())) {
+                    return {
+                        reason: "keyword",
+                        confidence: 0.9,
+                        detail: `Matched phrase: "${keyword}"`,
+                    };
+                }
+            }
+        }
+        // Check single-word keywords (must be whole words)
+        const words = lower.split(/\s+/);
+        for (const keyword of this.keywords) {
+            if (!keyword.includes(" ") && words.includes(keyword.toLowerCase())) {
+                return {
+                    reason: "keyword",
+                    confidence: 0.8,
+                    detail: `Matched keyword: "${keyword}"`,
+                };
+            }
+        }
+        return null;
+    }
+    checkPostLLM(session, _responseParts) {
+        const recentTexts = session.lastAssistantTexts(this.loopWindowSize);
+        if (recentTexts.length < this.loopWindowSize)
+            return null;
+        // Check pairwise similarity
+        for (let i = 0; i < recentTexts.length - 1; i++) {
+            const similarity = wordOverlapSimilarity(recentTexts[i], recentTexts[i + 1]);
+            if (similarity < this.loopThreshold)
+                return null;
+        }
+        return {
+            reason: "loop",
+            confidence: 0.85,
+            detail: `Last ${this.loopWindowSize} responses have similarity > ${this.loopThreshold}`,
+        };
+    }
+}
+/** Simple word overlap similarity (Jaccard index on word sets) */
+export function wordOverlapSimilarity(a, b) {
+    const setA = new Set(a.toLowerCase().split(/\s+/).filter(w => w.length > 0));
+    const setB = new Set(b.toLowerCase().split(/\s+/).filter(w => w.length > 0));
+    if (setA.size === 0 && setB.size === 0)
+        return 1.0;
+    if (setA.size === 0 || setB.size === 0)
+        return 0.0;
+    let intersection = 0;
+    for (const word of setA) {
+        if (setB.has(word))
+            intersection++;
+    }
+    const union = setA.size + setB.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+//# sourceMappingURL=escalation-detector.js.map

package/dist/session/escalation-detector.js.map

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

package/dist/session/in-memory-session-store.d.ts

@@ -0,0 +1,11 @@
+import type { ModeBSession } from "./mode-b-session.js";
+import type { SessionStore } from "./session-store.js";
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly store;
+    get(key: string): Promise<ModeBSession | undefined>;
+    set(key: string, session: ModeBSession): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    deleteByPrefix(prefix: string): Promise<number>;
+    keys(): Promise<string[]>;
+}
+//# sourceMappingURL=in-memory-session-store.d.ts.map

package/dist/session/in-memory-session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session-store.d.ts","sourceRoot":"","sources":["../../src/session/in-memory-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAEnD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAInD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW/C,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAGhC"}

package/dist/session/in-memory-session-store.js

@@ -0,0 +1,26 @@
+export class InMemorySessionStore {
+    store = new Map();
+    async get(key) {
+        return this.store.get(key);
+    }
+    async set(key, session) {
+        this.store.set(key, session);
+    }
+    async delete(key) {
+        return this.store.delete(key);
+    }
+    async deleteByPrefix(prefix) {
+        let count = 0;
+        for (const key of this.store.keys()) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    async keys() {
+        return [...this.store.keys()];
+    }
+}
+//# sourceMappingURL=in-memory-session-store.js.map

package/dist/session/in-memory-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-session-store.js","sourceRoot":"","sources":["../../src/session/in-memory-session-store.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEzD,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,OAAqB;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/session/mode-b-orchestrator.d.ts

@@ -1,7 +1,16 @@
 import type { ProviderAdapter, ContentPart, ToolDefinition } from "@kilnai/core";
 import type { McpClient } from "@kilnai/core";
 import type { EventBus } from "@kilnai/core";
+import type { Capability, ToolAuthorizer } from "@kilnai/core";
+import type { AuditLog } from "@kilnai/core";
+import type { ToolResultSanitizer } from "@kilnai/core";
+import type { ToolRAG } from "@kilnai/core";
+import type { RateLimiter } from "@kilnai/core";
+import type { ToolCache } from "@kilnai/core";
+import type { ModelRouter } from "@kilnai/core";
 import type { ModeBSession } from "./mode-b-session.js";
+import type { EscalationDetector, EscalationSignal } from "./escalation-detector.js";
+import type { ContextSummarizer } from "./context-summarizer.js";
 export interface OrchestratorDeps {
     readonly provider: ProviderAdapter;
     readonly model?: string;
@@ -11,6 +20,26 @@ export interface OrchestratorDeps {
     readonly mcpClients?: readonly McpClient[];
     readonly builtinTools?: ReadonlyMap<string, (input: Record<string, unknown>) => Promise<unknown>>;
     readonly eventBus?: EventBus;
+    readonly escalationDetector?: EscalationDetector;
+    readonly contextSummarizer?: ContextSummarizer;
+    readonly capabilityMap?: ReadonlyMap<string, Capability>;
+    readonly toolAuthorizer?: ToolAuthorizer;
+    readonly toolResultSanitizer?: ToolResultSanitizer;
+    readonly budgetChecker?: () => Promise<{
+        allowed: boolean;
+        message?: string;
+    }>;
+    readonly auditLog?: AuditLog;
+    readonly toolRAG?: ToolRAG;
+    readonly toolCache?: ToolCache;
+    readonly modelRouter?: ModelRouter;
+    readonly providerPool?: ReadonlyMap<string, ProviderAdapter>;
+}
+export interface ToolExecutionSummary {
+    readonly toolName: string;
+    readonly durationMs: number;
+    readonly success: boolean;
+    readonly resultSummary: string;
 }
 export interface OrchestrateResult {
     readonly parts: readonly ContentPart[];
@@ -18,6 +47,26 @@ export interface OrchestrateResult {
     readonly outputTokens: number;
     readonly cacheReadTokens: number;
     readonly cacheWriteTokens: number;
+    readonly queued: boolean;
+    readonly escalation?: EscalationSignal;
+    readonly contextSummary?: string;
+    readonly toolExecutions?: readonly ToolExecutionSummary[];
+    readonly routingDecision?: {
+        readonly provider: string;
+        readonly model: string;
+        readonly routingTier: string;
+        readonly reasoning: string;
+    };
+}
+export interface PerCallToolConfig {
+    readonly toolAllowlist?: ReadonlySet<string>;
+    readonly rateLimiter?: RateLimiter;
+    readonly tenantId?: string;
+    readonly additionalTools?: readonly ToolDefinition[];
+    readonly modelOverride?: {
+        readonly provider: string;
+        readonly model: string;
+    };
 }
 export declare class ModeBOrchestrator {
     private readonly deps;
@@ -31,13 +80,17 @@ export declare class ModeBOrchestrator {
     get tools(): readonly ToolDefinition[] | undefined;
     /** Register additional tool definitions at runtime (e.g. builtin tools discovered per-tenant). */
     registerTools(newTools: readonly ToolDefinition[]): void;
-    processMessage(session: ModeBSession, userParts: readonly ContentPart[], recalledMemory?: string, callBuiltinTools?: ReadonlyMap<string, (input: Record<string, unknown>) => Promise<unknown>>): Promise<OrchestrateResult>;
+    processMessage(session: ModeBSession, userParts: readonly ContentPart[], recalledMemory?: string, callBuiltinTools?: ReadonlyMap<string, (input: Record<string, unknown>) => Promise<unknown>>, perCallConfig?: PerCallToolConfig): Promise<OrchestrateResult>;
     private executeTool;
     private emitToolCalled;
+    private emitToolAuthorized;
     private emitToolResult;
+    private emitToolCacheHit;
+    private appendAudit;
     private computeTotalCostUsd;
     private get resolvedPricing();
     private emitCostUpdate;
+    private emitModelRouted;
     private emitError;
 }
 //# sourceMappingURL=mode-b-orchestrator.d.ts.map

package/dist/session/mode-b-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mode-b-orchestrator.d.ts","sourceRoot":"","sources":["../../src/session/mode-b-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,cAAc,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,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;CACnC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,iBAAiB,CAAC,CAA4E;gBAE1F,IAAI,EAAE,gBAAgB;IASlC,6FAA6F;IAC7F,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,gCAAgC;IAChC,IAAI,KAAK,IAAI,SAAS,cAAc,EAAE,GAAG,SAAS,CAEjD;IAED,kGAAkG;IAClG,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IASlD,cAAc,CAClB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,SAAS,WAAW,EAAE,EACjC,cAAc,CAAC,EAAE,MAAM,EACvB,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAC3F,OAAO,CAAC,iBAAiB,CAAC;YAuHf,WAAW;IAsBzB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,KAAK,eAAe,GAO1B;IAED,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,SAAS;CAWlB"}
+{"version":3,"file":"mode-b-orchestrator.d.ts","sourceRoot":"","sources":["../../src/session/mode-b-orchestrator.ts"],"names":[],"mappings":"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"}