Resources
Resource families are read-only, URI-addressable snapshots returned as resource_links from tool calls. Use them for large payloads (canon summaries, screenplay snapshots, wizard results) instead of inlining the whole object in a tool response.
account_status
Account Status
Caller-scoped BeatBandit account state including credits plus current default LLM and video model preferences.
analysis_wizard_result
Analysis Wizard Result
Read-only finalized Analysis Wizard scores, comments, and rewrite guidance.
asset_content
Asset Content
Binary content for one generated BeatBandit asset, delivered through BeatBandit instead of expiring storage URLs.
change_wizard_result
Change Story Result
Read-only finalized Change Story proposed changes and summary.
creative_canvas_result
Creative Canvas Result
Read-only finalized Creative Canvas directions.
diff_proposal
Diff Proposal
Full MCP diff proposal envelope for one saved rewrite or persona proposal.
episode_screenplay_result
Episode Screenplay Result
Read-only episodic screenplay generation result for one parent job.
export_artifact
Export Artifact
Read-only export artifact metadata or links.
media_catalog
Media Catalog
Paginated catalog of generated media assets for one project.
mentor_decisions
Story Mentor Decisions
Latest durable Story Mentor decision snapshot for one project.
novel_audits
Novel Audit Runs
Read-only history and findings for Novel continuity audit runs.
novel_blueprint
Novel Adaptation Blueprint
Read-only complete Adaptation Blueprint reconstructed from canonical Novel planning cards.
novel_candidate
Novel Manuscript Candidate
Read-only complete current and proposed Chapter documents for one Writer review checkpoint.
novel_canon
Novel Canon Ledger
Read-only canonical continuity ledger for a Novel project.
novel_changes
Novel Change Proposals
Read-only complete Novel review proposals and Chapter before/after detail.
novel_chapter
Novel Chapter
Read-only complete plain-text prose, compact Chapter plan, and linked source-unit resources for one Novel Chapter card. Excludes editor JSON and generation-debug payloads.
novel_manuscript
Novel Manuscript
Read-only canonical manuscript assembly in Chapter order.
novel_source
Novel Adaptation Source
Read-only normalized source package used by a Novel adaptation project.
novel_source_unit
Novel Adaptation Source Unit
Read-only canonical source text and metadata for one source unit linked from a Novel Chapter.
novel_voice
Novel Writing Voice
Read-only complete Voice Guidelines, Writing Samples, and revision state for a Novel project.
novel_voice_proposal
Novel Voice Options Proposal
Read-only complete Voice Options proposal and proof excerpts for an explicitly selected completed job.
polish_wizard_result
Polish Screenplay Result
Read-only finalized Polish Screenplay suggestions and conflicts.
project_canon_summary
Project Canon Summary
Compact read-only summary of a BeatBandit project canon.
project_chat_history
Project Chat History
Paginated freeform project chat history for one project stage.
project_diff_proposals
Diff Proposal Inbox
Recent unapplied MCP diff proposals for one project, including rewrite and persona proposals that can still be applied.
project_preferences
Project Preferences
Effective chat-facing project preferences, including provider/model defaults and the default stage snapshot.
project_updates
Project Updates
Current rewrite and structural-sync update queue for one project.
room_review_result
Room Review Result
Read-only finalized Room Review summary and notes.
screenplay_document
Screenplay Document Snapshot
Read-only snapshot of the structured screenplay document. A sequence-scoped read may use the same URI with `?sequence_number=1..8`.
screenplay_scene
Screenplay Scene Snapshot
Read-only snapshot of one screenplay scene.
screenplay_writing_voice
Screenplay Writing Voice
Complete revisioned project Writing Voice artifact, including explicitly requested samples.
screenplay_writing_voice_proposal
Screenplay Writing Voice Proposal
Completed editable Screenplay Writing Voice analysis proposal and its base expected revision.
sequence_wizard_result
Sequence Wizard Result
Read-only finalized Sequence Wizard update summary.
shot_element_library
Shot Element Library
Paginated recurring shot-element library for one project.
shot_list_scope
Shot List Scope
Read-only snapshot of a shot-list scope.
story_mentor_session
Story Mentor Session
Story Mentor transcript, decision state, and active turn snapshot for one session.
template_manifest
Template Manifest
Read-only BeatBandit template manifest.
treatment_wizard_result
Treatment Wizard Result
Read-only finalized Treatment Wizard sections and update summary.
visual_style_effective
Effective Visual Style
Read-only effective visual style resolution for a project, scene, or shot scope.
weave_result
Weave Result
Read-only finalized Weave result with saved episodes and warnings.