agent() API Agent, runtime, context, skill, memory, MCP, and RLM APIs. typescript api api/agent build/apidocs api agent() API

agent() API

Agent, RLM runtime, context, memory, skill, MCP, and delegation APIs.

Most Used

agent

TypeScript function exported by @ax-llm/ax. See the call shape, arguments, and full reference below.

FieldValue
Kindfunction
Formagent
ReturnsAxAgent<ParseSignature<T>["inputs"], ParseSignature<T>["outputs"]>
Sourcesource

Call Shape

TypeScript
function agent<T, CF>(signature: T, config: Omit<AxAgentConfig<ParseSignature<T>["inputs"], ParseSignature<T>["outputs"]>, "contextFields"> & object): AxAgent<ParseSignature<T>["inputs"], ParseSignature<T>["outputs"]>;
TypeScript
function agent<TInput, TOutput, CF>(signature: AxSignature<TInput, TOutput>, config: Omit<AxAgentConfig<TInput, TOutput>, "contextFields"> & object): AxAgent<TInput, TOutput>;
TypeScript
function agent(signature: Readonly<AxSignatureConfig>, config: AxAgentConfig<AxGenIn, AxGenOut>): AxAgent<AxGenIn, AxGenOut>;

Arguments And Options

NameTypeDescription
signatureT
configOmit<AxAgentConfig<ParseSignature<T>["inputs"], ParseSignature<T>["outputs"]>, "contextFields"> & object

Full reference

AxAgent

Pipeline-based coordinator. Every run walks the same static sequence:

FieldValue
Kindclass
FormAxAgent
Sourcesource

Call Shape

TypeScript
new AxAgent<IN, OUT>(init: Readonly<{
  agentIdentity?: Readonly<AxAgentIdentity>;
  agentModuleNamespace?: string;
  ai?: Readonly<AxAIService>;
  judgeAI?: Readonly<AxAIService>;
  signature:   | string
     | Readonly<AxSignatureConfig>
     | Readonly<AxSignature<IN, OUT>>;
}>, options: Readonly<AxAgentOptions<IN>>): AxAgent<IN, OUT>;

Full reference

AxAgentFunctionGroup

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionGroup
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionGroup = AxAgentFunctionModuleMeta & object;

Full reference

AxAgentOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOptions
Sourcesource

Call Shape

TypeScript
type AxAgentOptions<IN> = Omit<AxProgramForwardOptions<string>, "functions" | "description" | "onFunctionCall"> & object;

Full reference

Advanced / internals / full reference

AxAgentActorTurnCallback

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentActorTurnCallback
Returnsvoid \| Promise<void>
Sourcesource

Call Shape

TypeScript
type AxAgentActorTurnCallback = (args: AxAgentActorTurnCallbackArgs) => void | Promise<void>;

Arguments And Options

NameTypeDescription
argsAxAgentActorTurnCallbackArgs

Full reference

AxAgentActorTurnCallbackArgs

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentActorTurnCallbackArgs
Sourcesource

Call Shape

TypeScript
type AxAgentActorTurnCallbackArgs = object;

Full reference

AxAgentAutoPromotionRecord

One auto-upgrade context promotion, pending field_auto_promoted emission.

FieldValue
Kindtypealias
FormAxAgentAutoPromotionRecord
Sourcesource

Call Shape

TypeScript
type AxAgentAutoPromotionRecord = object;

Full reference

AxAgentAutoUpgrade

Smart-defaults knob: true/false toggles both upgrades; an object tunes each independently (an object value implies enabled for that domain).

FieldValue
Kindtypealias
FormAxAgentAutoUpgrade
Sourcesource

Call Shape

TypeScript
type AxAgentAutoUpgrade = 
  | boolean
  | {
  contextFields?:   | boolean
     | {
     previewChars?: number;
     promoteAboveChars?: number;
   };
  functionDiscovery?:   | boolean
     | {
     aboveFunctionDocChars?: number;
   };
};

Full reference

AxAgentCatalogSkill

A skill in a host-provided static catalog (skillsCatalog option). Unlike skills (which preloads full content into the prompt), a catalog entry is only loaded when matched — by the built-in local search that backs discover({ skills }) when no onSkillsSearch callback is provided, and by the advisory relevance hint.

FieldValue
Kindtypealias
FormAxAgentCatalogSkill
Sourcesource

