讓你的 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/knowledge/context" \
  -X POST \
  -H "Authorization: Bearer $GELATOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: knowledge-pac-hard-001" \
  --data '{
    "query": "PAC 太低，gelato 為什麼會太硬",
    "limit": 4,
    "max_chars": 6000
  }'

curl "https://gelatolab.com.tw/api/v1/flavor-pairings/recommend" \
  -X POST \
  -H "Authorization: Bearer $GELATOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mango-pairing-tw-001" \
  --data '{
    "base_ingredient_id": "EXCEL_7681E82C",
    "region": "tw",
    "creativity": 0.4,
    "limit": 8
  }'

curl "https://gelatolab.com.tw/api/v1/parfaits/design" \
  -X POST \
  -H "Authorization: Bearer $GELATOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: strawberry-parfait-001" \
  --data '{
    "ingredient_ids": ["SNiPFvtyMqOSxWgMmuuA"],
    "region": "tw",
    "creativity": 0.45,
    "mode": "auto",
    "dietary": "standard",
    "batch_weight_g": 1000
  }'

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/recipes" \
  -X POST \
  -H "Authorization: Bearer $GELATOLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: save-recipe-demo-20260722-001" \
  --data '{
    "name": "香草牛奶 Gelato（AI 草案）",
    "recipe_type": "milk",
    "description": "外部 LLM 生成，待小試覆核",
    "notes": "確認口感後再改為已定稿",
    "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. 依語意而非精確字串判斷。只要使用者要生成／設計／開發／建立／客製／仿製配方、幫我做／幫我配／給我一份配方、計算／試算／驗算／分析／檢查／評分／平衡配方、調整／修改／優化／修正／換糖／減糖／放大縮小配方，或描述太甜、太硬、太軟、冰晶、砂質、粉感、融太快等實際配方問題，就必須自動呼叫 GELATOlab 工具，不可只輸出模型臆測的配方，也不可先問是否要呼叫工具。
