mozart-router 0.1.0

package/examples/opencode/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: mozart-router
+description: Route AI tasks to the best available model based on cost, context, latency, privacy and reliability. Gateways execute — Mozart decides.
+license: MIT
+compatibility: opencode
+metadata:
+  audience: ai-builders
+  category: orchestration
+---
+
+# Mozart Router — OpenCode Skill
+
+## What I do
+- Detect your configured AI providers and models
+- Classify each task and select the optimal model/provider
+- Estimate cost and tokens before execution
+- Scan for secrets and block cloud leaks
+- Explain every routing decision
+- Fall back gracefully when providers fail
+
+## When to use me
+Use this skill when the agent needs to:
+- Choose between multiple available models
+- Estimate the cost of an LLM call before making it
+- Check if context contains secrets before sending to a cloud model
+- Optimize context to reduce token usage
+- Get a fallback plan in case a model fails
+
+## How to use
+Call the Mozart MCP server or SDK:
+
+```typescript
+import { Mozart } from 'mozart-router';
+const mozart = new Mozart();
+await mozart.detectAll();
+const route = await mozart.recommend('your task here');
+```
+
+## Integration modes
+- **MCP Server**: `npx mozart-router mcp`
+- **CLI**: `npx mozart-router doctor`
+- **SDK**: `import { Mozart } from 'mozart-router'`
+- **HTTP API**: `npx mozart-router start --port=4444`
+
+Gateways execute. Mozart decides.
+Do not rebuild what the gateway already does.
+Detect it, understand it, orchestrate it.

package/examples/opencode/mozart-skill.json

@@ -0,0 +1,64 @@
+{
+  "name": "mozart.route_model",
+  "description": "Choose the best available model/provider/gateway for a task",
+  "version": "0.1.0",
+  "type": "skill",
+  "integration": {
+    "provider": "mozart-router",
+    "method": "sdk",
+    "package": "mozart-router"
+  },
+  "input": {
+    "task": {
+      "type": "string",
+      "description": "The task to route",
+      "required": true
+    },
+    "context_size": {
+      "type": "number",
+      "description": "Estimated context size in tokens"
+    },
+    "privacy_mode": {
+      "type": "string",
+      "description": "Privacy level",
+      "enum": ["open", "balanced", "privacy_first", "local_only"],
+      "default": "balanced"
+    },
+    "budget_mode": {
+      "type": "string",
+      "description": "Budget preference",
+      "enum": ["lowest", "balanced", "quality"],
+      "default": "balanced"
+    }
+  },
+  "output": {
+    "selected_gateway": {
+      "type": "string",
+      "description": "Selected gateway"
+    },
+    "selected_provider": {
+      "type": "string",
+      "description": "Selected provider"
+    },
+    "selected_model": {
+      "type": "string",
+      "description": "Selected model"
+    },
+    "confidence": {
+      "type": "number",
+      "description": "Confidence score (0-1)"
+    },
+    "estimated_cost": {
+      "type": "number",
+      "description": "Estimated cost in USD"
+    },
+    "explanation": {
+      "type": "array",
+      "description": "Human-readable explanation"
+    }
+  },
+  "usage": {
+    "import": "import { Mozart } from 'mozart-router'",
+    "example": "const mozart = new Mozart();\nconst route = await mozart.recommend(task);"
+  }
+}

package/examples/openrouter/README.md

@@ -0,0 +1,21 @@
+# OpenRouter + Mozart
+
+This directory contains an example OpenRouter configuration reference.
+
+## Files
+
+- `config.json` — Example OpenRouter config
+
+## Integration
+
+Mozart detects OpenRouter via the `OPENROUTER_API_KEY` environment variable. When configured, Mozart adds OpenRouter to its inventory and can route tasks to models available through OpenRouter.
+
+1. Set your API key (already managed by your existing setup)
+2. Mozart detects it and builds an inventory
+3. Route tasks via Mozart's recommendation engine
+
+## Status
+
+OpenRouter integration is **real** — environment variable detection and curated model inventory work. Real-time model list from the API is not yet implemented to avoid unnecessary network calls.
+
+This integration is community-maintained. OpenRouter is its own service (https://openrouter.ai).

package/examples/openrouter/config.json

@@ -0,0 +1,14 @@
+{
+  "providers": {
+    "openrouter": {
+      "base_url": "https://openrouter.ai/api/v1",
+      "auth": "Bearer ${OPENROUTER_API_KEY}"
+    }
+  },
+  "preferences": {
+    "default_model": "auto",
+    "fallback_enabled": true,
+    "max_cost_per_call": 0.5
+  },
+  "mozart_note": "Mozart detects OpenRouter via OPENROUTER_API_KEY env var. No additional configuration needed."
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "mozart-router",
+  "version": "0.1.0",
+  "description": "Local orchestration and routing layer for AI agents — gateway-first, agent-first, integration-first.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mozart-router": "./dist/cli/main.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "mozart": "node dist/cli/main.js",
+    "dev": "tsx src/cli/main.ts"
+  },
+  "keywords": [
+    "ai",
+    "orchestration",
+    "routing",
+    "gateway",
+    "agent",
+    "llm",
+    "local"
+  ],
+  "license": "MIT",
+  "author": "Ucav",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ucav/mozart-router.git"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "dependencies": {
+    "yaml": "^2.3.4"
+  },
+  "optionalDependencies": {
+    "tsx": "^4.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "README.md"
+  ]
+}