@ax-llm/ax 23.0.0 → 23.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.cts CHANGED
@@ -5200,6 +5200,87 @@ type AxResolvedAutoUpgrade = {
5200
5200
  * respond payload reaching the pipeline is rejected.
5201
5201
  */
5202
5202
  type AxAgentDirectResponse = 'auto' | 'off';
5203
+ /**
5204
+ * Chain-of-evidence citations knob: when enabled, the responder gains an
5205
+ * optional string-array output field whose entries must be evidence ids the
5206
+ * answer actually relies on — the top-level keys of the `final(task,
5207
+ * evidence)` / `respond(task, evidence)` evidence object, plus (by default)
5208
+ * the `id` of any id-bearing records one level deep inside it, e.g. loaded
5209
+ * memories. Citations are validated subset-only against those ids; a
5210
+ * violation re-prompts the responder through the standard validation-retry
5211
+ * loop. Runs without evidence skip validation entirely.
5212
+ */
5213
+ type AxAgentCitations = boolean | {
5214
+ /** Responder output field name. Default 'evidenceCitations'. */
5215
+ field?: string;
5216
+ /**
5217
+ * Where validated citations land. `'output'` (default) keeps the field
5218
+ * on the returned result; `'hidden'` strips it after validation so the
5219
+ * result matches the user signature exactly — read citations via
5220
+ * `onCitations`.
5221
+ */
5222
+ surface?: 'output' | 'hidden';
5223
+ /**
5224
+ * Also accept `id` values of record arrays one level deep in the
5225
+ * evidence object (the shape `recall(...)` memories arrive in).
5226
+ * Default true.
5227
+ */
5228
+ includeMemoryIds?: boolean;
5229
+ /** Observer for validated citations; failures are swallowed. */
5230
+ onCitations?: (citations: readonly string[]) => void | Promise<void>;
5231
+ };
5232
+ /** Convenience result intersection for reading citations off a forward result. */
5233
+ type AxAgentCitationsOutput = {
5234
+ evidenceCitations?: string[];
5235
+ };
5236
+ type AxResolvedCitations = {
5237
+ enabled: boolean;
5238
+ field: string;
5239
+ surface: 'output' | 'hidden';
5240
+ includeMemoryIds: boolean;
5241
+ onCitations?: (citations: readonly string[]) => void | Promise<void>;
5242
+ };
5243
+
5244
+ /**
5245
+ * Deterministic failure harvesting for the AxAgent RLM loop.
5246
+ *
5247
+ * Builds a structured report of failure signals from the live action-log
5248
+ * entries at the end of a stage run — while the internal per-turn metadata
5249
+ * (`_functionCalls`) is still present — so run-end consumers (playbook
5250
+ * learning) never need the internal fields to survive state serialization.
5251
+ * Zero LLM calls; every heuristic here is pure and synchronous.
5252
+ */
5253
+
5254
+ type AxAgentFailureSignalKind =
5255
+ /** A turn errored and was neither resolved nor a repeat of the prior turn. */
5256
+ 'error_turn'
5257
+ /** A turn errored, a later turn succeeded, and the signature never recurred. */
5258
+ | 'resolved_error'
5259
+ /** A turn repeated the previous turn's failure (same error signature). */
5260
+ | 'dead_end'
5261
+ /** A registered tool/function call returned an error during a turn. */
5262
+ | 'tool_error';
5263
+ type AxAgentFailureSignal = {
5264
+ kind: AxAgentFailureSignalKind;
5265
+ /** Turn the failing action ran in. */
5266
+ turn: number;
5267
+ /** Normalized fingerprint (`extractErrorSignature`) used for deduping. */
5268
+ signature: string;
5269
+ /** Human-readable failure line (error message / `tool: error`). */
5270
+ detail: string;
5271
+ /** `resolved_error` only: turn whose action resolved the failure. */
5272
+ resolvedByTurn?: number;
5273
+ /** Truncated offending actor code (or tool arguments digest). */
5274
+ code?: string;
5275
+ /** Number of merged occurrences of this (kind, signature) pair. */
5276
+ occurrences: number;
5277
+ };
5278
+ type AxAgentFailureReport = {
5279
+ stage: 'distiller' | 'executor';
5280
+ signals: readonly AxAgentFailureSignal[];
5281
+ };
5282
+ /** Playbook section that curated failure-avoidance rules land in. */
5283
+ declare const axPlaybookFailureSection = "failures_to_avoid";
5203
5284
 
5204
5285
  type AxJudgeForwardOptions = Omit<AxProgramForwardOptions<string>, 'functions' | 'description'>;
5205
5286
  interface AxJudgeOptions extends AxJudgeForwardOptions {
@@ -5336,6 +5417,12 @@ interface AxACEOptimizationArtifact {
5336
5417
  epoch: number;
5337
5418
  exampleIndex: number;
5338
5419
  operations: AxACECuratorOperation[];
5420
+ /**
5421
+ * Ids of the bullets this delta created or updated. ADD operations get
5422
+ * their ids assigned at apply time, so the operations alone cannot be
5423
+ * mapped back to surviving bullets — this field can.
5424
+ */
5425
+ updatedBulletIds?: string[];
5339
5426
  }[];
5340
5427
  }
5341
5428
 
@@ -5576,6 +5663,91 @@ declare class AxAgentContextMap {
5576
5663
  }>): Promise<AxAgentContextMapUpdateResult>;
5577
5664
  }
5578
5665
 
5666
+ /**
5667
+ * Construction-time playbook configuration for AxAgent.
5668
+ *
5669
+ * Mirrors the `contextMap` config precedent: attach an evolving
5670
+ * {@link AxPlaybook} to an agent at construction, keep it rendered into the
5671
+ * live stage prompt, and (by default) let the agent learn from its own
5672
+ * failures — a run-end hook harvests the run's failure signals and curates
5673
+ * durable avoidance rules into the playbook so later runs stop repeating
5674
+ * them. Persistence is caller-driven via `onUpdate`.
5675
+ */
5676
+
5677
+ type AxAgentPlaybookLearnOptions = {
5678
+ /**
5679
+ * Failure signals a run must produce before spending LLM calls on a
5680
+ * playbook update. Default 1.
5681
+ */
5682
+ minSignals?: number;
5683
+ /**
5684
+ * Skip signals whose signature was already curated into this playbook —
5685
+ * recorded on the snapshot artifact's update events, so the check is
5686
+ * deterministic and survives save/restore. Coverage lapses when every
5687
+ * bullet that update produced has since been pruned from the playbook, so
5688
+ * a lost lesson can be re-learned; an update the curator explicitly
5689
+ * answered with no operations stays covered. Default true.
5690
+ */
5691
+ dedupe?: boolean;
5692
+ };
5693
+ type AxAgentPlaybookUpdateStatus = 'updated' | 'unchanged' | 'skipped';
5694
+ type AxAgentPlaybookSkipReason = 'learning_disabled' | 'no_failures' | 'below_min_signals' | 'all_duplicates';
5695
+ type AxAgentPlaybookUpdateResult = {
5696
+ /** Snapshot of the playbook after this run (persist via `onUpdate`). */
5697
+ snapshot: AxPlaybookSnapshot;
5698
+ status: AxAgentPlaybookUpdateStatus;
5699
+ skipReason?: AxAgentPlaybookSkipReason;
5700
+ /** Failure signals this update was fed (fresh signals only when deduping). */
5701
+ signals: readonly AxAgentFailureSignal[];
5702
+ /** Digest text sent to the playbook curator. Absent on skips. */
5703
+ feedback?: string;
5704
+ };
5705
+ type AxAgentPlaybookConfig = {
5706
+ /**
5707
+ * Seed content: a persisted {@link AxPlaybookSnapshot} (from `onUpdate` /
5708
+ * `handle.getState()`) or a bare playbook object.
5709
+ */
5710
+ playbook?: AxPlaybookSnapshot | AxACEPlaybook;
5711
+ /** Stage whose live prompt receives the rendered playbook. Default 'actor'. */
5712
+ target?: 'actor' | 'responder';
5713
+ /** Render the playbook into the live stage prompt. Default true. */
5714
+ apply?: boolean;
5715
+ /**
5716
+ * Run-end failure learning — ON by default (the config block itself is the
5717
+ * opt-in). After each completed run that produced failure signals (error
5718
+ * turns, repeated dead-ends, tool errors), one bounded playbook update
5719
+ * (default: 1 reflector + 1 curator call) curates avoidance rules into the
5720
+ * `failures_to_avoid` section. Clean runs cost zero extra calls. Pass an
5721
+ * object to tune gating, or `false` for a render-only playbook.
5722
+ */
5723
+ learn?: boolean | AxAgentPlaybookLearnOptions;
5724
+ /**
5725
+ * Persistence hook — fires after a run-end update actually ran
5726
+ * (`status !== 'skipped'`). Failures in the hook are swallowed; playbook
5727
+ * upkeep never breaks the completed user-facing run.
5728
+ */
5729
+ onUpdate?: (result: AxAgentPlaybookUpdateResult) => void | Promise<void>;
5730
+ /** AI running reflection/curation. Defaults to the agent's `ai`. */
5731
+ studentAI?: Readonly<AxAIService>;
5732
+ /** Stronger model for reflection/curation. Defaults to the agent's `judgeAI`. */
5733
+ teacherAI?: Readonly<AxAIService>;
5734
+ } & Pick<AxPlaybookOptions, 'maxReflectorRounds' | 'maxSectionSize' | 'allowDynamicSections' | 'seed' | 'verbose'>;
5735
+ type AxResolvedAgentPlaybookLearn = {
5736
+ enabled: boolean;
5737
+ minSignals: number;
5738
+ dedupe: boolean;
5739
+ };
5740
+ type AxResolvedAgentPlaybookConfig = {
5741
+ seedPlaybook?: AxPlaybookSnapshot | AxACEPlaybook;
5742
+ target: 'actor' | 'responder';
5743
+ apply: boolean;
5744
+ learn: AxResolvedAgentPlaybookLearn;
5745
+ onUpdate?: (result: AxAgentPlaybookUpdateResult) => void | Promise<void>;
5746
+ studentAI?: Readonly<AxAIService>;
5747
+ teacherAI?: Readonly<AxAIService>;
5748
+ playbookOptions: Pick<AxPlaybookOptions, 'maxReflectorRounds' | 'maxSectionSize' | 'allowDynamicSections' | 'seed' | 'verbose'>;
5749
+ };
5750
+
5579
5751
  /**
5580
5752
  * Demo traces for AxAgent's split architecture.
5581
5753
  * Actor demos use the runtime code field (`javascriptCode` for JavaScript,
@@ -5605,6 +5777,12 @@ type AxAgentEvalPredictionShared = {
5605
5777
  toolErrors: string[];
5606
5778
  turnCount: number;
5607
5779
  usage?: AxProgramUsage[];
5780
+ /**
5781
+ * Deterministic failure signals harvested from the run's stages (merged
5782
+ * distiller + executor), when the run produced any. Structured input for
5783
+ * failure clustering in `agent.playbook().evolve()`.
5784
+ */
5785
+ failureSignals?: readonly AxAgentFailureSignal[];
5608
5786
  recursiveTrace?: AxAgentRecursiveTraceNode;
5609
5787
  recursiveStats?: AxAgentRecursiveStats;
5610
5788
  recursiveSummary?: string;
@@ -5681,6 +5859,41 @@ type AxAgentOptions<IN extends AxGenIn = AxGenIn> = Omit<AxProgramForwardOptions
5681
5859
  * updated snapshot.
5682
5860
  */
5683
5861
  contextMap?: AxAgentContextMapConfig;
5862
+ /**
5863
+ * Optional evolving playbook attached at construction. The rendered
5864
+ * playbook is injected into the chosen stage's live prompt (the actor by
5865
+ * default), and — unless `learn: false` — the agent learns from its own
5866
+ * failures: after each completed run that produced failure signals (error
5867
+ * turns, repeated dead-ends, tool errors), one bounded playbook update
5868
+ * (default 1 reflection + 1 curation call, zero on clean runs) curates
5869
+ * durable avoidance rules into a `failures_to_avoid` section so later runs
5870
+ * stop repeating them. Seed it with a persisted snapshot and use `onUpdate`
5871
+ * to persist new snapshots; read the live handle via `getPlaybook()`.
5872
+ * TS-first: the 5 non-TS ports do not ship the playbook option yet.
5873
+ */
5874
+ playbook?: AxAgentPlaybookConfig;
5875
+ /**
5876
+ * Chain-of-evidence citations — opt-in (default off). When enabled, the
5877
+ * responder gains an optional string-array output field (default
5878
+ * `evidenceCitations`) that must list the evidence ids the answer actually
5879
+ * relies on: the top-level keys of the `final(task, evidence)` /
5880
+ * `respond(task, evidence)` evidence object, plus the `id` of id-bearing
5881
+ * records inside it (e.g. loaded memories). Citations are validated
5882
+ * subset-only against those ids — a violation re-prompts the responder via
5883
+ * the standard validation-retry loop; runs without evidence skip
5884
+ * validation. Pass an object to rename the field, hide it from the result
5885
+ * (`surface: 'hidden'`), or observe citations via `onCitations`. Valid ids
5886
+ * are the evidence object's top-level keys plus (with `includeMemoryIds`,
5887
+ * default on) the `id` of records nested inside it — arrays of records,
5888
+ * keyed maps of records, or single records, with string or numeric ids. A
5889
+ * run whose evidence object is empty rejects any citation; a run with no
5890
+ * evidence object at all skips validation. The guarantee is existence, not
5891
+ * entailment: the model cannot cite evidence it never collected, but
5892
+ * validation does not check that the answer's claims match the cited
5893
+ * evidence's content. TS-first: the 5 non-TS ports do not ship citations
5894
+ * yet.
5895
+ */
5896
+ citations?: AxAgentCitations;
5684
5897
  /**
5685
5898
  * Tools registered under their configured namespace globals. May contain
5686
5899
  * `AxFunction` / `AxAgentFunction` entries, grouped function modules, or
@@ -6143,6 +6356,13 @@ interface AxSynthesizerInit {
6143
6356
  description: string;
6144
6357
  namespace?: string;
6145
6358
  };
6359
+ /**
6360
+ * Resolved chain-of-evidence citations config. When enabled, the caller has
6361
+ * already appended the citations output field to the signature; this class
6362
+ * validates the model's citations against the per-call evidence ids and
6363
+ * surfaces/strips the field per `surface`.
6364
+ */
6365
+ citations?: AxResolvedCitations;
6146
6366
  }
6147
6367
  interface AxSynthesizerOptions {
6148
6368
  /** Forward options merged onto every responder call (debug, model choice, etc.). */
@@ -6165,7 +6385,41 @@ declare class Synthesizer<OUT extends AxGenOut = AxGenOut> {
6165
6385
  private program;
6166
6386
  private templateOverride;
6167
6387
  private _stopRequested;
6388
+ /**
6389
+ * Evidence ids valid for the in-flight call; `undefined` disables the
6390
+ * citations assert (no evidence this call). Per-call mutable state on a
6391
+ * shared stage — same accepted non-reentrancy class as the agent's
6392
+ * discovery/skills prompt state.
6393
+ */
6394
+ private _validCitationKeys;
6168
6395
  constructor(init: Readonly<AxSynthesizerInit>, options?: Readonly<AxSynthesizerOptions>);
6396
+ /**
6397
+ * Registered once — the underlying AxGen instance survives description
6398
+ * rebuilds and signature swaps, so the assert stays attached. Violations
6399
+ * return a dynamic message enumerating the invalid and valid ids, which
6400
+ * drives the standard validation-retry loop.
6401
+ */
6402
+ private _registerCitationsAssert;
6403
+ /**
6404
+ * Ids the responder may cite this call: the evidence object's top-level
6405
+ * keys plus (when `includeMemoryIds`) the `id` of any records nested inside
6406
+ * it — arrays of records (the `recall()` memories shape), keyed maps of
6407
+ * records, or single records — with string OR numeric ids (DB keys are
6408
+ * commonly numeric). Returns `undefined` only when the payload carries no
6409
+ * evidence contract at all (absent / non-object / array); a plain object —
6410
+ * even empty `{}` — returns its (possibly empty) key set so the assert
6411
+ * rejects citations fabricated on an evidence-less run.
6412
+ */
6413
+ private _computeCitationKeys;
6414
+ /**
6415
+ * Collect every `id` (string or number, stringified) reachable within
6416
+ * `depth` levels of `node`, descending through arrays and plain objects.
6417
+ * Bounded so a deeply nested / cyclic evidence object can't spin.
6418
+ */
6419
+ private _collectNestedIds;
6420
+ private _normalizeCitations;
6421
+ /** Fire the observer and strip the field for `surface: 'hidden'`. */
6422
+ private _finalizeCitations;
6169
6423
  private _buildProgram;
6170
6424
  private _templateId;
6171
6425
  getRole(): AxSynthesizerRole;
@@ -6211,6 +6465,194 @@ declare class Synthesizer<OUT extends AxGenOut = AxGenOut> {
6211
6465
  }>): AxGenStreamingOut<OUT>;
6212
6466
  }
6213
6467
 
