@alumbwe/anvil 1.0.20 → 1.0.21

package/vendor/@anvil/sdk/dist/index.d.ts

@@ -0,0 +1,4277 @@
+// Generated by dts-bundle-generator v9.5.1
+
+/// <reference types="node" />
+
+type SourceReader = (filePath: string) => string | null | Promise<string | null>;
+export interface TokenCallerMap {
+	[filePath: string]: {
+		[token: string]: string[];
+	};
+}
+export interface FileTokenData {
+	tokenScores: {
+		[filePath: string]: {
+			[token: string]: number;
+		};
+	};
+	tokenCallers: TokenCallerMap;
+}
+declare function getFileTokenScores(projectRoot: string, filePaths: string[], readFile?: SourceReader): Promise<FileTokenData>;
+export type JSONValue = null | string | number | boolean | JSONObject | JSONArray;
+export declare const jsonValueSchema: z.ZodType<JSONValue>;
+export declare const jsonObjectSchema: z.ZodType<JSONObject>;
+export type JSONObject = {
+	[key in string]: JSONValue | undefined;
+};
+export declare const jsonArraySchema: z.ZodType<JSONArray>;
+export type JSONArray = JSONValue[];
+type ProviderMetadata = Record<string, Record<string, JSONValue | undefined>>;
+declare const textPartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"text">;
+	text: z.ZodString;
+	providerOptions: z.ZodOptional<z.ZodType<ProviderMetadata, unknown, z.core.$ZodTypeInternals<ProviderMetadata, unknown>>>;
+}, z.core.$strip>;
+export type TextPart = z.infer<typeof textPartSchema>;
+declare const imagePartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"image">;
+	image: z.ZodUnion<readonly [
+		z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<Uint8Array, Uint8Array>,
+			z.ZodCustom<ArrayBuffer, ArrayBuffer>,
+			z.ZodCustom<Buffer, Buffer>
+		]>,
+		z.ZodCustom<URL, URL>
+	]>;
+	mediaType: z.ZodOptional<z.ZodString>;
+	providerOptions: z.ZodOptional<z.ZodType<ProviderMetadata, unknown, z.core.$ZodTypeInternals<ProviderMetadata, unknown>>>;
+}, z.core.$strip>;
+export type ImagePart = z.infer<typeof imagePartSchema>;
+declare const filePartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"file">;
+	data: z.ZodUnion<readonly [
+		z.ZodUnion<readonly [
+			z.ZodString,
+			z.ZodCustom<Uint8Array, Uint8Array>,
+			z.ZodCustom<ArrayBuffer, ArrayBuffer>,
+			z.ZodCustom<Buffer, Buffer>
+		]>,
+		z.ZodCustom<URL, URL>
+	]>;
+	filename: z.ZodOptional<z.ZodString>;
+	mediaType: z.ZodString;
+	providerOptions: z.ZodOptional<z.ZodType<ProviderMetadata, unknown, z.core.$ZodTypeInternals<ProviderMetadata, unknown>>>;
+}, z.core.$strip>;
+type FilePart = z.infer<typeof filePartSchema>;
+declare const reasoningPartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"reasoning">;
+	text: z.ZodString;
+	providerOptions: z.ZodOptional<z.ZodType<ProviderMetadata, unknown, z.core.$ZodTypeInternals<ProviderMetadata, unknown>>>;
+}, z.core.$strip>;
+type ReasoningPart = z.infer<typeof reasoningPartSchema>;
+declare const toolCallPartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"tool-call">;
+	toolCallId: z.ZodString;
+	toolName: z.ZodString;
+	input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+	providerOptions: z.ZodOptional<z.ZodType<ProviderMetadata, unknown, z.core.$ZodTypeInternals<ProviderMetadata, unknown>>>;
+	providerExecuted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type ToolCallPart = z.infer<typeof toolCallPartSchema>;
+declare const toolResultOutputSchema: z.ZodDiscriminatedUnion<[
+	z.ZodObject<{
+		type: z.ZodLiteral<"json">;
+		value: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"media">;
+		data: z.ZodString;
+		mediaType: z.ZodString;
+	}, z.core.$strip>
+], "type">;
+type ToolResultOutput = z.infer<typeof toolResultOutputSchema>;
+export type AuxiliaryMessageData = {
+	providerOptions?: ProviderMetadata;
+	tags?: string[];
+	/**
+	 * Unix timestamp (ms) when the message was added to history.
+	 * Used to detect prompt cache expiry (>5 min gap = cache miss).
+	 * This field is stripped before sending to the LLM.
+	 */
+	sentAt?: number;
+	/** @deprecated Use tags instead. */
+	timeToLive?: "agentStep" | "userPrompt";
+	/** @deprecated Use tags instead. */
+	keepDuringTruncation?: boolean;
+	/** @deprecated Use tags instead. */
+	keepLastTags?: string[];
+};
+export type SystemMessage = {
+	role: "system";
+	content: TextPart[];
+} & AuxiliaryMessageData;
+export type UserMessage = {
+	role: "user";
+	content: (TextPart | ImagePart | FilePart)[];
+} & AuxiliaryMessageData;
+export type AssistantMessage = {
+	role: "assistant";
+	content: (TextPart | ReasoningPart | ToolCallPart)[];
+} & AuxiliaryMessageData;
+export type ToolMessage = {
+	role: "tool";
+	toolCallId: string;
+	toolName: string;
+	content: ToolResultOutput[];
+} & AuxiliaryMessageData;
+export type Message = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+export declare const dataContentSchema: z.ZodUnion<readonly [
+	z.ZodString,
+	z.ZodCustom<Uint8Array, Uint8Array>,
+	z.ZodCustom<ArrayBuffer, ArrayBuffer>,
+	z.ZodCustom<Buffer, Buffer>
+]>;
+export type DataContent = z.infer<typeof dataContentSchema>;
+export declare const printModeStartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"start">;
+	agentId: z.ZodOptional<z.ZodString>;
+	messageHistoryLength: z.ZodNumber;
+}, z.core.$strip>;
+export type PrintModeStart = z.infer<typeof printModeStartSchema>;
+export declare const printModeErrorSchema: z.ZodObject<{
+	type: z.ZodLiteral<"error">;
+	message: z.ZodString;
+	source: z.ZodOptional<z.ZodEnum<{
+		"stream-interrupted": "stream-interrupted";
+		"output-limit": "output-limit";
+	}>>;
+}, z.core.$strip>;
+export type PrintModeError = z.infer<typeof printModeErrorSchema>;
+export declare const printModeDownloadStatusSchema: z.ZodObject<{
+	type: z.ZodLiteral<"download">;
+	version: z.ZodString;
+	status: z.ZodEnum<{
+		complete: "complete";
+		failed: "failed";
+	}>;
+}, z.core.$strip>;
+export type PrintModeDownloadStatus = z.infer<typeof printModeDownloadStatusSchema>;
+export declare const printModeToolCallSchema: z.ZodObject<{
+	type: z.ZodLiteral<"tool_call">;
+	toolCallId: z.ZodString;
+	toolName: z.ZodString;
+	input: z.ZodRecord<z.ZodString, z.ZodAny>;
+	agentId: z.ZodOptional<z.ZodString>;
+	parentAgentId: z.ZodOptional<z.ZodString>;
+	includeToolCall: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PrintModeToolCall = z.infer<typeof printModeToolCallSchema>;
+export declare const printModeToolResultSchema: z.ZodObject<{
+	type: z.ZodLiteral<"tool_result">;
+	toolCallId: z.ZodString;
+	toolName: z.ZodString;
+	output: z.ZodArray<z.ZodDiscriminatedUnion<[
+		z.ZodObject<{
+			type: z.ZodLiteral<"json">;
+			value: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+		}, z.core.$strip>,
+		z.ZodObject<{
+			type: z.ZodLiteral<"media">;
+			data: z.ZodString;
+			mediaType: z.ZodString;
+		}, z.core.$strip>
+	], "type">>;
+	parentAgentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeToolResult = z.infer<typeof printModeToolResultSchema>;
+export declare const printModeTextSchema: z.ZodObject<{
+	type: z.ZodLiteral<"text">;
+	text: z.ZodString;
+	agentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeText = z.infer<typeof printModeTextSchema>;
+export declare const printModeFinishSchema: z.ZodObject<{
+	type: z.ZodLiteral<"finish">;
+	agentId: z.ZodOptional<z.ZodString>;
+	totalCost: z.ZodNumber;
+}, z.core.$strip>;
+export type PrintModeFinish = z.infer<typeof printModeFinishSchema>;
+export declare const printModeSubagentStartSchema: z.ZodObject<{
+	type: z.ZodLiteral<"subagent_start">;
+	agentId: z.ZodString;
+	agentType: z.ZodString;
+	displayName: z.ZodString;
+	onlyChild: z.ZodBoolean;
+	parentAgentId: z.ZodOptional<z.ZodString>;
+	params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+	prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeSubagentStart = z.infer<typeof printModeSubagentStartSchema>;
+export declare const printModeSubagentFinishSchema: z.ZodObject<{
+	type: z.ZodLiteral<"subagent_finish">;
+	agentId: z.ZodString;
+	agentType: z.ZodString;
+	displayName: z.ZodString;
+	onlyChild: z.ZodBoolean;
+	parentAgentId: z.ZodOptional<z.ZodString>;
+	params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+	prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PrintModeSubagentFinish = z.infer<typeof printModeSubagentFinishSchema>;
+export declare const printModeReasoningDeltaSchema: z.ZodObject<{
+	type: z.ZodLiteral<"reasoning_delta">;
+	text: z.ZodString;
+	ancestorRunIds: z.ZodArray<z.ZodString>;
+	runId: z.ZodString;
+	agentId: z.ZodString;
+}, z.core.$strip>;
+export type PrintModeReasoningDelta = z.infer<typeof printModeReasoningDeltaSchema>;
+export declare const printModeEventSchema: z.ZodDiscriminatedUnion<[
+	z.ZodObject<{
+		type: z.ZodLiteral<"download">;
+		version: z.ZodString;
+		status: z.ZodEnum<{
+			complete: "complete";
+			failed: "failed";
+		}>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"error">;
+		message: z.ZodString;
+		source: z.ZodOptional<z.ZodEnum<{
+			"stream-interrupted": "stream-interrupted";
+			"output-limit": "output-limit";
+		}>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"finish">;
+		agentId: z.ZodOptional<z.ZodString>;
+		totalCost: z.ZodNumber;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"start">;
+		agentId: z.ZodOptional<z.ZodString>;
+		messageHistoryLength: z.ZodNumber;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"subagent_finish">;
+		agentId: z.ZodString;
+		agentType: z.ZodString;
+		displayName: z.ZodString;
+		onlyChild: z.ZodBoolean;
+		parentAgentId: z.ZodOptional<z.ZodString>;
+		params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+		prompt: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"subagent_start">;
+		agentId: z.ZodString;
+		agentType: z.ZodString;
+		displayName: z.ZodString;
+		onlyChild: z.ZodBoolean;
+		parentAgentId: z.ZodOptional<z.ZodString>;
+		params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+		prompt: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"text">;
+		text: z.ZodString;
+		agentId: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"tool_call">;
+		toolCallId: z.ZodString;
+		toolName: z.ZodString;
+		input: z.ZodRecord<z.ZodString, z.ZodAny>;
+		agentId: z.ZodOptional<z.ZodString>;
+		parentAgentId: z.ZodOptional<z.ZodString>;
+		includeToolCall: z.ZodOptional<z.ZodBoolean>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"tool_result">;
+		toolCallId: z.ZodString;
+		toolName: z.ZodString;
+		output: z.ZodArray<z.ZodDiscriminatedUnion<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+			}, z.core.$strip>,
+			z.ZodObject<{
+				type: z.ZodLiteral<"media">;
+				data: z.ZodString;
+				mediaType: z.ZodString;
+			}, z.core.$strip>
+		], "type">>;
+		parentAgentId: z.ZodOptional<z.ZodString>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"reasoning_delta">;
+		text: z.ZodString;
+		ancestorRunIds: z.ZodArray<z.ZodString>;
+		runId: z.ZodString;
+		agentId: z.ZodString;
+	}, z.core.$strip>
+], "type">;
+export type PrintModeEvent = z.infer<typeof printModeEventSchema>;
+export declare const KNOWLEDGE_FILE_NAMES: readonly [
+	"AGENTS.md",
+	"CLAUDE.md"
+];
+/**
+ * Checks if a file path is a knowledge file.
+ * Matches:
+ * - Exact file names: AGENTS.md, CLAUDE.md (case-insensitive)
+ * - Pattern: *.knowledge.md (e.g., authentication.knowledge.md)
+ */
+export declare function isKnowledgeFile(filePath: string): boolean;
+declare const toolNames: readonly [
+	"apply_patch",
+	"add_subgoal",
+	"add_message",
+	"ask_user",
+	"browser_logs",
+	"code_search",
+	"cloud_plan_ready",
+	"create_plan",
+	"end_turn",
+	"find_files",
+	"glob",
+	"gravity_index",
+	"list_directory",
+	"lookup_agent_info",
+	"propose_str_replace",
+	"propose_write_file",
+	"read_docs",
+	"read_files",
+	"read_subtree",
+	"read_url",
+	"render_ui",
+	"run_file_change_hooks",
+	"run_terminal_command",
+	"set_messages",
+	"set_output",
+	"skill",
+	"spawn_agents",
+	"spawn_agent_inline",
+	"str_replace",
+	"suggest_followups",
+	"task_completed",
+	"think_deeply",
+	"update_subgoal",
+	"screenshot",
+	"vision_analyze",
+	"web_search",
+	"write_file",
+	"write_todos",
+	"composio_manage_connections",
+	"composio_multi_execute_tool",
+	"composio_search_tools",
+	"composio_get_tool_schemas"
+];
+declare const publishedTools: readonly [
+	"apply_patch",
+	"add_message",
+	"ask_user",
+	"code_search",
+	"cloud_plan_ready",
+	"end_turn",
+	"find_files",
+	"glob",
+	"gravity_index",
+	"list_directory",
+	"lookup_agent_info",
+	"propose_str_replace",
+	"propose_write_file",
+	"read_docs",
+	"read_files",
+	"read_subtree",
+	"read_url",
+	"render_ui",
+	"run_file_change_hooks",
+	"run_terminal_command",
+	"screenshot",
+	"vision_analyze",
+	"set_messages",
+	"set_output",
+	"skill",
+	"spawn_agents",
+	"str_replace",
+	"suggest_followups",
+	"task_completed",
+	"think_deeply",
+	"web_search",
+	"write_file",
+	"write_todos"
+];
+export type ToolName = (typeof toolNames)[number];
+type PublishedToolName = (typeof publishedTools)[number];
+export type CustomToolDefinition<N extends string = string, Args extends any = any, Input extends any = any> = {
+	toolName: N;
+	inputSchema: z.ZodType<Args, Input>;
+	description: string;
+	endsAgentStep: boolean;
+	exampleInputs: Input[];
+	execute: (params: Args) => Promise<ToolResultOutput[]>;
+};
+/**
+ * Creates a CustomToolDefinition object
+ *
+ * @param toolName the name of the tool
+ * @param inputSchema a Zod4 schema describing the input of the tool.
+ * @param description a description of the tool to be passed to the LLM. This should describe what the tool does and when to use it.
+ * @param endsAgentStep whether the tool ends the agent step. If `true`, this will be used as a "stop sequence" for the LLM. i.e. it will not be able to call any other tools after this one in a single step and must wait for the tool results. Used for tools that give more information to the LLM.
+ * @param exampleInputs an array of example inputs for the tool.
+ * @param execute what to do when the tool is called. Can be either a sync or async. Must return an array of {@linkcode ToolResultOutput}
+ * @returns a {@linkcode CustomToolDefinition} object
+ */
+export declare function getCustomToolDefinition<TN extends string, Args extends any, Input extends any>({ toolName, inputSchema, description, endsAgentStep, exampleInputs, execute, }: {
+	toolName: TN extends ToolName ? TN & {
+		error: `Hi there. This is a message from the Anvil team: You have used a custom tool where you needed to use overrideTools instead for name: ${TN}`;
+	} : TN;
+	inputSchema: z.ZodType<Args, Input>;
+	description: string;
+	endsAgentStep?: boolean;
+	exampleInputs?: Input[];
+	execute: (params: Args) => Promise<ToolResultOutput[]> | ToolResultOutput[];
+}): CustomToolDefinition<TN, Args, Input>;
+type ToolName$1 = "add_message" | "apply_patch" | "ask_user" | "cloud_plan_ready" | "code_search" | "end_turn" | "find_files" | "glob" | "gravity_index" | "list_directory" | "lookup_agent_info" | "propose_str_replace" | "propose_write_file" | "read_docs" | "read_files" | "read_subtree" | "read_url" | "render_ui" | "run_file_change_hooks" | "run_terminal_command" | "set_messages" | "set_output" | "skill" | "spawn_agents" | "str_replace" | "suggest_followups" | "task_completed" | "think_deeply" | "web_search" | "write_file" | "write_todos";
+interface ToolParamsMap {
+	add_message: AddMessageParams;
+	apply_patch: ApplyPatchParams;
+	ask_user: AskUserParams;
+	cloud_plan_ready: CloudPlanReadyParams;
+	code_search: CodeSearchParams;
+	end_turn: EndTurnParams;
+	find_files: FindFilesParams;
+	glob: GlobParams;
+	gravity_index: GravityIndexParams;
+	list_directory: ListDirectoryParams;
+	lookup_agent_info: LookupAgentInfoParams;
+	propose_str_replace: ProposeStrReplaceParams;
+	propose_write_file: ProposeWriteFileParams;
+	read_docs: ReadDocsParams;
+	read_files: ReadFilesParams;
+	read_subtree: ReadSubtreeParams;
+	read_url: ReadUrlParams;
+	render_ui: RenderUiParams;
+	run_file_change_hooks: RunFileChangeHooksParams;
+	run_terminal_command: RunTerminalCommandParams;
+	set_messages: SetMessagesParams;
+	set_output: SetOutputParams;
+	skill: SkillParams;
+	spawn_agents: SpawnAgentsParams;
+	str_replace: StrReplaceParams;
+	suggest_followups: SuggestFollowupsParams;
+	task_completed: TaskCompletedParams;
+	think_deeply: ThinkDeeplyParams;
+	web_search: WebSearchParams;
+	write_file: WriteFileParams;
+	write_todos: WriteTodosParams;
+}
+interface AddMessageParams {
+	role: "user" | "assistant";
+	content: string;
+}
+interface ApplyPatchParams {
+	/** The file operation to perform. */
+	operation: {
+		/** Operation type: create_file, update_file, or delete_file */
+		type: "create_file" | "update_file" | "delete_file";
+		/** File path relative to project root */
+		path: string;
+		/** Diff content. Required for create_file and update_file. Lines prefixed with + for creates, unified diff with @@ hunks for updates. */
+		diff?: string;
+	};
+}
+interface AskUserParams {
+	/** List of multiple choice questions to ask the user */
+	questions: {
+		/** The question to ask the user */
+		question: string;
+		/** Short label (max 12 chars) displayed as a chip/tag */
+		header?: string;
+		/** Array of answer options with label and optional description (minimum 2) */
+		options: {
+			/** The display text for this option */
+			label: string;
+			/** Explanation shown when option is focused */
+			description?: string;
+		}[];
+		/** If true, allows selecting multiple options (checkbox). If false, single selection only (radio). */
+		multiSelect?: boolean;
+		/** Validation rules for "Other" text input */
+		validation?: {
+			/** Maximum length for "Other" text input */
+			maxLength?: number;
+			/** Minimum length for "Other" text input */
+			minLength?: number;
+			/** Regex pattern for "Other" text input */
+			pattern?: string;
+			/** Custom error message when pattern fails */
+			patternError?: string;
+		};
+	}[];
+}
+interface CloudPlanReadyParams {
+	summary: string;
+	stack: string[];
+	build_prompt: string;
+}
+interface CodeSearchParams {
+	/** The pattern to search for. */
+	pattern: string;
+	/** Optional ripgrep flags to customize the search (e.g., "-i" for case-insensitive, "-g *.ts -g *.js" for TypeScript and JavaScript files only, "-g !*.test.ts" to exclude Typescript test files,  "-A 3" for 3 lines after match, "-B 2" for 2 lines before match). */
+	flags?: string;
+	/** Optional working directory to search within, relative to the project root. Defaults to searching the entire project. */
+	cwd?: string;
+	/** Maximum number of results to return per file. Defaults to 15. There is also a global limit of 250 results across all files. */
+	maxResults?: number;
+}
+interface EndTurnParams {
+}
+interface FindFilesParams {
+	/** A brief natural language description of the files or the name of a function or class you are looking for. It's also helpful to mention a directory or two to look within. */
+	prompt: string;
+}
+interface GlobParams {
+	/** Glob pattern to match files against (e.g., *.js, src/glob/*.ts, glob/test/glob/*.go). */
+	pattern: string;
+	/** Optional working directory to search within, relative to project root. If not provided, searches from project root. */
+	cwd?: string;
+}
+interface GravityIndexParams {
+	/** Which Gravity Index operation to perform. search: recommend a provider; browse: list catalog services; list_categories: list categories with counts; get_service: full detail for a known slug; report_integration: report a completed integration. */
+	action: "search" | "browse" | "list_categories" | "get_service" | "report_integration";
+	/** For action "search": what the user needs, including stack, constraints, and required capabilities. */
+	query?: string;
+	/** For action "search": continue a previous search. For action "report_integration": the search_id from the earlier search result (required). */
+	search_id?: string;
+	/** For action "search": optional structured JSON context about the project, stack, or constraints. */
+	context?: Record<string, any>;
+	/** For action "browse": optional category filter, e.g. Database, Auth, Payments, Hosting, Email, AI. */
+	category?: string;
+	/** For action "browse": optional keyword filter, e.g. sendgrid or postgres. */
+	q?: string;
+	/** For action "get_service": service slug, e.g. supabase, stripe, sendgrid (required). */
+	slug?: string;
+	/** For action "report_integration": slug of the service that was actually integrated (required). */
+	integrated_slug?: string;
+}
+interface ListDirectoryParams {
+	/** Directory path to list, relative to the project root. */
+	path: string;
+}
+interface LookupAgentInfoParams {
+	/** Agent ID (short local or full published format) */
+	agentId: string;
+}
+interface ProposeStrReplaceParams {
+	/** The path to the file to edit. */
+	path: string;
+	/** Array of replacements to make. */
+	replacements: {
+		/** The string to replace. This must be an *exact match* of the string you want to replace, including whitespace and punctuation. */
+		oldString: string;
+		/** The string to replace the corresponding oldString with. Can be empty to delete. */
+		newString: string;
+		/** Whether to allow multiple replacements of oldString. */
+		allowMultiple?: boolean;
+	}[];
+}
+interface ProposeWriteFileParams {
+	/** Path to the file relative to the **project root** */
+	path: string;
+	/** What the change is intended to do in only one sentence. */
+	instructions: string;
+	/** Edit snippet to apply to the file. */
+	content: string;
+}
+interface ReadDocsParams {
+	/** The library or framework name (e.g., "Next.js", "MongoDB", "React"). Use the official name as it appears in documentation if possible. Only public libraries available in Context7's database are supported, so small or private libraries may not be available. */
+	libraryTitle: string;
+	/** Specific topic to focus on (e.g., "routing", "hooks", "authentication") */
+	topic: string;
+	/** Optional maximum number of tokens to return. Defaults to 10000. */
+	max_tokens?: number;
+}
+interface ReadFilesParams {
+	/** List of file paths to read. */
+	paths: string[];
+}
+interface ReadSubtreeParams {
+	/** List of paths to directories or files. Relative to the project root. If omitted, the entire project tree is used. */
+	paths?: string[];
+	/** Maximum token budget for the subtree blob; the tree will be truncated to fit within this budget by first dropping file variables and then removing the most-nested files and directories. */
+	maxTokens?: number;
+}
+interface ReadUrlParams {
+	/** The full http:// or https:// URL to fetch and extract readable text from. */
+	url: string;
+	/** Maximum number of extracted text characters to return. Defaults to 20000. */
+	max_chars?: number;
+}
+interface RenderUiParams {
+	/** The UI widget to render. */
+	widget: {
+		/** Widget type. Currently, the only supported widget is button. */
+		type: "button";
+		/** Short button label shown to the user. */
+		text: string;
+		/** The http:// or https:// URL to open when the user clicks the button. */
+		link: string;
+		/** Theme-aware color treatment. Use primary for the main action and secondary for lower-emphasis actions. */
+		variant?: "primary" | "secondary";
+	};
+}
+interface RunFileChangeHooksParams {
+	/** List of file paths that were changed and should trigger file change hooks */
+	files: string[];
+}
+interface RunTerminalCommandParams {
+	/** CLI command valid for user's OS. */
+	command: string;
+	/** Either SYNC (waits, returns output) or BACKGROUND (runs in background). Default SYNC */
+	process_type?: "SYNC" | "BACKGROUND";
+	/** The working directory to run the command in. Default is the project root. */
+	cwd?: string;
+	/** Set to -1 for no timeout. Does not apply for BACKGROUND commands. Default 30 */
+	timeout_seconds?: number;
+}
+interface SetMessagesParams {
+	messages: any;
+}
+interface SetOutputParams {
+}
+interface SkillParams {
+	/** The name of the skill to load */
+	name: string;
+}
+interface SpawnAgentsParams {
+	agents: {
+		/** Agent to spawn */
+		agent_type: string;
+		/** Prompt to send to the agent */
+		prompt?: string;
+		/** Parameters object for the agent (if any) */
+		params?: Record<string, any>;
+	}[];
+}
+interface StrReplaceParams {
+	/** The path to the file to edit. */
+	path: string;
+	/** Array of replacements to make. */
+	replacements: {
+		/** The string to replace. This must be an *exact match* of the string you want to replace, including whitespace and punctuation. */
+		oldString: string;
+		/** The string to replace the corresponding oldString with. Can be empty to delete. */
+		newString: string;
+		/** Whether to allow multiple replacements of oldString. */
+		allowMultiple?: boolean;
+	}[];
+}
+interface SuggestFollowupsParams {
+	/** List of suggested followup prompts the user can click to send */
+	followups: {
+		/** The prompt text to send as a user message when clicked. Keep it short and goal-oriented — one sentence naming the outcome, not the steps to get there */
+		prompt: string;
+		/** Short display label for the card (defaults to truncated prompt if not provided) */
+		label?: string;
+	}[];
+}
+interface TaskCompletedParams {
+}
+interface ThinkDeeplyParams {
+	/** Detailed step-by-step analysis. Initially keep each step concise (max ~5-7 words per step). */
+	thought: string;
+}
+interface WebSearchParams {
+	/** The search query to find relevant web content */
+	query: string;
+	/** Search depth - 'standard' for quick results, 'deep' for more comprehensive search. Default is 'standard'. */
+	depth?: "standard" | "deep";
+}
+interface WriteFileParams {
+	/** Path to the file relative to the **project root** */
+	path: string;
+	/** What the change is intended to do in only one sentence. */
+	instructions: string;
+	/** Edit snippet to apply to the file. */
+	content: string;
+}
+interface WriteTodosParams {
+	/** List of todos with their completion status. Add ALL of the applicable tasks to the list, so you don't forget to do anything. Try to order the todos the same way you will complete them. Do not mark todos as completed if you have not completed them yet! */
+	todos: {
+		/** Description of the task */
+		task: string;
+		/** Whether the task is completed */
+		completed: boolean;
+	}[];
+}
+type GetToolParams<T extends ToolName$1> = ToolParamsMap[T];
+type JSONValue$1 = null | string | number | boolean | JSONObject$1 | JSONArray$1;
+type JSONObject$1 = {
+	[key: string]: JSONValue$1 | undefined;
+};
+type JSONArray$1 = JSONValue$1[];
+type JsonSchema = {
+	type?: "object" | "array" | "string" | "number" | "boolean" | "null" | "integer";
+	description?: string;
+	properties?: Record<string, JsonSchema | boolean>;
+	required?: string[];
+	enum?: Array<string | number | boolean | null>;
+	[k: string]: unknown;
+};
+type JsonObjectSchema = JsonSchema & {
+	type: "object";
+};
+type DataContent$1 = string | Uint8Array | ArrayBuffer | Buffer;
+type ProviderMetadata$1 = Record<string, Record<string, JSONValue$1 | undefined>>;
+type TextPart$1 = {
+	type: "text";
+	text: string;
+	providerOptions?: ProviderMetadata$1;
+};
+type ImagePart$1 = {
+	type: "image";
+	image: DataContent$1;
+	mediaType?: string;
+	providerOptions?: ProviderMetadata$1;
+};
+type FilePart$1 = {
+	type: "file";
+	data: DataContent$1;
+	filename?: string;
+	mediaType: string;
+	providerOptions?: ProviderMetadata$1;
+};
+type ReasoningPart$1 = {
+	type: "reasoning";
+	text: string;
+	providerOptions?: ProviderMetadata$1;
+};
+type ToolCallPart$1 = {
+	type: "tool-call";
+	toolCallId: string;
+	toolName: string;
+	input: Record<string, unknown>;
+	providerOptions?: ProviderMetadata$1;
+	providerExecuted?: boolean;
+};
+type ToolResultOutput$1 = {
+	type: "json";
+	value: JSONValue$1;
+} | {
+	type: "media";
+	data: string;
+	mediaType: string;
+};
+type AuxiliaryMessageData$1 = {
+	providerOptions?: ProviderMetadata$1;
+	tags?: string[];
+	/** @deprecated Use tags instead. */
+	timeToLive?: "agentStep" | "userPrompt";
+	/** @deprecated Use tags instead. */
+	keepDuringTruncation?: boolean;
+	/** @deprecated Use tags instead. */
+	keepLastTags?: string[];
+};
+type SystemMessage$1 = {
+	role: "system";
+	content: TextPart$1[];
+} & AuxiliaryMessageData$1;
+type UserMessage$1 = {
+	role: "user";
+	content: (TextPart$1 | ImagePart$1 | FilePart$1)[];
+} & AuxiliaryMessageData$1;
+type AssistantMessage$1 = {
+	role: "assistant";
+	content: (TextPart$1 | ReasoningPart$1 | ToolCallPart$1)[];
+} & AuxiliaryMessageData$1;
+type ToolMessage$1 = {
+	role: "tool";
+	toolCallId: string;
+	toolName: string;
+	content: ToolResultOutput$1[];
+} & AuxiliaryMessageData$1;
+type Message$1 = SystemMessage$1 | UserMessage$1 | AssistantMessage$1 | ToolMessage$1;
+type MCPConfig = {
+	type?: "stdio";
+	command: string;
+	args?: string[];
+	env?: Record<string, string>;
+} | {
+	type?: "http" | "sse";
+	url: string;
+	params?: Record<string, string>;
+	headers?: Record<string, string>;
+};
+interface Logger {
+	debug: (data: any, msg?: string) => void;
+	info: (data: any, msg?: string) => void;
+	warn: (data: any, msg?: string) => void;
+	error: (data: any, msg?: string) => void;
+}
+/**
+ * Anvil Agent Type Definitions
+ *
+ * This file provides TypeScript type definitions for creating custom Anvil agents.
+ * Import these types in your agent files to get full type safety and IntelliSense.
+ *
+ * Usage in .agents/your-agent.ts:
+ *   import { AgentDefinition, ToolName, ModelName } from './types/agent-definition'
+ *
+ *   const definition: AgentDefinition = {
+ *     // ... your agent configuration with full type safety ...
+ *   }
+ *
+ *   export default definition
+ */
+export interface AgentDefinition {
+	/** Unique identifier for this agent. Must contain only lowercase letters, numbers, and hyphens, e.g. 'code-reviewer' */
+	id: string;
+	/** Version string (if not provided, will default to '0.0.1' and be bumped on each publish) */
+	version?: string;
+	/** Publisher ID for the agent. Must be provided if you want to publish the agent. */
+	publisher?: string;
+	/** Human-readable name for the agent */
+	displayName: string;
+	/** AI model to use for this agent. Can be any model in OpenRouter: https://openrouter.ai/models */
+	model: ModelName;
+	/**
+	 * https://openrouter.ai/docs/use-cases/reasoning-tokens
+	 * One of `max_tokens` or `effort` is required.
+	 * If `exclude` is true, reasoning will be removed from the response. Default is false.
+	 */
+	reasoningOptions?: {
+		enabled?: boolean;
+		exclude?: boolean;
+	} & ({
+		max_tokens: number;
+	} | {
+		effort: "high" | "medium" | "low" | "minimal" | "none";
+	});
+	/**
+	 * Provider routing options for OpenRouter.
+	 * Controls which providers to use and fallback behavior.
+	 * See https://openrouter.ai/docs/features/provider-routing
+	 */
+	providerOptions?: {
+		/**
+		 * List of provider slugs to try in order (e.g. ["anthropic", "openai"])
+		 */
+		order?: string[];
+		/**
+		 * Whether to allow backup providers when primary is unavailable (default: true)
+		 */
+		allow_fallbacks?: boolean;
+		/**
+		 * Only use providers that support all parameters in your request (default: false)
+		 */
+		require_parameters?: boolean;
+		/**
+		 * Control whether to use providers that may store data
+		 */
+		data_collection?: "allow" | "deny";
+		/**
+		 * List of provider slugs to allow for this request
+		 */
+		only?: string[];
+		/**
+		 * List of provider slugs to skip for this request
+		 */
+		ignore?: string[];
+		/**
+		 * List of quantization levels to filter by (e.g. ["int4", "int8"])
+		 */
+		quantizations?: Array<"int4" | "int8" | "fp4" | "fp6" | "fp8" | "fp16" | "bf16" | "fp32" | "unknown">;
+		/**
+		 * Sort providers by price, throughput, or latency
+		 */
+		sort?: "price" | "throughput" | "latency";
+		/**
+		 * Maximum pricing you want to pay for this request
+		 */
+		max_price?: {
+			prompt?: number | string;
+			completion?: number | string;
+			image?: number | string;
+			audio?: number | string;
+			request?: number | string;
+		};
+	};
+	/** MCP servers by name. Names cannot contain `/`. */
+	mcpServers?: Record<string, MCPConfig>;
+	/**
+	 * Tools this agent can use.
+	 *
+	 * By default, all tools are available from any specified MCP server. In
+	 * order to limit the tools from a specific MCP server, add the tool name(s)
+	 * in the format `'mcpServerName/toolName1'`, `'mcpServerName/toolName2'`,
+	 * etc.
+	 */
+	toolNames?: (ToolName$1 | (string & {}))[];
+	/** Other agents this agent can spawn, like 'anvil/file-picker@0.0.1'.
+	 *
+	 * Use the fully qualified agent id from the agent store, including publisher and version: 'anvil/file-picker@0.0.1'
+	 * (publisher and version are required!)
+	 *
+	 * Or, use the agent id from a local agent file in your .agents directory: 'file-picker'.
+	 */
+	spawnableAgents?: string[];
+	/** The input schema required to spawn the agent. Provide a prompt string and/or a params object or none.
+	 * 80% of the time you want just a prompt string with a description:
+	 * inputSchema: {
+	 *   prompt: { type: 'string', description: 'A description of what info would be helpful to the agent' }
+	 * }
+	 */
+	inputSchema?: {
+		prompt?: {
+			type: "string";
+			description?: string;
+		};
+		params?: JsonObjectSchema;
+	};
+	/** How the agent should output a response to its parent (defaults to 'last_message')
+	 *
+	 * last_message: The last message from the agent, typically after using tools.
+	 *
+	 * all_messages: All messages from the agent, including tool calls and results.
+	 *
+	 * structured_output: Make the agent output a JSON object. Can be used with outputSchema or without if you want freeform json output.
+	 */
+	outputMode?: "last_message" | "all_messages" | "structured_output";
+	/** JSON schema for structured output (when outputMode is 'structured_output') */
+	outputSchema?: JsonObjectSchema;
+	/** Prompt for when and why to spawn this agent. Include the main purpose and use cases.
+	 *
+	 * This field is key if the agent is intended to be spawned by other agents. */
+	spawnerPrompt?: string;
+	/** Whether to include conversation history from the parent agent in context.
+	 *
+	 * Defaults to false.
+	 * Use this when the agent needs to know all the previous messages in the conversation.
+	 */
+	includeMessageHistory?: boolean;
+	/** Whether to inherit the parent agent's system prompt instead of using this agent's own systemPrompt.
+	 *
+	 * Defaults to false.
+	 * Use this when you want to enable prompt caching by preserving the same system prompt prefix.
+	 * Cannot be used together with the systemPrompt field.
+	 */
+	inheritParentSystemPrompt?: boolean;
+	/** Opt in to windowed file reads: read_files accepts { path, offset, limit }
+	 * entries, whole-file reads are capped per file, glob results are capped, and
+	 * the read_files/code_search tool descriptions teach a search-first reading
+	 * style. Defaults to false, which keeps the legacy read behavior.
+	 */
+	windowedFileReads?: boolean;
+	/** Opt in to mechanical context compaction: the runtime rewrites old history
+	 * into a condensed summary before the next step. Defaults to false.
+	 *
+	 * Compaction runs when the context grows past the model's budget, and also
+	 * once the prompt cache has gone cold — the next request re-reads the whole
+	 * history at full price anyway, so rewriting it there is free. Pass
+	 * `{ cacheExpiryMs }` to tune that idle threshold, or `{ cacheExpiryMs: null }`
+	 * to compact on the context limit only.
+	 *
+	 * The cold-cache pass is skipped on a context smaller than
+	 * `cacheExpiryMinTokens`, since compaction always costs detail and a small
+	 * history has little to reclaim. Pass null to take it at any size. The
+	 * context-limit pass ignores this floor.
+	 */
+	compactContext?: boolean | {
+		cacheExpiryMs?: number | null;
+		cacheExpiryMinTokens?: number | null;
+	};
+	/** Background information for the agent. Fairly optional. Prefer using instructionsPrompt for agent instructions. */
+	systemPrompt?: string;
+	/** Instructions for the agent.
+	 *
+	 * IMPORTANT: Updating this prompt is the best way to shape the agent's behavior.
+	 * This prompt is inserted after each user input. */
+	instructionsPrompt?: string;
+	/** Prompt inserted at each agent step.
+	 *
+	 * Powerful for changing the agent's behavior, but usually not necessary for smart models.
+	 * Prefer instructionsPrompt for most instructions. */
+	stepPrompt?: string;
+	/** Programmatically step the agent forward and run tools.
+	 *
+	 * You can either yield:
+	 * - A tool call object with toolName and input properties.
+	 * - 'STEP' to run agent's model and generate one assistant message.
+	 * - 'STEP_ALL' to run the agent's model until it uses the end_turn tool or stops includes no tool calls in a message.
+	 *
+	 * Or use 'return' to end the turn.
+	 *
+	 * Example 1:
+	 * function* handleSteps({ agentState, prompt, params, logger }) {
+	 *   logger.info('Starting file read process')
+	 *   const { toolResult } = yield {
+	 *     toolName: 'read_files',
+	 *     input: { paths: ['file1.txt', 'file2.txt'] }
+	 *   }
+	 *   yield 'STEP_ALL'
+	 *
+	 *   // Optionally do a post-processing step here...
+	 *   logger.info('Files read successfully, setting output')
+	 *   yield {
+	 *     toolName: 'set_output',
+	 *     input: {
+	 *       output: 'The files were read successfully.',
+	 *     },
+	 *   }
+	 * }
+	 *
+	 * Example 2:
+	 * handleSteps: function* ({ agentState, prompt, params, logger }) {
+	 *   while (true) {
+	 *     logger.debug('Spawning thinker agent')
+	 *     yield {
+	 *       toolName: 'spawn_agents',
+	 *       input: {
+	 *         agents: [
+	 *         {
+	 *           agent_type: 'thinker',
+	 *           prompt: 'Think deeply about the user request',
+	 *         },
+	 *       ],
+	 *     },
+	 *   }
+	 *   const { stepsComplete } = yield 'STEP'
+	 *   if (stepsComplete) break
+	 * }
+	 * }
+	 */
+	handleSteps?: (context: AgentStepContext) => Generator<ToolCall | "STEP" | "STEP_ALL" | StepText | GenerateN, void, {
+		agentState: AgentState;
+		toolResult: ToolResultOutput$1[] | undefined;
+		stepsComplete: boolean;
+		nResponses?: string[];
+	}>;
+}
+interface AgentState {
+	agentId: string;
+	runId: string;
+	parentId: string | undefined;
+	/** The agent's conversation history: messages from the user and the assistant. */
+	messageHistory: Message$1[];
+	/** The last value set by the set_output tool. This is a plain object or undefined if not set. */
+	output: Record<string, any> | undefined;
+	/** The system prompt for this agent. */
+	systemPrompt: string;
+	/** The tool definitions for this agent. */
+	toolDefinitions: Record<string, {
+		description: string | undefined;
+		inputSchema: {};
+	}>;
+	/**
+	 * The token count from the Anthropic API.
+	 * This is updated on every agent step via the /api/v1/token-count endpoint.
+	 */
+	contextTokenCount: number;
+}
+interface AgentStepContext {
+	agentState: AgentState;
+	prompt?: string;
+	params?: Record<string, any>;
+	/**
+	 * The model this step is running on, after any per-request override of the
+	 * definition's `model`. `handleSteps` is serialized with `toString()`, so a
+	 * generator cannot close over request-time state — read the model here
+	 * instead (e.g. to size a context budget to the model's window).
+	 *
+	 * Supplied by the runtime; optional so a generator invoked directly (tests)
+	 * or run on an older runtime degrades rather than throwing. Treat
+	 * `undefined` as "unknown model" and pick a safe default.
+	 */
+	model?: string;
+	logger: Logger;
+}
+type StepText = {
+	type: "STEP_TEXT";
+	text: string;
+};
+type GenerateN = {
+	type: "GENERATE_N";
+	n: number;
+};
+type ToolCall<T extends ToolName$1 = ToolName$1> = {
+	[K in T]: {
+		toolName: K;
+		input: GetToolParams<K>;
+		includeToolCall?: boolean;
+	};
+}[T];
+type ModelName = "openai/gpt-5.3" | "openai/gpt-5.3-codex" | "openai/gpt-5.2" | "openai/gpt-5.1" | "openai/gpt-5.1-chat" | "openai/gpt-5-mini" | "openai/gpt-5-nano" | "anthropic/claude-fable-5" | "anthropic/claude-opus-5" | "anthropic/claude-sonnet-4.6" | "anthropic/claude-opus-4.8" | "anthropic/claude-opus-4.7" | "anthropic/claude-opus-4.6" | "anthropic/claude-opus-4.5" | "anthropic/claude-haiku-4.5" | "anthropic/claude-sonnet-4.5" | "anthropic/claude-opus-4.1" | "google/gemini-3.1-pro-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-flash-preview" | "google/gemini-3.5-flash-lite" | "google/gemini-3.1-flash-lite" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "qwen/qwen3-max" | "qwen/qwen3-coder-plus" | "qwen/qwen3-coder" | "qwen/qwen3-coder:nitro" | "qwen/qwen3-coder-flash" | "qwen/qwen3-235b-a22b-2507" | "qwen/qwen3-235b-a22b-2507:nitro" | "qwen/qwen3-235b-a22b-thinking-2507" | "qwen/qwen3-235b-a22b-thinking-2507:nitro" | "qwen/qwen3-30b-a3b" | "qwen/qwen3-30b-a3b:nitro" | "deepseek/deepseek-v4-pro" | "deepseek-v4-pro" | "deepseek/deepseek-v4-flash" | "deepseek-v4-flash" | "deepseek/deepseek-chat-v3-0324" | "deepseek/deepseek-chat-v3-0324:nitro" | "deepseek/deepseek-r1-0528" | "deepseek/deepseek-r1-0528:nitro" | "mimo/mimo-v2.5" | "mimo-v2.5" | "mimo/mimo-v2.5-pro" | "mimo-v2.5-pro" | "moonshotai/kimi-k2" | "moonshotai/kimi-k2:nitro" | "moonshotai/kimi-k2.6" | "moonshotai/kimi-k2.7-code" | "z-ai/glm-5" | "z-ai/glm-5.1" | "z-ai/glm-4.6" | "z-ai/glm-4.6:nitro" | "z-ai/glm-4.7" | "z-ai/glm-4.7:nitro" | "z-ai/glm-4.7-flash" | "z-ai/glm-4.7-flash:nitro" | "minimax/minimax-m2.5" | "minimax/minimax-m3" | (string & {});
+type LoggerFn = (data: unknown, msg?: string, ...args: unknown[]) => unknown;
+type Logger$1 = {
+	debug: LoggerFn;
+	info: LoggerFn;
+	warn: LoggerFn;
+	error: LoggerFn;
+};
+/** File system used for Anvil SDK.
+ *
+ * Compatible with `fs.promises` from the `'fs'` module.
+ */
+export type AnvilFileSystem = Pick<typeof fs.promises, "mkdir" | "readdir" | "readFile" | "stat" | "unlink" | "writeFile">;
+declare const SkillDefinitionSchema: z.ZodObject<{
+	name: z.ZodString;
+	description: z.ZodString;
+	license: z.ZodOptional<z.ZodString>;
+	disableModelInvocation: z.ZodOptional<z.ZodBoolean>;
+	metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+	content: z.ZodString;
+	filePath: z.ZodString;
+}, z.core.$strip>;
+export type SkillDefinition = z.infer<typeof SkillDefinitionSchema>;
+/**
+ * Collection of skills keyed by skill name.
+ */
+export type SkillsMap = Record<string, SkillDefinition>;
+interface FileTreeNode {
+	name: string;
+	type: "file" | "directory";
+	filePath: string;
+	lastReadTime?: number;
+	children?: FileTreeNode[];
+}
+declare const customToolDefinitionsSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+	inputSchema: z.ZodCustom<Record<string, unknown> | z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, Record<string, unknown> | z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+	endsAgentStep: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+	description: z.ZodOptional<z.ZodString>;
+	exampleInputs: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+}, z.core.$strip>>>;
+type CustomToolDefinitions = NonNullable<z.input<typeof customToolDefinitionsSchema>>;
+type ProjectFileContext = {
+	projectRoot: string;
+	cwd: string;
+	fileTree: FileTreeNode[];
+	fileTokenScores: Record<string, Record<string, number>>;
+	tokenCallers?: Record<string, Record<string, string[]>>;
+	knowledgeFiles: Record<string, string>;
+	userKnowledgeFiles?: Record<string, string>;
+	agentTemplates: Record<string, any>;
+	customToolDefinitions: CustomToolDefinitions;
+	skills?: SkillsMap;
+	gitChanges: {
+		status: string;
+		diff: string;
+		diffCached: string;
+		lastCommitMessages: string;
+	};
+	changesSinceLastChat: Record<string, string>;
+	shellConfigFiles: Record<string, string>;
+	systemInfo: {
+		platform: string;
+		shell: string;
+		nodeVersion: string;
+		arch: string;
+		homedir: string;
+		cpus: number;
+		chromeAvailable: boolean;
+	};
+};
+declare const toolCallSchema: z.ZodObject<{
+	toolName: z.ZodString;
+	toolCallId: z.ZodString;
+	input: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+type ToolCall$1 = z.infer<typeof toolCallSchema>;
+declare const subgoalSchema: z.ZodObject<{
+	objective: z.ZodOptional<z.ZodString>;
+	status: z.ZodOptional<z.ZodEnum<{
+		NOT_STARTED: "NOT_STARTED";
+		IN_PROGRESS: "IN_PROGRESS";
+		COMPLETE: "COMPLETE";
+		ABORTED: "ABORTED";
+	}>>;
+	plan: z.ZodOptional<z.ZodString>;
+	logs: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type Subgoal = z.infer<typeof subgoalSchema>;
+type AgentState$1 = {
+	/**
+	 * @deprecated agentId is replaced by runId
+	 */
+	agentId: string;
+	agentType: AgentTemplateType | null;
+	agentContext: Record<string, Subgoal>;
+	ancestorRunIds: string[];
+	runId?: string;
+	subagents: AgentState$1[];
+	childRunIds: string[];
+	messageHistory: Message[];
+	stepsRemaining: number;
+	creditsUsed: number;
+	directCreditsUsed: number;
+	output?: Record<string, any>;
+	parentId?: string;
+	systemPrompt: string;
+	toolDefinitions: Record<string, {
+		description: string | undefined;
+		inputSchema: {};
+	}>;
+	/**
+	 * The accurate token count from the Anthropic API.
+	 * This is updated on every agent step via the /api/v1/token-count endpoint.
+	 */
+	contextTokenCount: number;
+};
+declare const AgentOutputSchema: z.ZodDiscriminatedUnion<[
+	z.ZodObject<{
+		type: z.ZodLiteral<"structuredOutput">;
+		value: z.ZodUnion<[
+			z.ZodRecord<z.ZodString, z.ZodAny>,
+			z.ZodNull
+		]>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"lastMessage">;
+		value: z.ZodArray<z.ZodAny>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"allMessages">;
+		value: z.ZodArray<z.ZodAny>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		type: z.ZodLiteral<"error">;
+		message: z.ZodString;
+		statusCode: z.ZodOptional<z.ZodNumber>;
+		error: z.ZodOptional<z.ZodString>;
+		countryCode: z.ZodOptional<z.ZodString>;
+		countryBlockReason: z.ZodOptional<z.ZodString>;
+		ipPrivacySignals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+	}, z.core.$strip>
+], "type">;
+type AgentOutput = z.infer<typeof AgentOutputSchema>;
+declare const agentTemplateTypeSchema: z.ZodEnum<{
+	base: "base";
+	base_free: "base_free";
+	base_max: "base_max";
+	base_experimental: "base_experimental";
+	claude4_gemini_thinking: "claude4_gemini_thinking";
+	superagent: "superagent";
+	base_agent_builder: "base_agent_builder";
+	ask: "ask";
+	planner: "planner";
+	dry_run: "dry_run";
+	thinker: "thinker";
+	file_picker: "file_picker";
+	file_explorer: "file_explorer";
+	researcher: "researcher";
+	reviewer: "reviewer";
+	agent_builder: "agent_builder";
+	example_programmatic: "example_programmatic";
+}>;
+type AgentTemplateType = z.infer<typeof agentTemplateTypeSchema> | (string & {});
+type SessionState = {
+	fileContext: ProjectFileContext;
+	mainAgentState: AgentState$1;
+};
+type AnvilSpawn = (command: string, args?: readonly string[], options?: SpawnOptions) => ChildProcess;
+export type RunState = {
+	sessionState?: SessionState;
+	output: AgentOutput;
+	traceSessionId: string;
+};
+/** Result of indexing `projectFiles`: the file tree plus tree-sitter token
+ *  scores. Deterministic for a given file set, so hosts that run many
+ *  sessions over the same files (e.g. the Anvil web runner, one process
+ *  serving consecutive turns of a thread) can compute it once with
+ *  `computeProjectIndexFromFiles` and pass it back via the `projectIndex`
+ *  option instead of paying the tree-sitter parse (CPU + wasm memory) on
+ *  every run. */
+export type ComputedProjectIndex = {
+	fileTree: FileTreeNode[];
+	fileTokenScores: Record<string, any>;
+	tokenCallers: Record<string, any>;
+};
+export type InitialSessionStateOptions = {
+	cwd?: string;
+	/** Optional directory path to load skills from. When provided, skills are loaded from this directory instead of the default locations. */
+	skillsDir?: string;
+	projectFiles?: Record<string, string>;
+	/** Precomputed index for exactly these `projectFiles` (see
+	 *  ComputedProjectIndex). Ignored when `projectFiles` is absent. */
+	projectIndex?: ComputedProjectIndex;
+	knowledgeFiles?: Record<string, string>;
+	/** User-provided knowledge files that will be merged with home directory files */
+	userKnowledgeFiles?: Record<string, string>;
+	agentDefinitions?: AgentDefinition[];
+	customToolDefinitions?: CustomToolDefinition[];
+	maxAgentSteps?: number;
+	fs?: AnvilFileSystem;
+	spawn?: AnvilSpawn;
+	logger?: Logger$1;
+};
+/**
+ * Standalone version of the index build `run()` performs internally when
+ * given `projectFiles`. Hosts can call this once per distinct file set and
+ * feed the result to subsequent runs via the `projectIndex` option.
+ */
+export declare function computeProjectIndexFromFiles(params: {
+	cwd: string;
+	projectFiles: Record<string, string>;
+}): Promise<ComputedProjectIndex>;
+export declare function initialSessionState(params: InitialSessionStateOptions): Promise<SessionState>;
+export declare function generateInitialRunState({ cwd, skillsDir, projectFiles, knowledgeFiles, userKnowledgeFiles, agentDefinitions, customToolDefinitions, maxAgentSteps, fs, }: {
+	cwd: string;
+	skillsDir?: string;
+	projectFiles?: Record<string, string>;
+	knowledgeFiles?: Record<string, string>;
+	userKnowledgeFiles?: Record<string, string>;
+	agentDefinitions?: AgentDefinition[];
+	customToolDefinitions?: CustomToolDefinition[];
+	maxAgentSteps?: number;
+	fs: AnvilFileSystem;
+}): Promise<RunState>;
+export declare function withAdditionalMessage({ runState, message, }: {
+	runState: RunState;
+	message: Message;
+}): RunState;
+export declare function withMessageHistory({ runState, messages, }: {
+	runState: RunState;
+	messages: Message[];
+}): RunState;
+/**
+ * Applies overrides to an existing session state, allowing specific fields to be updated
+ * even when continuing from a previous run.
+ */
+export declare function applyOverridesToSessionState(cwd: string | undefined, baseSessionState: SessionState, overrides: {
+	projectFiles?: Record<string, string>;
+	/** Precomputed index for exactly these `projectFiles` (see
+	 *  ComputedProjectIndex). Ignored when `projectFiles` is absent. */
+	projectIndex?: ComputedProjectIndex;
+	knowledgeFiles?: Record<string, string>;
+	agentDefinitions?: AgentDefinition[];
+	customToolDefinitions?: CustomToolDefinition[];
+	maxAgentSteps?: number;
+}): Promise<SessionState>;
+declare const toolParams: {
+	composio_manage_connections: {
+		toolName: "composio_manage_connections";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			toolkits: z.ZodArray<z.ZodString>;
+			reinitiate_all: z.ZodOptional<z.ZodBoolean>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown, z.core.$ZodTypeInternals<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	composio_multi_execute_tool: {
+		toolName: "composio_multi_execute_tool";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			thought: z.ZodOptional<z.ZodString>;
+			sync_response_to_workbench: z.ZodDefault<z.ZodBoolean>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown, z.core.$ZodTypeInternals<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	composio_search_tools: {
+		toolName: "composio_search_tools";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			queries: z.ZodArray<z.ZodUnknown>;
+			session: z.ZodObject<{
+				generate_id: z.ZodOptional<z.ZodBoolean>;
+				id: z.ZodOptional<z.ZodString>;
+			}, z.core.$catchall<z.ZodUnknown>>;
+			model: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown, z.core.$ZodTypeInternals<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	composio_get_tool_schemas: {
+		toolName: "composio_get_tool_schemas";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			tool_slugs: z.ZodArray<z.ZodString>;
+			include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown, z.core.$ZodTypeInternals<z.core.util.JSONType | {
+					errorMessage: string;
+					status?: number | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	add_message: {
+		toolName: "add_message";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			role: z.ZodEnum<{
+				user: "user";
+				assistant: "assistant";
+			}>;
+			content: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	add_subgoal: {
+		toolName: "add_subgoal";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			id: z.ZodString;
+			objective: z.ZodString;
+			status: z.ZodEnum<{
+				NOT_STARTED: "NOT_STARTED";
+				IN_PROGRESS: "IN_PROGRESS";
+				COMPLETE: "COMPLETE";
+				ABORTED: "ABORTED";
+			}>;
+			plan: z.ZodOptional<z.ZodString>;
+			log: z.ZodOptional<z.ZodString>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	apply_patch: {
+		toolName: "apply_patch";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			operation: z.ZodDiscriminatedUnion<[
+				z.ZodObject<{
+					type: z.ZodLiteral<"create_file">;
+					path: z.ZodString;
+					diff: z.ZodString;
+				}, z.core.$strip>,
+				z.ZodObject<{
+					type: z.ZodLiteral<"update_file">;
+					path: z.ZodString;
+					diff: z.ZodString;
+				}, z.core.$strip>,
+				z.ZodObject<{
+					type: z.ZodLiteral<"delete_file">;
+					path: z.ZodString;
+				}, z.core.$strip>
+			], "type">;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+					applied: {
+						file: string;
+						action: "add" | "update" | "delete";
+					}[];
+				} | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+					applied: {
+						file: string;
+						action: "add" | "update" | "delete";
+					}[];
+				} | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	ask_user: {
+		toolName: "ask_user";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			questions: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+				question: z.ZodString;
+				header: z.ZodOptional<z.ZodString>;
+				options: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+					label: z.ZodString;
+					description: z.ZodOptional<z.ZodString>;
+				}, z.core.$strip>>>;
+				multiSelect: z.ZodDefault<z.ZodBoolean>;
+				validation: z.ZodOptional<z.ZodObject<{
+					maxLength: z.ZodOptional<z.ZodNumber>;
+					minLength: z.ZodOptional<z.ZodNumber>;
+					pattern: z.ZodOptional<z.ZodString>;
+					patternError: z.ZodOptional<z.ZodString>;
+				}, z.core.$strip>>;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					answers?: {
+						questionIndex: number;
+						selectedOption?: string | undefined;
+						selectedOptions?: string[] | undefined;
+						otherText?: string | undefined;
+					}[] | undefined;
+					skipped?: boolean | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					answers?: {
+						questionIndex: number;
+						selectedOption?: string | undefined;
+						selectedOptions?: string[] | undefined;
+						otherText?: string | undefined;
+					}[] | undefined;
+					skipped?: boolean | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	browser_logs: {
+		toolName: "browser_logs";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			type: z.ZodString;
+			url: z.ZodString;
+			waitUntil: z.ZodOptional<z.ZodEnum<{
+				networkidle0: "networkidle0";
+				load: "load";
+				domcontentloaded: "domcontentloaded";
+			}>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					success: boolean;
+					logs: {
+						type: "error" | "debug" | "info" | "warning" | "verbose";
+						message: string;
+						timestamp: number;
+						source: "tool" | "browser";
+						location?: string | undefined;
+						stack?: string | undefined;
+						category?: string | undefined;
+						level?: number | undefined;
+					}[];
+					error?: string | undefined;
+					logFilter?: {
+						types?: ("error" | "debug" | "info" | "warning" | "verbose")[] | undefined;
+						minLevel?: number | undefined;
+						categories?: string[] | undefined;
+					} | undefined;
+					networkEvents?: {
+						url: string;
+						method: string;
+						timestamp: number;
+						status?: number | undefined;
+						errorText?: string | undefined;
+					}[] | undefined;
+					metrics?: {
+						loadTime: number;
+						memoryUsage: number;
+						jsErrors: number;
+						networkErrors: number;
+						ttfb?: number | undefined;
+						lcp?: number | undefined;
+						fcp?: number | undefined;
+						domContentLoaded?: number | undefined;
+						sessionDuration?: number | undefined;
+					} | undefined;
+					screenshots?: {
+						post: {
+							type: "image";
+							source: {
+								type: "base64";
+								media_type: "image/jpeg";
+								data: string;
+							};
+						};
+						pre?: {
+							type: "image";
+							source: {
+								type: "base64";
+								media_type: "image/jpeg";
+								data: string;
+							};
+						} | undefined;
+					} | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					success: boolean;
+					logs: {
+						type: "error" | "debug" | "info" | "warning" | "verbose";
+						message: string;
+						timestamp: number;
+						source: "tool" | "browser";
+						location?: string | undefined;
+						stack?: string | undefined;
+						category?: string | undefined;
+						level?: number | undefined;
+					}[];
+					error?: string | undefined;
+					logFilter?: {
+						types?: ("error" | "debug" | "info" | "warning" | "verbose")[] | undefined;
+						minLevel?: number | undefined;
+						categories?: string[] | undefined;
+					} | undefined;
+					networkEvents?: {
+						url: string;
+						method: string;
+						timestamp: number;
+						status?: number | undefined;
+						errorText?: string | undefined;
+					}[] | undefined;
+					metrics?: {
+						loadTime: number;
+						memoryUsage: number;
+						jsErrors: number;
+						networkErrors: number;
+						ttfb?: number | undefined;
+						lcp?: number | undefined;
+						fcp?: number | undefined;
+						domContentLoaded?: number | undefined;
+						sessionDuration?: number | undefined;
+					} | undefined;
+					screenshots?: {
+						post: {
+							type: "image";
+							source: {
+								type: "base64";
+								media_type: "image/jpeg";
+								data: string;
+							};
+						};
+						pre?: {
+							type: "image";
+							source: {
+								type: "base64";
+								media_type: "image/jpeg";
+								data: string;
+							};
+						} | undefined;
+					} | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	code_search: {
+		toolName: "code_search";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			pattern: z.ZodString;
+			flags: z.ZodOptional<z.ZodString>;
+			cwd: z.ZodOptional<z.ZodString>;
+			maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					stdout: string;
+					message: string;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					stdout: string;
+					message: string;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	cloud_plan_ready: {
+		toolName: "cloud_plan_ready";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			summary: z.ZodString;
+			stack: z.ZodArray<z.ZodString>;
+			build_prompt: z.ZodString;
+			required_integrations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+				search_id: z.ZodString;
+				slug: z.ZodString;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	create_plan: {
+		toolName: "create_plan";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+			plan: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	end_turn: {
+		toolName: "end_turn";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	find_files: {
+		toolName: "find_files";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			prompt: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<({
+					path: string;
+					content: string;
+					referencedBy?: Record<string, string[]> | undefined;
+				} | {
+					path: string;
+					contentOmittedForLength: true;
+				})[] | {
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<({
+					path: string;
+					content: string;
+					referencedBy?: Record<string, string[]> | undefined;
+				} | {
+					path: string;
+					contentOmittedForLength: true;
+				})[] | {
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	glob: {
+		toolName: "glob";
+		description: string;
+		endsAgentStep: false;
+		inputSchema: z.ZodObject<{
+			pattern: z.ZodString;
+			cwd: z.ZodOptional<z.ZodString>;
+			max_results: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					files: string[];
+					count: number;
+					message: string;
+				} | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					files: string[];
+					count: number;
+					message: string;
+				} | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	gravity_index: {
+		toolName: "gravity_index";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			action: z.ZodEnum<{
+				search: "search";
+				browse: "browse";
+				list_categories: "list_categories";
+				get_service: "get_service";
+				report_integration: "report_integration";
+			}>;
+			query: z.ZodOptional<z.ZodString>;
+			search_id: z.ZodOptional<z.ZodString>;
+			context: z.ZodOptional<z.ZodType<JSONObject, unknown, z.core.$ZodTypeInternals<JSONObject, unknown>>>;
+			category: z.ZodOptional<z.ZodString>;
+			q: z.ZodOptional<z.ZodString>;
+			slug: z.ZodOptional<z.ZodString>;
+			integrated_slug: z.ZodOptional<z.ZodString>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<JSONObject | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<JSONObject | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	list_directory: {
+		toolName: "list_directory";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					files: string[];
+					directories: string[];
+					path: string;
+				} | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					files: string[];
+					directories: string[];
+					path: string;
+				} | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	lookup_agent_info: {
+		toolName: "lookup_agent_info";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			agentId: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	propose_str_replace: {
+		toolName: "propose_str_replace";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+			replacements: z.ZodPreprocess<z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+				oldString: z.ZodString;
+				newString: z.ZodString;
+				allowMultiple: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+			}, z.core.$strip>>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					file: string;
+					message: string;
+					unifiedDiff: string;
+				} | {
+					file: string;
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					file: string;
+					message: string;
+					unifiedDiff: string;
+				} | {
+					file: string;
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	propose_write_file: {
+		toolName: "propose_write_file";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+			instructions: z.ZodString;
+			content: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					file: string;
+					message: string;
+					unifiedDiff: string;
+				} | {
+					file: string;
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					file: string;
+					message: string;
+					unifiedDiff: string;
+				} | {
+					file: string;
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	read_docs: {
+		toolName: "read_docs";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			libraryTitle: z.ZodString;
+			topic: z.ZodString;
+			max_tokens: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					documentation: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					documentation: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	read_files: {
+		toolName: "read_files";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			paths: z.ZodPreprocess<z.ZodArray<z.ZodUnion<readonly [
+				z.ZodString,
+				z.ZodObject<{
+					path: z.ZodString;
+					offset: z.ZodOptional<z.ZodNumber>;
+					limit: z.ZodOptional<z.ZodNumber>;
+				}, z.core.$strip>
+			]>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<({
+					path: string;
+					content: string;
+					referencedBy?: Record<string, string[]> | undefined;
+				} | {
+					path: string;
+					contentOmittedForLength: true;
+				})[], unknown, z.core.$ZodTypeInternals<({
+					path: string;
+					content: string;
+					referencedBy?: Record<string, string[]> | undefined;
+				} | {
+					path: string;
+					contentOmittedForLength: true;
+				})[], unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	read_subtree: {
+		toolName: "read_subtree";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			paths: z.ZodOptional<z.ZodPreprocess<z.ZodArray<z.ZodString>>>;
+			maxTokens: z.ZodDefault<z.ZodNumber>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<({
+					path: string;
+					type: "directory";
+					printedTree: string;
+					tokenCount: number;
+					truncationLevel: "none" | "unimportant-files" | "tokens" | "depth-based";
+				} | {
+					path: string;
+					type: "file";
+					variables: string[];
+				} | {
+					path: string;
+					errorMessage: string;
+				})[], unknown, z.core.$ZodTypeInternals<({
+					path: string;
+					type: "directory";
+					printedTree: string;
+					tokenCount: number;
+					truncationLevel: "none" | "unimportant-files" | "tokens" | "depth-based";
+				} | {
+					path: string;
+					type: "file";
+					variables: string[];
+				} | {
+					path: string;
+					errorMessage: string;
+				})[], unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	read_url: {
+		toolName: "read_url";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			url: z.ZodURL;
+			max_chars: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					url: string;
+					finalUrl: string;
+					status: number;
+					text: string;
+					truncated: boolean;
+					contentType?: string | undefined;
+					title?: string | undefined;
+					description?: string | undefined;
+				} | {
+					errorMessage: string;
+					url?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					url: string;
+					finalUrl: string;
+					status: number;
+					text: string;
+					truncated: boolean;
+					contentType?: string | undefined;
+					title?: string | undefined;
+					description?: string | undefined;
+				} | {
+					errorMessage: string;
+					url?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	render_ui: {
+		toolName: "render_ui";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			widget: z.ZodDiscriminatedUnion<[
+				z.ZodObject<{
+					type: z.ZodLiteral<"button">;
+					text: z.ZodString;
+					variant: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+						primary: "primary";
+						secondary: "secondary";
+					}>>>;
+					link: z.ZodUnion<readonly [
+						z.ZodString,
+						z.ZodObject<{
+							source: z.ZodLiteral<"gravity_index">;
+							search_id: z.ZodString;
+							service_slug: z.ZodString;
+						}, z.core.$strip>
+					]>;
+				}, z.core.$strip>
+			], "type">;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	run_file_change_hooks: {
+		toolName: "run_file_change_hooks";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			files: z.ZodArray<z.ZodString>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<((({
+					command: string;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					stdout?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					stdoutOmittedForLength: true;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					processId: number;
+					backgroundProcessStatus: "error" | "running" | "completed";
+				} | {
+					command: string;
+					errorMessage: string;
+				}) & {
+					hookName: string;
+				}) | {
+					errorMessage: string;
+				})[], unknown, z.core.$ZodTypeInternals<((({
+					command: string;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					stdout?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					stdoutOmittedForLength: true;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					processId: number;
+					backgroundProcessStatus: "error" | "running" | "completed";
+				} | {
+					command: string;
+					errorMessage: string;
+				}) & {
+					hookName: string;
+				}) | {
+					errorMessage: string;
+				})[], unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	run_terminal_command: {
+		toolName: "run_terminal_command";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			command: z.ZodString;
+			process_type: z.ZodDefault<z.ZodEnum<{
+				SYNC: "SYNC";
+				BACKGROUND: "BACKGROUND";
+			}>>;
+			cwd: z.ZodOptional<z.ZodString>;
+			timeout_seconds: z.ZodPipe<z.ZodOptional<z.ZodDefault<z.ZodNumber>>, z.ZodTransform<number | undefined, number | undefined>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					command: string;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					stdout?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					stdoutOmittedForLength: true;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					processId: number;
+					backgroundProcessStatus: "error" | "running" | "completed";
+				} | {
+					command: string;
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					command: string;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					stdout?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					stdoutOmittedForLength: true;
+					startingCwd?: string | undefined;
+					message?: string | undefined;
+					stderr?: string | undefined;
+					exitCode?: number | undefined;
+				} | {
+					command: string;
+					processId: number;
+					backgroundProcessStatus: "error" | "running" | "completed";
+				} | {
+					command: string;
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	set_messages: {
+		toolName: "set_messages";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			messages: z.ZodAny;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	set_output: {
+		toolName: "set_output";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+		}, z.core.$loose>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	skill: {
+		toolName: "skill";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			name: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					name: string;
+					description: string;
+					content: string;
+					license?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					name: string;
+					description: string;
+					content: string;
+					license?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	spawn_agents: {
+		toolName: "spawn_agents";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			agents: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+				agent_type: z.ZodString;
+				prompt: z.ZodOptional<z.ZodString>;
+				params: z.ZodOptional<z.ZodPreprocess<z.ZodObject<{
+					command: z.ZodOptional<z.ZodString>;
+					what_to_summarize: z.ZodOptional<z.ZodString>;
+					timeout_seconds: z.ZodOptional<z.ZodNumber>;
+					searchQueries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+						pattern: z.ZodString;
+						flags: z.ZodOptional<z.ZodString>;
+						cwd: z.ZodOptional<z.ZodString>;
+						maxResults: z.ZodOptional<z.ZodNumber>;
+					}, z.core.$strip>>>;
+					filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+					directories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+					url: z.ZodOptional<z.ZodString>;
+					prompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+				}, z.core.$catchall<z.ZodAny>>>>;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<({
+					agentType: string;
+				} & JSONObject)[], unknown, z.core.$ZodTypeInternals<({
+					agentType: string;
+				} & JSONObject)[], unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	spawn_agent_inline: {
+		toolName: "spawn_agent_inline";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			agent_type: z.ZodString;
+			prompt: z.ZodOptional<z.ZodString>;
+			params: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	str_replace: {
+		toolName: "str_replace";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+			replacements: z.ZodPreprocess<z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+				oldString: z.ZodString;
+				newString: z.ZodString;
+				allowMultiple: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+			}, z.core.$strip>>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	suggest_followups: {
+		toolName: "suggest_followups";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			followups: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+				prompt: z.ZodString;
+				label: z.ZodOptional<z.ZodString>;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	task_completed: {
+		toolName: "task_completed";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	think_deeply: {
+		toolName: "think_deeply";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			thought: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+	update_subgoal: {
+		toolName: "update_subgoal";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			id: z.ZodString;
+			status: z.ZodOptional<z.ZodEnum<{
+				NOT_STARTED: "NOT_STARTED";
+				IN_PROGRESS: "IN_PROGRESS";
+				COMPLETE: "COMPLETE";
+				ABORTED: "ABORTED";
+			}>>;
+			plan: z.ZodOptional<z.ZodString>;
+			log: z.ZodOptional<z.ZodString>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					message: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					message: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	screenshot: {
+		toolName: "screenshot";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			url: z.ZodString;
+			output_path: z.ZodOptional<z.ZodString>;
+			width: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+			height: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+			full_page: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+			wait_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+			dark_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					success: boolean;
+					message: string;
+					width: number;
+					height: number;
+					output_path?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					success: boolean;
+					message: string;
+					width: number;
+					height: number;
+					output_path?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	vision_analyze: {
+		toolName: "vision_analyze";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			image_path: z.ZodString;
+			prompt: z.ZodString;
+			context: z.ZodOptional<z.ZodString>;
+			focus_areas: z.ZodOptional<z.ZodArray<z.ZodString>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					analysis: string;
+					issues_found: {
+						severity: "info" | "warning" | "critical";
+						area: string;
+						description: string;
+						suggestion: string;
+					}[];
+					score: number;
+					summary: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					analysis: string;
+					issues_found: {
+						severity: "info" | "warning" | "critical";
+						area: string;
+						description: string;
+						suggestion: string;
+					}[];
+					score: number;
+					summary: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	web_search: {
+		toolName: "web_search";
+		endsAgentStep: true;
+		description: string;
+		inputSchema: z.ZodObject<{
+			query: z.ZodString;
+			depth: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+				standard: "standard";
+				deep: "deep";
+			}>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					result: string;
+				} | {
+					errorMessage: string;
+				}, unknown, z.core.$ZodTypeInternals<{
+					result: string;
+				} | {
+					errorMessage: string;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	write_file: {
+		toolName: "write_file";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			path: z.ZodString;
+			instructions: z.ZodString;
+			content: z.ZodString;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodType<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown, z.core.$ZodTypeInternals<{
+					file: string;
+					message: string;
+				} | {
+					file: string;
+					errorMessage: string;
+					patch?: string | undefined;
+				}, unknown>>;
+			}, z.core.$strip>
+		], null>;
+	};
+	write_todos: {
+		toolName: "write_todos";
+		endsAgentStep: false;
+		description: string;
+		inputSchema: z.ZodObject<{
+			todos: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+				task: z.ZodString;
+				completed: z.ZodBoolean;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+		outputSchema: z.ZodTuple<[
+			z.ZodObject<{
+				type: z.ZodLiteral<"json">;
+				value: z.ZodObject<{
+					message: z.ZodString;
+				}, z.core.$strip>;
+			}, z.core.$strip>
+		], null>;
+	};
+};
+export type AnvilToolOutput<T extends ToolName = ToolName> = {
+	[K in ToolName]: K extends ToolName ? z.infer<(typeof toolParams)[K]["outputSchema"]> : never;
+}[T];
+declare const clientToolCallSchema: z.ZodDiscriminatedUnion<[
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"apply_patch">;
+		input: z.ZodObject<{
+			operation: z.ZodDiscriminatedUnion<[
+				z.ZodObject<{
+					type: z.ZodLiteral<"create_file">;
+					path: z.ZodString;
+					diff: z.ZodString;
+				}, z.core.$strip>,
+				z.ZodObject<{
+					type: z.ZodLiteral<"update_file">;
+					path: z.ZodString;
+					diff: z.ZodString;
+				}, z.core.$strip>,
+				z.ZodObject<{
+					type: z.ZodLiteral<"delete_file">;
+					path: z.ZodString;
+				}, z.core.$strip>
+			], "type">;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"ask_user">;
+		input: z.ZodObject<{
+			questions: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+				question: z.ZodString;
+				header: z.ZodOptional<z.ZodString>;
+				options: z.ZodPreprocess<z.ZodArray<z.ZodObject<{
+					label: z.ZodString;
+					description: z.ZodOptional<z.ZodString>;
+				}, z.core.$strip>>>;
+				multiSelect: z.ZodDefault<z.ZodBoolean>;
+				validation: z.ZodOptional<z.ZodObject<{
+					maxLength: z.ZodOptional<z.ZodNumber>;
+					minLength: z.ZodOptional<z.ZodNumber>;
+					pattern: z.ZodOptional<z.ZodString>;
+					patternError: z.ZodOptional<z.ZodString>;
+				}, z.core.$strip>>;
+			}, z.core.$strip>>>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"browser_logs">;
+		input: z.ZodObject<{
+			type: z.ZodString;
+			url: z.ZodString;
+			waitUntil: z.ZodOptional<z.ZodEnum<{
+				networkidle0: "networkidle0";
+				load: "load";
+				domcontentloaded: "domcontentloaded";
+			}>>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"code_search">;
+		input: z.ZodObject<{
+			pattern: z.ZodString;
+			flags: z.ZodOptional<z.ZodString>;
+			cwd: z.ZodOptional<z.ZodString>;
+			maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"create_plan">;
+		input: z.ZodObject<{
+			type: z.ZodEnum<{
+				file: "file";
+				patch: "patch";
+			}>;
+			path: z.ZodString;
+			content: z.ZodString;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"glob">;
+		input: z.ZodObject<{
+			pattern: z.ZodString;
+			cwd: z.ZodOptional<z.ZodString>;
+			max_results: z.ZodOptional<z.ZodNumber>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"list_directory">;
+		input: z.ZodObject<{
+			path: z.ZodString;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"run_file_change_hooks">;
+		input: z.ZodObject<{
+			files: z.ZodArray<z.ZodString>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"read_url">;
+		input: z.ZodObject<{
+			url: z.ZodURL;
+			max_chars: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"run_terminal_command">;
+		input: z.ZodIntersection<z.ZodObject<{
+			command: z.ZodString;
+			process_type: z.ZodDefault<z.ZodEnum<{
+				SYNC: "SYNC";
+				BACKGROUND: "BACKGROUND";
+			}>>;
+			cwd: z.ZodOptional<z.ZodString>;
+			timeout_seconds: z.ZodPipe<z.ZodOptional<z.ZodDefault<z.ZodNumber>>, z.ZodTransform<number | undefined, number | undefined>>;
+		}, z.core.$strip>, z.ZodObject<{
+			mode: z.ZodEnum<{
+				user: "user";
+				assistant: "assistant";
+			}>;
+		}, z.core.$strip>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"str_replace">;
+		input: z.ZodObject<{
+			type: z.ZodEnum<{
+				file: "file";
+				patch: "patch";
+			}>;
+			path: z.ZodString;
+			content: z.ZodString;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"write_file">;
+		input: z.ZodObject<{
+			type: z.ZodEnum<{
+				file: "file";
+				patch: "patch";
+			}>;
+			path: z.ZodString;
+			content: z.ZodString;
+		}, z.core.$strip>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"composio_manage_connections">;
+		input: z.ZodObject<{
+			toolkits: z.ZodArray<z.ZodString>;
+			reinitiate_all: z.ZodOptional<z.ZodBoolean>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"composio_multi_execute_tool">;
+		input: z.ZodObject<{
+			tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+			thought: z.ZodOptional<z.ZodString>;
+			sync_response_to_workbench: z.ZodDefault<z.ZodBoolean>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"composio_search_tools">;
+		input: z.ZodObject<{
+			queries: z.ZodArray<z.ZodUnknown>;
+			session: z.ZodObject<{
+				generate_id: z.ZodOptional<z.ZodBoolean>;
+				id: z.ZodOptional<z.ZodString>;
+			}, z.core.$catchall<z.ZodUnknown>>;
+			model: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+	}, z.core.$strip>,
+	z.ZodObject<{
+		toolName: z.ZodLiteral<"composio_get_tool_schemas">;
+		input: z.ZodObject<{
+			tool_slugs: z.ZodArray<z.ZodString>;
+			include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+			session_id: z.ZodOptional<z.ZodString>;
+		}, z.core.$catchall<z.ZodUnknown>>;
+	}, z.core.$strip>
+], "toolName">;
+declare const clientToolNames: ("glob" | "composio_manage_connections" | "composio_multi_execute_tool" | "composio_search_tools" | "composio_get_tool_schemas" | "create_plan" | "apply_patch" | "ask_user" | "browser_logs" | "code_search" | "list_directory" | "read_url" | "run_file_change_hooks" | "run_terminal_command" | "str_replace" | "write_file")[];
+export type ClientToolName = (typeof clientToolNames)[number];
+export type ClientToolCall<T extends ClientToolName = ClientToolName> = Extract<z.infer<typeof clientToolCallSchema>, {
+	toolName: T;
+}> & Pick<ToolCallPart, "toolCallId" | "toolName" | "input" | "providerOptions">;
+type PublishedClientToolName = Extract<ClientToolName, PublishedToolName>;
+export type TerminalCommandSpawnRequest = {
+	executable: string;
+	args: string[];
+	cwd: string;
+	env: NodeJS.ProcessEnv;
+};
+/** A command process whose complete descendant tree has one owner. */
+export interface TerminalCommandProcess {
+	pid?: number;
+	stdout: Readable;
+	stderr: Readable;
+	/** Settles after stdout/stderr drain; brokers also finish tree cleanup. */
+	completion: Promise<number | null>;
+	kill(signal: NodeJS.Signals): void;
+	isAlive(): boolean;
+}
+/**
+ * Host-provided process boundary for interactive applications.
+ *
+ * A broker must start the requested executable without attaching it to the
+ * host's console and return a handle that owns the complete process tree.
+ * Headless SDK consumers can omit this and use the direct process runner.
+ */
+export interface TerminalCommandBroker {
+	start(request: TerminalCommandSpawnRequest): TerminalCommandProcess;
+}
+export type ActiveTerminalCommandProcess = {
+	pid: number;
+	processGroupId?: number;
+};
+/**
+ * Return the process IDs owned by in-flight terminal tools. Commands are
+ * started in their own process group on POSIX, where the group ID matches the
+ * child PID. No command text or environment is exposed: diagnostics are often
+ * pasted into bug reports and those values may contain secrets.
+ */
+export declare function getActiveTerminalCommandProcesses(): ActiveTerminalCommandProcess[];
+export declare function runTerminalCommand({ command, process_type, cwd, timeout_seconds, env, signal, terminalCommandBroker, }: {
+	command: string;
+	process_type: "SYNC" | "BACKGROUND";
+	cwd: string;
+	timeout_seconds: number;
+	env?: NodeJS.ProcessEnv;
+	signal?: AbortSignal;
+	terminalCommandBroker?: TerminalCommandBroker;
+}): Promise<AnvilToolOutput<"run_terminal_command">>;
+type GrantType = "free" | "referral" | "referral_legacy" | "subscription" | "purchase" | "admin" | "organization" | "ad";
+declare const mcpConfigSchema: z.ZodUnion<readonly [
+	z.ZodObject<{
+		type: z.ZodDefault<z.ZodEnum<{
+			http: "http";
+			sse: "sse";
+		}>>;
+		url: z.ZodString;
+		params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+		headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+	}, z.core.$strict>,
+	z.ZodObject<{
+		type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+		command: z.ZodString;
+		args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+		env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+	}, z.core.$strict>
+]>;
+type MCPConfig$1 = z.infer<typeof mcpConfigSchema>;
+type ServerActionResponseChunk = {
+	type: "response-chunk";
+	userInputId: string;
+	chunk: string | PrintModeEvent;
+};
+type ServerActionSubagentResponseChunk = {
+	type: "subagent-response-chunk";
+	userInputId: string;
+	agentId: string;
+	agentType: string;
+	chunk: string;
+	prompt?: string;
+	forwardToPrompt?: boolean;
+};
+type ServerActionHandleStepsLogChunk = {
+	type: "handlesteps-log-chunk";
+	userInputId: string;
+	agentId: string;
+	level: "debug" | "info" | "warn" | "error";
+	data: any;
+	message?: string;
+};
+type PromptResponse = {
+	type: "prompt-response";
+	promptId: string;
+	sessionState: SessionState;
+	toolCalls?: ToolCall$1[];
+	toolResults?: ToolMessage[];
+	output?: AgentOutput;
+};
+type ServerActionReadFiles = {
+	type: "read-files";
+	filePaths: string[];
+	requestId: string;
+};
+type ServerActionToolCallRequest = {
+	type: "tool-call-request";
+	userInputId: string;
+	requestId: string;
+	toolName: string;
+	input: Record<string, any>;
+	timeout?: number;
+	mcpConfig?: MCPConfig$1;
+};
+type InitResponse = {
+	type: "init-response";
+	message?: string;
+	agentNames?: Record<string, string>;
+} & Omit<UsageResponse, "type">;
+type UsageResponse = {
+	type: "usage-response";
+	usage: number;
+	remainingBalance: number;
+	balanceBreakdown?: Record<GrantType, number>;
+	next_quota_reset: Date | null;
+	autoTopupAdded?: number;
+	autoTopupEnabled?: boolean;
+};
+type MessageCostResponse = {
+	type: "message-cost-response";
+	promptId: string;
+	credits: number;
+	agentId?: string;
+};
+type ServerActionActionError = {
+	type: "action-error";
+	message: string;
+	error?: string;
+	remainingBalance?: number;
+};
+type ServerActionPromptError = {
+	type: "prompt-error";
+	userInputId: string;
+	message: string;
+	error?: string;
+	remainingBalance?: number;
+};
+type ServerActionRequestReconnect = {
+	type: "request-reconnect";
+};
+type ServerActionRequestMcpToolData = {
+	type: "request-mcp-tool-data";
+	requestId: string;
+	mcpConfig: MCPConfig$1;
+	toolNames?: string[];
+};
+type ServerActionAny = ServerActionResponseChunk | ServerActionSubagentResponseChunk | ServerActionHandleStepsLogChunk | PromptResponse | ServerActionReadFiles | ServerActionToolCallRequest | InitResponse | UsageResponse | MessageCostResponse | ServerActionActionError | ServerActionPromptError | ServerActionRequestReconnect | ServerActionRequestMcpToolData;
+type ServerActionType = ServerActionAny["type"];
+type ServerAction<T extends ServerActionType = ServerActionType> = {
+	[K in ServerActionType]: Extract<ServerActionAny, {
+		type: K;
+	}>;
+}[T];
+type FileReadWindow = {
+	offset?: number;
+	limit?: number;
+};
+type SendActionFn = (params: {
+	action: ServerAction;
+}) => void;
+export type FileFilterResult = {
+	status: "blocked" | "allow-example" | "allow";
+};
+export type FileFilter = (filePath: string) => FileFilterResult;
+export declare function getFiles(params: {
+	filePaths: string[];
+	cwd: string;
+	fs: AnvilFileSystem;
+	fileWindows?: Record<string, FileReadWindow[]>;
+	/**
+	 * Apply the user-facing read_files output budget. Internal edit tools need
+	 * the complete file so replacements below the display limit can still match.
+	 */
+	limitContent?: boolean;
+	/** Apply the read_files-only .env restriction. */
+	enforceEnvPolicy?: boolean;
+	/**
+	 * Filter to classify files before reading.
+	 * If provided, the caller takes control of additional filtering. The SDK's
+	 * read_files .env policy applies by default, including ordinary gitignore
+	 * checks for env templates.
+	 */
+	fileFilter?: FileFilter;
+}): Promise<{
+	[x: string]: string | null;
+}>;
+declare enum AnalyticsEvent {
+	MESSAGE_SENT = "message_sent",
+	PRODUCT_ACTIVE_MINUTE = "product_active_minute",
+	APP_LAUNCHED = "cli.app_launched",
+	FINGERPRINT_GENERATED = "cli.fingerprint_generated",
+	CHANGE_DIRECTORY = "cli.change_directory",
+	INVALID_COMMAND = "cli.invalid_command",
+	KNOWLEDGE_FILE_UPDATED = "cli.knowledge_file_updated",
+	LOGIN = "cli.login",
+	LOGIN_STARTED = "cli.login_started",
+	LOGIN_FAILED = "cli.login_failed",
+	LOGIN_TIMEOUT = "cli.login_timeout",
+	LOGIN_ABORTED = "cli.login_aborted",
+	SLASH_MENU_ACTIVATED = "cli.slash_menu_activated",
+	SLASH_COMMAND_USED = "cli.slash_command_used",
+	TERMINAL_BROKER_SPAWN_FAILED = "cli.terminal_broker_spawn_failed",
+	TERMINAL_WATCHDOG_FAILED = "cli.terminal_watchdog_failed",
+	TERMINAL_COMMAND_COMPLETED = "cli.terminal_command_completed",
+	USER_INPUT_COMPLETE = "cli.user_input_complete",
+	UPDATE_ANVIL_FAILED = "cli.update_anvil_failed",
+	FEEDBACK_BUTTON_HOVERED = "cli.feedback_button_hovered",
+	FOLLOWUP_CLICKED = "cli.followup_clicked",
+	SUGGESTED_PROMPT_SHOWN = "cli.suggested_prompt_shown",
+	SUGGESTED_PROMPT_CLICKED = "cli.suggested_prompt_clicked",
+	CLI_INLINE_AD_SLOT_ELIGIBLE = "cli.inline_ad_slot_eligible",
+	CLI_INLINE_AD_POOL_REUSED = "cli.inline_ad_pool_reused",
+	AGENT_STEP = "backend.agent_step",
+	CREDIT_GRANT = "backend.credit_grant",
+	CREDIT_CONSUMED = "backend.credit_consumed",
+	MALFORMED_TOOL_CALL_JSON = "backend.malformed_tool_call_json",
+	TOOL_USE = "backend.tool_use",
+	UNKNOWN_TOOL_CALL = "backend.unknown_tool_call",
+	USER_INPUT = "backend.user_input",
+	ADVISORY_LOCK_CONTENTION = "backend.advisory_lock_contention",
+	TRANSACTION_RETRY_THRESHOLD_EXCEEDED = "backend.transaction_retry_threshold_exceeded",
+	SUBSCRIPTION_CREATED = "backend.subscription_created",
+	SUBSCRIPTION_CANCELED = "backend.subscription_canceled",
+	SUBSCRIPTION_PAYMENT_FAILED = "backend.subscription_payment_failed",
+	SUBSCRIPTION_BLOCK_CREATED = "backend.subscription_block_created",
+	SUBSCRIPTION_BLOCK_LIMIT_HIT = "backend.subscription_block_limit_hit",
+	SUBSCRIPTION_WEEKLY_LIMIT_HIT = "backend.subscription_weekly_limit_hit",
+	SUBSCRIPTION_CREDITS_MIGRATED = "backend.subscription_credits_migrated",
+	SUBSCRIPTION_TIER_CHANGED = "backend.subscription_tier_changed",
+	SIGNUP = "web.signup",
+	AUTH_LOGIN_STARTED = "auth.login_started",
+	AUTH_LOGOUT_COMPLETED = "auth.logout_completed",
+	COOKIE_CONSENT_ACCEPTED = "cookie_consent.accepted",
+	COOKIE_CONSENT_DECLINED = "cookie_consent.declined",
+	ONBOARDING_STEP_COMPLETED = "onboarding_step_completed",
+	ONBOARDING_STEP_VIEWED = "onboarding_step_viewed",
+	ONBOARDING_PM_SELECTED = "onboarding_pm_selected",
+	ONBOARDING_EDITOR_OPENED = "onboarding_editor_opened",
+	ONBOARD_PAGE_CD_COMMAND_COPIED = "onboard_page.cd_command_copied",
+	ONBOARD_PAGE_RUN_COMMAND_COPIED = "onboard_page.run_command_copied",
+	ONBOARD_PAGE_INSTALL_COMMAND_COPIED = "onboard_page.install_command_copied",
+	ANVIL_REFERRER_ATTRIBUTED = "anvil.referrer_attributed",
+	INSTALL_DIALOG_CD_COMMAND_COPIED = "install_dialog.cd_command_copied",
+	INSTALL_DIALOG_RUN_COMMAND_COPIED = "install_dialog.run_command_copied",
+	INSTALL_DIALOG_INSTALL_COMMAND_COPIED = "install_dialog.install_command_copied",
+	HOME_FEATURE_LEARN_MORE_CLICKED = "home.feature_learn_more_clicked",
+	HOME_INSTALL_COMMAND_COPIED = "home.install_command_copied",
+	HOME_TRY_FREE_CLICKED = "home.try_free_clicked",
+	HOME_TESTIMONIAL_CLICKED = "home.testimonial_clicked",
+	HOME_CTA_INSTALL_GUIDE_CLICKED = "home.cta_install_guide_clicked",
+	HOME_COMPETITION_TAB_CHANGED = "home.competition_tab_changed",
+	DEMO_TERMINAL_COMMAND_EXECUTED = "demo_terminal.command_executed",
+	DEMO_TERMINAL_HELP_VIEWED = "demo_terminal.help_viewed",
+	DEMO_TERMINAL_OPTIMIZE_REQUESTED = "demo_terminal.optimize_requested",
+	DEMO_TERMINAL_FIX_MEMORY_LEAK = "demo_terminal.fix_memory_leak",
+	DEMO_TERMINAL_REFACTOR_REQUESTED = "demo_terminal.refactor_requested",
+	DEMO_TERMINAL_FEATURE_REQUESTED = "demo_terminal.feature_requested",
+	DEMO_TERMINAL_THEME_CHANGED = "demo_terminal.theme_changed",
+	TOAST_SHOWN = "toast.shown",
+	AGENT_RUN_API_REQUEST = "api.agent_run_request",
+	AGENT_RUN_CREATED = "api.agent_run_created",
+	AGENT_RUN_COMPLETED = "api.agent_run_completed",
+	AGENT_RUN_VALIDATION_ERROR = "api.agent_run_validation_error",
+	AGENT_RUN_CREATION_ERROR = "api.agent_run_creation_error",
+	AGENT_RUN_COMPLETION_ERROR = "api.agent_run_completion_error",
+	ME_API_REQUEST = "api.me_request",
+	ME_VALIDATION_ERROR = "api.me_validation_error",
+	CHAT_COMPLETIONS_REQUEST = "api.chat_completions_request",
+	CHAT_COMPLETIONS_AUTH_ERROR = "api.chat_completions_auth_error",
+	CHAT_COMPLETIONS_VALIDATION_ERROR = "api.chat_completions_validation_error",
+	CHAT_COMPLETIONS_INSUFFICIENT_CREDITS = "api.chat_completions_insufficient_credits",
+	CHAT_COMPLETIONS_GENERATION_STARTED = "api.chat_completions_generation_started",
+	CHAT_COMPLETIONS_STREAM_STARTED = "api.chat_completions_stream_started",
+	CHAT_COMPLETIONS_ERROR = "api.chat_completions_error",
+	USAGE_API_REQUEST = "api.usage_request",
+	USAGE_API_AUTH_ERROR = "api.usage_auth_error",
+	WEB_SEARCH_REQUEST = "api.web_search_request",
+	WEB_SEARCH_AUTH_ERROR = "api.web_search_auth_error",
+	WEB_SEARCH_VALIDATION_ERROR = "api.web_search_validation_error",
+	WEB_SEARCH_INSUFFICIENT_CREDITS = "api.web_search_insufficient_credits",
+	WEB_SEARCH_ERROR = "api.web_search_error",
+	DOCS_SEARCH_REQUEST = "api.docs_search_request",
+	DOCS_SEARCH_AUTH_ERROR = "api.docs_search_auth_error",
+	DOCS_SEARCH_VALIDATION_ERROR = "api.docs_search_validation_error",
+	DOCS_SEARCH_INSUFFICIENT_CREDITS = "api.docs_search_insufficient_credits",
+	DOCS_SEARCH_ERROR = "api.docs_search_error",
+	GRAVITY_INDEX_REQUEST = "api.gravity_index_request",
+	GRAVITY_INDEX_AUTH_ERROR = "api.gravity_index_auth_error",
+	GRAVITY_INDEX_VALIDATION_ERROR = "api.gravity_index_validation_error",
+	GRAVITY_INDEX_ERROR = "api.gravity_index_error",
+	FEEDBACK_SUBMITTED = "api.feedback_submitted",
+	FEEDBACK_AUTH_ERROR = "api.feedback_auth_error",
+	FEEDBACK_VALIDATION_ERROR = "api.feedback_validation_error",
+	LOGS_INGEST_AUTH_ERROR = "api.logs_ingest_auth_error",
+	LOGS_INGEST_VALIDATION_ERROR = "api.logs_ingest_validation_error",
+	ADS_API_AUTH_ERROR = "api.ads_auth_error",
+	ADS_FETCH_COMPLETED = "ads.fetch_completed",
+	ADS_IMPRESSION_RECORDED = "ads.impression_recorded",
+	ADS_CLICKED = "ads.clicked",
+	TOKEN_COUNT_REQUEST = "api.token_count_request",
+	TOKEN_COUNT_AUTH_ERROR = "api.token_count_auth_error",
+	TOKEN_COUNT_VALIDATION_ERROR = "api.token_count_validation_error",
+	TOKEN_COUNT_ERROR = "api.token_count_error",
+	ANVIL_REFERRAL_REDEEMED = "anvil.referral.redeemed",
+	ANVIL_REFERRAL_REDEEM_FAILED = "anvil.referral.redeem_failed",
+	ANVIL_REFERRAL_SOCK_SIGNAL = "anvil.referral.sock_signal",
+	ANVIL_GET_STARTED_VIEWED = "anvil.get_started_viewed",
+	ANVIL_GET_STARTED_SIGN_IN_CLICKED = "anvil.get_started_sign_in_clicked",
+	ANVIL_GET_STARTED_SIGNED_IN = "anvil.get_started_signed_in",
+	ANVIL_GET_STARTED_ELIGIBILITY_RESOLVED = "anvil.get_started_eligibility_resolved",
+	ANVIL_GET_STARTED_CONNECT_GITHUB_CLICKED = "anvil.get_started_connect_github_clicked",
+	ANVIL_GET_STARTED_INSTALL_COMMAND_COPIED = "anvil.get_started_install_command_copied",
+	ANVIL_GET_STARTED_WEB_CLICKED = "anvil.get_started_web_clicked",
+	ANVIL_GET_STARTED_HELP_EXPANDED = "anvil.get_started_help_expanded",
+	ANVIL_GET_STARTED_EDITOR_CLICKED = "anvil.get_started_editor_clicked",
+	ANVIL_CHAT_TITLE_GENERATED = "anvil.chat_title_generated",
+	ANVIL_CLI_INSTALL_COMMAND_COPIED = "anvil.cli_install_command_copied",
+	ANVIL_ENTERPRISE_CONTACT_SUBMITTED = "anvil.enterprise_contact_submitted",
+	ANVIL_DESKTOP_DOWNLOAD_CLICKED = "anvil.desktop_download_clicked",
+	ANVIL_WEB_GATE_REDIRECT_CLICKED = "anvil.web_gate_redirect_clicked",
+	ANVIL_WEB_ONBOARDING_STEP = "anvil.web_onboarding_step",
+	ANVIL_WEB_ONBOARDING_FINISHED = "anvil.web_onboarding_finished",
+	ANVIL_WEB_TOUR_STEP = "anvil.web_tour_step",
+	ANVIL_WEB_TOUR_FINISHED = "anvil.web_tour_finished",
+	ANVIL_BOOKMARK_GATE_SHOWN = "anvil.bookmark_gate_shown",
+	ANVIL_BOOKMARK_GATE_CONFIRMED = "anvil.bookmark_gate_confirmed",
+	ANVIL_CLOUD_CONNECT_REPO_CLICKED = "anvil.cloud_connect_repo_clicked",
+	ANVIL_CLOUD_BLANK_PROJECT_CLICKED = "anvil.cloud_blank_project_clicked",
+	ANVIL_HOME_INSTALL_COMMAND_COPIED = "anvil.home_install_command_copied",
+	ANVIL_HOME_GITHUB_CLICKED = "anvil.home_github_clicked",
+	ANVIL_HOME_INSTALL_GUIDE_EXPANDED = "anvil.home_install_guide_expanded",
+	ANVIL_HOME_FAQ_OPENED = "anvil.home_faq_opened",
+	ANVIL_HOME_SAVINGS_CTA_CLICKED = "anvil.home_savings_cta_clicked",
+	ANVIL_ATTRIBUTED = "anvil.attributed",
+	ANVIL_AFFILIATE_SIGNUP = "anvil.affiliate.signup",
+	ANVIL_AFFILIATE_ACTIVATION = "anvil.affiliate.activation",
+	ANVIL_REDDIT_FUNNEL_CLI_INSTALLED = "anvil.reddit_funnel.cli_installed",
+	ANVIL_REDDIT_FUNNEL_LOGIN = "anvil.reddit_funnel.login",
+	ANVIL_REDDIT_FUNNEL_SIGN_UP = "anvil.reddit_funnel.sign_up",
+	ANVIL_REDDIT_FUNNEL_FIRST_PROMPT = "anvil.reddit_funnel.first_prompt",
+	ANVIL_REDDIT_FUNNEL_RETENTION_1D = "anvil.reddit_funnel.retention_1d",
+	ANVIL_REDDIT_FUNNEL_RETENTION_7D = "anvil.reddit_funnel.retention_7d",
+	ANVIL_REDDIT_FUNNEL_RETENTION_24D = "anvil.reddit_funnel.retention_24d",
+	ANVIL_REDDIT_FUNNEL_FIRST_PROMPT_CLI = "anvil.reddit_funnel.first_prompt_cli",
+	ANVIL_REDDIT_FUNNEL_FIRST_PROMPT_WEB = "anvil.reddit_funnel.first_prompt_web",
+	ANVIL_REDDIT_FUNNEL_FIRST_PROMPT_CHAT = "anvil.reddit_funnel.first_prompt_chat",
+	ANVIL_REDDIT_FUNNEL_RETENTION_1D_CLI = "anvil.reddit_funnel.retention_1d_cli",
+	ANVIL_REDDIT_FUNNEL_RETENTION_7D_CLI = "anvil.reddit_funnel.retention_7d_cli",
+	ANVIL_REDDIT_FUNNEL_RETENTION_24D_CLI = "anvil.reddit_funnel.retention_24d_cli",
+	ANVIL_REDDIT_FUNNEL_GRAVITY_AD_CLICK = "anvil.reddit_funnel.gravity_ad_click",
+	ANVIL_CHAT_ADS_EXPERIMENT_EXPOSED = "anvil.chat_ads.experiment_exposed",
+	ANVIL_CHAT_ADS_AD_SHOWN = "anvil.chat_ads.ad_shown",
+	DESKTOP_APP_LAUNCHED = "desktop.app_launched",
+	DESKTOP_LOGIN_STARTED = "desktop.login_started",
+	DESKTOP_LOGIN = "desktop.login",
+	DESKTOP_LOGIN_FAILED = "desktop.login_failed",
+	DESKTOP_LOGOUT = "desktop.logout",
+	DESKTOP_THREAD_CREATED = "desktop.thread_created",
+	DESKTOP_THREAD_TITLED = "desktop.thread_titled",
+	DESKTOP_PROJECT_OPENED = "desktop.project_opened",
+	DESKTOP_PROJECT_REMOVED = "desktop.project_removed",
+	DESKTOP_TURN_COMPLETED = "desktop.turn_completed",
+	DESKTOP_FAILED_TURN_RECOVERY = "desktop.failed_turn_recovery",
+	DESKTOP_HARNESS_CHANGED = "desktop.harness_changed",
+	DESKTOP_MODEL_CHANGED = "desktop.model_changed",
+	DESKTOP_SKILL_RUN = "desktop.skill_run",
+	DESKTOP_QUEUE_SEND_NOW = "desktop.queue_send_now",
+	DESKTOP_FEATURE_USED = "desktop.feature_used",
+	DESKTOP_AUTORUN_TOGGLED = "desktop.autorun_toggled",
+	DESKTOP_AUTORUN_SCOPE_SET = "desktop.autorun_scope_set",
+	DESKTOP_CODEX_RESOLUTION = "desktop.codex_resolution",
+	DESKTOP_AD_SHOWN = "desktop.ad_shown",
+	DESKTOP_AD_CLICKED = "desktop.ad_clicked",
+	DESKTOP_INLINE_AD_SLOT_ELIGIBLE = "desktop.inline_ad_slot_eligible",
+	DESKTOP_SHUTDOWN_TURNS_ABORTED = "desktop.shutdown_turns_aborted",
+	DESKTOP_ORPHANS_REAPED = "desktop.orphans_reaped",
+	DESKTOP_WORKTREES_RECLAIMED = "desktop.worktrees_reclaimed",
+	DESKTOP_TURNS_RESURRECTED = "desktop.turns_resurrected",
+	DESKTOP_TURN_STALLED = "desktop.turn_stalled",
+	DESKTOP_TURN_BACKGROUND_WAIT = "desktop.turn_background_wait",
+	DESKTOP_EVENT_LOOP_HEALTH = "desktop.event_loop_health",
+	DESKTOP_THREADS_AUTO_ARCHIVED = "desktop.threads_auto_archived",
+	DESKTOP_DELIVERY_CONFLICT_CHANGED = "desktop.delivery_conflict_changed",
+	FLUSH_FAILED = "common.flush_failed",
+	CLI_LOG = "cli.log"
+}
+type TrackEventFn = (params: {
+	event: AnalyticsEvent;
+	userId: string;
+	properties?: Record<string, any>;
+	logger: Logger$1;
+}) => void;
+declare const models: {
+	readonly ft_filepicker_003: "196166068534771712";
+	readonly ft_filepicker_005: "8493203957034778624";
+	readonly ft_filepicker_007: "2589952415784501248";
+	readonly ft_filepicker_topk_001: "3676445825887633408";
+	readonly ft_filepicker_008: "2672143108984012800";
+	readonly ft_filepicker_topk_002: "1694861989844615168";
+	readonly ft_filepicker_010: "3808739064941641728";
+	readonly ft_filepicker_010_epoch_2: "6231675664466968576";
+	readonly ft_filepicker_topk_003: "1502192368286171136";
+	readonly openrouter_claude_sonnet_4_5: "anthropic/claude-sonnet-4.5";
+	readonly openrouter_claude_sonnet_4: "anthropic/claude-4-sonnet-20250522";
+	readonly openrouter_claude_opus_4: "anthropic/claude-opus-4.1";
+	readonly openrouter_claude_3_5_haiku: "anthropic/claude-3.5-haiku-20241022";
+	readonly openrouter_claude_3_5_sonnet: "anthropic/claude-3.5-sonnet-20240620";
+	readonly openrouter_gpt4o: "openai/gpt-4o-2024-11-20";
+	readonly openrouter_gpt5: "openai/gpt-5.1";
+	readonly openrouter_gpt5_chat: "openai/gpt-5.1-chat";
+	readonly openrouter_gpt4o_mini: "openai/gpt-4o-mini-2024-07-18";
+	readonly openrouter_gpt4_1_nano: "openai/gpt-4.1-nano";
+	readonly openrouter_o3_mini: "openai/o3-mini-2025-01-31";
+	readonly openrouter_gemini2_5_pro_preview: "google/gemini-2.5-pro";
+	readonly openrouter_gemini2_5_flash: "google/gemini-2.5-flash";
+	readonly openrouter_gemini2_5_flash_thinking: "google/gemini-2.5-flash-preview:thinking";
+	readonly openrouter_grok_4: "x-ai/grok-4-07-09";
+	readonly minimaxM3: "minimax/minimax-m3";
+	readonly mimoV25Direct: "mimo-v2.5";
+	readonly mimoV25: "mimo/mimo-v2.5";
+	readonly mimoV25ProDirect: "mimo-v2.5-pro";
+	readonly mimoV25Pro: "mimo/mimo-v2.5-pro";
+	readonly deepseekChat: "deepseek-chat";
+	readonly deepseekReasoner: "deepseek-reasoner";
+	readonly deepseekV4ProDirect: "deepseek-v4-pro";
+	readonly deepseekV4Pro: "deepseek/deepseek-v4-pro";
+	readonly deepseekV4FlashDirect: "deepseek-v4-flash";
+	readonly deepseekV4Flash: "deepseek/deepseek-v4-flash";
+	readonly gpt4_1: "gpt-4.1-2025-04-14";
+	readonly gpt4o: "gpt-4o-2024-11-20";
+	readonly gpt4omini: "gpt-4o-mini-2024-07-18";
+	readonly o3mini: "o3-mini-2025-01-31";
+	readonly o3: "o3-2025-04-16";
+	readonly o3pro: "o3-pro-2025-06-10";
+	readonly o4mini: "o4-mini-2025-04-16";
+	readonly generatePatch: "ft:gpt-4o-2024-08-06:manifold-markets:generate-patch-batch2:AKYtDIhk";
+};
+type Model = (typeof models)[keyof typeof models] | (string & {});
+type OpenRouterReasoningOptions = {
+	/**
+	 * https://openrouter.ai/docs/use-cases/reasoning-tokens
+	 * One of `max_tokens` or `effort` is required.
+	 * If `exclude` is true, reasoning will be removed from the response. Default is false.
+	 */
+	enabled?: boolean;
+	exclude?: boolean;
+} & ({
+	max_tokens: number;
+} | {
+	effort: "high" | "medium" | "low" | "minimal" | "none";
+});
+type OpenRouterProviderRoutingOptions = {
+	/**
+	 * List of provider slugs to try in order (e.g. ["anthropic", "openai"])
+	 */
+	order?: string[];
+	/**
+	 * Whether to allow backup providers when primary is unavailable (default: true)
+	 */
+	allow_fallbacks?: boolean;
+	/**
+	 * Only use providers that support all parameters in your request (default: false)
+	 */
+	require_parameters?: boolean;
+	/**
+	 * Control whether to use providers that may store data
+	 */
+	data_collection?: "allow" | "deny";
+	/**
+	 * List of provider slugs to allow for this request
+	 */
+	only?: string[];
+	/**
+	 * List of provider slugs to skip for this request
+	 */
+	ignore?: string[];
+	/**
+	 * List of quantization levels to filter by (e.g. ["int4", "int8"])
+	 */
+	quantizations?: Array<"int4" | "int8" | "fp4" | "fp6" | "fp8" | "fp16" | "bf16" | "fp32" | "unknown">;
+	/**
+	 * Sort providers by price, throughput, or latency
+	 */
+	sort?: "price" | "throughput" | "latency";
+	/**
+	 * Maximum pricing you want to pay for this request
+	 */
+	max_price?: {
+		prompt?: number | string;
+		completion?: number | string;
+		image?: number | string;
+		audio?: number | string;
+		request?: number | string;
+	};
+};
+type AgentTemplate<P = string | undefined, T = Record<string, any> | undefined> = {
+	id: AgentTemplateType;
+	displayName: string;
+	model: Model;
+	reasoningOptions?: OpenRouterReasoningOptions;
+	providerOptions?: OpenRouterProviderRoutingOptions;
+	mcpServers: Record<string, MCPConfig$1>;
+	toolNames: (ToolName | (string & {}))[];
+	spawnableAgents: AgentTemplateType[];
+	spawnerPrompt?: string;
+	systemPrompt: string;
+	instructionsPrompt: string;
+	stepPrompt: string;
+	parentInstructions?: Record<string, string>;
+	inputSchema: {
+		prompt?: z.ZodSchema<P>;
+		params?: z.ZodSchema<T>;
+	};
+	includeMessageHistory: boolean;
+	inheritParentSystemPrompt: boolean;
+	windowedFileReads?: boolean;
+	compactContext?: boolean | {
+		cacheExpiryMs?: number | null;
+		cacheExpiryMinTokens?: number | null;
+	};
+	outputMode: "last_message" | "all_messages" | "structured_output";
+	outputSchema?: z.ZodSchema<any>;
+	handleSteps?: StepHandler<P, T> | string;
+	/**
+	 * Live copy of handleSteps kept alongside the serialized string. The string
+	 * form of a bundled function can reference out-of-scope bundler helpers
+	 * (esbuild keepNames injects `__name(...)`, minified to a bare identifier),
+	 * which breaks the eval path. When the runtime is in-process, prefer this
+	 * function. Dropped automatically by JSON serialization (resume blobs, DB).
+	 */
+	handleStepsFn?: StepHandler<P, T>;
+};
+type StepText$1 = {
+	type: "STEP_TEXT";
+	text: string;
+};
+type GenerateN$1 = {
+	type: "GENERATE_N";
+	n: number;
+};
+type StepGenerator = Generator<Omit<ToolCall, "toolCallId"> | "STEP" | "STEP_ALL" | StepText$1 | GenerateN$1, // Generic tool call type
+void, {
+	agentState: AgentState;
+	toolResult: ToolResultOutput[];
+	stepsComplete: boolean;
+	nResponses?: string[];
+}>;
+type StepHandler<P = string | undefined, T = Record<string, any> | undefined> = (context: {
+	agentState: AgentState$1;
+	prompt: P;
+	params: T;
+	/**
+	 * The model this agent step is running on, after any per-request override of
+	 * the template's `model`. Needed because `handleSteps` is serialized with
+	 * `toString()` (no closures survive), so a caller that swaps the model at
+	 * request time has no other way to tell the generator which model it got.
+	 *
+	 * Supplied by the runtime; optional so generators invoked directly in tests
+	 * keep compiling. Treat `undefined` as "unknown model".
+	 */
+	model?: string;
+	logger: Logger;
+}) => StepGenerator;
+type Prettify<T> = {
+	[K in keyof T]: T[K];
+} & {};
+type StripExact<T> = T extends infer U & {
+	[x: string]: never;
+} ? U : T;
+type ParamsOfFunction<T> = T extends (params: infer C) => any ? StripExact<C> : never;
+type IsUnion<T, U = T> = T extends any ? ([
+	U
+] extends [
+	T
+] ? false : true) : false;
+type ParamsOfArray<T> = UnionToIntersection<T extends [
+	infer fn,
+	...infer rest
+] ? ParamsOfFunction<fn> | ParamsOfArray<rest> : {}>;
+type ParamsOfUnion<T> = IsUnion<T> extends true ? UnionToIntersection<ParamsOfFunction<T>> : ParamsOfFunction<T>;
+type ParamsOf<T> = Prettify<T extends any[] ? ParamsOfArray<T> : ParamsOfUnion<T>>;
+type ParamsExcluding<T, K extends keyof ParamsOf<T>> = Prettify<Omit<ParamsOf<T>, K>>;
+type PromptResult<T> = PromptSuccess<T> | PromptAborted;
+type PromptSuccess<T> = {
+	aborted: false;
+	value: T;
+};
+type PromptAborted = {
+	aborted: true;
+	reason?: string;
+};
+type StreamRecoverySource = "stream-interrupted" | "output-limit";
+type StreamChunk = {
+	type: "text";
+	text: string;
+	agentId?: string;
+} | {
+	type: "reasoning";
+	text: string;
+	/** Provider metadata for the whole reasoning segment (e.g. OpenRouter
+	 *  reasoning_details with thinking signatures), delivered on a final
+	 *  empty-text chunk once the segment ends. Stored on the history's
+	 *  reasoning part so the next request can replay it. */
+	providerOptions?: ProviderMetadata;
+} | Pick<ToolCallPart, "type" | "toolCallId" | "toolName" | "input" | "providerOptions"> | {
+	type: "error";
+	message: string;
+	/** When set, this is an auto-recovered stream ending rather than a
+	 *  failure: consumers force another agent step so the model can
+	 *  continue, instead of wrapping the message as a tool-call failure and
+	 *  instead of the turn silently ending. */
+	source?: StreamRecoverySource;
+};
+type CacheDebugUsageData = {
+	inputTokens: number;
+	outputTokens: number;
+	reasoningOutputTokens?: number;
+	cachedInputTokens: number;
+	totalTokens: number;
+};
+type ModelUsageData = CacheDebugUsageData;
+type AgentUsageData = ModelUsageData & {
+	isRoot: boolean;
+	agentId?: string;
+};
+type ContextCompactionData = {
+	trigger: "context_limit" | "cache_expiry" | "context_limit_and_cache_expiry";
+	thresholdTokens: number;
+};
+type PromptAiSdkStreamFn = (params: {
+	apiKey: string;
+	runId: string;
+	messages: Message[];
+	clientSessionId: string;
+	fingerprintId: string;
+	model: Model;
+	userId: string | undefined;
+	chargeUser?: boolean;
+	thinkingBudget?: number;
+	userInputId: string;
+	agentId?: string;
+	maxRetries?: number;
+	onCostCalculated?: (credits: number) => Promise<void>;
+	onCacheDebugProviderRequestBuilt?: (params: {
+		provider: string;
+		rawBody: unknown;
+		normalizedBody?: unknown;
+	}) => void;
+	onCacheDebugUsageReceived?: (usage: CacheDebugUsageData) => void;
+	onUsageReceived?: (usage: ModelUsageData) => void;
+	/** The request ended without an exact final provider usage receipt. */
+	onUsageIncomplete?: () => void;
+	includeCacheControl?: boolean;
+	cacheDebugCorrelation?: string;
+	agentProviderOptions?: OpenRouterProviderRoutingOptions;
+	/** List of agents that can be spawned - used to transform agent tool calls */
+	spawnableAgents?: string[];
+	/** Map of locally available agent templates - used to transform agent tool calls */
+	localAgentTemplates?: Record<string, AgentTemplate>;
+	/** Cost mode - 'free' mode means 0 credits charged for all agents */
+	costMode?: string;
+	/** Extra key/values merged into the request's `anvil_metadata` field.
+	 *  Used to forward client-scoped identifiers (e.g. `anvil_instance_id`)
+	 *  that server-side gates read from the chat-completions body. */
+	extraAnvilMetadata?: Record<string, string>;
+	sendAction: SendActionFn;
+	logger: Logger$1;
+	trackEvent: TrackEventFn;
+	signal: AbortSignal;
+} & ParamsExcluding<typeof streamText, "model" | "messages">) => AsyncGenerator<StreamChunk, PromptResult<string | null>>;
+type PromptAiSdkFn = (params: {
+	apiKey: string;
+	runId: string;
+	messages: Message[];
+	clientSessionId: string;
+	fingerprintId: string;
+	userInputId: string;
+	model: Model;
+	userId: string | undefined;
+	chargeUser?: boolean;
+	agentId?: string;
+	onCostCalculated?: (credits: number) => Promise<void>;
+	onCacheDebugProviderRequestBuilt?: (params: {
+		provider: string;
+		rawBody: unknown;
+		normalizedBody?: unknown;
+	}) => void;
+	onCacheDebugUsageReceived?: (usage: CacheDebugUsageData) => void;
+	includeCacheControl?: boolean;
+	cacheDebugCorrelation?: string;
+	agentProviderOptions?: OpenRouterProviderRoutingOptions;
+	maxRetries?: number;
+	/** Cost mode - 'free' mode means 0 credits charged for all agents */
+	costMode?: string;
+	sendAction: SendActionFn;
+	logger: Logger$1;
+	trackEvent: TrackEventFn;
+	n?: number;
+	signal: AbortSignal;
+} & ParamsExcluding<typeof generateText, "model" | "messages">) => Promise<PromptResult<string>>;
+type PromptAiSdkStructuredInput<T> = {
+	apiKey: string;
+	runId: string;
+	messages: Message[];
+	schema: z.ZodType<T>;
+	clientSessionId: string;
+	fingerprintId: string;
+	userInputId: string;
+	model: Model;
+	userId: string | undefined;
+	maxTokens?: number;
+	temperature?: number;
+	timeout?: number;
+	chargeUser?: boolean;
+	agentId?: string;
+	onCostCalculated?: (credits: number) => Promise<void>;
+	onCacheDebugProviderRequestBuilt?: (params: {
+		provider: string;
+		rawBody: unknown;
+		normalizedBody?: unknown;
+	}) => void;
+	onCacheDebugUsageReceived?: (usage: CacheDebugUsageData) => void;
+	includeCacheControl?: boolean;
+	cacheDebugCorrelation?: string;
+	agentProviderOptions?: OpenRouterProviderRoutingOptions;
+	maxRetries?: number;
+	sendAction: SendActionFn;
+	logger: Logger$1;
+	trackEvent: TrackEventFn;
+	signal: AbortSignal;
+};
+type PromptAiSdkStructuredOutput<T> = Promise<PromptResult<T>>;
+/**
+ * Records agent message histories for debugging (e.g. to a trace.jsonl file).
+ *
+ * Callers pass the agent's full message history at each step boundary;
+ * implementations are expected to persist each message only once (appending
+ * the delta since the previous call for the same agentId), so calling this
+ * every step does not grow storage quadratically.
+ */
+export type TraceWriter = {
+	recordStep: (params: {
+		agentId: string;
+		agentType: string;
+		runId: string | undefined;
+		userInputId: string;
+		step: number;
+		system: string | undefined;
+		messages: Message[];
+	}) => void;
+};
+type Source<T> = T | Promise<T> | (T extends (...args: unknown[]) => unknown ? never : () => T | Promise<T>);
+type OverrideToolHandlers = {
+	[K in PublishedClientToolName]?: (input: any) => Promise<ToolResultOutput[]>;
+} & {
+	read_files?: (input: {
+		filePaths: string[];
+		/** Present only for `windowedFileReads` agents. An override that ignores
+		 *  it returns whole files, which is a cost regression rather than a
+		 *  correctness bug — but it is the whole point of the flag, so overrides
+		 *  on hosted surfaces window the content themselves (they hold the file
+		 *  before their own read budget truncates it). */
+		fileWindows?: Record<string, FileReadWindow[]>;
+	}) => Promise<Record<string, string | null>>;
+};
+export type AnvilClientOptions = {
+	apiKey?: string;
+	cwd?: string;
+	/** Optional directory path to load skills from. Skills found here will be available to the `skill` tool. */
+	skillsDir?: string;
+	projectFiles?: Record<string, string>;
+	/** Precomputed index for exactly these `projectFiles` (build it with
+	 *  `computeProjectIndexFromFiles`). Skips the per-run tree-sitter parse;
+	 *  ignored when `projectFiles` is absent. */
+	projectIndex?: ComputedProjectIndex;
+	knowledgeFiles?: Record<string, string>;
+	agentDefinitions?: AgentDefinition[];
+	maxAgentSteps?: number;
+	env?: Record<string, string>;
+	/** Optional host process boundary that keeps terminal tools away from an
+	 * interactive console. Headless consumers can omit it. */
+	terminalCommandBroker?: TerminalCommandBroker;
+	handleEvent?: (event: PrintModeEvent) => void | Promise<void>;
+	handleStreamChunk?: (chunk: string | {
+		type: "subagent_chunk";
+		agentId: string;
+		agentType: string;
+		chunk: string;
+	} | {
+		type: "reasoning_chunk";
+		agentId: string;
+		ancestorRunIds: string[];
+		chunk: string;
+	}) => void | Promise<void>;
+	/** Optional filter to classify files before reading (runs before gitignore check) */
+	fileFilter?: FileFilter;
+	overrideTools?: OverrideToolHandlers;
+	customToolDefinitions?: CustomToolDefinition[];
+	fsSource?: Source<AnvilFileSystem>;
+	spawnSource?: Source<AnvilSpawn>;
+	logger?: Logger$1;
+	/** Optional debug trace of agent message histories. Called with the full
+	 *  history at each agent step boundary; implementations should append each
+	 *  message once (see TraceWriter). */
+	traceWriter?: TraceWriter;
+};
+export type ImageContent = {
+	type: "image";
+	image: string;
+	mediaType: string;
+};
+export type TextContent = {
+	type: "text";
+	text: string;
+};
+export type MessageContent = TextContent | ImageContent;
+export type RunOptions = {
+	agent: string | AgentDefinition;
+	prompt: string;
+	/** End user represented by this run. Trusted service accounts may use this
+	 *  to run on behalf of a signed-in user; ordinary API keys cannot delegate. */
+	userId?: string;
+	/** Content array for multimodal messages (text + images) */
+	content?: MessageContent[];
+	params?: Record<string, any>;
+	previousRun?: RunState;
+	extraToolResults?: ToolMessage[];
+	signal?: AbortSignal;
+	/** Optional steering hook. Drained at each agent step boundary during the run;
+	 * any returned texts are appended to the conversation as user prompts (and keep
+	 * the turn going) before the next LLM call. Lets a host inject messages into a
+	 * running agent without aborting — i.e. "steer" it, as opposed to queuing a new
+	 * prompt for after the turn finishes. */
+	drainSteeringMessages?: () => string[];
+	costMode?: string;
+	/** Extra key/values merged into each LLM request's `anvil_metadata`.
+	 *  Used by hosts (e.g. the CLI) to forward client-scoped identifiers like
+	 *  `anvil_instance_id` that server-side gates read from the request body. */
+	extraAnvilMetadata?: Record<string, string>;
+	/** Optional checkpoint hook. Called once when the run starts and then
+	 * periodically while it is in flight, with a RunState snapshot that
+	 * preserves all progress so far (the user's prompt plus any completed
+	 * agent steps, ending with an interruption note). Hosts can persist these
+	 * snapshots so that a killed process (closed terminal, crash) does not
+	 * lose the in-flight turn. The final resolved RunState supersedes any
+	 * snapshot; no snapshots are emitted after the run settles. */
+	onStateSnapshot?: (runState: RunState) => void;
+	/** Provider-reported usage for each root-agent model request. */
+	onUsage?: (usage: AgentUsageData) => void;
+	/** A model request ended before an exact provider usage receipt arrived. */
+	onUsageIncomplete?: () => void;
+	/** Mechanical context compaction performed by the root agent runtime. */
+	onCompaction?: (data: ContextCompactionData) => void;
+};
+export declare const STATE_SNAPSHOT_INTERRUPTION_MESSAGE = "The session ended before this response completed. Partial progress has been preserved.";
+type RunExecutionOptions = RunOptions & AnvilClientOptions & {
+	apiKey: string;
+	fingerprintId: string;
+};
+export declare function run(options: RunExecutionOptions): Promise<RunState>;
+/**
+ * Combines prompt, params, and content into a unified message content structure.
+ */
+export declare function buildUserMessageContent(prompt: string | undefined, params: Record<string, any> | undefined, content?: Array<TextPart | ImagePart>): Array<TextPart | ImagePart>;
+export declare class AnvilClient {
+	options: AnvilClientOptions & {
+		apiKey: string;
+		fingerprintId: string;
+	};
+	constructor(options: AnvilClientOptions);
+	/**
+	 * Run a Anvil agent with the specified options.
+	 *
+	 * @param agent - The agent to run. Use 'base' for the default agent, or specify a custom agent ID if you made your own agent config.
+	 * @param prompt - The user prompt describing what you want the agent to do.
+	 * @param params - (Optional) Additional parameters for the agent. Most agents don't use this, but some custom agents can take a JSON object as input in addition to the user prompt string.
+	 * @param handleEvent - (Optional) Callback function that receives every event during execution (assistant messages, tool calls, etc.). This allows you to stream the agent's progress in real-time. We will likely add a token-by-token streaming callback in the future.
+	 * @param previousRun - (Optional) JSON state returned from a previous run() call. Use this to continue a conversation or session with the agent, maintaining context from previous interactions.
+	 * @param projectFiles - (Optional) All the files in your project as a plain JavaScript object. Keys should be the full path from your current directory to each file, and values should be the string contents of the file. Example: { "src/index.ts": "console.log('hi')" }. This helps Anvil pick good source files for context.
+	 * @param knowledgeFiles - (Optional) Knowledge files to inject into every run() call. Uses the same schema as projectFiles - keys are file paths and values are file contents. These files are added directly to the agent's context.
+	 * @param agentDefinitions - (Optional) Array of custom agent definitions. Each object should satisfy the AgentDefinition type. You can input the agent's id field into the agent parameter to run that agent.
+	 * @param customToolDefinitions - (Optional) Array of custom tool definitions that extend the agent's capabilities. Each tool definition includes a name, Zod schema for input validation, and a handler function. These tools can be called by the agent during execution.
+	 * @param skillsDir - (Optional) Path to a directory containing skills to load. Each skill should be in its own subdirectory with a SKILL.md file (e.g., `skillsDir/my-skill/SKILL.md`). When provided, skills are loaded from this directory instead of the default locations. The loaded skills will be listed in the `skill` tool's description and can be loaded by the agent.
+	 * @param maxAgentSteps - (Optional) Maximum number of steps the agent can take before stopping. Use this as a safety measure in case your agent starts going off the rails. A reasonable number is around 20.
+	 * @param env - (Optional) Environment variables to pass to terminal commands executed by the agent. These will be merged with the current process environment, with the custom values taking precedence. Can also be provided in individual run() calls to override.
+	 *
+	 * @returns A Promise that resolves to a RunState JSON object which you can pass to a subsequent run() call to continue the run. Use result.output to get the agent's output.
+	 */
+	run(options: RunOptions & AnvilClientOptions): Promise<RunState>;
+	/**
+	 * Check connection to the Anvil backend by hitting the /healthz endpoint.
+	 *
+	 * @returns Promise that resolves to true if connected, false otherwise
+	 */
+	checkConnection(): Promise<boolean>;
+}
+declare const clientEnvSchema: z.ZodObject<{
+	NEXT_PUBLIC_CB_ENVIRONMENT: z.ZodEnum<{
+		dev: "dev";
+		test: "test";
+		prod: "prod";
+	}>;
+	NEXT_PUBLIC_ANVIL_APP_URL: z.ZodURL;
+	NEXT_PUBLIC_SUPPORT_EMAIL: z.ZodEmail;
+	NEXT_PUBLIC_POSTHOG_API_KEY: z.ZodString;
+	NEXT_PUBLIC_POSTHOG_HOST_URL: z.ZodURL;
+	NEXT_PUBLIC_GRAVITY_PIXEL_ID: z.ZodOptional<z.ZodUUID>;
+	NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: z.ZodString;
+	NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL: z.ZodURL;
+	NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION_ID: z.ZodOptional<z.ZodString>;
+	NEXT_PUBLIC_WEB_PORT: z.ZodCoercedNumber<unknown>;
+	NEXT_PUBLIC_TURNSTILE_SITE_KEY: z.ZodOptional<z.ZodString>;
+	NEXT_PUBLIC_RECAPTCHA_V2_SITE_KEY: z.ZodOptional<z.ZodString>;
+	NEXT_PUBLIC_RECAPTCHA_V3_SITE_KEY: z.ZodOptional<z.ZodString>;
+	NEXT_PUBLIC_RECAPTCHA_V2_SIZE: z.ZodOptional<z.ZodEnum<{
+		checkbox: "checkbox";
+		invisible: "invisible";
+	}>>;
+	NEXT_PUBLIC_HUMANBEHAVIOR_API_KEY: z.ZodOptional<z.ZodString>;
+	NEXT_PUBLIC_HUMANBEHAVIOR_INGESTION_URL: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+type ClientEnv = z.infer<typeof clientEnvSchema>;
+type BaseEnv = {
+	SHELL?: string;
+	COMSPEC?: string;
+	HOME?: string;
+	USERPROFILE?: string;
+	APPDATA?: string;
+	XDG_CONFIG_HOME?: string;
+	TERM?: string;
+	TERM_PROGRAM?: string;
+	TERM_BACKGROUND?: string;
+	TERMINAL_EMULATOR?: string;
+	COLORFGBG?: string;
+	NODE_ENV?: string;
+	NODE_PATH?: string;
+	PATH?: string;
+};
+type SdkEnv = BaseEnv & {
+	ANVIL_RG_PATH?: string;
+	ANVIL_WASM_DIR?: string;
+	VERBOSE?: string;
+	OVERRIDE_TARGET?: string;
+	OVERRIDE_PLATFORM?: string;
+	OVERRIDE_ARCH?: string;
+};
+/**
+ * Get the path to the bundled ripgrep binary based on the current platform
+ * @param importMetaUrl - import.meta.url from the calling module
+ * @returns Path to the ripgrep binary
+ */
+export declare function getBundledRgPath(importMetaUrl?: string, env?: SdkEnv): string;
+declare function changeFile(params: {
+	parameters: unknown;
+	cwd: string;
+	fs: AnvilFileSystem;
+}): Promise<AnvilToolOutput<"str_replace">>;
+declare function codeSearch({ projectPath, pattern, flags, cwd, maxResults, globalMaxResults, maxOutputStringLength, timeoutSeconds, logger, signal, }: {
+	projectPath: string;
+	pattern: string;
+	flags?: string;
+	cwd?: string;
+	maxResults?: number;
+	globalMaxResults?: number;
+	maxOutputStringLength?: number;
+	timeoutSeconds?: number;
+	logger?: Logger$1;
+	/** External abort (e.g. user interrupt); kills the ripgrep process. */
+	signal?: AbortSignal;
+}): Promise<AnvilToolOutput<"code_search">>;
+declare function glob(params: {
+	pattern: string;
+	projectPath: string;
+	cwd?: string;
+	maxResults?: number;
+	fs: AnvilFileSystem;
+}): Promise<AnvilToolOutput<"glob">>;
+declare function listDirectory(params: {
+	directoryPath: string;
+	projectPath: string;
+	fs: AnvilFileSystem;
+}): Promise<AnvilToolOutput<"list_directory">>;
+declare function runFileChangeHooks({ files, }: {
+	files: string[];
+}): Promise<AnvilToolOutput<"run_file_change_hooks">>;
+export declare const ToolHelpers: {
+	runTerminalCommand: typeof runTerminalCommand;
+	codeSearch: typeof codeSearch;
+	glob: typeof glob;
+	listDirectory: typeof listDirectory;
+	getFiles: typeof getFiles;
+	runFileChangeHooks: typeof runFileChangeHooks;
+	changeFile: typeof changeFile;
+};
+export declare const IS_DEV: boolean;
+export declare const IS_TEST: boolean;
+export declare const IS_PROD: boolean;
+export declare const ANVIL_BINARY = "anvil";
+/**
+ * Resolve the Anvil backend base URL at call time. Remote hosts that bundle
+ * the SDK (Convex Node actions, Next server routes) must not rely on the
+ * bundle-time value: esbuild can inline a dev-machine localhost URL that the
+ * remote runtime cannot reach. Deployment env wins when present.
+ */
+export declare function getWebsiteUrl(): string;
+/** @deprecated Prefer {@link getWebsiteUrl} for runtime resolution. */
+export declare const WEBSITE_URL: string;
+type User = {
+	id: string;
+	email: string;
+	discord_id: string | null;
+	stripe_customer_id: string | null;
+	banned: boolean;
+	created_at: Date;
+};
+type UserColumn = keyof User;
+type GetUserInfoFromApiKeyInput<T extends UserColumn> = {
+	apiKey: string;
+	fields: readonly T[];
+	logger: Logger$1;
+};
+type GetUserInfoFromApiKeyOutput<T extends UserColumn> = Promise<{
+	[K in T]: User[K];
+} | null>;
+export declare function getUserInfoFromApiKey<T extends UserColumn>(params: GetUserInfoFromApiKeyInput<T>): GetUserInfoFromApiKeyOutput<T>;
+declare const userSchema: z.ZodObject<{
+	id: z.ZodString;
+	email: z.ZodString;
+	name: z.ZodNullable<z.ZodString>;
+	authToken: z.ZodString;
+	fingerprintId: z.ZodString;
+	fingerprintHash: z.ZodString;
+}, z.core.$strip>;
+type User$1 = z.infer<typeof userSchema>;
+export declare const userFromJson: (json: string) => User$1 | null;
+/**
+ * Get the config directory path based on the environment.
+ * Uses the clientEnv to determine the environment suffix.
+ */
+export declare const getConfigDir: (clientEnv?: ClientEnv) => string;
+/**
+ * Get the credentials file path based on the environment.
+ */
+export declare const getCredentialsPath: (clientEnv?: ClientEnv) => string;
+export declare const getUserCredentials: (clientEnv?: ClientEnv) => User$1 | null;
+/**
+ * Agent definition with source file path metadata.
+ */
+export type LoadedAgentDefinition = AgentDefinition & {
+	/** The file path this agent was loaded from */
+	_sourceFilePath: string;
+	/** Live copy of handleSteps kept alongside its stringified form (see
+	 * processedAgentDefinition below). */
+	handleStepsFn?: AgentDefinition["handleSteps"];
+};
+/**
+ * Loaded agent definitions keyed by agent ID.
+ */
+export type LoadedAgents = Record<string, LoadedAgentDefinition>;
+/**
+ * Validation error for an agent that failed validation.
+ */
+export type AgentValidationError = {
+	/** The agent's ID */
+	agentId: string;
+	/** The source file path where the agent was loaded from */
+	filePath: string;
+	/** The validation error message */
+	message: string;
+};
+/**
+ * Result returned by loadLocalAgents when validate: true.
+ * Contains both the valid agents and any validation errors.
+ */
+export type LoadLocalAgentsResult = {
+	/** Valid agent definitions that passed validation */
+	agents: LoadedAgents;
+	/** Validation errors for agents that failed validation */
+	validationErrors: AgentValidationError[];
+};
+/**
+ * Load agent definitions from `.agents` directories.
+ *
+ * By default, searches for agents in:
+ * - `{cwd}/.agents`
+ * - `{cwd}/../.agents`
+ * - `{homedir}/.agents`
+ *
+ * Agent files can be `.ts`, `.tsx`, `.js`, `.mjs`, or `.cjs`.
+ * TypeScript files are loaded natively by Bun's runtime.
+ *
+ * @param options.agentsPath - Optional path to a specific agents directory
+ * @param options.verbose - Whether to log errors during loading
+ * @param options.validate - Whether to validate agents after loading
+ * @returns When validate is false/omitted: Record of agent definitions keyed by agent ID.
+ *          When validate is true: Object with valid agents and validation errors.
+ *
+ * @example
+ * ```typescript
+ * // Load from default locations
+ * const agents = await loadLocalAgents({ verbose: true })
+ *
+ * // Load from a specific directory
+ * const agents = await loadLocalAgents({ agentsPath: './my-agents' })
+ *
+ * // Load and validate agents - returns both valid agents and errors
+ * const { agents, validationErrors } = await loadLocalAgents({ validate: true })
+ * if (validationErrors.length > 0) {
+ *   console.error('Some agents failed validation:', validationErrors)
+ * }
+ *
+ * // Access source file path for debugging
+ * for (const agent of Object.values(agents)) {
+ *   console.log(`${agent.id} loaded from ${agent._sourceFilePath}`)
+ * }
+ *
+ * // Use with client.run()
+ * const result = await client.run({
+ *   agent: 'my-agent',
+ *   agentDefinitions: Object.values(agents),
+ *   prompt: 'Hello',
+ * })
+ * ```
+ */
+export declare function loadLocalAgents(options: {
+	agentsPath?: string;
+	verbose?: boolean;
+	validate: true;
+}): Promise<LoadLocalAgentsResult>;
+export declare function loadLocalAgents(options: {
+	agentsPath?: string;
+	verbose?: boolean;
+	validate?: false;
+}): Promise<LoadedAgents>;
+declare const mcpFileSchema: z.ZodObject<{
+	mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [
+		z.ZodObject<{
+			type: z.ZodDefault<z.ZodEnum<{
+				http: "http";
+				sse: "sse";
+			}>>;
+			url: z.ZodString;
+			params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+			headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+		}, z.core.$strict>,
+		z.ZodObject<{
+			type: z.ZodDefault<z.ZodLiteral<"stdio">>;
+			command: z.ZodString;
+			args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+			env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+		}, z.core.$strict>
+	]>>>;
+}, z.core.$strip>;
+export type MCPFileConfig = z.infer<typeof mcpFileSchema>;
+/**
+ * Loaded MCP configuration with resolved environment variables.
+ */
+export type LoadedMCPConfig = {
+	mcpServers: Record<string, MCPConfig$1>;
+	/** The file path this config was loaded from */
+	_sourceFilePath: string;
+};
+/**
+ * Load MCP configuration from `mcp.json` files in `.agents` directories.
+ *
+ * By default, searches for mcp.json in:
+ * - `{cwd}/.agents/mcp.json`
+ * - `{cwd}/../.agents/mcp.json`
+ * - `{homedir}/.agents/mcp.json`
+ *
+ * Later directories take precedence, so project MCP servers override global ones.
+ * Environment variable references (e.g., `$API_KEY`) are resolved from process.env.
+ *
+ * @param options.verbose - Whether to log errors during loading
+ * @returns Record of MCP server configurations keyed by server name
+ *
+ * @example
+ * ```typescript
+ * // Load from default locations
+ * const mcpConfig = await loadMCPConfig({ verbose: true })
+ *
+ * // Access MCP servers
+ * for (const [serverName, config] of Object.entries(mcpConfig.mcpServers)) {
+ *   console.log(`MCP server: ${serverName}`)
+ * }
+ * ```
+ */
+export declare function loadMCPConfig(options: {
+	verbose?: boolean;
+}): Promise<LoadedMCPConfig>;
+/**
+ * Synchronously load MCP configuration from `mcp.json` files in `.agents` directories.
+ * This is a sync version for use in contexts where async is not available.
+ *
+ * @param options.verbose - Whether to log errors during loading
+ * @returns Record of MCP server configurations keyed by server name
+ */
+export declare function loadMCPConfigSync(options: {
+	verbose?: boolean;
+}): LoadedMCPConfig;
+/**
+ * Formats available skills as XML for inclusion in tool descriptions.
+ */
+export declare function formatAvailableSkillsXml(skills: SkillsMap): string;
+/**
+ * Loads a single skill from a SKILL.md file.
+ * Returns null if the skill is invalid.
+ */
+/** Parse and validate one SKILL.md document without touching disk. */
+export declare function parseSkillFileContent(content: string, options: {
+	directoryName: string;
+	filePath: string;
+	verbose?: boolean;
+}): SkillDefinition | null;
+export type LoadSkillsOptions = {
+	/** Working directory for project skills. Defaults to process.cwd() */
+	cwd?: string;
+	/** Optional specific skills directory path */
+	skillsPath?: string;
+	/** Whether to log errors during loading */
+	verbose?: boolean;
+};
+/**
+ * Load skills from .agents/skills and .claude/skills directories.
+ *
+ * By default, searches for skills in (later overrides earlier):
+ * - `~/.claude/skills/` (global, Claude Code compatible)
+ * - `~/.agents/skills/` (global)
+ * - `{cwd}/.claude/skills/` (project, Claude Code compatible)
+ * - `{cwd}/.agents/skills/` (project, highest priority)
+ *
+ * Each skill must be in its own directory with a SKILL.md file:
+ * - `.agents/skills/my-skill/SKILL.md`
+ * - `.claude/skills/my-skill/SKILL.md`
+ *
+ * @param options.cwd - Working directory for project skills
+ * @param options.skillsPath - Optional path to a specific skills directory
+ * @param options.verbose - Whether to log errors during loading
+ * @returns Record of skill definitions keyed by skill name
+ *
+ * @example
+ * ```typescript
+ * // Load from default locations
+ * const skills = await loadSkills({ verbose: true })
+ *
+ * // Load from a specific directory
+ * const skills = await loadSkills({ skillsPath: './my-skills' })
+ *
+ * // Access a skill
+ * const gitReleaseSkill = skills['git-release']
+ * console.log(gitReleaseSkill.description)
+ * ```
+ */
+export declare function loadSkillsSync(options?: LoadSkillsOptions): SkillsMap;
+/** Async-compatible public loader retained for existing callers. */
+export declare function loadSkills(options?: LoadSkillsOptions): Promise<SkillsMap>;
+export interface ValidationResult {
+	success: boolean;
+	validationErrors: Array<{
+		id: string;
+		message: string;
+	}>;
+	errorCount: number;
+}
+export interface ValidateAgentsOptions {
+	/**
+	 * Whether to perform remote validation via the web API.
+	 * Remote validation checks spawnable agents against the database.
+	 */
+	remote?: boolean;
+	/**
+	 * The base URL of the Anvil website API.
+	 * Optional - defaults to NEXT_PUBLIC_ANVIL_APP_URL or environment-based URL.
+	 * Example: 'https://codebuff.com'
+	 */
+	websiteUrl?: string;
+}
+/**
+ * Validates an array of agent definitions.
+ *
+ * By default, performs local Zod schema validation.
+ * When `options.remote` is true, additionally validates spawnable agents via the web API.
+ *
+ * @param definitions - Array of agent definitions to validate
+ * @param options - Optional configuration for validation
+ * @returns Promise<ValidationResult> - Validation results with any errors
+ *
+ * @example
+ * ```typescript
+ * // Local validation only
+ * const result = await validateAgents(definitions)
+ *
+ * // Remote validation
+ * const result = await validateAgents(definitions, {
+ *   remote: true,
+ *   websiteUrl: 'https://codebuff.com'
+ * })
+ * ```
+ */
+export declare function validateAgents(definitions: AgentDefinition[], options?: ValidateAgentsOptions): Promise<ValidationResult>;
+/**
+ * Notification hook for free-mode capacity deferrals. When the backend sheds
+ * a free-mode completion under saturation (HTTP 429 with
+ * `error: 'free_mode_capacity_deferred'` — see the server's
+ * free-mode-priority.ts), the AI SDK's retry loop absorbs the wait silently.
+ * Hosts (the CLI) can register here to surface a "high demand" indicator
+ * instead of an unexplained pause.
+ */
+export type FreeModeCapacityDeferral = {
+	retryAfterSeconds: number;
+};
+export declare function setFreeModeCapacityDeferralListener(listener: ((deferral: FreeModeCapacityDeferral) => void) | null): void;
+/**
+ * SDK Error Utilities
+ *
+ * Simple utilities for error handling based on HTTP status codes.
+ * Uses the AI SDK's error types which include statusCode property.
+ */
+/**
+ * Error type with statusCode property
+ */
+export type HttpError = Error & {
+	statusCode: number;
+};
+/**
+ * HTTP status codes that should trigger automatic retry
+ */
+export declare const RETRYABLE_STATUS_CODES: Set<number>;
+/**
+ * Creates an Error with a statusCode property
+ */
+export declare function createHttpError(message: string, statusCode: number): HttpError;
+/**
+ * Creates an authentication error (401)
+ */
+export declare function createAuthError(message?: string): HttpError;
+/**
+ * Creates a forbidden error (403)
+ */
+export declare function createForbiddenError(message?: string): HttpError;
+/**
+ * Creates a payment required error (402)
+ */
+export declare function createPaymentRequiredError(message?: string): HttpError;
+/**
+ * Creates a server error (500 by default, or custom 5xx)
+ */
+export declare function createServerError(message?: string, statusCode?: number): HttpError;
+/**
+ * Creates a network error (503 - service unavailable)
+ * Used for connection failures, DNS errors, timeouts, etc.
+ */
+export declare function createNetworkError(message?: string): HttpError;
+/**
+ * Checks if an HTTP status code is retryable
+ */
+export declare function isRetryableStatusCode(statusCode: number | undefined): boolean;
+/**
+ * Extracts the statusCode from an error if available.
+ * Checks both 'statusCode' (our convention) and 'status' (AI SDK's APICallError convention).
+ */
+export declare function getErrorStatusCode(error: unknown): number | undefined;
+/**
+ * Sanitizes error messages for display
+ * Removes sensitive information and formats for user consumption
+ */
+export declare function sanitizeErrorMessage(error: unknown): string;
+/**
+ * Retry Configuration Constants
+ *
+ * This module defines constants for retry behavior and exponential backoff.
+ * Used by the CLI to automatically retry failed messages after reconnection.
+ *
+ * @example
+ * ```typescript
+ * import { MAX_RETRIES_PER_MESSAGE, RETRY_BACKOFF_BASE_DELAY_MS } from '@anvil/sdk'
+ *
+ * let retryCount = 0
+ * let backoffDelay = RETRY_BACKOFF_BASE_DELAY_MS
+ *
+ * while (retryCount < MAX_RETRIES_PER_MESSAGE) {
+ *   await new Promise(resolve => setTimeout(resolve, backoffDelay))
+ *   // ... retry logic
+ *   backoffDelay = Math.min(backoffDelay * 2, RETRY_BACKOFF_MAX_DELAY_MS)
+ *   retryCount++
+ * }
+ * ```
+ */
+/**
+ * Maximum number of retry attempts per message
+ * After this many attempts, the message is marked as permanently failed
+ */
+export declare const MAX_RETRIES_PER_MESSAGE = 3;
+/**
+ * Base delay in milliseconds for exponential backoff
+ * First retry: 1s, Second: 2s, Third: 4s, Fourth: 8s (capped)
+ */
+export declare const RETRY_BACKOFF_BASE_DELAY_MS = 1000;
+/**
+ * Maximum delay in milliseconds for exponential backoff
+ * Prevents backoff from growing indefinitely
+ */
+export declare const RETRY_BACKOFF_MAX_DELAY_MS = 8000;
+/**
+ * Duration in milliseconds to show the reconnection message
+ * After this time, the message auto-hides
+ */
+export declare const RECONNECTION_MESSAGE_DURATION_MS = 2000;
+/**
+ * Delay in milliseconds before retrying messages after reconnection
+ * Gives the connection time to stabilize before attempting retries
+ */
+export declare const RECONNECTION_RETRY_DELAY_MS = 500;
+export declare function promptAiSdkStream(params: ParamsOf<PromptAiSdkStreamFn>): ReturnType<PromptAiSdkStreamFn>;
+export declare function promptAiSdk(params: ParamsOf<PromptAiSdkFn>): ReturnType<PromptAiSdkFn>;
+export declare function promptAiSdkStructured<T>(params: PromptAiSdkStructuredInput<T>): PromptAiSdkStructuredOutput<T>;
+declare function getFileTokenScores$1(...args: Parameters<typeof getFileTokenScores>): ReturnType<typeof getFileTokenScores>;
+export declare function setWasmDir(dir: string): void;
+export declare function setTreeSitterWasmPath(wasmPath: string): void;
+
+export {
+	getFileTokenScores$1 as getFileTokenScores,
+};
+
+export {};