@dumbmice/pi-deepseek-websearch 0.1.5 → 0.1.7

package/AGENTS.md

@@ -10,6 +10,7 @@ Instructions for anyone — human or coding agent — changing
 src/index.ts              the extension: two tool registrations, transport, formatting, guards
 test/index.test.ts        node:test suite; global fetch is stubbed, nothing touches the network
 docs/docs-alignment.md    every client-side deviation from DeepSeek's published API contract
+docs/pi-api-alignment.md  which pi release this package is verified against
 README.md                 user-facing documentation
 AGENTS.md                 this file
 CONTRIBUTING.md           four-line pointer to this file (GitHub convention)
@@ -21,8 +22,8 @@ tsconfig.json             the strict / noEmit settings used by typecheck
 
 ## Requirements and commands
 
-Node >= 22.6 (`engines`; the entry point is TypeScript and the test runner uses
-`--experimental-strip-types`). devDependencies stay limited to `typescript` and `@types/node`; the
+Node >= 22.19 (`engines`, the floor pi 1.5.1 itself requires; the entry point is TypeScript and
+the test runner uses `--experimental-strip-types`). devDependencies stay limited to `typescript` and `@types/node`; the
 publish workflow installs with `npm ci`, the test matrix with `npm install`.
 
 ```bash
@@ -118,6 +119,9 @@ is enough to check rendering. `npm test` needs neither key nor network.
   and constant and at the top of the register — keep them in step.
 - `CHANGELOG.md` follows Keep a Changelog. Put unreleased work under `[Unreleased]` with
   Added/Changed/Fixed headings; add the version heading when the release is tagged.
+- `docs/pi-api-alignment.md` records the pi release and Node version this package is verified
+  against. `PI_API_SNAPSHOT` in `src/index.ts`, that file and the README *Install* line move together;
+  `test/docs.test.ts` fails when they drift.
 - `AGENTS.md` (this file) holds contributor, architecture and release material.
 
 ## Release process

package/CHANGELOG.md

@@ -6,6 +6,27 @@ All notable changes to this extension are documented in this file. The format fo
 
 ## [Unreleased]
 
+## [0.1.7] - 2026-11-12
+
+### Changed
+
+- Re-verified against pi **1.5.2** (was 1.5.1). `PI_API_SNAPSHOT`, the register row and the README
+  requirement move to it; 1.5.2's breaking changes (grep context lines, empty `tools` arrays,
+  markdown-transformer options) do not touch any surface this package uses. No runtime change.
+
+## [0.1.6] - 2026-11-06
+
+### Added
+
+- `docs/pi-api-alignment.md`: a tested-version table recording the pi release (`1.5.1`) and Node
+  version this package is verified against, pinned by `PI_API_SNAPSHOT` and a docs test so the claim
+  cannot drift from the code.
+
+### Changed
+
+- `engines.node` raised to `>=22.19`, matching pi 1.5.1's own floor. The README now states the pi
+  version it was tested with.
+
 ## [0.1.5] - 2026-11-06
 
 ### Fixed
@@ -80,7 +101,9 @@ results are not billed. Validated against the DeepSeek API documentation as of 2
 - `deepseek_fetch` rejects local and private targets and never unescapes inside code.
 
 
-[Unreleased]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.5...HEAD
+[Unreleased]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.7...HEAD
+[0.1.7]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.4...v0.1.5
 [0.1.4]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.3...v0.1.4
 [0.1.3]: https://github.com/DumbMice/pi-deepseek-websearch/compare/v0.1.2...v0.1.3

package/README.md

@@ -46,13 +46,17 @@ pi install git:github.com/DumbMice/pi-deepseek-websearch
 
 Requirements:
 
-- Node >= 22.6.
+- **pi 1.5.2** (tested).
+- Node >= 22.19, the floor pi itself requires.
 - A DeepSeek key, from pi's `deepseek` provider (`/login`) or the `DEEPSEEK_API_KEY` variable. Create
   one at <https://platform.deepseek.com/api_keys>.
 - Optional, for a compatible gateway: set `PI_DEEPSEEK_BASE_URL` or `DEEPSEEK_SEARCH_BASE_URL`. A
   trailing slash or `/v1` suffix is stripped. The bare `DEEPSEEK_BASE_URL` is ignored on purpose,
   because other tools point it at an OpenAI-compatible `/v1` root.
 
+Last verified 2026-11-12; the table and what was checked is in
+[docs/pi-api-alignment.md](https://github.com/DumbMice/pi-deepseek-websearch/blob/main/docs/pi-api-alignment.md).
+
 Confirm registration by starting `pi` and asking *"use deepseek_search to look up the DeepSeek API
 pricing"*; the reply begins with a `DeepSeek search · N result(s)` header.
 

package/docs/pi-api-alignment.md

@@ -0,0 +1,46 @@
+# pi extension API alignment
+
+How this extension's use of pi's extension API relates to the documented contract, and which exact
+versions that was established against.
+
+| Component | Tested version | Recorded in |
+|---|---|---|
+| `@earendil-works/pi-coding-agent` | **1.5.2** | `PI_API_SNAPSHOT` in `src/index.ts` |
+| `@earendil-works/pi-schema` (tool validation) | ships with pi 1.5.2 | this file (notes below) |
+| Node | 22.23.2 (tested); floor 22.19, the floor pi itself requires | `package.json` `engines`, README *Install* |
+| DeepSeek Search & Fetch API | docs snapshot 2026-10-30 | `DOCS_SNAPSHOT`; see `docs/docs-alignment.md` |
+
+Last verified **2026-11-12**. Bump a row here, its constant where one exists, and the README
+*Install* line in the same commit as the change that depends on it.
+
+## What this extension actually uses
+
+The contract is followed where it is documented, and nothing here calls pi internals:
+
+- `pi.registerTool()` with a hand-written JSON Schema `parameters` object. pi validates any JSON
+  Schema; the `typebox` import in the docs is a convenience, and avoiding it keeps the package
+  dependency-free.
+- `execute(toolCallId, params, signal, onUpdate, ctx)` — the five-argument form.
+- `ctx.modelRegistry.getApiKeyForProvider("deepseek")` for credentials, falling back to
+  `DEEPSEEK_API_KEY`.
+- The `pi.extensions` manifest entry in `package.json`.
+
+It registers no commands, hooks, renderers or UI, so a release that only changes those surfaces
+cannot affect this package.
+
+## Notes on the 1.5.x line
+
+1. **Tool validation moved to `@earendil-works/pi-schema` in 1.5.0.** TypeBox features outside JSON
+   Schema no longer apply; plain JSON Schema tools now get the same coercion as TypeBox tools
+   (numeric strings to numbers, `"true"` to `true`, a single value to a one-item array, `null` in an
+   optional property dropped). This package uses only JSON Schema keywords, so nothing was lost, and
+   the coercion is a net improvement: `allowed_domains: "example.com"` now arrives as
+   `["example.com"]` instead of being rejected.
+2. **1.5.2's breaking changes do not touch this package.** They cover `GrepOperations.readFile`
+   context lines, the omission of an empty `"tools": []` array for OpenAI-compatible models, and new
+   `pi.registerMarkdownTransformer()` options. This package registers no renderers and does not
+   implement grep.
+3. **Package changelogs are read from the package root by 1.5.x.** `CHANGELOG.md` uses the required
+   `## [x.y.z]` headings, so extension updates surface our notes without a `pi.changelogPath` entry.
+4. **Node floor.** pi 1.5.1 declares `>=22.19.0`; this package declares the same floor, because it
+   only runs inside pi.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dumbmice/pi-deepseek-websearch",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "DeepSeek web search and page fetch tools for the pi coding agent: publication dates, authority, rerank scores, ori_question, count 1-50.",
   "type": "module",
   "license": "MIT",
@@ -41,12 +41,12 @@
     ]
   },
   "scripts": {
-    "test": "node --experimental-strip-types --no-warnings --test test/index.test.ts",
+    "test": "node --experimental-strip-types --no-warnings --test test/index.test.ts test/docs.test.ts",
     "typecheck": "tsc -p tsconfig.json",
     "pack:check": "npm pack --dry-run"
   },
   "engines": {
-    "node": ">=22.6"
+    "node": ">=22.19"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",

package/src/index.ts

@@ -21,6 +21,7 @@
 import { isIP } from "node:net";
 
 export const DOCS_SNAPSHOT = "2026-10-30";
+export const PI_API_SNAPSHOT = "2026-11-12";
 export const PRICE_PER_SUCCESSFUL_REQUEST_USD = 0.00075;
 export const MAX_QUERY_CHARS = 128;