@rotifer/mcp-server 0.8.2 → 0.8.6

package/README.md

@@ -1,6 +1,20 @@
+<div align="center">
+
 # @rotifer/mcp-server
 
-MCP (Model Context Protocol) server for the [Rotifer Protocol](https://rotifer.dev) Gene ecosystem. Lets AI agents search, inspect, compare, and rank Genes directly from any MCP-compatible IDE.
+[![npm](https://img.shields.io/npm/v/@rotifer/mcp-server)](https://www.npmjs.com/package/@rotifer/mcp-server)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-indigo)](https://modelcontextprotocol.io)
+
+**Build, compose, and run AI agents — directly from your IDE.**
+
+Search genes, create agents with composable genomes, run pipelines in a WASM sandbox, and compete in the Arena.
+Zero config. Works with Cursor, Claude Desktop, Windsurf, and any MCP-compatible client.
+
+</div>
+
+---
 
 ## Quick Start
 
@@ -13,7 +27,7 @@ Add to `.cursor/mcp.json`:
   "mcpServers": {
     "rotifer": {
       "command": "npx",
-      "args": ["-y", "@rotifer/mcp-server"]
+      "args": ["@rotifer/mcp-server"]
     }
   }
 }
@@ -28,7 +42,7 @@ Add to `claude_desktop_config.json`:
   "mcpServers": {
     "rotifer": {
       "command": "npx",
-      "args": ["-y", "@rotifer/mcp-server"]
+      "args": ["@rotifer/mcp-server"]
     }
   }
 }
@@ -38,20 +52,100 @@ Add to `claude_desktop_config.json`:
 
 Use the same `npx` command — any client that supports MCP stdio transport will work.
 
-## Tools
+## What Can It Do?
+
+### Create and run an agent in one conversation
+
+```
+You: "Build me an agent for code security scanning"
+AI:  → create_agent({ agent_name: "sec-bot", gene_ids: ["security-scanner", "genesis-code-format"],
+                       composition: "Seq" })
+     Agent 'sec-bot' created with 2-gene Seq genome.
+
+You: "Run it on my project"
+AI:  → agent_run({ agent_name: "sec-bot", input: "{\"path\":\"./src\"}" })
+     Pipeline complete — 3 findings, 0 critical.
+```
+
+### Search, compare, and compose genes
+
+```
+You: "Find the best gene for web search"
+AI:  → search_genes({ query: "web search" })
+     Found 8 genes. Top match: genesis-web-search (F(g) = 0.87, Native)
+
+You: "Compare it against the lite version"
+AI:  → compare_genes({ gene_ids: ["...", "..."] })
+     Side-by-side: success rate, latency, fitness breakdown
+```
+
+### Full gene lifecycle from your IDE
 
-| Tool | Description |
-|------|-------------|
-| `search_genes` | Search the Gene ecosystem by name, domain, or description |
-| `get_gene_detail` | Get detailed info about a specific Gene (phenotype, fitness, metadata) |
-| `get_arena_rankings` | Get Arena rankings for a domain, sorted by F(g) fitness score |
-| `compare_genes` | Side-by-side fitness comparison of 2–5 Genes |
-| `get_gene_stats` | Download statistics for a Gene (total, 7d, 30d, 90d) |
-| `get_leaderboard` | Developer reputation leaderboard |
-| `get_developer_profile` | Developer public profile and reputation data |
-| `list_local_genes` | Scan local workspace for installed Genes |
+```
+You: "Wrap my function as a gene"
+AI:  → wrap_gene({ gene_name: "my-search", domain: "search.web", fidelity: "Wrapped" })
+     → compile_gene({ gene_name: "my-search" })
+     → test_gene({ gene_name: "my-search", compliance: true })
+     → publish_gene({ gene_name: "my-search", changelog: "Initial release" })
+```
 
-## Resources
+## Tools (29)
+
+### Discovery & Analytics
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `search_genes` | Search the Gene ecosystem by name, domain, or description | `query`, `domain`, `fidelity`, `sort` (`relevance`/`newest`/`popular`/`fitness`), `page`, `per_page` |
+| `get_gene_detail` | Get detailed info about a Gene (phenotype, fitness, metadata) | `gene_id`, `content_hash` (either identifies the gene) |
+| `get_arena_rankings` | Arena rankings for a domain, sorted by F(g) fitness | `domain`, `page`, `per_page` |
+| `compare_genes` | Side-by-side fitness comparison of 2–5 Genes | `gene_ids` (array) |
+| `get_gene_stats` | Download statistics (total, 7d, 30d, 90d) | `gene_id` |
+| `get_leaderboard` | Creator reputation leaderboard | `limit` |
+| `get_developer_profile` | Creator public profile and reputation | `username` |
+| `get_gene_reputation` | Detailed reputation breakdown (Arena, Usage, Stability) | `gene_id` |
+| `list_gene_versions` | Version history chain with changelogs | `owner`, `gene_name` |
+| `suggest_domain` | Suggest matching domains from the registry | `description` |
+
+### Local Workspace
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `list_local_genes` | Scan local workspace for installed Genes | `project_root`, `domain`, `fidelity` |
+| `list_local_agents` | List Agents in the local workspace | `project_root`, `state` |
+
+### Gene Lifecycle
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `init_gene` | Initialize a new Gene project with starter files | `gene_name`, `fidelity`, `domain`, `no_genesis` |
+| `scan_genes` | Scan for candidate functions or SKILL.md files | `path`, `skills`, `skills_path` |
+| `wrap_gene` | Wrap a function/skill as a Gene | `gene_name`, `domain`, `fidelity`, `from_skill`, `from_clawhub` |
+| `test_gene` | Test a Gene (schema validation + sandbox) | `gene_name`, `verbose`, `compliance` |
+| `compile_gene` | Compile a Gene to WASM IR | `gene_name`, `check`, `wasm_path`, `lang` |
+| `run_gene` | Execute a local Gene | `gene_name`, `input`, `verbose`, `no_sandbox`, `trust_unsigned` |
+| `publish_gene` | Publish to Rotifer Cloud | `gene_name`, `all`, `description`, `changelog`, `skip_arena`, `skip_security` |
+| `install_gene` | Install a Gene from Cloud Registry | `gene_id`, `project_root`, `force` |
+| `vg_scan` | V(g) security scan — static analysis for Gene/Skill code safety | `path`, `gene_id`, `all`, `project_root` |
+| `arena_submit` | Submit to Arena with 5D fitness scores | `gene_id`, `fitness_value`, `safety_score`, `success_rate`, `latency_score`, `resource_efficiency` |
+
+### Agent Composition
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `create_agent` | Create an Agent composing multiple Genes | `agent_name`, `gene_ids`, `composition` (`Seq`/`Par`/`Cond`/`Try`/`TryPool`), `domain`, `top`, `strategy`, `par_merge` |
+| `agent_run` | Run a local Agent by name | `agent_name`, `input`, `verbose`, `no_sandbox` |
+
+### Authentication & Analytics
+
+| Tool | Description | Key Parameters |
+|------|-------------|----------------|
+| `auth_status` | Check login status | — |
+| `login` | OAuth login (GitHub/GitLab) | `provider`, `endpoint` |
+| `logout` | Clear credentials | — |
+| `get_mcp_stats` | MCP call analytics | `days` |
+| `get_my_reputation` | Current user's reputation | — |
+
+## Resources (7)
 
 MCP Resources let AI clients reference Rotifer data as context:
 
@@ -59,31 +153,61 @@ MCP Resources let AI clients reference Rotifer data as context:
 |---|---|
 | `rotifer://genes/{gene_id}/stats` | Gene download statistics |
 | `rotifer://genes/{gene_id}` | Gene detail + phenotype |
-| `rotifer://developers/{username}` | Developer profile + reputation |
-| `rotifer://leaderboard` | Top developers by reputation score |
+| `rotifer://developers/{username}` | Creator profile + reputation |
+| `rotifer://leaderboard` | Top creators by reputation score |
 | `rotifer://local/genes` | Local Gene inventory |
+| `rotifer://local/agents` | Local Agent registry |
+| `rotifer://version` | MCP Server version and update availability |
 
-### Examples
-
-**Search for web search genes:**
-
-> "Search for genes in the search.web domain"
-
-**Find the best gene for a task:**
-
-> "Show me Arena rankings for code.format"
+## Prompts (4)
 
-**Compare two genes:**
+MCP Prompts give AI clients guided workflows for common tasks:
 
-> "Compare these two genes: [id-1] vs [id-2]"
+| Prompt | Description | Key Arguments |
+|--------|-------------|---------------|
+| `rotifer-hello` | Interactive agent creation — pick a template and run immediately | `template`, `input` |
+| `rotifer-guide` | Understand Rotifer Protocol — genes, agents, Arena, fidelity model | — |
+| `rotifer-architect` | Design an Agent — task-driven gene search + composition planning | `task` |
+| `rotifer-challenge` | Arena evaluation — submit a gene, compare with competitors | `gene` |
 
-**Check download trends:**
+Try asking your AI: *"Use the rotifer-hello prompt to build me an agent"* or *"Use rotifer-architect to design an agent for document Q&A"*.
 
-> "Show me download stats for this gene"
+---
 
-**Explore local workspace:**
+## Architecture
 
-> "What genes are installed locally?"
+```
+┌─────────────────────────────────────────────────┐
+│  AI IDE (Cursor / Claude / Windsurf)            │
+│                                                 │
+│  "Find genes for code formatting"               │
+│       │                                         │
+│       ▼                                         │
+│  ┌─────────────────────┐                        │
+│  │  MCP Client         │                        │
+│  │  (stdio transport)  │                        │
+│  └────────┬────────────┘                        │
+└───────────┼─────────────────────────────────────┘
+            │ MCP Protocol
+            ▼
+┌─────────────────────────────────────────────────┐
+│  @rotifer/mcp-server                            │
+│                                                 │
+│  29 Tools  7 Resources  4 Prompts  Local Scanner│
+│  ┌──────────┐  ┌───────────┐   ┌────────────┐  │
+│  │ discover │  │rotifer:// │   │ ./genes/    │  │
+│  │ lifecycle│  │genes/stats│   │ phenotype   │  │
+│  │ agents   │  │developers │   │ agents      │  │
+│  │ auth     │  │leaderboard│   └────────────┘  │
+│  └────┬─────┘  └─────┬─────┘         │         │
+└───────┼──────────────┼────────────────┼─────────┘
+        │              │                │
+        ▼              ▼                ▼
+┌─────────────────────────────────────────────────┐
+│  Rotifer Cloud API          Local File System   │
+│  (Supabase)                 (genes/, .rotifer/) │
+└─────────────────────────────────────────────────┘
+```
 
 ## Configuration
 
@@ -109,12 +233,23 @@ ROTIFER_CLOUD_ANON_KEY=your-anon-key
 
 - Node.js >= 20
 
+## Pair with the CLI
+
+This MCP server works best alongside the [Rotifer CLI](https://github.com/rotifer-protocol/rotifer-playground). The CLI provides the local runtime (WASM sandbox, Arena engine, IR compiler) while the MCP server exposes it all to your AI assistant:
+
+```bash
+npm install -g @rotifer/playground
+rotifer init my-project && cd my-project
+rotifer hello   # your first agent in 30 seconds
+```
+
 ## Links
 
-- [Rotifer Protocol](https://rotifer.dev)
-- [MCP Setup Guide](https://rotifer.dev/docs/guides/mcp-setup)
-- [Gene Marketplace](https://rotifer.ai)
-- [Protocol Specification](https://github.com/rotifer-protocol/rotifer-spec)
+- [Rotifer Protocol](https://rotifer.dev) — Main site
+- [MCP Setup Guide](https://rotifer.dev/docs/guides/mcp-setup) — Step-by-step setup
+- [Gene Marketplace](https://rotifer.ai) — Browse and discover Genes
+- [CLI Playground](https://github.com/rotifer-protocol/rotifer-playground) — Build and test Genes locally
+- [Protocol Specification](https://github.com/rotifer-protocol/rotifer-spec) — Formal spec
 
 ## License
 

package/dist/auth.d.ts

@@ -18,7 +18,11 @@ export declare function clearCredentials(): void;
 export declare function generateCodeVerifier(): string;
 export declare function generateCodeChallenge(verifier: string): string;
 /**
- * Start a local HTTP server to receive the OAuth callback.
- * Handles both PKCE flow (?code=...) and implicit flow (#access_token=...).
+ * Start a local OAuth callback server on a random port (127.0.0.1:0).
+ * Returns the bound port immediately so the caller can construct the auth URL,
+ * plus a promise that resolves when the callback arrives.
  */
-export declare function waitForOAuthCallback(port?: number): Promise<string>;
+export declare function startOAuthCallbackServer(): Promise<{
+    port: number;
+    waitForCallback: Promise<string>;
+}>;

package/dist/auth.js

@@ -1,4 +1,4 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 import { createServer } from "node:http";
 import { randomBytes, createHash } from "node:crypto";
@@ -34,7 +34,6 @@ export function saveCredentials(creds) {
 export function clearCredentials() {
     const path = credentialsPath();
     if (existsSync(path)) {
-        const { unlinkSync } = require("node:fs");
         unlinkSync(path);
     }
 }
@@ -45,13 +44,21 @@ export function generateCodeChallenge(verifier) {
     return createHash("sha256").update(verifier).digest("base64url");
 }
 /**
- * Start a local HTTP server to receive the OAuth callback.
- * Handles both PKCE flow (?code=...) and implicit flow (#access_token=...).
+ * Start a local OAuth callback server on a random port (127.0.0.1:0).
+ * Returns the bound port immediately so the caller can construct the auth URL,
+ * plus a promise that resolves when the callback arrives.
  */
-export function waitForOAuthCallback(port = 9876) {
+export async function startOAuthCallbackServer() {
     return new Promise((resolve, reject) => {
+        let callbackResolve;
+        let callbackReject;
+        const waitForCallback = new Promise((res, rej) => {
+            callbackResolve = res;
+            callbackReject = rej;
+        });
         const server = createServer((req, res) => {
-            const url = new URL(req.url || "/", `http://localhost:${port}`);
+            const boundPort = server.address()?.port || 0;
+            const url = new URL(req.url || "/", `http://localhost:${boundPort}`);
             if (url.pathname === "/callback/token") {
                 const token = url.searchParams.get("access_token");
                 const refresh = url.searchParams.get("refresh_token");
@@ -61,7 +68,7 @@ export function waitForOAuthCallback(port = 9876) {
                         "<p>You can close this window and return to the terminal.</p>" +
                         "</body></html>");
                     server.close();
-                    resolve(`implicit:${token}:${refresh || ""}`);
+                    callbackResolve(`implicit:${token}:${refresh || ""}`);
                     return;
                 }
             }
@@ -72,7 +79,7 @@ export function waitForOAuthCallback(port = 9876) {
                     "<p>You can close this window and return to the terminal.</p>" +
                     "</body></html>");
                 server.close();
-                resolve(code);
+                callbackResolve(code);
             }
             else {
                 res.writeHead(200, { "Content-Type": "text/html" });
@@ -92,15 +99,16 @@ if (window.location.hash) {
 </script><noscript>Enable JavaScript to complete login.</noscript></body></html>`);
             }
         });
-        server.listen(port, () => {
-            // Server ready
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            resolve({ port: addr.port, waitForCallback });
         });
         server.on("error", (err) => {
             reject(new Error(`Failed to start callback server: ${err.message}`));
         });
         setTimeout(() => {
             server.close();
-            reject(new Error("Login timed out after 120 seconds"));
+            callbackReject(new Error("Login timed out after 120 seconds"));
         }, 120_000);
     });
 }

package/dist/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,YAAY,GAAG,IAAI,CACvB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EACrD,UAAU,CACX,CAAC;AAmBF,SAAS,iBAAiB;IACxB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAqB,CAAC;QACzE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAuB;IACrD,iBAAiB,EAAE,CAAC;IACpB,aAAa,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;QACtE,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAA6B,CAAC;QACtE,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,IAAI;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;YAEhE,IAAI,GAAG,CAAC,QAAQ,KAAK,iBAAiB,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACnD,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACtD,IAAI,KAAK,EAAE,CAAC;oBACV,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;oBACpD,GAAG,CAAC,GAAG,CACL,wCAAwC;wBACtC,8DAA8D;wBAC9D,gBAAgB,CACnB,CAAC;oBACF,MAAM,CAAC,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,YAAY,KAAK,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC9C,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,IAAI,EAAE,CAAC;gBACT,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,GAAG,CACL,wCAAwC;oBACtC,8DAA8D;oBAC9D,gBAAgB,CACnB,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,GAAG,CAAC;;;;;;;;;;;;;iFAaiE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,eAAe;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;QACzD,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/cloud.d.ts

@@ -11,13 +11,13 @@ export interface Gene {
     version: string;
     fidelity: string;
     description: string;
-    wasm_size: number;
+    wasmSize: number;
     downloads: number;
-    reputation_score: number | null;
-    previous_version_id: string | null;
+    reputationScore: number | null;
+    previousVersionId: string | null;
     changelog: string | null;
-    created_at: string;
-    updated_at: string;
+    createdAt: string;
+    updatedAt: string;
     phenotype?: Record<string, unknown>;
 }
 export interface GeneListResult {
@@ -25,6 +25,7 @@ export interface GeneListResult {
     total: number;
     page: number;
     per_page: number;
+    has_more: boolean;
 }
 export declare function listGenes(options: {
     domain?: string;
@@ -34,28 +35,34 @@ export declare function listGenes(options: {
     page?: number;
     perPage?: number;
 }): Promise<GeneListResult>;
-export declare function getGene(id: string): Promise<Gene & {
+export declare function getGene(idOrName: string): Promise<Gene & {
+    phenotype: Record<string, unknown>;
+}>;
+export declare function getGeneByContentHash(hash: string): Promise<Gene & {
     phenotype: Record<string, unknown>;
 }>;
 export interface ArenaEntry {
     rank: number;
-    gene_id: string;
-    gene_name: string;
+    geneId: string;
+    geneName: string;
     owner: string;
     domain: string;
     fidelity: string;
     fitness: number;
     safety: number;
-    success_rate: number;
-    latency_score: number;
-    resource_efficiency: number;
-    reputation_score: number | null;
-    total_calls: number;
-    last_evaluated: string;
+    successRate: number;
+    latencyScore: number;
+    resourceEfficiency: number;
+    reputationScore: number | null;
+    totalCalls: number;
+    lastEvaluated: string;
 }
 export interface ArenaRankingsResult {
     rankings: ArenaEntry[];
     total: number;
+    page: number;
+    per_page: number;
+    has_more: boolean;
     domain: string | null;
 }
 export declare function getArenaRankings(options: {
@@ -65,31 +72,31 @@ export declare function getArenaRankings(options: {
 }): Promise<ArenaRankingsResult>;
 export interface GeneStats {
     total: number;
-    last_7d: number;
-    last_30d: number;
-    last_90d: number;
+    last7d: number;
+    last30d: number;
+    last90d: number;
 }
 export declare function getGeneStatsRpc(geneId: string): Promise<GeneStats>;
 export interface LeaderboardEntry {
-    user_id: string;
+    userId: string;
     username: string;
-    avatar_url: string | null;
+    avatarUrl: string | null;
     score: number;
-    genes_published: number;
-    total_downloads: number;
-    arena_wins: number;
+    genesPublished: number;
+    totalDownloads: number;
+    arenaWins: number;
 }
 export declare function getReputationLeaderboard(limit?: number): Promise<LeaderboardEntry[]>;
 export interface DeveloperProfile {
-    user_id: string;
+    userId: string;
     username: string;
-    avatar_url: string | null;
-    created_at: string;
+    avatarUrl: string | null;
+    createdAt: string;
     reputation: {
         score: number;
-        genes_published: number;
-        total_downloads: number;
-        arena_wins: number;
+        genesPublished: number;
+        totalDownloads: number;
+        arenaWins: number;
     } | null;
 }
 export declare function getDeveloperProfile(username: string): Promise<DeveloperProfile>;
@@ -97,18 +104,18 @@ export interface GeneVersionEntry {
     id: string;
     version: string;
     changelog: string | null;
-    previous_version_id: string | null;
-    created_at: string;
+    previousVersionId: string | null;
+    createdAt: string;
 }
 export declare function listGeneVersions(ownerName: string, geneName: string): Promise<GeneVersionEntry[]>;
 export interface ArenaSubmitResult {
-    gene_id: string;
+    geneId: string;
     domain: string;
-    fitness_value: number;
-    safety_score: number;
-    success_rate: number;
-    latency_score: number;
-    resource_efficiency: number;
+    fitnessValue: number;
+    safetyScore: number;
+    successRate: number;
+    latencyScore: number;
+    resourceEfficiency: number;
 }
 export declare function arenaSubmitCloud(geneId: string, fitness: {
     value: number;
@@ -118,29 +125,29 @@ export declare function arenaSubmitCloud(geneId: string, fitness: {
     resource_efficiency: number;
 }): Promise<ArenaSubmitResult>;
 export interface GeneReputationResult {
-    gene_id: string;
-    gene_name: string;
+    geneId: string;
+    geneName: string;
     score: number;
-    arena_score: number;
-    usage_score: number;
-    stability_score: number;
+    arenaScore: number;
+    usageScore: number;
+    stabilityScore: number;
     epoch: number;
-    computed_at: string;
+    computedAt: string;
 }
 export declare function getGeneReputation(geneId: string): Promise<GeneReputationResult>;
 export interface MyReputationResult {
     username: string;
     score: number;
-    genes_published: number;
-    total_downloads: number;
-    arena_wins: number;
-    community_bonus: number;
+    genesPublished: number;
+    totalDownloads: number;
+    arenaWins: number;
+    communityBonus: number;
 }
 export declare function getMyReputation(): Promise<MyReputationResult>;
 export interface DomainSuggestion {
     domain: string;
     description: string | null;
-    gene_count: number;
+    geneCount: number;
 }
 export declare function suggestDomain(description: string): Promise<DomainSuggestion[]>;
 export declare function logMcpCall(entry: {
@@ -152,25 +159,25 @@ export declare function logMcpCall(entry: {
 }): void;
 export interface McpStatsResult {
     period: string;
-    total_calls: number;
-    success_rate: number;
-    avg_latency_ms: number;
-    top_tools: Array<{
-        tool_name: string;
+    totalCalls: number;
+    successRate: number;
+    avgLatencyMs: number;
+    topTools: Array<{
+        toolName: string;
         count: number;
     }>;
-    top_genes: Array<{
-        gene_id: string;
+    topGenes: Array<{
+        geneId: string;
         count: number;
     }>;
 }
 export declare function getMcpStats(days?: number): Promise<McpStatsResult>;
 export interface InstallResult {
-    gene_id: string;
+    geneId: string;
     name: string;
     domain: string;
     fidelity: string;
-    installed_to: string;
+    installedTo: string;
 }
-export declare function installGene(geneId: string, projectRoot: string): Promise<InstallResult>;
+export declare function installGene(geneId: string, projectRoot: string, shouldForce?: boolean): Promise<InstallResult>;
 export {};