Draft episode script
draft_episode_scriptWrite an episode's scene-by-scene script: draft it from premise, or adapt the writer's own scriptText; pass exactly one (400 for both or neither). It replaces the episode's scenes and returns { episode, scenesGenerated, source, sceneCountCheck }; review and edit with save_episode before generate_episode. groundInResearch adds web research to a premise draft. The series needs at least one character, and an episode that is generating is refused. Spends Galatic.AI credits (402 when the budget is short). seriesId is the flowId of the Flow Studio flow that holds the series (from list_flows).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"seriesId": "<seriesId>",
"episodeId": "<episodeId>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "draft_episode_script"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as "a user", "the customer", or "an account". Example: "Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution." | |
| premise | No | What happens. Send this or scriptText, not both. | |
| seriesId | Yes | ||
| episodeId | Yes | ||
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" — never guess. | |
| scriptText | No | A finished script to adapt into scenes. Send this or premise. | |
| conversation_id | No | Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request. | |
| groundInResearch | No | Premise drafts only: ground the draft in web research (costs more). |