maybeai-sheet-cli 0.26__tar.gz → 0.26.2__tar.gz

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: maybeai-sheet-cli
-Version: 0.26
+Version: 0.26.2
 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
@@ -103,8 +103,14 @@ List user-visible workbooks:
 
 ```bash
 mbs workbook list-user-workbooks --limit 20
+mbs workbook list-user-workbooks --order-by filename:asc --limit 20
+mbs workbook delete --doc-id abc123 --yes
 ```
 
+The default ordering is `updated_at DESC`. Use `--order-by FIELD[:DIRECTION]`
+with `created_at`, `updated_at`, `filename`, `file_size`, or `version`; the
+direction can be `asc` or `desc` and defaults to `asc` for an explicit field.
+
 Read a worksheet:
 
 ```bash
@@ -476,7 +482,8 @@ worksheet metadata, then routes by engine: Sheet worksheets get a frozen
 header row, persisted auto-filter, header styling, and semantic column styles
 for date, currency, percent, integer, status, and text columns; Base
 worksheets get equivalent field formatter/style metadata updates through the
-batched `/db_table/field/batch_update` route. The semantic classifier uses
+batched field-style route. Explicit Base column-width updates use the native
+`/table/field/update` route and persist as `field.property.style.width`. The semantic classifier uses
 weighted Chinese/English header keywords, common business
 abbreviations such as AOV/GMV/ARR/MRR, Base field display metadata, and Excel
 sample values. Use `--table-id` to beautify one Excel table within a multi-table
@@ -486,18 +493,12 @@ inventory, fulfillment status, 毛利率, 广告花费, 退款率, and 履约状
 `--dry-run --output json` to inspect each column's category, format, confidence,
 and reasons before applying styles.
 
-For explicit Base/db-table field updates, use one JSON array with
-`mbs db-table field batch-update` instead of many single-field calls:
-
-```json
-[
-  {"name": "revenue", "logical_type": "number", "property": {"formatter": "$#,##0.00"}},
-  {"name": "margin_rate", "logical_type": "number", "property": {"formatter": "0.00%"}}
-]
-```
+For explicit Base field updates, resolve fields with `base-table field list`,
+then use native `base-table field update`:
 
 ```bash
-mbs db-table field batch-update --doc-id abc123 --name orders_large --updates field-updates.json --verify
+mbs base-table field list --doc-id abc123 --table-id tbl_orders
+mbs base-table field update --doc-id abc123 --table-id tbl_orders --field-id fld_revenue --formatter '$#,##0.00' --width 144 --verify
 ```
 
 For chart specs authored as `type: "json"`, keep metadata `title` when the chart
@@ -538,6 +539,7 @@ mbs
 │   ├── list-user-workbooks    List the caller's workbooks with a bounded result
 │   ├── list-worksheets        List worksheets and their engines in one workbook
 │   ├── search                 Search the caller's workbooks by query
+│   ├── delete                 Soft-delete a workbook with explicit confirmation
 │   └── metadata               Inspect workbook routing and worksheet metadata
 │
 ├── worksheet
@@ -703,6 +705,7 @@ mbs workbook copy --doc-id abc123 --title "Budget Copy"
 mbs workbook export --doc-id abc123 --out workbook.xlsx
 mbs workbook calculate --doc-id abc123
 mbs workbook list-user-workbooks --limit 20
+mbs workbook list-user-workbooks --order-by updated_at:desc --limit 20
 mbs workbook list-worksheets --doc-id abc123
 mbs workbook search --query "Budget" --limit 20
 mbs workbook metadata --doc-id abc123
@@ -756,7 +759,7 @@ mbs base-table record create --doc-id abc123 --table-id tbl_orders --records rec
 mbs base-table record replace --doc-id abc123 --table-id tbl_orders --records records.json --expected-revision 7
 mbs base-table record upsert --doc-id abc123 --table-id tbl_orders --key-field-id fld_sku --records records.json
 mbs base-table field list --doc-id abc123 --table-id tbl_orders
-mbs base-table field metadata --doc-id abc123 --name ActualsTable
+mbs base-table field list --doc-id abc123 --table-id tbl_orders
 mbs base-table field update --doc-id abc123 --table-id tbl_orders --field-id fld_amount --formatter "#,##0.00" --expected-revision 7 --verify
 mbs base-table field update --doc-id abc123 --name Orders --field amount --formatter "#,##0.00" --verify  # resolves native table and field IDs
 mbs base-table formula compile --doc-id abc123 --table-id tbl_orders --field-id fld_total --expression '{fld_qty} * {fld_price}'
@@ -765,7 +768,7 @@ mbs base-table formula recalculate --doc-id abc123 --table-id tbl_orders --works
 
 # db-table
 mbs db-table read --doc-id abc123 --name orders-large --limit 100 --offset 200
-mbs db-table field batch-update --doc-id abc123 --name ActualsTable --updates field-updates.json
+mbs db-table field batch-update --doc-id abc123 --name ActualsTable --updates field-updates.json  # compatibility only
 
 # excel-worksheet row
 mbs excel-worksheet row insert --doc-id abc123 --worksheet-name Actuals --row 10 --count 2
@@ -930,8 +933,8 @@ Relationship guide:
   worksheet style planning/apply. `mbs worksheet style ...` and `mbs style ...`
   expose the same style commands. For Base worksheets, `style format`,
   `style columns-width`, and `style cell batch-set` automatically update field
-  metadata (`formatter`, text color, background color, and width) instead of
-  requiring agents to choose Base-specific commands.
+  metadata (`formatter`, text color, background color, and width) through the
+  native field API. Base width is stored at `field.property.style.width`.
 - Use `excel-worksheet chart` for list/get/create/update/delete of individual
   source-backed visualizations.
 - Use `excel-worksheet dashboard` for local validation and worksheet-level chart

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/README.md

@@ -79,8 +79,14 @@ List user-visible workbooks:
 
 ```bash
 mbs workbook list-user-workbooks --limit 20
