pi-readseek 0.8.24 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +22 -23
  2. package/dist/index.ts +649 -1688
  3. package/package.json +2 -2
  4. package/prompts/def.md +4 -1
  5. package/prompts/digest.md +37 -0
  6. package/prompts/edit.md +15 -22
  7. package/prompts/read.md +13 -17
  8. package/prompts/refs.md +2 -3
  9. package/prompts/view.md +10 -6
  10. package/prompts/write.md +0 -1
  11. package/prompts/check.md +0 -10
  12. package/prompts/hover.md +0 -7
package/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # pi-readseek
2
2
 
3
3
  `pi-readseek` adds ReadSeek's anchored file operations, structural search,
4
- symbol navigation, and PDF tools to Pi. Built-ins remain available unless
5
- `replacedTools` maps `read`, `edit`, `write`, or `grep` to a ReadSeek-backed
4
+ symbol navigation, and document tools to Pi. Built-ins remain available unless
5
+ `overrideTools` maps `read`, `edit`, `write`, or `grep` to a ReadSeek-backed
6
6
  implementation.
7
7
 
8
8
  ## Install
@@ -16,22 +16,21 @@ supported platforms.
16
16
 
17
17
  ## Tools
18
18
 
19
- | Tool | Purpose |
20
- | --- | --- |
21
- | `readSeek_read` | Read anchored text by range, symbol, or map; read images and PDFs |
22
- | `readSeek_edit` | Apply hash-verified edits to an existing text file |
23
- | `readSeek_write` | Create or replace a complete text file and return anchors |
24
- | `readSeek_grep` | Search text or regex and return edit-ready anchors |
25
- | `readSeek_search` | Search AST patterns |
26
- | `readSeek_def` | Find symbol definitions |
27
- | `readSeek_refs` | Find identifier usages, optionally scoped to a cursor binding |
28
- | `readSeek_hover` | Identify the token and enclosing symbol at a cursor |
29
- | `readSeek_rename` | Rename a cursor symbol; set `apply: false` to preview the plan |
30
- | `readSeek_check` | Report parser errors and missing syntax |
31
- | `readSeek_view` | View or narrow a structural PDF index |
19
+ | Tool | Purpose |
20
+ | ----------------- | ----------------------------------------------------------------------------- |
21
+ | `readSeek_read` | Read anchored text by range or symbol; read standalone images |
22
+ | `readSeek_edit` | Apply hash-verified edits to an existing text file |
23
+ | `readSeek_write` | Create or replace a complete text file and return anchors |
24
+ | `readSeek_grep` | Search text or regex and return edit-ready anchors |
25
+ | `readSeek_search` | Search AST patterns |
26
+ | `readSeek_def` | Find symbol definitions |
27
+ | `readSeek_refs` | Find identifier usages, optionally scoped to a cursor binding |
28
+ | `readSeek_rename` | Rename a cursor symbol; set `apply: false` to preview the plan |
29
+ | `readSeek_digest` | Native `digest` envelope: map, diagnostics, identity, content, metadata |
30
+ | `readSeek_view` | View or narrow a structural document index (PDF first); optional asset vision |
32
31
 
33
- The extension also tells Pi to get fresh anchors before editing and to run a
34
- syntax check after source edits.
32
+ The extension also tells Pi to get fresh anchors before editing and to run
33
+ `readSeek_digest` with diagnostics after source edits.
35
34
 
36
35
  ## Settings
37
36
 
@@ -42,7 +41,7 @@ Defaults:
42
41
  ```json
43
42
  {
44
43
  "readseek": {
45
- "replacedTools": [],
44
+ "overrideTools": [],
46
45
  "imageMode": "auto",
47
46
  "syntaxValidation": "warn",
48
47
  "timeoutMs": 120000,
@@ -60,12 +59,12 @@ Defaults:
60
59
  }
61
60
  ```
62
61
 
63
- - `replacedTools`: any of `"read"`, `"edit"`, `"write"`, and `"grep"`.
62
+ - `overrideTools`: any of `"read"`, `"edit"`, `"write"`, and `"grep"`.
64
63
  - `imageMode`: `"auto"` uses Pi's native image input when available, `"on"`
65
- always runs local analysis, and `"off"` skips images while still reading PDF
66
- text. Standalone images require `image`; values are `all`, `ocr`, `caption`, and
67
- `objects`. In `"auto"`, `none` returns a prepared standalone image without local
68
- analysis. Local analysis uses
64
+ always runs local analysis, and `"off"` skips standalone images. Image modes
65
+ are `all`, `ocr`, `caption`, and `objects`; in `"auto"`, `none` returns a
66
+ prepared image without local analysis. Documents use `readSeek_view` with
67
+ optional `visionMode` and `visionLevel`. Local analysis uses
69
68
  [Qwen3-VL-2B-Instruct](../../docs/models/qwen3-vl-2b-instruct.md).
70
69
  - `syntaxValidation`: `"warn"` (write and warn), `"block"` (abort), or `"off"`.
71
70
  Validation triggers only when an edit increases parser error or missing-node