npm - @ljoukov/llm - Versions diffs - 2.1.0 → 3.0.0 - Mend

@ljoukov/llm 2.1.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -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;
@@ -304,7 +324,7 @@ 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" | "write_file" | "replace" | "list_dir" | "list_directory" | "grep_files" | "grep_search" | "glob";
+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;
@@ -361,8 +381,16 @@ declare const applyPatchInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const geminiReadFileInputSchema: z.ZodObject<{
     file_path: z.ZodString;
-    offset: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
+    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;
@@ -373,57 +401,71 @@ declare const geminiReplaceInputSchema: z.ZodObject<{
     instruction: z.ZodString;
     old_string: z.ZodString;
     new_string: z.ZodString;
-    expected_replacements: z.ZodOptional<z.ZodNumber>;
+    expected_replacements: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const geminiListDirectoryInputSchema: z.ZodObject<{
     dir_path: z.ZodString;
-    ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    file_filtering_options: z.ZodOptional<z.ZodObject<{
-        respect_git_ignore: z.ZodOptional<z.ZodBoolean>;
-        respect_gemini_ignore: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    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.ZodString>;
-    include: z.ZodOptional<z.ZodString>;
-    exclude_pattern: z.ZodOptional<z.ZodString>;
-    names_only: z.ZodOptional<z.ZodBoolean>;
-    max_matches_per_file: z.ZodOptional<z.ZodNumber>;
-    total_max_matches: z.ZodOptional<z.ZodNumber>;
+    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.ZodString>;
-    case_sensitive: z.ZodOptional<z.ZodBoolean>;
-    respect_git_ignore: z.ZodOptional<z.ZodBoolean>;
-    respect_gemini_ignore: z.ZodOptional<z.ZodBoolean>;
+    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): LlmExecutableTool<typeof applyPatchInputSchema, string>;
-declare function createCodexReadFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexReadFileInputSchema, string>;
-declare function createListDirTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexListDirInputSchema, string>;
-declare function createGrepFilesTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexGrepFilesInputSchema, string>;
-declare function createReadFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiReadFileInputSchema, string>;
-declare function createWriteFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiWriteFileInputSchema, string>;
-declare function createReplaceTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiReplaceInputSchema, string>;
-declare function createListDirectoryTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiListDirectoryInputSchema, string>;
-declare function createGrepSearchTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiGrepSearchInputSchema, string>;
-declare function createGlobTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiGlobInputSchema, string>;
+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;
@@ -438,6 +480,9 @@ type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
 };
 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";
@@ -468,7 +513,7 @@ declare const applyPatchToolInputSchema: z.ZodObject<{
     input: z.ZodString;
 }, z.core.$strip>;
 type ApplyPatchToolInput = z.output<typeof applyPatchToolInputSchema>;
-declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmExecutableTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
+declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmFunctionTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
 declare function applyPatch(request: ApplyPatchRequest): Promise<ApplyPatchResult>;
 type ChatGptAuthProfile = {
@@ -485,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 = {
@@ -497,4 +545,12 @@ type GeminiConfiguration = {
 };
 declare function configureGemini(options?: GeminiConfiguration): void;
-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, type ChatGptAuthProfile, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReplaceToolInput, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, 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, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFileTool, createReplaceTool, createWriteFileTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, runAgentLoop, 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 CHANGED Viewed

@@ -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;
@@ -304,7 +324,7 @@ 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" | "write_file" | "replace" | "list_dir" | "list_directory" | "grep_files" | "grep_search" | "glob";
+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;
@@ -361,8 +381,16 @@ declare const applyPatchInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const geminiReadFileInputSchema: z.ZodObject<{
     file_path: z.ZodString;
-    offset: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
+    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;
@@ -373,57 +401,71 @@ declare const geminiReplaceInputSchema: z.ZodObject<{
     instruction: z.ZodString;
     old_string: z.ZodString;
     new_string: z.ZodString;
-    expected_replacements: z.ZodOptional<z.ZodNumber>;
+    expected_replacements: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const geminiListDirectoryInputSchema: z.ZodObject<{
     dir_path: z.ZodString;
-    ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    file_filtering_options: z.ZodOptional<z.ZodObject<{
-        respect_git_ignore: z.ZodOptional<z.ZodBoolean>;
-        respect_gemini_ignore: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    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.ZodString>;
-    include: z.ZodOptional<z.ZodString>;
-    exclude_pattern: z.ZodOptional<z.ZodString>;
-    names_only: z.ZodOptional<z.ZodBoolean>;
-    max_matches_per_file: z.ZodOptional<z.ZodNumber>;
-    total_max_matches: z.ZodOptional<z.ZodNumber>;
+    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.ZodString>;
-    case_sensitive: z.ZodOptional<z.ZodBoolean>;
-    respect_git_ignore: z.ZodOptional<z.ZodBoolean>;
-    respect_gemini_ignore: z.ZodOptional<z.ZodBoolean>;
+    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): LlmExecutableTool<typeof applyPatchInputSchema, string>;
-declare function createCodexReadFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexReadFileInputSchema, string>;
-declare function createListDirTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexListDirInputSchema, string>;
-declare function createGrepFilesTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof codexGrepFilesInputSchema, string>;
-declare function createReadFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiReadFileInputSchema, string>;
-declare function createWriteFileTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiWriteFileInputSchema, string>;
-declare function createReplaceTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiReplaceInputSchema, string>;
-declare function createListDirectoryTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiListDirectoryInputSchema, string>;
-declare function createGrepSearchTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiGrepSearchInputSchema, string>;
-declare function createGlobTool(options?: AgentFilesystemToolsOptions): LlmExecutableTool<typeof geminiGlobInputSchema, string>;
+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;
@@ -438,6 +480,9 @@ type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
 };
 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";
@@ -468,7 +513,7 @@ declare const applyPatchToolInputSchema: z.ZodObject<{
     input: z.ZodString;
 }, z.core.$strip>;
 type ApplyPatchToolInput = z.output<typeof applyPatchToolInputSchema>;
-declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmExecutableTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
+declare function createApplyPatchTool(options?: CreateApplyPatchToolOptions): LlmFunctionTool<typeof applyPatchToolInputSchema, ApplyPatchResult>;
 declare function applyPatch(request: ApplyPatchRequest): Promise<ApplyPatchResult>;
 type ChatGptAuthProfile = {
@@ -485,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 = {
@@ -497,4 +545,12 @@ type GeminiConfiguration = {
 };
 declare function configureGemini(options?: GeminiConfiguration): void;
-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, type ChatGptAuthProfile, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReplaceToolInput, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, 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, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFileTool, createReplaceTool, createWriteFileTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isGeminiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, runAgentLoop, 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 };