@mammothb/pi-webfetch 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 mammothb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# pi-webfetch
+
+A [pi](https://pi.dev) extension that adds a `webfetch` tool for fetching and converting web content.
+
+## Usage
+
+Once installed, the LLM can call the `webfetch` tool to fetch content from URLs and convert it to markdown, text, or html.
+
+## Development
+
+```bash
+# Test locally
+pi -e ./extensions/index.ts
+```

package/biome.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.14/schema.json",
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "files": {
+    "includes": [
+      "**",
+      "!dist",
+      "!coverage",
+      "!packages/*/dist",
+      "!packages/*/coverage",
+      "!node_modules",
+      "!forks/wreq-js"
+    ]
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always"
+    }
+  },
+  "json": {
+    "formatter": {
+      "indentStyle": "space"
+    }
+  }
+}

package/index.ts

@@ -0,0 +1,35 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+
+export default function (pi: ExtensionAPI) {
+  pi.registerTool({
+    name: "webfetch",
+    label: "Web Fetch",
+    description:
+      "Fetches content from a specified URL and converts it to the requested format (markdown by default).",
+    parameters: Type.Object({
+      url: Type.String({ description: "The URL to fetch content from" }),
+      format: Type.Optional(
+        Type.String({
+          description:
+            "The format to return the content in - text, markdown, or html (default: 'markdown')",
+        }),
+      ),
+    }),
+    async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+      const url = params.url;
+      const format = params.format ?? "markdown";
+
+      // TODO: implement actual fetch + conversion
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Fetched ${url} as ${format} (placeholder).`,
+          },
+        ],
+        details: { url, format },
+      };
+    },
+  });
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@mammothb/pi-webfetch",
+  "version": "0.1.0",
+  "description": "A pi extension that adds a webfetch tool for fetching and converting web content",
+  "keywords": [
+    "pi-package"
+  ],
+  "license": "MIT",
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-ai": "*",
+    "typebox": "*"
+  }
+}