+mbs workbook list-user-workbooks --order-by filename:asc --limit 20
+mbs workbook delete --doc-id abc123 --yes
 ```
 
+The default ordering is `updated_at DESC`. Use `--order-by FIELD[:DIRECTION]`
+with `created_at`, `updated_at`, `filename`, `file_size`, or `version`; the
+direction can be `asc` or `desc` and defaults to `asc` for an explicit field.
+
 Read a worksheet:
 
 ```bash
@@ -452,7 +458,8 @@ worksheet metadata, then routes by engine: Sheet worksheets get a frozen
 header row, persisted auto-filter, header styling, and semantic column styles
 for date, currency, percent, integer, status, and text columns; Base
 worksheets get equivalent field formatter/style metadata updates through the
-batched `/db_table/field/batch_update` route. The semantic classifier uses
+batched field-style route. Explicit Base column-width updates use the native
+`/table/field/update` route and persist as `field.property.style.width`. The semantic classifier uses
 weighted Chinese/English header keywords, common business
 abbreviations such as AOV/GMV/ARR/MRR, Base field display metadata, and Excel
 sample values. Use `--table-id` to beautify one Excel table within a multi-table
@@ -462,18 +469,12 @@ inventory, fulfillment status, 毛利率, 广告花费, 退款率, and 履约状
 `--dry-run --output json` to inspect each column's category, format, confidence,
 and reasons before applying styles.
 
-For explicit Base/db-table field updates, use one JSON array with
-`mbs db-table field batch-update` instead of many single-field calls:
-
-```json
-[
-  {"name": "revenue", "logical_type": "number", "property": {"formatter": "$#,##0.00"}},
-  {"name": "margin_rate", "logical_type": "number", "property": {"formatter": "0.00%"}}
-]
-```
+For explicit Base field updates, resolve fields with `base-table field list`,
+then use native `base-table field update`:
 
 ```bash
-mbs db-table field batch-update --doc-id abc123 --name orders_large --updates field-updates.json --verify
+mbs base-table field list --doc-id abc123 --table-id tbl_orders
+mbs base-table field update --doc-id abc123 --table-id tbl_orders --field-id fld_revenue --formatter '$#,##0.00' --width 144 --verify
 ```
 
 For chart specs authored as `type: "json"`, keep metadata `title` when the chart
@@ -514,6 +515,7 @@ mbs
 │   ├── list-user-workbooks    List the caller's workbooks with a bounded result
 │   ├── list-worksheets        List worksheets and their engines in one workbook
 │   ├── search                 Search the caller's workbooks by query
+│   ├── delete                 Soft-delete a workbook with explicit confirmation
 │   └── metadata               Inspect workbook routing and worksheet metadata
 │
 ├── worksheet
