the interface and the api
are the same declaration

get_creator_profile

A creator's baseline — followers, average likes — and their strongest recent videos, so a single video can be judged against their normal.

get_trending_snapshot

The current curated trending snapshot: top videos ranked by how far each travelled past its own creator's usual reach, with the time the snapshot was captured.

get_video_insight

Metrics, reach and hook for one video already in the database, by URL.

list_insight_coverage

What this database covers: platforms, how many videos, and how fresh the newest capture is.

search_trending_videos

Search Imagine Films' social insights database for high-performing short-form videos.

check_workflow_ready

Before offering to run a workflow, check what stands in its way: blockers with level 'must' (it cannot start — a Maxwell step with no tool, a crew step with nobody on it, a film-editing workflow with no film chosen) and 'should' (true and worth saying — steps that wait for Approve or for a person).

edit_workflow

Build or change a workflow by operations, never by restating it.

list_workflows

This organisation's Agent Workflows — the productions its crew follows, from concept to cut — and the templates a new one can start from (Concept to cut, Brief to script, Trend-led short, Screen and fix a cut, Social cutdowns).

read_workflow

One workflow as a numbered outline — every step with its id, who or what does it, and each fork's outcomes — plus the raw tree, the step kinds and the Maxwell tools a step may call.

start_workflow

Put one film into a workflow: a run that works through its steps — each crew member does its craft in its own conversation, reading what came before; Maxwell's tools are called with arguments filled from the film; anything that changes a film or spends credits, every task and every sign-off waits for a person under Follow-ups.

accept_pacing

Pacing Check — accept the pacing report.

activate_craft

Craft Activation — draft or redraft it the active craft list.

approve_element

Element Sheet — approve the element sheet.

build_animatic

Samples & Animatic — build the animatic the craft direction board and animatic.

build_audience_profile

Audience Profile Builder — draft or redraft it the audience profile.

build_beat_structure

Beat Structure Builder — draft or redraft it the beat plan.

build_concept_timeline

Concept Timeline Builder — draft or redraft it the concept timeline.

build_craft_samples

Samples & Animatic — draft or redraft it the craft direction board and animatic.

build_element_registry

Element Registry Builder — draft or redraft it the element registry.

build_emotion

Emotion Builder — draft or redraft it the emotion spec.

build_job_card

Job Card Builder — draft or redraft it the job card.

build_motion_graphics

Motion Graphics Builder — draft or redraft it the motion spec.

build_music

Music Builder — draft or redraft it the music cue spec.

build_perception

Perception Builder — draft or redraft it the perception spec.

build_performance

Performance Builder — draft or redraft it the performance spec.

build_reception_document

Reception Document — draft or redraft it the multi-mechanism document.

build_scene

Scene Builder — draft or redraft it the scene spec.

build_sound

Sound Builder — draft or redraft it the sound spec.

build_speech

Speech Builder — draft or redraft it the speech spec.

build_understanding_timeline

Understanding Timeline Builder — draft or redraft it the understanding timeline.

check_cohesion

Cohesion Check — draft or redraft it the cohesion report.

check_craft_consistency

Craft Consistency Check — draft or redraft it the craft consistency report.

check_distinctiveness

Distinctiveness Check — draft or redraft it the distinctiveness report.

check_pacing

Pacing Check — draft or redraft it the pacing report.

choose_concept

Brilliant Concept Generator — choose the concept set.

draft_constraints

Constraint Builder — draft or redraft it the constraint set.

draft_element_strategy

Element Strategy Builder — draft or redraft it the element strategy.

draft_mission_card

Mission Card Builder — draft or redraft it the video mission card.

draft_requirements_card

Requirements Card — draft or redraft it the video requirements card.

draft_understanding

Brilliant Idea Maker — draft or redraft it the understanding card.

generate_cast_face

Cast & Voice Samples — draft or redraft it the cast and voice samples.

generate_concepts

Brilliant Concept Generator — draft or redraft it the concept set.

generate_style_frame

Style Frames — draft or redraft it the style frames.

list_job_cards

Job Card Builder — read it the job card.

predict_attention

Attention Predictor — draft or redraft it the attention map.

propose_motion_directions

Motion Graphics Builder — propose two or three directions the motion spec.

propose_music_directions

Music Builder — propose two or three directions the music cue spec.

propose_performance_directions

Performance Builder — propose two or three directions the performance spec.

propose_scene_directions

Scene Builder — propose two or three directions the scene spec.

propose_speech_directions

Speech Builder — propose two or three directions the speech spec.

read_audience_profile

Audience Profile Builder — read it the audience profile.

read_beat_plan

Beat Structure Builder — read it the beat plan.

read_element_registry

Element Registry Builder — read it the element registry.

read_mission_card

Mission Card Builder — read it the video mission card.

