@monoes/routing 1.0.0

package/dist/routes/testing.route.js

@@ -0,0 +1,115 @@
+export const testingRoutes = [
+    {
+        name: 'accessibility-auditor',
+        agentSlug: 'testing-accessibility-auditor',
+        threshold: 0.73,
+        fallbackToLLM: true,
+        description: 'Accessibility testing, WCAG compliance, screen reader testing',
+        utterances: [
+            'audit the application for WCAG 2.1 compliance',
+            'test the component with a screen reader for accessibility',
+            'check the color contrast ratios against accessibility standards',
+            'review the keyboard navigation flow for the form',
+            'audit the ARIA attributes in the component library',
+            'test the modal focus management for accessibility',
+            'check the alt text on all images in the UI',
+            'audit the touch target sizes for mobile accessibility',
+            'review the accessibility of the data visualization charts',
+            'test the application with VoiceOver and NVDA',
+        ],
+    },
+    {
+        name: 'api-tester',
+        agentSlug: 'testing-api-tester',
+        threshold: 0.72,
+        fallbackToLLM: true,
+        description: 'API testing, contract testing, endpoint validation',
+        utterances: [
+            'run API endpoint tests against the staging environment',
+            'create contract tests for the provider and consumer APIs',
+            'test the REST API for correct HTTP status codes',
+            'validate the API response schemas against the OpenAPI spec',
+            'write integration tests for the authentication endpoints',
+            'test the API rate limiting behavior',
+            'create load tests for the search API endpoint',
+            'validate the pagination behavior in the list endpoints',
+            'test the API error responses and error codes',
+            'create the Postman collection for the API test suite',
+        ],
+    },
+    {
+        name: 'performance-benchmarker',
+        agentSlug: 'testing-performance-benchmarker',
+        threshold: 0.72,
+        fallbackToLLM: true,
+        description: 'Performance benchmarking, load testing, profiling',
+        utterances: [
+            'benchmark the response time of the database queries',
+            'run load tests to determine the maximum throughput',
+            'profile the memory usage of the caching layer',
+            'benchmark the startup time of the application',
+            'measure the CPU usage under peak load conditions',
+            'create performance regression tests for the API',
+            'run stress tests to find the breaking point of the service',
+            'benchmark the vector search query performance',
+            'measure the latency percentiles (p50, p95, p99) for the API',
+            'profile the garbage collection behavior under load',
+        ],
+    },
+    {
+        name: 'reality-checker',
+        agentSlug: 'testing-reality-checker',
+        threshold: 0.70,
+        fallbackToLLM: true,
+        description: 'Production validation, smoke tests, health checks',
+        utterances: [
+            'validate the deployment worked correctly in production',
+            'run smoke tests after the release to staging',
+            'verify the critical user flows work in production',
+            'check that all services are healthy after the deployment',
+            'validate the database migrations ran successfully',
+            'verify the feature flags are configured correctly',
+            'check the payment flow works end-to-end in production',
+            'validate the email delivery is working correctly',
+            'verify the API is returning correct data after the migration',
+            'check that monitoring and alerting are active',
+        ],
+    },
+    {
+        name: 'test-results-analyzer',
+        agentSlug: 'testing-test-results-analyzer',
+        threshold: 0.71,
+        fallbackToLLM: true,
+        description: 'Test result analysis, flaky test detection, coverage reporting',
+        utterances: [
+            'analyze the failing tests in the CI pipeline',
+            'identify the flaky tests causing intermittent failures',
+            'generate a test coverage report for the module',
+            'analyze which tests are slowest and need optimization',
+            'identify the missing test coverage in the critical paths',
+            'analyze the test failure patterns across runs',
+            'create a summary of the regression test results',
+            'identify which tests are duplicating the same assertions',
+            'analyze the end-to-end test failure root causes',
+            'generate test quality metrics for the codebase',
+        ],
+    },
+    {
+        name: 'workflow-optimizer',
+        agentSlug: 'testing-workflow-optimizer',
+        threshold: 0.68,
+        fallbackToLLM: true,
+        description: 'Test workflow optimization, CI optimization, test parallelization',
+        utterances: [
+            'optimize the CI pipeline to reduce build time',
+            'parallelize the test suite to speed up the feedback loop',
+            'reorganize the test structure for better maintainability',
+            'optimize the test database setup and teardown',
+            'create the test sharding strategy for the large test suite',
+            'reduce the test setup overhead with better fixtures',
+            'optimize the end-to-end test execution time',
+            'create the test tagging strategy for selective runs',
+        ],
+    },
+];
+//# sourceMappingURL=testing.route.js.map

package/dist/routes/testing.route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.route.js","sourceRoot":"","sources":["../../src/routes/testing.route.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC;QACE,IAAI,EAAE,uBAAuB;QAC7B,SAAS,EAAE,+BAA+B;QAC1C,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,+DAA+D;QAC5E,UAAU,EAAE;YACV,+CAA+C;YAC/C,2DAA2D;YAC3D,iEAAiE;YACjE,kDAAkD;YAClD,oDAAoD;YACpD,mDAAmD;YACnD,4CAA4C;YAC5C,uDAAuD;YACvD,2DAA2D;YAC3D,8CAA8C;SAC/C;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,oBAAoB;QAC/B,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,oDAAoD;QACjE,UAAU,EAAE;YACV,wDAAwD;YACxD,0DAA0D;YAC1D,iDAAiD;YACjD,4DAA4D;YAC5D,0DAA0D;YAC1D,qCAAqC;YACrC,+CAA+C;YAC/C,wDAAwD;YACxD,8CAA8C;YAC9C,sDAAsD;SACvD;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,iCAAiC;QAC5C,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE;YACV,qDAAqD;YACrD,oDAAoD;YACpD,+CAA+C;YAC/C,+CAA+C;YAC/C,kDAAkD;YAClD,iDAAiD;YACjD,4DAA4D;YAC5D,+CAA+C;YAC/C,6DAA6D;YAC7D,oDAAoD;SACrD;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,mDAAmD;QAChE,UAAU,EAAE;YACV,wDAAwD;YACxD,8CAA8C;YAC9C,mDAAmD;YACnD,0DAA0D;YAC1D,mDAAmD;YACnD,mDAAmD;YACnD,uDAAuD;YACvD,kDAAkD;YAClD,8DAA8D;YAC9D,+CAA+C;SAChD;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,SAAS,EAAE,+BAA+B;QAC1C,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE;YACV,8CAA8C;YAC9C,wDAAwD;YACxD,gDAAgD;YAChD,uDAAuD;YACvD,0DAA0D;YAC1D,+CAA+C;YAC/C,iDAAiD;YACjD,0DAA0D;YAC1D,iDAAiD;YACjD,gDAAgD;SACjD;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,SAAS,EAAE,4BAA4B;QACvC,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,mEAAmE;QAChF,UAAU,EAAE;YACV,+CAA+C;YAC/C,0DAA0D;YAC1D,0DAA0D;YAC1D,+CAA+C;YAC/C,4DAA4D;YAC5D,qDAAqD;YACrD,6CAA6C;YAC7C,qDAAqD;SACtD;KACF;CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+export interface Route {
+    /** Unique name for this route, typically an agent category */
+    name: string;
+    /** The agent slug from ALLOWED_AGENT_TYPES to dispatch to */
+    agentSlug: string;
+    /** 10–15 representative task descriptions for this agent */
+    utterances: string[];
+    /**
+     * Minimum cosine similarity for a confident match in the hash-encoder space
+     * (default ~0.72). NOTE: when the host supplies a calibrated
+     * `RouteLayerConfig.globalThreshold` (as the real-embedding backend does),
+     * that single value overrides this per-route threshold — see route-layer.ts.
+     */
+    threshold: number;
+    /** If true and confidence < threshold, escalate to LLM classifier */
+    fallbackToLLM: boolean;
+    /** Human-readable description of what this agent handles */
+    description?: string;
+}
+export interface RouteResult {
+    /** The resolved agent slug from ALLOWED_AGENT_TYPES */
+    agentSlug: string;
+    /** Cosine similarity score (0.0–1.0) */
+    confidence: number;
+    /** How the routing decision was made */
+    method: 'semantic' | 'keyword' | 'llm_fallback';
+    /** The route name that matched */
+    routeName: string;
+    /** All routes with their scores, for debugging */
+    allScores?: Array<{
+        routeName: string;
+        agentSlug: string;
+        score: number;
+    }>;
+}
+export interface LLMFallbackConfig {
+    /** Injected LLM caller for testability */
+    llmCaller: (prompt: string) => Promise<string>;
+    /** Model to use — should be Haiku for cost efficiency */
+    model?: 'haiku' | 'sonnet';
+    /** Maximum tokens to request from LLM */
+    maxTokens?: number;
+    /** Log fallback events to this function (defaults to console.warn) */
+    onFallback?: (routeName: string, taskDescription: string, confidence: number) => void;
+}
+export interface RouteLayerConfig {
+    routes: Route[];
+    /** Encoder type to use for embeddings */
+    encoder?: 'hnsw' | 'local';
+    /**
+     * Injected real embedding function (e.g. a local transformers model supplied
+     * by the host). When provided, semantic routing uses it instead of the
+     * hash-based LocalEncoder — both the route utterances and the task are
+     * embedded with it. Must return a fixed-dimensional, L2-normalized vector.
+     */
+    embeddingGenerator?: (text: string) => Promise<number[]>;
+    /**
+     * Precomputed route centroids, aligned 1:1 with `routes`. When supplied,
+     * `initialize()` skips embedding the route utterances and uses these directly,
+     * letting the host cache the (expensive) centroid computation across runs.
+     * Must be produced by the SAME embedder as `embeddingGenerator`.
+     */
+    centroids?: number[][];
+    /** If true, include all route scores in RouteResult */
+    debug?: boolean;
+    /** Global minimum threshold override */
+    globalThreshold?: number;
+    /** LLM fallback configuration for low-confidence matches */
+    llmFallback?: LLMFallbackConfig;
+    /** Enable keyword pre-filter before semantic routing (default: true) */
+    enableKeywordFilter?: boolean;
+    /** Custom keyword rules prepended before DEFAULT_KEYWORD_ROUTES */
+    keywordRules?: Array<{
+        pattern: RegExp;
+        agentSlug: string;
+        routeName: string;
+        description: string;
+    }>;
+}
+export interface AgentCapability {
+    slug: string;
+    description: string;
+    taskTypes: string[];
+    expertise: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;IAChD,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACvF;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,wEAAwE;IACxE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,YAAY,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,CAAC;CACtG;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@monoes/routing",
+  "version": "1.0.0",
+  "description": "Semantic task-to-agent routing for monomind",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./routes": { "types": "./dist/routes/index.d.ts", "import": "./dist/routes/index.js" }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^20.0.0",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}