maybeai-sheet-cli 0.5.0__tar.gz → 0.7.0__tar.gz

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maybeai-sheet-cli
-Version: 0.5.0
+Version: 0.7.0
 Summary: CLI for common MaybeAI spreadsheet operations
 Project-URL: Homepage, https://github.com/OmniMCP-AI/maybeai-sheet-cli
 Project-URL: Repository, https://github.com/OmniMCP-AI/maybeai-sheet-cli
@@ -135,6 +135,13 @@ Import a large table-like `.xlsx` into SheetTable/PG:
 mbs workbook import ./large-table.xlsx --engine postgres
 ```
 
+Import a mixed workbook and let the backend select engines per worksheet:
+
+```bash
+mbs workbook import ./mixed-workbook.xlsx --engine auto
+mbs workbook import ./mixed-workbook.xlsx --engine "postgres,excel,excel,postgres"
+```
+
 Append rows and verify:
 
 ```bash
@@ -219,7 +226,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
-│   ├── list-table               API   List worksheets in a workbook.
+│   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
 │   ├── sample                   PLAN  Return bounded worksheet/range sample rows.
@@ -252,9 +259,9 @@ mbs
 |   |- lineage                   API   Trace cell/range lineage.
 │
 ├── db_worksheet(AKA db_table)
-│   ├── create                   PG    Create a PG-backed table.
-│   ├── update                   PG    Update PG-backed table metadata.
-│   ├── delete                   PG    Delete a PG-backed table; requires --yes unless --dry-run.
+│   ├── create                   PLAN  Create a PG-backed table from JSON row data.
+│   ├── update                   PLAN  Update PG-backed rows from JSON row data.
+│   ├── delete                   PLAN  Delete PG-backed rows/table; requires --yes unless --dry-run.
 │   ├── schema                   API   Infer table schema from a bounded PG read.
 │   ├── sample                   API   Return bounded table sample rows.
 │   ├── read                     API   Read PG-backed table rows.
@@ -344,6 +351,7 @@ mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet list-table --doc-id abc123 --gid 3  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range
@@ -363,8 +371,17 @@ mbs excel-table style columns-width --doc-id abc123 --worksheet-name Orders --ta
 mbs db-table metadata --doc-id abc123 --name orders-large  # API
 mbs db-table schema --doc-id abc123 --name orders-large  # API
 mbs db-table sample --doc-id abc123 --name orders-large --limit 50  # API
-mbs db-table read --doc-id abc123 --name orders-large --limit 50  # API
+mbs db-table read --doc-id abc123 --name orders-large --limit 100 --offset 200  # API
 mbs db-table insert --doc-id abc123 --name orders-large --rows rows.json  # API
+mbs db-table create --doc-id abc123 --name Orders --rows orders.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --key order_id --rows orders_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --row-index 42 --rows row_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --where '{"status":"open"}' --rows status_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --column-index 3 --column-name status  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --where '{"order_id":"A1"}' --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --row-index 42 --count 10 --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --column-index 3 --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --column-name status --yes  # PLAN
 
 # row
 mbs excel-worksheet row insert --doc-id abc123 --worksheet-name Actuals --row 10 --count 2  # API
@@ -404,6 +421,11 @@ mbs version restore --doc-id abc123 --version-id v42 --dry-run  # PLAN
 mbs share create --doc-id abc123 --email teammate@example.com --role viewer  # API
 ```
 
+`db-table read`, `schema`, and `sample` keep reads bounded. The default read
+limit is 100 rows, and `--limit` / `--offset` are capped at 10,000 to avoid
+accidental large PG scans. Use a keyset-style backend contract for deeper
+pagination when it becomes available.
+
 Refactor planning is tracked separately from this README:
 `docs/superpowers/plans/2026-07-01-mbs-two-engine-command-refactor.md`.
 

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/README.md

@@ -111,6 +111,13 @@ Import a large table-like `.xlsx` into SheetTable/PG:
 mbs workbook import ./large-table.xlsx --engine postgres
 ```
 
