@applica-software-guru/persona-sdk 0.1.102 → 0.1.104

package/dist/index.d.ts

@@ -29,8 +29,7 @@ export declare interface Agent {
     network?: NetworkConfiguration;
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
-    shortTermMemory?: StmConfiguration;
-    contextManagement?: ContextManagementConfiguration;
+    compaction?: CompactionConfiguration;
     attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
@@ -64,8 +63,7 @@ export declare interface AgentCreateRequest {
     network?: NetworkConfiguration;
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
-    shortTermMemory?: StmConfiguration;
-    contextManagement?: ContextManagementConfiguration;
+    compaction?: CompactionConfiguration;
     attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
@@ -260,6 +258,17 @@ export declare interface CommittedUsage {
     details?: UsageCost[];
 }
 
+export declare interface CompactionConfiguration {
+    /** Enable automatic context compaction. Default: true. */
+    enabled?: boolean;
+    /** Headroom kept free below the context window. Default: 16384. */
+    reserveTokens?: number;
+    /** Token budget of recent conversation never summarized. Default: 20000. */
+    keepRecentTokens?: number;
+    /** Model used to generate the summary. Defaults to the agent's main model. */
+    model?: ModelConfiguration;
+}
+
 export declare interface Connection {
     id?: string;
     sourceId?: string;
@@ -282,20 +291,6 @@ export declare interface ContentValue {
     content?: ContentItem[];
 }
 
-export declare interface ContextManagementConfiguration {
-    enabled?: boolean;
-    maxContextTokens?: number;
-    summarizationThreshold?: number;
-    keepLastNIterations?: number;
-    keepFirstMessage?: boolean;
-    maxToolCallsBeforeCompaction?: number;
-    useLlmCompaction?: boolean;
-    maxSummaryWords?: number;
-    truncationEnabled?: boolean;
-    maxObservationTokens?: number;
-    compactionModel?: ModelConfiguration;
-}
-
 export declare interface CreateCustomerRequest {
     owner?: string;
     name?: string;
@@ -656,23 +651,6 @@ export declare interface KnowledgeConfiguration {
 
 export declare type KnowledgeType = 'multi_hop' | 'simple';
 
-export declare interface KnownModel {
-    id?: string;
-    provider?: string;
-    modelName?: string;
-    label?: string;
-    deprecated?: boolean;
-}
-
-export declare class KnownModelsApi extends HttpApi {
-    constructor(baseUrl: string, auth: string | AuthenticationProvider);
-    list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnownModel>>;
-    get(id: string): Promise<KnownModel>;
-    create(knownModel: KnownModel): Promise<KnownModel>;
-    update(id: string, knownModel: KnownModel): Promise<KnownModel>;
-    remove(id: string): Promise<void>;
-}
-
 export declare type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt-BR';
 
 export declare interface LineItem {
@@ -684,6 +662,26 @@ export declare interface LineItem {
     periodEnd?: string;
 }
 
+export declare interface MarkupRule {
+    id?: string;
+    pattern?: string;
+    percentage?: number;
+}
+
+/**
+ * Global markup rules (super admin only). Markup no longer lives on the
+ * ServicePrice: there is a single platform-wide list of {pattern, percentage}
+ * rules matched against usage service codes (most-specific-wins, "*" fallback).
+ */
+export declare class MarkupRulesApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(keyword?: string | null, page?: number, size?: number): Promise<Paginated<MarkupRule>>;
+    get(id: string): Promise<MarkupRule>;
+    create(markupRule: MarkupRule): Promise<MarkupRule>;
+    update(id: string, markupRule: MarkupRule): Promise<MarkupRule>;
+    remove(id: string): Promise<void>;
+}
+
 export declare interface McpServerConfiguration {
     type?: string;
     name?: string;
@@ -717,6 +715,8 @@ export declare interface Message {
     task?: Record<string, unknown>;
     sender?: string;
     thought?: boolean;
+    /** True when this message is a context-compaction summary (injected by compaction). */
+    isCompactionSummary?: boolean;
 }
 
 export declare interface Mission {
@@ -760,6 +760,8 @@ export declare interface ModelConfiguration {
     reasoningEffort?: ReasoningEffort;
     /** Maximum number of output tokens to generate. Undefined = provider default. */
     maxOutputTokens?: number;
+    /** Total context window (input) of the model, in tokens. Used by compaction. Undefined = default (128000). */
+    contextWindow?: number;
     /** Override the per-provider default API key (env var) when set. */
     apiKey?: string;
     /** Override the per-provider default base URL when set. */
@@ -886,8 +888,10 @@ export declare class PersonaSdk {
     triggers(authProvider: AuthenticationProvider): TriggersApi;
     servicePrices(apiKey: string): ServicePricesApi;
     servicePrices(authProvider: AuthenticationProvider): ServicePricesApi;
-    knownModels(apiKey: string): KnownModelsApi;
-    knownModels(authProvider: AuthenticationProvider): KnownModelsApi;
+    markupRules(apiKey: string): MarkupRulesApi;
+    markupRules(authProvider: AuthenticationProvider): MarkupRulesApi;
+    providers(apiKey: string): ProvidersApi;
+    providers(authProvider: AuthenticationProvider): ProvidersApi;
     sessions(apiKey: string): SessionsApi;
     sessions(authProvider: AuthenticationProvider): SessionsApi;
     missions(apiKey: string): MissionsApi;
@@ -961,6 +965,51 @@ export declare interface ProjectUpdateRequest {
     tag?: string;
 }
 
+export declare interface Provider {
+    id?: string;
+    /** litellm provider name, e.g. "openai", "anthropic", "vertex_ai". */
+    name?: string;
+    /** null/undefined => global; set => per-project override. */
+    projectId?: string | null;
+    /** Write-only; returned masked ("********") on reads. */
+    apiKey?: string;
+    baseUrl?: string;
+    /** Provider-specific extras (e.g. vertexProject, vertexLocation, vertexCredentials). */
+    config?: Record<string, unknown>;
+}
+
+/** A model suggestion for a provider, with litellm capability flags. */
+export declare interface ProviderModel {
+    id: string;
+    contextWindow?: number;
+    supportsVision?: boolean;
+    supportsFunctionCalling?: boolean;
+    supportsAudioInput?: boolean;
+    supportsPdfInput?: boolean;
+    supportsReasoning?: boolean;
+}
+
+/**
+ * Managed LLM providers (super admin only). Providers bind a litellm provider
+ * name to its credentials; global or per-project (override). API keys are stored
+ * encrypted and returned masked.
+ */
+export declare class ProvidersApi extends HttpApi {
+    constructor(baseUrl: string, auth: string | AuthenticationProvider);
+    list(projectId?: string | null, keyword?: string | null, page?: number, size?: number): Promise<Paginated<Provider>>;
+    get(id: string): Promise<Provider>;
+    create(provider: Provider): Promise<Provider>;
+    update(id: string, provider: Provider): Promise<Provider>;
+    remove(id: string): Promise<void>;
+    /** Provider names litellm supports (for the "add provider" picker). Admin. */
+    available(): Promise<string[]>;
+    /** Names of providers configured for the caller (global + their project), no
+     * credentials. Authenticated (not admin) — for the model selector. */
+    names(): Promise<string[]>;
+    /** Model suggestions (chat, with capabilities) for a provider, from litellm. */
+    models(provider: string): Promise<ProviderModel[]>;
+}
+
 export declare type ReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
 
 export declare interface Ref {
@@ -1004,7 +1053,6 @@ export declare interface ServicePrice {
     service?: string;
     cost?: number;
     unit?: string;
-    markupPercentage?: number;
     fixedPrice?: number;
 }
 
@@ -1134,20 +1182,6 @@ export declare interface Step {
     output?: Record<string, unknown>;
 }
 
-export declare interface StmConfiguration {
-    type?: StmType;
-    maxMessages?: number;
-    includeToolCalls?: boolean;
-    model?: ModelConfiguration;
-    maxNumberOfWords?: number;
-    keepLastNObservations?: number;
-    maskingThreshold?: number;
-    summaryThreshold?: number;
-    maxContextTokens?: number;
-}
-
-export declare type StmType = 'simple' | 'summary' | 'compact';
-
 export declare interface Subscription {
     id?: string;
     projectId?: string;
@@ -1390,7 +1424,6 @@ export declare class ValuesApi extends HttpApi {
     getTranscriberNames(): Promise<string[]>;
     getSynthesizerNames(): Promise<string[]>;
     getSynthesizerVoices(synthesizerName: string): Promise<string[]>;
-    getStmTypes(): Promise<string[]>;
     getDocumentExtractors(): Promise<string[]>;
     getEmbeddingModels(): Promise<string[]>;
     getQualityOptions(): Promise<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.102",
+  "version": "0.1.104",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/agents/types.ts

@@ -9,7 +9,6 @@ export type SynthesizerName = 'gcloud' | 'elevenlabs' | 'gtts' | 'openai';
 
 export type TranscriberName = 'gcloud' | 'deepgram' | 'vosk';
 
-export type StmType = 'simple' | 'summary' | 'compact';
 
 export type ToolType = 'remote' | 'local';
 
@@ -43,6 +42,8 @@ export interface ModelConfiguration {
   reasoningEffort?: ReasoningEffort;
   /** Maximum number of output tokens to generate. Undefined = provider default. */
   maxOutputTokens?: number;
+  /** Total context window (input) of the model, in tokens. Used by compaction. Undefined = default (128000). */
+  contextWindow?: number;
   /** Override the per-provider default API key (env var) when set. */
   apiKey?: string;
   /** Override the per-provider default base URL when set. */
@@ -245,30 +246,15 @@ export interface ToolkitConfiguration {
   tools?: Tool[];
 }
 
-export interface StmConfiguration {
-  type?: StmType;
-  maxMessages?: number;
-  includeToolCalls?: boolean;
-  model?: ModelConfiguration;
-  maxNumberOfWords?: number;
-  keepLastNObservations?: number;
-  maskingThreshold?: number;
-  summaryThreshold?: number;
-  maxContextTokens?: number;
-}
-
-export interface ContextManagementConfiguration {
+export interface CompactionConfiguration {
+  /** Enable automatic context compaction. Default: true. */
   enabled?: boolean;
-  maxContextTokens?: number;
-  summarizationThreshold?: number;
-  keepLastNIterations?: number;
-  keepFirstMessage?: boolean;
-  maxToolCallsBeforeCompaction?: number;
-  useLlmCompaction?: boolean;
-  maxSummaryWords?: number;
-  truncationEnabled?: boolean;
-  maxObservationTokens?: number;
-  compactionModel?: ModelConfiguration;
+  /** Headroom kept free below the context window. Default: 16384. */
+  reserveTokens?: number;
+  /** Token budget of recent conversation never summarized. Default: 20000. */
+  keepRecentTokens?: number;
+  /** Model used to generate the summary. Defaults to the agent's main model. */
+  model?: ModelConfiguration;
 }
 
 export interface Revision {
@@ -307,8 +293,7 @@ export interface Agent {
   network?: NetworkConfiguration;
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
-  shortTermMemory?: StmConfiguration;
-  contextManagement?: ContextManagementConfiguration;
+  compaction?: CompactionConfiguration;
   attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
@@ -339,8 +324,7 @@ export interface AgentCreateRequest {
   network?: NetworkConfiguration;
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
-  shortTermMemory?: StmConfiguration;
-  contextManagement?: ContextManagementConfiguration;
+  compaction?: CompactionConfiguration;
   attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;

package/src/index.ts

@@ -47,14 +47,12 @@ export type {
   ToolRemoteConfig,
   ToolDefinition,
   ToolkitConfiguration,
-  StmConfiguration,
-  StmType,
+  CompactionConfiguration,
   Revision,
   AgentType,
   ReasoningEffort,
   ModelProvider,
   CollaborationMode,
-  ContextManagementConfiguration,
   AttachmentsPreprocessorConfiguration,
   AttachmentsPreprocessorImageHandling,
 } from './agents/types';
@@ -154,8 +152,10 @@ export { MissionsApi } from './missions/missions-api';
 export type { Mission, MissionStatus } from './missions/types';
 export { ServicePricesApi } from './service-prices/service-prices-api';
 export type { ServicePrice } from './service-prices/types';
-export { KnownModelsApi } from './known-models/known-models-api';
-export type { KnownModel } from './known-models/types';
+export { MarkupRulesApi } from './markup-rules/markup-rules-api';
+export type { MarkupRule } from './markup-rules/types';
+export { ProvidersApi } from './providers/providers-api';
+export type { Provider, ProviderModel } from './providers/types';
 export type { Revision as RevisionType } from './revisions/types';
 export { BillingClient } from './billing/billing-client';
 export { ValuesApi } from './values/values-api';

package/src/markup-rules/markup-rules-api.ts

@@ -0,0 +1,38 @@
+import { HttpApi } from '../http-api';
+import { Paginated } from '../paginated';
+import { AuthenticationProvider } from '../auth/authentication-provider';
+import { MarkupRule } from './types';
+
+/**
+ * Global markup rules (super admin only). Markup no longer lives on the
+ * ServicePrice: there is a single platform-wide list of {pattern, percentage}
+ * rules matched against usage service codes (most-specific-wins, "*" fallback).
+ */
+export class MarkupRulesApi extends HttpApi {
+  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
+    super(baseUrl, auth);
+  }
+
+  async list(keyword?: string | null, page?: number, size?: number): Promise<Paginated<MarkupRule>> {
+    const { page: p, size: s } = this.normalizePageParams(page, size);
+    const params: Record<string, unknown> = { page: p, size: s };
+    if (keyword) params.keyword = keyword;
+    return this.httpGet<Paginated<MarkupRule>>('/markup-rules', params);
+  }
+
+  async get(id: string): Promise<MarkupRule> {
+    return this.httpGet<MarkupRule>('/markup-rules/' + id);
+  }
+
+  async create(markupRule: MarkupRule): Promise<MarkupRule> {
+    return this.httpPost<MarkupRule>('/markup-rules', markupRule);
+  }
+
+  async update(id: string, markupRule: MarkupRule): Promise<MarkupRule> {
+    return this.httpPut<MarkupRule>('/markup-rules/' + id, markupRule);
+  }
+
+  async remove(id: string): Promise<void> {
+    await this.httpDelete('/markup-rules/' + id);
+  }
+}

package/src/markup-rules/types.ts

@@ -0,0 +1,5 @@
+export interface MarkupRule {
+  id?: string;
+  pattern?: string;
+  percentage?: number;
+}

package/src/persona-sdk.ts

@@ -7,7 +7,8 @@ import { CredentialsApi } from './credentials/credentials-api';
 import { FeaturesApi } from './features/features-api';
 import { TriggersApi } from './triggers/triggers-api';
 import { ServicePricesApi } from './service-prices/service-prices-api';
-import { KnownModelsApi } from './known-models/known-models-api';
+import { MarkupRulesApi } from './markup-rules/markup-rules-api';
+import { ProvidersApi } from './providers/providers-api';
 import { SessionsApi } from './sessions/sessions-api';
 import { MissionsApi } from './missions/missions-api';
 import { BillingClient } from './billing/billing-client';
@@ -72,10 +73,16 @@ export class PersonaSdk {
     return new ServicePricesApi(this.baseUrl, auth);
   }
 
-  knownModels(apiKey: string): KnownModelsApi;
-  knownModels(authProvider: AuthenticationProvider): KnownModelsApi;
-  knownModels(auth: string | AuthenticationProvider): KnownModelsApi {
-    return new KnownModelsApi(this.baseUrl, auth);
+  markupRules(apiKey: string): MarkupRulesApi;
+  markupRules(authProvider: AuthenticationProvider): MarkupRulesApi;
+  markupRules(auth: string | AuthenticationProvider): MarkupRulesApi {
+    return new MarkupRulesApi(this.baseUrl, auth);
+  }
+
+  providers(apiKey: string): ProvidersApi;
+  providers(authProvider: AuthenticationProvider): ProvidersApi;
+  providers(auth: string | AuthenticationProvider): ProvidersApi {
+    return new ProvidersApi(this.baseUrl, auth);
   }
 
   sessions(apiKey: string): SessionsApi;

package/src/providers/providers-api.ts

@@ -0,0 +1,55 @@
+import { HttpApi } from '../http-api';
+import { Paginated } from '../paginated';
+import { AuthenticationProvider } from '../auth/authentication-provider';
+import { Provider, ProviderModel } from './types';
+
+/**
+ * Managed LLM providers (super admin only). Providers bind a litellm provider
+ * name to its credentials; global or per-project (override). API keys are stored
+ * encrypted and returned masked.
+ */
+export class ProvidersApi extends HttpApi {
+  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
+    super(baseUrl, auth);
+  }
+
+  async list(projectId?: string | null, keyword?: string | null, page?: number, size?: number): Promise<Paginated<Provider>> {
+    const { page: p, size: s } = this.normalizePageParams(page, size);
+    const params: Record<string, unknown> = { page: p, size: s };
+    if (projectId) params.projectId = projectId;
+    if (keyword) params.keyword = keyword;
+    return this.httpGet<Paginated<Provider>>('/providers', params);
+  }
+
+  async get(id: string): Promise<Provider> {
+    return this.httpGet<Provider>('/providers/' + id);
+  }
+
+  async create(provider: Provider): Promise<Provider> {
+    return this.httpPost<Provider>('/providers', provider);
+  }
+
+  async update(id: string, provider: Provider): Promise<Provider> {
+    return this.httpPut<Provider>('/providers/' + id, provider);
+  }
+
+  async remove(id: string): Promise<void> {
+    await this.httpDelete('/providers/' + id);
+  }
+
+  /** Provider names litellm supports (for the "add provider" picker). Admin. */
+  async available(): Promise<string[]> {
+    return this.httpGet<string[]>('/providers/available');
+  }
+
+  /** Names of providers configured for the caller (global + their project), no
+   * credentials. Authenticated (not admin) — for the model selector. */
+  async names(): Promise<string[]> {
+    return this.httpGet<string[]>('/provider-names');
+  }
+
+  /** Model suggestions (chat, with capabilities) for a provider, from litellm. */
+  async models(provider: string): Promise<ProviderModel[]> {
+    return this.httpGet<ProviderModel[]>('/provider-models', { provider });
+  }
+}

package/src/providers/types.ts

@@ -0,0 +1,23 @@
+export interface Provider {
+  id?: string;
+  /** litellm provider name, e.g. "openai", "anthropic", "vertex_ai". */
+  name?: string;
+  /** null/undefined => global; set => per-project override. */
+  projectId?: string | null;
+  /** Write-only; returned masked ("********") on reads. */
+  apiKey?: string;
+  baseUrl?: string;
+  /** Provider-specific extras (e.g. vertexProject, vertexLocation, vertexCredentials). */
+  config?: Record<string, unknown>;
+}
+
+/** A model suggestion for a provider, with litellm capability flags. */
+export interface ProviderModel {
+  id: string;
+  contextWindow?: number;
+  supportsVision?: boolean;
+  supportsFunctionCalling?: boolean;
+  supportsAudioInput?: boolean;
+  supportsPdfInput?: boolean;
+  supportsReasoning?: boolean;
+}

package/src/service-prices/types.ts

@@ -3,6 +3,5 @@ export interface ServicePrice {
   service?: string;
   cost?: number;
   unit?: string;
-  markupPercentage?: number;
   fixedPrice?: number;
 }

package/src/sessions/types.ts

@@ -66,6 +66,8 @@ export interface Message {
   task?: Record<string, unknown>;
   sender?: string;
   thought?: boolean;
+  /** True when this message is a context-compaction summary (injected by compaction). */
+  isCompactionSummary?: boolean;
 }
 
 export interface AgentResponse {

package/src/values/values-api.ts

@@ -42,10 +42,6 @@ export class ValuesApi extends HttpApi {
     return this.httpGet<string[]>('/values/synthesizers/' + synthesizerName + '/voices');
   }
 
-  async getStmTypes(): Promise<string[]> {
-    return this.httpGet<string[]>('/values/stm-types');
-  }
-
   async getDocumentExtractors(): Promise<string[]> {
     return this.httpGet<string[]>('/values/document-extractors');
   }

package/src/known-models/known-models-api.ts

@@ -1,33 +0,0 @@
-import { HttpApi } from '../http-api';
-import { Paginated } from '../paginated';
-import { AuthenticationProvider } from '../auth/authentication-provider';
-import { KnownModel } from './types';
-
-export class KnownModelsApi extends HttpApi {
-  constructor(baseUrl: string, auth: string | AuthenticationProvider) {
-    super(baseUrl, auth);
-  }
-
-  async list(keyword?: string | null, page?: number, size?: number, extraParams?: Record<string, string>): Promise<Paginated<KnownModel>> {
-    const { page: p, size: s } = this.normalizePageParams(page, size);
-    const params: Record<string, unknown> = { page: p, size: s, ...extraParams };
-    if (keyword) params.keyword = keyword;
-    return this.httpGet<Paginated<KnownModel>>('/known-models', params);
-  }
-
-  async get(id: string): Promise<KnownModel> {
-    return this.httpGet<KnownModel>('/known-models/' + id);
-  }
-
-  async create(knownModel: KnownModel): Promise<KnownModel> {
-    return this.httpPost<KnownModel>('/known-models', knownModel);
-  }
-
-  async update(id: string, knownModel: KnownModel): Promise<KnownModel> {
-    return this.httpPut<KnownModel>('/known-models/' + id, knownModel);
-  }
-
-  async remove(id: string): Promise<void> {
-    await this.httpDelete('/known-models/' + id);
-  }
-}

package/src/known-models/types.ts

@@ -1,7 +0,0 @@
-export interface KnownModel {
-  id?: string;
-  provider?: string;
-  modelName?: string;
-  label?: string;
-  deprecated?: boolean;
-}