hackshop-mcp 0.0.3 → 0.0.5

package/dist/sampling.js

@@ -1,24 +1,12 @@
 import Anthropic from "@anthropic-ai/sdk";
-// Wraps sampling/createMessage with retry-once + Anthropic-API fallback +
-// degraded-response semantics. Returns either parsed JSON of shape T, or null
-// if every path failed.
-//
-// Order of attempts:
-//   1. server.createMessage (host-delegated sampling)  — preferred
-//   2. retry server.createMessage once on transient failure
-//   3. direct Anthropic API call IF process.env.ANTHROPIC_API_KEY is set — fallback
-//   4. return null → caller produces a degraded response
-//
-// The fallback exists because not all MCP hosts implement sampling/createMessage
-// today. Claude Code supports it; Claude Desktop's support has been spotty;
-// Cursor / Cowork / other clients may not. Setting ANTHROPIC_API_KEY in your
-// MCP client config (under "env") gives the user reasoning even on hosts
-// without sampling.
 export async function sampleJson(opts) {
-    const { server, systemPrompt, userPrompt, maxTokens = 1500 } = opts;
+    const { server, systemPrompt, userPrompt, maxTokens = 1500, diagnostics, hostSamplingTimeoutMs, } = opts;
+    const hostSamplingDeadline = hostSamplingTimeoutMs === undefined
+        ? undefined
+        : Date.now() + hostSamplingTimeoutMs;
     const tryHostSampling = async () => {
         try {
-            const response = await server.createMessage({
+            const response = await withTimeout(server.createMessage({
                 systemPrompt,
                 messages: [
                     {
@@ -31,7 +19,7 @@ export async function sampleJson(opts) {
                     intelligencePriority: 0.6,
                     speedPriority: 0.4,
                 },
-            });
+            }), remainingHostSamplingMs(hostSamplingDeadline));
             const content = response.content;
             if (content.type !== "text")
                 return null;
@@ -49,13 +37,18 @@ export async function sampleJson(opts) {
     const second = await tryHostSampling();
     if (second !== null)
         return second;
-    // Attempt 3: direct Anthropic API fallback (env-gated)
+    // Attempt 3: direct Anthropic API fallback (env-gated). Default model id kept
+    // current ('claude-sonnet-4-6'); override via HACKSHOP_MODEL. If this throws
+    // WHILE a key was present (e.g. the default model was retired), we record the
+    // error in `diagnostics` so the caller can make the failure user-visible
+    // instead of degrading silently to stderr only.
     const apiKey = process.env.ANTHROPIC_API_KEY;
     if (apiKey) {
+        const fallbackModel = process.env.HACKSHOP_MODEL ?? "claude-sonnet-4-6";
         try {
             const client = new Anthropic({ apiKey });
             const response = await client.messages.create({
-                model: process.env.HACKSHOP_MODEL ?? "claude-sonnet-4-6",
+                model: fallbackModel,
                 max_tokens: maxTokens,
                 system: systemPrompt,
                 messages: [{ role: "user", content: userPrompt }],
@@ -68,13 +61,43 @@ export async function sampleJson(opts) {
                     return parsed;
                 }
             }
+            // Key present, call succeeded, but content was unusable — note it.
+            if (diagnostics) {
+                diagnostics.apiFallbackError = `Anthropic API fallback (model "${fallbackModel}") returned no usable JSON.`;
+            }
         }
         catch (err) {
-            process.stderr.write(`[hackshop-mcp] Anthropic fallback failed: ${err.message}\n`);
+            const msg = err.message;
+            process.stderr.write(`[hackshop-mcp] Anthropic fallback failed: ${msg}\n`);
+            if (diagnostics) {
+                diagnostics.apiFallbackError = `Anthropic API fallback failed (model "${fallbackModel}"): ${msg}. If the model id was retired, set HACKSHOP_MODEL to a current model.`;
+            }
         }
     }
     return null;
 }
+function remainingHostSamplingMs(deadline) {
+    if (deadline === undefined)
+        return undefined;
+    return Math.max(1, deadline - Date.now());
+}
+async function withTimeout(promise, timeoutMs) {
+    if (timeoutMs === undefined)
+        return promise;
+    let timeout;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => reject(new Error("host sampling timed out")), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
 // Strip a possible markdown code fence around JSON. Tolerant of whitespace
 // and explanatory prose around the fence.
 function parseJsonLoose(text) {

package/dist/sampling.js.map

@@ -1 +1 @@
-{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,0EAA0E;AAC1E,8EAA8E;AAC9E,wBAAwB;AACxB,EAAE;AACF,qBAAqB;AACrB,mEAAmE;AACnE,4DAA4D;AAC5D,oFAAoF;AACpF,yDAAyD;AACzD,EAAE;AACF,iFAAiF;AACjF,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,oBAAoB;AACpB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAI,IAKnC;IACC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAEpE,MAAM,eAAe,GAAG,KAAK,IAAuB,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;gBAC1C,YAAY;gBACZ,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE;qBAC5C;iBACF;gBACD,SAAS;gBACT,gBAAgB,EAAE;oBAChB,oBAAoB,EAAE,GAAG;oBACzB,aAAa,EAAE,GAAG;iBACnB;aACF,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;YACjC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,cAAc,CAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEjC,uBAAuB;IACvB,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAEnC,uDAAuD;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC5C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,mBAAmB;gBACxD,UAAU,EAAE,SAAS;gBACrB,MAAM,EAAE,YAAY;gBACpB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;aAClD,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,cAAc,CAAI,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oFAAoF,CACrF,CAAC;oBACF,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6CAA8C,GAAa,CAAC,OAAO,IAAI,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,0CAA0C;AAC1C,SAAS,cAAc,CAAI,IAAY;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,+CAA+C;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChE,IAAI,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,wEAAwE;IACxE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;YAChC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAM,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,6EAA6E;AAC7E,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc;IACvD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;YAC1C,YAAY,EACV,mEAAmE;YACrE,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;aAC3D;YACD,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"sampling.js","sourceRoot":"","sources":["../src/sampling.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,2 +1,15 @@
 #!/usr/bin/env node
-export {};
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { DeviceEntry } from "./catalog/schema.js";
+import type { Platform } from "./platforms/schema.js";
+export declare function createToolRunner(context: {
+    devices: DeviceEntry[];
+    platforms: Platform[];
+    server?: Server;
+    tags?: string[];
+}): (name: string, args: unknown) => Promise<{
+    out: unknown;
+    degraded?: boolean;
+    isError?: boolean;
+    text?: string;
+}>;

package/dist/server.js

@@ -1,21 +1,87 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { loadCatalog } from "./catalog/load.js";
+import { loadPlatforms } from "./platforms/load.js";
+import { printablesFor, setLoadedPlatforms } from "./platforms/index.js";
 import { probeSamplingSupport } from "./sampling.js";
 import { proposeHardware, proposeHardwareInput, } from "./tools/propose_hardware.js";
-import { assessHackability, assessHackabilityInput, } from "./tools/assess_hackability.js";
+import { simulateAssembly, simulateAssemblyInput, } from "./tools/simulate_assembly.js";
+import { siteUrlFromEnv } from "./site-url.js";
+import { createTelemetry, errorKind } from "./telemetry.js";
+import { coreToolDefinitions, executeCoreTool, } from "./core/tools.js";
+import { getCorePrompt, listCorePrompts, listCoreResources, readCoreResource, } from "./core/resources.js";
 const NAME = "hackshop-mcp";
-const VERSION = "0.0.3";
+const VERSION = "0.0.5";
+const STDIO_INSTRUCTIONS = "Hackshop maps a natural-language project idea to hackable, repurposable, or protocol-native hardware. Use plan_gadget for Muse agent-body gadgets because it is deterministic, instant and key-free. Use propose_hardware for broader repurposing ideas and existing hardware, especially when the host can sample or ANTHROPIC_API_KEY is set. Hackshop never buys anything; show shopping lists and ask the human before any purchase. Anonymous usage telemetry (tool names and timings only) is on by default; set HACKSHOP_TELEMETRY=0 to turn it off.";
+export function createToolRunner(context) {
+    return async (name, args) => {
+        if (name === "propose_hardware") {
+            if (!context.server) {
+                throw new Error("propose_hardware requires an MCP server context");
+            }
+            const input = proposeHardwareInput.parse(args);
+            const out = await proposeHardware(input, context.devices, context.server);
+            return { out, degraded: out.degraded };
+        }
+        if (name === "assess_hackability" ||
+            name === "plan_gadget" ||
+            name === "get_build_plan") {
+            const result = executeCoreTool(name, args, coreContext(context.devices, context.platforms, context.tags));
+            return runnerResult(result);
+        }
+        if (name === "simulate_assembly") {
+            const input = simulateAssemblyInput.parse(args);
+            return { out: await simulateAssembly(input) };
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    };
+}
+function coreContext(catalog, platforms, tags) {
+    const siteUrl = siteUrlFromEnv();
+    return {
+        catalog,
+        platforms,
+        printablesFor: (device, baseUrl) => printablesFor(device, baseUrl),
+        siteUrl,
+        tags,
+    };
+}
+function runnerResult(result) {
+    if (result.isError) {
+        return { out: { error: result.text }, isError: true, text: result.text };
+    }
+    return { out: result.output };
+}
 async function main() {
     // Boot validation. Refuses to start on bad catalog/tags.
     const { devices, tags } = loadCatalog();
-    process.stderr.write(`[hackshop-mcp] Catalog loaded: ${devices.length} devices, ${tags.size} tags.\n`);
+    const sortedTags = [...tags].sort();
+    const platforms = loadPlatforms(devices);
+    setLoadedPlatforms(platforms);
+    process.stderr.write(`[hackshop-mcp] Catalog loaded: ${devices.length} devices, ${tags.size} tags, ${platforms.length} platforms.\n`);
     // Note: sampling is a CLIENT capability, not a server one. We don't declare
     // it here; we just call server.createMessage(...) and the host either
     // supports it or doesn't. probeSamplingSupport() handles the check.
-    const server = new Server({ name: NAME, version: VERSION }, { capabilities: { tools: {} } });
+    const server = new Server({ name: NAME, version: VERSION }, {
+        capabilities: { tools: {}, resources: {}, prompts: {} },
+        instructions: STDIO_INSTRUCTIONS,
+    });
+    const telemetry = createTelemetry(VERSION);
+    const clientInfo = () => {
+        const client = server.getClientVersion();
+        return { client_name: client?.name, client_version: client?.version };
+    };
+    server.oninitialized = () => {
+        telemetry.send({
+            event: "mcp_server_started",
+            ...clientInfo(),
+            client_sampling: Boolean(server.getClientCapabilities()?.sampling),
+        });
+    };
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: [
             {
@@ -40,60 +106,118 @@ async function main() {
                     required: ["idea"],
                 },
             },
+            ...coreToolDefinitions(),
             {
-                name: "assess_hackability",
-                description: "Given a device name, return: hackable y/n, hack difficulty, brick risk (with safety rule applied), firmware links, community size, last verified date, and notes. Looks up by id, exact name, or substring.",
+                name: "simulate_assembly",
+                description: "Drop a proposed robot Assembly into a MuJoCo physics world and run a bounded navigation rollout. Returns whether it reached the goal plus honest failure telemetry (stuck/tipped/collisions/heading-oscillation), a natural-language post-mortem, and artifact URLs (rendered mp4, scene.xml, control.py, telemetry.json). Today simulates the diff-drive 'navigate' slice; other goal kinds return an honest 'unsupported'. Requires a running sim-worker (SIM_WORKER_URL).",
                 inputSchema: {
                     type: "object",
                     properties: {
-                        device_name: {
-                            type: "string",
-                            description: "Device name or id.",
+                        assembly: {
+                            type: "object",
+                            description: "Assembly IR: { idea, components[{ref,device_id,name,role}], edges[], goal{kind,spec,success_metric}, world{template,goal_xy?} }. Build it with the site /api/assembly output or by hand.",
+                        },
+                        duration_s: {
+                            type: "number",
+                            description: "Optional sim seconds (<=10, bounded). Default 8.",
                         },
                     },
-                    required: ["device_name"],
+                    required: ["assembly"],
                 },
             },
         ],
     }));
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: listCoreResources(),
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const resource = readCoreResource(request.params.uri, coreContext(devices, platforms, sortedTags));
+        if (!resource) {
+            throw new Error(`Unknown resource: ${request.params.uri}`);
+        }
+        return { contents: [resource] };
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: listCorePrompts(),
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const prompt = getCorePrompt(request.params.name, request.params.arguments);
+        if (!prompt) {
+            throw new Error(`Unknown prompt: ${request.params.name}`);
+        }
+        return prompt;
+    });
+    const runTool = createToolRunner({ devices, platforms, server, tags: sortedTags });
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
-        if (name === "propose_hardware") {
-            const input = proposeHardwareInput.parse(args);
-            const out = await proposeHardware(input, devices, server);
+        const startedAt = Date.now();
+        try {
+            const { out, degraded, isError, text } = await runTool(name, args);
+            telemetry.send({
+                event: "mcp_tool_called",
+                tool: name,
+                success: !isError,
+                degraded,
+                ...(isError ? { error_kind: "tool_error" } : {}),
+                duration_ms: Date.now() - startedAt,
+                ...clientInfo(),
+            });
             return {
-                content: [{ type: "text", text: JSON.stringify(out, null, 2) }],
+                ...(isError ? { isError: true } : {}),
+                content: [{ type: "text", text: text ?? JSON.stringify(out, null, 2) }],
             };
         }
-        if (name === "assess_hackability") {
-            const input = assessHackabilityInput.parse(args);
-            const out = assessHackability(input, devices);
-            return {
-                content: [{ type: "text", text: JSON.stringify(out, null, 2) }],
-            };
+        catch (err) {
+            telemetry.send({
+                event: "mcp_tool_called",
+                tool: name,
+                success: false,
+                error_kind: errorKind(err),
+                duration_ms: Date.now() - startedAt,
+                ...clientInfo(),
+            });
+            throw err;
         }
-        throw new Error(`Unknown tool: ${name}`);
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // Probe sampling support after connect. Logs to stderr; never fatal.
-    // Some hosts (Claude Desktop, Claude Code) support sampling/createMessage;
-    // some clients don't. If unsupported, propose_hardware degrades gracefully.
-    void probeSamplingSupport(server).then((ok) => {
-        if (!ok) {
-            process.stderr.write("[hackshop-mcp] Warning: this MCP host does not appear to support " +
-                "sampling/createMessage. The propose_hardware tool will return " +
-                "degraded responses (raw catalog matches without reasoning). " +
-                "Hosts known to support sampling: Claude Desktop, Claude Code.\n");
-        }
-        else {
-            process.stderr.write("[hackshop-mcp] Sampling probe OK.\n");
-        }
-    });
+    // Probe sampling support after connect — but ONLY when explicitly opted in
+    // via HACKSHOP_PROBE_SAMPLING=1. Previously this fired a real createMessage on
+    // every boot just to log "Sampling probe OK", spending tokens on every start.
+    // propose_hardware already degrades gracefully when sampling is unsupported,
+    // so the probe is purely informational. Logs to stderr; never fatal.
+    if (process.env.HACKSHOP_PROBE_SAMPLING === "1") {
+        void probeSamplingSupport(server).then((ok) => {
+            if (!ok) {
+                process.stderr.write("[hackshop-mcp] Warning: this MCP host does not appear to support " +
+                    "sampling/createMessage. The propose_hardware tool will return " +
+                    "degraded responses (raw catalog matches without reasoning). " +
+                    "Hosts known to support sampling: Claude Desktop, Claude Code.\n");
+            }
+            else {
+                process.stderr.write("[hackshop-mcp] Sampling probe OK.\n");
+            }
+        });
+    }
     process.stderr.write(`[hackshop-mcp] ${NAME} v${VERSION} ready.\n`);
 }
-main().catch((err) => {
-    process.stderr.write(`[hackshop-mcp] Fatal: ${err.message}\n`);
-    process.exit(1);
-});
+function isDirectRun() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    if (import.meta.url === pathToFileURL(entry).href)
+        return true;
+    try {
+        return import.meta.url === pathToFileURL(realpathSync(entry)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectRun()) {
+    main().catch((err) => {
+        process.stderr.write(`[hackshop-mcp] Fatal: ${err.message}\n`);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/site-url.d.ts

@@ -0,0 +1 @@
+export declare function siteUrlFromEnv(): string;

package/dist/site-url.js

@@ -0,0 +1,4 @@
+export function siteUrlFromEnv() {
+    return (process.env.HACKSHOP_SITE_URL ?? "https://www.hackshop.dev").replace(/\/+$/, "");
+}
+//# sourceMappingURL=site-url.js.map

package/dist/site-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-url.js","sourceRoot":"","sources":["../src/site-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,0BAA0B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_TELEMETRY_URL = "https://www.hackshop.dev/api/telemetry/mcp";
+export type TelemetryEvent = {
+    event: "mcp_server_started";
+    client_name?: string;
+    client_version?: string;
+    client_sampling?: boolean;
+} | {
+    event: "mcp_tool_called";
+    tool: string;
+    success: boolean;
+    duration_ms: number;
+    degraded?: boolean;
+    error_kind?: string;
+    client_name?: string;
+    client_version?: string;
+};
+export declare function telemetryEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Stable random install id, so repeat use by one person counts once. Falls
+ * back to a per-process id if the config dir is not writable.
+ */
+export declare function loadInstallId(env?: NodeJS.ProcessEnv, onCreate?: (path: string) => void): string;
+export type Telemetry = {
+    enabled: boolean;
+    send(event: TelemetryEvent): void;
+};
+export declare function createTelemetry(version: string, env?: NodeJS.ProcessEnv, log?: (line: string) => void): Telemetry;
+/** Coarse error bucket; the message itself is not sent. */
+export declare function errorKind(err: unknown): string;

package/dist/telemetry.js

@@ -0,0 +1,100 @@
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+// Anonymous usage telemetry for the MCP server. It exists so the maintainer
+// can see that the server is being used at all: stdio servers run on users'
+// machines and are otherwise invisible.
+//
+// Sent: event name, tool name, success/degraded, duration, hackshop-mcp
+// version, MCP client name/version, OS platform, Node major version, and a
+// random install id. NEVER sent: tool arguments, ideas, device names, results,
+// API keys, file paths, or anything typed by the user.
+//
+// Opt out with HACKSHOP_TELEMETRY=0 (or DO_NOT_TRACK=1).
+export const DEFAULT_TELEMETRY_URL = "https://www.hackshop.dev/api/telemetry/mcp";
+const SEND_TIMEOUT_MS = 1_500;
+const KNOWN_TOOLS = new Set(["propose_hardware", "assess_hackability", "simulate_assembly"]);
+export function telemetryEnabled(env = process.env) {
+    const flag = env.HACKSHOP_TELEMETRY?.trim().toLowerCase();
+    if (flag && ["0", "false", "off", "no", "disabled"].includes(flag))
+        return false;
+    const dnt = env.DO_NOT_TRACK?.trim().toLowerCase();
+    if (dnt && dnt !== "0" && dnt !== "false")
+        return false;
+    // Test runners and CI are not real usage.
+    if (env.VITEST || env.CI)
+        return false;
+    return true;
+}
+function configPath(env) {
+    const base = env.XDG_CONFIG_HOME?.trim() || join(homedir(), ".config");
+    return join(base, "hackshop-mcp", "telemetry.json");
+}
+/**
+ * Stable random install id, so repeat use by one person counts once. Falls
+ * back to a per-process id if the config dir is not writable.
+ */
+export function loadInstallId(env = process.env, onCreate = () => { }) {
+    const path = configPath(env);
+    try {
+        const stored = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof stored.install_id === "string" && stored.install_id.length === 36) {
+            return stored.install_id;
+        }
+    }
+    catch {
+        // Missing or unreadable: create below.
+    }
+    const id = randomUUID();
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify({ install_id: id }) + "\n", "utf8");
+        onCreate(path);
+    }
+    catch {
+        // Read-only home, sandbox, etc. A per-process id is fine.
+    }
+    return id;
+}
+export function createTelemetry(version, env = process.env, log = (line) => process.stderr.write(line)) {
+    if (!telemetryEnabled(env)) {
+        return { enabled: false, send: () => { } };
+    }
+    const installId = loadInstallId(env, () => log("[hackshop-mcp] Anonymous usage telemetry is on (tool names and timings only; " +
+        "never your ideas or tool inputs). Opt out with HACKSHOP_TELEMETRY=0.\n"));
+    const url = env.HACKSHOP_TELEMETRY_URL?.trim() || DEFAULT_TELEMETRY_URL;
+    const base = {
+        install_id: installId,
+        mcp_version: version,
+        platform: process.platform,
+        node_version: process.versions.node.split(".")[0],
+    };
+    return {
+        enabled: true,
+        send(event) {
+            const payload = event.event === "mcp_tool_called" && !KNOWN_TOOLS.has(event.tool)
+                ? { ...event, tool: "unknown" }
+                : event;
+            // Fire and forget: never awaited, never throws, never blocks a tool call.
+            void fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ ...base, ...payload }),
+                signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
+            }).catch(() => { });
+        },
+    };
+}
+/** Coarse error bucket; the message itself is not sent. */
+export function errorKind(err) {
+    if (err && typeof err === "object" && "name" in err) {
+        const name = String(err.name);
+        if (name === "ZodError")
+            return "invalid_input";
+        if (name === "AbortError" || name === "TimeoutError")
+            return "timeout";
+    }
+    return "error";
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/tools/assess_hackability.d.ts

@@ -1,31 +1,4 @@
-import { z } from "zod";
 import type { DeviceEntry } from "../catalog/schema.js";
-import { type DeviceLinks } from "../links.js";
-export declare const assessHackabilityInput: z.ZodObject<{
-    device_name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    device_name: string;
-}, {
-    device_name: string;
-}>;
-export type AssessInput = z.infer<typeof assessHackabilityInput>;
-export interface AssessOutput {
-    found: boolean;
-    device?: {
-        id: string;
-        name: string;
-        category: string;
-        hackable: boolean;
-        hack_difficulty: number;
-        brick_risk: number | null;
-        brick_risk_label: string;
-        brick_risk_disclaimer: string | null;
-        firmware_links: string[];
-        community_size: string;
-        last_verified: string;
-        notes: string;
-        links: DeviceLinks;
-    };
-    message?: string;
-}
+import { assessHackabilityInput, type AssessInput, type AssessOutput } from "../core/assess.js";
+export { assessHackabilityInput, type AssessInput, type AssessOutput };
 export declare function assessHackability(input: AssessInput, catalog: DeviceEntry[]): AssessOutput;