@apmantza/greedysearch-pi 1.7.3 → 1.7.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## v1.7.5 (2026-04-10)
+
+### Plugin
+- **Claude Code plugin** — added `.claude-plugin/plugin.json` and `marketplace.json` so GreedySearch can be installed directly as a Claude Code plugin via `claude plugin install`.
+- **Auto-mirror GH Action** — every push to `GreedySearch-pi/master` automatically syncs to `GreedySearch-claude/main`, keeping the Claude plugin up to date.
+- **Tightened `skill.md`** — removed verbose guidance sections; kept parameters, depth table, and coding_task reference. -72 lines.
+
+## v1.7.4 (2026-04-10)
+
+### Refactor
+- **Shared `waitForCopyButton()`** — consolidated duplicate copy-button polling loops from `bing-copilot`, `gemini`, and `coding-task` into a single `waitForCopyButton(tab, selector, { timeout, onPoll })` in `common.mjs`. Gemini's scroll-to-bottom logic passed as `onPoll` callback.
+- **Shared `TIMING` constants** — replaced 30+ scattered `setTimeout` magic numbers with named constants (`postNav`, `postNavSlow`, `postClick`, `postType`, `inputPoll`, `copyPoll`, `afterVerify`) in `common.mjs`.
+- **`waitForStreamComplete` improvements** — added `minLength` option and graceful last-value fallback; `google-ai` now uses the shared implementation instead of its own copy.
+- **Removed dead code** — deleted unused `_getOrReuseBlankTab` and `_getOrOpenEngineTab` from `bin/search.mjs`; removed unused `STREAM_POLL_INTERVAL` and `STREAM_STABLE_ROUNDS` from `coding-task`.
+
+### Fixes
+- **Synthesis tab regression** — `getOrOpenEngineTab("gemini")` call during synthesis was broken by the dead-code removal; replaced with `openNewTab()`.
+
 ## v1.7.3 (2026-04-10)
 
 ### Fixes

package/bin/coding-task.mjs

@@ -12,7 +12,7 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
-import { cdp, injectClipboardInterceptor } from "../extractors/common.mjs";
+import { cdp, injectClipboardInterceptor, waitForCopyButton } from "../extractors/common.mjs";
 import { dismissConsent, handleVerification } from "../extractors/consent.mjs";
 
 const __dir = fileURLToPath(new URL(".", import.meta.url));
@@ -31,9 +31,7 @@ const MODE_PROMPTS = {
 	debug: `You are a senior engineer debugging someone else's code. You have fresh eyes — no prior assumptions about what should work. Given the bug description and relevant code: (1) identify the most likely root cause, being specific about the exact line or condition, (2) explain why it manifests the way it does, (3) suggest the minimal fix, (4) flag any other latent bugs you notice while reading. Do not guess vaguely — reason from the code. If you need information that isn't provided, say exactly what you'd add to narrow it down.`,
 };
 
-const STREAM_POLL_INTERVAL = 800;
-const STREAM_STABLE_ROUNDS = 4;
-const STREAM_TIMEOUT = 120000; // coding tasks take longer
+const STREAM_TIMEOUT = 120000; // coding tasks take longer — passed to waitForCopyButton
 const MIN_RESPONSE_LENGTH = 50;
 
 // ---------------------------------------------------------------------------
