agentic-api 2.0.314 → 2.0.585

package/dist/src/execute/modelconfig.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelConfig = modelConfig;
+const llm_1 = require("../llm");
+const pricing_1 = require("../llm/pricing");
+/**
+ * Configuration des modèles pour Chat Completions (legacy) et Responses API
+ *
+ * Gère la configuration des modèles avec migration automatique des paramètres
+ * entre les deux APIs.
+ *
+ * @param model - Alias du modèle (ex: "LOW", "MEDIUM", "HIGH", "EMBEDDING-small", "VISION")
+ * @param custom - Options personnalisées (provider, thinking, temperature, etc.)
+ * @param custom.provider - Provider à utiliser ('openai' | 'xai'), default: LLM_PROVIDER env
+ * @param custom.thinking - Active le mode raisonnement (reasoning_effort: high)
+ * @param forResponses - Si true, adapte pour l'API Responses (sinon Chat Completions)
+ *
+ * @example
+ * // Modèle par défaut
+ * const config = modelConfig("MEDIUM");
+ *
+ * // Forcer OpenAI pour embeddings
+ * const config = modelConfig("EMBEDDING-small", { provider: 'openai' });
+ *
+ * // Vision avec xAI
+ * const config = modelConfig("VISION", { provider: 'xai' });
+ */
+function modelConfig(model, custom, forResponses = false) {
+    //
+    // Extraire et supprimer les paramètres spéciaux
+    const provider = custom?.provider || (0, llm_1.getDefaultProvider)();
+    const thinking = custom?.thinking || false;
+    delete custom?.provider;
+    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_1.LLM)(provider, thinking);
+    //
+    // Vérifier que le modèle existe pour ce provider
+    if (!mapping[model]) {
+        const availableModels = Object.keys(mapping).join(', ');
+        throw new Error(`Model "${model}" not available for provider "${provider}". ` +
+            `Available models: ${availableModels}`);
+    }
+    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>;