@ljoukov/llm 2.0.0 → 3.0.0

package/dist/index.d.cts

@@ -75,7 +75,7 @@ type LlmBlockedEvent = {
     readonly type: "blocked";
 };
 type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent;
-type LlmProvider = "openai" | "chatgpt" | "gemini";
+type LlmProvider = "openai" | "chatgpt" | "gemini" | "fireworks";
 type LlmTextResult = {
     readonly provider: LlmProvider;
     readonly model: string;
@@ -191,17 +191,37 @@ type LlmGenerateImagesRequest = {
     readonly imageSize?: LlmImageSize;
     readonly signal?: AbortSignal;
 };
-type LlmExecutableTool<Schema extends z.ZodType, Output> = {
+type LlmFunctionTool<Schema extends z.ZodType, Output> = {
+    readonly type?: "function";
     readonly description?: string;
     readonly inputSchema: Schema;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 };
+type LlmCustomToolInputFormat = {
+    readonly type: "text";
+} | {
+    readonly type: "grammar";
+    readonly syntax: "lark" | "regex";
+    readonly definition: string;
+};
+type LlmCustomTool<Output> = {
+    readonly type: "custom";
+    readonly description?: string;
+    readonly format?: LlmCustomToolInputFormat;
+    readonly execute: (input: string) => Promise<Output> | Output;
+};
+type LlmExecutableTool<Schema extends z.ZodType, Output> = LlmFunctionTool<Schema, Output> | LlmCustomTool<Output>;
 type LlmToolSet = Record<string, LlmExecutableTool<z.ZodType, unknown>>;
 declare function tool<Schema extends z.ZodType, Output>(options: {
     readonly description?: string;
     readonly inputSchema: Schema;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
-}): LlmExecutableTool<Schema, Output>;
+}): LlmFunctionTool<Schema, Output>;
+declare function customTool<Output>(options: {
+    readonly description?: string;
+    readonly format?: LlmCustomToolInputFormat;
+    readonly execute: (input: string) => Promise<Output> | Output;
+}): LlmCustomTool<Output>;
 type LlmToolCallResult = {
     readonly toolName: string;
     readonly input: unknown;
@@ -270,6 +290,232 @@ declare function loadEnvFromFile(filePath: string, { override }?: {
     override?: boolean;
 }): void;
 
+type AgentPathKind = "file" | "directory" | "symlink" | "other";
+type AgentPathInfo = {
+    readonly kind: AgentPathKind;
+    readonly mtimeMs: number;
+};
+type AgentDirectoryEntry = {
+    readonly name: string;
+    readonly path: string;
+    readonly kind: AgentPathKind;
+    readonly mtimeMs: number;
+};
+interface AgentFilesystem {
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    ensureDir(directoryPath: string): Promise<void>;
+    readDir(directoryPath: string): Promise<readonly AgentDirectoryEntry[]>;
+    stat(entryPath: string): Promise<AgentPathInfo>;
+}
+declare class InMemoryAgentFilesystem implements AgentFilesystem {
+    #private;
+    constructor(initialFiles?: Record<string, string>);
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    ensureDir(directoryPath: string): Promise<void>;
+    readDir(directoryPath: string): Promise<readonly AgentDirectoryEntry[]>;
+    stat(entryPath: string): Promise<AgentPathInfo>;
+    snapshot(): Record<string, string>;
+}
+declare function createNodeAgentFilesystem(): AgentFilesystem;
+declare function createInMemoryAgentFilesystem(initialFiles?: Record<string, string>): InMemoryAgentFilesystem;
+
+type AgentFilesystemToolProfile = "auto" | "model-agnostic" | "codex" | "gemini";
+type AgentFilesystemToolName = "apply_patch" | "read_file" | "read_files" | "write_file" | "replace" | "list_dir" | "list_directory" | "grep_files" | "rg_search" | "grep_search" | "glob";
+type AgentFilesystemToolAction = "read" | "write" | "delete" | "move" | "list" | "search";
+type AgentFilesystemToolAccessContext = {
+    readonly cwd: string;
+    readonly tool: AgentFilesystemToolName;
+    readonly action: AgentFilesystemToolAction;
+    readonly path: string;
+    readonly fromPath?: string;
+    readonly toPath?: string;
+    readonly pattern?: string;
+    readonly include?: string;
+};
+type AgentFilesystemToolAccessHook = (context: AgentFilesystemToolAccessContext) => Promise<void> | void;
+type AgentFilesystemToolsOptions = {
+    readonly cwd?: string;
+    readonly fs?: AgentFilesystem;
+    readonly allowOutsideCwd?: boolean;
+    readonly checkAccess?: AgentFilesystemToolAccessHook;
+    readonly maxLineLength?: number;
+    readonly grepMaxScannedFiles?: number;
+    readonly applyPatch?: {
+        readonly maxPatchBytes?: number;
+    };
+};
+declare const codexReadFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        slice: "slice";
+        indentation: "indentation";
+    }>>;
+    indentation: z.ZodOptional<z.ZodObject<{
+        anchor_line: z.ZodOptional<z.ZodNumber>;
+        max_levels: z.ZodOptional<z.ZodNumber>;
+        include_siblings: z.ZodOptional<z.ZodBoolean>;
+        include_header: z.ZodOptional<z.ZodBoolean>;
+        max_lines: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const codexListDirInputSchema: z.ZodObject<{
+    dir_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const codexGrepFilesInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    include: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const applyPatchInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>;
+declare const geminiReadFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiReadFilesInputSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    line_offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    line_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    char_offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    char_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    include_line_numbers: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const geminiWriteFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+declare const geminiReplaceInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    instruction: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    expected_replacements: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiListDirectoryInputSchema: z.ZodObject<{
+    dir_path: z.ZodString;
+    ignore: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    file_filtering_options: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        respect_git_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        respect_gemini_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const geminiRgSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    exclude_pattern: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    names_only: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    max_matches_per_file: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    max_results: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiGrepSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    dir_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    include: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    exclude_pattern: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    names_only: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    max_matches_per_file: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total_max_matches: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiGlobInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    dir_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    respect_git_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    respect_gemini_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+type CodexReadFileToolInput = z.output<typeof codexReadFileInputSchema>;
+type CodexListDirToolInput = z.output<typeof codexListDirInputSchema>;
+type CodexGrepFilesToolInput = z.output<typeof codexGrepFilesInputSchema>;
+type CodexApplyPatchToolInput = z.output<typeof applyPatchInputSchema>;
+type GeminiReadFileToolInput = z.output<typeof geminiReadFileInputSchema>;
+type GeminiReadFilesToolInput = z.output<typeof geminiReadFilesInputSchema>;
+type GeminiWriteFileToolInput = z.output<typeof geminiWriteFileInputSchema>;
+type GeminiReplaceToolInput = z.output<typeof geminiReplaceInputSchema>;
+type GeminiListDirectoryToolInput = z.output<typeof geminiListDirectoryInputSchema>;
+type GeminiGrepSearchToolInput = z.output<typeof geminiGrepSearchInputSchema>;
+type GeminiRgSearchToolInput = z.output<typeof geminiRgSearchInputSchema>;
+type GeminiGlobToolInput = z.output<typeof geminiGlobInputSchema>;
+declare function resolveFilesystemToolProfile(model: string, profile?: AgentFilesystemToolProfile): Exclude<AgentFilesystemToolProfile, "auto">;
+declare function createFilesystemToolSetForModel(model: string, profileOrOptions?: AgentFilesystemToolProfile | AgentFilesystemToolsOptions, maybeOptions?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createCodexFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createGeminiFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createModelAgnosticFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createCodexApplyPatchTool(options?: AgentFilesystemToolsOptions): LlmCustomTool<string>;
+declare function createCodexReadFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexReadFileInputSchema, string>;
+declare function createListDirTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexListDirInputSchema, string>;
+declare function createGrepFilesTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexGrepFilesInputSchema, string>;
+declare function createGeminiReadFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReadFileInputSchema, string>;
+declare function createReadFilesTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReadFilesInputSchema, string>;
+declare function createWriteFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiWriteFileInputSchema, string>;
+declare function createReplaceTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReplaceInputSchema, string>;
+declare function createListDirectoryTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiListDirectoryInputSchema, string>;
+declare function createGrepSearchTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiGrepSearchInputSchema, string>;
+declare function createRgSearchTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiRgSearchInputSchema, string>;
+declare function createGlobTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiGlobInputSchema, string>;
+
+type AgentFilesystemToolConfig = {
+    readonly enabled?: boolean;
+    readonly profile?: AgentFilesystemToolProfile;
+    readonly options?: AgentFilesystemToolsOptions;
+};
+type AgentFilesystemToolSelection = boolean | AgentFilesystemToolProfile | AgentFilesystemToolConfig;
+type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
+    readonly tools?: LlmToolSet;
+    readonly filesystemTool?: AgentFilesystemToolSelection;
+    readonly filesystem_tool?: AgentFilesystemToolSelection;
+};
+declare function runAgentLoop(request: RunAgentLoopRequest): Promise<LlmToolLoopResult>;
+
+declare const CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION = "Use the `apply_patch` tool to edit files. This is a FREEFORM tool, so do not wrap the patch in JSON.";
+declare const CODEX_APPLY_PATCH_LARK_GRAMMAR: string;
+declare const CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION: string;
+type ApplyPatchAccessContext = {
+    readonly cwd: string;
+    readonly kind: "add" | "delete" | "update" | "move";
+    readonly path: string;
+    readonly fromPath?: string;
+    readonly toPath?: string;
+};
+type ApplyPatchAccessHook = (context: ApplyPatchAccessContext) => Promise<void> | void;
+type ApplyPatchRequest = {
+    readonly patch: string;
+    readonly cwd?: string;
+    readonly fs?: AgentFilesystem;
+    readonly allowOutsideCwd?: boolean;
+    readonly checkAccess?: ApplyPatchAccessHook;
+    readonly maxPatchBytes?: number;
+};
+type ApplyPatchResult = {
+    readonly success: true;
+    readonly summary: string;
+    readonly added: readonly string[];
+    readonly modified: readonly string[];
+    readonly deleted: readonly string[];
+};
+type CreateApplyPatchToolOptions = Omit<ApplyPatchRequest, "patch"> & {
+    readonly description?: string;
+};
+declare const applyPatchToolInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>;
+type ApplyPatchToolInput = z.output<typeof applyPatchToolInputSchema>;
+declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmFunctionTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
+declare function applyPatch(request: ApplyPatchRequest): Promise<ApplyPatchResult>;
+
 type ChatGptAuthProfile = {
     readonly access: string;
     readonly refresh: string;
@@ -284,10 +530,13 @@ declare function exchangeChatGptOauthCode({ code, verifier, redirectUri, }: {
     verifier: string;
     redirectUri?: string;
 }): Promise<ChatGptAuthProfile>;
-declare function refreshChatGptOauthToken(refreshToken: string): Promise<ChatGptAuthProfile>;
+declare function refreshChatGptOauthToken(refreshToken: string, fallback?: {
+    accountId?: string;
+    idToken?: string;
+}): Promise<ChatGptAuthProfile>;
 declare function getChatGptAuthProfile(): Promise<ChatGptAuthProfile>;
 
-declare const GEMINI_MODEL_IDS: readonly ["gemini-3-pro-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
+declare const GEMINI_MODEL_IDS: readonly ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
 type GeminiModelId = (typeof GEMINI_MODEL_IDS)[number];
 declare function isGeminiModelId(value: string): value is GeminiModelId;
 type GeminiConfiguration = {
@@ -296,4 +545,12 @@ type GeminiConfiguration = {
 };
 declare function configureGemini(options?: GeminiConfiguration): void;
 
-export { type ChatGptAuthProfile, type GeminiModelId, type JsonSchema, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmExecutableTool, type LlmImageData, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallContext, type LlmToolCallResult, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopStep, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, appendMarkdownSourcesSection, configureGemini, convertGooglePartsToLlmParts, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };
+declare const FIREWORKS_MODEL_IDS: readonly ["kimi-k2.5", "glm-5", "minimax-m2.1"];
+type FireworksModelId = (typeof FIREWORKS_MODEL_IDS)[number];
+declare const FIREWORKS_DEFAULT_KIMI_MODEL: FireworksModelId;
+declare const FIREWORKS_DEFAULT_GLM_MODEL: FireworksModelId;
+declare const FIREWORKS_DEFAULT_MINIMAX_MODEL: FireworksModelId;
+declare function isFireworksModelId(value: string): value is FireworksModelId;
+declare function resolveFireworksModelId(model: string): string | undefined;
+
+export { type AgentDirectoryEntry, type AgentFilesystem, type AgentFilesystemToolAccessContext, type AgentFilesystemToolAccessHook, type AgentFilesystemToolAction, type AgentFilesystemToolConfig, type AgentFilesystemToolName, type AgentFilesystemToolProfile, type AgentFilesystemToolSelection, type AgentFilesystemToolsOptions, type AgentPathInfo, type AgentPathKind, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallContext, type LlmToolCallResult, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopStep, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGeminiReadFileTool, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFilesTool, createReplaceTool, createRgSearchTool, createWriteFileTool, customTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isFireworksModelId, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };

package/dist/index.d.ts

@@ -75,7 +75,7 @@ type LlmBlockedEvent = {
     readonly type: "blocked";
 };
 type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent;
-type LlmProvider = "openai" | "chatgpt" | "gemini";
+type LlmProvider = "openai" | "chatgpt" | "gemini" | "fireworks";
 type LlmTextResult = {
     readonly provider: LlmProvider;
     readonly model: string;
@@ -191,17 +191,37 @@ type LlmGenerateImagesRequest = {
     readonly imageSize?: LlmImageSize;
     readonly signal?: AbortSignal;
 };
-type LlmExecutableTool<Schema extends z.ZodType, Output> = {
+type LlmFunctionTool<Schema extends z.ZodType, Output> = {
+    readonly type?: "function";
     readonly description?: string;
     readonly inputSchema: Schema;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
 };
+type LlmCustomToolInputFormat = {
+    readonly type: "text";
+} | {
+    readonly type: "grammar";
+    readonly syntax: "lark" | "regex";
+    readonly definition: string;
+};
+type LlmCustomTool<Output> = {
+    readonly type: "custom";
+    readonly description?: string;
+    readonly format?: LlmCustomToolInputFormat;
+    readonly execute: (input: string) => Promise<Output> | Output;
+};
+type LlmExecutableTool<Schema extends z.ZodType, Output> = LlmFunctionTool<Schema, Output> | LlmCustomTool<Output>;
 type LlmToolSet = Record<string, LlmExecutableTool<z.ZodType, unknown>>;
 declare function tool<Schema extends z.ZodType, Output>(options: {
     readonly description?: string;
     readonly inputSchema: Schema;
     readonly execute: (input: z.output<Schema>) => Promise<Output> | Output;
-}): LlmExecutableTool<Schema, Output>;
+}): LlmFunctionTool<Schema, Output>;
+declare function customTool<Output>(options: {
+    readonly description?: string;
+    readonly format?: LlmCustomToolInputFormat;
+    readonly execute: (input: string) => Promise<Output> | Output;
+}): LlmCustomTool<Output>;
 type LlmToolCallResult = {
     readonly toolName: string;
     readonly input: unknown;
@@ -270,6 +290,232 @@ declare function loadEnvFromFile(filePath: string, { override }?: {
     override?: boolean;
 }): void;
 
+type AgentPathKind = "file" | "directory" | "symlink" | "other";
+type AgentPathInfo = {
+    readonly kind: AgentPathKind;
+    readonly mtimeMs: number;
+};
+type AgentDirectoryEntry = {
+    readonly name: string;
+    readonly path: string;
+    readonly kind: AgentPathKind;
+    readonly mtimeMs: number;
+};
+interface AgentFilesystem {
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    ensureDir(directoryPath: string): Promise<void>;
+    readDir(directoryPath: string): Promise<readonly AgentDirectoryEntry[]>;
+    stat(entryPath: string): Promise<AgentPathInfo>;
+}
+declare class InMemoryAgentFilesystem implements AgentFilesystem {
+    #private;
+    constructor(initialFiles?: Record<string, string>);
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    ensureDir(directoryPath: string): Promise<void>;
+    readDir(directoryPath: string): Promise<readonly AgentDirectoryEntry[]>;
+    stat(entryPath: string): Promise<AgentPathInfo>;
+    snapshot(): Record<string, string>;
+}
+declare function createNodeAgentFilesystem(): AgentFilesystem;
+declare function createInMemoryAgentFilesystem(initialFiles?: Record<string, string>): InMemoryAgentFilesystem;
+
+type AgentFilesystemToolProfile = "auto" | "model-agnostic" | "codex" | "gemini";
+type AgentFilesystemToolName = "apply_patch" | "read_file" | "read_files" | "write_file" | "replace" | "list_dir" | "list_directory" | "grep_files" | "rg_search" | "grep_search" | "glob";
+type AgentFilesystemToolAction = "read" | "write" | "delete" | "move" | "list" | "search";
+type AgentFilesystemToolAccessContext = {
+    readonly cwd: string;
+    readonly tool: AgentFilesystemToolName;
+    readonly action: AgentFilesystemToolAction;
+    readonly path: string;
+    readonly fromPath?: string;
+    readonly toPath?: string;
+    readonly pattern?: string;
+    readonly include?: string;
+};
+type AgentFilesystemToolAccessHook = (context: AgentFilesystemToolAccessContext) => Promise<void> | void;
+type AgentFilesystemToolsOptions = {
+    readonly cwd?: string;
+    readonly fs?: AgentFilesystem;
+    readonly allowOutsideCwd?: boolean;
+    readonly checkAccess?: AgentFilesystemToolAccessHook;
+    readonly maxLineLength?: number;
+    readonly grepMaxScannedFiles?: number;
+    readonly applyPatch?: {
+        readonly maxPatchBytes?: number;
+    };
+};
+declare const codexReadFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        slice: "slice";
+        indentation: "indentation";
+    }>>;
+    indentation: z.ZodOptional<z.ZodObject<{
+        anchor_line: z.ZodOptional<z.ZodNumber>;
+        max_levels: z.ZodOptional<z.ZodNumber>;
+        include_siblings: z.ZodOptional<z.ZodBoolean>;
+        include_header: z.ZodOptional<z.ZodBoolean>;
+        max_lines: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const codexListDirInputSchema: z.ZodObject<{
+    dir_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const codexGrepFilesInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    include: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const applyPatchInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>;
+declare const geminiReadFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiReadFilesInputSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    line_offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    line_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    char_offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    char_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    include_line_numbers: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+declare const geminiWriteFileInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+declare const geminiReplaceInputSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    instruction: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    expected_replacements: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiListDirectoryInputSchema: z.ZodObject<{
+    dir_path: z.ZodString;
+    ignore: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    file_filtering_options: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        respect_git_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        respect_gemini_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const geminiRgSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    glob: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    exclude_pattern: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    names_only: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    max_matches_per_file: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    max_results: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiGrepSearchInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    dir_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    include: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    exclude_pattern: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    names_only: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    max_matches_per_file: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    total_max_matches: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+declare const geminiGlobInputSchema: z.ZodObject<{
+    pattern: z.ZodString;
+    dir_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    case_sensitive: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    respect_git_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    respect_gemini_ignore: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strip>;
+type CodexReadFileToolInput = z.output<typeof codexReadFileInputSchema>;
+type CodexListDirToolInput = z.output<typeof codexListDirInputSchema>;
+type CodexGrepFilesToolInput = z.output<typeof codexGrepFilesInputSchema>;
+type CodexApplyPatchToolInput = z.output<typeof applyPatchInputSchema>;
+type GeminiReadFileToolInput = z.output<typeof geminiReadFileInputSchema>;
+type GeminiReadFilesToolInput = z.output<typeof geminiReadFilesInputSchema>;
+type GeminiWriteFileToolInput = z.output<typeof geminiWriteFileInputSchema>;
+type GeminiReplaceToolInput = z.output<typeof geminiReplaceInputSchema>;
+type GeminiListDirectoryToolInput = z.output<typeof geminiListDirectoryInputSchema>;
+type GeminiGrepSearchToolInput = z.output<typeof geminiGrepSearchInputSchema>;
+type GeminiRgSearchToolInput = z.output<typeof geminiRgSearchInputSchema>;
+type GeminiGlobToolInput = z.output<typeof geminiGlobInputSchema>;
+declare function resolveFilesystemToolProfile(model: string, profile?: AgentFilesystemToolProfile): Exclude<AgentFilesystemToolProfile, "auto">;
+declare function createFilesystemToolSetForModel(model: string, profileOrOptions?: AgentFilesystemToolProfile | AgentFilesystemToolsOptions, maybeOptions?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createCodexFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createGeminiFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createModelAgnosticFilesystemToolSet(options?: AgentFilesystemToolsOptions): LlmToolSet;
+declare function createCodexApplyPatchTool(options?: AgentFilesystemToolsOptions): LlmCustomTool<string>;
+declare function createCodexReadFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexReadFileInputSchema, string>;
+declare function createListDirTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexListDirInputSchema, string>;
+declare function createGrepFilesTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof codexGrepFilesInputSchema, string>;
+declare function createGeminiReadFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReadFileInputSchema, string>;
+declare function createReadFilesTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReadFilesInputSchema, string>;
+declare function createWriteFileTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiWriteFileInputSchema, string>;
+declare function createReplaceTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiReplaceInputSchema, string>;
+declare function createListDirectoryTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiListDirectoryInputSchema, string>;
+declare function createGrepSearchTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiGrepSearchInputSchema, string>;
+declare function createRgSearchTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiRgSearchInputSchema, string>;
+declare function createGlobTool(options?: AgentFilesystemToolsOptions): LlmFunctionTool<typeof geminiGlobInputSchema, string>;
+
+type AgentFilesystemToolConfig = {
+    readonly enabled?: boolean;
+    readonly profile?: AgentFilesystemToolProfile;
+    readonly options?: AgentFilesystemToolsOptions;
+};
+type AgentFilesystemToolSelection = boolean | AgentFilesystemToolProfile | AgentFilesystemToolConfig;
+type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
+    readonly tools?: LlmToolSet;
+    readonly filesystemTool?: AgentFilesystemToolSelection;
+    readonly filesystem_tool?: AgentFilesystemToolSelection;
+};
+declare function runAgentLoop(request: RunAgentLoopRequest): Promise<LlmToolLoopResult>;
+
+declare const CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION = "Use the `apply_patch` tool to edit files. This is a FREEFORM tool, so do not wrap the patch in JSON.";
+declare const CODEX_APPLY_PATCH_LARK_GRAMMAR: string;
+declare const CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION: string;
+type ApplyPatchAccessContext = {
+    readonly cwd: string;
+    readonly kind: "add" | "delete" | "update" | "move";
+    readonly path: string;
+    readonly fromPath?: string;
+    readonly toPath?: string;
+};
+type ApplyPatchAccessHook = (context: ApplyPatchAccessContext) => Promise<void> | void;
+type ApplyPatchRequest = {
+    readonly patch: string;
+    readonly cwd?: string;
+    readonly fs?: AgentFilesystem;
+    readonly allowOutsideCwd?: boolean;
+    readonly checkAccess?: ApplyPatchAccessHook;
+    readonly maxPatchBytes?: number;
+};
+type ApplyPatchResult = {
+    readonly success: true;
+    readonly summary: string;
+    readonly added: readonly string[];
+    readonly modified: readonly string[];
+    readonly deleted: readonly string[];
+};
+type CreateApplyPatchToolOptions = Omit<ApplyPatchRequest, "patch"> & {
+    readonly description?: string;
+};
+declare const applyPatchToolInputSchema: z.ZodObject<{
+    input: z.ZodString;
+}, z.core.$strip>;
+type ApplyPatchToolInput = z.output<typeof applyPatchToolInputSchema>;
+declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmFunctionTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
+declare function applyPatch(request: ApplyPatchRequest): Promise<ApplyPatchResult>;
+
 type ChatGptAuthProfile = {
     readonly access: string;
     readonly refresh: string;
@@ -284,10 +530,13 @@ declare function exchangeChatGptOauthCode({ code, verifier, redirectUri, }: {
     verifier: string;
     redirectUri?: string;
 }): Promise<ChatGptAuthProfile>;
-declare function refreshChatGptOauthToken(refreshToken: string): Promise<ChatGptAuthProfile>;
+declare function refreshChatGptOauthToken(refreshToken: string, fallback?: {
+    accountId?: string;
+    idToken?: string;
+}): Promise<ChatGptAuthProfile>;
 declare function getChatGptAuthProfile(): Promise<ChatGptAuthProfile>;
 
-declare const GEMINI_MODEL_IDS: readonly ["gemini-3-pro-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
+declare const GEMINI_MODEL_IDS: readonly ["gemini-3-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
 type GeminiModelId = (typeof GEMINI_MODEL_IDS)[number];
 declare function isGeminiModelId(value: string): value is GeminiModelId;
 type GeminiConfiguration = {
@@ -296,4 +545,12 @@ type GeminiConfiguration = {
 };
 declare function configureGemini(options?: GeminiConfiguration): void;
 
-export { type ChatGptAuthProfile, type GeminiModelId, type JsonSchema, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmExecutableTool, type LlmImageData, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallContext, type LlmToolCallResult, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopStep, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, appendMarkdownSourcesSection, configureGemini, convertGooglePartsToLlmParts, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };
+declare const FIREWORKS_MODEL_IDS: readonly ["kimi-k2.5", "glm-5", "minimax-m2.1"];
+type FireworksModelId = (typeof FIREWORKS_MODEL_IDS)[number];
+declare const FIREWORKS_DEFAULT_KIMI_MODEL: FireworksModelId;
+declare const FIREWORKS_DEFAULT_GLM_MODEL: FireworksModelId;
+declare const FIREWORKS_DEFAULT_MINIMAX_MODEL: FireworksModelId;
+declare function isFireworksModelId(value: string): value is FireworksModelId;
+declare function resolveFireworksModelId(model: string): string | undefined;
+
+export { type AgentDirectoryEntry, type AgentFilesystem, type AgentFilesystemToolAccessContext, type AgentFilesystemToolAccessHook, type AgentFilesystemToolAction, type AgentFilesystemToolConfig, type AgentFilesystemToolName, type AgentFilesystemToolProfile, type AgentFilesystemToolSelection, type AgentFilesystemToolsOptions, type AgentPathInfo, type AgentPathKind, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallContext, type LlmToolCallResult, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopStep, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGeminiReadFileTool, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFilesTool, createReplaceTool, createRgSearchTool, createWriteFileTool, customTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isFireworksModelId, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };