# publish_update

Canonical HTML page: https://bitterclip.com/docs/assistants/tools/publish_update

Surface: default model and app

Product release: 1dce717408a55fac1047e7d779177fa3ef8ede51
Public contract commit: 1ce47f7857ae3d9b6933fe83d5c33de3ae5efc64
Public contract SHA-256: 241d47d25e4b4c1dae9d2263793874d06fc4ba7bc3c78d4cf2bc63fbb32ed7dc
Descriptor SHA-256: 885d46f3ca3939dec2ace0cd6e93611c8b3f741f2d8f7a82e0adfe1452cc9a9e
Captured: 2026-09-24T16:39:30.100Z
Source: https://app.bitterclip.com/api/v1/mcp_descriptors.json

Edit copy for a reviewable publish package or approval item before it is published. If the package was already approved, the edit supersedes that decision and returns the package to review. This does not publish externally.

The JSON blocks below are the exact MCP descriptor projections served by Rails for the named profiles at capture time. Security schemes and resource URIs may vary by connected host.

## Default model descriptor

```json
{
  "name": "publish_update",
  "title": "Update a publish package",
  "description": "Edit copy for a reviewable publish package or approval item before it is published. If the package was already approved, the edit supersedes that decision and returns the package to review. This does not publish externally.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "publish_package_id": {
        "type": "string",
        "description": "Approval/package public ID."
      },
      "approval_id": {
        "type": "string",
        "description": "Approval/package public ID alias."
      },
      "title": {
        "type": "string",
        "description": "Optional title. Currently retained by package-specific backends when supported."
      },
      "description": {
        "type": "string",
        "description": "Optional description. Currently maps to channel copy where supported."
      },
      "copy": {
        "type": [
          "object",
          "string"
        ],
        "description": "Optional channel body copy. Object values may be keyed by channel plus default."
      },
      "boost": {
        "type": "string",
        "description": "Optional X quote-boost copy."
      }
    },
    "required": [],
    "additionalProperties": false,
    "anyOf": [
      {
        "required": [
          "publish_package_id"
        ]
      },
      {
        "required": [
          "approval_id"
        ]
      }
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}
```

## App descriptor

