hackshop-mcp 0.0.4 → 0.0.5

package/dist/build-plan/types.d.ts

@@ -0,0 +1,153 @@
+export type FeatureValue = boolean | string | number | null;
+export interface DeviceEntry {
+    id: string;
+    name: string;
+    buy_url?: string;
+    firmware_links: string[];
+    est_used_price_usd_min?: number;
+    est_used_price_usd_max?: number;
+    est_setup_hours_min?: number;
+    est_setup_hours_max?: number;
+}
+export interface PlatformBoardPart {
+    name: string;
+    qty: number;
+    required: boolean;
+    note: string;
+    buy_url?: string;
+    search?: string;
+    est_price_usd?: number;
+}
+export interface PlatformBoard {
+    device_id: string;
+    support: "official" | "possible";
+    tier: string;
+    kind: string;
+    build: string;
+    eol?: boolean;
+    note: string;
+    features: Record<string, FeatureValue>;
+    parts: PlatformBoardPart[];
+    try_saying: string[];
+}
+export interface Platform {
+    id: string;
+    name: string;
+    homepage: string;
+    sdk_repo: string;
+    sdk_path: string;
+    docs_url: string;
+    toolchain: string;
+    setup_steps: string[];
+    tiers: Array<{
+        id: string;
+        label: string;
+        description: string;
+    }>;
+    caveats: string[];
+    terms: {
+        url: string;
+        summary: string;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+    };
+}
+export interface Printable {
+    part: "desk-stand" | "enclosure";
+    title: string;
+    stl_url: string;
+    step_url: string;
+    svg_url: string;
+    fab_url: string;
+    fab?: {
+        print?: {
+            orientation?: string;
+            supports?: boolean;
+            material?: string;
+            layer_mm?: number;
+            infill_pct?: number;
+        };
+        params?: {
+            clearance?: number;
+            cable_d?: number;
+            plug_overmold?: number[];
+            tilt_deg?: number;
+        };
+        checks?: Record<string, boolean | null>;
+        caveats?: string[];
+    };
+}
+export interface BuildPlanPart {
+    id: string;
+    name: string;
+    qty: number;
+    required: boolean;
+    note: string;
+    buy_url: string | null;
+    search_url: string | null;
+    kind: "board" | "part" | "printed";
+    est_price_usd: number | null;
+}
+export interface BuildPlanStep {
+    id: string;
+    title: string;
+    why: string;
+    body_md: string;
+    commands: string[];
+    links: Array<{
+        label: string;
+        url: string;
+    }>;
+}
+export interface AssemblyStep {
+    id: string;
+    order: number;
+    action: "print" | "place" | "insert" | "connect" | "route_cable" | "fasten" | "power" | "flash" | "pair" | "verify";
+    part_ids: string[];
+    tools: string[];
+    instruction: string;
+    check: string;
+    robot: {
+        feasible: boolean;
+        notes: string;
+    };
+}
+export interface ShoppingList {
+    items: Array<{
+        part_id: string;
+        name: string;
+        qty: number;
+        url: string | null;
+        url_kind: "buy" | "search";
+        est_price_usd: number | null;
+        required: boolean;
+    }>;
+    est_total_usd: number | null;
+    currency: "USD";
+    purchase_policy: string;
+}
+export interface BuildPlan {
+    device_id: string;
+    name: string;
+    platform_id: string | null;
+    tier_label: string | null;
+    summary: string;
+    est_cost_label: string | null;
+    est_time_label: string | null;
+    parts: BuildPlanPart[];
+    shopping_list: ShoppingList;
+    steps: BuildPlanStep[];
+    assembly: AssemblyStep[];
+    try_saying: string[];
+    caveats: string[];
+    terms: {
+        summary: string;
+        url: string;
+    } | null;
+    agent_brief_md: string;
+    urls: {
+        build_page: string;
+        build_md: string;
+        muse_page: string | null;
+    };
+}

package/dist/build-plan/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/build-plan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/build-plan/types.ts"],"names":[],"mappings":""}

