@kilnai/core 0.1.0

package/dist/agents/model-pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../src/agents/model-pricing.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD,YAAY;IACZ,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;IACzG,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;IAC1G,EAAE,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE;IACtH,SAAS;IACT,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;IAC/F,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;IACxG,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;IACzF,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;IACpG,WAAW;IACX,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;IAC5G,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;IAChH,QAAQ;IACR,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE;CACjG,CAAC"}

package/dist/agents/provider-registry.d.ts

@@ -0,0 +1,25 @@
+import type { ProviderAdapter, AgentRole } from "./index.js";
+/** Registry for managing multiple LLM providers with per-role assignment. */
+export declare class ProviderRegistry {
+    private readonly adapters;
+    private readonly roleMapping;
+    private _default;
+    /** Register a provider adapter by name. */
+    register(name: string, adapter: ProviderAdapter): void;
+    /** Retrieve a provider adapter by name. */
+    get(name: string): ProviderAdapter | undefined;
+    /** Assign a specific provider to an agent role. */
+    setRoleProvider(role: AgentRole, providerName: string): void;
+    /**
+     * Get the provider for a given role.
+     * Resolution order: role-specific -> default -> first registered -> throw.
+     */
+    getForRole(role: AgentRole): ProviderAdapter;
+    /** Set the default fallback provider. */
+    defaultProvider(name: string): void;
+    /** Return all registered adapters. */
+    all(): Map<string, ProviderAdapter>;
+    /** Return role-to-provider mappings. */
+    roles(): Map<AgentRole, string>;
+}
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/agents/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/agents/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7D,6EAA6E;AAC7E,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAuB;IAEvC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAItD,2CAA2C;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI9C,mDAAmD;IACnD,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAO5D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe;IAsB5C,yCAAyC;IACzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOnC,sCAAsC;IACtC,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAInC,wCAAwC;IACxC,KAAK,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC;CAGhC"}

package/dist/agents/provider-registry.js

