View as Markdown

Default model tools

scene_edit

Edit FX scene source

Applies a literal string replacement to the current scene source. Requires expected_revision plus expected_sha256 from scene_read. old_string must match exactly once unless replace_all:true. Replacement bytes are literal, including JavaScript backslashes and dollar signs. Conflicts preserve source and return the current revision for rereading. Successful edits update the same open FX Studio view; scene_preview renders the result. JavaScript source changes do not mutate production defaults or an admitted Export.

Surface: Default model and app

Product release eb8538f4a297f331d0399351c1e175bffcd212d2
Public contract commit 20688e11af473a363145ed880d5019c90a7ec1e2
Public contract SHA-256 87a94b85a84dc19245fc03f9b544c70d64bd9f5e08585dcccb38157cace5700d
Captured 2026-10-04T11:55:45.577Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

Default model descriptor

{
  "name": "scene_edit",
  "title": "Edit FX scene source",
  "description": "Applies a literal string replacement to the current scene source. Requires expected_revision plus expected_sha256 from scene_read. old_string must match exactly once unless replace_all:true. Replacement bytes are literal, including JavaScript backslashes and dollar signs. Conflicts preserve source and return the current revision for rereading. Successful edits update the same open FX Studio view; scene_preview renders the result. JavaScript source changes do not mutate production defaults or an admitted Export.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "scene_id": {
        "type": "string"
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 1
      },
      "expected_sha256": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$"
      },
      "old_string": {
        "type": "string",
        "maxLength": 131072
      },
      "new_string": {
        "type": "string",
        "maxLength": 131072
      },
      "replace_all": {
        "type": "boolean"
      }
    },
    "required": [
      "scene_id",
      "old_string",
      "new_string",
      "expected_revision",
      "expected_sha256"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit FX scene source",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "scene_edit",
  "title": "Edit FX scene source",
  "description": "Applies a literal string replacement to the current scene source. Requires expected_revision plus expected_sha256 from scene_read. old_string must match exactly once unless replace_all:true. Replacement bytes are literal, including JavaScript backslashes and dollar signs. Conflicts preserve source and return the current revision for rereading. Successful edits update the same open FX Studio view; scene_preview renders the result. JavaScript source changes do not mutate production defaults or an admitted Export.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "scene_id": {
        "type": "string"
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 1
      },
      "expected_sha256": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$"
      },
      "old_string": {
        "type": "string",
        "maxLength": 131072
      },
      "new_string": {
        "type": "string",
        "maxLength": 131072
      },
      "replace_all": {
        "type": "boolean"
      }
    },
    "required": [
      "scene_id",
      "old_string",
      "new_string",
      "expected_revision",
      "expected_sha256"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit FX scene source",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "scene": {
        "type": "object"
      },
      "replacements": {
        "type": "integer"
      },
      "message": {
        "type": "string"
      },
      "before_bytes": {
        "type": "integer"
      },
      "after_bytes": {
        "type": "integer"
      },
      "bytes_delta": {
        "type": "integer"
      },
      "post_edit_context": {
        "type": "string"
      },
      "warnings": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "schema": {
        "type": "string",
        "description": "Receipt schema identifier, bitterclip.scene_edit_receipt.v1."
      },
      "changed": {
        "type": "boolean",
        "description": "False when the edited source, name and settings matched the saved scene, so no revision was written."
      },
      "validation": {
        "type": "object",
        "description": "Validation state of the scene code: syntax is checked when the scene is written; runtime is not checked.",
        "properties": {
          "syntax": {
            "type": "string"
          },
          "runtime": {
            "type": "string"
          }
        }
      },
      "project_id": {
        "type": "string",
        "description": "Project public ID the scene was edited through; absent for an account-level edit."
      },
      "blockers": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Typed blockers; empty when the call succeeded."
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Live Workspace descriptor

{
  "name": "scene_edit",
  "title": "Edit FX scene source",
  "description": "Applies a literal string replacement to the current scene source. Requires expected_revision plus expected_sha256 from scene_read. old_string must match exactly once unless replace_all:true. Replacement bytes are literal, including JavaScript backslashes and dollar signs. Conflicts preserve source and return the current revision for rereading. Successful edits update the same open FX Studio view; scene_preview renders the result. JavaScript source changes do not mutate production defaults or an admitted Export.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "scene_id": {
        "type": "string"
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 1
      },
      "expected_sha256": {
        "type": "string",
        "pattern": "^[a-f0-9]{64}$"
      },
      "old_string": {
        "type": "string",
        "maxLength": 131072
      },
      "new_string": {
        "type": "string",
        "maxLength": 131072
      },
      "replace_all": {
        "type": "boolean"
      }
    },
    "required": [
      "scene_id",
      "old_string",
      "new_string",
      "expected_revision",
      "expected_sha256"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit FX scene source",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "scene": {
        "type": "object"
      },
      "replacements": {
        "type": "integer"
      },
      "message": {
        "type": "string"
      },
      "before_bytes": {
        "type": "integer"
      },
      "after_bytes": {
        "type": "integer"
      },
      "bytes_delta": {
        "type": "integer"
      },
      "post_edit_context": {
        "type": "string"
      },
      "warnings": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "schema": {
        "type": "string",
        "description": "Receipt schema identifier, bitterclip.scene_edit_receipt.v1."
      },
      "changed": {
        "type": "boolean",
        "description": "False when the edited source, name and settings matched the saved scene, so no revision was written."
      },
      "validation": {
        "type": "object",
        "description": "Validation state of the scene code: syntax is checked when the scene is written; runtime is not checked.",
        "properties": {
          "syntax": {
            "type": "string"
          },
          "runtime": {
            "type": "string"
          }
        }
      },
      "project_id": {
        "type": "string",
        "description": "Project public ID the scene was edited through; absent for an account-level edit."
      },
      "blockers": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Typed blockers; empty when the call succeeded."
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "project_not_found",
  "invalid_input",
  "revision_conflict"
]

Examples

[]