read_product

Product Reader — read it the product (read only).

read_requirements_card

Requirements Card — read it the video requirements card.

read_requirements_template

Requirements Templates — read it the requirements template.

read_society_state

Society State Catch-up — read it the society state brief.

read_understanding

Brilliant Idea Maker — read it the understanding card.

refine_attention

Perception Builder — refine attention the perception spec.

refine_dynamics

Emotion Builder — refine dynamics the emotion spec.

refine_experience

Emotion Builder — refine experience the emotion spec.

refine_governance

Perception Builder — refine governance the perception spec.

refine_register

Emotion Builder — refine register the emotion spec.

refine_staging

Perception Builder — refine staging the perception spec.

refresh_society_state

Society State Catch-up — draft or redraft it the society state brief.

render_cast_faces

Cast & Voice Samples — faces the cast and voice samples.

render_element_sheet

Element Sheet — draft or redraft it the element sheet.

render_storyboard

Storyboard — draft or redraft it the multi-mechanism storyboard.

render_storyboard_frames

Storyboard — render the multi-mechanism storyboard.

render_style_frames

Style Frames — render the style frames.

repair_cohesion

Cohesion Check — apply the proposed repairs the cohesion report.

repair_craft

Craft Consistency Check — apply the proposed repairs the craft consistency report.

sample_voice

Cast & Voice Samples — sample a voice reading the film's lines the cast and voice samples.

search_music

Music Finder — draft or redraft it the music shortlist.

test_understanding

Understanding Tester — draft or redraft it the understanding test result.

complete_plan

Carry out a plan.

create_execution_plan

Write the plan that would close the gap, and what each item would cost.

evaluate_against_goal

Judge whether the film now does what was asked.

read_records

What has gone wrong on a film: what Maxwell claimed against what was actually there, and anything you have told it.

read_turn

Where Maxwell has got to: what it understood, the gap it found, the plan and its clashes, which tasks are done and which are not, what it has spent, and which version the film is on.

read_video_reading

What Maxwell saw when it watched: the shots in order, the words on screen, the concerns, and what was heard.

record_mistakes_and_improvements

Tell Maxwell what is wrong — with a film, or with what Maxwell itself did.

understand_goal_gap

Work out the distance between the film as it is and what you asked for.

understand_human

Start Maxwell on a change to a film.

understand_video

Watch a film and say what is actually on the screen — shots, what changes, words you could read, where the eye goes, and anything genuinely wrong like a blank stretch or text off the edge.

create_collection

Start a new collection.

file_inspiration

Put a video the organisation has already kept into a collection.

forget_inspiration

Take a kept video off the organisation's shelf entirely, and out of every collection it was filed in.

keep_inspiration

Keep a video somebody else made, so it can be found again and built from.

list_collections

The organisation's collections of kept videos — name, what the collection is for, how many are in it, and a few covers.

rename_collection

Rename a collection, and optionally rewrite what it is for.

unfile_inspiration

Take a video out of a collection.

edit_knowledge_graph

Build or change a Knowledge Graph by operations, never by restating it.

list_knowledge_graphs