package/dist/catalog/schema.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export declare const Category: z.ZodEnum<["display", "speaker", "input", "sensor", "bulb", "sbc", "handheld", "mini-pc", "wearable", "router", "other"]>;
-export declare const Provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred"]>;
+export declare const Provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred", "vendor-docs"]>;
 export declare const CommunitySize: z.ZodEnum<["tiny", "small", "active", "thriving"]>;
 export declare const Physical: z.ZodEffects<z.ZodObject<{
     orientation: z.ZodEnum<["upright", "flat"]>;
@@ -138,13 +138,14 @@ export declare const DeviceEntry: z.ZodObject<{
     idea_fit_tags: z.ZodArray<z.ZodString, "many">;
     hack_difficulty: z.ZodNumber;
     brick_risk: z.ZodNumber;
-    brick_provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred"]>;
+    brick_provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred", "vendor-docs"]>;
     last_verified: z.ZodString;
     firmware_links: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     community_size_bucket: z.ZodEnum<["tiny", "small", "active", "thriving"]>;
     notes: z.ZodString;
     est_used_price_usd_min: z.ZodOptional<z.ZodNumber>;
     est_used_price_usd_max: z.ZodOptional<z.ZodNumber>;
+    buy_url: z.ZodOptional<z.ZodString>;
     image_url: z.ZodOptional<z.ZodString>;
     est_setup_hours_min: z.ZodOptional<z.ZodNumber>;
     est_setup_hours_max: z.ZodOptional<z.ZodNumber>;
@@ -284,13 +285,14 @@ export declare const DeviceEntry: z.ZodObject<{
     idea_fit_tags: string[];
     hack_difficulty: number;
     brick_risk: number;
-    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred";
+    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred" | "vendor-docs";
     last_verified: string;
     firmware_links: string[];
     community_size_bucket: "tiny" | "small" | "active" | "thriving";
     notes: string;
     est_used_price_usd_min?: number | undefined;
     est_used_price_usd_max?: number | undefined;
+    buy_url?: string | undefined;
     image_url?: string | undefined;
     est_setup_hours_min?: number | undefined;
     est_setup_hours_max?: number | undefined;
@@ -324,13 +326,14 @@ export declare const DeviceEntry: z.ZodObject<{
     idea_fit_tags: string[];
     hack_difficulty: number;
     brick_risk: number;
-    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred";
+    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred" | "vendor-docs";
     last_verified: string;
     community_size_bucket: "tiny" | "small" | "active" | "thriving";
     notes: string;
     firmware_links?: string[] | undefined;
     est_used_price_usd_min?: number | undefined;
     est_used_price_usd_max?: number | undefined;
+    buy_url?: string | undefined;
     image_url?: string | undefined;
     est_setup_hours_min?: number | undefined;
     est_setup_hours_max?: number | undefined;
@@ -369,13 +372,14 @@ export declare const Catalog: z.ZodArray<z.ZodObject<{
     idea_fit_tags: z.ZodArray<z.ZodString, "many">;
     hack_difficulty: z.ZodNumber;
     brick_risk: z.ZodNumber;
-    brick_provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred"]>;
+    brick_provenance: z.ZodEnum<["founder-verified", "community-reported", "llm-inferred", "vendor-docs"]>;
     last_verified: z.ZodString;
     firmware_links: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     community_size_bucket: z.ZodEnum<["tiny", "small", "active", "thriving"]>;
     notes: z.ZodString;
     est_used_price_usd_min: z.ZodOptional<z.ZodNumber>;
     est_used_price_usd_max: z.ZodOptional<z.ZodNumber>;
+    buy_url: z.ZodOptional<z.ZodString>;
     image_url: z.ZodOptional<z.ZodString>;
     est_setup_hours_min: z.ZodOptional<z.ZodNumber>;
     est_setup_hours_max: z.ZodOptional<z.ZodNumber>;
@@ -515,13 +519,14 @@ export declare const Catalog: z.ZodArray<z.ZodObject<{
     idea_fit_tags: string[];
     hack_difficulty: number;
     brick_risk: number;
-    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred";
+    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred" | "vendor-docs";
     last_verified: string;
     firmware_links: string[];
     community_size_bucket: "tiny" | "small" | "active" | "thriving";
     notes: string;
     est_used_price_usd_min?: number | undefined;
     est_used_price_usd_max?: number | undefined;
+    buy_url?: string | undefined;
     image_url?: string | undefined;
     est_setup_hours_min?: number | undefined;
     est_setup_hours_max?: number | undefined;
@@ -555,13 +560,14 @@ export declare const Catalog: z.ZodArray<z.ZodObject<{
     idea_fit_tags: string[];
     hack_difficulty: number;
     brick_risk: number;
-    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred";
+    brick_provenance: "founder-verified" | "community-reported" | "llm-inferred" | "vendor-docs";
     last_verified: string;
     community_size_bucket: "tiny" | "small" | "active" | "thriving";
     notes: string;
     firmware_links?: string[] | undefined;
     est_used_price_usd_min?: number | undefined;
     est_used_price_usd_max?: number | undefined;
+    buy_url?: string | undefined;
     image_url?: string | undefined;
     est_setup_hours_min?: number | undefined;
     est_setup_hours_max?: number | undefined;

package/dist/catalog/schema.js

@@ -16,6 +16,7 @@ export const Provenance = z.enum([
     "founder-verified",
     "community-reported",
     "llm-inferred",
+    "vendor-docs",
 ]);
 export const CommunitySize = z.enum(["tiny", "small", "active", "thriving"]);
 const UsbFace = z.enum(["front", "back", "top", "bottom", "left", "right"]);
@@ -73,6 +74,7 @@ export const DeviceEntry = z.object({
     notes: z.string().max(500, "notes capped at 500 chars to discourage dumping"),
     est_used_price_usd_min: z.number().int().nonnegative().optional(),
     est_used_price_usd_max: z.number().int().nonnegative().optional(),
+    buy_url: z.string().url().optional(),
     image_url: z.string().url().optional(),
     est_setup_hours_min: z.number().nonnegative().optional(),
     est_setup_hours_max: z.number().nonnegative().optional(),

package/dist/catalog/schema.js.map

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

package/dist/core/assess.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { AgentPlatform, CoreContext, DeviceEntry, DeviceLinks, Platform, Printable } from "./types.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;
+        build_page_url: string;
+        agent_platforms: AgentPlatform[];
+        physical: DeviceEntry["physical"] | null;
+        printables: Printable[];
+        next_steps: string[];
+    };
+    message?: string;
+}
+export declare function assessHackability(input: AssessInput, ctx: CoreContext): AssessOutput;
+export declare function agentPlatformsFor(deviceId: string, platforms: Platform[]): AgentPlatform[];

package/dist/core/assess.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+import { buildUrls } from "../build-plan/index.js";
+import { buildLinks } from "./links.js";
+import { applyBrickRiskSafety } from "./safety.js";
+export const assessHackabilityInput = z.object({
+    device_name: z.string().min(1).max(200),
+});
+function norm(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, "");
+}
+export function assessHackability(input, ctx) {
+    const target = norm(input.device_name);
+    let match = ctx.catalog.find((d) => d.id === input.device_name);
+    if (!match)
+        match = ctx.catalog.find((d) => norm(d.name) === target);
+    if (!match && target.length > 0) {
+        const candidates = ctx.catalog.filter((d) => norm(d.name).includes(target));
+        if (candidates.length === 1) {
+            match = candidates[0];
+        }
+        else if (candidates.length > 1) {
+            const sorted = [...candidates].sort((a, b) => {
+                const la = norm(a.name).length;
+                const lb = norm(b.name).length;
+                if (la !== lb)
+                    return la - lb;
+                if (a.name !== b.name)
+                    return a.name.localeCompare(b.name);
+                return a.id.localeCompare(b.id);
+            });
+            match = sorted[0];
+        }
+    }
+    if (!match) {
+        return {
+            found: false,
+            message: `"${input.device_name}" is not in the catalog. Cannot assess hackability without verification. Try a more specific name, or check the firmware links section of similar devices.`,
+        };
+    }
+    const safety = applyBrickRiskSafety(match);
+    const links = buildLinks(match);
+    const agentPlatforms = agentPlatformsFor(match.id, ctx.platforms);
+    const hackable = match.firmware_links.length > 0 || match.hack_difficulty <= 4;
+    const urls = buildUrls(match.id, ctx.siteUrl, agentPlatforms.length > 0);
+    const nextSteps = agentPlatforms.length > 0
+        ? [
+            `Start a build at ${urls.build_page} to save the parts list, checklist and agent brief to My builds.`,
+        ]
+        : [];
+    return {
+        found: true,
+        device: {
+            id: match.id,
+            name: match.name,
+            category: match.category,
+            hackable,
+            hack_difficulty: match.hack_difficulty,
+            brick_risk: safety.brick_risk,
+            brick_risk_label: safety.brick_risk_label,
+            brick_risk_disclaimer: safety.brick_risk_disclaimer,
+            firmware_links: match.firmware_links,
+            community_size: match.community_size_bucket,
+            last_verified: match.last_verified,
+            notes: match.notes,
+            links,
+            build_page_url: urls.build_page,
+            agent_platforms: agentPlatforms,
+            physical: match.physical ?? null,
+            printables: ctx.printablesFor(match, ctx.siteUrl),
+            next_steps: nextSteps,
+        },
+    };
+}
+export function agentPlatformsFor(deviceId, platforms) {
+    const matches = [];
+    for (const platform of platforms) {
+        const tierLabels = new Map(platform.tiers.map((tier) => [tier.id, tier.label]));
+        for (const board of platform.boards) {
+            if (board.device_id !== deviceId)
+                continue;
+            matches.push(toAgentPlatform(platform, board, tierLabels));
+        }
+    }
+    return matches;
+}
+function toAgentPlatform(platform, board, tierLabels) {
+    return {
+        platform_id: platform.id,
+        platform_name: platform.name,
+        support: board.support,
+        tier: board.tier,
+        tier_label: tierLabels.get(board.tier) ?? board.tier,
+        kind: board.kind,
+        build: board.build,
+        ...(board.eol ? { eol: board.eol } : {}),
+        features: board.features,
+        note: board.note,
+    };
+}
+//# sourceMappingURL=assess.js.map

package/dist/core/assess.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export declare function formatInputError(toolName: string, zodError: z.ZodError): string;

package/dist/core/errors.js

@@ -0,0 +1,70 @@
+import { NEED_VALUES } from "./types.js";
+const FIELD_LABELS = {
+    idea: "`idea`",
+    limit: "`limit`",
+    needs: "`needs`",
+    platform: "`platform`",
+    budget_usd: "`budget_usd`",
+    owned_device_ids: "`owned_device_ids`",
+    device_id: "`device_id`",
+    device_name: "`device_name`",
+    size: "`size`",
+};
+export function formatInputError(toolName, zodError) {
+    return zodError.issues
+        .map((issue) => formatIssue(issue))
+        .join(" ");
+}
+function formatIssue(issue) {
+    const path = issue.path.map(String);
+    const field = fieldLabel(path);
+    if (issue.code === "invalid_enum_value") {
+        const options = issue.options.map(String);
+        return `${field} must be one of: ${options.join(", ")} (got ${JSON.stringify(issue.received)}).`;
+    }
+    if (issue.code === "too_small") {
+        if (issue.type === "string") {
+            return `${field} must be at least ${issue.minimum} characters.`;
+        }
+        if (issue.type === "number") {
+            return `${field} must be at least ${issue.minimum}.`;
+        }
+        if (issue.type === "array") {
+            return `${field} must include at least ${issue.minimum} item${issue.minimum === 1 ? "" : "s"}.`;
+        }
+    }
+    if (issue.code === "too_big") {
+        if (issue.type === "string") {
+            return `${field} must be at most ${issue.maximum} characters.`;
+        }
+        if (issue.type === "number") {
+            const got = typeof issue.path.at(-1) === "number" ? "" : "";
+            return `${field} must be at most ${issue.maximum}${got}.`;
+        }
+        if (issue.type === "array") {
+            return `${field} must include at most ${issue.maximum} items.`;
+        }
+    }
+    if (issue.code === "invalid_type") {
+        return `${field} must be ${issue.expected}.`;
+    }
+    if (issue.code === "custom") {
+        return `${field} ${issue.message}.`;
+    }
+    if (path[0] === "needs") {
+        return `${field} must be one of: ${NEED_VALUES.join(", ")}.`;
+    }
+    return `${field} is invalid: ${issue.message}.`;
+}
+function fieldLabel(path) {
+    if (path.length === 0)
+        return "input";
+    const [first, ...rest] = path;
+    if (!first)
+        return "input";
+    const base = FIELD_LABELS[first] ?? `\`${first}\``;
+    if (rest.length === 0)
+        return base;
+    return `\`${[first, ...rest].join(".").replace(/\.(\d+)/g, "[$1]")}\``;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

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

package/dist/core/links.d.ts

@@ -0,0 +1,3 @@
+import type { DeviceEntry, DeviceLinks } from "./types.js";
+export declare function buildEbayQuery(device: DeviceEntry): string;
+export declare function buildLinks(device: DeviceEntry): DeviceLinks;

package/dist/core/links.js

@@ -0,0 +1,19 @@
+function ebayCondition(brickRisk) {
+    if (brickRisk === null)
+        return "used";
+    return brickRisk >= 4 ? "working" : "used";
+}
+export function buildEbayQuery(device) {
+    const cond = ebayCondition(device.brick_risk);
+    return `${device.name} ${cond}`;
+}
+export function buildLinks(device) {
+    const ebayQuery = buildEbayQuery(device);
+    return {
+        ebay_search_url: `https://www.ebay.com/sch/i.html?_nkw=${encodeURIComponent(ebayQuery)}&_sop=15`,
+        hackaday_search_url: `https://hackaday.com/?s=${encodeURIComponent(device.name)}`,
+        reddit_search_url: `https://www.reddit.com/search/?q=${encodeURIComponent(`${device.name} hack`)}&sort=new`,
+        google_search_url: `https://www.google.com/search?q=${encodeURIComponent(`${device.name} custom firmware OR hack OR mod`)}`,
+    };
+}
+//# sourceMappingURL=links.js.map

package/dist/core/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/core/links.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAC,SAAwB;IAC7C,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO;QACL,eAAe,EAAE,wCAAwC,kBAAkB,CAAC,SAAS,CAAC,UAAU;QAChG,mBAAmB,EAAE,2BAA2B,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACjF,iBAAiB,EAAE,oCAAoC,kBAAkB,CAAC,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW;QAC3G,iBAAiB,EAAE,mCAAmC,kBAAkB,CAAC,GAAG,MAAM,CAAC,IAAI,iCAAiC,CAAC,EAAE;KAC5H,CAAC;AACJ,CAAC"}

package/dist/core/plan-gadget.d.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { NEED_VALUES, type CoreContext, type Need, type Printable, type Size } from "./types.js";
+export { NEED_VALUES, type Need, type Size };
+export declare const planGadgetInput: 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;
+}>;
+export type PlanGadgetInput = z.infer<typeof planGadgetInput>;
+export interface PlanGadgetQuestion {
+    id: string;
+    question: string;
+    why: string;
+    options: Array<{
+        label: string;
+        value: string;
+        needs?: Need[];
+        budget_usd?: number;
+        size?: Size;
+    }>;
+}
+export interface PlanGadgetOutput {
+    inferred_needs: Need[];
+    inferred_preferences: InferredPreference[];
+    fit: "all" | "partial" | "none";
+    notes: string[];
+    warnings: string[];
+    questions: PlanGadgetQuestion[];
+    picks: Array<{
+        device_id: string;
+        name: string;
+        platform_id: string;
+        platform_name: string;
+        support: "official" | "possible";
+        tier: string;
+        tier_label: string;
+        score: number;
+        why: string;
+        gaps: string[];
+        needs_met: Need[];
+        within_budget: boolean | null;
+        price_label: string | null;
+        build_page_url: string;
+        agent_brief_url: string;
+        links: string[];
+        build_command: string;
+        setup_steps: string[];
+        caveats: string[];
+        fabrication: {
+            printables: Printable[];
+            note: string;
+        };
+    }>;
+    terms: Array<{
+        platform_id: string;
+        summary: string;
+        url: string;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+    }>;
+    next_steps: string[];
+}
+type InferredPreference = "cheap";
+export declare function planGadget(input: PlanGadgetInput, ctx: CoreContext): PlanGadgetOutput;
+export declare function inferNeeds(idea: string): Need[];