@ornncompute/cli 0.2.24 → 1.0.34

package/vendor/capabilities/cli-migrations.js

@@ -0,0 +1,261 @@
+export const CLI_MIGRATION_GUIDE_URL = "https://docs.ornn.com/cli#migrating-to-vnext";
+/**
+ * Retired top-level parser homes. These entries are guidance metadata only:
+ * they are never registered as executable CLI bindings.
+ */
+export const LEGACY_CLI_MIGRATIONS = [
+    { legacy: ["account"], replacement: "ornn context" },
+    { legacy: ["whoami"], replacement: "ornn context" },
+    { legacy: ["catalog", "search"], replacement: "ornn capacity-offers list" },
+    { legacy: ["gpu-types"], replacement: "ornn capacity-offers list" },
+    { legacy: ["availability", "list"], replacement: "ornn capacity-offers list" },
+    { legacy: ["availability", "forecast"], replacement: "ornn schedules list" },
+    { legacy: ["availability", "show"], replacement: "ornn capacity-offers show" },
+    { legacy: ["listing", "list"], replacement: "ornn capacity-offers list" },
+    { legacy: ["listing", "forecast"], replacement: "ornn schedules list" },
+    { legacy: ["listing", "show"], replacement: "ornn capacity-offers show" },
+    { legacy: ["listings", "list"], replacement: "ornn capacity-offers list" },
+    { legacy: ["listings", "forecast"], replacement: "ornn schedules list" },
+    { legacy: ["listings", "show"], replacement: "ornn capacity-offers show" },
+    { legacy: ["listings", "create"], replacement: "ornn admin capacity-offers create" },
+    { legacy: ["buy"], replacement: "ornn offers post" },
+    { legacy: ["bid", "create"], replacement: "ornn spot bid" },
+    { legacy: ["bid", "list"], replacement: "ornn spot orders" },
+    { legacy: ["bid", "show"], replacement: "ornn spot orders" },
+    { legacy: ["bid", "update"], replacement: "ornn spot bid" },
+    { legacy: ["bid", "withdraw"], replacement: "ornn spot cancel" },
+    {
+        legacy: ["exchange", "create"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["exchange", "list"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["exchange", "show"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["exchange", "update"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["exchange", "withdraw"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpu", "list"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpu", "show"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpu", "checkout"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpus", "list"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpus", "show"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["gpus", "checkout"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["tenant", "reservations"], replacement: "ornn reservations list" },
+    { legacy: ["reservations", "checkout"], replacement: "ornn reservations show" },
+    {
+        legacy: ["reservations", "operator"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["reservations", "commerce", "create"], replacement: "ornn admin reservations create" },
+    {
+        legacy: ["reservations", "commerce"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["reservations", "deploy"], replacement: "ornn admin nodes assign" },
+    {
+        legacy: ["reservations", "transfer"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["nodes", "launch"], replacement: "ornn launch" },
+    { legacy: ["nodes", "list"], replacement: "ornn machines list" },
+    { legacy: ["nodes", "show"], replacement: "ornn machines show" },
+    { legacy: ["nodes", "wait"], replacement: "ornn machines wait" },
+    { legacy: ["nodes", "switch"], replacement: "ornn machines switch" },
+    { legacy: ["nodes", "reboot"], replacement: "ornn machines reboot" },
+    { legacy: ["nodes", "hard-reset"], replacement: "ornn machines reset --erase-local-data" },
+    { legacy: ["nodes", "ssh-command"], replacement: "ornn connect" },
+    { legacy: ["nodes", "keys"], replacement: "ornn ssh-keys assignments status" },
+    { legacy: ["nodes", "keys", "attach"], replacement: "ornn ssh-keys assignments assign" },
+    { legacy: ["nodes", "keys", "list"], replacement: "ornn ssh-keys assignments list" },
+    { legacy: ["ssh"], replacement: "ornn connect" },
+    { legacy: ["metrics", "nodes"], replacement: "ornn check" },
+    { legacy: ["metrics", "node"], replacement: "ornn check" },
+    { legacy: ["metrics", "history"], replacement: "ornn machines metrics" },
+    { legacy: ["metrics", "watch"], replacement: "ornn machines metrics --follow" },
+    { legacy: ["metrics"], replacement: "ornn check" },
+    { legacy: ["telemetry", "latest"], replacement: "ornn machines metrics" },
+    { legacy: ["telemetry", "tail"], replacement: "ornn machines metrics --follow" },
+    { legacy: ["telemetry"], replacement: "ornn machines metrics" },
+    { legacy: ["logs", "latest"], replacement: "ornn machines logs" },
+    { legacy: ["logs", "tail"], replacement: "ornn machines logs --follow" },
+    { legacy: ["logs"], replacement: "ornn machines logs" },
+    { legacy: ["cluster", "list"], replacement: "ornn clusters list" },
+    {
+        legacy: ["cluster", "reservations"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["cluster", "eligible-nodes"], replacement: "ornn clusters eligible-machines" },
+    { legacy: ["cluster", "create"], replacement: "ornn launch --mode <kubernetes|slurm>" },
+    { legacy: ["cluster", "show"], replacement: "ornn clusters show" },
+    { legacy: ["cluster", "wait"], replacement: "ornn clusters wait" },
+    { legacy: ["cluster", "credentials"], replacement: "ornn connect" },
+    { legacy: ["cluster", "kubeconfig"], replacement: "ornn connect --output <path>" },
+    { legacy: ["cluster", "ssh-command"], replacement: "ornn connect --print" },
+    { legacy: ["cluster", "ssh"], replacement: "ornn connect" },
+    { legacy: ["cluster", "add-node"], replacement: "ornn clusters add-node" },
+    { legacy: ["cluster", "remove-node"], replacement: "ornn clusters remove-node" },
+    { legacy: ["cluster", "teardown"], replacement: "ornn clusters teardown" },
+    { legacy: ["cluster"], replacement: "ornn clusters list" },
+    {
+        legacy: ["clusters", "reservations"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["clusters", "eligible-nodes"], replacement: "ornn clusters eligible-machines" },
+    { legacy: ["clusters", "create"], replacement: "ornn launch --mode kubernetes" },
+    { legacy: ["clusters", "credentials"], replacement: "ornn connect" },
+    { legacy: ["clusters", "kubeconfig"], replacement: "ornn connect --output <path>" },
+    { legacy: ["clusters", "ssh-command"], replacement: "ornn connect --print" },
+    { legacy: ["clusters", "ssh"], replacement: "ornn connect" },
+    { legacy: ["kubernetes", "launch"], replacement: "ornn launch --mode kubernetes" },
+    { legacy: ["kubernetes", "status"], replacement: "ornn clusters show" },
+    { legacy: ["kubernetes", "credentials"], replacement: "ornn connect --output <path>" },
+    { legacy: ["kubernetes", "kubeconfig"], replacement: "ornn connect --output <path>" },
+    { legacy: ["kubernetes", "teardown"], replacement: "ornn clusters teardown" },
+    { legacy: ["slurm", "launch"], replacement: "ornn launch --mode slurm" },
+    { legacy: ["slurm", "status"], replacement: "ornn clusters show" },
+    { legacy: ["slurm", "credentials"], replacement: "ornn connect" },
+    { legacy: ["slurm", "ssh"], replacement: "ornn connect" },
+    { legacy: ["slurm", "teardown"], replacement: "ornn clusters teardown" },
+    { legacy: ["network", "list"], replacement: "ornn private-networks list" },
+    { legacy: ["networks", "list"], replacement: "ornn private-networks list" },
+    { legacy: ["networks", "show"], replacement: "ornn private-networks show" },
+    { legacy: ["networks", "create"], replacement: "ornn private-networks create" },
+    { legacy: ["networks", "update"], replacement: "ornn private-networks update" },
+    { legacy: ["networks", "delete"], replacement: "ornn private-networks delete" },
+    { legacy: ["networks", "reservation"], replacement: "ornn private-networks list" },
+    { legacy: ["networks", "attach"], replacement: "ornn private-networks list" },
+    { legacy: ["networks", "detach"], replacement: "ornn private-networks list" },
+    { legacy: ["access", "show"], replacement: "ornn machines show" },
+    { legacy: ["access", "activate"], replacement: "ornn launch" },
+    { legacy: ["access", "switch"], replacement: "ornn machines switch" },
+    { legacy: ["access", "push-keys"], replacement: "ornn ssh-keys assignments sync" },
+    { legacy: ["access", "keys", "list"], replacement: "ornn ssh-keys assignments list" },
+    { legacy: ["access", "keys", "add"], replacement: "ornn ssh-keys assignments assign" },
+    { legacy: ["access", "keys", "push"], replacement: "ornn ssh-keys assignments sync" },
+    { legacy: ["access", "keys", "status"], replacement: "ornn ssh-keys assignments status" },
+    { legacy: ["access", "keys"], replacement: "ornn ssh-keys assignments list" },
+    { legacy: ["keys", "list"], replacement: "ornn ssh-keys list" },
+    { legacy: ["keys", "add"], replacement: "ornn ssh-keys add" },
+    { legacy: ["keys", "delete"], replacement: "ornn ssh-keys delete" },
+    { legacy: ["keys"], replacement: "ornn ssh-keys list" },
+    { legacy: ["storage", "volumes", "list"], replacement: "ornn volumes list" },
+    { legacy: ["storage", "volumes", "show"], replacement: "ornn volumes show" },
+    { legacy: ["storage", "volumes", "refresh"], replacement: "ornn volumes refresh" },
+    { legacy: ["storage", "volumes", "clear"], replacement: "ornn volumes clear" },
+    { legacy: ["storage", "volumes", "create"], replacement: "ornn volumes create" },
+    { legacy: ["storage", "volumes", "delete"], replacement: "ornn volumes delete" },
+    { legacy: ["storage", "files", "ls"], replacement: "ornn volumes files list" },
+    { legacy: ["storage", "files", "list"], replacement: "ornn volumes files list" },
+    { legacy: ["storage", "files", "upload"], replacement: "ornn volumes files upload" },
+    { legacy: ["storage", "files", "download"], replacement: "ornn volumes files download" },
+    { legacy: ["storage", "files", "delete"], replacement: "ornn volumes files delete" },
+    { legacy: ["storage", "buckets", "list"], replacement: "ornn external-buckets list" },
+    { legacy: ["storage", "buckets", "show"], replacement: "ornn external-buckets show" },
+    { legacy: ["storage", "buckets", "connect"], replacement: "ornn external-buckets connect" },
+    {
+        legacy: ["storage", "buckets", "update-credentials"],
+        replacement: "ornn external-buckets update-credentials",
+    },
+    { legacy: ["storage", "buckets", "verify"], replacement: "ornn external-buckets verify" },
+    { legacy: ["storage", "buckets", "import"], replacement: "ornn external-buckets import" },
+    {
+        legacy: ["storage", "buckets", "disconnect"],
+        replacement: "ornn external-buckets disconnect",
+    },
+    { legacy: ["storage", "buckets", "create"], replacement: "ornn external-buckets connect" },
+    { legacy: ["storage", "buckets", "delete"], replacement: "ornn external-buckets disconnect" },
+    { legacy: ["storage", "volumes"], replacement: "ornn volumes list" },
+    { legacy: ["storage", "files"], replacement: "ornn volumes files list" },
+    { legacy: ["storage", "buckets"], replacement: "ornn external-buckets list" },
+    { legacy: ["storage", "targets"], replacement: "ornn volume-mounts candidates" },
+    { legacy: ["storage", "deploy"], replacement: "ornn volume-mounts attach" },
+    { legacy: ["storage", "status"], replacement: "ornn volume-mounts show" },
+    { legacy: ["storage", "detach"], replacement: "ornn volume-mounts detach" },
+    { legacy: ["storage", "filesystem"], replacement: "ornn filesystems show" },
+    { legacy: ["storage", "filesystem", "deploy"], replacement: "ornn filesystems deploy" },
+    { legacy: ["storage", "filesystem", "status"], replacement: "ornn filesystems show" },
+    { legacy: ["storage", "filesystem", "delete"], replacement: "ornn filesystems delete" },
+    {
+        legacy: ["billing", "summary"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["billing", "invoices"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["billing", "showback"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["billing", "open"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    {
+        legacy: ["billing"],
+        replacement: "ornn capacity-offers list (use the Ornn web app for commercial workflows)",
+    },
+    { legacy: ["reservations", "commerce", "list"], replacement: "ornn reservations list" },
+    { legacy: ["reservations", "commerce", "create"], replacement: "ornn admin reservations create" },
+    { legacy: ["operator", "list"], replacement: "ornn admin suppliers list" },
+    { legacy: ["operators", "list"], replacement: "ornn admin suppliers list" },
+    { legacy: ["facilities", "list"], replacement: "ornn admin facilities list" },
+    { legacy: ["tokens", "list"], replacement: "ornn admin enrollment-tokens list" },
+    { legacy: ["tokens", "create"], replacement: "ornn admin enrollment-tokens create" },
+    { legacy: ["tokens", "revoke"], replacement: "ornn admin enrollment-tokens revoke" },
+    { legacy: ["users", "query"], replacement: "ornn admin users search" },
+    { legacy: ["node", "enroll"], replacement: "ornn admin nodes enroll" },
+    { legacy: ["node", "list"], replacement: "ornn admin nodes list" },
+    { legacy: ["node", "health"], replacement: "ornn admin nodes health" },
+    { legacy: ["node", "reboot"], replacement: "ornn admin nodes reboot" },
+    { legacy: ["node", "admin-key"], replacement: "ornn admin nodes export-key" },
+    { legacy: ["node", "diagnose"], replacement: "ornn admin nodes diagnose" },
+    { legacy: ["node", "exec"], replacement: "ornn admin nodes exec" },
+    { legacy: ["node", "hard-reset"], replacement: "ornn admin nodes hard-reset --erase-local-data" },
+    { legacy: ["node", "terminate"], replacement: "ornn admin nodes terminate" },
+    { legacy: ["node", "off-grid"], replacement: "ornn admin nodes suspend-management" },
+    { legacy: ["node", "on-grid"], replacement: "ornn admin nodes resume-management" },
+    { legacy: ["operator"], replacement: "ornn admin suppliers list" },
+    { legacy: ["operators"], replacement: "ornn admin suppliers list" },
+    { legacy: ["facilities"], replacement: "ornn admin facilities list" },
+    { legacy: ["tokens"], replacement: "ornn admin enrollment-tokens list" },
+    { legacy: ["users"], replacement: "ornn admin users search" },
+    { legacy: ["node"], replacement: "ornn admin nodes list" },
+    { legacy: ["cache", "purge"], replacement: "ornn resources" },
+    { legacy: ["api"], replacement: "ornn resources" },
+    { legacy: ["commerce"], replacement: "ornn resources" },
+    { legacy: ["orchestrator"], replacement: "ornn resources" },
+];
+export function findLegacyCliMigration(argv) {
+    return ([...LEGACY_CLI_MIGRATIONS]
+        .sort((left, right) => right.legacy.length - left.legacy.length)
+        .find((entry) => entry.legacy.every((part, index) => argv[index] === part)) ?? null);
+}

package/vendor/capabilities/cli.js

@@ -0,0 +1,7 @@
+// The CLI entrypoint must not import staff commerce or CRM capabilities.
+export { catalog } from "./cli-catalog.js";
+export { ADMIN_CLI_ROOTS } from "./capabilities/admin.js";
+export { byCliCommand, byMcpName, forRole } from "./capability.js";
+export { CLI_MIGRATION_GUIDE_URL, findLegacyCliMigration, LEGACY_CLI_MIGRATIONS, } from "./cli-migrations.js";
+export { gpuDisplay, HARDWARE_CATALOG_PATH, parseHardwareCatalog } from "./spec-catalog.js";
+export { SOFTWARE_CATALOG_PATH } from "./software-catalog.js";

package/vendor/capabilities/software-catalog.js

@@ -0,0 +1,36 @@
+/** Live orchestrator software dictionary: `GET /v1/orchestrator/catalog/software`. */
+export const SOFTWARE_CATALOG_PATH = "/v1/orchestrator/catalog/software";
+export const SOFTWARE_KINDS = ["python", "package", "cuda", "nvidia_smi", "dcgmi"];
+function stringMap(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {};
+    }
+    const out = {};
+    for (const [key, entry] of Object.entries(value)) {
+        if (typeof entry === "string" && entry.trim()) {
+            out[key] = entry;
+        }
+    }
+    return out;
+}
+export function parseSoftwareCatalog(payload) {
+    const row = payload && typeof payload === "object" ? payload : {};
+    const python = Array.isArray(row.python)
+        ? row.python.filter((value) => typeof value === "string")
+        : [];
+    return {
+        python,
+        packages: stringMap(row.packages),
+        cuda: stringMap(row.cuda),
+        nvidia_smi: stringMap(row.nvidia_smi),
+        dcgmi: stringMap(row.dcgmi),
+    };
+}
+export async function loadSoftwareCatalog(fetchImpl) {
+    return parseSoftwareCatalog(await fetchImpl(SOFTWARE_CATALOG_PATH, { method: "GET" }));
+}
+export function displayForSoftwareSlug(catalog, kind, slug) {
+    const map = catalog[kind];
+    const hit = Object.entries(map).find(([, value]) => value === slug);
+    return hit?.[0] ?? slug;
+}

package/vendor/capabilities/spec-catalog.js

@@ -1,5 +1,5 @@
-/** Live orchestrator dictionary: `GET /v1/orchestrator/catalog` from `spec/dictionary.csv`. */
-export const HARDWARE_CATALOG_PATH = "/v1/orchestrator/catalog";
+/** Live orchestrator dictionary: `GET /v1/orchestrator/catalog/hardware` from `spec/dictionary.csv`. */
+export const HARDWARE_CATALOG_PATH = "/v1/orchestrator/catalog/hardware";
 export const HARDWARE_KINDS = ["gpu", "cpu", "node", "link"];
 export const UNRESOLVED_CATALOG_HINT = "Leave this field empty. Only dictionary.csv product names are allowed. Do not ask to add spec-sheet text to the dictionary.";
 export const HARDWARE_LISTING_FIELDS = [
@@ -66,6 +66,26 @@ export function parseHardwareCatalog(payload) {
 export async function loadHardwareCatalog(fetchImpl) {
     return parseHardwareCatalog(await fetchImpl(HARDWARE_CATALOG_PATH, { method: "GET" }));
 }
+/** What a GPU slug the catalog does not list renders as. */
+export const UNKNOWN_GPU = "Unknown GPU";
+/**
+ * The display name of a stored GPU slug. Every UI and server renderer maps
+ * slugs through the catalog's terms; nothing renders a slug. Empty while the
+ * catalog is still loading.
+ */
+export function gpuDisplay(terms, slug) {
+    if (!terms)
+        return "";
+    if (!slug)
+        return UNKNOWN_GPU;
+    return terms.find((term) => term.kind === "gpu" && term.canonical === slug)?.display ?? UNKNOWN_GPU;
+}
+/** GPU picker and filter options: slug values with display labels, in catalog order. */
+export function gpuOptions(terms) {
+    return (terms ?? [])
+        .filter((term) => term.kind === "gpu")
+        .map((term) => ({ value: term.canonical, label: term.display }));
+}
 export function resolveCatalogTerm(terms, kind, query) {
     if (looksLikeSpecDump(query) || !normalizeCatalogQuery(query) || !kind.trim()) {
         return { canonical: null, display: null, hint: UNRESOLVED_CATALOG_HINT };
@@ -93,8 +113,10 @@ export function bindHardwareFields(terms, input, fields) {
             continue;
         }
         const resolved = resolveCatalogTerm(terms, kind, value);
-        if (resolved.display) {
-            payload[field] = resolved.display;
+        // GPUs are stored as slugs; other hardware keeps its display name.
+        const bound = kind === "gpu" ? resolved.canonical : resolved.display;
+        if (bound) {
+            payload[field] = bound;
             continue;
         }
         rejected.push({ field, value });
@@ -104,7 +126,7 @@ export function bindHardwareFields(terms, input, fields) {
             ok: false,
             error: "unknown_catalog_term",
             rejected,
-            hint: "Call listings_catalog_terms and retry with a display name from the dump. Do not ask to add spec-sheet text to the dictionary.",
+            hint: "Call listings_catalog_terms and retry with a slug, display name or alias from the dump. Do not ask to add spec-sheet text to the dictionary.",
         };
     }
     return { ok: true, payload };
@@ -121,6 +143,7 @@ export function projectCatalogTerms(terms, kind) {
             .filter((term) => (kind?.trim() ? term.kind.toLowerCase() === kind.toLowerCase() : true))
             .map((term) => ({
             kind: term.kind,
+            canonical: term.canonical,
             display: term.display,
             aliases: term.aliases ?? [],
         })),

package/vendor/capabilities/supplier-directory.js

@@ -0,0 +1,20 @@
+/** One supplier-filtered page, including server-side name search. */
+export async function listSupplierOrganizationPage(fetch, input) {
+    const params = `role=supplier&limit=${input.limit}&offset=${input.offset}&sort=created_at&direction=asc` +
+        (input.q?.trim() ? `&q=${encodeURIComponent(input.q.trim())}` : "");
+    const page = await fetch(`/v1/organizations?${params}`, { method: "GET" });
+    if (!Array.isArray(page))
+        throw new Error("Invalid supplier directory response.");
+    return page;
+}
+/** Authorization uses offset pagination; never return a partial supplier catalog. */
+export async function listSupplierOrganizations(fetch) {
+    const rows = [];
+    for (let offset = 0; offset < 50_000; offset += 1000) {
+        const page = await listSupplierOrganizationPage(fetch, { limit: 1000, offset });
+        rows.push(...page);
+        if (page.length < 1000)
+            return rows;
+    }
+    throw new Error("Supplier directory exceeded 50 pages; refusing a partial catalog.");
+}