hackshop-mcp 0.0.3 → 0.0.5

package/dist/core/resources.d.ts

@@ -0,0 +1,37 @@
+import type { CoreContext } from "./types.js";
+export interface CoreResource {
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    mimeType: string;
+}
+export interface CorePrompt {
+    name: string;
+    title: string;
+    description: string;
+    arguments: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+export declare const CORE_RESOURCES: CoreResource[];
+export declare const CORE_PROMPTS: CorePrompt[];
+export declare function listCoreResources(): CoreResource[];
+export declare function readCoreResource(uri: string, ctx: CoreContext): {
+    uri: string;
+    mimeType: string;
+    text: string;
+} | null;
+export declare function listCorePrompts(): CorePrompt[];
+export declare function getCorePrompt(name: string, args: Record<string, unknown> | undefined): {
+    description: string;
+    messages: Array<{
+        role: "user";
+        content: {
+            type: "text";
+            text: string;
+        };
+    }>;
+} | null;

package/dist/core/resources.js

@@ -0,0 +1,143 @@
+import { buildUrls } from "../build-plan/index.js";
+export const CORE_RESOURCES = [
+    {
+        uri: "hackshop://muse/boards",
+        name: "muse-boards",
+        title: "Muse boards",
+        description: "Every Hackshop Muse board with features, price and build-page URL.",
+        mimeType: "application/json",
+    },
+    {
+        uri: "hackshop://muse/sdk-terms",
+        name: "muse-sdk-terms",
+        title: "Muse SDK terms",
+        description: "Plain-English summary of the Muse SDK token terms.",
+        mimeType: "text/plain",
+    },
+    {
+        uri: "hackshop://catalog/tags",
+        name: "catalog-tags",
+        title: "Catalog tags",
+        description: "The Hackshop catalog tag list.",
+        mimeType: "text/plain",
+    },
+];
+export const CORE_PROMPTS = [
+    {
+        name: "plan-muse-gadget",
+        title: "Plan a Muse gadget",
+        description: "Guide an agent through intake, Muse gadget planning, shopping-list approval and assembly.",
+        arguments: [
+            {
+                name: "idea",
+                description: "The human's desired agent body or Muse gadget idea.",
+                required: true,
+            },
+            {
+                name: "budget_usd",
+                description: "Optional budget in USD.",
+                required: false,
+            },
+        ],
+    },
+];
+export function listCoreResources() {
+    return CORE_RESOURCES;
+}
+export function readCoreResource(uri, ctx) {
+    if (uri === "hackshop://muse/boards") {
+        return {
+            uri,
+            mimeType: "application/json",
+            text: JSON.stringify(museBoards(ctx), null, 2),
+        };
+    }
+    if (uri === "hackshop://muse/sdk-terms") {
+        return {
+            uri,
+            mimeType: "text/plain",
+            text: sdkTermsText(ctx.platforms),
+        };
+    }
+    if (uri === "hackshop://catalog/tags") {
+        return {
+            uri,
+            mimeType: "text/plain",
+            text: ctx.tagsText ?? (ctx.tags ?? []).map((tag) => `- \`${tag}\``).join("\n"),
+        };
+    }
+    return null;
+}
+export function listCorePrompts() {
+    return CORE_PROMPTS;
+}
+export function getCorePrompt(name, args) {
+    if (name !== "plan-muse-gadget")
+        return null;
+    const idea = typeof args?.idea === "string" && args.idea.trim().length > 0
+        ? args.idea.trim()
+        : "";
+    const budget = typeof args?.budget_usd === "number"
+        ? ` Budget: $${args.budget_usd}.`
+        : "";
+    return {
+        description: "Plan and build a Muse gadget body with explicit human purchase approval.",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Help me build a physical body for my AI agent. Idea: ${idea || "<ask me for the idea>"}.${budget}\n\n` +
+                        "Flow: ask at most four intake questions if the idea is vague, using `plan_gadget.questions`. Then call `plan_gadget` (or POST /api/plan) and let the human choose a board. Call `get_build_plan` for the chosen board, show the shopping list and get explicit approval before buying anything. Follow the machine-readable `assembly` steps, then flash and pair it. Tell the human to click Start a build on the build page so progress is saved.",
+                },
+            },
+        ],
+    };
+}
+function museBoards(ctx) {
+    const catalogById = new Map(ctx.catalog.map((device) => [device.id, device]));
+    return ctx.platforms.flatMap((platform) => platform.boards.flatMap((board) => {
+        const device = catalogById.get(board.device_id);
+        if (!device)
+            return [];
+        return [{
+                device_id: device.id,
+                name: device.name,
+                platform: platform.id,
+                platform_name: platform.name,
+                tier: board.tier,
+                support: board.support,
+                price: {
+                    min_usd: device.est_used_price_usd_min ?? null,
+                    max_usd: device.est_used_price_usd_max ?? null,
+                    label: priceLabel(device),
+                },
+                features: board.features,
+                build_command: board.build,
+                build_page_url: buildUrls(device.id, ctx.siteUrl, true).build_page,
+            }];
+    }));
+}
+function sdkTermsText(platforms) {
+    const seen = new Set();
+    const lines = [];
+    for (const platform of platforms) {
+        const key = `${platform.terms.summary}|${platform.terms.url}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        lines.push(`${platform.name}: ${platform.terms.summary}`);
+        lines.push(`Terms URL: ${platform.terms.url}`);
+    }
+    return lines.join("\n\n");
+}
+function priceLabel(device) {
+    const min = device.est_used_price_usd_min;
+    const max = device.est_used_price_usd_max;
+    if (min === undefined && max === undefined)
+        return null;
+    if (min !== undefined && max !== undefined && min !== max)
+        return `$${min}-${max}`;
+    return `~$${min ?? max}`;
+}
+//# sourceMappingURL=resources.js.map

package/dist/core/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/core/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAsBnD,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,GAAG,EAAE,wBAAwB;QAC7B,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,oEAAoE;QACjF,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,2BAA2B;QAChC,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,YAAY;KACvB;IACD;QACE,GAAG,EAAE,yBAAyB;QAC9B,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,YAAY;KACvB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,2FAA2F;QAC7F,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,qDAAqD;gBAClE,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,yBAAyB;gBACtC,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,GAAgB;IAEhB,IAAI,GAAG,KAAK,wBAAwB,EAAE,CAAC;QACrC,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SAC/C,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,KAAK,2BAA2B,EAAE,CAAC;QACxC,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,KAAK,yBAAyB,EAAE,CAAC;QACtC,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,YAAY;YACtB,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/E,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAAyC;IAEzC,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACxE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAClB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,MAAM,GAAG,OAAO,IAAI,EAAE,UAAU,KAAK,QAAQ;QACjD,CAAC,CAAC,aAAa,IAAI,CAAC,UAAU,GAAG;QACjC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,WAAW,EAAE,0EAA0E;QACvF,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,wDAAwD,IAAI,IAAI,uBAAuB,IAAI,MAAM,MAAM;wBACvG,qbAAqb;iBACxb;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAgB;IAClC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACxC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC;gBACN,SAAS,EAAE,MAAM,CAAC,EAAE;gBACpB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,QAAQ,CAAC,EAAE;gBACrB,aAAa,EAAE,QAAQ,CAAC,IAAI;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE;oBACL,OAAO,EAAE,MAAM,CAAC,sBAAsB,IAAI,IAAI;oBAC9C,OAAO,EAAE,MAAM,CAAC,sBAAsB,IAAI,IAAI;oBAC9C,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;iBAC1B;gBACD,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,aAAa,EAAE,KAAK,CAAC,KAAK;gBAC1B,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,UAAU;aACnE,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,SAAqB;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,cAAc,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,MAAmB;IACrC,MAAM,GAAG,GAAG,MAAM,CAAC,sBAAsB,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,sBAAsB,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;IACnF,OAAO,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/safety.d.ts

@@ -0,0 +1,7 @@
+import { type DeviceEntry } from "./types.js";
+export interface BrickRiskOutput {
+    brick_risk: number | null;
+    brick_risk_label: string;
+    brick_risk_disclaimer: string | null;
+}
+export declare function applyBrickRiskSafety(device: DeviceEntry): BrickRiskOutput;

package/dist/core/safety.js

@@ -0,0 +1,28 @@
+import { UNRECOVERABLE_BRICK_CATEGORIES, } from "./types.js";
+export function applyBrickRiskSafety(device) {
+    const isLlmInferred = device.brick_provenance === "llm-inferred";
+    const isUnrecoverable = UNRECOVERABLE_BRICK_CATEGORIES.has(device.category);
+    if (isLlmInferred && isUnrecoverable) {
+        return {
+            brick_risk: null,
+            brick_risk_label: "brick-risk unknown - research before flashing",
+            brick_risk_disclaimer: null,
+        };
+    }
+    if (isLlmInferred) {
+        return {
+            brick_risk: device.brick_risk,
+            brick_risk_label: `${device.brick_risk}/5 (LLM-inferred, unverified)`,
+            brick_risk_disclaimer: "Brick risk for this device is LLM-inferred and unverified. Confirm with the linked community before flashing.",
+        };
+    }
+    const provenance = device.brick_provenance === "vendor-docs"
+        ? "vendor docs; brick risk estimated"
+        : device.brick_provenance;
+    return {
+        brick_risk: device.brick_risk,
+        brick_risk_label: `${device.brick_risk}/5 (${provenance})`,
+        brick_risk_disclaimer: null,
+    };
+}
+//# sourceMappingURL=safety.js.map

package/dist/core/safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../src/core/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,GAE/B,MAAM,YAAY,CAAC;AAQpB,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,KAAK,cAAc,CAAC;IACjE,MAAM,eAAe,GAAG,8BAA8B,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5E,IAAI,aAAa,IAAI,eAAe,EAAE,CAAC;QACrC,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,gBAAgB,EAAE,+CAA+C;YACjE,qBAAqB,EAAE,IAAI;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,gBAAgB,EAAE,GAAG,MAAM,CAAC,UAAU,+BAA+B;YACrE,qBAAqB,EACnB,+GAA+G;SAClH,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GACd,MAAM,CAAC,gBAAgB,KAAK,aAAa;QACvC,CAAC,CAAC,mCAAmC;QACrC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAE9B,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,gBAAgB,EAAE,GAAG,MAAM,CAAC,UAAU,OAAO,UAAU,GAAG;QAC1D,qBAAqB,EAAE,IAAI;KAC5B,CAAC;AACJ,CAAC"}

package/dist/core/tools.d.ts

@@ -0,0 +1,247 @@
+import { z } from "zod";
+import type { BuildPlan } from "../build-plan/types.js";
+import { assessHackability } from "./assess.js";
+import { planGadget } from "./plan-gadget.js";
+import type { CoreContext } from "./types.js";
+export declare const getBuildPlanInput: z.ZodObject<{
+    device_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    device_id: string;
+}, {
+    device_id: string;
+}>;
+export type GetBuildPlanInput = z.infer<typeof getBuildPlanInput>;
+type JsonSchema = Record<string, unknown>;
+export interface CoreTool<Input, Output> {
+    name: "plan_gadget" | "get_build_plan" | "assess_hackability";
+    title: string;
+    description: string;
+    inputSchema: JsonSchema;
+    zodSchema: z.ZodTypeAny;
+    run(input: Input, ctx: CoreContext): Output | CoreToolError;
+}
+export interface CoreToolError {
+    isError: true;
+    text: string;
+}
+export interface CoreToolSuccess {
+    isError?: false;
+    output: unknown;
+}
+export type CoreToolResult = CoreToolSuccess | CoreToolError;
+export declare const CORE_TOOLS: readonly [{
+    name: "plan_gadget";
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            idea: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            platform: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            budget_usd: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            owned_device_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            needs: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: readonly ["voice", "screen", "images", "touch", "camera", "air-sensors", "e-ink", "battery", "round", "home-tunnel", "big-screen", "compute", "linux"];
+                };
+                description: string;
+            };
+            size: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    zodSchema: z.ZodObject<{
+        idea: z.ZodString;
+        platform: z.ZodDefault<z.ZodEnum<["muse-esp32", "muse-linux", "any"]>>;
+        budget_usd: z.ZodOptional<z.ZodNumber>;
+        owned_device_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        needs: z.ZodOptional<z.ZodArray<z.ZodEnum<["voice", "screen", "images", "touch", "camera", "air-sensors", "e-ink", "battery", "round", "home-tunnel", "big-screen", "compute", "linux"]>, "many">>;
+        size: z.ZodDefault<z.ZodEnum<["pocket", "desk", "wall", "any"]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        size: "pocket" | "desk" | "wall" | "any";
+        idea: string;
+        platform: "any" | "muse-esp32" | "muse-linux";
+        limit: number;
+        budget_usd?: number | undefined;
+        needs?: ("round" | "e-ink" | "battery" | "voice" | "compute" | "linux" | "screen" | "images" | "touch" | "camera" | "air-sensors" | "home-tunnel" | "big-screen")[] | undefined;
+        owned_device_ids?: string[] | undefined;
+    }, {
+        idea: string;
+        size?: "pocket" | "desk" | "wall" | "any" | undefined;
+        budget_usd?: number | undefined;
+        platform?: "any" | "muse-esp32" | "muse-linux" | undefined;
+        limit?: number | undefined;
+        needs?: ("round" | "e-ink" | "battery" | "voice" | "compute" | "linux" | "screen" | "images" | "touch" | "camera" | "air-sensors" | "home-tunnel" | "big-screen")[] | undefined;
+        owned_device_ids?: string[] | undefined;
+    }>;
+    run: typeof planGadget;
+}, {
+    name: "get_build_plan";
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            device_id: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    zodSchema: z.ZodObject<{
+        device_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        device_id: string;
+    }, {
+        device_id: string;
+    }>;
+    run: typeof getBuildPlan;
+}, {
+    name: "assess_hackability";
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            device_name: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    zodSchema: z.ZodObject<{
+        device_name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        device_name: string;
+    }, {
+        device_name: string;
+    }>;
+    run: typeof assessHackability;
+}];
+export type CoreToolName = (typeof CORE_TOOLS)[number]["name"];
+export declare function coreToolDefinitions(): {
+    name: "plan_gadget" | "assess_hackability" | "get_build_plan";
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            idea: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            platform: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            budget_usd: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            owned_device_ids: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                maxItems: number;
+                description: string;
+            };
+            needs: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: readonly ["voice", "screen", "images", "touch", "camera", "air-sensors", "e-ink", "battery", "round", "home-tunnel", "big-screen", "compute", "linux"];
+                };
+                description: string;
+            };
+            size: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    } | {
+        type: string;
+        properties: {
+            device_id: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+        };
+        required: string[];
+    } | {
+        type: string;
+        properties: {
+            device_name: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+export declare function executeCoreTool(toolName: string, args: unknown, ctx: CoreContext): CoreToolResult;
+export declare function getBuildPlan(input: GetBuildPlanInput, ctx: CoreContext): BuildPlan | CoreToolError;
+export {};

package/dist/core/tools.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import { buildPlan } from "../build-plan/index.js";
+import { assessHackability, assessHackabilityInput, } from "./assess.js";
+import { formatInputError } from "./errors.js";
+import { NEED_VALUES, planGadget, planGadgetInput, } from "./plan-gadget.js";
+export const getBuildPlanInput = z.object({
+    device_id: z.string().min(1).max(200),
+});
+export const CORE_TOOLS = [
+    {
+        name: "plan_gadget",
+        title: "Plan a Muse gadget",
+        description: "Deterministically plan a physical body for an AI agent using Meta Muse boards. Inputs: `idea` 3-2000 chars; `platform` one of muse-esp32, muse-linux, any (default any); `budget_usd` positive number up to 100000; `owned_device_ids` up to 50 catalog ids; `needs` values: " +
+            `${NEED_VALUES.join(", ")}; ` +
+            "`size` one of pocket, desk, wall, any (default any); `limit` 1-5 (default 3). Returns fit, notes, warnings, intake questions, picks, terms and next steps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                idea: {
+                    type: "string",
+                    minLength: 3,
+                    maxLength: 2000,
+                    description: "Gadget idea or use case, 3-2000 characters.",
+                },
+                platform: {
+                    type: "string",
+                    enum: ["muse-esp32", "muse-linux", "any"],
+                    default: "any",
+                    description: "Platform filter: muse-esp32, muse-linux, or any. Default any.",
+                },
+                budget_usd: {
+                    type: "number",
+                    minimum: 0,
+                    maximum: 100000,
+                    description: "Optional hardware budget in USD. Positive, max 100000.",
+                },
+                owned_device_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    maxItems: 50,
+                    description: "Catalog device ids the user already owns. Max 50.",
+                },
+                needs: {
+                    type: "array",
+                    items: { type: "string", enum: NEED_VALUES },
+                    description: `Optional explicit needs. Allowed: ${NEED_VALUES.join(", ")}.`,
+                },
+                size: {
+                    type: "string",
+                    enum: ["pocket", "desk", "wall", "any"],
+                    default: "any",
+                    description: "Preferred size or placement: pocket, desk, wall, any. Default any.",
+                },
+                limit: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 5,
+                    default: 3,
+                    description: "Number of picks to return: 1-5, default 3.",
+                },
+            },
+            required: ["idea"],
+        },
+        zodSchema: planGadgetInput,
+        run: planGadget,
+    },
+    {
+        name: "get_build_plan",
+        title: "Get a build plan",
+        description: "Return the complete deterministic build plan for a catalog device id: parts, shopping list, steps, machine-readable assembly, commands, links, caveats and an agent-ready brief. Input: `device_id` 1-200 chars.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                device_id: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 200,
+                    description: "Catalog device id, 1-200 characters.",
+                },
+            },
+            required: ["device_id"],
+        },
+        zodSchema: getBuildPlanInput,
+        run: getBuildPlan,
+    },
+    {
+        name: "assess_hackability",
+        title: "Assess hackability",
+        description: "Look up a device by id, exact name or substring and return hackability, brick risk, firmware links, community size, build page and agent platform support. Input: `device_name` 1-200 chars.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                device_name: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 200,
+                    description: "Device name or id, 1-200 characters.",
+                },
+            },
+            required: ["device_name"],
+        },
+        zodSchema: assessHackabilityInput,
+        run: assessHackability,
+    },
+];
+export function coreToolDefinitions() {
+    return CORE_TOOLS.map((tool) => ({
+        name: tool.name,
+        title: tool.title,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    }));
+}
+export function executeCoreTool(toolName, args, ctx) {
+    const tool = CORE_TOOLS.find((candidate) => candidate.name === toolName);
+    if (!tool) {
+        return { isError: true, text: `Unknown tool: ${toolName}` };
+    }
+    const parsed = tool.zodSchema.safeParse(args);
+    if (!parsed.success) {
+        return {
+            isError: true,
+            text: formatInputError(tool.name, parsed.error),
+        };
+    }
+    const result = tool.run(parsed.data, ctx);
+    if (isCoreToolError(result))
+        return result;
+    return { output: result };
+}
+export function getBuildPlan(input, ctx) {
+    const device = ctx.catalog.find((candidate) => candidate.id === input.device_id);
+    if (!device) {
+        // Suggest supported agent-gadget boards first; they are what people ask for.
+        const boardIds = ctx.platforms.flatMap((platform) => platform.boards.filter((board) => board.support === "official").map((board) => board.device_id));
+        const examples = (boardIds.length > 0 ? boardIds : ctx.catalog.map((candidate) => candidate.id))
+            .slice(0, 4)
+            .join(", ");
+        return {
+            isError: true,
+            text: `Unknown device_id "${input.device_id}". It isn't in the hackshop catalog. Try one of: ${examples}, or call plan_gadget to find a board for an idea.`,
+        };
+    }
+    const { platform, board } = platformAndBoardFor(device.id, ctx.platforms);
+    return buildPlan({
+        device,
+        platform,
+        board,
+        printables: ctx.printablesFor(device, ctx.siteUrl),
+        siteUrl: ctx.siteUrl,
+    });
+}
+function platformAndBoardFor(deviceId, platforms) {
+    for (const platform of platforms) {
+        const board = platform.boards.find((candidate) => candidate.device_id === deviceId);
+        if (board)
+            return { platform, board };
+    }
+    return { platform: null, board: null };
+}
+function isCoreToolError(value) {
+    return Boolean(value && typeof value === "object" && "isError" in value);
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/tools.js.map

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