lemura 1.2.0 → 1.4.0

package/dist/{storage-CG3nTa6o.d.mts → adapters-BhTAnrOM.d.mts}

@@ -1,6 +1,83 @@
 import { I as IRAGAdapter } from './rag-La_Bo-J8.mjs';
 import { I as ILogger } from './logger-DxvKliuk.mjs';
 
+/**
+ * Interface for Short Term Memory storage adapters.
+ * Implementations handle the persistence of STM variables.
+ */
+interface IStorageAdapter {
+    /**
+     * Retrieves content by its unique ID.
+     *
+     * @param id - The unique identifier of the stored content
+     * @returns The content or undefined if it does not exist
+     */
+    get(id: string): Promise<any | undefined>;
+    /**
+     * Saves content returning a stable ID if none was provided, or using the given ID.
+     *
+     * @param id - An optional unique identifier. If not provided, one should be generated.
+     * @param content - The content to be stored
+     * @param metadata - Optional metadata about the content (e.g. type, size)
+     * @returns A promise that resolves to the ID under which it was saved
+     */
+    set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string>;
+    /**
+     * Deletes content by its unique ID.
+     *
+     * @param id - The unique identifier of the content to delete
+     * @returns Resolves when deletion is complete
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Optional health check for remote storage adapters.
+     *
+     * @returns true if storage is accessible, false otherwise
+     */
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Interface for Scratchpad storage adapters.
+ * Implementations handle persistence of the scratchpad per session.
+ */
+interface IScratchpadAdapter {
+    /**
+     * Reads the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     * @returns The scratchpad content or undefined if none exists
+     */
+    read(sessionId: string): Promise<string | undefined>;
+    /**
+     * Writes the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     * @param content - The scratchpad content to store
+     */
+    write(sessionId: string, content: string): Promise<void>;
+    /**
+     * Clears the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     */
+    clear(sessionId: string): Promise<void>;
+    /**
+     * Optional health check for remote storage adapters.
+     *
+     * @returns true if storage is accessible, false otherwise
+     */
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Represents an item stored in Short Term Memory.
+ */
+interface STMItem {
+    id: string;
+    content: any;
+    type: 'text' | 'blob';
+    metadata?: Record<string, unknown>;
+}
+
 interface STMRegistryConfig {
     /**
      * The storage backend to use for Short Term Memory items.
@@ -66,6 +143,7 @@ interface ToolContext {
     ragAdapter?: IRAGAdapter;
     stmRegistry?: ShortTermMemoryRegistry;
     scratchpad?: string;
+    scratchpadAdapter?: IScratchpadAdapter;
 }
 interface IToolDefinition {
     name: string;
@@ -285,49 +363,4 @@ interface IProviderAdapter {
     healthCheck(): Promise<boolean>;
 }
 
-/**
- * Interface for Short Term Memory storage adapters.
- * Implementations handle the persistence of STM variables.
- */
-interface IStorageAdapter {
-    /**
-     * Retrieves content by its unique ID.
-     *
-     * @param id - The unique identifier of the stored content
-     * @returns The content or undefined if it does not exist
-     */
-    get(id: string): Promise<any | undefined>;
-    /**
-     * Saves content returning a stable ID if none was provided, or using the given ID.
-     *
-     * @param id - An optional unique identifier. If not provided, one should be generated.
-     * @param content - The content to be stored
-     * @param metadata - Optional metadata about the content (e.g. type, size)
-     * @returns A promise that resolves to the ID under which it was saved
-     */
-    set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string>;
-    /**
-     * Deletes content by its unique ID.
-     *
-     * @param id - The unique identifier of the content to delete
-     * @returns Resolves when deletion is complete
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Optional health check for remote storage adapters.
-     *
-     * @returns true if storage is accessible, false otherwise
-     */
-    healthCheck?(): Promise<boolean>;
-}
-/**
- * Represents an item stored in Short Term Memory.
- */
-interface STMItem {
-    id: string;
-    content: any;
-    type: 'text' | 'blob';
-    metadata?: Record<string, unknown>;
-}
-
-export { type AudioChunk as A, type ContextWindow as C, type IToolDefinition as I, type ModelInfo as M, type NormalizedMessage as N, ShortTermMemoryRegistry as S, type TranscriptionRequest as T, type VisionRequest as V, type IProviderAdapter as a, type IContextStrategy as b, type TranscriptionResponse as c, type SynthesisRequest as d, type VisionResponse as e, type ImageGenRequest as f, type ImageGenResponse as g, type Turn as h, type ContentBlock as i, type CompletionChunk as j, type CompletionRequest as k, type CompletionResponse as l, type IStorageAdapter as m, type STMItem as n, type STMRegistryConfig as o, type TokenUsage as p, type ToolCall as q, type ToolContext as r, type ToolResult as s };
+export { type AudioChunk as A, type ContextWindow as C, type IToolDefinition as I, type ModelInfo as M, type NormalizedMessage as N, ShortTermMemoryRegistry as S, type TranscriptionRequest as T, type VisionRequest as V, type IProviderAdapter as a, type IContextStrategy as b, type IScratchpadAdapter as c, type TranscriptionResponse as d, type SynthesisRequest as e, type VisionResponse as f, type ImageGenRequest as g, type ImageGenResponse as h, type Turn as i, type ContentBlock as j, type CompletionChunk as k, type CompletionRequest as l, type CompletionResponse as m, type IStorageAdapter as n, type STMItem as o, type STMRegistryConfig as p, type TokenUsage as q, type ToolCall as r, type ToolContext as s, type ToolResult as t };

package/dist/{storage-DBt_q0wO.d.ts → adapters-CVcfWf85.d.ts}

@@ -1,6 +1,83 @@
 import { I as IRAGAdapter } from './rag-La_Bo-J8.js';
 import { I as ILogger } from './logger-DxvKliuk.js';
 
+/**
+ * Interface for Short Term Memory storage adapters.
+ * Implementations handle the persistence of STM variables.
+ */
+interface IStorageAdapter {
+    /**
+     * Retrieves content by its unique ID.
+     *
+     * @param id - The unique identifier of the stored content
+     * @returns The content or undefined if it does not exist
+     */
+    get(id: string): Promise<any | undefined>;
+    /**
+     * Saves content returning a stable ID if none was provided, or using the given ID.
+     *
+     * @param id - An optional unique identifier. If not provided, one should be generated.
+     * @param content - The content to be stored
+     * @param metadata - Optional metadata about the content (e.g. type, size)
+     * @returns A promise that resolves to the ID under which it was saved
+     */
+    set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string>;
+    /**
+     * Deletes content by its unique ID.
+     *
+     * @param id - The unique identifier of the content to delete
+     * @returns Resolves when deletion is complete
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Optional health check for remote storage adapters.
+     *
+     * @returns true if storage is accessible, false otherwise
+     */
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Interface for Scratchpad storage adapters.
+ * Implementations handle persistence of the scratchpad per session.
+ */
+interface IScratchpadAdapter {
+    /**
+     * Reads the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     * @returns The scratchpad content or undefined if none exists
+     */
+    read(sessionId: string): Promise<string | undefined>;
+    /**
+     * Writes the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     * @param content - The scratchpad content to store
+     */
+    write(sessionId: string, content: string): Promise<void>;
+    /**
+     * Clears the scratchpad for a given session.
+     *
+     * @param sessionId - The session identifier
+     */
+    clear(sessionId: string): Promise<void>;
+    /**
+     * Optional health check for remote storage adapters.
+     *
+     * @returns true if storage is accessible, false otherwise
+     */
+    healthCheck?(): Promise<boolean>;
+}
+/**
+ * Represents an item stored in Short Term Memory.
+ */
+interface STMItem {
+    id: string;
+    content: any;
+    type: 'text' | 'blob';
+    metadata?: Record<string, unknown>;
+}
+
 interface STMRegistryConfig {
     /**
      * The storage backend to use for Short Term Memory items.
@@ -66,6 +143,7 @@ interface ToolContext {
     ragAdapter?: IRAGAdapter;
     stmRegistry?: ShortTermMemoryRegistry;
     scratchpad?: string;
+    scratchpadAdapter?: IScratchpadAdapter;
 }
 interface IToolDefinition {
     name: string;
@@ -285,49 +363,4 @@ interface IProviderAdapter {
     healthCheck(): Promise<boolean>;
 }
 
-/**
- * Interface for Short Term Memory storage adapters.
- * Implementations handle the persistence of STM variables.
- */
-interface IStorageAdapter {
-    /**
-     * Retrieves content by its unique ID.
-     *
-     * @param id - The unique identifier of the stored content
-     * @returns The content or undefined if it does not exist
-     */
-    get(id: string): Promise<any | undefined>;
-    /**
-     * Saves content returning a stable ID if none was provided, or using the given ID.
-     *
-     * @param id - An optional unique identifier. If not provided, one should be generated.
-     * @param content - The content to be stored
-     * @param metadata - Optional metadata about the content (e.g. type, size)
-     * @returns A promise that resolves to the ID under which it was saved
-     */
-    set(id: string | undefined, content: any, metadata?: Record<string, unknown>): Promise<string>;
-    /**
-     * Deletes content by its unique ID.
-     *
-     * @param id - The unique identifier of the content to delete
-     * @returns Resolves when deletion is complete
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Optional health check for remote storage adapters.
-     *
-     * @returns true if storage is accessible, false otherwise
-     */
-    healthCheck?(): Promise<boolean>;
-}
-/**
- * Represents an item stored in Short Term Memory.
- */
-interface STMItem {
-    id: string;
-    content: any;
-    type: 'text' | 'blob';
-    metadata?: Record<string, unknown>;
-}
-
-export { type AudioChunk as A, type ContextWindow as C, type IToolDefinition as I, type ModelInfo as M, type NormalizedMessage as N, ShortTermMemoryRegistry as S, type TranscriptionRequest as T, type VisionRequest as V, type IProviderAdapter as a, type IContextStrategy as b, type TranscriptionResponse as c, type SynthesisRequest as d, type VisionResponse as e, type ImageGenRequest as f, type ImageGenResponse as g, type Turn as h, type ContentBlock as i, type CompletionChunk as j, type CompletionRequest as k, type CompletionResponse as l, type IStorageAdapter as m, type STMItem as n, type STMRegistryConfig as o, type TokenUsage as p, type ToolCall as q, type ToolContext as r, type ToolResult as s };
+export { type AudioChunk as A, type ContextWindow as C, type IToolDefinition as I, type ModelInfo as M, type NormalizedMessage as N, ShortTermMemoryRegistry as S, type TranscriptionRequest as T, type VisionRequest as V, type IProviderAdapter as a, type IContextStrategy as b, type IScratchpadAdapter as c, type TranscriptionResponse as d, type SynthesisRequest as e, type VisionResponse as f, type ImageGenRequest as g, type ImageGenResponse as h, type Turn as i, type ContentBlock as j, type CompletionChunk as k, type CompletionRequest as l, type CompletionResponse as m, type IStorageAdapter as n, type STMItem as o, type STMRegistryConfig as p, type TokenUsage as q, type ToolCall as r, type ToolContext as s, type ToolResult as t };

package/dist/{agent-DxRd93wl.d.ts → agent-38El9_yp.d.ts}

@@ -1,6 +1,6 @@
-import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry } from './storage-DBt_q0wO.js';
+import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry, c as IScratchpadAdapter } from './adapters-CVcfWf85.js';
 import { I as ILogger } from './logger-DxvKliuk.js';
-import { I as ISkill } from './skills-wc8S-OvC.js';
+import { I as ISkill } from './skills-Y6D7zSSw.js';
 import { I as IRAGAdapter } from './rag-La_Bo-J8.js';
 
 /**
@@ -161,6 +161,8 @@ interface SessionConfig {
     adapter: IProviderAdapter;
     /** Model string */
     model: string;
+    /** Optional session id for scratchpad and tracing */
+    sessionId?: string;
     /** Max context tokens */
     maxTokens: number;
     /** Max ReAct cycles */
@@ -169,6 +171,22 @@ interface SessionConfig {
     tools?: IToolDefinition[];
     /** Explicit skills */
     skills?: ISkill[];
+    /**
+     * Names of dynamic skills (those with `strategy: 'dynamic'`) to enable
+     * automatically at session construction. Fixed skills are always active
+     * regardless of this list.
+     *
+     * @since 1.4.0
+     */
+    activeDynamicSkills?: string[];
+    /**
+     * Tags used to bulk-enable dynamic skills at session construction.
+     * Any dynamic skill whose `tags` array intersects with this list will be
+     * activated automatically.
+     *
+     * @since 1.4.0
+     */
+    activeDynamicTags?: string[];
     /** RAG adapter */
     ragAdapter?: IRAGAdapter;
     /** Context compression strategies */
@@ -194,12 +212,25 @@ interface SessionConfig {
     enableGoalPlanning?: boolean;
     goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
     goalInjectionPosition?: 'system_prompt' | 'pre_turn';
-    /** Skill budget */
+    /** Skill budget — max tokens the skill injection block may consume */
     skillTokenBudget?: number;
+    /**
+     * Maximum tokens the provider may generate per completion call.
+     * Defaults to 2 000 when not set. This is separate from `maxTokens`
+     * which controls the total context window size.
+     */
+    maxCompletionTokens?: number;
+    /**
+     * When `goalInjectionFrequency` is `'every_N_turns'`, re-inject the goal
+     * every N ReAct iterations. Default: 3.
+     */
+    goalInjectionN?: number;
     /** Callback for each turn in the session */
     onTurn?: (turn: any) => void;
     /** Short Term Memory Registry */
     stmRegistry?: ShortTermMemoryRegistry;
+    /** Scratchpad storage adapter */
+    scratchpadAdapter?: IScratchpadAdapter;
     /** Max tokens allowed for a single tool response */
     maxTokensPerTool?: number;
     /**
@@ -235,7 +266,7 @@ interface SessionConfig {
 /** Rich trace event for observability */
 interface TraceEvent {
     sessionId?: string;
-    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error';
+    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error' | 'skill';
     name: string;
     input?: any;
     output?: any;

package/dist/{agent-D6uhF-CZ.d.mts → agent-CJvmcAbT.d.mts}

@@ -1,6 +1,6 @@
-import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry } from './storage-CG3nTa6o.mjs';
+import { I as IToolDefinition, a as IProviderAdapter, b as IContextStrategy, S as ShortTermMemoryRegistry, c as IScratchpadAdapter } from './adapters-BhTAnrOM.mjs';
 import { I as ILogger } from './logger-DxvKliuk.mjs';
-import { I as ISkill } from './skills-wc8S-OvC.mjs';
+import { I as ISkill } from './skills-Y6D7zSSw.mjs';
 import { I as IRAGAdapter } from './rag-La_Bo-J8.mjs';
 
 /**
@@ -161,6 +161,8 @@ interface SessionConfig {
     adapter: IProviderAdapter;
     /** Model string */
     model: string;
+    /** Optional session id for scratchpad and tracing */
+    sessionId?: string;
     /** Max context tokens */
     maxTokens: number;
     /** Max ReAct cycles */
@@ -169,6 +171,22 @@ interface SessionConfig {
     tools?: IToolDefinition[];
     /** Explicit skills */
     skills?: ISkill[];
+    /**
+     * Names of dynamic skills (those with `strategy: 'dynamic'`) to enable
+     * automatically at session construction. Fixed skills are always active
+     * regardless of this list.
+     *
+     * @since 1.4.0
+     */
+    activeDynamicSkills?: string[];
+    /**
+     * Tags used to bulk-enable dynamic skills at session construction.
+     * Any dynamic skill whose `tags` array intersects with this list will be
+     * activated automatically.
+     *
+     * @since 1.4.0
+     */
+    activeDynamicTags?: string[];
     /** RAG adapter */
     ragAdapter?: IRAGAdapter;
     /** Context compression strategies */
@@ -194,12 +212,25 @@ interface SessionConfig {
     enableGoalPlanning?: boolean;
     goalInjectionFrequency?: 'always' | 'every_N_turns' | 'on_compression';
     goalInjectionPosition?: 'system_prompt' | 'pre_turn';
-    /** Skill budget */
+    /** Skill budget — max tokens the skill injection block may consume */
     skillTokenBudget?: number;
+    /**
+     * Maximum tokens the provider may generate per completion call.
+     * Defaults to 2 000 when not set. This is separate from `maxTokens`
+     * which controls the total context window size.
+     */
+    maxCompletionTokens?: number;
+    /**
+     * When `goalInjectionFrequency` is `'every_N_turns'`, re-inject the goal
+     * every N ReAct iterations. Default: 3.
+     */
+    goalInjectionN?: number;
     /** Callback for each turn in the session */
     onTurn?: (turn: any) => void;
     /** Short Term Memory Registry */
     stmRegistry?: ShortTermMemoryRegistry;
+    /** Scratchpad storage adapter */
+    scratchpadAdapter?: IScratchpadAdapter;
     /** Max tokens allowed for a single tool response */
     maxTokensPerTool?: number;
     /**
@@ -235,7 +266,7 @@ interface SessionConfig {
 /** Rich trace event for observability */
 interface TraceEvent {
     sessionId?: string;
-    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error';
+    type: 'planning' | 'budget' | 'tool_call' | 'tool_result' | 'thinking' | 'system' | 'compression' | 'error' | 'skill';
     name: string;
     input?: any;
     output?: any;

package/dist/context/index.d.mts

@@ -1,5 +1,5 @@
-import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, m as IStorageAdapter } from '../storage-CG3nTa6o.mjs';
-export { o as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../storage-CG3nTa6o.mjs';
+import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, n as IStorageAdapter, c as IScratchpadAdapter } from '../adapters-BhTAnrOM.mjs';
+export { p as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../adapters-BhTAnrOM.mjs';
 import '../rag-La_Bo-J8.mjs';
 import '../logger-DxvKliuk.mjs';
 
@@ -30,17 +30,25 @@ declare class ContextManager {
 interface SandwichCompressionConfig {
     preserveFirst: number;
     preserveLast: number;
-    triggerThreshold: number;
+    /** Fire when context reaches this fraction of maxTokens (e.g. 0.80 = 80%). Default: 0.80 */
+    triggerThreshold?: number;
+    /** Max tokens for the generated summary turn. Default: unlimited */
+    summaryMaxTokens?: number;
+    /** Strategy execution priority — lower number runs first. Default: 20 */
+    priority?: number;
 }
 /**
  * Sandwich compression preserves the beginning and end of the conversation,
  * replacing the middle with a generated summary.
+ *
+ * Pair with `SummaryInjectionStrategy` to ensure the compression summary is
+ * visible to the model on every subsequent call.
  */
 declare class SandwichCompressionStrategy implements IContextStrategy {
     private adapter;
     private config;
     readonly name = "sandwich_compression";
-    readonly priority = 20;
+    readonly priority: number;
     constructor(adapter: IProviderAdapter, config: SandwichCompressionConfig);
     shouldApply(ctx: ContextWindow): boolean;
     apply(ctx: ContextWindow): Promise<ContextWindow>;
@@ -71,22 +79,66 @@ declare class ScratchpadStrategy implements IContextStrategy {
     apply(ctx: ContextWindow): Promise<ContextWindow>;
 }
 interface HistoryCompressionConfig {
+    /** Number of oldest turns to summarize in each compression pass */
     windowSize: number;
+    /** Fire when context reaches this fraction of maxTokens (e.g. 0.8 = 80%) */
     triggerAtPercent: number;
+    /** Strategy execution priority — lower number runs first. Default: 30 */
+    priority?: number;
 }
 /**
- * Operates on a rolling window of the oldest N turns and summarizes them.
+ * Summarizes the oldest N uncompressed turns using a rolling-window approach.
+ *
+ * Pair with `SummaryInjectionStrategy` (priority < this one) to ensure the
+ * accumulated summary is re-injected before each provider call.
  */
 declare class HistoryCompressionStrategy implements IContextStrategy {
     private adapter;
     private config;
     readonly name = "history_compression";
-    readonly priority = 30;
+    readonly priority: number;
     constructor(adapter: IProviderAdapter, config: HistoryCompressionConfig);
     shouldApply(ctx: ContextWindow): boolean;
     apply(ctx: ContextWindow): Promise<ContextWindow>;
 }
 
+interface SummaryInjectionConfig {
+    /** Strategy priority — lower number runs first. Default: 1 (runs before compression). */
+    priority?: number;
+    /** Label prepended to the injected summary block. */
+    label?: string;
+}
+/**
+ * SummaryInjectionStrategy ensures that whenever a `compressionSummary` exists on
+ * the context window, it is re-injected as a synthetic system turn at the beginning
+ * of the turn list before each provider call.
+ *
+ * **Why this matters:** `HistoryCompressionStrategy` and `SandwichCompressionStrategy`
+ * store compressed context in `ctx.compressionSummary`, but without this strategy the
+ * summary never reaches the model — the pruned turns are simply gone.
+ *
+ * Pair this with any compression strategy:
+ *
+ * @example
+ * ```typescript
+ * compressionStrategies: [
+ *   new SummaryInjectionStrategy({ priority: 1 }),       // always runs first
+ *   new SandwichCompressionStrategy(adapter, { priority: 2, triggerThreshold: 0.80 }),
+ * ]
+ * ```
+ *
+ * The strategy is idempotent: if a summary turn already exists it is updated in-place
+ * rather than appended again.
+ */
+declare class SummaryInjectionStrategy implements IContextStrategy {
+    readonly name = "summary_injection";
+    readonly priority: number;
+    private readonly label;
+    constructor(config?: SummaryInjectionConfig);
+    shouldApply(ctx: ContextWindow): boolean;
+    apply(ctx: ContextWindow): Promise<ContextWindow>;
+}
+
 /**
  * An in-memory implementation of IStorageAdapter for holding Short Term Memory.
  * Ideal for testing or single-process lightweight usage.
@@ -139,4 +191,16 @@ declare class InMemoryStorageAdapter implements IStorageAdapter {
     healthCheck(): Promise<boolean>;
 }
 
-export { ContextManager, type HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryStorageAdapter, type SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy };
+/**
+ * In-memory scratchpad adapter, keyed by sessionId.
+ * Ideal for testing or single-process usage.
+ */
+declare class InMemoryScratchpadAdapter implements IScratchpadAdapter {
+    private store;
+    read(sessionId: string): Promise<string | undefined>;
+    write(sessionId: string, content: string): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+
+export { ContextManager, type HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryScratchpadAdapter, InMemoryStorageAdapter, type SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy, type SummaryInjectionConfig, SummaryInjectionStrategy };

package/dist/context/index.d.ts

@@ -1,5 +1,5 @@
-import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, m as IStorageAdapter } from '../storage-DBt_q0wO.js';
-export { o as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../storage-DBt_q0wO.js';
+import { b as IContextStrategy, C as ContextWindow, a as IProviderAdapter, n as IStorageAdapter, c as IScratchpadAdapter } from '../adapters-CVcfWf85.js';
+export { p as STMRegistryConfig, S as ShortTermMemoryRegistry } from '../adapters-CVcfWf85.js';
 import '../rag-La_Bo-J8.js';
 import '../logger-DxvKliuk.js';
 
@@ -30,17 +30,25 @@ declare class ContextManager {
 interface SandwichCompressionConfig {
     preserveFirst: number;
     preserveLast: number;
-    triggerThreshold: number;
+    /** Fire when context reaches this fraction of maxTokens (e.g. 0.80 = 80%). Default: 0.80 */
+    triggerThreshold?: number;
+    /** Max tokens for the generated summary turn. Default: unlimited */
+    summaryMaxTokens?: number;
+    /** Strategy execution priority — lower number runs first. Default: 20 */
+    priority?: number;
 }
 /**
  * Sandwich compression preserves the beginning and end of the conversation,
  * replacing the middle with a generated summary.
+ *
+ * Pair with `SummaryInjectionStrategy` to ensure the compression summary is
+ * visible to the model on every subsequent call.
  */
 declare class SandwichCompressionStrategy implements IContextStrategy {
     private adapter;
     private config;
     readonly name = "sandwich_compression";
-    readonly priority = 20;
+    readonly priority: number;
     constructor(adapter: IProviderAdapter, config: SandwichCompressionConfig);
     shouldApply(ctx: ContextWindow): boolean;
     apply(ctx: ContextWindow): Promise<ContextWindow>;
@@ -71,22 +79,66 @@ declare class ScratchpadStrategy implements IContextStrategy {
     apply(ctx: ContextWindow): Promise<ContextWindow>;
 }
 interface HistoryCompressionConfig {
+    /** Number of oldest turns to summarize in each compression pass */
     windowSize: number;
+    /** Fire when context reaches this fraction of maxTokens (e.g. 0.8 = 80%) */
     triggerAtPercent: number;
+    /** Strategy execution priority — lower number runs first. Default: 30 */
+    priority?: number;
 }
 /**
- * Operates on a rolling window of the oldest N turns and summarizes them.
+ * Summarizes the oldest N uncompressed turns using a rolling-window approach.
+ *
+ * Pair with `SummaryInjectionStrategy` (priority < this one) to ensure the
+ * accumulated summary is re-injected before each provider call.
  */
 declare class HistoryCompressionStrategy implements IContextStrategy {
     private adapter;
     private config;
     readonly name = "history_compression";
-    readonly priority = 30;
+    readonly priority: number;
     constructor(adapter: IProviderAdapter, config: HistoryCompressionConfig);
     shouldApply(ctx: ContextWindow): boolean;
     apply(ctx: ContextWindow): Promise<ContextWindow>;
 }
 
+interface SummaryInjectionConfig {
+    /** Strategy priority — lower number runs first. Default: 1 (runs before compression). */
+    priority?: number;
+    /** Label prepended to the injected summary block. */
+    label?: string;
+}
+/**
+ * SummaryInjectionStrategy ensures that whenever a `compressionSummary` exists on
+ * the context window, it is re-injected as a synthetic system turn at the beginning
+ * of the turn list before each provider call.
+ *
+ * **Why this matters:** `HistoryCompressionStrategy` and `SandwichCompressionStrategy`
+ * store compressed context in `ctx.compressionSummary`, but without this strategy the
+ * summary never reaches the model — the pruned turns are simply gone.
+ *
+ * Pair this with any compression strategy:
+ *
+ * @example
+ * ```typescript
+ * compressionStrategies: [
+ *   new SummaryInjectionStrategy({ priority: 1 }),       // always runs first
+ *   new SandwichCompressionStrategy(adapter, { priority: 2, triggerThreshold: 0.80 }),
+ * ]
+ * ```
+ *
+ * The strategy is idempotent: if a summary turn already exists it is updated in-place
+ * rather than appended again.
+ */
+declare class SummaryInjectionStrategy implements IContextStrategy {
+    readonly name = "summary_injection";
+    readonly priority: number;
+    private readonly label;
+    constructor(config?: SummaryInjectionConfig);
+    shouldApply(ctx: ContextWindow): boolean;
+    apply(ctx: ContextWindow): Promise<ContextWindow>;
+}
+
 /**
  * An in-memory implementation of IStorageAdapter for holding Short Term Memory.
  * Ideal for testing or single-process lightweight usage.
@@ -139,4 +191,16 @@ declare class InMemoryStorageAdapter implements IStorageAdapter {
     healthCheck(): Promise<boolean>;
 }
 
-export { ContextManager, type HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryStorageAdapter, type SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy };
+/**
+ * In-memory scratchpad adapter, keyed by sessionId.
+ * Ideal for testing or single-process usage.
+ */
+declare class InMemoryScratchpadAdapter implements IScratchpadAdapter {
+    private store;
+    read(sessionId: string): Promise<string | undefined>;
+    write(sessionId: string, content: string): Promise<void>;
+    clear(sessionId: string): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+
+export { ContextManager, type HistoryCompressionConfig, HistoryCompressionStrategy, InMemoryScratchpadAdapter, InMemoryStorageAdapter, type SandwichCompressionConfig, SandwichCompressionStrategy, ScratchpadStrategy, type SummaryInjectionConfig, SummaryInjectionStrategy };