Call Shape

TypeScript
type AxAgentCatalogSkill = object;

Full reference

AxAgentCitations

Chain-of-evidence citations knob: when enabled, the responder gains an optional string-array output field whose entries must be evidence ids the answer actually relies on — the top-level keys of the final(task, evidence) / respond(task, evidence) evidence object, plus (by default) the id of any id-bearing records one level deep inside it, e.g. loaded memories. Citations are validated subset-only against those ids; a violation re-prompts the responder through the standard validation-retry loop. Runs without evidence skip validation entirely.

FieldValue
Kindtypealias
FormAxAgentCitations
Sourcesource

Call Shape

TypeScript
type AxAgentCitations = 
  | boolean
  | {
  field?: string;
  includeMemoryIds?: boolean;
  onCitations?: (citations: readonly string[]) => void | Promise<void>;
  surface?: "output" | "hidden";
};

Full reference

AxAgentCitationsOutput

Convenience result intersection for reading citations off a forward result.

FieldValue
Kindtypealias
FormAxAgentCitationsOutput
Sourcesource

Call Shape

TypeScript
type AxAgentCitationsOutput = object;

Full reference

AxAgentClarification

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentClarification
Sourcesource

Call Shape

TypeScript
type AxAgentClarification = 
  | string
  | AxAgentStructuredClarification;

Full reference

AxAgentClarificationChoice

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentClarificationChoice
Sourcesource

Call Shape

TypeScript
type AxAgentClarificationChoice = 
  | string
  | {
  label: string;
  value?: string;
};

Full reference

AxAgentClarificationError

TypeScript class exported by @ax-llm/ax. See the constructor, methods, and full reference below.

FieldValue
Kindclass
FormAxAgentClarificationError
Sourcesource

Call Shape

TypeScript
new AxAgentClarificationError(clarification: AxAgentClarification, options?: Readonly<{
  state?: AxAgentState;
  stateError?: string;
}>): AxAgentClarificationError;

Full reference

AxAgentClarificationKind

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentClarificationKind
Sourcesource

Call Shape

TypeScript
type AxAgentClarificationKind = "text" | "number" | "date" | "single_choice" | "multiple_choice";

Full reference

AxAgentCompletionProtocol

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentCompletionProtocol
Sourcesource

Call Shape

TypeScript
type AxAgentCompletionProtocol = Readonly<{
  askClarification: (...args: unknown[]) => never;
  failed: (message: string) => Promise<void>;
  final: (...args: unknown[]) => never;
  guideAgent: (guidance: string) => never;
  success: (message: string) => Promise<void>;
}>;

Full reference

AxAgentConfig

TypeScript interface exported by @ax-llm/ax. See the fields and full reference below.

FieldValue
Kindinterface
FormAxAgentConfig
Sourcesource

Full reference

AxAgentContextEvent

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextEvent
Sourcesource

Call Shape

TypeScript
type AxAgentContextEvent = 
  | {
  actionLogEntryCount: number;
  checkpointActive: boolean;
  effectiveBudgetChars: number;
  fixedPromptChars: number;
  guidanceLogEntryCount: number;
  kind: "budget_check";
  mutablePromptChars: number;
  pressure: AxAgentContextPressure;
  stage: AxAgentContextStage;
  targetPromptChars: number;
  turn: number;
}
  | {
  coveredTurns: number[];
  kind: "checkpoint_created" | "checkpoint_cleared";
  reason: "over_budget" | "under_budget" | "disabled";
  stage: AxAgentContextStage;
  summaryChars?: number;
  turn: number;
}
  | {
  kind: "tombstone_created";
  resolvedByTurn: number;
  source: "deterministic" | "model";
  stage: AxAgentContextStage;
  summaryChars: number;
  turn: number;
}
  | {
  kind: "action_compacted";
  mode: "distill" | "compact";
  originalChars: number;
  reason: "structured_output" | "superseded" | "pressure" | "proactive" | "lean";
  renderedChars: number;
  stage: AxAgentContextStage;
  turn: number;
}
  | {
  domain: "modules" | "skills" | "memories";
  kind: "relevance_ranking";
  shortlist: object[];
  stage: AxAgentContextStage;
  suppressed: boolean;
  taskChars: number;
}
  | {
  fieldName: string;
  kind: "field_auto_promoted";
  originalChars: number;
  promptPreviewChars?: number;
  stage: AxAgentContextStage;
  turn: number;
};

