@fluxo-dev/api-client-base 26.2.5 → 26.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxo-dev/api-client-base",
-  "version": "26.2.5",
+  "version": "26.3.1",
   "type": "commonjs",
   "peerDependencies": {
     "react": "^18.3.1",
@@ -8,7 +8,7 @@
     "react-router-dom": "^6.11.2",
     "react-redux": "^8.0.5",
     "@reduxjs/toolkit": "^1.9.1",
-    "@fluxo-dev/state": "^26.2.5"
+    "@fluxo-dev/state": "^26.3.1"
   },
   "main": "./index.cjs.js",
   "types": "./index.cjs.d.ts"

package/src/lib/ai/ai.service.d.ts

@@ -1,148 +1,163 @@
-import { CreateLLMSettingsCommand, LLMSettingsDto, UpdateLLMSettingsCommand, AgentDto, CreateAgentCommand, UpdateAgentCommand, CreateAgentOrchestrationCommand, AgentOrchestrationDto, UpdateAgentOrchestrationCommand, McpServerConfigurationDto, CreateMcpServerCommand, UpdateMcpServerCommand } from './models';
+import { LlmConfigDto, CreateLlmConfigCommand, UpdateLlmConfigCommand, AiAgentDto, CreateAgentCommand, UpdateAgentCommand, UpdateAgentToolsCommand, AiToolDto, AiWorkflowDto, CreateAiWorkflowCommand, UpdateAiWorkflowCommand, UpdateAiWorkflowAgentsCommand, ChatTargetDto, StartConversationCommand, StartConversationResult, ChatConversationSummaryDto, ChatConversationDetailDto, RenameConversationCommand, UpdateConversationTagsCommand, SetActiveLeafCommand, AiChatAttachmentDto, AiPromptTemplateDto, CreateAiPromptTemplateCommand, UpdateAiPromptTemplateCommand, UpdateAgentMcpServersCommand, McpServerConfigurationDto, CreateMcpServerCommand, UpdateMcpServerCommand, McpServerTestResultDto, AvailableToolDto, AvailableSkillDto, AiSkillDto, AiSkillFileContentDto, CreateAiSkillCommand, UpdateAiSkillCommand, TestSkillScriptCommand, AiSkillScriptTestResultDto, UpdateAgentSkillsCommand } from './models';
 export declare class AiService {
-    /**
-     * ========================================
-     * LLM SETTINGS METHODS
-     * ========================================
-     */
-    /**
-     * Lista tutte le configurazioni LLM
-     */
-    getAllLLMSettings(): Promise<LLMSettingsDto[]>;
-    /**
-     * Ottieni una configurazione specifica
-     */
-    getLLMSettingsById(id: string): Promise<LLMSettingsDto>;
-    /**
-     * Crea una nuova configurazione LLM
-     */
-    createLLMSettings(command: CreateLLMSettingsCommand): Promise<LLMSettingsDto>;
-    /**
-     * Aggiorna una configurazione esistente
-     */
-    updateLLMSettings(id: string, command: UpdateLLMSettingsCommand): Promise<LLMSettingsDto>;
-    /**
-     * Attiva una configurazione
-     */
-    activateLLMSettings(id: string): Promise<LLMSettingsDto>;
-    /**
-     * Disattiva una configurazione
-     */
-    deactivateLLMSettings(id: string): Promise<LLMSettingsDto>;
-    /**
-     * Elimina una configurazione
-     */
-    deleteLLMSettings(id: string): Promise<void>;
-    /**
-     * ========================================
-     * AGENT METHODS
-     * ========================================
-     */
-    /**
-     * Lista tutti gli agenti
-     */
-    getAllAgents(): Promise<AgentDto[]>;
-    /**
-     * Ottieni un agente specifico
-     */
-    getAgentById(id: string): Promise<AgentDto>;
-    /**
-     * Crea un nuovo agente
-     */
-    createAgent(command: CreateAgentCommand): Promise<AgentDto>;
-    /**
-     * Aggiorna un agente esistente
-     */
-    updateAgent(id: string, command: UpdateAgentCommand): Promise<AgentDto>;
-    /**
-     * Attiva un agente
-     */
-    activateAgent(id: string): Promise<AgentDto>;
-    /**
-     * Disattiva un agente
-     */
-    deactivateAgent(id: string): Promise<AgentDto>;
-    /**
-     * Elimina un agente
-     */
-    deleteAgent(id: string): Promise<void>;
-    /**
-     * ========================================
-     * ORCHESTRATION METHODS
-     * ========================================
-     */
-    /**
-     * Lista tutte le orchestrazioni
-     */
-    getAllOrchestrations(): Promise<AgentOrchestrationDto[]>;
-    /**
-     * Ottieni un'orchestrazione specifica
-     */
-    getOrchestrationById(id: string): Promise<AgentOrchestrationDto>;
-    /**
-     * Crea una nuova orchestrazione
-     */
-    createOrchestration(command: CreateAgentOrchestrationCommand): Promise<AgentOrchestrationDto>;
-    /**
-     * Aggiorna un'orchestrazione esistente
-     */
-    updateOrchestration(id: string, command: UpdateAgentOrchestrationCommand): Promise<AgentOrchestrationDto>;
-    /**
-     * Attiva un'orchestrazione
-     */
-    activateOrchestration(id: string): Promise<AgentOrchestrationDto>;
-    /**
-     * Disattiva un'orchestrazione
-     */
-    deactivateOrchestration(id: string): Promise<AgentOrchestrationDto>;
-    /**
-     * Elimina un'orchestrazione
-     */
-    deleteOrchestration(id: string): Promise<void>;
-    /**
-     * ========================================
-     * MCP SERVER METHODS
-     * ========================================
-     */
-    /**
-     * Lista tutti i server MCP
-     */
-    getAllMcpServers(): Promise<McpServerConfigurationDto[]>;
-    /**
-     * Ottieni un server MCP specifico
-     */
-    getMcpServerById(id: string): Promise<McpServerConfigurationDto>;
-    /**
-     * Crea un nuovo server MCP
-     */
+    getLlmConfigs(): Promise<LlmConfigDto[]>;
+    getLlmConfig(id: number): Promise<LlmConfigDto>;
+    createLlmConfig(command: CreateLlmConfigCommand): Promise<LlmConfigDto>;
+    updateLlmConfig(id: number, command: UpdateLlmConfigCommand): Promise<LlmConfigDto>;
+    deleteLlmConfig(id: number): Promise<void>;
+    getAgents(): Promise<AiAgentDto[]>;
+    getAgent(id: number): Promise<AiAgentDto>;
+    createAgent(command: CreateAgentCommand): Promise<AiAgentDto>;
+    updateAgent(id: number, command: UpdateAgentCommand): Promise<AiAgentDto>;
+    deleteAgent(id: number): Promise<void>;
+    updateAgentTools(id: number, command: UpdateAgentToolsCommand): Promise<void>;
+    /** Replace the set of MCP servers linked to an agent. Empty array detaches all. */
+    updateAgentMcpServers(id: number, command: UpdateAgentMcpServersCommand): Promise<void>;
+    /** Replace the set of skills linked to an agent. Empty array detaches all. */
+    updateAgentSkills(id: number, command: UpdateAgentSkillsCommand): Promise<void>;
+    /**
+     * Live snapshot of the tools the agent can invoke right now (native + MCP).
+     * The FE uses this to render origin badges and to group the `/tools` modal.
+     */
+    getAvailableTools(id: number): Promise<AvailableToolDto[]>;
+    /**
+     * Live snapshot of the skills currently linked to the agent. Used by the chat
+     * UI to attribute synthetic skill tool_calls (`load_skill`,
+     * `read_skill_resource`, `run_skill_script`) to a row, and to render the
+     * "Skill" group in the `/tools` modal.
+     */
+    getAvailableSkills(id: number): Promise<AvailableSkillDto[]>;
+    getTools(): Promise<AiToolDto[]>;
+    getTool(id: string): Promise<AiToolDto>;
+    getAiWorkflows(): Promise<AiWorkflowDto[]>;
+    getAiWorkflow(id: number): Promise<AiWorkflowDto>;
+    createAiWorkflow(command: CreateAiWorkflowCommand): Promise<AiWorkflowDto>;
+    updateAiWorkflow(id: number, command: UpdateAiWorkflowCommand): Promise<AiWorkflowDto>;
+    deleteAiWorkflow(id: number): Promise<void>;
+    updateAiWorkflowAgents(id: number, command: UpdateAiWorkflowAgentsCommand): Promise<void>;
+    /** Lista degli agenti/workflow pubblici con cui l'utente può aprire una chat. */
+    getChatTargets(): Promise<ChatTargetDto[]>;
+    /** Pre-crea una conversazione e restituisce le coordinate AG-UI (`threadId` + `aguiUrl`). */
+    startConversation(command: StartConversationCommand): Promise<StartConversationResult>;
+    /** Tutte le conversazioni dell'utente ordinate per ultima attività (più recente prima). */
+    getConversations(): Promise<ChatConversationSummaryDto[]>;
+    /**
+     * Conversation metadata + active-branch chain (root → leaf). Each message carries its
+     * sibling externalIds for the branch navigator. Not paginated: a single branch chain is
+     * bounded — typically a few dozen messages.
+     */
+    getConversation(id: string): Promise<ChatConversationDetailDto>;
+    /** Rinomina la conversazione. Il backend non ritorna body. */
+    renameConversation(id: string, command: RenameConversationCommand): Promise<void>;
+    /**
+     * Replace ALL tags on a conversation. Backend lowercases + de-duplicates + trims;
+     * pass an empty array to remove every tag.
+     */
+    updateConversationTags(id: string, command: UpdateConversationTagsCommand): Promise<void>;
+    /**
+     * Download the conversation as a Blob in the requested format. The blob's MIME
+     * type matches the server's Content-Type (`text/markdown` or `application/json`).
+     * The caller is expected to wire this to a hidden `<a download>` to trigger the
+     * browser save dialog — see the conversation menu in ConversationList.tsx.
+     *
+     * The shared HttpClient interceptor unwraps axios's `response.data`, so with
+     * `responseType: 'blob'` we get the Blob directly. The `as` cast is just to
+     * satisfy TS — axios's generic ties the return to `AxiosResponse<Blob>` even
+     * after the interceptor has re-typed it.
+     */
+    exportConversation(id: string, format: 'md' | 'json'): Promise<Blob>;
+    /**
+     * Switch del branch attivo. Dopo questa chiamata, `getConversation` ritorna la chain del
+     * nuovo leaf e il prossimo turn si aggancia a quel ramo. Il frontend dovrebbe ricaricare
+     * la conversazione subito dopo per riflettere lo stato.
+     */
+    setActiveLeaf(id: string, command: SetActiveLeafCommand): Promise<void>;
+    /** Elimina conversazione e tutti i messaggi associati. */
+    deleteConversation(id: string): Promise<void>;
+    /**
+     * Carica un file come attachment, ritornando la metadata persistita (incluso l'id che
+     * va poi passato via header `X-Fluxo-Attachment-Ids` al prossimo turn AGUI).
+     * L'attachment resta "orphan" finché non viene linkato a un user msg dal dispatcher.
+     */
+    uploadAttachment(conversationId: string, file: File): Promise<AiChatAttachmentDto>;
+    /**
+     * Elimina un attachment orphan (uploaded ma non ancora associato a un turn inviato).
+     * Il backend rifiuta con 409 se l'attachment è già stato linkato a un messaggio.
+     */
+    deleteAttachment(conversationId: string, attachmentId: number): Promise<void>;
+    /**
+     * List every attachment in the conversation, newest first. Includes both user
+     * uploads and files harvested from skill script `cwd`s. Used by the chat header's
+     * 📎 drawer to show "Allegati prodotti" (skill outputs) alongside inputs.
+     *
+     * Returns an empty array if the conversation has no attachments OR if the caller
+     * doesn't own it (backend returns 404 — caller treats it as "no access, no list").
+     */
+    listConversationAttachments(conversationId: string): Promise<AiChatAttachmentDto[]>;
+    /**
+     * Risolve una URL relativa di attachment (es. ContentUrl ritornato dal DTO) in URL
+     * assoluta + headers di autenticazione, pronta per essere usata come `src` di `<img>`
+     * o come destinazione di un fetch manuale.
+     */
+    resolveAttachmentUrl(contentUrl: string): {
+        url: string;
+        headers: Record<string, string>;
+    };
+    /** List every skill (org-wide), ordered most-recent UpdatedAt first. */
+    getSkills(): Promise<AiSkillDto[]>;
+    getSkill(id: number): Promise<AiSkillDto>;
+    createSkill(command: CreateAiSkillCommand): Promise<AiSkillDto>;
+    updateSkill(id: number, command: UpdateAiSkillCommand): Promise<AiSkillDto>;
+    deleteSkill(id: number): Promise<void>;
+    /**
+     * Import a skill from an agentskills.io-shaped archive (`.zip` / `.tar.gz` /
+     * `.tgz`). The BE parses `SKILL.md` (frontmatter → name/description, body →
+     * instructions) and dumps the entire tree (every other file) into
+     * `AiSkillFile` rows preserving relative paths — including binary assets
+     * and nested helpers used by Python packages like Anthropic's pptx skill.
+     * Returns the newly created skill DTO. Throws (4xx propagated as `message`)
+     * if the archive is malformed or fails validation.
+     */
+    importSkill(file: File): Promise<AiSkillDto>;
+    /**
+     * Fetch the bytes (base64 in `content`) of one supporting file attached to
+     * a skill. Separate from `getSkill` because skill imports can carry tens of
+     * MB of nested files — pulling them on every editor render would be wasteful.
+     * The editor "Additional files" section calls this when the admin clicks a
+     * row to inspect a specific file's content.
+     */
+    getSkillFileContent(skillId: number, fileId: number): Promise<AiSkillFileContentDto>;
+    /**
+     * Run a script with admin-provided mock args. Never throws — failure is
+     * surfaced as `success: false` with a sanitised `error` message. Used by the
+     * "Test script" inline panel in the skill editor.
+     */
+    testSkillScript(skillId: number, scriptId: number, command: TestSkillScriptCommand): Promise<AiSkillScriptTestResultDto>;
+    /** List every MCP server visible to the org, ordered alphabetically by name. */
+    getMcpServers(): Promise<McpServerConfigurationDto[]>;
+    getMcpServer(id: number): Promise<McpServerConfigurationDto>;
     createMcpServer(command: CreateMcpServerCommand): Promise<McpServerConfigurationDto>;
-    /**
-     * Aggiorna un server MCP esistente
-     */
-    updateMcpServer(id: string, command: UpdateMcpServerCommand): Promise<McpServerConfigurationDto>;
-    /**
-     * Attiva un server MCP
-     */
-    activateMcpServer(id: string): Promise<McpServerConfigurationDto>;
-    /**
-     * Disattiva un server MCP
-     */
-    deactivateMcpServer(id: string): Promise<McpServerConfigurationDto>;
-    /**
-     * Elimina un server MCP
-     */
-    deleteMcpServer(id: string): Promise<void>;
-    /**
-     * ========================================
-     * AGENT-MCP ASSOCIATION METHODS
-     * ========================================
-     */
-    /**
-     * Associa un server MCP ad un agente
-     */
-    associateMcpServerToAgent(agentId: string, mcpServerId: string): Promise<AgentDto>;
-    /**
-     * Rimuovi l'associazione tra un server MCP e un agente
-     */
-    dissociateMcpServerFromAgent(agentId: string, mcpServerId: string): Promise<AgentDto>;
+    updateMcpServer(id: number, command: UpdateMcpServerCommand): Promise<McpServerConfigurationDto>;
+    deleteMcpServer(id: number): Promise<void>;
+    /**
+     * Try the server's transport and list its tools, then dispose the transient client.
+     * Never throws — failures are reported via `McpServerTestResultDto.error`.
+     */
+    testMcpServer(id: number): Promise<McpServerTestResultDto>;
+    /** Manually invalidate the pool's cached tool snapshot for a server. */
+    refreshMcpServer(id: number): Promise<void>;
+    /** Org-wide library of reusable templates. Ordered by most-recent UpdatedAt. */
+    getPromptTemplates(): Promise<AiPromptTemplateDto[]>;
+    getPromptTemplate(id: number): Promise<AiPromptTemplateDto>;
+    createPromptTemplate(command: CreateAiPromptTemplateCommand): Promise<AiPromptTemplateDto>;
+    updatePromptTemplate(id: number, command: UpdateAiPromptTemplateCommand): Promise<AiPromptTemplateDto>;
+    deletePromptTemplate(id: number): Promise<void>;
+    /**
+     * Trasforma l'`aguiUrl` (relativo, ritornato dal backend) in URL assoluto
+     * + headers di autenticazione, pronti per `HttpAgent` di AG-UI / CopilotKit.
+     */
+    resolveAguiUrl(aguiUrl: string): {
+        url: string;
+        headers: Record<string, string>;
+    };
 }

package/src/lib/ai/index.d.ts

@@ -1,2 +1,2 @@
+export * from './models/index';
 export * from './ai.service';
-export * from './models';