@bohvaa/pi-web-tools 0.0.0-stage → 1.0.0

package/index.ts

@@ -0,0 +1,59 @@
+import { getAgentDir, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import Conf from "conf";
+import { Type } from "typebox";
+
+import { providers } from "./providers.ts";
+
+const result = (data: unknown) => ({ content: [{ type: "text" as const, text: JSON.stringify(data) }], details: {} });
+
+export default function (pi: ExtensionAPI) {
+  const config = new Conf<{ provider: string; apiKeys: Record<string, string> }>({
+    cwd: getAgentDir(),
+    configName: "web-tools",
+    configFileMode: 0o600,
+  });
+
+  const client = () => {
+    const provider = config.get("provider");
+    const apiKey = config.get("apiKeys")?.[provider];
+    if (!provider || !apiKey) throw new Error("Please run /web-tools to configure a provider and API key first.");
+
+    return providers[provider](apiKey);
+  };
+
+  pi.registerCommand("web-tools", {
+    description: "Select and configure the web API provider.",
+
+    async handler(_args, ctx) {
+      const provider = await ctx.ui.select("web API provider", Object.keys(providers));
+      if (provider === undefined) return;
+
+      const apiKey = await ctx.ui.input(`${provider} API key`);
+      if (apiKey === undefined) return;
+
+      config.set({ provider, apiKeys: { ...config.get("apiKeys"), [provider]: apiKey } });
+    },
+  });
+
+  pi.registerTool({
+    name: "web_search",
+    label: "web search",
+    description: "Search the web for information. Returns result titles, URLs, and content snippets.",
+    parameters: Type.Object({ query: Type.String({ description: "search query" }) }),
+
+    async execute(_id, { query }) {
+      return result(await client().search(query));
+    },
+  });
+
+  pi.registerTool({
+    name: "web_fetch",
+    label: "web fetch",
+    description: "Fetch the content of a web page. Returns the page URL and extracted Markdown content.",
+    parameters: Type.Object({ url: Type.String({ description: "web page URL to fetch" }) }),
+
+    async execute(_id, { url }) {
+      return result(await client().fetch(url));
+    },
+  });
+}

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@bohvaa/pi-web-tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bohvaa/pi-web-tools.git"
+  },
+  "keywords": [
+    "pi-package"
+  ],
+  "type": "module",
+  "files": [
+    "index.ts",
+    "providers.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "dependencies": {
+    "@tavily/core": "^1.0.0",
+    "conf": "^16.0.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
+    "prettier": "^3.9.10"
+  }
+}

package/providers.ts

@@ -0,0 +1,14 @@
+import { tavily } from "@tavily/core";
+
+export interface WebProvider {
+  search(query: string): Promise<unknown>;
+  fetch(url: string): Promise<unknown>;
+}
+
+export const providers: Record<string, (apiKey: string) => WebProvider> = {
+  tavily: (apiKey) => {
+    const client = tavily({ apiKey });
+
+    return { search: (query) => client.search(query), fetch: (url) => client.extract([url]) };
+  },
+};

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.