6468
+ /**
6469
+ * Public types for `agent.playbook().evolve(dataset, options)` — verified (or
6470
+ * trust-batch) playbook learning. The engine (batch eval → failure clustering
6471
+ * → grounded weakness mining → bounded playbook proposal → regression-gated
6472
+ * accept) is hidden behind the method, exactly as `optimize()` hides GEPA.
6473
+ * Verified learning produces only playbook bullets.
6474
+ */
6475
+
6476
+ /** One executed (task, prediction, score) triple from the batch harness. */
6477
+ type AxAgentPlaybookEvolveRunRecord<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut = AxGenOut> = {
6478
+ task: AxAgentEvalTask<IN>;
6479
+ /** Absent when the run threw before producing a prediction. */
6480
+ prediction?: AxAgentEvalPrediction<OUT>;
6481
+ score: number;
6482
+ /** `score >= scoreThreshold` and the run neither threw nor stalled. */
6483
+ passed: boolean;
6484
+ /** Message of a thrown (non-clarification) run error. */
6485
+ error?: string;
6486
+ };
6487
+ /** A verifier-grounded weakness mined from one failure cluster. */
6488
+ type AxAgentPlaybookWeakness = {
6489
+ id: string;
6490
+ /** Deterministic cluster fingerprint the weakness was mined from. */
6491
+ clusterSignature: string;
6492
+ description: string;
6493
+ rootCause: string;
6494
+ /** The avoidance rule/lesson the proposal carries into the playbook. */
6495
+ proposedGuidance: string;
6496
+ /**
6497
+ * Quotes from the actual failure excerpts that ground this weakness. Only
6498
+ * quotes that substring-match the real excerpts survive; a weakness with
6499
+ * zero surviving quotes is discarded.
6500
+ */
6501
+ evidenceQuotes: readonly string[];
6502
+ /** Tasks in the cluster (by id or index). */
6503
+ taskIds: readonly string[];
6504
+ /** Report-only configuration suggestions; never auto-applied. */
6505
+ configRecommendations: readonly string[];
6506
+ };
6507
+ /** A bounded proposal: one curated playbook update per mined weakness. */
6508
+ type AxAgentPlaybookEvolveProposal = {
6509
+ weaknessId: string;
6510
+ /** Cluster signature recorded on the update event (dedupe ledger). */
6511
+ clusterSignature: string;
6512
+ /** Digest handed to the playbook update (curator input). */
6513
+ feedback: string;
6514
+ };
6515
+ type AxAgentPlaybookEvolveOutcome = {
6516
+ proposal: AxAgentPlaybookEvolveProposal;
6517
+ accepted: boolean;
6518
+ reason: string;
6519
+ heldIn: {
6520
+ before: number;
6521
+ after: number;
6522
+ };
6523
+ heldOut?: {
6524
+ before: number;
6525
+ after: number;
6526
+ };
6527
+ };
6528
+ type AxAgentPlaybookEvolveProgressEvent = {
6529
+ phase: 'baseline' | 'mining' | 'proposal' | 'validation' | 'done';
6530
+ message: string;
6531
+ metricCallsUsed: number;
6532
+ };
6533
+ type AxAgentPlaybookEvolveOptions = {
6534
+ /**
6535
+ * Keep only proposals that provably help — re-score train + held-out after
6536
+ * each candidate bullet and accept only on a held-in gain without a
6537
+ * held-out regression, else roll it back. Default true. With `false`,
6538
+ * mined lessons are applied without the gate (fast trust-batch).
6539
+ */
6540
+ verify?: boolean;
6541
+ /** Runs the agent during evaluation. Defaults to the agent's `ai`. */
6542
+ studentAI?: Readonly<AxAIService>;
6543
+ /** Mines weaknesses. Defaults to `judgeAI`, then the student. */
6544
+ teacherAI?: Readonly<AxAIService>;
6545
+ /** Scores runs via the built-in judge. Resolution mirrors `optimize()`. */
6546
+ judgeAI?: Readonly<AxAIService>;
6547
+ judgeOptions?: AxAgentJudgeOptions;
6548
+ /** Optional deterministic scorer replacing the LLM judge. */
6549
+ metric?: AxMetricFn;
6550
+ /** Maximum weaknesses mined / proposals evaluated. Default 4. */
6551
+ maxProposals?: number;
6552
+ /**
6553
+ * Budget counting (agent run + judge) pairs across baseline and
6554
+ * re-evaluations. Default `max(100, (maxProposals + 1) * (train + validation)
6555
+ * * runsPerTask)`.
6556
+ */
6557
+ maxMetricCalls?: number;
6558
+ /**
6559
+ * Times each task runs per evaluation, with scores averaged. Default 1.
6560
+ * Use 2-3 when the dataset is small: accept/reject compares mean scores,
6561
+ * and on a handful of tasks a single lucky or unlucky run can otherwise
6562
+ * decide the gate. Each repeat spends budget.
6563
+ */
6564
+ runsPerTask?: number;
6565
+ /** Tolerated held-out drop when accepting a proposal (verify). Default 0.01. */
6566
+ epsilon?: number;
6567
+ /** Required held-in improvement to accept a proposal (verify). Default 0.05. */
6568
+ minHeldInGain?: number;
6569
+ /** Records scoring below this count as failures for mining. Default 0.7. */
6570
+ scoreThreshold?: number;
6571
+ /**
6572
+ * Keep accepted bullets on the live playbook (default). With `false`, the
6573
+ * playbook is rolled back at the end and the result's `playbookSnapshot`
6574
+ * carries the accepted state for a later `getPlaybook()?.load(...)`.
6575
+ */
6576
+ apply?: boolean;
6577
+ verbose?: boolean;
6578
+ onProgress?: (event: Readonly<AxAgentPlaybookEvolveProgressEvent>) => void;
6579
+ abortSignal?: AbortSignal;
6580
+ };
6581
+ type AxAgentPlaybookEvolveResult<OUT extends AxGenOut = AxGenOut> = {
6582
+ baseline: {
6583
+ heldIn: number;
6584
+ heldOut?: number;
6585
+ };
6586
+ final: {
6587
+ heldIn: number;
6588
+ heldOut?: number;
6589
+ };
6590
+ weaknesses: readonly AxAgentPlaybookWeakness[];
6591
+ outcomes: readonly AxAgentPlaybookEvolveOutcome[];
6592
+ /** Config suggestions collected from mined weaknesses; never auto-applied. */
6593
+ recommendations: readonly string[];
6594
+ /** Playbook state after the accepted bullets. */
6595
+ playbookSnapshot?: AxPlaybookSnapshot;
6596
+ metricCallsUsed: number;
6597
+ /** The baseline corpus (post-run records with scores). */
6598
+ records: readonly AxAgentPlaybookEvolveRunRecord<any, OUT>[];
6599
+ };
6600
+
6601
+ /**
6602
+ * `AxAgentPlaybook` — the agent-facing playbook handle returned by
6603
+ * `agent.playbook()` / `agent.getPlaybook()`.
6604
+ *
6605
+ * It is one thing (the agent's learned playbook) that grows three ways:
6606
+ * - continuously, from each run (the `playbook` construction config);
6607
+ * - on demand from one interaction, via {@link update} (trust);
6608
+ * - from a task set, via {@link evolve} (verified by default, or trust-batch).
6609
+ *
6610
+ * The generic program-level `AxPlaybook` (from the `playbook(program, …)`
6611
+ * factory) is unchanged; this wraps one bound to an agent stage and adds the
6612
+ * agent-level `evolve(dataset, options)`. The shared handle methods delegate
6613
+ * to the inner `AxPlaybook`.
6614
+ */
6615
+
6616
+ declare class AxAgentPlaybook<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut = AxGenOut> {
6617
+ /** The owning agent coordinator (used by `evolve`). */
6618
+ private readonly agent;
6619
+ /** The inner stage-bound playbook the handle methods delegate to. */
6620
+ private readonly handle;
6621
+ constructor(
6622
+ /** The owning agent coordinator (used by `evolve`). */
6623
+ agent: unknown,
6624
+ /** The inner stage-bound playbook the handle methods delegate to. */
6625
+ handle: AxPlaybook<IN, OUT>);
6626
+ /**
6627
+ * Grow the playbook from a task set. `verify` (default) keeps only bullets
6628
+ * that provably help — re-scoring train + held-out after each candidate and
6629
+ * rolling back regressions. `verify: false` applies mined lessons without
6630
+ * the gate (trust-batch). Produces only playbook bullets. Must not run
6631
+ * concurrently with `forward()` on the same agent instance.
6632
+ */
6633
+ evolve(dataset: Readonly<AxAgentEvalDataset<IN>>, options?: Readonly<AxAgentPlaybookEvolveOptions>): Promise<AxAgentPlaybookEvolveResult<OUT>>;
6634
+ /** Refine the playbook from a single live interaction (trust). */
6635
+ update(args: Readonly<{
6636
+ example: unknown;
6637
+ prediction: unknown;
6638
+ feedback?: string;
6639
+ }>): Promise<void>;
6640
+ /** The current playbook rendered as a markdown block. */
6641
+ render(): string;
6642
+ /** A serializable snapshot of the current playbook and its history. */
6643
+ getState(): AxPlaybookSnapshot;
6644
+ /** Alias of {@link getState} so `JSON.stringify(handle)` yields a snapshot. */
6645
+ toJSON(): AxPlaybookSnapshot;
6646
+ /** Restore a snapshot and render it into the live stage. */
6647
+ load(snapshot: Readonly<AxPlaybookSnapshot>): this;
6648
+ /** Clear the playbook back to its initial state. */
6649
+ reset(): void;
6650
+ /** Set the evolution intensity preset. */
6651
+ configureAuto(level: 'light' | 'medium' | 'heavy'): void;
6652
+ /** The inner program-level playbook handle (for advanced use). */
6653
+ get inner(): AxPlaybook<IN, OUT>;
6654
+ }
6655
+
6214
6656
  /**
6215
6657
  * Pipeline-based coordinator. Every run walks the same static sequence:
6216
6658
  *
@@ -6262,6 +6704,10 @@ declare class AxAgent<IN extends AxGenIn, OUT extends AxGenOut> implements AxAge
6262
6704
  private readonly options;
6263
6705
  private readonly contextMapConfig?;
6264
6706
  private contextMap?;
6707
+ private readonly playbookConfigResolved?;
6708
+ private playbookHandle?;
6709
+ private _agentPlaybook?;
6710
+ private readonly citationsResolved;
6265
6711
  private func?;
6266
6712
  constructor(init: Readonly<{
6267
6713
  ai?: Readonly<AxAIService>;
@@ -6310,17 +6756,46 @@ declare class AxAgent<IN extends AxGenIn, OUT extends AxGenOut> implements AxAge
6310
6756
  applyOptimizedComponents(updates: Readonly<Record<string, string>>): void;
6311
6757
  optimize(dataset: Readonly<AxAgentEvalDataset<IN>>, options?: Readonly<AxAgentOptimizeOptions<IN, OUT>>): Promise<AxAgentOptimizeResult<OUT>>;
6312
6758
  /**
6313
- * Build an evolving context {@link AxPlaybook} bound to an agent stage
6314
- * (the actor/task stage by default).
6315
- *
6316
- * Use `.update({ example, prediction, feedback })` to refine the playbook from
6317
- * live feedback, or `.evolve(dataset, metric)` to grow it offline. Offline
6318
- * evolution scores the chosen stage in isolation; for full-pipeline tuning of
6319
- * instructions and demos use {@link optimize} instead. Unless `apply` is
6320
- * `false`, the rendered playbook is injected into the live stage prompt as it
6321
- * evolves. The evolution engine (ACE) is an implementation detail.
6322
- */
6323
- playbook(options?: Readonly<AxAgentPlaybookOptions>): AxPlaybook<any, any>;
6759
+ * Append a standing instruction addendum to the executor actor's prompt.
6760
+ * A separate additive channel from `executorOptions.description` and the
6761
+ * playbook injection, so the three never clobber each other. Process-local —
6762
+ * not serialized into `AxAgentState`.
6763
+ */
6764
+ addActorInstruction(addendum: string): void;
6765
+ /**
6766
+ * The agent's learned playbook one evolving body of task knowledge bound
6767
+ * to an agent stage (the actor/task stage by default). It grows three ways:
6768
+ * continuously from each run (the `playbook` construction config),
6769
+ * on demand via `.update(...)`, or from a task set via
6770
+ * `.evolve(dataset, options)` (verified by default). Unless `apply` is
6771
+ * `false`, the rendered playbook is injected into the live stage prompt.
6772
+ * Memoized — one playbook per agent. The evolution engine (ACE) is an
6773
+ * implementation detail.
6774
+ */
6775
+ playbook(options?: Readonly<AxAgentPlaybookOptions>): AxAgentPlaybook<any, any>;
6776
+ /** The agent's playbook handle, or `undefined` if none has been created. */
6777
+ getPlaybook(): AxAgentPlaybook<any, any> | undefined;
6778
+ private _agentPlaybookWrapper;
6779
+ private _buildStagePlaybook;
6780
+ /**
6781
+ * Build and seed the construction-time playbook handle (`options.playbook`).
6782
+ * Reuses the `playbook()` stage-binding path; a snapshot seed is restored
6783
+ * via `load()`, a bare playbook seeds the engine directly. Either way the
6784
+ * seeded content is rendered into the live stage prompt (unless
6785
+ * `apply: false`).
6786
+ */
6787
+ private _createPlaybookHandle;
6788
+ /**
6789
+ * Run-end failure learning for the attached playbook (see
6790
+ * `AxAgentPlaybookConfig.learn`): merge the stages' deterministic failure
6791
+ * reports, gate on volume and signature novelty, then feed one bounded
6792
+ * playbook update whose curated rules land in the `failures_to_avoid`
6793
+ * section. Non-fatal by construction — playbook upkeep must never break the
6794
+ * completed user-facing run.
6795
+ *
6796
+ * @internal Public for the pipeline flow node and tests.
6797
+ */
6798
+ _updatePlaybookFromPipelineState(state: Readonly<Record<string, any>>): Promise<AxAgentPlaybookUpdateResult | undefined>;
6324
6799
  private _listOptimizationTargetDescriptors;
6325
6800
  private _createOptimizationProgram;
6326
6801
  private _createAgentOptimizeMetric;
@@ -6384,6 +6859,22 @@ declare class ActorAgentRLM<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut =
6384
6859
  private rlmConfig;
6385
6860
  private runtime;
6386
6861
  private executorDescription?;
6862
+ /**
6863
+ * Stage-owned optimizable instruction, rendered at the top of the actor
6864
+ * definition. This is the live backing for the stage's `::instruction`
6865
+ * component: it survives `_buildSplitPrograms()` rebuilds (unlike an
6866
+ * instruction set on the inner split programs, which are recreated) and
6867
+ * setting it triggers a rebuild so it takes effect immediately.
6868
+ */
6869
+ private stageInstruction?;
6870
+ /**
6871
+ * Standing instruction addenda appended after `executorDescription` in the
6872
+ * actor definition (set via `agent.addActorInstruction(...)`). A separate
6873
+ * additive channel so manual standing rules and the playbook apply-hook
6874
+ * (which recomposes `executorDescription` from a captured base) never
6875
+ * clobber each other. Process-local: not serialized into `AxAgentState`.
6876
+ */
6877
+ private instructionAddenda?;
6387
6878
  private executorModelPolicy?;
6388
6879
  private judgeOptions?;
6389
6880
  private recursionForwardOptions?;
@@ -6497,6 +6988,13 @@ declare class ActorAgentRLM<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut =
6497
6988
  }>): Promise<AxAgentTestResult>;
6498
6989
  setSignature(signature: AxSignatureInput): void;
6499
6990
  applyOptimization(optimizedProgram: any): void;
6991
+ /**
6992
+ * The stage's optimizable instruction. Backed by the stage itself (not the
6993
+ * inner split programs, which are recreated on every rebuild and would
6994
+ * silently drop it) and rendered at the top of the actor definition.
6995
+ */
6996
+ getInstruction(): string | undefined;
6997
+ setInstruction(instruction: string): void;
6500
6998
  getOptimizableComponents(): readonly any[];
6501
6999
  applyOptimizedComponents(updates: Readonly<Record<string, string>>): void;
