@oh-my-pi/pi-coding-agent 12.10.1 → 12.11.0

package/src/config/model-resolver.ts

@@ -2,39 +2,16 @@
  * Model resolution, scoping, and initial selection
  */
 import type { ThinkingLevel } from "@oh-my-pi/pi-agent-core";
-import { type Api, type KnownProvider, type Model, modelsAreEqual } from "@oh-my-pi/pi-ai";
+import { type Api, DEFAULT_MODEL_PER_PROVIDER, type KnownProvider, type Model, modelsAreEqual } from "@oh-my-pi/pi-ai";
 import chalk from "chalk";
 import { isValidThinkingLevel } from "../cli/args";
+import MODEL_PRIO from "../priority.json" with { type: "json" };
 import { fuzzyMatch } from "../utils/fuzzy";
 import { MODEL_ROLE_IDS, type ModelRegistry, type ModelRole } from "./model-registry";
 import type { Settings } from "./settings";
 
 /** Default model IDs for each known provider */
-export const defaultModelPerProvider: Record<KnownProvider, string> = {
-	"amazon-bedrock": "us.anthropic.claude-opus-4-6-v1",
-	anthropic: "claude-sonnet-4-6",
-	openai: "gpt-5.1-codex",
-	"openai-codex": "gpt-5.3-codex",
-	google: "gemini-2.5-pro",
-	"google-gemini-cli": "gemini-2.5-pro",
-	"google-antigravity": "gemini-3-pro-high",
-	"google-vertex": "gemini-3-pro-preview",
-	"github-copilot": "gpt-4o",
-	cursor: "claude-sonnet-4-6",
-	openrouter: "openai/gpt-5.1-codex",
-	"vercel-ai-gateway": "anthropic/claude-sonnet-4-6",
-	xai: "grok-4-fast-non-reasoning",
-	groq: "openai/gpt-oss-120b",
-	cerebras: "zai-glm-4.6",
-	zai: "glm-4.6",
-	mistral: "devstral-medium-latest",
-	minimax: "MiniMax-M2.5",
-	"minimax-code": "MiniMax-M2.5",
-	"minimax-code-cn": "MiniMax-M2.5",
-	opencode: "claude-sonnet-4-6",
-	"kimi-code": "kimi-k2.5",
-	synthetic: "hf:moonshotai/Kimi-K2.5",
-};
+export const defaultModelPerProvider: Record<KnownProvider, string> = DEFAULT_MODEL_PER_PROVIDER;
 
 export interface ScopedModel {
 	model: Model<Api>;
@@ -42,47 +19,6 @@ export interface ScopedModel {
 	explicitThinkingLevel: boolean;
 }
 
-/** Priority chain for auto-discovering smol/fast models */
-export const SMOL_MODEL_PRIORITY = [
-	// any spark
-	"gpt-5.3-codex-spark",
-	"gpt-5.3-spark",
-	"spark",
-	// cerebras zai
-	"cerebras/zai-glm-4.7",
-	"cerebras/zai-glm-4.6",
-	"cerebras/zai-glm",
-	// any haiku
-	"haiku-4-5",
-	"haiku-4.5",
-	"haiku",
-	// any flash
-	"flash",
-	// any mini
-	"mini",
-];
-
-/** Priority chain for auto-discovering slow/comprehensive models (reasoning, codex) */
-export const SLOW_MODEL_PRIORITY = [
-	// any codex
-	"gpt-5.3-codex",
-	"gpt-5.3",
-	"gpt-5.2-codex",
-	"gpt-5.2",
-	"gpt-5.1-codex",
-	"gpt-5.1",
-	"codex",
-	// any opus
-	"opus-4.6",
-	"opus-4-6",
-	"opus-4.5",
-	"opus-4-5",
-	"opus-4.1",
-	"opus-4-1",
-	// whatever
-	"pro",
-];
-
 /**
  * Parse a model string in "provider/modelId" format.
  * Returns undefined if the format is invalid.
@@ -812,7 +748,7 @@ export async function findSmolModel(
 	}
 
 	// 2. Try priority chain
-	for (const pattern of SMOL_MODEL_PRIORITY) {
+	for (const pattern of MODEL_PRIO.smol) {
 		// Try exact match with provider prefix
 		const providerMatch = availableModels.find(m => `${m.provider}/${m.id}`.toLowerCase() === pattern);
 		if (providerMatch) return providerMatch;
@@ -855,7 +791,7 @@ export async function findSlowModel(
 	}
 
 	// 2. Try priority chain
-	for (const pattern of SLOW_MODEL_PRIORITY) {
+	for (const pattern of MODEL_PRIO.slow) {
 		// Try exact match first
 		const exactMatch = availableModels.find(m => m.id.toLowerCase() === pattern.toLowerCase());
 		if (exactMatch) return exactMatch;

package/src/config/settings-schema.ts

@@ -244,6 +244,16 @@ export const SETTINGS_SCHEMA = {
 		default: false,
 		ui: { tab: "input", label: "Collapse changelog", description: "Show condensed changelog after updates" },
 	},
+	autocompleteMaxVisible: {
+		type: "number",
+		default: 5,
+		ui: {
+			tab: "input",
+			label: "Autocomplete max items",
+			description: "Max visible items in autocomplete dropdown (3-20)",
+			submenu: true,
+		},
+	},
 	normativeRewrite: {
 		type: "boolean",
 		default: false,

package/src/modes/components/model-selector.ts

@@ -223,6 +223,16 @@ export class ModelSelectorComponent extends Container {
 			const providerCmp = a.provider.localeCompare(b.provider);
 			if (providerCmp !== 0) return providerCmp;
 
+			// Priority field (lower = better, e.g. Codex priority values)
+			const aPri = a.model.priority ?? Number.MAX_SAFE_INTEGER;
+			const bPri = b.model.priority ?? Number.MAX_SAFE_INTEGER;
+			if (aPri !== bPri) return aPri - bPri;
+
+			// Version number descending (higher version = better model)
+			const aVer = extractVersionNumber(a.id);
+			const bVer = extractVersionNumber(b.id);
+			if (aVer !== bVer) return bVer - aVer;
+
 			const aIsLatest = latestRe.test(a.id);
 			const bIsLatest = latestRe.test(b.id);
 			const aDate = a.id.match(dateRe)?.[1] ?? "";
@@ -596,3 +606,17 @@ export class ModelSelectorComponent extends Container {
 		return this.#searchInput;
 	}
 }
+
+/** Extract the first version number from a model ID (e.g. "gemini-2.5-pro" → 2.5, "claude-sonnet-4-6" → 4.6). */
+function extractVersionNumber(id: string): number {
+	// Dot-separated version: "gemini-2.5-pro" → 2.5
+	const dotMatch = id.match(/(?:^|[-_])(\d+\.\d+)/);
+	if (dotMatch) return Number.parseFloat(dotMatch[1]);
+	// Dash-separated short segments: "claude-sonnet-4-6" → 4.6, "llama-3-1-8b" → 3.1
+	const dashMatch = id.match(/(?:^|[-_])(\d{1,2})-(\d{1,2})(?=-|$)/);
+	if (dashMatch) return Number.parseFloat(`${dashMatch[1]}.${dashMatch[2]}`);
+	// Single number after separator: "gpt-4o" → 4
+	const singleMatch = id.match(/(?:^|[-_])(\d+)/);
+	if (singleMatch) return Number.parseFloat(singleMatch[1]);
+	return 0;
+}

package/src/modes/components/settings-defs.ts

@@ -116,6 +116,15 @@ const OPTION_PROVIDERS: Partial<Record<SettingPath, OptionProvider>> = {
 		{ value: "5", label: "5 lines" },
 		{ value: "10", label: "10 lines" },
 	],
+	// Autocomplete max visible
+	autocompleteMaxVisible: [
+		{ value: "3", label: "3 items" },
+		{ value: "5", label: "5 items" },
+		{ value: "7", label: "7 items" },
+		{ value: "10", label: "10 items" },
+		{ value: "15", label: "15 items" },
+		{ value: "20", label: "20 items" },
+	],
 	// Ask timeout
 	"ask.timeout": [
 		{ value: "0", label: "Disabled" },
@@ -155,7 +164,7 @@ const OPTION_PROVIDERS: Partial<Record<SettingPath, OptionProvider>> = {
 		{
 			value: "auto",
 			label: "Auto",
-			description: "Priority: Exa > Brave > Jina > Perplexity > Anthropic > Gemini > Codex > Z.AI",
+			description: "Priority: Exa > Brave > Jina > Perplexity > Anthropic > Gemini > Codex > Z.AI > Synthetic",
 		},
 		{ value: "exa", label: "Exa", description: "Requires EXA_API_KEY" },
 		{ value: "brave", label: "Brave", description: "Requires BRAVE_API_KEY" },
@@ -163,6 +172,7 @@ const OPTION_PROVIDERS: Partial<Record<SettingPath, OptionProvider>> = {
 		{ value: "perplexity", label: "Perplexity", description: "Requires PERPLEXITY_API_KEY" },
 		{ value: "anthropic", label: "Anthropic", description: "Uses Anthropic web search" },
 		{ value: "zai", label: "Z.AI", description: "Calls Z.AI webSearchPrime MCP" },
+		{ value: "synthetic", label: "Synthetic", description: "Requires SYNTHETIC_API_KEY" },
 	],
 	"providers.image": [
 		{ value: "auto", label: "Auto", description: "Priority: OpenRouter > Gemini" },

package/src/modes/controllers/selector-controller.ts

@@ -201,6 +201,10 @@ export class SelectorController {
 				this.ctx.ui.setClearOnShrink(value as boolean);
 				break;
 
+			case "autocompleteMaxVisible":
+				this.ctx.editor.setAutocompleteMaxVisible(typeof value === "number" ? value : Number(value));
+				break;
+
 			// Settings with UI side effects
 			case "showImages":
 				for (const child of this.ctx.chatContainer.children) {

package/src/modes/interactive-mode.ts

@@ -189,6 +189,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.todoContainer = new Container();
 		this.editor = new CustomEditor(getEditorTheme());
 		this.editor.setUseTerminalCursor(this.ui.getShowHardwareCursor());
+		this.editor.setAutocompleteMaxVisible(settings.get("autocompleteMaxVisible"));
 		this.editor.onAutocompleteCancel = () => {
 			this.ui.requestRender(true);
 		};

package/src/priority.json

@@ -0,0 +1,28 @@
+{
+	"smol": [
+		"cerebras/zai-glm-4.7",
+		"cerebras/zai-glm-4.6",
+		"cerebras/zai-glm",
+		"haiku-4-5",
+		"haiku-4.5",
+		"haiku",
+		"flash",
+		"mini"
+	],
+	"slow": [
+		"gpt-5.3-codex",
+		"gpt-5.3",
+		"gpt-5.2-codex",
+		"gpt-5.2",
+		"gpt-5.1-codex",
+		"gpt-5.1",
+		"codex",
+		"opus-4.6",
+		"opus-4-6",
+		"opus-4.5",
+		"opus-4-5",
+		"opus-4.1",
+		"opus-4-1",
+		"pro"
+	]
+}

package/src/prompts/agents/explore.md

@@ -2,7 +2,7 @@
 name: explore
 description: Fast read-only codebase scout returning compressed context for handoff
 tools: read, grep, find, bash
-model: pi/smol, haiku-4.5, haiku-4-5, gemini-flash-latest, gemini-3-flash, zai-glm-4.7, glm-4.7-flash, glm-4.5-flash, gpt-5.1-codex-mini, haiku, flash, mini
+model: pi/smol
 thinking-level: minimal
 output:
   properties:

package/src/prompts/agents/plan.md

@@ -3,7 +3,7 @@ name: plan
 description: Software architect for complex multi-file architectural decisions. NOT for simple tasks, single-file changes, or tasks completable in <5 tool calls.
 tools: read, grep, find, bash
 spawns: explore
-model: pi/plan, pi/slow, gpt-5.2-codex, gpt-5.2, codex, gpt, opus-4.5, opus-4-5, gemini-3-pro
+model: pi/plan, pi/slow
 thinking-level: high
 ---
 

package/src/prompts/agents/reviewer.md

@@ -3,7 +3,7 @@ name: reviewer
 description: "Code review specialist for quality/security analysis"
 tools: read, grep, find, bash, report_finding
 spawns: explore, task
-model: pi/slow, gpt-5.2-codex, gpt-5.2, codex, gpt
+model: pi/slow
 thinking-level: high
 output:
   properties:

package/src/session/agent-session.ts

@@ -16,7 +16,15 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 
-import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLevel } from "@oh-my-pi/pi-agent-core";
+import {
+	type Agent,
+	AgentBusyError,
+	type AgentEvent,
+	type AgentMessage,
+	type AgentState,
+	type AgentTool,
+	type ThinkingLevel,
+} from "@oh-my-pi/pi-agent-core";
 import type {
 	AssistantMessage,
 	ImageContent,
@@ -304,6 +312,7 @@ export class AgentSession {
 
 	// Handoff state
 	#handoffAbortController: AbortController | undefined = undefined;
+	#skipPostTurnMaintenanceAssistantTimestamp: number | undefined = undefined;
 
 	// Retry state
 	#retryAbortController: AbortController | undefined = undefined;
@@ -579,6 +588,9 @@ export class AgentSession {
 				this.#lastAssistantMessage = event.message;
 				const assistantMsg = event.message as AssistantMessage;
 				this.#queueDeferredTtsrInjectionIfNeeded(assistantMsg);
+				if (this.#handoffAbortController) {
+					this.#skipPostTurnMaintenanceAssistantTimestamp = assistantMsg.timestamp;
+				}
 				if (
 					assistantMsg.stopReason !== "error" &&
 					assistantMsg.stopReason !== "aborted" &&
@@ -637,6 +649,11 @@ export class AgentSession {
 			const msg = this.#lastAssistantMessage;
 			this.#lastAssistantMessage = undefined;
 
+			if (this.#skipPostTurnMaintenanceAssistantTimestamp === msg.timestamp) {
+				this.#skipPostTurnMaintenanceAssistantTimestamp = undefined;
+				return;
+			}
+
 			// Check for retryable errors first (overloaded, rate limit, server errors)
 			if (this.#isRetryableError(msg)) {
 				const didRetry = await this.#handleRetryableError(msg);
@@ -1607,9 +1624,7 @@ export class AgentSession {
 		// If streaming, queue via steer() or followUp() based on option
 		if (this.isStreaming) {
 			if (!options?.streamingBehavior) {
-				throw new Error(
-					"Agent is already processing. Specify streamingBehavior ('steer' or 'followUp') to queue the message.",
-				);
+				throw new AgentBusyError();
 			}
 			if (options.streamingBehavior === "followUp") {
 				await this.#queueFollowUp(expandedText, options?.images);
@@ -1650,9 +1665,7 @@ export class AgentSession {
 
 		if (this.isStreaming) {
 			if (!options?.streamingBehavior) {
-				throw new Error(
-					"Agent is already processing. Specify streamingBehavior ('steer' or 'followUp') to queue the message.",
-				);
+				throw new AgentBusyError();
 			}
 			await this.sendCustomMessage(message, { deliverAs: options.streamingBehavior });
 			return;
@@ -1777,7 +1790,7 @@ export class AgentSession {
 			}
 
 			const agentPromptOptions = options?.toolChoice ? { toolChoice: options.toolChoice } : undefined;
-			await this.agent.prompt(messages, agentPromptOptions);
+			await this.#promptAgentWithIdleRetry(messages, agentPromptOptions);
 			await this.#waitForRetry();
 		} finally {
 			this.#promptInFlight = false;
@@ -2800,6 +2813,8 @@ export class AgentSession {
 			throw new Error("Nothing to hand off (no messages yet)");
 		}
 
+		this.#skipPostTurnMaintenanceAssistantTimestamp = undefined;
+
 		this.#handoffAbortController = new AbortController();
 
 		// Build the handoff prompt
@@ -3693,6 +3708,24 @@ Be thorough - include exact file paths, function names, error messages, and tech
 		}
 	}
 
+	async #promptAgentWithIdleRetry(messages: AgentMessage[], options?: { toolChoice?: ToolChoice }): Promise<void> {
+		const deadline = Date.now() + 30_000;
+		for (;;) {
+			try {
+				await this.agent.prompt(messages, options);
+				return;
+			} catch (err) {
+				if (!(err instanceof AgentBusyError)) {
+					throw err;
+				}
+				if (Date.now() >= deadline) {
+					throw new Error("Timed out waiting for prior agent run to finish before prompting.");
+				}
+				await this.agent.waitForIdle();
+			}
+		}
+	}
+
 	/** Whether auto-retry is currently in progress */
 	get isRetrying(): boolean {
 		return this.#retryPromise !== undefined;

package/src/session/auth-storage.ts

@@ -14,16 +14,28 @@ import {
 	loginAnthropic,
 	loginAntigravity,
 	loginCerebras,
+	loginCloudflareAiGateway,
 	loginCursor,
 	loginGeminiCli,
 	loginGitHubCopilot,
+	loginHuggingface,
 	loginKimi,
+	loginLiteLLM,
 	loginMiniMaxCode,
 	loginMiniMaxCodeCn,
+	loginMoonshot,
+	loginNvidia,
+	loginOllama,
 	loginOpenAICodex,
 	loginOpenCode,
 	loginPerplexity,
+	loginQianfan,
+	loginQwenPortal,
 	loginSynthetic,
+	loginTogether,
+	loginVenice,
+	loginVllm,
+	loginXiaomi,
 	loginZai,
 	type OAuthController,
 	type OAuthCredentials,
@@ -693,11 +705,24 @@ export class AuthStorage {
 			case "perplexity":
 				credentials = await loginPerplexity(ctrl);
 				break;
+			case "huggingface": {
+				const apiKey = await loginHuggingface(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
 			case "opencode": {
 				const apiKey = await loginOpenCode(ctrl);
 				await saveApiKeyCredential(apiKey);
 				return;
 			}
+			case "ollama": {
+				const apiKey = await loginOllama(ctrl);
+				if (!apiKey) {
+					return;
+				}
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
 			case "cerebras": {
 				const apiKey = await loginCerebras(ctrl);
 				await saveApiKeyCredential(apiKey);
@@ -708,6 +733,11 @@ export class AuthStorage {
 				await saveApiKeyCredential(apiKey);
 				return;
 			}
+			case "qianfan": {
+				const apiKey = await loginQianfan(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
 			case "minimax-code": {
 				const apiKey = await loginMiniMaxCode(ctrl);
 				await saveApiKeyCredential(apiKey);
@@ -723,6 +753,51 @@ export class AuthStorage {
 				await saveApiKeyCredential(apiKey);
 				return;
 			}
+			case "venice": {
+				const apiKey = await loginVenice(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "litellm": {
+				const apiKey = await loginLiteLLM(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "moonshot": {
+				const apiKey = await loginMoonshot(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "together": {
+				const apiKey = await loginTogether(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "cloudflare-ai-gateway": {
+				const apiKey = await loginCloudflareAiGateway(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "vllm": {
+				const apiKey = await loginVllm(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "qwen-portal": {
+				const apiKey = await loginQwenPortal(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "nvidia": {
+				const apiKey = await loginNvidia(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
+			case "xiaomi": {
+				const apiKey = await loginXiaomi(ctrl);
+				await saveApiKeyCredential(apiKey);
+				return;
+			}
 			default: {
 				const customProvider = getOAuthProvider(provider);
 				if (!customProvider) {

package/src/tools/browser.ts

@@ -4,10 +4,18 @@ import { Readability } from "@mozilla/readability";
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import { StringEnum } from "@oh-my-pi/pi-ai";
 import { logger, Snowflake, untilAborted } from "@oh-my-pi/pi-utils";
+import { getPuppeteerDir } from "@oh-my-pi/pi-utils/dirs";
 import { type Static, Type } from "@sinclair/typebox";
 import { type HTMLElement, parseHTML } from "linkedom";
-import type { Browser, CDPSession, ElementHandle, KeyInput, Page, SerializedAXNode } from "puppeteer";
-import puppeteer from "puppeteer";
+import type {
+	Browser,
+	CDPSession,
+	ElementHandle,
+	KeyInput,
+	Page,
+	default as Puppeteer,
+	SerializedAXNode,
+} from "puppeteer";
 import { renderPromptTemplate } from "../config/prompt-templates";
 import browserDescription from "../prompts/tools/browser.md" with { type: "text" };
 import type { ToolSession } from "../sdk";
@@ -31,6 +39,25 @@ import stealthWorkerScript from "./puppeteer/13_stealth_worker.txt" with { type:
 import { ToolAbortError, ToolError, throwIfAborted } from "./tool-errors";
 import { toolResult } from "./tool-result";
 
+/**
+ * Lazy-import puppeteer from a safe CWD so cosmiconfig doesn't choke
+ * on malformed package.json files in the user's project tree.
+ */
+let puppeteerModule: typeof Puppeteer | undefined;
+async function loadPuppeteer(): Promise<typeof Puppeteer> {
+	if (puppeteerModule) return puppeteerModule;
+	const prev = process.cwd();
+	const safeDir = getPuppeteerDir();
+	await Bun.write(path.join(safeDir, "package.json"), "{}");
+	try {
+		process.chdir(safeDir);
+		puppeteerModule = (await import("puppeteer")).default;
+		return puppeteerModule;
+	} finally {
+		process.chdir(prev);
+	}
+}
+
 const DEFAULT_TIMEOUT_SECONDS = 30;
 const MAX_TIMEOUT_SECONDS = 120;
 const DEFAULT_VIEWPORT = { width: 1365, height: 768, deviceScaleFactor: 1.25 };
@@ -488,6 +515,7 @@ export class BrowserTool implements AgentTool<typeof browserSchema, BrowserToolD
 		await this.#closeBrowser();
 		this.#currentHeadless = this.session.settings.get("browser.headless");
 		const initialViewport = params?.viewport ?? DEFAULT_VIEWPORT;
+		const puppeteer = await loadPuppeteer();
 		this.#browser = await puppeteer.launch({
 			headless: this.#currentHeadless,
 			defaultViewport: this.#currentHeadless ? initialViewport : null,

package/src/utils/title-generator.ts

@@ -5,8 +5,9 @@ import type { Api, Model } from "@oh-my-pi/pi-ai";
 import { completeSimple } from "@oh-my-pi/pi-ai";
 import { logger } from "@oh-my-pi/pi-utils";
 import type { ModelRegistry } from "../config/model-registry";
-import { parseModelString, SMOL_MODEL_PRIORITY } from "../config/model-resolver";
+import { parseModelString } from "../config/model-resolver";
 import { renderPromptTemplate } from "../config/prompt-templates";
+import MODEL_PRIO from "../priority.json" with { type: "json" };
 import titleSystemPrompt from "../prompts/system/title-system.md" with { type: "text" };
 
 const TITLE_SYSTEM_PROMPT = renderPromptTemplate(titleSystemPrompt);
@@ -34,7 +35,7 @@ function getTitleModelCandidates(registry: ModelRegistry, savedSmolModel?: strin
 		}
 	}
 
-	for (const pattern of SMOL_MODEL_PRIORITY) {
+	for (const pattern of MODEL_PRIO.smol) {
 		const needle = pattern.toLowerCase();
 		const exactMatch = availableModels.find(model => model.id.toLowerCase() === needle);
 		addCandidate(exactMatch);

package/src/web/search/index.ts

@@ -1,7 +1,7 @@
 /**
  * Unified Web Search Tool
  *
- * Single tool supporting Anthropic, Perplexity, Exa, Brave, Jina, Gemini, Codex, and Z.AI
+ * Single tool supporting Anthropic, Perplexity, Exa, Brave, Jina, Gemini, Codex, Z.AI, and Synthetic
  * providers with provider-specific parameters exposed conditionally.
  *
  * When EXA_API_KEY is available, additional specialized tools are exposed:
@@ -33,7 +33,7 @@ import { SearchProviderError } from "./types";
 export const webSearchSchema = Type.Object({
 	query: Type.String({ description: "Search query" }),
 	provider: Type.Optional(
-		StringEnum(["auto", "exa", "brave", "jina", "zai", "anthropic", "perplexity", "gemini", "codex"], {
+		StringEnum(["auto", "exa", "brave", "jina", "zai", "anthropic", "perplexity", "gemini", "codex", "synthetic"], {
 			description: "Search provider (default: auto)",
 		}),
 	),
@@ -47,7 +47,7 @@ export const webSearchSchema = Type.Object({
 
 export type SearchParams = {
 	query: string;
-	provider?: "auto" | "exa" | "brave" | "jina" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex";
+	provider?: "auto" | "exa" | "brave" | "jina" | "zai" | "anthropic" | "perplexity" | "gemini" | "codex" | "synthetic";
 	recency?: "day" | "week" | "month" | "year";
 	limit?: number;
 	/** Maximum output tokens. Defaults to 4096. */
@@ -236,7 +236,7 @@ export async function runSearchQuery(
 /**
  * Web search tool implementation.
  *
- * Supports Anthropic, Perplexity, Exa, Brave, Jina, Gemini, Codex, and Z.AI providers with automatic fallback.
+ * Supports Anthropic, Perplexity, Exa, Brave, Jina, Gemini, Codex, Z.AI, and Synthetic providers with automatic fallback.
  * Session is accepted for interface consistency but not used.
  */
 export class SearchTool implements AgentTool<typeof webSearchSchema, SearchRenderDetails> {

package/src/web/search/provider.ts

@@ -6,6 +6,7 @@ import { ExaProvider } from "./providers/exa";
 import { GeminiProvider } from "./providers/gemini";
 import { JinaProvider } from "./providers/jina";
 import { PerplexityProvider } from "./providers/perplexity";
+import { SyntheticProvider } from "./providers/synthetic";
 import { ZaiProvider } from "./providers/zai";
 import type { SearchProviderId } from "./types";
 
@@ -21,6 +22,7 @@ const SEARCH_PROVIDERS: Record<SearchProviderId, SearchProvider> = {
 	anthropic: new AnthropicProvider(),
 	gemini: new GeminiProvider(),
 	codex: new CodexProvider(),
+	synthetic: new SyntheticProvider(),
 } as const;
 
 const SEARCH_PROVIDER_ORDER: SearchProviderId[] = [
@@ -32,6 +34,7 @@ const SEARCH_PROVIDER_ORDER: SearchProviderId[] = [
 	"gemini",
 	"codex",
 	"zai",
+	"synthetic",
 ];
 
 export function getSearchProvider(provider: SearchProviderId): SearchProvider {
@@ -46,7 +49,7 @@ export function setPreferredSearchProvider(provider: SearchProviderId | "auto"):
 	preferredProvId = provider;
 }
 
-/** Determine which providers are configured (priority: Exa → Brave → Jina → Perplexity → Anthropic → Gemini → Codex → Z.AI) */
+/** Determine which providers are configured (priority: Exa → Brave → Jina → Perplexity → Anthropic → Gemini → Codex → Z.AI → Synthetic) */
 export async function resolveProviderChain(
 	preferredProvider: SearchProviderId | "auto" = preferredProvId,
 ): Promise<SearchProvider[]> {