@ax-llm/ax 21.0.10 → 21.0.12

package/index.d.cts

@@ -1,4 +1,4 @@
-import { Histogram, Counter, Gauge, Meter, Context, Tracer, Span } from '@opentelemetry/api';
+import { Histogram, Counter, Gauge, Context, Tracer, Span, Meter } from '@opentelemetry/api';
 
 type AxMemoryMessageValue = Omit<AxChatRequest['chatPrompt'][number], 'role'> | Omit<AxChatResponseResult, 'index'>;
 type AxMemoryData = {
@@ -1224,9 +1224,27 @@ declare class AxProgram<IN = any, OUT = any> implements AxUsable, AxTunable<IN,
     protected applyLocalOptimizedComponents(updates: Readonly<Record<string, string>>): void;
 }
 
-type AxGenerateResult<OUT> = OUT & {
-    thought?: string;
-};
+type AxFieldProcessorProcess = (value: AxFieldValue, context?: Readonly<{
+    values?: AxGenOut;
+    sessionId?: string;
+    done?: boolean;
+}>) => unknown | Promise<unknown>;
+type AxStreamingFieldProcessorProcess = (value: string, context?: Readonly<{
+    values?: AxGenOut;
+    sessionId?: string;
+    done?: boolean;
+}>) => unknown | Promise<unknown>;
+interface AxFieldProcessor {
+    field: Readonly<AxField>;
+    /**
+     * Process the field value and return a new value (or undefined if no update is needed).
+     * The returned value may be merged back into memory.
+     * @param value - The current field value.
+     * @param context - Additional context (e.g. memory and session id).
+     */
+    process: AxFieldProcessorProcess | AxStreamingFieldProcessorProcess;
+}
+
 interface AxResponseHandlerArgs<T> {
     ai: Readonly<AxAIService>;
     model?: string;
@@ -1243,6 +1261,10 @@ interface AxResponseHandlerArgs<T> {
     debugPromptMetrics?: Readonly<AxPromptMetrics>;
     onFunctionCall?: (call: Readonly<AxFunctionCallTrace>) => void | Promise<void>;
 }
+
+type AxGenerateResult<OUT> = OUT & {
+    thought?: string;
+};
 interface AxStreamingEvent<T> {
     event: 'delta' | 'done' | 'error';
     data: {
@@ -4392,6 +4414,14 @@ type AxAgentContextEvent = {
     resolvedByTurn: number;
     source: 'deterministic' | 'model';
     summaryChars: number;
+} | {
+    kind: 'action_compacted';
+    stage: AxAgentContextStage;
+    turn: number;
+    mode: 'distill' | 'compact';
+    reason: 'structured_output' | 'superseded' | 'pressure' | 'proactive' | 'lean';
+    originalChars: number;
+    renderedChars: number;
 };
 type AxAgentOnContextEvent = (event: Readonly<AxAgentContextEvent>) => void | Promise<void>;
 
@@ -4405,7 +4435,8 @@ type AxAgentOnContextEvent = (event: Readonly<AxAgentContextEvent>) => void | Pr
 
 type ActionLogTag = 'error' | 'dead-end' | 'foundational' | 'pivot' | 'superseded';
 type ActionLogStepKind = 'explore' | 'transform' | 'query' | 'finalize' | 'error';
-type ActionReplayMode = 'full' | 'omit';
+type ActionReplayMode = 'full' | 'distill' | 'compact' | 'omit';
+type ActionLogHygieneMode = 'none' | 'pressure' | 'proactive' | 'aggressive';
 type ActionLogFunctionCall = {
     qualifiedName: string;
     name?: string;
@@ -5705,6 +5736,10 @@ type AxResolvedContextPolicy = {
     summarizerOptions?: Omit<AxProgramForwardOptions<string>, 'functions'>;
     actionReplay: 'full' | 'adaptive' | 'minimal' | 'checkpointed';
     recentFullActions: number;
+    contextHygiene: {
+        defaultMode: ActionLogHygieneMode;
+        pressureMode?: ActionLogHygieneMode;
+    };
     errorPruning: boolean;
     hindsightEvaluation: boolean;
     pruneRank: number;
@@ -9620,27 +9655,6 @@ declare class AxTestPrompt<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut =
     run(metricFn: AxMetricFn): Promise<void>;
 }
 
-type AxFieldProcessorProcess = (value: AxFieldValue, context?: Readonly<{
-    values?: AxGenOut;
-    sessionId?: string;
-    done?: boolean;
-}>) => unknown | Promise<unknown>;
-type AxStreamingFieldProcessorProcess = (value: string, context?: Readonly<{
-    values?: AxGenOut;
-    sessionId?: string;
-    done?: boolean;
-}>) => unknown | Promise<unknown>;
-interface AxFieldProcessor {
-    field: Readonly<AxField>;
-    /**
-     * Process the field value and return a new value (or undefined if no update is needed).
-     * The returned value may be merged back into memory.
-     * @param value - The current field value.
-     * @param context - Additional context (e.g. memory and session id).
-     */
-    process: AxFieldProcessorProcess | AxStreamingFieldProcessorProcess;
-}
-
 type AxFunctionResultFormatter = (result: unknown) => string;
 declare const axGlobals: {
     signatureStrict: boolean;

package/index.d.ts

@@ -1,4 +1,4 @@
-import { Histogram, Counter, Gauge, Meter, Context, Tracer, Span } from '@opentelemetry/api';
+import { Histogram, Counter, Gauge, Context, Tracer, Span, Meter } from '@opentelemetry/api';
 
 type AxMemoryMessageValue = Omit<AxChatRequest['chatPrompt'][number], 'role'> | Omit<AxChatResponseResult, 'index'>;
 type AxMemoryData = {
@@ -1224,9 +1224,27 @@ declare class AxProgram<IN = any, OUT = any> implements AxUsable, AxTunable<IN,
     protected applyLocalOptimizedComponents(updates: Readonly<Record<string, string>>): void;
 }
 
-type AxGenerateResult<OUT> = OUT & {
-    thought?: string;
-};
+type AxFieldProcessorProcess = (value: AxFieldValue, context?: Readonly<{
+    values?: AxGenOut;
+    sessionId?: string;
+    done?: boolean;
+}>) => unknown | Promise<unknown>;
+type AxStreamingFieldProcessorProcess = (value: string, context?: Readonly<{
+    values?: AxGenOut;
+    sessionId?: string;
+    done?: boolean;
+}>) => unknown | Promise<unknown>;
+interface AxFieldProcessor {
+    field: Readonly<AxField>;
+    /**
+     * Process the field value and return a new value (or undefined if no update is needed).
+     * The returned value may be merged back into memory.
+     * @param value - The current field value.
+     * @param context - Additional context (e.g. memory and session id).
+     */
+    process: AxFieldProcessorProcess | AxStreamingFieldProcessorProcess;
+}
+
 interface AxResponseHandlerArgs<T> {
     ai: Readonly<AxAIService>;
     model?: string;
@@ -1243,6 +1261,10 @@ interface AxResponseHandlerArgs<T> {
     debugPromptMetrics?: Readonly<AxPromptMetrics>;
     onFunctionCall?: (call: Readonly<AxFunctionCallTrace>) => void | Promise<void>;
 }
+
+type AxGenerateResult<OUT> = OUT & {
+    thought?: string;
+};
 interface AxStreamingEvent<T> {
     event: 'delta' | 'done' | 'error';
     data: {
@@ -4392,6 +4414,14 @@ type AxAgentContextEvent = {
     resolvedByTurn: number;
     source: 'deterministic' | 'model';
     summaryChars: number;
+} | {
+    kind: 'action_compacted';
+    stage: AxAgentContextStage;
+    turn: number;
+    mode: 'distill' | 'compact';
+    reason: 'structured_output' | 'superseded' | 'pressure' | 'proactive' | 'lean';
+    originalChars: number;
+    renderedChars: number;
 };
 type AxAgentOnContextEvent = (event: Readonly<AxAgentContextEvent>) => void | Promise<void>;
 
@@ -4405,7 +4435,8 @@ type AxAgentOnContextEvent = (event: Readonly<AxAgentContextEvent>) => void | Pr
 
 type ActionLogTag = 'error' | 'dead-end' | 'foundational' | 'pivot' | 'superseded';
 type ActionLogStepKind = 'explore' | 'transform' | 'query' | 'finalize' | 'error';
-type ActionReplayMode = 'full' | 'omit';
+type ActionReplayMode = 'full' | 'distill' | 'compact' | 'omit';
+type ActionLogHygieneMode = 'none' | 'pressure' | 'proactive' | 'aggressive';
 type ActionLogFunctionCall = {
     qualifiedName: string;
     name?: string;
@@ -5705,6 +5736,10 @@ type AxResolvedContextPolicy = {
     summarizerOptions?: Omit<AxProgramForwardOptions<string>, 'functions'>;
     actionReplay: 'full' | 'adaptive' | 'minimal' | 'checkpointed';
     recentFullActions: number;
+    contextHygiene: {
+        defaultMode: ActionLogHygieneMode;
+        pressureMode?: ActionLogHygieneMode;
+    };
     errorPruning: boolean;
     hindsightEvaluation: boolean;
     pruneRank: number;
@@ -9620,27 +9655,6 @@ declare class AxTestPrompt<IN extends AxGenIn = AxGenIn, OUT extends AxGenOut =
     run(metricFn: AxMetricFn): Promise<void>;
 }
 
-type AxFieldProcessorProcess = (value: AxFieldValue, context?: Readonly<{
-    values?: AxGenOut;
-    sessionId?: string;
-    done?: boolean;
-}>) => unknown | Promise<unknown>;
-type AxStreamingFieldProcessorProcess = (value: string, context?: Readonly<{
-    values?: AxGenOut;
-    sessionId?: string;
-    done?: boolean;
-}>) => unknown | Promise<unknown>;
-interface AxFieldProcessor {
-    field: Readonly<AxField>;
-    /**
-     * Process the field value and return a new value (or undefined if no update is needed).
-     * The returned value may be merged back into memory.
-     * @param value - The current field value.
-     * @param context - Additional context (e.g. memory and session id).
-     */
-    process: AxFieldProcessorProcess | AxStreamingFieldProcessorProcess;
-}
-
 type AxFunctionResultFormatter = (result: unknown) => string;
 declare const axGlobals: {
     signatureStrict: boolean;