Every Knowledge Graph in this account — name, how many topics, questions and links — and the templates a new one can start from (audience-to-mission: the five cards a film's mission reads with hand-written questions and follow-ups; film-design-cards: all 37 film design cards as topics).

read_knowledge_graph

One Knowledge Graph as an outline — every topic with its id, every field, every question in order with its id, what makes a question conditional, which topic a question opens, every reference (a term in a topic's text that names another topic) and every association with its kind and relevance — plus the raw graph.

record_knowledge

Record what was learned about ONE real thing — an audience, a customer, a deal, a film's mission — as an entity of a topic on a knowledge graph: values keyed by the topic's field keys, every value stamped with `source` (where it came from: the call, the document, the person's own words) and when.

compose_film

Generate a film from a written description.

get_generation

Status and output URLs for one generation, by request_id.

list_films

Recent generations for your organisation.

research_creator

Pull a creator's recent post history live and add it to the corpus, so their videos can be judged against their own baseline.

research_video

Pull live data for a video that is not yet in the database, including its full transcript and hook, and add it to the corpus.

detail_software

What Maxwell knows about a product's software — the product map, and each surface with its purpose, copy and design tokens.

issue_ci_token

Connect a repository, so every push keeps Maxwell current.

make_software_clip

Make a clip about one of the product's screens, from what Maxwell already knows about it.

understand_software

Deposit what a product's screens are, so films can be made about them.

apply_bindings

Work out what every binding means right now and commit it as one new version — elements retimed to their moments, and placed against their subjects.

bind_element

Say what an element in the film is ABOUT, rather than where it happens to sit.

check_element_approval_status

Before planning or editing, find out which of a film's elements a person has actually approved.

describe_footage

What is known about the footage in a composition — which clips have been analysed, by what, and what was found.

edit_video_composition

Change a video composition.

evaluate_composition

Check a film before handing it back: that every relationship it claims still resolves, that nothing anchored has walked out of frame, that nothing starts after the film ends, and whether it leans on footage nobody has analysed.

get_render

Where a render has got to.

list_element_bindings

Every relationship this composition claims, and to what.

list_video_composition_versions

The history of a video composition — every change, who made it, and how much it changed.

list_video_compositions

List the video compositions on this account, most recently edited first.

query_footage

Find things inside the footage: people and objects that move ('subject'), spoken words ('word'), musical beats ('beat'), shot changes ('shot'), or notable moments ('moment').

read_evaluation

The most recent verdict on a composition, with every finding.

read_pairing_document

The collaboration so far, oldest first, so it reads as a conversation.

read_screening

What a screening saw, moment by moment — every frame that was looked at, what was on screen, and anything wrong with it.

read_video_composition

Read one video composition: its shape, and every element on its timeline with the times it occupies.

reconcile_tasks

Check a project's task list against what has actually been made in it — the films and whether they have rendered, the master sheets and their scene counts, the museboards, the elements cast — and propose what should change: work the material shows is finished, two tasks that say the same thing, a task whose prerequisite does not exist, work the film obviously needs that nobody has written down.

render_video_composition

Render a composition to an mp4.

request_change

Ask for a change in your own words.

restore_video_composition_version

Bring an earlier version of a composition back.

screen_video_composition

Have Maxwell WATCH the whole film, start to finish, and write down what is on screen.

unbind_element

Take a relationship off.

watch_video_composition

A link that plays this film in a browser, for someone with no account here — hand this to a client rather than making them wait for a file.

write_pairing_note

Add to the record of this collaboration.

answer_journey_questions

Give the Plan the client's answers to the questions Maxwell could not answer itself (which feature, which version, is it released…), keyed by each question's code as read_video_journey shows it.

choose_concept_route

The most important checkpoint: the client picks the idea.

decide_journey_checkpoint

Record the client's decision at a checkpoint: 'approved' (Maxwell starts the next stage) or 'revise' with their note (Maxwell redrafts this stage from it, and everything after it is set aside).

read_video_journey

Read one journey: which stage it is at, each stage's status (working, awaiting_approval, approved…), the drafts so far (Brief, Plan with its open questions, the concept routes with scores and reasons, beats with what the viewer should understand/perceive/feel, elements, look and sound, the film and its quality record), every checkpoint decided, and the jobs running.

render_journey_slots

Render the film's shots once Look & sound is approved.

start_video_journey

Start a pre-production journey from the client's one sentence — who the film is for and what it should do.

find_the_gap

Measure a film against what it was asked to be.

list_documents

What this account has kept — names, kinds and lengths, without the words.

make_composition_from_film

Lay a film you generated on a timeline, so it becomes something you can watch, read in full, measure against a brief and edit.

plan_to_close_the_gap

Turn a gap into something somebody can act on: for each fault, the cheapest route that can actually close it — an edit to the composition, a Seedance `video_edit`, a `video_extension`, a full re-render, or nothing, because some faults have no route and saying so beats paying to find out.

read_document

One kept document, with its words.

read_film_in_full

Read a film the way somebody watching it would, in three passes, and keep what each one says.

read_full_report

Where a full reading has got to, and what one pass said.

refine_prompt

Take a prompt through the loop until it is clean: check, read, revise, again.

render_film

Generate a film from a prompt at a chosen resolution.

render_options

What a render would cost at each resolution, in credits, before anything is spent.

review_prompt

Read a generation prompt the way a creative director does, before anything is generated.

compose⌘↵

Generate a film from a written description.

• promptstring · requiredWhat the film should show.
• referencesnumberCount of attached reference stills or clips. Up to 50.

attach_reference@

Attach a still or clip to steer subject, product or location identity.

• kindstill | clip | product | floorplanReference type.

set_model

Choose the generation model.

• modelaperture-2 | aperture-2-turbo | longform-30s · requiredModel identifier.

set_look←→

Apply a colour science. Changes lighting and stock response, not the subject.

• lookcommerce | training | property · requiredNamed grade.

set_aspect_ratio

Set the output frame shape.

• aspect16:9 | 9:16 | 1:1 | 2.39:1 · requiredWidth-to-height ratio.

set_duration

Set the output length.

• duration4s | 8s | 15s | 30s · requiredClip length.

toggle_audio

Hear one example film. Only one plays sound at a time.

browse_examples

List example films for a given look.

• lookcommerce | training | propertyFilter by grade.
• limitnumberMaximum results.

open_command_palette⌘K

Open the command surface. Identical schema to this manifest.