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

package/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: CI
+
+# Validate su PR: lint + test (il test include la build).
+# Il publish avviene solo al push su main (deploy.yml).
+# Il pipeline Bitbucket non aveva validate su PR: aggiunta in migrazione.
+
+on:
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test

package/.github/workflows/deploy.yml

@@ -0,0 +1,81 @@
+name: Deploy
+
+# Push su main: versione riconciliata su NPM (dist della serie 0.1.x,
+# lo stesso algoritmo della pipeline Bitbucket: patch-max su npm +1)
+# → lint/test (miglioria: il BB non li eseguiva) → build → publish su
+# npm tramite TRUSTED PUBLISHING OIDC (nessun token: GitHub firma ogni
+# publish, configurato su npmjs.com → package → Trusted Publisher)
+# → tag di versione. npm stesso è la guard anti-collisione: rifiuta
+# (403) una versione già pubblicata, il run fallisce senza side-effect.
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: npm-publish-persona-sdk-js
+  cancel-in-progress: false
+
+permissions:
+  contents: write # push del tag di versione con GITHUB_TOKEN
+  id-token: write # OIDC → npm trusted publishing
+
+jobs:
+  version:
+    name: Calcola versione (riconciliazione su npm, serie 0.1.x)
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.v.outputs.version }}
+    steps:
+      - id: v
+        run: |
+          PKG="@applica-software-guru/persona-sdk"
+          # patch-max sulla serie 0.1 (esclude prerelease), +1 —
+          # identico all'algoritmo della pipeline Bitbucket
+          NEXT=$(npm view "$PKG" versions --json | node -e '
+            const versions = JSON.parse(require("fs").readFileSync(0, "utf8"));
+            const prefix = "0.1.";
+            const patches = versions
+              .filter(v => v.startsWith(prefix) && !v.includes("-"))
+              .map(v => Number(v.slice(prefix.length)))
+              .filter(Number.isFinite);
+            console.log(prefix + (Math.max(...patches, 0) + 1));')
+          echo "Prossima versione: ${NEXT}"
+          echo "version=${NEXT}" >> "$GITHUB_OUTPUT"
+
+  publish:
+    name: Lint, test, build & publish su npm (OIDC)
+    runs-on: ubuntu-latest
+    needs: version
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: 'https://registry.npmjs.org'
+        # niente cache npm nei rilasci (recommendation npm per trusted publishing)
+      - name: Assicura npm >= 11.5.1 (richiesto per trusted publishing OIDC)
+        run: npm install -g npm@^11
+      - name: Versiona il package
+        run: npm version "${{ needs.version.outputs.version }}" --no-git-tag-version
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test
+      - name: Publish su npm (OIDC trusted publishing, nessun token)
+        run: npm publish --access public
+
+  tag-release:
+    name: Tag di versione
+    runs-on: ubuntu-latest
+    needs: [version, publish]
+    if: always() && needs.publish.result == 'success'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Crea e pusha il tag
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          git config user.name "RoBYCoNTe"
+          git config user.email "2301162+RoBYCoNTe@users.noreply.github.com"
+          git tag -a "${VERSION}" -m "Version ${VERSION}"
+          git push origin "${VERSION}"

package/MIGRATION_GITHUB.md

@@ -0,0 +1,45 @@
+# Migrazione Bitbucket → GitHub Actions
+
+Repo migrato da `applicaguru/persona-sdk-js` (Bitbucket) a
+`applica-software-guru/persona-sdk-js` (GitHub, privato) il
+**2026-09-24**.
+
+## Fasi
+
+1. **Validazione locale** — lint (0 errori) + `npm test` (4/4,
+   build inclusa). Il pipeline BB non eseguiva test né lint sul push:
+   aggiunti in migrazione come miglioramento.
+2. **Repo GitHub** — creato privato; `main` (`74dc185`) + 46 tag
+   (serie `0.1.*` fino a `0.1.111`) + 2 rami WIP pushati tali quali:
+   `feature/sip-protocol` (SIP trunks/call-control, 3 commit) e
+   `refactor/litellm-model-config` (rimozione union `ModelName`,
+   3 commit). I rami mergiati `feature/harness` e
+   `feature/voice-latency` non sono stati ripushati. Invariante
+   verificata: Bitbucket ⊆ GitHub (0 commit, 0 tag mancanti).
+3. **Pipeline** — `deploy.yml` (npm OIDC) + `ci.yml`, cutover.
+4. **Verifica** — run verde, `0.1.112` su npm, tag git.
+
+## Versioning
+
+Alla migrazione le fonti erano **allineate**: npm latest = `0.1.111`
+= tag git max. La formula replica l'algoritmo della pipeline BB
+(patch-max sulla serie `0.1` da `npm view versions` +1; prerelease
+escluse). Prima release GitHub: **`0.1.112`**. npm stesso è la guard
+anti-collisione (rifiuta versioni duplicate). Il consumer principale
+(`persona-cp`, dep `^0.1.110`) resta compatibile.
+
+## Pipeline decisionale (npm)
+
+- **push su main** → version (riconciliazione npm) → lint/test →
+  **publish OIDC trusted publishing** (nessun token; configurato su
+  npmjs.com → package → Trusted Publisher, repo + workflow
+  `deploy.yml`) → tag di versione. Come il BB: ogni push su main è
+  una release.
+- **PR** → `ci.yml`: validate (lint + test). Nuovo rispetto al BB.
+
+## Decisioni
+
+- **Test**: suite esistente (`node --test`, 2 file) eseguita al
+  push — il BB la ignorava.
+- **Segreti**: nessuno — OIDC trusted publishing.
+- **Rimosso dal tree nel cutover**: `bitbucket-pipelines.yml`.

package/README.md

@@ -1,3 +1,9 @@
+<div align="center">
+
+[![Deploy](https://github.com/applica-software-guru/persona-sdk-js/actions/workflows/deploy.yml/badge.svg)](https://github.com/applica-software-guru/persona-sdk-js/actions/workflows/deploy.yml)
+
+</div>
+
 # Persona SDK
 
 [![npm version](https://img.shields.io/npm/v/@applica-software-guru/persona-sdk)](https://www.npmjs.com/package/@applica-software-guru/persona-sdk)

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.112",
   "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);
+});

package/bitbucket-pipelines.yml

@@ -1,20 +0,0 @@
-image: node:22
-
-pipelines:
-  branches:
-    main:
-      - step:
-          name: Deploy
-          deployment: Production
-          script:
-            - export VERSION_PREFIX=0.1
-            - export PACKAGE_VERSION=$(npm view @applica-software-guru/persona-sdk versions --json | node -e "const versions = JSON.parse(require('fs').readFileSync(0, 'utf8')); const prefix = process.env.VERSION_PREFIX + '.'; const patches = versions.filter(v => v.startsWith(prefix) && !v.includes('-')).map(v => Number(v.slice(prefix.length))).filter(Number.isFinite); console.log(process.env.VERSION_PREFIX + '.' + (Math.max(...patches, 0) + 1));")
-            - npm --no-git-tag-version version "$PACKAGE_VERSION" -m "Upgrade to new version"
-            - npm install
-            - npm run build
-            - pipe: atlassian/npm-publish:0.3.2
-              variables:
-                NPM_TOKEN: $NPM_TOKEN
-                EXTRA_ARGS: '--access public'
-            - git tag -a "$PACKAGE_VERSION" -m "Version $PACKAGE_VERSION"
-            - git push origin "$PACKAGE_VERSION"