Cookwala APIs

curl https://cookwala.ai/.well-known/cookwala.json
curl https://cookwala.ai/v1/recipes/fah-234.cookwala.json
curl "https://cookwala.ai/v1/search?q=shakshuka&lang=ar&min_level=V1"
curl -X POST https://cookwala.ai/v1/match -H 'content-type: application/json' \
     -d @my-kitchen-capabilities.json

query {
  search(query: "couscous", filter: { cuisine: ["MA"], excludeAllergens: ["nuts"], minLevel: V1 }, lang: "fr") {
    total
    edges { node { id title(lang: "fr") level totalTime supervision allergensEU } }
  }
}

# create, confirm and start a session (assisted mode, dinner at 19:30)
curl -X POST https://cookwala-hub.local:7878/cookwala/v1/sessions -H "authorization: Bearer $T" \
  -d '{"recipes":[{"recipeId":"fah-234","servings":4}],"serveAt":"2026-10-03T19:30:00+03:00","mode":"assisted"}'
curl -X POST .../sessions/$S/confirm -d '{"acknowledgedRules":["us.fda-food-code-2022/allergen-disclosure"]}'
curl -X POST .../sessions/$S/start
# follow along
curl -N ".../events?types=cookwala.task.,cookwala.safety.&session=$S"

subscription { taskUpdated(sessionId: "s-123") { id state assignee { id kind } message(lang: "en") } }

{
  "name": "Cookwala Kitchen Hub",
  "description": "Plans and runs cooking sessions with this kitchen's robots, appliances and people.",
  "url": "https://cookwala-hub.local:7878/a2a",
  "version": "1.0.0",
  "capabilities": { "streaming": true, "pushNotifications": true },
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json", "text/plain"],
  "skills": [
    { "id": "plan_meal", "name": "Plan a meal", "description": "Choose recipes that this kitchen can cook for given diners, time and inventory.", "tags": ["cooking", "planning"] },
    { "id": "cook_recipe", "name": "Cook a recipe", "description": "Create, confirm (with a human) and run a cook session; streams task updates.", "tags": ["cooking", "robotics"] },
    { "id": "restock_kitchen", "name": "Restock", "description": "Build an order intent for missing ingredients; requires human approval.", "tags": ["groceries"] },
    { "id": "advise", "name": "Cooking advice", "description": "What can I cook, fix a mistake, rescue a meal, store food, feed N people, personalize portions.", "tags": ["cooking", "reasoning"] },
    { "id": "team_plan", "name": "Team plan", "description": "Split work across robots, appliances and people; contract-net teaming.", "tags": ["robotics", "planning"] },
    { "id": "relief_allocate", "name": "Relief allocation", "description": "Match aggregated needs with pledges across kitchens (coordinator hubs).", "tags": ["humanitarian"] }
  ],
  "securitySchemes": { "paired": { "type": "http", "scheme": "bearer" } },
  "security": [{ "paired": [] }]
}