@dreki-gg/pi-doc-search 0.2.0

package/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  publish:
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # npm trusted publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+
+      - run: bun install --frozen-lockfile
+
+      - run: bun run typecheck
+
+      # npm >= 11.5.1 required for OIDC trusted publishing; Node 24 ships it
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org
+
+      - run: npm publish

package/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# @dreki-gg/pi-doc-search
+
+> Renamed from `@dreki-gg/pi-context7` when extracted from the pi-extensions monorepo. Entries below predate the rename; tool names were `context7_*` at the time.
+
+## 0.2.0
+
+### Minor Changes
+
+- Rework the model-facing prompts so agents actually reach for the docs tools.
+  `context7_get_library_docs` is now framed as a proactive step — consult it
+  before writing or editing code against a third-party library rather than only
+  when a user explicitly asks for documentation — and its one-call auto-resolve
+  path is emphasized. `context7_resolve_library_id` is demoted to the
+  ambiguous-match exception, and tool descriptions lead with behavior instead of
+  "MCP equivalent" narration.
+
+## 0.1.9
+
+### Patch Changes
+
+- [`938048f`](https://github.com/dreki-gg/pi-extensions/commit/938048ffd15f8b4174e369f2042a101a42486ed8) Thanks [@jalbarrang](https://github.com/jalbarrang)! - disable terminate: true on context7 tool calls
+
+## 0.1.8
+
+### Patch Changes
+
+- [`90899a5`](https://github.com/dreki-gg/pi-extensions/commit/90899a52d3910bcf4860c1dfbb376b0d203addcd) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Fix promptGuidelines to include explicit tool names instead of "this tool", following pi extension best practices. Guidelines are appended flat to the system prompt, so each bullet must name the tool it refers to.
+
+## 0.1.7
+
+### Patch Changes
+
+- [`d133c3d`](https://github.com/dreki-gg/pi-extensions/commit/d133c3da917e7e5def568d27d6cde8ae8a6c00d2) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Mark pi peer dependencies as optional so npm does not auto-install pi internals when installing extension packages.
+
+## 0.1.6
+
+### Patch Changes
+
+- [`0be7b68`](https://github.com/dreki-gg/pi-extensions/commit/0be7b6877e9874b46c756b58c99d599db623ef11) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Migrate TypeBox usage and session replacement flows for Pi 0.69 compatibility.
+
+  - switch extension imports from `@sinclair/typebox` to `typebox`
+  - update package peer dependencies to require `typebox`
+  - move subagent `/run-agent` fork-at follow-up work into `withSession` so post-fork operations use the replacement session safely
+  - add command argument completions for `/run-agent`, `/delegate-agents`, `/preset`, `/mode`, and `/plan`
+  - align local development dependencies with Pi 0.69 for typechecking and compatibility checks
+
+## 0.1.5
+
+### Patch Changes
+
+- [`5e853af`](https://github.com/dreki-gg/pi-extensions/commit/5e853af054a31c4bf87d80f944513e537a39201d) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Sync the extensions repo with Pi 0.68.0 and improve direct agent runs.
+
+  - `@dreki-gg/pi-context7`: remove stale alias docs and align compatibility tests with the canonical tool names actually exported.
+  - `@dreki-gg/pi-modes`: use `before_agent_start.systemPromptOptions.selectedTools` when available so mode prompt text reflects the active prompt tool set.
+  - `@dreki-gg/pi-subagent`: add `/run-agent`, support `sessionStrategy: fork-at` in agent frontmatter, default bundled `worker` and `reviewer` to forked direct runs, and add a custom renderer for run summaries.
+
+## 0.1.4
+
+### Patch Changes
+
+- [`15559e4`](https://github.com/dreki-gg/pi-extensions/commit/15559e4d3392e4b5e1779cf191a69725f029a22b) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Fix Context7 config loading to read from Pi's global extension directory (`~/.pi/agent/extensions/context7`) instead of the installed npm package directory. This restores `apiKey` detection from `config.json`, ensures authenticated requests include the Authorization header, and prevents unexpected rate limiting when a key is already configured.
+
+## 0.1.3
+
+### Patch Changes
+
+- [`147eb20`](https://github.com/dreki-gg/pi-extensions/commit/147eb205ace0f842da2f2823a3a3fe163ee29ad5) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Improve compatibility with newer PI releases.
+
+  - `@dreki-gg/pi-delegate`: limit bundled agent bootstrap work to startup/reload-compatible session starts.
+  - `@dreki-gg/pi-context7`: tighten tool definitions and alias argument normalization for PI compatibility.
+
+## 0.1.2
+
+### Patch Changes
+
+- [`53809f8`](https://github.com/dreki-gg/pi-extensions/commit/53809f83cdf054d1eb58c577903a1d2619a2a654) Thanks [@jalbarrang](https://github.com/jalbarrang)! - Add repository.url to package.json for npm provenance verification
+
+## 0.1.1
+
+### Patch Changes
+
+- [`b1e603c`](https://github.com/dreki-gg/pi-extensions/commit/b1e603c9dab1837eed39880c0455b553deab5cb0) Thanks [@jalbarrang](https://github.com/jalbarrang)! - init packages

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Albarran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @dreki-gg/pi-doc-search
+
+Library doc-search tools for pi, powered by [Context7](https://context7.com). Bypasses MCP entirely — direct HTTP to the Context7 API with a persistent searchable cache.
+
+Formerly published as `@dreki-gg/pi-context7`.
+
+## Install
+
+```bash
+pi install npm:@dreki-gg/pi-doc-search
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `doc_search_resolve_library_id` | Resolve a library/package name to a Context7 library ID |
+| `doc_search_get_library_docs` | Fetch curated docs by ID or name (auto-resolves) |
+| `doc_search_get_cached_doc_raw` | Read full raw cached docs by docRef or semantic lookup |
+
+
+## Configuration
+
+Set env var (preferred):
+
+```bash
+export CONTEXT7_API_KEY=ctx7sk-...
+```
+
+Or create `~/.pi/agent/extensions/doc-search/config.json`:
+
+```json
+{
+  "apiKey": "ctx7sk-...",
+  "cache": {
+    "resolveTtlHours": 168,
+    "docsTtlHours": 24
+  }
+}
+```
+
+API key is optional — Context7 works without one but with lower rate limits.
+
+## Cache
+
+Stored under `~/.pi/agent/extensions/doc-search/cache/` with:
+- Atomic JSON writes
+- Structured indexes (by library name, version, ID, docRef)
+- TTL-based expiry with stale fallback
+- Automatic pruning of expired/orphaned entries