eve
Version:
Filesystem-first framework for durable backend AI agents that run anywhere.
40 lines (39 loc) • 1.82 kB
TypeScript
import { type ToolSet } from "ai";
import type { RuntimeModelReference } from "#runtime/agent/bootstrap.js";
import type { JsonObject } from "#shared/json.js";
/**
* The provider backend resolved for one web search tool invocation.
*/
export type WebSearchBackend = "anthropic" | "google" | "openai" | "parallel";
/**
* Returns the framework tool name that produced an upstream provider tool
* `type`, or `null` when the type is not one we know how to remove.
*
* Used by the harness recovery path to decide which tools to drop when a
* gateway fallback provider rejects a tool. Unknown types fall through to
* the existing terminal/recoverable handling.
*/
export declare function resolveFrameworkToolFromUpstreamType(type: string): string | null;
/**
* Returns the output schema for the provider-managed web search tool that
* will be injected for `backend`.
*/
export declare function resolveWebSearchOutputSchema(backend: WebSearchBackend): JsonObject;
/**
* Determines the web search backend for a model reference.
*
* - All AI Gateway models: Parallel search via gateway
* - Direct/BYO OpenAI models: native OpenAI search
* - Direct/BYO Anthropic models: native Anthropic search
* - Direct/BYO Google models: native Google search grounding
* - Other BYO models: not available (returns `null`)
*/
export declare function resolveWebSearchBackend(modelRef: RuntimeModelReference): WebSearchBackend | null;
/**
* Constructs the AI SDK provider tool for web search based on the resolved
* backend. Called once per harness step when web search is enabled.
*
* Dynamic imports keep unused provider SDKs out of the bundle — only the
* provider matching the current model is loaded.
*/
export declare function resolveWebSearchProviderTool(backend: WebSearchBackend): Promise<ToolSet[string]>;