@@ -679,6 +681,7 @@ mbs workbook copy --doc-id abc123 --title "Budget Copy"
 mbs workbook export --doc-id abc123 --out workbook.xlsx
 mbs workbook calculate --doc-id abc123
 mbs workbook list-user-workbooks --limit 20
+mbs workbook list-user-workbooks --order-by updated_at:desc --limit 20
 mbs workbook list-worksheets --doc-id abc123
 mbs workbook search --query "Budget" --limit 20
 mbs workbook metadata --doc-id abc123
@@ -732,7 +735,7 @@ mbs base-table record create --doc-id abc123 --table-id tbl_orders --records rec
 mbs base-table record replace --doc-id abc123 --table-id tbl_orders --records records.json --expected-revision 7
 mbs base-table record upsert --doc-id abc123 --table-id tbl_orders --key-field-id fld_sku --records records.json
 mbs base-table field list --doc-id abc123 --table-id tbl_orders
-mbs base-table field metadata --doc-id abc123 --name ActualsTable
+mbs base-table field list --doc-id abc123 --table-id tbl_orders
 mbs base-table field update --doc-id abc123 --table-id tbl_orders --field-id fld_amount --formatter "#,##0.00" --expected-revision 7 --verify
 mbs base-table field update --doc-id abc123 --name Orders --field amount --formatter "#,##0.00" --verify  # resolves native table and field IDs
 mbs base-table formula compile --doc-id abc123 --table-id tbl_orders --field-id fld_total --expression '{fld_qty} * {fld_price}'
@@ -741,7 +744,7 @@ mbs base-table formula recalculate --doc-id abc123 --table-id tbl_orders --works
 
 # db-table
 mbs db-table read --doc-id abc123 --name orders-large --limit 100 --offset 200
-mbs db-table field batch-update --doc-id abc123 --name ActualsTable --updates field-updates.json
+mbs db-table field batch-update --doc-id abc123 --name ActualsTable --updates field-updates.json  # compatibility only
 
 # excel-worksheet row
 mbs excel-worksheet row insert --doc-id abc123 --worksheet-name Actuals --row 10 --count 2
@@ -906,8 +909,8 @@ Relationship guide:
   worksheet style planning/apply. `mbs worksheet style ...` and `mbs style ...`
   expose the same style commands. For Base worksheets, `style format`,
   `style columns-width`, and `style cell batch-set` automatically update field
-  metadata (`formatter`, text color, background color, and width) instead of
-  requiring agents to choose Base-specific commands.
+  metadata (`formatter`, text color, background color, and width) through the
+  native field API. Base width is stored at `field.property.style.width`.
 - Use `excel-worksheet chart` for list/get/create/update/delete of individual
   source-backed visualizations.
 - Use `excel-worksheet dashboard` for local validation and worksheet-level chart

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "maybeai-sheet-cli"
-version = "0.26"
+version = "0.26.2"
 description = "CLI for common MaybeAI spreadsheet operations"
 readme = "README.md"
 requires-python = ">=3.10"

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/src/maybeai_sheet/commands/_phase2.py

@@ -19,6 +19,26 @@ _A1_RANGE_RE = re.compile(r"^([A-Za-z]+[1-9][0-9]*):([A-Za-z]+[1-9][0-9]*)$")
 _TRUE_VALUES = frozenset({"1", "true", "t", "yes", "y", "on"})
 _FALSE_VALUES = frozenset({"0", "false", "f", "no", "n", "off"})
 _LINEAGE_MAX_RANGE_CELLS = 100
