View as Markdown

Default model tools

episode_change_set_read

Read a Program edit run

Reads authoritative progress, recovery state, and a bounded page of individual operation receipts for one durable Program change set. This does not move the Program, transport, selection, focus, viewport, zoom, or Peek state.

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": "episode_change_set_read",
  "title": "Read a Program edit run",
  "description": "Reads authoritative progress, recovery state, and a bounded page of individual operation receipts for one durable Program change set. This does not move the Program, transport, selection, focus, viewport, zoom, or Peek state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "change_set_id": {
        "type": "string",
        "description": "Durable Program change-set public ID."
      },
      "after": {
        "type": "integer",
        "description": "Optional last item position already seen."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Optional item page size; defaults to 50."
      }
    },
    "required": [
      "change_set_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Read a Program edit run",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "episode_change_set_read",
  "title": "Read a Program edit run",
  "description": "Reads authoritative progress, recovery state, and a bounded page of individual operation receipts for one durable Program change set. This does not move the Program, transport, selection, focus, viewport, zoom, or Peek state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "change_set_id": {
        "type": "string",
        "description": "Durable Program change-set public ID."
      },
      "after": {
        "type": "integer",
        "description": "Optional last item position already seen."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Optional item page size; defaults to 50."
      }
    },
    "required": [
      "change_set_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Read a Program edit run",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "change_set_id": {
        "type": "string"
      },
      "episode_id": {
        "type": "string"
      },
      "kind": {
        "type": "string",
        "enum": [
          "edit",
          "revert"
        ]
      },
      "status": {
        "type": "string"
      },
      "activity_revision": {
        "type": "integer"
      },
      "total_operations": {
        "type": "integer"
      },
      "committed_operations": {
        "type": "integer"
      },
      "counts": {
        "type": "object"
      },
      "head_revision": {
        "type": "integer"
      },
      "head_program_digest": {
        "type": "string"
      },
      "attribution": {
        "type": "string"
      },
      "can_stop": {
        "type": "boolean"
      },
      "can_revert": {
        "type": "boolean"
      },
      "exact_revertible": {
        "type": "boolean"
      },
      "external_adoptions": {
        "type": "integer"
      },
      "error": {
        "type": [
          "object",
          "null"
        ]
      },
      "summary": {
        "type": "object"
      },
      "started_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "finished_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "stopped_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverted_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverts_change_set_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverted_by_change_set_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "next_after": {
        "type": "integer"
      },
      "has_more": {
        "type": "boolean"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Live Workspace descriptor

{
  "name": "episode_change_set_read",
  "title": "Read a Program edit run",
  "description": "Reads authoritative progress, recovery state, and a bounded page of individual operation receipts for one durable Program change set. This does not move the Program, transport, selection, focus, viewport, zoom, or Peek state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "change_set_id": {
        "type": "string",
        "description": "Durable Program change-set public ID."
      },
      "after": {
        "type": "integer",
        "description": "Optional last item position already seen."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Optional item page size; defaults to 50."
      }
    },
    "required": [
      "change_set_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Read a Program edit run",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "change_set_id": {
        "type": "string"
      },
      "episode_id": {
        "type": "string"
      },
      "kind": {
        "type": "string",
        "enum": [
          "edit",
          "revert"
        ]
      },
      "status": {
        "type": "string"
      },
      "activity_revision": {
        "type": "integer"
      },
      "total_operations": {
        "type": "integer"
      },
      "committed_operations": {
        "type": "integer"
      },
      "counts": {
        "type": "object"
      },
      "head_revision": {
        "type": "integer"
      },
      "head_program_digest": {
        "type": "string"
      },
      "attribution": {
        "type": "string"
      },
      "can_stop": {
        "type": "boolean"
      },
      "can_revert": {
        "type": "boolean"
      },
      "exact_revertible": {
        "type": "boolean"
      },
      "external_adoptions": {
        "type": "integer"
      },
      "error": {
        "type": [
          "object",
          "null"
        ]
      },
      "summary": {
        "type": "object"
      },
      "started_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "finished_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "stopped_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverted_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverts_change_set_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "reverted_by_change_set_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "next_after": {
        "type": "integer"
      },
      "has_more": {
        "type": "boolean"
      },
      "workspace_binding": {
        "type": "object",
        "properties": {
          "schema": {
            "type": "string",
            "enum": [
              "bitterclip.workspace-binding.v2"
            ]
          },
          "mode": {
            "type": "string",
            "enum": [
              "live_workspace"
            ]
          },
          "project_id": {
            "type": "string"
          },
          "target_kind": {
            "type": "string",
            "enum": [
              "episode",
              "clip"
            ]
          },
          "target_id": {
            "type": "string"
          },
          "revision": {
            "type": "integer"
          },
          "draft_revision": {
            "type": "string"
          },
          "workspace_url": {
            "type": "string"
          },
          "output_id": {
            "type": "string"
          },
          "output_status": {
            "type": "string",
            "enum": [
              "missing",
              "stale",
              "rendering",
              "ready",
              "failed"
            ]
          },
          "output_revision": {
            "type": "integer"
          },
          "parent_episode_id": {
            "type": "string"
          }
        },
        "required": [
          "schema",
          "mode",
          "target_kind",
          "target_id",
          "revision",
          "draft_revision",
          "workspace_url",
          "output_status"
        ],
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "program_change_set_not_found",
  "invalid_input"
]

Examples

[]