@monoes/routing 1.0.0

package/dist/capability-index.d.ts

@@ -0,0 +1,15 @@
+import { Route } from './types.js';
+/**
+ * Build a compact text index of all agent capabilities for LLM classification.
+ * Each entry: "<agentSlug>: <description>"
+ * Total output stays under MAX_INDEX_CHARS to fit in a single LLM prompt.
+ */
+export declare function buildCapabilityIndex(routes: Route[]): string;
+/**
+ * Build a compact list of the top-N candidate agents by semantic score for hint injection.
+ */
+export declare function buildCandidateHints(scores: Array<{
+    agentSlug: string;
+    score: number;
+}>, topN?: number): string;
+//# sourceMappingURL=capability-index.d.ts.map

package/dist/capability-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-index.d.ts","sourceRoot":"","sources":["../src/capability-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAgB5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACnD,IAAI,SAAI,GACP,MAAM,CAKR"}

package/dist/capability-index.js

@@ -0,0 +1,32 @@
+const MAX_INDEX_CHARS = 8000;
+/**
+ * Build a compact text index of all agent capabilities for LLM classification.
+ * Each entry: "<agentSlug>: <description>"
+ * Total output stays under MAX_INDEX_CHARS to fit in a single LLM prompt.
+ */
+export function buildCapabilityIndex(routes) {
+    const lines = [];
+    for (const route of routes) {
+        const description = route.description ?? route.utterances[0] ?? route.name;
+        lines.push(`${route.agentSlug}: ${description}`);
+    }
+    let index = lines.join('\n');
+    if (index.length > MAX_INDEX_CHARS) {
+        const trimmedLines = routes.map(r => {
+            const desc = (r.description ?? r.utterances[0] ?? r.name).slice(0, 80);
+            return `${r.agentSlug}: ${desc}`;
+        });
+        index = trimmedLines.join('\n').slice(0, MAX_INDEX_CHARS);
+    }
+    return index;
+}
+/**
+ * Build a compact list of the top-N candidate agents by semantic score for hint injection.
+ */
+export function buildCandidateHints(scores, topN = 3) {
+    return scores
+        .slice(0, topN)
+        .map(s => `- ${s.agentSlug} (similarity: ${s.score.toFixed(3)})`)
+        .join('\n');
+}
+//# sourceMappingURL=capability-index.js.map

package/dist/capability-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-index.js","sourceRoot":"","sources":["../src/capability-index.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvE,OAAO,GAAG,CAAC,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAmD,EACnD,IAAI,GAAG,CAAC;IAER,OAAO,MAAM;SACV,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;SAChE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/cosine.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Compute cosine similarity between two vectors.
+ * Returns a value in [-1, 1], where 1 = identical direction.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Compute the mean centroid of a list of vectors.
+ * All vectors must have the same dimensionality.
+ */
+export declare function computeCentroid(vectors: number[][]): number[];
+//# sourceMappingURL=cosine.d.ts.map

package/dist/cosine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine.d.ts","sourceRoot":"","sources":["../src/cosine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAejE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAa7D"}

package/dist/cosine.js

@@ -0,0 +1,41 @@
+/**
+ * Compute cosine similarity between two vectors.
+ * Returns a value in [-1, 1], where 1 = identical direction.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector length mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dot / denominator;
+}
+/**
+ * Compute the mean centroid of a list of vectors.
+ * All vectors must have the same dimensionality.
+ */
+export function computeCentroid(vectors) {
+    if (vectors.length === 0)
+        throw new Error('Cannot compute centroid of empty array');
+    const dim = vectors[0].length;
+    const centroid = new Array(dim).fill(0);
+    for (const vec of vectors) {
+        for (let i = 0; i < dim; i++) {
+            centroid[i] += vec[i];
+        }
+    }
+    for (let i = 0; i < dim; i++) {
+        centroid[i] /= vectors.length;
+    }
+    return centroid;
+}
+//# sourceMappingURL=cosine.js.map

package/dist/cosine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine.js","sourceRoot":"","sources":["../src/cosine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,GAAG,GAAG,WAAW,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/encoder.d.ts