+_PIXEL_DIMENSION_RE = re.compile(r"^(?P<value>\d+(?:\.\d+)?)px$", re.IGNORECASE)
+
+
+def parse_pixel_dimension(raw: str, *, name: str, example: str = "140px") -> tuple[float, str | None]:
+    """Parse new px syntax while preserving legacy numeric CLI input."""
+    value = raw.strip()
+    match = _PIXEL_DIMENSION_RE.fullmatch(value)
+    if match:
+        return float(match.group("value")), "px"
+    try:
+        numeric = float(value)
+    except ValueError as exc:
+        raise UsageError(f"{name} must be a number or a pixel value such as {example}.") from exc
+    if numeric <= 0:
+        raise UsageError(f"{name} must be greater than 0.")
+    typer.echo(
+        f"Warning: numeric {name} uses legacy units; use {name} with an explicit px suffix (for example {example}).",
+        err=True,
+    )
+    return numeric, None
 
 
 def run_post_command(

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/src/maybeai_sheet/commands/column.py

@@ -14,6 +14,7 @@ from ._phase2 import (
     common_options,
     require_worksheet,
     require_yes_or_dry_run,
+    parse_pixel_dimension,
     run_post_command,
 )
 
@@ -186,7 +187,7 @@ def width(
     worksheet_name: Optional[str] = typer.Option(None, "--worksheet-name", help="Worksheet name."),
     start_column: str = typer.Option(..., "--start-column", help="A1-style first column."),
     end_column: str = typer.Option(..., "--end-column", help="A1-style last column."),
-    width: int = typer.Option(..., "--width", min=1, help="Column width."),
+    width: str = typer.Option(..., "--width", help="Column width, for example 140px. Bare numbers remain legacy-compatible."),
     dry_run: bool = typer.Option(False, "--dry-run", help="Show the request without sending it."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -203,11 +204,14 @@ def width(
             verbose=verbose,
             timeout=timeout,
         )
+        width_value, width_unit = parse_pixel_dimension(width, name="--width")
         payload = base_payload(target) | {
             "start_column": start_column,
             "end_column": end_column,
-            "width": width,
+            "width": width_value,
         }
+        if width_unit:
+            payload["width_unit"] = width_unit
         run_post_command(
             state=state,
             endpoint="/api/v1/excel/set_columns_width",

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/src/maybeai_sheet/commands/db_table.py

@@ -603,12 +603,75 @@ def _first_tabular_value(value: Any) -> Any:
     return None
 
 
+def _logical_type_from_pg_type(pg_type: str) -> str:
+    normalized = pg_type.strip().lower()
+    if normalized.startswith(("smallint", "integer", "bigint", "numeric", "real", "double precision")):
+        return "number"
+    if normalized == "boolean":
+        return "boolean"
+    if normalized.startswith(("date", "timestamp")):
+        return "datetime"
+    return "text"
+
+
+def _typed_create_columns(response: dict[str, Any], headers: list[str]) -> list[dict[str, Any]] | None:
+    schema = response.get("columns")
+    if schema is None:
+        return None
+    if not isinstance(schema, list):
+        raise UsageError("SQL query response columns must be an array.")
+    if schema and all(isinstance(column, str) for column in schema):
+        return None
+    if not all(isinstance(column, dict) for column in schema):
+        raise UsageError("SQL query response columns must contain typed column objects.")
+
+    typed_columns: list[dict[str, Any]] = []
+    schema_names: list[str] = []
+    for index, column in enumerate(schema):
+        name = column.get("name")
+        pg_type = column.get("pg_type")
+        if not isinstance(name, str) or not name.strip():
+            raise UsageError("SQL query typed column schema must include non-empty names.")
+        if not isinstance(pg_type, str) or not pg_type.strip():
+            raise UsageError("SQL query typed column schema must include pg_type for every column.")
+        name = name.strip()
+        schema_names.append(name)
+        typed_columns.append(
+            {
+                "name": name,
+                "logical_type": _logical_type_from_pg_type(pg_type),
+                "pg_type": pg_type,
+                "index": index,
+            }
+        )
+    if len(set(schema_names)) != len(schema_names):
+        raise UsageError("SQL query typed column schema contains duplicate column names.")
+    if schema_names != headers:
+        raise UsageError("SQL query typed column schema does not match the result header row.")
+    return typed_columns
+
+
+def _row_headers(rows: list[dict[str, Any]]) -> list[str]:
+    headers: list[str] = []
+    seen: set[str] = set()
+    for row in rows:
+        for key in row:
+            name = str(key).strip()
+            if name and name not in seen:
+                seen.add(name)
+                headers.append(name)
+    return headers
+
+
 def _rows_from_tabular_response(response: dict[str, Any]) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
     table = _first_tabular_value(response)
     if table is None:
         raise UsageError("SQL query response did not contain tabular values.")
     if isinstance(table, list) and all(isinstance(row, dict) for row in table):
         rows = [dict(row) for row in table]
+        typed_columns = _typed_create_columns(response, _row_headers(rows))
+        if typed_columns is not None:
+            return rows, typed_columns
         columns = _infer_create_columns(rows)
         return rows, columns
     if not isinstance(table, list) or not all(isinstance(row, list) for row in table):
@@ -627,6 +690,9 @@ def _rows_from_tabular_response(response: dict[str, Any]) -> tuple[list[dict[str
             for idx, header in enumerate(headers)
         }
         rows.append(row)
+    typed_columns = _typed_create_columns(response, headers)
+    if typed_columns is not None:
+        return rows, typed_columns
     columns = [
         {
             "name": header,

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/src/maybeai_sheet/commands/style.py

@@ -29,6 +29,7 @@ from ._phase2 import (
     load_json_object_argument,
     parse_bool_text,
     parse_optional_bool_text,
+    parse_pixel_dimension,
     require_worksheet,
     run_post_command,
 )
@@ -71,6 +72,7 @@ _BEAUTIFY_COLUMN_POLICY: dict[str, object] = {
 }
 _COLUMN_BACKGROUND_STYLE_KEYS = frozenset({"bg_color", "backgroundColor", "fillColor", "background_color", "fill_color"})
 _COLUMN_FONT_COLOR_STYLE_KEYS = frozenset({"font_color", "color", "fontColor", "text_color", "textColor"})
+_COLUMN_FORMAT_STYLE_KEYS = frozenset({"format_code", "formatCode"})
 _BEAUTIFY_CONFIG_KEYS = frozenset(
     {
         "defaults",
@@ -1510,12 +1512,15 @@ def _column_style_for_policy(style: dict[str, object], style_policy: dict[str, o
     column_policy = _column_policy_from_style_policy(style_policy)
     allow_font_color = bool(column_policy.get("allowFontColorBySemanticType"))
     allow_background = bool(column_policy.get("backgroundBySemanticType"))
+    allow_format = bool(column_policy.get("allowFormatBySemanticType", True))
     cleaned: dict[str, object] = {}
     for key, value in style.items():
         if key in _COLUMN_BACKGROUND_STYLE_KEYS and not allow_background:
             continue
         if key in _COLUMN_FONT_COLOR_STYLE_KEYS and not allow_font_color:
             continue
+        if key in _COLUMN_FORMAT_STYLE_KEYS and not allow_format:
+            continue
         cleaned[key] = value
     return cleaned
 
@@ -2188,14 +2193,13 @@ def _base_beautify_field_update(
     style = _column_style_for_policy(classification.style, style_policy)
     logical_type = _field_logical_type(field, None)
     # Base validates number fields against numeric formatter patterns. A name
-    # such as "period" can suggest a date even when the stored field is numeric,
-    # so do not apply an incompatible date formatter from name-based inference.
-    if classification.category == "date" and logical_type and logical_type.lower() in {
-        "number",
-        "integer",
-        "float",
-        "double",
-        "decimal",
+    # such as "period" can suggest a date even when its metadata omits the
+    # type or it is stored as a number, so date formatting needs an explicit
+    # date/time logical type rather than header-based inference alone.
+    if classification.category == "date" and (logical_type or "").lower() not in {
+        "date",
+        "datetime",
+        "timestamp",
     }:
         style.pop("format_code", None)
     existing_property = field.get("property")
@@ -2462,6 +2466,33 @@ def _base_field_update_payload(
     return payload
 
 
+def _base_native_field_width_payload(
+    *,
+    target,
+    gid: int,
+    metadata_response: dict[str, object],
+    field_index: int,
+    width: int,
+) -> dict[str, object]:
+    field_metadata, _ = _resolve_field(
+        metadata_response,
+        _resolved_base_target(target, gid),
+        field=None,
+        field_index=field_index,
+    )
+    field_id = field_metadata.get("field_id")
+    if not isinstance(field_id, str) or not field_id.strip():
+        raise UsageError(
+            "Base field metadata did not include field_id; native width update cannot continue."
+        )
+    return {
+        "document_id": target.document_id,
+        "gid": gid,
+        "field_id": field_id,
+        "property": {"style": {"width": width}},
+    }
+
+
 def _render_base_field_update_result(
     *,
     state,
@@ -2993,16 +3024,19 @@ def format_field(
         handle_cli_error(error)
 
 
-@app.command("columns-width")
+@app.command(
+    "columns-width",
+    help="Set Sheet column widths, or persist Base widths on field.property.style.width.",
+)
 def columns_width(
     ctx: typer.Context,
     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."),
     worksheet_name: Optional[str] = typer.Option(None, "--worksheet-name", help="Worksheet name."),
-    start_column: str = typer.Option(..., "--start-column", help="A1-style first column."),
-    end_column: str = typer.Option(..., "--end-column", help="A1-style last column."),
-    width: int = typer.Option(..., "--width", min=1, help="Column width."),
+    start_column: str = typer.Option(..., "--start-column", help="A1-style first column (resolved to a Base field in Base mode)."),
+    end_column: str = typer.Option(..., "--end-column", help="A1-style last column (resolved to a Base field in Base mode)."),
+    width: str = typer.Option(..., "--width", help="Column width in pixels, for example 140px. Bare numbers remain legacy-compatible."),
     dry_run: bool = typer.Option(False, "--dry-run", help="Show the request without sending it."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -3019,11 +3053,14 @@ def columns_width(
             verbose=verbose,
             timeout=timeout,
         )
+        width_value, width_unit = parse_pixel_dimension(width, name="--width")
         payload = base_payload(target) | {
             "start_column": start_column,
             "end_column": end_column,
-            "width": width,
+            "width": width_value,
         }
+        if width_unit:
+            payload["width_unit"] = width_unit
         if not dry_run:
             client = MaybeAIClient(state)
             engine, gid, _worksheet = _resolve_worksheet_engine(client=client, target=target)
@@ -3037,22 +3074,17 @@ def columns_width(
                 last_index = max(start_index, end_index)
                 updates: list[dict[str, object]] = []
                 for field_index in range(first_index, last_index + 1):
-                    update_payload = _base_field_update_payload(
+                    update_payload = _base_native_field_width_payload(
                         target=target,
                         gid=gid,
                         metadata_response=metadata_response,
-                        field=None,
                         field_index=field_index,
-                        logical_type=None,
-                        formatter=None,
-                        color=None,
-                        background_color=None,
-                        width=width,
+                        width=int(round(width_value)),
                     )
-                    updates.append(_normalize_base_mode_output(client.post_json("/api/v1/excel/db_table/field/update", update_payload)))
+                    updates.append(_normalize_base_mode_output(client.post_json("/api/v1/excel/table/field/update", update_payload)))
                 render_output(
                     build_command_output(
-                        endpoint="/api/v1/excel/db_table/field/update",
+                        endpoint="/api/v1/excel/table/field/update",
                         target=target,
                         result={
                             "success": all(bool(update.get("success", True)) for update in updates),
@@ -3093,7 +3125,7 @@ def rows_height(
     worksheet_name: Optional[str] = typer.Option(None, "--worksheet-name", help="Worksheet name."),
     start_row: int = typer.Option(..., "--start-row", min=1, help="1-based first row."),
     end_row: int = typer.Option(..., "--end-row", min=1, help="1-based last row."),
-    height: int = typer.Option(..., "--height", min=1, help="Row height."),
+    height: str = typer.Option(..., "--height", help="Row height in pixels, for example 32px. Bare numbers remain legacy-compatible."),
     dry_run: bool = typer.Option(False, "--dry-run", help="Show the request without sending it."),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
@@ -3110,11 +3142,14 @@ def rows_height(
             verbose=verbose,
             timeout=timeout,
         )
+        height_value, height_unit = parse_pixel_dimension(height, name="--height", example="32px")
         payload = base_payload(target) | {
             "start_row": start_row,
             "end_row": end_row,
-            "height": height,
+            "height": height_value,
         }
+        if height_unit:
+            payload["height_unit"] = height_unit
         run_post_command(
             state=state,
             endpoint="/api/v1/excel/set_rows_height",

{maybeai_sheet_cli-0.26 → maybeai_sheet_cli-0.26.2}/src/maybeai_sheet/commands/workbook.py

@@ -16,7 +16,7 @@ from ..formatters import build_command_output, handle_cli_error, load_json_file,
 from ..models.workbook import CreateWorkbookRequest
 from ..options import output_option, resolve_command_state, timeout_option, verbose_option
 from ..resolver import ResolvedTarget, build_document_url, parse_document_target, resolve_target
-from ._phase2 import bounded_limit
+from ._phase2 import bounded_limit, require_yes_or_dry_run, run_post_command
 from .db_table import (
     _adopt_existing_create_response,
     _created_table_target,
@@ -42,6 +42,8 @@ _WORKSHEET_DIMENSIONS_ENDPOINT = "/api/v1/excel/worksheet/dimensions"
 _COPY_WORKSHEET_ENDPOINT = "/api/v1/excel/copy_worksheet"
 _GOOGLE_SHEET_HOST = "docs.google.com"
 _GOOGLE_SHEET_PATH_MARKER = "/spreadsheets/d/"
+_WORKBOOK_ORDER_FIELDS = ("created_at", "file_size", "filename", "updated_at", "version")
+_WORKBOOK_ORDER_DIRECTIONS = ("asc", "desc")
 
 
 class _EmptySourceWorksheetError(UsageError):
@@ -153,6 +155,23 @@ def _normalize_engine_token(value: str) -> str:
     )
 
 
+def _normalize_workbook_order(value: str | None) -> tuple[str, str]:
+    if value is None or not value.strip():
+        return "updated_at", "desc"
+    parts = [part.strip().lower() for part in value.split(":")]
+    if len(parts) > 2 or not parts[0]:
+        raise UsageError("--order-by must use FIELD[:DIRECTION]")
+    field = parts[0]
+    if field not in _WORKBOOK_ORDER_FIELDS:
+        raise UsageError(
+            "--order-by field must be one of: " + ", ".join(_WORKBOOK_ORDER_FIELDS)
+        )
+    direction = parts[1] if len(parts) == 2 and parts[1] else "asc"
+    if direction not in _WORKBOOK_ORDER_DIRECTIONS:
+        raise UsageError("--order-by direction must be one of: asc, desc")
+    return field, direction
+
+
 def _normalize_import_source_engine(engine: str | None) -> str:
     if engine is None:
         return "sheet"
@@ -2251,6 +2270,11 @@ def calculate(
 def list_workbooks(
     ctx: typer.Context,
     limit: int = typer.Option(20, "--limit", min=1, help="Maximum workbooks to return."),
+    order_by: Optional[str] = typer.Option(
+        None,
+        "--order-by",
+        help="Sort workbooks by FIELD[:DIRECTION]. Default: updated_at:desc.",
+    ),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
     timeout: Optional[float] = timeout_option(),
@@ -2263,7 +2287,12 @@ def list_workbooks(
             timeout=timeout,
         )
         endpoint = "/api/v1/excel/list_files"
-        payload = {"limit": bounded_limit(limit, option="--limit")}
+        sort_field, sort_direction = _normalize_workbook_order(order_by)
+        payload = {
+            "limit": bounded_limit(limit, option="--limit"),
+            "order_by": sort_field,
+            "order_direction": sort_direction,
+        }
         response = MaybeAIClient(state).post_json(endpoint, payload)
         render_output(
             build_command_output(
@@ -2277,10 +2306,53 @@ def list_workbooks(
         handle_cli_error(error)
 
 
+@app.command("delete")
+def delete_workbook(
+    ctx: typer.Context,
+    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."),
+    yes: bool = typer.Option(False, "--yes", help="Confirm destructive workbook deletion."),
+    dry_run: bool = typer.Option(False, "--dry-run", help="Show the request without sending it."),
+    output: Optional[str] = output_option(),
+    verbose: Optional[bool] = verbose_option(),
+    timeout: Optional[float] = timeout_option(),
+) -> None:
+    """Soft-delete a workbook."""
+    try:
+        require_yes_or_dry_run(yes=yes, dry_run=dry_run)
+        state: CLIContext = resolve_command_state(
+            ctx,
+            doc_id=doc_id,
+            url=url,
+            uri=uri,
+            output=output,
+            verbose=verbose,
+            timeout=timeout,
+        )
+        target = resolve_target(state)
+        endpoint = "/api/v1/excel/delete_file"
+        run_post_command(
+            state=state,
+            endpoint=endpoint,
+            payload={"uri": target.uri},
+            target=target,
+            dry_run=dry_run,
+            command_id="workbook.delete",
+        )
+    except Exception as error:  # pragma: no cover - CLI boundary
+        handle_cli_error(error)
+
+
 @app.command("list-user-workbooks")
 def list_user_workbooks(
     ctx: typer.Context,
     limit: int = typer.Option(20, "--limit", min=1, help="Maximum workbooks to return."),
+    order_by: Optional[str] = typer.Option(
+        None,
+        "--order-by",
+        help="Sort workbooks by FIELD[:DIRECTION]. Default: updated_at:desc.",
+    ),
     output: Optional[str] = output_option(),
     verbose: Optional[bool] = verbose_option(),
     timeout: Optional[float] = timeout_option(),
@@ -2288,6 +2360,7 @@ def list_user_workbooks(
     list_workbooks(
         ctx,
         limit=limit,
+        order_by=order_by,
         output=output,
         verbose=verbose,
         timeout=timeout,