Full reference

AxAgentContextMap

TypeScript class exported by @ax-llm/ax. See the constructor, methods, and full reference below.

FieldValue
Kindclass
FormAxAgentContextMap
Sourcesource

Call Shape

TypeScript
new AxAgentContextMap(input?: 
  | string
  | AxAgentContextMapSnapshot, options?: AxAgentContextMapOptions): AxAgentContextMap;

Full reference

AxAgentContextMapConfig

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextMapConfig
Sourcesource

Call Shape

TypeScript
type AxAgentContextMapConfig = object;

Full reference

AxAgentContextMapOperation

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextMapOperation
Sourcesource

Call Shape

TypeScript
type AxAgentContextMapOperation = 
  | {
  content: string;
  section: string;
  type: "ADD";
}
  | {
  itemId: string;
  type: "DELETE";
}
  | {
  content: string;
  itemId: string;
  type: "REPLACE";
};

Full reference

AxAgentContextMapOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextMapOptions
Sourcesource

Call Shape

TypeScript
type AxAgentContextMapOptions = object;

Full reference

AxAgentContextMapSnapshot

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextMapSnapshot
Sourcesource

Call Shape

TypeScript
type AxAgentContextMapSnapshot = object;

Full reference

AxAgentContextMapUpdateResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextMapUpdateResult
Sourcesource

Call Shape

TypeScript
type AxAgentContextMapUpdateResult = object;

Full reference

AxAgentContextPressure

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextPressure
Sourcesource

Call Shape

TypeScript
type AxAgentContextPressure = "ok" | "watch" | "critical";

Full reference

AxAgentContextStage

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentContextStage
Sourcesource

Call Shape

TypeScript
type AxAgentContextStage = "distiller" | "executor";

Full reference

AxAgentDemos

Demo traces for AxAgent’s split architecture. Actor demos use the runtime code field (javascriptCode for JavaScript, <language>Code for other runtimes such as pythonCode). Responder demos use the agent’s output type + optional input fields.

FieldValue
Kindtypealias
FormAxAgentDemos
Sourcesource

Call Shape

TypeScript
type AxAgentDemos<IN, OUT, PREFIX> = 
  | {
  programId: `${PREFIX}.actor`;
  traces: Record<string, AxFieldValue>[];
}
  | {
  programId: `${PREFIX}.responder`;
  traces: OUT & Partial<IN>[];
};

Full reference

AxAgentDirectResponse

Direct-respond knob: lets the distiller end the run with respond(task, evidence) and skip the executor stage entirely (zero executor model calls) when the task needs no user-provided functions.

FieldValue
Kindtypealias
FormAxAgentDirectResponse
Sourcesource

Call Shape

TypeScript
type AxAgentDirectResponse = "auto" | "off";

Full reference

AxAgentDiscoveryPromptState

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentDiscoveryPromptState
Sourcesource

Call Shape

TypeScript
type AxAgentDiscoveryPromptState = object;

Full reference

AxAgentEvalBatchResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentEvalBatchResult
Sourcesource

Call Shape

TypeScript
type AxAgentEvalBatchResult<IN, OUT> = object;

Full reference

AxAgentEvalBudget

Mutable (run + judge) pair budget shared across all improve() batches.

FieldValue
Kindtypealias
FormAxAgentEvalBudget
Sourcesource

Call Shape

TypeScript
type AxAgentEvalBudget = object;

Full reference

AxAgentEvalDataset

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentEvalDataset
Sourcesource

Call Shape

TypeScript
type AxAgentEvalDataset<IN> = 
  | readonly AxAgentEvalTask<IN>[]
  | {
  train: readonly AxAgentEvalTask<IN>[];
  validation?: readonly AxAgentEvalTask<IN>[];
};

Full reference

AxAgentEvalFunctionCall

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentEvalFunctionCall
Sourcesource

Call Shape

TypeScript
type AxAgentEvalFunctionCall = object;

Full reference

AxAgentEvalPrediction

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentEvalPrediction
Sourcesource

Call Shape

TypeScript
type AxAgentEvalPrediction<OUT> = 
  | AxAgentEvalPredictionShared & object
  | AxAgentEvalPredictionShared & object;

Full reference

AxAgentEvalTask

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentEvalTask
Sourcesource

