@opvs-ai/mcp 2.6.1 → 2.7.1

package/dist/fleet.js

@@ -0,0 +1,474 @@
+/**
+ * Fleet tools — the MACHINE and SLOT surface (OSB-119, BYO plan row 3.2).
+ *
+ * Until this module the MCP package had 11 tools and NONE of them reached the
+ * environment layer, so the owner's "dashboard or MCP" was dashboard-only.
+ *
+ * Lives outside `index.ts` because that file ends in a top-level
+ * `await server.connect(transport)` — importing it to unit-test a handler would
+ * start a server. See `http.ts` for the same reasoning.
+ */
+import { err, getJson, ok, postJson } from "./http.js";
+export const FLEET_TOOLS = [
+    //
+    // VOCABULARY IS RULED, NOT FREE. `MACHINE-AND-SLOT.md` §3 (owner ruling
+    // 2026-09-07) settles the product surface on exactly two nouns: a MACHINE is
+    // the host you connect, a SLOT is the worker sitting at a desk on it. "box"
+    // and "desk" are retired from new writing, and this is new writing. The wire
+    // keeps saying `environments` — that disagreement is deliberate and is
+    // recorded there, not re-litigated here.
+    //
+    // Every description below therefore names the wire word and the retired
+    // synonyms explicitly, so an agent that was told "list my environments" or
+    // "check my box" still finds the right tool. Discoverability is paid for in
+    // the description; the NAME follows the ruling.
+    {
+        name: "fleet_list",
+        description: "List every SLOT this brand owns (a slot = one worker desk = one row of the " +
+            "`environments` table; also called an environment, box, desk, machine or " +
+            "workstation elsewhere), together with the machine allowance it spends. ONE " +
+            "call replaces list + allowance + a per-slot fetch. Slots are also grouped " +
+            "under their MACHINE (the physical host, keyed by `machine_id`) so co-tenancy " +
+            "is visible. Slots whose machine has not identified itself are listed under " +
+            "`unplaced` and are NEVER grouped together — two boxes that both decline to " +
+            "say where they run are not thereby on the same host. Brand is pinned " +
+            "server-side from the PAT — never pass a brand_id; `brand_id` is echoed back " +
+            "so an empty fleet says WHOSE fleet is empty. Read-only. `detail=compact` " +
+            "(default) emits id, short_id, name, status, dormant, runtime, machine_id, " +
+            "sidecar_port, wg_address, sidecar_version and the three freshness fields; " +
+            "`full` passes every server field through untouched.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                detail: {
+                    type: "string",
+                    enum: ["compact", "full"],
+                    description: "Row depth. Default `compact` (the decision fields, token-cheapest). " +
+                        "`full` returns each slot exactly as the server sent it.",
+                },
+            },
+        },
+    },
+    {
+        name: "slot_get",
+        description: "Fetch ONE slot (environment / box / desk / workstation) plus its live " +
+            "ONBOARDING CHECKLIST — the four steps run_installer → wg_register → " +
+            "sidecar_up → ready, each with its OWN state (pending | done | failed | " +
+            "blocked), a machine-readable `reason` and an operator `hint`. This is the " +
+            "tool that answers 'why is my machine stuck?': it also returns " +
+            "`next_action`, the single step to act on, so a stalled desk reads as one " +
+            "line rather than four competing ones. Accepts ANY ref shape — the full " +
+            "UUID, an 8+ hex prefix, or the `env_…` short code — and canonicalizes it " +
+            "for you. Read-only; touches no box. Use `slot_health` for a live probe.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slot: {
+                    type: "string",
+                    description: "The slot ref: full UUID, an 8-or-more hex prefix, or the `env_…` " +
+                        "short code. From `fleet_list`.",
+                },
+            },
+            required: ["slot"],
+        },
+    },
+    {
+        name: "slot_health",
+        description: "LIVE health probe of one slot's sidecar — this call reaches out to the " +
+            "actual box over WireGuard, so it is slower than `slot_get` and can time " +
+            "out when the machine is down. Returns the stored status alongside " +
+            "`sidecar_reachable` and the version + code digest the sidecar reports " +
+            "about ITSELF right now (which may differ from the copy stored on the row). " +
+            "`sidecar_reachable: false` is a real answer, not a failure — it means the " +
+            "box did not respond. Accepts any ref shape (UUID, 8+ hex prefix, `env_…`).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                slot: {
+                    type: "string",
+                    description: "The slot ref — UUID, 8+ hex prefix, or `env_…` short code.",
+                },
+            },
+            required: ["slot"],
+        },
+    },
+    {
+        name: "fleet_logins",
+        description: "Which logins have lapsed across the whole fleet, on BOTH credential lanes " +
+            "— they are different lanes and are reported separately ON PURPOSE. " +
+            "`lease` is the SpiderGate BUILD credential (when it lapses a build falls " +
+            "back to metered pricing); `desk` is what the box's TERMINAL actually opens " +
+            "(when it lapses the desk will not start). A box can be perfect on one and " +
+            "unusable on the other. Desk state is FOUR-valued (healthy | " +
+            "not_applicable | unknown | lapsed) and must be rendered as four — " +
+            "'nobody asked OPVS to manage this desk' and 'OPVS was asked and cannot " +
+            "vouch for it' are different sentences. The two lanes' attention counts are " +
+            "returned separately and are never summed: a single total cannot say which " +
+            "lane broke. `checked` is the denominator; `dormant` counts boxes skipped " +
+            "because nothing has been heard from them. Read-only, fleet-wide, no params.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "slot_order",
+        description: "ORDER A NEW SLOT — the self-serve onboarding door (the MCP equivalent of " +
+            "the dashboard's '+ HIRE'). ⚠️ THIS WRITES: it spends one unit of the " +
+            "brand's machine allowance (check `fleet_list.allowance` first — a full " +
+            "allowance is refused with 402/403) and it mints a ONE-SHOT install PAT. " +
+            "That PAT and the `install_command` one-liner that embeds it are returned " +
+            "EXACTLY ONCE, here, and are never retrievable again — hand them straight " +
+            "to the operator to paste onto the target VPS. Nothing is provisioned by " +
+            "this call; it creates the record and the installer command. The box goes " +
+            "`provisioning` → `ready` on its own once the one-liner has run and the " +
+            "sidecar registers. Poll `slot_get` to watch the checklist advance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Human name for the slot, 1-128 chars. E.g. 'frontend-1'.",
+                },
+                runtime: {
+                    type: "string",
+                    enum: ["claude_code", "codex", "custom"],
+                    description: "Agent runtime installed on the slot. Default `claude_code`. " +
+                        "`custom` installs the sidecar but auto-launches nothing.",
+                },
+                region: {
+                    type: "string",
+                    description: "Preferred region hint (advisory only — nothing enforces it).",
+                },
+                description: {
+                    type: "string",
+                    description: "Optional free-text note, max 1000 chars.",
+                },
+            },
+            required: ["name"],
+        },
+    },
+];
+// ── Fleet handlers — MACHINES and SLOTS (OSB-119) ─────────────────────
+/** The slot fields a compact fleet row carries.
+ *
+ *  AN ENUMERATION IS ITSELF A CLAIM, so this list is exported into the
+ *  `fleet_list` description verbatim and `detail: "full"` exists to escape it.
+ *  A trim that nobody can see is indistinguishable from a field the server
+ *  stopped sending.
+ */
+export const COMPACT_SLOT_FIELDS = [
+    "id",
+    "short_id",
+    "name",
+    "status",
+    "dormant",
+    "runtime",
+    "machine_id",
+    "sidecar_port",
+    "wg_address",
+    "sidecar_version",
+    "last_health_check",
+    "last_sync_at",
+    "pending_sync_count",
+];
+export function compactSlot(row) {
+    const out = {};
+    for (const f of COMPACT_SLOT_FIELDS) {
+        if (row[f] !== undefined)
+            out[f] = row[f];
+    }
+    return out;
+}
+/** Group slots under the machine that reported hosting them.
+ *
+ *  🔴 A NULL `machine_id` is NOT a group. The column is written by the health
+ *  poller from `/etc/machine-id` and is NULL whenever the sidecar is too old to
+ *  report it — which is still the common case. Two boxes that both decline to
+ *  say where they run are not thereby co-tenants, and collapsing them would
+ *  invent a co-tenancy the platform has no evidence for
+ *  (`schemas/environment.py`, `machine_id`). They go to `unplaced`, one entry
+ *  each, in list order.
+ */
+export function groupByMachine(rows) {
+    const byMachine = new Map();
+    const unplaced = [];
+    for (const row of rows) {
+        const label = typeof row.name === "string" && row.name ? row.name : String(row.id ?? "?");
+        const ref = `${String(row.id ?? "?")} (${label})`;
+        const mid = row.machine_id;
+        if (typeof mid === "string" && mid.length > 0) {
+            const bucket = byMachine.get(mid);
+            if (bucket)
+                bucket.push(ref);
+            else
+                byMachine.set(mid, [ref]);
+        }
+        else {
+            unplaced.push(ref);
+        }
+    }
+    return {
+        machines: [...byMachine.entries()].map(([machine_id, slots]) => ({
+            machine_id,
+            slot_count: slots.length,
+            slots,
+        })),
+        unplaced,
+    };
+}
+export async function handleFleetList(args) {
+    if (args.detail != null && !["compact", "full"].includes(args.detail)) {
+        return err(`invalid detail '${args.detail}'`, "#audit.error:input=bad-detail — detail must be compact | full. " +
+            "#next:omit it for the default (compact).");
+    }
+    const full = args.detail === "full";
+    let fleet;
+    try {
+        fleet = await getJson("/api/v1/environments");
+    }
+    catch (e) {
+        const error = e;
+        if (error.status === 401 || error.status === 403) {
+            return err(`fleet_list forbidden: ${error.detail ?? "not authorized for this brand"}`, "#audit.error:auth #next:whoami to confirm which brand this PAT is pinned to.");
+        }
+        return err(`fleet_list failed: ${error.status ?? "?"} ${error.detail ?? ""}`, "#audit.error:upstream #next:whoami to verify auth; check the API is reachable.");
+    }
+    const rows = Array.isArray(fleet.environments) ? fleet.environments : [];
+    // The allowance is a SECOND upstream read and is allowed to fail on its own.
+    // A fleet listing is still useful without the cap, so a failure here is
+    // REPORTED rather than swallowed into a null: `allowance: null` alone would
+    // be indistinguishable from an uncapped brand, which is the one reading that
+    // must not be invented (`EnvironmentAllowance` carries `unlimited` explicitly
+    // for exactly this reason).
+    let allowance = null;
+    let allowanceError = null;
+    try {
+        allowance = await getJson("/api/v1/environments/allowance");
+    }
+    catch (e) {
+        const error = e;
+        allowanceError = `${error.status ?? "?"} ${error.detail ?? "allowance read failed"}`;
+    }
+    const grouped = groupByMachine(rows);
+    const body = {
+        // Echoed from the SERVER, never from a client guess: `get_current_brand`
+        // may settle on a different brand than the caller assumed, and an empty
+        // list has to be able to say whose fleet is empty (OSB-164).
+        brand_id: fleet.brand_id ?? null,
+        total: fleet.total ?? rows.length,
+        slots: full ? rows : rows.map(compactSlot),
+        machines: grouped.machines,
+        unplaced: grouped.unplaced,
+        allowance,
+    };
+    if (allowanceError) {
+        body.allowance_error = allowanceError;
+        body._guidance =
+            "#audit.partial:allowance — the fleet listing is complete; the machine " +
+                "allowance could not be read, so `allowance` is null because it is UNKNOWN, " +
+                "not because the brand is uncapped. Do not tell the operator they have room.";
+    }
+    return ok(body);
+}
+/** Resolve any slot ref (UUID | 8+ hex prefix | `env_…` short code) to the
+ *  canonical environment row.
+ *
+ *  🔑 THIS EXISTS BECAUSE THE TWO ROUTES DISAGREE ABOUT REF SHAPES.
+ *  `GET /environments/{ref}` funnels through `_resolve_env`, which accepts all
+ *  three. `GET /workstations/{id}` gates on `_is_uuid` and returns 404 for
+ *  anything else — so an agent that reads `short_id` out of `fleet_list` and
+ *  hands it to the checklist route gets "not found" for a slot that plainly
+ *  exists. Resolving here, once, and then using the row's own `id` for the
+ *  second hop is what keeps `slot_get` honest about which refs it accepts.
+ */
+export async function resolveSlot(ref) {
+    try {
+        const row = await getJson(`/api/v1/environments/${encodeURIComponent(ref)}`);
+        return { ok: true, row };
+    }
+    catch (e) {
+        const error = e;
+        if (error.status === 404) {
+            return {
+                ok: false,
+                result: err(`slot '${ref}' not found (or not owned by this brand)`, "#audit.error:slot=missing #next:fleet_list to see this brand's slots; " +
+                    "whoami to confirm which brand the PAT is pinned to. Any of the full " +
+                    "UUID, an 8+ hex prefix or the `env_…` short code is accepted."),
+            };
+        }
+        if (error.status === 409) {
+            return {
+                ok: false,
+                result: err(`slot ref '${ref}' is ambiguous: ${error.detail ?? "matches more than one slot"}`, "#audit.error:slot=ambiguous #next:lengthen the hex prefix, or use the " +
+                    "full UUID / `env_…` short code from fleet_list. Retrying the same ref fails identically."),
+            };
+        }
+        if (error.status === 401 || error.status === 403) {
+            return {
+                ok: false,
+                result: err(`slot '${ref}' forbidden: ${error.detail ?? "not authorized for this brand"}`, "#audit.error:auth #next:whoami to confirm the PAT's brand."),
+            };
+        }
+        return {
+            ok: false,
+            result: err(`slot lookup failed: ${error.status ?? "?"} ${error.detail ?? ""}`, "#audit.error:upstream #next:whoami to verify auth; check the API is reachable."),
+        };
+    }
+}
+/** The one step an operator should act on: the first that is not `done`.
+ *
+ *  Everything after it is `blocked_by:<key>` by construction (OSB-113), so
+ *  picking the first non-done step is what turns four competing lines into one.
+ *  Returns null when every step is done — a genuinely ready slot.
+ */
+export function nextAction(steps) {
+    const pending = steps.find((s) => s.state !== "done");
+    if (!pending)
+        return null;
+    return {
+        key: pending.key ?? null,
+        state: pending.state ?? null,
+        reason: pending.reason ?? null,
+        hint: pending.hint ?? null,
+    };
+}
+export async function handleSlotGet(args) {
+    if (!args.slot || typeof args.slot !== "string") {
+        return err("slot is required", "#audit.error:input=missing — slot_get needs a slot ref (UUID, 8+ hex " +
+            "prefix, or `env_…` short code). #next:fleet_list to find one.");
+    }
+    const resolved = await resolveSlot(args.slot);
+    if (!resolved.ok)
+        return resolved.result;
+    const row = resolved.row;
+    // Second hop, by CANONICAL UUID — see `resolveSlot`. The onboarding checklist
+    // hangs off the workstation view, which is the same `environments` row mapped
+    // through `_to_view`; a workstation id IS an env id.
+    const canonical = typeof row.id === "string" ? row.id : args.slot;
+    const body = { slot: row };
+    try {
+        const view = await getJson(`/api/v1/workstations/${encodeURIComponent(canonical)}`);
+        const steps = Array.isArray(view.onboarding_steps) ? view.onboarding_steps : [];
+        body.onboarding = {
+            ready: view.ready ?? null,
+            steps,
+            next_action: nextAction(steps),
+        };
+    }
+    catch (e) {
+        // The slot itself resolved, so returning it without the checklist beats
+        // failing the whole call — but the gap is NAMED. A missing `onboarding` key
+        // that the caller has to notice is how a checklist comes to read as "no
+        // steps outstanding".
+        const error = e;
+        body.onboarding = null;
+        body.onboarding_error = `${error.status ?? "?"} ${error.detail ?? "checklist read failed"}`;
+        body._guidance =
+            "#audit.partial:onboarding — the slot resolved but its checklist could not " +
+                "be read. `onboarding: null` means UNKNOWN, not 'nothing outstanding'.";
+    }
+    return ok(body);
+}
+export async function handleSlotHealth(args) {
+    if (!args.slot || typeof args.slot !== "string") {
+        return err("slot is required", "#audit.error:input=missing — slot_health needs a slot ref (UUID, 8+ hex " +
+            "prefix, or `env_…` short code). #next:fleet_list to find one.");
+    }
+    try {
+        const data = await getJson(`/api/v1/environments/${encodeURIComponent(args.slot)}/health`);
+        return ok(data);
+    }
+    catch (e) {
+        const error = e;
+        if (error.status === 404) {
+            return err(`slot '${args.slot}' not found (or not owned by this brand)`, "#audit.error:slot=missing #next:fleet_list to see this brand's slots.");
+        }
+        if (error.status === 409) {
+            return err(`slot ref '${args.slot}' is ambiguous: ${error.detail ?? "matches more than one slot"}`, "#audit.error:slot=ambiguous #next:lengthen the prefix or use the full UUID.");
+        }
+        // A DOWN BOX IS NOT AN ERROR OF THIS TOOL. The route probes the sidecar over
+        // WireGuard, so a dead machine surfaces as an upstream failure here rather
+        // than as `sidecar_reachable: false` — say which of the two it was, because
+        // "the API is broken" and "the box is off" call for different actions.
+        return err(`slot_health failed: ${error.status ?? "?"} ${error.detail ?? ""}`, "#audit.error:upstream — this call reaches the box itself, so a timeout " +
+            "here usually means the MACHINE is unreachable, not that OPVS is down. " +
+            "#next:slot_get for the stored status + onboarding checklist, which touches no box.");
+    }
+}
+export async function handleFleetLogins() {
+    try {
+        const data = await getJson("/api/v1/environments/credentials/reauth-status");
+        return ok({
+            // Passed through by LANE, deliberately un-merged. The two counts answer
+            // different questions and the schema is explicit that a rail which adds
+            // them cannot say which lane broke.
+            lease: {
+                flagged: data.environments ?? [],
+                total_providers: data.total_providers ?? 0,
+            },
+            desk: {
+                rows: data.desk ?? [],
+                needs_attention: data.desk_needs_attention ?? 0,
+            },
+            checked: data.checked ?? 0,
+            // Skipped boxes are COUNTED rather than dropped: `checked` is the
+            // denominator every figure above is read against, and shrinking it
+            // silently would turn "all fine" into a claim about a fleet that was
+            // never examined (OSB-158).
+            dormant: data.dormant ?? 0,
+        });
+    }
+    catch (e) {
+        const error = e;
+        if (error.status === 401 || error.status === 403) {
+            return err(`fleet_logins forbidden: ${error.detail ?? "not authorized for this brand"}`, "#audit.error:auth #next:whoami to confirm the PAT's brand.");
+        }
+        return err(`fleet_logins failed: ${error.status ?? "?"} ${error.detail ?? ""}`, "#audit.error:upstream #next:whoami to verify auth; check the API is reachable.");
+    }
+}
+export const SLOT_RUNTIMES = ["claude_code", "codex", "custom"];
+export async function handleSlotOrder(args) {
+    if (!args.name || typeof args.name !== "string" || args.name.trim() === "") {
+        return err("name is required", "#audit.error:input=missing — slot_order needs a human name for the slot, " +
+            "1-128 chars. Nothing is created without it.");
+    }
+    if (args.runtime != null && !SLOT_RUNTIMES.includes(args.runtime)) {
+        // Refused HERE rather than forwarded, because the upstream 422 arrives after
+        // the allowance gate has already been consulted and reads as a server fault.
+        return err(`invalid runtime '${args.runtime}'`, `#audit.error:input=bad-runtime — runtime must be one of ${SLOT_RUNTIMES.join(" | ")}. #next:omit it for the default (claude_code). Note \`gemini-cli\` and ` +
+            "`openhands` are NOT slot runtimes — they exist on other axes.");
+    }
+    const body = { name: args.name };
+    if (args.runtime)
+        body.runtime = args.runtime;
+    if (args.region)
+        body.region = args.region;
+    if (args.description)
+        body.description = args.description;
+    try {
+        const data = await postJson("/api/v1/workstations", body);
+        return ok({
+            ...data,
+            _guidance: "#audit.write:slot-ordered — `pat` and `install_command` are ONE-SHOT and " +
+                "are not retrievable again from any endpoint. Hand the one-liner to the " +
+                "operator now; if it is lost, rotate with a fresh PAT rather than " +
+                "re-ordering (a second order spends the allowance again). Nothing is " +
+                "installed yet — poll slot_get to watch the checklist advance.",
+        });
+    }
+    catch (e) {
+        const error = e;
+        if (error.status === 402 || error.status === 403) {
+            return err(`slot_order denied: ${error.detail ?? "machine allowance exhausted"}`, "#audit.error:quota — ORDER and ATTACH spend the SAME allowance; there is " +
+                "one cap, not two. #next:fleet_list to read `allowance`, then release an " +
+                "unused slot or raise the plan's `max_environments_per_brand`.");
+        }
+        if (error.status === 400 || error.status === 422) {
+            return err(`slot_order rejected: ${error.detail ?? "invalid request"}`, "#audit.error:input — check `name` (1-128 chars) and `description` (max 1000).");
+        }
+        return err(`slot_order failed: ${error.status ?? "?"} ${error.detail ?? ""}`, "#audit.error:upstream — a failure here may still have created the slot. " +
+            "#next:fleet_list BEFORE retrying, or you will spend the allowance twice.");
+    }
+}
+//# sourceMappingURL=fleet.js.map

