shortcutxl 0.3.43 → 0.3.44

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.3.44]
+
+- **Shorty mascot** — Replaced the braille X logo with a new Shorty block-art mascot.
+- **Plan mode bug fix** — Fixed an issue where plan mode was unable to read files.
+
 ## [0.3.43]
 
 - **Security & stability** — Internal hardening fixes across the runtime.

package/dist/app/constants.d.ts

@@ -10,6 +10,8 @@ export declare const SHORTCUT_LLM_PROXY_URL: string;
 export declare const SHORTCUT_AUTH_URL: string;
 /** API service for credit balance and billing. */
 export declare const SHORTCUT_API_URL: string;
+/** Log ingest service for client-side observability. */
+export declare const NEXT_PUBLIC_LOG_INGEST_URL: string;
 /** Optional directory for fork trace review artifacts. */
 export declare function getShortcutForkTraceDir(): string | undefined;
 /** WebSocket URL for the collab signaling server. */

package/dist/app/prompts/com-api-reference.json

@@ -1,146 +1,146 @@
-{
-  "interfaces": {
-    "Workbook": {
-      "docstring": "Workbook wrapper.\nUsage:\n    wb = Workbook(app.Workbooks(\"MyFile.xlsx\"))\n\nRaw COM access:\n    wb._wb  \u2014 the underlying COM Workbook object for direct platform API calls.\n    Example: wb._wb.Worksheets(\"Sheet1\").Visible = False",
-      "functions": {
-        "getSheetNames": {
-          "signature": "def getSheetNames() -> list[str]",
-          "docstring": "Get the names of all sheets in the workbook.",
-          "tags": ["action", "ask"]
-        },
-        "getWorkbookSummary": {
-          "signature": "def getWorkbookSummary() -> str",
-          "docstring": "Get sheet names and used ranges for this workbook.\nReturns lines like:\n    Sheets and their used ranges:\n      Sheet1: A1:D10 (active)\n      Inputs: (empty)",
-          "tags": ["action", "ask"]
-        },
-        "getSheet": {
-          "signature": "def getSheet(name: str) -> 'Worksheet'",
-          "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
-          "tags": ["action", "ask"]
-        },
-        "addSheet": {
-          "signature": "def addSheet(name: str, index: int | None = None) -> 'Worksheet'",
-          "docstring": "Add a new sheet at 0-based index. index=0 inserts before the first sheet.\nOmit index for Excel's default position.\nExample: wb.addSheet(\"NewSheet\", 0)  # insert as first sheet",
-          "tags": ["action"]
-        },
-        "moveSheet": {
-          "signature": "def moveSheet(name: str, index: int) -> None",
-          "docstring": "Move a sheet to 0-based index. index=0 moves to first, index=Count-1 moves to last.\nExample: wb.moveSheet(\"Data\", 0)  # move to first position",
-          "tags": ["action"]
-        },
-        "calculate": {
-          "signature": "def calculate() -> None",
-          "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u2014 read in a follow-up block.",
-          "tags": ["action"]
-        },
-        "errorCheck": {
-          "signature": "def errorCheck(ranges: list[str] | None = None) -> str",
-          "docstring": "Scan for errors (#REF!, #DIV/0!, #NAME?, #VALUE!, #N/A, #NULL!, #NUM!). Ranges MUST include a sheet name (\"Sheet1\" or \"Sheet1!A1:D50\") \u2014 bare ranges like \"A1:D50\" will fail.\n      Args:\n          ranges: Optional sheet names (\"Sheet1\") or ranges (\"Sheet1!A1:D50\"). Omit to check all.\n      Returns:\n          \"No issues found.\" or \"Errors (N):\nSheet1!A1: #REF!\n...\"",
-          "tags": ["action", "ask"]
-        },
-        "copyPasteRange": {
-          "signature": "def copyPasteRange(from_range: str, to_address: str, paste_type: str = 'all', ) -> None",
-          "docstring": "Copy range within same workbook via range.Copy + PasteSpecial.\nAddresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).\nExample: wb.copyPasteRange(\"Sheet1!A1:D10\", \"Sheet2!A1\", paste_type=\"values\")",
-          "tags": ["action"]
-        },
-        "getNamedRangeInfo": {
-          "signature": "def getNamedRangeInfo(max_count: int = 50) -> str",
-          "docstring": "Get named ranges. Returns formatted string with name, reference, scope, and comment.\nExample output: \"Named Ranges (2):\\n  Name: TaxRate | Ref: =Settings!$B$2 | Scope: workbook | Comment: ...\"\nReturns \"No named ranges found.\" if none exist.",
-          "tags": ["action", "ask"]
-        }
-      }
-    },
-    "Worksheet": {
-      "docstring": "Worksheet wrapper.\nUsage:\n    sheet = wb.getSheet(\"Sheet1\")\n\nRaw COM access:\n    sheet._ws  \u2014 the underlying COM Worksheet object for direct platform API calls.\n    Use for borders, text orientation, cell protection, and other properties not covered by the wrapper.\n    Example: sheet._ws.Range(\"A1\").Borders(9).LineStyle = 1  # xlEdgeBottom, xlContinuous",
-      "functions": {
-        "getSheetSummary": {
-          "signature": "def getSheetSummary() -> str",
-          "docstring": "Overview: name, used range, tables (with style/banded/header/total props),\npivots (with range), conditional formats (type/range/priority/stopIfTrue),\nautofilter (with filtering status), charts (with type).",
-          "tags": ["action", "ask"]
-        },
-        "getUsedRange": {
-          "signature": "def getUsedRange() -> str",
-          "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
-          "tags": ["action", "ask"]
-        },
-        "getCell": {
-          "signature": "def getCell(address: str, include_style: bool = True) -> str",
-          "docstring": "Formatted cell string: \"value(=FORMULA) (style_json)\". Formula always included.\nZero with custom format appends [0]: \"$ - [0]\".\nExample:\n    print(sheet.getCell(\"A1\"))\n    print(sheet.getCell(\"A1\", include_style=False))",
-          "tags": ["action", "ask"]
-        },
-        "getCellRange": {
-          "signature": "def getCellRange(range_addr: str, include_style: bool = True) -> str",
-          "docstring": "Markdown-like range: \"A1:Name | B1:Value\\nA2:Alice | B2:100\". Uses display text. Max 3000 cells.\nAppends \"--- Style patterns ---\" section when include_style=True.",
-          "tags": ["action", "ask"]
-        },
-        "getRawCellData": {
-          "signature": "def getRawCellData(address: str, formula: bool = False) -> Any",
-          "docstring": "Get raw data value from a cell, preserving data type. Set formula=True to get the formula string.",
-          "tags": ["action", "ask"]
-        },
-        "getRawRangeData": {
-          "signature": "def getRawRangeData(range_addr: str, formula: bool = False) -> list[list[Any]]",
-          "docstring": "Get raw data for a range as 2D list. Always returns 2D list even for single row/column.",
-          "tags": ["action", "ask"]
-        },
-        "regexSearch": {
-          "signature": "def regexSearch(patterns: list[str], match_case: bool = False) -> list[dict]",
-          "docstring": "Regex search across used range using display text. Returns [{\"address\": \"A1\", \"value\": \"display text\"}, ...].\nExample: sheet.regexSearch([\"revenue\", \"cost\"])",
-          "tags": ["action", "ask"]
-        },
-        "setCell": {
-          "signature": "def setCell(address: str, value: Any, number_format: str | None = None, note: str | None = None, ) -> None",
-          "docstring": "Write value or formula. \"=\" prefix = formula. None or \"\" clears the cell.\nExamples:\n    sheet.setCell(\"A1\", 8000)\n    sheet.setCell(\"C1\", 0.15, number_format=\"0%\", note=\"Tax rate\")\n    sheet.setCell(\"B1\", \"=SUM(A1:A10)\")",
-          "tags": ["action"]
-        },
-        "setCellRange": {
-          "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
-          "docstring": "Bulk write \u2014 ALWAYS use for >100 cells. \"=\" prefix = formula.\nExamples:\n    sheet.setCellRange(\"A1:B2\", [[1, 2], [3, 4]])\n    sheet.setCellRange(\"A1:B2\", [[\"=SUM(C1)\", \"=SUM(D1)\"], [5, 6]], number_format=\"$#,##0\")",
-          "tags": ["action"]
-        },
-        "autoFill": {
-          "signature": "def autoFill(source_range: str, target_range: str, fill_mode: str = 'auto', ) -> None",
-          "docstring": "Drag-fill. Source must be contained within target.\nUse fill_mode=\"constant\" when copying a single value without incrementing.\nWARNING: Single numeric value with \"auto\" creates incrementing sequence (0,1,2,3...).\nExample: sheet.autoFill(\"A1:A2\", \"A1:A10\")",
-          "tags": ["action"]
-        },
-        "addPicture": {
-          "signature": "def addPicture(name: str, base64_data: str, anchor_cell: str) -> None",
-          "docstring": "Add a picture from base64-encoded PNG or JPEG data. No data URI prefix.\nExample: sheet.addPicture(\"chart1\", base64_string, \"F2\")",
-          "tags": ["action"]
-        },
-        "setIBTextColors": {
-          "signature": "def setIBTextColors(range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None, ) -> None",
-          "docstring": "IB text colors for numeric inputs only. Text strings and booleans are left untouched.\n- Blue/16711680: hard-coded numeric constants (int/float)\n- Black/0: formulas (same-sheet references)\n- Green/32768: formulas with cross-sheet references (contains '!')\nColors are BGR integers (native COM format).\nExample: sheet.setIBTextColors(\"A1:D10\", ignored_constants=[0])",
-          "tags": ["action"]
-        }
-      }
-    }
-  },
-  "helpers": {
-    "hex_to_bgr": {
-      "signature": "def hex_to_bgr(hex_str: str) -> int",
-      "docstring": "Convert \"#RRGGBB\" hex string to BGR integer for Excel COM.\nExample: ws.Range(\"A1\").Font.Color = hex_to_bgr(\"#FF0000\")  # red",
-      "tags": ["action", "ask"]
-    },
-    "index_to_address": {
-      "signature": "def index_to_address(row: int, col: int) -> str",
-      "docstring": "Convert 0-based (row, col) to Excel address: index_to_address(0, 0) \u2192 \"A1\".",
-      "tags": ["action", "ask"]
-    },
-    "address_to_index": {
-      "signature": "def address_to_index(address: str) -> tuple[int, int]",
-      "docstring": "Parse \"A1\" into (row, col) 0-based tuple: address_to_index(\"B3\") \u2192 (2, 1).",
-      "tags": ["action", "ask"]
-    },
-    "col_letter": {
-      "signature": "def col_letter(index: int) -> str",
-      "docstring": "Convert 0-based column index to letter: col_letter(26) \u2192 \"AA\".",
-      "tags": ["action", "ask"]
-    },
-    "col_index": {
-      "signature": "def col_index(letter: str) -> int",
-      "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u2192 26.",
-      "tags": ["action", "ask"]
-    }
-  }
-}
+{
+  "interfaces": {
+    "Workbook": {
+      "docstring": "Workbook wrapper.\nUsage:\n    wb = Workbook(app.Workbooks(\"MyFile.xlsx\"))\n\nRaw COM access:\n    wb._wb  \u2014 the underlying COM Workbook object for direct platform API calls.\n    Example: wb._wb.Worksheets(\"Sheet1\").Visible = False",
+      "functions": {
+        "getSheetNames": {
+          "signature": "def getSheetNames() -> list[str]",
+          "docstring": "Get the names of all sheets in the workbook.",
+          "tags": ["action", "ask"]
+        },
+        "getWorkbookSummary": {
+          "signature": "def getWorkbookSummary() -> str",
+          "docstring": "Get sheet names and used ranges for this workbook.\nReturns lines like:\n    Sheets and their used ranges:\n      Sheet1: A1:D10 (active)\n      Inputs: (empty)",
+          "tags": ["action", "ask"]
+        },
+        "getSheet": {
+          "signature": "def getSheet(name: str) -> 'Worksheet'",
+          "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
+          "tags": ["action", "ask"]
+        },
+        "addSheet": {
+          "signature": "def addSheet(name: str, index: int | None = None) -> 'Worksheet'",
+          "docstring": "Add a new sheet at 0-based index. index=0 inserts before the first sheet.\nOmit index for Excel's default position.\nExample: wb.addSheet(\"NewSheet\", 0)  # insert as first sheet",
+          "tags": ["action"]
+        },
+        "moveSheet": {
+          "signature": "def moveSheet(name: str, index: int) -> None",
+          "docstring": "Move a sheet to 0-based index. index=0 moves to first, index=Count-1 moves to last.\nExample: wb.moveSheet(\"Data\", 0)  # move to first position",
+          "tags": ["action"]
+        },
+        "calculate": {
+          "signature": "def calculate() -> None",
+          "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u2014 read in a follow-up block.",
+          "tags": ["action"]
+        },
+        "errorCheck": {
+          "signature": "def errorCheck(ranges: list[str] | None = None) -> str",
+          "docstring": "Scan for errors (#REF!, #DIV/0!, #NAME?, #VALUE!, #N/A, #NULL!, #NUM!). Ranges MUST include a sheet name (\"Sheet1\" or \"Sheet1!A1:D50\") \u2014 bare ranges like \"A1:D50\" will fail.\n      Args:\n          ranges: Optional sheet names (\"Sheet1\") or ranges (\"Sheet1!A1:D50\"). Omit to check all.\n      Returns:\n          \"No issues found.\" or \"Errors (N):\nSheet1!A1: #REF!\n...\"",
+          "tags": ["action", "ask"]
+        },
+        "copyPasteRange": {
+          "signature": "def copyPasteRange(from_range: str, to_address: str, paste_type: str = 'all', ) -> None",
+          "docstring": "Copy range within same workbook via range.Copy + PasteSpecial.\nAddresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).\nExample: wb.copyPasteRange(\"Sheet1!A1:D10\", \"Sheet2!A1\", paste_type=\"values\")",
+          "tags": ["action"]
+        },
+        "getNamedRangeInfo": {
+          "signature": "def getNamedRangeInfo(max_count: int = 50) -> str",
+          "docstring": "Get named ranges. Returns formatted string with name, reference, scope, and comment.\nExample output: \"Named Ranges (2):\\n  Name: TaxRate | Ref: =Settings!$B$2 | Scope: workbook | Comment: ...\"\nReturns \"No named ranges found.\" if none exist.",
+          "tags": ["action", "ask"]
+        }
+      }
+    },
+    "Worksheet": {
+      "docstring": "Worksheet wrapper.\nUsage:\n    sheet = wb.getSheet(\"Sheet1\")\n\nRaw COM access:\n    sheet._ws  \u2014 the underlying COM Worksheet object for direct platform API calls.\n    Use for borders, text orientation, cell protection, and other properties not covered by the wrapper.\n    Example: sheet._ws.Range(\"A1\").Borders(9).LineStyle = 1  # xlEdgeBottom, xlContinuous",
+      "functions": {
+        "getSheetSummary": {
+          "signature": "def getSheetSummary() -> str",
+          "docstring": "Overview: name, used range, tables (with style/banded/header/total props),\npivots (with range), conditional formats (type/range/priority/stopIfTrue),\nautofilter (with filtering status), charts (with type).",
+          "tags": ["action", "ask"]
+        },
+        "getUsedRange": {
+          "signature": "def getUsedRange() -> str",
+          "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
+          "tags": ["action", "ask"]
+        },
+        "getCell": {
+          "signature": "def getCell(address: str, include_style: bool = True) -> str",
+          "docstring": "Formatted cell string: \"value(=FORMULA) (style_json)\". Formula always included.\nZero with custom format appends [0]: \"$ - [0]\".\nExample:\n    print(sheet.getCell(\"A1\"))\n    print(sheet.getCell(\"A1\", include_style=False))",
+          "tags": ["action", "ask"]
+        },
+        "getCellRange": {
+          "signature": "def getCellRange(range_addr: str, include_style: bool = True) -> str",
+          "docstring": "Markdown-like range: \"A1:Name | B1:Value\\nA2:Alice | B2:100\". Uses display text. Max 3000 cells; read larger areas in smaller chunks.\nAppends \"--- Style patterns ---\" section when include_style=True.",
+          "tags": ["action", "ask"]
+        },
+        "getRawCellData": {
+          "signature": "def getRawCellData(address: str, formula: bool = False) -> Any",
+          "docstring": "Get raw data value from a cell, preserving data type. Set formula=True to get the formula string.",
+          "tags": ["action", "ask"]
+        },
+        "getRawRangeData": {
+          "signature": "def getRawRangeData(range_addr: str, formula: bool = False) -> list[list[Any]]",
+          "docstring": "Get raw data for a range as 2D list. Always returns 2D list even for single row/column.",
+          "tags": ["action", "ask"]
+        },
+        "regexSearch": {
+          "signature": "def regexSearch(patterns: list[str], match_case: bool = False) -> list[dict]",
+          "docstring": "Regex search across used range using display text. Returns [{\"address\": \"A1\", \"value\": \"display text\"}, ...].\nExample: sheet.regexSearch([\"revenue\", \"cost\"])",
+          "tags": ["action", "ask"]
+        },
+        "setCell": {
+          "signature": "def setCell(address: str, value: Any, number_format: str | None = None, note: str | None = None, ) -> None",
+          "docstring": "Write value or formula. \"=\" prefix = formula. None or \"\" clears the cell.\nExamples:\n    sheet.setCell(\"A1\", 8000)\n    sheet.setCell(\"C1\", 0.15, number_format=\"0%\", note=\"Tax rate\")\n    sheet.setCell(\"B1\", \"=SUM(A1:A10)\")",
+          "tags": ["action"]
+        },
+        "setCellRange": {
+          "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
+          "docstring": "Bulk write \u2014 ALWAYS use for >100 cells. \"=\" prefix = formula.\nExamples:\n    sheet.setCellRange(\"A1:B2\", [[1, 2], [3, 4]])\n    sheet.setCellRange(\"A1:B2\", [[\"=SUM(C1)\", \"=SUM(D1)\"], [5, 6]], number_format=\"$#,##0\")",
+          "tags": ["action"]
+        },
+        "autoFill": {
+          "signature": "def autoFill(source_range: str, target_range: str, fill_mode: str = 'auto', ) -> None",
+          "docstring": "Drag-fill. Source must be contained within target. Default \"auto\" increments hardcoded numeric literals; use fill_mode=\"constant\" to copy literal values, then read back destination cells and check for empty/NaN values.\nUse fill_mode=\"constant\" when copying a single value without incrementing.\nWARNING: Single numeric value with \"auto\" creates incrementing sequence (0,1,2,3...).\nExample: sheet.autoFill(\"A1:A2\", \"A1:A10\")",
+          "tags": ["action"]
+        },
+        "addPicture": {
+          "signature": "def addPicture(name: str, base64_data: str, anchor_cell: str) -> None",
+          "docstring": "Add a picture from base64-encoded PNG or JPEG data. No data URI prefix.\nExample: sheet.addPicture(\"chart1\", base64_string, \"F2\")",
+          "tags": ["action"]
+        },
+        "setIBTextColors": {
+          "signature": "def setIBTextColors(range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None, ) -> None",
+          "docstring": "IB text colors for numeric inputs only. Text strings and booleans are left untouched.\n- Blue/16711680: hard-coded numeric constants (int/float)\n- Black/0: formulas (same-sheet references)\n- Green/32768: formulas with cross-sheet references (contains '!')\nColors are BGR integers (native COM format).\nExample: sheet.setIBTextColors(\"A1:D10\", ignored_constants=[0])",
+          "tags": ["action"]
+        }
+      }
+    }
+  },
+  "helpers": {
+    "hex_to_bgr": {
+      "signature": "def hex_to_bgr(hex_str: str) -> int",
+      "docstring": "Convert \"#RRGGBB\" hex string to BGR integer for Excel COM.\nExample: ws.Range(\"A1\").Font.Color = hex_to_bgr(\"#FF0000\")  # red",
+      "tags": ["action", "ask"]
+    },
+    "index_to_address": {
+      "signature": "def index_to_address(row: int, col: int) -> str",
+      "docstring": "Convert 0-based (row, col) to Excel address: index_to_address(0, 0) \u2192 \"A1\".",
+      "tags": ["action", "ask"]
+    },
+    "address_to_index": {
+      "signature": "def address_to_index(address: str) -> tuple[int, int]",
+      "docstring": "Parse \"A1\" into (row, col) 0-based tuple: address_to_index(\"B3\") \u2192 (2, 1).",
+      "tags": ["action", "ask"]
+    },
+    "col_letter": {
+      "signature": "def col_letter(index: int) -> str",
+      "docstring": "Convert 0-based column index to letter: col_letter(26) \u2192 \"AA\".",
+      "tags": ["action", "ask"]
+    },
+    "col_index": {
+      "signature": "def col_index(letter: str) -> int",
+      "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u2192 26.",
+      "tags": ["action", "ask"]
+    }
+  }
+}