haas-mcp 0.2.0

package/dist/tools/cancel_job.js

@@ -0,0 +1,22 @@
+export const cancelJobTool = {
+    name: "cancel_job",
+    description: "Cancel a job. If still pre-flight (DRAFT/STATIC_CHECK/ESTIMATED/ESCROW_HELD/QUEUED), the escrow is fully refunded. If mid-flight (FLASHING/RUNNING), elapsed time is charged and the rest refunded.",
+    inputSchema: {
+        type: "object",
+        required: ["job_id"],
+        properties: {
+            job_id: { type: "string" },
+            reason: { type: "string" },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (!args.job_id)
+            throw new Error("job_id is required");
+        return client.postJson(`/api/jobs/${encodeURIComponent(args.job_id)}/cancel`, {
+            reason: args.reason,
+        });
+    },
+};
+//# sourceMappingURL=cancel_job.js.map

package/dist/tools/cancel_job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel_job.js","sourceRoot":"","sources":["../../src/tools/cancel_job.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qMAAqM;IACvM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAAyD,CAAC;QACvE,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;YAC5E,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/estimate_cost.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const estimateCostTool: ToolDef;
+//# sourceMappingURL=estimate_cost.d.ts.map

package/dist/tools/estimate_cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate_cost.d.ts","sourceRoot":"","sources":["../../src/tools/estimate_cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAS1C,eAAO,MAAM,gBAAgB,EAAE,OA2B9B,CAAC"}

package/dist/tools/estimate_cost.js

@@ -0,0 +1,28 @@
+export const estimateCostTool = {
+    name: "estimate_cost",
+    description: "Compute the cost estimate for a hypothetical job without submitting it. Returns flash + run cost, deposit (sized by reputation tier), and the total escrow that would be reserved.",
+    inputSchema: {
+        type: "object",
+        required: ["firmware_size"],
+        properties: {
+            firmware_size: { type: "number", description: "Size in bytes" },
+            device_id: { type: "string" },
+            profile_key: { type: "string" },
+            runtime_s: { type: "number", description: "Expected runtime in seconds" },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (typeof args.firmware_size !== "number" || args.firmware_size <= 0) {
+            throw new Error("firmware_size (positive number) is required");
+        }
+        return client.postJson("/api/v1/estimate", {
+            firmwareSize: args.firmware_size,
+            deviceId: args.device_id,
+            profileKey: args.profile_key,
+            expectedRuntimeSec: args.runtime_s,
+        });
+    },
+};
+//# sourceMappingURL=estimate_cost.js.map

package/dist/tools/estimate_cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate_cost.js","sourceRoot":"","sources":["../../src/tools/estimate_cost.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,oLAAoL;IACtL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,eAAe,CAAC;QAC3B,UAAU,EAAE;YACV,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YAC/D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SAC1E;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE;YACzC,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,kBAAkB,EAAE,IAAI,CAAC,SAAS;SACnC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/get_balance.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const getBalanceTool: ToolDef;
+//# sourceMappingURL=get_balance.d.ts.map

package/dist/tools/get_balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_balance.d.ts","sourceRoot":"","sources":["../../src/tools/get_balance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,OAY5B,CAAC"}

package/dist/tools/get_balance.js

@@ -0,0 +1,13 @@
+export const getBalanceTool = {
+    name: "get_balance",
+    description: "Fetch the caller's wallet balance: available credits, reserved credits (held by open escrows), reputation tier, and account status.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+    async handler(_args, client) {
+        return client.get("/api/v1/balance");
+    },
+};
+//# sourceMappingURL=get_balance.js.map

package/dist/tools/get_balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_balance.js","sourceRoot":"","sources":["../../src/tools/get_balance.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,qIAAqI;IACvI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM;QACzB,OAAO,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACF,CAAC"}

package/dist/tools/get_job_status.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const getJobStatusTool: ToolDef;
+//# sourceMappingURL=get_job_status.d.ts.map

package/dist/tools/get_job_status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_job_status.d.ts","sourceRoot":"","sources":["../../src/tools/get_job_status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,OAiB9B,CAAC"}

package/dist/tools/get_job_status.js

@@ -0,0 +1,19 @@
+export const getJobStatusTool = {
+    name: "get_job_status",
+    description: "Fetch the current state of a job: status, estimate, actual cost, escrow link, static check result, damage report, settled timestamp. While the job is QUEUED the response also carries queuePosition, its one-based place among the jobs waiting for the same boards (null in every other status). Jobs are taken oldest first as boards free up, so there is no need to poll for the position; read it when you need it.",
+    inputSchema: {
+        type: "object",
+        required: ["job_id"],
+        properties: {
+            job_id: { type: "string" },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (!args.job_id)
+            throw new Error("job_id is required");
+        return client.get(`/api/v1/jobs/${encodeURIComponent(args.job_id)}`);
+    },
+};
+//# sourceMappingURL=get_job_status.js.map

package/dist/tools/get_job_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_job_status.js","sourceRoot":"","sources":["../../src/tools/get_job_status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,2ZAA2Z;IAC7Z,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAAwC,CAAC;QACtD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,GAAG,CAAC,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;CACF,CAAC"}

package/dist/tools/list_devices.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const listDevicesTool: ToolDef;
+//# sourceMappingURL=list_devices.d.ts.map

package/dist/tools/list_devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_devices.d.ts","sourceRoot":"","sources":["../../src/tools/list_devices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,eAAe,EAAE,OAY7B,CAAC"}

package/dist/tools/list_devices.js

@@ -0,0 +1,13 @@
+export const listDevicesTool = {
+    name: "list_devices",
+    description: "List the hardware devices available for flashing. Each entry includes profile key, status, replacement cost, queue depth, current job, agent, and any active lease.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+    async handler(_args, client) {
+        return client.get("/api/v1/devices");
+    },
+};
+//# sourceMappingURL=list_devices.js.map

package/dist/tools/list_devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_devices.js","sourceRoot":"","sources":["../../src/tools/list_devices.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,qKAAqK;IACvK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM;QACzB,OAAO,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACF,CAAC"}

package/dist/tools/purchase_lease.d.ts

@@ -0,0 +1,16 @@
+import type { ToolDef } from "./types.js";
+/**
+ * Book a board for a window. HAAS-211.
+ *
+ * A stub until 2026-09-07 that threw "not yet implemented; lease endpoints
+ * land in Phase E" — months after `POST /api/v1/leases` shipped and the
+ * dashboard began leasing through it. An MCP client asking for a lease was
+ * told the feature did not exist while the web app sold it. This calls the
+ * same route the dashboard's panel calls, with the same three fields.
+ *
+ * The arguments are renamed on the way through, the way `estimate_cost`
+ * renames its own: the tool speaks snake_case to the model and the API takes
+ * camelCase, and the seam is here rather than in every caller.
+ */
+export declare const purchaseLeaseTool: ToolDef;
+//# sourceMappingURL=purchase_lease.d.ts.map

package/dist/tools/purchase_lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase_lease.d.ts","sourceRoot":"","sources":["../../src/tools/purchase_lease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAqC/B,CAAC"}

package/dist/tools/purchase_lease.js

@@ -0,0 +1,50 @@
+/**
+ * Book a board for a window. HAAS-211.
+ *
+ * A stub until 2026-09-07 that threw "not yet implemented; lease endpoints
+ * land in Phase E" — months after `POST /api/v1/leases` shipped and the
+ * dashboard began leasing through it. An MCP client asking for a lease was
+ * told the feature did not exist while the web app sold it. This calls the
+ * same route the dashboard's panel calls, with the same three fields.
+ *
+ * The arguments are renamed on the way through, the way `estimate_cost`
+ * renames its own: the tool speaks snake_case to the model and the API takes
+ * camelCase, and the seam is here rather than in every caller.
+ */
+export const purchaseLeaseTool = {
+    name: "purchase_lease",
+    description: "Book a board exclusively for a number of hours. Jobs you run on it during the window pay no runtime cost. The price falls with the length, up to ten percent off at a day. Refused with a reason when the account may not lease (a reputation tier, or a balance covering the board's replacement cost, qualifies), when the window overlaps a lease already on the board, or when the balance is short. Returns the lease: id, deviceId, startsAt, endsAt, hourCount, costMicroCreds.",
+    inputSchema: {
+        type: "object",
+        required: ["device_id", "hours"],
+        properties: {
+            device_id: { type: "string", description: "The board to book, from list_devices" },
+            hours: { type: "number", description: "Whole hours, at least 1" },
+            starts_at: {
+                type: "string",
+                description: "ISO timestamp for a window starting later; omit to start now",
+            },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (typeof args.device_id !== "string" || args.device_id.length === 0) {
+            throw new Error("device_id (non-empty string) is required");
+        }
+        if (typeof args.hours !== "number" || !Number.isFinite(args.hours) || args.hours <= 0) {
+            throw new Error("hours (positive number) is required");
+        }
+        if (args.starts_at !== undefined && Number.isNaN(new Date(args.starts_at).getTime())) {
+            throw new Error(`starts_at is not a timestamp: ${JSON.stringify(args.starts_at)}`);
+        }
+        const body = {
+            deviceId: args.device_id,
+            hours: args.hours,
+        };
+        if (args.starts_at !== undefined)
+            body.startsAt = args.starts_at;
+        return client.postJson("/api/v1/leases", body);
+    },
+};
+//# sourceMappingURL=purchase_lease.js.map

package/dist/tools/purchase_lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase_lease.js","sourceRoot":"","sources":["../../src/tools/purchase_lease.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,wdAAwd;IAC1d,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;QAChC,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAClF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACjE,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,IAAI,GAA2D;YACnE,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEjE,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/tools/submit_batch.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const submitBatchTool: ToolDef;
+//# sourceMappingURL=submit_batch.d.ts.map

package/dist/tools/submit_batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_batch.d.ts","sourceRoot":"","sources":["../../src/tools/submit_batch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAc1C,eAAO,MAAM,eAAe,EAAE,OAyD7B,CAAC"}

package/dist/tools/submit_batch.js

@@ -0,0 +1,58 @@
+export const submitBatchTool = {
+    name: "submit_batch",
+    description: "Fan out N firmware variants across the device pool in a single round-trip. Primary tool for parallel iteration. Up to 32 jobs per call. Each job is estimated and escrowed independently; with policy='all_or_nothing' any failure rolls back the entire batch.",
+    inputSchema: {
+        type: "object",
+        required: ["jobs"],
+        properties: {
+            jobs: {
+                type: "array",
+                maxItems: 32,
+                items: {
+                    type: "object",
+                    required: ["firmware_b64"],
+                    properties: {
+                        firmware_b64: { type: "string" },
+                        target: {
+                            type: "object",
+                            properties: {
+                                device_id: { type: "string" },
+                                profile_key: { type: "string" },
+                            },
+                            additionalProperties: false,
+                        },
+                        params: {
+                            type: "object",
+                            properties: {
+                                expected_runtime_s: { type: "number" },
+                            },
+                            additionalProperties: false,
+                        },
+                    },
+                    additionalProperties: false,
+                },
+            },
+            policy: { type: "string", enum: ["best_effort", "all_or_nothing"] },
+            auto_confirm: { type: "boolean" },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (!Array.isArray(args.jobs) || args.jobs.length === 0) {
+            throw new Error("jobs array is required and non-empty");
+        }
+        const body = {
+            jobs: args.jobs.map((j) => ({
+                firmware_b64: j.firmware_b64,
+                device_id: j.target?.device_id,
+                profile_key: j.target?.profile_key,
+                expected_runtime_s: j.params?.expected_runtime_s,
+            })),
+            policy: args.policy ?? "best_effort",
+            auto_confirm: args.auto_confirm ?? false,
+        };
+        return client.postJson("/api/jobs/batch", body);
+    },
+};
+//# sourceMappingURL=submit_batch.js.map

package/dist/tools/submit_batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_batch.js","sourceRoot":"","sources":["../../src/tools/submit_batch.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,iQAAiQ;IACnQ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAE,CAAC,cAAc,CAAC;oBAC1B,UAAU,EAAE;wBACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBAChC,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAChC;4BACD,oBAAoB,EAAE,KAAK;yBAC5B;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BACvC;4BACD,oBAAoB,EAAE,KAAK;yBAC5B;qBACF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;aACF;YACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC,EAAE;YACnE,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAClC;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS;gBAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW;gBAClC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,kBAAkB;aACjD,CAAC,CAAC;YACH,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,aAAa;YACpC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK;SACzC,CAAC;QACF,OAAO,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/tools/submit_job.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const submitJobTool: ToolDef;
+//# sourceMappingURL=submit_job.d.ts.map

package/dist/tools/submit_job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_job.d.ts","sourceRoot":"","sources":["../../src/tools/submit_job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C,eAAO,MAAM,aAAa,EAAE,OA+C3B,CAAC"}

package/dist/tools/submit_job.js

@@ -0,0 +1,49 @@
+export const submitJobTool = {
+    name: "submit_job",
+    description: "Submit a single firmware (base64-encoded .bin) to be flashed and run on a device. Returns job id, status, and the cost estimate. With auto_confirm=true, the job goes straight to QUEUED and the response carries queuePosition, its one-based place among the jobs waiting for the same boards; otherwise it lands in ESCROW_HELD and the caller must call confirm.",
+    inputSchema: {
+        type: "object",
+        required: ["firmware_b64"],
+        properties: {
+            firmware_b64: { type: "string", description: "Base64-encoded firmware blob (.bin)" },
+            target: {
+                type: "object",
+                properties: {
+                    device_id: { type: "string" },
+                    profile_key: { type: "string" },
+                },
+                additionalProperties: false,
+            },
+            params: {
+                type: "object",
+                properties: {
+                    auto_confirm: { type: "boolean" },
+                    expected_runtime_s: {
+                        type: "number",
+                        description: "The run seconds you book. The job's booked window is this plus the profile's flash allowance, and the escrow is reserved against it (HAAS-20).",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        const buf = Buffer.from(args.firmware_b64, "base64");
+        if (buf.length === 0)
+            throw new Error("firmware_b64 decoded to empty buffer");
+        const fields = {};
+        if (args.target?.device_id)
+            fields.device_id = args.target.device_id;
+        if (args.target?.profile_key)
+            fields.profile_key = args.target.profile_key;
+        if (args.params?.auto_confirm)
+            fields.auto_confirm = "true";
+        if (args.params?.expected_runtime_s !== undefined) {
+            fields.expected_runtime_s = String(args.params.expected_runtime_s);
+        }
+        return client.postMultipartFirmware("/api/jobs", buf, fields);
+    },
+};
+//# sourceMappingURL=submit_job.js.map

package/dist/tools/submit_job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_job.js","sourceRoot":"","sources":["../../src/tools/submit_job.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,sWAAsW;IACxW,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,UAAU,EAAE;YACV,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YACpF,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAChC;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACjC,kBAAkB,EAAE;wBAClB,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,gJAAgJ;qBACnJ;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACrD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAE9E,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY;YAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,EAAE,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC,qBAAqB,CAAC,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;CACF,CAAC"}

package/dist/tools/submit_source.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const submitSourceTool: ToolDef;
+//# sourceMappingURL=submit_source.d.ts.map

package/dist/tools/submit_source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_source.d.ts","sourceRoot":"","sources":["../../src/tools/submit_source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C,eAAO,MAAM,gBAAgB,EAAE,OAuD9B,CAAC"}

package/dist/tools/submit_source.js

@@ -0,0 +1,55 @@
+export const submitSourceTool = {
+    name: "submit_source",
+    description: "Submit C source to be compiled on the bench into a FreeRTOS app for the board and then flashed (HAAS-230). This is the default way to run a program: you write `void app_main(void) { ... }` with FreeRTOS tasks and the whole of ESP-IDF available, and the bench builds it for the chosen chip — no local toolchain. Returns job id, status and the cost estimate, exactly like submit_job; with auto_confirm=true it goes straight to QUEUED. Use submit_job instead only when you already have a prebuilt .bin.",
+    inputSchema: {
+        type: "object",
+        required: ["source"],
+        properties: {
+            source: {
+                type: "string",
+                description: "C source for one ESP-IDF app. Must define `void app_main(void)`, the entry point ESP-IDF calls. Everything else — the CMake, the partition table, the console — is the bench's; you write the program. The default template (two FreeRTOS tasks and a queue) is a good starting point.",
+            },
+            target: {
+                type: "object",
+                properties: {
+                    device_id: { type: "string" },
+                    profile_key: {
+                        type: "string",
+                        description: "e.g. esp32c3-mini-v1. The bench compiles for this board's chip.",
+                    },
+                },
+                additionalProperties: false,
+            },
+            params: {
+                type: "object",
+                properties: {
+                    auto_confirm: { type: "boolean" },
+                    expected_runtime_s: {
+                        type: "number",
+                        description: "The run seconds you book. The booked window is this plus the profile's flash allowance; the compile happens before the window opens (HAAS-20, HAAS-230).",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (typeof args.source !== "string" || args.source.trim().length === 0) {
+            throw new Error("source is required and must be non-empty C");
+        }
+        const fields = {};
+        if (args.target?.device_id)
+            fields.device_id = args.target.device_id;
+        if (args.target?.profile_key)
+            fields.profile_key = args.target.profile_key;
+        if (args.params?.auto_confirm)
+            fields.auto_confirm = "true";
+        if (args.params?.expected_runtime_s !== undefined) {
+            fields.expected_runtime_s = String(args.params.expected_runtime_s);
+        }
+        return client.postMultipartSource("/api/jobs", args.source, fields);
+    },
+};
+//# sourceMappingURL=submit_source.js.map

package/dist/tools/submit_source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit_source.js","sourceRoot":"","sources":["../../src/tools/submit_source.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,qfAAqf;IACvf,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wRAAwR;aAC3R;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7B,WAAW,EAAE;wBACX,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iEAAiE;qBAC/E;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBACjC,kBAAkB,EAAE;wBAClB,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,0JAA0J;qBAC7J;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY;YAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,EAAE,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;CACF,CAAC"}

package/dist/tools/tail_serial.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./types.js";
+export declare const tailSerialTool: ToolDef;
+//# sourceMappingURL=tail_serial.d.ts.map

package/dist/tools/tail_serial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail_serial.d.ts","sourceRoot":"","sources":["../../src/tools/tail_serial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQ1C,eAAO,MAAM,cAAc,EAAE,OAwB5B,CAAC"}

package/dist/tools/tail_serial.js

@@ -0,0 +1,26 @@
+export const tailSerialTool = {
+    name: "tail_serial",
+    description: "Long-poll the SSE feed for a job and return up to max_chunks of serial output. Returns once chunks arrive or after a 25-second timeout. Use repeatedly to follow a live job.",
+    inputSchema: {
+        type: "object",
+        required: ["job_id"],
+        properties: {
+            job_id: { type: "string" },
+            since_seq: { type: "number" },
+            max_chunks: { type: "number" },
+        },
+        additionalProperties: false,
+    },
+    async handler(rawArgs, client) {
+        const args = rawArgs;
+        if (!args.job_id)
+            throw new Error("job_id is required");
+        const max = Math.min(Math.max(1, args.max_chunks ?? 50), 200);
+        return client.streamFeed(`/api/v1/jobs/${encodeURIComponent(args.job_id)}/feed`, {
+            timeoutMs: 25_000,
+            maxChunks: max,
+            sinceSeq: args.since_seq,
+        });
+    },
+};
+//# sourceMappingURL=tail_serial.js.map

package/dist/tools/tail_serial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail_serial.js","sourceRoot":"","sources":["../../src/tools/tail_serial.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,8KAA8K;IAChL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC/B;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;QAC3B,MAAM,IAAI,GAAG,OAA0B,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,UAAU,CAAC,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC/E,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,9 @@
+import type { HaasClient } from "../client.js";
+export interface ToolDef {
+    name: string;
+    description: string;
+    /** JSON Schema (subset) describing the tool's input. */
+    inputSchema: Record<string, unknown>;
+    handler: (args: Record<string, unknown>, client: HaasClient) => Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB"}

package/dist/tools/types.js

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

package/dist/tools/types.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "haas-mcp",
+  "version": "0.2.0",
+  "description": "MCP server (stdio) for haas-lab — flash firmware to real boards in the cloud from any AI client.",
+  "homepage": "https://haas-lab.com/docs",
+  "type": "module",
+  "bin": {
+    "haas-mcp": "dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run type-check && npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "tsx": "^4.19.2",
+    "typescript": "^5",
+    "vitest": "^4.1.5"
+  }
+}