trainfabric 0.1.48 → 0.1.49

package/dist/index.cjs

@@ -9362,7 +9362,7 @@ function buildComputeSpec(options) {
 
 // src/index.ts
 var DEFAULT_TRAINFABRIC_API_URL2 = "https://api.trainfabric.com";
-var CLI_VERSION = "0.1.48";
+var CLI_VERSION = "0.1.49";
 var CONFIG_DIR = import_node_path3.default.join(import_node_os2.default.homedir(), ".trainfabric");
 var CONFIG_PATH = import_node_path3.default.join(CONFIG_DIR, "config.json");
 var FALLBACK_SECRET_PATH = import_node_path3.default.join(CONFIG_DIR, "session.enc");
@@ -10034,6 +10034,73 @@ async function login(config) {
 }
 var program2 = new Command();
 program2.name("trainfabric").description("Trainfabric CLI for launching and monitoring GPU training jobs").version(CLI_VERSION);
+program2.command("runs").description("Show run command group help").addHelpText(
+  "after",
+  `
+Run commands:
+  trainfabric runs:quote      Preview Efficient, Balanced, and Power launch options
+  trainfabric runs:create     Launch a run from an accepted quote
+  trainfabric runs:list       List runs
+  trainfabric runs:status     Fetch full run detail
+  trainfabric runs:logs       Fetch run logs
+  trainfabric runs:wait       Wait for a terminal state
+  trainfabric runs:watch      Stream run events
+  trainfabric runs:usage      Show run usage and charges
+  trainfabric runs:cancel     Cancel a queued or active run
+  trainfabric runs:terminate  Terminate an active run
+
+Use --help on any command for options.`
+).action(() => {
+  console.log(`Run commands:
+  trainfabric runs:quote      Preview Efficient, Balanced, and Power launch options
+  trainfabric runs:create     Launch a run from an accepted quote
+  trainfabric runs:list       List runs
+  trainfabric runs:status     Fetch full run detail
+  trainfabric runs:logs       Fetch run logs
+  trainfabric runs:wait       Wait for a terminal state
+  trainfabric runs:watch      Stream run events
+  trainfabric runs:usage      Show run usage and charges
+  trainfabric runs:cancel     Cancel a queued or active run
+  trainfabric runs:terminate  Terminate an active run
+
+Use --help on any command for options.`);
+});
+program2.command("datasets").description("Show dataset command group help").addHelpText(
+  "after",
+  `
+Dataset commands:
+  trainfabric datasets:validate  Validate a JSONL dataset file
+  trainfabric datasets:upload    Upload a dataset
+  trainfabric datasets:list      List datasets
+  trainfabric datasets:get       Fetch dataset detail
+  trainfabric datasets:delete    Delete a dataset
+
+Use --help on any command for options.`
+).action(() => {
+  console.log(`Dataset commands:
+  trainfabric datasets:validate  Validate a JSONL dataset file
+  trainfabric datasets:upload    Upload a dataset
+  trainfabric datasets:list      List datasets
+  trainfabric datasets:get       Fetch dataset detail
+  trainfabric datasets:delete    Delete a dataset
+
+Use --help on any command for options.`);
+});
+program2.command("models").description("Show model command group help").addHelpText(
+  "after",
+  `
+Model commands:
+  trainfabric models:list    List ready/exported models
+  trainfabric models:export  Fetch the export package path for a model
+
+Use --help on any command for options.`
+).action(() => {
+  console.log(`Model commands:
+  trainfabric models:list    List ready/exported models
+  trainfabric models:export  Fetch the export package path for a model
+
+Use --help on any command for options.`);
+});
 program2.command("login").description("Paste and store a TrainFabric API key").action(async () => {
   await login(loadConfig());
 });
@@ -10131,10 +10198,10 @@ program2.command("datasets:validate").argument("<file>").description("Validate a
     process.exitCode = 1;
   }
 });
