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 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Captured 2026-10-29T03:35:56.855Z. 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

[]