@applica-software-guru/persona-sdk 0.1.29 → 0.1.31

package/dist/index.d.ts

@@ -31,6 +31,7 @@ export declare interface Agent {
     toolkit?: ToolkitConfiguration;
     shortTermMemory?: StmConfiguration;
     contextManagement?: ContextManagementConfiguration;
+    attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
 }
@@ -65,6 +66,7 @@ export declare interface AgentCreateRequest {
     toolkit?: ToolkitConfiguration;
     shortTermMemory?: StmConfiguration;
     contextManagement?: ContextManagementConfiguration;
+    attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
 }
@@ -114,6 +116,19 @@ export declare class ApiKeyAuthenticationProvider implements AuthenticationProvi
     getCredentials(): string;
 }
 
+export declare interface AttachmentsPreprocessorConfiguration {
+    enabled?: boolean;
+    imageHandling?: AttachmentsPreprocessorImageHandling;
+    standalonePassthrough?: boolean;
+    secondaryModel?: ModelConfiguration;
+    llmPrompt?: string;
+    pdfImageDpi?: number;
+    maxPages?: number;
+    failOpen?: boolean;
+}
+
+export declare type AttachmentsPreprocessorImageHandling = 'drop' | 'describe' | 'keep';
+
 export declare interface AuthenticationProvider {
     applyHeaders(headers: Headers): void;
     getCredentials(): string;
@@ -250,7 +265,7 @@ export declare interface ContentValue {
     content?: ContentItem[];
 }
 
-declare interface ContextManagementConfiguration {
+export declare interface ContextManagementConfiguration {
     enabled?: boolean;
     maxContextTokens?: number;
     summarizationThreshold?: number;
@@ -678,13 +693,8 @@ export declare class MissionsApi extends HttpApi {
 export declare type MissionStatus = 'draft' | 'planned' | 'active' | 'review' | 'paused' | 'completed' | 'failed' | 'cancelled';
 
 export declare interface ModelConfiguration {
-    /**
-     * litellm-style "<provider>/<model>" string (e.g. "openai/gpt-5"). Bare legacy
-     * names (e.g. "gpt-5", "accounts/fireworks/models/x", "ollama") are still
-     * accepted; the provider is derived server-side. The `ModelName` union keeps
-     * autocomplete for known models while `string` allows any litellm identifier.
-     */
-    modelName?: ModelName | (string & {});
+    /** litellm-style "<provider>/<model>" string (e.g. "fireworks/accounts/fireworks/models/minimax-m3"). Use the known-models API for the current list. */
+    modelName?: string;
     temperature?: number;
     reasoningEffort?: ReasoningEffort;
     /** Maximum number of output tokens to generate. Undefined = provider default. */
@@ -693,6 +703,8 @@ export declare interface ModelConfiguration {
     apiKey?: string;
     /** Override the per-provider default base URL when set. */
     baseUrl?: string;
+    /** Passed verbatim as extra_body to the underlying LLM request (e.g. { service_tier: "priority" }). */
+    extraBody?: Record<string, unknown>;
     /** @deprecated use `baseUrl`. Kept for backward compatibility. */
     url?: string;
     /** @deprecated use litellm `modelName` (e.g. "ollama/llama3.1"). */
@@ -705,8 +717,6 @@ export declare interface ModelConfiguration {
     openrouterModelName?: string;
 }
 
-export declare type ModelName = 'gemini-3.5-flash' | 'gemini-3-pro' | 'gemini-3-flash-preview' | 'gemini-3.1-pro-preview' | 'gemini-3.1-flash-lite' | '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-5p1' | 'accounts/fireworks/models/deepseek-v4-pro' | 'accounts/fireworks/models/qwen3p6-plus' | 'grok-4.3' | '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' | 'openrouter';
-
 export declare type ModelProvider = 'google' | 'openai' | 'grok' | 'fireworks' | 'together' | 'ollama' | 'openai_compatible' | 'openrouter';
 
 export declare interface NetworkConfiguration {

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.29",
+  "version": "0.1.31",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/agents/types.ts

@@ -4,69 +4,6 @@ export type KnowledgeType = 'multi_hop' | 'simple';
 
 export type LanguageCode = 'en-US' | 'it-IT' | 'es-ES' | 'fr-FR' | 'de-DE' | 'pt-BR';
 
-export type ModelName =
-  | 'gemini-3.5-flash'
-  | 'gemini-3-pro'
-  | 'gemini-3-flash-preview'
-  | 'gemini-3.1-pro-preview'
-  | 'gemini-3.1-flash-lite'
-  | '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-5p1'
-  | 'accounts/fireworks/models/deepseek-v4-pro'
-  | 'accounts/fireworks/models/qwen3p6-plus'
-  | 'grok-4.3'
-  | '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'
-  | 'openrouter';
 
 export type SynthesizerName = 'gcloud' | 'elevenlabs' | 'gtts' | 'openai';
 
@@ -100,13 +37,8 @@ export interface Variable {
 }
 
 export interface ModelConfiguration {
-  /**
-   * litellm-style "<provider>/<model>" string (e.g. "openai/gpt-5"). Bare legacy
-   * names (e.g. "gpt-5", "accounts/fireworks/models/x", "ollama") are still
-   * accepted; the provider is derived server-side. The `ModelName` union keeps
-   * autocomplete for known models while `string` allows any litellm identifier.
-   */
-  modelName?: ModelName | (string & {});
+  /** litellm-style "<provider>/<model>" string (e.g. "fireworks/accounts/fireworks/models/minimax-m3"). Use the known-models API for the current list. */
+  modelName?: string;
   temperature?: number;
   reasoningEffort?: ReasoningEffort;
   /** Maximum number of output tokens to generate. Undefined = provider default. */
@@ -115,6 +47,8 @@ export interface ModelConfiguration {
   apiKey?: string;
   /** Override the per-provider default base URL when set. */
   baseUrl?: string;
+  /** Passed verbatim as extra_body to the underlying LLM request (e.g. { service_tier: "priority" }). */
+  extraBody?: Record<string, unknown>;
   /** @deprecated use `baseUrl`. Kept for backward compatibility. */
   url?: string;
   /** @deprecated use litellm `modelName` (e.g. "ollama/llama3.1"). */
@@ -127,6 +61,19 @@ export interface ModelConfiguration {
   openrouterModelName?: string;
 }
 
+export type AttachmentsPreprocessorImageHandling = 'drop' | 'describe' | 'keep';
+
+export interface AttachmentsPreprocessorConfiguration {
+  enabled?: boolean;
+  imageHandling?: AttachmentsPreprocessorImageHandling;
+  standalonePassthrough?: boolean;
+  secondaryModel?: ModelConfiguration;
+  llmPrompt?: string;
+  pdfImageDpi?: number;
+  maxPages?: number;
+  failOpen?: boolean;
+}
+
 export interface SynthesizerVoice {
   id?: string;
   name?: string;
@@ -362,6 +309,7 @@ export interface Agent {
   toolkit?: ToolkitConfiguration;
   shortTermMemory?: StmConfiguration;
   contextManagement?: ContextManagementConfiguration;
+  attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
 }
@@ -393,6 +341,7 @@ export interface AgentCreateRequest {
   toolkit?: ToolkitConfiguration;
   shortTermMemory?: StmConfiguration;
   contextManagement?: ContextManagementConfiguration;
+  attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
 }

package/src/index.ts

@@ -26,7 +26,6 @@ export type {
   KnowledgeType,
   LanguageCode,
   ModelConfiguration,
-  ModelName,
   NetworkConfiguration,
   OrchestrationConfiguration,
   OrchestrationAgent,
@@ -55,6 +54,9 @@ export type {
   ReasoningEffort,
   ModelProvider,
   CollaborationMode,
+  ContextManagementConfiguration,
+  AttachmentsPreprocessorConfiguration,
+  AttachmentsPreprocessorImageHandling,
 } from './agents/types';
 export { SessionsApi } from './sessions/sessions-api';
 export type {