hackshop-mcp 0.0.3 → 0.0.5

package/dist/tools/simulate_assembly.js

@@ -0,0 +1,145 @@
+import { z } from "zod";
+// ─────────────────────────────────────────────────────────────────────────
+// simulate_assembly — hand an Assembly IR to the physics worker and get back a
+// bounded, synchronous verdict: did the robot reach its goal, and the honest
+// failure theatre (stuck / tipped / collisions) if it didn't.
+//
+// Compact mirror of site/lib/assembly.ts `Assembly` (kept loose on purpose; the
+// Python worker re-validates with Pydantic). Bounded mode caps duration + render
+// so this stays usable inside a single tool call.
+// ─────────────────────────────────────────────────────────────────────────
+const Transport = z.enum([
+    "usb", "i2c", "spi", "gpio", "uart", "wifi", "ble", "ros2", "hdmi", "aux", "power",
+]);
+const SimHandle = z.object({
+    asset_id: z.string().min(1).optional(),
+    asset_version: z.string().min(1).optional(),
+    model_uri: z.string().optional(),
+    format: z.enum(["mjcf", "urdf", "proxy"]).optional(),
+    dof: z.number().int().nonnegative().optional(),
+    mass_kg: z.number().positive().optional(),
+    dimensions_m: z.tuple([
+        z.number().positive(),
+        z.number().positive(),
+        z.number().positive(),
+    ]).optional(),
+    fidelity: z.enum([
+        "device-model",
+        "dimensioned-proxy",
+        "generic-placeholder",
+    ]).optional(),
+});
+const AssemblyComponent = z.object({
+    ref: z.string().min(1),
+    device_id: z.string().min(1),
+    name: z.string().min(1),
+    role: z.enum([
+        "compute", "actuator", "sensor", "display", "power", "chassis", "peripheral",
+    ]),
+    sim: SimHandle.optional(),
+});
+const ProtocolEdge = z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+    transport: Transport,
+    payload: z.string().optional(),
+});
+const Assembly = z.object({
+    idea: z.string().min(1),
+    components: z.array(AssemblyComponent).min(1),
+    edges: z.array(ProtocolEdge).default([]),
+    goal: z.object({
+        kind: z.enum(["navigate", "locomote", "manipulate", "sense-act", "display-loop"]),
+        spec: z.string().min(1),
+        success_metric: z.string().min(1),
+        criteria: z.object({
+            position_tolerance_m: z.number().positive().max(1),
+            dwell_s: z.number().nonnegative(),
+            max_collision_events: z.number().int().nonnegative(),
+            require_upright: z.boolean(),
+        }).optional(),
+    }),
+    world: z.object({
+        // Canonical WorldTemplate enum — keep in sync with site/lib/assembly.ts
+        // WorldSpec and the Python worker.
+        template: z.enum([
+            "empty-room", "obstacle-course", "ramp", "tabletop", "stairs", "outdoor-flat",
+        ]),
+        goal_xy: z.tuple([z.number(), z.number()]).optional(),
+    }),
+});
+export const simulateAssemblyInput = z.object({
+    assembly: Assembly,
+    duration_s: z.number().positive().max(10).optional(),
+});
+function workerBase() {
+    return (process.env.SIM_WORKER_URL || "http://127.0.0.1:8000").replace(/\/$/, "");
+}
+// Bounded sync simulation can take a while (cold MuJoCo + render) but must not
+// hang a tool call indefinitely. Cap the client-side wait well under any host
+// tool-call ceiling.
+const SYNC_TIMEOUT_MS = 90_000;
+export async function simulateAssembly(input) {
+    const body = {
+        assembly: input.assembly,
+        options: {
+            mode: "sync",
+            bounded: true,
+            render: true,
+            agent: false,
+            duration_s: input.duration_s ?? 8.0,
+        },
+    };
+    let job;
+    try {
+        const res = await fetch(`${workerBase()}/simulate`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(SYNC_TIMEOUT_MS),
+        });
+        if (!res.ok) {
+            return {
+                status: "error",
+                message: `Simulation worker returned ${res.status}: ${(await res.text()).slice(0, 200)}`,
+            };
+        }
+        job = (await res.json());
+    }
+    catch (err) {
+        const aborted = err instanceof Error &&
+            (err.name === "AbortError" || err.name === "TimeoutError");
+        return {
+            status: "unavailable",
+            message: aborted
+                ? `Simulation worker did not respond within ${SYNC_TIMEOUT_MS / 1000}s; treating it as unavailable. ` +
+                    "Set SIM_WORKER_URL and ensure the sim-worker is running and reachable."
+                : "Could not reach the simulation worker. Set SIM_WORKER_URL and ensure the " +
+                    `sim-worker is running. (${err instanceof Error ? err.message : "fetch failed"})`,
+        };
+    }
+    if (job.status === "error" || !job.result) {
+        return { status: "error", message: job.error ?? "Simulation failed with no result." };
+    }
+    const r = job.result;
+    if (!r.supported) {
+        return {
+            status: "unsupported",
+            message: r.reason ?? "This assembly/goal isn't simulatable yet.",
+            world_desc: r.world_desc,
+        };
+    }
+    return {
+        status: "ok",
+        success: r.success,
+        summary: r.summary,
+        post_mortem: r.post_mortem,
+        authored_by: r.authored_by,
+        metric_value: r.metric_value,
+        telemetry: r.telemetry,
+        world_desc: r.world_desc,
+        artifacts: r.artifacts,
+        robot: r.robot,
+    };
+}
+//# sourceMappingURL=simulate_assembly.js.map

package/dist/tools/simulate_assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate_assembly.js","sourceRoot":"","sources":["../../src/tools/simulate_assembly.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hackshop-mcp",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Hardware-literate AI scout for tinkerers. Idea-to-hardware mapping via MCP.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "catalog.json",
+    "platforms.json",
     "tags.md",
     "examples",
     "README.md",
@@ -51,7 +52,9 @@
     "zod": "^3.23.0"
   },
   "devDependencies": {
+    "@ai-sdk/anthropic": "^2.0.85",
     "@types/node": "^22.0.0",
+    "ai": "^6.0.223",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0"