Call Shape

TypeScript
type AxAgentEvalTask<IN> = object;

Full reference

AxAgentExecutorResultPayload

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentExecutorResultPayload
Sourcesource

Call Shape

TypeScript
type AxAgentExecutorResultPayload = AxAgentTestCompletionPayload;

Full reference

AxAgentFailureCluster

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFailureCluster
Sourcesource

Call Shape

TypeScript
type AxAgentFailureCluster = object;

Full reference

AxAgentFailureReport

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFailureReport
Sourcesource

Call Shape

TypeScript
type AxAgentFailureReport = object;

Full reference

AxAgentFailureSignal

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFailureSignal
Sourcesource

Call Shape

TypeScript
type AxAgentFailureSignal = object;

Full reference

AxAgentFailureSignalKind

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFailureSignalKind
Sourcesource

Call Shape

TypeScript
type AxAgentFailureSignalKind = "error_turn" | "resolved_error" | "dead_end" | "tool_error";

Full reference

AxAgentForwardOptions

Forward options for AxAgent.forward(...). Extends the dsp-layer AxProgramForwardOptionsWithModels with agent-specific knobs that only make sense at the agent boundary (currently skills for one-shot preloading). Forward-time skills merge on top of init-time skills (forward overrides by id).

FieldValue
Kindtypealias
FormAxAgentForwardOptions
Sourcesource

Call Shape

TypeScript
type AxAgentForwardOptions<T> = AxProgramForwardOptionsWithModels<T> & object;

Full reference

AxAgentFunction

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunction
Sourcesource

Call Shape

TypeScript
type AxAgentFunction = Omit<AxFunction, "description"> & object;

Full reference

AxAgentFunctionCall

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionCall
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionCall = object;

Full reference

AxAgentFunctionCallRecorder

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionCallRecorder
Returnsvoid
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionCallRecorder = (call: AxAgentEvalFunctionCall) => void;

Arguments And Options

NameTypeDescription
callAxAgentEvalFunctionCall

Full reference

AxAgentFunctionCollection

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionCollection
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionCollection = 
  | readonly (
  | AxAgentFunction
  | AxAnyAgentic
  | AxFunctionProvider)[]
  | readonly AxAgentFunctionGroup[];

Full reference

AxAgentFunctionExample

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionExample
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionExample = object;

Full reference

AxAgentFunctionModuleMeta

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentFunctionModuleMeta
Sourcesource

Call Shape

TypeScript
type AxAgentFunctionModuleMeta = object;

Full reference

AxAgentGuidanceLogEntry

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentGuidanceLogEntry
Sourcesource

Call Shape

TypeScript
type AxAgentGuidanceLogEntry = object;

Full reference

AxAgentGuidancePayload

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentGuidancePayload
Sourcesource

Call Shape

TypeScript
type AxAgentGuidancePayload = object;

Full reference

AxAgentGuidanceState

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentGuidanceState
Sourcesource

Call Shape

TypeScript
type AxAgentGuidanceState = object;

Full reference

AxAgentic

Interface for agents that can be used as child agents. Provides methods to get the agent’s function definition and features.

FieldValue
Kindinterface
FormAxAgentic
Sourcesource

Call Shape

TypeScript
applyOptimization(optimizedProgram: AxOptimizedProgram<OUT>): void;

Full reference

AxAgentIdentity

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentIdentity
Sourcesource

Call Shape

TypeScript
type AxAgentIdentity = object;

Full reference

AxAgentInputUpdateCallback

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentInputUpdateCallback
Returns\| Promise<Partial<IN> \| undefined> \| Partial<IN> \| undefined
Sourcesource

Call Shape

TypeScript
type AxAgentInputUpdateCallback<IN> = (currentInputs: Readonly<IN>) => 
  | Promise<Partial<IN> | undefined>
  | Partial<IN>
  | undefined;

Arguments And Options

NameTypeDescription
currentInputsReadonly<IN>

Full reference

AxAgentJudgeEvalInput

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentJudgeEvalInput
Sourcesource

Call Shape

TypeScript
type AxAgentJudgeEvalInput = AxAgentJudgeInput & AxAgentJudgeOutput;

Full reference

AxAgentJudgeEvalOutput

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentJudgeEvalOutput
Sourcesource

Call Shape

