@hiper2d/ai-agents 0.12.0 → 0.13.0

package/dist/index.mjs

@@ -886,10 +886,16 @@ var SupportedAiModels = {
   // GPT-6 Astra (2026-09-03): OpenAI's frontier tier above Sol. No `none` reasoning effort;
   // temperature/top_p are rejected — Gpt5Agent sends neither, so the same agent serves it.
   // The catalog temperature is only carried for the agent constructor signature.
+  // All four OpenAI entries carry reasoningEffort: 'medium' as of 2026-09-22. That is
+  // OpenAI's own current default, established by MEASUREMENT rather than docs: each model was
+  // called with no reasoning param and the effort it echoes back read off the response, since
+  // OpenAI documents the default for Sol, Luna and the 5.6 family but never states Astra's.
+  // Pinning it changes no behaviour today; it stops the default moving under us silently.
   [LLM_CONSTANTS.GPT_ASTRA]: {
     displayName: "GPT-6 Astra",
     modelApiName: "gpt-6-astra",
     apiKeyName: API_KEY_CONSTANTS.OPENAI,
+    reasoningEffort: "medium",
     hasThinking: true,
     temperature: 1,
     tags: ["expensive"]
@@ -904,6 +910,7 @@ var SupportedAiModels = {
     displayName: "GPT-6 Sol",
     modelApiName: "gpt-6-sol",
     apiKeyName: API_KEY_CONSTANTS.OPENAI,
+    reasoningEffort: "medium",
     hasThinking: true,
     temperature: 1,
     tags: ["expensive"]
@@ -912,6 +919,7 @@ var SupportedAiModels = {
     displayName: "GPT-5.6 Terra",
     modelApiName: "gpt-5.6-terra",
     apiKeyName: API_KEY_CONSTANTS.OPENAI,
+    reasoningEffort: "medium",
     hasThinking: true,
     temperature: 1,
     tags: ["fast", "expensive"]
@@ -920,6 +928,7 @@ var SupportedAiModels = {
     displayName: "GPT-6 Luna",
     modelApiName: "gpt-6-luna",
     apiKeyName: API_KEY_CONSTANTS.OPENAI,
+    reasoningEffort: "medium",
     hasThinking: true,
     temperature: 1,
     tags: ["fast", "cheap"]
@@ -2333,6 +2342,17 @@ ${instruction}`);
       apiKey
     });
   }
+  /**
+   * `reasoning: {effort}`, sent only when the catalog names a level. Every current OpenAI
+   * model defaults to "medium" when the field is omitted — verified 2026-09-22 by calling
+   * astra/sol/terra/luna with no reasoning param and reading the effort the API echoes back,
+   * since OpenAI documents the default for Sol, Luna and the 5.6 family but not for Astra.
+   * The catalog pins all four to medium so the level is explicit in our request rather than
+   * inherited from a default OpenAI can change under us.
+   */
+  reasoningParams() {
+    return this.reasoningEffort ? { reasoning: { effort: toOpenAIEffort(this.reasoningEffort) } } : {};
+  }
   /**
    * Structured output method using Zod with OpenAI's Responses API
    * This provides better schema handling and runtime validation
@@ -2353,6 +2373,7 @@ ${instruction}`);
           input,
           max_output_tokens: this.maxOutputTokens,
           prompt_cache_key: this.promptCacheKey,
+          ...this.reasoningParams(),
           text: {
             format: zodTextFormat(schemaToSend, "response_schema")
           }
@@ -2437,7 +2458,8 @@ ${instruction}`);
         instructions: this.instruction,
         input,
         max_output_tokens: this.maxOutputTokens,
-        prompt_cache_key: this.promptCacheKey
+        prompt_cache_key: this.promptCacheKey,
+        ...this.reasoningParams()
       });
       const content = response.output_text;
       if (!content) {