@levelcode/sdk 0.0.5 → 0.1.0

package/dist/index.d.ts

@@ -1,3443 +0,0 @@
-// Generated by dts-bundle-generator v9.5.1
-
-/// <reference types="node" />
-
-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;
-};
-export declare const jsonArraySchema: z.ZodType<JSONArray>;
-export type JSONArray = JSONValue[];
-declare const textPartSchema: z.ZodObject<{
-	type: z.ZodLiteral<"text">;
-	text: z.ZodString;
-	providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, 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.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, 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.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, 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.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, 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.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, 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>;
-declare const providerMetadataSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>>;
-type ProviderMetadata = z.infer<typeof providerMetadataSchema>;
-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;
-}, 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;
-}, 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;
-	}, 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;
-	}, z.core.$strip>
-], "type">;
-export type PrintModeEvent = z.infer<typeof printModeEventSchema>;
-declare const toolNames: readonly [
-	"add_subgoal",
-	"add_message",
-	"ask_user",
-	"browser_logs",
-	"code_search",
-	"create_plan",
-	"end_turn",
-	"find_files",
-	"glob",
-	"list_directory",
-	"lookup_agent_info",
-	"propose_str_replace",
-	"propose_write_file",
-	"read_docs",
-	"read_files",
-	"read_subtree",
-	"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",
-	"web_search",
-	"write_file",
-	"write_todos"
-];
-declare const publishedTools: readonly [
-	"add_message",
-	"ask_user",
-	"code_search",
-	"end_turn",
-	"find_files",
-	"glob",
-	"list_directory",
-	"lookup_agent_info",
-	"propose_str_replace",
-	"propose_write_file",
-	"read_docs",
-	"read_files",
-	"read_subtree",
-	"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"
-];
-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 LevelCode 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>;
-/**
- * The primary/default knowledge file name.
- * Used when creating new knowledge files.
- */
-export declare const PRIMARY_KNOWLEDGE_FILE_NAME = "knowledge.md";
-/**
- * Knowledge file names in priority order (highest priority first).
- * Used for both project knowledge files and home directory user knowledge files.
- */
-export declare const KNOWLEDGE_FILE_NAMES: readonly [
-	"knowledge.md",
-	"AGENTS.md",
-	"CLAUDE.md"
-];
-/**
- * Checks if a file path is a knowledge file.
- * Matches:
- * - Exact file names: knowledge.md, AGENTS.md, CLAUDE.md (case-insensitive)
- * - Pattern: *.knowledge.md (e.g., authentication.knowledge.md)
- */
-export declare function isKnowledgeFile(filePath: string): boolean;
-type ToolName$1 = "add_message" | "ask_user" | "code_search" | "end_turn" | "find_files" | "glob" | "list_directory" | "lookup_agent_info" | "propose_str_replace" | "propose_write_file" | "read_docs" | "read_files" | "read_subtree" | "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;
-	ask_user: AskUserParams;
-	code_search: CodeSearchParams;
-	end_turn: EndTurnParams;
-	find_files: FindFilesParams;
-	glob: GlobParams;
-	list_directory: ListDirectoryParams;
-	lookup_agent_info: LookupAgentInfoParams;
-	propose_str_replace: ProposeStrReplaceParams;
-	propose_write_file: ProposeWriteFileParams;
-	read_docs: ReadDocsParams;
-	read_files: ReadFilesParams;
-	read_subtree: ReadSubtreeParams;
-	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 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 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 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. */
-		old: string;
-		/** The string to replace the corresponding old string with. Can be empty to delete. */
-		new: string;
-		/** Whether to allow multiple replacements of old string. */
-		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 20000. Values less than 10000 are automatically increased 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 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. */
-		old: string;
-		/** The string to replace the corresponding old string with. Can be empty to delete. */
-		new: string;
-		/** Whether to allow multiple replacements of old string. */
-		allowMultiple?: boolean;
-	}[];
-}
-interface SuggestFollowupsParams {
-	/** List of suggested followup prompts the user can click to send */
-	followups: {
-		/** The full prompt text to send as a user message when clicked */
-		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;
-};
-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>>;
-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;
-}
-/**
- * LevelCode Agent Type Definitions
- *
- * This file provides TypeScript type definitions for creating custom LevelCode 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 'levelcode/file-picker@0.0.1'.
-	 *
-	 * Use the fully qualified agent id from the agent store, including publisher and version: 'levelcode/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;
-	/** 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>;
-	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.1" | "openai/gpt-5.1-chat" | "openai/gpt-5-mini" | "openai/gpt-5-nano" | "anthropic/claude-sonnet-4.5" | "anthropic/claude-opus-4.1" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-preview-09-2025" | "google/gemini-2.5-flash-lite-preview-09-2025" | "x-ai/grok-4-07-09" | "x-ai/grok-4-fast" | "x-ai/grok-code-fast-1" | "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-chat-v3-0324" | "deepseek/deepseek-chat-v3-0324:nitro" | "deepseek/deepseek-r1-0528" | "deepseek/deepseek-r1-0528:nitro" | "moonshotai/kimi-k2" | "moonshotai/kimi-k2:nitro" | "z-ai/glm-4.6" | "z-ai/glm-4.6:nitro" | (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 LevelCode SDK.
- *
- * Compatible with `fs.promises` from the `'fs'` module.
- */
-export type LevelCodeFileSystem = Pick<typeof fs.promises, "mkdir" | "readdir" | "readFile" | "stat" | "writeFile">;
-declare const SkillDefinitionSchema: z.ZodObject<{
-	name: z.ZodString;
-	description: z.ZodString;
-	license: z.ZodOptional<z.ZodString>;
-	metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-	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;
-	};
-};
-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>;
-	}, 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 LevelCodeSpawn = (command: string, args?: readonly string[], options?: SpawnOptions) => ChildProcess;
-/**
- * Given a list of candidate file paths, selects the one with highest priority.
- * Priority order: knowledge.md > AGENTS.md > CLAUDE.md (case-insensitive).
- * Returns undefined if no knowledge files are found.
- * @internal Exported for testing
- */
-export declare function selectHighestPriorityKnowledgeFile(candidates: string[]): string | undefined;
-export type RunState = {
-	sessionState?: SessionState;
-	output: AgentOutput;
-};
-export type InitialSessionStateOptions = {
-	cwd?: string;
-	projectFiles?: Record<string, string>;
-	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?: LevelCodeFileSystem;
-	spawn?: LevelCodeSpawn;
-	logger?: Logger$1;
-};
-/**
- * Loads user knowledge files from the home directory.
- * Checks for ~/.knowledge.md, ~/.AGENTS.md, and ~/.CLAUDE.md with priority fallback.
- * Matching is case-insensitive (e.g., ~/.KNOWLEDGE.md will match).
- * Returns a record with the tilde-prefixed path as key (e.g., "~/.knowledge.md").
- * @internal Exported for testing
- */
-export declare function loadUserKnowledgeFiles(params: {
-	fs: LevelCodeFileSystem;
-	logger: Logger$1;
-	/** Optional home directory override for testing */
-	homeDir?: string;
-}): Promise<Record<string, string>>;
-/**
- * Selects knowledge files from a list of file paths with fallback logic.
- * For each directory, checks for knowledge.md first, then AGENTS.md, then CLAUDE.md.
- * @internal Exported for testing
- */
-export declare function selectKnowledgeFilePaths(allFilePaths: string[]): string[];
-export declare function initialSessionState(params: InitialSessionStateOptions): Promise<SessionState>;
-export declare function generateInitialRunState({ cwd, projectFiles, knowledgeFiles, userKnowledgeFiles, agentDefinitions, customToolDefinitions, maxAgentSteps, fs, }: {
-	cwd: string;
-	projectFiles?: Record<string, string>;
-	knowledgeFiles?: Record<string, string>;
-	userKnowledgeFiles?: Record<string, string>;
-	agentDefinitions?: AgentDefinition[];
-	customToolDefinitions?: CustomToolDefinition[];
-	maxAgentSteps?: number;
-	fs: LevelCodeFileSystem;
-}): 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>;
-	knowledgeFiles?: Record<string, string>;
-	agentDefinitions?: AgentDefinition[];
-	customToolDefinitions?: CustomToolDefinition[];
-	maxAgentSteps?: number;
-}): Promise<SessionState>;
-export type FileFilterResult = {
-	status: "blocked" | "allow-example" | "allow";
-};
-export type FileFilter = (filePath: string) => FileFilterResult;
-export declare function getFiles(params: {
-	filePaths: string[];
-	cwd: string;
-	fs: LevelCodeFileSystem;
-	/**
-	 * Filter to classify files before reading.
-	 * If provided, the caller takes full control of filtering (no gitignore check).
-	 * If not provided, the SDK applies gitignore checking automatically.
-	 */
-	fileFilter?: FileFilter;
-}): Promise<Record<string, string | null>>;
-declare const toolParams: {
-	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>;
-	};
-	ask_user: {
-		toolName: "ask_user";
-		endsAgentStep: true;
-		description: string;
-		inputSchema: z.ZodObject<{
-			questions: z.ZodArray<z.ZodObject<{
-				question: z.ZodString;
-				header: z.ZodOptional<z.ZodString>;
-				options: 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>;
-	};
-	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;
-					unifiedDiff: string;
-				} | {
-					file: string;
-					errorMessage: string;
-					patch?: string | undefined;
-				}, unknown, z.core.$ZodTypeInternals<{
-					file: string;
-					message: string;
-					unifiedDiff: 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>;
-		}, 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>;
-	};
-	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.ZodArray<z.ZodObject<{
-				old: z.ZodString;
-				new: 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.ZodArray<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;
-				})[], 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.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" | "tokens" | "unimportant-files" | "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" | "tokens" | "unimportant-files" | "depth-based";
-				} | {
-					path: string;
-					type: "file";
-					variables: string[];
-				} | {
-					path: string;
-					errorMessage: 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.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-		}, 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.ZodArray<z.ZodObject<{
-				agent_type: z.ZodString;
-				prompt: z.ZodOptional<z.ZodString>;
-				params: z.ZodOptional<z.ZodRecord<z.ZodString, 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.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.ZodArray<z.ZodObject<{
-				old: z.ZodString;
-				new: 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;
-					patch?: string | undefined;
-				}, unknown, z.core.$ZodTypeInternals<{
-					file: string;
-					message: string;
-					unifiedDiff: 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.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>;
-	};
-	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;
-					unifiedDiff: string;
-				} | {
-					file: string;
-					errorMessage: string;
-					patch?: string | undefined;
-				}, unknown, z.core.$ZodTypeInternals<{
-					file: string;
-					message: string;
-					unifiedDiff: 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.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 LevelCodeToolOutput<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<"ask_user">;
-		input: z.ZodObject<{
-			questions: z.ZodArray<z.ZodObject<{
-				question: z.ZodString;
-				header: z.ZodOptional<z.ZodString>;
-				options: 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>;
-		}, 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<"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.ZodOptional<z.ZodDefault<z.ZodNumber>>;
-		}, 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>
-], "toolName">;
-declare const clientToolNames: ("glob" | "create_plan" | "ask_user" | "browser_logs" | "code_search" | "list_directory" | "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 Source<T> = T | Promise<T> | (T extends (...args: unknown[]) => unknown ? never : () => T | Promise<T>);
-type LevelCodeClientOptions = {
-	apiKey?: string;
-	cwd?: string;
-	projectFiles?: Record<string, string>;
-	knowledgeFiles?: Record<string, string>;
-	agentDefinitions?: AgentDefinition[];
-	maxAgentSteps?: number;
-	env?: Record<string, string>;
-	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?: Partial<{
-		[K in ClientToolName & PublishedToolName]: (input: ClientToolCall<K>["input"]) => Promise<LevelCodeToolOutput<K>>;
-	} & {
-		read_files: (input: {
-			filePaths: string[];
-		}) => Promise<Record<string, string | null>>;
-	}>;
-	customToolDefinitions?: CustomToolDefinition[];
-	fsSource?: Source<LevelCodeFileSystem>;
-	spawnSource?: Source<LevelCodeSpawn>;
-	logger?: Logger$1;
-};
-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;
-	/** Content array for multimodal messages (text + images) */
-	content?: MessageContent[];
-	params?: Record<string, any>;
-	previousRun?: RunState;
-	extraToolResults?: ToolMessage[];
-	signal?: AbortSignal;
-	costMode?: string;
-};
-type RunExecutionOptions = RunOptions & LevelCodeClientOptions & {
-	apiKey: string;
-	fingerprintId: string;
-};
-export declare function run(options: RunExecutionOptions): Promise<RunState>;
-/**
- * Combines prompt, params, and content into a unified message content structure.
- * Always wraps the first text part in <user_message> tags for consistent XML framing.
- * If you need a specific text part wrapped, put it first or pre-wrap it yourself before calling.
- */
-export declare function buildUserMessageContent(prompt: string | undefined, params: Record<string, any> | undefined, content?: Array<TextPart | ImagePart>): Array<TextPart | ImagePart>;
-export declare class LevelCodeClient {
-	options: LevelCodeClientOptions & {
-		apiKey: string;
-		fingerprintId: string;
-	};
-	constructor(options: LevelCodeClientOptions);
-	/**
-	 * Run a LevelCode 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 LevelCode 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 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 & LevelCodeClientOptions): Promise<RunState>;
-	/**
-	 * Check connection to the LevelCode 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.ZodDefault<z.ZodEnum<{
-		dev: "dev";
-		test: "test";
-		prod: "prod";
-	}>>;
-	NEXT_PUBLIC_LEVELCODE_APP_URL: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_SUPPORT_EMAIL: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_POSTHOG_API_KEY: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_POSTHOG_HOST_URL: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL: z.ZodDefault<z.ZodString>;
-	NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION_ID: z.ZodOptional<z.ZodString>;
-	NEXT_PUBLIC_WEB_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-}, 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 & {
-	LEVELCODE_RG_PATH?: string;
-	LEVELCODE_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: LevelCodeFileSystem;
-}): Promise<LevelCodeToolOutput<"str_replace">>;
-declare function codeSearch({ projectPath, pattern, flags, cwd, maxResults, globalMaxResults, maxOutputStringLength, timeoutSeconds, logger, }: {
-	projectPath: string;
-	pattern: string;
-	flags?: string;
-	cwd?: string;
-	maxResults?: number;
-	globalMaxResults?: number;
-	maxOutputStringLength?: number;
-	timeoutSeconds?: number;
-	logger?: Logger$1;
-}): Promise<LevelCodeToolOutput<"code_search">>;
-declare function glob(params: {
-	pattern: string;
-	projectPath: string;
-	cwd?: string;
-	fs: LevelCodeFileSystem;
-}): Promise<LevelCodeToolOutput<"glob">>;
-declare function listDirectory(params: {
-	directoryPath: string;
-	projectPath: string;
-	fs: LevelCodeFileSystem;
-}): Promise<LevelCodeToolOutput<"list_directory">>;
-declare function runFileChangeHooks({ files, }: {
-	files: string[];
-}): Promise<LevelCodeToolOutput<"run_file_change_hooks">>;
-export declare function runTerminalCommand({ command, process_type, cwd, timeout_seconds, env, }: {
-	command: string;
-	process_type: "SYNC" | "BACKGROUND";
-	cwd: string;
-	timeout_seconds: number;
-	env?: NodeJS.ProcessEnv;
-}): Promise<LevelCodeToolOutput<"run_terminal_command">>;
-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 LEVELCODE_BINARY = "levelcode";
-export declare const WEBSITE_URL: string;
-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>;
-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 deepseekChat: "deepseek-chat";
-	readonly deepseekReasoner: "deepseek-reasoner";
-	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;
-	outputMode: "last_message" | "all_messages" | "structured_output";
-	outputSchema?: z.ZodSchema<any>;
-	handleSteps?: StepHandler<P, T> | string;
-};
-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;
-	logger: Logger;
-}) => StepGenerator;
-type User = {
-	id: string;
-	email: string;
-	discord_id: string | null;
-	referral_code: string | null;
-	stripe_customer_id: string | null;
-	banned: boolean;
-};
-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>;
-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>>;
-export declare function getUserInfoFromApiKey<T extends UserColumn>(params: GetUserInfoFromApiKeyInput<T>): GetUserInfoFromApiKeyOutput<T>;
-export declare const getOpenRouterApiKeyFromEnv: () => string | undefined;
-/**
- * Standalone mode: bypass all backend dependencies, route LLM calls directly.
- * Default mode when no backend URL (NEXT_PUBLIC_LEVELCODE_APP_URL) is configured.
- * Also activates when a direct provider key (OPENROUTER_API_KEY or ANTHROPIC_API_KEY)
- * is set AND LEVELCODE_API_KEY is NOT set.
- */
-export declare const isStandaloneMode: () => boolean;
-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;
-/**
- * Claude OAuth credentials stored in the credentials file.
- */
-export interface ClaudeOAuthCredentials {
-	accessToken: string;
-	refreshToken: string;
-	expiresAt: number;
-	connectedAt: number;
-}
-/**
- * Get Claude OAuth credentials from file or environment variable.
- * Environment variable takes precedence.
- * @returns OAuth credentials or null if not found
- */
-export declare const getClaudeOAuthCredentials: (clientEnv?: ClientEnv) => ClaudeOAuthCredentials | null;
-/**
- * Save Claude OAuth credentials to the credentials file.
- * Preserves existing user credentials.
- */
-export declare const saveClaudeOAuthCredentials: (credentials: ClaudeOAuthCredentials, clientEnv?: ClientEnv) => void;
-/**
- * Clear Claude OAuth credentials from the credentials file.
- * Preserves other credentials.
- */
-export declare const clearClaudeOAuthCredentials: (clientEnv?: ClientEnv) => void;
-/**
- * Check if Claude OAuth credentials are valid (not expired).
- * Returns true if credentials exist and haven't expired.
- */
-export declare const isClaudeOAuthValid: (clientEnv?: ClientEnv) => boolean;
-/**
- * Refresh the Claude OAuth access token using the refresh token.
- * Returns the new credentials if successful, null if refresh fails.
- * Uses a mutex to prevent concurrent refresh attempts.
- */
-export declare const refreshClaudeOAuthToken: (clientEnv?: ClientEnv) => Promise<ClaudeOAuthCredentials | null>;
-/**
- * Get valid Claude OAuth credentials, refreshing if necessary.
- * This is the main function to use when you need credentials for an API call.
- *
- * - Returns credentials immediately if valid (>5 min until expiry)
- * - Attempts refresh if token is expired or near-expiry
- * - Returns null if no credentials or refresh fails
- */
-export declare const getValidClaudeOAuthCredentials: (clientEnv?: ClientEnv) => Promise<ClaudeOAuthCredentials | null>;
-/**
- * Agent definition with source file path metadata.
- */
-export type LoadedAgentDefinition = AgentDefinition & {
-	/** The file path this agent was loaded from */
-	_sourceFilePath: string;
-};
-/**
- * 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;
-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 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 LevelCode website API.
-	 * Optional - defaults to NEXT_PUBLIC_LEVELCODE_APP_URL or environment-based URL.
-	 * Example: 'https://levelcode.vercel.app'
-	 */
-	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://levelcode.vercel.app'
- * })
- * ```
- */
-export declare function validateAgents(definitions: AgentDefinition[], options?: ValidateAgentsOptions): Promise<ValidationResult>;
-/**
- * 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 '@levelcode/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;
-/**
- * Set a custom WASM directory for loading tree-sitter WASM files.
- * This can be useful for custom packaging or deployment scenarios.
- */
-export declare function setWasmDir(dir: string): void;
-export interface TokenCallerMap {
-	[filePath: string]: {
-		[token: string]: string[];
-	};
-}
-export interface FileTokenData {
-	tokenScores: {
-		[filePath: string]: {
-			[token: string]: number;
-		};
-	};
-	tokenCallers: TokenCallerMap;
-}
-export declare function getFileTokenScores(projectRoot: string, filePaths: string[], readFile?: (filePath: string) => string | null): Promise<FileTokenData>;
-declare enum AnalyticsEvent {
-	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",
-	SLASH_MENU_ACTIVATED = "cli.slash_menu_activated",
-	SLASH_COMMAND_USED = "cli.slash_command_used",
-	TERMINAL_COMMAND_COMPLETED = "cli.terminal_command_completed",
-	USER_INPUT_COMPLETE = "cli.user_input_complete",
-	UPDATE_LEVELCODE_FAILED = "cli.update_levelcode_failed",
-	FEEDBACK_SUBMITTED = "cli.feedback_submitted",
-	FEEDBACK_BUTTON_HOVERED = "cli.feedback_button_hovered",
-	FOLLOWUP_CLICKED = "cli.followup_clicked",
-	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_REFERRAL_GITHUB_LOGIN_STARTED = "auth.referral_github_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",
-	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",
-	REFERRAL_BANNER_CLICKED = "referral_banner.clicked",
-	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",
-	ADS_API_AUTH_ERROR = "api.ads_auth_error",
-	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",
-	CLAUDE_OAUTH_REQUEST = "sdk.claude_oauth_request",
-	CLAUDE_OAUTH_RATE_LIMITED = "sdk.claude_oauth_rate_limited",
-	CLAUDE_OAUTH_AUTH_ERROR = "sdk.claude_oauth_auth_error",
-	FLUSH_FAILED = "common.flush_failed",
-	CLI_LOG = "cli.log"
-}
-type TrackEventFn = (params: {
-	event: AnalyticsEvent;
-	userId: string;
-	properties?: Record<string, any>;
-	logger: Logger$1;
-}) => void;
-type GrantType = "free" | "referral" | "referral_legacy" | "subscription" | "purchase" | "admin" | "organization" | "ad";
-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 SendActionFn = (params: {
-	action: ServerAction;
-}) => void;
-type PromptResult<T> = PromptSuccess<T> | PromptAborted;
-type PromptSuccess<T> = {
-	aborted: false;
-	value: T;
-};
-type PromptAborted = {
-	aborted: true;
-	reason?: string;
-};
-type StreamChunk = {
-	type: "text";
-	text: string;
-	agentId?: string;
-} | {
-	type: "reasoning";
-	text: string;
-} | Pick<ToolCallPart, "type" | "toolCallId" | "toolName" | "input" | "providerOptions"> | {
-	type: "error";
-	message: string;
-};
-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>;
-	includeCacheControl?: boolean;
-	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;
-	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>;
-	includeCacheControl?: boolean;
-	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>;
-	includeCacheControl?: boolean;
-	agentProviderOptions?: OpenRouterProviderRoutingOptions;
-	maxRetries?: number;
-	sendAction: SendActionFn;
-	logger: Logger$1;
-	trackEvent: TrackEventFn;
-	signal: AbortSignal;
-};
-type PromptAiSdkStructuredOutput<T> = Promise<PromptResult<T>>;
-export declare function promptAiSdkStream(params: ParamsOf<PromptAiSdkStreamFn> & {
-	skipClaudeOAuth?: boolean;
-	onClaudeOAuthStatusChange?: (isActive: boolean) => void;
-}): ReturnType<PromptAiSdkStreamFn>;
-export declare function promptAiSdk(params: ParamsOf<PromptAiSdkFn>): ReturnType<PromptAiSdkFn>;
-export declare function promptAiSdkStructured<T>(params: PromptAiSdkStructuredInput<T>): PromptAiSdkStructuredOutput<T>;
-/**
- * Reset the Claude OAuth rate limit cache.
- * Call this when user reconnects their Claude subscription.
- */
-export declare function resetClaudeOAuthRateLimit(): void;
-
-export {};