command-code 1.45.0 → 1.47.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # command-code
 
+## 1.47.0
+
+- fix: mark Grok 4.6 as vision-capable
+
+## 1.46.0
+
+### Minor Changes
+
+- feat: auto compact improvements
+- feat: Add browser sign in through local callback server
+- feat: read_file now reads documents. Word, PowerPoint, Excel, OpenDocument, RTF, EPUB and PDF files are extracted to Markdown.
+
 ## 1.45.0
 
 ### Patch Changes

package/dist/bundled/command-code-knowledge/reference/tools.md

@@ -40,12 +40,29 @@ Read a file as a bounded, line-numbered window. Read-only; never prompts.
 
 What it does beyond "read a file":
 
-- **Format-aware**: images (png/jpg/gif/webp/bmp/tiff) come back as real image blocks the model can see; Jupyter notebooks render as tagged cells with outputs; SVG reads as text; PDFs get a shell-extraction hint.
+- **Format-aware**: images come back as real image blocks the model can see; Jupyter notebooks render as tagged cells with outputs; Word, PowerPoint, Excel, OpenDocument, RTF, EPUB and PDF files are extracted to Markdown; SVG reads as text. The full list is below.
 - **Bounded by design**: 128 KB byte cap, 2000-line window, 2000-char per-line clamp - with truncation notes that embed the exact `offset` to continue from.
 - **Typo-tolerant**: on a miss it retries macOS filename variants (curly apostrophes, NFD normalization) and then suggests siblings ("Did you mean…?") using substring and edit-distance matching.
 - **Efficient**: memory-capped streaming reads, and re-reading an unchanged file returns a dedup stub instead of burning context.
 - **Honest about safety**: device and stream paths (`/dev/zero`, `/dev/stdin`, `/proc/<pid>/fd/*`, …) are blocked; every read is recorded in the session's read ledger, which the write tools check later.
 
+#### What it reads
+
+| Kind | Extensions | What comes back |
+| --- | --- | --- |
+| Text and code | anything not listed below, plus `.svg` and `.rtf` | Line-numbered text window (`offset`/`limit`, negative `offset` reads the tail). |
+| Images | `.png` `.jpg` `.jpeg` `.gif` `.webp` `.bmp` `.tiff` | The image itself, attached for vision-capable models (compressed, with the scale factor disclosed when downscaled). |
+| Jupyter notebooks | `.ipynb` | Tagged cells with their outputs; plots attached as images; oversized outputs replaced by a `jq` pointer. |
+| Word | `.docx` `.docm` `.doc` | Markdown: headings, lists, tables, windowed by `offset`/`limit` like text. |
+| PowerPoint | `.pptx` `.pptm` `.ppsx` `.ppsm` `.ppt` `.pps` `.pot` | Markdown per slide, speaker notes included. |
+| Excel | `.xlsx` `.xlsm` `.xlsb` `.xls` | Markdown tables per sheet. |
+| OpenDocument | `.odt` `.ods` `.odp` | Markdown, as for the Office equivalents. |
+| RTF, EPUB | `.rtf` `.epub` | Markdown. `.rtf` reads as plain text when no converter is available. |
+| PDF | `.pdf` | Markdown from the text layer. A scanned or image-only PDF says which pages have no text and gives the `pdftoppm` command to render them; reading the rendered pages attaches them as images. |
+| Other binary | `.zip` `.tar` `.gz` `.exe` `.dll` `.so` `.dylib` `.wasm` and other known binary types | A one-line note with the MIME type and size. Bytes are never loaded. |
+
+Document extraction runs through a native converter that is not shipped with the CLI. The first document read on a machine installs it (needs network, a second or two); every later read and every later session reuses it, and a new release upgrades it on the next read. Where it cannot be installed (offline, unsupported platform) the read falls back to the binary note above, and `.rtf` to plain text. Documents are read as a rendering, never as bytes, so `write_file` will not overwrite a `.docx` with the Markdown that came out of it.
+
 #### Multi-file reads
 
 Pass `paths` (or a single glob pattern in `file_path`) and the contents come back concatenated under `// File: <path> (<type>)` headers, preceded by a `Read X/Y files` summary:
@@ -56,7 +73,7 @@ Pass `paths` (or a single glob pattern in `file_path`) and the contents come bac
 
 `file_path` and `paths` are two separate fields on purpose rather than one union-typed field: providers translate JSON-Schema unions inconsistently — Gemini rejects a function declaration whose parameter sets `any_of` alongside `description`/`items`, failing the whole request. `paths` satisfies the schema's `file_path` requirement through the tool's `requiredAlternatives`, so a multi-file call needs no placeholder.
 
-Literal paths are read as named; glob patterns are filtered by `exclude`, the default exclusions and `.gitignore`. Binary files are noted with their type and size instead of being inlined. Per-file errors are reported inline and never fail the whole call; every match is boundary-checked individually (symlink and `..` escapes are dropped); and an aggregate ~100 KB cap (one tool-output budget) reports exactly which files were skipped, so a wide glob narrows instead of flooding the context.
+Literal paths are read as named; glob patterns are filtered by `exclude`, the default exclusions and `.gitignore`. Documents are extracted to Markdown (capped per file at 128 KB, with a hint to read the file alone for the rest); other binary files are noted with their type and size instead of being inlined. Per-file errors are reported inline and never fail the whole call; every match is boundary-checked individually (symlink and `..` escapes are dropped); and an aggregate ~100 KB cap (one tool-output budget) reports exactly which files were skipped, so a wide glob narrows instead of flooding the context.
 
 This absorbed the former `read_multiple_files` tool — one tool schema instead of two keeps roughly 540 tokens out of every request (~1,685 → ~1,147), and models no longer have to choose between two near-identical read tools. Calls that still arrive under the old name are rewritten to `read_file` (its `include` renames onto `paths`, and `targetDirectory` / `gitIgnore` / `defaultExclude` onto the merged schema's snake_case options), so nothing breaks mid-conversation.