package/dist/fleet.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared transport + response helpers for the OPVS MCP server.
+ *
+ * Carved out of `index.ts` (OSB-119) for one reason: `index.ts` ends in a
+ * top-level `await server.connect(transport)`, so importing it to test anything
+ * STARTS A SERVER. Any unit test of a handler therefore needs the handler to
+ * live somewhere that can be imported without that side effect. This module and
+ * `fleet.ts` are that somewhere; the move is pure, with no behaviour change.
+ */
+import { createClient } from "@opvs-ai/core";
+export type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare function ok(body: unknown): ToolResult;
+/** Standard error envelope: flat-sibling `_guidance` (W1.A discipline,
+ *  confirmed with SpiderIQ 2026-05-15 PM). Never wrap. */
+export declare function err(message: string, guidance?: string): ToolResult;
+/**
+ * `err` plus machine-readable fields, as FLAT SIBLINGS of `error` — the same
+ * W1.A discipline `_guidance` follows. Never wrap: a nested `details: {...}`
+ * would make the agent reach one level deeper for exactly the values the
+ * refusal exists to hand it.
+ *
+ * For refusals an agent must ACT on rather than merely report. A 413 whose
+ * numbers live only inside an English sentence forces the model to parse prose
+ * to decide what to do next, which is the failure this envelope removes
+ * (OSB-207). `error` and `_guidance` are reserved and cannot be overwritten.
+ */
+export declare function errFields(message: string, fields: Record<string, unknown>, guidance?: string): ToolResult;
+export declare function client(): ReturnType<typeof createClient>;
+export declare function getJson<T = unknown>(path: string): Promise<T>;
+export declare function postJson<T = unknown>(path: string, body?: unknown): Promise<T>;
+/** GET a path and return the raw response body as text (no JSON parse). Used
+ *  for endpoints that emit Markdown / plain text such as the board export. */
+export declare function getText(path: string): Promise<string>;
+export declare function del204(path: string): Promise<void>;