TypeScript
type AxAgentJudgeEvalOutput = object;

Full reference

AxAgentJudgeInput

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentJudgeInput
Sourcesource

Call Shape

TypeScript
type AxAgentJudgeInput = object;

Full reference

AxAgentJudgeOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentJudgeOptions
Sourcesource

Call Shape

TypeScript
type AxAgentJudgeOptions = Partial<Omit<AxJudgeOptions, "ai">>;

Full reference

AxAgentJudgeOutput

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentJudgeOutput
Sourcesource

Call Shape

TypeScript
type AxAgentJudgeOutput = object;

Full reference

AxAgentMemoriesSearchFn

Memories search callback. Receives the raw search strings and the snapshot of inputs.memories already loaded for the current run (deduped by id, sorted). Use the second argument to skip work for entries that are already in scope — for example, filter your vector search by id NOT IN alreadyLoaded so you don’t re-fetch and the actor doesn’t pay tokens for duplicates. Returning already-loaded entries is still safe (the runtime dedupes by id) but wastes work.

FieldValue
Kindtypealias
FormAxAgentMemoriesSearchFn
Returns\| readonly AxAgentMemoryResult[] \| Promise<readonly AxAgentMemoryResult[]>
Sourcesource

Call Shape

TypeScript
type AxAgentMemoriesSearchFn = (searches: readonly string[], alreadyLoaded: readonly AxAgentMemoryResult[]) => 
  | readonly AxAgentMemoryResult[]
| Promise<readonly AxAgentMemoryResult[]>;

Arguments And Options

NameTypeDescription
searchesreadonly string[]
alreadyLoadedreadonly AxAgentMemoryResult[]

Full reference

AxAgentMemoryEntry

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentMemoryEntry
Sourcesource

Call Shape

TypeScript
type AxAgentMemoryEntry = object;

Full reference

AxAgentMemoryResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentMemoryResult
Sourcesource

Call Shape

TypeScript
type AxAgentMemoryResult = object;

Full reference

AxAgentOnContextEvent

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOnContextEvent
Returnsvoid \| Promise<void>
Sourcesource

Call Shape

TypeScript
type AxAgentOnContextEvent = (event: Readonly<AxAgentContextEvent>) => void | Promise<void>;

Arguments And Options

NameTypeDescription
eventReadonly<AxAgentContextEvent>

Full reference

AxAgentOnFunctionCall

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOnFunctionCall
Returnsvoid \| Promise<void>
Sourcesource

Call Shape

TypeScript
type AxAgentOnFunctionCall = (call: Readonly<AxAgentFunctionCall>) => void | Promise<void>;

Arguments And Options

NameTypeDescription
callReadonly<AxAgentFunctionCall>

Full reference

AxAgentOptimizationTargetDescriptor

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOptimizationTargetDescriptor
Sourcesource

Call Shape

TypeScript
type AxAgentOptimizationTargetDescriptor = object;

Full reference

AxAgentOptimizeOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOptimizeOptions
Sourcesource

Call Shape

TypeScript
type AxAgentOptimizeOptions<_IN, _OUT> = object & Pick<AxOptimizerArgs, 
  | "numTrials"
  | "minibatch"
  | "minibatchSize"
  | "earlyStoppingTrials"
  | "minImprovementThreshold"
  | "sampleCount"
| "seed">;

Full reference

AxAgentOptimizeResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOptimizeResult
Sourcesource

Call Shape

TypeScript
type AxAgentOptimizeResult<OUT> = AxParetoResult<OUT>;

Full reference

AxAgentOptimizeTarget

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentOptimizeTarget
Sourcesource

Call Shape

TypeScript
type AxAgentOptimizeTarget = "actor" | "responder" | "all" | readonly string[];

Full reference

AxAgentPlaybook

TypeScript class exported by @ax-llm/ax. See the constructor, methods, and full reference below.

FieldValue
Kindclass
FormAxAgentPlaybook
Sourcesource

Call Shape

TypeScript
new AxAgentPlaybook<IN, OUT>(agent: unknown, handle: AxPlaybook<IN, OUT>): AxAgentPlaybook<IN, OUT>;

Full reference

AxAgentPlaybookConfig

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookConfig
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookConfig = object & Pick<AxPlaybookOptions, 
  | "maxReflectorRounds"
  | "maxSectionSize"
  | "allowDynamicSections"
  | "seed"
