@applica-software-guru/persona-sdk 0.1.110 → 0.1.111

package/dist/index.d.ts

@@ -401,6 +401,8 @@ export declare interface ExecuteRequest {
     initialData?: Record<string, unknown>;
     callbackUrl?: string;
     eventsHook?: string;
+    /** Execution-level automatic recovery rounds (undefined = server default). */
+    recoveryAttempts?: number;
 }
 
 export declare interface Execution {
@@ -1611,12 +1613,16 @@ export declare interface Workflow {
  * Configuration for "workflow" trigger destinations.
  * `timeout` is the maximum time in seconds to wait for the workflow
  * execution callback; when not set the server applies its default (300s).
+ * `recoveryAttempts` is the execution-level automatic recovery rounds the
+ * engine applies when a node fails for good (0 disables); when not set the
+ * server applies its default (1 round) and caps the upper bound.
  */
 export declare interface WorkflowDestinationConfiguration {
     workflowId?: string;
     callbackUrl?: string;
     args?: Record<string, unknown>;
     timeout?: number;
+    recoveryAttempts?: number;
 }
 
 export declare class WorkflowExecutionsApi extends HttpApi {

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

package/src/triggers/types.ts

@@ -29,12 +29,16 @@ export interface TriggerSource {
  * Configuration for "workflow" trigger destinations.
  * `timeout` is the maximum time in seconds to wait for the workflow
  * execution callback; when not set the server applies its default (300s).
+ * `recoveryAttempts` is the execution-level automatic recovery rounds the
+ * engine applies when a node fails for good (0 disables); when not set the
+ * server applies its default (1 round) and caps the upper bound.
  */
 export interface WorkflowDestinationConfiguration {
   workflowId?: string;
   callbackUrl?: string;
   args?: Record<string, unknown>;
   timeout?: number;
+  recoveryAttempts?: number;
 }
 
 export type TriggerDestinationConfiguration =

package/src/workflows/types.ts

@@ -137,6 +137,8 @@ export interface ExecuteRequest {
   initialData?: Record<string, unknown>;
   callbackUrl?: string;
   eventsHook?: string;
+  /** Execution-level automatic recovery rounds (undefined = server default). */
+  recoveryAttempts?: number;
 }
 
 export interface HumanTask {

package/tests/triggers-api.test.mjs

@@ -0,0 +1,66 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { TriggersApi } from '../dist/bundle.es.js';
+
+function jsonResponse(body) {
+  return new Response(JSON.stringify(body), {
+    status: 200,
+    headers: { 'Content-Type': 'application/json' },
+  });
+}
+
+const TRIGGER = {
+  name: 'email-trigger',
+  source: { type: 'imap' },
+  destination: {
+    type: 'workflow',
+    configuration: {
+      workflowId: 'wf-001',
+      recoveryAttempts: 2,
+    },
+  },
+  enabled: true,
+};
+
+test('trigger create forwards recoveryAttempts in the destination configuration', async (context) => {
+  const originalFetch = globalThis.fetch;
+  context.after(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  let requestBody;
+  globalThis.fetch = async (url, init) => {
+    requestBody = JSON.parse(init.body);
+    return jsonResponse({ id: 'trigger-001', ...TRIGGER });
+  };
+
+  const api = new TriggersApi('https://example.test', 'api-key');
+  await api.create(TRIGGER);
+
+  assert.equal(requestBody.destination.configuration.recoveryAttempts, 2);
+});
+
+test('trigger update forwards recoveryAttempts too', async (context) => {
+  const originalFetch = globalThis.fetch;
+  context.after(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  let requestBody;
+  globalThis.fetch = async (url, init) => {
+    requestBody = JSON.parse(init.body);
+    return jsonResponse({ id: 'trigger-001', ...TRIGGER });
+  };
+
+  const api = new TriggersApi('https://example.test', 'api-key');
+  await api.update('trigger-001', {
+    ...TRIGGER,
+    destination: {
+      type: 'workflow',
+      configuration: { workflowId: 'wf-001', recoveryAttempts: 0 },
+    },
+  });
+
+  assert.equal(requestBody.destination.configuration.recoveryAttempts, 0);
+});