@lincoln504/pi-research 1.6.5 → 1.6.7

package/README.md

@@ -40,19 +40,19 @@ pi install npm:@lincoln504/pi-research
 Standalone, as an [agent skill](docs/AGENT-SKILL.md) for Claude Code, Codex, and other skills-compatible agents:
 
 ```bash
-npm install -g @lincoln504/pi-research --allow-scripts=better-sqlite3
+npm install -g @lincoln504/pi-research
 pi-research skill install
 ```
 
-On npm 12 or newer, npm skips dependency install scripts by default; the flag allows the one that builds search's SQLite module — without it, every search fails with a missing-module error (the flag is harmless on older npm). `pi install` passes no flags to npm, so on npm 12 bracket any install or update with the same allowance as config — set, run, delete — because while the setting is in place it can break installs of other projects with git dependencies ([npm/cli#9783](https://github.com/npm/cli/issues/9783)):
+On npm ≥11.19 (and npm 12), dependency install scripts are skipped by default. This
+package needs none of them: better-sqlite3 13 ships prebuilt bindings for every
+supported platform inside its own tarball, and the stealth browser (~500MB)
+self-provisions on its first use instead of at install time — so the first scrape
+takes a few minutes. Nothing needs approving. (On older npm, which still runs
+scripts, a Windows machine without Visual Studio Build Tools can fail while npm
+needlessly recompiles better-sqlite3; upgrading npm fixes that too.)
 
-```bash
-npm config set allow-scripts=better-sqlite3 --location=user
-pi install npm:@lincoln504/pi-research
-npm config delete allow-scripts --location=user
-```
-
-In pi it works out of the box on the session's model and pi's configuration. Standalone use ([agent skill](docs/AGENT-SKILL.md) or [SDK](docs/SDK.md)) needs a model configured. See [Configuration](docs/CONFIGURATION.md). The first install downloads the stealth browser engine, which takes a few minutes.
+In pi it works out of the box on the session's model and pi's configuration. Standalone use ([agent skill](docs/AGENT-SKILL.md) or [SDK](docs/SDK.md)) needs a model configured. See [Configuration](docs/CONFIGURATION.md).
 
 ### How it works
 
@@ -82,6 +82,7 @@ Three depth levels (normal, deep, ultra) set the team size and number of rounds.
 - An LLM with a 100k+ context window (an API key or a local model)
 - Internet access on a residential IP, since search, scraping, and YouTube transcripts get bot-blocked from datacenter/VPS/cloud IPs
 - pi. The pi extension uses the host's copy while the standalone CLI and agent skill install it as a dependency.
+- Local knowledge-store embeddings need `@huggingface/transformers`, which is an **optional dependency**: if its native image chain (sharp) cannot install on your machine, npm skips it with a warning, the install still succeeds, and everything except local embeddings works. The store disables embeddings gracefully with a message telling you how to restore them.
 - Cloudflare Turnstile and similar systems block scraping on some sites. A run compensates with a wide pool of search results to scrape.
 
 ### Channels
@@ -95,3 +96,7 @@ MIT. Bundled third-party licenses are listed in [docs/THIRD-PARTY-NOTICES.md](do
 ### Package identity
 
 This project is always `@lincoln504/pi-research` on npm. The `pi-research` (unscoped) package is unrelated and deprecated.
+
+### Versioning
+
+pi-research typically follows the latest pi version and is not actively backwards compatible.

package/agent-skill/pi-research/README.md

@@ -43,13 +43,14 @@ model/key is missing.
   model (`PI_RESEARCH_MODEL`) + API key. See [`references/configuration.md`](references/configuration.md).
 
 ```bash
-npm install -g @lincoln504/pi-research --allow-scripts=better-sqlite3
+npm install -g @lincoln504/pi-research
 node "<skill_dir>/scripts/run.mjs" status  # verify detection
 ```
 
-On npm 12 or newer the flag is needed: npm blocks the install script that builds the
-stealth browser's SQLite module, and without it every search fails with a
-missing-module error. It is harmless on older npm.
+On npm ≥11.19 (and npm 12) dependency install scripts are skipped by default — and
+none are needed: better-sqlite3 13 ships prebuilt bindings in its own tarball, and
+the stealth browser self-provisions on its first use (the first scrape takes a few
+minutes). No approval is required.
 
 ### Install the skill
 

package/agent-skill/pi-research/SKILL.md

@@ -2,7 +2,7 @@
 name: pi-research
 description: "Multi-agent web research for any coding agent. Use for anything requiring current information from the internet — news, trends, product/service/company facts, statistics, people, places, events, APIs, library behavior, or 'what is X / how does X work' questions. Also use to search a local knowledge store of previously researched findings before doing live research. Powered by the pi-research engine (search, stealth scraping, security databases, Stack Exchange). Not for reading local files, running project commands, or analyzing this repository's own source."
 license: MIT
-metadata: { "author": "Lincoln Deen", "version": "1.6.5", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
+metadata: { "author": "Lincoln Deen", "version": "1.6.7", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
 allowed-tools: Bash(node:*)
 ---