known-errors

name: known-errors description: Use when a OpenChatCut tool call fails or returns an unexpected shape.

Known Errors

edit_item update raw shape:

• Wrong: { "id": "abc", "fromFrame": 30 }
• Right: { "json": "{\"updates\":[{\"id\":\"abc\",\"fromFrame\":30}]}" }
• Use this same updates shape for common moves, trims, and track changes.

edit_item add raw shape:

• The new item goes inside the adds array of the json transaction: { "json": "{\"adds\":[{...}]}" }.
• Use edit_item for simple video placement, for example { "json": "{\"adds\":[{\"type\":\"video\",\"assetId\":\"...\",\"fromFrame\":0}]}" }.