@@ -104,17 +102,7 @@ const ENGINES = {
 		},
 
 		async waitForCopyButton(tab) {
-			const deadline = Date.now() + STREAM_TIMEOUT;
-			while (Date.now() < deadline) {
-				await new Promise((r) => setTimeout(r, STREAM_POLL_INTERVAL));
-				const found = await cdp([
-					"eval",
-					tab,
-					`!!document.querySelector('button[aria-label="Copy"]')`,
-				]).catch(() => "false");
-				if (found === "true") return;
-			}
-			throw new Error("Gemini copy button did not appear within timeout");
+			await waitForCopyButton(tab, 'button[aria-label="Copy"]', { timeout: STREAM_TIMEOUT });
 		},
 
 		async extract(tab) {
@@ -162,17 +150,7 @@ const ENGINES = {
 		},
 
 		async waitForCopyButton(tab) {
-			const deadline = Date.now() + STREAM_TIMEOUT;
-			while (Date.now() < deadline) {
-				await new Promise((r) => setTimeout(r, STREAM_POLL_INTERVAL));
-				const found = await cdp([
-					"eval",
-					tab,
-					`!!document.querySelector('button[data-testid="copy-ai-message-button"]')`,
-				]).catch(() => "false");
-				if (found === "true") return;
-			}
-			throw new Error("Copilot copy button did not appear within timeout");
+			await waitForCopyButton(tab, 'button[data-testid="copy-ai-message-button"]', { timeout: STREAM_TIMEOUT });
 		},
 
 		async extract(tab) {

package/bin/search.mjs

@@ -752,27 +752,6 @@ async function getAnyTab() {
 	return first.slice(0, 8);
 }
 
-async function _getOrReuseBlankTab() {
-	// Reuse an existing about:blank tab rather than always creating a new one
-	const listOut = await cdp(["list"]);
-	const lines = listOut.split("\n").filter(Boolean);
-	for (const line of lines) {
-		if (line.includes("about:blank")) {
-			return line.slice(0, 8); // prefix of the blank tab's targetId
-		}
-	}
-	// No blank tab — open a new one
-	const anchor = await getAnyTab();
-	const raw = await cdp([
-		"evalraw",
-		anchor,
-		"Target.createTarget",
-		'{"url":"about:blank"}',
-	]);
-	const { targetId } = JSON.parse(raw);
-	return targetId;
-}
-
 async function openNewTab() {
 	const anchor = await getAnyTab();
 	const raw = await cdp([
@@ -785,11 +764,6 @@ async function openNewTab() {
 	return targetId;
 }
 
-async function _getOrOpenEngineTab(engine) {
-	await cdp(["list"]);
-	return getFullTabFromCache(engine) || openNewTab();
-}
-
 async function activateTab(targetId) {
 	try {
 		const anchor = await getAnyTab();
@@ -1487,7 +1461,7 @@ async function main() {
 					"[greedysearch] Synthesizing results with Gemini...\n",
 				);
 				try {
-					const geminiTab = await getOrOpenEngineTab("gemini");
+					const geminiTab = await openNewTab();
 					await activateTab(geminiTab);
 					const synthesis = await synthesizeWithGemini(query, out, {
 						grounded: depth === "deep",

package/extractors/bing-copilot.mjs

@@ -18,7 +18,9 @@ import {
 	outputJson,
 	parseArgs,
 	parseSourcesFromMarkdown,
+	TIMING,
 	validateQuery,
+	waitForCopyButton,
 } from "./common.mjs";
 import { dismissConsent, handleVerification } from "./consent.mjs";
 import { SELECTORS } from "./selectors.mjs";
@@ -30,20 +32,6 @@ const GLOBAL_VAR = "__bingClipboard";
 // Bing Copilot-specific helpers
 // ============================================================================
 
-async function waitForCopyButton(tab, timeout = 60000) {
-	const deadline = Date.now() + timeout;
-	while (Date.now() < deadline) {
-		await new Promise((r) => setTimeout(r, 700));
-		const found = await cdp([
-			"eval",
-			tab,
-			`!!document.querySelector('${S.copyButton}')`,
-		]).catch(() => "false");
-		if (found === "true") return;
-	}
-	throw new Error(`Copilot copy button did not appear within ${timeout}ms`);
-}
-
 async function extractAnswer(tab) {
 	await cdp([
 		"eval",
@@ -78,7 +66,7 @@ async function main() {
 
 		// Navigate to Copilot homepage and use the chat input
 		await cdp(["nav", tab, "https://copilot.microsoft.com/"], 35000);
-		await new Promise((r) => setTimeout(r, 2000));
+		await new Promise((r) => setTimeout(r, TIMING.postNavSlow));
 		await dismissConsent(tab, cdp);
 
 		// Handle verification challenges (Cloudflare Turnstile, Microsoft auth, etc.)
@@ -91,7 +79,7 @@ async function main() {
 
 		// After verification, page may have redirected or reloaded — wait for it to settle
 		if (verifyResult === "clicked") {
-			await new Promise((r) => setTimeout(r, 3000));
+			await new Promise((r) => setTimeout(r, TIMING.afterVerify));
 
 			// Re-navigate if we got redirected
 			const currentUrl = await cdp([
@@ -101,7 +89,7 @@ async function main() {
 			]).catch(() => "");
 			if (!currentUrl.includes("copilot.microsoft.com")) {
 				await cdp(["nav", tab, "https://copilot.microsoft.com/"], 35000);
-				await new Promise((r) => setTimeout(r, 2000));
+				await new Promise((r) => setTimeout(r, TIMING.postNavSlow));
 				await dismissConsent(tab, cdp);
 			}
 		}
@@ -133,9 +121,9 @@ async function main() {
 
 		await injectClipboardInterceptor(tab, GLOBAL_VAR);
 		await cdp(["click", tab, S.input]);
-		await new Promise((r) => setTimeout(r, 400));
+		await new Promise((r) => setTimeout(r, TIMING.postClick));
 		await cdp(["type", tab, query]);
-		await new Promise((r) => setTimeout(r, 400));
+		await new Promise((r) => setTimeout(r, TIMING.postType));
 
 		// Submit with Enter (most reliable across locales and Chrome instances)
 		await cdp([
@@ -144,7 +132,7 @@ async function main() {
 			`document.querySelector('${S.input}')?.dispatchEvent(new KeyboardEvent('keydown',{key:'Enter',bubbles:true,keyCode:13})), 'ok'`,
 		]);
 
-		await waitForCopyButton(tab);
+		await waitForCopyButton(tab, S.copyButton, { timeout: 60000 });
 
 		const { answer, sources } = await extractAnswer(tab);
 		if (!answer)

package/extractors/common.mjs

@@ -119,6 +119,46 @@ export function parseSourcesFromMarkdown(text) {
 		.slice(0, 10);
 }
 
+// ============================================================================
+// Timing constants
+// ============================================================================
+
+export const TIMING = {
+	postNav: 1500,       // settle after navigation
+	postNavSlow: 2000,   // settle after slower navigations (Bing, Gemini)
+	postClick: 400,      // settle after a UI click
+	postType: 400,       // settle after typing
+	inputPoll: 400,      // polling interval when waiting for input to appear
+	copyPoll: 600,       // polling interval when waiting for copy button
+	afterVerify: 3000,   // settle after a verification challenge completes
+};
+
+// ============================================================================
+// Copy button polling
+// ============================================================================
+
+/**
+ * Wait for a copy button to appear in the DOM.
+ * @param {string} tab - Tab identifier
+ * @param {string} selector - CSS selector for the copy button
+ * @param {object} [options]
+ * @param {number} [options.timeout=60000] - Max wait in ms
+ * @param {Function} [options.onPoll] - Optional async callback on each poll tick (e.g. scroll)
+ * @returns {Promise<void>}
+ */
+export async function waitForCopyButton(tab, selector, options = {}) {
+	const { timeout = 60000, onPoll } = options;
+	const deadline = Date.now() + timeout;
+	let tick = 0;
+	while (Date.now() < deadline) {
+		await new Promise((r) => setTimeout(r, TIMING.copyPoll));
+		if (onPoll) await onPoll(++tick).catch(() => null);
+		const found = await cdp(["eval", tab, `!!document.querySelector('${selector}')`]).catch(() => "false");
+		if (found === "true") return;
+	}
+	throw new Error(`Copy button ('${selector}') did not appear within ${timeout}ms`);
+}
+
 // ============================================================================
 // Stream completion detection
 // ============================================================================
@@ -139,6 +179,7 @@ export async function waitForStreamComplete(tab, options = {}) {
 		interval = 600,
 		stableRounds = 3,
 		selector = "document.body",
+		minLength = 0,
 	} = options;
 
 	const deadline = Date.now() + timeout;
@@ -154,7 +195,7 @@ export async function waitForStreamComplete(tab, options = {}) {
 		]).catch(() => "0");
 		const currentLen = parseInt(lenStr, 10) || 0;
 
-		if (currentLen > 0) {
+		if (currentLen >= minLength) {
 			if (currentLen === lastLen) {
 				stableCount++;
 				if (stableCount >= stableRounds) return currentLen;
@@ -165,6 +206,7 @@ export async function waitForStreamComplete(tab, options = {}) {
 		}
 	}
 
+	if (lastLen >= minLength) return lastLen;
 	throw new Error(`Generation did not stabilise within ${timeout}ms`);
 }
 

package/extractors/gemini.mjs

@@ -18,7 +18,9 @@ import {
 	outputJson,
 	parseArgs,
 	parseSourcesFromMarkdown,
+	TIMING,
 	validateQuery,
+	waitForCopyButton,
 } from "./common.mjs";
 import { dismissConsent, handleVerification } from "./consent.mjs";
 import { SELECTORS } from "./selectors.mjs";
@@ -46,36 +48,15 @@ async function typeIntoGemini(tab, text) {
 	]);
 }
 
-async function waitForCopyButton(tab, timeout = 120000) {
-	const deadline = Date.now() + timeout;
-	let scrollCount = 0;
-	while (Date.now() < deadline) {
-		await new Promise((r) => setTimeout(r, 600));
-
-		// Scroll to bottom every ~6 seconds to trigger lazy loading and ensure copy button appears
-		if (++scrollCount % 10 === 0) {
-			await cdp([
-				"eval",
-				tab,
-				`
-				(function() {
-					const chat = document.querySelector('chat-window, [role="main"], main') || document.body;
-					const scrollHeight = chat.scrollHeight || document.body.scrollHeight || 0;
-					// Scroll to bottom to ensure all content is loaded
-					chat.scrollTo ? chat.scrollTo({ top: scrollHeight, behavior: 'smooth' }) : window.scrollTo(0, scrollHeight);
-				})()
-			`,
-			]).catch(() => null);
-		}
-
-		const found = await cdp([
-			"eval",
-			tab,
-			`!!document.querySelector('${S.copyButton}')`,
-		]).catch(() => "false");
-		if (found === "true") return;
-	}
-	throw new Error(`Gemini copy button did not appear within ${timeout}ms`);
+async function scrollToBottom(tab) {
+	await cdp([
+		"eval",
+		tab,
+		`(function() {
+			const chat = document.querySelector('chat-window, [role="main"], main') || document.body;
+			chat.scrollTo ? chat.scrollTo({ top: chat.scrollHeight, behavior: 'smooth' }) : window.scrollTo(0, document.body.scrollHeight);
+		})()`,
+	]);
 }
 
 async function extractAnswer(tab) {
@@ -111,7 +92,7 @@ async function main() {
 
 		// Each search = fresh conversation
 		await cdp(["nav", tab, "https://gemini.google.com/app"], 35000);
-		await new Promise((r) => setTimeout(r, 2000));
+		await new Promise((r) => setTimeout(r, TIMING.postNavSlow));
 		await dismissConsent(tab, cdp);
 		await handleVerification(tab, cdp, 60000);
 
@@ -124,13 +105,13 @@ async function main() {
 				`!!document.querySelector('${S.input}')`,
 			]).catch(() => "false");
 			if (ready === "true") break;
-			await new Promise((r) => setTimeout(r, 400));
+			await new Promise((r) => setTimeout(r, TIMING.inputPoll));
 		}
-		await new Promise((r) => setTimeout(r, 300));
+		await new Promise((r) => setTimeout(r, TIMING.postClick));
 
 		await injectClipboardInterceptor(tab, GLOBAL_VAR);
 		await typeIntoGemini(tab, query);
-		await new Promise((r) => setTimeout(r, 400));
+		await new Promise((r) => setTimeout(r, TIMING.postType));
 
 		await cdp([
 			"eval",
@@ -138,7 +119,11 @@ async function main() {
 			`document.querySelector('${S.sendButton}')?.click()`,
 		]);
 
-		await waitForCopyButton(tab);
+		// Scroll to bottom every ~6s while waiting to trigger lazy-loaded content
+		await waitForCopyButton(tab, S.copyButton, {
+			timeout: 120000,
+			onPoll: (tick) => tick % 10 === 0 ? scrollToBottom(tab) : Promise.resolve(),
+		});
 
 		const { answer, sources } = await extractAnswer(tab);
 		if (!answer) throw new Error("No answer captured from Gemini clipboard");

package/extractors/google-ai.mjs

@@ -16,53 +16,17 @@ import {
 	handleError,
 	outputJson,
 	parseArgs,
+	TIMING,
 	validateQuery,
+	waitForStreamComplete,
 } from "./common.mjs";
 import { dismissConsent, handleVerification } from "./consent.mjs";
 import { SELECTORS } from "./selectors.mjs";
 
 const S = SELECTORS.google;
 
-const STREAM_POLL_INTERVAL = 600;
-const STREAM_STABLE_ROUNDS = 3;
-const STREAM_TIMEOUT = 45000;
 const MIN_ANSWER_LENGTH = 50;
 
-// ============================================================================
-// Google AI-specific helpers
-// ============================================================================
-
-async function waitForGoogleStreamComplete(tab) {
-	const deadline = Date.now() + STREAM_TIMEOUT;
-	let stableCount = 0;
-	let lastLen = -1;
-
-	while (Date.now() < deadline) {
-		await new Promise((r) => setTimeout(r, STREAM_POLL_INTERVAL));
-
-		const lenStr = await cdp([
-			"eval",
-			tab,
-			`(document.querySelector('${S.answerContainer}')?.innerText?.length || 0) + ''`,
-		]).catch(() => "0");
-
-		const len = parseInt(lenStr, 10) || 0;
-
-		if (len >= MIN_ANSWER_LENGTH && len === lastLen) {
-			stableCount++;
-			if (stableCount >= STREAM_STABLE_ROUNDS) return len;
-		} else {
-			stableCount = 0;
-			lastLen = len;
-		}
-	}
-
-	if (lastLen >= MIN_ANSWER_LENGTH) return lastLen;
-	throw new Error(
-		`Google AI answer did not stabilise within ${STREAM_TIMEOUT}ms`,
-	);
-}
-
 async function extractAnswer(tab) {
 	const excludeFilter = S.sourceExclude
 		.map((e) => `!a.href.includes('${e}')`)
@@ -107,7 +71,7 @@ async function main() {
 
 		const url = `https://www.google.com/search?q=${encodeURIComponent(query)}&udm=50&hl=en`;
 		await cdp(["nav", tab, url], 35000);
-		await new Promise((r) => setTimeout(r, 1500));
+		await new Promise((r) => setTimeout(r, TIMING.postNav));
 		await dismissConsent(tab, cdp);
 
 		// If consent redirected us away, navigate back
@@ -116,7 +80,7 @@ async function main() {
 		);
 		if (!currentUrl.includes("google.com/search")) {
 			await cdp(["nav", tab, url], 35000);
-			await new Promise((r) => setTimeout(r, 1500));
+			await new Promise((r) => setTimeout(r, TIMING.postNav));
 		}
 
 		// Handle "verify you're human" — auto-click simple buttons, wait for user on hard CAPTCHA
@@ -128,10 +92,14 @@ async function main() {
 		if (verifyResult === "clicked" || verifyResult === "cleared-by-user") {
 			// Re-navigate to the search URL after verification
 			await cdp(["nav", tab, url], 35000);
-			await new Promise((r) => setTimeout(r, 1500));
+			await new Promise((r) => setTimeout(r, TIMING.postNav));
 		}
 
-		await waitForGoogleStreamComplete(tab);
+		await waitForStreamComplete(tab, {
+			timeout: 45000,
+			selector: `document.querySelector('${S.answerContainer}')`,
+			minLength: MIN_ANSWER_LENGTH,
+		});
 
 		const { answer, sources } = await extractAnswer(tab);
 		if (!answer)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@apmantza/greedysearch-pi",
-	"version": "1.7.3",
+	"version": "1.7.5",
 	"description": "Pi extension: multi-engine AI search (Perplexity, Bing Copilot, Google AI) via browser automation -- NO API KEYS needed. Extracts answers with sources, optional Gemini synthesis. Grounded AI answers from real browser interactions.",
 	"type": "module",
 	"keywords": [

package/skills/greedy-search/skill.md

@@ -0,0 +1,44 @@
+---
+name: greedy-search
+description: Live web search via Perplexity, Bing, and Google AI in parallel. Use for library docs, recent framework changes, error messages, dependency selection, or anything where training data may be stale. NOT for codebase search.
+---
+
+# GreedySearch — Live Web Search
+
+Runs Perplexity, Bing Copilot, and Google AI in parallel. Gemini synthesizes results.
+
+## greedy_search
+
+```
+greedy_search({ query: "React 19 changes", depth: "standard" })
+```
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `query` | string | required | Search question |
+| `engine` | string | `"all"` | `all`, `perplexity`, `bing`, `google`, `gemini` |
+| `depth` | string | `"standard"` | `fast`, `standard`, `deep` |
+| `fullAnswer` | boolean | `false` | Full answer vs ~300 char summary |
+
+| Depth | Engines | Synthesis | Source Fetch | Time |
+|-------|---------|-----------|--------------|------|
+| `fast` | 1 | — | — | 15-30s |
+| `standard` | 3 | Gemini | — | 30-90s |
+| `deep` | 3 | Gemini | top 5 | 60-180s |
+
+**When engines agree** → high confidence. **When they diverge** → note both perspectives.
+
+## coding_task
+
+Second opinion from Gemini/Copilot on hard problems.
+
+```
+coding_task({ task: "debug race condition", mode: "debug", engine: "gemini" })
+```
+
+| Parameter | Type | Default | Options |
+|-----------|------|---------|---------|
+| `task` | string | required | — |
+| `engine` | string | `"gemini"` | `gemini`, `copilot`, `all` |
+| `mode` | string | `"code"` | `debug`, `plan`, `review`, `test`, `code` |
+| `context` | string | — | Code snippet |

package/skills/greedy-search/SKILL.md

@@ -1,117 +0,0 @@
----
-name: greedy-search
-description: Multi-engine AI **WEB SEARCH** tool — NOT for codebase search. Use greedy_search for high-quality web research where training data may be stale or single-engine results are insufficient. Searches Perplexity, Bing, Google via browser automation. NO API KEYS needed.
----
-
-# ⚠️ WEB SEARCH ONLY — NOT CODEBASE SEARCH
-
-**`greedy_search` searches the live web**, not your local codebase.
-
-| Tool | Searches |
-|------|----------|
-| `greedy_search` | **Live web** (Perplexity, Bing, Google) |
-| `ast_grep_search` | **Local codebase** — use this for code patterns |
-| `bash` with `grep/rg` | **Local codebase** — use this for text search |
-
-**DO NOT use `greedy_search` for:**
-- Finding functions in your codebase
-- Searching local files
-- Code review of your project
-- Understanding project structure
-
-**DO use `greedy_search` for:**
-- Library documentation
-- Recent framework changes
-- Error message explanations
-- Best practices research
-- Current events/news
-
-# GreedySearch Tools
-
-| Tool | Speed | Use For |
-|------|-------|---------|
-| `greedy_search` | 15-180s | Multi-engine search with depth levels |
-| `coding_task` | 60-180s | Debug, review, plan modes for hard problems |
-
-## greedy_search
-
-Multi-engine AI search (Perplexity, Bing, Google) with three depth levels.
-
-```greedy_search({ query: "React 19 changes", depth: "standard" })```
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `query` | string | required | Search question |
-| `engine` | string | `"all"` | `all`, `perplexity`, `bing`, `google`, `gemini` |
-| `depth` | string | `"standard"` | `fast`, `standard`, `deep` — see below |
-| `fullAnswer` | boolean | `false` | Complete vs ~300 char summary |
-
-### Depth Levels
-
-| Depth | Engines | Synthesis | Source Fetch | Time | Use When |
-|-------|---------|-----------|--------------|------|----------|
-| `fast` | 1 | ❌ | ❌ | 15-30s | Quick lookup, single perspective |
-| `standard` | 3 | ✅ | ❌ | 30-90s | Default — balanced speed/quality |
-| `deep` | 3 | ✅ | ✅ (top 5) | 60-180s | Research that matters — architecture decisions |
-
-**Standard** (default): Runs 3 engines, deduplicates sources, synthesizes via Gemini.  
-**Deep**: Same + fetches content from top sources for grounded synthesis + confidence scores.
-
-### Engine Selection (for fast mode)
-
-```greedy_search({ query: "...", engine: "perplexity", depth: "fast" })```
-
-- `perplexity`: Technical Q&A, citations
-- `bing`: Recent news, Microsoft ecosystem
-- `google`: Broad coverage
-- `gemini`: Different training data
-
-### Examples — Web Research Only
-
-**✅ GOOD — Web research:**
-```greedy_search({ query: "what changed in React 19", depth: "fast" })```
-```greedy_search({ query: "best auth patterns for SaaS", depth: "deep" })```
-```greedy_search({ query: "Prisma vs Drizzle 2026", depth: "standard", fullAnswer: true })```
-
-**❌ WRONG — Don't use for codebase search:**
-```javascript
-// DON'T: Searching your own codebase
-// greedy_search({ query: "find UserService class" })  // ❌ Won't find it!
-
-// DO: Use these instead for codebase search:
-// ast_grep_search({ pattern: "class UserService", lang: "typescript" })
-// bash({ command: "rg 'class UserService' --type ts" })
-```
-
-### Legacy
-
-`deep_research` tool still works — aliases to `greedy_search` with `depth: "deep"`.
-
-## coding_task
-
-Browser-based coding assistant via Gemini/Copilot.
-
-```coding_task({ task: "debug race condition", mode: "debug", engine: "gemini" })```
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `task` | string | required | Coding task/question |
-| `engine` | string | `"gemini"` | `gemini`, `copilot`, `all` |
-| `mode` | string | `"code"` | `debug`, `plan`, `review`, `test`, `code` |
-| `context` | string | — | Code snippet to include |
-
-**Modes:**
-- `debug`: Tricky bugs — fresh eyes catch different failure modes
-- `plan`: Big refactor — plays devil's advocate on risks
-- `review`: High-stakes code review before merge
-- `test`: Edge cases the author missed
-- `code`: Simple generation (but you're probably faster)
-
-**When to use:** Second opinions on hard problems. Skip for simple code.
-
-## Result Interpretation
-
-- **All 3 engines agree** → High confidence, present as fact
-- **2 agree, 1 differs** → Likely correct, note dissent
-- **Sources [3/3] or [2/3]** → Multiple engines cite, higher confidence
-- **Deep research confidence scores** → Structured confidence metadata