@nexuss0781/nar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nexuss0781
+
+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,151 @@
+# @nexuss0781/nar
+
+Minimal TypeScript client for **Nexuss AI Router (NAR)**. Zero dependencies.
+
+Do not hand-write `curl` requests, and do not call a provider directly. NAR routes
+every call to a healthy free model and falls back automatically when one is busy.
+
+## Install
+
+```bash
+npm install @nexuss0781/nar
+```
+
+Zero dependencies. Node 18+, Bun, Deno, Cloudflare Workers, Vercel Edge.
+
+```bash
+export NAR_BASE_URL="https://omniouter-vercel.vercel.app"
+export NAR_API_KEY="<your master key>"
+```
+
+
+## Stream a completion
+
+```ts
+import { stream } from "@nexuss0781/nar";
+
+for await (const delta of stream("Explain ownership in Rust in two sentences")) {
+  process.stdout.write(delta);
+}
+```
+
+## Get the whole answer
+
+```ts
+import { chat } from "@nexuss0781/nar";
+
+const { text, route } = await chat("Write a haiku about routers");
+console.log(text);
+console.log(route.provider, route.model);   // e.g. "puter  puter/infron:qwen/qwen3.8-27b:free"
+```
+
+## Which model actually answered
+
+`route.provider` and `route.model` come from NAR's response headers, not from
+guessing. Log them — they are how you measure which free route is actually
+carrying traffic, and how you tell a silent fallback from a healthy call.
+
+```ts
+const { text, route } = await chat(prompt);
+console.log(`[${route.provider}/${route.model}] ${text.length} chars`);
+```
+
+## Pin a specific model
+
+Only when you need determinism. Omit `model` to let NAR choose.
+
+```ts
+await chat("hi", { model: "puter/infron:qwen/qwen3.8-27b:free" });
+```
+
+Call `models()` to list what is live right now:
+
+```ts
+import { models } from "@nexuss0781/nar";
+console.log(await models());
+```
+
+## Tool calling
+
+Tool call deltas are accumulated for you and arrive keyed by index.
+
+```ts
+import { streamEvents, complete } from "@nexuss0781/nar";
+
+for await (const event of streamEvents("What is the weather in Oslo?", {
+  tools: [{
+    type: "function",
+    function: {
+      name: "get_weather",
+      description: "Current weather for a city",
+      parameters: {
+        type: "object",
+        properties: { city: { type: "string" } },
+        required: ["city"],
+      },
+    },
+  }],
+})) {
+  for (const call of Object.values(event.toolCalls)) {
+    if (call.name && !event.delta) console.log(call.name, call.arguments);
+  }
+}
+```
+
+NAR keeps a tool-calling conversation pinned to the model that started it, so a
+multi-turn tool loop does not silently change models mid-conversation.
+
+## Errors
+
+```ts
+import { NarError } from "@nexuss0781/nar";
+
+try {
+  await chat("hi");
+} catch (error) {
+  if (error instanceof NarError) {
+    console.error(error.status, error.code, error.message);
+    console.error(error.route.attemptTrail);   // providers that failed before this one
+  }
+}
+```
+
+`attemptTrail` is populated when a request failed everywhere. It is the fastest way
+to tell "the model was bad" from "every free tier was rate-limited".
+
+## Health
+
+```ts
+import { health } from "@nexuss0781/nar";
+const report = await health();
+console.log(report.checks.find((c) => c.name === "puter_auth"));
+```
+
+`puter_auth` reports `ok`, `rejected` (token died — sign out/in again) or
+`unreachable` (network trouble, token probably fine). Check this before debugging
+a slow provider, because a silently failing provider still returns 200 traffic
+routed elsewhere.
+
+## API
+
+| Function | Returns |
+| --- | --- |
+| `stream(prompt, opts?)` | `AsyncGenerator<string>` of text deltas |
+| `streamEvents(prompt, opts?)` | `AsyncGenerator<StreamEvent>` with tool calls + route |
+| `chat(prompt, opts?)` | `Promise<ChatResult>` — text + route |
+| `complete(prompt, opts?)` | `Promise<ChatResult>` — non-streaming, keeps usage |
+| `models(opts?)` | `Promise<string[]>` of live model ids |
+| `health(opts?)` | `Promise<HealthReport>` |
+
+`ChatOptions`: `model`, `system`, `temperature`, `maxTokens`, `tools`, `signal`,
+`baseUrl`, `apiKey`, `extra`.
+
+## Rules for agents
+
+- Always default to `model: "auto"`. Pin a model only for tests that must be
+  reproducible.
+- Never read a provider API key. One NAR master key is the whole credential.
+- Never retry on 429 yourself; NAR already falls back. Retry only on `5xx`, and
+  at most twice.
+- Never assume a model name is stable. Call `models()` if you need to verify one.
+- Streaming responses usually omit `usage`. Do not assert on token counts.

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * nar — minimal client for Nexuss AI Router.
+ *
+ * Zero dependencies: uses the platform fetch, so it runs on Node 18+, Bun, Deno,
+ * Cloudflare Workers and Vercel Edge without a polyfill.
+ *
+ * The point of this wrapper is that a caller never assembles a URL, never picks a
+ * provider, and never handles a provider outage. Pass "auto" (the default) and NAR
+ * picks a healthy free model. Every call reports which model actually served it.
+ */
+export type ChatOptions = {
+    /** Model id such as "auto", or a pinned id like "puter/infron:qwen/qwen3.8-27b:free". */
+    model?: string;
+    /** System prompt. Appended ahead of the user turn. */
+    system?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** OpenAI-style tool definitions, for tool-calling loops. */
+    tools?: unknown[];
+    /** Abort the request. */
+    signal?: AbortSignal;
+    /** Override the deployment for this call only. */
+    baseUrl?: string;
+    apiKey?: string;
+    /** Extra body fields merged last, for anything this wrapper does not model. */
+    extra?: Record<string, unknown>;
+};
+/** Which route actually served the request, read from NAR's response headers. */
+export type Route = {
+    provider: string | null;
+    model: string | null;
+    /** Providers that failed and were fallen through, when the request ultimately failed. */
+    attemptTrail: string | null;
+};
+/** OpenAI-shaped token usage. Keys are the wire names, so it can be forwarded as-is. */
+export type Usage = {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+};
+export type ChatResult = {
+    text: string;
+    route: Route;
+    /** Token usage, when the upstream reported it. Streaming responses usually omit it. */
+    usage: Usage | null;
+    /** Raw response envelope, for callers that need more than text. */
+    raw: unknown;
+};
+export type StreamEvent = {
+    /** Incremental text. Empty on role-only or tool-call-only chunks. */
+    delta: string;
+    /** Accumulated tool calls so far, keyed by index. */
+    toolCalls: Record<number, {
+        id?: string;
+        name?: string;
+        arguments: string;
+    }>;
+    finishReason: string | null;
+    route: Route;
+};
+export declare class NarError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly route: Route;
+    readonly body: unknown;
+    constructor(message: string, status: number, code: string, route: Route, body: unknown);
+}
+/**
+ * Stream a chat completion as text deltas.
+ *
+ *   for await (const delta of nar.stream("explain pythons")) console.log(delta);
+ *
+ * Yields plain strings, so a caller that only wants the text never touches SSE.
+ * Use streamEvents when tool calls are needed.
+ */
+export declare function stream(prompt: string, options?: ChatOptions): AsyncGenerator<string>;
+/** Same as stream(), but yields structured events including accumulated tool calls. */
+export declare function streamEvents(prompt: string, options?: ChatOptions): AsyncGenerator<StreamEvent>;
+/** Collect a full streamed answer. Convenient when streaming is not needed downstream. */
+export declare function chat(prompt: string, options?: ChatOptions): Promise<ChatResult>;
+/** One non-streaming request, returning the parsed OpenAI-shaped envelope. */
+export declare function complete(prompt: string, options?: ChatOptions): Promise<ChatResult>;
+/** List live models. Pass this to a user or an agent to see what is actually available. */
+export declare function models(options?: {
+    baseUrl?: string;
+    apiKey?: string;
+    signal?: AbortSignal;
+}): Promise<string[]>;
+export type HealthReport = {
+    status: string;
+    ready: boolean;
+    checks: Array<{
+        name: string;
+        status: string;
+        detail: string;
+    }>;
+};
+/** Router health, including per-provider auth state. Useful for uptime checks. */
+export declare function health(options?: {
+    baseUrl?: string;
+    signal?: AbortSignal;
+}): Promise<HealthReport>;
+export declare const nar: {
+    stream: typeof stream;
+    streamEvents: typeof streamEvents;
+    chat: typeof chat;
+    complete: typeof complete;
+    models: typeof models;
+    health: typeof health;
+};
+export default nar;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,225 @@
+/**
+ * nar — minimal client for Nexuss AI Router.
+ *
+ * Zero dependencies: uses the platform fetch, so it runs on Node 18+, Bun, Deno,
+ * Cloudflare Workers and Vercel Edge without a polyfill.
+ *
+ * The point of this wrapper is that a caller never assembles a URL, never picks a
+ * provider, and never handles a provider outage. Pass "auto" (the default) and NAR
+ * picks a healthy free model. Every call reports which model actually served it.
+ */
+export class NarError extends Error {
+    status;
+    code;
+    route;
+    body;
+    constructor(message, status, code, route, body) {
+        super(message);
+        this.name = "NarError";
+        this.status = status;
+        this.code = code;
+        this.route = route;
+        this.body = body;
+    }
+}
+const DEFAULT_MODEL = "auto";
+function envBase() {
+    const raw = process.env.NAR_BASE_URL || process.env.OMNIROUTE_BASE_URL || "https://omniouter-vercel.vercel.app";
+    return raw.replace(/\/+$/, "");
+}
+function envKey() {
+    const key = process.env.NAR_API_KEY || process.env.OMNIROUTE_AI_API_KEY || "";
+    if (!key) {
+        throw new NarError("No master key. Set NAR_API_KEY (or OMNIROUTE_AI_API_KEY) to your NAR gateway key.", 401, "missing_api_key", { provider: null, model: null, attemptTrail: null }, null);
+    }
+    return key;
+}
+function apiBase(override) {
+    const base = (override || envBase()).replace(/\/+$/, "");
+    return base.endsWith("/api/v1") ? base : `${base}/api/v1`;
+}
+function routeFrom(headers) {
+    return {
+        provider: headers.get("x-omniroute-provider"),
+        model: headers.get("x-omniroute-model"),
+        attemptTrail: headers.get("x-omniroute-attempt-trail"),
+    };
+}
+function buildMessages(prompt, options) {
+    const messages = [];
+    if (options.system)
+        messages.push({ role: "system", content: options.system });
+    messages.push({ role: "user", content: prompt });
+    return messages;
+}
+function buildBody(prompt, options, stream) {
+    return {
+        model: options.model || DEFAULT_MODEL,
+        messages: buildMessages(prompt, options),
+        ...(options.temperature === undefined ? {} : { temperature: options.temperature }),
+        ...(options.maxTokens === undefined ? {} : { max_tokens: options.maxTokens }),
+        ...(options.tools ? { tools: options.tools } : {}),
+        ...(stream ? { stream: true } : {}),
+        ...(options.extra ?? {}),
+    };
+}
+async function readError(response, route) {
+    let body = null;
+    try {
+        body = await response.json();
+    }
+    catch {
+        body = null;
+    }
+    const record = (body ?? {});
+    const message = record.error?.message || `NAR request failed with status ${response.status}`;
+    const code = record.error?.code || record.error?.type || `http_${response.status}`;
+    return new NarError(message, response.status, code, route, body);
+}
+function mergeToolCalls(into, deltas) {
+    if (!Array.isArray(deltas))
+        return into;
+    for (const call of deltas) {
+        const index = typeof call.index === "number" ? call.index : 0;
+        const existing = (into[index] ??= { arguments: "" });
+        if (typeof call.id === "string" && call.id)
+            existing.id = call.id;
+        const fn = call.function;
+        if (fn && typeof fn.name === "string")
+            existing.name = fn.name;
+        if (fn && typeof fn.arguments === "string")
+            existing.arguments += fn.arguments;
+    }
+    return into;
+}
+function parseChunk(payload, route, toolCalls) {
+    try {
+        const parsed = JSON.parse(payload);
+        const choice = parsed?.choices?.[0] ?? {};
+        const delta = choice.delta ?? {};
+        mergeToolCalls(toolCalls, delta.tool_calls);
+        return {
+            delta: typeof delta.content === "string" ? delta.content : "",
+            toolCalls,
+            finishReason: typeof choice.finish_reason === "string" ? choice.finish_reason : null,
+            route,
+        };
+    }
+    catch {
+        return { delta: "", toolCalls, finishReason: null, route };
+    }
+}
+/**
+ * Stream a chat completion as text deltas.
+ *
+ *   for await (const delta of nar.stream("explain pythons")) console.log(delta);
+ *
+ * Yields plain strings, so a caller that only wants the text never touches SSE.
+ * Use streamEvents when tool calls are needed.
+ */
+export async function* stream(prompt, options = {}) {
+    for await (const event of streamEvents(prompt, options)) {
+        if (event.delta)
+            yield event.delta;
+    }
+}
+/** Same as stream(), but yields structured events including accumulated tool calls. */
+export async function* streamEvents(prompt, options = {}) {
+    const response = await fetch(`${apiBase(options.baseUrl)}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${options.apiKey || envKey()}`,
+        },
+        body: JSON.stringify(buildBody(prompt, options, true)),
+        signal: options.signal,
+    });
+    const route = routeFrom(response.headers);
+    if (!response.ok)
+        throw await readError(response, route);
+    if (!response.body)
+        throw new NarError("NAR returned an empty stream", 502, "empty_stream", route, null);
+    // Network chunks do not align with SSE frame boundaries, so partial frames are held
+    // in `buffer` until the next chunk supplies the rest of the line.
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    const toolCalls = {};
+    let buffer = "";
+    let done = false;
+    while (!done) {
+        const { value, done: finished } = await reader.read();
+        if (finished) {
+            buffer += decoder.decode();
+            done = true;
+        }
+        else {
+            buffer += decoder.decode(value, { stream: true });
+        }
+        // Frames are separated by a blank line; a trailing partial frame stays in buffer.
+        let boundary = buffer.indexOf("\n\n");
+        while (boundary !== -1) {
+            const frame = buffer.slice(0, boundary);
+            buffer = buffer.slice(boundary + 2);
+            const payload = frame
+                .split("\n")
+                .filter((line) => line.startsWith("data:"))
+                .map((line) => line.slice(5).trim())
+                .join("");
+            if (payload && payload !== "[DONE]")
+                yield parseChunk(payload, route, toolCalls);
+            boundary = buffer.indexOf("\n\n");
+        }
+    }
+}
+/** Collect a full streamed answer. Convenient when streaming is not needed downstream. */
+export async function chat(prompt, options = {}) {
+    let text = "";
+    let route = { provider: null, model: null, attemptTrail: null };
+    for await (const event of streamEvents(prompt, options)) {
+        text += event.delta;
+        route = event.route;
+    }
+    return { text, route, usage: null, raw: null };
+}
+/** One non-streaming request, returning the parsed OpenAI-shaped envelope. */
+export async function complete(prompt, options = {}) {
+    const response = await fetch(`${apiBase(options.baseUrl)}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${options.apiKey || envKey()}`,
+        },
+        body: JSON.stringify(buildBody(prompt, options, false)),
+        signal: options.signal,
+    });
+    const route = routeFrom(response.headers);
+    if (!response.ok)
+        throw await readError(response, route);
+    const body = (await response.json());
+    return {
+        text: body?.choices?.[0]?.message?.content ?? "",
+        route,
+        usage: body?.usage ?? null,
+        raw: body,
+    };
+}
+/** List live models. Pass this to a user or an agent to see what is actually available. */
+export async function models(options = {}) {
+    const response = await fetch(`${apiBase(options.baseUrl)}/models`, {
+        headers: { authorization: `Bearer ${options.apiKey || envKey()}` },
+        signal: options.signal,
+    });
+    const route = routeFrom(response.headers);
+    if (!response.ok)
+        throw await readError(response, route);
+    const body = (await response.json());
+    return (body.data ?? []).map((entry) => String(entry.id)).filter(Boolean);
+}
+/** Router health, including per-provider auth state. Useful for uptime checks. */
+export async function health(options = {}) {
+    const response = await fetch(`${envBase().replace(/\/+$/, "")}/api/v1/health`, { signal: options.signal });
+    return (await response.json());
+}
+export const nar = { stream, streamEvents, chat, complete, models, health };
+export default nar;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@nexuss0781/nar",
+  "version": "0.1.0",
+  "description": "Minimal client for Nexuss AI Router: auto-routed free LLMs, SSE streaming, one master key, no provider handling.",
+  "keywords": ["llm", "router", "gateway", "openai-compatible", "sse", "agents", "ai"],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "sideEffects": false,
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "git+https://github.com/nexuss0781/Nexuss-Router.git", "directory": "sdk" },
+  "devDependencies": { "typescript": "^5.0.0", "@types/node": "^22.0.0" }
+}