@applica-software-guru/persona-sdk 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export declare interface Agent {
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
     shortTermMemory?: StmConfiguration;
+    contextManagement?: ContextManagementConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
 }
@@ -61,6 +62,7 @@ export declare interface AgentCreateRequest {
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
     shortTermMemory?: StmConfiguration;
+    contextManagement?: ContextManagementConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
 }
@@ -246,6 +248,19 @@ export declare interface ContentValue {
     content?: ContentItem[];
 }
 
+declare interface ContextManagementConfiguration {
+    enabled?: boolean;
+    maxContextTokens?: number;
+    maskingThreshold?: number;
+    summarizationThreshold?: number;
+    keepLastNObservations?: number;
+    keepLastNIterations?: number;
+    minGrowthToRecompact?: number;
+    truncationEnabled?: boolean;
+    maxObservationTokens?: number;
+    compactionModel?: ModelConfiguration;
+}
+
 export declare interface CreateCustomerRequest {
     owner?: string;
     name?: string;
@@ -651,7 +666,7 @@ export declare interface ModelConfiguration {
     openaiCompatibleApiKey?: string;
 }
 
-export declare type ModelName = 'gemini-3-pro' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-2.0-flash' | 'gemini-1.5-flash' | 'gemini-1.5-pro' | 'gemini-2.5-pro-exp-03-25' | 'gemini-2.0-flash-001' | 'gemini-2.0-flash-lite' | 'gemini-2.0-flash-lite-001' | 'gemini-1.5-flash-latest' | 'gemini-1.5-flash-001' | 'gemini-1.5-flash-002' | 'gemini-1.5-pro-latest' | 'gemini-1.5-pro-001' | 'gemini-1.5-pro-002' | 'gpt-5.2' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.5' | 'o1' | 'o1-mini' | 'o3-mini' | 'o4-mini' | 'o4-mini-high' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'accounts/fireworks/models/minimax-m2p5' | 'accounts/fireworks/models/deepseek-v3p2' | 'accounts/fireworks/models/kimi-k2p5' | 'accounts/fireworks/models/glm-5' | 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-code-fast-1' | 'grok-4-fast-reasoning' | 'grok-4-fast-non-reasoning' | 'grok-4-0709' | 'grok-3-mini' | 'grok-3' | 'grok-2-vision-1212' | 'ollama' | 'openai-compatible';
+export declare type ModelName = 'gemini-3-pro' | 'gemini-3-flash-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-lite-preview' | 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-2.0-flash' | 'gemini-1.5-flash' | 'gemini-1.5-pro' | 'gemini-2.5-pro-exp-03-25' | 'gemini-2.0-flash-001' | 'gemini-2.0-flash-lite' | 'gemini-2.0-flash-lite-001' | 'gemini-1.5-flash-latest' | 'gemini-1.5-flash-001' | 'gemini-1.5-flash-002' | 'gemini-1.5-pro-latest' | 'gemini-1.5-pro-001' | 'gemini-1.5-pro-002' | 'gpt-5.5' | 'gpt-5.4' | 'gpt-5.3' | 'gpt-5.2' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.5' | 'o1' | 'o1-mini' | 'o3-mini' | 'o4-mini' | 'o4-mini-high' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'accounts/fireworks/models/minimax-m2p7' | 'accounts/fireworks/models/minimax-m2p5' | 'accounts/fireworks/models/deepseek-v3p2' | 'accounts/fireworks/models/kimi-k2p5' | 'accounts/fireworks/models/glm-5' | 'accounts/fireworks/models/glm-5.1' | 'accounts/fireworks/models/qwen3p6-plus' | 'grok-4-1-fast-reasoning' | 'grok-4-1-fast-non-reasoning' | 'grok-code-fast-1' | 'grok-4-fast-reasoning' | 'grok-4-fast-non-reasoning' | 'grok-4-0709' | 'grok-3-mini' | 'grok-3' | 'grok-2-vision-1212' | 'ollama' | 'openai-compatible';
 
 export declare type ModelProvider = 'google' | 'openai' | 'grok' | 'fireworks' | 'ollama' | 'openai_compatible';
 
@@ -979,9 +994,12 @@ export declare interface StmConfiguration {
     includeToolCalls?: boolean;
     model?: ModelConfiguration;
     maxNumberOfWords?: number;
+    keepLastNObservations?: number;
+    maskingThreshold?: number;
+    maxContextTokens?: number;
 }
 
-export declare type StmType = 'simple' | 'summary';
+export declare type StmType = 'simple' | 'summary' | 'compact';
 
 export declare interface Subscription {
     id?: string;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@applica-software-guru/persona-sdk",
   "description": "Official TypeScript SDK for the Persona API — manage agents, sessions, projects, knowledge bases, workflows, triggers and more.",
   "private": false,
-  "version": "0.1.14",
+  "version": "0.1.15",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/agents/types.ts

@@ -6,6 +6,9 @@ export type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt
 
 export type ModelName =
   | 'gemini-3-pro'
+  | 'gemini-3-flash-preview'
+  | 'gemini-3.1-pro-preview'
+  | 'gemini-3.1-flash-lite-preview'
   | 'gemini-2.5-pro'
   | 'gemini-2.5-flash'
   | 'gemini-2.5-flash-lite'
@@ -22,6 +25,9 @@ export type ModelName =
   | 'gemini-1.5-pro-latest'
   | 'gemini-1.5-pro-001'
   | 'gemini-1.5-pro-002'
+  | 'gpt-5.5'
+  | 'gpt-5.4'
+  | 'gpt-5.3'
   | 'gpt-5.2'
   | 'gpt-5'
   | 'gpt-5-mini'
@@ -39,10 +45,13 @@ export type ModelName =
   | 'o4-mini-high'
   | 'gpt-3.5-turbo'
   | 'gpt-3.5-turbo-16k'
+  | 'accounts/fireworks/models/minimax-m2p7'
   | 'accounts/fireworks/models/minimax-m2p5'
   | 'accounts/fireworks/models/deepseek-v3p2'
   | 'accounts/fireworks/models/kimi-k2p5'
   | 'accounts/fireworks/models/glm-5'
+  | 'accounts/fireworks/models/glm-5.1'
+  | 'accounts/fireworks/models/qwen3p6-plus'
   | 'grok-4-1-fast-reasoning'
   | 'grok-4-1-fast-non-reasoning'
   | 'grok-code-fast-1'
@@ -59,7 +68,7 @@ export type SynthesizerName = 'gcloud' | 'elevenlabs' | 'gtts' | 'openai';
 
 export type TranscriberName = 'gcloud' | 'deepgram' | 'vosk';
 
-export type StmType = 'simple' | 'summary';
+export type StmType = 'simple' | 'summary' | 'compact';
 
 export type ToolType = 'remote' | 'local';
 
@@ -272,6 +281,22 @@ export interface StmConfiguration {
   includeToolCalls?: boolean;
   model?: ModelConfiguration;
   maxNumberOfWords?: number;
+  keepLastNObservations?: number;
+  maskingThreshold?: number;
+  maxContextTokens?: number;
+}
+
+export interface ContextManagementConfiguration {
+  enabled?: boolean;
+  maxContextTokens?: number;
+  maskingThreshold?: number;
+  summarizationThreshold?: number;
+  keepLastNObservations?: number;
+  keepLastNIterations?: number;
+  minGrowthToRecompact?: number;
+  truncationEnabled?: boolean;
+  maxObservationTokens?: number;
+  compactionModel?: ModelConfiguration;
 }
 
 export interface Revision {
@@ -310,6 +335,7 @@ export interface Agent {
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
   shortTermMemory?: StmConfiguration;
+  contextManagement?: ContextManagementConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
 }
@@ -339,6 +365,7 @@ export interface AgentCreateRequest {
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
   shortTermMemory?: StmConfiguration;
+  contextManagement?: ContextManagementConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
 }