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

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

@@ -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.111",
+  "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,

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"