| "verbose">;

Full reference

AxAgentPlaybookEvolveOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveOptions
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveOptions = object;

Full reference

AxAgentPlaybookEvolveOutcome

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveOutcome
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveOutcome = object;

Full reference

AxAgentPlaybookEvolveProgressEvent

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveProgressEvent
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveProgressEvent = object;

Full reference

AxAgentPlaybookEvolveProposal

A bounded proposal: one curated playbook update per mined weakness.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveProposal
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveProposal = object;

Full reference

AxAgentPlaybookEvolveResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveResult
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveResult<OUT> = object;

Full reference

AxAgentPlaybookEvolveRunRecord

One executed (task, prediction, score) triple from the batch harness.

FieldValue
Kindtypealias
FormAxAgentPlaybookEvolveRunRecord
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookEvolveRunRecord<IN, OUT> = object;

Full reference

AxAgentPlaybookLearnOptions

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookLearnOptions
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookLearnOptions = object;

Full reference

AxAgentPlaybookOptions

Options for AxAgent.playbook(). Builds an AxPlaybook bound to an agent stage (the actor by default). The evolution engine (ACE) is hidden, exactly as in the standalone playbook() factory.

FieldValue
Kindtypealias
FormAxAgentPlaybookOptions
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookOptions = object & Pick<AxPlaybookOptions, 
  | "verbose"
  | "seed"
  | "maxEpochs"
  | "maxReflectorRounds"
  | "maxSectionSize"
  | "allowDynamicSections"
  | "initialPlaybook"
| "auto">;

Full reference

AxAgentPlaybookSkipReason

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookSkipReason
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookSkipReason = 
  | "learning_disabled"
  | "no_failures"
  | "below_min_signals"
  | "all_duplicates";

Full reference

AxAgentPlaybookUpdateResult

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookUpdateResult
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookUpdateResult = object;

Full reference

AxAgentPlaybookUpdateStatus

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentPlaybookUpdateStatus
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookUpdateStatus = "updated" | "unchanged" | "skipped";

Full reference

AxAgentPlaybookWeakness

A verifier-grounded weakness mined from one failure cluster.

FieldValue
Kindtypealias
FormAxAgentPlaybookWeakness
Sourcesource

Call Shape

TypeScript
type AxAgentPlaybookWeakness = object;

Full reference

AxAgentProtocolCompletionSignal

TypeScript class exported by @ax-llm/ax. See the constructor, methods, and full reference below.

FieldValue
Kindclass
FormAxAgentProtocolCompletionSignal
Sourcesource

Call Shape

TypeScript
new AxAgentProtocolCompletionSignal(type: "final" | "guide_agent" | "askClarification" | "respond"): AxAgentProtocolCompletionSignal;

Full reference

AxAgentRecursionOptions

Forward options forwarded to the AxGen spawned by each llmQuery(...) call.

FieldValue
Kindtypealias
FormAxAgentRecursionOptions
Sourcesource

Call Shape

TypeScript
type AxAgentRecursionOptions = Partial<Omit<AxProgramForwardOptions<string>, "functions">>;

Full reference

AxAgentRecursiveExpensiveNode

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveExpensiveNode
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveExpensiveNode = object;

Full reference

AxAgentRecursiveFunctionCall

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveFunctionCall
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveFunctionCall = object;

Full reference

AxAgentRecursiveNodeRole

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveNodeRole
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveNodeRole = "root" | "recursive" | "terminal";

Full reference

AxAgentRecursiveStats

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveStats
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveStats = object;

Full reference

AxAgentRecursiveTargetId

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveTargetId
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveTargetId = 
  | "root.actor.shared"
  | "root.actor.root"
  | "root.actor.recursive"
  | "root.actor.terminal"
  | "root.responder";

Full reference

AxAgentRecursiveTraceNode

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveTraceNode
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveTraceNode = object;

Full reference

AxAgentRecursiveTurn

TypeScript typealias exported by @ax-llm/ax. See the full reference for complete details.

FieldValue
Kindtypealias
FormAxAgentRecursiveTurn
Sourcesource

Call Shape

TypeScript
type AxAgentRecursiveTurn = object;

Full reference

Full Reference

Open the full TypeScript reference. This page highlights the agent symbols most relevant to everyday use.

Docs