@wafflebase/cli 0.6.3 → 0.6.4

package/README.md

@@ -53,7 +53,10 @@ wafflebase
 │   └── import <file>                      --replace <id> --yes for in-place
 │
 ├── sheets (aliases: sheet, spreadsheet, spreadsheets)
-│   ├── tabs (alias: tab) list <doc-id>
+│   ├── tabs (alias: tab)
+│   │   ├── list <doc-id>
+│   │   ├── create <doc-id> [name]        --type sheet
+│   │   └── rename <doc-id> <tab-id> <name>
 │   ├── cells (alias: cell)
 │   │   ├── get <doc-id> [<range>]
 │   │   ├── set <doc-id> <ref> <value>     --formula
@@ -71,7 +74,9 @@ wafflebase
 ```
 
 **Global flags**: `--server`, `--api-key`, `--workspace`, `--profile`,
-`--format json|table|csv` (default `json`), `--quiet`, `--verbose`,
+`--format json|table|csv|yaml` (default `json`), `--quiet` (suppresses
+progress notices only — the result body and the JSON error envelope are
+always emitted), `--verbose`,
 `--dry-run`. The `--format` flag also doubles as the per-content shape
 on `docs content` (`json|md|text`) and the export type override on
 `docs export` (`pdf|docx`).
@@ -84,6 +89,8 @@ wafflebase docs list
 wafflebase docs create "Q1 Notes" --type doc
 
 # Spreadsheets
+wafflebase sheets tabs create abc-123 "History"
+wafflebase sheets tabs rename abc-123 tab-1 "Summary"
 wafflebase sheets cells get abc-123 A1:D100
 echo '{"A1":"Name","B1":"Score"}' | wafflebase sheets cells batch abc-123
 wafflebase sheets export abc-123 out.csv

package/dist/bin.js

@@ -271,7 +271,7 @@ var HttpClient = class {
   // blob and creates the document in one call; see the controller comment in
   // `packages/backend/src/api/v1/files.controller.ts` for why it is not the
   // browser's two-step flow.
-  async uploadFileDocument(bytes, fileName, mimeType, title) {
+  async uploadFileDocument(bytes, fileName, mimeType, fields = {}) {
     const { res, sessionExpired } = await this.send(
       `${this.base}/files`,
       (auth) => {
@@ -282,7 +282,8 @@ var HttpClient = class {
           bytes.byteLength
         );
         form.append("file", new Blob([part], { type: mimeType }), fileName);
-        if (title) form.append("title", title);
+        if (fields.title) form.append("title", fields.title);
+        if (fields.folderId) form.append("folderId", fields.folderId);
         return { method: "POST", headers: auth, body: form };
       }
     );
@@ -370,6 +371,12 @@ var HttpClient = class {
   listTabs(docId) {
     return this.request("GET", `/documents/${docId}/tabs`);
   }
+  createTab(docId, body) {
+    return this.request("POST", `/documents/${docId}/tabs`, body);
+  }
+  renameTab(docId, tabId, name) {
+    return this.request("PATCH", `/documents/${docId}/tabs/${tabId}`, { name });
+  }
   // Cells
   getCells(docId, tabId, range) {
     const query = range ? `?range=${encodeURIComponent(range)}` : "";
@@ -419,7 +426,7 @@ var HttpClient = class {
 };
 
 // package.json
-var version = "0.6.3";
+var version = "0.6.4";
 
 // src/commands/root.ts
 function getGlobalOpts(cmd) {
@@ -438,9 +445,13 @@ function getClient(opts) {
   return new HttpClient(getConfig(opts));
 }
 function createProgram() {
-  const program2 = new Command();
-  program2.name("wafflebase").description("CLI for Wafflebase spreadsheet API").version(version).option("--server <url>", "Server URL").option("--api-key <key>", "API key").option("--workspace <id>", "Workspace ID").option("--profile <name>", "Config profile", "default").option("--format <fmt>", "Output format (json, table, csv)", "json").option("--quiet", "Suppress output", false).option("--verbose", "Verbose output", false).option("--dry-run", "Show request without executing", false);
-  return program2;
+  const program = new Command();
+  program.name("wafflebase").description("CLI for Wafflebase spreadsheet API").version(version).option("--server <url>", "Server URL").option("--api-key <key>", "API key").option("--workspace <id>", "Workspace ID").option("--profile <name>", "Config profile", "default").option("--format <fmt>", "Output format (json, table, csv, yaml)", "json").option(
+    "--quiet",
+    "Suppress progress notices (result body and errors still print)",
+    false
+  ).option("--verbose", "Verbose output", false).option("--dry-run", "Show request without executing", false);
+  return program;
 }
 
 // src/commands/docs.ts
@@ -487,6 +498,12 @@ function formatCsv(data) {
   return [header, ...lines].join("\n");
 }
 
+// src/output/yaml.ts
+import { stringify } from "yaml";
+function formatYaml(data) {
+  return stringify(data).replace(/\n$/, "");
+}
+
 // src/output/formatter.ts
 function format(data, fmt) {
   switch (fmt) {
@@ -496,10 +513,13 @@ function format(data, fmt) {
       return formatTable(data);
     case "csv":
       return formatCsv(data);
+    case "yaml":
+      return formatYaml(data);
+    default:
+      throw new Error(`Unsupported output format: ${String(fmt)}`);
   }
 }
-function output(data, fmt, quiet) {
-  if (quiet) return;
+function output(data, fmt) {
   console.log(format(data, fmt));
 }
 function errorCode(error) {
@@ -509,11 +529,7 @@ function errorCode(error) {
   }
   return "ERROR";
 }
-function outputError(error, quiet) {
-  if (quiet) {
-    process.exitCode = 1;
-    return;
-  }
+function outputError(error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(
     JSON.stringify({ error: { code: errorCode(error), message } }, null, 2)
@@ -43569,8 +43585,8 @@ function detectExportFormat(file, formatFlag) {
     `Cannot infer format from "${file}". Pass --format pdf|docx, or use a .pdf/.docx extension.`
   );
 }
-function registerDocsCommand(program2) {
-  const doc = program2.command("docs").alias("doc").alias("document").alias("documents").description("Manage documents");
+function registerDocsCommand(program) {
+  const doc = program.command("docs").alias("doc").alias("document").alias("documents").description("Manage documents");
   doc.command("list").description("List documents in workspace").option("--type <type>", "Filter by document type (doc|sheet)").action(async function() {
     const opts = getGlobalOpts(this);
     const { type: typeStr } = this.opts();
@@ -43584,9 +43600,9 @@ function registerDocsCommand(program2) {
           (d) => (d.type ?? "sheet") === filterType
         );
       }
-      output(data, opts.format, opts.quiet);
+      output(data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("create <title>").description("Create a new document").option("--type <type>", "Document type (doc|sheet)", "sheet").action(async function(title) {
@@ -43600,9 +43616,9 @@ function registerDocsCommand(program2) {
       }
       const res = await getClient(opts).createDocument(title, type);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("get <doc-id>").description("Show document metadata").action(async function(docId) {
@@ -43610,9 +43626,9 @@ function registerDocsCommand(program2) {
     try {
       const res = await getClient(opts).getDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("rename <doc-id> <title>").description("Rename a document").action(async function(docId, title) {
@@ -43624,9 +43640,9 @@ function registerDocsCommand(program2) {
     try {
       const res = await getClient(opts).updateDocument(docId, title);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("delete <doc-id>").description("Delete a document").action(async function(docId) {
@@ -43638,9 +43654,9 @@ function registerDocsCommand(program2) {
     try {
       const res = await getClient(opts).deleteDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("content <doc-id>").description("Read document content as JSON, Markdown, or plain text").option("--pages <range>", "Page range to include (e.g. 1-3,5)").option("--include-header-footer", "Include header/footer (md/text)", false).option("--inline-images", "Inline data: image URLs (md only)", false).option("--out <file>", "Output file (- for stdout)").option("--force", "Overwrite existing output file", false).action(async function(docId) {
@@ -43677,7 +43693,7 @@ function registerDocsCommand(program2) {
         quiet: opts.quiet
       });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   doc.command("export <doc-id> <file>").description("Export a document to PDF or DOCX").option("--pages <range>", "Page range to export (PDF only)").option("--include-header-footer", "Include header/footer regions", true).option("--force", "Overwrite existing output file", false).action(async function(docId, file) {
@@ -43746,7 +43762,7 @@ function registerDocsCommand(program2) {
       }
       writeBinary(bytes, file, { force: local.force, quiet: opts.quiet });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   registerDocsImportCommand(doc);
@@ -43774,7 +43790,7 @@ function registerDocsImportCommand(doc) {
       );
       if (result.exitCode !== 0) process.exitCode = result.exitCode;
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -43788,9 +43804,9 @@ function registerCellsCommand(parent) {
     try {
       const res = range?.includes(":") ? await getClient(opts).getCells(docId, tab, range) : range ? await getClient(opts).getCell(docId, tab, range) : await getClient(opts).getCells(docId, tab);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   cell.command("set <doc-id> <ref> <value>").description("Set a single cell value").option("--tab <tab-id>", "Tab ID", "tab-1").option("--formula", "Treat value as a formula").action(async function(docId, ref, value) {
@@ -43815,9 +43831,9 @@ function registerCellsCommand(parent) {
         formula ? value : void 0
       );
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   cell.command("delete <doc-id> <ref>").description("Delete a single cell").option("--tab <tab-id>", "Tab ID", "tab-1").action(async function(docId, ref) {
@@ -43834,43 +43850,43 @@ function registerCellsCommand(parent) {
     try {
       const res = await getClient(opts).deleteCell(docId, tab, ref);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   cell.command("batch <doc-id>").description("Batch update cells (JSON from stdin or --data)").option("--tab <tab-id>", "Tab ID", "tab-1").option("--data <json>", "Cell data as JSON string").action(async function(docId) {
     const opts = getGlobalOpts(this);
     const { tab, data: dataStr } = this.opts();
-    let cells;
-    if (dataStr) {
-      cells = JSON.parse(dataStr);
-    } else {
-      const chunks = [];
-      for await (const chunk of process.stdin) {
-        chunks.push(chunk);
-      }
-      cells = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
-    }
-    if (opts.dryRun) {
-      printDryRun(
-        getConfig(opts),
-        "PATCH",
-        `/documents/${docId}/tabs/${tab}/cells`,
-        { cells }
-      );
-      return;
-    }
     try {
+      let cells;
+      if (dataStr) {
+        cells = JSON.parse(dataStr);
+      } else {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+          chunks.push(chunk);
+        }
+        cells = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
+      }
+      if (opts.dryRun) {
+        printDryRun(
+          getConfig(opts),
+          "PATCH",
+          `/documents/${docId}/tabs/${tab}/cells`,
+          { cells }
+        );
+        return;
+      }
       const res = await getClient(opts).batchCells(
         docId,
         tab,
         cells
       );
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -43883,9 +43899,48 @@ function registerTabsCommand(parent) {
     try {
       const res = await getClient(opts).listTabs(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
+    } catch (e) {
+      outputError(e);
+    }
+  });
+  tab.command("create <doc-id> [name]").description("Create a new sheet tab (name optional -> next SheetN)").option("--type <type>", 'Tab type (only "sheet" is supported)', "sheet").action(async function(docId, name) {
+    const opts = getGlobalOpts(this);
+    const { type } = this.opts();
+    if (type !== "sheet") {
+      outputError(
+        new Error(`Unsupported tab type "${type}"; only "sheet" is supported.`)
+      );
+      return;
+    }
+    const body = { type };
+    if (name !== void 0) body.name = name;
+    if (opts.dryRun) {
+      printDryRun(getConfig(opts), "POST", `/documents/${docId}/tabs`, body);
+      return;
+    }
+    try {
+      const res = await getClient(opts).createTab(docId, body);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      output(res.data, opts.format);
+    } catch (e) {
+      outputError(e);
+    }
+  });
+  tab.command("rename <doc-id> <tab-id> <name>").description("Rename a tab").action(async function(docId, tabId, name) {
+    const opts = getGlobalOpts(this);
+    if (opts.dryRun) {
+      printDryRun(getConfig(opts), "PATCH", `/documents/${docId}/tabs/${tabId}`, {
+        name
+      });
+      return;
+    }
+    try {
+      const res = await getClient(opts).renameTab(docId, tabId, name);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -44031,9 +44086,9 @@ function registerSheetsImportCommand(parent) {
       const res = await getClient(opts).batchCells(docId, localOpts.tab, cells);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
       const result = typeof res.data === "object" && res.data !== null ? { imported: cellCount, ...res.data } : { imported: cellCount };
-      output(result, opts.format, opts.quiet);
+      output(result, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -44074,14 +44129,14 @@ function registerSheetsExportCommand(parent) {
         }
       }
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
 
 // src/commands/sheets.ts
-function registerSheetsCommand(program2) {
-  const sheets = program2.command("sheets").alias("sheet").alias("spreadsheet").alias("spreadsheets").description("Spreadsheet commands");
+function registerSheetsCommand(program) {
+  const sheets = program.command("sheets").alias("sheet").alias("spreadsheet").alias("spreadsheets").description("Spreadsheet commands");
   registerTabsCommand(sheets);
   registerCellsCommand(sheets);
   registerSheetsImportCommand(sheets);
@@ -99408,8 +99463,8 @@ async function exportPptxCli(deck, opts = {}) {
 }
 
 // src/commands/slides.ts
-function registerSlidesCommand(program2) {
-  const slides = program2.command("slides").alias("slide").alias("deck").description("Manage slide decks");
+function registerSlidesCommand(program) {
+  const slides = program.command("slides").alias("slide").alias("deck").description("Manage slide decks");
   slides.command("list").description("List slide decks in workspace").action(async function() {
     const opts = getGlobalOpts(this);
     try {
@@ -99421,9 +99476,9 @@ function registerSlidesCommand(program2) {
           (d) => d.type === "slides"
         );
       }
-      output(data, opts.format, opts.quiet);
+      output(data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("create <title>").description("Create a new slide deck").action(async function(title) {
@@ -99438,9 +99493,9 @@ function registerSlidesCommand(program2) {
       }
       const res = await getClient(opts).createDocument(title, "slides");
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("get <doc-id>").description("Show slide deck metadata").action(async function(docId) {
@@ -99448,9 +99503,9 @@ function registerSlidesCommand(program2) {
     try {
       const res = await getClient(opts).getDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("rename <doc-id> <title>").description("Rename a slide deck").action(async function(docId, title) {
@@ -99462,9 +99517,9 @@ function registerSlidesCommand(program2) {
     try {
       const res = await getClient(opts).updateDocument(docId, title);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("delete <doc-id>").description("Delete a slide deck").action(async function(docId) {
@@ -99476,9 +99531,9 @@ function registerSlidesCommand(program2) {
     try {
       const res = await getClient(opts).deleteDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("content <doc-id>").description("Read deck content as JSON, Markdown, or plain text").option("--notes", "Include speaker notes (md/text)", false).option("--out <file>", "Output file (- for stdout)").option("--force", "Overwrite existing output file", false).action(async function(docId) {
@@ -99509,7 +99564,7 @@ function registerSlidesCommand(program2) {
         quiet: opts.quiet
       });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   slides.command("export <doc-id> <file>").description("Export a slide deck to PPTX").option("--force", "Overwrite existing output file", false).action(async function(docId, file) {
@@ -99540,7 +99595,7 @@ function registerSlidesCommand(program2) {
       const bytes = await exportPptxCli(res.data, { imageFetcher });
       writeBinary(bytes, file, { force: local.force, quiet: opts.quiet });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   registerSlidesImportCommand(slides);
@@ -99565,7 +99620,7 @@ function registerSlidesImportCommand(slides) {
       );
       if (result.exitCode !== 0) process.exitCode = result.exitCode;
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -99762,8 +99817,8 @@ function runNotesContent(args, io2 = defaultNotesContentIO) {
 }
 
 // src/commands/notes.ts
-function registerNotesCommand(program2) {
-  const notes = program2.command("notes").alias("note").description("Manage markdown notes");
+function registerNotesCommand(program) {
+  const notes = program.command("notes").alias("note").description("Manage markdown notes");
   notes.command("list").description("List notes in workspace").action(async function() {
     const opts = getGlobalOpts(this);
     try {
@@ -99775,9 +99830,9 @@ function registerNotesCommand(program2) {
           (d) => d.type === "note"
         );
       }
-      output(data, opts.format, opts.quiet);
+      output(data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("create <title>").description("Create a new note").action(async function(title) {
@@ -99792,9 +99847,9 @@ function registerNotesCommand(program2) {
       }
       const res = await getClient(opts).createDocument(title, "note");
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("get <doc-id>").description("Show note metadata").action(async function(docId) {
@@ -99802,9 +99857,9 @@ function registerNotesCommand(program2) {
     try {
       const res = await getClient(opts).getDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("rename <doc-id> <title>").description("Rename a note").action(async function(docId, title) {
@@ -99816,9 +99871,9 @@ function registerNotesCommand(program2) {
     try {
       const res = await getClient(opts).updateDocument(docId, title);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("delete <doc-id>").description("Delete a note").action(async function(docId) {
@@ -99830,9 +99885,9 @@ function registerNotesCommand(program2) {
     try {
       const res = await getClient(opts).deleteDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("content <doc-id>").description("Read note content as JSON or Markdown").option("--out <file>", "Output file (- for stdout)").option("--force", "Overwrite existing output file", false).action(async function(docId) {
@@ -99862,7 +99917,7 @@ function registerNotesCommand(program2) {
         quiet: opts.quiet
       });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   notes.command("export <doc-id> <file>").description("Export a note to Markdown").option("--force", "Overwrite existing output file", false).action(async function(docId, file) {
@@ -99902,7 +99957,7 @@ function registerNotesCommand(program2) {
         quiet: opts.quiet
       });
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   registerNotesImportCommand(notes);
@@ -99925,7 +99980,7 @@ function registerNotesImportCommand(notes) {
       );
       if (result.exitCode !== 0) process.exitCode = result.exitCode;
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -99978,7 +100033,11 @@ var defaultFilesUploadIO = {
   sizeOf: (path) => statSync(path).size
 };
 async function runFilesUpload(args, client, io2 = defaultFilesUploadIO) {
-  const { file, title, quiet = false, dryRun = false } = args;
+  const { file, title, folder, quiet = false, dryRun = false } = args;
+  const fields = {
+    ...title ? { title } : {},
+    ...folder ? { folderId: folder } : {}
+  };
   if (file === "-") {
     io2.stderr(
       errorJson(
@@ -100015,7 +100074,10 @@ async function runFilesUpload(args, client, io2 = defaultFilesUploadIO) {
           path: "/files",
           body: {
             file: `<${size} bytes of ${fileName}>`,
-            title: title ?? basename4(fileName, extname9(fileName))
+            // The server defaults the title to the whole filename, extension
+            // included — a blob document *is* the file.
+            title: title ?? fileName,
+            ...folder ? { folderId: folder } : {}
           }
         },
         null,
@@ -100040,12 +100102,7 @@ async function runFilesUpload(args, client, io2 = defaultFilesUploadIO) {
     );
     return { exitCode: 1 };
   }
-  const res = await client.uploadFileDocument(
-    bytes,
-    fileName,
-    mimeType,
-    title
-  );
+  const res = await client.uploadFileDocument(bytes, fileName, mimeType, fields);
   if (!res.ok) {
     io2.stderr(
       JSON.stringify(res.data ?? { error: { code: "HTTP_ERROR" } }, null, 2)
@@ -100086,9 +100143,15 @@ async function runFilesDownload(args, client, io2 = defaultBinaryIO) {
 
 // src/commands/files.ts
 var BLOB_TYPES = /* @__PURE__ */ new Set(["file", "pdf", "image"]);
-function registerFilesCommand(program2) {
-  const files = program2.command("files").alias("file").description("Upload and download files stored as documents");
-  files.command("upload <file>").description("Upload any file as a document").option("--title <title>", "Document title (default: file basename)").action(async function(file) {
+function registerFilesCommand(program) {
+  const files = program.command("files").alias("file").description("Upload and download files stored as documents");
+  files.command("upload <file>").description("Upload any file as a document").option(
+    "--title <title>",
+    "Document title (default: the filename, extension included)"
+  ).option(
+    "--folder <id>",
+    "Folder to upload into (default: the workspace root)"
+  ).action(async function(file) {
     const opts = getGlobalOpts(this);
     const local = this.opts();
     try {
@@ -100096,6 +100159,7 @@ function registerFilesCommand(program2) {
         {
           file,
           title: local.title,
+          folder: local.folder,
           quiet: opts.quiet,
           dryRun: opts.dryRun
         },
@@ -100103,7 +100167,7 @@ function registerFilesCommand(program2) {
       );
       if (result.exitCode !== 0) process.exitCode = result.exitCode;
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   files.command("download <doc-id> [out]").description(
@@ -100122,7 +100186,7 @@ function registerFilesCommand(program2) {
       );
       if (result.exitCode !== 0) process.exitCode = result.exitCode;
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   files.command("list").description("List blob documents (file, pdf, image) in workspace").option("--type <type>", "Filter by a single type (file|pdf|image)").action(async function() {
@@ -100142,9 +100206,9 @@ function registerFilesCommand(program2) {
           (d) => local.type ? d.type === local.type : BLOB_TYPES.has(d.type ?? "")
         );
       }
-      output(data, opts.format, opts.quiet);
+      output(data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   files.command("get <doc-id>").description("Show file document metadata").action(async function(docId) {
@@ -100152,9 +100216,9 @@ function registerFilesCommand(program2) {
     try {
       const res = await getClient(opts).getDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   files.command("rename <doc-id> <title>").description("Rename a file document").action(async function(docId, title) {
@@ -100166,9 +100230,9 @@ function registerFilesCommand(program2) {
     try {
       const res = await getClient(opts).updateDocument(docId, title);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   files.command("delete <doc-id>").description("Delete a file document (and its stored bytes)").action(async function(docId) {
@@ -100180,24 +100244,24 @@ function registerFilesCommand(program2) {
     try {
       const res = await getClient(opts).deleteDocument(docId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
 
 // src/commands/api-keys.ts
-function registerApiKeysCommand(program2) {
-  const apiKey = program2.command("api-keys").alias("api-key").description("Manage API keys");
+function registerApiKeysCommand(program) {
+  const apiKey = program.command("api-keys").alias("api-key").description("Manage API keys");
   apiKey.command("create <name>").description("Create a new API key").action(async function(name) {
     const opts = getGlobalOpts(this);
     try {
       const res = await getClient(opts).createApiKey(name);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, false);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   apiKey.command("list").description("List API keys in workspace").action(async function() {
@@ -100205,9 +100269,9 @@ function registerApiKeysCommand(program2) {
     try {
       const res = await getClient(opts).listApiKeys();
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
   apiKey.command("revoke <key-id>").description("Revoke an API key").action(async function(keyId) {
@@ -100215,9 +100279,9 @@ function registerApiKeysCommand(program2) {
     try {
       const res = await getClient(opts).revokeApiKey(keyId);
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
-      output(res.data, opts.format, opts.quiet);
+      output(res.data, opts.format);
     } catch (e) {
-      outputError(e, opts.quiet);
+      outputError(e);
     }
   });
 }
@@ -100633,6 +100697,39 @@ var registry = [
     response: { type: "array", items: { id: "string", name: "string", type: "string" } },
     aliases: ["tab.list", "tabs.list", "sheet.tabs.list", "sheet.tab.list", "sheets.tab.list"]
   },
+  {
+    name: "sheets.tabs.create",
+    description: "Create a new sheet tab",
+    safety: "write",
+    parameters: {
+      "doc-id": { type: "string", required: true, description: "Document ID" },
+      name: {
+        type: "string",
+        required: false,
+        description: "Tab name (omit for the next SheetN)"
+      },
+      "--type": {
+        type: "string",
+        required: false,
+        description: 'Tab type; only "sheet" is supported',
+        default: "sheet"
+      }
+    },
+    response: { id: "string", name: "string", type: "string" },
+    aliases: ["tab.create", "tabs.create", "sheet.tabs.create", "sheet.tab.create", "sheets.tab.create"]
+  },
+  {
+    name: "sheets.tabs.rename",
+    description: "Rename a tab",
+    safety: "write",
+    parameters: {
+      "doc-id": { type: "string", required: true, description: "Document ID" },
+      "tab-id": { type: "string", required: true, description: "Tab ID" },
+      name: { type: "string", required: true, description: "New tab name" }
+    },
+    response: { id: "string", name: "string", type: "string" },
+    aliases: ["tab.rename", "tabs.rename", "sheet.tabs.rename", "sheet.tab.rename", "sheets.tab.rename"]
+  },
   {
     name: "sheets.cells.get",
     description: "Get cells from a spreadsheet tab",
@@ -100756,8 +100853,8 @@ function getAllCommandSchemas() {
 function toSchemaListPayload(commands, format2) {
   return format2 === "json" ? { commands } : commands;
 }
-function registerSchemaCommand(program2) {
-  program2.command("schema [command]").description("Describe command parameters and response shape").action(function(commandName) {
+function registerSchemaCommand(program) {
+  program.command("schema [command]").description("Describe command parameters and response shape").action(function(commandName) {
     const opts = getGlobalOpts(this);
     if (commandName) {
       const schema = getCommandSchema(commandName);
@@ -100772,18 +100869,14 @@ function registerSchemaCommand(program2) {
         process.exitCode = 1;
         return;
       }
-      output(schema, opts.format, opts.quiet);
+      output(schema, opts.format);
     } else {
       const commands = getAllCommandSchemas().map((c) => ({
         name: c.name,
         description: c.description,
         safety: c.safety
       }));
-      output(
-        toSchemaListPayload(commands, opts.format),
-        opts.format,
-        opts.quiet
-      );
+      output(toSchemaListPayload(commands, opts.format), opts.format);
     }
   });
 }
@@ -100791,8 +100884,8 @@ function registerSchemaCommand(program2) {
 // src/commands/login.ts
 import { createServer } from "http";
 import { createInterface as createInterface4 } from "readline";
-function registerLoginCommand(program2) {
-  program2.command("login").description("Log in via GitHub OAuth in the browser").action(async function() {
+function registerLoginCommand(program) {
+  program.command("login").description("Log in via GitHub OAuth in the browser").action(async function() {
     const parentOpts = this.optsWithGlobals();
     const server = (parentOpts.server ?? DEFAULT_SERVER).replace(/\/$/, "");
     const existing = loadSession();
@@ -100997,16 +101090,16 @@ function startCallbackServer() {
 }
 
 // src/commands/logout.ts
-function registerLogoutCommand(program2) {
-  program2.command("logout").description("Log out and clear session").action(() => {
+function registerLogoutCommand(program) {
+  program.command("logout").description("Log out and clear session").action(() => {
     clearSession();
     console.log("Logged out.");
   });
 }
 
 // src/commands/status.ts
-function registerStatusCommand(program2) {
-  program2.command("status").description("Show current auth state").action(() => {
+function registerStatusCommand(program) {
+  program.command("status").description("Show current auth state").action(() => {
     const session = loadSession();
     if (!session) {
       console.log("Not logged in. Run `wafflebase login`.");
@@ -101046,8 +101139,8 @@ function findWorkspace(workspaces, query) {
   if (byPrefix.length === 1) return byPrefix[0];
   return void 0;
 }
-function registerCtxCommand(program2) {
-  const ctx = program2.command("ctx").description("Workspace context switching");
+function registerCtxCommand(program) {
+  const ctx = program.command("ctx").description("Workspace context switching");
   ctx.command("list").description("List workspaces").action(() => {
     const session = loadSession();
     if (!session) {
@@ -101075,20 +101168,32 @@ function registerCtxCommand(program2) {
   });
 }
 
+// src/cli.ts
+function buildProgram() {
+  const program = createProgram();
+  registerLoginCommand(program);
+  registerLogoutCommand(program);
+  registerStatusCommand(program);
+  registerCtxCommand(program);
+  registerDocsCommand(program);
+  registerSheetsCommand(program);
+  registerSlidesCommand(program);
+  registerNotesCommand(program);
+  registerFilesCommand(program);
+  registerApiKeysCommand(program);
+  registerSchemaCommand(program);
+  return program;
+}
+async function runCli(program = buildProgram(), argv) {
+  try {
+    await program.parseAsync(argv);
+  } catch (e) {
+    outputError(e);
+  }
+}
+
 // src/bin.ts
-var program = createProgram();
-registerLoginCommand(program);
-registerLogoutCommand(program);
-registerStatusCommand(program);
-registerCtxCommand(program);
-registerDocsCommand(program);
-registerSheetsCommand(program);
-registerSlidesCommand(program);
-registerNotesCommand(program);
-registerFilesCommand(program);
-registerApiKeysCommand(program);
-registerSchemaCommand(program);
-program.parse();
+void runCli();
 /*!
 
 JSZip v3.10.1 - A JavaScript class for generating and reading zip files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wafflebase/cli",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "CLI for Wafflebase spreadsheet API",
   "license": "Apache-2.0",
   "type": "module",
@@ -31,8 +31,8 @@
     "tsx": "^4.19.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@wafflebase/docs": "0.6.3",
-    "@wafflebase/slides": "0.6.3"
+    "@wafflebase/docs": "0.6.4",
+    "@wafflebase/slides": "0.6.4"
   },
   "scripts": {
     "build": "tsup",