@ornncompute/cli 0.2.8 → 0.2.10

package/vendor/capabilities/capabilities/staff-fleet.d.ts

@@ -5,55 +5,50 @@ export declare const enrollmentTokenRevokeInput: z.ZodObject<{
 }, z.core.$strip>;
 export declare const enrollmentTokenRevokeCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const operatorCreateInput: z.ZodObject<{
-    slug: z.ZodString;
-    displayName: z.ZodString;
-    mode: z.ZodOptional<z.ZodEnum<{
-        managed: "managed";
-        federated: "federated";
-    }>>;
-    status: z.ZodOptional<z.ZodEnum<{
-        active: "active";
-        unavailable: "unavailable";
-        revoked: "revoked";
-    }>>;
+    slug: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const operatorCreateCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const operatorUpdateInput: z.ZodObject<{
-    operatorId: z.ZodString;
+    operatorId: z.ZodOptional<z.ZodString>;
+    operator_id: z.ZodOptional<z.ZodString>;
     displayName: z.ZodOptional<z.ZodString>;
-    slug: z.ZodOptional<z.ZodString>;
-    mode: z.ZodOptional<z.ZodEnum<{
-        managed: "managed";
-        federated: "federated";
-    }>>;
-    status: z.ZodOptional<z.ZodEnum<{
-        active: "active";
-        unavailable: "unavailable";
-        revoked: "revoked";
-    }>>;
+    display_name: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const operatorUpdateCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const operatorDeleteInput: z.ZodObject<{
-    operatorId: z.ZodString;
+    operatorId: z.ZodOptional<z.ZodString>;
+    operator_id: z.ZodOptional<z.ZodString>;
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const operatorDeleteCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const facilityCreateInput: z.ZodObject<{
-    operatorId: z.ZodString;
-    slug: z.ZodString;
-    displayName: z.ZodString;
+    operatorId: z.ZodOptional<z.ZodString>;
+    operator_id: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
     region: z.ZodString;
     zone: z.ZodOptional<z.ZodString>;
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const facilityCreateCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const facilityUpdateInput: z.ZodObject<{
-    facilityId: z.ZodString;
+    facilityId: z.ZodOptional<z.ZodString>;
+    facility_id: z.ZodOptional<z.ZodString>;
     displayName: z.ZodOptional<z.ZodString>;
+    display_name: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
     region: z.ZodOptional<z.ZodString>;
     zone: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const facilityUpdateCapability: import("../capability.ts").Capability<unknown, unknown>;
@@ -79,13 +74,6 @@ export declare const nodeDetailsUpdateInput: z.ZodObject<{
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const nodeDetailsUpdateCapability: import("../capability.ts").Capability<unknown, unknown>;
-export declare const nodeReserveListingInput: z.ZodObject<{
-    nodeId: z.ZodString;
-    availableFrom: z.ZodOptional<z.ZodString>;
-    availableTo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    confirm: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export declare const nodeReserveListingCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const nodeTestTriggerInput: z.ZodObject<{
     nodeId: z.ZodString;
     burnTimeMinutes: z.ZodOptional<z.ZodNumber>;
@@ -107,6 +95,8 @@ export declare const nodeBenchmarkCapability: import("../capability.ts").Capabil
 export declare const nodeDeployInput: z.ZodObject<{
     nodeId: z.ZodString;
     targetTenantId: z.ZodString;
+    commerceReservationId: z.ZodOptional<z.ZodString>;
+    commerce_reservation_id: z.ZodOptional<z.ZodString>;
     targetAuthUserId: z.ZodOptional<z.ZodString>;
     networkMode: z.ZodOptional<z.ZodEnum<{
         public: "public";
@@ -138,4 +128,13 @@ export declare const nodeAdminKeyInput: z.ZodObject<{
     confirm: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const nodeAdminKeyCapability: import("../capability.ts").Capability<unknown, unknown>;
+export declare const nodeOperatorTransferInput: z.ZodObject<{
+    nodeId: z.ZodString;
+    operatorId: z.ZodString;
+    operatorSlug: z.ZodString;
+    facilityId: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const nodeOperatorTransferCapability: import("../capability.ts").Capability<unknown, unknown>;
 export declare const staffFleetCapabilities: import("../capability.ts").Capability<unknown, unknown>[];

package/vendor/capabilities/capabilities/staff-fleet.js

@@ -1,14 +1,12 @@
 import { z } from "zod";
 import { defineStaffMcpCapability, preview } from "../capability.js";
-import { mapBody, seg } from "./staff-shared.js";
+import { mapBody, resolveVersion, seg } from "./staff-shared.js";
 // Staff fleet verbs: operators, facilities, nodes, node jobs, and enrollment
 // token revocation. MCP-only — see `defineStaffMcpCapability`.
 const slugSchema = z
     .string()
     .regex(/^[a-z0-9][a-z0-9-]*$/, "slug must be lowercase alphanumeric with dashes")
     .max(80);
-const operatorModeSchema = z.enum(["managed", "federated"]);
-const operatorStatusSchema = z.enum(["active", "unavailable", "revoked"]);
 export const enrollmentTokenRevokeInput = z.object({
     tokenId: z.string(),
     confirm: z.boolean().optional(),
@@ -28,27 +26,34 @@ export const enrollmentTokenRevokeCapability = defineStaffMcpCapability({
         return ctx.fetch(`/enrollment/tokens/${seg(parsed.tokenId)}/revoke`, { method: "POST" });
     },
 });
-export const operatorCreateInput = z.object({
-    slug: slugSchema,
-    displayName: z.string().min(1).max(160),
-    mode: operatorModeSchema.optional(),
-    status: operatorStatusSchema.optional(),
+export const operatorCreateInput = z
+    .object({
+    slug: z.string().optional(),
+    displayName: z.string().min(1).max(160).optional(),
+    display_name: z.string().min(1).max(160).optional(),
+    name: z.string().min(1).max(160).optional(),
     confirm: z.boolean().optional(),
+})
+    .refine((data) => Boolean(data.displayName || data.display_name || data.name), {
+    message: "displayName is required",
+    path: ["displayName"],
 });
 export const operatorCreateCapability = defineStaffMcpCapability({
     id: "operator.create",
     domain: "fleet",
     roles: ["admin"],
-    description: "Internal staff only: create an operator (managed or federated). Requires confirm: true. Does not touch any hardware.",
+    description: "Internal staff only: create an operator. Requires confirm: true. Does not touch any hardware.",
     mutation: "preview-confirm",
     http: { method: "POST", path: "/provisioning/operators" },
     input: operatorCreateInput,
     execute: async (ctx, input) => {
         const parsed = operatorCreateInput.parse(input);
+        const displayName = (parsed.displayName || parsed.display_name || parsed.name).trim();
+        const rawSlug = parsed.slug ? parsed.slug.trim() : displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+        const slug = rawSlug.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "");
         const body = {
-            slug: parsed.slug,
-            display_name: parsed.displayName,
-            ...mapBody(parsed, { mode: "mode", status: "status" }),
+            slug: slug || "operator-" + Date.now(),
+            display_name: displayName,
         };
         if (!ctx.confirmed)
             return preview("operator.create", body);
@@ -56,63 +61,91 @@ export const operatorCreateCapability = defineStaffMcpCapability({
     },
 });
 export const operatorUpdateInput = z.object({
-    operatorId: z.string(),
+    operatorId: z.string().optional(),
+    operator_id: z.string().optional(),
     displayName: z.string().min(1).max(160).optional(),
-    slug: slugSchema.optional(),
-    mode: operatorModeSchema.optional(),
-    status: operatorStatusSchema.optional(),
+    display_name: z.string().min(1).max(160).optional(),
+    name: z.string().min(1).max(160).optional(),
+    version: z.number().int().positive().optional(),
     confirm: z.boolean().optional(),
 });
 export const operatorUpdateCapability = defineStaffMcpCapability({
     id: "operator.update",
     domain: "fleet",
     roles: ["admin"],
-    description: "Internal staff only: update an operator's display name, slug, mode, or status. Requires confirm: true.",
+    description: "Internal staff only: rename an operator. Display name is the only field commerce can patch; slug, mode, and status are fixed at creation. Requires confirm: true.",
     mutation: "preview-confirm",
     http: { method: "PATCH", path: "/provisioning/operators/{operatorId}" },
     input: operatorUpdateInput,
     execute: async (ctx, input) => {
         const parsed = operatorUpdateInput.parse(input);
-        const body = mapBody(parsed, {
-            displayName: "display_name",
-            slug: "slug",
-            mode: "mode",
-            status: "status",
-        });
+        const operatorId = parsed.operatorId || parsed.operator_id;
+        if (!operatorId) {
+            throw new Error("operatorId is required");
+        }
+        const displayName = parsed.displayName || parsed.display_name || parsed.name;
+        if (!displayName) {
+            throw new Error("displayName is required; it is the only operator field commerce can patch.");
+        }
+        const body = {
+            display_name: displayName,
+            version: await resolveVersion(ctx, `/provisioning/operators/${seg(operatorId)}`, parsed.version),
+        };
         if (!ctx.confirmed)
             return preview("operator.update", body);
-        return ctx.fetch(`/provisioning/operators/${seg(parsed.operatorId)}`, {
+        return ctx.fetch(`/provisioning/operators/${seg(operatorId)}`, {
             method: "PATCH",
             body,
         });
     },
 });
 export const operatorDeleteInput = z.object({
-    operatorId: z.string(),
+    operatorId: z.string().optional(),
+    operator_id: z.string().optional(),
     confirm: z.boolean().optional(),
 });
 export const operatorDeleteCapability = defineStaffMcpCapability({
     id: "operator.delete",
     domain: "fleet",
     roles: ["admin"],
-    description: "Internal staff only: delete an operator. Requires confirm: true.",
+    description: "Internal staff only: delete an operator and cascade-delete every facility attached to it. " +
+        "Refuses while any listing still references the operator. Requires confirm: true.",
     mutation: "preview-confirm",
     http: { method: "DELETE", path: "/provisioning/operators/{operatorId}" },
     input: operatorDeleteInput,
     execute: async (ctx, input) => {
         const parsed = operatorDeleteInput.parse(input);
+        const operatorId = parsed.operatorId || parsed.operator_id;
+        if (!operatorId) {
+            throw new Error("operatorId is required");
+        }
         if (!ctx.confirmed)
-            return preview("operator.delete", { operatorId: parsed.operatorId });
-        return ctx.fetch(`/provisioning/operators/${seg(parsed.operatorId)}`, { method: "DELETE" });
+            return preview("operator.delete", { operatorId });
+        const result = await ctx.fetch(`/provisioning/operators/${seg(operatorId)}`, {
+            method: "DELETE",
+        });
+        return result ?? { deleted: true, operatorId };
     },
 });
-export const facilityCreateInput = z.object({
-    operatorId: z.string(),
-    slug: slugSchema,
-    displayName: z.string().min(1).max(160),
+export const facilityCreateInput = z
+    .object({
+    operatorId: z.string().optional(),
+    operator_id: z.string().optional(),
+    slug: z.string().optional(),
+    displayName: z.string().min(1).max(160).optional(),
+    display_name: z.string().min(1).max(160).optional(),
+    name: z.string().min(1).max(160).optional(),
     region: z.string().min(1).max(120),
     zone: z.string().max(120).optional(),
     confirm: z.boolean().optional(),
+})
+    .refine((data) => Boolean(data.operatorId || data.operator_id), {
+    message: "operatorId is required",
+    path: ["operatorId"],
+})
+    .refine((data) => Boolean(data.displayName || data.display_name || data.name), {
+    message: "displayName is required",
+    path: ["displayName"],
 });
 export const facilityCreateCapability = defineStaffMcpCapability({
     id: "facility.create",
@@ -124,10 +157,14 @@ export const facilityCreateCapability = defineStaffMcpCapability({
     input: facilityCreateInput,
     execute: async (ctx, input) => {
         const parsed = facilityCreateInput.parse(input);
+        const operatorId = (parsed.operatorId || parsed.operator_id);
+        const displayName = (parsed.displayName || parsed.display_name || parsed.name).trim();
+        const rawSlug = parsed.slug ? parsed.slug.trim() : displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+        const slug = rawSlug.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "");
         const body = {
-            operator_id: parsed.operatorId,
-            slug: parsed.slug,
-            display_name: parsed.displayName,
+            operator_id: operatorId,
+            slug: slug || "facility-" + Date.now(),
+            display_name: displayName,
             region: parsed.region,
             zone: parsed.zone ?? null,
         };
@@ -137,10 +174,14 @@ export const facilityCreateCapability = defineStaffMcpCapability({
     },
 });
 export const facilityUpdateInput = z.object({
-    facilityId: z.string(),
+    facilityId: z.string().optional(),
+    facility_id: z.string().optional(),
     displayName: z.string().min(1).max(160).optional(),
+    display_name: z.string().min(1).max(160).optional(),
+    name: z.string().min(1).max(160).optional(),
     region: z.string().min(1).max(120).optional(),
     zone: z.string().max(120).optional(),
+    version: z.number().int().positive().optional(),
     confirm: z.boolean().optional(),
 });
 export const facilityUpdateCapability = defineStaffMcpCapability({
@@ -153,15 +194,22 @@ export const facilityUpdateCapability = defineStaffMcpCapability({
     input: facilityUpdateInput,
     execute: async (ctx, input) => {
         const parsed = facilityUpdateInput.parse(input);
-        // "" clears zone; omitting it leaves zone unchanged (mirrors the dashboard PATCH).
-        const body = mapBody(parsed, {
-            displayName: "display_name",
-            region: "region",
-            zone: "zone",
-        });
+        const facilityId = parsed.facilityId || parsed.facility_id;
+        if (!facilityId) {
+            throw new Error("facilityId is required");
+        }
+        const displayName = parsed.displayName || parsed.display_name || parsed.name;
+        const body = {
+            ...(displayName ? { display_name: displayName } : {}),
+            ...mapBody(parsed, {
+                region: "region",
+                zone: "zone",
+            }),
+            version: await resolveVersion(ctx, `/provisioning/facilities/${seg(facilityId)}`, parsed.version),
+        };
         if (!ctx.confirmed)
             return preview("facility.update", body);
-        return ctx.fetch(`/provisioning/facilities/${seg(parsed.facilityId)}`, {
+        return ctx.fetch(`/provisioning/facilities/${seg(facilityId)}`, {
             method: "PATCH",
             body,
         });
@@ -233,31 +281,6 @@ export const nodeDetailsUpdateCapability = defineStaffMcpCapability({
         return ctx.fetch(`/internal/nodes/${seg(parsed.nodeId)}/details`, { method: "PATCH", body });
     },
 });
-export const nodeReserveListingInput = z.object({
-    nodeId: z.string(),
-    availableFrom: z.string().optional(),
-    availableTo: z.string().nullable().optional(),
-    confirm: z.boolean().optional(),
-});
-export const nodeReserveListingCapability = defineStaffMcpCapability({
-    id: "node.reserve-listing",
-    domain: "fleet",
-    roles: ["admin"],
-    description: "Internal staff only: list a GPU node on the reserve marketplace inventory. Requires confirm: true.",
-    mutation: "preview-confirm",
-    http: { method: "POST", path: "/inventory/{nodeId}" },
-    input: nodeReserveListingInput,
-    execute: async (ctx, input) => {
-        const parsed = nodeReserveListingInput.parse(input);
-        const body = mapBody(parsed, {
-            availableFrom: "available_from",
-            availableTo: "available_to",
-        });
-        if (!ctx.confirmed)
-            return preview("node.reserve-listing", body);
-        return ctx.fetch(`/inventory/${seg(parsed.nodeId)}`, { method: "POST", body });
-    },
-});
 export const nodeTestTriggerInput = z.object({
     nodeId: z.string(),
     burnTimeMinutes: z.number().optional(),
@@ -291,7 +314,18 @@ export const nodeTestTriggerCapability = defineStaffMcpCapability({
         };
         if (!ctx.confirmed)
             return preview("node.test-trigger", body);
-        return ctx.fetch("/jobs", { method: "POST", body });
+        try {
+            return await ctx.fetch("/jobs", { method: "POST", body });
+        }
+        catch (err) {
+            const errorObj = err;
+            if (errorObj?.status === 409 || errorObj?.message?.includes("409")) {
+                const detail = errorObj.detail ||
+                    "Node is busy: a test or benchmark job is already running on this node.";
+                throw new Error(detail);
+            }
+            throw err;
+        }
     },
 });
 export const nodeTestResultInput = z.object({
@@ -329,6 +363,8 @@ export const nodeBenchmarkCapability = defineStaffMcpCapability({
 export const nodeDeployInput = z.object({
     nodeId: z.string(),
     targetTenantId: z.string(),
+    commerceReservationId: z.string().optional(),
+    commerce_reservation_id: z.string().optional(),
     targetAuthUserId: z.string().optional(),
     networkMode: z.enum(["public", "private"]).optional(),
     notes: z.string().max(2000).optional(),
@@ -344,8 +380,10 @@ export const nodeDeployCapability = defineStaffMcpCapability({
     input: nodeDeployInput,
     execute: async (ctx, input) => {
         const parsed = nodeDeployInput.parse(input);
+        const reservationId = parsed.commerceReservationId ?? parsed.commerce_reservation_id;
         const body = {
             target_tenant_id: parsed.targetTenantId,
+            ...(reservationId ? { commerce_reservation_id: reservationId } : {}),
             ...mapBody(parsed, {
                 targetAuthUserId: "target_auth_user_id",
                 networkMode: "network_mode",
@@ -444,6 +482,41 @@ export const nodeAdminKeyCapability = defineStaffMcpCapability({
         });
     },
 });
+export const nodeOperatorTransferInput = z.object({
+    nodeId: z.string(),
+    operatorId: z.string(),
+    operatorSlug: z.string(),
+    facilityId: z.string().optional(),
+    reason: z.string().optional(),
+    confirm: z.boolean().optional(),
+});
+export const nodeOperatorTransferCapability = defineStaffMcpCapability({
+    id: "node.operator-transfer",
+    domain: "fleet",
+    roles: ["admin"],
+    description: "Internal staff only: transfer a node's ownership to a different operator/facility in Orchestrator. Requires confirm: true.",
+    mutation: "preview-confirm",
+    http: { method: "POST", path: "/internal/nodes/{nodeId}/transfer" },
+    input: nodeOperatorTransferInput,
+    execute: async (ctx, input) => {
+        const parsed = nodeOperatorTransferInput.parse(input);
+        const body = {
+            operator_id: parsed.operatorId,
+            operator_slug: parsed.operatorSlug,
+            ...mapBody(parsed, {
+                facilityId: "facility_id",
+                reason: "reason",
+            }),
+        };
+        if (!ctx.confirmed) {
+            return preview("node.operator-transfer", { nodeId: parsed.nodeId, ...body });
+        }
+        return ctx.fetch(`/internal/nodes/${seg(parsed.nodeId)}/transfer`, {
+            method: "POST",
+            body,
+        });
+    },
+});
 export const staffFleetCapabilities = [
     enrollmentTokenRevokeCapability,
     operatorCreateCapability,
@@ -453,7 +526,6 @@ export const staffFleetCapabilities = [
     facilityUpdateCapability,
     nodeShowCapability,
     nodeDetailsUpdateCapability,
-    nodeReserveListingCapability,
     nodeTestTriggerCapability,
     nodeTestResultCapability,
     nodeBenchmarkCapability,
@@ -462,4 +534,5 @@ export const staffFleetCapabilities = [
     nodeRebootCapability,
     nodeHardResetCapability,
     nodeAdminKeyCapability,
+    nodeOperatorTransferCapability,
 ];

package/vendor/capabilities/capabilities/staff-shared.d.ts

@@ -16,3 +16,32 @@ export declare function seg(value: string): string;
  * `WebApiError`, say), so read the status structurally.
  */
 export declare function statusOf(error: unknown): number | undefined;
+/**
+ * Read a resource's current optimistic-concurrency version.
+ *
+ * Commerce rejects a PATCH or lifecycle action whose `version` is absent or
+ * non-positive ("missing version" / "version must be positive"), but no staff
+ * caller has that number to hand. Read it back when it was not supplied, and
+ * only once confirmed so a preview stays a pure dry run.
+ */
+export declare function resolveVersion(ctx: {
+    fetch: (path: string, init: {
+        method: string;
+    }) => Promise<unknown>;
+    confirmed?: boolean;
+}, path: string, provided?: number): Promise<number>;
+/**
+ * Require a commerce identifier, named by this tool's own parameter.
+ *
+ * A malformed UUID never reaches a commerce handler's validation: Go fails the
+ * JSON decode first and answers with a bare "invalid request body" that names
+ * no field at all.
+ */
+export declare function requireUuid(value: string | undefined, field: string): string;
+/**
+ * The human-readable text a transport failure carries, wherever it put it.
+ *
+ * Mirrors how the MCP surface renders an error so a capability can rewrite
+ * that same string before it reaches the caller.
+ */
+export declare function errorTextOf(error: unknown): string;

package/vendor/capabilities/capabilities/staff-shared.js

@@ -32,3 +32,67 @@ export function statusOf(error) {
     }
     return undefined;
 }
+/**
+ * Read a resource's current optimistic-concurrency version.
+ *
+ * Commerce rejects a PATCH or lifecycle action whose `version` is absent or
+ * non-positive ("missing version" / "version must be positive"), but no staff
+ * caller has that number to hand. Read it back when it was not supplied, and
+ * only once confirmed so a preview stays a pure dry run.
+ */
+export async function resolveVersion(ctx, path, provided) {
+    if (provided && provided > 0)
+        return provided;
+    if (!ctx.confirmed)
+        return 1;
+    try {
+        const current = (await ctx.fetch(path, { method: "GET" }));
+        if (typeof current?.version === "number" && current.version > 0)
+            return current.version;
+    }
+    catch {
+        // Fall through: send 1 and let commerce report the conflict, which names
+        // the expected version, rather than failing on a lookup the caller can't see.
+    }
+    return 1;
+}
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Require a commerce identifier, named by this tool's own parameter.
+ *
+ * A malformed UUID never reaches a commerce handler's validation: Go fails the
+ * JSON decode first and answers with a bare "invalid request body" that names
+ * no field at all.
+ */
+export function requireUuid(value, field) {
+    const trimmed = (value ?? "").trim();
+    if (!trimmed)
+        throw new Error(`${field} is required.`);
+    if (!UUID_PATTERN.test(trimmed)) {
+        throw new Error(`${field} must be a UUID; received ${JSON.stringify(trimmed)}.`);
+    }
+    return trimmed;
+}
+/**
+ * The human-readable text a transport failure carries, wherever it put it.
+ *
+ * Mirrors how the MCP surface renders an error so a capability can rewrite
+ * that same string before it reaches the caller.
+ */
+export function errorTextOf(error) {
+    if (error && typeof error === "object" && "detail" in error) {
+        const detail = error.detail;
+        if (typeof detail === "string" && detail)
+            return detail;
+        if (detail && typeof detail === "object") {
+            for (const key of ["summary", "message", "error", "reason"]) {
+                const value = detail[key];
+                if (typeof value === "string" && value)
+                    return value;
+            }
+        }
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}

package/vendor/capabilities/index.d.ts

@@ -8,8 +8,8 @@ export { createListingCapability, listingCreateInput, listCatalogTermsCapability
 export { userCapabilities, usersQueryCapability } from "./capabilities/users.ts";
 export { kubernetesCapabilities, slurmCapabilities } from "./capabilities/clusters.ts";
 export { logsLatestCapability, logsTailCapability, observabilityCapabilities, telemetryLatestCapability, telemetryTailCapability, } from "./capabilities/observability.ts";
-export { enrollmentTokenRevokeCapability, enrollmentTokenRevokeInput, facilityCreateCapability, facilityCreateInput, facilityUpdateCapability, facilityUpdateInput, nodeAdminKeyCapability, nodeAdminKeyInput, nodeBenchmarkCapability, nodeBenchmarkInput, nodeDeployCapability, nodeDeployInput, nodeDetailsUpdateCapability, nodeDetailsUpdateInput, nodeHardResetCapability, nodeHardResetInput, nodeRebootCapability, nodeRebootInput, nodeReserveListingCapability, nodeReserveListingInput, nodeShowCapability, nodeShowInput, nodeTestResultCapability, nodeTestResultInput, nodeTestTriggerCapability, nodeTestTriggerInput, nodeUpdateCapability, nodeUpdateInput, operatorCreateCapability, operatorCreateInput, operatorDeleteCapability, operatorDeleteInput, operatorUpdateCapability, operatorUpdateInput, staffFleetCapabilities, } from "./capabilities/staff-fleet.ts";
-export { bidAcceptCapability, bidAcceptInput, bidRejectCapability, bidRejectInput, inventoryUpdateCapability, inventoryUpdateInput, reservationCancelCapability, reservationCancelInput, reservationMachinesListCapability, reservationMachinesListInput, reservationPublishCapability, reservationPublishInput, reservationSshKeyAddCapability, reservationSshKeyAddInput, reservationSshKeyRemoveCapability, reservationSshKeyRemoveInput, reservationTransferCapability, reservationTransferInput, staffCommerceCapabilities, tenantCreditProfileShowCapability, tenantCreditProfileShowInput, } from "./capabilities/staff-commerce.ts";
+export { enrollmentTokenRevokeCapability, enrollmentTokenRevokeInput, facilityCreateCapability, facilityCreateInput, facilityUpdateCapability, facilityUpdateInput, nodeAdminKeyCapability, nodeAdminKeyInput, nodeBenchmarkCapability, nodeBenchmarkInput, nodeDeployCapability, nodeDeployInput, nodeDetailsUpdateCapability, nodeDetailsUpdateInput, nodeHardResetCapability, nodeHardResetInput, nodeOperatorTransferCapability, nodeOperatorTransferInput, nodeRebootCapability, nodeRebootInput, nodeShowCapability, nodeShowInput, nodeTestResultCapability, nodeTestResultInput, nodeTestTriggerCapability, nodeTestTriggerInput, nodeUpdateCapability, nodeUpdateInput, operatorCreateCapability, operatorCreateInput, operatorDeleteCapability, operatorDeleteInput, operatorUpdateCapability, operatorUpdateInput, staffFleetCapabilities, } from "./capabilities/staff-fleet.ts";
+export { bidShowCapability, bidShowInput, bidAcceptCapability, bidAcceptInput, bidRejectCapability, bidRejectInput, billingInvoicesListCapability, billingInvoicesListInput, inventoryDelistCapability, inventoryDelistInput, inventoryUpdateCapability, inventoryUpdateInput, reservationActivateCapability, reservationActivateInput, reservationCancelCapability, reservationCancelInput, reservationCompleteCapability, reservationCompleteInput, reservationDraftCreateCapability, reservationDraftCreateInput, reservationListCapability, reservationListInput, reservationMachinesListCapability, reservationMachinesListInput, reservationPublishCapability, reservationPublishInput, reservationShowCapability, reservationShowInput, reservationSshKeyAddCapability, reservationSshKeyAddInput, reservationSshKeyRemoveCapability, reservationSshKeyRemoveInput, reservationTransferCapability, reservationTransferInput, reservationUpdateCapability, reservationUpdateInput, staffCommerceCapabilities, tenantCreditProfileShowCapability, tenantCreditProfileShowInput, } from "./capabilities/staff-commerce.ts";
 export { sshKeyAddCapability, sshKeyAddInput, sshKeyPushCapability, sshKeyPushInput, sshKeyRevokeCapability, sshKeyRevokeInput, staffAccessCapabilities, } from "./capabilities/staff-access.ts";
 export { CLIENTS, parseRole, roleAtLeast, ROLES, type ClientKind, type Role } from "./role.ts";
 export { bindHardwareFields, HARDWARE_CATALOG_PATH, HARDWARE_KINDS, HARDWARE_LISTING_FIELDS, HARDWARE_LISTING_FILTERS, loadHardwareCatalog, looksLikeSpecDump, normalizeCatalogQuery, parseHardwareCatalog, projectCatalogTerms, proposeListingPayload, resolveCatalogTerm, UNRESOLVED_CATALOG_HINT, type CatalogBindResult, type CatalogTerm, type HardwareCatalog, type HardwareKind, type ResolvedCatalogTerm, } from "./spec-catalog.ts";

package/vendor/capabilities/index.js

@@ -8,8 +8,8 @@ export { createListingCapability, listingCreateInput, listCatalogTermsCapability
 export { userCapabilities, usersQueryCapability } from "./capabilities/users.js";
 export { kubernetesCapabilities, slurmCapabilities } from "./capabilities/clusters.js";
 export { logsLatestCapability, logsTailCapability, observabilityCapabilities, telemetryLatestCapability, telemetryTailCapability, } from "./capabilities/observability.js";
-export { enrollmentTokenRevokeCapability, enrollmentTokenRevokeInput, facilityCreateCapability, facilityCreateInput, facilityUpdateCapability, facilityUpdateInput, nodeAdminKeyCapability, nodeAdminKeyInput, nodeBenchmarkCapability, nodeBenchmarkInput, nodeDeployCapability, nodeDeployInput, nodeDetailsUpdateCapability, nodeDetailsUpdateInput, nodeHardResetCapability, nodeHardResetInput, nodeRebootCapability, nodeRebootInput, nodeReserveListingCapability, nodeReserveListingInput, nodeShowCapability, nodeShowInput, nodeTestResultCapability, nodeTestResultInput, nodeTestTriggerCapability, nodeTestTriggerInput, nodeUpdateCapability, nodeUpdateInput, operatorCreateCapability, operatorCreateInput, operatorDeleteCapability, operatorDeleteInput, operatorUpdateCapability, operatorUpdateInput, staffFleetCapabilities, } from "./capabilities/staff-fleet.js";
-export { bidAcceptCapability, bidAcceptInput, bidRejectCapability, bidRejectInput, inventoryUpdateCapability, inventoryUpdateInput, reservationCancelCapability, reservationCancelInput, reservationMachinesListCapability, reservationMachinesListInput, reservationPublishCapability, reservationPublishInput, reservationSshKeyAddCapability, reservationSshKeyAddInput, reservationSshKeyRemoveCapability, reservationSshKeyRemoveInput, reservationTransferCapability, reservationTransferInput, staffCommerceCapabilities, tenantCreditProfileShowCapability, tenantCreditProfileShowInput, } from "./capabilities/staff-commerce.js";
+export { enrollmentTokenRevokeCapability, enrollmentTokenRevokeInput, facilityCreateCapability, facilityCreateInput, facilityUpdateCapability, facilityUpdateInput, nodeAdminKeyCapability, nodeAdminKeyInput, nodeBenchmarkCapability, nodeBenchmarkInput, nodeDeployCapability, nodeDeployInput, nodeDetailsUpdateCapability, nodeDetailsUpdateInput, nodeHardResetCapability, nodeHardResetInput, nodeOperatorTransferCapability, nodeOperatorTransferInput, nodeRebootCapability, nodeRebootInput, nodeShowCapability, nodeShowInput, nodeTestResultCapability, nodeTestResultInput, nodeTestTriggerCapability, nodeTestTriggerInput, nodeUpdateCapability, nodeUpdateInput, operatorCreateCapability, operatorCreateInput, operatorDeleteCapability, operatorDeleteInput, operatorUpdateCapability, operatorUpdateInput, staffFleetCapabilities, } from "./capabilities/staff-fleet.js";
+export { bidShowCapability, bidShowInput, bidAcceptCapability, bidAcceptInput, bidRejectCapability, bidRejectInput, billingInvoicesListCapability, billingInvoicesListInput, inventoryDelistCapability, inventoryDelistInput, inventoryUpdateCapability, inventoryUpdateInput, reservationActivateCapability, reservationActivateInput, reservationCancelCapability, reservationCancelInput, reservationCompleteCapability, reservationCompleteInput, reservationDraftCreateCapability, reservationDraftCreateInput, reservationListCapability, reservationListInput, reservationMachinesListCapability, reservationMachinesListInput, reservationPublishCapability, reservationPublishInput, reservationShowCapability, reservationShowInput, reservationSshKeyAddCapability, reservationSshKeyAddInput, reservationSshKeyRemoveCapability, reservationSshKeyRemoveInput, reservationTransferCapability, reservationTransferInput, reservationUpdateCapability, reservationUpdateInput, staffCommerceCapabilities, tenantCreditProfileShowCapability, tenantCreditProfileShowInput, } from "./capabilities/staff-commerce.js";
 export { sshKeyAddCapability, sshKeyAddInput, sshKeyPushCapability, sshKeyPushInput, sshKeyRevokeCapability, sshKeyRevokeInput, staffAccessCapabilities, } from "./capabilities/staff-access.js";
 export { CLIENTS, parseRole, roleAtLeast, ROLES } from "./role.js";
 export { bindHardwareFields, HARDWARE_CATALOG_PATH, HARDWARE_KINDS, HARDWARE_LISTING_FIELDS, HARDWARE_LISTING_FILTERS, loadHardwareCatalog, looksLikeSpecDump, normalizeCatalogQuery, parseHardwareCatalog, projectCatalogTerms, proposeListingPayload, resolveCatalogTerm, UNRESOLVED_CATALOG_HINT, } from "./spec-catalog.js";