@fifthrevision/axle 0.23.1 → 0.25.0

package/dist/accumulator-BnFn9yqM.js

@@ -0,0 +1 @@
+var e=class e{_state;constructor(e){this._state={turns:e?.turns??[],sessionAnnotations:e?.sessionAnnotations}}get state(){return this._state}apply(t){let n=t;switch(t.type){case`session:restore`:return this.replaceState({turns:n.turns??[],sessionAnnotations:n.sessionAnnotations},t);case`turn:user`:return this.replaceTurns([...this._state.turns,n.turn],t);case`turn:start`:{let e={id:n.turnId,owner:`agent`,parts:[],status:`streaming`,...n.timing?{timing:n.timing}:{}};return this.replaceTurns([...this._state.turns,e],t)}case`part:start`:return this.updateTurn(n.turnId,t,e=>({...e,parts:[...e.parts,n.part]}));case`text:delta`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`text`?{...e,text:e.text+n.delta}:e);case`text:citation`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`text`?{...e,citations:[...e.citations??[],n.citation]}:e);case`thinking:delta`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`thinking`?{...e,text:(e.text??``)+n.delta}:e);case`thinking:summary-delta`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`thinking`?{...e,summary:(e.summary??``)+n.delta}:e);case`thinking:update`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`thinking`?{...e,...n.redacted===void 0?{}:{redacted:n.redacted},...n.continuity?{continuity:n.continuity}:{},...n.providerMetadata?{providerMetadata:n.providerMetadata}:{}}:e);case`part:end`:return this.updatePart(n.turnId,n.partId,t,e=>({...e,timing:n.timing??e.timing}));case`action:args-delta`:return this.updatePart(n.turnId,n.partId,t,e=>e.type!==`action`||e.kind!==`tool`?e:{...e,detail:{...e.detail,pendingArgs:n.accumulated}});case`action:running`:return this.updatePart(n.turnId,n.partId,t,e=>{if(e.type!==`action`)return e;if(e.kind===`tool`){let{pendingArgs:t,...r}=e.detail;return{...e,status:`running`,detail:n.parameters?{...r,parameters:n.parameters}:r}}return{...e,status:`running`}});case`action:progress`:return this.updatePart(n.turnId,n.partId,t,e=>{if(e.type!==`action`)return e;let t=e.detail.result,r=t?.type===`in-progress`?t.content:``;return{...e,detail:{...e.detail,result:{type:`in-progress`,content:r+n.chunk}}}});case`action:complete`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`action`?{...e,status:`complete`,detail:{...e.detail,result:n.result},timing:n.timing??e.timing}:e);case`action:error`:return this.updatePart(n.turnId,n.partId,t,e=>e.type===`action`?{...e,status:`error`,detail:{...e.detail,result:{type:`error`,error:n.error}},timing:n.timing??e.timing}:e);case`turn:end`:return this.updateTurn(n.turnId,t,e=>({...e,status:n.status,usage:n.usage,timing:n.timing??e.timing}));case`annotation:start`:return this.addAnnotation(t);case`annotation:update`:return this.replaceAnnotation(t,!1);case`annotation:end`:return this.replaceAnnotation(t,!0);case`error`:return this.handled(t);case`action:child-event`:return this.updatePart(n.turnId,n.partId,t,t=>{if(t.type!==`action`||t.kind!==`agent`)return t;let r=new e({turns:t.detail.children}).apply(n.event);return{...t,detail:{...t.detail,children:r.state.turns}}});default:return{handled:!1,state:this._state,event:t}}}replaceState(e,t){return this._state=e,this.handled(t)}replaceTurns(e,t){return this.replaceState({...this._state,turns:e},t)}updateTurn(e,t,n){let r=!1,i=this._state.turns.map(t=>{if(t.id!==e)return t;let i=n(t);return i===t?t:(r=!0,i)});return r?this.replaceTurns(i,t):this.handled(t)}updatePart(e,t,n,r){return this.updateTurn(e,n,e=>{let n=!1,i=e.parts.map(e=>{if(e.id!==t)return e;let i=r(e);return i===e?e:(n=!0,i)});return n?{...e,parts:i}:e})}addAnnotation(e){let n=e,r=n.target,i=t(n.annotation);return!r||!i?this.handled(e):r.type===`session`?this.replaceState({...this._state,sessionAnnotations:[...this._state.sessionAnnotations??[],i]},e):r.type===`turn`?this.updateTurn(r.turnId,e,e=>({...e,annotations:[...e.annotations??[],i]})):r.type===`part`?this.updatePart(r.turnId,r.partId,e,e=>({...e,annotations:[...e.annotations??[],i]})):this.handled(e)}replaceAnnotation(e,r){let i=e,a=i.target,o=t(i.annotation,r);if(!a||!o)return this.handled(e);if(a.type===`session`){let t=n(this._state.sessionAnnotations,o);return t?this.replaceState({...this._state,sessionAnnotations:t},e):this.handled(e)}return a.type===`turn`?this.updateTurn(a.turnId,e,e=>{let t=n(e.annotations,o);return t?{...e,annotations:t}:e}):a.type===`part`?this.updatePart(a.turnId,a.partId,e,e=>{let t=n(e.annotations,o);return t?{...e,annotations:t}:e}):this.handled(e)}handled(e){return{handled:!0,state:this._state,event:e}}};function t(e,t=!1){if(!e)return;let n=t?e.status??`complete`:e.status,r={...e,placement:e.placement??`after`};return n?{...r,status:n}:r}function n(e,t){if(!e)return;let n=!1,r=e.map(e=>e.id===t.id?(n=!0,t):e);return n?r:void 0}export{e as t};

