AxACE

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L314

AxACE implements the Agentic Context Engineering loop (Generator → Reflector → Curator). The implementation mirrors the paper’s architecture while integrating with the Ax optimizer ergonomics (unified optimized program artifacts, metrics, and checkpointing).

Extends

• AxBaseOptimizer

Constructors

Constructor

new AxACE(args: Readonly<AxOptimizerArgs>, options?: Readonly<AxACEOptions>): AxACE;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L329

Parameters

Returns

AxACE

Overrides

AxBaseOptimizer.constructor

Methods

applyCurrentState()

applyCurrentState<IN, OUT>(program?: AxGen<IN, OUT>): void;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L399

Type Parameters

Parameters

Returns

void

applyOnlineUpdate()

applyOnlineUpdate(args: Readonly<{
  example: AxExample;
  feedback?: string;
  prediction: unknown;
}>): Promise<undefined | AxACECuratorOutput>;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L682

Apply ACE updates after each online inference. Mirrors the online adaptation flow described in the paper; can be called by user-land code between queries.

Parameters

Returns

Promise<undefined | AxACECuratorOutput>

compile()

compile<IN, OUT>(
   program: Readonly<AxGen<IN, OUT>>, 
   examples: readonly AxTypedExample<IN>[], 
   metricFn: AxMetricFn, 
options?: AxACECompileOptions): Promise<AxACEResult<OUT>>;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L431

Abstract method that must be implemented by concrete optimizers

Type Parameters

Parameters

Returns

Promise<AxACEResult<OUT>>

Overrides

AxBaseOptimizer.compile

compilePareto()

compilePareto<IN, OUT>(
   program: Readonly<AxGen<IN, OUT>>, 
   examples: readonly AxTypedExample<IN>[], 
   metricFn: AxMultiMetricFn, 
options?: AxCompileOptions): Promise<AxParetoResult<OUT>>;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizer.ts#L1688

Multi-objective optimization using Pareto frontier Default implementation that leverages the single-objective compile method

Type Parameters

Parameters

Returns

Promise<AxParetoResult<OUT>>

Pareto optimization result with frontier of non-dominated solutions

Inherited from

AxBaseOptimizer.compilePareto

compileStream()

compileStream<IN, OUT>(
   program: Readonly<AxGen<IN, OUT>>, 
   examples: readonly AxTypedExample<IN>[], 
   metricFn: AxMetricFn, 
options?: AxCompileOptions): AsyncIterableIterator<AxOptimizationProgress>;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizer.ts#L1574

Optimize a program with real-time streaming updates

Type Parameters

Parameters

Returns

AsyncIterableIterator<AxOptimizationProgress>

Async iterator yielding optimization progress

Inherited from

AxBaseOptimizer.compileStream

configureAuto()

configureAuto(level: "medium" | "light" | "heavy"): void;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L414

Parameters

Returns

void

getArtifact()

getArtifact(): AxACEOptimizationArtifact;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L395

Returns

AxACEOptimizationArtifact

getBaseInstruction()

getBaseInstruction(): undefined | string;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L391

Returns

undefined | string

getPlaybook()

getPlaybook(): AxACEPlaybook;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L387

Returns

AxACEPlaybook

getStats()

getStats(): AxOptimizationStats;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizer.ts#L2685

Get current optimization statistics

Returns

AxOptimizationStats

Current optimization statistics

Inherited from

AxBaseOptimizer.getStats

hydrate()

hydrate<IN, OUT>(program: Readonly<AxGen<IN, OUT>>, state?: Readonly<{
  artifact?: Partial<AxACEOptimizationArtifact>;
  baseInstruction?: string;
  playbook?: AxACEPlaybook;
}>): void;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L364

Type Parameters

Parameters

Returns

void

reset()

reset(): void;

Defined in: https://github.com/ax-llm/ax/blob/3306475085414d36aee4411ad2466e08e53bef8a/src/ax/dsp/optimizers/ace.ts#L353

Reset optimizer state for reuse with different programs

Returns

void

Overrides

AxBaseOptimizer.reset