@@ -0,0 +1,62 @@
+/** Registry for managing multiple LLM providers with per-role assignment. */
+export class ProviderRegistry {
+    adapters = new Map();
+    roleMapping = new Map();
+    _default = null;
+    /** Register a provider adapter by name. */
+    register(name, adapter) {
+        this.adapters.set(name, adapter);
+    }
+    /** Retrieve a provider adapter by name. */
+    get(name) {
+        return this.adapters.get(name);
+    }
+    /** Assign a specific provider to an agent role. */
+    setRoleProvider(role, providerName) {
+        if (!this.adapters.has(providerName)) {
+            throw new Error(`Provider not registered: ${providerName}`);
+        }
+        this.roleMapping.set(role, providerName);
+    }
+    /**
+     * Get the provider for a given role.
+     * Resolution order: role-specific -> default -> first registered -> throw.
+     */
+    getForRole(role) {
+        // 1. Role-specific mapping
+        const roleName = this.roleMapping.get(role);
+        if (roleName) {
+            const adapter = this.adapters.get(roleName);
+            if (adapter)
+                return adapter;
+        }
+        // 2. Default provider
+        if (this._default) {
+            const adapter = this.adapters.get(this._default);
+            if (adapter)
+                return adapter;
+        }
+        // 3. First registered adapter
+        const first = this.adapters.values().next();
+        if (!first.done)
+            return first.value;
+        // 4. Throw
+        throw new Error(`No provider available for role: ${role}`);
+    }
+    /** Set the default fallback provider. */
+    defaultProvider(name) {
+        if (!this.adapters.has(name)) {
+            throw new Error(`Provider not registered: ${name}`);
+        }
+        this._default = name;
+    }
+    /** Return all registered adapters. */
+    all() {
+        return new Map(this.adapters);
+    }
+    /** Return role-to-provider mappings. */
+    roles() {
+        return new Map(this.roleMapping);
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/agents/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/agents/provider-registry.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,OAAO,gBAAgB;IACV,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC9C,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;IACpD,QAAQ,GAAkB,IAAI,CAAC;IAEvC,2CAA2C;IAC3C,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,mDAAmD;IACnD,eAAe,CAAC,IAAe,EAAE,YAAoB;QACnD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,IAAe;QACxB,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QAED,8BAA8B;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC;QAEpC,WAAW;QACX,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,yCAAyC;IACzC,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,sCAAsC;IACtC,GAAG;QACD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,wCAAwC;IACxC,KAAK;QACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/agents/tool-cache.d.ts

@@ -0,0 +1,13 @@
+/** In-memory tool result cache with per-entry TTL. */
+export declare class ToolCache {
+    private readonly entries;
+    /** Retrieve a cached result, or undefined if missing/expired. */
+    get(tool: string, args: Record<string, unknown>): unknown | undefined;
+    /** Store a result with the given TTL in seconds. */
+    set(tool: string, args: Record<string, unknown>, result: unknown, ttlSeconds: number): void;
+    /** Invalidate entries. No args = all entries for the tool. No tool = clear all. */
+    invalidate(tool?: string, args?: Record<string, unknown>): void;
+    /** Number of cached entries (including potentially expired). */
+    get size(): number;
+}
+//# sourceMappingURL=tool-cache.d.ts.map

package/dist/agents/tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../src/agents/tool-cache.ts"],"names":[],"mappings":"AAOA,sDAAsD;AACtD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IAEzD,iEAAiE;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;IAWrE,oDAAoD;IACpD,GAAG,CACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,GACjB,IAAI;IAQP,mFAAmF;IACnF,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAe/D,gEAAgE;IAChE,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/agents/tool-cache.js

@@ -0,0 +1,52 @@
+import { createHash } from "node:crypto";
+/** In-memory tool result cache with per-entry TTL. */
+export class ToolCache {
+    entries = new Map();
+    /** Retrieve a cached result, or undefined if missing/expired. */
+    get(tool, args) {
+        const key = cacheKey(tool, args);
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        return entry.result;
+    }
+    /** Store a result with the given TTL in seconds. */
+    set(tool, args, result, ttlSeconds) {
+        if (ttlSeconds <= 0)
+            return;
+        const expiresAt = ttlSeconds === Infinity
+            ? Infinity
+            : Date.now() + ttlSeconds * 1000;
+        this.entries.set(cacheKey(tool, args), { result, expiresAt });
+    }
+    /** Invalidate entries. No args = all entries for the tool. No tool = clear all. */
+    invalidate(tool, args) {
+        if (!tool) {
+            this.entries.clear();
+            return;
+        }
+        if (args) {
+            this.entries.delete(cacheKey(tool, args));
+            return;
+        }
+        const prefix = `${tool}:`;
+        for (const key of this.entries.keys()) {
+            if (key.startsWith(prefix))
+                this.entries.delete(key);
+        }
+    }
+    /** Number of cached entries (including potentially expired). */
+    get size() {
+        return this.entries.size;
+    }
+}
+function cacheKey(tool, args) {
+    const sorted = JSON.stringify(args, Object.keys(args).sort());
+    const hash = createHash("sha256").update(sorted).digest("hex");
+    return `${tool}:${hash}`;
+}
+//# sourceMappingURL=tool-cache.js.map

package/dist/agents/tool-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.js","sourceRoot":"","sources":["../../src/agents/tool-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,sDAAsD;AACtD,MAAM,OAAO,SAAS;IACH,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEzD,iEAAiE;IACjE,GAAG,CAAC,IAAY,EAAE,IAA6B;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,oDAAoD;IACpD,GAAG,CACD,IAAY,EACZ,IAA6B,EAC7B,MAAe,EACf,UAAkB;QAElB,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO;QAC5B,MAAM,SAAS,GAAG,UAAU,KAAK,QAAQ;YACvC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,mFAAmF;IACnF,UAAU,CAAC,IAAa,EAAE,IAA8B;QACtD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,IAA6B;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/agents/tool-rag.d.ts

@@ -0,0 +1,15 @@
+import type { Capability } from "../engine/domain/capability.js";
+import type { EmbeddingAdapter } from "../engine/domain/embedding.js";
+import type { VectorStore } from "../engine/domain/vector-store.js";
+import type { ToolSelectionConfig } from "../engine/domain/tool-selection-config.js";
+export declare class ToolRAG {
+    private readonly embedder;
+    private readonly store;
+    private readonly config;
+    private toolNameToCapability;
+    private ingested;
+    constructor(embedder: EmbeddingAdapter, store: VectorStore, config: ToolSelectionConfig);
+    ingestTools(tools: readonly Capability[]): Promise<void>;
+    selectTools(query: string, allTools: readonly Capability[]): Promise<readonly Capability[]>;
+}
+//# sourceMappingURL=tool-rag.d.ts.map

package/dist/agents/tool-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-rag.d.ts","sourceRoot":"","sources":["../../src/agents/tool-rag.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,oBAAoB,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB;IAUjF,WAAW,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC;CAuClG"}

package/dist/agents/tool-rag.js

@@ -0,0 +1,92 @@
+// ToolRAG: embeds tool descriptions and retrieves top-K relevant tools per query
+import { KilnError } from "../engine/errors.js";
+export class ToolRAG {
+    embedder;
+    store;
+    config;
+    toolNameToCapability = new Map();
+    ingested = false;
+    constructor(embedder, store, config) {
+        this.embedder = embedder;
+        this.store = store;
+        this.config = {
+            strategy: config.strategy,
+            maxTools: config.maxTools ?? 15,
+            threshold: config.threshold ?? 30,
+        };
+    }
+    async ingestTools(tools) {
+        this.toolNameToCapability.clear();
+        this.ingested = false;
+        if (tools.length === 0) {
+            this.ingested = true;
+            return;
+        }
+        const texts = [];
+        const entries = [];
+        for (const tool of tools) {
+            const text = `${tool.name}: ${tool.description}`;
+            texts.push(text);
+            this.toolNameToCapability.set(tool.name, tool);
+        }
+        try {
+            const embeddings = await this.embedder.embed(texts);
+            for (let i = 0; i < tools.length; i++) {
+                const tool = tools[i];
+                const embedding = embeddings[i];
+                if (!embedding)
+                    continue;
+                entries.push({
+                    id: `tool:${tool.name}`,
+                    content: texts[i],
+                    embedding,
+                    metadata: { toolName: tool.name },
+                });
+            }
+            await this.store.upsert(entries);
+            this.ingested = true;
+        }
+        catch (err) {
+            throw new KilnError("TOOL_RAG_FAILED", `Failed to ingest tools: ${err}`, {
+                context: { toolCount: tools.length },
+                cause: err,
+            });
+        }
+    }
+    async selectTools(query, allTools) {
+        if (allTools.length <= this.config.threshold) {
+            return allTools;
+        }
+        if (!this.ingested) {
+            return allTools.slice(0, this.config.maxTools);
+        }
+        try {
+            const embeddings = await this.embedder.embed([query]);
+            const queryEmbedding = embeddings[0];
+            if (!queryEmbedding) {
+                return allTools.slice(0, this.config.maxTools);
+            }
+            const results = await this.store.query(queryEmbedding, {
+                topK: this.config.maxTools,
+            });
+            const selectedTools = [];
+            for (const result of results) {
+                const toolName = result.metadata.toolName;
+                if (toolName) {
+                    const tool = this.toolNameToCapability.get(toolName);
+                    if (tool) {
+                        selectedTools.push(tool);
+                    }
+                }
+            }
+            return selectedTools;
+        }
+        catch (err) {
+            throw new KilnError("TOOL_RAG_FAILED", `Failed to select tools: ${err}`, {
+                context: { queryLength: query.length },
+                cause: err,
+            });
+        }
+    }
+}
+//# sourceMappingURL=tool-rag.js.map

package/dist/agents/tool-rag.js.map

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

package/dist/agents/tool-registry.d.ts

@@ -0,0 +1,29 @@
+import type { ToolDefinition } from "./index.js";
+import type { DomainConfig } from "../domain/index.js";
+/** Centralized tool storage with tag-based filtering. */
+export declare class ToolRegistry {
+    private readonly tools;
+    /** Register a single tool (overwrites if same name). */
+    register(tool: ToolDefinition): void;
+    /** Bulk-register tools. */
+    registerMany(tools: readonly ToolDefinition[]): void;
+    /** Remove a tool by name. */
+    unregister(name: string): void;
+    /** Get a tool by name. */
+    get(name: string): ToolDefinition | undefined;
+    /** Return all registered tools. */
+    all(): readonly ToolDefinition[];
+    /** Return tools matching ANY of the given tags. */
+    filterByTags(tags: ReadonlySet<string>): readonly ToolDefinition[];
+    /** Shorthand for filterByTags using a DomainConfig. */
+    filterByDomain(config: Pick<DomainConfig, "toolTags">): readonly ToolDefinition[];
+    /** Return tools with no tags (available in all domains). */
+    universal(): readonly ToolDefinition[];
+    /** Return universal + domain-specific tools, deduplicated. */
+    forDomain(config: Pick<DomainConfig, "toolTags">): readonly ToolDefinition[];
+    /** Total number of registered tools. */
+    get count(): number;
+    /** Remove all tools. */
+    clear(): void;
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/agents/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/agents/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,yDAAyD;AACzD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIpC,2BAA2B;IAC3B,YAAY,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IAMpD,6BAA6B;IAC7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,0BAA0B;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,mCAAmC;IACnC,GAAG,IAAI,SAAS,cAAc,EAAE;IAIhC,mDAAmD;IACnD,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,cAAc,EAAE;IASlE,uDAAuD;IACvD,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,SAAS,cAAc,EAAE;IAIjF,4DAA4D;IAC5D,SAAS,IAAI,SAAS,cAAc,EAAE;IAItC,8DAA8D;IAC9D,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,SAAS,cAAc,EAAE;IAW5E,wCAAwC;IACxC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAGd"}

package/dist/agents/tool-registry.js

@@ -0,0 +1,64 @@
+/** Centralized tool storage with tag-based filtering. */
+export class ToolRegistry {
+    tools = new Map();
+    /** Register a single tool (overwrites if same name). */
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /** Bulk-register tools. */
+    registerMany(tools) {
+        for (const tool of tools) {
+            this.tools.set(tool.name, tool);
+        }
+    }
+    /** Remove a tool by name. */
+    unregister(name) {
+        this.tools.delete(name);
+    }
+    /** Get a tool by name. */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** Return all registered tools. */
+    all() {
+        return [...this.tools.values()];
+    }
+    /** Return tools matching ANY of the given tags. */
+    filterByTags(tags) {
+        return [...this.tools.values()].filter((tool) => {
+            for (const tag of tool.tags) {
+                if (tags.has(tag))
+                    return true;
+            }
+            return false;
+        });
+    }
+    /** Shorthand for filterByTags using a DomainConfig. */
+    filterByDomain(config) {
+        return this.filterByTags(config.toolTags);
+    }
+    /** Return tools with no tags (available in all domains). */
+    universal() {
+        return [...this.tools.values()].filter((tool) => tool.tags.size === 0);
+    }
+    /** Return universal + domain-specific tools, deduplicated. */
+    forDomain(config) {
+        const seen = new Map();
+        for (const tool of this.universal()) {
+            seen.set(tool.name, tool);
+        }
+        for (const tool of this.filterByDomain(config)) {
+            seen.set(tool.name, tool);
+        }
+        return [...seen.values()];
+    }
+    /** Total number of registered tools. */
+    get count() {
+        return this.tools.size;
+    }
+    /** Remove all tools. */
+    clear() {
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/agents/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/agents/tool-registry.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,2BAA2B;IAC3B,YAAY,CAAC,KAAgC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,0BAA0B;IAC1B,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,mCAAmC;IACnC,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,mDAAmD;IACnD,YAAY,CAAC,IAAyB;QACpC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;YACjC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,cAAc,CAAC,MAAsC;QACnD,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,4DAA4D;IAC5D,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,8DAA8D;IAC9D,SAAS,CAAC,MAAsC;QAC9C,MAAM,IAAI,GAAG,IAAI,GAAG,EAA0B,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,wBAAwB;IACxB,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/cost/cost-tracker.d.ts

@@ -0,0 +1,27 @@
+import type { AgentRole } from "../agents/index.js";
+import type { ModelPricing, CostSummary } from "./index.js";
+/** Unified pricing derived from MODEL_CATALOG (single source of truth) */
+export declare const MODEL_PRICING: ReadonlyMap<string, ModelPricing>;
+interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+}
+/**
+ * Tracks token usage and computes costs per role with cache-aware pricing.
+ * Subscribes to EventBus cost_update events for automatic tracking.
+ */
+export declare class CostTracker {
+    private readonly usageByRole;
+    /** Record token usage for a specific role and model */
+    record(role: AgentRole, model: string, usage: TokenUsage): void;
+    /** Compute USD cost for a specific role */
+    costForRole(role: AgentRole): number;
+    /** Get full cost summary with totals and per-role breakdown */
+    get summary(): CostSummary;
+    /** Clear all accumulated usage */
+    reset(): void;
+}
+export {};
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/cost/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/cost/cost-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAa,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAOvE,0EAA0E;AAC1E,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAS3D,CAAC;AAEF,UAAU,UAAU;IAClB,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;AAaD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;IAEtE,uDAAuD;IACvD,MAAM,CACJ,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,GAChB,IAAI;IAsBP,2CAA2C;IAC3C,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAMpC,+DAA+D;IAC/D,IAAI,OAAO,IAAI,WAAW,CAuCzB;IAED,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAGd"}

package/dist/cost/cost-tracker.js

@@ -0,0 +1,103 @@
+import { MODEL_CATALOG } from "../agents/model-pricing.js";
+/** Anthropic cache multipliers (other providers don't expose cache-aware pricing) */
+const ANTHROPIC_CACHE = { cacheReadMultiplier: 0.1, cacheWriteMultiplier: 1.25 };
+const NO_CACHE = { cacheReadMultiplier: 0, cacheWriteMultiplier: 0 };
+/** Unified pricing derived from MODEL_CATALOG (single source of truth) */
+export const MODEL_PRICING = new Map(MODEL_CATALOG.map((entry) => [
+    entry.model,
+    {
+        inputRate: entry.inputPer1M,
+        outputRate: entry.outputPer1M,
+        ...(entry.provider === "anthropic" ? ANTHROPIC_CACHE : NO_CACHE),
+    },
+]));
+/**
+ * Tracks token usage and computes costs per role with cache-aware pricing.
+ * Subscribes to EventBus cost_update events for automatic tracking.
+ */
+export class CostTracker {
+    usageByRole = new Map();
+    /** Record token usage for a specific role and model */
+    record(role, model, usage) {
+        let entry = this.usageByRole.get(role);
+        if (!entry) {
+            entry = {
+                role,
+                model,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+                calls: 0,
+            };
+            this.usageByRole.set(role, entry);
+        }
+        entry.model = model;
+        entry.inputTokens += usage.inputTokens;
+        entry.outputTokens += usage.outputTokens;
+        entry.cacheReadTokens += usage.cacheReadTokens;
+        entry.cacheWriteTokens += usage.cacheWriteTokens;
+        entry.calls += 1;
+    }
+    /** Compute USD cost for a specific role */
+    costForRole(role) {
+        const entry = this.usageByRole.get(role);
+        if (!entry)
+            return 0;
+        return computeCost(entry);
+    }
+    /** Get full cost summary with totals and per-role breakdown */
+    get summary() {
+        let totalInputTokens = 0;
+        let totalOutputTokens = 0;
+        let totalCacheReadTokens = 0;
+        let totalCacheWriteTokens = 0;
+        let totalToolCalls = 0;
+        let totalCostUsd = 0;
+        const byRole = {};
+        for (const [role, entry] of this.usageByRole) {
+            totalInputTokens += entry.inputTokens;
+            totalOutputTokens += entry.outputTokens;
+            totalCacheReadTokens += entry.cacheReadTokens;
+            totalCacheWriteTokens += entry.cacheWriteTokens;
+            totalToolCalls += entry.calls;
+            const roleCost = computeCost(entry);
+            totalCostUsd += roleCost;
+            byRole[role] = {
+                role: entry.role,
+                model: entry.model,
+                inputTokens: entry.inputTokens,
+                outputTokens: entry.outputTokens,
+                cacheReadTokens: entry.cacheReadTokens,
+                cacheWriteTokens: entry.cacheWriteTokens,
+                calls: entry.calls,
+            };
+        }
+        return {
+            totalInputTokens,
+            totalOutputTokens,
+            totalCacheReadTokens,
+            totalCacheWriteTokens,
+            totalToolCalls,
+            totalCostUsd,
+            byRole,
+        };
+    }
+    /** Clear all accumulated usage */
+    reset() {
+        this.usageByRole.clear();
+    }
+}
+/** Compute USD cost for a usage entry using MODEL_PRICING */
+function computeCost(entry) {
+    const pricing = MODEL_PRICING.get(entry.model);
+    if (!pricing)
+        return 0;
+    const uncachedInput = Math.max(0, entry.inputTokens - entry.cacheReadTokens - entry.cacheWriteTokens);
+    return ((uncachedInput * pricing.inputRate +
+        entry.outputTokens * pricing.outputRate +
+        entry.cacheReadTokens * pricing.inputRate * pricing.cacheReadMultiplier +
+        entry.cacheWriteTokens * pricing.inputRate * pricing.cacheWriteMultiplier) /
+        1_000_000);
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/cost/cost-tracker.js.map

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

package/dist/cost/index.d.ts

@@ -0,0 +1,30 @@
+import type { AgentRole } from "../agents/index.js";
+/** Per-role usage tracking */
+export interface RoleUsage {
+    readonly role: AgentRole;
+    readonly model: string;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly calls: number;
+}
+/** Model pricing rates (per million tokens) */
+export interface ModelPricing {
+    readonly inputRate: number;
+    readonly outputRate: number;
+    readonly cacheReadMultiplier: number;
+    readonly cacheWriteMultiplier: number;
+}
+/** Cost tracking summary */
+export interface CostSummary {
+    readonly totalInputTokens: number;
+    readonly totalOutputTokens: number;
+    readonly totalCacheReadTokens: number;
+    readonly totalCacheWriteTokens: number;
+    readonly totalToolCalls: number;
+    readonly totalCostUsd: number;
+    readonly byRole: Record<string, RoleUsage>;
+}
+export { CostTracker, MODEL_PRICING } from "./cost-tracker.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cost/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAC5C;AAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cost/index.js

@@ -0,0 +1,2 @@
+export { CostTracker, MODEL_PRICING } from "./cost-tracker.js";
+//# sourceMappingURL=index.js.map

package/dist/cost/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/domain/domain-package-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { DomainPackageManifest } from "../package/types.js";
+export type { DomainPackageManifest } from "../package/types.js";
+/**
+ * Parse domain.yaml content into a DomainPackageManifest.
+ * Backward-compatible: domain YAML does not require type/version/author.
+ * Uses domain YAML validator (not package validator).
+ */
+export declare function parseDomainPackageYaml(content: string, installPath: string, filePath?: string): DomainPackageManifest;
+/** Load domain.yaml from disk into a DomainPackageManifest */
+export declare function loadDomainPackageYaml(filePath: string, installPath: string): DomainPackageManifest;
+/** Verify a file on disk has not been tampered with */
+export declare function verifyContentHash(filePath: string, expectedHash: string): boolean;
+//# sourceMappingURL=domain-package-adapter.d.ts.map

package/dist/domain/domain-package-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-package-adapter.d.ts","sourceRoot":"","sources":["../../src/domain/domain-package-adapter.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,qBAAqB,CAmDvB;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,qBAAqB,CAGvB;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGjF"}