v0.1 · production

Route work across the models you already use.

Nymrel Agent applies one deterministic routing contract across a public API, a local CLI, and an MCP server. You supply the model catalog and its evidence. Nymrel Agent filters ineligible options, ranks the rest, and explains the decision.

Quickstart

The public endpoint needs no account or API key. It accepts model metadata, not task or prompt text.

curl -sS https://nymrel-agent.vercel.app/v1/route \
  -H "content-type: application/json" \
  --data-binary @examples/route-request.json

Download the example at /examples/route-request.json. A successful response includes selectedModelId, the ranked eligible set, every rejected candidate with reason codes, and the score components.

Request contract

The root object has exactly two fields: request and models. Unknown fields fail closed. Payloads are capped at 256 KiB and 100 models.

{
  "request": {
    "phase": "implement",
    "risk": "workspace_write",
    "objective": "balanced",
    "requirements": {
      "toolUse": true,
      "structuredOutput": true,
      "minContextTokens": 32000,
      "modalities": ["text"]
    },
    "constraints": {
      "dataBoundary": "approved_provider",
      "maxCostMicroUsd": 50000,
      "maxLatencyMs": 10000
    }
  },
  "models": [/* 1–100 model profiles */]
}

See the complete OpenAPI 3.1 document for enums, limits, and response schemas.

Scoring

Routing happens in two phases. First, a model is rejected if it violates health, risk class, data boundary, capability, context, modality, cost, or latency requirements. Duplicate model IDs are also rejected. Second, eligible candidates receive normalized quality, reliability, cost, latency, health, and optional incumbent-stickiness components.

The selected objective changes explicit weights:

• balanced: quality 35%, reliability 25%, cost 20%, latency 15%, health 5%.
• quality: quality 60%, reliability 25%, with 5% each for cost, latency, and health.
• cost: cost 45%, quality and reliability 20% each, latency 10%, health 5%.
• latency: latency 45%, quality and reliability 20% each, cost 10%, health 5%.

Errors

All API errors are JSON and include a request ID plus a stable code. Expected codes include invalid_json, invalid_content_length, invalid_request, payload_too_large, unsupported_media_type, method_not_allowed, rate_limited, service_misconfigured, service_disabled, and not_found. The Vercel production endpoint applies a project-level WAF limit of 120 routing calls per 60-second window per platform-derived network identity, shared across function instances. Shared networks can share an allowance. Internal stack traces and request bodies are never returned.

CLI

Until the npm package is published, install from the versioned v0.1.0 source release:

git clone https://github.com/JalenBuildsHub/nymrel-agent.git
cd nymrel-agent
npm ci
npm run compile
node dist/src/bin/nymrel-agent.js route --file examples/route-request.json

The CLI reads locally by default and writes the result as JSON to stdout. Use --endpoint https://nymrel-agent.vercel.app to call the hosted router. No prompt is sent because route payloads contain metadata only.

MCP

The MCP server exposes route_models and explain_contract over stdio. Configure your compatible client to run node /absolute/path/to/dist/src/bin/nymrel-agent-mcp.js. Protocol messages use stdout; diagnostics use stderr.

Local execution

The optional local harness can execute read-only tasks through explicitly configured adapters. Provider keys are read from an environment variable named in your local config and sent directly from your machine to that provider. Keys are never accepted by the public Nymrel endpoint, stored in receipts, or printed by the CLI.

v0.1 includes an OpenAI Responses adapter and a synthetic adapter for offline verification. A profile that claims local_only custody is accepted only when its adapter uses a loopback base URL. Provider responses are size-bounded and must report completed; partial responses fail closed. The public router remains provider-neutral and can rank any provider profile. Write-capable tools and hosted key custody are not enabled.

Security and privacy

• The hosted router accepts no prompts, files, provider keys, or customer identifiers.
• Requests are processed in memory and are not written by application code.
• Standard network metadata may be processed by the hosting platform for delivery, abuse protection, and operational telemetry.
• Local receipts contain SHA-256 correlation digests, not task or output bodies. A digest is not an encryption or confidentiality control.
• The local execution runtime permits read-only runs only in v0.1.

Report a security issue privately to contact@jalenbuilds.com. Do not include provider credentials or customer data.

Managed implementation service

Nymrel can configure a model catalog, evidence collection, routing policy, evals, local adapters, and operational receipts for a real workflow. Hosted provider execution, credentials, data retention, and write-capable tools require a separate scope and security review. Pricing is provided on request.

Start a project brief