@@ -0,0 +1,37 @@
+export interface Encoder {
+    encode(text: string): Promise<number[]>;
+    encodeAll(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Local encoder that produces deterministic pseudo-embeddings from text.
+ * Uses n-gram hashing to spread tokens across a fixed-dimensional vector.
+ * NOTE: Real semantic routing requires a real embedding model.
+ * In production, replace with HNSWEncoder backed by a proper embedding model.
+ */
+export declare class LocalEncoder implements Encoder {
+    private readonly DIM;
+    private cache;
+    encode(text: string): Promise<number[]>;
+    encodeAll(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Production encoder backed by a real embedding model.
+ *
+ * The model is injected by the host (the CLI wires in a local
+ * `@huggingface/transformers` feature-extraction pipeline) so this package
+ * carries no model dependency. When no embedder is injected it degrades to the
+ * deterministic {@link LocalEncoder}.
+ */
+export declare class HNSWEncoder implements Encoder {
+    private fallback;
+    private embed?;
+    /**
+     * @param embed Optional real embedding function. When provided it is used
+     *   exclusively — the hash-based LocalEncoder is NOT mixed in, since combining
+     *   vectors of different dimensionality would break cosine comparison.
+     */
+    constructor(embed?: (text: string) => Promise<number[]>);
+    encode(text: string): Promise<number[]>;
+    encodeAll(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=encoder.d.ts.map

package/dist/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAO;IAC3B,OAAO,CAAC,KAAK,CAA+B;IAEtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6B5C;IAEK,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAEpD;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAC,CAAsC;IAEpD;;;;OAIG;IACH,YAAY,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EAEtD;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5C;IAEK,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAOpD;CACF"}

package/dist/encoder.js

@@ -0,0 +1,75 @@
+import { createHash } from 'crypto';
+/**
+ * Local encoder that produces deterministic pseudo-embeddings from text.
+ * Uses n-gram hashing to spread tokens across a fixed-dimensional vector.
+ * NOTE: Real semantic routing requires a real embedding model.
+ * In production, replace with HNSWEncoder backed by a proper embedding model.
+ */
+export class LocalEncoder {
+    DIM = 256;
+    cache = new Map();
+    async encode(text) {
+        const key = createHash('sha256').update(text.toLowerCase().trim()).digest('hex');
+        if (this.cache.has(key))
+            return this.cache.get(key);
+        const vector = new Array(this.DIM).fill(0);
+        const words = text.toLowerCase().split(/\s+/);
+        // Unigrams
+        for (const word of words) {
+            const hash = createHash('md5').update(word).digest();
+            for (let i = 0; i < Math.min(hash.length, this.DIM); i++) {
+                vector[i % this.DIM] += (hash[i] - 128) / 128;
+            }
+        }
+        // Bigrams for better phrase sensitivity
+        for (let i = 0; i < words.length - 1; i++) {
+            const bigram = `${words[i]} ${words[i + 1]}`;
+            const hash = createHash('md5').update(bigram).digest();
+            for (let j = 0; j < Math.min(hash.length, this.DIM); j++) {
+                vector[(j + this.DIM / 2) % this.DIM] += (hash[j] - 128) / 128 * 0.5;
+            }
+        }
+        // L2 normalize
+        const norm = Math.sqrt(vector.reduce((s, v) => s + v * v, 0)) || 1;
+        const normalized = vector.map(v => v / norm);
+        this.cache.set(key, normalized);
+        return normalized;
+    }
+    async encodeAll(texts) {
+        return Promise.all(texts.map(t => this.encode(t)));
+    }
+}
+/**
+ * Production encoder backed by a real embedding model.
+ *
+ * The model is injected by the host (the CLI wires in a local
+ * `@huggingface/transformers` feature-extraction pipeline) so this package
+ * carries no model dependency. When no embedder is injected it degrades to the
+ * deterministic {@link LocalEncoder}.
+ */
+export class HNSWEncoder {
+    fallback = new LocalEncoder();
+    embed;
+    /**
+     * @param embed Optional real embedding function. When provided it is used
+     *   exclusively — the hash-based LocalEncoder is NOT mixed in, since combining
+     *   vectors of different dimensionality would break cosine comparison.
+     */
+    constructor(embed) {
+        this.embed = embed;
+    }
+    async encode(text) {
+        return this.embed ? this.embed(text) : this.fallback.encode(text);
+    }
+    async encodeAll(texts) {
+        if (!this.embed)
+            return this.fallback.encodeAll(texts);
+        // Sequential: the underlying transformers pipeline is single-threaded, so
+        // Promise.all would not parallelise — it would only inflate peak memory.
+        const out = [];
+        for (const t of texts)
+            out.push(await this.embed(t));
+        return out;
+    }
+}
+//# sourceMappingURL=encoder.js.map

package/dist/encoder.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { RouteLayer } from './route-layer.js';
+export { cosineSimilarity, computeCentroid } from './cosine.js';
+export { LocalEncoder, HNSWEncoder } from './encoder.js';
+export type { Encoder } from './encoder.js';
+export { LLMFallbackRouter } from './llm-fallback.js';
+export { buildCapabilityIndex, buildCandidateHints } from './capability-index.js';
+export { buildClassificationPrompt } from './prompts/classify.js';
+export type { Route, RouteResult, RouteLayerConfig, AgentCapability, LLMFallbackConfig } from './types.js';
+export { ALL_ROUTES } from './routes/index.js';
+export { KeywordPreFilter, DEFAULT_KEYWORD_ROUTES } from './keyword-pre-filter.js';
+export type { KeywordRule } from './keyword-pre-filter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3G,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { RouteLayer } from './route-layer.js';
+export { cosineSimilarity, computeCentroid } from './cosine.js';
+export { LocalEncoder, HNSWEncoder } from './encoder.js';
+export { LLMFallbackRouter } from './llm-fallback.js';
+export { buildCapabilityIndex, buildCandidateHints } from './capability-index.js';
+export { buildClassificationPrompt } from './prompts/classify.js';
+export { ALL_ROUTES } from './routes/index.js';
+export { KeywordPreFilter, DEFAULT_KEYWORD_ROUTES } from './keyword-pre-filter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/keyword-pre-filter.d.ts

@@ -0,0 +1,44 @@
+import { RouteResult } from './types.js';
+export interface KeywordRule {
+    /** Regex pattern to match against task description */
+    pattern: RegExp;
+    /** Agent slug to route to when matched */
+    agentSlug: string;
+    /** Human-readable name for this route */
+    routeName: string;
+    /** Description of what this rule matches */
+    description: string;
+}
+/**
+ * 30+ default keyword rules for fast, deterministic routing.
+ * First-match wins — order matters.
+ */
+export declare const DEFAULT_KEYWORD_ROUTES: KeywordRule[];
+/**
+ * Fast keyword-based pre-filter for routing.
+ * Runs regex matches against task descriptions before falling through
+ * to semantic (embedding-based) routing. First match wins.
+ */
+export declare class KeywordPreFilter {
+    private rules;
+    constructor(customRules?: Array<{
+        pattern: RegExp;
+        agentSlug: string;
+        routeName: string;
+        description: string;
+    }>);
+    /**
+     * Match a task description against keyword rules.
+     * Returns the first matching route or null if no keyword matches.
+     */
+    match(taskDescription: string): RouteResult | null;
+    /**
+     * Prepend a custom rule (highest priority).
+     */
+    addRule(rule: KeywordRule): void;
+    /**
+     * Return a copy of the current rules (immutable view).
+     */
+    getRules(): ReadonlyArray<KeywordRule>;
+}
+//# sourceMappingURL=keyword-pre-filter.d.ts.map

package/dist/keyword-pre-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-pre-filter.d.ts","sourceRoot":"","sources":["../src/keyword-pre-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,EA2E/C,CAAC;AAEF;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAgB;IAE7B,YAAY,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EAM9G;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAYjD;IAED;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAE/B;IAED;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC,WAAW,CAAC,CAErC;CACF"}

package/dist/keyword-pre-filter.js

@@ -0,0 +1,109 @@
+/**
+ * 30+ default keyword rules for fast, deterministic routing.
+ * First-match wins — order matters.
+ */
+export const DEFAULT_KEYWORD_ROUTES = [
+    // Security / CVE
+    { pattern: /CVE-\d{4}-\d+/i, agentSlug: 'engineering-security-engineer', routeName: 'cve-remediation', description: 'CVE identifier detected' },
+    { pattern: /\bOWASP\b/i, agentSlug: 'engineering-security-engineer', routeName: 'owasp-security', description: 'OWASP security reference' },
+    { pattern: /\bthreat\s*model/i, agentSlug: 'engineering-security-engineer', routeName: 'threat-modeling', description: 'Threat modeling task' },
+    // Test files
+    { pattern: /\.(test|spec)\.(ts|js|tsx|jsx)\b/i, agentSlug: 'tdd-london-swarm', routeName: 'test-file', description: 'Test file detected' },
+    { pattern: /\b(write|create|add|fix)\s+(unit|integration|e2e)?\s*tests?\b/i, agentSlug: 'tdd-london-swarm', routeName: 'test-writing', description: 'Test writing task' },
+    // Docker / DevOps
+    { pattern: /\bDockerfile\b/i, agentSlug: 'engineering-devops-automator', routeName: 'dockerfile', description: 'Dockerfile detected' },
+    { pattern: /\bdocker[-.]?compose\b/i, agentSlug: 'engineering-devops-automator', routeName: 'docker-compose', description: 'Docker Compose detected' },
+    { pattern: /\bterraform\b/i, agentSlug: 'engineering-devops-automator', routeName: 'terraform', description: 'Terraform infrastructure' },
+    { pattern: /\bgithub\s*actions?\b/i, agentSlug: 'engineering-devops-automator', routeName: 'github-actions', description: 'GitHub Actions workflow' },
+    { pattern: /\b\.github\/workflows\b/i, agentSlug: 'engineering-devops-automator', routeName: 'github-workflows', description: 'GitHub workflow file' },
+    { pattern: /\bkubernetes\b|\bk8s\b|\bhelm\b(?=[\s\S]{0,60}\b(?:kubernetes|k8s|chart|deploy|helmfile)\b)|\b(?:kubernetes|k8s|chart|deploy|helmfile)\b(?=[\s\S]{0,60}\bhelm\b)/i, agentSlug: 'engineering-devops-automator', routeName: 'kubernetes', description: 'Kubernetes / Helm (bare "helm" requires nearby Kubernetes context — "take the helm" is not Kubernetes)' },
+    // Git operations
+    { pattern: /\bgit\s+(rebase|blame|bisect|cherry-pick|stash|reflog)\b/i, agentSlug: 'engineering-git-workflow-master', routeName: 'git-operations', description: 'Advanced git operation' },
+    { pattern: /\bgit\s+(merge|branch|tag|log|diff)\b/i, agentSlug: 'engineering-git-workflow-master', routeName: 'git-workflow', description: 'Git workflow operation' },
+    // Solidity / Smart contracts
+    { pattern: /\.sol\b/i, agentSlug: 'engineering-solidity-smart-contract-engineer', routeName: 'solidity-file', description: 'Solidity file detected' },
+    { pattern: /\bsolidity\b|\bsmart\s*contract\b/i, agentSlug: 'engineering-solidity-smart-contract-engineer', routeName: 'solidity', description: 'Solidity / smart contract' },
+    // ZK proofs
+    { pattern: /\bzkp\b|\bcircom\b|\bsnark\b|\bzk[-\s]?proof/i, agentSlug: 'zk-steward', routeName: 'zk-proofs', description: 'Zero-knowledge proof' },
+    // MCP
+    { pattern: /\bMCP\s*(server|builder|tool)\b/i, agentSlug: 'specialized-mcp-builder', routeName: 'mcp-builder', description: 'MCP server/tool building' },
+    // React Native / Mobile
+    { pattern: /\breact[-\s]?native\b/i, agentSlug: 'engineering-react-native-developer', routeName: 'react-native', description: 'React Native development' },
+    // iOS / Swift
+    // Bare "swift" is a common English word ("a swift fix") — only match it when
+    // iOS/Xcode/Apple context appears nearby (either word order). swiftui/xcode/
+    // "ios app" are already unambiguous domain qualifiers.
+    { pattern: /\bswiftui\b|\bxcode\b|\bios\s+app\b|\bswift\b(?=[\s\S]{0,60}\b(?:ios|xcode|apple|app)\b)|\b(?:ios|xcode|apple|app)\b(?=[\s\S]{0,60}\bswift\b)/i, agentSlug: 'engineering-ios-swift-developer', routeName: 'ios-swift', description: 'iOS / Swift development' },
+    // Android / Kotlin
+    { pattern: /\bkotlin\b|\bandroid\s+(app|dev)/i, agentSlug: 'engineering-android-kotlin-developer', routeName: 'android-kotlin', description: 'Android / Kotlin development' },
+    // Embedded / Firmware
+    // Bare "embedded" is a common English word ("the config embedded in the file")
+    // — only match it near hardware/firmware context (either word order).
+    { pattern: /\bfirmware\b|\brtos\b|\bmicrocontroller\b|\bembedded\b(?=[\s\S]{0,60}\b(?:firmware|hardware|mcu|rtos|chip|microcontroller|device|system)\b)|\b(?:firmware|hardware|mcu|rtos|chip|microcontroller|device|system)\b(?=[\s\S]{0,60}\bembedded\b)/i, agentSlug: 'engineering-embedded-firmware-engineer', routeName: 'embedded-firmware', description: 'Embedded / firmware development' },
+    // Salesforce
+    // Bare "apex" is a common English word ("the apex of the call graph") —
+    // only match it near Salesforce context (either word order).
+    { pattern: /\bsalesforce\b|\bsoql\b|\bapex\b(?=[\s\S]{0,60}\b(?:salesforce|soql|trigger|lwc|visualforce)\b)|\b(?:salesforce|soql|trigger|lwc|visualforce)\b(?=[\s\S]{0,60}\bapex\b)/i, agentSlug: 'specialized-salesforce-developer', routeName: 'salesforce', description: 'Salesforce / Apex / SOQL' },
+    // Game engines
+    // Bare "blender" is a common English word (kitchen appliance) — only match
+    // it near 3D/render context (either word order).
+    { pattern: /\bblender\b(?=[\s\S]{0,60}\b(?:3d|model|render|animation|mesh|scene|texture)\b)|\b(?:3d|model|render|animation|mesh|scene|texture)\b(?=[\s\S]{0,60}\bblender\b)/i, agentSlug: 'specialized-blender-3d-artist', routeName: 'blender', description: 'Blender 3D modeling' },
+    { pattern: /\bunreal\s*engine\b|\bUE[45]\b/i, agentSlug: 'specialized-unreal-engine-developer', routeName: 'unreal-engine', description: 'Unreal Engine development' },
+    // Bare "unity" is a common English word ("ensure unity between modules") —
+    // only match it near game/engine context (either word order).
+    { pattern: /\bC#\s*game\b|\bunity3d\b|\bunity\b(?=[\s\S]{0,60}\b(?:game|engine|3d|prefab|asset|c#)\b)|\b(?:game|engine|3d|prefab|asset|c#)\b(?=[\s\S]{0,60}\bunity\b)/i, agentSlug: 'specialized-unity-developer', routeName: 'unity', description: 'Unity game development' },
+    { pattern: /\bgodot\b|\bgdscript\b/i, agentSlug: 'specialized-godot-developer', routeName: 'godot', description: 'Godot game development' },
+    // SEO
+    { pattern: /\bSEO\b|\bsearch\s*engine\s*optim/i, agentSlug: 'specialized-seo-strategist', routeName: 'seo', description: 'SEO optimization' },
+    // Supply chain
+    { pattern: /\bsupply[-\s]?chain\b|\bSBOM\b/i, agentSlug: 'engineering-supply-chain-security', routeName: 'supply-chain', description: 'Supply chain security' },
+    // GraphQL
+    { pattern: /\bgraphql\b|\b\.graphql\b|\b\.gql\b/i, agentSlug: 'engineering-graphql-developer', routeName: 'graphql', description: 'GraphQL development' },
+    // Database / SQL
+    { pattern: /\bpostgres\b|\bmysql\b|\bmongodb\b|\bredis\b/i, agentSlug: 'engineering-database-engineer', routeName: 'database', description: 'Database engineering' },
+];
+/**
+ * Fast keyword-based pre-filter for routing.
+ * Runs regex matches against task descriptions before falling through
+ * to semantic (embedding-based) routing. First match wins.
+ */
+export class KeywordPreFilter {
+    rules;
+    constructor(customRules) {
+        this.rules = [...DEFAULT_KEYWORD_ROUTES];
+        if (customRules) {
+            // Prepend custom rules so they take priority
+            this.rules = [...customRules, ...this.rules];
+        }
+    }
+    /**
+     * Match a task description against keyword rules.
+     * Returns the first matching route or null if no keyword matches.
+     */
+    match(taskDescription) {
+        for (const rule of this.rules) {
+            if (rule.pattern.test(taskDescription)) {
+                return {
+                    agentSlug: rule.agentSlug,
+                    confidence: 1.0,
+                    method: 'keyword',
+                    routeName: rule.routeName,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Prepend a custom rule (highest priority).
+     */
+    addRule(rule) {
+        this.rules.unshift(rule);
+    }
+    /**
+     * Return a copy of the current rules (immutable view).
+     */
+    getRules() {
+        return [...this.rules];
+    }
+}
+//# sourceMappingURL=keyword-pre-filter.js.map

package/dist/keyword-pre-filter.js.map

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

package/dist/llm-fallback.d.ts

@@ -0,0 +1,18 @@
+import { Route, RouteResult, LLMFallbackConfig } from './types.js';
+export declare class LLMFallbackRouter {
+    private config;
+    /** Session-scoped fallback counter per route name */
+    private fallbackCounts;
+    constructor(config: LLMFallbackConfig);
+    /**
+     * Classify a task description using an LLM when semantic routing confidence is too low.
+     */
+    classify(taskDescription: string, routes: Route[], scores: Array<{
+        routeName: string;
+        agentSlug: string;
+        score: number;
+    }>): Promise<RouteResult>;
+    /** Returns a snapshot of fallback counts for this session */
+    getFallbackStats(): Record<string, number>;
+}
+//# sourceMappingURL=llm-fallback.d.ts.map

package/dist/llm-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-fallback.d.ts","sourceRoot":"","sources":["../src/llm-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAOnE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoB;IAClC,qDAAqD;IACrD,OAAO,CAAC,cAAc,CAA6B;IAEnD,YAAY,MAAM,EAAE,iBAAiB,EAEpC;IAED;;OAEG;IACG,QAAQ,CACZ,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,KAAK,EAAE,EACf,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GACrE,OAAO,CAAC,WAAW,CAAC,CA4DtB;IAED,6DAA6D;IAC7D,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzC;CACF"}

package/dist/llm-fallback.js

@@ -0,0 +1,76 @@
+import { buildCapabilityIndex, buildCandidateHints } from './capability-index.js';
+import { buildClassificationPrompt } from './prompts/classify.js';
+/** Slug validation regex — must match ALLOWED_AGENT_TYPES pattern */
+const SLUG_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
+export class LLMFallbackRouter {
+    config;
+    /** Session-scoped fallback counter per route name */
+    fallbackCounts = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Classify a task description using an LLM when semantic routing confidence is too low.
+     */
+    async classify(taskDescription, routes, scores) {
+        const nearestRoute = scores[0];
+        // Log the fallback event
+        const onFallback = this.config.onFallback ?? defaultFallbackLogger;
+        onFallback(nearestRoute.routeName, taskDescription, nearestRoute.score);
+        this.fallbackCounts.set(nearestRoute.routeName, (this.fallbackCounts.get(nearestRoute.routeName) ?? 0) + 1);
+        // Build prompt
+        const capabilityIndex = buildCapabilityIndex(routes);
+        const candidateHints = buildCandidateHints(scores);
+        const prompt = buildClassificationPrompt(taskDescription, capabilityIndex, candidateHints);
+        // Call LLM
+        let rawResponse;
+        try {
+            rawResponse = await this.config.llmCaller(prompt);
+        }
+        catch (err) {
+            console.error('[LLMFallback] LLM call failed, using best semantic match:', err);
+            return {
+                agentSlug: nearestRoute.agentSlug,
+                confidence: nearestRoute.score,
+                method: 'llm_fallback',
+                routeName: nearestRoute.routeName,
+            };
+        }
+        // Parse and validate the slug
+        const slug = rawResponse.trim().replace(/[`'"]/g, '').toLowerCase();
+        if (!SLUG_PATTERN.test(slug)) {
+            console.error(`[LLMFallback] Invalid slug in LLM response: "${slug}"`);
+            return {
+                agentSlug: nearestRoute.agentSlug,
+                confidence: nearestRoute.score,
+                method: 'llm_fallback',
+                routeName: nearestRoute.routeName,
+            };
+        }
+        // Verify slug exists in routes — compare case-insensitively since slug is lowercased
+        const matchedRoute = routes.find(r => r.agentSlug.toLowerCase() === slug);
+        if (!matchedRoute) {
+            console.error(`[LLMFallback] LLM returned unknown slug: "${slug}"`);
+            return {
+                agentSlug: nearestRoute.agentSlug,
+                confidence: nearestRoute.score,
+                method: 'llm_fallback',
+                routeName: nearestRoute.routeName,
+            };
+        }
+        return {
+            agentSlug: matchedRoute.agentSlug, // use canonical casing from route definition
+            confidence: 0.85,
+            method: 'llm_fallback',
+            routeName: matchedRoute.name,
+        };
+    }
+    /** Returns a snapshot of fallback counts for this session */
+    getFallbackStats() {
+        return Object.fromEntries(this.fallbackCounts.entries());
+    }
+}
+function defaultFallbackLogger(routeName, task, confidence) {
+    console.warn(`[LLMFallback] Route "${routeName}" confidence ${confidence.toFixed(3)} below threshold for task: "${task.slice(0, 80)}..."`);
+}
+//# sourceMappingURL=llm-fallback.js.map

package/dist/llm-fallback.js.map

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

package/dist/prompts/classify.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build the classification prompt for LLM fallback routing.
+ */
+export declare function buildClassificationPrompt(taskDescription: string, capabilityIndex: string, candidateHints: string): string;
+//# sourceMappingURL=classify.d.ts.map

package/dist/prompts/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/prompts/classify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,MAAM,CAoBR"}

package/dist/prompts/classify.js

@@ -0,0 +1,25 @@
+/**
+ * Build the classification prompt for LLM fallback routing.
+ */
+export function buildClassificationPrompt(taskDescription, capabilityIndex, candidateHints) {
+    return `You are a task routing classifier. Your job is to select the single best agent slug for a given task.
+
+## Available Agents
+${capabilityIndex}
+
+## Semantic Pre-Candidates (top 3 by embedding similarity)
+${candidateHints}
+
+## Task to Route
+"${taskDescription}"
+
+## Instructions
+1. Review the task description carefully.
+2. Consider the semantic pre-candidates — they may already be correct.
+3. Select the SINGLE best agent slug from the Available Agents list above.
+4. Output ONLY the agent slug — no explanation, no markdown, no punctuation.
+5. The slug must exactly match one of the slugs in the Available Agents list.
+
+Agent slug:`;
+}
+//# sourceMappingURL=classify.js.map

package/dist/prompts/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/prompts/classify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,eAAuB,EACvB,eAAuB,EACvB,cAAsB;IAEtB,OAAO;;;EAGP,eAAe;;;EAGf,cAAc;;;GAGb,eAAe;;;;;;;;;YASN,CAAC;AACb,CAAC"}

package/dist/route-layer.d.ts

@@ -0,0 +1,25 @@
+import { Route, RouteResult, RouteLayerConfig } from './types.js';
+export declare class RouteLayer {
+    private centroids;
+    private encoder;
+    private config;
+    private initialized;
+    private llmFallback?;
+    private keywordFilter?;
+    constructor(config: RouteLayerConfig);
+    /**
+     * Pre-compute centroids for all routes.
+     * Idempotent — safe to call multiple times.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Route a task description to the most appropriate agent slug.
+     * Auto-initializes on first call.
+     */
+    route(taskDescription: string): Promise<RouteResult>;
+    /**
+     * Register an additional route at runtime without re-initializing all centroids.
+     */
+    addRoute(route: Route): Promise<void>;
+}
+//# sourceMappingURL=route-layer.d.ts.map

package/dist/route-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-layer.d.ts","sourceRoot":"","sources":["../src/route-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWlE,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,aAAa,CAAC,CAAmB;IAEzC,YAAY,MAAM,EAAE,gBAAgB,EAkBnC;IAED;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBhC;IAED;;;OAGG;IACG,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgEzD;IAED;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1C;CACF"}