pi-web-kit 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -6,6 +6,23 @@ This project follows the spirit of [Keep a Changelog](https://keepachangelog.com
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-06-06
+
+### Changed
+
+- Extract install telemetry to separate `src/install-telemetry.ts` module for consistency with monorepo guidelines.
+- Add root `index.ts` re-export and fix `pi.extensions` path to `./index.ts`.
+- Update `peerDependencies` to use `*` for Pi core packages.
+- Add Pi core packages to `devDependencies` for type checking.
+- Update `author` field to full name.
+
+## [0.1.5] - 2026-05-20
+
+### Changed
+
+- Moved package source to the `jvm/pi-mono` monorepo.
+- Updated npm metadata to point at the monorepo package directory.
+
 ## [0.1.4] - 2026-05-10
 
 ### Fixed

package/CONTRIBUTING.md

@@ -19,14 +19,14 @@ Install this checkout into a temporary Pi project:
 ```bash
 mkdir -p <test-project>
 cd <test-project>
-pi install -l /path/to/pi-web-kit
+pi install -l /path/to/pi-mono/packages/pi-web-kit
 pi
 ```
 
 For a one-off run without changing settings:
 
 ```bash
-pi -e /path/to/pi-web-kit --web-provider-fetch markdown_new --print "Fetch https://example.com"
+pi -e /path/to/pi-mono/packages/pi-web-kit --web-provider-fetch markdown_new --print "Fetch https://example.com"
 ```
 
 ## Pull request checklist

package/README.md

@@ -1,6 +1,6 @@
 # pi-web-kit
 
-Context-efficient web search and fetch tools for [Pi](https://github.com/badlogic/pi-mono): `web_search` and `web_fetch`.
+Context-efficient web search and fetch tools for [Pi](https://pi.dev): `web_search` and `web_fetch`.
 
 `pi-web-kit` provides provider-backed search and page fetching with bounded output, chunked reads, URL validation, and an in-memory fetch cache designed for agent workflows.
 
@@ -22,28 +22,22 @@ Install from npm:
 pi install npm:pi-web-kit
 ```
 
-Install from GitHub:
-
-```bash
-pi install git:github.com/jvm/pi-web-kit
-```
-
 Install project-locally with Pi's `-l` flag:
 
 ```bash
-pi install -l git:github.com/jvm/pi-web-kit
+pi install -l npm:pi-web-kit
 ```
 
-During local development from this repository:
+During local development from this monorepo:
 
 ```bash
-pi install /path/to/pi-web-kit
+pi install /path/to/pi-mono/packages/pi-web-kit
 ```
 
 For a one-off test run without installing:
 
 ```bash
-pi -e /path/to/pi-web-kit --web-provider-fetch markdown_new --print "Fetch https://example.com"
+pi -e /path/to/pi-mono/packages/pi-web-kit --web-provider-fetch markdown_new --print "Fetch https://example.com"
 ```
 
 This is an npm-compatible TypeScript Pi package. Bun is not required.

package/extensions/index.ts

@@ -1,6 +1,3 @@
-import { readFileSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
 import { type ExtensionAPI, getAgentDir } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
@@ -12,12 +9,7 @@ import { createFetchProvider, createSearchProvider } from "../src/providers/inde
 import { mapFetchResults } from "../src/providers/fallback.js";
 import type { FetchProviderName, SearchProviderName, WebFetchResult } from "../src/types.js";
 import { canonicalWebUrl, normalizeUrlInput } from "../src/urls.js";
-
-const PACKAGE_NAME = "pi-web-kit";
-const INSTALL_TELEMETRY_URL = "https://mocito.dev/api/report-install";
-const INSTALL_TELEMETRY_TIMEOUT_MS = 5000;
-
-type InstallTelemetryState = { lastReportedVersion?: string };
+import { reportInstallTelemetry } from "../src/install-telemetry.js";
 
 export default function (pi: ExtensionAPI) {
   void reportInstallTelemetry();
@@ -168,64 +160,6 @@ function buildFetchDescription(provider: FetchProviderName): string {
   return `Fetch URL content with startup provider '${provider}'. Results are cached by URL/options; use offset/limit to read long pages in chunks. Restart/reload pi after provider changes.`;
 }
 
-function readJsonFile(path: string): unknown {
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-function isTruthyEnvFlag(value: string | undefined): boolean {
-  if (!value) return false;
-  return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
-}
-
-function isInstallTelemetryEnabled(): boolean {
-  if (isTruthyEnvFlag(process.env.PI_OFFLINE)) return false;
-  if (isTruthyEnvFlag(process.env.CI) || isTruthyEnvFlag(process.env.GITHUB_ACTIONS)) return false;
-  if (process.env.PI_TELEMETRY !== undefined) return isTruthyEnvFlag(process.env.PI_TELEMETRY);
-  const settings = readJsonFile(join(getAgentDir(), "settings.json")) as { enableInstallTelemetry?: unknown };
-  return settings.enableInstallTelemetry !== false;
-}
-
-function getPackageVersion(): string {
-  try {
-    const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")) as { version?: unknown };
-    return typeof packageJson.version === "string" && packageJson.version.length > 0 ? packageJson.version : "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
-}
-
-function getInstallTelemetryUserAgent(version: string): string {
-  const runtimeVersions = process.versions as NodeJS.ProcessVersions & { bun?: string };
-  const runtime = runtimeVersions.bun ? `bun/${runtimeVersions.bun}` : `node/${process.version}`;
-  return `${PACKAGE_NAME}/${version} (${process.platform}; ${runtime}; ${process.arch})`;
-}
-
-export async function reportInstallTelemetry(): Promise<void> {
-  try {
-    if (!isInstallTelemetryEnabled()) return;
-
-    const version = getPackageVersion();
-    const telemetryDir = join(getAgentDir(), "extensions");
-    const statePath = join(telemetryDir, "pi-web-kit-install.json");
-    const state = readJsonFile(statePath) as InstallTelemetryState;
-    if (state.lastReportedVersion === version) return;
-
-    await mkdir(telemetryDir, { recursive: true });
-    await writeFile(statePath, `${JSON.stringify({ lastReportedVersion: version }, null, 2)}\n`);
-
-    const params = new URLSearchParams({ tool: PACKAGE_NAME, version });
-    await fetch(`${INSTALL_TELEMETRY_URL}?${params.toString()}`, {
-      headers: { "User-Agent": getInstallTelemetryUserAgent(version) },
-      signal: AbortSignal.timeout(INSTALL_TELEMETRY_TIMEOUT_MS),
-    });
-  } catch {
-    // Best-effort install telemetry: ignore settings, filesystem, and network failures.
-  }
-}
 
 function normalizeQueries(params: Record<string, any>): string[] {
   const raw = Array.isArray(params.queries) ? params.queries : params.query ? [params.query] : [];

package/index.ts

@@ -0,0 +1 @@
+export { default } from "./extensions/index.js";

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "pi-web-kit",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Context-efficient web search and fetch tools for Pi.",
   "type": "module",
   "license": "MIT",
-  "author": "jvm",
+  "author": "Jose Mocito",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jvm/pi-web-kit.git"
+    "url": "git+https://github.com/jvm/pi-mono.git",
+    "directory": "packages/pi-web-kit"
   },
   "bugs": {
-    "url": "https://github.com/jvm/pi-web-kit/issues"
+    "url": "https://github.com/jvm/pi-mono/issues"
   },
-  "homepage": "https://github.com/jvm/pi-web-kit#readme",
+  "homepage": "https://github.com/jvm/pi-mono/tree/main/packages/pi-web-kit#readme",
   "keywords": [
     "pi-package",
     "pi-extension",
@@ -27,10 +28,11 @@
   },
   "pi": {
     "extensions": [
-      "./extensions/index.ts"
+      "./index.ts"
     ]
   },
   "files": [
+    "index.ts",
     "extensions",
     "src",
     "README.md",
@@ -53,8 +55,12 @@
     "typebox": "*"
   },
   "devDependencies": {
+    "@earendil-works/pi-ai": "^0.75.4",
+    "@earendil-works/pi-coding-agent": "^0.75.4",
+    "@earendil-works/pi-tui": "^0.75.4",
     "@types/node": "^25.6.2",
     "tsx": "^4.21.0",
+    "typebox": "^1.1.33",
     "typescript": "^6.0.3"
   },
   "publishConfig": {

package/src/install-telemetry.ts

@@ -0,0 +1,69 @@
+import { readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+
+const PACKAGE_NAME = "pi-web-kit";
+const INSTALL_TELEMETRY_URL = "https://mocito.dev/api/report-install";
+const INSTALL_TELEMETRY_TIMEOUT_MS = 5000;
+
+type InstallTelemetryState = { lastReportedVersion?: string };
+
+function readJsonFile(path: string): unknown {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+function isTruthyEnvFlag(value: string | undefined): boolean {
+  if (!value) return false;
+  return value === "1" || value.toLowerCase() === "true" || value.toLowerCase() === "yes";
+}
+
+function isInstallTelemetryEnabled(): boolean {
+  if (isTruthyEnvFlag(process.env.PI_OFFLINE)) return false;
+  if (isTruthyEnvFlag(process.env.CI) || isTruthyEnvFlag(process.env.GITHUB_ACTIONS)) return false;
+  if (process.env.PI_TELEMETRY !== undefined) return isTruthyEnvFlag(process.env.PI_TELEMETRY);
+  const settings = readJsonFile(join(getAgentDir(), "settings.json")) as { enableInstallTelemetry?: unknown };
+  return settings.enableInstallTelemetry !== false;
+}
+
+function getPackageVersion(): string {
+  try {
+    const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")) as { version?: unknown };
+    return typeof packageJson.version === "string" && packageJson.version.length > 0 ? packageJson.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
+function getInstallTelemetryUserAgent(version: string): string {
+  const runtimeVersions = process.versions as NodeJS.ProcessVersions & { bun?: string };
+  const runtime = runtimeVersions.bun ? `bun/${runtimeVersions.bun}` : `node/${process.version}`;
+  return `${PACKAGE_NAME}/${version} (${process.platform}; ${runtime}; ${process.arch})`;
+}
+
+export async function reportInstallTelemetry(): Promise<void> {
+  try {
+    if (!isInstallTelemetryEnabled()) return;
+
+    const version = getPackageVersion();
+    const telemetryDir = join(getAgentDir(), "extensions");
+    const statePath = join(telemetryDir, "pi-web-kit-install.json");
+    const state = readJsonFile(statePath) as InstallTelemetryState;
+    if (state.lastReportedVersion === version) return;
+
+    await mkdir(telemetryDir, { recursive: true });
+    await writeFile(statePath, `${JSON.stringify({ lastReportedVersion: version }, null, 2)}\n`);
+
+    const params = new URLSearchParams({ tool: PACKAGE_NAME, version });
+    await fetch(`${INSTALL_TELEMETRY_URL}?${params.toString()}`, {
+      headers: { "User-Agent": getInstallTelemetryUserAgent(version) },
+      signal: AbortSignal.timeout(INSTALL_TELEMETRY_TIMEOUT_MS),
+    });
+  } catch {
+    // Best-effort install telemetry: ignore settings, filesystem, and network failures.
+  }
+}