@noelclaw/mcp 1.1.0 → 1.2.1

package/dist/tools/miroshark.js

@@ -2,12 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MIROSHARK_TOOLS = void 0;
 exports.handleMirosharkTool = handleMirosharkTool;
-const convex_js_1 = require("../convex.js");
+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: {
@@ -15,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: {
@@ -42,37 +34,121 @@ exports.MIROSHARK_TOOLS = [
         },
     },
 ];
+// ── HTTP helpers ──────────────────────────────────────────────────────────────
+function authHeaders() {
+    const key = process.env.NOELCLAW_API_KEY ?? process.env.NOELCLAW_SESSION_TOKEN;
+    return key ? { Authorization: `Bearer ${key}` } : {};
+}
+async function miroJson(path, method, body, timeoutMs = 90000) {
+    const res = await fetch(`${CONVEX_SITE}${path}`, {
+        method,
+        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),
+    });
+    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);
+    }
+    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 };
         }
         try {
-            // Step 1: parse scenario into simulation params
-            const asked = await (0, convex_js_1.callConvex)("/miroshark/api/simulation/ask", "POST", { question: a.scenario });
-            // Step 2: create simulation
-            const created = await (0, convex_js_1.callConvex)("/miroshark/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 + start
-            await (0, convex_js_1.callConvex)(`/miroshark/api/simulation/${simId}/prepare`, "POST", {});
-            await (0, convex_js_1.callConvex)(`/miroshark/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"),
                     }],
             };
@@ -81,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 (0, convex_js_1.callConvex)(`/miroshark/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)}`);
-                    }
+            // Check run status first
+            const runStatus = await miroJson(`/miroshark/api/simulation/${simId}/run-status`, "GET").catch(() => ({ runner_status: "idle" }));
+            const runnerStatus = (runStatus?.runner_status ?? "idle").toLowerCase();
+            // If not yet running, check whether agents are prepared by probing /config
+            // (config only exists after /prepare completes)
+            if (runnerStatus === "idle") {
+                const config = await miroJson(`/miroshark/api/simulation/${simId}/config`, "GET").catch(() => null);
+                if (!config) {
+                    // Preparation still in progress — check profiles for real-time progress
+                    const profiles = await miroJson(`/miroshark/api/simulation/${simId}/profiles/realtime`, "GET").catch(() => null);
+                    const total = profiles?.total_expected ?? "?";
+                    const ready = profiles?.profiles_ready ?? 0;
+                    return {
+                        content: [{
+                                type: "text",
+                                text: [
+                                    `**MiroShark \`${simId}\`** — preparing agents`,
+                                    total !== "?" ? `Profiles: ${ready} / ${total} ready` : `Profiles generating...`,
+                                    ``,
+                                    `Poll again in ~10 seconds.`,
+                                ].join("\n"),
+                            }],
+                    };
                 }
-                if (data.results.consensus)
-                    lines.push("", `**Consensus:** ${data.results.consensus}`);
+                // Config exists → agents prepared → auto-start
+                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 if (status === "failed") {
-                lines.push("", `Error: ${data.error ?? "unknown"}`);
+            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"),
+                        }],
+                };
             }
-            else {
-                lines.push("", "Simulation still running — poll again in a few seconds.");
+            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") }] };
             }
-            return { content: [{ type: "text", text: lines.join("\n") }] };
+            // Fallback: unknown state
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `**MiroShark \`${simId}\`** — status: ${runnerStatus || "unknown"}`,
+                            ``,
+                            `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.1.0",
+  "version": "1.2.1",
   "description": "Noelclaw as an MCP skill — persistent memory, multi-agent coordination, scenario simulation, DeFi execution, and Sentinel-gated playbooks.",
   "main": "dist/index.js",
   "bin": {