haas-mcp 0.2.0

package/README.md

@@ -0,0 +1,98 @@
+# haas-mcp
+
+stdio MCP server for [haas-lab](https://haas-lab.com) — gives any AI client
+(Claude Desktop, Cursor, OpenAI Codex CLI, etc.) native tools to compile and
+flash firmware on real ESP32 boards in the cloud.
+
+## Install
+
+One line, once the package is on npm. It opens your browser at the token page
+(sign in if asked); you click **Connect** there, and the token it mints
+arrives at the command by itself — nothing to paste. The command proves it
+against the API, then connects every AI client it finds on the machine: Claude
+Code and Codex through their own CLIs, Claude Desktop and Cursor by merging
+their server lists.
+
+```bash
+npx -y haas-mcp setup
+```
+
+The terminal prints a four-character check and the page shows the same one;
+if they differ, or you did not start the command yourself, close the tab. The
+token it mints has the `read` and `submit` scopes only.
+
+`setup --paste` asks for the token at the prompt instead, and is what the
+command falls back to on a Node older than 22, which has no WebSocket.
+
+By hand instead, one line per client:
+
+```bash
+# Claude Code
+claude mcp add haas-lab -e HAAS_PAT=pat_... -- npx -y haas-mcp
+
+# OpenAI Codex CLI
+codex mcp add haas-lab --env HAAS_PAT=pat_... -- npx -y haas-mcp
+```
+
+Claude Desktop, Cursor and every other client that takes a JSON server list
+get the same thing in that form — `claude_desktop_config.json` under
+`~/Library/Application Support/Claude/` on a Mac or `%APPDATA%\Claude\` on
+Windows, `.cursor/mcp.json` for Cursor:
+
+```json
+{
+  "mcpServers": {
+    "haas-lab": {
+      "command": "npx",
+      "args": ["-y", "haas-mcp"],
+      "env": { "HAAS_PAT": "pat_..." }
+    }
+  }
+}
+```
+
+Prove the token before restarting the client:
+
+```bash
+HAAS_PAT=pat_... npx -y haas-mcp --check
+# haas-mcp: connected to https://haas-lab.com — 1200 credits available
+```
+
+Then ask the client: *"List the haas-lab devices."* — it will call
+`list_devices`.
+
+## Configure
+
+Two environment variables (or `--token` / `--base-url` flags):
+
+| Var | What | Default |
+|---|---|---|
+| `HAAS_PAT` | Personal Access Token from your haas-lab dashboard | required |
+| `HAAS_BASE_URL` | API root | `https://haas-lab.com` |
+
+A developer running the web app locally sets `HAAS_BASE_URL=http://localhost:3000`.
+`--help` prints the install lines above.
+
+## Tools
+
+| Tool | What |
+|---|---|
+| `list_devices` | List rentable hardware |
+| `submit_source` | Compile C source into a FreeRTOS app on the bench and flash it — the default way to run a program, no local toolchain |
+| `submit_job` | Safety-check and flash one prebuilt application image (base64; simulation recorded as skipped) |
+| `submit_batch` | Fan out N variants in parallel (the differentiator) |
+| `get_job_status` | Fetch a job's state, cost, escrow |
+| `tail_serial` | Long-poll the SSE feed for serial output |
+| `get_balance` | Check wallet credits + reputation |
+| `estimate_cost` | Price a hypothetical job |
+| `cancel_job` | Cancel + refund |
+| `purchase_lease` | Book a board for a number of hours; runs on it during the window pay no runtime cost |
+
+## Develop
+
+```bash
+cd mcp
+npm install
+npm run dev          # tsx, no build step
+HAAS_PAT=pat_... npm run dev
+```

package/dist/check.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Prove a token against the API before an AI client is restarted around it
+ * (HAAS-142).
+ *
+ * One read-scoped call, the cheapest the API has — the wallet balance — so a
+ * `--check` costs the same as one tool call and says the three things a
+ * misconfigured install cannot otherwise tell apart: the base URL is right,
+ * the token is accepted, and the account behind it is the expected one.
+ */
+import type { HaasClient } from "./client.js";
+export type CheckResult = {
+    ok: true;
+    baseUrl: string;
+    credits: number | null;
+} | {
+    ok: false;
+    baseUrl: string;
+    reason: string;
+};
+/** Only `get` is needed, which is also what lets a test hand in a double that throws. */
+export declare function checkConnection(client: Pick<HaasClient, "get">, baseUrl: string): Promise<CheckResult>;
+export declare function describeCheck(result: CheckResult): string;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD,yFAAyF;AACzF,wBAAsB,eAAe,CACnC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAOtB;AASD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMzD"}

package/dist/check.js

@@ -0,0 +1,34 @@
+/**
+ * Prove a token against the API before an AI client is restarted around it
+ * (HAAS-142).
+ *
+ * One read-scoped call, the cheapest the API has — the wallet balance — so a
+ * `--check` costs the same as one tool call and says the three things a
+ * misconfigured install cannot otherwise tell apart: the base URL is right,
+ * the token is accepted, and the account behind it is the expected one.
+ */
+/** Only `get` is needed, which is also what lets a test hand in a double that throws. */
+export async function checkConnection(client, baseUrl) {
+    try {
+        const body = await client.get("/api/v1/balance");
+        return { ok: true, baseUrl, credits: creditsOf(body) };
+    }
+    catch (error) {
+        return { ok: false, baseUrl, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** The balance, when the API's answer carries one; the check does not depend on it. */
+function creditsOf(body) {
+    if (typeof body !== "object" || body === null)
+        return null;
+    const { availableCredits } = body;
+    return typeof availableCredits === "number" ? availableCredits : null;
+}
+export function describeCheck(result) {
+    if (result.ok) {
+        const balance = result.credits === null ? "" : ` — ${result.credits} credits available`;
+        return `haas-mcp: connected to ${result.baseUrl}${balance}`;
+    }
+    return `haas-mcp: could not reach ${result.baseUrl} with this token: ${result.reason}`;
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA+B,EAC/B,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAChG,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAsC,CAAC;IACpE,OAAO,OAAO,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB;IAC/C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,oBAAoB,CAAC;QACxF,OAAO,0BAA0B,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,6BAA6B,MAAM,CAAC,OAAO,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC;AACzF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+import { spawn, spawnSync } from "node:child_process";
+import { createHash, randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, hostname } from "node:os";
+import { delimiter, dirname, join } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { checkConnection, describeCheck } from "./check.js";
+import { HaasClient } from "./client.js";
+import { readConfig, USAGE } from "./config.js";
+import { CONNECT_TIMEOUT_MS, connectPageUrl, newSetupCode, pairingCheck, receiveToken, registerUrl, setupStreamUrl, } from "./connect.js";
+import { startMcpServer } from "./server.js";
+import { browserCommand, describeOutcomes, planSetup, runSetup, tokenPageUrl, } from "./setup.js";
+async function main() {
+    const config = readConfig(process.argv.slice(2), process.env);
+    if (config.help) {
+        process.stdout.write(USAGE);
+        return;
+    }
+    if (config.setup) {
+        process.exit(await setup(config.pat, config.baseUrl, config.paste));
+    }
+    if (!config.pat) {
+        process.stderr.write("haas-mcp: HAAS_PAT environment variable (or --token flag) is required.\n" +
+            `Run \`npx -y haas-mcp setup\` once, or get a token from ${config.baseUrl}/dashboard/tokens\n`);
+        process.exit(1);
+    }
+    const client = new HaasClient(config.baseUrl, config.pat);
+    if (config.check) {
+        const result = await checkConnection(client, config.baseUrl);
+        process.stderr.write(`${describeCheck(result)}\n`);
+        process.exit(result.ok ? 0 : 1);
+    }
+    await startMcpServer(client);
+}
+/**
+ * The wizard. No question when no token was given: the token arrives over a
+ * socket once the person clicks Connect on the page this opens (HAAS-144),
+ * and the paste prompt remains only where that path cannot be used. Then the
+ * plan is run against this machine. Deliberately no second question: which
+ * clients to connect is detected, not asked, because a person who has to
+ * answer that is a person who could have edited the config themselves.
+ */
+async function setup(given, baseUrl, paste) {
+    let token = given;
+    if (!token && !paste)
+        token = await receiveOverSocket(baseUrl);
+    if (!token) {
+        // The browser is opened at the token page; signed out, the site's
+        // middleware takes the person through sign-in and back to it. The URL is
+        // printed as well, for a machine with no browser or where the launch
+        // fails silently — the launch is best-effort and never blocks the prompt.
+        const url = tokenPageUrl(baseUrl);
+        openBrowser(url);
+        process.stdout.write(`haas-mcp setup — opening ${url}\n` +
+            "Sign in if asked, mint a token with the read and submit scopes, then\n");
+        const prompt = createInterface({ input: process.stdin, output: process.stdout });
+        token = (await prompt.question("paste it here: ")).trim();
+        prompt.close();
+        if (!token) {
+            process.stderr.write("haas-mcp: no token given\n");
+            return 1;
+        }
+    }
+    const proof = await checkConnection(new HaasClient(baseUrl, token), baseUrl);
+    process.stdout.write(`${describeCheck(proof)}\n`);
+    if (!proof.ok)
+        return 1;
+    const actions = planSetup(token, {
+        platform: process.platform,
+        env: process.env,
+        home: homedir(),
+        exists: existsSync,
+        onPath: findOnPath,
+    });
+    const outcomes = runSetup(actions, token, {
+        run: (program, args) => {
+            // A `.cmd` shim on Windows only runs through a shell; elsewhere the
+            // resolved path runs directly.
+            const result = spawnSync(program, args, {
+                encoding: "utf8",
+                shell: process.platform === "win32",
+            });
+            return { ok: result.status === 0, output: `${result.stdout ?? ""}${result.stderr ?? ""}` };
+        },
+        read: (path) => (existsSync(path) ? readFileSync(path, "utf8") : null),
+        write: (path, text) => {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, text, "utf8");
+        },
+    });
+    process.stdout.write(describeOutcomes(outcomes));
+    return outcomes.length > 0 && outcomes.every((o) => o.ok) ? 0 : 1;
+}
+/**
+ * The no-paste path (HAAS-144): a code, a registration, the browser at the
+ * token page with the code, and a socket that receives what the click mints.
+ * Null when it cannot be used here — no WebSocket in this Node, a server that
+ * would not register the code, nobody clicking in time — with the reason
+ * printed, so the paste prompt that follows is a fallback the person can see.
+ */
+async function receiveOverSocket(baseUrl) {
+    // Looked up by name because the global exists only on Node 22 and newer;
+    // the structural type is the part of it this uses.
+    const Socket = globalThis.WebSocket;
+    if (!Socket) {
+        process.stdout.write("haas-mcp setup — this Node has no WebSocket (Node 22 or newer does); falling back to pasting the token.\n");
+        return null;
+    }
+    const code = newSetupCode((n) => randomBytes(n));
+    try {
+        const registered = await fetch(registerUrl(baseUrl, code), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ machine: hostname() }),
+        });
+        if (!registered.ok) {
+            process.stdout.write(`haas-mcp setup — ${baseUrl} would not register a setup code (HTTP ${registered.status}); falling back to pasting the token.\n`);
+            return null;
+        }
+    }
+    catch (error) {
+        process.stdout.write(`haas-mcp setup — could not reach ${baseUrl} (${error instanceof Error ? error.message : String(error)}); falling back to pasting the token.\n`);
+        return null;
+    }
+    const url = connectPageUrl(baseUrl, code);
+    const check = pairingCheck(code, (input) => createHash("sha256").update(input, "utf8").digest("hex"));
+    openBrowser(url);
+    process.stdout.write(`haas-mcp setup — opening ${url}\n` +
+        `Sign in if asked. The page shows the check ${check}; if it shows anything else,\n` +
+        "do not click Connect. Waiting for it here, up to 10 minutes\n" +
+        "(Ctrl-C to stop; `haas-mcp setup --paste` to paste a token instead).\n");
+    try {
+        return await receiveToken(new Socket(setupStreamUrl(baseUrl, code)), CONNECT_TIMEOUT_MS);
+    }
+    catch (error) {
+        process.stdout.write(`haas-mcp setup — ${error instanceof Error ? error.message : String(error)}; falling back to pasting the token.\n`);
+        return null;
+    }
+}
+/** Open a URL in the default browser, detached, and never fail the wizard over it. */
+function openBrowser(url) {
+    try {
+        const { program, args } = browserCommand(process.platform, url);
+        const child = spawn(program, args, { detached: true, stdio: "ignore" });
+        child.on("error", () => {
+            // No browser here; the URL is printed beside the prompt.
+        });
+        child.unref();
+    }
+    catch {
+        // Same: the printed URL is the fallback.
+    }
+}
+/** Where a program is on PATH, honouring Windows' executable suffixes. */
+function findOnPath(name) {
+    const suffixes = process.platform === "win32" ? [".cmd", ".exe", ".bat", ""] : [""];
+    for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const suffix of suffixes) {
+            const candidate = join(dir, `${name}${suffix}`);
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+main().catch((err) => {
+    process.stderr.write(`haas-mcp fatal: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Minimal REST client for the haas-lab API. Forwards `Authorization: Bearer <pat>`
+ * on every call, throws on non-2xx with the response body for visibility.
+ */
+export declare class HaasClient {
+    private readonly baseUrl;
+    private readonly pat;
+    constructor(baseUrl: string, pat: string);
+    private headers;
+    private parse;
+    private ensureOk;
+    get(path: string): Promise<unknown>;
+    postJson(path: string, body: unknown): Promise<unknown>;
+    postEmpty(path: string): Promise<unknown>;
+    /**
+     * Multipart upload — used by submit_job. Pass the firmware as a Buffer.
+     */
+    postMultipartFirmware(path: string, firmware: Buffer | Uint8Array, fields?: Record<string, string>): Promise<unknown>;
+    /**
+     * Submit C to be compiled on the bench (HAAS-230): the same multipart intake
+     * as a firmware, with a `source` text field in place of the `firmware` blob.
+     */
+    postMultipartSource(path: string, source: string, fields?: Record<string, string>): Promise<unknown>;
+    /**
+     * SSE long-poll: open the feed, collect chunks/events for up to `timeoutMs`,
+     * then close and return them. Used by tail_serial.
+     */
+    streamFeed(path: string, opts: {
+        timeoutMs: number;
+        maxChunks: number;
+        sinceSeq?: number;
+    }): Promise<{
+        chunks: {
+            seq: number;
+            data: string;
+        }[];
+        events: {
+            event: string;
+            data: string;
+        }[];
+        timedOut: boolean;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM;IAG9B,OAAO,CAAC,OAAO;YAOD,KAAK;YAUL,QAAQ;IAShB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ/C;;OAEG;IACG,qBAAqB,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,UAAU,EAC7B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC;IAiBnB;;;OAGG;IACG,mBAAmB,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC;IAcnB;;;OAGG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CA6DtH"}

package/dist/client.js

@@ -0,0 +1,168 @@
+/**
+ * Minimal REST client for the haas-lab API. Forwards `Authorization: Bearer <pat>`
+ * on every call, throws on non-2xx with the response body for visibility.
+ */
+export class HaasClient {
+    baseUrl;
+    pat;
+    constructor(baseUrl, pat) {
+        this.baseUrl = baseUrl;
+        this.pat = pat;
+    }
+    headers(extra = {}) {
+        return {
+            Authorization: `Bearer ${this.pat}`,
+            ...extra,
+        };
+    }
+    async parse(res) {
+        const text = await res.text();
+        if (!text)
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    async ensureOk(res, label) {
+        const body = await this.parse(res);
+        if (!res.ok) {
+            const detail = typeof body === "string" ? body : JSON.stringify(body);
+            throw new Error(`${label} failed: HTTP ${res.status} — ${detail}`);
+        }
+        return body;
+    }
+    async get(path) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "GET",
+            headers: this.headers(),
+        });
+        return this.ensureOk(res, `GET ${path}`);
+    }
+    async postJson(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers({ "Content-Type": "application/json" }),
+            body: JSON.stringify(body),
+        });
+        return this.ensureOk(res, `POST ${path}`);
+    }
+    async postEmpty(path) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(),
+        });
+        return this.ensureOk(res, `POST ${path}`);
+    }
+    /**
+     * Multipart upload — used by submit_job. Pass the firmware as a Buffer.
+     */
+    async postMultipartFirmware(path, firmware, fields = {}) {
+        const form = new FormData();
+        const blob = new Blob([new Uint8Array(firmware)], {
+            type: "application/octet-stream",
+        });
+        form.append("firmware", blob, "firmware.bin");
+        for (const [k, v] of Object.entries(fields)) {
+            form.append(k, v);
+        }
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(), // do not set Content-Type; fetch sets multipart boundary
+            body: form,
+        });
+        return this.ensureOk(res, `POST ${path} (multipart)`);
+    }
+    /**
+     * Submit C to be compiled on the bench (HAAS-230): the same multipart intake
+     * as a firmware, with a `source` text field in place of the `firmware` blob.
+     */
+    async postMultipartSource(path, source, fields = {}) {
+        const form = new FormData();
+        form.append("source", source);
+        for (const [k, v] of Object.entries(fields)) {
+            form.append(k, v);
+        }
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: this.headers(), // do not set Content-Type; fetch sets multipart boundary
+            body: form,
+        });
+        return this.ensureOk(res, `POST ${path} (source)`);
+    }
+    /**
+     * SSE long-poll: open the feed, collect chunks/events for up to `timeoutMs`,
+     * then close and return them. Used by tail_serial.
+     */
+    async streamFeed(path, opts) {
+        const ac = new AbortController();
+        const timer = setTimeout(() => ac.abort(), opts.timeoutMs);
+        const chunks = [];
+        const events = [];
+        try {
+            const res = await fetch(`${this.baseUrl}${path}`, {
+                method: "GET",
+                headers: this.headers({ Accept: "text/event-stream" }),
+                signal: ac.signal,
+            });
+            if (!res.ok || !res.body) {
+                await this.ensureOk(res, `GET ${path}`);
+            }
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buf = "";
+            let currentEvent = "message";
+            let currentData = "";
+            let seq = opts.sinceSeq ?? 0;
+            while (chunks.length < opts.maxChunks) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buf += decoder.decode(value, { stream: true });
+                const frames = buf.split(/\n\n/);
+                buf = frames.pop() ?? "";
+                for (const frame of frames) {
+                    currentEvent = "message";
+                    currentData = "";
+                    let sawData = false;
+                    for (const line of frame.split(/\n/)) {
+                        if (line.startsWith("event:"))
+                            currentEvent = line.slice(6).trim();
+                        // Several data lines are one value joined with newlines — the
+                        // specification's rule, and what a multi-line serial chunk needs
+                        // (HAAS-139). One leading space after the colon is the separator,
+                        // not content; anything else stays.
+                        else if (line.startsWith("data:")) {
+                            const piece = line.slice(5).replace(/^ /, "");
+                            currentData = currentData === "" && !sawData ? piece : `${currentData}\n${piece}`;
+                            sawData = true;
+                        }
+                    }
+                    events.push({ event: currentEvent, data: currentData });
+                    if (currentEvent === "serial" || currentEvent === "message") {
+                        chunks.push({ seq: ++seq, data: currentData });
+                        if (chunks.length >= opts.maxChunks)
+                            break;
+                    }
+                }
+            }
+            try {
+                reader.releaseLock();
+            }
+            catch { /* ignore */ }
+            return { chunks, events, timedOut: false };
+        }
+        catch (err) {
+            if (ac.signal.aborted) {
+                return { chunks, events, timedOut: true };
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What `haas-mcp` is told, and what it assumes when told nothing (HAAS-142).
+ *
+ * Pure, so the one-line install can be tested: the whole point of a one-liner
+ * is that the only thing a user supplies is a token, which means every other
+ * value has to default to the right thing. The base URL defaulted to a
+ * localhost port for the first months of this package's life, so a user who
+ * ran the documented `npx haas-mcp` against production would have been
+ * talking to nothing.
+ */
+/** Where the hosted service is. A developer running the app locally overrides it. */
+export declare const PRODUCTION_BASE_URL = "https://haas-lab.com";
+export interface CliConfig {
+    /** The Personal Access Token, or null when none was given anywhere. */
+    pat: string | null;
+    /** No trailing slash, so paths concatenate cleanly. */
+    baseUrl: string;
+    /** Prove the token against the API and exit, instead of serving. */
+    check: boolean;
+    /** `haas-mcp setup`: connect every AI client on this machine, then exit. */
+    setup: boolean;
+    /** `setup --paste`: ask for the token at the prompt instead of receiving it over a socket. */
+    paste: boolean;
+    help: boolean;
+}
+/**
+ * Flags win over the environment, which wins over the default. `--token` and
+ * `--base-url` take a value; `--check` and `--help` stand alone.
+ */
+export declare function readConfig(argv: readonly string[], env: Readonly<Record<string, string | undefined>>): CliConfig;
+/** Printed by `--help`, and the same lines the README and the docs page carry. */
+export declare const USAGE = "haas-mcp \u2014 flash firmware on real boards from any AI client, over MCP.\n\n  npx -y haas-mcp setup                      opens the token page; click Connect there; every AI client here is connected\n  npx -y haas-mcp setup --paste              the same, pasting the token instead (a Node older than 22 has no WebSocket)\n  HAAS_PAT=pat_...  npx -y haas-mcp            serve (stdio)\n  HAAS_PAT=pat_...  npx -y haas-mcp --check    prove the token, then exit 0 or 1\n  npx -y haas-mcp --help\n\nFlags       --token <pat>   --base-url <url>   --check   --paste   --help\nEnvironment HAAS_PAT (required to serve)   HAAS_BASE_URL (default https://haas-lab.com)\n\nMint a token at https://haas-lab.com/dashboard/tokens with the read and submit scopes.\n\nBy hand, one line per client:\n  Claude Code   claude mcp add haas-lab -e HAAS_PAT=pat_... -- npx -y haas-mcp\n  Codex CLI     codex mcp add haas-lab --env HAAS_PAT=pat_... -- npx -y haas-mcp\n  Claude Desktop, Cursor and others take the JSON form:\n    {\"mcpServers\":{\"haas-lab\":{\"command\":\"npx\",\"args\":[\"-y\",\"haas-mcp\"],\"env\":{\"HAAS_PAT\":\"pat_...\"}}}}\n";
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,uEAAuE;IACvE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,8FAA8F;IAC9F,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,SAAS,CAoBX;AAED,kFAAkF;AAClF,eAAO,MAAM,KAAK,4mCAkBjB,CAAC"}