@applica-software-guru/persona-sdk 0.1.109 → 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 {
@@ -1422,9 +1424,11 @@ export declare interface Trigger {
 
 export declare interface TriggerDestination {
     type?: string;
-    configuration?: Record<string, unknown>;
+    configuration?: TriggerDestinationConfiguration;
 }
 
+export declare type TriggerDestinationConfiguration = WorkflowDestinationConfiguration | Record<string, unknown>;
+
 export declare interface TriggerExecutionResult {
     id?: string;
     triggerId?: string;
@@ -1605,6 +1609,22 @@ export declare interface Workflow {
     features?: Feature[];
 }
 
+/**
+ * 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 {
     constructor(baseUrl: string, auth: string | AuthenticationProvider);
     list(workflowId: string, page?: number, size?: number): Promise<Paginated<Execution>>;

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

package/src/index.ts

@@ -144,6 +144,8 @@ export type {
   GmailTriggerSourceConfiguration,
   ImapTriggerSourceConfiguration,
   TriggerDestination,
+  TriggerDestinationConfiguration,
+  WorkflowDestinationConfiguration,
   TriggerExecutionResult,
 } from './triggers/types';
 export { FeaturesApi } from './features/features-api';

package/src/triggers/types.ts

@@ -25,9 +25,29 @@ export interface TriggerSource {
   configuration?: TriggerSourceConfiguration;
 }
 
+/**
+ * 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 =
+  | WorkflowDestinationConfiguration
+  | Record<string, unknown>;
+
 export interface TriggerDestination {
   type?: string;
-  configuration?: Record<string, unknown>;
+  configuration?: TriggerDestinationConfiguration;
 }
 
 export interface Trigger {

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);
+});