package/dist/{accumulator-C4O3UCxY.d.ts → accumulator-j9h_1Eyk.d.ts}

@@ -83,10 +83,7 @@ interface Span {
 }
 //#endregion
 //#region src/types.d.ts
-/**
- * Usage reported by a provider response.
- */
-interface Stats {
+interface TokenStats {
   /** Total effective input tokens. Includes `cachedIn` and `cacheWriteIn` when reported. */
   in: number;
   /** Total output tokens. Includes `reasoningOut` when reported. */
@@ -98,6 +95,24 @@ interface Stats {
   /** Output tokens spent on reasoning/thinking. Included in `out`. */
   reasoningOut?: number;
 }
+interface UsageEntry extends TokenStats {
+  /** Provider identifier. */
+  provider: string;
+  /** Model identifier. */
+  model: string;
+}
+/**
+ * Aggregate usage reported by an Axle operation.
+ *
+ * `breakdown` holds one entry per provider+model pair so cost can be
+ * reconstructed when an operation spans models (for example subagent tools).
+ * Entries explain the aggregate numeric fields and must not be added to them
+ * again.
+ */
+interface Stats extends TokenStats {
+  /** @experimental The entry shape may gain dimensions in a minor release. */
+  breakdown?: UsageEntry[];
+}
 //#endregion
 //#region src/messages/stream.d.ts
 interface StreamChunk {
@@ -303,15 +318,6 @@ type DeferredFileInfo = FileInfo & {
     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 = {
@@ -409,11 +415,22 @@ interface AxleModelRequestOptions {
 }
 interface AIProvider {
   get name(): string;
+  /**
+   * Resolves a portable provider-tool name to the provider-native name.
+   * Returning undefined marks the tool unsupported. When omitted, Axle
+   * preserves the provider's existing passthrough behavior.
+   *
+   * @internal
+   */
+  resolveProviderToolName?(name: string, model: string): string | undefined;
   /** @internal */
   createGenerationRequest(model: string, params: ProviderGenerationParams): Promise<ModelResult>;
   /** @internal */
   createStreamingRequest(model: string, params: ProviderStreamParams): AsyncGenerator<AnyStreamChunk, void, unknown>;
 }
+interface ResolvedProviderTool extends ProviderTool {
+  nativeName?: string;
+}
 /**
  * Parameters passed to provider adapters for one non-streaming generation call.
  */
@@ -425,7 +442,7 @@ interface ProviderGenerationParams extends AxleModelRequestOptions {
   /** Executable tools exposed as provider function tools. */
   tools?: Array<ToolDefinition>;
   /** Provider-managed tools such as web search or code execution. */
-  providerTools?: Array<ProviderTool>;
+  providerTools?: Array<ResolvedProviderTool>;
   /** Internal services available during provider request creation. */
   runtime: ProviderRuntime;
 }
@@ -510,14 +527,15 @@ type MessageMetadata = Record<string, unknown>;
  * Content returned by a tool call.
  *
  * Tool results may be simple text or structured parts when the result includes
- * file data.
+ * file data. Deferred file sources remain authored in history and are resolved
+ * at each provider conversion boundary so expiring URLs are not persisted.
  */
 type ToolResultPart = {
   type: "text";
   text: string;
 } | {
   type: "file";
-  file: ConcreteFileInfo;
+  file: FileInfo;
 };
 /**
  * Message authored by the user or host application.
@@ -750,56 +768,6 @@ interface ContentPartCitation {
   providerMetadata?: Record<string, unknown>;
 }
 //#endregion
-//#region src/tools/registry.d.ts
-declare class ToolRegistry {
-  private tools;
-  private mcpTools;
-  private providerTools;
-  constructor(init?: {
-    tools?: ExecutableTool[];
-    providerTools?: ProviderTool[];
-  });
-  add(tool: ExecutableTool): void;
-  add(tools: ExecutableTool[]): void;
-  addMcp(tool: ExecutableTool): void;
-  addMcp(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[];
-  local(): ExecutableTool[];
-  mcp(): ExecutableTool[];
-  provider(): ProviderTool[];
-  get size(): number;
-}
-//#endregion
-//#region src/tools/types.d.ts
-interface ToolContext {
-  registry: ToolRegistry;
-  signal: AbortSignal;
-  emit: (chunk: string) => void;
-  span?: Span;
-}
-interface ExecutableTool<TSchema extends ZodObject<any> = ZodObject<any>> {
-  type?: "function";
-  name: string;
-  description: string;
-  schema: TSchema;
-  execute(input: z.infer<TSchema>, ctx: ToolContext): Promise<string | ToolResultPart[]>;
-  configure?(config: Record<string, any>): void;
-  summarize?(input: z.infer<TSchema>): string;
-}
-interface ProviderTool {
-  type: "provider";
-  name: string;
-  /** Provider-specific passthrough config. Field names and placement are not portable. */
-  config?: Record<string, unknown>;
-}
-type ToolDefinition = Pick<ExecutableTool, "name" | "description" | "schema">;
-//#endregion
 //#region src/turns/types.d.ts
 /**
  * Lifecycle state for a renderable turn.
@@ -1163,6 +1131,69 @@ type TurnEvent<TAnnotation extends Annotation = Annotation> = {
   };
 };
 //#endregion
+//#region src/tools/registry.d.ts
+declare class ToolRegistry {
+  private tools;
+  private mcpTools;
+  private providerTools;
+  constructor(init?: {
+    tools?: ExecutableTool[];
+    providerTools?: ProviderTool[];
+  });
+  add(tool: ExecutableTool): void;
+  add(tools: ExecutableTool[]): void;
+  addMcp(tool: ExecutableTool): void;
+  addMcp(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[];
+  local(): ExecutableTool[];
+  mcp(): ExecutableTool[];
+  provider(): ProviderTool[];
+  get size(): number;
+}
+//#endregion
+//#region src/tools/types.d.ts
+type ToolProgressChunk = string | {
+  type: "turn-event";
+  event: TurnEvent;
+};
+interface ToolContext {
+  registry: ToolRegistry;
+  signal: AbortSignal;
+  emit: (chunk: ToolProgressChunk) => void;
+  /**
+   * Report model usage incurred while executing this tool (for example a
+   * subagent's tokens) so it is rolled into the parent operation's totals.
+   *
+   * @experimental
+   */
+  reportUsage?: (usage: Stats) => void;
+  span?: Span;
+}
+interface ExecutableTool<TSchema extends ZodObject<any> = ZodObject<any>> {
+  type?: "function";
+  /** Presentation metadata. Agent-backed tools set "agent"; execution is identical. */
+  kind?: "tool" | "agent";
+  name: string;
+  description: string;
+  schema: TSchema;
+  execute(input: z.infer<TSchema>, ctx: ToolContext): Promise<string | ToolResultPart[]>;
+  configure?(config: Record<string, any>): void;
+  summarize?(input: z.infer<TSchema>): string;
+}
+interface ProviderTool {
+  type: "provider";
+  name: string;
+  /** Provider-specific passthrough config. Field names and placement are not portable. */
+  config?: Record<string, unknown>;
+}
+type ToolDefinition = Pick<ExecutableTool, "name" | "description" | "schema">;
+//#endregion
 //#region src/turns/accumulator.d.ts
 interface TurnAccumulatorState<TAnnotation extends Annotation = Annotation> {
   turns: Turn<TAnnotation>[];
@@ -1195,4 +1226,4 @@ declare class TurnAccumulator<TAnnotation extends Annotation = Annotation, THost
   private handled;
 }
 //#endregion
-export { ContextUsage as $, ToolRegistry as A, ContentPartCitation as B, TurnMetadata as C, SpanResult as Ct, ProviderTool as D, ToolResult as Dt, ExecutableTool as E, TokenUsage as Et, AxleUserMessage as F, ContentPartToolCall as G, ContentPartProviderTool as H, Citation as I, ThinkingContinuity as J, DocumentLocator as K, CitationOutputSpan as L, AxleMessage as M, AxleToolCallMessage as N, ToolContext as O, TraceWriter as Ot, AxleToolCallResult as P, AxleStopReason as Q, CitationSource as R, Turn as S, SpanOptions as St, TurnStatus as T, SpanType as Tt, ContentPartText as U, ContentPartFile as V, ContentPartThinking as W, AIProvider as X, ToolResultPart as Y, AxleModelRequestOptions as Z, SubagentAction as _, LLMResponse as _t, UnknownEvent as a, DeferredFileInfo as at, TimingInfo as b, SpanData as bt, TurnEvent as c, FileProviderId as ct, Annotation as d, FileResolver as dt, ModelError as et, AnnotationPlacement as f, ResolvedFileSource as ft, ProviderToolAction as g, LLMRequest as gt, FilePart as h, EventLevel as ht, TurnAccumulatorState as i, ToolChoice as it, AxleAssistantMessage as j, ToolDefinition as k, ActionPart as l, FileResolveFormat as lt, CitationPart as m, Stats as mt, TurnAccumulator as n, ProviderClientOptions as nt, AnnotationEvent as o, FileInfo as ot, AnnotationStatus as p, loadFileContent as pt, MessageMetadata as q, TurnAccumulatorResult as r, ProviderOptions as rt, AnnotationTarget as s, FileKind as st, AccumulatableEvent as t, ModelResult as tt, ActionResult as u, FileResolveRequest as ut, TextPart as v, LLMResult as vt, TurnPart as w, SpanStatus as wt, ToolAction as x, SpanEvent as xt, ThinkingPart as y, Span as yt, ContentPart as z };
+export { AxleStopReason as $, TurnPart as A, TokenUsage as At, ContentPart as B, SubagentAction as C, Span as Ct, ToolAction as D, SpanResult as Dt, TimingInfo as E, SpanOptions as Et, AxleToolCallResult as F, ContentPartThinking as G, ContentPartFile as H, AxleUserMessage as I, MessageMetadata as J, ContentPartToolCall as K, Citation as L, AxleAssistantMessage as M, TraceWriter as Mt, AxleMessage as N, Turn as O, SpanStatus as Ot, AxleToolCallMessage as P, AxleModelRequestOptions as Q, CitationOutputSpan as R, ProviderToolAction as S, LLMResult as St, ThinkingPart as T, SpanEvent as Tt, ContentPartProviderTool as U, ContentPartCitation as V, ContentPartText as W, ToolResultPart as X, ThinkingContinuity as Y, AIProvider as Z, Annotation as _, TokenStats as _t, UnknownEvent as a, ResolvedProviderTool as at, CitationPart as b, LLMRequest as bt, ToolContext as c, FileInfo as ct, ToolRegistry as d, FileResolveFormat as dt, ContextUsage as et, AnnotationEvent as f, FileResolveRequest as ft, ActionResult as g, Stats as gt, ActionPart as h, loadFileContent as ht, TurnAccumulatorState as i, ProviderOptions as it, TurnStatus as j, ToolResult as jt, TurnMetadata as k, SpanType as kt, ToolDefinition as l, FileKind as lt, TurnEvent as m, ResolvedFileSource as mt, TurnAccumulator as n, ModelResult as nt, ExecutableTool as o, ToolChoice as ot, AnnotationTarget as p, FileResolver as pt, DocumentLocator as q, TurnAccumulatorResult as r, ProviderClientOptions as rt, ProviderTool as s, DeferredFileInfo as st, AccumulatableEvent as t, ModelError as tt, ToolProgressChunk as u, FileProviderId as ut, AnnotationPlacement as v, UsageEntry as vt, TextPart as w, SpanData as wt, FilePart as x, LLMResponse as xt, AnnotationStatus as y, EventLevel as yt, CitationSource as z };

package/dist/index.d.ts

@@ -1,6 +1,50 @@
-import { $ as ContextUsage, A as ToolRegistry, B as ContentPartCitation, C as TurnMetadata, Ct as SpanResult, D as ProviderTool, Dt as ToolResult, E as ExecutableTool, Et as TokenUsage, F as AxleUserMessage, G as ContentPartToolCall, H as ContentPartProviderTool, I as Citation, J as ThinkingContinuity, K as DocumentLocator, L as CitationOutputSpan, M as AxleMessage, N as AxleToolCallMessage, O as ToolContext, Ot as TraceWriter, P as AxleToolCallResult, Q as AxleStopReason, R as CitationSource, S as Turn, St as SpanOptions, T as TurnStatus, Tt as SpanType, U as ContentPartText, V as ContentPartFile, W as ContentPartThinking, X as AIProvider, Y as ToolResultPart, Z as AxleModelRequestOptions, _ as SubagentAction, _t as LLMResponse, at as DeferredFileInfo, bt as SpanData, c as TurnEvent, ct as FileProviderId, d as Annotation, dt as FileResolver, et as ModelError, f as AnnotationPlacement, ft as ResolvedFileSource, g as ProviderToolAction, gt as LLMRequest, h as FilePart, ht as EventLevel, i as TurnAccumulatorState, it as ToolChoice, j as AxleAssistantMessage, k as ToolDefinition, l as ActionPart, lt as FileResolveFormat, m as CitationPart, mt as Stats, n as TurnAccumulator, nt as ProviderClientOptions, o as AnnotationEvent, ot as FileInfo, p as AnnotationStatus, pt as loadFileContent, q as MessageMetadata, r as TurnAccumulatorResult, rt as ProviderOptions, s as AnnotationTarget, st as FileKind, t as AccumulatableEvent, tt as ModelResult, u as ActionResult, ut as FileResolveRequest, v as TextPart, vt as LLMResult, w as TurnPart, wt as SpanStatus, x as ToolAction, xt as SpanEvent, y as ThinkingPart, yt as Span, z as ContentPart } from "./accumulator-C4O3UCxY.js";
+import { $ as AxleStopReason, A as TurnPart, At as TokenUsage, B as ContentPart, C as SubagentAction, Ct as Span, D as ToolAction, Dt as SpanResult, Et as SpanOptions, F as AxleToolCallResult, G as ContentPartThinking, H as ContentPartFile, I as AxleUserMessage, J as MessageMetadata, K as ContentPartToolCall, L as Citation, M as AxleAssistantMessage, Mt as TraceWriter, N as AxleMessage, O as Turn, Ot as SpanStatus, P as AxleToolCallMessage, Q as AxleModelRequestOptions, R as CitationOutputSpan, S as ProviderToolAction, St as LLMResult, T as ThinkingPart, Tt as SpanEvent, U as ContentPartProviderTool, V as ContentPartCitation, W as ContentPartText, X as ToolResultPart, Y as ThinkingContinuity, Z as AIProvider, _ as Annotation, _t as TokenStats, at as ResolvedProviderTool, b as CitationPart, bt as LLMRequest, c as ToolContext, ct as FileInfo, d as ToolRegistry, dt as FileResolveFormat, et as ContextUsage, f as AnnotationEvent, ft as FileResolveRequest, g as ActionResult, gt as Stats, h as ActionPart, ht as loadFileContent, i as TurnAccumulatorState, it as ProviderOptions, j as TurnStatus, jt as ToolResult, k as TurnMetadata, kt as SpanType, l as ToolDefinition, lt as FileKind, m as TurnEvent, mt as ResolvedFileSource, n as TurnAccumulator, nt as ModelResult, o as ExecutableTool, ot as ToolChoice, p as AnnotationTarget, pt as FileResolver, q as DocumentLocator, r as TurnAccumulatorResult, rt as ProviderClientOptions, s as ProviderTool, st as DeferredFileInfo, t as AccumulatableEvent, tt as ModelError, u as ToolProgressChunk, ut as FileProviderId, v as AnnotationPlacement, vt as UsageEntry, w as TextPart, wt as SpanData, x as FilePart, xt as LLMResponse, y as AnnotationStatus, yt as EventLevel, z as CitationSource } from "./accumulator-j9h_1Eyk.js";
 import * as z$2 from "zod";
+import { ZodObject, z } from "zod";
 
+//#region src/tools/webSearch.d.ts
+interface WebSearchRequest {
+  query: string;
+}
+interface WebSearchResult {
+  title: string;
+  url: string;
+  snippets: string[];
+}
+interface WebSearchResponse {
+  results: WebSearchResult[];
+}
+interface WebSearchBackendContext {
+  signal: AbortSignal;
+  span?: Span;
+}
+interface WebSearchBackend {
+  readonly name: string;
+  search(request: WebSearchRequest, context: WebSearchBackendContext): Promise<WebSearchResponse>;
+}
+interface BraveWebSearchOptions {
+  apiKey: string;
+  endpoint?: string;
+  maxResults?: number;
+  candidateCount?: number;
+  maxTokens?: number;
+  maxSnippets?: number;
+  maxTokensPerUrl?: number;
+  maxSnippetsPerUrl?: number;
+  contextThresholdMode?: string;
+  country?: string;
+  searchLanguage?: string;
+  freshness?: "pd" | "pw" | "pm" | "py" | `${string}to${string}`;
+  timeoutMs?: number;
+}
+declare function braveWebSearch(options: BraveWebSearchOptions): WebSearchBackend;
+//#endregion
+//#region src/config.d.ts
+interface AxleConfiguration {
+  webSearchFallback?: WebSearchBackend;
+}
+declare function configureAxle(options: AxleConfiguration): void;
+//#endregion
 //#region src/mcp/MCP.d.ts
 interface MCPStdioConfig {
   transport: "stdio";
@@ -55,6 +99,10 @@ declare function parseResponse<T extends OutputSchema>(rawValue: string, schema?
 //#region src/core/Instruct.d.ts
 type InstructInputs = Record<string, unknown>;
 type InstructVarsMode = "required" | "optional";
+interface InstructContextSection {
+  content: string;
+  title?: string;
+}
 interface InstructOptions<TSchema extends OutputSchema | undefined = OutputSchema | undefined> {
   prompt: string;
   schema?: TSchema;
@@ -69,6 +117,7 @@ declare class Instruct<TSchema extends OutputSchema | undefined = undefined> {
     content: string;
     name?: string;
   }>;
+  contextSections: InstructContextSection[];
   vars: InstructVarsMode;
   metadata?: MessageMetadata;
   schema: TSchema;
@@ -81,6 +130,10 @@ declare class Instruct<TSchema extends OutputSchema | undefined = undefined> {
   addFile(file: FileInfo | string, options?: {
     name?: string;
   }): void;
+  /** Append host-supplied supporting material without modifying the authored prompt. */
+  addContext(content: string, options?: {
+    title?: string;
+  }): this;
   hasFiles(): boolean;
   render(options?: {
     vars?: InstructVarsMode;
@@ -179,6 +232,80 @@ declare class Tracer {
   flush(): Promise<void>;
 }
 //#endregion
+//#region src/errors/AxleError.d.ts
+declare class AxleError extends Error {
+  readonly code: string;
+  readonly id?: string;
+  readonly details?: Record<string, any>;
+  constructor(message: string, options?: {
+    code?: string;
+    id?: string;
+    details?: Record<string, any>;
+    cause?: unknown;
+  });
+  toJSON(): {
+    cause?: unknown;
+    details?: Record<string, any> | undefined;
+    id?: string | undefined;
+    name: string;
+    message: string;
+    code: string;
+  };
+}
+//#endregion
+//#region src/errors/AxleAbortError.d.ts
+declare class AxleAbortError extends AxleError {
+  readonly reason: unknown;
+  readonly messages?: AxleMessage[];
+  readonly partial?: AxleAssistantMessage;
+  readonly usage?: Stats;
+  constructor(message?: string, options?: {
+    reason?: unknown;
+    messages?: AxleMessage[];
+    partial?: AxleAssistantMessage;
+    usage?: Stats;
+  });
+  toJSON(): {
+    usage?: Stats | undefined;
+    partial?: AxleAssistantMessage | undefined;
+    messages?: AxleMessage[] | undefined;
+    reason: unknown;
+    cause?: unknown;
+    details?: Record<string, any> | undefined;
+    id?: string | undefined;
+    name: string;
+    message: string;
+    code: string;
+  };
+}
+//#endregion
+//#region src/errors/AxleToolFatalError.d.ts
+declare class AxleToolFatalError extends AxleError {
+  readonly toolName?: string;
+  readonly messages?: AxleMessage[];
+  readonly partial?: AxleAssistantMessage;
+  readonly usage?: Stats;
+  constructor(message?: string, options?: {
+    toolName?: string;
+    messages?: AxleMessage[];
+    partial?: AxleAssistantMessage;
+    usage?: Stats;
+    cause?: unknown;
+  });
+  toJSON(): {
+    usage?: Stats | undefined;
+    partial?: AxleAssistantMessage | undefined;
+    messages?: AxleMessage[] | undefined;
+    toolName?: string | undefined;
+    cause?: unknown;
+    details?: Record<string, any> | undefined;
+    id?: string | undefined;
+    name: string;
+    message: string;
+    code: string;
+  };
+}
+//#endregion
 //#region src/providers/helpers.d.ts
 type ToolCallResult = {
   type: "success";
@@ -455,7 +582,7 @@ declare class Agent {
   addMcp(mcp: MCP): void;
   addMcps(mcps: MCP[]): void;
   hasTools(): boolean;
-  on(callback: TurnEventCallback): void;
+  on(callback: TurnEventCallback): () => void;
   context(): ContextUsage;
   /**
    * Capture the serializable session state for later continuation.
@@ -495,53 +622,6 @@ declare function createAgentConfig(definition: AgentDefinition, resolver: AgentD
 //#region src/core/userTurn.d.ts
 type InstructResponse<TSchema extends OutputSchema | undefined> = TSchema extends OutputSchema ? ParsedSchema<TSchema> : string;
 //#endregion
-//#region src/errors/AxleError.d.ts
-declare class AxleError extends Error {
-  readonly code: string;
-  readonly id?: string;
-  readonly details?: Record<string, any>;
-  constructor(message: string, options?: {
-    code?: string;
-    id?: string;
-    details?: Record<string, any>;
-    cause?: unknown;
-  });
-  toJSON(): {
-    cause?: unknown;
-    details?: Record<string, any> | undefined;
-    id?: string | undefined;
-    name: string;
-    message: string;
-    code: string;
-  };
-}
-//#endregion
-//#region src/errors/AxleAbortError.d.ts
-declare class AxleAbortError extends AxleError {
-  readonly reason: unknown;
-  readonly messages?: AxleMessage[];
-  readonly partial?: AxleAssistantMessage;
-  readonly usage?: Stats;
-  constructor(message?: string, options?: {
-    reason?: unknown;
-    messages?: AxleMessage[];
-    partial?: AxleAssistantMessage;
-    usage?: Stats;
-  });
-  toJSON(): {
-    usage?: Stats | undefined;
-    partial?: AxleAssistantMessage | undefined;
-    messages?: AxleMessage[] | undefined;
-    reason: unknown;
-    cause?: unknown;
-    details?: Record<string, any> | undefined;
-    id?: string | undefined;
-    name: string;
-    message: string;
-    code: string;
-  };
-}
-//#endregion
 //#region src/errors/AxleAgentAbortError.d.ts
 declare class AxleAgentAbortError extends AxleAbortError {
   readonly turn?: Turn;
@@ -567,33 +647,6 @@ declare class AxleAgentAbortError extends AxleAbortError {
   };
 }
 //#endregion
-//#region src/errors/AxleToolFatalError.d.ts
-declare class AxleToolFatalError extends AxleError {
-  readonly toolName?: string;
-  readonly messages?: AxleMessage[];
-  readonly partial?: AxleAssistantMessage;
-  readonly usage?: Stats;
-  constructor(message?: string, options?: {
-    toolName?: string;
-    messages?: AxleMessage[];
-    partial?: AxleAssistantMessage;
-    usage?: Stats;
-    cause?: unknown;
-  });
-  toJSON(): {
-    usage?: Stats | undefined;
-    partial?: AxleAssistantMessage | undefined;
-    messages?: AxleMessage[] | undefined;
-    toolName?: string | undefined;
-    cause?: unknown;
-    details?: Record<string, any> | undefined;
-    id?: string | undefined;
-    name: string;
-    message: string;
-    code: string;
-  };
-}
-//#endregion
 //#region src/errors/InstructVariableError.d.ts
 declare class InstructVariableError extends AxleError {
   readonly missingVariables: string[];
@@ -646,9 +699,13 @@ declare const Anthropic: {
   readonly DefaultModel: "claude-haiku-4-5-20251001";
 };
 //#endregion
+//#region src/providers/chatcompletions/utils.d.ts
+type ChatCompletionsProviderDialect = "together";
+//#endregion
 //#region src/providers/chatcompletions/provider.d.ts
 interface ChatCompletionsOptions extends ProviderClientOptions {
   apiKey?: string;
+  providerDialect?: ChatCompletionsProviderDialect;
   providerToolVendor?: "openrouter";
 }
 declare function chatCompletions(baseUrl: string, options?: ChatCompletionsOptions): AIProvider;
@@ -725,7 +782,7 @@ interface GenerateTurnParams extends AxleModelRequestOptions {
   messages: Array<AxleMessage>;
   system?: string;
   tools?: Array<ToolDefinition>;
-  providerTools?: Array<ProviderTool>;
+  providerTools?: Array<ResolvedProviderTool>;
   span?: Span;
   fileResolver?: FileResolver;
 }
@@ -799,6 +856,7 @@ type StreamEvent = {
   index: number;
   id: string;
   name: string;
+  kind?: "tool" | "agent";
 } | {
   type: "tool:args-delta";
   index: number;
@@ -817,13 +875,24 @@ type StreamEvent = {
   index: number;
   id: string;
   name: string;
-  chunk: string;
+  chunk: ToolProgressChunk;
 } | {
   type: "tool:exec-complete";
   index: number;
   id: string;
   name: string;
   result: ToolCallResult;
+  usage?: Stats;
+} | {
+  type: "tool:exec-error";
+  index: number;
+  id: string;
+  name: string;
+  error: {
+    type: "fatal" | "aborted";
+    message: string;
+  };
+  usage?: Stats;
 } | {
   type: "provider-tool:start";
   index: number;
@@ -927,6 +996,70 @@ declare const OpenAI: {
   readonly DefaultModel: "gpt-5.4-mini";
 };
 //#endregion
+//#region src/tools/agentTool.d.ts
+interface CreateAgentToolOptions<TSchema extends ZodObject<any>> {
+  name: string;
+  description: string;
+  schema: TSchema;
+  /** Create the child agent for this tool call. Fresh agents are recommended. */
+  createAgent: (input: z.infer<TSchema>, ctx: ToolContext) => MaybePromise<Agent>;
+  /**
+   * Convert tool input into the child-agent user prompt. Defaults to a compact
+   * JSON task payload.
+   */
+  prompt?: string | ((input: z.infer<TSchema>) => string);
+  /** Per-send request overrides for the child agent. */
+  request?: AxleModelRequestOptions;
+}
+/**
+ * Expose an Agent as a normal executable tool.
+ *
+ * This lets a parent model delegate bounded work to a child agent while only
+ * receiving the child agent's final response. The child's turn events are
+ * forwarded through `ctx.emit` and its token usage through `ctx.reportUsage`,
+ * so parents can render live progress and reconstruct cost.
+ *
+ * @experimental Shapes related to subagent rendering may change in a minor
+ * release.
+ */
+declare function createAgentTool<TSchema extends ZodObject<any>>(options: CreateAgentToolOptions<TSchema>): ExecutableTool<TSchema>;
+//#endregion
+//#region src/tools/parallelize.d.ts
+interface ParallelizeOptions {
+  /** Name of the generated batch tool. Defaults to `${tool.name}_batch`. */
+  name?: string;
+  /** Description of the generated batch tool. */
+  description?: string;
+  /** Maximum items accepted by the generated tool schema. */
+  maxItems?: number;
+  /** Maximum inner tool calls to run concurrently. */
+  maxConcurrency?: number;
+}
+interface ParallelToolResult<TInput = unknown> {
+  index: number;
+  input: TInput;
+  ok: boolean;
+  output?: string | ToolResultPart[];
+  error?: {
+    type: "execution";
+    message: string;
+  };
+}
+/**
+ * Create a batch tool that runs a tool over many input items concurrently.
+ *
+ * The generated tool preserves result order and reports per-item failures
+ * instead of failing the whole batch for ordinary execution errors. Fatal
+ * and abort errors are not demoted: they propagate and terminate the run,
+ * matching the unbatched tool contract.
+ *
+ * @experimental The generated tool's result JSON (`ParallelToolResult`) may
+ * change in a minor release.
+ */
+declare function parallelize<TSchema extends ZodObject<any>>(tool: ExecutableTool<TSchema>, options?: ParallelizeOptions): ExecutableTool<ZodObject<{
+  items: z.ZodArray<TSchema>;
+}>>;
+//#endregion
 //#region src/turns/eventBuilder.d.ts
 declare class TurnEventBuilder {
   private currentTurnId;
@@ -1001,5 +1134,6 @@ interface FileStore {
 //#region src/utils/stats.d.ts
 declare function createStats(): Stats;
 declare function addStats(total: Stats, usage?: Stats): void;
+declare function mergeStats(...usages: Array<Stats | undefined>): Stats;
 //#endregion
-export { type AIProvider, type AccumulatableEvent, type ActionPart, type ActionResult, Agent, type AgentConfig, type AgentDefinition, type AgentDefinitionRequestOptions, type AgentDefinitionResolver, type AgentErrorResult, type AgentHandle, type AgentMemory, type AgentResult, type AgentSession, type Annotation, type AnnotationEvent, type AnnotationPlacement, type AnnotationStatus, type AnnotationTarget, Anthropic, AxleAbortError, AxleAgentAbortError, type AxleAssistantMessage, AxleError, type AxleMessage, type AxleModelRequestOptions, AxleStopReason, type AxleToolCallMessage, type AxleToolCallResult, AxleToolFatalError, type AxleUserMessage, type ChatCompletionsOptions, type Citation, type CitationOutputSpan, type CitationPart, type CitationSource, type ContentPart, type ContentPartCitation, type ContentPartFile, type ContentPartProviderTool, type ContentPartText, type ContentPartThinking, type ContentPartToolCall, type ContextUsage, type DeferredFileInfo, type DocumentLocator, type EventLevel, type ExecutableTool, type FileInfo, type FileKind, type FilePart, type FileProviderId, type FileResolveFormat, type FileResolveRequest, type FileResolver, type FileStore, Gemini, type GenerateInstructParams, type GenerateInstructResult, type GenerateParams, type Handle, History, Instruct, type InstructInputs, type InstructOptions, type InstructResponse, InstructVariableError, type InstructVarsMode, type LLMRequest, type LLMResponse, type LLMResult, type LogEntry, type LogFn, LogWriter, MCP, type MCPConfig, type MCPHttpConfig, type MCPStdioConfig, type MaybePromise, type MemoryContext, type MessageMetadata, type ObservabilityOptions, OpenAI, type OutputSchema, type ParsedSchema, type ProviderClientOptions, type ProviderDefinition, type ProviderOptions, type ProviderTool, type ProviderToolAction, type ProviderToolDefinitionRef, type RecallResult, type ResolvedAgentDefinition, type ResolvedFileSource, type SavedAgent, type SendMessageOptions, SimpleWriter, type SimpleWriterOptions, type Span, type SpanData, type SpanEvent, type SpanOptions, type SpanResult, type SpanStatus, type SpanType, type Stats, type StreamEvent, type StreamEventCallback, type StreamHandle, type StreamInstructHandle, type StreamInstructParams, type StreamInstructResult, type StreamParams, type StreamResult, type SubagentAction, TaskError, type TextPart, type ThinkingContinuity, type ThinkingPart, type TokenUsage, type ToolAction, type ToolChoice, type ToolContext, type ToolDefinition, type ToolDefinitionRef, ToolRegistry, type ToolResult, type ToolResultPart, type TraceWriter, Tracer, type TracerOptions, type Turn, TurnAccumulator, type TurnAccumulatorResult, type TurnAccumulatorState, type TurnEvent, TurnEventBuilder, type TurnEventCallback, type TurnMetadata, type TurnPart, type TurnStatus, addStats, anthropic, chatCompletions, createAgentConfig, createHandle, createStats, estimateContextUsage, gemini, generate, generateTurn, loadFileContent, openai, parseResponse, stream };
+export { type AIProvider, type AccumulatableEvent, type ActionPart, type ActionResult, Agent, type AgentConfig, type AgentDefinition, type AgentDefinitionRequestOptions, type AgentDefinitionResolver, type AgentErrorResult, type AgentHandle, type AgentMemory, type AgentResult, type AgentSession, type Annotation, type AnnotationEvent, type AnnotationPlacement, type AnnotationStatus, type AnnotationTarget, Anthropic, AxleAbortError, AxleAgentAbortError, type AxleAssistantMessage, type AxleConfiguration, AxleError, type AxleMessage, type AxleModelRequestOptions, AxleStopReason, type AxleToolCallMessage, type AxleToolCallResult, AxleToolFatalError, type AxleUserMessage, type BraveWebSearchOptions, type ChatCompletionsOptions, type Citation, type CitationOutputSpan, type CitationPart, type CitationSource, type ContentPart, type ContentPartCitation, type ContentPartFile, type ContentPartProviderTool, type ContentPartText, type ContentPartThinking, type ContentPartToolCall, type ContextUsage, type CreateAgentToolOptions, type DeferredFileInfo, type DocumentLocator, type EventLevel, type ExecutableTool, type FileInfo, type FileKind, type FilePart, type FileProviderId, type FileResolveFormat, type FileResolveRequest, type FileResolver, type FileStore, Gemini, type GenerateInstructParams, type GenerateInstructResult, type GenerateParams, type Handle, History, Instruct, type InstructContextSection, type InstructInputs, type InstructOptions, type InstructResponse, InstructVariableError, type InstructVarsMode, type LLMRequest, type LLMResponse, type LLMResult, type LogEntry, type LogFn, LogWriter, MCP, type MCPConfig, type MCPHttpConfig, type MCPStdioConfig, type MaybePromise, type MemoryContext, type MessageMetadata, type ObservabilityOptions, OpenAI, type OutputSchema, type ParallelToolResult, type ParallelizeOptions, type ParsedSchema, type ProviderClientOptions, type ProviderDefinition, type ProviderOptions, type ProviderTool, type ProviderToolAction, type ProviderToolDefinitionRef, type RecallResult, type ResolvedAgentDefinition, type ResolvedFileSource, type SavedAgent, type SendMessageOptions, SimpleWriter, type SimpleWriterOptions, type Span, type SpanData, type SpanEvent, type SpanOptions, type SpanResult, type SpanStatus, type SpanType, type Stats, type StreamEvent, type StreamEventCallback, type StreamHandle, type StreamInstructHandle, type StreamInstructParams, type StreamInstructResult, type StreamParams, type StreamResult, type SubagentAction, TaskError, type TextPart, type ThinkingContinuity, type ThinkingPart, type TokenStats, type TokenUsage, type ToolAction, type ToolChoice, type ToolContext, type ToolDefinition, type ToolDefinitionRef, type ToolProgressChunk, ToolRegistry, type ToolResult, type ToolResultPart, type TraceWriter, Tracer, type TracerOptions, type Turn, TurnAccumulator, type TurnAccumulatorResult, type TurnAccumulatorState, type TurnEvent, TurnEventBuilder, type TurnEventCallback, type TurnMetadata, type TurnPart, type TurnStatus, type UsageEntry, type WebSearchBackend, type WebSearchBackendContext, type WebSearchRequest, type WebSearchResponse, type WebSearchResult, addStats, anthropic, braveWebSearch, chatCompletions, configureAxle, createAgentConfig, createAgentTool, createHandle, createStats, estimateContextUsage, gemini, generate, generateTurn, loadFileContent, mergeStats, openai, parallelize, parseResponse, stream };