@hiper2d/ai-agents 0.10.0 → 0.12.0

package/dist/index.mjs

@@ -969,6 +969,7 @@ var SupportedAiModels = {
     modelApiName: "grok-4.7",
     apiKeyName: API_KEY_CONSTANTS.GROK,
     hasThinking: true,
+    reasoningEffort: "high",
     temperature: 0.7
   },
   // Mistral models. Two hybrid entries since 2026-09-18: reasoning is off by default on the
@@ -1017,6 +1018,9 @@ var SupportedAiModels = {
     hasThinking: true,
     // Temperature is omitted from the request: kimi-k3 rejects any value other than 1.
     // Speed samples: 17s (2026-08-04) and 28.9s (2026-08-05) — graded into the >25s tier.
+    // Pinned 'high' 2026-09-22, down from Moonshot's 'max' default: K3 had no levels at
+    // launch and the agent hardcoded max, so this is the first time the knob exists.
+    reasoningEffort: "high",
     tags: ["very-slow", "expensive"]
   },
   // Z.AI models — thinking-only entry (non-thinking variant retired 2026-08-05)
@@ -1530,6 +1534,8 @@ var DEEPSEEK_REASONING_EFFORTS = ["low", "high", "max"];
 var FUGU_REASONING_EFFORTS = ["high", "xhigh", "max"];
 var META_REASONING_EFFORTS = ["minimal", "low", "medium", "high", "xhigh", "max"];
 var MISTRAL_REASONING_EFFORTS = ["minimal", "low", "medium", "high", "xhigh"];
+var XAI_REASONING_EFFORTS = ["low", "medium", "high", "xhigh"];
+var KIMI_REASONING_EFFORTS = ["low", "high", "max"];
 function clampReasoningEffort(effort, allowed) {
   const rank = REASONING_EFFORT_SCALE.indexOf(effort);
   let best = allowed[0];
@@ -1551,6 +1557,8 @@ var toDeepSeekEffort = (effort) => clampReasoningEffort(effort, DEEPSEEK_REASONI
 var toMetaEffort = (effort) => clampReasoningEffort(effort, META_REASONING_EFFORTS);
 var toFuguEffort = (effort) => clampReasoningEffort(effort, FUGU_REASONING_EFFORTS);
 var toMistralEffort = (effort) => clampReasoningEffort(effort, MISTRAL_REASONING_EFFORTS);
+var toXaiEffort = (effort) => clampReasoningEffort(effort, XAI_REASONING_EFFORTS);
+var toKimiEffort = (effort) => clampReasoningEffort(effort, KIMI_REASONING_EFFORTS);
 
 // src/pricing/token-usage-utils.ts
 function extractTokenUsage(response) {
@@ -3788,6 +3796,16 @@ ${schemaDescription}`;
       throw new Error(this.errorMessages.apiError(error));
     }
   }
+  /**
+   * A stable key per (game, bot) so xAI routes this conversation's requests to the same
+   * server. Without it a request often lands on a cache-cold machine and the whole prompt
+   * bills at full input price — xAI calls this out as the most common caching mistake.
+   * Falls back to the bot name alone outside a game (story generation, tests), which is
+   * still stabler than sending nothing.
+   */
+  get promptCacheKey() {
+    return this.gameId ? `${this.gameId}:${this.name}` : this.name;
+  }
   createResponse(input, jsonMode) {
     return this.client.responses.create({
       model: this.model,
@@ -3798,9 +3816,16 @@ ${schemaDescription}`;
       // ever starts truncating — measured turns peak far below the shared default.
       max_output_tokens: this.maxOutputTokens,
       // We manage conversation state ourselves; encrypted reasoning is only
-      // returned for unstored responses.
+      // returned for unstored responses. Grok 4.7 returns reasoning.encrypted_content
+      // on the Responses API whether or not `include` asks for it; we keep asking so
+      // the behaviour is identical if the model is ever pointed back at 4.6.
       store: false,
       include: ["reasoning.encrypted_content"],
+      prompt_cache_key: this.promptCacheKey,
+      // Grok 4.7 is the first Grok with an effort knob (4.6 had none) and defaults to
+      // "high". Only send it when the catalog asks for a level, so an unset entry keeps
+      // the provider default rather than us silently picking one.
+      ...this.reasoningEffort ? { reasoning: { effort: toXaiEffort(this.reasoningEffort) } } : {},
       ...jsonMode ? { text: { format: { type: "json_object" } } } : {}
     });
   }
@@ -3908,8 +3933,8 @@ var KimiAgent = class extends AbstractAgent {
       model: this.model,
       stream: false,
       max_tokens: this.maxOutputTokens,
-      // Moonshot's only accepted level; "max" is not in the OpenAI SDK's ReasoningEffort union.
-      reasoning_effort: "max"
+      // "max" is not in the OpenAI SDK's ReasoningEffort union, hence the cast.
+      reasoning_effort: toKimiEffort(this.reasoningEffort ?? "max")
     };
   }
   // Log message templates
@@ -5185,6 +5210,7 @@ export {
   Gpt5Agent,
   GrokAgent,
   InMemorySpendStore,
+  KIMI_REASONING_EFFORTS,
   KimiAgent,
   LLM_CONSTANTS,
   MESSAGE_ROLE,
@@ -5213,6 +5239,7 @@ export {
   VOICE_MODEL_PRICING,
   VOICE_PROVIDER_API_KEY,
   VoiceAgentFactory,
+  XAI_REASONING_EFFORTS,
   ZodSchemaConverter,
   applySpend,
   buildGoogleTtsPrompt,
@@ -5290,9 +5317,11 @@ export {
   toFuguEffort,
   toGeminiEffort,
   toGlmEffort,
+  toKimiEffort,
   toMetaEffort,
   toMistralEffort,
   toOpenAIEffort,
+  toXaiEffort,
   transcribeWithGemini,
   transcribeWithOpenAi,
   validateResponse