package/dist/http.js

@@ -0,0 +1,83 @@
+/**
+ * Shared transport + response helpers for the OPVS MCP server.
+ *
+ * Carved out of `index.ts` (OSB-119) for one reason: `index.ts` ends in a
+ * top-level `await server.connect(transport)`, so importing it to test anything
+ * STARTS A SERVER. Any unit test of a handler therefore needs the handler to
+ * live somewhere that can be imported without that side effect. This module and
+ * `fleet.ts` are that somewhere; the move is pure, with no behaviour change.
+ */
+import { createClient, getResponseText } from "@opvs-ai/core";
+export function ok(body) {
+    const text = typeof body === "string" ? body : JSON.stringify(body);
+    return { content: [{ type: "text", text }] };
+}
+/** Standard error envelope: flat-sibling `_guidance` (W1.A discipline,
+ *  confirmed with SpiderIQ 2026-05-15 PM). Never wrap. */
+export function err(message, guidance) {
+    const body = { error: message };
+    if (guidance)
+        body._guidance = guidance;
+    return { content: [{ type: "text", text: JSON.stringify(body) }] };
+}
+/**
+ * `err` plus machine-readable fields, as FLAT SIBLINGS of `error` — the same
+ * W1.A discipline `_guidance` follows. Never wrap: a nested `details: {...}`
+ * would make the agent reach one level deeper for exactly the values the
+ * refusal exists to hand it.
+ *
+ * For refusals an agent must ACT on rather than merely report. A 413 whose
+ * numbers live only inside an English sentence forces the model to parse prose
+ * to decide what to do next, which is the failure this envelope removes
+ * (OSB-207). `error` and `_guidance` are reserved and cannot be overwritten.
+ */
+export function errFields(message, fields, guidance) {
+    const body = { error: message };
+    for (const [k, v] of Object.entries(fields)) {
+        if (k === "error" || k === "_guidance")
+            continue;
+        body[k] = v;
+    }
+    if (guidance)
+        body._guidance = guidance;
+    return { content: [{ type: "text", text: JSON.stringify(body) }] };
+}
+// ── API client ────────────────────────────────────────────────────────
+// The explicit return type is load-bearing: `createClient` returns an anonymous
+// class with private fields, which TypeScript refuses to export inferentially
+// (TS4094). Naming it via ReturnType keeps the export legal without widening it.
+export function client() {
+    return createClient();
+}
+export async function getJson(path) {
+    const res = await client().get(path);
+    const text = await getResponseText(res);
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+export async function postJson(path, body) {
+    const res = await client().post(path, body);
+    const text = await getResponseText(res);
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/** GET a path and return the raw response body as text (no JSON parse). Used
+ *  for endpoints that emit Markdown / plain text such as the board export. */
+export async function getText(path) {
+    const res = await client().get(path);
+    return getResponseText(res);
+}
+export async function del204(path) {
+    // The OPVS DELETE endpoints we hit return 204 No Content; createClient
+    // throws on non-2xx, so reaching here = success.
+    await client().delete(path);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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