@fifthrevision/axle 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -9,7 +9,7 @@ interface Stats {
 //#endregion
 //#region src/messages/stream.d.ts
 interface StreamChunk {
-  type: "start" | "text-start" | "text-delta" | "text-complete" | "tool-call-start" | "tool-call-complete" | "thinking-start" | "thinking-delta" | "thinking-summary-delta" | "thinking-complete" | "internal-tool-start" | "internal-tool-complete" | "complete" | "error";
+  type: "start" | "text-start" | "text-delta" | "text-complete" | "tool-call-start" | "tool-call-args-delta" | "tool-call-complete" | "thinking-start" | "thinking-delta" | "thinking-summary-delta" | "thinking-complete" | "provider-tool-start" | "provider-tool-complete" | "complete" | "error";
   id?: string;
   data?: any;
 }
@@ -93,6 +93,16 @@ interface StreamToolCallStartChunk extends StreamChunk {
     name: string;
   };
 }
+interface StreamToolCallArgsDeltaChunk extends StreamChunk {
+  type: "tool-call-args-delta";
+  data: {
+    index: number;
+    id: string;
+    name: string;
+    delta: string;
+    accumulated: string;
+  };
+}
 interface StreamToolCallCompleteChunk extends StreamChunk {
   type: "tool-call-complete";
   data: {
@@ -103,16 +113,16 @@ interface StreamToolCallCompleteChunk extends StreamChunk {
     providerMetadata?: Record<string, unknown>;
   };
 }
-interface StreamInternalToolStartChunk extends StreamChunk {
-  type: "internal-tool-start";
+interface StreamProviderToolStartChunk extends StreamChunk {
+  type: "provider-tool-start";
   data: {
     index: number;
     id: string;
     name: string;
   };
 }
-interface StreamInternalToolCompleteChunk extends StreamChunk {
-  type: "internal-tool-complete";
+interface StreamProviderToolCompleteChunk extends StreamChunk {
+  type: "provider-tool-complete";
   data: {
     index: number;
     id: string;
@@ -120,7 +130,7 @@ interface StreamInternalToolCompleteChunk extends StreamChunk {
     output?: unknown;
   };
 }
-type AnyStreamChunk = StreamStartChunk | StreamCompleteChunk | StreamErrorChunk | StreamTextStartChunk | StreamTextDeltaChunk | StreamTextCompleteChunk | StreamThinkingStartChunk | StreamThinkingDeltaChunk | StreamThinkingSummaryDeltaChunk | StreamThinkingCompleteChunk | StreamToolCallStartChunk | StreamToolCallCompleteChunk | StreamInternalToolStartChunk | StreamInternalToolCompleteChunk;
+type AnyStreamChunk = StreamStartChunk | StreamCompleteChunk | StreamErrorChunk | StreamTextStartChunk | StreamTextDeltaChunk | StreamTextCompleteChunk | StreamThinkingStartChunk | StreamThinkingDeltaChunk | StreamThinkingSummaryDeltaChunk | StreamThinkingCompleteChunk | StreamToolCallStartChunk | StreamToolCallArgsDeltaChunk | StreamToolCallCompleteChunk | StreamProviderToolStartChunk | StreamProviderToolCompleteChunk;
 //#endregion
 //#region src/tracer/types.d.ts
 type SpanStatus = "ok" | "error";
@@ -199,46 +209,142 @@ interface TracingContext {
   setResult(result: SpanResult): void;
 }
 //#endregion
+//#region src/utils/file.d.ts
+type FileKind = "image" | "document" | "text";
+type TextSource = {
+  type: "text";
+  content: string;
+} | {
+  type: "url";
+  url: string;
+} | {
+  type: "ref";
+  ref: unknown;
+};
+type BinarySource = {
+  type: "base64";
+  data: string;
+} | {
+  type: "url";
+  url: string;
+} | {
+  type: "ref";
+  ref: unknown;
+};
+interface BaseFile {
+  mimeType: string;
+  name: string;
+  size?: number;
+}
+type TextFileInfo = BaseFile & {
+  kind: "text";
+  source: TextSource;
+};
+type BinaryFileInfo = BaseFile & {
+  kind: "image" | "document";
+  source: BinarySource;
+};
+type FileInfo = TextFileInfo | BinaryFileInfo;
+type InlineTextFile = TextFileInfo & {
+  source: {
+    type: "text";
+    content: string;
+  };
+};
+type InlineBinaryFile = BinaryFileInfo & {
+  source: {
+    type: "base64";
+    data: string;
+  };
+};
+type DeferredFileInfo = FileInfo & {
+  source: {
+    type: "ref";
+    ref: unknown;
+  };
+};
+type ConcreteFileInfo = FileInfo & {
+  source: {
+    type: "text";
+  } | {
+    type: "base64";
+  } | {
+    type: "url";
+  };
+};
+type FileProviderId = "anthropic" | "openai" | "gemini" | "chatcompletions";
+type FileResolveFormat = "base64" | "url" | "text" | "gemini-file-uri";
+type ResolvedFileSource = {
+  type: "base64";
+  data: string;
+  mimeType?: string;
+  name?: string;
+} | {
+  type: "url";
+  url: string;
+  mimeType?: string;
+  name?: string;
+} | {
+  type: "text";
+  content: string;
+  mimeType?: string;
+  name?: string;
+} | {
+  type: "gemini-file-uri";
+  uri: string;
+  mimeType?: string;
+  name?: string;
+};
+interface FileResolveRequest {
+  file: DeferredFileInfo;
+  ref: unknown;
+  provider: FileProviderId;
+  model: string;
+  accepted: FileResolveFormat[];
+  signal?: AbortSignal;
+}
+type FileResolver = (request: FileResolveRequest) => Promise<ResolvedFileSource>;
+/**
+ * Load a file with the specified encoding or auto-detect based on file extension
+ * @param filePath - Path to the file
+ * @param encoding - How to load the file: "utf-8" for text, "base64" for binary, or omit for auto-detection
+ * @returns FileInfo object with appropriate content based on encoding
+ */
+declare function loadFileContent(filePath: string): Promise<FileInfo>;
+declare function loadFileContent(filePath: string, encoding: "utf-8"): Promise<InlineTextFile>;
+declare function loadFileContent(filePath: string, encoding: "base64"): Promise<InlineBinaryFile>;
+//#endregion
 //#region src/providers/types.d.ts
+interface ProviderRequestContext {
+  tracer?: TracingContext;
+  fileResolver?: FileResolver;
+}
+interface GenerateTurnOptions {
+  temperature?: number;
+  top_p?: number;
+  max_tokens?: number;
+  frequency_penalty?: number;
+  presence_penalty?: number;
+  stop?: string | string[];
+  [key: string]: any;
+}
+interface GenerationRequestParams {
+  messages: Array<AxleMessage>;
+  system?: string;
+  tools?: Array<ToolDefinition>;
+  context: ProviderRequestContext;
+  options?: GenerateTurnOptions;
+  reasoning?: boolean;
+}
+interface StreamingRequestParams extends GenerationRequestParams {
+  signal?: AbortSignal;
+}
 interface AIProvider {
   get name(): string;
   /** @internal */
-  createGenerationRequest(model: string, params: {
-    messages: Array<AxleMessage>;
-    system?: string;
-    tools?: Array<ToolDefinition>;
-    context: {
-      tracer?: TracingContext;
-    };
-    options?: {
-      temperature?: number;
-      top_p?: number;
-      max_tokens?: number;
-      frequency_penalty?: number;
-      presence_penalty?: number;
-      stop?: string | string[];
-      [key: string]: any;
-    };
-  }): Promise<ModelResult>;
+  createGenerationRequest(model: string, params: GenerationRequestParams): Promise<ModelResult>;
   /** @internal */
-  createStreamingRequest?(model: string, params: {
-    messages: Array<AxleMessage>;
-    system?: string;
-    tools?: Array<ToolDefinition>;
-    context: {
-      tracer?: TracingContext;
-    };
-    signal?: AbortSignal;
-    options?: {
-      temperature?: number;
-      top_p?: number;
-      max_tokens?: number;
-      frequency_penalty?: number;
-      presence_penalty?: number;
-      stop?: string | string[];
-      [key: string]: any;
-    };
-  }): AsyncGenerator<AnyStreamChunk, void, unknown>;
+  createStreamingRequest(model: string, params: StreamingRequestParams): AsyncGenerator<AnyStreamChunk, void, unknown>;
 }
 interface ModelResponse {
   type: "success";
@@ -270,38 +376,15 @@ declare enum AxleStopReason {
   Cancelled = "cancelled"
 }
 //#endregion
-//#region src/utils/file.d.ts
-interface FileInfo {
-  path: string;
-  base64?: string;
-  content?: string;
-  mimeType: string;
-  size: number;
-  name: string;
-  type: "image" | "document" | "text";
-}
-type TextFileInfo = FileInfo & {
-  content: string;
-  base64?: never;
-  type: "text";
-};
-type Base64FileInfo = FileInfo & {
-  base64: string;
-  content?: never;
-  type: "image" | "document";
-};
-/**
- * Load a file with the specified encoding or auto-detect based on file extension
- * @param filePath - Path to the file
- * @param encoding - How to load the file: "utf-8" for text, "base64" for binary, or omit for auto-detection
- * @returns FileInfo object with appropriate content based on encoding
- */
-declare function loadFileContent(filePath: string): Promise<FileInfo>;
-declare function loadFileContent(filePath: string, encoding: "utf-8"): Promise<TextFileInfo>;
-declare function loadFileContent(filePath: string, encoding: "base64"): Promise<Base64FileInfo>;
-//#endregion
 //#region src/messages/message.d.ts
 type AxleMessage = AxleUserMessage | AxleAssistantMessage | AxleToolCallMessage;
+type ToolResultPart = {
+  type: "text";
+  text: string;
+} | {
+  type: "file";
+  file: ConcreteFileInfo;
+};
 interface AxleUserMessage {
   role: "user";
   id?: string;
@@ -312,7 +395,7 @@ interface AxleAssistantMessage {
   role: "assistant";
   id: string;
   model?: string;
-  content: Array<ContentPartText | ContentPartThinking | ContentPartToolCall | ContentPartInternalTool>;
+  content: Array<ContentPartText | ContentPartThinking | ContentPartToolCall | ContentPartProviderTool>;
   finishReason?: AxleStopReason;
 }
 interface AxleToolCallMessage {
@@ -320,21 +403,13 @@ interface AxleToolCallMessage {
   id: string;
   content: Array<AxleToolCallResult>;
 }
-type ToolResultPart = {
-  type: "text";
-  text: string;
-} | {
-  type: "image";
-  data: string;
-  mimeType: string;
-};
 interface AxleToolCallResult {
   id: string;
   name: string;
   content: string | ToolResultPart[];
   isError?: boolean;
 }
-type ContentPart = ContentPartText | ContentPartFile | ContentPartToolCall | ContentPartThinking | ContentPartInternalTool;
+type ContentPart = ContentPartText | ContentPartFile | ContentPartToolCall | ContentPartThinking | ContentPartProviderTool;
 interface ContentPartText {
   type: "text";
   text: string;
@@ -359,30 +434,56 @@ interface ContentPartToolCall {
   parameters: Record<string, unknown>;
   providerMetadata?: Record<string, unknown>;
 }
-interface ContentPartInternalTool {
-  type: "internal-tool";
+interface ContentPartProviderTool {
+  type: "provider-tool";
   id: string;
   name: string;
   input?: unknown;
   output?: unknown;
 }
 //#endregion
+//#region src/tools/registry.d.ts
+declare class ToolRegistry {
+  private executableTools;
+  private providerTools;
+  constructor(init?: {
+    tools?: ExecutableTool[];
+    providerTools?: ProviderTool[];
+  });
+  add(tool: ExecutableTool): void;
+  add(tools: ExecutableTool[]): void;
+  addProvider(tool: ProviderTool): void;
+  addProvider(tools: ProviderTool[]): void;
+  remove(name: string): boolean;
+  has(name: string): boolean;
+  get(name: string): ExecutableTool | undefined;
+  getProvider(name: string): ProviderTool | undefined;
+  executable(): ExecutableTool[];
+  provider(): ProviderTool[];
+  get size(): number;
+}
+//#endregion
 //#region src/tools/types.d.ts
+interface ToolContext {
+  registry: ToolRegistry;
+  signal: AbortSignal;
+  emit: (chunk: string) => void;
+  tracer?: TracingContext;
+}
 interface ExecutableTool<TSchema extends ZodObject<any> = ZodObject<any>> {
   type?: "function";
   name: string;
   description: string;
   schema: TSchema;
-  execute(input: z.infer<TSchema>): Promise<string | ToolResultPart[]>;
+  execute(input: z.infer<TSchema>, ctx: ToolContext): Promise<string | ToolResultPart[]>;
   configure?(config: Record<string, any>): void;
   summarize?(input: z.infer<TSchema>): string;
 }
-interface ServerTool {
-  type: "server";
+interface ProviderTool {
+  type: "provider";
   name: string;
   config?: Record<string, unknown>;
 }
-type AxleTool = ExecutableTool | ServerTool;
 type ToolDefinition = Pick<ExecutableTool, "name" | "description" | "schema">;
 //#endregion
 //#region src/mcp/MCP.d.ts
@@ -500,6 +601,7 @@ interface ToolAction extends ActionPartBase {
   detail: {
     name: string;
     parameters: Record<string, unknown>;
+    pendingArgs?: string;
     result?: ActionResult;
   };
 }
@@ -512,16 +614,19 @@ interface SubagentAction extends ActionPartBase {
     result?: ActionResult;
   };
 }
-interface InternalToolAction extends ActionPartBase {
-  kind: "internal-tool";
+interface ProviderToolAction extends ActionPartBase {
+  kind: "provider-tool";
   detail: {
     name: string;
     input?: unknown;
     result?: ActionResult;
   };
 }
-type ActionPart = ToolAction | SubagentAction | InternalToolAction;
+type ActionPart = ToolAction | SubagentAction | ProviderToolAction;
 type ActionResult = {
+  type: "in-progress";
+  content: string;
+} | {
   type: "success";
   content: unknown;
 } | {
@@ -568,11 +673,22 @@ type AgentEvent = {
   turnId: string;
   partId: string;
   timing?: TimingInfo;
+} | {
+  type: "action:args-delta";
+  turnId: string;
+  partId: string;
+  delta: string;
+  accumulated: string;
 } | {
   type: "action:running";
   turnId: string;
   partId: string;
   parameters?: Record<string, unknown>;
+} | {
+  type: "action:progress";
+  turnId: string;
+  partId: string;
+  chunk: string;
 } | {
   type: "action:complete";
   turnId: string;
@@ -640,12 +756,11 @@ declare function parseResponse<T extends OutputSchema>(rawValue: string, schema?
 declare class Instruct<TSchema extends OutputSchema | undefined = undefined> {
   prompt: string;
   inputs: Record<string, string>;
-  files: Base64FileInfo[];
+  files: FileInfo[];
   textReferences: Array<{
     content: string;
     name?: string;
   }>;
-  instructions: string[];
   schema: TSchema;
   constructor(prompt: string, schema?: TSchema);
   setInputs(inputs: Record<string, string>): void;
@@ -653,7 +768,6 @@ declare class Instruct<TSchema extends OutputSchema | undefined = undefined> {
   addFile(file: FileInfo | string, options?: {
     name?: string;
   }): void;
-  addInstructions(instruction: string): void;
   hasFiles(): boolean;
 }
 //#endregion
@@ -667,10 +781,13 @@ interface AgentConfig {
   system?: string;
   name?: string;
   scope?: Record<string, string>;
-  tools?: AxleTool[];
+  tools?: ExecutableTool[];
+  providerTools?: ProviderTool[];
   mcps?: MCP[];
   memory?: AgentMemory;
   tracer?: TracingContext;
+  fileResolver?: FileResolver;
+  reasoning?: boolean;
   options?: AgentOptions;
 }
 interface AgentResult<T = string> {
@@ -682,6 +799,8 @@ type AgentHandle<T = string> = Handle<AgentResult<T>>;
 type AgentEventCallback = (event: AgentEvent) => void;
 interface SendMessageOptions {
   signal?: AbortSignal;
+  fileResolver?: FileResolver;
+  reasoning?: boolean;
 }
 interface SendInstructOptions extends SendMessageOptions {
   variables?: Record<string, string>;
@@ -694,18 +813,17 @@ declare class Agent {
   readonly name?: string;
   readonly scope?: Record<string, string>;
   readonly store: FileStore;
+  readonly fileResolver?: FileResolver;
+  readonly reasoning?: boolean;
+  readonly registry: ToolRegistry;
   system: string | undefined;
-  tools: Record<string, ExecutableTool>;
-  serverTools: ServerTool[];
   private mcps;
-  private mcpToolsResolved;
+  private resolvedMcps;
   private memory?;
   private options;
   private eventCallbacks;
   private sendQueue;
   constructor(config: AgentConfig);
-  addTool(tool: AxleTool): void;
-  addTools(tools: AxleTool[]): void;
   addMcp(mcp: MCP): void;
   addMcps(mcps: MCP[]): void;
   hasTools(): boolean;
@@ -759,10 +877,14 @@ declare function gemini(apiKey: string): AIProvider;
 declare const Gemini: {
   readonly Models: {
     readonly GEMINI_3_1_PRO_PREVIEW: "gemini-3.1-pro-preview";
+    readonly GEMINI_3_1_PRO: "gemini-3.1-pro-preview";
     readonly GEMINI_3_1_PRO_PREVIEW_CUSTOMTOOLS: "gemini-3.1-pro-preview-customtools";
     readonly GEMINI_3_1_FLASH_LITE_PREVIEW: "gemini-3.1-flash-lite-preview";
+    readonly GEMINI_3_1_FLASH_LITE: "gemini-3.1-flash-lite-preview";
     readonly GEMINI_3_PRO_PREVIEW: "gemini-3-pro-preview";
+    readonly GEMINI_3_PRO: "gemini-3-pro-preview";
     readonly GEMINI_3_FLASH_PREVIEW: "gemini-3-flash-preview";
+    readonly GEMINI_3_FLASH: "gemini-3-flash-preview";
     readonly GEMINI_2_5_PRO: "gemini-2.5-pro";
     readonly GEMINI_2_5_FLASH: "gemini-2.5-flash";
     readonly GEMINI_2_5_FLASH_LITE: "gemini-2.5-flash-lite";
@@ -773,14 +895,6 @@ declare const Gemini: {
     readonly GEMINI_FLASH_LATEST: "gemini-flash-latest";
     readonly GEMINI_FLASH_LITE_LATEST: "gemini-flash-lite-latest";
     readonly GEMINI_PRO_LATEST: "gemini-pro-latest";
-    readonly GEMMA_4_31B_IT: "gemma-4-31b-it";
-    readonly GEMMA_4_E4B_IT: "gemma-4-26b-a4b-it";
-    readonly GEMMA_3_27B_IT: "gemma-3-27b-it";
-    readonly GEMMA_3_12B_IT: "gemma-3-12b-it";
-    readonly GEMMA_3_4B_IT: "gemma-3-4b-it";
-    readonly GEMMA_3_1B_IT: "gemma-3-1b-it";
-    readonly GEMMA_3N_E4B_IT: "gemma-3n-e4b-it";
-    readonly GEMMA_3N_E2B_IT: "gemma-3n-e2b-it";
   };
   readonly DefaultModel: "gemini-3.1-flash-lite-preview";
 };
@@ -798,7 +912,7 @@ type ToolCallResult = {
     retryable?: boolean;
   };
 };
-type ToolCallCallback = (name: string, parameters: Record<string, unknown>) => Promise<ToolCallResult | null | undefined>;
+type ToolCallCallback = (name: string, parameters: Record<string, unknown>, ctx: ToolContext) => Promise<ToolCallResult | null | undefined>;
 type GenerateError = {
   type: "model";
   error: ModelError;
@@ -828,15 +942,6 @@ type StreamResult = GenerateResult | {
 };
 //#endregion
 //#region src/providers/generateTurn.d.ts
-interface GenerateTurnOptions {
-  temperature?: number;
-  top_p?: number;
-  max_tokens?: number;
-  frequency_penalty?: number;
-  presence_penalty?: number;
-  stop?: string | string[];
-  [key: string]: any;
-}
 interface GenerateTurnProps {
   provider: AIProvider;
   model: string;
@@ -844,7 +949,9 @@ interface GenerateTurnProps {
   system?: string;
   tools?: Array<ToolDefinition>;
   tracer?: TracingContext;
+  fileResolver?: FileResolver;
   options?: GenerateTurnOptions;
+  reasoning?: boolean;
 }
 declare function generateTurn(props: GenerateTurnProps): Promise<ModelResult>;
 //#endregion
@@ -854,11 +961,16 @@ interface GenerateOptions {
   model: string;
   messages: Array<AxleMessage>;
   system?: string;
-  tools?: Array<ToolDefinition>;
+  tools?: ExecutableTool[];
+  providerTools?: ProviderTool[];
+  registry?: ToolRegistry;
   onToolCall?: ToolCallCallback;
   maxIterations?: number;
   tracer?: TracingContext;
+  fileResolver?: FileResolver;
   options?: GenerateTurnOptions;
+  reasoning?: boolean;
+  signal?: AbortSignal;
 }
 declare function generate(options: GenerateOptions): Promise<GenerateResult>;
 //#endregion
@@ -906,12 +1018,25 @@ type StreamEvent = {
   index: number;
   id: string;
   name: string;
+} | {
+  type: "tool:args-delta";
+  index: number;
+  id: string;
+  name: string;
+  delta: string;
+  accumulated: string;
 } | {
   type: "tool:exec-start";
   index: number;
   id: string;
   name: string;
   parameters: Record<string, unknown>;
+} | {
+  type: "tool:exec-delta";
+  index: number;
+  id: string;
+  name: string;
+  chunk: string;
 } | {
   type: "tool:exec-complete";
   index: number;
@@ -919,12 +1044,12 @@ type StreamEvent = {
   name: string;
   result: ToolCallResult;
 } | {
-  type: "internal-tool:start";
+  type: "provider-tool:start";
   index: number;
   id: string;
   name: string;
 } | {
-  type: "internal-tool:complete";
+  type: "provider-tool:complete";
   index: number;
   id: string;
   name: string;
@@ -939,12 +1064,15 @@ interface StreamOptions {
   model: string;
   messages: Array<AxleMessage>;
   system?: string;
-  tools?: Array<ToolDefinition>;
-  serverTools?: Array<ServerTool>;
+  tools?: ExecutableTool[];
+  providerTools?: ProviderTool[];
+  registry?: ToolRegistry;
   onToolCall?: ToolCallCallback;
   maxIterations?: number;
   tracer?: TracingContext;
+  fileResolver?: FileResolver;
   options?: GenerateTurnOptions;
+  reasoning?: boolean;
   signal?: AbortSignal;
 }
 interface StreamHandle {
@@ -997,8 +1125,6 @@ declare const OpenAI: {
     readonly GPT_4_1_NANO_2025_04_14: "gpt-4.1-nano-2025-04-14";
     readonly GPT_4_1_NANO: "gpt-4.1-nano";
     readonly GPT_4O_2024_11_20: "gpt-4o-2024-11-20";
-    readonly GPT_4O_2024_08_06: "gpt-4o-2024-08-06";
-    readonly GPT_4O_2024_05_13: "gpt-4o-2024-05-13";
     readonly GPT_4O: "gpt-4o";
     readonly GPT_4O_MINI_2024_07_18: "gpt-4o-mini-2024-07-18";
     readonly GPT_4O_MINI: "gpt-4o-mini";
@@ -1010,10 +1136,6 @@ declare const OpenAI: {
     readonly O3_PRO: "o3-pro";
     readonly O3_MINI_2025_01_31: "o3-mini-2025-01-31";
     readonly O3_MINI: "o3-mini";
-    readonly O1_2024_12_17: "o1-2024-12-17";
-    readonly O1: "o1";
-    readonly O1_PRO_2025_03_19: "o1-pro-2025-03-19";
-    readonly O1_PRO: "o1-pro";
   };
   readonly DefaultModel: "gpt-5.4-mini";
 };
@@ -1024,6 +1146,12 @@ declare const BraveProviderConfigSchema: z.ZodObject<{
   rateLimit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type BraveProviderConfig = z.infer<typeof BraveProviderConfigSchema>;
+declare const ExecProviderConfigSchema: z.ZodObject<{
+  timeout: z.ZodOptional<z.ZodNumber>;
+  maxBuffer: z.ZodOptional<z.ZodNumber>;
+  cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ExecProviderConfig = z.infer<typeof ExecProviderConfigSchema>;
 //#endregion
 //#region src/tools/brave.d.ts
 declare const braveSearchSchema: z$2.ZodObject<{
@@ -1040,7 +1168,7 @@ declare class BraveSearchTool implements ExecutableTool<typeof braveSearchSchema
   lastExecTime: number;
   constructor(config?: BraveProviderConfig);
   configure(config: BraveProviderConfig): void;
-  execute(params: z$2.infer<typeof braveSearchSchema>): Promise<string>;
+  execute(params: z$2.infer<typeof braveSearchSchema>, _ctx: ToolContext): Promise<string>;
 }
 declare const braveSearchTool: BraveSearchTool;
 //#endregion
@@ -1057,6 +1185,49 @@ declare const calculatorSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const calculatorTool: ExecutableTool<typeof calculatorSchema>;
 //#endregion
+//#region src/tools/exec/index.d.ts
+declare const execSchema: z$2.ZodObject<{
+  command: z$2.ZodString;
+}, z$2.core.$strip>;
+declare class ExecTool implements ExecutableTool<typeof execSchema> {
+  name: string;
+  description: string;
+  schema: z$2.ZodObject<{
+    command: z$2.ZodString;
+  }, z$2.core.$strip>;
+  private timeout;
+  private maxBuffer;
+  private cwd?;
+  constructor(config?: ExecProviderConfig);
+  configure(config: ExecProviderConfig): void;
+  summarize(params: z$2.infer<typeof execSchema>): string;
+  execute(params: z$2.infer<typeof execSchema>, ctx: ToolContext): Promise<string>;
+}
+declare const execTool: ExecTool;
+//#endregion
+//#region src/tools/patch-file.d.ts
+declare const patchFileSchema: z.ZodObject<{
+  path: z.ZodString;
+  old_string: z.ZodString;
+  new_string: z.ZodString;
+  start_line: z.ZodNumber;
+  end_line: z.ZodNumber;
+}, z.core.$strip>;
+declare const patchFileTool: ExecutableTool<typeof patchFileSchema>;
+//#endregion
+//#region src/tools/read-file.d.ts
+declare const readFileSchema: z.ZodObject<{
+  path: z.ZodString;
+}, z.core.$strip>;
+declare const readFileTool: ExecutableTool<typeof readFileSchema>;
+//#endregion
+//#region src/tools/write-file.d.ts
+declare const writeFileSchema: z.ZodObject<{
+  path: z.ZodString;
+  content: z.ZodString;
+}, z.core.$strip>;
+declare const writeFileTool: ExecutableTool<typeof writeFileSchema>;
+//#endregion
 //#region src/turns/builder.d.ts
 declare class TurnBuilder {
   private currentTurn;
@@ -1185,4 +1356,4 @@ declare class LocalFileStore implements FileStore {
   write(path: string, content: string): Promise<void>;
 }
 //#endregion
-export { type AIProvider, type ActionPart, type ActionResult, Agent, type AgentConfig, type AgentEvent, type AgentEventCallback, type AgentHandle, type AgentMemory, type AgentResult, Anthropic, type AxleAssistantMessage, type AxleMessage, AxleStopReason, type AxleTool, type AxleToolCallMessage, type AxleToolCallResult, type AxleUserMessage, type ContentPart, type ContentPartFile, type ContentPartInternalTool, type ContentPartText, type ContentPartThinking, type ContentPartToolCall, type EventLevel, type ExecutableTool, type FileInfo, type FilePart, type FileStore, Gemini, type Handle, History, Instruct, type InternalToolAction, LocalFileStore, MCP, type MCPConfig, type MCPHttpConfig, type MCPStdioConfig, type MemoryContext, OpenAI, ProceduralMemory, type ProceduralMemoryConfig, type RecallResult, type SendInstructOptions, type SendMessageOptions, type ServerTool, SimpleWriter, type SimpleWriterOptions, type SpanData, type SpanOptions, type SpanType, type StreamEvent, type StreamEventCallback, type StreamHandle, type StreamResult, type SubagentAction, type TextPart, type ThinkingPart, type ToolAction, type ToolDefinition, type ToolResultPart, type TraceWriter, Tracer, type TracingContext, type Turn, TurnBuilder, type TurnPart, type TurnStatus, anthropic, braveSearchTool, calculatorTool, chatCompletions, compileInstruct, createHandle, gemini, generate, generateTurn, loadFileContent, openai, parseResponse, stream };
+export { type AIProvider, type ActionPart, type ActionResult, Agent, type AgentConfig, type AgentEvent, type AgentEventCallback, type AgentHandle, type AgentMemory, type AgentResult, Anthropic, type AxleAssistantMessage, type AxleMessage, AxleStopReason, type AxleToolCallMessage, type AxleToolCallResult, type AxleUserMessage, type ContentPart, type ContentPartFile, type ContentPartProviderTool, type ContentPartText, type ContentPartThinking, type ContentPartToolCall, type DeferredFileInfo, type EventLevel, type ExecutableTool, type FileInfo, type FileKind, type FilePart, type FileProviderId, type FileResolveFormat, type FileResolveRequest, type FileResolver, type FileStore, Gemini, type Handle, History, Instruct, LocalFileStore, MCP, type MCPConfig, type MCPHttpConfig, type MCPStdioConfig, type MemoryContext, OpenAI, ProceduralMemory, type ProceduralMemoryConfig, type ProviderTool, type ProviderToolAction, type RecallResult, type ResolvedFileSource, type SendInstructOptions, type SendMessageOptions, SimpleWriter, type SimpleWriterOptions, type SpanData, type SpanOptions, type SpanType, type StreamEvent, type StreamEventCallback, type StreamHandle, type StreamResult, type SubagentAction, type TextPart, type ThinkingPart, type ToolAction, type ToolContext, type ToolDefinition, ToolRegistry, type ToolResultPart, type TraceWriter, Tracer, type TracingContext, type Turn, TurnBuilder, type TurnPart, type TurnStatus, anthropic, braveSearchTool, calculatorTool, chatCompletions, compileInstruct, createHandle, execTool, gemini, generate, generateTurn, loadFileContent, openai, parseResponse, patchFileTool, readFileTool, stream, writeFileTool };