6502
7000
  /**
@@ -6554,6 +7052,45 @@ type AxAgentMemoryEntry = {
6554
7052
  content: string;
6555
7053
  };
6556
7054
 
7055
+ /**
7056
+ * Sequential agent-layer batch evaluation for `agent.playbook().evolve()`.
7057
+ *
7058
+ * Strictly sequential by design: `_forwardForEvaluation` saves/clears/
7059
+ * restores the primary actor's state, discovery state, and llmQuery budget
7060
+ * around each call — concurrent calls on one agent instance would interleave
7061
+ * those save/restore pairs and corrupt state.
7062
+ */
7063
+
7064
+ /** Mutable (run + judge) pair budget shared across all improve() batches. */
7065
+ type AxAgentEvalBudget = {
7066
+ remaining: number;
7067
+ };
7068
+ type AxAgentEvalBatchResult<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut = AxGenOut> = {
7069
+ records: AxAgentPlaybookEvolveRunRecord<IN, OUT>[];
7070
+ /** Weighted mean score over executed records (0 when none ran). */
7071
+ mean: number;
7072
+ /** True when the budget ran out before every task executed. */
7073
+ exhausted: boolean;
7074
+ };
7075
+
7076
+ /**
7077
+ * Deterministic failure clustering for `agent.playbook().evolve()` — zero LLM calls.
7078
+ *
7079
+ * Failures group by a stable signature so the miner sees one cluster per
7080
+ * failure mode. Key resolution order per record: majority signature among the
7081
+ * run's structured failure signals (P1 harvest) → first tool-error line →
7082
+ * first `XxxError:` line in the action log → `'behavioral:no_error'` (the
7083
+ * judge failed an error-free run: wrong output, forbidden actions, stalls).
7084
+ */
7085
+
7086
+ type AxAgentFailureCluster = {
7087
+ signature: string;
7088
+ records: AxAgentPlaybookEvolveRunRecord[];
7089
+ /** count x mean(1 - score): frequent, badly-scored clusters rank first. */
7090
+ severity: number;
7091
+ taskIds: readonly string[];
7092
+ };
7093
+
6557
7094
  /**
6558
7095
  * Local, deterministic relevance ranker for agent discovery and recall.
6559
7096
  *
@@ -7027,6 +7564,7 @@ type AxAIAnthropicThinkingWire = {
7027
7564
  budget_tokens: number;
7028
7565
  } | {
7029
7566
  type: 'adaptive';
7567
+ display?: 'summarized' | 'omitted';
7030
7568
  };
7031
7569
  type AxAIAnthropicEffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
7032
7570
  type AxAIAnthropicTaskBudget = {
@@ -12389,4 +12927,4 @@ declare class AxRateLimiterTokenUsage {
12389
12927
  acquire(tokens: number): Promise<void>;
12390
12928
  }
12391
12929
 
12392
- export { AxACE, type AxACEBullet, type AxACECuratorOperation, type AxACECuratorOperationType, type AxACECuratorOutput, type AxACEFeedbackEvent, type AxACEGeneratorOutput, type AxACEOptimizationArtifact, AxACEOptimizedProgram, type AxACEOptions, type AxACEPlaybook, type AxACEReflectionOutput, type AxACEResult, AxAI, AxAIAnthropic, type AxAIAnthropicArgs, type AxAIAnthropicChatError, type AxAIAnthropicChatRequest, type AxAIAnthropicChatRequestCacheParam, type AxAIAnthropicChatResponse, type AxAIAnthropicChatResponseDelta, type AxAIAnthropicConfig, type AxAIAnthropicContentBlockDeltaEvent, type AxAIAnthropicContentBlockStartEvent, type AxAIAnthropicContentBlockStopEvent, type AxAIAnthropicEffortLevel, type AxAIAnthropicEffortLevelMapping, type AxAIAnthropicErrorEvent, type AxAIAnthropicFunctionTool, type AxAIAnthropicMessageDeltaEvent, type AxAIAnthropicMessageStartEvent, type AxAIAnthropicMessageStopEvent, AxAIAnthropicModel, type AxAIAnthropicOutputConfig, type AxAIAnthropicPingEvent, type AxAIAnthropicRequestTool, type AxAIAnthropicStopDetails, type AxAIAnthropicTaskBudget, type AxAIAnthropicThinkingConfig, type AxAIAnthropicThinkingTokenBudgetLevels, type AxAIAnthropicThinkingWire, AxAIAnthropicVertexModel, type AxAIAnthropicWebSearchTool, type AxAIArgs, AxAIAzureOpenAI, type AxAIAzureOpenAIArgs, type AxAIAzureOpenAIConfig, AxAICohere, type AxAICohereArgs, type AxAICohereChatRequest, type AxAICohereChatRequestToolResults, type AxAICohereChatResponse, type AxAICohereChatResponseDelta, type AxAICohereChatResponseToolCalls, type AxAICohereConfig, AxAICohereEmbedModel, type AxAICohereEmbedRequest, type AxAICohereEmbedResponse, AxAICohereModel, AxAIDeepSeek, type AxAIDeepSeekArgs, AxAIDeepSeekModel, type AxAIEmbedModels, type AxAIFeatures, AxAIGoogleGemini, type AxAIGoogleGeminiArgs, type AxAIGoogleGeminiBatchEmbedRequest, type AxAIGoogleGeminiBatchEmbedResponse, type AxAIGoogleGeminiCacheCreateRequest, type AxAIGoogleGeminiCacheResponse, type AxAIGoogleGeminiCacheUpdateRequest, type AxAIGoogleGeminiChatRequest, type AxAIGoogleGeminiChatResponse, type AxAIGoogleGeminiChatResponseDelta, type AxAIGoogleGeminiConfig, type AxAIGoogleGeminiContent, type AxAIGoogleGeminiContentPart, AxAIGoogleGeminiEmbedModel, AxAIGoogleGeminiEmbedTypes, type AxAIGoogleGeminiGenerationConfig, AxAIGoogleGeminiModel, type AxAIGoogleGeminiOptionsTools, type AxAIGoogleGeminiRetrievalConfig, AxAIGoogleGeminiSafetyCategory, type AxAIGoogleGeminiSafetySettings, AxAIGoogleGeminiSafetyThreshold, type AxAIGoogleGeminiThinkingConfig, type AxAIGoogleGeminiThinkingLevel, type AxAIGoogleGeminiThinkingLevelMapping, type AxAIGoogleGeminiThinkingTokenBudgetLevels, type AxAIGoogleGeminiTool, type AxAIGoogleGeminiToolConfig, type AxAIGoogleGeminiToolFunctionDeclaration, type AxAIGoogleGeminiToolGoogleMaps, type AxAIGoogleGeminiToolGoogleSearchRetrieval, type AxAIGoogleVertexBatchEmbedRequest, type AxAIGoogleVertexBatchEmbedResponse, AxAIGrok, type AxAIGrokArgs, type AxAIGrokChatRequest, AxAIGrokEmbedModels, AxAIGrokModel, type AxAIGrokOptionsTools, type AxAIGrokSearchSource, type AxAIInputModelList, type AxAIMemory, type AxAIMetricsInstruments, AxAIMistral, type AxAIMistralArgs, type AxAIMistralChatRequest, AxAIMistralEmbedModels, AxAIMistralModel, type AxAIModelCatalogAudioSupport, type AxAIModelCatalogFilter, type AxAIModelCatalogModel, type AxAIModelCatalogModelCapabilities, type AxAIModelCatalogModelType, type AxAIModelCatalogOptions, type AxAIModelCatalogProvider, type AxAIModelCatalogProviderName, type AxAIModelList, type AxAIModelListBase, type AxAIModels, AxAIOpenAI, type AxAIOpenAIAnnotation, type AxAIOpenAIArgs, AxAIOpenAIBase, type AxAIOpenAIBaseArgs, type AxAIOpenAIChatRequest, type AxAIOpenAIChatResponse, type AxAIOpenAIChatResponseDelta, type AxAIOpenAIConfig, AxAIOpenAIEmbedModel, type AxAIOpenAIEmbedRequest, type AxAIOpenAIEmbedResponse, type AxAIOpenAILogprob, AxAIOpenAIModel, type AxAIOpenAIResponseDelta, AxAIOpenAIResponses, type AxAIOpenAIResponsesArgs, AxAIOpenAIResponsesBase, type AxAIOpenAIResponsesCodeInterpreterToolCall, type AxAIOpenAIResponsesComputerToolCall, type AxAIOpenAIResponsesConfig, type AxAIOpenAIResponsesContentPartAddedEvent, type AxAIOpenAIResponsesContentPartDoneEvent, type AxAIOpenAIResponsesDefineFunctionTool, type AxAIOpenAIResponsesErrorEvent, type AxAIOpenAIResponsesFileSearchCallCompletedEvent, type AxAIOpenAIResponsesFileSearchCallInProgressEvent, type AxAIOpenAIResponsesFileSearchCallSearchingEvent, type AxAIOpenAIResponsesFileSearchToolCall, type AxAIOpenAIResponsesFunctionCallArgumentsDeltaEvent, type AxAIOpenAIResponsesFunctionCallArgumentsDoneEvent, type AxAIOpenAIResponsesFunctionCallItem, type AxAIOpenAIResponsesImageGenerationCallCompletedEvent, type AxAIOpenAIResponsesImageGenerationCallGeneratingEvent, type AxAIOpenAIResponsesImageGenerationCallInProgressEvent, type AxAIOpenAIResponsesImageGenerationCallPartialImageEvent, type AxAIOpenAIResponsesImageGenerationToolCall, type AxAIOpenAIResponsesInputAudioContentPart, type AxAIOpenAIResponsesInputContentPart, type AxAIOpenAIResponsesInputFunctionCallItem, type AxAIOpenAIResponsesInputFunctionCallOutputItem, type AxAIOpenAIResponsesInputImageUrlContentPart, type AxAIOpenAIResponsesInputItem, type AxAIOpenAIResponsesInputMessageItem, type AxAIOpenAIResponsesInputTextContentPart, type AxAIOpenAIResponsesLocalShellToolCall, type AxAIOpenAIResponsesMCPCallArgumentsDeltaEvent, type AxAIOpenAIResponsesMCPCallArgumentsDoneEvent, type AxAIOpenAIResponsesMCPCallCompletedEvent, type AxAIOpenAIResponsesMCPCallFailedEvent, type AxAIOpenAIResponsesMCPCallInProgressEvent, type AxAIOpenAIResponsesMCPListToolsCompletedEvent, type AxAIOpenAIResponsesMCPListToolsFailedEvent, type AxAIOpenAIResponsesMCPListToolsInProgressEvent, type AxAIOpenAIResponsesMCPToolCall, AxAIOpenAIResponsesModel, type AxAIOpenAIResponsesOutputItem, type AxAIOpenAIResponsesOutputItemAddedEvent, type AxAIOpenAIResponsesOutputItemDoneEvent, type AxAIOpenAIResponsesOutputMessageItem, type AxAIOpenAIResponsesOutputRefusalContentPart, type AxAIOpenAIResponsesOutputTextAnnotationAddedEvent, type AxAIOpenAIResponsesOutputTextContentPart, type AxAIOpenAIResponsesOutputTextDeltaEvent, type AxAIOpenAIResponsesOutputTextDoneEvent, type AxAIOpenAIResponsesReasoningDeltaEvent, type AxAIOpenAIResponsesReasoningDoneEvent, type AxAIOpenAIResponsesReasoningItem, type AxAIOpenAIResponsesReasoningSummaryDeltaEvent, type AxAIOpenAIResponsesReasoningSummaryDoneEvent, type AxAIOpenAIResponsesReasoningSummaryPart, type AxAIOpenAIResponsesReasoningSummaryPartAddedEvent, type AxAIOpenAIResponsesReasoningSummaryPartDoneEvent, type AxAIOpenAIResponsesReasoningSummaryTextDeltaEvent, type AxAIOpenAIResponsesReasoningSummaryTextDoneEvent, type AxAIOpenAIResponsesRefusalDeltaEvent, type AxAIOpenAIResponsesRefusalDoneEvent, type AxAIOpenAIResponsesRequest, type AxAIOpenAIResponsesResponse, type AxAIOpenAIResponsesResponseCompletedEvent, type AxAIOpenAIResponsesResponseCreatedEvent, type AxAIOpenAIResponsesResponseFailedEvent, type AxAIOpenAIResponsesResponseInProgressEvent, type AxAIOpenAIResponsesResponseIncompleteEvent, type AxAIOpenAIResponsesResponseQueuedEvent, type AxAIOpenAIResponsesStreamEvent, type AxAIOpenAIResponsesStreamEventBase, type AxAIOpenAIResponsesToolCall, type AxAIOpenAIResponsesToolCallBase, type AxAIOpenAIResponsesToolChoice, type AxAIOpenAIResponsesToolDefinition, type AxAIOpenAIResponsesWebSearchCallCompletedEvent, type AxAIOpenAIResponsesWebSearchCallInProgressEvent, type AxAIOpenAIResponsesWebSearchCallSearchingEvent, type AxAIOpenAIResponsesWebSearchToolCall, type AxAIOpenAIUrlCitation, type AxAIOpenAIUsage, AxAIRefusalError, AxAIReka, type AxAIRekaArgs, type AxAIRekaChatRequest, type AxAIRekaChatResponse, type AxAIRekaChatResponseDelta, type AxAIRekaConfig, AxAIRekaModel, type AxAIRekaUsage, type AxAIService, AxAIServiceAbortedError, type AxAIServiceActionOptions, AxAIServiceAuthenticationError, AxAIServiceError, type AxAIServiceImpl, type AxAIServiceMetrics, type AxAIServiceModelType, AxAIServiceNetworkError, type AxAIServiceOptions, AxAIServiceResponseError, AxAIServiceStatusError, AxAIServiceStreamTerminatedError, AxAIServiceTimeoutError, AxAIWebLLM, type AxAIWebLLMArgs, type AxAIWebLLMChatRequest, type AxAIWebLLMChatResponse, type AxAIWebLLMChatResponseDelta, type AxAIWebLLMConfig, type AxAIWebLLMEmbedModel, type AxAIWebLLMEmbedRequest, type AxAIWebLLMEmbedResponse, type AxAIWebLLMEngine, AxAIWebLLMModel, type AxAIWebLLMModelId, type AxAPI, type AxAPIConfig, type AxAPIResponseMetadata, AxAgent, type AxAgentActorTurnCallback, type AxAgentActorTurnCallbackArgs, type AxAgentAutoPromotionRecord, type AxAgentAutoUpgrade, type AxAgentCatalogSkill, type AxAgentClarification, type AxAgentClarificationChoice, AxAgentClarificationError, type AxAgentClarificationKind, type AxAgentCompletionProtocol, type AxAgentConfig, type AxAgentContextEvent, AxAgentContextMap, type AxAgentContextMapConfig, type AxAgentContextMapOperation, type AxAgentContextMapOptions, type AxAgentContextMapSnapshot, type AxAgentContextMapUpdateResult, type AxAgentContextPressure, type AxAgentContextStage, type AxAgentDemos, type AxAgentDirectResponse, type AxAgentDiscoveryPromptState, type AxAgentEvalDataset, type AxAgentEvalFunctionCall, type AxAgentEvalPrediction, type AxAgentEvalTask, type AxAgentExecutorResultPayload, type AxAgentForwardOptions, type AxAgentFunction, type AxAgentFunctionCall, type AxAgentFunctionCallRecorder, type AxAgentFunctionCollection, type AxAgentFunctionExample, type AxAgentFunctionGroup, type AxAgentFunctionModuleMeta, type AxAgentGuidanceLogEntry, type AxAgentGuidancePayload, type AxAgentGuidanceState, type AxAgentIdentity, type AxAgentInputUpdateCallback, type AxAgentJudgeEvalInput, type AxAgentJudgeEvalOutput, type AxAgentJudgeInput, type AxAgentJudgeOptions, type AxAgentJudgeOutput, type AxAgentMemoriesSearchFn, type AxAgentMemoryEntry, type AxAgentMemoryResult, type AxAgentOnContextEvent, type AxAgentOnFunctionCall, type AxAgentOptimizationTargetDescriptor, type AxAgentOptimizeOptions, type AxAgentOptimizeResult, type AxAgentOptimizeTarget, type AxAgentOptions, type AxAgentPlaybookOptions, AxAgentProtocolCompletionSignal, type AxAgentRecursionOptions, type AxAgentRecursiveExpensiveNode, type AxAgentRecursiveFunctionCall, type AxAgentRecursiveNodeRole, type AxAgentRecursiveStats, type AxAgentRecursiveTargetId, type AxAgentRecursiveTraceNode, type AxAgentRecursiveTurn, type AxAgentRecursiveUsage, type AxAgentRuntimeCompletionState, type AxAgentRuntimeExecutionContext, type AxAgentRuntimeInputState, AxAgentSharedRuntimeSession, type AxAgentSkillResult, type AxAgentSkillsPromptState, type AxAgentSkillsSearchFn, type AxAgentStagePolicy, type AxAgentStageVariant, type AxAgentState, type AxAgentStateActionLogEntry, type AxAgentStateCheckpointState, type AxAgentStateExecutorModelState, type AxAgentStateRuntimeEntry, type AxAgentStreamingForwardOptions, type AxAgentStructuredClarification, type AxAgentTestCompletionPayload, type AxAgentTestResult, type AxAgentUsage, type AxAgentUsedMemoriesCallback, type AxAgentUsedMemory, type AxAgentUsedSkill, type AxAgentUsedSkillsCallback, type AxAgentic, type AxAnyAgentic, type AxAssertion, AxAssertionError, type AxAttempt, type AxAudioFormat, type AxAudioInput, AxBalancer, type AxBalancerOptions, AxBaseAI, type AxBaseAIArgs, AxBaseOptimizer, AxBestOfN, type AxBestOfNOptions, AxBootstrapFewShot, type AxBootstrapOptimizerOptions, type AxChatAudioConfig, type AxChatAudioOutput, type AxChatLogEntry, type AxChatLogMessage, type AxChatRequest, type AxChatResponse, type AxChatResponseFunctionCall, type AxChatResponseResult, type AxCheckpointLoadFn, type AxCheckpointSaveFn, type AxCitation, type AxCodeRuntime, type AxCodeSession, type AxCodeSessionSnapshot, type AxCodeSessionSnapshotEntry, type AxCompileOptions, AxContentProcessingError, type AxContentProcessingServices, type AxContextCacheInfo, type AxContextCacheOperation, type AxContextCacheOptions, type AxContextCacheRegistry, type AxContextCacheRegistryEntry, type AxContextFieldInput, type AxContextFieldPromptConfig, AxContextMetricsCollector, type AxContextMetricsRow, type AxContextMetricsSummary, type AxContextPolicyBudget, type AxContextPolicyConfig, type AxContextPolicyPreset, type AxContextScenario, type AxContextTurnSample, type AxCostTracker, type AxCostTrackerOptions, type AxDateRange, type AxDateRangeValue, type AxDebugChatResponseUsage, AxDefaultCostTracker, type AxDiscoveryTurnSummary, type AxDockerContainer, AxDockerSession, type AxEmbedRequest, type AxEmbedResponse, AxEmbeddingAdapter, type AxErrorCategory, AxEvalUtil, type AxEvaluateArgs, type AxEvidenceDescriptor, type AxExample, type AxExamples, type AxExecutorModelPolicy, type AxExecutorModelPolicyEntry, type AxField, type AxFieldOptions, type AxFieldProcessor, type AxFieldProcessorProcess, type AxFieldTemplateFn, type AxFieldType, type AxFieldValue, AxFlow, type AxFlowBranchEvaluationData, type AxFlowCompleteData, type AxFlowDynamicContext, type AxFlowErrorData, type AxFlowExecutionPlan, type AxFlowExecutionPlanGroup, type AxFlowExecutionPlanStep, type AxFlowForwardOptions, type AxFlowLogData, type AxFlowLoggerData, type AxFlowLoggerFunction, type AxFlowOptions, type AxFlowParallelGroupCompleteData, type AxFlowParallelGroupStartData, type AxFlowStartData, type AxFlowState, type AxFlowStateDependencyAnalysis, type AxFlowStepCompleteData, type AxFlowStepStartData, type AxFlowTypedParallelBranch, type AxFlowTypedSubContext, type AxFlowable, type AxFluentFieldInfo, AxFluentFieldType, type AxForwardable, type AxFunction, type AxFunctionCallRecord, type AxFunctionCallTrace, AxFunctionError, type AxFunctionHandler, type AxFunctionJSONSchema, AxFunctionProcessor, type AxFunctionProvider, type AxFunctionResult, type AxFunctionResultFormatter, AxGEPA, type AxGEPAAdapter, type AxGEPABatchEvaluation, type AxGEPABatchRow, type AxGEPABootstrapOptions, type AxGEPAComponentBanditState, AxGEPAComponentSelector, type AxGEPAComponentTarget, type AxGEPAEvaluationBatch, type AxGEPAEvaluationState, type AxGEPAOptimizationReport, type AxGEPAReflectiveTuple, type AxGEPATraceSummary, type AxGEPATraceSummaryCall, AxGen, type AxGenDeltaOut, type AxGenIn, type AxGenInput, type AxGenMetricsInstruments, type AxGenOut, type AxGenOutput, type AxGenStreamingOut, AxGenerateError, type AxGenerateErrorDetails, type AxGenerateResult, type AxIField, type AxInputFunctionType, AxJSRuntime, type AxJSRuntimeNodePermissionAllowlist, type AxJSRuntimeOutputMode, AxJSRuntimePermission, type AxJSRuntimeResourceLimits, type AxJudgeForwardOptions, type AxJudgeOptions, type AxLlmQueryBudgetState, type AxLlmQueryPromptMode, type AxLoggerData, type AxLoggerFunction, type AxMCPAnnotations, type AxMCPAudioContent, type AxMCPBaseAnnotated, type AxMCPBlobResourceContents, AxMCPClient, type AxMCPClientCapabilities, type AxMCPClientOptions, type AxMCPCompletionArgument, type AxMCPCompletionReference, type AxMCPCompletionRequest, type AxMCPCompletionResult, type AxMCPContent, type AxMCPEmbeddedResource, type AxMCPFetchOptions, type AxMCPFunctionDescription, type AxMCPFunctionOverride, AxMCPHTTPSSETransport, type AxMCPIcon, type AxMCPImageContent, type AxMCPImplementationInfo, type AxMCPInitializeParams, type AxMCPInitializeResult, type AxMCPJSONRPCErrorResponse, type AxMCPJSONRPCMessage, type AxMCPJSONRPCNotification, type AxMCPJSONRPCRequest, type AxMCPJSONRPCResponse, type AxMCPJSONRPCSuccessResponse, type AxMCPJSONSchema, type AxMCPListRootsResult, type AxMCPLoggingLevel, type AxMCPMeta, type AxMCPOAuthOptions, type AxMCPPaginatedRequest, type AxMCPPrompt, type AxMCPPromptArgument, type AxMCPPromptGetResult, type AxMCPPromptMessage, type AxMCPPromptsListResult, type AxMCPProtocolVersion, type AxMCPResource, type AxMCPResourceLink, type AxMCPResourceReadResult, type AxMCPResourceTemplate, type AxMCPResourceTemplatesListResult, type AxMCPResourcesListResult, type AxMCPRoot, type AxMCPSSRFProtectionContext, type AxMCPSSRFProtectionOptions, type AxMCPServerCapabilities, AxMCPStreamableHTTPTransport, type AxMCPStreamableHTTPTransportOptions, AxMCPStreambleHTTPTransport, type AxMCPTextContent, type AxMCPTextResourceContents, type AxMCPTokenSet, type AxMCPTool, type AxMCPToolCallParams, type AxMCPToolCallResult, type AxMCPToolsListResult, type AxMCPTransport, AxMediaNotSupportedError, AxMemory, type AxMemoryData, type AxMemoryMessageValue, type AxMetricFn, type AxMetricFnArgs, type AxMetricsConfig, AxMockAIService, type AxMockAIServiceConfig, type AxModelConfig, type AxModelInfo, type AxModelInfoWithProvider, type AxModelUsage, type AxModuleRankInput, type AxMultiMetricFn, type AxMultiProviderConfig, AxMultiServiceRouter, type AxNamedProgramInstance, type AxOptimizableComponent, type AxOptimizableValidator, type AxOptimizationCheckpoint, type AxOptimizationProgress, type AxOptimizationStats, type AxOptimizeOptions, type AxOptimizedProgram, AxOptimizedProgramImpl, type AxOptimizer, type AxOptimizerArgs, type AxOptimizerLoggerData, type AxOptimizerLoggerFunction, type AxOptimizerMetricsConfig, type AxOptimizerMetricsInstruments, type AxOptimizerResult, type AxParetoResult, AxPlaybook, type AxPlaybookEvolveOptions, type AxPlaybookEvolveResult, type AxPlaybookOptions, type AxPlaybookSnapshot, AxProgram, type AxProgramDemos, type AxProgramExamples, type AxProgramForwardOptions, type AxProgramForwardOptionsWithModels, type AxProgramOptions, type AxProgramStreamingForwardOptions, type AxProgramStreamingForwardOptionsWithModels, type AxProgramTrace, type AxProgramUsage, type AxProgrammable, type AxPromptMetrics, AxPromptTemplate, type AxPromptTemplateOptions, type AxProviderMetadata, AxProviderRouter, type AxRLMConfig, type AxRankDocumentsOptions, type AxRankModulesOptions, type AxRankableDocument, type AxRankableField, type AxRankedDocument, type AxRankedModule, type AxRateLimiterFunction, AxRateLimiterTokenUsage, type AxRateLimiterTokenUsageOptions, AxRefine, AxRefineError, type AxRefineOptions, type AxRefineStrategy, type AxRelevanceHints, type AxRenderedPrompt, type AxResolvedAutoUpgrade, type AxResolvedContextPolicy, type AxResolvedExecutorModelPolicy, type AxResolvedExecutorModelPolicyEntry, type AxResultPickerFunction, type AxResultPickerFunctionFieldResults, type AxResultPickerFunctionFunctionResults, type AxRewardFn, type AxRewardFnArgs, type AxRolloutTrace, type AxRoutingResult, type AxRuntimeCallableFormatArgs, type AxRuntimeLanguageInfo, type AxRuntimePrimitive, type AxRuntimePrimitiveExample, type AxRuntimePrimitiveOverrideMap, type AxRuntimePrimitiveSignature, type AxRuntimePrimitiveStage, type AxSamplePickerOptions, type AxSelfTuningConfig, type AxSerializedOptimizedProgram, type AxSetExamplesOptions, type AxSharedSessionPhase, AxSignature, AxSignatureBuilder, type AxSignatureConfig, type AxSignatureInput, type AxSpeechConfig, type AxSpeechRequest, type AxSpeechResponse, type AxStageDefinitionBuildOptions, type AxStageOptions, type AxStepContext, type AxStepHooks, type AxStepUsage, AxStopFunctionCallException, type AxStreamingAssertion, AxStreamingAssertionError, type AxStreamingEvent, type AxStreamingFieldProcessorProcess, AxStringUtil, AxSynth, type AxSynthExample, type AxSynthOptions, type AxSynthResult, type AxSynthesizerInit, type AxSynthesizerOptions, type AxSynthesizerRole, AxTestPrompt, type AxThoughtBlockItem, AxTokenLimitError, type AxTokenUsage, type AxTranscriptionRequest, type AxTranscriptionResponse, type AxTranscriptionSegment, type AxTunable, type AxTypedExample, type AxUsable, type AxWorkerRuntimeConfig, agent, ai, ax, axAIAnthropicDefaultConfig, axAIAnthropicVertexDefaultConfig, axAIAzureOpenAIBestConfig, axAIAzureOpenAICreativeConfig, axAIAzureOpenAIDefaultConfig, axAIAzureOpenAIFastConfig, axAICohereCreativeConfig, axAICohereDefaultConfig, axAIDeepSeekCodeConfig, axAIDeepSeekDefaultConfig, axAIGoogleGeminiDefaultConfig, axAIGoogleGeminiDefaultCreativeConfig, axAIGoogleGeminiLiveAudioDefaultConfig, axAIGrokBestConfig, axAIGrokDefaultConfig, axAIGrokVoiceDefaultConfig, axAIMistralBestConfig, axAIMistralDefaultConfig, axAIOpenAIAudioDefaultConfig, axAIOpenAIBestConfig, axAIOpenAICreativeConfig, axAIOpenAIDefaultConfig, axAIOpenAIFastConfig, axAIOpenAIRealtimeDefaultConfig, axAIOpenAIRealtimeTranscriptionDefaultConfig, axAIOpenAIResponsesBestConfig, axAIOpenAIResponsesCreativeConfig, axAIOpenAIResponsesDefaultConfig, axAIRekaBestConfig, axAIRekaCreativeConfig, axAIRekaDefaultConfig, axAIRekaFastConfig, axAIWebLLMCreativeConfig, axAIWebLLMDefaultConfig, axAnalyzeChatPromptRequirements, axAnalyzeRequestRequirements, axApplyOpenAIChatAudioRequest, axAudioFormatFromMimeType, axAudioInputFilename, axAudioInputToBlob, axAudioMimeType, axBaseAIDefaultConfig, axBaseAIDefaultCreativeConfig, axBuildDistillerDefinition, axBuildExecutorDefinition, axBuildResponderDefinition, axCheckMetricsHealth, axConcatBase64, axCreateDefaultColorLogger, axCreateDefaultOptimizerColorLogger, axCreateDefaultOptimizerTextLogger, axCreateDefaultTextLogger, axCreateFlowColorLogger, axCreateFlowTextLogger, axCreateGeminiLiveAudioApi, axCreateGrokRealtimeApi, axCreateJSRuntime, axCreateOpenAIRealtimeApi, axDefaultFlowLogger, axDefaultMetricsConfig, axDefaultOptimizerLogger, axDefaultOptimizerMetricsConfig, axDeserializeOptimizedProgram, axFetchJsonSpeech, axFetchMultipartTranscription, axGetCompatibilityReport, axGetFormatCompatibility, axGetMetricsConfig, axGetOptimizerMetricsConfig, axGetProvidersWithMediaSupport, axGetSupportedAIModels, axGlobals, axGoogleGeminiLiveAudioDefaults, axIsAudioOutputEnabled, axIsGeminiLiveAudioModel, axIsGrokVoiceModel, axIsOpenAIChatAudioModel, axIsOpenAIRealtimeModel, axIsOpenAIRealtimeTranscriptionModel, axMCPToolInputSchemaToFunctionSchema, axMapGeminiLiveAudioPart, axMapOpenAIChatAudioDelta, axMapOpenAIChatAudioResponse, axMapOpenAIInputAudioPart, axMergeChatAudioConfig, axModelInfoAnthropic, axModelInfoCohere, axModelInfoDeepSeek, axModelInfoGoogleGemini, axModelInfoGrok, axModelInfoMistral, axModelInfoOpenAI, axModelInfoOpenAIResponses, axModelInfoReka, axModelInfoWebLLM, axNormalizeOpenAIUsage, axNormalizeTranscriptionResponse, axOpenAIChatAudioDefaults, axOptimizableValidators, axProcessContentForProvider, axResolveGeminiLiveAudioConfig, axResolveGrokRealtimeAudioConfig, axResolveOpenAIChatAudioConfig, axResolveOpenAIRealtimeAudioConfig, axRuntimePrimitives, axScoreProvidersForRequest, axSelectOptimalProvider, axSerializeOptimizedProgram, axShouldUseGeminiLiveAudio, axShouldUseGrokRealtime, axShouldUseOpenAIRealtime, axSpanAttributes, axSpanEvents, axUpdateMetricsConfig, axUpdateOptimizerMetricsConfig, axValidateChatRequestMessage, axValidateChatResponseResult, axValidateGeminiLiveAudioInput, axValidateProviderCapabilities, axWorkerRuntime, bestOfN, f, flow, fn, optimize, playbook, refine, s };
12930
+ export { AxACE, type AxACEBullet, type AxACECuratorOperation, type AxACECuratorOperationType, type AxACECuratorOutput, type AxACEFeedbackEvent, type AxACEGeneratorOutput, type AxACEOptimizationArtifact, AxACEOptimizedProgram, type AxACEOptions, type AxACEPlaybook, type AxACEReflectionOutput, type AxACEResult, AxAI, AxAIAnthropic, type AxAIAnthropicArgs, type AxAIAnthropicChatError, type AxAIAnthropicChatRequest, type AxAIAnthropicChatRequestCacheParam, type AxAIAnthropicChatResponse, type AxAIAnthropicChatResponseDelta, type AxAIAnthropicConfig, type AxAIAnthropicContentBlockDeltaEvent, type AxAIAnthropicContentBlockStartEvent, type AxAIAnthropicContentBlockStopEvent, type AxAIAnthropicEffortLevel, type AxAIAnthropicEffortLevelMapping, type AxAIAnthropicErrorEvent, type AxAIAnthropicFunctionTool, type AxAIAnthropicMessageDeltaEvent, type AxAIAnthropicMessageStartEvent, type AxAIAnthropicMessageStopEvent, AxAIAnthropicModel, type AxAIAnthropicOutputConfig, type AxAIAnthropicPingEvent, type AxAIAnthropicRequestTool, type AxAIAnthropicStopDetails, type AxAIAnthropicTaskBudget, type AxAIAnthropicThinkingConfig, type AxAIAnthropicThinkingTokenBudgetLevels, type AxAIAnthropicThinkingWire, AxAIAnthropicVertexModel, type AxAIAnthropicWebSearchTool, type AxAIArgs, AxAIAzureOpenAI, type AxAIAzureOpenAIArgs, type AxAIAzureOpenAIConfig, AxAICohere, type AxAICohereArgs, type AxAICohereChatRequest, type AxAICohereChatRequestToolResults, type AxAICohereChatResponse, type AxAICohereChatResponseDelta, type AxAICohereChatResponseToolCalls, type AxAICohereConfig, AxAICohereEmbedModel, type AxAICohereEmbedRequest, type AxAICohereEmbedResponse, AxAICohereModel, AxAIDeepSeek, type AxAIDeepSeekArgs, AxAIDeepSeekModel, type AxAIEmbedModels, type AxAIFeatures, AxAIGoogleGemini, type AxAIGoogleGeminiArgs, type AxAIGoogleGeminiBatchEmbedRequest, type AxAIGoogleGeminiBatchEmbedResponse, type AxAIGoogleGeminiCacheCreateRequest, type AxAIGoogleGeminiCacheResponse, type AxAIGoogleGeminiCacheUpdateRequest, type AxAIGoogleGeminiChatRequest, type AxAIGoogleGeminiChatResponse, type AxAIGoogleGeminiChatResponseDelta, type AxAIGoogleGeminiConfig, type AxAIGoogleGeminiContent, type AxAIGoogleGeminiContentPart, AxAIGoogleGeminiEmbedModel, AxAIGoogleGeminiEmbedTypes, type AxAIGoogleGeminiGenerationConfig, AxAIGoogleGeminiModel, type AxAIGoogleGeminiOptionsTools, type AxAIGoogleGeminiRetrievalConfig, AxAIGoogleGeminiSafetyCategory, type AxAIGoogleGeminiSafetySettings, AxAIGoogleGeminiSafetyThreshold, type AxAIGoogleGeminiThinkingConfig, type AxAIGoogleGeminiThinkingLevel, type AxAIGoogleGeminiThinkingLevelMapping, type AxAIGoogleGeminiThinkingTokenBudgetLevels, type AxAIGoogleGeminiTool, type AxAIGoogleGeminiToolConfig, type AxAIGoogleGeminiToolFunctionDeclaration, type AxAIGoogleGeminiToolGoogleMaps, type AxAIGoogleGeminiToolGoogleSearchRetrieval, type AxAIGoogleVertexBatchEmbedRequest, type AxAIGoogleVertexBatchEmbedResponse, AxAIGrok, type AxAIGrokArgs, type AxAIGrokChatRequest, AxAIGrokEmbedModels, AxAIGrokModel, type AxAIGrokOptionsTools, type AxAIGrokSearchSource, type AxAIInputModelList, type AxAIMemory, type AxAIMetricsInstruments, AxAIMistral, type AxAIMistralArgs, type AxAIMistralChatRequest, AxAIMistralEmbedModels, AxAIMistralModel, type AxAIModelCatalogAudioSupport, type AxAIModelCatalogFilter, type AxAIModelCatalogModel, type AxAIModelCatalogModelCapabilities, type AxAIModelCatalogModelType, type AxAIModelCatalogOptions, type AxAIModelCatalogProvider, type AxAIModelCatalogProviderName, type AxAIModelList, type AxAIModelListBase, type AxAIModels, AxAIOpenAI, type AxAIOpenAIAnnotation, type AxAIOpenAIArgs, AxAIOpenAIBase, type AxAIOpenAIBaseArgs, type AxAIOpenAIChatRequest, type AxAIOpenAIChatResponse, type AxAIOpenAIChatResponseDelta, type AxAIOpenAIConfig, AxAIOpenAIEmbedModel, type AxAIOpenAIEmbedRequest, type AxAIOpenAIEmbedResponse, type AxAIOpenAILogprob, AxAIOpenAIModel, type AxAIOpenAIResponseDelta, AxAIOpenAIResponses, type AxAIOpenAIResponsesArgs, AxAIOpenAIResponsesBase, type AxAIOpenAIResponsesCodeInterpreterToolCall, type AxAIOpenAIResponsesComputerToolCall, type AxAIOpenAIResponsesConfig, type AxAIOpenAIResponsesContentPartAddedEvent, type AxAIOpenAIResponsesContentPartDoneEvent, type AxAIOpenAIResponsesDefineFunctionTool, type AxAIOpenAIResponsesErrorEvent, type AxAIOpenAIResponsesFileSearchCallCompletedEvent, type AxAIOpenAIResponsesFileSearchCallInProgressEvent, type AxAIOpenAIResponsesFileSearchCallSearchingEvent, type AxAIOpenAIResponsesFileSearchToolCall, type AxAIOpenAIResponsesFunctionCallArgumentsDeltaEvent, type AxAIOpenAIResponsesFunctionCallArgumentsDoneEvent, type AxAIOpenAIResponsesFunctionCallItem, type AxAIOpenAIResponsesImageGenerationCallCompletedEvent, type AxAIOpenAIResponsesImageGenerationCallGeneratingEvent, type AxAIOpenAIResponsesImageGenerationCallInProgressEvent, type AxAIOpenAIResponsesImageGenerationCallPartialImageEvent, type AxAIOpenAIResponsesImageGenerationToolCall, type AxAIOpenAIResponsesInputAudioContentPart, type AxAIOpenAIResponsesInputContentPart, type AxAIOpenAIResponsesInputFunctionCallItem, type AxAIOpenAIResponsesInputFunctionCallOutputItem, type AxAIOpenAIResponsesInputImageUrlContentPart, type AxAIOpenAIResponsesInputItem, type AxAIOpenAIResponsesInputMessageItem, type AxAIOpenAIResponsesInputTextContentPart, type AxAIOpenAIResponsesLocalShellToolCall, type AxAIOpenAIResponsesMCPCallArgumentsDeltaEvent, type AxAIOpenAIResponsesMCPCallArgumentsDoneEvent, type AxAIOpenAIResponsesMCPCallCompletedEvent, type AxAIOpenAIResponsesMCPCallFailedEvent, type AxAIOpenAIResponsesMCPCallInProgressEvent, type AxAIOpenAIResponsesMCPListToolsCompletedEvent, type AxAIOpenAIResponsesMCPListToolsFailedEvent, type AxAIOpenAIResponsesMCPListToolsInProgressEvent, type AxAIOpenAIResponsesMCPToolCall, AxAIOpenAIResponsesModel, type AxAIOpenAIResponsesOutputItem, type AxAIOpenAIResponsesOutputItemAddedEvent, type AxAIOpenAIResponsesOutputItemDoneEvent, type AxAIOpenAIResponsesOutputMessageItem, type AxAIOpenAIResponsesOutputRefusalContentPart, type AxAIOpenAIResponsesOutputTextAnnotationAddedEvent, type AxAIOpenAIResponsesOutputTextContentPart, type AxAIOpenAIResponsesOutputTextDeltaEvent, type AxAIOpenAIResponsesOutputTextDoneEvent, type AxAIOpenAIResponsesReasoningDeltaEvent, type AxAIOpenAIResponsesReasoningDoneEvent, type AxAIOpenAIResponsesReasoningItem, type AxAIOpenAIResponsesReasoningSummaryDeltaEvent, type AxAIOpenAIResponsesReasoningSummaryDoneEvent, type AxAIOpenAIResponsesReasoningSummaryPart, type AxAIOpenAIResponsesReasoningSummaryPartAddedEvent, type AxAIOpenAIResponsesReasoningSummaryPartDoneEvent, type AxAIOpenAIResponsesReasoningSummaryTextDeltaEvent, type AxAIOpenAIResponsesReasoningSummaryTextDoneEvent, type AxAIOpenAIResponsesRefusalDeltaEvent, type AxAIOpenAIResponsesRefusalDoneEvent, type AxAIOpenAIResponsesRequest, type AxAIOpenAIResponsesResponse, type AxAIOpenAIResponsesResponseCompletedEvent, type AxAIOpenAIResponsesResponseCreatedEvent, type AxAIOpenAIResponsesResponseFailedEvent, type AxAIOpenAIResponsesResponseInProgressEvent, type AxAIOpenAIResponsesResponseIncompleteEvent, type AxAIOpenAIResponsesResponseQueuedEvent, type AxAIOpenAIResponsesStreamEvent, type AxAIOpenAIResponsesStreamEventBase, type AxAIOpenAIResponsesToolCall, type AxAIOpenAIResponsesToolCallBase, type AxAIOpenAIResponsesToolChoice, type AxAIOpenAIResponsesToolDefinition, type AxAIOpenAIResponsesWebSearchCallCompletedEvent, type AxAIOpenAIResponsesWebSearchCallInProgressEvent, type AxAIOpenAIResponsesWebSearchCallSearchingEvent, type AxAIOpenAIResponsesWebSearchToolCall, type AxAIOpenAIUrlCitation, type AxAIOpenAIUsage, AxAIRefusalError, AxAIReka, type AxAIRekaArgs, type AxAIRekaChatRequest, type AxAIRekaChatResponse, type AxAIRekaChatResponseDelta, type AxAIRekaConfig, AxAIRekaModel, type AxAIRekaUsage, type AxAIService, AxAIServiceAbortedError, type AxAIServiceActionOptions, AxAIServiceAuthenticationError, AxAIServiceError, type AxAIServiceImpl, type AxAIServiceMetrics, type AxAIServiceModelType, AxAIServiceNetworkError, type AxAIServiceOptions, AxAIServiceResponseError, AxAIServiceStatusError, AxAIServiceStreamTerminatedError, AxAIServiceTimeoutError, AxAIWebLLM, type AxAIWebLLMArgs, type AxAIWebLLMChatRequest, type AxAIWebLLMChatResponse, type AxAIWebLLMChatResponseDelta, type AxAIWebLLMConfig, type AxAIWebLLMEmbedModel, type AxAIWebLLMEmbedRequest, type AxAIWebLLMEmbedResponse, type AxAIWebLLMEngine, AxAIWebLLMModel, type AxAIWebLLMModelId, type AxAPI, type AxAPIConfig, type AxAPIResponseMetadata, AxAgent, type AxAgentActorTurnCallback, type AxAgentActorTurnCallbackArgs, type AxAgentAutoPromotionRecord, type AxAgentAutoUpgrade, type AxAgentCatalogSkill, type AxAgentCitations, type AxAgentCitationsOutput, type AxAgentClarification, type AxAgentClarificationChoice, AxAgentClarificationError, type AxAgentClarificationKind, type AxAgentCompletionProtocol, type AxAgentConfig, type AxAgentContextEvent, AxAgentContextMap, type AxAgentContextMapConfig, type AxAgentContextMapOperation, type AxAgentContextMapOptions, type AxAgentContextMapSnapshot, type AxAgentContextMapUpdateResult, type AxAgentContextPressure, type AxAgentContextStage, type AxAgentDemos, type AxAgentDirectResponse, type AxAgentDiscoveryPromptState, type AxAgentEvalBatchResult, type AxAgentEvalBudget, type AxAgentEvalDataset, type AxAgentEvalFunctionCall, type AxAgentEvalPrediction, type AxAgentEvalTask, type AxAgentExecutorResultPayload, type AxAgentFailureCluster, type AxAgentFailureReport, type AxAgentFailureSignal, type AxAgentFailureSignalKind, type AxAgentForwardOptions, type AxAgentFunction, type AxAgentFunctionCall, type AxAgentFunctionCallRecorder, type AxAgentFunctionCollection, type AxAgentFunctionExample, type AxAgentFunctionGroup, type AxAgentFunctionModuleMeta, type AxAgentGuidanceLogEntry, type AxAgentGuidancePayload, type AxAgentGuidanceState, type AxAgentIdentity, type AxAgentInputUpdateCallback, type AxAgentJudgeEvalInput, type AxAgentJudgeEvalOutput, type AxAgentJudgeInput, type AxAgentJudgeOptions, type AxAgentJudgeOutput, type AxAgentMemoriesSearchFn, type AxAgentMemoryEntry, type AxAgentMemoryResult, type AxAgentOnContextEvent, type AxAgentOnFunctionCall, type AxAgentOptimizationTargetDescriptor, type AxAgentOptimizeOptions, type AxAgentOptimizeResult, type AxAgentOptimizeTarget, type AxAgentOptions, AxAgentPlaybook, type AxAgentPlaybookConfig, type AxAgentPlaybookEvolveOptions, type AxAgentPlaybookEvolveOutcome, type AxAgentPlaybookEvolveProgressEvent, type AxAgentPlaybookEvolveProposal, type AxAgentPlaybookEvolveResult, type AxAgentPlaybookEvolveRunRecord, type AxAgentPlaybookLearnOptions, type AxAgentPlaybookOptions, type AxAgentPlaybookSkipReason, type AxAgentPlaybookUpdateResult, type AxAgentPlaybookUpdateStatus, type AxAgentPlaybookWeakness, AxAgentProtocolCompletionSignal, type AxAgentRecursionOptions, type AxAgentRecursiveExpensiveNode, type AxAgentRecursiveFunctionCall, type AxAgentRecursiveNodeRole, type AxAgentRecursiveStats, type AxAgentRecursiveTargetId, type AxAgentRecursiveTraceNode, type AxAgentRecursiveTurn, type AxAgentRecursiveUsage, type AxAgentRuntimeCompletionState, type AxAgentRuntimeExecutionContext, type AxAgentRuntimeInputState, AxAgentSharedRuntimeSession, type AxAgentSkillResult, type AxAgentSkillsPromptState, type AxAgentSkillsSearchFn, type AxAgentStagePolicy, type AxAgentStageVariant, type AxAgentState, type AxAgentStateActionLogEntry, type AxAgentStateCheckpointState, type AxAgentStateExecutorModelState, type AxAgentStateRuntimeEntry, type AxAgentStreamingForwardOptions, type AxAgentStructuredClarification, type AxAgentTestCompletionPayload, type AxAgentTestResult, type AxAgentUsage, type AxAgentUsedMemoriesCallback, type AxAgentUsedMemory, type AxAgentUsedSkill, type AxAgentUsedSkillsCallback, type AxAgentic, type AxAnyAgentic, type AxAssertion, AxAssertionError, type AxAttempt, type AxAudioFormat, type AxAudioInput, AxBalancer, type AxBalancerOptions, AxBaseAI, type AxBaseAIArgs, AxBaseOptimizer, AxBestOfN, type AxBestOfNOptions, AxBootstrapFewShot, type AxBootstrapOptimizerOptions, type AxChatAudioConfig, type AxChatAudioOutput, type AxChatLogEntry, type AxChatLogMessage, type AxChatRequest, type AxChatResponse, type AxChatResponseFunctionCall, type AxChatResponseResult, type AxCheckpointLoadFn, type AxCheckpointSaveFn, type AxCitation, type AxCodeRuntime, type AxCodeSession, type AxCodeSessionSnapshot, type AxCodeSessionSnapshotEntry, type AxCompileOptions, AxContentProcessingError, type AxContentProcessingServices, type AxContextCacheInfo, type AxContextCacheOperation, type AxContextCacheOptions, type AxContextCacheRegistry, type AxContextCacheRegistryEntry, type AxContextFieldInput, type AxContextFieldPromptConfig, AxContextMetricsCollector, type AxContextMetricsRow, type AxContextMetricsSummary, type AxContextPolicyBudget, type AxContextPolicyConfig, type AxContextPolicyPreset, type AxContextScenario, type AxContextTurnSample, type AxCostTracker, type AxCostTrackerOptions, type AxDateRange, type AxDateRangeValue, type AxDebugChatResponseUsage, AxDefaultCostTracker, type AxDiscoveryTurnSummary, type AxDockerContainer, AxDockerSession, type AxEmbedRequest, type AxEmbedResponse, AxEmbeddingAdapter, type AxErrorCategory, AxEvalUtil, type AxEvaluateArgs, type AxEvidenceDescriptor, type AxExample, type AxExamples, type AxExecutorModelPolicy, type AxExecutorModelPolicyEntry, type AxField, type AxFieldOptions, type AxFieldProcessor, type AxFieldProcessorProcess, type AxFieldTemplateFn, type AxFieldType, type AxFieldValue, AxFlow, type AxFlowBranchEvaluationData, type AxFlowCompleteData, type AxFlowDynamicContext, type AxFlowErrorData, type AxFlowExecutionPlan, type AxFlowExecutionPlanGroup, type AxFlowExecutionPlanStep, type AxFlowForwardOptions, type AxFlowLogData, type AxFlowLoggerData, type AxFlowLoggerFunction, type AxFlowOptions, type AxFlowParallelGroupCompleteData, type AxFlowParallelGroupStartData, type AxFlowStartData, type AxFlowState, type AxFlowStateDependencyAnalysis, type AxFlowStepCompleteData, type AxFlowStepStartData, type AxFlowTypedParallelBranch, type AxFlowTypedSubContext, type AxFlowable, type AxFluentFieldInfo, AxFluentFieldType, type AxForwardable, type AxFunction, type AxFunctionCallRecord, type AxFunctionCallTrace, AxFunctionError, type AxFunctionHandler, type AxFunctionJSONSchema, AxFunctionProcessor, type AxFunctionProvider, type AxFunctionResult, type AxFunctionResultFormatter, AxGEPA, type AxGEPAAdapter, type AxGEPABatchEvaluation, type AxGEPABatchRow, type AxGEPABootstrapOptions, type AxGEPAComponentBanditState, AxGEPAComponentSelector, type AxGEPAComponentTarget, type AxGEPAEvaluationBatch, type AxGEPAEvaluationState, type AxGEPAOptimizationReport, type AxGEPAReflectiveTuple, type AxGEPATraceSummary, type AxGEPATraceSummaryCall, AxGen, type AxGenDeltaOut, type AxGenIn, type AxGenInput, type AxGenMetricsInstruments, type AxGenOut, type AxGenOutput, type AxGenStreamingOut, AxGenerateError, type AxGenerateErrorDetails, type AxGenerateResult, type AxIField, type AxInputFunctionType, AxJSRuntime, type AxJSRuntimeNodePermissionAllowlist, type AxJSRuntimeOutputMode, AxJSRuntimePermission, type AxJSRuntimeResourceLimits, type AxJudgeForwardOptions, type AxJudgeOptions, type AxLlmQueryBudgetState, type AxLlmQueryPromptMode, type AxLoggerData, type AxLoggerFunction, type AxMCPAnnotations, type AxMCPAudioContent, type AxMCPBaseAnnotated, type AxMCPBlobResourceContents, AxMCPClient, type AxMCPClientCapabilities, type AxMCPClientOptions, type AxMCPCompletionArgument, type AxMCPCompletionReference, type AxMCPCompletionRequest, type AxMCPCompletionResult, type AxMCPContent, type AxMCPEmbeddedResource, type AxMCPFetchOptions, type AxMCPFunctionDescription, type AxMCPFunctionOverride, AxMCPHTTPSSETransport, type AxMCPIcon, type AxMCPImageContent, type AxMCPImplementationInfo, type AxMCPInitializeParams, type AxMCPInitializeResult, type AxMCPJSONRPCErrorResponse, type AxMCPJSONRPCMessage, type AxMCPJSONRPCNotification, type AxMCPJSONRPCRequest, type AxMCPJSONRPCResponse, type AxMCPJSONRPCSuccessResponse, type AxMCPJSONSchema, type AxMCPListRootsResult, type AxMCPLoggingLevel, type AxMCPMeta, type AxMCPOAuthOptions, type AxMCPPaginatedRequest, type AxMCPPrompt, type AxMCPPromptArgument, type AxMCPPromptGetResult, type AxMCPPromptMessage, type AxMCPPromptsListResult, type AxMCPProtocolVersion, type AxMCPResource, type AxMCPResourceLink, type AxMCPResourceReadResult, type AxMCPResourceTemplate, type AxMCPResourceTemplatesListResult, type AxMCPResourcesListResult, type AxMCPRoot, type AxMCPSSRFProtectionContext, type AxMCPSSRFProtectionOptions, type AxMCPServerCapabilities, AxMCPStreamableHTTPTransport, type AxMCPStreamableHTTPTransportOptions, AxMCPStreambleHTTPTransport, type AxMCPTextContent, type AxMCPTextResourceContents, type AxMCPTokenSet, type AxMCPTool, type AxMCPToolCallParams, type AxMCPToolCallResult, type AxMCPToolsListResult, type AxMCPTransport, AxMediaNotSupportedError, AxMemory, type AxMemoryData, type AxMemoryMessageValue, type AxMetricFn, type AxMetricFnArgs, type AxMetricsConfig, AxMockAIService, type AxMockAIServiceConfig, type AxModelConfig, type AxModelInfo, type AxModelInfoWithProvider, type AxModelUsage, type AxModuleRankInput, type AxMultiMetricFn, type AxMultiProviderConfig, AxMultiServiceRouter, type AxNamedProgramInstance, type AxOptimizableComponent, type AxOptimizableValidator, type AxOptimizationCheckpoint, type AxOptimizationProgress, type AxOptimizationStats, type AxOptimizeOptions, type AxOptimizedProgram, AxOptimizedProgramImpl, type AxOptimizer, type AxOptimizerArgs, type AxOptimizerLoggerData, type AxOptimizerLoggerFunction, type AxOptimizerMetricsConfig, type AxOptimizerMetricsInstruments, type AxOptimizerResult, type AxParetoResult, AxPlaybook, type AxPlaybookEvolveOptions, type AxPlaybookEvolveResult, type AxPlaybookOptions, type AxPlaybookSnapshot, AxProgram, type AxProgramDemos, type AxProgramExamples, type AxProgramForwardOptions, type AxProgramForwardOptionsWithModels, type AxProgramOptions, type AxProgramStreamingForwardOptions, type AxProgramStreamingForwardOptionsWithModels, type AxProgramTrace, type AxProgramUsage, type AxProgrammable, type AxPromptMetrics, AxPromptTemplate, type AxPromptTemplateOptions, type AxProviderMetadata, AxProviderRouter, type AxRLMConfig, type AxRankDocumentsOptions, type AxRankModulesOptions, type AxRankableDocument, type AxRankableField, type AxRankedDocument, type AxRankedModule, type AxRateLimiterFunction, AxRateLimiterTokenUsage, type AxRateLimiterTokenUsageOptions, AxRefine, AxRefineError, type AxRefineOptions, type AxRefineStrategy, type AxRelevanceHints, type AxRenderedPrompt, type AxResolvedAgentPlaybookConfig, type AxResolvedAgentPlaybookLearn, type AxResolvedAutoUpgrade, type AxResolvedCitations, type AxResolvedContextPolicy, type AxResolvedExecutorModelPolicy, type AxResolvedExecutorModelPolicyEntry, type AxResultPickerFunction, type AxResultPickerFunctionFieldResults, type AxResultPickerFunctionFunctionResults, type AxRewardFn, type AxRewardFnArgs, type AxRolloutTrace, type AxRoutingResult, type AxRuntimeCallableFormatArgs, type AxRuntimeLanguageInfo, type AxRuntimePrimitive, type AxRuntimePrimitiveExample, type AxRuntimePrimitiveOverrideMap, type AxRuntimePrimitiveSignature, type AxRuntimePrimitiveStage, type AxSamplePickerOptions, type AxSelfTuningConfig, type AxSerializedOptimizedProgram, type AxSetExamplesOptions, type AxSharedSessionPhase, AxSignature, AxSignatureBuilder, type AxSignatureConfig, type AxSignatureInput, type AxSpeechConfig, type AxSpeechRequest, type AxSpeechResponse, type AxStageDefinitionBuildOptions, type AxStageOptions, type AxStepContext, type AxStepHooks, type AxStepUsage, AxStopFunctionCallException, type AxStreamingAssertion, AxStreamingAssertionError, type AxStreamingEvent, type AxStreamingFieldProcessorProcess, AxStringUtil, AxSynth, type AxSynthExample, type AxSynthOptions, type AxSynthResult, type AxSynthesizerInit, type AxSynthesizerOptions, type AxSynthesizerRole, AxTestPrompt, type AxThoughtBlockItem, AxTokenLimitError, type AxTokenUsage, type AxTranscriptionRequest, type AxTranscriptionResponse, type AxTranscriptionSegment, type AxTunable, type AxTypedExample, type AxUsable, type AxWorkerRuntimeConfig, agent, ai, ax, axAIAnthropicDefaultConfig, axAIAnthropicVertexDefaultConfig, axAIAzureOpenAIBestConfig, axAIAzureOpenAICreativeConfig, axAIAzureOpenAIDefaultConfig, axAIAzureOpenAIFastConfig, axAICohereCreativeConfig, axAICohereDefaultConfig, axAIDeepSeekCodeConfig, axAIDeepSeekDefaultConfig, axAIGoogleGeminiDefaultConfig, axAIGoogleGeminiDefaultCreativeConfig, axAIGoogleGeminiLiveAudioDefaultConfig, axAIGrokBestConfig, axAIGrokDefaultConfig, axAIGrokVoiceDefaultConfig, axAIMistralBestConfig, axAIMistralDefaultConfig, axAIOpenAIAudioDefaultConfig, axAIOpenAIBestConfig, axAIOpenAICreativeConfig, axAIOpenAIDefaultConfig, axAIOpenAIFastConfig, axAIOpenAIRealtimeDefaultConfig, axAIOpenAIRealtimeTranscriptionDefaultConfig, axAIOpenAIResponsesBestConfig, axAIOpenAIResponsesCreativeConfig, axAIOpenAIResponsesDefaultConfig, axAIRekaBestConfig, axAIRekaCreativeConfig, axAIRekaDefaultConfig, axAIRekaFastConfig, axAIWebLLMCreativeConfig, axAIWebLLMDefaultConfig, axAnalyzeChatPromptRequirements, axAnalyzeRequestRequirements, axApplyOpenAIChatAudioRequest, axAudioFormatFromMimeType, axAudioInputFilename, axAudioInputToBlob, axAudioMimeType, axBaseAIDefaultConfig, axBaseAIDefaultCreativeConfig, axBuildDistillerDefinition, axBuildExecutorDefinition, axBuildResponderDefinition, axCheckMetricsHealth, axConcatBase64, axCreateDefaultColorLogger, axCreateDefaultOptimizerColorLogger, axCreateDefaultOptimizerTextLogger, axCreateDefaultTextLogger, axCreateFlowColorLogger, axCreateFlowTextLogger, axCreateGeminiLiveAudioApi, axCreateGrokRealtimeApi, axCreateJSRuntime, axCreateOpenAIRealtimeApi, axDefaultFlowLogger, axDefaultMetricsConfig, axDefaultOptimizerLogger, axDefaultOptimizerMetricsConfig, axDeserializeOptimizedProgram, axFetchJsonSpeech, axFetchMultipartTranscription, axGetCompatibilityReport, axGetFormatCompatibility, axGetMetricsConfig, axGetOptimizerMetricsConfig, axGetProvidersWithMediaSupport, axGetSupportedAIModels, axGlobals, axGoogleGeminiLiveAudioDefaults, axIsAudioOutputEnabled, axIsGeminiLiveAudioModel, axIsGrokVoiceModel, axIsOpenAIChatAudioModel, axIsOpenAIRealtimeModel, axIsOpenAIRealtimeTranscriptionModel, axMCPToolInputSchemaToFunctionSchema, axMapGeminiLiveAudioPart, axMapOpenAIChatAudioDelta, axMapOpenAIChatAudioResponse, axMapOpenAIInputAudioPart, axMergeChatAudioConfig, axModelInfoAnthropic, axModelInfoCohere, axModelInfoDeepSeek, axModelInfoGoogleGemini, axModelInfoGrok, axModelInfoMistral, axModelInfoOpenAI, axModelInfoOpenAIResponses, axModelInfoReka, axModelInfoWebLLM, axNormalizeOpenAIUsage, axNormalizeTranscriptionResponse, axOpenAIChatAudioDefaults, axOptimizableValidators, axPlaybookFailureSection, axProcessContentForProvider, axResolveGeminiLiveAudioConfig, axResolveGrokRealtimeAudioConfig, axResolveOpenAIChatAudioConfig, axResolveOpenAIRealtimeAudioConfig, axRuntimePrimitives, axScoreProvidersForRequest, axSelectOptimalProvider, axSerializeOptimizedProgram, axShouldUseGeminiLiveAudio, axShouldUseGrokRealtime, axShouldUseOpenAIRealtime, axSpanAttributes, axSpanEvents, axUpdateMetricsConfig, axUpdateOptimizerMetricsConfig, axValidateChatRequestMessage, axValidateChatResponseResult, axValidateGeminiLiveAudioInput, axValidateProviderCapabilities, axWorkerRuntime, bestOfN, f, flow, fn, optimize, playbook, refine, s };