HAI Orbit

Submit actual orbit.artifact.v1 website content for user review. This prepares an import; the user must confirm at confirmationUrl before a private Workspace is created. Reuse idempotencyKey only for identical content. Do not invent unavailable source content.

create_workspace_from_artifact

Return the complete actual canonical website: every stored text, node, style property and image reference, with an exact version and digest. publicationState distinguishes initial content from Owner-published content. Never returns Approved/unpublished changes or private previews. Authenticated image bytes need get_workspace_asset. This does not overwrite a ChatGPT Canvas.

get_workspace

Return the existing permission-gated Workspace URL and role-aware review guidance. Owners use Review proposals, Before / After, select proposals and Publish selected in Orbit; there is no separate Approve or Reject button in this flow. Follow the returned guidance. This does not create public access, a sharing token or an MCP publication action.

get_workspace_link

List only canonical history, with normalized proposal IDs and explicit initial/published states. This is a version index; use get_workspace_version to retrieve full historical website content. Never reads private previews or publishes/restores.

get_workspace_versions

Retrieve the full immutable canonical website at an exact version. Returns initial/published state, all nodes/styles/images and digests. Does not retrieve private previews or un-published approved proposals.

get_workspace_version

Return the latest Owner-published website as a complete orbit.artifact.v1 object: text, structure, all stored component styles and image references, with version and digests. Initial-only Workspaces return NOT_PUBLISHED. Approved proposals and private previews never replace the published version. Use this after Publish to continue work in ChatGPT; do not claim automatic replacement of the original Canvas.

get_published_workspace

After the user confirms the handoff in Orbit, get the actual Workspace URL. Pending imports have no Workspace yet.

get_import_status

Get the exact supported website content contract and component schemas. Raw HTML, React source, titles and prompts alone are not imports.

get_artifact_import_format

List visible formal proposal metadata for one supplied Workspace ID under this user's existing permissions. This does not return private conversations, unsubmitted drafts or visual diffs. There is no global Workspace discovery tool; ask for an authorized Workspace URL or ID instead of offering to enumerate all workspaces.

list_proposals

Return actual stored private-image bytes as MCP image content, only if this Image element appears in the exact authorized canonical version. Never reads another person's private draft image or provider metadata. External URLs return references without server fetches. Fetch a pinned asset once; do not repeat a successful call merely because the host cannot display its pixels. In that case explain the host limitation and provide the returned authenticated source link, without claiming inline display. This does not make an image public; rendering it in a ChatGPT-created website requires host asset materialization and validation.

get_workspace_asset