@synteq/cli 0.1.5 → 0.1.6

package/dist/commands/config/set-api-url.js

@@ -20,18 +20,32 @@ export default class ConfigSetApiUrl extends BaseCommand {
         const { args } = await this.parse(ConfigSetApiUrl);
         const raw = args.url.trim();
         const next = raw === "reset" || raw === "default" ? PROD_DEFAULT : raw;
+        let parsed = null;
         if (next !== PROD_DEFAULT) {
             try {
-                new URL(next);
+                parsed = new URL(next);
             }
             catch {
                 this.error(`Invalid URL: "${raw}".`, { exit: 1 });
             }
         }
+        // http:// against a non-local host means credentials go over the wire in
+        // plaintext — warn but don't block (staging behind a private LB may still
+        // be http, and localhost dev definitely is).
+        const insecureRemote = parsed?.protocol === "http:" && !isLoopbackOrPrivate(parsed.hostname);
         this.clients.config.set({ api_base_url: next });
         const envOverride = process.env.SYNTEQ_API_BASE_URL;
-        this.emit({ api_base_url: next, env_override: envOverride ?? null }, () => {
+        this.emit({
+            api_base_url: next,
+            env_override: envOverride ?? null,
+            insecure_scheme: insecureRemote,
+        }, () => {
             this.log(`API base URL set to ${next}.`);
+            if (insecureRemote) {
+                this.log("");
+                this.log(`Warning: ${next} is plain HTTP — credentials and tokens will be sent in the clear. ` +
+                    "Use https:// unless this is truly a trusted local/private endpoint.");
+            }
             if (envOverride && envOverride !== next) {
                 this.log("");
                 this.log(`Note: SYNTEQ_API_BASE_URL is set to "${envOverride}" and will override the persisted value.`);
@@ -40,4 +54,25 @@ export default class ConfigSetApiUrl extends BaseCommand {
         });
     }
 }
+function isLoopbackOrPrivate(hostname) {
+    const h = hostname.toLowerCase().replace(/^\[/, "").replace(/\]$/, "");
+    if (h === "localhost" || h === "::1")
+        return true;
+    if (h.endsWith(".local"))
+        return true;
+    const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(h);
+    if (m) {
+        const a = Number(m[1]);
+        const b = Number(m[2]);
+        if (a === 127)
+            return true;
+        if (a === 10)
+            return true;
+        if (a === 172 && b >= 16 && b <= 31)
+            return true;
+        if (a === 192 && b === 168)
+            return true;
+    }
+    return false;
+}
 //# sourceMappingURL=set-api-url.js.map

package/dist/commands/config/set-api-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"set-api-url.js","sourceRoot":"","sources":["../../../src/commands/config/set-api-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,WAAW;IACtD,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,WAAW,GAAG,2DAA2D,CAAC;IACjF,MAAM,CAAC,QAAQ,GAAG;QAChB,+EAA+E;QAC/E,uFAAuF;QACvF,gGAAgG;KACjG,CAAC;IACF,MAAM,CAAC,IAAI,GAAG;QACZ,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,+EAA+E;YAC5F,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC;QACvE,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAEpD,IAAI,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE;YACxE,IAAI,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAC;YACzC,IAAI,WAAW,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACxC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,wCAAwC,WAAW,0CAA0C,CAAC,CAAC;gBACxG,IAAI,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"set-api-url.js","sourceRoot":"","sources":["../../../src/commands/config/set-api-url.ts"],"names":[],"mappings":"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"}

package/dist/commands/gpu/activity.d.ts

@@ -1,6 +1,7 @@
 import ResourceActivity from "../vps/activity.js";
 export default class GpuActivity extends ResourceActivity {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/activity.js

@@ -1,6 +1,12 @@
 import ResourceActivity from "../vps/activity.js";
 export default class GpuActivity extends ResourceActivity {
     static description = "Show recent activity for a GPU Cloud instance.";
+    static examples = [
+        "<%= config.bin %> gpu activity 019e...",
+        "<%= config.bin %> gpu activity 019e... --limit 50",
+        "<%= config.bin %> gpu activity 019e... --limit 25 --offset 25",
+        "<%= config.bin %> gpu activity 019e... -o json",
+    ];
     static args = ResourceActivity.args;
     static flags = ResourceActivity.flags;
     static baseFlags = ResourceActivity.baseFlags;

package/dist/commands/gpu/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/gpu/activity.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,gBAAgB;IACvD,MAAM,CAAC,WAAW,GAAG,gDAAgD,CAAC;IACtE,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;IACtC,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/gpu/activity.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,gBAAgB;IACvD,MAAM,CAAC,WAAW,GAAG,gDAAgD,CAAC;IACtE,MAAM,CAAC,QAAQ,GAAG;QACd,wCAAwC;QACxC,mDAAmD;QACnD,+DAA+D;QAC/D,gDAAgD;KACjD,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;IACtC,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/bandwidth.d.ts

@@ -1,6 +1,7 @@
 import ResourceBandwidth from "../vps/bandwidth.js";
 export default class GpuBandwidth extends ResourceBandwidth {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/bandwidth.js

@@ -1,6 +1,10 @@
 import ResourceBandwidth from "../vps/bandwidth.js";
 export default class GpuBandwidth extends ResourceBandwidth {
     static description = "Show a GPU Cloud instance's bandwidth usage (month-to-date, allowance, overage).";
+    static examples = [
+        "<%= config.bin %> gpu bandwidth 019e...",
+        "<%= config.bin %> gpu bandwidth 019e... -o json    # full summary for scripting",
+    ];
     static args = ResourceBandwidth.args;
     static flags = ResourceBandwidth.flags;
     static baseFlags = ResourceBandwidth.baseFlags;

package/dist/commands/gpu/bandwidth.js.map

@@ -1 +1 @@
-{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../../../src/commands/gpu/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,kFAAkF,CAAC;IACxG,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../../../src/commands/gpu/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,kFAAkF,CAAC;IACxG,MAAM,CAAC,QAAQ,GAAG;QACd,yCAAyC;QACzC,iFAAiF;KAClF,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/boot-order.d.ts

@@ -1,6 +1,7 @@
 import ResourceBootOrder from "../vps/boot-order.js";
 export default class GpuBootOrder extends ResourceBootOrder {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         order: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;

package/dist/commands/gpu/boot-order.js

@@ -1,6 +1,11 @@
 import ResourceBootOrder from "../vps/boot-order.js";
 export default class GpuBootOrder extends ResourceBootOrder {
     static description = "View or set a GPU Cloud instance's boot order.";
+    static examples = [
+        "<%= config.bin %> gpu boot-order 019e...                               # read current",
+        "<%= config.bin %> gpu boot-order 019e... disk_first",
+        "<%= config.bin %> gpu boot-order 019e... cdrom_first",
+    ];
     static args = ResourceBootOrder.args;
     static flags = ResourceBootOrder.flags;
     static baseFlags = ResourceBootOrder.baseFlags;

package/dist/commands/gpu/boot-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot-order.js","sourceRoot":"","sources":["../../../src/commands/gpu/boot-order.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,gDAAgD,CAAC;IACtE,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"boot-order.js","sourceRoot":"","sources":["../../../src/commands/gpu/boot-order.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,gDAAgD,CAAC;IACtE,MAAM,CAAC,QAAQ,GAAG;QACd,uFAAuF;QACvF,qDAAqD;QACrD,sDAAsD;KACvD,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/console.d.ts

@@ -1,6 +1,7 @@
 import ResourceConsole from "../vps/console.js";
 export default class GpuConsole extends ResourceConsole {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/console.js

@@ -1,6 +1,11 @@
 import ResourceConsole from "../vps/console.js";
 export default class GpuConsole extends ResourceConsole {
     static description = "Open a GPU Cloud console (interactive serial, or a browser URL for graphical).";
+    static examples = [
+        "<%= config.bin %> gpu console 019e...                                 # attach serial (TTY) or print URL",
+        "<%= config.bin %> gpu console 019e... --print-url                     # always print the browser URL",
+        "<%= config.bin %> gpu console 019e... --print-url -o json             # {url, token, console_type} for scripting",
+    ];
     static args = ResourceConsole.args;
     static flags = ResourceConsole.flags;
     static baseFlags = ResourceConsole.baseFlags;

package/dist/commands/gpu/console.js.map

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/commands/gpu/console.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,eAAe;IACrD,MAAM,CAAC,WAAW,GAAG,gFAAgF,CAAC;IACtG,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/commands/gpu/console.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,eAAe;IACrD,MAAM,CAAC,WAAW,GAAG,gFAAgF,CAAC;IACtG,MAAM,CAAC,QAAQ,GAAG;QACd,0GAA0G;QAC1G,sGAAsG;QACtG,kHAAkH;KACnH,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/details.d.ts

@@ -1,6 +1,7 @@
 import ResourceDetails from "../vps/details.js";
 export default class GpuDetails extends ResourceDetails {
     static description: string;
+    static examples: string[];
     static aliases: never[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
@@ -13,4 +14,5 @@ export default class GpuDetails extends ResourceDetails {
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         insecure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    protected matchesKind(): string;
 }

package/dist/commands/gpu/details.js

@@ -1,9 +1,18 @@
 import ResourceDetails from "../vps/details.js";
 export default class GpuDetails extends ResourceDetails {
     static description = "Show full details for one GPU Cloud instance. With no id, pick from a list.";
+    static examples = [
+        "<%= config.bin %> gpu details                                          # pick from a list (TTY)",
+        "<%= config.bin %> gpu details web-01                                   # by hostname",
+        "<%= config.bin %> gpu details 019f155b                                 # by short id",
+        "<%= config.bin %> gpu details 192.0.2.45 -o json                       # by IP, as JSON",
+    ];
     static aliases = [];
     static args = ResourceDetails.args;
     static flags = ResourceDetails.flags;
     static baseFlags = ResourceDetails.baseFlags;
+    matchesKind() {
+        return "gpu_cloud";
+    }
 }
 //# sourceMappingURL=details.js.map

package/dist/commands/gpu/details.js.map

@@ -1 +1 @@
-{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../src/commands/gpu/details.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,eAAe;IACrD,MAAM,CAAC,WAAW,GAAG,6EAA6E,CAAC;IACnG,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../src/commands/gpu/details.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,eAAe;IACrD,MAAM,CAAC,WAAW,GAAG,6EAA6E,CAAC;IACnG,MAAM,CAAC,QAAQ,GAAG;QACd,iGAAiG;QACjG,sFAAsF;QACtF,sFAAsF;QACtF,yFAAyF;KAC1F,CAAC;IACJ,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;IAEnC,WAAW;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC"}

package/dist/commands/gpu/ip/add.d.ts

@@ -1,6 +1,7 @@
 import ResourceIpAdd from "../../vps/ip/add.js";
 export default class GpuIpAdd extends ResourceIpAdd {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/ip/add.js

@@ -1,6 +1,12 @@
 import ResourceIpAdd from "../../vps/ip/add.js";
 export default class GpuIpAdd extends ResourceIpAdd {
     static description = "Buy extra IPv4 addresses for a GPU Cloud instance (charges immediately).";
+    static examples = [
+        "<%= config.bin %> gpu ip add 019e...                                     # 1 IP, prompts for payment + confirm",
+        "<%= config.bin %> gpu ip add 019e... --quantity 2 --payment-method 019f... --yes",
+        "<%= config.bin %> gpu ip add 019e... --apply-credits --yes -o json       # credits first; agent-friendly",
+        "<%= config.bin %> gpu ip add 019e... --billing-mode new_cycle --payment-method 019f... --yes",
+    ];
     static args = ResourceIpAdd.args;
     static flags = ResourceIpAdd.flags;
     static baseFlags = ResourceIpAdd.baseFlags;

package/dist/commands/gpu/ip/add.js.map

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../src/commands/gpu/ip/add.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,0EAA0E,CAAC;IAChG,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../src/commands/gpu/ip/add.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,0EAA0E,CAAC;IAChG,MAAM,CAAC,QAAQ,GAAG;QACd,gHAAgH;QAChH,kFAAkF;QAClF,0GAA0G;QAC1G,8FAA8F;KAC/F,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/ip/list.d.ts

@@ -1,6 +1,7 @@
 import ResourceIpList from "../../vps/ip/list.js";
 export default class GpuIpList extends ResourceIpList {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/ip/list.js

@@ -1,6 +1,10 @@
 import ResourceIpList from "../../vps/ip/list.js";
 export default class GpuIpList extends ResourceIpList {
     static description = "List a GPU Cloud instance's IP addresses and extra-IP add-ons.";
+    static examples = [
+        "<%= config.bin %> gpu ip list 019e...",
+        "<%= config.bin %> gpu ip list 019e... -o json      # {ips, addons, pending_addons}",
+    ];
     static args = ResourceIpList.args;
     static flags = ResourceIpList.flags;
     static baseFlags = ResourceIpList.baseFlags;

package/dist/commands/gpu/ip/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gpu/ip/list.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAc;IACnD,MAAM,CAAC,WAAW,GAAG,gEAAgE,CAAC;IACtF,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;IACpC,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/gpu/ip/list.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAc;IACnD,MAAM,CAAC,WAAW,GAAG,gEAAgE,CAAC;IACtF,MAAM,CAAC,QAAQ,GAAG;QACd,uCAAuC;QACvC,oFAAoF;KACrF,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;IACpC,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/order.js

@@ -4,6 +4,8 @@ export default class GpuOrder extends ResourceOrder {
     static examples = [
         "<%= config.bin %> gpu order                        # interactive wizard, pre-filtered to GPU Cloud",
         "<%= config.bin %> gpu order --project <id> --plan <id> --location <id> --image <id> --payment-method <id>",
+        "<%= config.bin %> gpu order --plan <id> --location <id> --image <id> --payment-method <id> --billing-cycle yearly",
+        "                                                   # plan must have the yearly cycle enabled",
     ];
     async run() {
         this.argv.push("--category", "gpu_cloud");

package/dist/commands/gpu/order.js.map

@@ -1 +1 @@
-{"version":3,"file":"order.js","sourceRoot":"","sources":["../../../src/commands/gpu/order.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,6FAA6F,CAAC;IACnH,MAAM,CAAC,QAAQ,GAAG;QAChB,oGAAoG;QACpG,2GAA2G;KAC5G,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC"}
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../../src/commands/gpu/order.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,6FAA6F,CAAC;IACnH,MAAM,CAAC,QAAQ,GAAG;QAChB,oGAAoG;QACpG,2GAA2G;QAC3G,mHAAmH;QACnH,8FAA8F;KAC/F,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC"}

package/dist/commands/gpu/power.d.ts

@@ -1,6 +1,7 @@
 import ResourcePower from "../vps/power.js";
 export default class GpuPower extends ResourcePower {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         action: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;

package/dist/commands/gpu/power.js

@@ -1,6 +1,12 @@
 import ResourcePower from "../vps/power.js";
 export default class GpuPower extends ResourcePower {
     static description = "Power a GPU Cloud instance on/off, reboot, shutdown, or cycle.";
+    static examples = [
+        "<%= config.bin %> gpu power 019e... on",
+        "<%= config.bin %> gpu power 019e... shutdown --wait          # block until stopped; prompts first",
+        "<%= config.bin %> gpu power 019e... stop --yes               # no prompt (required when piped)",
+        "<%= config.bin %> gpu power 019e... cycle --yes --wait --timeout 300 -o json",
+    ];
     static args = ResourcePower.args;
     static flags = ResourcePower.flags;
     static baseFlags = ResourcePower.baseFlags;

package/dist/commands/gpu/power.js.map

@@ -1 +1 @@
-{"version":3,"file":"power.js","sourceRoot":"","sources":["../../../src/commands/gpu/power.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,gEAAgE,CAAC;IACtF,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}
+{"version":3,"file":"power.js","sourceRoot":"","sources":["../../../src/commands/gpu/power.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,gEAAgE,CAAC;IACtF,MAAM,CAAC,QAAQ,GAAG;QACd,wCAAwC;QACxC,mGAAmG;QACnG,gGAAgG;QAChG,8EAA8E;KAC/E,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/reinstall.d.ts

@@ -1,6 +1,7 @@
 import ResourceReinstall from "../vps/reinstall.js";
 export default class GpuReinstall extends ResourceReinstall {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/reinstall.js

@@ -1,6 +1,13 @@
 import ResourceReinstall from "../vps/reinstall.js";
 export default class GpuReinstall extends ResourceReinstall {
     static description = "Reinstall a GPU Cloud instance with a new OS image (erases all data).";
+    static examples = [
+        "<%= config.bin %> gpu reinstall 019e... --image 019f...              # confirms, then prompts (masked) for a root password",
+        "cat pass.txt | <%= config.bin %> gpu reinstall 019e... --image 019f... --password-stdin --yes",
+        "<%= config.bin %> gpu reinstall 019e... --image 019f... --ssh-key 019g... --wait --yes",
+        "<%= config.bin %> gpu reinstall 019e... --image 019f... --ssh-public-key 'ssh-ed25519 AAAA... user@host'",
+        "<%= config.bin %> gpu reinstall 019e... --image 019f... --ssh-key 019g... --ciuser ubuntu",
+    ];
     static args = ResourceReinstall.args;
     static flags = ResourceReinstall.flags;
     static baseFlags = ResourceReinstall.baseFlags;

package/dist/commands/gpu/reinstall.js.map

@@ -1 +1 @@
-{"version":3,"file":"reinstall.js","sourceRoot":"","sources":["../../../src/commands/gpu/reinstall.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,uEAAuE,CAAC;IAC7F,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"reinstall.js","sourceRoot":"","sources":["../../../src/commands/gpu/reinstall.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,iBAAiB;IACzD,MAAM,CAAC,WAAW,GAAG,uEAAuE,CAAC;IAC7F,MAAM,CAAC,QAAQ,GAAG;QACd,4HAA4H;QAC5H,+FAA+F;QAC/F,wFAAwF;QACxF,0GAA0G;QAC1G,2FAA2F;KAC5F,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/resize.d.ts

@@ -1,6 +1,7 @@
 import ResourceResize from "../vps/resize.js";
 export default class GpuResize extends ResourceResize {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/resize.js

@@ -1,6 +1,12 @@
 import ResourceResize from "../vps/resize.js";
 export default class GpuResize extends ResourceResize {
     static description = "Resize a GPU Cloud instance (change CPU / RAM / disk / bandwidth in place).";
+    static examples = [
+        "<%= config.bin %> gpu resize 019e... --ram 8 --yes                    # bump RAM to 8 GB; keep CPU/disk",
+        "<%= config.bin %> gpu resize 019e... --plan <planId> --payment-method <id> --yes",
+        "<%= config.bin %> gpu resize 019e... --cpu 4 --ram 8 --disk 120       # TTY: quote + confirm interactively",
+        "<%= config.bin %> gpu resize 019e... --disk 200 --apply-credits -o json",
+    ];
     static args = ResourceResize.args;
     static flags = ResourceResize.flags;
     static baseFlags = ResourceResize.baseFlags;

package/dist/commands/gpu/resize.js.map

@@ -1 +1 @@
-{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../../src/commands/gpu/resize.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAc;IACnD,MAAM,CAAC,WAAW,GAAG,6EAA6E,CAAC;IACnG,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;IACpC,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC"}
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../../src/commands/gpu/resize.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAc;IACnD,MAAM,CAAC,WAAW,GAAG,6EAA6E,CAAC;IACnG,MAAM,CAAC,QAAQ,GAAG;QACd,yGAAyG;QACzG,kFAAkF;QAClF,4GAA4G;QAC5G,yEAAyE;KAC1E,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;IAClC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;IACpC,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC"}

package/dist/commands/gpu/stats.d.ts

@@ -1,6 +1,7 @@
 import ResourceStats from "../vps/stats.js";
 export default class GpuStats extends ResourceStats {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/gpu/stats.js

@@ -1,6 +1,11 @@
 import ResourceStats from "../vps/stats.js";
 export default class GpuStats extends ResourceStats {
     static description = "Show live CPU / memory / disk / uptime + network I/O for a GPU Cloud instance.";
+    static examples = [
+        "<%= config.bin %> gpu stats 019e...",
+        "<%= config.bin %> gpu stats 019e... --timeframe day    # sparklines over the last day",
+        "<%= config.bin %> gpu stats 019e... -o json            # raw RRD array for scripting",
+    ];
     static args = ResourceStats.args;
     static flags = ResourceStats.flags;
     static baseFlags = ResourceStats.baseFlags;

package/dist/commands/gpu/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/commands/gpu/stats.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,gFAAgF,CAAC;IACtG,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/commands/gpu/stats.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,aAAa;IACjD,MAAM,CAAC,WAAW,GAAG,gFAAgF,CAAC;IACtG,MAAM,CAAC,QAAQ,GAAG;QACd,qCAAqC;QACrC,uFAAuF;QACvF,sFAAsF;KACvF,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}

package/dist/commands/instant-metal/activity.d.ts

@@ -1,6 +1,7 @@
 import ResourceActivity from "../vps/activity.js";
 export default class InstantMetalActivity extends ResourceActivity {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/instant-metal/activity.js

@@ -1,6 +1,12 @@
 import ResourceActivity from "../vps/activity.js";
 export default class InstantMetalActivity extends ResourceActivity {
     static description = "Show recent activity for an Instant Metal instance.";
+    static examples = [
+        "<%= config.bin %> instant-metal activity 019e...",
+        "<%= config.bin %> instant-metal activity 019e... --limit 50",
+        "<%= config.bin %> instant-metal activity 019e... --limit 25 --offset 25",
+        "<%= config.bin %> instant-metal activity 019e... -o json",
+    ];
     static args = ResourceActivity.args;
     static flags = ResourceActivity.flags;
     static baseFlags = ResourceActivity.baseFlags;

package/dist/commands/instant-metal/activity.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/activity.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,gBAAgB;IAChE,MAAM,CAAC,WAAW,GAAG,qDAAqD,CAAC;IAC3E,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;IACtC,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/activity.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,gBAAgB;IAChE,MAAM,CAAC,WAAW,GAAG,qDAAqD,CAAC;IAC3E,MAAM,CAAC,QAAQ,GAAG;QACd,kDAAkD;QAClD,6DAA6D;QAC7D,yEAAyE;QACzE,0DAA0D;KAC3D,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;IACtC,MAAM,CAAC,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC"}

package/dist/commands/instant-metal/bandwidth.d.ts

@@ -1,6 +1,7 @@
 import ResourceBandwidth from "../vps/bandwidth.js";
 export default class InstantMetalBandwidth extends ResourceBandwidth {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/instant-metal/bandwidth.js

@@ -1,6 +1,10 @@
 import ResourceBandwidth from "../vps/bandwidth.js";
 export default class InstantMetalBandwidth extends ResourceBandwidth {
     static description = "Show an Instant Metal instance's bandwidth usage (month-to-date, allowance, overage).";
+    static examples = [
+        "<%= config.bin %> instant-metal bandwidth 019e...",
+        "<%= config.bin %> instant-metal bandwidth 019e... -o json    # full summary for scripting",
+    ];
     static args = ResourceBandwidth.args;
     static flags = ResourceBandwidth.flags;
     static baseFlags = ResourceBandwidth.baseFlags;

package/dist/commands/instant-metal/bandwidth.js.map

@@ -1 +1 @@
-{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;IAClE,MAAM,CAAC,WAAW,GAAG,uFAAuF,CAAC;IAC7G,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"bandwidth.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/bandwidth.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;IAClE,MAAM,CAAC,WAAW,GAAG,uFAAuF,CAAC;IAC7G,MAAM,CAAC,QAAQ,GAAG;QACd,mDAAmD;QACnD,2FAA2F;KAC5F,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}

package/dist/commands/instant-metal/boot-order.d.ts

@@ -1,6 +1,7 @@
 import ResourceBootOrder from "../vps/boot-order.js";
 export default class InstantMetalBootOrder extends ResourceBootOrder {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
         order: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;

package/dist/commands/instant-metal/boot-order.js

@@ -1,6 +1,11 @@
 import ResourceBootOrder from "../vps/boot-order.js";
 export default class InstantMetalBootOrder extends ResourceBootOrder {
     static description = "View or set an Instant Metal instance's boot order.";
+    static examples = [
+        "<%= config.bin %> instant-metal boot-order 019e...                               # read current",
+        "<%= config.bin %> instant-metal boot-order 019e... disk_first",
+        "<%= config.bin %> instant-metal boot-order 019e... cdrom_first",
+    ];
     static args = ResourceBootOrder.args;
     static flags = ResourceBootOrder.flags;
     static baseFlags = ResourceBootOrder.baseFlags;

package/dist/commands/instant-metal/boot-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot-order.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/boot-order.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;IAClE,MAAM,CAAC,WAAW,GAAG,qDAAqD,CAAC;IAC3E,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}
+{"version":3,"file":"boot-order.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/boot-order.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,iBAAiB;IAClE,MAAM,CAAC,WAAW,GAAG,qDAAqD,CAAC;IAC3E,MAAM,CAAC,QAAQ,GAAG;QACd,iGAAiG;QACjG,+DAA+D;QAC/D,gEAAgE;KACjE,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;IACrC,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACvC,MAAM,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC"}

package/dist/commands/instant-metal/console.d.ts

@@ -1,6 +1,7 @@
 import ResourceConsole from "../vps/console.js";
 export default class InstantMetalConsole extends ResourceConsole {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/instant-metal/console.js

@@ -1,6 +1,11 @@
 import ResourceConsole from "../vps/console.js";
 export default class InstantMetalConsole extends ResourceConsole {
     static description = "Open an Instant Metal console (interactive serial, or a browser URL for graphical).";
+    static examples = [
+        "<%= config.bin %> instant-metal console 019e...                                 # attach serial (TTY) or print URL",
+        "<%= config.bin %> instant-metal console 019e... --print-url                     # always print the browser URL",
+        "<%= config.bin %> instant-metal console 019e... --print-url -o json             # {url, token, console_type} for scripting",
+    ];
     static args = ResourceConsole.args;
     static flags = ResourceConsole.flags;
     static baseFlags = ResourceConsole.baseFlags;

package/dist/commands/instant-metal/console.js.map

@@ -1 +1 @@
-{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/console.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,eAAe;IAC9D,MAAM,CAAC,WAAW,GAAG,qFAAqF,CAAC;IAC3G,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/console.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,eAAe;IAC9D,MAAM,CAAC,WAAW,GAAG,qFAAqF,CAAC;IAC3G,MAAM,CAAC,QAAQ,GAAG;QACd,oHAAoH;QACpH,gHAAgH;QAChH,4HAA4H;KAC7H,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}

package/dist/commands/instant-metal/details.d.ts

@@ -1,6 +1,7 @@
 import ResourceDetails from "../vps/details.js";
 export default class InstantMetalDetails extends ResourceDetails {
     static description: string;
+    static examples: string[];
     static aliases: never[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
@@ -13,4 +14,5 @@ export default class InstantMetalDetails extends ResourceDetails {
         output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         insecure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    protected matchesKind(): string;
 }

package/dist/commands/instant-metal/details.js

@@ -1,9 +1,18 @@
 import ResourceDetails from "../vps/details.js";
 export default class InstantMetalDetails extends ResourceDetails {
     static description = "Show full details for one Instant Metal instance. With no id, pick from a list.";
+    static examples = [
+        "<%= config.bin %> instant-metal details                                          # pick from a list (TTY)",
+        "<%= config.bin %> instant-metal details web-01                                   # by hostname",
+        "<%= config.bin %> instant-metal details 019f155b                                 # by short id",
+        "<%= config.bin %> instant-metal details 192.0.2.45 -o json                       # by IP, as JSON",
+    ];
     static aliases = [];
     static args = ResourceDetails.args;
     static flags = ResourceDetails.flags;
     static baseFlags = ResourceDetails.baseFlags;
+    matchesKind() {
+        return "instant_metal";
+    }
 }
 //# sourceMappingURL=details.js.map

package/dist/commands/instant-metal/details.js.map

@@ -1 +1 @@
-{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/details.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,eAAe;IAC9D,MAAM,CAAC,WAAW,GAAG,iFAAiF,CAAC;IACvG,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC"}
+{"version":3,"file":"details.js","sourceRoot":"","sources":["../../../src/commands/instant-metal/details.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,eAAe;IAC9D,MAAM,CAAC,WAAW,GAAG,iFAAiF,CAAC;IACvG,MAAM,CAAC,QAAQ,GAAG;QACd,2GAA2G;QAC3G,gGAAgG;QAChG,gGAAgG;QAChG,mGAAmG;KACpG,CAAC;IACJ,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACnC,MAAM,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;IACrC,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;IAEnC,WAAW;QACnB,OAAO,eAAe,CAAC;IACzB,CAAC"}

package/dist/commands/instant-metal/ip/add.d.ts

@@ -1,6 +1,7 @@
 import ResourceIpAdd from "../../vps/ip/add.js";
 export default class InstantMetalIpAdd extends ResourceIpAdd {
     static description: string;
+    static examples: string[];
     static args: {
         id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };

package/dist/commands/instant-metal/ip/add.js

@@ -1,6 +1,12 @@
 import ResourceIpAdd from "../../vps/ip/add.js";
 export default class InstantMetalIpAdd extends ResourceIpAdd {
     static description = "Buy extra IPv4 addresses for an Instant Metal instance (charges immediately).";
+    static examples = [
+        "<%= config.bin %> instant-metal ip add 019e...                                     # 1 IP, prompts for payment + confirm",
+        "<%= config.bin %> instant-metal ip add 019e... --quantity 2 --payment-method 019f... --yes",
+        "<%= config.bin %> instant-metal ip add 019e... --apply-credits --yes -o json       # credits first; agent-friendly",
+        "<%= config.bin %> instant-metal ip add 019e... --billing-mode new_cycle --payment-method 019f... --yes",
+    ];
     static args = ResourceIpAdd.args;
     static flags = ResourceIpAdd.flags;
     static baseFlags = ResourceIpAdd.baseFlags;

package/dist/commands/instant-metal/ip/add.js.map

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../src/commands/instant-metal/ip/add.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D,MAAM,CAAC,WAAW,GAAG,+EAA+E,CAAC;IACrG,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../src/commands/instant-metal/ip/add.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,aAAa;IAC1D,MAAM,CAAC,WAAW,GAAG,+EAA+E,CAAC;IACrG,MAAM,CAAC,QAAQ,GAAG;QACd,0HAA0H;QAC1H,4FAA4F;QAC5F,oHAAoH;QACpH,wGAAwG;KACzG,CAAC;IACJ,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;IACjC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IACnC,MAAM,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC"}