@ornncompute/cli 1.0.75 → 1.0.97

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

@@ -1,405 +0,0 @@
-import { z } from "zod";
-import { nativeTermsInput, nativeTermFields, listingWriteControls } from "./native-listing.js";
-import { defineCapability, preview } from "../capability.js";
-import { consent, idempotencyHeaders, microUsd, 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 pageLimit = z.coerce.number().int().min(1).max(200).optional();
-export const listingsListInput = z.object({
-    $positionals: positionals,
-    kind: z.enum(["primary", "secondary", "on_demand"]).optional(),
-    state: z.enum(["draft", "available", "held", "sold", "delisted"]).optional(),
-    sourceReservationId: z.string().uuid().optional(),
-    sourceListingId: z.string().uuid().optional(),
-    limit: z.coerce.number().int().min(1).max(100).optional(),
-    cursor: z.string().min(1).optional(),
-});
-export const listingsListCapability = defineCapability({
-    id: "listings.list",
-    domain: "listings",
-    roles: ["user"],
-    description: "List native capacity listings. Primary listings require organization approval. Returns capacityListingId, hardware, capacity and availability; when nextCursor is present, pass it back as cursor for the next page. Read listings.terms separately for prices and durations.",
-    mutation: "read",
-    http: { method: "GET", path: "/commerce/v2/listings" },
-    input: listingsListInput,
-    cli: {
-        command: ["capacity-offers", "list"],
-        vnext: help(["capacity-offers", "list"], "List capacity parents with bounded pagination; read their financial terms separately.", "ornn capacity-offers list [--kind primary|secondary|on_demand] [--source-reservation-id <id>] [--limit <1-100>] [--cursor <opaque>]", "ornn capacity-offers list --limit 50 --format json", ["capacity-offers show", "capacity-offers terms", "capacity-offers availability"], 20, ["opaque page cursor"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const parsed = listingsListInput.parse(input ?? {});
-        return ctx.fetch(`/commerce/v2/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 native capacity listing. Returns capacityListingId, hardware, capacity and availability; use listings.terms for financial choices.",
-    mutation: "read",
-    http: { method: "GET", path: "/commerce/v2/listings/{listingId}" },
-    input: listingShowInput,
-    cli: {
-        command: ["capacity-offers", "show"],
-        vnext: help(["capacity-offers", "show"], "Inspect one listing's hardware, capacity and availability.", "ornn capacity-offers show --listing-id <id>", "ornn capacity-offers show --listing-id <id> --format json", ["capacity-offers list", "capacity-offers terms", "capacity-offers availability"], 21, ["listing ID"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const parsed = listingShowInput.parse(input);
-        return ctx.fetch(`/commerce/v2/listings/${seg(parsed.listingId)}`, { method: "GET" });
-    },
-});
-export const listingTermsCapability = defineCapability({
-    id: "listings.terms",
-    domain: "listings",
-    roles: ["user"],
-    description: "Read a capacity listing's advertised financial terms. Each term returns listingTermsId, capacityListingId, pricePerGpuHourMicroUsd, duration bounds, downPaymentCents and renewable. Use the parent's capacityListingId as listingId. Prices are gross integer micro-USD per GPU-hour, the price reservations.purchase expects.",
-    mutation: "read",
-    http: { method: "GET", path: "/commerce/v2/listings/{listingId}/terms" },
-    input: listingShowInput,
-    cli: {
-        command: ["capacity-offers", "terms"],
-        vnext: help(["capacity-offers", "terms"], "Read the advertised financial terms for a capacity listing.", "ornn capacity-offers terms --listing-id <id>", "ornn capacity-offers terms --listing-id <id> --format json", ["capacity-offers show", "offers post", "reservations buy"], 22, ["capacityListingId from capacity-offers list or show"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const parsed = listingShowInput.parse(input);
-        return ctx.fetch(`/commerce/v2/listings/${seg(parsed.listingId)}/terms`, { method: "GET" });
-    },
-});
-export const listingAvailabilityInput = z.object({
-    $positionals: positionals,
-    listingId: z.string().uuid(),
-    from: z.iso
-        .datetime({ offset: true })
-        .optional()
-        .describe("RFC 3339 start of the range to read. Defaults to now or the listing's start."),
-    to: z.iso
-        .datetime({ offset: true })
-        .optional()
-        .describe("RFC 3339 end of the range to read. Defaults to the listing's end."),
-});
-export const listingAvailabilityCapability = defineCapability({
-    id: "listings.availability",
-    domain: "listings",
-    roles: ["user"],
-    description: "Read how much of a capacity listing is free to book over time: windows of startsAt, endsAt, gpus and nodes (the nodes with any GPU free) from now until the listing ends (for an open-ended listing, 30 days ahead for a Market listing and far enough for any term of a Reserve listing), optionally narrowed by from and to. Use the parent's capacityListingId as listingId.",
-    mutation: "read",
-    http: { method: "GET", path: "/v1/markets/listings/{listingId}/availability" },
-    input: listingAvailabilityInput,
-    cli: {
-        command: ["capacity-offers", "availability"],
-        vnext: help(["capacity-offers", "availability"], "Show how many of a listing's nodes are free over time.", "ornn capacity-offers availability --listing-id <id> [--from <time>] [--to <time>]", "ornn capacity-offers availability --listing-id <id> --format json", ["capacity-offers terms", "reservations buy", "offers post"], 23, ["capacityListingId from capacity-offers list or show"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const parsed = listingAvailabilityInput.parse(input);
-        return ctx.fetch(`/v1/markets/listings/${seg(parsed.listingId)}/availability${query({
-            from: parsed.from,
-            to: parsed.to,
-        })}`, { method: "GET" });
-    },
-});
-export const listingRelistInput = z.strictObject({
-    $positionals: positionals,
-    reservationId: z.string().uuid(),
-    startsAt: z.iso.datetime({ offset: true }),
-    endsAt: z.iso.datetime({ offset: true }),
-    nodeCount: z.coerce.number().int().positive(),
-    terms: nativeTermsInput,
-    idempotencyKey: z.string().min(1).max(200).optional(),
-    confirm: z.boolean().optional(),
-    yes: z.boolean().optional(),
-});
-export const listingRelistCapability = defineCapability({
-    id: "listings.relist",
-    domain: "listings",
-    roles: ["user"],
-    description: "Relist whole nodes of a reservation's capacity using a native availability window, nodeCount and financial terms. Buyers run on nodes Ornn assigns when their rental starts..",
-    mutation: "preview-confirm",
-    http: { method: "POST", path: "/commerce/reservations/{reservationId}/relist" },
-    input: listingRelistInput,
-    cli: {
-        command: ["capacity-offers", "relist"],
-        vnext: help(["capacity-offers", "relist"], "Relist reserved capacity with explicit financial terms.", "ornn capacity-offers relist --reservation-id UUID --node-count COUNT --starts-at TIME --ends-at TIME --terms JSON", "ornn capacity-offers relist --reservation-id UUID --node-count 1 --starts-at TIME --ends-at TIME --terms JSON --idempotency-key KEY  --format json", ["capacity-offers terms", "capacity-offers delist"], 24, ["reservation ID"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const { $positionals: _, reservationId, confirm: _confirm, yes: _yes, idempotencyKey, ...body } = listingRelistInput.parse(input);
-        const gate = await consent(ctx, "listings.relist", "Relist capacity", [
-            { label: "Reservation", value: reservationId },
-            { label: "Capacity and financial terms", value: JSON.stringify(body) },
-        ], { reservationId, ...body });
-        if (gate)
-            return gate;
-        return ctx.fetch(`/commerce/reservations/${seg(reservationId)}/relist`, {
-            method: "POST",
-            body,
-            headers: idempotencyHeaders(ctx, idempotencyKey),
-        });
-    },
-});
-export const listingUpdateInput = z
-    .object({
-    $positionals: positionals,
-    listingId: z.string().uuid(),
-    listingTermsId: z.string().uuid(),
-    ...nativeTermFields,
-    ...listingWriteControls,
-})
-    .strict();
-export const listingUpdateCapability = defineCapability({
-    id: "listings.update",
-    domain: "listings",
-    roles: ["admin"],
-    description: "Staff only: edit one advertised native financial term with its complete financial fields. Reuse idempotencyKey on retries..",
-    mutation: "preview-confirm",
-    http: { method: "PATCH", path: "/commerce/v2/listings/{listingId}/terms/{listingTermsId}" },
-    input: listingUpdateInput,
-    cli: {
-        command: ["admin", "capacity-offers", "update"],
-        vnext: {
-            ...help(["admin", "capacity-offers", "update"], "Edit one advertised financial term as staff.", "ornn admin capacity-offers update --listing-id UUID --listing-terms-id UUID --min-duration-hours HOURS --max-duration-hours HOURS --price-per-gpu-hour-micro-usd RATE --renewable true|false --idempotency-key KEY [--type reserved|spot|on-demand] [--down-payment-cents CENTS]", "Requires an eligible human terminal; reuse --idempotency-key on retries.", ["capacity-offers terms"], 25),
-            audience: "admin",
-        },
-    },
-    slack: false,
-    mcp: false,
-    execute: async (ctx, input) => {
-        const { $positionals: _, listingId, listingTermsId, confirm: _confirm, idempotencyKey, ...body } = listingUpdateInput.parse(input);
-        if (!ctx.confirmed)
-            return preview("listings.update", { listingId, listingTermsId, ...body });
-        return ctx.fetch(`/commerce/v2/listings/${seg(listingId)}/terms/${seg(listingTermsId)}`, {
-            method: "PATCH",
-            body,
-            headers: idempotencyHeaders(ctx, idempotencyKey),
-        });
-    },
-});
-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..",
-    mutation: "preview-confirm",
-    http: { method: "POST", path: "/commerce/v2/listings/{listingId}/delist" },
-    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>  --format json", ["capacity-offers relist"], 26, ["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/v2/listings/${seg(parsed.listingId)}/delist`, { method: "POST" });
-    },
-});
-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. When nextCursor is present, pass it back as cursor for the next page.",
-    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"], 27, ["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"], 28, ["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"], 29, ["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 reservationPurchaseInput = z.object({
-    $positionals: positionals,
-    listingId: z
-        .string()
-        .uuid()
-        .describe("The relisted (secondary) listing's capacityListingId, from listings.list."),
-    listingTermId: z
-        .string()
-        .uuid()
-        .describe("The listingTermsId of the listing's term, from listings.terms."),
-    nodeCount: z.coerce
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe("Whole nodes to book for the window. Defaults to every node the listing sells."),
-    startsAt: z.iso
-        .datetime({ offset: true })
-        .describe("RFC 3339 start of the window, in whole seconds, inside the listing and not in the past."),
-    endsAt: z.iso
-        .datetime({ offset: true })
-        .describe("RFC 3339 end of the window, at least an hour after the start and within the term's duration range, or at the listing's end."),
-    pricePerGpuHourMicroUsd: microUsd.describe("The term's price from listings.terms, in micro-USD per GPU-hour. A changed price refuses the purchase."),
-    idempotencyKey: z.string().min(1).max(200).optional(),
-    confirm: z.boolean().optional(),
-});
-export const reservationPurchaseCapability = defineCapability({
-    id: "reservations.purchase",
-    domain: "reservations",
-    roles: ["user"],
-    description: "Book a window of a relisted (secondary) listing on one of its terms at the term's price. The GPUs are held for you until the window starts; then it becomes your reservation, with the booking's ID. Nothing is charged when you book. Primary listings take offers instead (offers.post)..",
-    mutation: "preview-confirm",
-    http: { method: "POST", path: "/v1/markets/bookings" },
-    input: reservationPurchaseInput,
-    cli: {
-        command: ["reservations", "buy"],
-        vnext: help(["reservations", "buy"], "Book a window of relisted capacity at its term's price.", "ornn reservations buy --listing-id <id> --listing-term-id <id> --starts-at <time> --ends-at <time> --price-per-gpu-hour-micro-usd <n> [--node-count <n>]", "ornn reservations buy --listing-id <id> --listing-term-id <id> --starts-at <time> --ends-at <time> --price-per-gpu-hour-micro-usd 4000000 --idempotency-key <key>  --format json", ["capacity-offers availability", "capacity-offers terms", "reservations show"], 30, ["listingTermsId from capacity-offers terms"]),
-    },
-    slack: false,
-    execute: async (ctx, input) => {
-        const parsed = reservationPurchaseInput.parse(input);
-        const body = {
-            legs: [
-                {
-                    listingId: parsed.listingId,
-                    listingTermId: parsed.listingTermId,
-                    ...(parsed.nodeCount !== undefined ? { nodes: parsed.nodeCount } : {}),
-                    startsAt: parsed.startsAt,
-                    endsAt: parsed.endsAt,
-                    pricePerGpuHourMicroUsd: parsed.pricePerGpuHourMicroUsd,
-                },
-            ],
-        };
-        const gate = await consent(ctx, "reservations.purchase", "Book relisted window", [
-            { label: "Listing term", value: parsed.listingTermId },
-            {
-                label: "Nodes",
-                value: parsed.nodeCount !== undefined ? String(parsed.nodeCount) : "Every node on the listing",
-            },
-            { label: "Window", value: `${parsed.startsAt} to ${parsed.endsAt}` },
-            { label: "Price", value: microUsdLabel(parsed.pricePerGpuHourMicroUsd) },
-            { label: "Payment", value: "Nothing is charged when you book." },
-        ], body);
-        if (gate)
-            return gate;
-        return ctx.fetch("/v1/markets/bookings", {
-            method: "POST",
-            body,
-            headers: idempotencyHeaders(ctx, parsed.idempotencyKey),
-        });
-    },
-});
-export const commerceMarketCapabilities = [
-    listingsListCapability,
-    listingShowCapability,
-    listingTermsCapability,
-    listingAvailabilityCapability,
-    listingRelistCapability,
-    listingUpdateCapability,
-    listingDelistCapability,
-    reservationsListCapability,
-    reservationsShowCapability,
-    reservationInvoicesCapability,
-    reservationPurchaseCapability,
-];