-program2.command("datasets:list").option("--project <projectId>").description("List datasets").action(async (options) => {
+program2.command("datasets:list").option("--project <projectId>").option("--json", "print raw JSON output; this is the default").description("List datasets").action(async (options) => {
   printJson(await createClient(loadConfig()).datasets.list(normalizeOptionalId(options.project, "project", "Project ID")));
 });
-program2.command("datasets:get").argument("<datasetId>").description("Fetch dataset detail").action(async (datasetId) => {
+program2.command("datasets:get").argument("<datasetId>").option("--json", "print raw JSON output; this is the default").description("Fetch dataset detail").action(async (datasetId) => {
   printJson(await createClient(loadConfig()).datasets.get(normalizeId(datasetId, "dataset", "Dataset ID")));
 });
 program2.command("datasets:delete").argument("<datasetId>").description("Delete a dataset").action(async (datasetId) => {
@@ -10173,7 +10240,7 @@ program2.command("runs:create").option("--project <projectId>").option("--datase
   const run = await client.runs.create(runInput);
   printJson(run.snapshot);
 });
-program2.command("runtime:detect").option("--project <projectId>").option("--repo <path>").option("--git <url>").option("--branch <branch>").description("Detect a supported runtime from a local repo snapshot or git metadata").action(async (options) => {
+program2.command("runtime:detect").option("--project <projectId>").option("--repo <path>").option("--git <url>").option("--branch <branch>").option("--json", "print raw JSON output; this is the default").description("Detect a supported runtime from a local repo snapshot or git metadata").action(async (options) => {
   const sourceOptions = buildSourceOptions(options);
   if (!sourceOptions.source) {
     throw new Error("Provide --repo or --git.");
@@ -10231,7 +10298,7 @@ program2.command("runs:status").argument("<runId>").description("Fetch full run
   const detail = await createClient(loadConfig()).runs.get(normalizeId(runId, "run", "Run ID"));
   printJson({ ...detail, ...detail.run });
 });
-program2.command("runs:logs").argument("<runId>").description("Fetch run logs").action(async (runId) => {
+program2.command("runs:logs").argument("<runId>").option("--json", "print raw JSON output; this is the default").description("Fetch run logs").action(async (runId) => {
   printJson(await createClient(loadConfig()).runs.logs(normalizeId(runId, "run", "Run ID")));
 });
 program2.command("runs:wait").argument("<runId>").option("--timeout <duration>", "maximum wait duration, for example 30s, 10m, or 1h").option("--poll <duration>", "poll interval, for example 1s or 500ms").option("--summary", "print a compact terminal run summary").description("Wait for a run to reach a terminal state").action(async (runId, options) => {
@@ -10245,7 +10312,7 @@ program2.command("runs:wait").argument("<runId>").option("--timeout <duration>",
 program2.command("runs:watch").argument("<runId>").option("--json", "emit event output as JSON").option("--timeout <duration>", "maximum watch duration, for example 30s, 10m, or 1h").option("--poll <duration>", "poll interval, for example 1s or 500ms").description("Stream a run until it completes").action(async (runId, options) => {
   await watchRun(normalizeId(runId, "run", "Run ID"), Boolean(options.json), parseDurationMs(options.timeout), parsePositiveMs(options.poll, 1e3));
 });
-program2.command("runs:usage").argument("<runId>").option("--summary", "print a human-readable cost summary instead of raw JSON").description("Fetch run usage summary").action(async (runId, options) => {
+program2.command("runs:usage").argument("<runId>").option("--json", "print raw JSON output; this is the default unless --summary is used").option("--summary", "print a human-readable cost summary instead of raw JSON").description("Fetch run usage summary").action(async (runId, options) => {
   const usage = await createClient(loadConfig()).runs.usage(normalizeId(runId, "run", "Run ID"));
   if (options.summary) {
     printUsageSummary(usage);
@@ -10285,7 +10352,7 @@ program2.command("cluster:capacity").description("Fetch cluster capacity view").
 program2.command("cluster:pools").description("List inventory pools").action(async () => {
   printJson(await createClient(loadConfig()).cluster.listInventoryPools());
 });
-program2.command("models:list").description("List exported models").action(async () => {
+program2.command("models:list").option("--json", "print raw JSON output; this is the default").description("List exported models").action(async () => {
   printJson(await createClient(loadConfig()).models.list());
 });
 program2.command("models:export").argument("<modelId>").description("Fetch the export package path for a model").action(async (modelId) => {
@@ -10324,7 +10391,12 @@ program2.command("billing:usage").option("--unit <unit>", "normalized_tflop_seco
   const runId = normalizeOptionalId(options.run, "run", "Run ID");
   const unit = normalizeOptionalBillingUnit(options.unit);
   const client = createClient(loadConfig());
-  printJson(runId && !unit ? await client.billing.getRunUsage(runId) : await client.billing.getUsage(unit, runId));
+  if (runId) {
+    const summary = await client.billing.getRunUsage(runId);
+    printJson(unit ? { ...summary, unit, usage: summary.usage.filter((entry) => entry.unit === unit) } : summary);
+    return;
+  }
+  printJson(await client.billing.getUsage(unit));
 });
 program2.command("billing:invoices").description("List invoices").action(async () => {
   printJson(await createClient(loadConfig()).billing.listInvoices());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trainfabric",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "description": "Trainfabric CLI for launching GPU training jobs on the hosted Trainfabric backend.",
   "type": "module",
   "main": "dist/index.cjs",