@hiper2d/ai-agents 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -370,6 +370,7 @@ declare const LLM_CONSTANTS: {
     GLM: string;
     GLM_FLASH: string;
     FUGU_ULTRA: string;
+    FUGU_MAX: string;
     QWEN_MAX: string;
     QWEN_FLASH: string;
     MINIMAX: string;
@@ -527,7 +528,8 @@ declare function getProviderSignatureFields(aiType: string, signature?: string):
  * - Gemini 3.x thinkingLevel: minimal|low|medium|high (3.1 Pro and 3.7 Flash reject minimal)
  * - Z.AI GLM-5.3 / 5.3-Flash: low|high|max only
  * - DeepSeek V4: low|high|max (the API itself aliases medium → high)
- * - Sakana Fugu: high|xhigh
+ * - Sakana Fugu (verified live 2026-09-20): high|xhigh|max on every model ("low" → 400 naming
+ *   exactly that enum). The server default is xhigh for fugu-ultra and high for the rest.
  * - Meta Muse Spark (verified 2026-09-12): minimal|low|medium|high|xhigh|max ("none" → 400; max is
  *   Standard tier only)
  * - Mistral Small 4 / Medium 3.5 (verified 2026-09-18): the API enum is
@@ -543,7 +545,7 @@ type AnthropicReasoningEffort = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 type GeminiReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
 type GlmReasoningEffort = 'low' | 'high' | 'max';
 type DeepSeekReasoningEffort = 'low' | 'high' | 'max';
-type FuguReasoningEffort = 'high' | 'xhigh';
+type FuguReasoningEffort = 'high' | 'xhigh' | 'max';
 type MetaReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 type MistralReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 /** The shared scale, lowest first. */
@@ -1651,7 +1653,6 @@ declare class FuguAgent extends AbstractAgent {
     private readonly errorMessages;
     constructor(name: string, instruction: string, model: string, apiKey: string, enableThinking?: boolean, agentLoggingConfig?: AgentLoggingConfig);
     private convertToOpenAIMessages;
-    private logRawUsageForCalibration;
     private extractThinkingAndUsage;
     private prependSystemInstruction;
     doAskWithZodSchema<T>(zodSchema: z.ZodSchema<T>, messages: AIMessage[]): Promise<[T, string, TokenUsage$1?, string?]>;

package/dist/index.d.ts

@@ -370,6 +370,7 @@ declare const LLM_CONSTANTS: {
     GLM: string;
     GLM_FLASH: string;
     FUGU_ULTRA: string;
+    FUGU_MAX: string;
     QWEN_MAX: string;
     QWEN_FLASH: string;
     MINIMAX: string;
@@ -527,7 +528,8 @@ declare function getProviderSignatureFields(aiType: string, signature?: string):
  * - Gemini 3.x thinkingLevel: minimal|low|medium|high (3.1 Pro and 3.7 Flash reject minimal)
  * - Z.AI GLM-5.3 / 5.3-Flash: low|high|max only
  * - DeepSeek V4: low|high|max (the API itself aliases medium → high)
- * - Sakana Fugu: high|xhigh
+ * - Sakana Fugu (verified live 2026-09-20): high|xhigh|max on every model ("low" → 400 naming
+ *   exactly that enum). The server default is xhigh for fugu-ultra and high for the rest.
  * - Meta Muse Spark (verified 2026-09-12): minimal|low|medium|high|xhigh|max ("none" → 400; max is
  *   Standard tier only)
  * - Mistral Small 4 / Medium 3.5 (verified 2026-09-18): the API enum is
@@ -543,7 +545,7 @@ type AnthropicReasoningEffort = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 type GeminiReasoningEffort = 'minimal' | 'low' | 'medium' | 'high';
 type GlmReasoningEffort = 'low' | 'high' | 'max';
 type DeepSeekReasoningEffort = 'low' | 'high' | 'max';
-type FuguReasoningEffort = 'high' | 'xhigh';
+type FuguReasoningEffort = 'high' | 'xhigh' | 'max';
 type MetaReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 type MistralReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
 /** The shared scale, lowest first. */
@@ -1651,7 +1653,6 @@ declare class FuguAgent extends AbstractAgent {
     private readonly errorMessages;
     constructor(name: string, instruction: string, model: string, apiKey: string, enableThinking?: boolean, agentLoggingConfig?: AgentLoggingConfig);
     private convertToOpenAIMessages;
-    private logRawUsageForCalibration;
     private extractThinkingAndUsage;
     private prependSystemInstruction;
     doAskWithZodSchema<T>(zodSchema: z.ZodSchema<T>, messages: AIMessage[]): Promise<[T, string, TokenUsage$1?, string?]>;

package/dist/index.js

@@ -976,6 +976,7 @@ var LLM_CONSTANTS = {
   GLM: "glm",
   GLM_FLASH: "glm-flash",
   FUGU_ULTRA: "fugu-ultra",
+  FUGU_MAX: "fugu-max",
   // Qwen (QwenCloud/DashScope). Stable picker ids without the version, matching the gpt/gemini
   // pattern, so future repoints don't orphan persisted ids.
   QWEN_MAX: "qwen-max",
@@ -1221,13 +1222,37 @@ var SupportedAiModels = {
   // so the rate is not even guaranteed stable, and its cache hit rate was 9.3% — effectively
   // zero, since every hit came from a duplicate call seconds apart rather than turn-to-turn
   // prefix reuse. Ultra costs the same and is predictable.
+  //
+  // reasoningEffort is PINNED on both entries because the server default differs per model:
+  // fugu-ultra defaults to `xhigh` (console.sakana.ai/models), fugu-max to `high`. Until
+  // 2026-09-20 the agent sent no effort at all, so every Ultra turn ran at xhigh. Measured that
+  // day on a 2k-token three-day game prompt (two samples each, chat completions, json mode):
+  //   ultra xhigh  148s / 265s   $0.34 / $0.50 a turn (orchestration tokens included)
+  //   ultra high    65s /  78s   $0.16 / $0.17
+  //   max   high     6s /  10s   $0.006 / $0.008
+  //   max   xhigh   41s /  47s   $0.02
+  // `max_tokens` is not a latency lever for Ultra: Sakana applies it to the final response only,
+  // the orchestrator "still uses maximum token limit". Effort is the only knob.
   [LLM_CONSTANTS.FUGU_ULTRA]: {
     displayName: "Sakana Fugu Ultra",
     modelApiName: "fugu-ultra",
     apiKeyName: API_KEY_CONSTANTS.FUGU,
     hasThinking: false,
+    reasoningEffort: "high",
     tags: ["extremely-slow", "expensive"]
   },
+  // Fugu Max (2026-09-20, fugu-max → fugu-max-v1.0): Sakana's "largest pool of models on the
+  // cost–performance Pareto frontier" — the everyday Fugu at 5x less than Ultra's output rate
+  // and a fraction of its latency. It reasons (reasoning_tokens 80-500 a turn) but, like
+  // Ultra, never returns reasoning_content, hence hasThinking: false. No orchestration
+  // tokens observed on any call.
+  [LLM_CONSTANTS.FUGU_MAX]: {
+    displayName: "Sakana Fugu Max",
+    modelApiName: "fugu-max",
+    apiKeyName: API_KEY_CONSTANTS.FUGU,
+    hasThinking: false,
+    reasoningEffort: "high"
+  },
   // Qwen models (QwenCloud, OpenAI-compatible endpoint). Added 2026-08-05 straight into the
   // thinking-only catalog: their API has an `enable_thinking` toggle, we always send true, and
   // thinking arrives in `reasoning_content` (verified live against all three, non-streaming).
@@ -1515,9 +1540,12 @@ var MODEL_PRICING = {
     extendedContextCacheHitPrice: 1,
     extendedContextThresholdTokens: 2e5
   },
-  // Sakana Fugu models. Base `fugu` was retired 2026-08-04 — it had no published price and
-  // measured out at these same ultra rates, so it has no pricing entry.
-  // fugu-ultra has published pricing. Above 272K context the rates roughly double.
+  // Sakana Fugu models (console.sakana.ai/pricing, read 2026-09-20). Base `fugu` was retired
+  // 2026-08-04 — it had no published price and measured out at these same ultra rates, so it
+  // has no pricing entry. fugu-ultra: above 272K context the rates roughly double. Ultra also
+  // reports "orchestration" tokens (its internal expert calls) in prompt_tokens_details /
+  // completion_tokens_details, billed at these same input/output rates — FuguAgent folds them
+  // into the token counts before pricing.
   [SupportedAiModels[LLM_CONSTANTS.FUGU_ULTRA].modelApiName]: {
     inputPrice: 5,
     outputPrice: 30,
@@ -1527,6 +1555,12 @@ var MODEL_PRICING = {
     extendedContextCacheHitPrice: 1,
     extendedContextThresholdTokens: 272e3
   },
+  // fugu-max: flat rates, no context tiers.
+  [SupportedAiModels[LLM_CONSTANTS.FUGU_MAX].modelApiName]: {
+    inputPrice: 2,
+    outputPrice: 6,
+    cacheHitPrice: 0.25
+  },
   // Qwen models. Rates from the official pricing page (qwencloud.com/pricing/api, read
   // 2026-08-30 — the page is client-rendered, so it was read by eye, not WebFetch):
   // qwen3.8-max $2/$6 with implicit-cache hits at $0.25; qwen3.8-flash $0.15/$0.47, hits
@@ -1643,7 +1677,7 @@ var ANTHROPIC_REASONING_EFFORTS = ["low", "medium", "high", "xhigh", "max"];
 var GEMINI_REASONING_EFFORTS = ["minimal", "low", "medium", "high"];
 var GLM_REASONING_EFFORTS = ["low", "high", "max"];
 var DEEPSEEK_REASONING_EFFORTS = ["low", "high", "max"];
-var FUGU_REASONING_EFFORTS = ["high", "xhigh"];
+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"];
 function clampReasoningEffort(effort, allowed) {
@@ -4411,13 +4445,15 @@ var FuguAgent = class extends AbstractAgent {
   client;
   // A getter, not a field: `maxOutputTokens` can be raised after construction, and a field
   // initializer would snapshot the default and silently ignore the override.
+  // `reasoning_effort` is re-declared as string: the OpenAI SDK's union lacks Sakana's 'max'.
   get defaultParams() {
     return {
       model: this.model,
       stream: false,
-      // Caps visible output only. Server-side orchestration/reasoning tokens are
-      // separate and unaffected by this.
-      max_tokens: this.maxOutputTokens
+      // Caps the final reply only. Per Sakana's docs the orchestrator "still uses maximum
+      // token limit", so this bounds neither Ultra's latency nor its orchestration spend.
+      max_tokens: this.maxOutputTokens,
+      reasoning_effort: toFuguEffort(this.reasoningEffort ?? "high")
     };
   }
   logTemplates = {
@@ -4442,33 +4478,6 @@ var FuguAgent = class extends AbstractAgent {
       content: msg.content
     }));
   }
-  // ───────────────────────────────────────────────────────────────────────────────────────
-  // TEMPORARY (cost calibration). Base `fugu` is a dynamic router with no published per-token
-  // price and Sakana returns NO cost field in the response — only token counts. Crucially the
-  // response also reports "orchestration tokens" (billed at input/output rates per Sakana's
-  // pricing page) that our standard TokenUsage drops. This logs the full raw breakdown to
-  // BetterStack under a distinctive tag so we can sum real tokens per game and, combined with
-  // the Sakana billing dashboard total, derive the true per-token rate. REMOVE AFTER CALIBRATION.
-  logRawUsageForCalibration(completion) {
-    const usage = completion?.usage;
-    if (!usage) return;
-    logger.info("FUGU_COST_CALIBRATION", {
-      tag: "FUGU_COST_CALIBRATION",
-      model: this.model,
-      agentName: this.name,
-      gameId: this.gameId,
-      userId: this.userId,
-      promptTokens: usage.prompt_tokens ?? 0,
-      completionTokens: usage.completion_tokens ?? 0,
-      totalTokens: usage.total_tokens ?? 0,
-      cachedTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,
-      orchestrationInputTokens: usage.prompt_tokens_details?.orchestration_input_tokens ?? 0,
-      orchestrationInputCachedTokens: usage.prompt_tokens_details?.orchestration_input_cached_tokens ?? 0,
-      reasoningTokens: usage.completion_tokens_details?.reasoning_tokens ?? 0,
-      orchestrationOutputTokens: usage.completion_tokens_details?.orchestration_output_tokens ?? 0,
-      rawUsage: usage
-    });
-  }
   extractThinkingAndUsage(completion) {
     let thinkingContent = "";
     const message = completion.choices[0]?.message;
@@ -4476,21 +4485,14 @@ var FuguAgent = class extends AbstractAgent {
       thinkingContent = message.reasoning_content;
       this.logger(`Captured reasoning_content (${thinkingContent.length} characters)`);
     }
-    let tokenUsage;
-    const usageResult = extractUsageAndCalculateCost(this.model, completion);
-    if (usageResult) {
-      tokenUsage = {
-        inputTokens: usageResult.usage.promptTokens,
-        outputTokens: usageResult.usage.completionTokens,
-        totalTokens: usageResult.usage.totalTokens,
-        costUSD: usageResult.cost,
-        ...usageResult.usage.cacheHitTokens !== void 0 ? { cachedInputTokens: usageResult.usage.cacheHitTokens } : {}
-      };
-      if (usageResult.usage.reasoningTokens) {
-        const reasoningTokens = usageResult.usage.reasoningTokens;
-        const finalAnswerTokens = Math.max(0, tokenUsage.outputTokens - reasoningTokens);
+    const tokenUsage = extractFuguTokenUsage(this.model, completion);
+    if (tokenUsage) {
+      const details = completion.usage ?? {};
+      const orchestrationIn = details.prompt_tokens_details?.orchestration_input_tokens ?? 0;
+      const orchestrationOut = details.completion_tokens_details?.orchestration_output_tokens ?? 0;
+      if (tokenUsage.reasoningTokens || orchestrationIn || orchestrationOut) {
         this.logger(
-          `Output breakdown: ${reasoningTokens} reasoning tokens, ${finalAnswerTokens} final answer tokens`
+          `Usage breakdown: ${tokenUsage.reasoningTokens ?? 0} reasoning tokens; orchestration ${orchestrationIn} in / ${orchestrationOut} out (billed, folded into the totals)`
         );
       }
     }
@@ -4532,7 +4534,6 @@ ${schemaDescription}`;
         this.logger(this.logTemplates.error(this.name, apiError));
         throw new Error(this.errorMessages.apiError(apiError));
       }
-      this.logRawUsageForCalibration(completion);
       const rawReply = completion.choices[0]?.message?.content;
       if (!rawReply) {
         throw new Error(this.errorMessages.emptyResponse);
@@ -4576,7 +4577,6 @@ ${schemaDescription}`;
         this.logger(this.logTemplates.error(this.name, apiError));
         throw new Error(this.errorMessages.apiError(apiError));
       }
-      this.logRawUsageForCalibration(completion);
       const rawReply = completion.choices[0]?.message?.content;
       if (!rawReply) {
         throw new Error(this.errorMessages.emptyResponse);
@@ -4595,6 +4595,31 @@ ${schemaDescription}`;
     }
   }
 };
+function extractFuguTokenUsage(modelApiName, completion) {
+  const usage = completion?.usage;
+  if (!usage) {
+    return void 0;
+  }
+  const promptDetails = usage.prompt_tokens_details ?? {};
+  const completionDetails = usage.completion_tokens_details ?? {};
+  const inputTokens = (usage.prompt_tokens ?? 0) + (promptDetails.orchestration_input_tokens ?? 0);
+  const outputTokens = (usage.completion_tokens ?? 0) + (completionDetails.orchestration_output_tokens ?? 0);
+  const cachedInputTokens = (promptDetails.cached_tokens ?? 0) + (promptDetails.orchestration_input_cached_tokens ?? 0);
+  const reasoningTokens = completionDetails.reasoning_tokens ?? 0;
+  return {
+    inputTokens,
+    outputTokens,
+    totalTokens: inputTokens + outputTokens,
+    cachedInputTokens,
+    // Omitted rather than 0: consumers persist the object as-is (see TokenUsage).
+    ...reasoningTokens > 0 ? { reasoningTokens } : {},
+    costUSD: calculateModelCost(modelApiName, inputTokens, outputTokens, {
+      cacheHitTokens: cachedInputTokens,
+      // Context-tier selection: the request's own size, not the orchestrator's traffic.
+      contextTokens: usage.total_tokens ?? inputTokens
+    })
+  };
+}
 
 // src/agents/qwen-agent.ts
 var import_openai9 = require("openai");
@@ -5255,6 +5280,7 @@ var AgentFactory = class {
         return new GlmAgent(name, instruction, model.modelApiName, key, model.temperature, shouldEnableThinking);
       // Sakana Fugu models — always-on reasoning, no temperature (ignored by the model)
       case LLM_CONSTANTS.FUGU_ULTRA:
+      case LLM_CONSTANTS.FUGU_MAX:
         return new FuguAgent(name, instruction, model.modelApiName, key, shouldEnableThinking);
       // Qwen models — thinking-only (enable_thinking always sent)
       case LLM_CONSTANTS.QWEN_MAX: