讓你的 LLM，
接上配方科學。

curl "https://gelatolab.com.tw/api/v1/ingredients/search?q=鮮奶&limit=5" \
  -H "Authorization: Bearer $GELATOLAB_API_KEY"

curl "https://gelatolab.com.tw/api/v1/recipes/balance" \
  -X POST \
  -H "Authorization: Bearer $GELATOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: recipe-demo-20260717-001" \
  --data '{
    "recipe_type": "milk",
    "items": [
      { "ingredient_id": "ilLc1HQsDxs7X4vyVDR1", "grams": 600 },
      { "ingredient_id": "2Sef4m2eeoyHz11NqQwq", "grams": 150 },
      { "ingredient_id": "v5qYjTLMaisEiKy9has0", "grams": 160 },
      { "ingredient_id": "CFY4HJ1JJXrcB8JvPPXM", "grams": 40 },
      { "ingredient_id": "R3_002", "grams": 50 }
    ]
  }'

curl "https://gelatolab.com.tw/api/v1/usage" \
  -H "Authorization: Bearer $GELATOLAB_API_KEY"

你可以使用 GELATOlab 配方工具。

規則：
1. 使用者提供食材名稱時，先逐項呼叫 searchIngredients。
2. 只能使用搜尋結果回傳的 ingredient_id；不可自行猜測 ID。
3. 收集所有 ID 與克數後，再呼叫 balanceRecipe。
4. PAC、POD、MSNF、總固形物與凍結點必須引用 API 結果，不可自行計算。
5. 同一次配方重試必須沿用相同 Idempotency-Key。
6. API 回傳 402 時，告知使用者額度不足；不要繞過計費。
7. API 回傳 request_id 時保留它，方便問題追蹤。

export const gelatolabTools = [
  {
    name: "gelatolab_search_ingredients",
    description: "把食材名稱解析為 GELATOlab 官方 ingredient_id。配方計算前必須先呼叫。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["query"],
      properties: {
        query: { type: "string", minLength: 1, maxLength: 80 },
        limit: { type: "integer", minimum: 1, maximum: 20, default: 5 }
      }
    }
  },
  {
    name: "gelatolab_balance_recipe",
    description: "使用官方食材 ID 與克數計算配方平衡。成功呼叫扣 1 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["recipe_type", "items"],
      properties: {
        recipe_type: {
          type: "string",
          enum: ["milk", "cream", "sorbet", "yogurt", "vegan", "alcohol", "pet", "highProtein", "sugarFree"]
        },
        items: {
          type: "array",
          minItems: 1,
          maxItems: 60,
          items: {
            type: "object",
            additionalProperties: false,
            required: ["ingredient_id", "grams"],
            properties: {
              ingredient_id: { type: "string" },
              grams: { type: "number", exclusiveMinimum: 0, maximum: 100000 }
            }
          }
        }
      }
    }
  }
];

import crypto from "node:crypto";
import { gelatoLab } from "./client.mjs";

export async function runGelatoLabTool(name, input) {
  if (name === "gelatolab_search_ingredients") {
    const query = new URLSearchParams({
      q: input.query,
      limit: String(input.limit || 5),
    });
    return gelatoLab(`/ingredients/search?${query}`);
  }

  if (name === "gelatolab_balance_recipe") {
    return gelatoLab("/recipes/balance", {
      method: "POST",
      headers: { "Idempotency-Key": crypto.randomUUID() },
      body: JSON.stringify(input),
    });
  }

  throw new Error(`Unknown tool: ${name}`);
}