@dalek-ai/router 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dalek (@dalekkskaro)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @dalek-ai/router
+
+TypeScript SDK for [agent-tool-router](https://github.com/dalek-ai/agent-tool-router) — picks the right tools for an agent task from a catalog of 18 000.
+
+The default endpoint is a hosted API at `dalek-ai-router-api.hf.space`. No API key, no signup.
+
+## Install
+
+```bash
+npm install @dalek-ai/router
+```
+
+Requires Node 18+ (uses the built-in `fetch`).
+
+## Use
+
+```ts
+import { route } from "@dalek-ai/router";
+
+const result = await route({
+  task: "annule ma commande et rembourse-moi",
+  k: 3,
+});
+
+console.log(result.tools);
+// [
+//   { name: "get_order_details", score: 0.26 },
+//   { name: "get_user_details", score: 0.25 },
+//   { name: "return_delivered_order_items", score: 0.24 }
+// ]
+console.log(result.model);      // "baseline-v1-desc-hybrid-multilingual-next-v1"
+console.log(result.latency_ms); // ~200
+```
+
+### History-aware routing
+
+Pass the previous tools called to bias the next-tool prediction (uses a Markov-2 history bigram with stupid-backoff under the hood):
+
+```ts
+const result = await route({
+  task: "rembourse-moi maintenant",
+  history: ["get_order_details", "verify_refund_eligibility"],
+  k: 3,
+});
+```
+
+### Reusable client
+
+```ts
+import { Router } from "@dalek-ai/router";
+
+const r = new Router(); // defaults to https://dalek-ai-router-api.hf.space
+const top3 = await r.route("send slack to my team");
+
+// or point at a self-hosted instance
+const self = new Router("https://router.mycompany.internal");
+```
+
+### Errors
+
+Failed requests throw `RouterError` with `.status` and `.body`:
+
+```ts
+import { RouterError } from "@dalek-ai/router";
+
+try {
+  await route({ task: "..." });
+} catch (e) {
+  if (e instanceof RouterError) console.error(e.status, e.body);
+}
+```
+
+## Hosted API specs
+
+- URL: `https://dalek-ai-router-api.hf.space`
+- Median latency: ~200 ms (shared free CPU on Hugging Face Spaces)
+- Default model: `baseline-v1-desc-hybrid-multilingual-next-v1` (FR + EN, Pareto-dominates 3 LOSO benchmarks)
+- Rate limits: HF Spaces public quotas (generous, not for production scale)
+- Higher limits / private deployments: drop your handle on the [Waitlist discussion](https://github.com/dalek-ai/agent-tool-router/discussions/1)
+
+## Numbers
+
+- 18 671 tools indexed (Hermes function-calling, ToolACE, tau-bench)
+- 14 000 agent traces in the training corpus
+- 77.4% top-3 next-tool accuracy (Markov-2 backoff on the multilingual encoder)
+- 100% top-3 on tau-bench position 2 (228 test calls, zero errors at this horizon)
+- 9 ms p50 latency in-process (local MacBook MPS) with the Python SDK
+
+Full benchmark numbers, eval scripts, and the dataset rebuild script:
+[github.com/dalek-ai/agent-tool-router](https://github.com/dalek-ai/agent-tool-router)
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @dalek-ai/router — TypeScript SDK for the agent-tool-router hosted API.
+ * https://github.com/dalek-ai/agent-tool-router
+ */
+export declare const DEFAULT_API_URL = "https://dalek-ai-router-api.hf.space";
+export interface RouteOptions {
+    task: string;
+    k?: number;
+    history?: string[];
+    model?: string;
+    apiUrl?: string;
+    signal?: AbortSignal;
+}
+export interface RouteResultTool {
+    name: string;
+    score: number;
+}
+export interface RouteResult {
+    tools: RouteResultTool[];
+    model: string;
+    latency_ms: number;
+}
+export declare class RouterError extends Error {
+    status?: number;
+    body?: string;
+    constructor(message: string, status?: number, body?: string);
+}
+export declare function route(opts: RouteOptions): Promise<RouteResult>;
+export declare class Router {
+    private readonly apiUrl;
+    private readonly defaultModel?;
+    constructor(apiUrl?: string, defaultModel?: string);
+    route(task: string, opts?: {
+        k?: number;
+        history?: string[];
+        model?: string;
+        signal?: AbortSignal;
+    }): Promise<RouteResult>;
+    health(signal?: AbortSignal): Promise<{
+        status: string;
+        models_loaded: number;
+    }>;
+}

package/dist/index.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * @dalek-ai/router — TypeScript SDK for the agent-tool-router hosted API.
+ * https://github.com/dalek-ai/agent-tool-router
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = exports.RouterError = exports.DEFAULT_API_URL = void 0;
+exports.route = route;
+exports.DEFAULT_API_URL = "https://dalek-ai-router-api.hf.space";
+class RouterError extends Error {
+    constructor(message, status, body) {
+        super(message);
+        this.name = "RouterError";
+        this.status = status;
+        this.body = body;
+    }
+}
+exports.RouterError = RouterError;
+async function route(opts) {
+    if (!opts.task || typeof opts.task !== "string") {
+        throw new RouterError("`task` must be a non-empty string");
+    }
+    const url = (opts.apiUrl ?? exports.DEFAULT_API_URL).replace(/\/$/, "") + "/route";
+    const payload = {
+        task: opts.task,
+        k: opts.k ?? 3,
+    };
+    if (opts.history && opts.history.length > 0)
+        payload.history = opts.history;
+    if (opts.model)
+        payload.model = opts.model;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        signal: opts.signal,
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new RouterError(`Router API ${res.status} ${res.statusText}`, res.status, body);
+    }
+    return (await res.json());
+}
+class Router {
+    constructor(apiUrl = exports.DEFAULT_API_URL, defaultModel) {
+        this.apiUrl = apiUrl;
+        this.defaultModel = defaultModel;
+    }
+    async route(task, opts) {
+        return route({
+            task,
+            k: opts?.k,
+            history: opts?.history,
+            model: opts?.model ?? this.defaultModel,
+            apiUrl: this.apiUrl,
+            signal: opts?.signal,
+        });
+    }
+    async health(signal) {
+        const res = await fetch(this.apiUrl.replace(/\/$/, "") + "/health", { signal });
+        if (!res.ok)
+            throw new RouterError(`health ${res.status}`, res.status);
+        return (await res.json());
+    }
+}
+exports.Router = Router;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dalek-ai/router",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the agent-tool-router hosted API. Picks the right tools for an agent task from a catalog of 18 000.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agent",
+    "agents",
+    "tool-routing",
+    "tool-calling",
+    "function-calling",
+    "llm",
+    "mcp",
+    "router"
+  ],
+  "author": "Dalek",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dalek-ai/agent-tool-router.git",
+    "directory": "router/sdk/typescript"
+  },
+  "homepage": "https://github.com/dalek-ai/agent-tool-router",
+  "bugs": {
+    "url": "https://github.com/dalek-ai/agent-tool-router/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}