@noelclaw/mcp 1.0.0 → 1.2.0

package/README.md

@@ -5,7 +5,7 @@
 Noelclaw as an MCP skill — persistent memory, multi-agent coordination, scenario simulation, DeFi execution, and Sentinel-gated playbooks. Works with Claude, Cursor, Hermes, Windsurf, and any MCP-compatible client.
 
 ```bash
-npx @noelclaw/mcp@latest
+npx @noelclaw/mcp
 ```
 
 ---
@@ -14,12 +14,12 @@ npx @noelclaw/mcp@latest
 
 ### Claude Code
 ```bash
-claude mcp add noelclaw -- npx @noelclaw/mcp@latest
+claude mcp add noelclaw -- npx @noelclaw/mcp
 ```
 
 Set your API key:
 ```bash
-claude mcp add noelclaw -e NOELCLAW_API_KEY=noel_... -- npx @noelclaw/mcp@latest
+claude mcp add noelclaw -e NOELCLAW_API_KEY=noel_... -- npx @noelclaw/mcp
 ```
 
 ### Claude Desktop
@@ -30,7 +30,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or
   "mcpServers": {
     "noelclaw": {
       "command": "npx",
-      "args": ["@noelclaw/mcp@latest"],
+      "args": ["@noelclaw/mcp"],
       "env": {
         "NOELCLAW_API_KEY": "noel_..."
       }
@@ -45,7 +45,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or
   "mcpServers": {
     "noelclaw": {
       "command": "npx",
-      "args": ["@noelclaw/mcp@latest"],
+      "args": ["@noelclaw/mcp"],
       "env": {
         "NOELCLAW_API_KEY": "noel_..."
       }
@@ -60,7 +60,7 @@ mcp_servers:
   noelclaw:
     command: npx
     args:
-      - "@noelclaw/mcp@latest"
+      - "@noelclaw/mcp"
     env:
       NOELCLAW_API_KEY: "noel_..."
 ```
@@ -175,13 +175,6 @@ Set `NOELCLAW_API_KEY` in your MCP config. That's it.
 |-----|-------------|
 | `NOELCLAW_API_KEY` | Your API key (`noel_...`) — get one at `POST https://api.noelclaw.com/auth/key` |
 
-### MiroShark (optional)
-
-| Var | Description |
-|-----|-------------|
-| `MIROSHARK_URL` | URL of your deployed MiroShark instance |
-| `MIROSHARK_ADMIN_TOKEN` | Admin token set on your MiroShark deployment |
-
 ### BYOK (optional)
 
 | Var | Used for |
@@ -234,7 +227,6 @@ get_noel_ledger
 |-------|-----|
 | Tools not appearing | Restart your MCP client after adding the config |
 | `401 Unauthorized` | Check `NOELCLAW_API_KEY` is set — get one at `POST https://api.noelclaw.com/auth/key` |
-| `miroshark_simulate` error | Set `MIROSHARK_URL` and `MIROSHARK_ADMIN_TOKEN` |
 | Server starts but no response | Expected — server waits for MCP stdin, not HTTP |
 
 ---
@@ -242,5 +234,5 @@ get_noel_ledger
 ## Links
 
 - npm: [npmjs.com/package/@noelclaw/mcp](https://npmjs.com/package/@noelclaw/mcp)
-- GitHub: [github.com/noelclaw/research](https://github.com/noelclaw/mcp)
+- GitHub: [github.com/noelclaw/mcp](https://github.com/noelclaw/mcp)
 - Platform: [noelclaw.com](https://noelclaw.com)

package/dist/tools/miroshark.js

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIROSHARK_TOOLS = void 0;
 exports.handleMirosharkTool = handleMirosharkTool;
+const CONVEX_SITE = process.env.NOELCLAW_CONVEX_URL ?? "https://api.noelclaw.com";
 exports.MIROSHARK_TOOLS = [
     {
         name: "miroshark_simulate",
-        description: "Run a MiroShark multi-agent simulation. Describe a scenario in plain English and get back strategic insights from a network of AI agents (market actors, risk managers, analysts). " +
-            "Returns a simulation ID you can poll with miroshark_status.",
+        description: "Run a MiroShark multi-agent simulation. Describe any scenario in plain English — market crashes, policy changes, social events — and get back a running simulation with AI agents acting as market participants, analysts, and social actors. " +
+            "Handles the full setup automatically (knowledge graph, agent profiles). Returns a simulation_id to poll with miroshark_status.",
         inputSchema: {
             type: "object",
             properties: {
@@ -14,21 +15,13 @@ exports.MIROSHARK_TOOLS = [
                     type: "string",
                     description: "Plain-English description of the scenario to simulate. E.g. 'What happens if ETH drops 20% and whale wallets start selling?'",
                 },
-                agents: {
-                    type: "number",
-                    description: "Number of agents in the simulation (default: 10, max: 50)",
-                },
-                steps: {
-                    type: "number",
-                    description: "Number of simulation steps to run (default: 5)",
-                },
             },
             required: ["scenario"],
         },
     },
     {
         name: "miroshark_status",
-        description: "Poll the status and results of a MiroShark simulation by ID. Returns agent outputs, consensus findings, and final strategic insights when complete.",
+        description: "Poll the status of a MiroShark simulation. Returns preparation progress, running progress, or final results. Automatically starts the simulation when agent preparation completes.",
         inputSchema: {
             type: "object",
             properties: {
@@ -41,71 +34,121 @@ exports.MIROSHARK_TOOLS = [
         },
     },
 ];
-function getConfig() {
-    const url = process.env.MIROSHARK_URL?.replace(/\/$/, "");
-    const token = process.env.MIROSHARK_ADMIN_TOKEN;
-    return { url, token };
+// ── HTTP helpers ──────────────────────────────────────────────────────────────
+function authHeaders() {
+    const key = process.env.NOELCLAW_API_KEY ?? process.env.NOELCLAW_SESSION_TOKEN;
+    return key ? { Authorization: `Bearer ${key}` } : {};
 }
-async function mirofetch(path, method, body) {
-    const { url, token } = getConfig();
-    if (!url)
-        throw new Error("MIROSHARK_URL not set");
-    if (!token)
-        throw new Error("MIROSHARK_ADMIN_TOKEN not set");
-    const res = await fetch(`${url}${path}`, {
+async function miroJson(path, method, body, timeoutMs = 90000) {
+    const res = await fetch(`${CONVEX_SITE}${path}`, {
         method,
-        headers: {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${token}`,
-        },
-        ...(body ? { body: JSON.stringify(body) } : {}),
-        signal: AbortSignal.timeout(30000),
+        headers: { ...authHeaders(), "Content-Type": "application/json" },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+    const text = await res.text();
+    if (!res.ok)
+        throw new Error(`MiroShark ${method} ${path} [${res.status}]: ${text.slice(0, 300)}`);
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`MiroShark non-JSON response: ${text.slice(0, 200)}`);
+    }
+    if (json.success === false)
+        throw new Error(`MiroShark error: ${json.error ?? JSON.stringify(json).slice(0, 300)}`);
+    return json.data ?? json;
+}
+async function miroForm(path, form, timeoutMs = 120000) {
+    // No Content-Type header — browser/fetch sets multipart boundary automatically
+    const res = await fetch(`${CONVEX_SITE}${path}`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: form,
+        signal: AbortSignal.timeout(timeoutMs),
     });
-    if (!res.ok) {
-        const err = await res.text();
-        throw new Error(`MiroShark ${res.status}: ${err.slice(0, 200)}`);
+    const text = await res.text();
+    if (!res.ok)
+        throw new Error(`MiroShark POST ${path} [${res.status}]: ${text.slice(0, 300)}`);
+    let json;
+    try {
+        json = JSON.parse(text);
     }
-    return res.json();
+    catch {
+        throw new Error(`MiroShark non-JSON response: ${text.slice(0, 200)}`);
+    }
+    if (json.success === false)
+        throw new Error(`MiroShark error: ${json.error ?? JSON.stringify(json).slice(0, 300)}`);
+    return json.data ?? json;
+}
+async function pollUntilDone(taskPath, pollIntervalMs = 8000, maxWaitMs = 180000) {
+    const deadline = Date.now() + maxWaitMs;
+    while (Date.now() < deadline) {
+        await new Promise(r => setTimeout(r, pollIntervalMs));
+        const task = await miroJson(taskPath, "GET");
+        const s = (task.status ?? "").toLowerCase();
+        if (s === "completed" || s === "success")
+            return task;
+        if (s === "failed" || s === "error") {
+            throw new Error(`Task failed: ${task.error ?? task.message ?? s}`);
+        }
+    }
+    throw new Error("Task timed out after 3 minutes");
 }
+// ── Tool handler ──────────────────────────────────────────────────────────────
 async function handleMirosharkTool(name, args) {
     const a = (args ?? {});
+    // ── miroshark_simulate ────────────────────────────────────────────────────
     if (name === "miroshark_simulate") {
         if (!a.scenario?.trim()) {
             return { content: [{ type: "text", text: "scenario is required" }], isError: true };
         }
-        const { url, token } = getConfig();
-        if (!url || !token) {
-            return {
-                content: [{ type: "text", text: "MiroShark not configured — set MIROSHARK_URL and MIROSHARK_ADMIN_TOKEN" }],
-                isError: true,
-            };
-        }
         try {
-            // Step 1: ask (parse scenario into simulation params)
-            const asked = await mirofetch("/api/simulation/ask", "POST", { question: a.scenario });
-            // Step 2: create simulation
-            const created = await mirofetch("/api/simulation/create", "POST", {
-                ...asked,
-                num_agents: Math.min(a.agents ?? 10, 50),
-                num_steps: a.steps ?? 5,
-            });
+            // Step 1: convert plain-English question into a structured seed document
+            const asked = await miroJson("/miroshark/api/simulation/ask", "POST", { question: a.scenario });
+            const { title, seed_document, simulation_requirement } = asked;
+            // Step 2: generate knowledge-graph ontology from the seed document
+            const form = new FormData();
+            form.append("simulation_requirement", simulation_requirement ?? a.scenario);
+            form.append("project_name", (title ?? a.scenario).slice(0, 100));
+            form.append("url_docs", JSON.stringify([{
+                    title: title ?? "Simulation Context",
+                    url: "",
+                    text: seed_document ?? a.scenario,
+                }]));
+            const ontology = await miroForm("/miroshark/api/graph/ontology/generate", form);
+            const projectId = ontology.project_id;
+            if (!projectId)
+                throw new Error("No project_id in ontology response");
+            // Step 3: kick off the async graph build
+            const built = await miroJson("/miroshark/api/graph/build", "POST", { project_id: projectId });
+            const graphTaskId = built.task_id;
+            if (!graphTaskId)
+                throw new Error("No task_id in graph build response");
+            // Step 4: wait for graph to finish (up to 3 min)
+            await pollUntilDone(`/miroshark/api/graph/task/${graphTaskId}`);
+            // Step 5: create simulation from the built graph
+            const created = await miroJson("/miroshark/api/simulation/create", "POST", { project_id: projectId });
             const simId = created.simulation_id ?? created.id;
             if (!simId)
-                throw new Error("No simulation ID in create response");
-            // Step 3: prepare
-            await mirofetch(`/api/simulation/${simId}/prepare`, "POST", {});
-            // Step 4: start
-            await mirofetch(`/api/simulation/${simId}/start`, "POST", {});
+                throw new Error("No simulation_id in create response");
+            // Step 6: kick off agent preparation (async — don't block)
+            const prepared = await miroJson("/miroshark/api/simulation/prepare", "POST", { simulation_id: simId });
+            const prepTaskId = prepared.task_id;
             return {
                 content: [{
                         type: "text",
                         text: [
-                            `🦈 **MiroShark simulation started**`,
+                            `**MiroShark simulation queued** ✓`,
+                            ``,
                             `Scenario: ${a.scenario}`,
+                            `Project: \`${projectId}\``,
                             `Simulation ID: \`${simId}\``,
-                            `Agents: ${a.agents ?? 10} · Steps: ${a.steps ?? 5}`,
+                            `Status: preparing agents${prepTaskId ? ` (task: ${prepTaskId})` : ""}`,
                             ``,
-                            `Poll results with: \`miroshark_status simulation_id="${simId}"\``,
+                            `Agent preparation runs in the background. Poll progress with:`,
+                            `\`miroshark_status simulation_id="${simId}"\``,
                         ].join("\n"),
                     }],
             };
@@ -114,38 +157,106 @@ async function handleMirosharkTool(name, args) {
             return { content: [{ type: "text", text: `MiroShark error: ${err.message}` }], isError: true };
         }
     }
+    // ── miroshark_status ──────────────────────────────────────────────────────
     if (name === "miroshark_status") {
         if (!a.simulation_id?.trim()) {
             return { content: [{ type: "text", text: "simulation_id is required" }], isError: true };
         }
+        const simId = a.simulation_id.trim();
         try {
-            const data = await mirofetch(`/api/simulation/${a.simulation_id}/status`, "GET");
-            const status = data.status ?? "unknown";
-            const lines = [
-                `🦈 **MiroShark Simulation \`${a.simulation_id}\`**`,
-                `Status: **${status}**`,
-            ];
-            if (data.progress != null)
-                lines.push(`Progress: ${data.progress}%`);
-            if (status === "completed" && data.results) {
-                lines.push("", "**Results**");
-                if (data.results.summary)
-                    lines.push(data.results.summary);
-                if (Array.isArray(data.results.insights)) {
-                    for (const insight of data.results.insights.slice(0, 5)) {
-                        lines.push(`• ${typeof insight === "string" ? insight : JSON.stringify(insight)}`);
-                    }
-                }
-                if (data.results.consensus)
-                    lines.push("", `**Consensus:** ${data.results.consensus}`);
+            // Check if agents are still being prepared
+            const prepStatus = await miroJson("/miroshark/api/simulation/prepare/status", "POST", { simulation_id: simId }).catch(() => null);
+            const prepState = (prepStatus?.status ?? "").toLowerCase();
+            if (prepState === "processing" || prepState === "pending") {
+                const pct = prepStatus?.progress ?? 0;
+                const msg = prepStatus?.message ?? "preparing agents...";
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `**MiroShark \`${simId}\`** — preparing agents`,
+                                `Progress: ${pct}%`,
+                                `${msg}`,
+                                ``,
+                                `Poll again in a few seconds.`,
+                            ].join("\n"),
+                        }],
+                };
             }
-            else if (status === "failed") {
-                lines.push("", `Error: ${data.error ?? "unknown"}`);
+            // Agents ready (or prepare already done) — check run status
+            const runStatus = await miroJson(`/miroshark/api/simulation/${simId}/run-status`, "GET").catch(() => ({ runner_status: "idle" }));
+            const runnerStatus = (runStatus?.runner_status ?? "idle").toLowerCase();
+            // Auto-start the simulation when agents are ready but not yet running
+            if (runnerStatus === "idle" && (prepState === "ready" || prepState === "completed" || prepStatus?.already_prepared)) {
+                await miroJson("/miroshark/api/simulation/start", "POST", {
+                    simulation_id: simId,
+                    platform: "parallel",
+                });
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `**MiroShark \`${simId}\`** — simulation started`,
+                                ``,
+                                `Agents are now active. Poll again in ~15 seconds for progress.`,
+                                `\`miroshark_status simulation_id="${simId}"\``,
+                            ].join("\n"),
+                        }],
+                };
             }
-            else {
-                lines.push("", "Simulation still running — poll again in a few seconds.");
+            if (runnerStatus === "running") {
+                const round = runStatus.current_round ?? 0;
+                const total = runStatus.total_rounds ?? "?";
+                const pct = runStatus.progress_percent?.toFixed(1) ?? "0";
+                const twitterActs = runStatus.twitter_actions_count ?? 0;
+                const redditActs = runStatus.reddit_actions_count ?? 0;
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `**MiroShark \`${simId}\`** — running`,
+                                `Round: ${round} / ${total} (${pct}%)`,
+                                `Actions: ${twitterActs} Twitter · ${redditActs} Reddit`,
+                                ``,
+                                `Simulation in progress — poll again in ~15 seconds.`,
+                            ].join("\n"),
+                        }],
+                };
             }
-            return { content: [{ type: "text", text: lines.join("\n") }] };
+            if (runnerStatus === "completed" || runnerStatus === "stopped") {
+                // Fetch a sample of agent actions for the summary
+                const actionsData = await miroJson(`/miroshark/api/simulation/${simId}/actions?limit=10`, "GET").catch(() => ({ actions: [] }));
+                const actions = actionsData?.actions ?? [];
+                const lines = [
+                    `**MiroShark \`${simId}\`** — ${runnerStatus}`,
+                    ``,
+                    `Rounds completed: ${runStatus.current_round ?? "?"}`,
+                    `Total actions: ${runStatus.total_actions_count ?? actions.length}`,
+                ];
+                if (actions.length > 0) {
+                    lines.push("", "**Sample agent activity:**");
+                    for (const act of actions.slice(0, 8)) {
+                        const who = act.agent_name ?? act.agent_id ?? "agent";
+                        const what = act.action_type ?? act.type ?? "action";
+                        const content = act.content ?? act.text ?? "";
+                        lines.push(`• **${who}** [${what}]${content ? `: ${String(content).slice(0, 80)}` : ""}`);
+                    }
+                }
+                lines.push("", `Full transcript: \`miroshark_status\` returns results above.`);
+                return { content: [{ type: "text", text: lines.join("\n") }] };
+            }
+            // Fallback: unknown state
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `**MiroShark \`${simId}\`** — status: ${runnerStatus || "unknown"}`,
+                            prepState ? `Prepare state: ${prepState}` : "",
+                            ``,
+                            `If agents are still preparing, poll again shortly.`,
+                        ].filter(Boolean).join("\n"),
+                    }],
+            };
         }
         catch (err) {
             return { content: [{ type: "text", text: `MiroShark error: ${err.message}` }], isError: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noelclaw/mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Noelclaw as an MCP skill — persistent memory, multi-agent coordination, scenario simulation, DeFi execution, and Sentinel-gated playbooks.",
   "main": "dist/index.js",
   "bin": {
@@ -27,11 +27,11 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/noelclaw/noelmcp.git"
+    "url": "git+https://github.com/noelclaw/mcp.git"
   },
-  "homepage": "https://github.com/noelclaw/noelmcp#readme",
+  "homepage": "https://github.com/noelclaw/mcp#readme",
   "bugs": {
-    "url": "https://github.com/noelclaw/noelmcp/issues"
+    "url": "https://github.com/noelclaw/mcp/issues"
   },
   "license": "MIT",
   "files": [