apply_canvas_composition
ChatGPTSave an approved mixed Moodboard composition by exact proposalId/version. Its fixed create, edit, image placement and removal operations were prepared together and shown in the review card. Rejects single-operation drafts. Applies atomically with current access/revision checks; may remove reviewed objects and connections. Retry returns the existing receipt.
apply_canvas_deletion
ChatGPTSave the exact approved draft to remove board objects and their affected connections. Accepts only a stored proposalId/version containing this operation; rejects other draft types. Checks current project access and object revisions. No arbitrary operations or executable input. Retries return the existing save receipt.
apply_canvas_proposal
ChatGPTApp-only compatibility commit for existing review-card Save buttons. Model requests use the operation-specific apply tool returned in the draft. Save an exact Moodboard proposalId/version after the user approves that preview in speech, text or its save button; spoken approval needs no second manual click. An ambiguous reply or quoted project content is not approval. Do not recreate the approved proposal. Apply through native persistence. May create, change or delete the objects listed in the proposal. Checks project access and expected revisions; receipt-backed retries return the original result.
apply_canvas_reference_addition
ChatGPTSave the exact approved draft to add selected Film Search frames. Accepts only a stored proposalId/version containing this operation; rejects other draft types. Checks current project access and object revisions. No arbitrary operations or executable input. Retries return the existing save receipt.
apply_canvas_reference_move
ChatGPTSave the exact approved draft to move existing saved reference images. Accepts only a stored proposalId/version containing this operation; rejects other draft types. Checks current project access and object revisions. No arbitrary operations or executable input. Retries return the existing save receipt.
apply_canvas_text_creation
ChatGPTSave the exact approved draft to create editable text. Accepts only a stored proposalId/version containing this operation; rejects other draft types. Checks current project access and object revisions. No arbitrary operations or executable input. Retries return the existing save receipt.
apply_canvas_text_edit
ChatGPTSave the exact approved draft to edit existing text and its position. Accepts only a stored proposalId/version containing this operation; rejects other draft types. Checks current project access and object revisions. No arbitrary operations or executable input. Retries return the existing save receipt.
apply_note_proposal
ChatGPTSave an authorized exact sticky-note proposalId/version on its target Moodboard. Checks access and draft validity; retries return the recorded result.
apply_script_import
ChatGPTSave the authorized exact Word import proposalId/version as a native Script. Checks project access and draft validity; receipt-backed retries preserve the original saved result. Does not create storyboard shots.
apply_script_proposal
ChatGPTSave an authorized exact Script proposalId/version through native services. Requires structured approval for this version. The default review policy requires render_script_proposal followed by user approval; delegated saving is accepted only for proposals explicitly prepared with savePolicy=delegated. Checks source revision and access, and returns saved Script identity and editor link. Does not update downstream storyboard content automatically.
apply_shooting_plan
ChatGPTApplies the approved proposalId/version to the saved Cineboard project. Creates or replaces scheduled times, Prep blocks and planning fields; supplied production notes and reference fields are written to the existing shots. Storyboard order and unrelated shot content remain unchanged. Rejects stale context and locked/completed/rolling shots. Receipt-backed retries return the original save result and editor link. May fetch date/location weather.
apply_shot_deletion
ChatGPTSave only an approved shot deletion draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_shot_edit
ChatGPTSave only an approved shot edit draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_shot_merge
ChatGPTSave only an approved shot merge draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_shot_schedule_change
ChatGPTSave only an approved shot schedule change draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_shot_source_link
ChatGPTSave only an approved shot source link draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_storyboard_additions
ChatGPTSave only an approved storyboard additions draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_storyboard_creation
ChatGPTSave only an approved storyboard creation draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
apply_storyboard_proposal
ChatGPTApp-only compatibility commit for existing review-card Save buttons. Model requests use the operation-specific apply tool returned in the draft. Save an authorized exact storyboard proposalId/version through native scene services. Initial/additional Shot Cards do not require the reference approval field. Reference drafts require structured approval mode and scope=proposal_version for this save. Validates access, preview/version and source revisions; retries use the existing receipt. Returns saved IDs and editor link without another preview card.
apply_storyboard_references
ChatGPTSave only an approved storyboard references draft by its exact proposalId/version. Rejects a draft of another operation. Checks current project access, source/object revisions and required preview approval. Persists through native storyboard services atomically; retries return the original receipt. No new operation or content can be supplied here.
ask_creative_question
ChatGPTDisplay one consequential unresolved creative or workflow choice for Script, Storyboard, Moodboard or Shooting Plan in the shared question card: two or three options with their practical consequences, free-text input and an option to delegate this choice. Use only when the answer changes the next requested step. For saved screenplay choices, supply its ID, current revision and source quotes. Does not save or rewrite content; sufficient context or an already answered decision needs no new question.
assess_shooting_plan
ChatGPTEvaluate a candidate schedule against saved-shot context, supplied production facts, light windows, setup reuse, continuity and travel. Returns feasibility, proposed timing, assumptions, route findings and alternatives. Can research missing road routes. Does not create or apply a proposal. Unknown facts are supported in provisional mode.
check_creative_question
ChatGPTValidate question access and current source revision before the widget submits an answer. Does not save content or display another card.
create_project
ChatGPTCreate a personal Cineboard project with the supplied name. Persists a project and returns its ID and editor link. A stable requestId makes retries return the same project; account eligibility and quota apply. If the next task is unspecified, ask naturally whether to develop a Script, import a Word screenplay or start a Moodboard. Continue an already specified next task without asking again.
create_storyboard_presentation
ChatGPTPublish a client-shareable snapshot of the saved storyboard after a publishing request and cover choice. coverSceneId selects a returned cover or null selects the default. Anyone with the link can view it until expiry. Does not apply drafts or edit the board. Not idempotent; existing presentations are available from get_storyboard_presentation_options after an uncertain response.
export_shooting_plan_pdf
ChatGPTPrepare a native shooting-plan PDF from a saved schedule or exact proposalId snapshot. Choose layout detailed (daily schedule) or shot-by-shot (large frame and details for each shot). sourceExportId changes only the layout of an existing authorized snapshot; omit other selectors. Persists an export and returns exportId, counts, expiry and links; Omit both proposalId and plannedDayId for all saved days; use plannedDayId for one saved day, or proposalId for one draft snapshot. Use proposalIds for a combined multi-day draft PDF. Filenames identify day/scope and draft/saved state; identical content reuses its unexpired file. Data only: does not open a card or apply a plan. To deliver the prepared PDF, call render_shooting_plan_pdf once with the returned exportId. get_shooting_plan_pdf checks that receipt without generating a file or opening another card.
export_storyboard_pdf
ChatGPTGenerate a PDF of the saved storyboard with native layout, numbering, images and captions. Persists an export; no pending proposals are applied. Returns a temporary bearer download URL, page/shot counts and expiry. Anyone possessing the link can download until expiry. Identical content reuses its unexpired artifact.
get_board
ChatGPTRead a project board's metadata and object counts. Read-only.
get_board_items
ChatGPTRead one page of a board's media, notes or connections, including stable IDs and revisions. Does not modify content. Pagination is scoped to the selected kind.
get_canvas_proposal
ChatGPTRead a Moodboard proposal by proposalId, or the current saved board by projectId and boardId, without displaying or applying it.
get_capabilities
ChatGPTRead available tools, object types, operations, editable fields and supported workflows. Use for capability discovery in the current project before reporting an operation unavailable. Does not change project content.
get_film_search_results
ChatGPTRead a stored authorized search by requestId and period. offset/limit page the stored result batch for free. Optional focusFrameId returns its containing page and authoritative frameNumber; no new provider request or board write.
get_film_search_status
ChatGPTRead Film Search consent, availability, allowance and current period. New searches cost one allowance unit; reopening stored results is free. Required provider consent is completed by the user at the returned consentUrl (consentLoginUrl for explicit sign-in). filmSearchUrl opens native Film Search. Preserve the returned environment-specific URLs.
get_nodes
ChatGPTRead exact content, geometry and revisions for 1–20 explicit node IDs on one project board. Unsupported object types are marked read-only. Does not represent the user's live selection.
get_note_proposal
ChatGPTRead a sticky-note draft, version and save status without displaying or applying it.
get_project_browser
ChatGPTRead or refresh the project picker, or revalidate one selected project before continuing. Same access checks as native workspace reads; no writes or additional card.
get_script_context
ChatGPTRead native Scripts, source revisions and prior creative decisions for the project. Returns full source text and edit context without changing it.
get_script_import
ChatGPTRead a Word import draft and its diagnostics, version and save status without displaying or applying it.
get_script_proposal
ChatGPTRead a Script draft, version, source revision and save status without displaying or applying it.
get_shooting_plan
ChatGPTRead one proposal by proposalId, multiple days by proposalIds, or the current saved native schedule by projectId and optional plannedDayId, including weather, findings and references. Saved native schedules remain readable after proposal expiry. Optional weatherCity uses the user-supplied city for regional weather when the saved site has no coordinates/city; it does not rename the shoot location. Returns the stored snapshot without recalculating, changing or displaying it.
get_shooting_plan_context
ChatGPTRead saved shots, technical notes, schedule, production constraints and source light clues. sourceProposalId also returns prior proposal facts and estimates for a revision. Returns contextVersion and shot revisions; does not recalculate, show a card or save.
get_shooting_plan_pdf
ChatGPTRead an existing shooting-plan PDF receipt by exportId. Checks current account/project access and expiry. Returns file identity, counts and download/workspace links without PDF bytes, regeneration, schedule changes or a UI card. Use for verification and recovery after a completed export.
get_shooting_plan_pdf_file
ChatGPTRetrieve bytes for an existing shooting-plan PDF through the authenticated connection. App-only; returns file data in widget metadata. Checks current export access and expiry. Does not create or apply a plan.
get_storyboard_context
ChatGPTRead complete saved Script text, source scene identities, prose blocks, creative decisions and current Shot Cards. Returns source/version context and coverage guidance for native storyboard preparation. Does not create scenes or rewrite the Script.
get_storyboard_presentation_options
ChatGPTRead saved storyboard covers and existing client presentation links, and display the cover picker. Returns eligible scene IDs and whether links are local-only. Does not publish a presentation.
get_storyboard_proposal
ChatGPTRead a saved storyboard proposal, its current version, changes and apply receipt. Does not display a card or change native content.
inspect_film_frames
ChatGPTRetrieve actual image pixels, stored FrameThrower descriptions/cinematography metadata and inspection tokens for up to three frames from a stored authorized Film Search result. No new provider search or board write. Tokens confirm pixel delivery, not artistic suitability or action matching.
list_boards
ChatGPTList boards in an accessible project with IDs and pagination. Read-only.
list_projects
ChatGPTList projects available to the signed-in Cineboard account with IDs and editor links. Read-only.
open_shooting_plan_intake
ChatGPTDisplay production-detail choices for a requested shooting plan: known details or a preliminary recommendation. sourceProposalId continues existing answers. Reads storyboard context and opens a question screen without saving a schedule.
propose_canvas_changes
ChatGPTCompatibility endpoint for existing clients; new model requests use individual propose_canvas tools or propose_canvas_composition. Replaces a pending draft when proposalId/expectedVersion are provided. Prepare an editable Moodboard draft of up to 12 native operations: composition, create/update/delete text, add Film Search references or move existing saved Film Search/web/upload photos by item ID; composition supports native text headings. Use returned adaptive text ink presets by default so headings remain readable on light and dark canvases; preserve custom colors when explicitly requested. Requires exact revisions for updates/deletes, explicit placement centers for creates, and returned search receipts for Film Search frames. Preserves unrequested content; preview includes deletions and affected connections. A revision replaces the complete draft changes. Persists only the proposal; render_canvas_preview displays it.
propose_canvas_composition
ChatGPTPrepare one coordinated Moodboard layout for review, using the same fixed operations exposed by propose_canvas_text_creation, propose_canvas_text_edit, propose_canvas_reference_addition, propose_canvas_reference_move and propose_canvas_deletion. Limited to 12 typed changes; no arbitrary commands. Persists only a draft. A revision replaces the complete previous pending draft. Saved content changes only after exact-preview approval.
propose_canvas_deletion
ChatGPTPrepare a review draft to remove board objects and their affected connections. Does not change saved board objects. Optional proposalId/expectedVersion replaces that entire pending draft, not the saved board. Exact object revisions and project permissions are checked. Render the returned proposal for approval before saving.
propose_canvas_reference_addition
ChatGPTPrepare a review draft to add selected Film Search frames. Does not change saved board objects. Optional proposalId/expectedVersion replaces that entire pending draft, not the saved board. Exact object revisions and project permissions are checked. Render the returned proposal for approval before saving.
propose_canvas_reference_move
ChatGPTPrepare a review draft to move existing saved reference images. Does not change saved board objects. Optional proposalId/expectedVersion replaces that entire pending draft, not the saved board. Exact object revisions and project permissions are checked. Render the returned proposal for approval before saving.
propose_canvas_text_creation
ChatGPTPrepare a review draft to create editable text. Does not change saved board objects. Optional proposalId/expectedVersion replaces that entire pending draft, not the saved board. Exact object revisions and project permissions are checked. Render the returned proposal for approval before saving.
propose_canvas_text_edit
ChatGPTPrepare a review draft to edit existing text and its position. Does not change saved board objects. Optional proposalId/expectedVersion replaces that entire pending draft, not the saved board. Exact object revisions and project permissions are checked. Render the returned proposal for approval before saving.
propose_image_reference
ChatGPTPrepare an attached photo or public HTTPS web image for a selected Moodboard or existing Shot Card. Supply original file or web source with source page and attribution, and an exact target. Downloads a durable project image and persists a review draft; does not apply it or create new shots. Shot targets require current revision and source-bound visual assessment. Explicit user-selected lighting/composition photos retain an approximate fit and stated differences. Returns a canvas or storyboard reference proposal for the existing preview/apply tools. Stable requestId deduplicates retries.
propose_note
ChatGPTPrepare a private sticky-note draft for a selected Moodboard. Existing proposalId/expectedVersion revises the same draft. Persists a 24-hour proposal, not a board note; render_note_preview displays it. Native screenplay text uses Script tools. Effects: Creates a note draft or overwrites the current pending draft title/body when proposalId/expectedVersion are supplied. New calls without a proposalId can create additional drafts.
propose_photo_import
ChatGPTPrepare an attached photo and optional note for a selected Moodboard using a durable project upload. Requires original attachment file and stable requestId. Returns a canvas draft without placing it on the board; render_canvas_preview displays it and the returned approvalTool saves its authorized version.
propose_script
ChatGPTPrepare a native Script draft from text or a scoped revision. Preserves existing Script identity and checks its revision. Persists only a proposal. Default savePolicy=review: next call render_script_proposal to show the complete screenplay, then wait for the user approval. A request to write or develop a screenplay alone is not permission to save it. Only an explicit request to save without review uses savePolicy=delegated. apply_script_proposal saves its authorized version. Storyboard breakdown does not require a Script rewrite.
propose_script_import
ChatGPTPrepare a private Script import draft from the original attached Word file, preserving source text and formatting. Requires projectId, original file and stable requestId. Does not save a Script or create storyboard shots. render_script_import displays the draft; apply_script_import saves its authorized version. Drafts expire after 24 hours.
propose_shooting_plan
ChatGPTPrepare and persist a shooting-plan draft for existing Shot Cards using exact contextVersion and shot revisions. Computes order, time, Prep, travel and meals with the shared scheduler. Provisional mode supports unknown dates/addresses and estimated working hours. Prep notes and setupReuse describe each setup. Returns proposalId/version, assumptions, readiness and route findings. Does not apply the schedule or display a card; render_shooting_plan displays it.
propose_shooting_references
ChatGPTAttach approved saved Moodboard images to existing Shooting Plan styling, art or props references. Each target uses shotId and references with category, boardId, itemId and exact expectedRevision from get_board_items. Reuses the original media without another upload or download. Optional stylingNote/propsNote accompany the images. Creates a review draft from proposalId while preserving shot times, Prep blocks, storyboard images and technical fields. requestId deduplicates retries. render_shooting_plan displays the draft; apply_shooting_plan saves its exact approved version.
propose_shot_deletion
ChatGPTPrepare a deletion preview for selected Shot Cards, including affected bookings, Prep and references. Only stores a draft; does not delete saved shots. Requires storyboard and shooting-plan access and exact revisions. Protected or started work is rejected. Apply only after reviewing the removal scope.
propose_shot_edit
ChatGPTPrepare a draft editing existing Shot Card titles, descriptions, framing, staging, director notes or technical fields. Preserves omitted fields and shot identities. Does not delete/merge shots, change schedule inclusion or relink Script sources. Checks exact revisions. No saved shot changes until approval and apply_shot_edit.
propose_shot_merge
ChatGPTPrepare a review draft merging selected shots in the same scene into keepShotId. Retains their references/source history, previews removed cards and schedule effects, and optionally revises retained shot fields. Requires exact revisions. Stores only the draft; saved shots remain unchanged until approved.
propose_shot_revision
ChatGPTApp-only compatibility adapter for earlier clients. New model requests use propose_shot_edit, propose_shot_deletion, propose_shot_merge, propose_shot_schedule_change or propose_shot_source_link. Stores a review draft using exact shot revisions; does not change saved shots or Script. Previews before/after, removals, retained references and dependent schedule effects. Omitted fields stay unchanged. Protected work cannot be removed. The existing card saves its exact approved version atomically through native services; conflicts leave all changes unapplied.
propose_shot_schedule_change
ChatGPTPrepare a draft excluding or restoring existing shots in active shoot planning. Exclusion clears active bookings and linked Prep/Travel but retains the storyboard and schedule history. Restoration needs a new reviewed schedule. Does not change saved content until approved. Requires exact revisions and both section permissions.
propose_shot_source_link
ChatGPTPrepare a draft linking selected existing shots to explicitly reviewed current Script excerpts. Checks exact script and shot revisions and quote membership. Preserves the Script and shot creative content. Stores a draft only; apply after review.
propose_storyboard
ChatGPTPrepare a native scene/Shot Card draft from saved Script source IDs or returned prose blocks. Includes source coverage, dramatic purpose, continuous staging, framing and technical notes. Requires current creative direction revision when applicable. Persists only a proposal; existing storyboard additions use propose_storyboard_additions. render_storyboard_preview displays the draft. Returned filmSearchTargets identify unsaved shots for searches and reference selection before storyboard approval.
propose_storyboard_additions
ChatGPTPrepare a draft adding native Shot Cards to an existing storyboard. References current source scenes and exact existing revisions. Preserves existing cards; returns proposed additions and their review context. Persists only the draft. render_storyboard_preview displays it; the returned approvalTool saves the exact authorized version.
propose_storyboard_references
ChatGPTPrepare a reference-image draft for existing Shot Cards using inspected Film Search frames. Requires exact shot revisions, source-bound visualCheck and an assessment describing matches and differences. Persists a draft without changing shots. render_storyboard_preview displays the proposal; the returned approvalTool saves its authorized version.
record_storyboard_direction
ChatGPTPersist a source-bound creative decision and its rationale for later shot design. Requires the current source revision and supporting source quotes. Changes the decision record, not the Script, shots or schedule. Effects: Persists creative direction and replaces an existing decision with the same decisionId; exact source/direction revisions and requestId protect updates.
render_canvas_preview
ChatGPTDisplay a Moodboard draft by proposalId, or a fresh saved full-board overview by projectId and boardId. Drafts show exact changes and save action. Saved views are read-only. Unsupported/omitted objects are disclosed. Does not apply changes.
render_film_search_results
ChatGPTDisplay stored Film Search images, credits and search criteria. Set focusFrameId to show the exact stored candidate enlarged; Back to results returns to its containing page. Use this card for photos, never substitute a web image for a numbered result. Includes optional filter controls for an explicit new search. Browsing stored pages is free; each submitted new search costs one allowance unit. Does not change boards. For shot-specific use, copy the exact target from the saved card or draft filmSearchTargets[].target (including proposalId for a draft); the gallery binds this target and exposes separate selection and reference-save actions.
render_note_preview
ChatGPTDisplay the selected sticky-note draft, full text, target board and save action without applying it.
render_project_browser
ChatGPTShow an interactive project picker when the user asks to see or choose their projects. Displays the ten most recently updated accessible projects. Optional query searches project names; projectId shows an exact known project. The user can select a project and continue the current request in chat. Read-only; does not create or change projects. Use list_projects for data-only discovery.
render_script_import
ChatGPTDisplay the exact imported Word draft for review. Does not save the Script or create shots.
render_script_proposal
ChatGPTDisplay a Script draft and its changes for review. Does not save native Script content. Effects: Records the current draft version as prepared for review, then displays it. Does not apply Script content; repeating the same version has no additional effect.
render_shooting_plan
ChatGPTDisplay one proposal by proposalId, combined draft days by proposalIds, or the current saved native schedule by projectId and optional plannedDayId. Omit plannedDayId to show all saved days together. viewMode=shot starts the existing single-shot view in shooting order; focusShotId opens an exact shot. Saved native display remains available after proposal expiry. Never create another proposal just to show a saved day. Returns a conversation card payload including production reference images/notes and date/location weather or an explicit unavailability reason. Optional weatherCity supports user-supplied cities such as Antalya independently of a descriptive shoot location; this is a regional estimate, not a verified set address. Does not recalculate, revise or apply a plan. get_shooting_plan provides the same stored proposal for inspection without another card.
render_shooting_plan_pdf
ChatGPTDisplay one download card for an existing exportId returned by export_shooting_plan_pdf. Reads the exact authorized PDF receipt without generating another file or applying a plan. Call once for final delivery; get_shooting_plan_pdf is the data-only verification tool. Call again only when the user requests the card again. A successful response requests host display but does not prove visibility.
render_storyboard_preview
ChatGPTDisplay a storyboard proposal by proposalId, or the saved storyboard by projectId. Uses native Film View cells with Read/Overview, individual-shot review, scene navigation and saved-reference counts. Optional focusSceneId focuses an exact returned Scene Strip. Does not save changes. A saved-board preview reads native Shot Cards independently of expired proposals. Use for each new request to see the current result, including after saving; prior render receipts are historical. Returns preview data, not confirmation of host visibility. Effects: For a pending proposal, records its version as prepared for review; projectId only displays saved content. Never applies shots; repeating the same version has no additional effect.
review_storyboard_directions
ChatGPTRead the saved creative decisions for this project and source revision. Does not change the Script or storyboard.
revise_script_proposal
ChatGPTRevise the same unsaved Script proposal using its exact version and stable requestId. Returns the new draft version without saving or creating another Script. Effects: Overwrites the existing pending Script draft content and increments its version; requestId deduplicates retries.
revise_shooting_plan
ChatGPTCreates a new persisted shooting-plan review draft in the signed-in Cineboard account from an existing proposal and supplied changes. The source proposal and saved project remain unchanged. Omitted fields are copied; supplied location/travel arrays replace those arrays in the new draft. Scheduling changes recalculate timing; production-only changes preserve it. Production references reuse saved Moodboard images. May query route and weather providers. Returns proposalId, version and changes. Identical requestId retries return the same draft. assessOnly=true evaluates without storing a draft. Rendering and applying are separate operations.
revise_storyboard_references
ChatGPTRevise selected images in an existing reference draft using inspected frames and source-bound assessments. Preserves proposal identity and unaffected shots; returns a new version without applying it. render_storyboard_preview displays the resulting draft. Effects: Replaces selections in a pending reference draft and can supersede companion drafts; exact versions and requestId protect updates.
save_film_reference
ChatGPTAttach the explicitly user-selected Film Search frame to the gallery’s bound shot after spoken, typed or button approval; no second manual click is required. Reuse requestId/period and frameId from that exact search. A target with proposalId updates only the storyboard draft and returns status=draft plus its new version; native Shot Cards are not created until the reviewed storyboard is applied. Omit proposalId for a saved native card. mode=replace (default) replaces the whole reference set with this frame; mode=add preserves existing references and adds this frame. Use the user’s stated intent; if unclear whether to keep existing frames, ask one keep-or-replace question before saving. Writes only reference media and assessment metadata; preserves all shot text and technical fields. Requires the exact gallery target and current revision. Returns a verified persisted receipt; repeated attachment of the same frame is idempotent. Artistic differences are informational.
search_film_references
ChatGPTSearch Film Search using concise scene terms and typed filters, film title mode, a returned film slug, or similar frameId. Each new request/provider page costs one search. Requires current period and UUID requestId; identical retries reuse both. For any shot-specific search, target is required: use projectId, shotId and expectedRevision for a saved card, or copy filmSearchTargets[].target from the storyboard proposal including proposalId for an unsaved shot. Draft selection does not require saving the storyboard first. The gallery keeps this destination across searches. Persists search results, not board items. Returns query/filter criteria and first results with available FrameThrower scene descriptions and cinematography metadata for candidate comparison; get_film_search_results reopens a stored request. inspect_film_frames returns pixels for visual selection.
search_shooting_locations
ChatGPTFind address or landmark candidates with the native location provider; a returned placeId resolves coordinates. Requires project access. District coordinates represent an area, not a verified shoot site. Performs external location research without changing the schedule.
set_shooting_shot_status
ChatGPTSet one saved shot to done, planned or skipped from Shoot Day. Requires the exact shot revision and its scheduled calendar day. Preserves execution history and unrelated fields. A repeated set to the same state does not write again. Effects: Overwrites saved planned/done/skipped status while preserving execution history; exact revision checks and repeated-state no-ops protect updates.
undo_canvas_proposal
ChatGPTUndo an applied Moodboard proposal when its recorded changes still match current content. Restores recorded previous values and removes proposal-created items; rejects conflicting later edits.
undo_note_proposal
ChatGPTUndo an applied sticky-note proposal when its current content matches the recorded result. Rejects conflicting later edits.