agentic-api 2.0.314 → 2.0.491

package/dist/src/execute/modelconfig.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelConfig = modelConfig;
+const utils_1 = require("../utils");
+const pricing_llm_1 = require("../pricing.llm");
+/**
+ * Configuration des modèles pour Chat Completions (legacy) et Responses API
+ *
+ * Gère la configuration des modèles avec migration automatique des paramètres
+ * selon le provider (OpenAI, xAI) et l'API utilisée (legacy ou Responses)
+ *
+ * @param model - Alias du modèle (LOW-fast, MEDIUM-fast, HIGH-fast, HIGH-medium, etc.)
+ * @param custom - Options custom
+ * @param custom.thinking - Si true, active reasoning_effort élevé (via LLM mapping)
+ * @param forResponses - Si true, retourne format Responses API avec mappings:
+ *   - reasoning_effort → reasoning: { effort }
+ *   - verbosity → text.verbosity
+ * @returns Configuration du modèle
+ *
+ * NOTE: Pour GPT-5, temperature est toujours fixée à 1
+ * NOTE: reasoning_effort est géré automatiquement par LLM() selon le provider
+ */
+function modelConfig(model, custom, forResponses = false) {
+    const thinking = custom?.thinking || false;
+    delete custom?.thinking;
+    const defaultOptions = Object.assign({
+        stream_options: { "include_usage": true },
+    }, custom || {});
+    //
+    // Get mapping based on provider (OpenAI vs xAI)
+    // LLM() applique automatiquement reasoning_effort si thinking=true
+    const mapping = (0, pricing_llm_1.LLM)((0, utils_1.openaiInstance)(), thinking);
+    const options = Object.assign({}, mapping[model], defaultOptions);
+    //
+    // Pour Responses API : mapper vers la nouvelle structure et filtrer les paramètres incompatibles
+    // Chat Completions utilise reasoning_effort (string) et verbosity (string)
+    // Responses API utilise reasoning: { effort: string } et text.verbosity (string)
+    if (forResponses) {
+        // Mapper reasoning_effort → reasoning: { effort }
+        if (options.reasoning_effort) {
+            options.reasoning = { effort: options.reasoning_effort };
+            delete options.reasoning_effort;
+        }
+        // Mapper verbosity → text.verbosity
+        if (options.verbosity) {
+            options.text = { verbosity: options.verbosity };
+            delete options.verbosity;
+        }
+        // Supprimer les paramètres non supportés par Responses API
+        const unsupportedParams = ['frequency_penalty', 'presence_penalty', 'stream_options', 'web_search_options'];
+        unsupportedParams.forEach(param => {
+            delete options[param];
+        });
+    }
+    return options;
+}

package/dist/src/execute/responses.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Responses API Implementation
+ *
+ * Migration de Chat Completions vers Responses API pour:
+ * - Meilleur support des modèles reasoning (o-series, gpt-5)
+ * - Tool calls préservés pendant le raisonnement via reasoning: { effort }
+ * - Events SSE typés (response.output_text.delta, response.function_call.*)
+ * - Plus de boucle moreThinkin (obsolète) : reasoning géré nativement
+ *
+ * Différences clés vs legacy:
+ * - `input` remplace `messages` (même format array, juste renommage du paramètre)
+ * - `reasoning: { effort: 'low' | 'medium' | 'high' }` remplace `reasoning_effort`
+ * - Events SSE structurés vs delta progressifs
+ * - `response.usage` vs `final.usage`
+ * - Tools/function calling: format identique, `parallel_tool_calls` supporté
+ *
+ * Optimisations appliquées (vs code original):
+ * - OPTIM: Helpers centralisés (accumulateUsageTokens, stepsToActions)
+ * - BUG FIX: executionResultMerge fusionne actions correctement (corrigé dans types.ts)
+ * - BUG FIX: moreThinkin supprimé (obsolète)
+ * - BUG FIX: reasoning_effort géré par modelConfig uniquement
+ *
+ * TODO [Phase 2]: Migration vers openai-agents-js
+ * https://openai.github.io/openai-agents-js/
+ * - Remplacer handleTransferCall par handoff natif du SDK
+ * - Utiliser swarm.run() pour orchestration multi-agents
+ * - Mapper downstreamAgents vers router policies
+ * - Intégration optionnelle avec Vercel AI SDK (multi-providers)
+ * - stateGraph restera compatible (AgentMessage générique, agnostic de l'API)
+ */
+import { AgentConfig, AgenticContext, ExecuteAgentResult, ExecutionResult } from "../types";
+import { ReadCompletionsStreamOptions, ExecuteAgentSetParams } from "./shared";
+/**
+ * RESPONSES API: Traite le stream de responses avec tool calls
+ *
+ * Utilise les events SSE typés de Responses API:
+ * - response.output_text.delta → texte
+ * - response.function_call.* → tool calls
+ * - response.completed → finalisation
+ */
+export declare function readCompletionsStream(params: ReadCompletionsStreamOptions): Promise<ExecutionResult>;
+/**
+ * Executes a set of agents to process a user query
+ *
+ * RESPONSES API VERSION
+ */
+export declare function executeAgentSet(agentSet: AgentConfig[], context: AgenticContext, params: ExecuteAgentSetParams): Promise<ExecutionResult>;
+/**
+ * Execute agent - Responses API version
+ */
+export declare function executeAgent(agentSet: AgentConfig[], params: ExecuteAgentSetParams): Promise<ExecuteAgentResult>;
+/**
+ * Execute query - Responses API version
+ */
+export declare function executeQuery(params: ExecuteAgentSetParams): Promise<ExecuteAgentResult>;