@phi-code-admin/phi-code 0.56.3

package/extensions/phi/web-search.ts

@@ -0,0 +1,284 @@
+/**
+ * Web Search Extension - Internet search capabilities for Phi Code
+ *
+ * Provides web search functionality with fallback options:
+ * 1. Brave Search API (if BRAVE_API_KEY environment variable is set)
+ * 2. DuckDuckGo HTML scraping fallback
+ *
+ * Features:
+ * - web_search tool for LLM use
+ * - Configurable result count
+ * - Clean result formatting with titles, URLs, and descriptions
+ * - Automatic fallback when API is unavailable
+ *
+ * Usage:
+ * 1. Copy to packages/coding-agent/extensions/phi/web-search.ts
+ * 2. Optionally set BRAVE_API_KEY environment variable
+ * 3. Use web_search tool in conversations
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "phi-code";
+
+interface SearchResult {
+	title: string;
+	url: string;
+	description: string;
+}
+
+export default function webSearchExtension(pi: ExtensionAPI) {
+	const BRAVE_API_KEY = process.env.BRAVE_API_KEY;
+	const BRAVE_API_URL = "https://api.search.brave.com/res/v1/web/search";
+
+	/**
+	 * Search using Brave Search API
+	 */
+	async function searchBrave(query: string, count: number = 5): Promise<SearchResult[]> {
+		if (!BRAVE_API_KEY) {
+			throw new Error("BRAVE_API_KEY environment variable not set");
+		}
+
+		const params = new URLSearchParams({
+			q: query,
+			count: count.toString(),
+			offset: "0",
+			mkt: "en-US",
+			safesearch: "moderate",
+			freshness: "pw", // Past week preference
+			text_decorations: "false",
+			spellcheck: "true"
+		});
+
+		const response = await fetch(`${BRAVE_API_URL}?${params}`, {
+			method: "GET",
+			headers: {
+				"Accept": "application/json",
+				"Accept-Encoding": "gzip",
+				"X-Subscription-Token": BRAVE_API_KEY
+			}
+		});
+
+		if (!response.ok) {
+			throw new Error(`Brave API error: ${response.status} ${response.statusText}`);
+		}
+
+		const data = await response.json();
+		
+		if (!data.web?.results) {
+			return [];
+		}
+
+		return data.web.results.map((result: any): SearchResult => ({
+			title: result.title || "No title",
+			url: result.url || "",
+			description: result.description || "No description available"
+		}));
+	}
+
+	/**
+	 * Search using DuckDuckGo HTML fallback
+	 */
+	async function searchDuckDuckGo(query: string, count: number = 5): Promise<SearchResult[]> {
+		try {
+			const encodedQuery = encodeURIComponent(query);
+			const url = `https://html.duckduckgo.com/html/?q=${encodedQuery}`;
+
+			const response = await fetch(url, {
+				method: "GET",
+				headers: {
+					"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
+				}
+			});
+
+			if (!response.ok) {
+				throw new Error(`DuckDuckGo error: ${response.status} ${response.statusText}`);
+			}
+
+			const html = await response.text();
+			
+			// Parse HTML to extract search results
+			const results: SearchResult[] = [];
+			
+			// Basic regex parsing for DuckDuckGo results
+			// This is fragile but works for basic cases
+			const resultPattern = /<a[^>]*class="result__a"[^>]*href="([^"]*)"[^>]*>([^<]*)<\/a>/g;
+			const snippetPattern = /<a[^>]*class="result__snippet"[^>]*>([^<]*)<\/a>/g;
+
+			let match;
+			const urls: string[] = [];
+			const titles: string[] = [];
+
+			// Extract titles and URLs
+			while ((match = resultPattern.exec(html)) !== null && titles.length < count) {
+				const url = match[1];
+				const title = match[2];
+				
+				if (url && title && !url.startsWith('/')) {
+					urls.push(url);
+					titles.push(title.trim());
+				}
+			}
+
+			// Extract snippets (descriptions)
+			const descriptions: string[] = [];
+			while ((match = snippetPattern.exec(html)) !== null && descriptions.length < titles.length) {
+				descriptions.push(match[1].trim());
+			}
+
+			// Combine results
+			for (let i = 0; i < Math.min(titles.length, count); i++) {
+				results.push({
+					title: titles[i] || "No title",
+					url: urls[i] || "",
+					description: descriptions[i] || "No description available"
+				});
+			}
+
+			return results;
+
+		} catch (error) {
+			console.warn("DuckDuckGo fallback failed:", error);
+			return [];
+		}
+	}
+
+	/**
+	 * Perform web search with automatic fallback
+	 */
+	async function performSearch(query: string, count: number = 5): Promise<SearchResult[]> {
+		// Try Brave first if API key is available
+		if (BRAVE_API_KEY) {
+			try {
+				const results = await searchBrave(query, count);
+				if (results.length > 0) {
+					return results;
+				}
+			} catch (error) {
+				console.warn("Brave Search failed, falling back to DuckDuckGo:", error);
+			}
+		}
+
+		// Fallback to DuckDuckGo
+		return await searchDuckDuckGo(query, count);
+	}
+
+	/**
+	 * Web search tool
+	 */
+	pi.registerTool({
+		name: "web_search",
+		label: "Web Search",
+		description: "Search the web for information using Brave Search API or DuckDuckGo fallback",
+		parameters: Type.Object({
+			query: Type.String({ 
+				description: "Search query to find information about" 
+			}),
+			count: Type.Optional(Type.Number({ 
+				description: "Number of results to return (1-10, default: 5)",
+				minimum: 1,
+				maximum: 10 
+			})),
+		}),
+
+		async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+			const { query, count = 5 } = params as { query: string; count?: number };
+
+			try {
+				const results = await performSearch(query, count);
+
+				if (results.length === 0) {
+					return {
+						content: [{ 
+							type: "text", 
+							text: `No search results found for "${query}". Try rephrasing your search or checking your internet connection.` 
+						}],
+						details: { found: false, query, resultCount: 0 }
+					};
+				}
+
+				// Format results
+				let resultText = `**Web Search Results for "${query}":**\n\n`;
+
+				results.forEach((result, index) => {
+					resultText += `**${index + 1}. ${result.title}**\n`;
+					resultText += `🔗 ${result.url}\n`;
+					resultText += `📄 ${result.description}\n\n`;
+				});
+
+				// Add search method info
+				const method = BRAVE_API_KEY ? "Brave Search API" : "DuckDuckGo";
+				resultText += `\n*Results provided by ${method}*`;
+
+				return {
+					content: [{ type: "text", text: resultText }],
+					details: { 
+						found: true, 
+						query, 
+						resultCount: results.length,
+						method,
+						results: results.map(r => ({ title: r.title, url: r.url }))
+					}
+				};
+
+			} catch (error) {
+				return {
+					content: [{ 
+						type: "text", 
+						text: `Web search failed: ${error}. Please check your internet connection and try again.` 
+					}],
+					details: { error: String(error), found: false, query }
+				};
+			}
+		},
+	});
+
+	/**
+	 * /search command - Quick web search from chat
+	 */
+	pi.registerCommand("search", {
+		description: "Perform a web search (usage: /search <query>)",
+		handler: async (args, ctx) => {
+			const query = args.trim();
+
+			if (!query) {
+				ctx.ui.notify("Usage: /search <search query>", "warning");
+				return;
+			}
+
+			try {
+				ctx.ui.notify(`🔍 Searching for: "${query}"...`, "info");
+				
+				const results = await performSearch(query, 3); // Fewer results for command
+
+				if (results.length === 0) {
+					ctx.ui.notify("No results found. Try different keywords.", "warning");
+					return;
+				}
+
+				let message = `🔍 **Search Results for "${query}":**\n\n`;
+
+				results.forEach((result, index) => {
+					message += `**${index + 1}. ${result.title}**\n`;
+					message += `${result.url}\n`;
+					message += `${result.description.slice(0, 100)}...\n\n`;
+				});
+
+				const method = BRAVE_API_KEY ? "Brave Search" : "DuckDuckGo";
+				message += `*Powered by ${method}*`;
+
+				ctx.ui.notify(message, "info");
+
+			} catch (error) {
+				ctx.ui.notify(`Search failed: ${error}`, "error");
+			}
+		},
+	});
+
+	/**
+	 * Show search configuration on session start
+	 */
+	pi.on("session_start", async (_event, ctx) => {
+		const method = BRAVE_API_KEY ? "Brave Search API" : "DuckDuckGo (fallback)";
+		ctx.ui.notify(`🌐 Web search enabled (${method})`, "info");
+	});
+}

