@ornncompute/cli 1.0.25 → 1.0.34

package/vendor/capabilities/capabilities/commerce-market.js

@@ -0,0 +1,330 @@
+import { z } from "zod";
+import { defineCapability } from "../capability.js";
+import { consent, flag, idempotencyHeaders, microUsdLabel, positionals, query, seg, } from "./market-shared.js";
+// Commerce market verbs: one capability per role-aware `/commerce` route.
+// Commerce decides from the caller's session what each listing or
+// reservation reveals; these verbs return its JSON unchanged.
+function help(command, outcome, human, automation, related, order, acceptedReferences = []) {
+    return {
+        arguments: "semantic",
+        audience: "customer",
+        category: "resource",
+        command,
+        outcome,
+        human,
+        automation,
+        acceptedReferences,
+        related,
+        order,
+    };
+}
+const microUsd = z.coerce.number().int().positive();
+const pageLimit = z.coerce.number().int().min(1).max(200).optional();
+const nodeIdList = z.preprocess((value) => typeof value === "string"
+    ? value
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean)
+    : value, z.array(z.string().uuid()).min(1));
+export const listingsListInput = z.object({
+    $positionals: positionals,
+    kind: z.enum(["primary", "secondary"]).optional(),
+    state: z.enum(["available", "internal", "delisted"]).optional(),
+    sourceReservationId: z.string().uuid().optional(),
+    sourceListingId: z.string().uuid().optional(),
+    limit: pageLimit,
+    cursor: z.string().min(1).optional(),
+});
+export const listingsListCapability = defineCapability({
+    id: "listings.list",
+    domain: "listings",
+    roles: ["user"],
+    description: "List Commerce listings. Primary listings are shown to approved organizations; secondary listings (relists) to every signed-in organization. Prices are micro-USD per GPU-hour.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/listings" },
+    input: listingsListInput,
+    cli: {
+        command: ["capacity-offers", "list"],
+        vnext: help(["capacity-offers", "list"], "List primary and secondary listings with bounded pagination and no supplier provenance.", "ornn capacity-offers list [--kind primary|secondary] [--source-reservation-id <id>] [--limit <1-200>] [--cursor <opaque>]", "ornn capacity-offers list --limit 50 --format json", ["capacity-offers show", "schedules list"], 20, ["opaque page cursor"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = listingsListInput.parse(input ?? {});
+        return ctx.fetch(`/commerce/listings${query({
+            kind: parsed.kind,
+            state: parsed.state,
+            sourceReservationId: parsed.sourceReservationId,
+            sourceListingId: parsed.sourceListingId,
+            limit: parsed.limit,
+            cursor: parsed.cursor,
+        })}`, { method: "GET" });
+    },
+});
+export const listingShowInput = z.object({
+    $positionals: positionals,
+    listingId: z.string().uuid(),
+});
+export const listingShowCapability = defineCapability({
+    id: "listings.show",
+    domain: "listings",
+    roles: ["user"],
+    description: "Show one Commerce listing: specs, window, node count and its buyer price.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/listings/{listingId}" },
+    input: listingShowInput,
+    cli: {
+        command: ["capacity-offers", "show"],
+        vnext: help(["capacity-offers", "show"], "Inspect one listing's hardware, facility, window and price.", "ornn capacity-offers show --listing-id <id>", "ornn capacity-offers show --listing-id <id> --format json", ["capacity-offers list", "schedules show"], 21, ["listing ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = listingShowInput.parse(input);
+        return ctx.fetch(`/commerce/listings/${seg(parsed.listingId)}`, { method: "GET" });
+    },
+});
+export const listingRelistInput = z
+    .object({
+    $positionals: positionals,
+    sourceReservationId: z
+        .string()
+        .uuid()
+        .optional()
+        .describe("A confirmed or active schedule reservation you hold."),
+    sourceListingId: z
+        .string()
+        .uuid()
+        .optional()
+        .describe("A primary listing you own (suppliers relist their own listings)."),
+    nodeIds: nodeIdList.describe("The nodes to relist: a subset of the source's nodes (comma-separated on the CLI)."),
+    startsAt: z.string().min(1).describe("RFC 3339 start, inside the source's window."),
+    endsAt: z.string().min(1).describe("RFC 3339 end, inside the source's window."),
+    askPricePerGpuHourMicroUsd: microUsd.describe("Asking price in micro-USD per GPU-hour, the listing's only price: buyers buy any open window at it, and idle time sells as spot at it."),
+    sellAtMarketFirst: flag
+        .default(false)
+        .describe("Sell each node's GPUs into resting spot bids before asking at the asking price."),
+    idempotencyKey: z.string().min(1).max(200).optional(),
+    confirm: z.boolean().optional(),
+})
+    .refine((relist) => (relist.sourceReservationId === undefined) !== (relist.sourceListingId === undefined), {
+    message: "Give exactly one of sourceReservationId or sourceListingId.",
+    path: ["sourceReservationId"],
+});
+export const listingRelistCapability = defineCapability({
+    id: "listings.relist",
+    domain: "listings",
+    roles: ["user"],
+    description: "Relist a time slice and/or node subset of a schedule reservation you hold (or a primary listing you own) as a secondary listing with an asking price. " +
+        "Buyers buy any open window of it at the asking price, and its unsold time goes on the spot book. Fails with node_window_sold if those nodes are already sold for part of the window, or relist_overlaps if another live relist of those nodes overlaps it. Requires confirm: true.",
+    mutation: "preview-confirm",
+    http: { method: "POST", path: "/commerce/listings" },
+    input: listingRelistInput,
+    cli: {
+        command: ["capacity-offers", "relist"],
+        vnext: help(["capacity-offers", "relist"], "Relist part of a reservation or primary listing you hold.", "ornn capacity-offers relist --source-reservation-id <id> --node-ids <id,...> --starts-at <time> --ends-at <time> --ask-price-per-gpu-hour-micro-usd <n> [--sell-at-market-first true]", "ornn capacity-offers relist --source-reservation-id <id> --node-ids <id> --starts-at <time> --ends-at <time> --ask-price-per-gpu-hour-micro-usd 2500000 --yes --format json", ["capacity-offers update", "capacity-offers delist", "reservations show"], 23, ["reservation ID", "listing ID", "node ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = listingRelistInput.parse(input);
+        const body = {
+            ...(parsed.sourceReservationId ? { sourceReservationId: parsed.sourceReservationId } : {}),
+            ...(parsed.sourceListingId ? { sourceListingId: parsed.sourceListingId } : {}),
+            nodeIds: parsed.nodeIds,
+            startsAt: parsed.startsAt,
+            endsAt: parsed.endsAt,
+            askPricePerGpuHourMicroUsd: parsed.askPricePerGpuHourMicroUsd,
+            sellAtMarketFirst: parsed.sellAtMarketFirst,
+        };
+        const gate = await consent(ctx, "listings.relist", "Relist capacity", [
+            {
+                label: "Source",
+                value: parsed.sourceReservationId
+                    ? `reservation ${parsed.sourceReservationId}`
+                    : `listing ${parsed.sourceListingId}`,
+            },
+            { label: "Nodes", value: parsed.nodeIds.join(", ") },
+            { label: "Window", value: `${parsed.startsAt} to ${parsed.endsAt}` },
+            { label: "Asking price", value: microUsdLabel(parsed.askPricePerGpuHourMicroUsd) },
+            { label: "Sell at market first", value: parsed.sellAtMarketFirst ? "yes" : "no" },
+        ], body);
+        if (gate)
+            return gate;
+        return ctx.fetch("/commerce/listings", {
+            method: "POST",
+            body,
+            headers: idempotencyHeaders(ctx, parsed.idempotencyKey),
+        });
+    },
+});
+export const listingUpdateInput = z.object({
+    $positionals: positionals,
+    listingId: z.string().uuid(),
+    askPricePerGpuHourMicroUsd: microUsd,
+    confirm: z.boolean().optional(),
+});
+export const listingUpdateCapability = defineCapability({
+    id: "listings.update",
+    domain: "listings",
+    roles: ["user"],
+    description: "Change the asking price of a secondary listing you own, its only price. Windows bought later use the new price, and the listing's spot asks are re-sent at it. Requires confirm: true.",
+    mutation: "preview-confirm",
+    http: { method: "PATCH", path: "/commerce/listings/{listingId}" },
+    input: listingUpdateInput,
+    cli: {
+        command: ["capacity-offers", "update"],
+        vnext: help(["capacity-offers", "update"], "Change the asking price of a listing you relisted.", "ornn capacity-offers update --listing-id <id> --ask-price-per-gpu-hour-micro-usd <n>", "ornn capacity-offers update --listing-id <id> --ask-price-per-gpu-hour-micro-usd 2400000 --yes --format json", ["capacity-offers relist", "capacity-offers delist"], 24, ["listing ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = listingUpdateInput.parse(input);
+        const body = { askPricePerGpuHourMicroUsd: parsed.askPricePerGpuHourMicroUsd };
+        const gate = await consent(ctx, "listings.update", "Update listing asking price", [
+            { label: "Listing", value: parsed.listingId },
+            { label: "Asking price", value: microUsdLabel(body.askPricePerGpuHourMicroUsd) },
+        ], { listingId: parsed.listingId, ...body });
+        if (gate)
+            return gate;
+        return ctx.fetch(`/commerce/listings/${seg(parsed.listingId)}`, { method: "PATCH", body });
+    },
+});
+export const listingDelistInput = z.object({
+    $positionals: positionals,
+    listingId: z.string().uuid(),
+    confirm: z.boolean().optional(),
+});
+export const listingDelistCapability = defineCapability({
+    id: "listings.delist",
+    domain: "listings",
+    roles: ["user"],
+    description: "Delist a listing you own. Its unsold time leaves the market, its spot asks are cancelled and running spot reservations on it end. Windows already bought stay sold. Requires confirm: true.",
+    mutation: "preview-confirm",
+    http: { method: "DELETE", path: "/commerce/listings/{listingId}" },
+    input: listingDelistInput,
+    cli: {
+        command: ["capacity-offers", "delist"],
+        vnext: help(["capacity-offers", "delist"], "Delist a listing you relisted.", "ornn capacity-offers delist --listing-id <id>", "ornn capacity-offers delist --listing-id <id> --yes --format json", ["capacity-offers relist"], 25, ["listing ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = listingDelistInput.parse(input);
+        const gate = await consent(ctx, "listings.delist", "Delist listing", [
+            { label: "Listing", value: parsed.listingId },
+            {
+                label: "Consequence",
+                value: "Unsold time and spot asks leave the market; running spot reservations on it end.",
+            },
+        ], { listingId: parsed.listingId });
+        if (gate)
+            return gate;
+        return ctx.fetch(`/commerce/listings/${seg(parsed.listingId)}`, { method: "DELETE" });
+    },
+});
+export const reservationsListInput = z.object({
+    $positionals: positionals,
+    kind: z.enum(["schedule", "spot"]).optional(),
+    status: z
+        .enum([
+        "awaiting_down_payment",
+        "awaiting_payment",
+        "confirmed",
+        "active",
+        "completed",
+        "cancelled",
+    ])
+        .optional(),
+    listingId: z.string().uuid().optional().describe("Trades on a listing you own."),
+    limit: pageLimit,
+    cursor: z.string().min(1).optional(),
+});
+export const reservationsListCapability = defineCapability({
+    id: "reservations.list",
+    domain: "reservations",
+    roles: ["user"],
+    description: "List this organization's reservations, schedule and spot alike (a running spot reservation has no end time). With listingId, list the trades on a listing you own.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/reservations" },
+    input: reservationsListInput,
+    cli: {
+        command: ["reservations", "list"],
+        vnext: help(["reservations", "list"], "List your organization's schedule and spot reservations.", "ornn reservations list [--kind schedule|spot] [--status <status>] [--listing-id <id>] [--limit <1-200>] [--cursor <opaque>]", "ornn reservations list --format json", ["reservations show", "capacity-offers relist"], 26, ["opaque page cursor"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = reservationsListInput.parse(input ?? {});
+        return ctx.fetch(`/commerce/reservations${query({
+            kind: parsed.kind,
+            status: parsed.status,
+            listingId: parsed.listingId,
+            limit: parsed.limit,
+            cursor: parsed.cursor,
+        })}`, { method: "GET" });
+    },
+});
+export const reservationLookupInput = z.object({
+    $positionals: positionals,
+    reservationId: z.string().uuid(),
+});
+export const reservationsShowCapability = defineCapability({
+    id: "reservations.show",
+    domain: "reservations",
+    roles: ["user"],
+    description: "Show one reservation: kind, status, window, price and node count.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/reservations/{reservationId}" },
+    input: reservationLookupInput,
+    cli: {
+        command: ["reservations", "show"],
+        vnext: help(["reservations", "show"], "Inspect one reservation.", "ornn reservations show --reservation-id <id>", "ornn reservations show --reservation-id <id> --format json", ["reservations list", "reservations invoices"], 27, ["reservation ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = reservationLookupInput.parse(input);
+        return ctx.fetch(`/commerce/reservations/${seg(parsed.reservationId)}`, { method: "GET" });
+    },
+});
+export const reservationInvoicesCapability = defineCapability({
+    id: "reservations.invoices",
+    domain: "billing",
+    roles: ["user"],
+    description: "List a reservation's invoices: the down payment and each billing period, with status and amount in cents.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/reservations/{reservationId}/invoices" },
+    input: reservationLookupInput,
+    cli: {
+        command: ["reservations", "invoices"],
+        vnext: help(["reservations", "invoices"], "List one reservation's invoices.", "ornn reservations invoices --reservation-id <id>", "ornn reservations invoices --reservation-id <id> --format json", ["reservations show"], 28, ["reservation ID"]),
+    },
+    slack: false,
+    execute: async (ctx, input) => {
+        const parsed = reservationLookupInput.parse(input);
+        return ctx.fetch(`/commerce/reservations/${seg(parsed.reservationId)}/invoices`, {
+            method: "GET",
+        });
+    },
+});
+export const feesShowInput = z.object({ $positionals: positionals });
+export const feesShowCapability = defineCapability({
+    id: "fees.show",
+    domain: "billing",
+    roles: ["user"],
+    description: "Show the transaction fee on spot and secondary trades, in parts per million (1000000 = 100%). The side that takes a resting order pays it; primary schedules carry no transaction fee.",
+    mutation: "read",
+    http: { method: "GET", path: "/commerce/fees" },
+    input: feesShowInput,
+    cli: {
+        command: ["fees", "show"],
+        vnext: help(["fees", "show"], "Show the transaction fee on spot and secondary trades.", "ornn fees show", "ornn fees show --format json", ["spot bid", "offers post"], 29),
+    },
+    slack: false,
+    execute: async (ctx) => ctx.fetch("/commerce/fees", { method: "GET" }),
+});
+export const commerceMarketCapabilities = [
+    listingsListCapability,
+    listingShowCapability,
+    listingRelistCapability,
+    listingUpdateCapability,
+    listingDelistCapability,
+    reservationsListCapability,
+    reservationsShowCapability,
+    reservationInvoicesCapability,
+    feesShowCapability,
+];

package/vendor/capabilities/capabilities/fleet.js

@@ -1,3 +1,4 @@
+import { listSupplierOrganizations, listSupplierOrganizationPage } from "../supplier-directory.js";
 import { z } from "zod";
 import { defineCapability, preview } from "../capability.js";
 function queryPath(path, params) {
@@ -9,14 +10,20 @@ function queryPath(path, params) {
     return parts.length ? `${path}?${parts.join("&")}` : path;
 }
 const emptyInput = z.object({});
+const suppliersInput = z.object({
+    q: z.string().optional(),
+    offset: z.number().int().min(0).optional(),
+    limit: z.number().int().min(1).max(1000).optional(),
+});
 const facilitiesInput = z.object({
-    operator_id: z.string().optional(),
-    operator: z.string().optional(),
+    organization_id: z.string().optional(),
+    organizationId: z.string().optional(),
+    cursor: z.string().optional(),
+    limit: z.number().int().min(1).max(500).optional(),
 });
 const nodesInput = z.object({
-    operator_id: z.string().optional(),
-    operatorId: z.string().optional(),
-    operator: z.string().optional(),
+    organization_id: z.string().optional(),
+    organizationId: z.string().optional(),
     facility_id: z.string().optional(),
     facilityId: z.string().optional(),
     status: z.string().optional(),
@@ -42,29 +49,53 @@ const nodeExecInput = z.object({
 function nodeIdOf(input) {
     return (input.node_id || input.nodeId || "").trim();
 }
-export const listOperatorsCapability = defineCapability({
-    id: "operator.list",
+export const listSuppliersCapability = defineCapability({
+    id: "supplier.list",
     domain: "fleet",
     roles: ["admin"],
-    description: "List GPU operators (id, slug, display name, status). Resolve operator names with this before nodes.list.",
+    description: "List supplier organizations (id, name). Resolve supplier names to organization_id with this before nodes.list or facilities.list.",
     mutation: "read",
-    http: { method: "GET", path: "/provisioning/operators" },
-    slack: { parameters: { type: "object", properties: {} } },
-    input: emptyInput,
-    execute: async (ctx) => ctx.fetch("/provisioning/operators", { method: "GET" }),
+    http: { method: "GET", path: "/v1/organizations" },
+    slack: {
+        parameters: {
+            type: "object",
+            properties: {
+                q: { type: "string", description: "Search supplier names." },
+                offset: { type: "integer", description: "Use next_offset to fetch another page." },
+                limit: { type: "integer", description: "Page size (Slack maximum 10)." },
+            },
+        },
+    },
+    input: suppliersInput,
+    execute: async (ctx, input) => {
+        const parsed = suppliersInput.parse(input);
+        const paged = parsed.limit !== undefined || parsed.offset !== undefined || parsed.q !== undefined;
+        const limit = parsed.limit ?? 25;
+        const offset = parsed.offset ?? 0;
+        const rows = paged
+            ? await listSupplierOrganizationPage(ctx.fetch, { ...parsed, limit, offset })
+            : await listSupplierOrganizations(ctx.fetch);
+        return {
+            suppliers: rows.map((org) => ({ id: org.id, name: org.name })),
+            ...(paged && rows.length === limit ? { next_offset: offset + rows.length } : {}),
+        };
+    },
 });
 export const listFacilitiesCapability = defineCapability({
     id: "facilities.list",
     domain: "fleet",
     roles: ["admin"],
-    description: "List facilities (id, display name, region, operator). Optional operator_id filter. Resolve facility names with this before nodes.list.",
+    description: "List facilities (id, display name, region, supplier organization id). Optional organization_id filter. Resolve facility names with this before nodes.list.",
     mutation: "read",
     http: { method: "GET", path: "/provisioning/facilities" },
     slack: {
         parameters: {
             type: "object",
             properties: {
-                operator_id: { type: "string", description: "Commerce operator UUID." },
+                organization_id: {
+                    type: "string",
+                    description: "Optional supplier organization UUID from supplier.list.",
+                },
             },
         },
     },
@@ -72,7 +103,9 @@ export const listFacilitiesCapability = defineCapability({
     execute: async (ctx, input) => {
         const parsed = facilitiesInput.parse(input);
         return ctx.fetch(queryPath("/provisioning/facilities", {
-            operator_id: parsed.operator_id ?? parsed.operator,
+            organizationId: parsed.organization_id ?? parsed.organizationId,
+            cursor: parsed.cursor,
+            limit: parsed.limit === undefined ? undefined : String(parsed.limit),
         }), { method: "GET" });
     },
 });
@@ -80,22 +113,25 @@ export const listNodesCapability = defineCapability({
     id: "nodes.list",
     domain: "fleet",
     roles: ["user", "admin"],
-    description: "List nodes. Users see their own reserved machines. Admins see enrolled, ghost, and off-grid nodes. Call with no filters for the whole fleet. Optional email lists nodes for that user's organizations. Optional operator_id, facility_id, and status (ghost, off-grid, bare-metal) narrow the same list. Paginate large fleets with cursor + max: pass the response's next_cursor back as cursor to fetch the next page; next_cursor is omitted once the page is not full. Never invent nodes. Never print private keys.",
+    description: "List nodes. Users see their own reserved machines. Admins see enrolled, ghost, and off-grid nodes. Call with no filters for the whole fleet. Optional email lists nodes for that user's organizations. Optional organization_id (supplier), facility_id, and status (ghost, off-grid, bare-metal) narrow the same list. Paginate large fleets with cursor + max: pass the response's next_cursor back as cursor to fetch the next page; next_cursor is omitted once the page is not full. Never invent nodes. Never print private keys.",
     mutation: "read",
     http: { method: "GET", path: "/nodes" },
     slack: {
         parameters: {
             type: "object",
             properties: {
-                operator_id: {
+                organization_id: {
                     type: "string",
-                    description: "Optional commerce operator UUID from operator.list.",
+                    description: "Optional supplier organization UUID from supplier.list.",
                 },
                 facility_id: {
                     type: "string",
                     description: "Optional commerce facility UUID from facilities.list.",
                 },
-                email: { type: "string", description: "Optional. List nodes for this user's organizations." },
+                email: {
+                    type: "string",
+                    description: "Optional. List nodes for this user's organizations.",
+                },
                 status: {
                     type: "string",
                     enum: ["ghost", "off-grid", "bare-metal"],
@@ -123,7 +159,7 @@ export const listNodesCapability = defineCapability({
             return ctx.fetch(queryPath("/nodes", pagination), { method: "GET" });
         }
         return ctx.fetch(queryPath("/nodes", {
-            operator_id: parsed.operator_id ?? parsed.operatorId ?? parsed.operator,
+            organization_id: parsed.organization_id ?? parsed.organizationId,
             facility_id: parsed.facility_id ?? parsed.facilityId,
             status: parsed.status,
             email: parsed.email,
@@ -259,7 +295,7 @@ export const nodeTerminateCapability = defineCapability({
     },
 });
 export const fleetCapabilities = [
-    listOperatorsCapability,
+    listSuppliersCapability,
     listFacilitiesCapability,
     listNodesCapability,
     nodeOffGridCapability,