hackshop-mcp 0.0.3 → 0.0.4

package/dist/platforms/index.js

@@ -0,0 +1,51 @@
+import { loadCatalog } from "../catalog/load.js";
+import { loadPlatforms } from "./load.js";
+let platformCache = null;
+export function setLoadedPlatforms(platforms) {
+    platformCache = platforms;
+}
+export function getLoadedPlatforms() {
+    if (platformCache)
+        return platformCache;
+    const { devices } = loadCatalog();
+    platformCache = loadPlatforms(devices);
+    return platformCache;
+}
+export function agentPlatformsFor(deviceId) {
+    const matches = [];
+    for (const platform of getLoadedPlatforms()) {
+        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;
+}
+export function printablesFor(device) {
+    const base = (process.env.HACKSHOP_SITE_URL ?? "https://www.hackshop.dev").replace(/\/$/, "");
+    return (device.physical?.printables ?? []).map((part) => ({
+        part,
+        title: part === "desk-stand" ? "Printable desk stand" : "Printable enclosure",
+        stl_url: `${base}/cad/${device.id}/${part}.stl`,
+        step_url: `${base}/cad/${device.id}/${part}.step`,
+        svg_url: `${base}/cad/${device.id}/${part}.svg`,
+        fab_url: `${base}/cad/${device.id}/${part}.fab.json`,
+    }));
+}
+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=index.js.map

package/dist/platforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platforms/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAyB1C,IAAI,aAAa,GAAsB,IAAI,CAAC;AAE5C,MAAM,UAAU,kBAAkB,CAAC,SAAqB;IACtD,aAAa,GAAG,SAAS,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;IAClC,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChF,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;gBAAE,SAAS;YAC3C,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,0BAA0B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9F,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI;QACJ,KAAK,EAAE,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,qBAAqB;QAC7E,OAAO,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,IAAI,IAAI,MAAM;QAC/C,QAAQ,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,IAAI,IAAI,OAAO;QACjD,OAAO,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,IAAI,IAAI,MAAM;QAC/C,OAAO,EAAE,GAAG,IAAI,QAAQ,MAAM,CAAC,EAAE,IAAI,IAAI,WAAW;KACrD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CACtB,QAAkB,EAClB,KAAoB,EACpB,UAA+B;IAE/B,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxB,aAAa,EAAE,QAAQ,CAAC,IAAI;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI;QACpD,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/platforms/load.d.ts

@@ -0,0 +1,4 @@
+import type { DeviceEntry } from "../catalog/schema.js";
+import { type Platform } from "./schema.js";
+export declare function loadPlatforms(devices: DeviceEntry[]): Platform[];
+export declare function assertPlatformInvariants(platforms: Platform[], devices: DeviceEntry[]): void;

package/dist/platforms/load.js

@@ -0,0 +1,78 @@
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Platforms } from "./schema.js";
+const repoRoot = () => {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "..", "..");
+};
+export function loadPlatforms(devices) {
+    const platformsPath = join(repoRoot(), "platforms.json");
+    const raw = readFileSync(platformsPath, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`platforms.json is not valid JSON: ${e.message}\n` +
+            `Path: ${platformsPath}`);
+    }
+    const result = Platforms.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`platforms.json failed schema validation:\n${issues}\n` +
+            `Path: ${platformsPath}`);
+    }
+    assertPlatformInvariants(result.data, devices);
+    return result.data;
+}
+export function assertPlatformInvariants(platforms, devices) {
+    const deviceIds = new Set(devices.map((device) => device.id));
+    const taggedAgentDevices = new Set(devices
+        .filter((device) => device.idea_fit_tags.includes("agent-gadget"))
+        .map((device) => device.id));
+    const platformIds = new Set();
+    const platformDevicePairs = new Set();
+    const officialAgentDevices = new Set();
+    const violations = [];
+    for (const platform of platforms) {
+        if (platformIds.has(platform.id)) {
+            violations.push(`  - duplicate platform id "${platform.id}"`);
+        }
+        platformIds.add(platform.id);
+        const tierIds = new Set(platform.tiers.map((tier) => tier.id));
+        for (const board of platform.boards) {
+            const pairKey = `${platform.id}:${board.device_id}`;
+            if (platformDevicePairs.has(pairKey)) {
+                violations.push(`  - duplicate board pair "${board.device_id}" in platform "${platform.id}"`);
+            }
+            platformDevicePairs.add(pairKey);
+            if (!deviceIds.has(board.device_id)) {
+                violations.push(`  - platform "${platform.id}" references unknown device "${board.device_id}"`);
+            }
+            if (!tierIds.has(board.tier)) {
+                violations.push(`  - board "${board.device_id}" uses unknown tier "${board.tier}" in platform "${platform.id}"`);
+            }
+            if (board.support === "official") {
+                officialAgentDevices.add(board.device_id);
+            }
+        }
+    }
+    for (const deviceId of officialAgentDevices) {
+        if (!taggedAgentDevices.has(deviceId)) {
+            violations.push(`  - official platform board "${deviceId}" is missing tag "agent-gadget"`);
+        }
+    }
+    for (const deviceId of taggedAgentDevices) {
+        if (!officialAgentDevices.has(deviceId)) {
+            violations.push(`  - device "${deviceId}" has tag "agent-gadget" but is not an official platform board`);
+        }
+    }
+    if (violations.length > 0) {
+        throw new Error(`Platform invariant violation:\n${violations.join("\n")}\n\n` +
+            `Fix: keep platforms.json, catalog.json and tags.md in sync.`);
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/platforms/load.js.map

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

package/dist/platforms/schema.d.ts

@@ -0,0 +1,383 @@
+import { z } from "zod";
+export declare const PlatformBoard: z.ZodObject<{
+    device_id: z.ZodString;
+    support: z.ZodEnum<["official", "possible"]>;
+    tier: z.ZodString;
+    kind: z.ZodString;
+    build: z.ZodString;
+    eol: z.ZodOptional<z.ZodBoolean>;
+    note: z.ZodString;
+    features: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodBoolean, z.ZodString, z.ZodNumber, z.ZodNull]>>;
+}, "strip", z.ZodTypeAny, {
+    note: string;
+    device_id: string;
+    support: "official" | "possible";
+    tier: string;
+    kind: string;
+    build: string;
+    features: Record<string, string | number | boolean | null>;
+    eol?: boolean | undefined;
+}, {
+    note: string;
+    device_id: string;
+    support: "official" | "possible";
+    tier: string;
+    kind: string;
+    build: string;
+    features: Record<string, string | number | boolean | null>;
+    eol?: boolean | undefined;
+}>;
+export declare const Platform: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    vendor: z.ZodString;
+    kind: z.ZodLiteral<"agent-gadget">;
+    launched: z.ZodString;
+    homepage: z.ZodString;
+    sdk_repo: z.ZodString;
+    sdk_path: z.ZodString;
+    docs_url: z.ZodString;
+    license: z.ZodString;
+    summary: z.ZodString;
+    toolchain: z.ZodString;
+    requires: z.ZodArray<z.ZodString, "many">;
+    setup_steps: z.ZodArray<z.ZodString, "many">;
+    agent_quickstart: z.ZodString;
+    commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    extending: z.ZodOptional<z.ZodString>;
+    tiers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        label: string;
+    }, {
+        id: string;
+        description: string;
+        label: string;
+    }>, "many">;
+    caveats: z.ZodArray<z.ZodString, "many">;
+    terms: z.ZodObject<{
+        url: z.ZodString;
+        summary: z.ZodString;
+        personal_noncommercial_only: z.ZodBoolean;
+        max_devices_per_token: z.ZodNumber;
+        selling_allowed: z.ZodBoolean;
+        revocable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    }, {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    }>;
+    community_url: z.ZodString;
+    boards: z.ZodArray<z.ZodObject<{
+        device_id: z.ZodString;
+        support: z.ZodEnum<["official", "possible"]>;
+        tier: z.ZodString;
+        kind: z.ZodString;
+        build: z.ZodString;
+        eol: z.ZodOptional<z.ZodBoolean>;
+        note: z.ZodString;
+        features: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodBoolean, z.ZodString, z.ZodNumber, z.ZodNull]>>;
+    }, "strip", z.ZodTypeAny, {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }, {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }>, "many">;
+    sources: z.ZodArray<z.ZodString, "many">;
+    last_verified: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    last_verified: string;
+    kind: "agent-gadget";
+    vendor: string;
+    launched: string;
+    homepage: string;
+    sdk_repo: string;
+    sdk_path: string;
+    docs_url: string;
+    license: string;
+    summary: string;
+    toolchain: string;
+    requires: string[];
+    setup_steps: string[];
+    agent_quickstart: string;
+    tiers: {
+        id: string;
+        description: string;
+        label: string;
+    }[];
+    caveats: string[];
+    terms: {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    };
+    community_url: string;
+    boards: {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }[];
+    sources: string[];
+    commands?: string[] | undefined;
+    extending?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    last_verified: string;
+    kind: "agent-gadget";
+    vendor: string;
+    launched: string;
+    homepage: string;
+    sdk_repo: string;
+    sdk_path: string;
+    docs_url: string;
+    license: string;
+    summary: string;
+    toolchain: string;
+    requires: string[];
+    setup_steps: string[];
+    agent_quickstart: string;
+    tiers: {
+        id: string;
+        description: string;
+        label: string;
+    }[];
+    caveats: string[];
+    terms: {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    };
+    community_url: string;
+    boards: {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }[];
+    sources: string[];
+    commands?: string[] | undefined;
+    extending?: string | undefined;
+}>;
+export declare const Platforms: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    vendor: z.ZodString;
+    kind: z.ZodLiteral<"agent-gadget">;
+    launched: z.ZodString;
+    homepage: z.ZodString;
+    sdk_repo: z.ZodString;
+    sdk_path: z.ZodString;
+    docs_url: z.ZodString;
+    license: z.ZodString;
+    summary: z.ZodString;
+    toolchain: z.ZodString;
+    requires: z.ZodArray<z.ZodString, "many">;
+    setup_steps: z.ZodArray<z.ZodString, "many">;
+    agent_quickstart: z.ZodString;
+    commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    extending: z.ZodOptional<z.ZodString>;
+    tiers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        label: string;
+    }, {
+        id: string;
+        description: string;
+        label: string;
+    }>, "many">;
+    caveats: z.ZodArray<z.ZodString, "many">;
+    terms: z.ZodObject<{
+        url: z.ZodString;
+        summary: z.ZodString;
+        personal_noncommercial_only: z.ZodBoolean;
+        max_devices_per_token: z.ZodNumber;
+        selling_allowed: z.ZodBoolean;
+        revocable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    }, {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    }>;
+    community_url: z.ZodString;
+    boards: z.ZodArray<z.ZodObject<{
+        device_id: z.ZodString;
+        support: z.ZodEnum<["official", "possible"]>;
+        tier: z.ZodString;
+        kind: z.ZodString;
+        build: z.ZodString;
+        eol: z.ZodOptional<z.ZodBoolean>;
+        note: z.ZodString;
+        features: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodBoolean, z.ZodString, z.ZodNumber, z.ZodNull]>>;
+    }, "strip", z.ZodTypeAny, {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }, {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }>, "many">;
+    sources: z.ZodArray<z.ZodString, "many">;
+    last_verified: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    last_verified: string;
+    kind: "agent-gadget";
+    vendor: string;
+    launched: string;
+    homepage: string;
+    sdk_repo: string;
+    sdk_path: string;
+    docs_url: string;
+    license: string;
+    summary: string;
+    toolchain: string;
+    requires: string[];
+    setup_steps: string[];
+    agent_quickstart: string;
+    tiers: {
+        id: string;
+        description: string;
+        label: string;
+    }[];
+    caveats: string[];
+    terms: {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    };
+    community_url: string;
+    boards: {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }[];
+    sources: string[];
+    commands?: string[] | undefined;
+    extending?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    last_verified: string;
+    kind: "agent-gadget";
+    vendor: string;
+    launched: string;
+    homepage: string;
+    sdk_repo: string;
+    sdk_path: string;
+    docs_url: string;
+    license: string;
+    summary: string;
+    toolchain: string;
+    requires: string[];
+    setup_steps: string[];
+    agent_quickstart: string;
+    tiers: {
+        id: string;
+        description: string;
+        label: string;
+    }[];
+    caveats: string[];
+    terms: {
+        summary: string;
+        url: string;
+        personal_noncommercial_only: boolean;
+        max_devices_per_token: number;
+        selling_allowed: boolean;
+        revocable: boolean;
+    };
+    community_url: string;
+    boards: {
+        note: string;
+        device_id: string;
+        support: "official" | "possible";
+        tier: string;
+        kind: string;
+        build: string;
+        features: Record<string, string | number | boolean | null>;
+        eol?: boolean | undefined;
+    }[];
+    sources: string[];
+    commands?: string[] | undefined;
+    extending?: string | undefined;
+}>, "many">;
+export type Platform = z.infer<typeof Platform>;
+export type PlatformBoard = z.infer<typeof PlatformBoard>;