```json
{
  "name": "publish_update",
  "title": "Update a publish package",
  "description": "Edit copy for a reviewable publish package or approval item before it is published. If the package was already approved, the edit supersedes that decision and returns the package to review. This does not publish externally.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "publish_package_id": {
        "type": "string",
        "description": "Approval/package public ID."
      },
      "approval_id": {
        "type": "string",
        "description": "Approval/package public ID alias."
      },
      "title": {
        "type": "string",
        "description": "Optional title. Currently retained by package-specific backends when supported."
      },
      "description": {
        "type": "string",
        "description": "Optional description. Currently maps to channel copy where supported."
      },
      "copy": {
        "type": [
          "object",
          "string"
        ],
        "description": "Optional channel body copy. Object values may be keyed by channel plus default."
      },
      "boost": {
        "type": "string",
        "description": "Optional X quote-boost copy."
      }
    },
    "required": [],
    "additionalProperties": false,
    "anyOf": [
      {
        "required": [
          "publish_package_id"
        ]
      },
      {
        "required": [
          "approval_id"
        ]
      }
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "publish_package_id": {
        "type": "string"
      },
      "approval_id": {
        "type": "string"
      },
      "status": {
        "type": "string"
      },
      "ready_to_publish": {
        "type": "boolean"
      },
      "composed_copy": {
        "type": "object",
        "description": "Refreshed channel copy, such as post_body and boost when present."
      },
      "publish_state": {
        "type": "object",
        "description": "Canonical BitterClip publish-state envelope for web, mobile, MCP/App widgets, and AI cockpit tools. Use stage first for the current product state and next action.",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "object": {
            "type": "object",
            "description": "Current publish object identity, using public IDs only.",
            "properties": {
              "kind": {
                "type": "string"
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "recording_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "clip_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "composition_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "export_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "approval_id": {
                "type": "string"
              },
              "platform": {
                "type": "string"
              }
            }
          },
          "media": {
            "type": "object",
            "description": "Whether the media asset can be published.",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "ready",
                  "rendering",
                  "failed",
                  "missing",
                  "render_required",
                  "stale"
                ]
              },
              "ready": {
                "type": "boolean"
              },
              "source": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "download_url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "package": {
            "type": "object",
            "description": "Reviewable package readiness and approval state.",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "missing",
                  "needs_review",
                  "approved",
                  "published",
                  "failed",
                  "blocked",
                  "manual_handoff",
                  "ready",
                  "rendering",
                  "render_required",
                  "stale"
                ]
              },
              "ready": {
                "type": "boolean"
              },
              "approval_status": {
                "type": "string"
              },
              "explicit_approval_required": {
                "type": "boolean"
              },
              "kind": {
                "type": "string"
              },
              "mode": {
                "type": "string"
              },
              "review_url": {
                "type": "string"
              },
              "checks_summary": {
                "type": "object"
              }
            }
          },
          "copy": {
            "type": "object",
            "description": "Destination-copy readiness and formatting state.",
            "properties": {
              "status": {
                "type": "string"
              },
              "format": {
                "type": "string"
              },
              "ready": {
                "type": "boolean"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "body_present": {
                "type": "boolean"
              },
              "text_present": {
                "type": "boolean"
              },
              "body_preview": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "message": {
                "type": "string",
                "description": "Plain-language copy readiness summary for primary UI and model responses."
              },
              "preview_lines": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "First non-empty destination-copy lines, preserving platform-native paragraph and bullet structure for compact UI."
              },
              "line_count": {
                "type": "integer"
              },
              "character_count": {
                "type": "integer"
              },
              "platform_native": {
                "type": "boolean"
              }
            }
          },
          "destinations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "platform": {
                  "type": "string"
                },
                "platform_key": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "readiness": {
                  "type": "string",
                  "enum": [
                    "connected",
                    "missing_auth",
                    "permission_limited",
                    "capped",
                    "unsupported",
                    "manual_handoff",
                    "blocked"
                  ]
                },
                "configured": {
                  "type": "boolean"
                },
                "package_mode": {
                  "type": "string"
                },
                "package": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ready": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "approval_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "approval_public_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "approval_status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "review_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "mode": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "link_platform": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "attempt_state": {
                  "type": "string"
                },
                "reconciliation_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "cleanup_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "latest_publish_record_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "external_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "external_urls": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "safe_to_retry": {
                  "type": "boolean"
                },
                "can_prepare_package": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "selected_by_default": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "can_publish_approval": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "attempts": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "next_action": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
                  "properties": {
                    "kind": {
                      "type": "string"
                    },
                    "label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "safe_to_retry": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "publish_record_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_record_public_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cleanup_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reconcile_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "inspect_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "retry_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "tool_name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "poll_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "required_fields": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "optional_fields": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "platforms": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "approval_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "arguments": {
                      "type": "object"
                    },
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "review_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "settings_path": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "authorize_path": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "stage": {
            "type": "object",
            "description": "Compact product-language state for above-the-fold UI and model narration. Read this first.",
            "required": [
              "status",
              "label",
              "message",
              "blocking",
              "ready_to_publish"
            ],
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "ready_to_publish",
                  "ready_to_package",
                  "needs_review",
                  "needs_destination",
                  "destination_blocked",
                  "manual_handoff",
                  "copy_needs_review",
                  "needs_reconciliation",
                  "cleanup_failed",
                  "publishing",
                  "published",
                  "rendering",
                  "render_required",
                  "stale",
                  "missing",
                  "failed"
                ]
              },
              "label": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "blocking": {
                "type": "boolean"
              },
              "ready_to_publish": {
                "type": "boolean"
              },
              "action": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
                "properties": {
                  "kind": {
                    "type": "string"
                  },
                  "label": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "safe_to_retry": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "publish_record_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "publish_record_public_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reconcile_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "inspect_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "retry_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "publish_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tool_name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "poll_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "required_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "optional_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "approval_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "arguments": {
                    "type": "object"
                  },
                  "url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "review_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "settings_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "authorize_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          },
          "next_action": {
            "type": [
              "object",
              "null"
            ],
            "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
            "properties": {
              "kind": {
                "type": "string"
              },
              "label": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "message": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "safe_to_retry": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "publish_record_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publish_record_public_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cleanup_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "reconcile_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "inspect_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "retry_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publish_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "tool_name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "poll_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "required_fields": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "optional_fields": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "platforms": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "approval_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "arguments": {
                "type": "object"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "review_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "settings_path": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "authorize_path": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "required": [
          "schema_version",
          "object",
          "media",
          "package",
          "copy",
          "destinations",
          "stage"
        ]
      },
      "next_action": {
        "type": [
          "object",
          "null"
        ],
        "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
        "properties": {
          "kind": {
            "type": "string"
          },
          "label": {
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "safe_to_retry": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "publish_record_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "publish_record_public_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "cleanup_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "reconcile_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "inspect_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "retry_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "publish_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "tool_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "poll_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "required_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "optional_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "approval_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "arguments": {
            "type": "object"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "settings_path": {
            "type": [
              "string",
              "null"
            ]
          },
          "authorize_path": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "blockers": {
        "type": "array",
        "items": {
          "type": "object"
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Live Workspace descriptor

```json
{
  "name": "publish_update",
  "title": "Update a publish package",
  "description": "Edit copy for a reviewable publish package or approval item before it is published. If the package was already approved, the edit supersedes that decision and returns the package to review. This does not publish externally.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "publish_package_id": {
        "type": "string",
        "description": "Approval/package public ID."
      },
      "approval_id": {
        "type": "string",
        "description": "Approval/package public ID alias."
      },
      "title": {
        "type": "string",
        "description": "Optional title. Currently retained by package-specific backends when supported."
      },
      "description": {
        "type": "string",
        "description": "Optional description. Currently maps to channel copy where supported."
      },
      "copy": {
        "type": [
          "object",
          "string"
        ],
        "description": "Optional channel body copy. Object values may be keyed by channel plus default."
      },
      "boost": {
        "type": "string",
        "description": "Optional X quote-boost copy."
      }
    },
    "required": [],
    "additionalProperties": false,
    "anyOf": [
      {
        "required": [
          "publish_package_id"
        ]
      },
      {
        "required": [
          "approval_id"
        ]
      }
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "publish_package_id": {
        "type": "string"
      },
      "approval_id": {
        "type": "string"
      },
      "status": {
        "type": "string"
      },
      "ready_to_publish": {
        "type": "boolean"
      },
      "composed_copy": {
        "type": "object",
        "description": "Refreshed channel copy, such as post_body and boost when present."
      },
      "publish_state": {
        "type": "object",
        "description": "Canonical BitterClip publish-state envelope for web, mobile, MCP/App widgets, and AI cockpit tools. Use stage first for the current product state and next action.",
        "properties": {
          "schema_version": {
            "type": "string"
          },
          "object": {
            "type": "object",
            "description": "Current publish object identity, using public IDs only.",
            "properties": {
              "kind": {
                "type": "string"
              },
              "title": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "recording_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "clip_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "composition_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "export_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "approval_id": {
                "type": "string"
              },
              "platform": {
                "type": "string"
              }
            }
          },
          "media": {
            "type": "object",
            "description": "Whether the media asset can be published.",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "ready",
                  "rendering",
                  "failed",
                  "missing",
                  "render_required",
                  "stale"
                ]
              },
              "ready": {
                "type": "boolean"
              },
              "source": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "download_url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "package": {
            "type": "object",
            "description": "Reviewable package readiness and approval state.",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "missing",
                  "needs_review",
                  "approved",
                  "published",
                  "failed",
                  "blocked",
                  "manual_handoff",
                  "ready",
                  "rendering",
                  "render_required",
                  "stale"
                ]
              },
              "ready": {
                "type": "boolean"
              },
              "approval_status": {
                "type": "string"
              },
              "explicit_approval_required": {
                "type": "boolean"
              },
              "kind": {
                "type": "string"
              },
              "mode": {
                "type": "string"
              },
              "review_url": {
                "type": "string"
              },
              "checks_summary": {
                "type": "object"
              }
            }
          },
          "copy": {
            "type": "object",
            "description": "Destination-copy readiness and formatting state.",
            "properties": {
              "status": {
                "type": "string"
              },
              "format": {
                "type": "string"
              },
              "ready": {
                "type": "boolean"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "body_present": {
                "type": "boolean"
              },
              "text_present": {
                "type": "boolean"
              },
              "body_preview": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "message": {
                "type": "string",
                "description": "Plain-language copy readiness summary for primary UI and model responses."
              },
              "preview_lines": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "First non-empty destination-copy lines, preserving platform-native paragraph and bullet structure for compact UI."
              },
              "line_count": {
                "type": "integer"
              },
              "character_count": {
                "type": "integer"
              },
              "platform_native": {
                "type": "boolean"
              }
            }
          },
          "destinations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "platform": {
                  "type": "string"
                },
                "platform_key": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "readiness": {
                  "type": "string",
                  "enum": [
                    "connected",
                    "missing_auth",
                    "permission_limited",
                    "capped",
                    "unsupported",
                    "manual_handoff",
                    "blocked"
                  ]
                },
                "configured": {
                  "type": "boolean"
                },
                "package_mode": {
                  "type": "string"
                },
                "package": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "ready": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "approval_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "approval_public_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "approval_status": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "review_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "mode": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "link_platform": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reason": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "attempt_state": {
                  "type": "string"
                },
                "reconciliation_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "cleanup_state": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "latest_publish_record_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "external_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "external_urls": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "safe_to_retry": {
                  "type": "boolean"
                },
                "can_prepare_package": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "selected_by_default": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "can_publish_approval": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "attempts": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  }
                },
                "next_action": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
                  "properties": {
                    "kind": {
                      "type": "string"
                    },
                    "label": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "message": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "safe_to_retry": {
                      "type": [
                        "boolean",
                        "null"
                      ]
                    },
                    "publish_record_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_record_public_id": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cleanup_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "reconcile_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "inspect_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "retry_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "publish_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "tool_name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "poll_tool": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "required_fields": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "optional_fields": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "platforms": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "approval_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "arguments": {
                      "type": "object"
                    },
                    "url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "review_url": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "settings_path": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "authorize_path": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "stage": {
            "type": "object",
            "description": "Compact product-language state for above-the-fold UI and model narration. Read this first.",
            "required": [
              "status",
              "label",
              "message",
              "blocking",
              "ready_to_publish"
            ],
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "ready_to_publish",
                  "ready_to_package",
                  "needs_review",
                  "needs_destination",
                  "destination_blocked",
                  "manual_handoff",
                  "copy_needs_review",
                  "needs_reconciliation",
                  "cleanup_failed",
                  "publishing",
                  "published",
                  "rendering",
                  "render_required",
                  "stale",
                  "missing",
                  "failed"
                ]
              },
              "label": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "blocking": {
                "type": "boolean"
              },
              "ready_to_publish": {
                "type": "boolean"
              },
              "action": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
                "properties": {
                  "kind": {
                    "type": "string"
                  },
                  "label": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "message": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "safe_to_retry": {
                    "type": [
                      "boolean",
                      "null"
                    ]
                  },
                  "publish_record_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "publish_record_public_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cleanup_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reconcile_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "inspect_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "retry_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "publish_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "tool_name": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "poll_tool": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "required_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "optional_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "platforms": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "approval_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "arguments": {
                    "type": "object"
                  },
                  "url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "review_url": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "settings_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "authorize_path": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          },
          "next_action": {
            "type": [
              "object",
              "null"
            ],
            "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
            "properties": {
              "kind": {
                "type": "string"
              },
              "label": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "message": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "safe_to_retry": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "publish_record_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publish_record_public_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "cleanup_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "reconcile_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "inspect_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "retry_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "publish_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "tool_name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "poll_tool": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "required_fields": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "optional_fields": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "platforms": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "approval_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "arguments": {
                "type": "object"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "review_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "settings_path": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "authorize_path": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        },
        "required": [
          "schema_version",
          "object",
          "media",
          "package",
          "copy",
          "destinations",
          "stage"
        ]
      },
      "next_action": {
        "type": [
          "object",
          "null"
        ],
        "description": "Safe next action or recovery action in product terms. Tool fields are partial instructions; callers must supply any required_fields that are not present in arguments.",
        "properties": {
          "kind": {
            "type": "string"
          },
          "label": {
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "type": [
              "string",
              "null"
            ]
          },
          "safe_to_retry": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "publish_record_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "publish_record_public_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "cleanup_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "reconcile_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "inspect_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "retry_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "publish_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "tool_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "poll_tool": {
            "type": [
              "string",
              "null"
            ]
          },
          "required_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "optional_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "platforms": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "approval_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "arguments": {
            "type": "object"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "settings_path": {
            "type": [
              "string",
              "null"
            ]
          },
          "authorize_path": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "blockers": {
        "type": "array",
        "items": {
          "type": "object"
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Errors

```json
[
  "approval_not_found",
  "publish_not_editable",
  "no_changes",
  "invalid_input"
]
```

## Examples

```json
[]
```