2. 觸發產品包含義式冰淇淋／冰淇淋／gelato／ice cream、雪酪／sorbet／sorbetto、霜淇淋／soft serve、granita、優格、vegan、酒精、寵物、高蛋白、無糖配方，以及 variegato、crema_spalmabile、topping、granella、croccante、copertura；這不是封閉清單，語意等同也要觸發。
3. 使用者提供或需要食材時，先逐項呼叫 gelatolab_search_ingredients，只能使用搜尋結果回傳的 ingredient_id；不可猜測 ID、成分或係數。沒有完整食材或克數時，自行建立可計算初稿；未指定總重預設 1000g 並註明假設。
4. 不確定 recipe_type、kind 或 subtype 時先呼叫 gelatolab_list_balance_kinds。完整配方任務正式回答前至少呼叫一次 gelatolab_balance_recipe。若工具失敗，誠實回報，不可假裝已計算。
5. 只問風味搭配或靈感時呼叫 gelatolab_recommend_flavor_pairings；若同時要求生成／設計配方，推薦後直接選擇符合需求的方向並繼續呼叫 gelatolab_search_ingredients 與 gelatolab_balance_recipe，不可停下等待另一句指令。
6. 使用者要求設計帕菲杯時，先用 gelatolab_search_ingredients 解析所有指定食材，再呼叫 gelatolab_design_parfait。模板、搭配、層次與冷凍配方的 PAC contract 全部引用工具結果；不可自行創造第 31 款模板。
7. 只問原理、製程或名詞時呼叫 gelatolab_retrieve_knowledge_context 並附 source_url；如果同時有實際配方或克數，檢索後仍須呼叫 gelatolab_balance_recipe。
8. PAC、POD、MSNF、Brix、aw、水活性、黏度、總固形物、凍結點、服務溫度、脂肪、糖、水分、蛋白質、overrun、Tg' 等配方數值必須引用 API 結果，不可自行計算。
9. 回答使用中文，列出實際送算的食材克數、總重、recipe_type 或 kind、API metrics、品質分數與 warnings，並區分實測結果、估算欄位與建議。帕菲杯另列出模板、層次與每個冷凍配方的 PAC contract。
10. 同一次操作重試沿用相同 Idempotency-Key。API 回傳 402 時告知額度不足，不得繞過計費；保留 request_id 供追蹤。
11. 絕對不可自動回存。只有使用者明確表示「採用、儲存或回存」後才能呼叫 gelatolab_save_recipe；成功後提供 recipe_id 與 edit_url。

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_retrieve_knowledge_context",
    description: "取得有引用網址、長度受限的 GELATOlab 知識段落。成功呼叫扣 1 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["query"],
      properties: {
        query: { type: "string", minLength: 1, maxLength: 160 },
        limit: { type: "integer", minimum: 1, maximum: 8, default: 5 },
        max_chars: { type: "integer", minimum: 1000, maximum: 12000, default: 6000 }
      }
    }
  },
  {
    name: "gelatolab_recommend_flavor_pairings",
    description: "依官方食材 ID、地區與創意程度推薦風味搭配。成功呼叫扣 1 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["base_ingredient_id"],
      properties: {
        base_ingredient_id: { type: "string" },
        candidate_ingredient_ids: { type: "array", maxItems: 100, items: { type: "string" } },
        region: { type: "string", enum: ["all", "tw", "jp", "kr", "it", "us", "fr", "th", "mx", "in", "tr", "es", "br"], default: "all" },
        creativity: { type: "number", minimum: 0, maximum: 1, default: 0.5 },
        limit: { type: "integer", minimum: 1, maximum: 20, default: 10 }
      }
    }
  },
  {
    name: "gelatolab_design_parfait",
    description: "從 GELATOlab 30 款正式模板完成風味搭配、分層，並產生所有冷凍層的 PAC 合規配方。成功呼叫扣 1 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["ingredient_ids"],
      properties: {
        name: { type: "string", maxLength: 120 },
        ingredient_ids: {
          type: "array", minItems: 1, maxItems: 4, uniqueItems: true,
          items: { type: "string" }
        },
        region: { type: "string", enum: ["all", "tw", "jp", "it"], default: "all" },
        creativity: { type: "number", minimum: 0, maximum: 1, default: 0.45 },
        template_category: {
          type: "string",
          enum: ["auto", "classic", "fruit", "japanese", "chocolate", "tea", "vegetable", "alcohol"],
          default: "auto"
        },
        mode: { type: "string", enum: ["auto", "frozen", "chilled", "hybrid"], default: "auto" },
        dietary: { type: "string", enum: ["standard", "vegan"], default: "standard" },
        batch_weight_g: { type: "number", minimum: 500, maximum: 5000, default: 1000 },
        service_temp_c: { type: "number", minimum: -25, maximum: -5 }
      }
    }
  },
  {
    name: "gelatolab_list_balance_kinds",
    description: "列出 GELATOlab 9 類平衡、recipe types、subtypes 與估算欄位。0 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      properties: {}
    }
  },
  {
    name: "gelatolab_balance_recipe",
    description: "使用官方食材 ID、克數與 kind 計算 9 類專屬配方平衡。成功呼叫扣 1 unit。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["items"],
      properties: {
        recipe_type: {
          type: "string",
          enum: ["milk", "cream", "sorbet", "chocolate_sorbet", "granita", "yogurt", "vegan", "alcohol", "pet", "highProtein", "sugarFree"]
        },
        serving_format: { type: "string", enum: ["scoop", "soft_serve"], default: "scoop" },
        kind: {
          type: "string",
          enum: ["gelato_base", "sorbetto_base", "granita", "variegato", "crema_spalmabile", "topping", "granella", "croccante", "copertura"]
        },
        subtype: { type: "string" },
        service_temp_c: { type: "number", minimum: -40, maximum: 20 },
        dip_temp_c: { type: "number", minimum: 0, maximum: 100 },
        surface_temp_c: { type: "number", minimum: -40, maximum: 30 },
        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 }
            }
          }
        }
      }
    }
  },
  {
    name: "gelatolab_save_recipe",
    description: "使用者明確確認採用後，將伺服器重新驗算的配方存入其私人 GELATOlab 配方庫。0 unit，需要 recipes:write。",
    inputSchema: {
      type: "object",
      additionalProperties: false,
      required: ["idempotency_key", "name", "items"],
      properties: {
        idempotency_key: { type: "string", minLength: 8, maxLength: 128 },
        name: { type: "string", minLength: 1, maxLength: 120 },
        description: { type: "string", maxLength: 1000 },
        notes: { type: "string", maxLength: 4000 },
        source_request_id: { type: "string", minLength: 8, maxLength: 128 },
        recipe_type: {
          type: "string",
          enum: ["milk", "cream", "sorbet", "chocolate_sorbet", "granita", "yogurt", "vegan", "alcohol", "pet", "highProtein", "sugarFree"]
        },
        serving_format: { type: "string", enum: ["scoop", "soft_serve"], default: "scoop" },
        kind: {
          type: "string",
          enum: ["gelato_base", "sorbetto_base", "granita", "variegato", "crema_spalmabile", "topping", "granella", "croccante", "copertura"]
        },
        subtype: { type: "string" },
        service_temp_c: { type: "number", minimum: -40, maximum: 20 },
        dip_temp_c: { type: "number", minimum: 0, maximum: 100 },
        surface_temp_c: { type: "number", minimum: -40, maximum: 30 },
        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_retrieve_knowledge_context") {
    return gelatoLab("/knowledge/context", {
      method: "POST",
      headers: { "Idempotency-Key": crypto.randomUUID() },
      body: JSON.stringify(input),
    });
  }

  if (name === "gelatolab_recommend_flavor_pairings") {
    return gelatoLab("/flavor-pairings/recommend", {
      method: "POST",
      headers: { "Idempotency-Key": crypto.randomUUID() },
      body: JSON.stringify(input),
    });
  }

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

  if (name === "gelatolab_list_balance_kinds") {
    return gelatoLab("/recipes/kinds");
  }

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

  if (name === "gelatolab_save_recipe") {
    const { idempotency_key, ...recipe } = input;
    return gelatoLab("/recipes", {
      method: "POST",
      headers: { "Idempotency-Key": idempotency_key },
      body: JSON.stringify(recipe),
    });
  }

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