package/dist/platforms/schema.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+const KebabId = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "id must be kebab-case");
+const IsoDate = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "date must be YYYY-MM-DD");
+const FeatureValue = z.union([z.boolean(), z.string(), z.number(), z.null()]);
+export const PlatformBoard = z.object({
+    device_id: z.string().min(1),
+    support: z.enum(["official", "possible"]),
+    tier: z.string().min(1),
+    kind: z.string().min(1),
+    build: z.string().min(1),
+    eol: z.boolean().optional(),
+    note: z.string().min(1),
+    features: z.record(FeatureValue),
+});
+export const Platform = z.object({
+    id: KebabId,
+    name: z.string().min(1),
+    vendor: z.string().min(1),
+    kind: z.literal("agent-gadget"),
+    launched: IsoDate,
+    homepage: z.string().url(),
+    sdk_repo: z.string().url(),
+    sdk_path: z.string().min(1),
+    docs_url: z.string().url(),
+    license: z.string().min(1),
+    summary: z.string().min(1),
+    toolchain: z.string().min(1),
+    requires: z.array(z.string().min(1)),
+    setup_steps: z.array(z.string().min(1)),
+    agent_quickstart: z.string().min(1),
+    commands: z.array(z.string().min(1)).optional(),
+    extending: z.string().optional(),
+    tiers: z.array(z.object({
+        id: z.string().min(1),
+        label: z.string().min(1),
+        description: z.string().min(1),
+    })).min(1),
+    caveats: z.array(z.string().min(1)),
+    terms: z.object({
+        url: z.string().url(),
+        summary: z.string().min(1),
+        personal_noncommercial_only: z.boolean(),
+        max_devices_per_token: z.number().int().positive(),
+        selling_allowed: z.boolean(),
+        revocable: z.boolean(),
+    }),
+    community_url: z.string().url(),
+    boards: z.array(PlatformBoard).min(1),
+    sources: z.array(z.string().url()),
+    last_verified: IsoDate,
+});
+export const Platforms = z.array(Platform).min(1);
+//# sourceMappingURL=schema.js.map

package/dist/platforms/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/platforms/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,4BAA4B,EAAE,uBAAuB,CAAC,CAAC;AACxF,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;AACnF,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC/B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACV,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,2BAA2B,EAAE,CAAC,CAAC,OAAO,EAAE;QACxC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAClD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;QAC5B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;KACvB,CAAC;IACF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC"}

package/dist/sampling.d.ts

@@ -1,8 +1,12 @@
 import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export interface SamplingDiagnostics {
+    apiFallbackError?: string;
+}
 export declare function sampleJson<T>(opts: {
     server: Server;
     systemPrompt: string;
     userPrompt: string;
     maxTokens?: number;
+    diagnostics?: SamplingDiagnostics;
 }): Promise<T | null>;
 export declare function probeSamplingSupport(server: Server): Promise<boolean>;

package/dist/sampling.js

@@ -1,21 +1,6 @@
 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 } = opts;
     const tryHostSampling = async () => {
         try {
             const response = await server.createMessage({
@@ -49,13 +34,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,9 +58,17 @@ 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;