@ornncompute/cli 1.0.67 → 1.0.75

package/vendor/capabilities/capabilities/compute.js

@@ -140,7 +140,7 @@ export const launchCapability = cliOnly({
             order: 2,
             outcome: "Launch one reviewed VM, Bare Metal machine, Kubernetes cluster, or Slurm cluster from active reserved capacity, including a declared durable Bare Metal workspace.",
             human: "ornn launch [<capacity-reservation>] --mode vm|bare-metal|kubernetes|slurm [--key <ssh-key>]; Bare Metal may add --network shared --volume <managed-volume> --mount-access read-only|read-write; Kubernetes/Slurm prompt for missing --network public|private and --nodes <membership-count>, and may add running VMs with --vms <vm-ids>",
-            automation: "ornn launch <canonical-reservation-id> --mode vm|bare-metal|kubernetes|slurm --yes --idempotency-key <key> --format json; VM/Bare Metal/Slurm require --key <canonical-key-id>; Bare Metal may add --network shared --volume <canonical-volume-id> --mount-access read-only|read-write; Kubernetes/Slurm require --network public|private --nodes <membership-count> --machines <canonical-machine-ids>, and may add --vms <canonical-vm-ids> (with --nodes 0 for a cluster of VMs only)",
+            automation: "ornn launch <canonical-reservation-id> --mode vm|bare-metal|kubernetes|slurm  --idempotency-key <key> --format json; VM/Bare Metal/Slurm require --key <canonical-key-id>; Bare Metal may add --network shared --volume <canonical-volume-id> --mount-access read-only|read-write; Kubernetes/Slurm require --network public|private --nodes <membership-count> --machines <canonical-machine-ids>, and may add --vms <canonical-vm-ids> (with --nodes 0 for a cluster of VMs only)",
             acceptedReferences: [
                 "canonical capacity-reservation ID",
                 "canonical eligible machine IDs",
@@ -262,7 +262,7 @@ export const machineSwitchCapability = cliOnly({
             order: 463,
             outcome: "Change only the explicitly requested VM, Bare Metal, or network goal while retaining SSH-key intent.",
             human: "ornn machines switch <canonical-reservation-id> [--mode vm|bare-metal] [--network public|private] [--erase-local-data]",
-            automation: "ornn machines switch <canonical-reservation-id> [--mode vm|bare-metal] [--network public|private] [--erase-local-data] --yes --idempotency-key <key> --format json",
+            automation: "ornn machines switch <canonical-reservation-id> [--mode vm|bare-metal] [--network public|private] [--erase-local-data]  --idempotency-key <key> --format json",
             acceptedReferences: ["canonical capacity-reservation ID"],
             review: "exact reservation, current and requested access mode, network intent, retained SSH keys, access interruption, and permanent local-data erasure for cross-mode changes",
             resumableStates: ["switch accepted", "SSH ready"],
@@ -287,7 +287,7 @@ export const machineRebootCapability = cliOnly({
             order: 464,
             outcome: "Reboot one exact machine and normally wait for restored SSH readiness.",
             human: "ornn machines reboot <canonical-machine-id|exact-hostname> [--no-wait]",
-            automation: "ornn machines reboot <canonical-machine-id> --yes --idempotency-key <key> --format json",
+            automation: "ornn machines reboot <canonical-machine-id>  --idempotency-key <key> --format json",
             acceptedReferences: [
                 "canonical machine ID",
                 "exact unique hostname",
@@ -316,7 +316,7 @@ export const machineResetCapability = cliOnly({
             order: 465,
             outcome: "Hard reset one exact machine only with explicit local-data erasure scope and final consent.",
             human: "ornn machines reset <canonical-machine-id|exact-hostname> --erase-local-data [--no-wait]",
-            automation: "ornn machines reset <canonical-machine-id> --erase-local-data --yes --idempotency-key <key> --format json",
+            automation: "ornn machines reset <canonical-machine-id> --erase-local-data  --idempotency-key <key> --format json",
             acceptedReferences: [
                 "canonical machine ID",
                 "exact unique hostname",
@@ -392,7 +392,7 @@ export const sshKeyDeleteCapability = cliOnly({
             order: 452,
             outcome: "Delete one exact organization SSH key without implying machine delivery.",
             human: "ornn ssh-keys delete <exact-key-id-or-label>",
-            automation: "ornn ssh-keys delete <canonical-key-id> --yes --idempotency-key <key> --format json",
+            automation: "ornn ssh-keys delete <canonical-key-id>  --idempotency-key <key> --format json",
             acceptedReferences: [
                 "canonical SSH-key ID",
                 "exact unique key label in an eligible terminal",
@@ -443,7 +443,7 @@ export const sshKeyAssignmentAssignCapability = cliOnly({
             order: 454,
             outcome: "Assign or replay one exact SSH-key relationship.",
             human: "ornn ssh-keys assignments assign <canonical-reservation-id> --key <exact-key-id-or-label>",
-            automation: "ornn ssh-keys assignments assign <canonical-reservation-id> --key <canonical-key-id> --yes --idempotency-key <key> --format json",
+            automation: "ornn ssh-keys assignments assign <canonical-reservation-id> --key <canonical-key-id>  --idempotency-key <key> --format json",
             acceptedReferences: [
                 "canonical capacity-reservation ID",
                 "canonical SSH-key ID",
@@ -472,7 +472,7 @@ export const sshKeyAssignmentSyncCapability = cliOnly({
             order: 455,
             outcome: "Queue idempotent SSH-key synchronization and report delayed delivery honestly.",
             human: "ornn ssh-keys assignments sync <canonical-reservation-id>",
-            automation: "ornn ssh-keys assignments sync <canonical-reservation-id> --yes --idempotency-key <key> --format json",
+            automation: "ornn ssh-keys assignments sync <canonical-reservation-id>  --idempotency-key <key> --format json",
             acceptedReferences: ["canonical capacity-reservation ID"],
             review: "reservation, assigned keys, and target machines",
             resumableStates: ["queued", "installed", "failed"],

package/vendor/capabilities/capabilities/credits.js

@@ -37,7 +37,7 @@ export const creditGrantCapability = defineCapability({
             category: "resource",
             command: ["admin", "organizations", "grant-credit"],
             outcome: "Grant Ornn credits to a customer organization.",
-            human: "ornn admin organizations grant-credit --organization UUID --amount-cents N --note TEXT --idempotency-key UUID [--yes]",
+            human: "ornn admin organizations grant-credit --organization UUID --amount-cents N --note TEXT --idempotency-key UUID []",
             automation: "Requires an eligible human terminal.",
             acceptedReferences: ["organization UUID from admin organizations list"],
             review: "Review the organization, USD amount, note, and grant UUID before default-no consent.",
@@ -53,6 +53,11 @@ export const creditGrantCapability = defineCapability({
                     format: "uuid",
                     description: "Exact customer organization UUID from organization_list.",
                 },
+                adjustmentId: {
+                    type: "string",
+                    format: "uuid",
+                    description: "a new UUID per grant, reused on retries",
+                },
                 amountCents: {
                     type: "integer",
                     minimum: 1,
@@ -64,7 +69,7 @@ export const creditGrantCapability = defineCapability({
                     description: "Reason for the credit grant, at most 500 UTF-8 bytes.",
                 },
             },
-            required: ["organizationId", "amountCents", "note"],
+            required: ["organizationId", "adjustmentId", "amountCents", "note"],
         },
     },
     input: creditGrantInput,

package/vendor/capabilities/capabilities/external-buckets.js

@@ -131,7 +131,7 @@ export const externalBucketCapabilities = [
         input: connectInput,
         outcome: "Create or rediscover one external bucket connection with verification kept separate.",
         human: "ornn external-buckets connect <gcs|s3|r2> --bucket <bucket> [--name <name>] [--prefix <prefix>] [--region <region>] [--account-id <id>|--endpoint-url <url>] [--access-key-id <id> --secret-access-key-file <path>] [--read-only|--read-write]",
-        automation: "ornn external-buckets connect <gcs|s3|r2> --bucket <bucket> <provider-inputs> --yes --idempotency-key <key> --format json",
+        automation: "ornn external-buckets connect <gcs|s3|r2> --bucket <bucket> <provider-inputs>  --idempotency-key <key> --format json",
         review: `Review the exact source, access mode, and credential presence before connecting it. ${gcsImportGuidance}`,
         related: ["external-buckets verify", "external-buckets import"],
     }),
@@ -143,7 +143,7 @@ export const externalBucketCapabilities = [
         input: credentialInput,
         outcome: "Update one connection's credentials and require a separate verification.",
         human: "ornn external-buckets update-credentials <external-bucket> --access-key-id <id> --secret-access-key-file <path>",
-        automation: "ornn external-buckets update-credentials <external-bucket-id> --access-key-id <id> --secret-access-key-file <path> --yes --idempotency-key <key> --format json",
+        automation: "ornn external-buckets update-credentials <external-bucket-id> --access-key-id <id> --secret-access-key-file <path>  --idempotency-key <key> --format json",
         acceptedReferences: ["canonical external bucket ID", "exact unique external bucket name"],
         review: "Credential changes invalidate the prior verification and require renewed review.",
         related: ["external-buckets verify"],
@@ -169,7 +169,7 @@ export const externalBucketCapabilities = [
         input: importInput,
         outcome: "Create or replay exactly one managed working copy with source writeback disabled.",
         human: "ornn external-buckets import <gcs|s3|r2> <external-bucket> --reservation <canonical-reservation-id> [--no-wait] [--timeout <duration>]",
-        automation: "ornn external-buckets import <gcs|s3> <external-bucket-id> --reservation <canonical-reservation-id> --yes --idempotency-key <key> [--wait --timeout <duration>] --format json",
+        automation: "ornn external-buckets import <gcs|s3> <external-bucket-id> --reservation <canonical-reservation-id>  --idempotency-key <key> [--wait --timeout <duration>] --format json",
         acceptedReferences: ["canonical external bucket ID", "exact unique external bucket name"],
         review: `Review the isolated destination and explicit no-writeback guarantee before importing. ${gcsImportGuidance}`,
         resumableStates: ["pending", "working", "partial", "failed", "interrupted"],
@@ -183,7 +183,7 @@ export const externalBucketCapabilities = [
         input: disconnectInput,
         outcome: "Remove one external source connection without writing to its source bucket.",
         human: "ornn external-buckets disconnect <external-bucket>",
-        automation: "ornn external-buckets disconnect <external-bucket-id> --yes --idempotency-key <key> --format json",
+        automation: "ornn external-buckets disconnect <external-bucket-id>  --idempotency-key <key> --format json",
         acceptedReferences: ["canonical external bucket ID", "exact unique external bucket name"],
         review: "Disconnecting reduces access to the source and is blocked while mounts remain.",
         related: ["storage detach", "external-buckets show"],

package/vendor/capabilities/capabilities/fleet.js

@@ -17,44 +17,41 @@ const suppliersInput = z.object({
 });
 const facilitiesInput = z.object({
     organization_id: z.string().optional(),
-    organizationId: z.string().optional(),
     cursor: z.string().optional(),
-    limit: z.number().int().min(1).max(500).optional(),
+    limit: z.number().int().min(1).max(100).optional(),
 });
 const nodesInput = z.object({
     organization_id: z.string().optional(),
-    organizationId: z.string().optional(),
     facility_id: z.string().optional(),
-    facilityId: z.string().optional(),
     status: z.string().optional(),
     reservation_id: z.string().optional(),
-    reservationId: z.string().optional(),
     cursor: z.string().optional(),
     max: z.number().int().positive().max(5000).optional(),
     limit: z.number().int().positive().max(5000).optional(),
 });
 const nodeLifecycleInput = z.object({
     node_id: z.string().min(1),
-    nodeId: z.string().optional(),
+    node_ref: z.string().optional(),
     reason: z.string().optional(),
     force: z.boolean().optional(),
+    skip_cleanup: z.boolean().optional(),
+    delete_node_record: z.literal(true).optional(),
+    idempotency_key: z.string().optional(),
+    yes: z.boolean().optional(),
+    wait: z.boolean().optional(),
+    timeout_seconds: z.number().positive().optional(),
 });
 const nodeExecInput = z.object({
     node_id: z.string().min(1),
-    nodeId: z.string().optional(),
     command: z.string().min(1),
     timeout_seconds: z.number().int().positive(),
-    timeoutSeconds: z.number().int().positive().optional(),
     yes: z.boolean().optional(),
 });
-function nodeIdOf(input) {
-    return (input.node_id || input.nodeId || "").trim();
-}
 export const listSuppliersCapability = defineCapability({
     id: "supplier.list",
     domain: "fleet",
     roles: ["admin"],
-    description: "List supplier organizations (id, name). Resolve supplier names to organization_id with this before nodes.list or facilities.list.",
+    description: "List supplier organizations (id, name). Resolve supplier names to organization_id with this before nodes.list or facilities.list. When next_offset is present, pass it back as offset for the next page.",
     mutation: "read",
     http: { method: "GET", path: "/v1/organizations" },
     slack: {
@@ -86,7 +83,7 @@ export const listFacilitiesCapability = defineCapability({
     id: "facilities.list",
     domain: "fleet",
     roles: ["admin"],
-    description: "List facilities (id, display name, region, supplier organization id). Optional organization_id filter. Resolve facility names with this before nodes.list.",
+    description: "List facilities (id, display name, region, supplier organization id). Optional organization_id filter. When nextCursor is present, pass it back as cursor for the next page. Use facilities.show to resolve one facility id.",
     mutation: "read",
     http: { method: "GET", path: "/provisioning/facilities" },
     slack: {
@@ -97,6 +94,16 @@ export const listFacilitiesCapability = defineCapability({
                     type: "string",
                     description: "Optional supplier organization UUID from supplier.list.",
                 },
+                cursor: {
+                    type: "string",
+                    description: "Pass the previous response's nextCursor to fetch the next page.",
+                },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 100,
+                    description: "Optional page size (maximum 100).",
+                },
             },
         },
     },
@@ -104,12 +111,38 @@ export const listFacilitiesCapability = defineCapability({
     execute: async (ctx, input) => {
         const parsed = facilitiesInput.parse(input);
         return ctx.fetch(queryPath("/provisioning/facilities", {
-            organizationId: parsed.organization_id ?? parsed.organizationId,
+            organizationId: parsed.organization_id,
             cursor: parsed.cursor,
             limit: parsed.limit === undefined ? undefined : String(parsed.limit),
         }), { method: "GET" });
     },
 });
+export const facilityShowInput = z.object({ facilityId: z.uuid() });
+export const facilityShowCapability = defineCapability({
+    id: "facilities.show",
+    domain: "fleet",
+    roles: ["admin"],
+    description: "Resolve one facility id (e.g. a listing's facilityId) to its display name, region and status.",
+    mutation: "read",
+    http: { method: "GET", path: "/provisioning/facilities/{facilityId}" },
+    cli: false,
+    slack: {
+        parameters: {
+            type: "object",
+            properties: {
+                facilityId: { type: "string", format: "uuid" },
+            },
+            required: ["facilityId"],
+        },
+    },
+    input: facilityShowInput,
+    execute: async (ctx, input) => {
+        const parsed = facilityShowInput.parse(input);
+        return ctx.fetch(`/provisioning/facilities/${encodeURIComponent(parsed.facilityId)}`, {
+            method: "GET",
+        });
+    },
+});
 export const listNodesCapability = defineCapability({
     id: "nodes.list",
     domain: "fleet",
@@ -160,10 +193,10 @@ export const listNodesCapability = defineCapability({
             return ctx.fetch(queryPath("/nodes", pagination), { method: "GET" });
         }
         return ctx.fetch(queryPath("/nodes", {
-            organization_id: parsed.organization_id ?? parsed.organizationId,
-            facility_id: parsed.facility_id ?? parsed.facilityId,
+            organization_id: parsed.organization_id,
+            facility_id: parsed.facility_id,
             status: parsed.status,
-            reservation_id: parsed.reservation_id ?? parsed.reservationId,
+            reservation_id: parsed.reservation_id,
             ...pagination,
         }), { method: "GET" });
     },
@@ -172,9 +205,21 @@ export const nodeOffGridCapability = defineCapability({
     id: "node.off-grid",
     domain: "fleet",
     roles: ["admin"],
-    description: "Admin-only. Take a node off-grid (remove Ornn agent management, leave the host powered on). CLI asks y/N. Slack waits for a human confirm. MCP requires confirm: true.",
+    description: "Admin-only. Take a node off-grid (remove Ornn agent management, leave the host powered on). Slack waits for a human confirm. ",
     mutation: "preview-confirm",
     http: { method: "POST", path: "/nodes/{id}/off-grid" },
+    cli: {
+        command: ["admin", "nodes", "suspend-management"],
+        vnext: {
+            audience: "admin",
+            category: "resource",
+            command: ["admin", "nodes", "suspend-management"],
+            outcome: "Remove Ornn management and managed access from one powered-on node.",
+            human: "ornn admin nodes suspend-management <node-ref> [--reason TEXT] [] [--no-wait]",
+            automation: "ornn admin nodes suspend-management <node-id>  --idempotency-key KEY --format json",
+            review: "Node, supplier, facility, capacity assignment, management removal, and managed-access loss.",
+        },
+    },
     slack: {
         parameters: {
             type: "object",
@@ -188,14 +233,18 @@ export const nodeOffGridCapability = defineCapability({
     input: nodeLifecycleInput,
     execute: async (ctx, input) => {
         const parsed = nodeLifecycleInput.parse(input);
-        const id = nodeIdOf(parsed);
-        const body = { ...(parsed.reason ? { reason: parsed.reason } : {}) };
+        const id = parsed.node_id.trim();
+        const body = {
+            ...(parsed.idempotency_key ? { request_id: parsed.idempotency_key } : {}),
+            ...(parsed.reason ? { reason: parsed.reason } : {}),
+        };
         if (!ctx.confirmed) {
             return preview("node.off-grid", { node_id: id, ...body });
         }
         return ctx.fetch(`/nodes/${encodeURIComponent(id)}/off-grid`, {
             method: "POST",
             body,
+            ...(parsed.idempotency_key ? { headers: { "Idempotency-Key": parsed.idempotency_key } } : {}),
         });
     },
 });
@@ -203,9 +252,21 @@ export const nodeOnGridCapability = defineCapability({
     id: "node.on-grid",
     domain: "fleet",
     roles: ["admin"],
-    description: "Admin-only. Re-enroll an off-grid node: orchestrator SSHs with the stored admin key and runs the installer with restore_node_id. No caller key. CLI asks y/N. Slack waits for a human confirm. MCP requires confirm: true.",
+    description: "Admin-only. Re-enroll an off-grid node: orchestrator SSHs with the stored admin key and runs the installer with restore_node_id. No caller key. Slack waits for a human confirm. ",
     mutation: "preview-confirm",
     http: { method: "POST", path: "/nodes/{id}/on-grid" },
+    cli: {
+        command: ["admin", "nodes", "resume-management"],
+        vnext: {
+            audience: "admin",
+            category: "resource",
+            command: ["admin", "nodes", "resume-management"],
+            outcome: "Restore Ornn management and managed access on one off-grid node.",
+            human: "ornn admin nodes resume-management <node-ref> [] [--no-wait]",
+            automation: "ornn admin nodes resume-management <node-id>  --idempotency-key KEY --format json",
+            review: "Node, supplier, facility, capacity assignment, remote re-enrollment, and restored managed access.",
+        },
+    },
     slack: {
         parameters: {
             type: "object",
@@ -218,13 +279,16 @@ export const nodeOnGridCapability = defineCapability({
     input: nodeLifecycleInput,
     execute: async (ctx, input) => {
         const parsed = nodeLifecycleInput.parse(input);
-        const id = nodeIdOf(parsed);
+        const id = parsed.node_id.trim();
         if (!ctx.confirmed) {
             return preview("node.on-grid", { node_id: id });
         }
         return ctx.fetch(`/nodes/${encodeURIComponent(id)}/on-grid`, {
             method: "POST",
-            body: {},
+            body: {
+                ...(parsed.idempotency_key ? { request_id: parsed.idempotency_key } : {}),
+            },
+            ...(parsed.idempotency_key ? { headers: { "Idempotency-Key": parsed.idempotency_key } } : {}),
         });
     },
 });
@@ -233,7 +297,7 @@ export const nodeExecCapability = defineCapability({
     domain: "fleet",
     roles: ["admin"],
     description: "Admin-only. Run one unrestricted command on an enrolled node over orchestrator SSH with the stored admin key. Always pass timeout_seconds. Not an interactive shell. On NVIDIA hosts use nvidia-smi; on AMD Instinct use amd-smi. Runs on the tool call — no confirm, no y/N.",
-    mutation: "read",
+    mutation: "immediate",
     http: { method: "POST", path: "/remote" },
     slack: {
         parameters: {
@@ -252,8 +316,8 @@ export const nodeExecCapability = defineCapability({
     input: nodeExecInput,
     execute: async (ctx, input) => {
         const parsed = nodeExecInput.parse(input);
-        const id = nodeIdOf(parsed);
-        const timeoutSeconds = parsed.timeout_seconds ?? parsed.timeoutSeconds;
+        const id = parsed.node_id.trim();
+        const timeoutSeconds = parsed.timeout_seconds;
         return ctx.fetch("/remote", {
             method: "POST",
             body: { node_id: id, command: parsed.command, timeout_seconds: timeoutSeconds },
@@ -264,9 +328,21 @@ export const nodeTerminateCapability = defineCapability({
     id: "node.terminate",
     domain: "fleet",
     roles: ["admin"],
-    description: "Admin-only. Terminate a node record (best-effort clean + delete). Off-grid nodes need force: true. There is no deenroll verb. CLI asks y/N. Slack waits for a human confirm. MCP requires confirm: true.",
+    description: "Admin-only. Terminate a node record (best-effort clean + delete). Off-grid nodes need force: true. There is no deenroll verb. Slack waits for a human confirm. ",
     mutation: "preview-confirm",
     http: { method: "POST", path: "/nodes/{id}/terminate" },
+    cli: {
+        command: ["admin", "nodes", "terminate"],
+        vnext: {
+            audience: "admin",
+            category: "resource",
+            command: ["admin", "nodes", "terminate"],
+            outcome: "End managed access and permanently delete one exact node record.",
+            human: "ornn admin nodes terminate <node-ref> --delete-node-record [--skip-cleanup] [--reason TEXT] []",
+            automation: "ornn admin nodes terminate <node-id> --delete-node-record  --idempotency-key KEY --format json",
+            review: "Node, supplier, facility, reservation/capacity, host cleanup, node-record deletion, and access loss.",
+        },
+    },
     slack: {
         parameters: {
             type: "object",
@@ -281,10 +357,12 @@ export const nodeTerminateCapability = defineCapability({
     input: nodeLifecycleInput,
     execute: async (ctx, input) => {
         const parsed = nodeLifecycleInput.parse(input);
-        const id = nodeIdOf(parsed);
+        const id = parsed.node_id.trim();
+        const force = parsed.force ?? parsed.skip_cleanup;
         const body = {
             ...(parsed.reason ? { reason: parsed.reason } : {}),
-            ...(parsed.force !== undefined ? { force: parsed.force } : {}),
+            ...(force !== undefined ? { force } : {}),
+            ...(parsed.idempotency_key ? { request_id: parsed.idempotency_key } : {}),
         };
         if (!ctx.confirmed) {
             return preview("node.terminate", { node_id: id, ...body });
@@ -292,12 +370,14 @@ export const nodeTerminateCapability = defineCapability({
         return ctx.fetch(`/nodes/${encodeURIComponent(id)}/terminate`, {
             method: "POST",
             body,
+            ...(parsed.idempotency_key ? { headers: { "Idempotency-Key": parsed.idempotency_key } } : {}),
         });
     },
 });
 export const fleetCapabilities = [
     listSuppliersCapability,
     listFacilitiesCapability,
+    facilityShowCapability,
     listNodesCapability,
     nodeOffGridCapability,
     nodeOnGridCapability,

package/vendor/capabilities/capabilities/listings.js

@@ -1,6 +1,7 @@
 import { listSupplierOrganizations } from "../supplier-directory.js";
 import { z } from "zod";
 import { defineCapability, preview } from "../capability.js";
+import { ensureFacility, LOCATION_LOOKUP_UNAVAILABLE, locateRegion, unplacedLocation, } from "./locality.js";
 import { bindHardwareFields, HARDWARE_LISTING_FIELDS, HARDWARE_LISTING_FILTERS, loadHardwareCatalog, projectCatalogTerms, resolveCatalogTerm, } from "../spec-catalog.js";
 function queryPath(path, params) {
     const parts = [];
@@ -30,7 +31,10 @@ export const listingCreateInput = z.object({
     fabric_type: z.string().optional(),
     node_count: z.number().int().optional(),
     gpus_per_node: z.number().int().optional(),
-    site_nickname: z.string().optional(),
+    site_nickname: z
+        .string()
+        .optional()
+        .describe("A state, city, address, or catalog region such as us-west-3."),
     site_supplier: z.string().optional(),
     ram: z.string().optional(),
     storage: z.string().optional(),
@@ -67,7 +71,10 @@ const slackListingCreateParams = {
         fabric_type: { type: "string" },
         node_count: { type: "integer" },
         gpus_per_node: { type: "integer" },
-        site_nickname: { type: "string" },
+        site_nickname: {
+            type: "string",
+            description: "Where the capacity is, exactly as the user said it: a state, city, address, or catalog region such as us-west-3. Ornn places it in a catalog region.",
+        },
         site_supplier: { type: "string" },
         ram: { type: "string" },
         storage: { type: "string" },
@@ -242,7 +249,7 @@ export const createListingCapability = defineCapability({
         let organizationId = parsed.organizationId ?? parsed.organization_id;
         let facilityId = parsed.facilityId ?? parsed.facility_id;
         const supplierQuery = (parsed.site_supplier ?? "").trim().toLowerCase();
-        const facilityQuery = (parsed.site_nickname ?? parsed.site ?? "").trim().toLowerCase();
+        const place = (parsed.site_nickname ?? parsed.site ?? "").trim();
         if (!organizationId && supplierQuery) {
             const matches = (await listSupplierOrganizations(ctx.fetch)).filter((org) => org.id.toLowerCase() === supplierQuery || org.name.toLowerCase() === supplierQuery);
             if (matches.length !== 1) {
@@ -250,7 +257,19 @@ export const createListingCapability = defineCapability({
             }
             organizationId = matches[0].id;
         }
-        if ((facilityId && !organizationId) || (!facilityId && (facilityQuery || organizationId))) {
+        let located = null;
+        let lookupUnavailable = false;
+        if (!facilityId && place) {
+            try {
+                located = await locateRegion(ctx.fetch, place);
+            }
+            catch (error) {
+                if (ctx.confirmed)
+                    throw error;
+                lookupUnavailable = true;
+            }
+        }
+        if ((facilityId && !organizationId) || (!facilityId && !place && organizationId)) {
             const matches = [];
             const seenCursors = new Set();
             let cursor;
@@ -262,14 +281,7 @@ export const createListingCapability = defineCapability({
                     throw new Error("invalid facility catalog");
                 matches.push(...response.facilities.filter((facility) => (!organizationId ||
                     (facility.organizationId ?? facility.organization_id) === organizationId) &&
-                    (facilityId
-                        ? (facility.facilityId ?? facility.id) === facilityId
-                        : !facilityQuery ||
-                            [
-                                facility.facilityId ?? facility.id,
-                                facility.region,
-                                facility.displayName ?? facility.display_name,
-                            ].some((value) => value?.toLowerCase() === facilityQuery))));
+                    (!facilityId || (facility.facilityId ?? facility.id) === facilityId)));
                 cursor = response.nextCursor ?? undefined;
                 if (cursor) {
                     if (seenCursors.has(cursor) || seenCursors.size >= 49) {
@@ -302,6 +314,10 @@ export const createListingCapability = defineCapability({
         const gpusPerNode = parsed.gpus_per_node ?? 8;
         const boundPayload = bound.payload;
         const draft = Object.fromEntries(Object.entries(boundPayload).filter(([key]) => !LISTING_CREATE_INPUT_ONLY_KEYS.includes(key)));
+        if (located)
+            draft.site_nickname = located.name;
+        else if (place && !facilityId && !lookupUnavailable)
+            delete draft.site_nickname;
         const gpuSlug = normalized.gpu_type
             ? resolveCatalogTerm(hardware.terms, "gpu", normalized.gpu_type).canonical
             : null;
@@ -318,11 +334,12 @@ export const createListingCapability = defineCapability({
                     percent: parsed.deposit_percent,
                 })
                 : 0);
-        const listing = organizationId && facilityId && gpuSlug && buyerMicro != null
+        const priced = Boolean(organizationId && gpuSlug && buyerMicro != null);
+        const listingAt = (facility) => priced && facility
             ? primaryListingBody({
-                organizationId,
-                facilityId,
-                gpuSlug,
+                organizationId: organizationId,
+                facilityId: facility,
+                gpuSlug: gpuSlug,
                 gpusPerNode,
                 provisioningType: parsed.access_mode ?? "virtual-machine",
                 availableAt: startsAt,
@@ -337,13 +354,24 @@ export const createListingCapability = defineCapability({
             }, buyerMicro, downPaymentCents)
             : null;
         if (!ctx.confirmed) {
+            const listing = listingAt(facilityId);
             return preview("create_listing", {
                 ...draft,
                 node_count: nodeCount,
                 gpus_per_node: gpusPerNode,
+                ...(located ? { facility_region: located.region } : {}),
+                ...(lookupUnavailable
+                    ? { location_unavailable: place, location_hint: LOCATION_LOOKUP_UNAVAILABLE }
+                    : place && !facilityId && !located
+                        ? { location_unresolved: place, location_hint: unplacedLocation(place) }
+                        : {}),
                 ...(listing ? { listing } : {}),
             });
         }
+        if (located && !facilityId && priced) {
+            facilityId = (await ensureFacility(ctx.fetch, organizationId, located.region)).facilityId;
+        }
+        const listing = listingAt(facilityId);
         if (!listing) {
             return {
                 ok: false,

package/vendor/capabilities/capabilities/locality.js

@@ -0,0 +1,42 @@
+import { statusOf } from "./staff-shared.js";
+export const LOCALITY_GEOLOCATE_PATH = "/v1/orchestrator/locality/geolocate";
+export const FACILITY_ENSURE_PATH = "/provisioning/facilities/ensure";
+/**
+ * `GET /v1/orchestrator/locality/geolocate?address=`: the catalog region a typed
+ * place stands in. Orchestrator answers a region code or name as itself and
+ * geocodes anything else (state, city, address) to its nearest region.
+ * Null means Orchestrator could not place the text (404); an unavailable
+ * geocoder or gateway throws, so callers ask for a retry rather than new text.
+ */
+export async function locateRegion(fetch, place) {
+    const address = place.trim();
+    if (!address)
+        return null;
+    let located;
+    try {
+        located = (await fetch(`${LOCALITY_GEOLOCATE_PATH}?address=${encodeURIComponent(address)}`, {
+            method: "GET",
+        }));
+    }
+    catch (error) {
+        if (statusOf(error) === 404)
+            return null;
+        throw error;
+    }
+    const region = typeof located?.facility_slug === "string" ? located.facility_slug.trim() : "";
+    if (!region)
+        return null;
+    const name = typeof located?.region === "string" && located.region.trim() ? located.region.trim() : region;
+    return { region, name };
+}
+export function unplacedLocation(place) {
+    return `Ornn could not place "${place}". Give a state, city, address, or catalog region such as us-west-3.`;
+}
+export const LOCATION_LOOKUP_UNAVAILABLE = "Ornn's location lookup is unavailable right now. Keep this location and try again in a moment.";
+/** `POST /internal/v1/facilities/ensure`: the organization's facility at a catalog region. */
+export async function ensureFacility(fetch, organizationId, region) {
+    return (await fetch(FACILITY_ENSURE_PATH, {
+        method: "POST",
+        body: { organizationId, region },
+    }));
+}

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

@@ -21,7 +21,7 @@ export function idempotencyHeaders(ctx, supplied) {
 }
 /**
  * One consent gate for every surface: the CLI reviews the terms in the
- * terminal (or takes `--yes`), MCP and Slack return a preview until the
+ * terminal (or takes ``), MCP and Slack return a preview until the
  * caller confirms. `null` means go ahead.
  */
 export async function consent(ctx, action, title, terms, payload) {