@applica-software-guru/persona-sdk 0.1.112 → 0.1.113

package/dist/index.d.ts

@@ -32,6 +32,7 @@ export declare interface Agent {
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
     compaction?: CompactionConfiguration;
+    loopRecovery?: LoopRecoveryConfiguration;
     attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
@@ -68,6 +69,7 @@ export declare interface AgentCreateRequest {
     features?: Feature[];
     toolkit?: ToolkitConfiguration;
     compaction?: CompactionConfiguration;
+    loopRecovery?: LoopRecoveryConfiguration;
     attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
     responseSchema?: Record<string, unknown>;
     verboseErrors?: boolean;
@@ -708,6 +710,22 @@ export declare interface LineItem {
     periodEnd?: string;
 }
 
+export declare interface LoopRecoveryConfiguration {
+    /**
+     * Enable the completion check at the end of the turn: when the model's final
+     * response arrives (finish_reason stop, no tool call; tool-call iterations are
+     * never checked), a checker model decides whether the task is
+     * really finished and resumes the loop if not. Default: false.
+     */
+    enabled?: boolean;
+    /** Model used for the check (pick a small, fast one). Defaults to the agent's main model. */
+    model?: ModelConfiguration;
+    /** Maximum number of recoveries within a single turn. Default: 2. */
+    maxAttempts?: number;
+    /** Allow restarting the turn from the user's request; otherwise a restart is handled as a continue. Default: false. */
+    allowRestart?: boolean;
+}
+
 export declare interface MarkupRule {
     id?: string;
     pattern?: 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.112",
+  "version": "0.1.113",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/agents/types.ts

@@ -349,6 +349,22 @@ export interface CompactionConfiguration {
   model?: ModelConfiguration;
 }
 
+export interface LoopRecoveryConfiguration {
+  /**
+   * Enable the completion check at the end of the turn: when the model's final
+   * response arrives (finish_reason stop, no tool call; tool-call iterations are
+   * never checked), a checker model decides whether the task is
+   * really finished and resumes the loop if not. Default: false.
+   */
+  enabled?: boolean;
+  /** Model used for the check (pick a small, fast one). Defaults to the agent's main model. */
+  model?: ModelConfiguration;
+  /** Maximum number of recoveries within a single turn. Default: 2. */
+  maxAttempts?: number;
+  /** Allow restarting the turn from the user's request; otherwise a restart is handled as a continue. Default: false. */
+  allowRestart?: boolean;
+}
+
 export interface Revision {
   id?: string;
   entityId?: string;
@@ -388,6 +404,7 @@ export interface Agent {
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
   compaction?: CompactionConfiguration;
+  loopRecovery?: LoopRecoveryConfiguration;
   attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;
@@ -421,6 +438,7 @@ export interface AgentCreateRequest {
   features?: Feature[];
   toolkit?: ToolkitConfiguration;
   compaction?: CompactionConfiguration;
+  loopRecovery?: LoopRecoveryConfiguration;
   attachmentsPreprocessor?: AttachmentsPreprocessorConfiguration;
   responseSchema?: Record<string, unknown>;
   verboseErrors?: boolean;

package/src/index.ts

@@ -54,6 +54,7 @@ export type {
   ToolDefinition,
   ToolkitConfiguration,
   CompactionConfiguration,
+  LoopRecoveryConfiguration,
   Revision,
   AgentType,
   ReasoningEffort,