storyroom-roan.vercel.app

{
  "name": "get_story_context",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieve the project's essential context: title, genre, logline, director's intent, characters, locations, scene index, and relevant story facts.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "required": []
  }
}

{
  "name": "get_current_scene",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieve the complete record for a scene by number or ID, including screenplay text, characters, location, time of day, and emotional goal.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sceneId": {
        "type": "string",
        "description": "Scene number (e.g. \"4\", \"scene-4\", or \"The Report\")"
      }
    },
    "required": [
      "sceneId"
    ]
  }
}

{
  "name": "search_scenes",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search across scene screenplay text, titles, summaries, and character appearances. Supports filtering by character, location, and time of day.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search query (matches dialogue, action, scene summaries)"
      },
      "character": {
        "type": "string",
        "description": "Optional character filter (e.g. \"Riya\", \"Arjun\", \"Kabir\")"
      },
      "location": {
        "type": "string",
        "description": "Optional location filter (e.g. \"Cafe\", \"Editing Studio\", \"Railway Station\")"
      },
      "timeOfDay": {
        "type": "string",
        "description": "Optional time of day filter (e.g. \"DAY\", \"NIGHT\", \"DAWN\")"
      }
    },
    "required": []
  }
}

{
  "name": "get_character",
  "kind": "answer",
  "impl": "imperative",
  "description": "Retrieve detailed character profile, personality, relationships, emotional arc, and the list of scenes they appear in.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "characterName": {
        "type": "string",
        "description": "Character name or ID (e.g. \"Riya\", \"Arjun\", \"Kabir\", \"char-riya\")"
      }
    },
    "required": [
      "characterName"
    ]
  }
}

{
  "name": "check_continuity",
  "kind": "answer",
  "impl": "imperative",
  "description": "Audit the screenplay for contradictions: character age mentions vs profiles, inconsistent location naming, timeline discrepancies, and prop label variations.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sceneId": {
        "type": "string",
        "description": "Optional scene identifier to scope continuity checks to a single scene"
      }
    },
    "required": []
  }
}

{
  "name": "analyze_scene",
  "kind": "act",
  "impl": "imperative",
  "description": "Evaluate a scene's pacing, emotional intensity, dialogue subtext, visual storytelling, and alignment with Director's Memory creative rules.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sceneId": {
        "type": "string",
        "description": "Scene number or ID to analyze (e.g. \"scene-4\")"
      }
    },
    "required": [
      "sceneId"
    ]
  }
}

{
  "name": "propose_rewrite",
  "kind": "act",
  "impl": "imperative",
  "description": "Draft a revised screenplay version that increases restraint, subtext, or tension per Director's Memory. Does NOT overwrite live script; creates a pending revision for human approval.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "sceneId": {
        "type": "string",
        "description": "Scene number or ID to rewrite (e.g. \"scene-4\")"
      },
      "instruction": {
        "type": "string",
        "description": "Creative instruction or reasoning for the rewrite (e.g. \"Make dialogue more restrained\")"
      }
    },
    "required": [
      "sceneId"
    ]
  }
}

{
  "name": "apply_revision",
  "kind": "act",
  "impl": "imperative",
  "description": "Commit a director-approved screenplay revision to the project. Requires that the revision has already received explicit director approval via the StoryRoom UI. Returns HUMAN_APPROVAL_REQUIRED if called on unapproved/pending revisions.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "revisionId": {
        "type": "string",
        "description": "The unique ID of the already-approved revision to commit (e.g. \"rev-xxxx\")"
      }
    },
    "required": [
      "revisionId"
    ]
  }
}