@ornncompute/cli 0.2.24 → 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,
+];