@reneturcios/modelrelay 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rene Turcios
+
+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

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# modelrelay
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Open AI models are spread across providers with incompatible APIs and price lists. modelrelay is a small local bridge to the hosted Synap MCP service: you can run a chat completion on one of the open models Synap serves, browse the live catalogue with per-million-token prices, pull the full record for a single model, and estimate what a call will cost before you spend anything.
+
+Nothing is stored or computed on your own machine. This package answers `tools/list` locally from the captured tool definitions and forwards every `tools/call` to the hosted service over a streamable-HTTP JSON-RPC session, returning whatever the service sends back unchanged.
+
+## The tools
+
+Three of the four tools are free catalogue and price reads. The fourth, `synap_chat_completion`, is the only one that costs money: it bills prompt and completion tokens to the Synap API key supplied with the call, against your own pre-existing Synap account. No tool buys credit, tops up a balance, starts a subscription, or creates an API key.
+
+- **`synap_chat_completion`** — Sends a conversation to a model and returns the standard OpenAI `chat.completion` JSON: the reply sits in `choices[0].message.content` and token counts in `usage`. The call is not streamed and keeps no memory between calls, so send the full message history each time. The model id `synap-v1` lets Synap pick the cheapest model that can handle the request. `temperature` (0 to 2) and `max_tokens` are optional.
+- **`synap_list_models`** — The live list of models Synap serves right now, each with its price per million tokens, context window and what it is good at. An optional `query` filters case-insensitively against model id, name and capability. Auto-routing ids such as `synap-v1` carry no fixed price; they bill at the price of the model they route to.
+- **`synap_get_model`** — The complete catalogue record for one model: pricing, context and output limits, supported parameters, quantisation, data-retention policy and readiness. An unknown id comes back as an error naming the id.
+- **`synap_estimate_cost`** — Works out what a chat completion would cost from token counts, using the live price list: prompt and completion dollars and the total. `completion_tokens` defaults to 0; use your `max_tokens` for a worst case. Auto-routing ids have no fixed price and return an error saying so.
+
+## Install and run
+
+As an MCP server via npm:
+
+```bash
+npx -y @reneturcios/modelrelay mcp
+```
+
+MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "modelrelay": {
+      "command": "npx",
+      "args": ["-y", "@reneturcios/modelrelay", "mcp"]
+    }
+  }
+}
+```
+
+As a container:
+
+```bash
+docker run -i ghcr.io/cloudcorprecords/modelrelay
+docker run --rm ghcr.io/cloudcorprecords/modelrelay synap_get_model '{"model":"qwen3-coder-30b"}'
+```
+
+## CLI
+
+One binary serves both the command line and the MCP server. Each tool is a subcommand taking a single JSON string with that tool's arguments:
+
+```bash
+modelrelay synap_list_models '{"query":"coder"}'
+modelrelay synap_chat_completion '{"model":"synap-v1","messages":[{"role":"user","content":"hello"}]}'
+modelrelay synap_get_model '{"model":"qwen3-coder-30b"}'
+modelrelay synap_estimate_cost '{"model":"qwen3-coder-30b","prompt_tokens":500,"completion_tokens":200}'
+modelrelay --version
+```
+
+Exit codes: `0` when the forwarded call succeeds, `1` when the upstream result is an error, and `2` for usage problems such as an unknown subcommand or a malformed JSON argument.
+
+## Configuration
+
+- `SYNAP_MCP_URL` — Overrides the upstream endpoint. The default is the pinned hosted endpoint, `https://pool.linkrra.com/mcp`. (The override variable is a reconstruction added by this rebuild.)
+- `SYNAP_API_KEY` — When set, its value is sent to the upstream on every request as an `Authorization: Bearer <value>` header. When it is not set, no key header is sent at all, matching the keyless behaviour the tool surface was captured with. (The hosted service's registry record pins a secret `Authorization` header on its remote; the environment-variable forwarding is a reconstruction added by this rebuild.) Without a key, `synap_chat_completion` returns an error and nothing is spent; the three catalogue tools need no key.
+
+Upstream failures — a JSON-RPC error from the service, a non-2xx response, an unreadable body, or a request that fails outright — are reported to the caller as an error result whose text starts with `modelrelay error:`.
+
+## How forwarding works
+
+The first forwarded call opens a session: an `initialize` request (protocol version `2025-03-26`), followed by a `notifications/initialized` notification, then the `tools/call` itself. If the service answers the initialize request with an `Mcp-Session-Id` header, that value is carried on every later request, and the open session is reused for the rest of the process. Replies are accepted either as plain JSON or as server-sent events. Successful results pass through verbatim, including any `isError` flag and any extra fields the service includes.
+
+## Development
+
+```bash
+npm install
+npm run build   # tsc -> dist/ (dist/cli.js is the bin)
+npm test        # tsx --test test/*.test.ts — stubbed upstream, no network
+npm run dev     # run the CLI from source
+```
+
+The test suite checks the served tool list against the captured surface tool by tool, exercises the session handshake and its reuse, covers both key-header branches, and verifies that arguments go upstream untouched and results come back untouched.
+
+## License
+
+MIT — see `LICENSE`. Copyright (c) 2026 Rene Turcios.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+/**
+ * modelrelay CLI.
+ *
+ *   modelrelay <tool> '<json-args>'
+ *   modelrelay mcp
+ *   modelrelay --version
+ *
+ * <tool> is one of the 4 forwarded tools. Each tool
+ * subcommand takes a single JSON argument string holding
+ * that tool's arguments, forwards the call the same way
+ * the MCP path does, and prints the forwarded result
+ * content. Exit codes: 0 success, 1 on an isError
+ * result, 2 usage error.
+ */
+import { callTool, TOOL_NAMES, VERSION } from "./forward.js";
+function usage() {
+    console.error(`Usage:
+  modelrelay <tool> '<json-args>'     one of: ${TOOL_NAMES.join(", ")}
+  modelrelay mcp
+  modelrelay --version`);
+    process.exit(2);
+}
+function firstText(result) {
+    const content = result.content;
+    if (Array.isArray(content)) {
+        for (const item of content) {
+            if (item !== null &&
+                typeof item === "object" &&
+                item.type === "text" &&
+                typeof item.text === "string") {
+                return item.text;
+            }
+        }
+    }
+    return typeof content === "string" ? content : JSON.stringify(content);
+}
+async function main() {
+    const [cmd, ...rest] = process.argv.slice(2);
+    if (cmd === "--version" || cmd === "-v") {
+        console.log(VERSION);
+        return;
+    }
+    if (cmd === "mcp") {
+        if (rest.length !== 0)
+            usage();
+        const { startMcpServer } = await import("./mcp.js");
+        await startMcpServer();
+        return;
+    }
+    if (!TOOL_NAMES.includes(cmd ?? ""))
+        usage();
+    if (rest.length > 1)
+        usage();
+    let args = {};
+    if (rest.length === 1) {
+        try {
+            const parsed = JSON.parse(rest[0]);
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                usage();
+            }
+            args = parsed;
+        }
+        catch {
+            console.error("error: argument must be a JSON object string");
+            process.exit(2);
+        }
+    }
+    const result = await callTool(cmd, args);
+    if (result.isError) {
+        console.error(`error: ${firstText(result)}`);
+        process.exit(1);
+    }
+    console.log(typeof result.content === "string"
+        ? result.content
+        : JSON.stringify(result.content, null, 2));
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/forward.d.ts

@@ -0,0 +1,85 @@
+/**
+ * modelrelay core: a forwarding client for the hosted
+ * Synap MCP server.
+ *
+ * No model inference happens on this machine. tools/list is
+ * answered from the literal definitions below, which
+ * reproduce a live capture of the upstream server word
+ * for word (name, title, description and inputSchema
+ * exactly as captured; `synap_chat_completion` requires
+ * `model` and `messages`, `synap_get_model` requires
+ * `model`, `synap_estimate_cost` requires `model` and
+ * `prompt_tokens`, and `synap_list_models` declares no
+ * `required` field). A tools/call travels upstream over a
+ * streamable-HTTP JSON-RPC session: an initialize POST, a
+ * notifications/initialized POST, then the tools/call
+ * POST, carrying the Mcp-Session-Id response header on
+ * later requests when the upstream issues one. The
+ * session opens lazily on the first forwarded call and
+ * is reused for the client's lifetime.
+ *
+ * The endpoint is pinned to
+ * https://pool.linkrra.com/mcp and may be
+ * replaced with the SYNAP_MCP_URL environment
+ * variable (that override is a labelled
+ * reconstruction). The registry record pins a secret
+ * `Authorization` header on its remote and the capture
+ * was taken keyless; when SYNAP_API_KEY is set, every
+ * upstream request carries an
+ * `Authorization: Bearer <key>` header (that env
+ * forwarding is a labelled reconstruction). When it is
+ * unset, no key header goes out.
+ *
+ * A successful upstream result is returned exactly as
+ * received, isError flag and extra fields included.
+ * Failures — an upstream JSON-RPC error, a non-2xx
+ * status, a body that cannot be parsed, or a fetch
+ * that throws or times out — become an isError result
+ * whose text begins with `modelrelay error:` (that
+ * rendering is a labelled reconstruction). Replies may
+ * be plain JSON or SSE (`data:` lines); the JSON-RPC
+ * message whose id matches the request wins.
+ */
+import type { ForwardDeps, ToolArgs, ToolDef, ToolResult } from "./types.js";
+export declare const VERSION = "0.1.0";
+export declare const DEFAULT_ENDPOINT_URL = "https://pool.linkrra.com/mcp";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const PROTOCOL_VERSION = "2025-03-26";
+export declare const TOOL_DEFS: ToolDef[];
+export declare const TOOL_NAMES: string[];
+/** Whether `name` belongs to the captured surface. */
+export declare function isKnownTool(name: string): boolean;
+/**
+ * Read a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * present, otherwise the last parseable message, otherwise
+ * null when nothing in the body parses.
+ */
+export declare function parseRpcBody(text: string, expectedId?: number): Record<string, unknown> | null;
+/**
+ * A forwarding client holding a single upstream session,
+ * opened lazily on first use and reused from then on
+ * (for the process lifetime in the MCP server, or for a
+ * single invocation in the CLI).
+ */
+export declare class ModelrelayClient {
+    private readonly deps;
+    private sessionId;
+    private ready;
+    private sessionPromise;
+    private idCounter;
+    constructor(deps?: ForwardDeps);
+    private fetchFn;
+    private endpointUrl;
+    private apiKey;
+    private timeoutMs;
+    private nextId;
+    private post;
+    private ensureSession;
+    /** Forward one tool call; upstream failures come back as isError results. */
+    callTool(name: string, args: ToolArgs): Promise<ToolResult>;
+}
+/** Build a forwarding client; tests inject a fake fetch and env through deps. */
+export declare function createClient(deps?: ForwardDeps): ModelrelayClient;
+/** One-shot helper: a fresh client for a single call (the CLI path). */
+export declare function callTool(name: string, args: ToolArgs, deps?: ForwardDeps): Promise<ToolResult>;

package/dist/forward.js

@@ -0,0 +1,360 @@
+export const VERSION = "0.1.0";
+export const DEFAULT_ENDPOINT_URL = "https://pool.linkrra.com/mcp";
+export const DEFAULT_TIMEOUT_MS = 30000;
+export const PROTOCOL_VERSION = "2025-03-26";
+/* ------------------------------------------------------------------ */
+/* Tool definitions (tools/list literals, verbatim from the live       */
+/* capture in harness/fixtures/synap-tools-original.json;              */
+/* generated programmatically by parsing and re-serialising the        */
+/* fixture JSON, never retyped)                                        */
+/* ------------------------------------------------------------------ */
+export const TOOL_DEFS = [
+    {
+        "name": "synap_chat_completion",
+        "title": "Run a chat completion on Synap",
+        "description": "Send a conversation to a model on Synap, Linkrra's OpenAI-compatible inference API, and get the model's reply. Use this when you need text generated, code written or a question answered by one of the open models Synap serves. This is the only tool here that costs money: it bills prompt and completion tokens to the Synap API key supplied as the Authorization: Bearer header on the MCP connection. With no key it returns an error and nothing is spent; a key with no balance returns insufficient_credits. Call synap_estimate_cost first if the price matters. Returns the standard OpenAI chat.completion JSON (choices[0].message.content holds the reply, usage holds token counts). The call is not streamed and keeps no memory between calls — send the full message history each time.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "model": {
+                    "type": "string",
+                    "description": "Model id exactly as returned by synap_list_models, e.g. \"qwen3-coder-30b\". Use \"synap-v1\" to let Synap pick the cheapest model that can handle the request."
+                },
+                "messages": {
+                    "type": "array",
+                    "description": "The conversation so far, oldest first. The last message is normally the user turn to answer.",
+                    "minItems": 1,
+                    "items": {
+                        "type": "object",
+                        "properties": {
+                            "role": {
+                                "type": "string",
+                                "enum": [
+                                    "system",
+                                    "user",
+                                    "assistant"
+                                ],
+                                "description": "Who wrote the message: system (instructions), user, or assistant (an earlier model reply)."
+                            },
+                            "content": {
+                                "type": "string",
+                                "description": "The message text."
+                            }
+                        },
+                        "required": [
+                            "role",
+                            "content"
+                        ]
+                    }
+                },
+                "temperature": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 2,
+                    "description": "Sampling randomness, 0 to 2. Lower is more deterministic. Omit to use the model default."
+                },
+                "max_tokens": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "Upper limit on tokens generated in the reply. Omit to use the model default; lower it to cap cost."
+                }
+            },
+            "required": [
+                "model",
+                "messages"
+            ]
+        }
+    },
+    {
+        "name": "synap_list_models",
+        "title": "List Synap models and prices",
+        "description": "List the models Synap serves right now, each with its price per million tokens, context window and what it is good at. Use this to choose a model id before calling synap_chat_completion, or to compare prices. Free, read-only, no API key needed, and safe to call repeatedly; the list is live, so models can appear or go between calls. Returns {\"object\":\"list\",\"count\":N,\"data\":[{id,name,capability,tier,context_tokens,max_output_tokens,pricing,data_policy}]}; pricing is USD per million prompt and completion tokens and is absent for the auto-routing ids (\"synap-v1\"), which bill at the price of the model they route to. For every field of one model use synap_get_model.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "query": {
+                    "type": "string",
+                    "description": "Optional case-insensitive filter matched against model id, name and capability, e.g. \"coder\", \"qwen\" or \"vision\". Omit to list everything."
+                }
+            }
+        }
+    },
+    {
+        "name": "synap_get_model",
+        "title": "Get one Synap model in full",
+        "description": "Return the complete catalogue record for one Synap model: pricing, context and output limits, supported parameters, quantisation, data-retention policy and readiness. Use this after synap_list_models when you need details the summary leaves out. Free, read-only and needs no API key. Returns the raw model object, or an error naming the id if Synap does not serve it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "model": {
+                    "type": "string",
+                    "description": "Model id exactly as returned by synap_list_models."
+                }
+            },
+            "required": [
+                "model"
+            ]
+        }
+    },
+    {
+        "name": "synap_estimate_cost",
+        "title": "Estimate the cost of a Synap call",
+        "description": "Work out what a chat completion would cost on Synap from token counts, using the live price list. Use this before synap_chat_completion when budget matters, or to compare models for a job. Free, read-only, needs no API key and runs no model. Returns {model, prompt_tokens, completion_tokens, prompt_usd, completion_usd, total_usd, pricing}. It is an estimate: the real charge uses the token counts the model reports afterwards. Auto-routing ids such as \"synap-v1\" have no fixed price and return an error saying so.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "model": {
+                    "type": "string",
+                    "description": "Model id exactly as returned by synap_list_models."
+                },
+                "prompt_tokens": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "Tokens you will send (system + conversation). Roughly 4 characters of English per token."
+                },
+                "completion_tokens": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "description": "Tokens you expect back. Use your max_tokens for a worst case. Defaults to 0."
+                }
+            },
+            "required": [
+                "model",
+                "prompt_tokens"
+            ]
+        }
+    }
+];
+export const TOOL_NAMES = TOOL_DEFS.map((t) => t.name);
+/** Whether `name` belongs to the captured surface. */
+export function isKnownTool(name) {
+    return TOOL_NAMES.includes(name);
+}
+/* ------------------------------------------------------------------ */
+/* Forwarding client                                                   */
+/* ------------------------------------------------------------------ */
+function errorResult(detail) {
+    return {
+        content: [{ type: "text", text: `modelrelay error: ${detail}` }],
+        isError: true,
+    };
+}
+function rpcErrorMessage(error) {
+    if (error !== null && typeof error === "object") {
+        const message = error.message;
+        if (typeof message === "string" && message !== "")
+            return message;
+        return JSON.stringify(error);
+    }
+    return String(error);
+}
+/**
+ * Read a JSON-RPC response body, tolerating SSE framing.
+ * Returns the message whose id matches `expectedId` when
+ * present, otherwise the last parseable message, otherwise
+ * null when nothing in the body parses.
+ */
+export function parseRpcBody(text, expectedId) {
+    const trimmed = text.trim();
+    if (trimmed === "")
+        return null;
+    const candidates = [];
+    const tryPush = (payload) => {
+        try {
+            const parsed = JSON.parse(payload);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                candidates.push(parsed);
+            }
+        }
+        catch {
+            // Not a JSON payload; skip this candidate.
+        }
+    };
+    if (trimmed.includes("data:")) {
+        for (const line of trimmed.split("\n")) {
+            const t = line.trim();
+            if (!t.startsWith("data:"))
+                continue;
+            const payload = t.slice("data:".length).trim();
+            if (payload !== "" && payload !== "[DONE]")
+                tryPush(payload);
+        }
+    }
+    else {
+        tryPush(trimmed);
+    }
+    if (candidates.length === 0)
+        return null;
+    if (expectedId !== undefined) {
+        const match = candidates.find((c) => c.id === expectedId);
+        if (match !== undefined)
+            return match;
+    }
+    return candidates[candidates.length - 1];
+}
+async function defaultFetch(url, init) {
+    return fetch(url, init);
+}
+/**
+ * A forwarding client holding a single upstream session,
+ * opened lazily on first use and reused from then on
+ * (for the process lifetime in the MCP server, or for a
+ * single invocation in the CLI).
+ */
+export class ModelrelayClient {
+    deps;
+    sessionId = null;
+    ready = false;
+    sessionPromise = null;
+    idCounter = 0;
+    constructor(deps = {}) {
+        this.deps = deps;
+    }
+    fetchFn() {
+        return this.deps.fetchFn ?? defaultFetch;
+    }
+    endpointUrl() {
+        if (this.deps.url && this.deps.url.trim() !== "")
+            return this.deps.url.trim();
+        const raw = (this.deps.env ?? process.env).SYNAP_MCP_URL;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return DEFAULT_ENDPOINT_URL;
+    }
+    apiKey() {
+        const raw = (this.deps.env ?? process.env).SYNAP_API_KEY;
+        if (raw && raw.trim() !== "")
+            return raw.trim();
+        return null;
+    }
+    timeoutMs() {
+        if (typeof this.deps.timeoutMs === "number" && this.deps.timeoutMs > 0) {
+            return this.deps.timeoutMs;
+        }
+        return DEFAULT_TIMEOUT_MS;
+    }
+    nextId() {
+        this.idCounter += 1;
+        return this.idCounter;
+    }
+    async post(body, withSession) {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json, text/event-stream",
+        };
+        const key = this.apiKey();
+        if (key !== null)
+            headers["Authorization"] = `Bearer ${key}`;
+        if (withSession && this.sessionId !== null) {
+            headers["Mcp-Session-Id"] = this.sessionId;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs());
+        try {
+            return await this.fetchFn()(this.endpointUrl(), {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async ensureSession() {
+        if (this.ready)
+            return;
+        if (this.sessionPromise === null) {
+            this.sessionPromise = (async () => {
+                const initId = this.nextId();
+                const initRes = await this.post({
+                    jsonrpc: "2.0",
+                    id: initId,
+                    method: "initialize",
+                    params: {
+                        protocolVersion: PROTOCOL_VERSION,
+                        capabilities: {},
+                        clientInfo: { name: "modelrelay", version: VERSION },
+                    },
+                }, false);
+                const sessionId = initRes.headers.get("mcp-session-id");
+                if (sessionId)
+                    this.sessionId = sessionId;
+                const initText = await initRes.text();
+                const initParsed = parseRpcBody(initText, initId);
+                if (initParsed !== null && initParsed.error) {
+                    throw new Error(rpcErrorMessage(initParsed.error));
+                }
+                if (initRes.status < 200 || initRes.status >= 300) {
+                    throw new Error(`HTTP ${initRes.status}`);
+                }
+                if (initParsed === null && initText.trim() !== "") {
+                    throw new Error("malformed response");
+                }
+                const initializedRes = await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, true);
+                try {
+                    await initializedRes.text();
+                }
+                catch {
+                    // Nothing needed from the notification response body.
+                }
+                this.ready = true;
+            })();
+        }
+        try {
+            await this.sessionPromise;
+        }
+        catch (err) {
+            this.sessionPromise = null;
+            this.sessionId = null;
+            throw err;
+        }
+    }
+    /** Forward one tool call; upstream failures come back as isError results. */
+    async callTool(name, args) {
+        try {
+            await this.ensureSession();
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+        const callId = this.nextId();
+        let callRes;
+        try {
+            callRes = await this.post({
+                jsonrpc: "2.0",
+                id: callId,
+                method: "tools/call",
+                params: { name, arguments: args ?? {} },
+            }, true);
+        }
+        catch (err) {
+            return errorResult(`request failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const parsed = parseRpcBody(await callRes.text(), callId);
+        if (parsed !== null && parsed.error) {
+            return errorResult(rpcErrorMessage(parsed.error));
+        }
+        if (callRes.status < 200 || callRes.status >= 300) {
+            return errorResult(`HTTP ${callRes.status}`);
+        }
+        if (parsed === null)
+            return errorResult("malformed response");
+        const result = parsed.result;
+        if (result === undefined || result === null || typeof result !== "object") {
+            return errorResult("malformed response");
+        }
+        // Hand the upstream result back exactly as received.
+        return result;
+    }
+}
+/** Build a forwarding client; tests inject a fake fetch and env through deps. */
+export function createClient(deps = {}) {
+    return new ModelrelayClient(deps);
+}
+/** One-shot helper: a fresh client for a single call (the CLI path). */
+export async function callTool(name, args, deps = {}) {
+    return new ModelrelayClient(deps).callTool(name, args);
+}
+//# sourceMappingURL=forward.js.map

package/dist/forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,wEAAwE;AACxE,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC;QACE,MAAM,EAAE,uBAAuB;QAC/B,OAAO,EAAE,gCAAgC;QACzC,aAAa,EAAE,6wBAA6wB;QAC5xB,aAAa,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE;gBACZ,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,iKAAiK;iBACjL;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,OAAO;oBACf,aAAa,EAAE,8FAA8F;oBAC7G,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;wBAChB,YAAY,EAAE;4BACZ,MAAM,EAAE;gCACN,MAAM,EAAE,QAAQ;gCAChB,MAAM,EAAE;oCACN,QAAQ;oCACR,MAAM;oCACN,WAAW;iCACZ;gCACD,aAAa,EAAE,4FAA4F;6BAC5G;4BACD,SAAS,EAAE;gCACT,MAAM,EAAE,QAAQ;gCAChB,aAAa,EAAE,mBAAmB;6BACnC;yBACF;wBACD,UAAU,EAAE;4BACV,MAAM;4BACN,SAAS;yBACV;qBACF;iBACF;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,0FAA0F;iBAC1G;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,oGAAoG;iBACpH;aACF;YACD,UAAU,EAAE;gBACV,OAAO;gBACP,UAAU;aACX;SACF;KACF;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,OAAO,EAAE,8BAA8B;QACvC,aAAa,EAAE,yqBAAyqB;QACxrB,aAAa,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE;gBACZ,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,kJAAkJ;iBAClK;aACF;SACF;KACF;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,6BAA6B;QACtC,aAAa,EAAE,iXAAiX;QAChY,aAAa,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE;gBACZ,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,oDAAoD;iBACpE;aACF;YACD,UAAU,EAAE;gBACV,OAAO;aACR;SACF;KACF;IACD;QACE,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,mCAAmC;QAC5C,aAAa,EAAE,sgBAAsgB;QACrhB,aAAa,EAAE;YACb,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE;gBACZ,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,oDAAoD;iBACpE;gBACD,eAAe,EAAE;oBACf,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,0FAA0F;iBAC1G;gBACD,mBAAmB,EAAE;oBACnB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,8EAA8E;iBAC9F;aACF;YACD,UAAU,EAAE;gBACV,OAAO;gBACP,eAAe;aAChB;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEvD,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,MAAM,EAAE,EAAE,CAAC;QAChE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAI,KAA+B,CAAC,OAAO,CAAC;QACzD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,OAAO,CAAC;QAClE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,UAAmB;IAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,UAAU,GAA8B,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,CAAC,OAAe,EAAQ,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,UAAU,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC,CAAC;IACF,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACrC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;QAC1D,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,GAAW,EACX,IAKC;IAED,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,CAAiC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACV,IAAI,CAAc;IAC3B,SAAS,GAAkB,IAAI,CAAC;IAChC,KAAK,GAAG,KAAK,CAAC;IACd,cAAc,GAAyB,IAAI,CAAC;IAC5C,SAAS,GAAG,CAAC,CAAC;IAEtB,YAAY,OAAoB,EAAE;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,OAAO;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,YAAY,CAAC;IAC3C,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;QACzD,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;QACzD,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,SAAS;QACf,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7B,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAa,EACb,WAAoB;QAEpB,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,qCAAqC;SAC9C,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,GAAG,EAAE,CAAC;QAC7D,IAAI,WAAW,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC3C,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7C,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;gBAC9C,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;gBAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAC7B;oBACE,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,MAAM;oBACV,MAAM,EAAE,YAAY;oBACpB,MAAM,EAAE;wBACN,eAAe,EAAE,gBAAgB;wBACjC,YAAY,EAAE,EAAE;wBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE;qBACrD;iBACF,EACD,KAAK,CACN,CAAC;gBACF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBACxD,IAAI,SAAS;oBAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC1C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAClD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;oBAC5C,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,UAAU,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBACxC,CAAC;gBACD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,IAAI,CACpC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,EACvD,IAAI,CACL,CAAC;gBACF,IAAI,CAAC;oBACH,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,sDAAsD;gBACxD,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YACpB,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAAc;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CACvB;gBACE,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,MAAM;gBACV,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;aACxC,EACD,IAAI,CACL,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAChB,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAClD,OAAO,WAAW,CAAC,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgC,CAAC;QACvD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1E,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;QACD,qDAAqD;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE;IACjD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAAc,EACd,OAAoB,EAAE;IAEtB,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export * from "./forward.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./forward.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,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,33 @@
+/**
+ * modelrelay MCP server. Tools: the 4 captured
+ * Synap tools (see forward.ts).
+ *
+ * This file uses the low-level Server API rather than
+ * McpServer: the high-level helper rebuilds schemas from
+ * zod and rewrites what is served, which would break
+ * exact parity with the captured tools/list. Here
+ * tools/list is answered locally from the core's literal
+ * definitions — the verbatim objects from the upstream
+ * capture — and every tools/call is forwarded upstream.
+ *
+ * A forwarded result returns unchanged, upstream isError
+ * flag and extra fields included. An upstream failure
+ * arrives as an isError result carrying a
+ * `modelrelay error:` text, built by the forwarding
+ * client. Unknown tool names are rejected with McpError
+ * MethodNotFound, and non-object arguments with McpError
+ * InvalidParams, before any network hop is made.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type ModelrelayClient } from "./forward.js";
+import type { ForwardDeps, ToolResult } from "./types.js";
+/**
+ * Validate and forward a single tools/call through
+ * `client`. Exported so this layer can be tested directly
+ * without a stdio transport.
+ */
+export declare function handleCallTool(client: ModelrelayClient, name: string, args: unknown): Promise<ToolResult>;
+/** Build the stdio MCP server (transport not yet connected). */
+export declare function createServer(deps?: ForwardDeps): Server;
+/** Connect the MCP server over stdio. */
+export declare function startMcpServer(deps?: ForwardDeps): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,58 @@
+/**
+ * modelrelay MCP server. Tools: the 4 captured
+ * Synap tools (see forward.ts).
+ *
+ * This file uses the low-level Server API rather than
+ * McpServer: the high-level helper rebuilds schemas from
+ * zod and rewrites what is served, which would break
+ * exact parity with the captured tools/list. Here
+ * tools/list is answered locally from the core's literal
+ * definitions — the verbatim objects from the upstream
+ * capture — and every tools/call is forwarded upstream.
+ *
+ * A forwarded result returns unchanged, upstream isError
+ * flag and extra fields included. An upstream failure
+ * arrives as an isError result carrying a
+ * `modelrelay error:` text, built by the forwarding
+ * client. Unknown tool names are rejected with McpError
+ * MethodNotFound, and non-object arguments with McpError
+ * InvalidParams, before any network hop is made.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { createClient, isKnownTool, TOOL_DEFS, VERSION, } from "./forward.js";
+/**
+ * Validate and forward a single tools/call through
+ * `client`. Exported so this layer can be tested directly
+ * without a stdio transport.
+ */
+export async function handleCallTool(client, name, args) {
+    if (!isKnownTool(name)) {
+        throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    if (args !== undefined &&
+        (typeof args !== "object" || args === null || Array.isArray(args))) {
+        throw new McpError(ErrorCode.InvalidParams, `Arguments for tool ${name} must be a JSON object`);
+    }
+    return client.callTool(name, (args ?? {}));
+}
+/** Build the stdio MCP server (transport not yet connected). */
+export function createServer(deps = {}) {
+    const client = createClient(deps);
+    const server = new Server({ name: "modelrelay", version: VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFS,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const result = await handleCallTool(client, name, args);
+        return result;
+    });
+    return server;
+}
+/** Connect the MCP server over stdio. */
+export async function startMcpServer(deps = {}) {
+    await createServer(deps).connect(new StdioServerTransport());
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,sBAAsB,EACtB,QAAQ,GACT,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,SAAS,EACT,OAAO,GAER,MAAM,cAAc,CAAC;AAGtB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAwB,EACxB,IAAY,EACZ,IAAa;IAEb,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IACE,IAAI,KAAK,SAAS;QAClB,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAClE,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,sBAAsB,IAAI,wBAAwB,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;AACxE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,OAAoB,EAAE;IACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,MAAe,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAoB,EAAE;IACzD,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * modelrelay types.
+ *
+ * No model inference happens on this machine. The
+ * package is a forwarding client: the captured tool
+ * surface is kept as data (ToolDef entries served
+ * verbatim for tools/list) and each tools/call is sent
+ * to the hosted Synap MCP endpoint through an
+ * injectable fetch, so the whole test suite can run
+ * against a stubbed upstream with no live network.
+ */
+/** One captured tool definition, served exactly as captured for tools/list. */
+export interface ToolDef {
+    name: string;
+    title?: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** Arguments for a tool call, as decoded JSON. */
+export type ToolArgs = Record<string, unknown>;
+/** A tools/call result: upstream payloads pass through verbatim; local failures use this shape too. */
+export interface ToolResult {
+    content?: unknown;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/** The narrow slice of a fetch Response the forwarding client relies on. */
+export interface FetchResponseLike {
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    text(): Promise<string>;
+}
+/** Injectable fetch function, so tests never reach the live network. */
+export type FetchFn = (url: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<FetchResponseLike>;
+/** Injectable runtime dependencies for the forwarding client. */
+export interface ForwardDeps {
+    /** Fetch implementation. Defaults to the global fetch. */
+    fetchFn?: FetchFn;
+    /** Environment (SYNAP_MCP_URL, SYNAP_API_KEY). Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Endpoint URL override. Defaults to env SYNAP_MCP_URL or the pinned default. */
+    url?: string;
+    /** Per-request timeout in milliseconds. Defaults to 30000. */
+    timeoutMs?: number;
+}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * modelrelay types.
+ *
+ * No model inference happens on this machine. The
+ * package is a forwarding client: the captured tool
+ * surface is kept as data (ToolDef entries served
+ * verbatim for tools/list) and each tools/call is sent
+ * to the hosted Synap MCP endpoint through an
+ * injectable fetch, so the whole test suite can run
+ * against a stubbed upstream with no live network.
+ */
+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":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -1,6 +1,41 @@
 {
+  "bin": {
+    "modelrelay": "dist/cli.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1",
+    "zod": "^4"
+  },
+  "description": "A local stdio bridge to the hosted Synap MCP service: chat completions on open AI models, a live model catalogue with prices, full detail for one model and cost estimates. One bin serves a small CLI and the MCP server.",
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "server.json"
+  ],
+  "homepage": "https://github.com/CloudCorpRecords/modelrelay#readme",
+  "license": "MIT",
+  "mcpName": "io.github.CloudCorpRecords/modelrelay",
   "name": "@reneturcios/modelrelay",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CloudCorpRecords/modelrelay.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "tsx --test test/*.test.ts"
+  },
+  "type": "module",
+  "version": "0.1.0"
+}

package/server.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "description": "Open AI models through one API: chat completions, live model catalogue, prices, cost estimates.",
+  "name": "io.github.CloudCorpRecords/modelrelay",
+  "packages": [
+    {
+      "identifier": "@reneturcios/modelrelay",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "registryType": "npm",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "version": "0.1.0"
+    },
+    {
+      "identifier": "ghcr.io/cloudcorprecords/modelrelay:0.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ],
+      "registryType": "oci",
+      "runtimeArguments": [
+        {
+          "name": "--rm",
+          "type": "named"
+        },
+        {
+          "name": "-i",
+          "type": "named"
+        }
+      ],
+      "runtimeHint": "docker",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "repository": {
+    "source": "github",
+    "url": "https://github.com/CloudCorpRecords/modelrelay"
+  },
+  "version": "0.1.0"
+}