package/package.json

@@ -0,0 +1,101 @@
+{
+	"name": "@phi-code-admin/phi-code",
+	"version": "0.56.3",
+	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
+	"type": "module",
+	"piConfig": {
+		"name": "phi",
+		"configDir": ".phi"
+	},
+	"bin": {
+		"phi": "dist/cli.js"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./hooks": {
+			"types": "./dist/core/hooks/index.d.ts",
+			"import": "./dist/core/hooks/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"extensions",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"dev": "tsgo -p tsconfig.build.json --watch --preserveWatchOutput",
+		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/cli.js && npm run copy-assets",
+		"build:binary": "npm --prefix ../tui run build && npm --prefix ../ai run build && npm --prefix ../agent run build && npm run build && bun build --compile ./dist/cli.js --outfile dist/pi && npm run copy-binary-assets",
+		"copy-assets": "shx mkdir -p dist/modes/interactive/theme && shx cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && shx mkdir -p dist/core/export-html/vendor && shx cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && shx cp src/core/export-html/vendor/*.js dist/core/export-html/vendor/",
+		"copy-binary-assets": "shx cp package.json dist/ && shx cp README.md dist/ && shx cp CHANGELOG.md dist/ && shx mkdir -p dist/theme && shx cp src/modes/interactive/theme/*.json dist/theme/ && shx mkdir -p dist/export-html/vendor && shx cp src/core/export-html/template.html dist/export-html/ && shx cp src/core/export-html/vendor/*.js dist/export-html/vendor/ && shx cp -r docs dist/ && shx cp -r examples dist/ && shx cp ../../node_modules/@silvia-odwyer/photon-node/photon_rs_bg.wasm dist/",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"dependencies": {
+		"@mariozechner/jiti": "^2.6.2",
+		"phi-code-agent": "^0.56.3",
+		"phi-code-ai": "^0.56.3",
+		"phi-code-tui": "^0.56.3",
+		"sigma-memory": "file:../sigma-memory",
+		"@silvia-odwyer/photon-node": "^0.3.4",
+		"chalk": "^5.5.0",
+		"cli-highlight": "^2.1.11",
+		"diff": "^8.0.2",
+		"extract-zip": "^2.0.1",
+		"file-type": "^21.1.1",
+		"glob": "^13.0.1",
+		"hosted-git-info": "^9.0.2",
+		"ignore": "^7.0.5",
+		"marked": "^15.0.12",
+		"minimatch": "^10.2.3",
+		"proper-lockfile": "^4.1.2",
+		"strip-ansi": "^7.1.0",
+		"undici": "^7.19.1",
+		"yaml": "^2.8.2"
+	},
+	"overrides": {
+		"rimraf": "6.1.2",
+		"gaxios": {
+			"rimraf": "6.1.2"
+		}
+	},
+	"optionalDependencies": {
+		"@mariozechner/clipboard": "^0.3.2"
+	},
+	"devDependencies": {
+		"@types/diff": "^7.0.2",
+		"@types/hosted-git-info": "^3.0.5",
+		"@types/ms": "^2.1.0",
+		"@types/node": "^24.3.0",
+		"@types/proper-lockfile": "^4.1.4",
+		"shx": "^0.4.0",
+		"typescript": "^5.7.3",
+		"vitest": "^3.2.4"
+	},
+	"keywords": [
+		"ai",
+		"coding-agent",
+		"cli",
+		"typescript",
+		"sub-agents",
+		"memory"
+	],
+	"author": "Mario Zechner",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/uglyswap/phi-code.git"
+	},
+	"homepage": "https://github.com/uglyswap/phi-code",
+	"engines": {
+		"node": ">=20.6.0"
+	}
+}