@lincoln504/pi-research 1.6.5 → 1.6.6
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.
- package/README.md +13 -9
- package/agent-skill/pi-research/README.md +5 -4
- package/agent-skill/pi-research/SKILL.md +1 -1
- package/dist/cli.mjs +587 -149
- package/dist/pdf-extract-worker.mjs +1289 -0
- package/dist/prompts/research-tool-usage.md +2 -1
- package/dist/prompts/researcher.md +1 -1
- package/dist/prompts/system-coordinator.md +2 -2
- package/dist/prompts/system-lead-router.md +1 -1
- package/docs/AGENT-SKILL.md +6 -6
- package/docs/ARCHITECTURE.md +24 -22
- package/docs/CHANGELOG.md +54 -0
- package/docs/CONFIGURATION.md +3 -2
- package/docs/SDK.md +7 -12
- package/package.json +7 -4
- package/scripts/build.cjs +35 -0
- package/scripts/setup.cjs +12 -10
- package/src/cleanup/research-cleanup.ts +11 -5
- package/src/cli.ts +7 -5
- package/src/config.ts +9 -3
- package/src/core/interfaces/knowledge-interfaces.ts +8 -0
- package/src/core/interfaces/orchestration-interfaces.ts +1 -1
- package/src/core/interfaces/research-plan-types.ts +6 -0
- package/src/core/llm/agentic-repair.ts +40 -3
- package/src/core/llm/llm-utils.ts +93 -5
- package/src/core/llm/model-registry-factory.ts +2 -15
- package/src/core/pi-ai-skew.ts +351 -0
- package/src/core/pi-version.ts +1 -1
- package/src/core/planning-service.ts +110 -15
- package/src/core/planning-utils.ts +3 -0
- package/src/core/service-registry.ts +8 -6
- package/src/index.ts +14 -0
- package/src/infrastructure/browser/config.ts +6 -7
- package/src/infrastructure/browser/ensure-browser.ts +14 -7
- package/src/infrastructure/browser/thread-worker-browser.ts +18 -19
- package/src/knowledge/chunker.ts +22 -4
- package/src/knowledge/embedder-init.ts +41 -1
- package/src/knowledge/store.ts +68 -1
- package/src/observers/research-observer-impl.ts +4 -1
- package/src/orchestration/deep-research-orchestrator.ts +3 -3
- package/src/orchestration/headless-observer.ts +33 -0
- package/src/orchestration/quick-research-orchestrator.ts +17 -3
- package/src/orchestration/research-orchestration-service.ts +27 -4
- package/src/orchestration/session-state.ts +36 -7
- package/src/prompts/research-tool-usage.md +2 -1
- package/src/prompts/researcher.md +1 -1
- package/src/prompts/system-coordinator.md +2 -2
- package/src/prompts/system-lead-router.md +1 -1
- package/src/sdk.ts +12 -4
- package/src/tools/research-knowledge-search.ts +23 -7
- package/src/tools/research-tool-definition.ts +1 -1
- package/src/tools/scrape.ts +12 -9
- package/src/tools/search.ts +12 -6
- package/src/tools/security.ts +6 -1
- package/src/tools/stackexchange.ts +6 -1
- package/src/utils/cancellation.ts +34 -1
- package/src/utils/llm-usage.ts +8 -0
- package/src/utils/log-utils.ts +1 -1
- package/src/web-research/browser-search.ts +6 -5
- package/src/web-research/pdf-extract-worker.mjs +1289 -0
- package/src/web-research/pdf-extract-worker.ts +42 -0
- package/src/web-research/pdf-extraction.ts +392 -0
- package/src/web-research/web-scraper.ts +3 -111
package/README.md
CHANGED
|
@@ -40,19 +40,19 @@ pi install npm:@lincoln504/pi-research
|
|
|
40
40
|
Standalone, as an [agent skill](docs/AGENT-SKILL.md) for Claude Code, Codex, and other skills-compatible agents:
|
|
41
41
|
|
|
42
42
|
```bash
|
|
43
|
-
npm install -g @lincoln504/pi-research
|
|
43
|
+
npm install -g @lincoln504/pi-research
|
|
44
44
|
pi-research skill install
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
-
On npm
|
|
47
|
+
On npm ≥11.19 (and npm 12), dependency install scripts are skipped by default. This
|
|
48
|
+
package needs none of them: better-sqlite3 13 ships prebuilt bindings for every
|
|
49
|
+
supported platform inside its own tarball, and the stealth browser (~500MB)
|
|
50
|
+
self-provisions on its first use instead of at install time — so the first scrape
|
|
51
|
+
takes a few minutes. Nothing needs approving. (On older npm, which still runs
|
|
52
|
+
scripts, a Windows machine without Visual Studio Build Tools can fail while npm
|
|
53
|
+
needlessly recompiles better-sqlite3; upgrading npm fixes that too.)
|
|
48
54
|
|
|
49
|
-
|
|
50
|
-
npm config set allow-scripts=better-sqlite3 --location=user
|
|
51
|
-
pi install npm:@lincoln504/pi-research
|
|
52
|
-
npm config delete allow-scripts --location=user
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
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.
|
|
55
|
+
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).
|
|
56
56
|
|
|
57
57
|
### How it works
|
|
58
58
|
|
|
@@ -95,3 +95,7 @@ MIT. Bundled third-party licenses are listed in [docs/THIRD-PARTY-NOTICES.md](do
|
|
|
95
95
|
### Package identity
|
|
96
96
|
|
|
97
97
|
This project is always `@lincoln504/pi-research` on npm. The `pi-research` (unscoped) package is unrelated and deprecated.
|
|
98
|
+
|
|
99
|
+
### Versioning
|
|
100
|
+
|
|
101
|
+
pi-research typically follows the latest pi version and is not actively backwards compatible.
|
|
@@ -43,13 +43,14 @@ model/key is missing.
|
|
|
43
43
|
model (`PI_RESEARCH_MODEL`) + API key. See [`references/configuration.md`](references/configuration.md).
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
npm install -g @lincoln504/pi-research
|
|
46
|
+
npm install -g @lincoln504/pi-research
|
|
47
47
|
node "<skill_dir>/scripts/run.mjs" status # verify detection
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
On npm
|
|
51
|
-
|
|
52
|
-
|
|
50
|
+
On npm ≥11.19 (and npm 12) dependency install scripts are skipped by default — and
|
|
51
|
+
none are needed: better-sqlite3 13 ships prebuilt bindings in its own tarball, and
|
|
52
|
+
the stealth browser self-provisions on its first use (the first scrape takes a few
|
|
53
|
+
minutes). No approval is required.
|
|
53
54
|
|
|
54
55
|
### Install the skill
|
|
55
56
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: pi-research
|
|
3
3
|
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."
|
|
4
4
|
license: MIT
|
|
5
|
-
metadata: { "author": "Lincoln Deen", "version": "1.6.
|
|
5
|
+
metadata: { "author": "Lincoln Deen", "version": "1.6.6", "package": "@lincoln504/pi-research", "engine": "pi-research-sdk", "openclaw": { "requires": { "bins": ["node"] } } }
|
|
6
6
|
allowed-tools: Bash(node:*)
|
|
7
7
|
---
|
|
8
8
|
|