@asteroidai/cli 1.8.197 → 1.9.2

package/dist/asteroid.js

@@ -57,7 +57,7 @@ function columns(rows) {
   const scalarKeys = [];
   for (const row of rows) {
     for (const [key, value2] of Object.entries(row)) {
-      if (isScalar(value2) && !HIDDEN.test(key) && !scalarKeys.includes(key))
+      if (isScalar(value2) && !HIDDEN.test(key.split(".").at(-1) ?? key) && !scalarKeys.includes(key))
         scalarKeys.push(key);
     }
   }
@@ -70,8 +70,21 @@ function columns(rows) {
 function style(format, value2, options) {
   return options.styled ? styleText(format, value2, { validateStream: false }) : value2;
 }
-function table(rows, options = {}) {
-  if (rows.length === 0) return "No results.";
+function flatten(row) {
+  const flat = {};
+  for (const [key, value2] of Object.entries(row)) {
+    if (!isObject(value2)) {
+      flat[key] = value2;
+      continue;
+    }
+    for (const [inner, v] of Object.entries(value2))
+      flat[`${key}.${inner}`] = v;
+  }
+  return flat;
+}
+function table(input, options = {}) {
+  if (input.length === 0) return "No results.";
+  const rows = input.map(flatten);
   const keys = columns(rows);
   if (keys.length === 0) return rows.map((row) => text(row)).join("\n");
   const cells = rows.map((row) => keys.map((key) => cell(row[key])));
@@ -108,6 +121,10 @@ ${indent(table(v, options))}`;
     if (Array.isArray(v) && v.length > 0 && v.every(isScalar)) {
       return `${label(key)}  ${v.map(text).join(`
 ${" ".repeat(width + 2)}`)}`;
+    }
+    if (isObject(v) && Object.keys(v).length > 0) {
+      return `${style("bold", key, options)}:
+${indent(record(v, options))}`;
     }
     return `${label(key)}  ${isScalar(v) ? text(v) : summary(v)}`;
   }).join("\n");
@@ -4875,16 +4892,25 @@ function defineCommands(root, options, dotted = /* @__PURE__ */ new Map(), onInv
     const defaults = command.args.map(
       (arg) => options.defaultArg?.(command, arg)
     );
-    command.args.forEach((arg, i) => {
+    const defaulted = defaults[0] !== void 0;
+    command.args.forEach((arg) => {
       leaf.argument(
-        defaults[i] === void 0 ? `<${arg.flag}>` : `[${arg.flag}]`,
+        defaulted ? `[${arg.flag}]` : `<${arg.flag}>`,
         arg.description ?? ""
       );
     });
-    if (defaults.some((value2) => value2 !== void 0) && options.defaultArgNote) {
-      leaf.addHelpText("after", `
-${options.defaultArgNote}`);
+    if (defaulted) {
+      const names = command.args.map(
+        (arg, i) => i === 0 ? `[${arg.flag}]` : `<${arg.flag}>`
+      );
+      leaf.usage(`[options] ${names.join(" ")}`);
     }
+    const notes = [
+      defaults.some((value2) => value2 !== void 0) ? options.defaultArgNote : void 0,
+      options.helpNote?.(command)
+    ].filter(Boolean);
+    if (notes.length > 0) leaf.addHelpText("after", `
+${notes.join("\n")}`);
     leafOptions(leaf, command);
     leaf.action((...args) => {
       const cmd = args.at(-1);
@@ -4893,7 +4919,7 @@ ${options.defaultArgNote}`);
         positionals = [defaults[0], ...positionals];
       }
       if (positionals.length !== command.args.length) {
-        const expected = command.args.map((a) => `<${a.flag}>`).join(" ");
+        const expected = command.args.map((a, i) => i === 0 && defaulted ? `[${a.flag}]` : `<${a.flag}>`).join(" ");
         throw new UsageError(
           `expected ${expected}, got ${cmd.args.length} argument(s)`
         );
@@ -5303,7 +5329,7 @@ var ApiError = class extends Error {
   status;
   body;
 };
-var VERSION = "1.8.197";
+var VERSION = "1.9.2";
 function problem(status, body, fallback) {
   if (body && typeof body === "object") {
     const record2 = body;

package/dist/core.js

@@ -4569,7 +4569,7 @@ function columns(rows) {
   const scalarKeys = [];
   for (const row of rows) {
     for (const [key, value2] of Object.entries(row)) {
-      if (isScalar(value2) && !HIDDEN.test(key) && !scalarKeys.includes(key))
+      if (isScalar(value2) && !HIDDEN.test(key.split(".").at(-1) ?? key) && !scalarKeys.includes(key))
         scalarKeys.push(key);
     }
   }
@@ -4582,8 +4582,21 @@ function columns(rows) {
 function style(format, value2, options) {
   return options.styled ? styleText(format, value2, { validateStream: false }) : value2;
 }
-function table(rows, options = {}) {
-  if (rows.length === 0) return "No results.";
+function flatten(row) {
+  const flat = {};
+  for (const [key, value2] of Object.entries(row)) {
+    if (!isObject(value2)) {
+      flat[key] = value2;
+      continue;
+    }
+    for (const [inner, v] of Object.entries(value2))
+      flat[`${key}.${inner}`] = v;
+  }
+  return flat;
+}
+function table(input, options = {}) {
+  if (input.length === 0) return "No results.";
+  const rows = input.map(flatten);
   const keys = columns(rows);
   if (keys.length === 0) return rows.map((row) => text(row)).join("\n");
   const cells = rows.map((row) => keys.map((key) => cell(row[key])));
@@ -4620,6 +4633,10 @@ ${indent(table(v, options))}`;
     if (Array.isArray(v) && v.length > 0 && v.every(isScalar)) {
       return `${label(key)}  ${v.map(text).join(`
 ${" ".repeat(width + 2)}`)}`;
+    }
+    if (isObject(v) && Object.keys(v).length > 0) {
+      return `${style("bold", key, options)}:
+${indent(record(v, options))}`;
     }
     return `${label(key)}  ${isScalar(v) ? text(v) : summary(v)}`;
   }).join("\n");
@@ -4808,16 +4825,25 @@ function defineCommands(root, options, dotted = /* @__PURE__ */ new Map(), onInv
     const defaults = command.args.map(
       (arg) => options.defaultArg?.(command, arg)
     );
-    command.args.forEach((arg, i) => {
+    const defaulted = defaults[0] !== void 0;
+    command.args.forEach((arg) => {
       leaf.argument(
-        defaults[i] === void 0 ? `<${arg.flag}>` : `[${arg.flag}]`,
+        defaulted ? `[${arg.flag}]` : `<${arg.flag}>`,
         arg.description ?? ""
       );
     });
-    if (defaults.some((value2) => value2 !== void 0) && options.defaultArgNote) {
-      leaf.addHelpText("after", `
-${options.defaultArgNote}`);
+    if (defaulted) {
+      const names = command.args.map(
+        (arg, i) => i === 0 ? `[${arg.flag}]` : `<${arg.flag}>`
+      );
+      leaf.usage(`[options] ${names.join(" ")}`);
     }
+    const notes = [
+      defaults.some((value2) => value2 !== void 0) ? options.defaultArgNote : void 0,
+      options.helpNote?.(command)
+    ].filter(Boolean);
+    if (notes.length > 0) leaf.addHelpText("after", `
+${notes.join("\n")}`);
     leafOptions(leaf, command);
     leaf.action((...args) => {
       const cmd = args.at(-1);
@@ -4826,7 +4852,7 @@ ${options.defaultArgNote}`);
         positionals = [defaults[0], ...positionals];
       }
       if (positionals.length !== command.args.length) {
-        const expected = command.args.map((a) => `<${a.flag}>`).join(" ");
+        const expected = command.args.map((a, i) => i === 0 && defaulted ? `[${a.flag}]` : `<${a.flag}>`).join(" ");
         throw new UsageError(
           `expected ${expected}, got ${cmd.args.length} argument(s)`
         );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteroidai/cli",
-  "version": "1.8.197",
+  "version": "1.9.2",
   "description": "The asteroid command-line interface for the Asteroid platform.",
   "type": "module",
   "license": "MIT",

package/src/output.test.ts

@@ -23,4 +23,30 @@ describe("render", () => {
     expect(render(rows)).not.toContain("┌");
     expect(render(rows, { styled: true })).toContain("┌");
   });
+
+  it("prints nested objects in full, not as cut JSON", () => {
+    const out = render({
+      workflow: { id: "3cfc3c1d-e38d-4132-a5ee-8847136d491d", name: "Nebula" },
+      version: { version: 3, isPublished: true },
+    });
+    expect(out).toContain("3cfc3c1d-e38d-4132-a5ee-8847136d491d");
+    expect(out).toMatch(/workflow:\n {2}id +3cfc3c1d/);
+    expect(out).not.toContain("…");
+  });
+
+  it("flattens one level of nested fields into table columns", () => {
+    const out = render([
+      { date: "2026-10-09", outcomes: { success: 3, failure: 1 } },
+    ]);
+    expect(out).toContain("OUTCOMES.SUCCESS");
+    expect(out).toMatch(/2026-10-09 +3 +1/);
+  });
+
+  it("hides nested fields that are hidden at the top level", () => {
+    const out = render([
+      { id: "1", execution: { agentId: "a-1", status: "failed" } },
+    ]);
+    expect(out).toContain("EXECUTION.STATUS");
+    expect(out).not.toContain("AGENTID");
+  });
 });

package/src/output.ts

@@ -59,7 +59,11 @@ function columns(rows: Row[]): string[] {
   const scalarKeys: string[] = [];
   for (const row of rows) {
     for (const [key, value] of Object.entries(row)) {
-      if (isScalar(value) && !HIDDEN.test(key) && !scalarKeys.includes(key))
+      if (
+        isScalar(value) &&
+        !HIDDEN.test(key.split(".").at(-1) ?? key) &&
+        !scalarKeys.includes(key)
+      )
         scalarKeys.push(key);
     }
   }
@@ -80,8 +84,22 @@ function style(
     : value;
 }
 
-export function table(rows: Row[], options: RenderOptions = {}): string {
-  if (rows.length === 0) return "No results.";
+function flatten(row: Row): Row {
+  const flat: Row = {};
+  for (const [key, value] of Object.entries(row)) {
+    if (!isObject(value)) {
+      flat[key] = value;
+      continue;
+    }
+    for (const [inner, v] of Object.entries(value as Row))
+      flat[`${key}.${inner}`] = v;
+  }
+  return flat;
+}
+
+export function table(input: Row[], options: RenderOptions = {}): string {
+  if (input.length === 0) return "No results.";
+  const rows = input.map(flatten);
   const keys = columns(rows);
   if (keys.length === 0) return rows.map((row) => text(row)).join("\n");
   const cells = rows.map((row) => keys.map((key) => cell(row[key])));
@@ -124,6 +142,9 @@ function record(value: Row, options: RenderOptions): string {
       if (Array.isArray(v) && v.length > 0 && v.every(isScalar)) {
         return `${label(key)}  ${v.map(text).join(`\n${" ".repeat(width + 2)}`)}`;
       }
+      if (isObject(v) && Object.keys(v as Row).length > 0) {
+        return `${style("bold", key, options)}:\n${indent(record(v as Row, options))}`;
+      }
       return `${label(key)}  ${isScalar(v) ? text(v) : summary(v)}`;
     })
     .join("\n");

package/src/program.test.ts

@@ -96,4 +96,41 @@ describe("parseInvocation", () => {
     );
     expect(got.parsed.positionals).toEqual(["chat-wf"]);
   });
+
+  it("adds a per-command help note", async () => {
+    const help = await parseInvocation(["workflow", "get", "--help"], {
+      commands: COMMANDS,
+      helpNote: (command) =>
+        command.tool === "workflow_get" ? "Note for get." : undefined,
+    });
+
+    expect(help.kind === "exit" && help.stdout).toContain("Note for get.");
+  });
+
+  it("fills a defaulted first argument ahead of a required one", async () => {
+    const options = {
+      commands: COMMANDS,
+      defaultArg: (_: unknown, arg: { name: string }) =>
+        arg.name === "workflowId" ? "chat-wf" : undefined,
+    };
+
+    const short = command(
+      await parseInvocation(["schedule", "get", "s-1"], options),
+    );
+    expect(short.parsed.positionals).toEqual(["chat-wf", "s-1"]);
+
+    const full = command(
+      await parseInvocation(["schedule", "get", "wf-2", "s-1"], options),
+    );
+    expect(full.parsed.positionals).toEqual(["wf-2", "s-1"]);
+
+    const help = await parseInvocation(["schedule", "get", "--help"], options);
+    expect(help.kind === "exit" && help.stdout).toContain(
+      "[workflow-id] <schedule-id>",
+    );
+
+    await expect(parseInvocation(["schedule", "get"], options)).rejects.toThrow(
+      "expected [workflow-id] <schedule-id>, got 0 argument(s)",
+    );
+  });
 });

package/src/program.ts

@@ -16,6 +16,7 @@ export interface ProgramOptions {
   description?: string;
   defaultArg?: (command: CliCommand, arg: Option) => string | undefined;
   defaultArgNote?: string;
+  helpNote?: (command: CliCommand) => string | undefined;
 }
 
 const DOTTED = /^--([a-z0-9-]+\.[a-z0-9.-]+)(?:=(.*))?$/;
@@ -155,18 +156,26 @@ export function defineCommands(
     const defaults = command.args.map((arg) =>
       options.defaultArg?.(command, arg),
     );
-    command.args.forEach((arg, i) => {
+    const defaulted = defaults[0] !== undefined;
+    command.args.forEach((arg) => {
       leaf.argument(
-        defaults[i] === undefined ? `<${arg.flag}>` : `[${arg.flag}]`,
+        defaulted ? `[${arg.flag}]` : `<${arg.flag}>`,
         arg.description ?? "",
       );
     });
-    if (
-      defaults.some((value) => value !== undefined) &&
-      options.defaultArgNote
-    ) {
-      leaf.addHelpText("after", `\n${options.defaultArgNote}`);
+    if (defaulted) {
+      const names = command.args.map((arg, i) =>
+        i === 0 ? `[${arg.flag}]` : `<${arg.flag}>`,
+      );
+      leaf.usage(`[options] ${names.join(" ")}`);
     }
+    const notes = [
+      defaults.some((value) => value !== undefined)
+        ? options.defaultArgNote
+        : undefined,
+      options.helpNote?.(command),
+    ].filter(Boolean);
+    if (notes.length > 0) leaf.addHelpText("after", `\n${notes.join("\n")}`);
     leafOptions(leaf, command);
     leaf.action((...args: unknown[]) => {
       const cmd = args.at(-1) as Command;
@@ -178,7 +187,9 @@ export function defineCommands(
         positionals = [defaults[0], ...positionals];
       }
       if (positionals.length !== command.args.length) {
-        const expected = command.args.map((a) => `<${a.flag}>`).join(" ");
+        const expected = command.args
+          .map((a, i) => (i === 0 && defaulted ? `[${a.flag}]` : `<${a.flag}>`))
+          .join(" ");
         throw new UsageError(
           `expected ${expected}, got ${cmd.args.length} argument(s)`,
         );