@ljoukov/llm 3.0.4 → 3.0.8

package/dist/index.d.cts

@@ -74,7 +74,33 @@ type LlmModelEvent = {
 type LlmBlockedEvent = {
     readonly type: "blocked";
 };
-type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent;
+type LlmToolCallStartedEvent = {
+    readonly type: "tool_call";
+    readonly phase: "started";
+    readonly turn: number;
+    readonly toolIndex: number;
+    readonly toolName: string;
+    readonly toolId: string;
+    readonly callKind: "function" | "custom";
+    readonly callId?: string;
+    readonly input: unknown;
+};
+type LlmToolCallCompletedEvent = {
+    readonly type: "tool_call";
+    readonly phase: "completed";
+    readonly turn: number;
+    readonly toolIndex: number;
+    readonly toolName: string;
+    readonly toolId: string;
+    readonly callKind: "function" | "custom";
+    readonly callId?: string;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly error?: string;
+    readonly durationMs?: number;
+};
+type LlmToolCallStreamEvent = LlmToolCallStartedEvent | LlmToolCallCompletedEvent;
+type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent | LlmToolCallStreamEvent;
 type LlmProvider = "openai" | "chatgpt" | "gemini" | "fireworks";
 declare const LLM_TEXT_MODEL_IDS: readonly ["gpt-5.3-codex", "gpt-5.3-codex-spark", "gpt-5.2", "gpt-5.1-codex-mini", "chatgpt-gpt-5.3-codex", "chatgpt-gpt-5.3-codex-spark", "chatgpt-gpt-5.2", "chatgpt-gpt-5.1-codex-mini", "kimi-k2.5", "glm-5", "minimax-m2.1", "gpt-oss-120b", "gemini-3-pro-preview", "gemini-3.1-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
 type LlmTextModelId = (typeof LLM_TEXT_MODEL_IDS)[number];
@@ -240,6 +266,23 @@ type LlmToolCallResult = {
     readonly output: unknown;
     readonly error?: string;
     readonly callId?: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly durationMs?: number;
+    readonly metrics?: Record<string, unknown>;
+};
+type LlmToolLoopStepTiming = {
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly totalMs: number;
+    readonly queueWaitMs: number;
+    readonly connectionSetupMs: number;
+    readonly activeGenerationMs: number;
+    readonly toolExecutionMs: number;
+    readonly waitToolMs: number;
+    readonly schedulerDelayMs: number;
+    readonly providerRetryDelayMs: number;
+    readonly providerAttempts: number;
 };
 type LlmToolLoopStep = {
     readonly step: number;
@@ -249,6 +292,7 @@ type LlmToolLoopStep = {
     readonly toolCalls: readonly LlmToolCallResult[];
     readonly usage?: LlmUsageTokens;
     readonly costUsd: number;
+    readonly timing?: LlmToolLoopStepTiming;
 };
 type LlmToolLoopResult = {
     readonly text: string;
@@ -256,15 +300,39 @@ type LlmToolLoopResult = {
     readonly steps: readonly LlmToolLoopStep[];
     readonly totalCostUsd: number;
 };
+type LlmToolLoopSteeringMessage = {
+    readonly role?: "user";
+    readonly content: string | readonly LlmContentPart[];
+};
+type LlmToolLoopSteeringInput = string | LlmToolLoopSteeringMessage | readonly LlmToolLoopSteeringMessage[];
+type LlmToolLoopSteeringAppendResult = {
+    readonly accepted: boolean;
+    readonly queuedCount: number;
+};
+type LlmToolLoopSteeringChannel = {
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingCount: () => number;
+    readonly close: () => void;
+};
 type LlmToolLoopRequest = LlmInput & {
     readonly model: LlmTextModelId;
     readonly tools: LlmToolSet;
     readonly modelTools?: readonly LlmToolConfig[];
     readonly maxSteps?: number;
     readonly openAiReasoningEffort?: OpenAiReasoningEffort;
+    readonly steering?: LlmToolLoopSteeringChannel;
     readonly onEvent?: (event: LlmStreamEvent) => void;
     readonly signal?: AbortSignal;
 };
+type LlmToolLoopStream = {
+    readonly events: AsyncIterable<LlmStreamEvent>;
+    readonly result: Promise<LlmToolLoopResult>;
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingSteeringCount: () => number;
+    readonly abort: () => void;
+};
 declare function toGeminiJsonSchema(schema: z.ZodType, options?: {
     name?: string;
 }): JsonSchema;
@@ -279,7 +347,9 @@ declare function generateJson<T>(request: LlmJsonRequest<T>): Promise<{
     readonly rawText: string;
     readonly result: LlmTextResult;
 }>;
+declare function createToolLoopSteeringChannel(): LlmToolLoopSteeringChannel;
 declare function runToolLoop(request: LlmToolLoopRequest): Promise<LlmToolLoopResult>;
+declare function streamToolLoop(request: LlmToolLoopRequest): LlmToolLoopStream;
 declare function generateImages(request: LlmGenerateImagesRequest): Promise<LlmImageData[]>;
 declare function generateImageInBatches(request: LlmGenerateImagesRequest & {
     batchSize: number;
@@ -302,11 +372,22 @@ declare function loadEnvFromFile(filePath: string, { override }?: {
     override?: boolean;
 }): void;
 
+type ModelConcurrencyProvider = "openai" | "google" | "fireworks";
+type ModelConcurrencyConfig = {
+    readonly globalCap?: number;
+    readonly providerCaps?: Partial<Record<ModelConcurrencyProvider, number>>;
+    readonly modelCaps?: Record<string, number>;
+    readonly providerModelCaps?: Partial<Record<ModelConcurrencyProvider, Record<string, number>>>;
+};
+declare function configureModelConcurrency(config?: ModelConcurrencyConfig): void;
+declare function resetModelConcurrencyConfig(): void;
+
 type AgentSubagentToolPromptPattern = "codex" | "none";
 type AgentSubagentToolConfig = {
     readonly enabled?: boolean;
     readonly maxAgents?: number;
     readonly maxDepth?: number;
+    readonly minWaitTimeoutMs?: number;
     readonly defaultWaitTimeoutMs?: number;
     readonly maxWaitTimeoutMs?: number;
     readonly promptPattern?: AgentSubagentToolPromptPattern;
@@ -378,31 +459,31 @@ type AgentFilesystemToolsOptions = {
 };
 declare const codexReadFileInputSchema: z.ZodObject<{
     file_path: z.ZodString;
-    offset: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    mode: z.ZodOptional<z.ZodEnum<{
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    mode: z.ZodOptional<z.ZodNullable<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>>;
+    }>>>;
+    indentation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        anchor_line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        max_levels: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        include_siblings: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        include_header: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        max_lines: z.ZodOptional<z.ZodNullable<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>;
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    depth: z.ZodOptional<z.ZodNullable<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>;
+    include: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const applyPatchInputSchema: z.ZodObject<{
     input: z.ZodString;
@@ -509,8 +590,57 @@ type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
     readonly subagentTool?: AgentSubagentToolSelection;
     readonly subagent_tool?: AgentSubagentToolSelection;
     readonly subagents?: AgentSubagentToolSelection;
+    readonly telemetry?: AgentTelemetrySelection;
+};
+type AgentLoopStream = {
+    readonly events: AsyncIterable<LlmStreamEvent>;
+    readonly result: Promise<LlmToolLoopResult>;
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingSteeringCount: () => number;
+    readonly abort: () => void;
 };
 declare function runAgentLoop(request: RunAgentLoopRequest): Promise<LlmToolLoopResult>;
+declare function streamAgentLoop(request: RunAgentLoopRequest): AgentLoopStream;
+type AgentTelemetryBaseEvent = {
+    readonly timestamp: string;
+    readonly runId: string;
+    readonly parentRunId?: string;
+    readonly depth: number;
+    readonly model: LlmToolLoopRequest["model"];
+};
+type AgentRunStartedTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.started";
+    readonly inputMode: "string" | "messages";
+    readonly customToolCount: number;
+    readonly mergedToolCount: number;
+    readonly filesystemToolsEnabled: boolean;
+    readonly subagentToolsEnabled: boolean;
+};
+type AgentRunStreamTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.stream";
+    readonly event: LlmStreamEvent;
+};
+type AgentRunCompletedTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.completed";
+    readonly success: boolean;
+    readonly durationMs: number;
+    readonly stepCount?: number;
+    readonly toolCallCount?: number;
+    readonly totalCostUsd?: number;
+    readonly usage?: LlmUsageTokens;
+    readonly error?: string;
+};
+type AgentTelemetryEvent = AgentRunStartedTelemetryEvent | AgentRunStreamTelemetryEvent | AgentRunCompletedTelemetryEvent;
+type AgentTelemetrySink = {
+    readonly emit: (event: AgentTelemetryEvent) => void | Promise<void>;
+    readonly flush?: () => void | Promise<void>;
+};
+type AgentTelemetryConfig = {
+    readonly sink: AgentTelemetrySink;
+    readonly includeLlmStreamEvents?: boolean;
+};
+type AgentTelemetrySelection = AgentTelemetrySink | AgentTelemetryConfig;
 
 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;
@@ -599,4 +729,4 @@ declare const FIREWORKS_DEFAULT_GPT_OSS_120B_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 AgentSubagentToolConfig, type AgentSubagentToolPromptPattern, type AgentSubagentToolSelection, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CHATGPT_MODEL_IDS, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type ChatGptModelId, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_GPT_OSS_120B_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, GEMINI_IMAGE_MODEL_IDS, GEMINI_MODEL_IDS, GEMINI_TEXT_MODEL_IDS, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiImageModelId, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiTextModelId, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, LLM_IMAGE_MODEL_IDS, LLM_MODEL_IDS, LLM_TEXT_MODEL_IDS, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageModelId, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmModelId, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextModelId, 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, OPENAI_MODEL_IDS, type OpenAiModelId, 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, isChatGptModelId, isFireworksModelId, isGeminiImageModelId, isGeminiModelId, isGeminiTextModelId, isLlmImageModelId, isLlmModelId, isLlmTextModelId, isOpenAiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };
+export { type AgentDirectoryEntry, type AgentFilesystem, type AgentFilesystemToolAccessContext, type AgentFilesystemToolAccessHook, type AgentFilesystemToolAction, type AgentFilesystemToolConfig, type AgentFilesystemToolName, type AgentFilesystemToolProfile, type AgentFilesystemToolSelection, type AgentFilesystemToolsOptions, type AgentLoopStream, type AgentPathInfo, type AgentPathKind, type AgentRunCompletedTelemetryEvent, type AgentRunStartedTelemetryEvent, type AgentRunStreamTelemetryEvent, type AgentSubagentToolConfig, type AgentSubagentToolPromptPattern, type AgentSubagentToolSelection, type AgentTelemetryConfig, type AgentTelemetryEvent, type AgentTelemetrySelection, type AgentTelemetrySink, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CHATGPT_MODEL_IDS, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type ChatGptModelId, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_GPT_OSS_120B_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, GEMINI_IMAGE_MODEL_IDS, GEMINI_MODEL_IDS, GEMINI_TEXT_MODEL_IDS, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiImageModelId, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiTextModelId, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, LLM_IMAGE_MODEL_IDS, LLM_MODEL_IDS, LLM_TEXT_MODEL_IDS, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageModelId, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmModelId, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextModelId, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallCompletedEvent, type LlmToolCallContext, type LlmToolCallResult, type LlmToolCallStartedEvent, type LlmToolCallStreamEvent, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopSteeringAppendResult, type LlmToolLoopSteeringChannel, type LlmToolLoopSteeringInput, type LlmToolLoopSteeringMessage, type LlmToolLoopStep, type LlmToolLoopStream, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, type ModelConcurrencyConfig, type ModelConcurrencyProvider, OPENAI_MODEL_IDS, type OpenAiModelId, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, configureModelConcurrency, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGeminiReadFileTool, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFilesTool, createReplaceTool, createRgSearchTool, createToolLoopSteeringChannel, createWriteFileTool, customTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isChatGptModelId, isFireworksModelId, isGeminiImageModelId, isGeminiModelId, isGeminiTextModelId, isLlmImageModelId, isLlmModelId, isLlmTextModelId, isOpenAiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resetModelConcurrencyConfig, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamAgentLoop, streamJson, streamText, streamToolLoop, stripCodexCitationMarkers, toGeminiJsonSchema, tool };

package/dist/index.d.ts

@@ -74,7 +74,33 @@ type LlmModelEvent = {
 type LlmBlockedEvent = {
     readonly type: "blocked";
 };
-type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent;
+type LlmToolCallStartedEvent = {
+    readonly type: "tool_call";
+    readonly phase: "started";
+    readonly turn: number;
+    readonly toolIndex: number;
+    readonly toolName: string;
+    readonly toolId: string;
+    readonly callKind: "function" | "custom";
+    readonly callId?: string;
+    readonly input: unknown;
+};
+type LlmToolCallCompletedEvent = {
+    readonly type: "tool_call";
+    readonly phase: "completed";
+    readonly turn: number;
+    readonly toolIndex: number;
+    readonly toolName: string;
+    readonly toolId: string;
+    readonly callKind: "function" | "custom";
+    readonly callId?: string;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly error?: string;
+    readonly durationMs?: number;
+};
+type LlmToolCallStreamEvent = LlmToolCallStartedEvent | LlmToolCallCompletedEvent;
+type LlmStreamEvent = LlmTextDeltaEvent | LlmUsageEvent | LlmModelEvent | LlmBlockedEvent | LlmToolCallStreamEvent;
 type LlmProvider = "openai" | "chatgpt" | "gemini" | "fireworks";
 declare const LLM_TEXT_MODEL_IDS: readonly ["gpt-5.3-codex", "gpt-5.3-codex-spark", "gpt-5.2", "gpt-5.1-codex-mini", "chatgpt-gpt-5.3-codex", "chatgpt-gpt-5.3-codex-spark", "chatgpt-gpt-5.2", "chatgpt-gpt-5.1-codex-mini", "kimi-k2.5", "glm-5", "minimax-m2.1", "gpt-oss-120b", "gemini-3-pro-preview", "gemini-3.1-pro-preview", "gemini-3-flash-preview", "gemini-2.5-pro", "gemini-flash-latest", "gemini-flash-lite-latest"];
 type LlmTextModelId = (typeof LLM_TEXT_MODEL_IDS)[number];
@@ -240,6 +266,23 @@ type LlmToolCallResult = {
     readonly output: unknown;
     readonly error?: string;
     readonly callId?: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly durationMs?: number;
+    readonly metrics?: Record<string, unknown>;
+};
+type LlmToolLoopStepTiming = {
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly totalMs: number;
+    readonly queueWaitMs: number;
+    readonly connectionSetupMs: number;
+    readonly activeGenerationMs: number;
+    readonly toolExecutionMs: number;
+    readonly waitToolMs: number;
+    readonly schedulerDelayMs: number;
+    readonly providerRetryDelayMs: number;
+    readonly providerAttempts: number;
 };
 type LlmToolLoopStep = {
     readonly step: number;
@@ -249,6 +292,7 @@ type LlmToolLoopStep = {
     readonly toolCalls: readonly LlmToolCallResult[];
     readonly usage?: LlmUsageTokens;
     readonly costUsd: number;
+    readonly timing?: LlmToolLoopStepTiming;
 };
 type LlmToolLoopResult = {
     readonly text: string;
@@ -256,15 +300,39 @@ type LlmToolLoopResult = {
     readonly steps: readonly LlmToolLoopStep[];
     readonly totalCostUsd: number;
 };
+type LlmToolLoopSteeringMessage = {
+    readonly role?: "user";
+    readonly content: string | readonly LlmContentPart[];
+};
+type LlmToolLoopSteeringInput = string | LlmToolLoopSteeringMessage | readonly LlmToolLoopSteeringMessage[];
+type LlmToolLoopSteeringAppendResult = {
+    readonly accepted: boolean;
+    readonly queuedCount: number;
+};
+type LlmToolLoopSteeringChannel = {
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingCount: () => number;
+    readonly close: () => void;
+};
 type LlmToolLoopRequest = LlmInput & {
     readonly model: LlmTextModelId;
     readonly tools: LlmToolSet;
     readonly modelTools?: readonly LlmToolConfig[];
     readonly maxSteps?: number;
     readonly openAiReasoningEffort?: OpenAiReasoningEffort;
+    readonly steering?: LlmToolLoopSteeringChannel;
     readonly onEvent?: (event: LlmStreamEvent) => void;
     readonly signal?: AbortSignal;
 };
+type LlmToolLoopStream = {
+    readonly events: AsyncIterable<LlmStreamEvent>;
+    readonly result: Promise<LlmToolLoopResult>;
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingSteeringCount: () => number;
+    readonly abort: () => void;
+};
 declare function toGeminiJsonSchema(schema: z.ZodType, options?: {
     name?: string;
 }): JsonSchema;
@@ -279,7 +347,9 @@ declare function generateJson<T>(request: LlmJsonRequest<T>): Promise<{
     readonly rawText: string;
     readonly result: LlmTextResult;
 }>;
+declare function createToolLoopSteeringChannel(): LlmToolLoopSteeringChannel;
 declare function runToolLoop(request: LlmToolLoopRequest): Promise<LlmToolLoopResult>;
+declare function streamToolLoop(request: LlmToolLoopRequest): LlmToolLoopStream;
 declare function generateImages(request: LlmGenerateImagesRequest): Promise<LlmImageData[]>;
 declare function generateImageInBatches(request: LlmGenerateImagesRequest & {
     batchSize: number;
@@ -302,11 +372,22 @@ declare function loadEnvFromFile(filePath: string, { override }?: {
     override?: boolean;
 }): void;
 
+type ModelConcurrencyProvider = "openai" | "google" | "fireworks";
+type ModelConcurrencyConfig = {
+    readonly globalCap?: number;
+    readonly providerCaps?: Partial<Record<ModelConcurrencyProvider, number>>;
+    readonly modelCaps?: Record<string, number>;
+    readonly providerModelCaps?: Partial<Record<ModelConcurrencyProvider, Record<string, number>>>;
+};
+declare function configureModelConcurrency(config?: ModelConcurrencyConfig): void;
+declare function resetModelConcurrencyConfig(): void;
+
 type AgentSubagentToolPromptPattern = "codex" | "none";
 type AgentSubagentToolConfig = {
     readonly enabled?: boolean;
     readonly maxAgents?: number;
     readonly maxDepth?: number;
+    readonly minWaitTimeoutMs?: number;
     readonly defaultWaitTimeoutMs?: number;
     readonly maxWaitTimeoutMs?: number;
     readonly promptPattern?: AgentSubagentToolPromptPattern;
@@ -378,31 +459,31 @@ type AgentFilesystemToolsOptions = {
 };
 declare const codexReadFileInputSchema: z.ZodObject<{
     file_path: z.ZodString;
-    offset: z.ZodOptional<z.ZodNumber>;
-    limit: z.ZodOptional<z.ZodNumber>;
-    mode: z.ZodOptional<z.ZodEnum<{
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    mode: z.ZodOptional<z.ZodNullable<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>>;
+    }>>>;
+    indentation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        anchor_line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        max_levels: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        include_siblings: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        include_header: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        max_lines: z.ZodOptional<z.ZodNullable<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>;
+    offset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    depth: z.ZodOptional<z.ZodNullable<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>;
+    include: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const applyPatchInputSchema: z.ZodObject<{
     input: z.ZodString;
@@ -509,8 +590,57 @@ type RunAgentLoopRequest = Omit<LlmToolLoopRequest, "tools"> & {
     readonly subagentTool?: AgentSubagentToolSelection;
     readonly subagent_tool?: AgentSubagentToolSelection;
     readonly subagents?: AgentSubagentToolSelection;
+    readonly telemetry?: AgentTelemetrySelection;
+};
+type AgentLoopStream = {
+    readonly events: AsyncIterable<LlmStreamEvent>;
+    readonly result: Promise<LlmToolLoopResult>;
+    readonly append: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly steer: (input: LlmToolLoopSteeringInput) => LlmToolLoopSteeringAppendResult;
+    readonly pendingSteeringCount: () => number;
+    readonly abort: () => void;
 };
 declare function runAgentLoop(request: RunAgentLoopRequest): Promise<LlmToolLoopResult>;
+declare function streamAgentLoop(request: RunAgentLoopRequest): AgentLoopStream;
+type AgentTelemetryBaseEvent = {
+    readonly timestamp: string;
+    readonly runId: string;
+    readonly parentRunId?: string;
+    readonly depth: number;
+    readonly model: LlmToolLoopRequest["model"];
+};
+type AgentRunStartedTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.started";
+    readonly inputMode: "string" | "messages";
+    readonly customToolCount: number;
+    readonly mergedToolCount: number;
+    readonly filesystemToolsEnabled: boolean;
+    readonly subagentToolsEnabled: boolean;
+};
+type AgentRunStreamTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.stream";
+    readonly event: LlmStreamEvent;
+};
+type AgentRunCompletedTelemetryEvent = AgentTelemetryBaseEvent & {
+    readonly type: "agent.run.completed";
+    readonly success: boolean;
+    readonly durationMs: number;
+    readonly stepCount?: number;
+    readonly toolCallCount?: number;
+    readonly totalCostUsd?: number;
+    readonly usage?: LlmUsageTokens;
+    readonly error?: string;
+};
+type AgentTelemetryEvent = AgentRunStartedTelemetryEvent | AgentRunStreamTelemetryEvent | AgentRunCompletedTelemetryEvent;
+type AgentTelemetrySink = {
+    readonly emit: (event: AgentTelemetryEvent) => void | Promise<void>;
+    readonly flush?: () => void | Promise<void>;
+};
+type AgentTelemetryConfig = {
+    readonly sink: AgentTelemetrySink;
+    readonly includeLlmStreamEvents?: boolean;
+};
+type AgentTelemetrySelection = AgentTelemetrySink | AgentTelemetryConfig;
 
 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;
@@ -599,4 +729,4 @@ declare const FIREWORKS_DEFAULT_GPT_OSS_120B_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 AgentSubagentToolConfig, type AgentSubagentToolPromptPattern, type AgentSubagentToolSelection, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CHATGPT_MODEL_IDS, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type ChatGptModelId, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_GPT_OSS_120B_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, GEMINI_IMAGE_MODEL_IDS, GEMINI_MODEL_IDS, GEMINI_TEXT_MODEL_IDS, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiImageModelId, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiTextModelId, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, LLM_IMAGE_MODEL_IDS, LLM_MODEL_IDS, LLM_TEXT_MODEL_IDS, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageModelId, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmModelId, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextModelId, 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, OPENAI_MODEL_IDS, type OpenAiModelId, 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, isChatGptModelId, isFireworksModelId, isGeminiImageModelId, isGeminiModelId, isGeminiTextModelId, isLlmImageModelId, isLlmModelId, isLlmTextModelId, isOpenAiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamJson, streamText, stripCodexCitationMarkers, toGeminiJsonSchema, tool };
+export { type AgentDirectoryEntry, type AgentFilesystem, type AgentFilesystemToolAccessContext, type AgentFilesystemToolAccessHook, type AgentFilesystemToolAction, type AgentFilesystemToolConfig, type AgentFilesystemToolName, type AgentFilesystemToolProfile, type AgentFilesystemToolSelection, type AgentFilesystemToolsOptions, type AgentLoopStream, type AgentPathInfo, type AgentPathKind, type AgentRunCompletedTelemetryEvent, type AgentRunStartedTelemetryEvent, type AgentRunStreamTelemetryEvent, type AgentSubagentToolConfig, type AgentSubagentToolPromptPattern, type AgentSubagentToolSelection, type AgentTelemetryConfig, type AgentTelemetryEvent, type AgentTelemetrySelection, type AgentTelemetrySink, type ApplyPatchAccessContext, type ApplyPatchAccessHook, type ApplyPatchRequest, type ApplyPatchResult, type ApplyPatchToolInput, CHATGPT_MODEL_IDS, CODEX_APPLY_PATCH_FREEFORM_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_JSON_TOOL_DESCRIPTION, CODEX_APPLY_PATCH_LARK_GRAMMAR, type ChatGptAuthProfile, type ChatGptModelId, type CodexApplyPatchToolInput, type CodexGrepFilesToolInput, type CodexListDirToolInput, type CodexReadFileToolInput, type CreateApplyPatchToolOptions, FIREWORKS_DEFAULT_GLM_MODEL, FIREWORKS_DEFAULT_GPT_OSS_120B_MODEL, FIREWORKS_DEFAULT_KIMI_MODEL, FIREWORKS_DEFAULT_MINIMAX_MODEL, FIREWORKS_MODEL_IDS, type FireworksModelId, GEMINI_IMAGE_MODEL_IDS, GEMINI_MODEL_IDS, GEMINI_TEXT_MODEL_IDS, type GeminiGlobToolInput, type GeminiGrepSearchToolInput, type GeminiImageModelId, type GeminiListDirectoryToolInput, type GeminiModelId, type GeminiReadFileToolInput, type GeminiReadFilesToolInput, type GeminiReplaceToolInput, type GeminiRgSearchToolInput, type GeminiTextModelId, type GeminiWriteFileToolInput, InMemoryAgentFilesystem, type JsonSchema, LLM_IMAGE_MODEL_IDS, LLM_MODEL_IDS, LLM_TEXT_MODEL_IDS, type LlmBaseRequest, type LlmBlockedEvent, type LlmContent, type LlmContentPart, type LlmCustomTool, type LlmCustomToolInputFormat, type LlmExecutableTool, type LlmFunctionTool, type LlmImageData, type LlmImageModelId, type LlmImageSize, type LlmInput, type LlmInputMessage, LlmJsonCallError, type LlmJsonRequest, type LlmJsonStream, type LlmJsonStreamEvent, type LlmJsonStreamRequest, type LlmModelEvent, type LlmModelId, type LlmProvider, type LlmStreamEvent, type LlmTextDeltaEvent, type LlmTextModelId, type LlmTextRequest, type LlmTextResult, type LlmTextStream, type LlmToolCallCompletedEvent, type LlmToolCallContext, type LlmToolCallResult, type LlmToolCallStartedEvent, type LlmToolCallStreamEvent, type LlmToolConfig, type LlmToolLoopRequest, type LlmToolLoopResult, type LlmToolLoopSteeringAppendResult, type LlmToolLoopSteeringChannel, type LlmToolLoopSteeringInput, type LlmToolLoopSteeringMessage, type LlmToolLoopStep, type LlmToolLoopStream, type LlmToolSet, type LlmUsageEvent, type LlmUsageTokens, type LlmWebSearchMode, type ModelConcurrencyConfig, type ModelConcurrencyProvider, OPENAI_MODEL_IDS, type OpenAiModelId, type RunAgentLoopRequest, appendMarkdownSourcesSection, applyPatch, configureGemini, configureModelConcurrency, convertGooglePartsToLlmParts, createApplyPatchTool, createCodexApplyPatchTool, createCodexFilesystemToolSet, createCodexReadFileTool, createFilesystemToolSetForModel, createGeminiFilesystemToolSet, createGeminiReadFileTool, createGlobTool, createGrepFilesTool, createGrepSearchTool, createInMemoryAgentFilesystem, createListDirTool, createListDirectoryTool, createModelAgnosticFilesystemToolSet, createNodeAgentFilesystem, createReadFilesTool, createReplaceTool, createRgSearchTool, createToolLoopSteeringChannel, createWriteFileTool, customTool, encodeChatGptAuthJson, encodeChatGptAuthJsonB64, estimateCallCostUsd, exchangeChatGptOauthCode, generateImageInBatches, generateImages, generateJson, generateText, getChatGptAuthProfile, getCurrentToolCallContext, isChatGptModelId, isFireworksModelId, isGeminiImageModelId, isGeminiModelId, isGeminiTextModelId, isLlmImageModelId, isLlmModelId, isLlmTextModelId, isOpenAiModelId, loadEnvFromFile, loadLocalEnv, parseJsonFromLlmText, refreshChatGptOauthToken, resetModelConcurrencyConfig, resolveFilesystemToolProfile, resolveFireworksModelId, runAgentLoop, runToolLoop, sanitisePartForLogging, streamAgentLoop, streamJson, streamText, streamToolLoop, stripCodexCitationMarkers, toGeminiJsonSchema, tool };