+Import a mixed workbook and let the backend select engines per worksheet:
+
+```bash
+mbs workbook import ./mixed-workbook.xlsx --engine auto
+mbs workbook import ./mixed-workbook.xlsx --engine "postgres,excel,excel,postgres"
+```
+
 Append rows and verify:
 
 ```bash
@@ -195,7 +202,7 @@ mbs
 │
 ├── excel_worksheet
 │   ├── read                     API   Read the full range of the worksheet.
-│   ├── list-table               API   List worksheets in a workbook.
+│   ├── list-table               API   Detect content-backed tables in a worksheet.
 │   ├── create                   API   Create a worksheet, optionally with starter values.
 │   ├── update                   API   Update worksheet metadata.
 │   ├── sample                   PLAN  Return bounded worksheet/range sample rows.
@@ -228,9 +235,9 @@ mbs
 |   |- lineage                   API   Trace cell/range lineage.
 │
 ├── db_worksheet(AKA db_table)
-│   ├── create                   PG    Create a PG-backed table.
-│   ├── update                   PG    Update PG-backed table metadata.
-│   ├── delete                   PG    Delete a PG-backed table; requires --yes unless --dry-run.
+│   ├── create                   PLAN  Create a PG-backed table from JSON row data.
+│   ├── update                   PLAN  Update PG-backed rows from JSON row data.
+│   ├── delete                   PLAN  Delete PG-backed rows/table; requires --yes unless --dry-run.
 │   ├── schema                   API   Infer table schema from a bounded PG read.
 │   ├── sample                   API   Return bounded table sample rows.
 │   ├── read                     API   Read PG-backed table rows.
@@ -320,6 +327,7 @@ mbs excel-worksheet read --doc-id abc123 --worksheet-name Actuals --range A1:D20
 mbs excel-worksheet create --doc-id abc123 --name Actuals  # API
 mbs excel-worksheet update --doc-id abc123 --worksheet-name Actuals --title "Actuals FY26"  # API
 mbs excel-worksheet metadata --doc-id abc123 --worksheet-name Actuals  # API
+mbs excel-worksheet list-table --doc-id abc123 --gid 3  # API
 mbs excel-worksheet sample --doc-id abc123 --worksheet-name Actuals --range A1:Z5000 --limit 50  # PLAN
 
 # excel-worksheet range
@@ -339,8 +347,17 @@ mbs excel-table style columns-width --doc-id abc123 --worksheet-name Orders --ta
 mbs db-table metadata --doc-id abc123 --name orders-large  # API
 mbs db-table schema --doc-id abc123 --name orders-large  # API
 mbs db-table sample --doc-id abc123 --name orders-large --limit 50  # API
-mbs db-table read --doc-id abc123 --name orders-large --limit 50  # API
+mbs db-table read --doc-id abc123 --name orders-large --limit 100 --offset 200  # API
 mbs db-table insert --doc-id abc123 --name orders-large --rows rows.json  # API
+mbs db-table create --doc-id abc123 --name Orders --rows orders.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --key order_id --rows orders_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --row-index 42 --rows row_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --where '{"status":"open"}' --rows status_patch.json  # PLAN
+mbs db-table update --doc-id abc123 --name Orders --column-index 3 --column-name status  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --where '{"order_id":"A1"}' --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --row-index 42 --count 10 --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --column-index 3 --yes  # PLAN
+mbs db-table delete --doc-id abc123 --name Orders --column-name status --yes  # PLAN
 
 # row
 mbs excel-worksheet row insert --doc-id abc123 --worksheet-name Actuals --row 10 --count 2  # API
@@ -380,6 +397,11 @@ mbs version restore --doc-id abc123 --version-id v42 --dry-run  # PLAN
 mbs share create --doc-id abc123 --email teammate@example.com --role viewer  # API
 ```
 
+`db-table read`, `schema`, and `sample` keep reads bounded. The default read
+limit is 100 rows, and `--limit` / `--offset` are capped at 10,000 to avoid
+accidental large PG scans. Use a keyset-style backend contract for deeper
+pagination when it becomes available.
+
 Refactor planning is tracked separately from this README:
 `docs/superpowers/plans/2026-07-01-mbs-two-engine-command-refactor.md`.
 

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "maybeai-sheet-cli"
-version = "0.5.0"
+version = "0.7.0"
 description = "CLI for common MaybeAI spreadsheet operations"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -39,3 +39,11 @@ mbs = "maybeai_sheet.cli:app"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/maybeai_sheet"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/tests",
+  "/README.md",
+  "/pyproject.toml",
+]

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.5.0"
+__version__ = "0.7.0"

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/cli.py

@@ -52,6 +52,7 @@ def main(
     base_url: str = typer.Option(
         "https://play-be.omnimcp.ai",
         "--base-url",
+        envvar="MAYBEAI_BASE_URL",
         help="MaybeAI API base URL.",
     ),
     doc_id: Optional[str] = typer.Option(

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/commands/db_table.py

@@ -22,6 +22,8 @@ from ..table_resolver import (
 from ._phase2 import bounded_limit
 
 app = typer.Typer(help="PG/SheetTable-backed table operations.", no_args_is_help=True)
+DB_TABLE_SAFE_MAX_LIMIT = 10_000
+DB_TABLE_SAFE_MAX_OFFSET = 10_000
 
 
 def _state(
@@ -79,13 +81,27 @@ def _read_payload(
     resolved: ResolvedTableTarget,
     *,
     limit: int,
+    offset: int = 0,
 ) -> dict[str, Any]:
-    return {
+    payload: dict[str, Any] = {
         "uri": target.uri,
         "worksheet_name": resolved.worksheet_name,
-        "range_address": bounded_a1_range(resolved.range_address, limit),
         "value_render_option": "FORMATTED_VALUE",
+        "limit": limit,
     }
+    if offset:
+        payload["offset"] = offset
+    if resolved.range_address:
+        payload["range_address"] = bounded_a1_range(resolved.range_address, limit)
+    return payload
+
+
+def _bounded_offset(value: int) -> int:
+    if value < 0:
+        raise UsageError("--offset must be at least 0.")
+    if value > DB_TABLE_SAFE_MAX_OFFSET:
+        raise UsageError(f"--offset must be {DB_TABLE_SAFE_MAX_OFFSET} or less.")
+    return value
 
 
 def _load_rows(rows: Path) -> list[dict[str, Any]]:
@@ -168,6 +184,7 @@ def schema(
             verbose=verbose,
             timeout=timeout,
         )
+        bounded = bounded_limit(limit, option="--limit", maximum=DB_TABLE_SAFE_MAX_LIMIT)
         workbook_target = resolve_target(state)
         client = MaybeAIClient(state)
         resolved, target = _resolve_db_table(
@@ -179,7 +196,11 @@ def schema(
         endpoint = "/api/v1/excel/read_sheet"
         response = client.post_json(
             endpoint,
-            _read_payload(target, resolved, limit=bounded_limit(limit, option="--limit")),
+            _read_payload(
+                target,
+                resolved,
+                limit=bounded,
+            ),
         )
         result = {
             **schema_from_read_payload(response),
@@ -224,6 +245,7 @@ def sample(
             verbose=verbose,
             timeout=timeout,
         )
+        bounded = bounded_limit(limit, option="--limit", maximum=DB_TABLE_SAFE_MAX_LIMIT)
         workbook_target = resolve_target(state)
         client = MaybeAIClient(state)
         resolved, target = _resolve_db_table(
@@ -232,7 +254,6 @@ def sample(
             name=name,
             backend_id=backend_id,
         )
-        bounded = bounded_limit(limit, option="--limit")
         endpoint = "/api/v1/excel/read_sheet"
         response = client.post_json(endpoint, _read_payload(target, resolved, limit=bounded))
         result = {
@@ -264,6 +285,7 @@ def read(
     name: Optional[str] = typer.Option(None, "--name", help="PG-backed table name."),
     backend_id: Optional[str] = typer.Option(None, "--backend-id", help="Advanced backend table id."),
     limit: int = typer.Option(100, "--limit", min=1, help="Maximum rows to return."),
+    offset: int = typer.Option(0, "--offset", min=0, help="Rows to skip before reading."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
     timeout: Optional[float] = timeout_option(),
@@ -278,6 +300,8 @@ def read(
             verbose=verbose,
             timeout=timeout,
         )
+        bounded = bounded_limit(limit, option="--limit", maximum=DB_TABLE_SAFE_MAX_LIMIT)
+        bounded_offset = _bounded_offset(offset)
         workbook_target = resolve_target(state)
         client = MaybeAIClient(state)
         resolved, target = _resolve_db_table(
@@ -289,7 +313,12 @@ def read(
         endpoint = "/api/v1/excel/read_sheet"
         response = client.post_json(
             endpoint,
-            _read_payload(target, resolved, limit=bounded_limit(limit, option="--limit")),
+            _read_payload(
+                target,
+                resolved,
+                limit=bounded,
+                offset=bounded_offset,
+            ),
         )
         render_output(
             build_command_output(
@@ -304,6 +333,128 @@ def read(
         handle_cli_error(error)
 
 
+DB_TABLE_CREATE_EXAMPLE = """Example:
+
+  mbs db-table create --doc-id <doc_id> --name Orders --rows orders.json
+
+`orders.json` should contain a JSON array of row objects, similar to workbook
+import data:
+
+  [
+    {"order_id": "A1", "amount": 120.5},
+    {"order_id": "A2", "amount": 88.0}
+  ]
+"""
+
+
+DB_TABLE_UPDATE_EXAMPLE = """Example:
+
+  mbs db-table update --doc-id <doc_id> --name Orders --key order_id --rows orders_patch.json
+  mbs db-table update --doc-id <doc_id> --name Orders --row-index 42 --rows row_patch.json
+  mbs db-table update --doc-id <doc_id> --name Orders --where '{"status":"open"}' --rows status_patch.json
+  mbs db-table update --doc-id <doc_id> --name Orders --column-index 3 --column-name status
+
+`orders_patch.json` should contain row objects keyed by --key. Positional
+updates use 1-based --row-index and --column-index when the backend exposes a
+stable SheetTable index contract.
+"""
+
+
+DB_TABLE_DELETE_EXAMPLE = """Example:
+
+  mbs db-table delete --doc-id <doc_id> --name Orders --where '{"order_id":"A1"}' --yes
+  mbs db-table delete --doc-id <doc_id> --name Orders --row-index 42 --yes
+  mbs db-table delete --doc-id <doc_id> --name Orders --row-index 42 --count 10 --yes
+  mbs db-table delete --doc-id <doc_id> --name Orders --column-index 3 --yes
+  mbs db-table delete --doc-id <doc_id> --name Orders --column-name status --yes
+
+Use --dry-run first once the backend route is available.
+"""
+
+
+def _planned_db_table_error(command: str, example: str) -> None:
+    raise UsageError(
+        f"db-table {command} is planned but the backend route is not implemented yet.\n\n"
+        f"{example.strip()}"
+    )
+
+
+@app.command(
+    "create",
+    help="Planned: create a PG/SheetTable-backed table from JSON row data.",
+    epilog=DB_TABLE_CREATE_EXAMPLE,
+)
+def create(
+    doc_id: Optional[str] = typer.Option(None, "--doc-id", help="MaybeAI document ID."),
+    name: Optional[str] = typer.Option(None, "--name", help="New PG-backed table name."),
+    rows: Optional[Path] = typer.Option(
+        None,
+        "--rows",
+        exists=True,
+        readable=True,
+        resolve_path=True,
+        help="Path to JSON rows payload.",
+    ),
+) -> None:
+    _ = (doc_id, name, rows)
+    try:
+        _planned_db_table_error("create", DB_TABLE_CREATE_EXAMPLE)
+    except Exception as error:  # pragma: no cover - CLI boundary
+        handle_cli_error(error)
+
+
+@app.command(
+    "update",
+    help="Planned: update PG/SheetTable-backed rows from JSON row data.",
+    epilog=DB_TABLE_UPDATE_EXAMPLE,
+)
+def update(
+    doc_id: Optional[str] = typer.Option(None, "--doc-id", help="MaybeAI document ID."),
+    name: Optional[str] = typer.Option(None, "--name", help="PG-backed table name."),
+    key: Optional[str] = typer.Option(None, "--key", help="Unique key column for matching rows."),
+    row_index: Optional[int] = typer.Option(None, "--row-index", min=1, help="1-based SheetTable row index to update."),
+    column_index: Optional[int] = typer.Option(None, "--column-index", min=1, help="1-based SheetTable column index to update."),
+    column_name: Optional[str] = typer.Option(None, "--column-name", help="Column name to update."),
+    where: Optional[str] = typer.Option(None, "--where", help="JSON object filter for rows to update."),
+    rows: Optional[Path] = typer.Option(
+        None,
+        "--rows",
+        exists=True,
+        readable=True,
+        resolve_path=True,
+        help="Path to JSON rows payload.",
+    ),
+) -> None:
+    _ = (doc_id, name, key, row_index, column_index, column_name, where, rows)
+    try:
+        _planned_db_table_error("update", DB_TABLE_UPDATE_EXAMPLE)
+    except Exception as error:  # pragma: no cover - CLI boundary
+        handle_cli_error(error)
+
+
+@app.command(
+    "delete",
+    help="Planned: delete PG/SheetTable-backed rows or a table.",
+    epilog=DB_TABLE_DELETE_EXAMPLE,
+)
+def delete(
+    doc_id: Optional[str] = typer.Option(None, "--doc-id", help="MaybeAI document ID."),
+    name: Optional[str] = typer.Option(None, "--name", help="PG-backed table name."),
+    where: Optional[str] = typer.Option(None, "--where", help="JSON object filter for rows to delete."),
+    row_index: Optional[int] = typer.Option(None, "--row-index", min=1, help="1-based SheetTable row index to delete."),
+    column_index: Optional[int] = typer.Option(None, "--column-index", min=1, help="1-based SheetTable column index to delete."),
+    column_name: Optional[str] = typer.Option(None, "--column-name", help="Column name to delete."),
+    count: int = typer.Option(1, "--count", min=1, help="Number of rows to delete from --row-index."),
+    yes: bool = typer.Option(False, "--yes", help="Confirm destructive delete."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Preview delete when backend support exists."),
+) -> None:
+    _ = (doc_id, name, where, row_index, column_index, column_name, count, yes, dry_run)
+    try:
+        _planned_db_table_error("delete", DB_TABLE_DELETE_EXAMPLE)
+    except Exception as error:  # pragma: no cover - CLI boundary
+        handle_cli_error(error)
+
+
 @app.command("insert")
 def insert(
     ctx: typer.Context,

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/commands/excel_worksheet.py

@@ -288,6 +288,7 @@ def list_table(
     doc_id: Optional[str] = typer.Option(None, "--doc-id", help="MaybeAI document ID."),
     url: Optional[str] = typer.Option(None, "--url", help="MaybeAI workbook URL."),
     uri: Optional[str] = typer.Option(None, "--uri", help="Resolved workbook URI."),
+    gid: Optional[int] = typer.Option(None, "--gid", help="Worksheet gid."),
     worksheet_name: Optional[str] = typer.Option(None, "--worksheet-name", help="Optional worksheet name filter."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -299,12 +300,16 @@ def list_table(
             doc_id=doc_id,
             url=url,
             uri=uri,
+            gid=gid,
             worksheet_name=worksheet_name,
             output=output,
             verbose=verbose,
             timeout=timeout,
         )
-        target = resolve_target(state)
+        target = resolve_target(
+            state,
+            force_gid_uri=bool(state.gid is not None and not state.worksheet_name),
+        )
         if target.worksheet_name or target.gid is not None:
             endpoint = "/api/v1/excel/table/metadata"
             payload: dict[str, object] = {

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/commands/workbook.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import Optional
+from typing import Any, Optional
 
 import typer
 
@@ -18,15 +18,63 @@ from ._phase2 import bounded_limit
 app = typer.Typer(help="Workbook-level operations.", no_args_is_help=True)
 
 
+_WORKSHEET_NAME_ALIASES = ("title", "name", "sheet_name")
+
+
+def _simplify_list_worksheets_response(response: dict[str, Any]) -> dict[str, Any]:
+    simplified = dict(response)
+    worksheets = simplified.get("worksheets")
+    if not isinstance(worksheets, list):
+        return simplified
+    simplified["worksheets"] = [
+        _simplify_worksheet_item(item) if isinstance(item, dict) else item
+        for item in worksheets
+    ]
+    return simplified
+
+
+def _simplify_worksheet_item(item: dict[str, Any]) -> dict[str, Any]:
+    simplified = dict(item)
+    canonical = simplified.get("worksheet_name")
+    if not canonical:
+        for alias in _WORKSHEET_NAME_ALIASES:
+            value = simplified.get(alias)
+            if value:
+                canonical = value
+                simplified["worksheet_name"] = value
+                break
+    for alias in _WORKSHEET_NAME_ALIASES:
+        if simplified.get(alias) == canonical:
+            simplified.pop(alias, None)
+    return simplified
+
+
 def _normalize_create_from_file_engine(engine: str | None) -> str | None:
     if engine is None:
         return None
     normalized = engine.strip().lower()
-    if normalized in {"", "excelize"}:
+    if normalized == "":
         return None
-    if normalized in {"pg", "postgres", "postgresql"}:
+    if "," in normalized:
+        return ",".join(_normalize_engine_token(part) for part in normalized.split(","))
+    token = _normalize_engine_token(normalized)
+    if token == "excelize":
+        return None
+    return token
+
+
+def _normalize_engine_token(value: str) -> str:
+    normalized = value.strip().lower()
+    if normalized in {"auto"}:
+        return "auto"
+    if normalized in {"excel", "excelize", "xlsx"}:
+        return "excelize"
+    if normalized in {"pg", "postgres", "postgresql", "sheettable", "sheet_table"}:
         return "postgres"
-    raise UsageError("Unsupported engine. Use 'excelize', 'postgres', or 'pg'.")
+    raise UsageError(
+        "Unsupported engine. Use 'auto', 'excelize', 'postgres', 'pg', "
+        "or a comma-separated per-worksheet list such as 'postgres,excel,excel'."
+    )
 
 
 @app.callback()
@@ -130,7 +178,7 @@ def create_from_file(
     engine: Optional[str] = typer.Option(
         None,
         "--engine",
-        help="Creation engine: excelize (default) or postgres/pg for SheetTable.",
+        help="Creation engine: excelize (default), postgres/pg, auto, or comma-separated per-worksheet engines.",
     ),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -187,7 +235,7 @@ def import_workbook(
     engine: Optional[str] = typer.Option(
         None,
         "--engine",
-        help="Creation engine: excelize (default) or postgres/pg for SheetTable.",
+        help="Creation engine: excelize (default), postgres/pg, auto, or comma-separated per-worksheet engines.",
     ),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -399,11 +447,12 @@ def list_worksheets(
         target = resolve_target(state)
         endpoint = "/api/v1/excel/list_worksheets"
         response = MaybeAIClient(state).post_json(endpoint, {"uri": target.uri})
+        result = _simplify_list_worksheets_response(response) if isinstance(response, dict) else response
         render_output(
             build_command_output(
                 endpoint=endpoint,
                 target=target,
-                result=response,
+                result=result,
                 metadata=get_endpoint_metadata("workbook.list-worksheets") if state.verbose else None,
             ),
             state.output,

{maybeai_sheet_cli-0.5.0 → maybeai_sheet_cli-0.7.0}/src/maybeai_sheet/endpoints.py

@@ -65,6 +65,9 @@ COMMAND_ENDPOINTS: dict[str, EndpointMetadata] = {
     "db-table.sample": _meta("db-table.sample", "API", "POST", "/api/v1/excel/read_sheet", notes="CLI-composed sample from bounded PG read."),
     "db-table.read": _meta("db-table.read", "API", "POST", "/api/v1/excel/read_sheet", large_output=True, default_limit=100),
     "db-table.insert": _meta("db-table.insert", "API", "POST", "/api/v1/excel/append_rows", verify_supported=True),
+    "db-table.create": _meta("db-table.create", "PLAN", None, None, notes="Planned native db-table create route; CLI help documents the target rows-file shape."),
+    "db-table.update": _meta("db-table.update", "PLAN", None, None, notes="Planned native db-table update route; CLI help documents keyed JSON row patches."),
+    "db-table.delete": _meta("db-table.delete", "PLAN", None, None, destructive=True, confirmation_required=True, notes="Planned native db-table delete route."),
     "worksheet.list": _meta("worksheet.list", "NOW", "POST", "/api/v1/excel/list_worksheets"),
     "worksheet.create": _meta("worksheet.create", "NOW", "POST", "/api/v1/excel/write_new_worksheet"),
     "range.read": _meta("range.read", "NOW", "POST", "/api/v1/excel/read_sheet"),