@normful/parallel-web-pi-extension 1.0.0 → 1.1.1

package/README.md

@@ -196,6 +196,24 @@ pi --no-extensions --no-skills -e ./src/index.ts
 
 This changes the browser login endpoints used by `/login parallel`.
 
+### Override The API Base URL
+
+`PARALLEL_BASE_URL` redirects every Parallel API call the tools make — search,
+extract and research all follow it, so they can be pointed at a staging or local
+host together:
+
+```bash
+export PARALLEL_BASE_URL=https://your-api-host
+pi --no-extensions --no-skills -e ./src/index.ts
+```
+
+The value is an **origin**, not a full URL: the `/v1/search`, `/v1/extract` and
+`/v1/responses` paths are appended to it, and a trailing slash is tolerated.
+Unset it to use `https://api.parallel.ai`.
+
+This is separate from `PARALLEL_PLATFORM_URL`, which only affects the OAuth
+login flow (that host is `platform.parallel.ai`, not `api.parallel.ai`).
+
 ## Quick Smoke Test
 
 Once Pi is running with the extension loaded, ask something that should force web usage, for example:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@normful/parallel-web-pi-extension",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Add Parallel web search, fetch, and research tools to your pi agent",
   "author": "Norman Sue",
   "license": "MIT",
@@ -18,11 +18,11 @@
     "README.md"
   ],
   "dependencies": {
-    "parallel-web": "1.3.0",
-    "typebox": "^1.1.37"
+    "parallel-web": "1.3.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=0.83.0"
+    "@earendil-works/pi-coding-agent": ">=0.83.0",
+    "typebox": "*"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": ">=0.83.0",
@@ -32,11 +32,13 @@
     "@vitest/coverage-v8": "^5.0.4",
     "eslint": "^8.54.0",
     "prettier": "^3.1.0",
+    "typebox": "^1.1.37",
     "typescript": "^5.3.2",
     "vitest": "^5.0.4"
   },
   "scripts": {
     "test": "vitest run",
+    "coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",

package/src/parallel-responses.ts

@@ -1,6 +1,28 @@
 import pkg from '../package.json' with { type: 'json' };
 
-export const PARALLEL_RESPONSES_URL = 'https://api.parallel.ai/v1/responses';
+/**
+ * Default API origin used when PARALLEL_BASE_URL is unset. Matches the value
+ * hardcoded into the parallel-web SDK, so a single variable can point every
+ * web tool at the same host.
+ */
+export const PARALLEL_API_ORIGIN = 'https://api.parallel.ai';
+export const PARALLEL_RESPONSES_PATH = '/v1/responses';
+/** Responses endpoint on the default origin. */
+export const PARALLEL_RESPONSES_URL = `${PARALLEL_API_ORIGIN}${PARALLEL_RESPONSES_PATH}`;
+
+/**
+ * Resolve the Responses endpoint, honoring PARALLEL_BASE_URL exactly as the
+ * parallel-web SDK does for web_search and web_fetch. The value is an origin:
+ * the `/v1/...` path is always appended, and a trailing slash is tolerated.
+ */
+export function resolveParallelResponsesUrl(
+  baseUrl: string | undefined = process.env.PARALLEL_BASE_URL
+) {
+  const origin = baseUrl?.trim().replace(/\/+$/, '');
+  return origin
+    ? `${origin}${PARALLEL_RESPONSES_PATH}`
+    : PARALLEL_RESPONSES_URL;
+}
 export const PARALLEL_RESPONSES_MAX_INPUT_CHARS = 20_000;
 export const PARALLEL_RESPONSES_TIMEOUT_MS = 120_000;
 export const DEFAULT_RESEARCH_EFFORT = 'medium';
@@ -217,7 +239,7 @@ export async function runParallelResearch(
   timeout.unref?.();
   try {
     requestSignal.throwIfAborted();
-    const response = await fetch(PARALLEL_RESPONSES_URL, {
+    const response = await fetch(resolveParallelResponsesUrl(), {
       method: 'POST',
       headers: {
         Authorization: `Bearer ${apiKey}`,