Tool tree
gradeNot graded
page: Every page
helpAnswer
How to recut this live page. Returns the five-step judge path, the current suggested next move, and the pin rule. Read-only. Call this if you are lost among the tools.
View tool JSON
{
"name": "help",
"kind": "answer",
"impl": "imperative",
"description": "How to recut this live page. Returns the five-step judge path, the current suggested next move, and the pin rule. Read-only. Call this if you are lost among the tools.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}see_stillAction
Look at the still on the page right now. You cannot see the photograph yourself — this tool returns look (what the picture shows), slate, title, caption, pin, neighbors, remaining time, whether export is armed, Codex's last beat, and suggested next. Call help if you are lost. Call this before you write.
View tool JSON
{
"name": "see_still",
"kind": "act",
"impl": "imperative",
"description": "Look at the still on the page right now. You cannot see the photograph yourself — this tool returns look (what the picture shows), slate, title, caption, pin, neighbors, remaining time, whether export is armed, Codex's last beat, and suggested next. Call help if you are lost. Call this before you write.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}lookAction
Same as see_still. Look at the shared photograph. Returns look, pin, neighbors, and Codex's last beat.
View tool JSON
{
"name": "look",
"kind": "act",
"impl": "imperative",
"description": "Same as see_still. Look at the shared photograph. Returns look, pin, neighbors, and Codex's last beat.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}suggest_cutAction
Propose the next recut from the brief and pins. Does not write. Typical NORTHWIND: caption the hand, shorten the landfill, leave the laugh, then mark_cut.
View tool JSON
{
"name": "suggest_cut",
"kind": "act",
"impl": "imperative",
"description": "Propose the next recut from the brief and pins. Does not write. Typical NORTHWIND: caption the hand, shorten the landfill, leave the laugh, then mark_cut.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}apply_suggestionAction
Apply the current suggest_cut script. Pins refuse that line and the rest continue. Pass rehearse true to also try the laugh (it should refuse) before mark_cut.
View tool JSON
{
"name": "apply_suggestion",
"kind": "act",
"impl": "imperative",
"description": "Apply the current suggest_cut script. Pins refuse that line and the rest continue. Pass rehearse true to also try the laugh (it should refuse) before mark_cut.",
"inputSchema": {
"type": "object",
"properties": {
"rehearse": {
"type": "boolean",
"description": "Also try to trim the laugh, then mark. The laugh should refuse."
}
},
"additionalProperties": false
},
"page": "/"
}mark_cutAction
Arm the clap. Same as request_export. Does not commit until clap / confirm_export or the human claps on the page.
View tool JSON
{
"name": "mark_cut",
"kind": "act",
"impl": "imperative",
"description": "Arm the clap. Same as request_export. Does not commit until clap / confirm_export or the human claps on the page.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}clapAction
Commit the armed cut. Same as confirm_export. Fails unless mark_cut / request_export already ran, or the human armed it.
View tool JSON
{
"name": "clap",
"kind": "act",
"impl": "imperative",
"description": "Commit the armed cut. Same as confirm_export. Fails unless mark_cut / request_export already ran, or the human armed it.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}get_projectAnswer
Read the shared NORTHWIND cut: every shot, pins, brief, and the still on screen. 05-A The laugh starts pinned. Prefer see_still when you only need the picture.
View tool JSON
{
"name": "get_project",
"kind": "answer",
"impl": "imperative",
"description": "Read the shared NORTHWIND cut: every shot, pins, brief, and the still on screen. 05-A The laugh starts pinned. Prefer see_still when you only need the picture.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}get_selectionAnswer
Read the shot the human has selected. Same live page as see_still.
View tool JSON
{
"name": "get_selection",
"kind": "answer",
"impl": "imperative",
"description": "Read the shot the human has selected. Same live page as see_still.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}find_shotAnswer
Look up a shot by id, slate, title, or a loose query without moving the playhead. The human stays on their still. Examples: laugh, landfill, 03-A, Product in hand.
View tool JSON
{
"name": "find_shot",
"kind": "answer",
"impl": "imperative",
"description": "Look up a shot by id, slate, title, or a loose query without moving the playhead. The human stays on their still. Examples: laugh, landfill, 03-A, Product in hand.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text such as laugh or landfill"
},
"id": {
"type": "string"
},
"slate": {
"type": "string"
},
"title": {
"type": "string"
}
},
"additionalProperties": false
},
"page": "/"
}select_shotAction
Select a shot by id, slate, title, or query and jump the playhead so the human sees that still. Examples: shot_3, 03-A, Product in hand, The laugh, landfill.
View tool JSON
{
"name": "select_shot",
"kind": "act",
"impl": "imperative",
"description": "Select a shot by id, slate, title, or query and jump the playhead so the human sees that still. Examples: shot_3, 03-A, Product in hand, The laugh, landfill.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Shot id such as shot_3, or a title if that is all you have"
},
"slate": {
"type": "string",
"description": "Slate such as 03-A"
},
"title": {
"type": "string",
"description": "Title such as The laugh"
},
"query": {
"type": "string",
"description": "Loose text such as hand or landfill"
}
},
"additionalProperties": false
},
"page": "/"
}add_shotAction
Insert an unlocked shot. Default is the end. Pass after (query) or index to place it.
View tool JSON
{
"name": "add_shot",
"kind": "act",
"impl": "imperative",
"description": "Insert an unlocked shot. Default is the end. Pass after (query) or index to place it.",
"inputSchema": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"caption": {
"type": "string"
},
"durationMs": {
"type": "number",
"description": "Duration in milliseconds, 800–12000"
},
"index": {
"type": "number",
"description": "Zero-based insert index"
},
"after": {
"type": "string",
"description": "Place after this shot: landfill, 03-A, hand"
}
},
"required": [
"title"
],
"additionalProperties": false
},
"page": "/"
}set_project_titleAction
Rename the cut. The human sees the new title immediately.
View tool JSON
{
"name": "set_project_title",
"kind": "act",
"impl": "imperative",
"description": "Rename the cut. The human sees the new title immediately.",
"inputSchema": {
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
],
"additionalProperties": false
},
"page": "/"
}reset_cutAction
Restore the sample Northwind cut. Does not confirm export.
View tool JSON
{
"name": "reset_cut",
"kind": "act",
"impl": "imperative",
"description": "Restore the sample Northwind cut. Does not confirm export.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}playAction
Play the cut from the current playhead. The human watches the same picture.
View tool JSON
{
"name": "play",
"kind": "act",
"impl": "imperative",
"description": "Play the cut from the current playhead. The human watches the same picture.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}replayAction
Seek to the start and play. The human watches the same cut from the top.
View tool JSON
{
"name": "replay",
"kind": "act",
"impl": "imperative",
"description": "Seek to the start and play. The human watches the same cut from the top.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}pauseAction
Pause playback.
View tool JSON
{
"name": "pause",
"kind": "act",
"impl": "imperative",
"description": "Pause playback.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}seekAction
Move the playhead. Pass ms, seconds, a shot query, or step (-1 or 1) to walk stills.
View tool JSON
{
"name": "seek",
"kind": "act",
"impl": "imperative",
"description": "Move the playhead. Pass ms, seconds, a shot query, or step (-1 or 1) to walk stills.",
"inputSchema": {
"type": "object",
"properties": {
"ms": {
"type": "number"
},
"seconds": {
"type": "number"
},
"step": {
"type": "number",
"description": "-1 previous still, 1 next still"
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}set_briefAction
Update the directing brief the human and agent share on this page.
View tool JSON
{
"name": "set_brief",
"kind": "act",
"impl": "imperative",
"description": "Update the directing brief the human and agent share on this page.",
"inputSchema": {
"type": "object",
"properties": {
"brief": {
"type": "string"
}
},
"required": [
"brief"
],
"additionalProperties": false
},
"page": "/"
}undoAction
Undo the last edit to the cut.
View tool JSON
{
"name": "undo",
"kind": "act",
"impl": "imperative",
"description": "Undo the last edit to the cut.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}redoAction
Redo the last undone edit.
View tool JSON
{
"name": "redo",
"kind": "act",
"impl": "imperative",
"description": "Redo the last undone edit.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}get_edlAnswer
Read the current cut as an EDL. Does not arm or clap. Use this to review before request_export.
View tool JSON
{
"name": "get_edl",
"kind": "answer",
"impl": "imperative",
"description": "Read the current cut as an EDL. Does not arm or clap. Use this to review before request_export.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}what_changedAction
Diff the cut against the last edit. Captions, holds, pins, order, adds, and deletes.
View tool JSON
{
"name": "what_changed",
"kind": "act",
"impl": "imperative",
"description": "Diff the cut against the last edit. Captions, holds, pins, order, adds, and deletes.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}trim_shotAction
Hold a shot to length, or nudge with delta (-0.4 or "+0.3s"). Pass query (landfill, hand). Pass query to pick a shot. Pins refuse writes. Fails on a pin. Same as hold.
View tool JSON
{
"name": "trim_shot",
"kind": "act",
"impl": "imperative",
"description": "Hold a shot to length, or nudge with delta (-0.4 or \"+0.3s\"). Pass query (landfill, hand). Pass query to pick a shot. Pins refuse writes. Fails on a pin. Same as hold.",
"inputSchema": {
"type": "object",
"properties": {
"durationMs": {
"type": "number",
"description": "Milliseconds, or a small number like 1.8 treated as seconds"
},
"seconds": {
"type": "number",
"description": "Hold in seconds, e.g. 1.8"
},
"duration": {
"type": "string",
"description": "Also accepts \"1.8s\""
},
"delta": {
"type": "number",
"description": "Nudge seconds if |n|<20, else ms. Negative shortens."
},
"nudge": {
"type": "string",
"description": "\"-0.4s\" or \"+300\""
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}holdAction
Same as trim_shot. Hold a shot to length, or nudge with delta. Pass query (landfill, hand). Pass query to pick a shot. Pins refuse writes. Fails on a pin.
View tool JSON
{
"name": "hold",
"kind": "act",
"impl": "imperative",
"description": "Same as trim_shot. Hold a shot to length, or nudge with delta. Pass query (landfill, hand). Pass query to pick a shot. Pins refuse writes. Fails on a pin.",
"inputSchema": {
"type": "object",
"properties": {
"durationMs": {
"type": "number",
"description": "Milliseconds, or a small number like 1.8 treated as seconds"
},
"seconds": {
"type": "number",
"description": "Hold in seconds, e.g. 1.8"
},
"duration": {
"type": "string",
"description": "Also accepts \"1.8s\""
},
"delta": {
"type": "number",
"description": "Nudge seconds if |n|<20, else ms. Negative shortens."
},
"nudge": {
"type": "string",
"description": "\"-0.4s\" or \"+300\""
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}split_shotAction
Split at the playhead when that shot is on screen. Pass query to pick another shot (splits at mid, or pass at/seconds). Pass query to pick a shot. Pins refuse writes. Fails on a pin.
View tool JSON
{
"name": "split_shot",
"kind": "act",
"impl": "imperative",
"description": "Split at the playhead when that shot is on screen. Pass query to pick another shot (splits at mid, or pass at/seconds). Pass query to pick a shot. Pins refuse writes. Fails on a pin.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
},
"at": {
"type": "number",
"description": "Local split point in ms"
},
"seconds": {
"type": "number",
"description": "Local split point in seconds"
}
},
"additionalProperties": false
},
"page": "/"
}set_captionAction
Write a burned-in caption on the shared still. The human sees it immediately. Pass query to pick the shot (hand, landfill). Pass query to pick a shot. Pins refuse writes. Fails on a pin.
View tool JSON
{
"name": "set_caption",
"kind": "act",
"impl": "imperative",
"description": "Write a burned-in caption on the shared still. The human sees it immediately. Pass query to pick the shot (hand, landfill). Pass query to pick a shot. Pins refuse writes. Fails on a pin.",
"inputSchema": {
"type": "object",
"properties": {
"caption": {
"type": "string"
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"required": [
"caption"
],
"additionalProperties": false
},
"page": "/"
}set_titleAction
Rename a shot. title is the new name. Pass query to pick the shot. Pass query to pick a shot. Pins refuse writes. Fails on a pin.
View tool JSON
{
"name": "set_title",
"kind": "act",
"impl": "imperative",
"description": "Rename a shot. title is the new name. Pass query to pick the shot. Pass query to pick a shot. Pins refuse writes. Fails on a pin.",
"inputSchema": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
}
},
"required": [
"title"
],
"additionalProperties": false
},
"page": "/"
}move_shotAction
Reorder a shot. Pass index (zero-based) or after (a shot query). Pins may move. They still refuse trim and caption.
View tool JSON
{
"name": "move_shot",
"kind": "act",
"impl": "imperative",
"description": "Reorder a shot. Pass index (zero-based) or after (a shot query). Pins may move. They still refuse trim and caption.",
"inputSchema": {
"type": "object",
"properties": {
"index": {
"type": "number",
"description": "Zero-based destination"
},
"after": {
"type": "string",
"description": "Place after this shot: hand, landfill, 03-A"
},
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}swap_shotsAction
Swap two shots by query. Pins may swap. They still refuse trim and caption.
View tool JSON
{
"name": "swap_shots",
"kind": "act",
"impl": "imperative",
"description": "Swap two shots by query. Pins may swap. They still refuse trim and caption.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
},
"with": {
"type": "string",
"description": "The other shot: landfill, hand, 04-A"
}
},
"required": [
"with"
],
"additionalProperties": false
},
"page": "/"
}lock_shotAction
Pin a shot. Write tools then refuse it until unlock_shot. Pass query or use the selection. Same as pin.
View tool JSON
{
"name": "lock_shot",
"kind": "act",
"impl": "imperative",
"description": "Pin a shot. Write tools then refuse it until unlock_shot. Pass query or use the selection. Same as pin.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}pinAction
Same as lock_shot. Pin a shot. Writes then refuse until unpin.
View tool JSON
{
"name": "pin",
"kind": "act",
"impl": "imperative",
"description": "Same as lock_shot. Pin a shot. Writes then refuse until unpin.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}delete_shotSensitive Action
Delete a shot. Fails if pinned or if it is the last shot. Pass query to pick a shot. Pins refuse writes.
View tool JSON
{
"name": "delete_shot",
"kind": "transact",
"impl": "imperative",
"description": "Delete a shot. Fails if pinned or if it is the last shot. Pass query to pick a shot. Pins refuse writes.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}duplicate_shotAction
Duplicate a shot as a new unlocked copy. Pass query or use the selection.
View tool JSON
{
"name": "duplicate_shot",
"kind": "act",
"impl": "imperative",
"description": "Duplicate a shot as a new unlocked copy. Pass query or use the selection.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}unlock_shotAction
Unpin a shot so write tools can change it. Pass query such as laugh, or use the selection. Same as unpin.
View tool JSON
{
"name": "unlock_shot",
"kind": "act",
"impl": "imperative",
"description": "Unpin a shot so write tools can change it. Pass query such as laugh, or use the selection. Same as unpin.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}unpinAction
Same as unlock_shot. Unpin a shot so write tools can change it.
View tool JSON
{
"name": "unpin",
"kind": "act",
"impl": "imperative",
"description": "Same as unlock_shot. Unpin a shot so write tools can change it.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Loose text: hand, landfill, laugh, product"
},
"id": {
"type": "string",
"description": "shot_3"
},
"slate": {
"type": "string",
"description": "03-A"
},
"title": {
"type": "string",
"description": "Product in hand"
}
},
"additionalProperties": false
},
"page": "/"
}request_exportAction
Arm export. Does not write the cut until confirm_export, clap, or the human claps on the page. Same as mark_cut.
View tool JSON
{
"name": "request_export",
"kind": "act",
"impl": "imperative",
"description": "Arm export. Does not write the cut until confirm_export, clap, or the human claps on the page. Same as mark_cut.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}confirm_exportAction
Commit the cut after it is armed. Fails if export is not armed. Same as clap. The human can also clap on the page.
View tool JSON
{
"name": "confirm_export",
"kind": "act",
"impl": "imperative",
"description": "Commit the cut after it is armed. Fails if export is not armed. Same as clap. The human can also clap on the page.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}directAction
Run several named edits in one call. Pins refuse that line and the rest continue. One edit per line. Example: caption hand Hold. Then turn.\ntrim landfill 1.8s\nmark_cut
View tool JSON
{
"name": "direct",
"kind": "act",
"impl": "imperative",
"description": "Run several named edits in one call. Pins refuse that line and the rest continue. One edit per line. Example: caption hand Hold. Then turn.\\ntrim landfill 1.8s\\nmark_cut",
"inputSchema": {
"type": "object",
"properties": {
"script": {
"type": "string",
"description": "One edit per line. Friendly: \"caption hand Hold. Then turn.\", \"trim landfill 1.8s\", \"try laugh\", \"mark_cut\", \"clap\"."
}
},
"required": [
"script"
],
"additionalProperties": false
},
"page": "/"
}cancel_exportSensitive Action
Cancel a pending export clap.
View tool JSON
{
"name": "cancel_export",
"kind": "transact",
"impl": "imperative",
"description": "Cancel a pending export clap.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/"
}page: Studio
set_briefAction
Update the directing brief the human and agent share.
View tool JSON
{
"name": "set_brief",
"kind": "act",
"impl": "declarative",
"description": "Update the directing brief the human and agent share.",
"inputSchema": {
"type": "object",
"properties": {
"brief": {
"type": "string"
}
}
},
"page": "/studio"
}