@kilnai/runtime 0.1.16 → 0.9.1

package/dist/observability/prometheus-collector.js

@@ -0,0 +1,169 @@
+/**
+ * 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;
+                for (const [, role] of Object.entries(e.byRoleModel)) {
+                    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/mode-b-orchestrator.d.ts

@@ -1,6 +1,13 @@
 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";
@@ -15,6 +22,24 @@ export interface OrchestratorDeps {
     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[];
@@ -25,6 +50,23 @@ export interface OrchestrateResult {
     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;
@@ -38,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;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,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;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;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;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;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;YAyLf,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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"}