hackshop-mcp 0.0.3 → 0.0.5

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[];