{
  "title": "[Demo] The Goblin Ambush (HP script)",
  "description": "A tiny combat scene that shows script-driven state: the AI narrates and decides damage, a JavaScript script tracks your HP. Open the State panel on the left to watch it change.",
  "prompt": "The forest path narrows between two moss-choked boulders. You are halfway through when the bushes erupt — three goblins, blades drawn, teeth bared. The lead one lunges at you with a rusty scimitar.\n\nYou have no time to think.",
  "memory": "The player is a lone traveler ambushed by three goblins on a forest path. This is a dangerous but fair combat encounter. The player starts at full health.",
  "authors_note": "Keep the combat visceral and consequential. Let the player's choices matter — a reckless move should hurt, a clever one should pay off.",
  "ai_instructions": "Write in second person, present tense. End each response where the player can act.",
  "tags": "demo, combat, scripting, hp, short",
  "story_cards": [],
  "scripts": [
    {
      "name": "[Demo] HP System",
      "description": "AI-driven health. The script tells the AI the current HP and to tag damage/healing as [HP-N]/[HP+N]; the AI decides the amounts, the script applies them to state.hp and hides the tags. Watch state.hp in the left State panel.",
      "library_js": "// Shared HP helpers — available to every hook of this script.\nvar HP_MAX = 100;\nfunction getHp() {\n  if (typeof state.hp !== \"number\") state.hp = HP_MAX;\n  return state.hp;\n}\nfunction setHp(value) {\n  state.hp = Math.max(0, Math.min(HP_MAX, Math.round(value)));\n  return state.hp;\n}\n",
      "input_js": "",
      "context_js": "// Tell the AI the current HP and how to report changes it decides on.\nvar modifier = function (text) {\n  var hp = getHp();\n  var note =\n    \"\\n\\n[HP SYSTEM] The player currently has \" + hp + \" of \" + HP_MAX + \" HP. \" +\n    \"You, the narrator, decide when and how much the player is hurt or healed based on the story. \" +\n    \"When the player takes damage (an attack, trap, or fall) or heals (a potion, rest, or spell), \" +\n    \"append a tag on its own line at the very end of your reply: [HP-N] for damage or [HP+N] for healing, \" +\n    \"where N is a whole number. For example a solid sword blow might be [HP-14]; a healing potion might be [HP+25]. \" +\n    \"Include the tag only when HP actually changes, and never explain or mention the tag in the prose.\";\n  return { text: text + note };\n};\nmodifier(text);\n",
      "output_js": "// Read the AI's [HP+N]/[HP-N] tags, apply them to state, hide them from the player.\nvar modifier = function (text) {\n  var re = /\\[HP([+-])(\\d{1,3})\\]/g;\n  var hp = getHp();\n  var changed = false;\n  var m;\n  while ((m = re.exec(text)) !== null) {\n    var amount = parseInt(m[2], 10);\n    hp += (m[1] === \"-\" ? -amount : amount);\n    changed = true;\n  }\n  if (changed) setHp(hp);\n  var clean = text\n    .replace(/\\[HP[+-]\\d{1,3}\\]/g, \"\")\n    .replace(/[ \\t]+\\n/g, \"\\n\")\n    .replace(/\\n{3,}/g, \"\\n\\n\")\n    .trim();\n  if (changed && getHp() <= 0 && !state.dead) {\n    state.dead = true;\n    clean += \"\\n\\nYour strength gives out and the world goes dark. (0 HP)\";\n  }\n  return { text: clean };\n};\nmodifier(text);\n"
    }
  ]
}