Tools / design_versions
design_versions
Read a composition's versions and accepted version.
Generated from @oods/foundry 0.11.0
One of the 26 tools your assistant sees by default.
Use it when inspecting saved lineage; use design_preview to render, edit, compare or accept. Returns version metadata, latest and acceptance summary. Supply compositionId. Starts no preview host and returns no running URL. Full schema: oods://schemas/design_versions.input.json.
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
action | "versions" | no | Choose versions. |
compositionId | string | yes | An existing composition from design_compose; with no version, its latest version opens. |
Outputs
| Name | Type | Required | Description |
|---|---|---|---|
status | "ok" | yes | |
action | "versions" | yes | |
compositionId | string | yes | |
latest | integer | null | yes | |
versions | object[] | yes | |
accepted | null | object | yes | The standing acceptance (the last one in accepted.json), or null when no version was accepted. |
durationMs | number | yes |
A real call
Recorded by this site's tools run, step design-versions, with the published OODS Foundry
0.11.0.
Its input:
{
"compositionId": "cmp-c49f93626dd7"
}Its result:
{
"status": "ok",
"action": "versions",
"compositionId": "cmp-c49f93626dd7",
"latest": 1,
"versions": [
{
"version": 1,
"parentVersion": null,
"operation": "compose",
"createdAt": "2026-10-09T05:48:46.621Z",
"schemaHash": "sha256:934f0ddf15a7b59cca66d7d70992ab750ecb457ef3f9b22d1879057e58c4d79d",
"head": "74da4ff4cee8b8cb6857e24195f8ec3d1a63f130",
"artifacts": []
}
],
"accepted": null,
"durationMs": 0.5983340000000226
}