@deepraxis/sdk 0.1.1-dev.d412c99 → 0.1.1-dev.d73d5e4

package/dist/operations.generated.js

@@ -7001,13 +7001,19 @@ export const operations = [
         "resource": "browser.contexts",
         "method": "list",
         "summary": "列出浏览器上下文",
-        "description": "分页列出当前账户保存的登录态，按登录态 ID 升序排列。每项返回名称、标签及保存内容的统计信息；将 nextCursor 原样传入读取下一页，直到其为 null。",
+        "description": "分页列出当前账户保存的登录态，按登录态 ID 升序排列。每项返回名称、标签及保存内容的统计信息；将 nextCursor 原样传入读取下一页，直到其为 null。传 name 时只返回该名称的登录态；名称在当前账户内唯一，所以最多一条。",
         "http": "GET",
         "path": "/browser/v1/contexts",
         "streaming": "no",
         "pagination": false,
         "pathParams": [],
         "query": [
+            {
+                "name": "name",
+                "type": "string",
+                "required": false,
+                "description": "按登录态名称精确匹配；名称在当前账户内唯一，所以最多返回一条。省略时列出全部登录态。"
+            },
             {
                 "name": "cursor",
                 "type": "string",
@@ -7360,6 +7366,28 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "browser.sessions.actions",
+        "method": "create",
+        "summary": "执行页面动作",
+        "description": "在会话的浏览器里执行一个页面动作并返回结果，由浏览器服务执行，客户端不需要 Playwright。同一会话的动作按到达顺序串行执行，单个动作 30 秒内完成。先用 snapshot 读取页面：元素带 [ref=eN]，click、fill 按 ref 操作；ref 只在最近一次快照里有效，页面跳转后失效（409 ACTION_REF_STALE，重新 snapshot）。省略 tab 时作用于当前标签页。",
+        "http": "POST",
+        "path": "/browser/v1/sessions/{sessionId}/actions",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "sessionId",
+                "sdkName": "sessionId",
+                "description": "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。"
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": []
+        }
+    },
     {
         "resource": "browser.sessions",
         "method": "retrieveDebug",
@@ -9856,7 +9884,7 @@ export const operations = [
         "resource": "cut.projects.analysis",
         "method": "create",
         "summary": "Analyze project media or measure the project mix",
-        "description": "Request silence, filler-word or scene analysis for selected bound assets before editing, or measure the mix the timeline itself renders with kind mix. That kind is a render job, not a read: it answers pending with retry_after_sec and is polled by the id it returned, because the answer only exists once the audio has been rendered and measured. Omit media to select project sources; ranges returned in segments use source seconds. A pending result is not completion: use retry_after_sec before checking again, and inspect failed or unsupported asset results before deciding which edits are possible. Silence measures transcript-based speech pauses, not music or loudness. A completed transcript without words returns ready with empty segments and reason no_speech; no completed transcript returns unsupported with reason no_transcript. A failed transcription remains failed. kind mix is separate: it reports the project mix loudness, the loudness of each role and where music masks speech, so an editor can fix the mix rather than guess at it.",
+        "description": "Request silence, filler-word, scene or beat analysis for selected bound assets before editing, or measure the mix the timeline itself renders with kind mix. That kind is a render job, not a read: it answers pending with retry_after_sec and an id. Poll by calling this same method again with body { kinds: [\"mix\"], id } (there is no separate retrieve method); that call reads the measurement and renders nothing. The answer only exists once the audio has been rendered and measured. Omit media to select project sources; ranges returned in segments use source seconds. A pending result is not completion: use retry_after_sec before checking again, and inspect failed or unsupported asset results before deciding which edits are possible. Silence measures transcript-based speech pauses, not music or loudness. A completed transcript without words returns ready with empty segments and reason no_speech; no completed transcript returns unsupported with reason no_transcript. A failed transcription remains failed. kind mix is separate: it reports the project mix loudness, the loudness of each role and where music masks speech, so an editor can fix the mix rather than guess at it.",
         "http": "POST",
         "path": "/cut/v1/projects/{project_id}/analysis",
         "streaming": "no",
@@ -9887,10 +9915,11 @@ export const operations = [
                         "silence",
                         "filler",
                         "scenes",
+                        "beats",
                         "mix"
                     ],
                     "required": true,
-                    "description": "Analysis types to request. silence, filler and scenes analyze the selected source assets and are read from the media library; mix measures the project's own rendered mix and is requested on its own."
+                    "description": "Analysis types to request. silence, filler, scenes and beats analyze the selected source assets and are read from the media library; mix measures the project's own rendered mix and is requested on its own."
                 },
                 {
                     "name": "from",
@@ -10367,7 +10396,7 @@ export const operations = [
         "resource": "cut.projects",
         "method": "execute",
         "summary": "Execute editing script",
-        "description": "Edit the current timeline atomically using synchronous JavaScript source. Read state or timeline first, then pass its revision as expected_revision to detect concurrent changes. Unlike Shotstack, execute applies script edits to a persistent project in one transaction. Provide script or a saved edit_id with literal edits, never both; failures roll back writes. A revision conflict while preparing the response may follow a committed edit: retrieve state before retrying. Minimal script after creating a project: `const t = AddTrack(\"video\"); Insert(t, {type: \"color\", color: \"#123456\", start: 0, length: 3}); Print(t);`\n\n<!-- cut-reference:start -->\n### Script function, field and error reference\n\nEvery script function, clip field and error code has its own section, read one at a time:\n\n```\ncodemode.describe(\"praxis.cut.script.<Name>\")  // one function: signature, arguments, return, errors, example\ncodemode.describe(\"praxis.cut.fields.<name>\")  // one field: type, unit, range, default, where writable\ncodemode.describe(\"praxis.cut.errors.<CODE>\")  // one code: meaning, causes, fix\ncodemode.describe(\"praxis.cut.script\")         // names, one page at a time\n```\n\nPublished at https://docs.deepraxis.com/docs/developers/cut/script-reference with one anchor per entry. Names below omit the `praxis.cut.<kind>.` prefix.\n\n#### Script functions (script)\n\n- `GetTimeline` — Duration, tracks, joins; clips are under `items`.\n- `GetItem` — One clip's compact view, by id.\n- `FindItems` — Visit every clip with its track; collect results.\n- `GetMedia` — Media metadata; `durationUs` is microseconds.\n- `GetTranscript` — Transcript words in source microseconds.\n- `GetAnalysis` — Silence, filler or scene segments.\n- `ListTransitions` — Join transition kinds and parameters.\n- `ListEffects` — Visual-effect catalog and parameters.\n- `ListAnimations` — Animation presets by phase and target.\n- `ListFonts` — Font families, weights and scripts.\n- `ListTextStyles` — Text style presets for `style.preset`.\n- `ListTextTemplates` — Multi-layer templates and their slots.\n- `Insert` — Add a clip; a track never overlaps itself.\n- `Append` — Add a clip at the end of a track.\n- `Update` — Change named fields; the rest stay.\n- `SetSpeed` — Change rate, keeping source or duration.\n- `Delete` — Remove a clip. There is no `Remove`.\n- `Join` — Overlap clips; followers shift, track shortens.\n- `UpdateJoin` — Change a join's length or effect.\n- `DeleteJoin` — Remove a join; restore the butt cut.\n- `Split` — Cut a clip in two at a time.\n- `Trim` — Move one clip edge by seconds.\n- `Move` — Set a clip's start or track.\n- `RippleDeleteRange` — Cut a time range and close the gap.\n- `AddTrack` — Add a video, audio or caption track.\n- `UpdateTrack` — Change a track's name, lock, gain or role.\n- `DeleteTrack` — Remove a track and its clips.\n- `SetSettings` — Change canvas, frame rate or background.\n- `AddCaptionsFromTranscript` — Captions from a clip's kept words.\n- `InsertTemplate` — Insert a template and fill its slots.\n- `AlignCaptions` — Rebuild captions from text punctuation.\n- `ImportCaptions` — Import SRT or WebVTT onto captions.\n- `ExportCaptions` — Export captions as SRT or WebVTT.\n- `SetMarker` — Label a timeline position.\n- `Print` — Append values to the result's `prints`.\n- `Preview` — Up to 8 frames as inline PNG data URLs.\n\n#### Fields (fields)\n\n- `type` — Clip kind; decides which fields apply.\n- `start` — Clip start in seconds; snaps to frames.\n- `length` — Duration; optional for video and audio.\n- `media` — Source `{ libraryId, assetId }`.\n- `sourceIn` — First source second kept; default 0.\n- `sourceOut` — Exclusive source end; read-only.\n- `text` — Text of a text or caption clip.\n- `color` — Solid colour of a color clip.\n- `shape` — Shape clip kind: `rect` or `ellipse`.\n- `width` — Shape width, a fraction of canvas width.\n- `height` — Shape height, a fraction of canvas height.\n- `radius` — Rect corner rounding, in 1080-height px.\n- `fill` — Shape or text paint: colour or gradient.\n- `stroke` — Shape outline: colour and width.\n- `transform` — Position, scale, rotation, opacity, crop, blur.\n- `fit` — contain, cover, fill or none.\n- `blend` — Layer blend mode; null clears.\n- `style` — Text styling: font, fill, strokes, glow, position.\n- `style.position` — top, middle or bottom; omit it, never null.\n- `playback` — Rate, direction, audio policy, or freeze.\n- `volumeDb` — Audio level in dB; 0 is source level.\n- `gain` — Keyframed audio level in dB.\n- `fadeIn` — Fade-in seconds at the clip's start.\n- `fadeOut` — Fade-out seconds at the clip's end.\n- `duck` — Lower this clip while another track plays.\n- `animate` — Transform keyframes; `at` is clip-relative seconds.\n- `reveal` — Per-character, word or line reveal timing.\n- `animation` — Preset slots `{ in, out, loop }`; null clears.\n- `effects` — Effect stack, at most 8; null clears.\n- `transitionIn` — Entrance effect: kind plus seconds.\n- `transitionOut` — Exit effect: kind plus seconds.\n- `mask` — Shape, path or track matte.\n- `words` — Caption words with clip-local times.\n\n#### Error codes (errors)\n\n- `JOIN_CONFLICT` — A join is invalid or blocks this edit.\n- `INVALID_TRANSITION` — Bad transition kind, parameter or length.\n- `INVALID_STYLE` — A style value is out of range.\n- `INVALID_MASK` — A mask definition is malformed.\n- `MASK_IN_USE` — The edit would break a live mask.\n- `TOO_MANY_MASKS` — At most 16 masks per project.\n- `RATE_OUT_OF_RANGE` — A rate is outside 0.25-4.\n- `UNSUPPORTED_PLAYBACK` — Reverse without an explicit mute.\n- `INVALID_PLAYBACK` — A playback object is partial or malformed.\n- `UNKNOWN_FONT` — The family is not in `ListFonts()`.\n- `UNKNOWN_FIELD` — The field name is not accepted here.\n- `UNKNOWN_TEXT_STYLE` — `style.preset` is not in the catalog.\n- `TEXT_STYLE_TARGET_MISMATCH` — Preset on the wrong clip type.\n- `CAPTION_ALIGN_LOW_CONFIDENCE` — Alignment confidence too low; nothing changed.\n- `OVERLAP` — Two clips on one track would share time.\n- `OUT_OF_SOURCE` — The clip would read past its source.\n- `LOCKED_TRACK` — The edit targets a locked track.\n- `UNBOUND_LIBRARY` — The library is not bound to the project.\n- `TRACK_KIND_MISMATCH` — The clip type does not fit the track.\n- `NOT_FOUND` — The named id is not in this project.\n- `TOO_SHORT` — The result would be under one frame.\n- `INVALID_DUCK` — Bad `duck` level or a missing track.\n- `UNKNOWN_ANIMATION` — The preset is not in `ListAnimations()`.\n- `INVALID_ANIMATION_PARAM` — Bad slot, parameter or keyframe limit.\n- `ANIMATION_TOO_LONG` — In plus out exceed the clip length.\n- `ANIMATION_TARGET_MISMATCH` — The preset does not match the clip type.\n- `ANIMATION_PHASE_MISMATCH` — The preset is in the wrong slot.\n- `UNKNOWN_EFFECT` — The effect is not in `ListEffects()`.\n- `INVALID_EFFECT_PARAM` — Bad effect parameter or keyframe.\n- `TOO_MANY_EFFECTS` — More than 8 effects on one clip.\n- `PROJECT_NOT_FOUND` — No visible project has this id.\n- `EXPORT_NOT_FOUND` — No such export in this project.\n- `DRAFT_RENDER_NOT_FOUND` — No such draft render.\n- `VERSION_NOT_FOUND` — No saved version has this revision.\n- `LIBRARY_NOT_FOUND` — The library is missing or invisible.\n- `BINDING_INVALID` — The binding request is malformed.\n- `BINDING_IN_USE` — Clips still use this library's assets.\n- `NOTHING_TO_UNDO` — No earlier revision to return to.\n- `NOTHING_TO_REDO` — No undone revision is waiting.\n- `UNDO_CONFLICT` — The revision to undo is no longer head.\n- `REVISION_CONFLICT` — The project moved; your revision is stale.\n- `CUT_BUSY` — The project is busy; retry.\n- `INVALID_CAPTION_FILE` — The subtitle file is malformed or too big.\n- `SCRIPT_ERROR` — The script threw or did not parse.\n- `SCRIPT_LIMIT` — An execute budget was exceeded.\n- `OPS_REJECTED` — An op failed; the whole edit rolled back.\n- `EDIT_EXPIRED` — The saved edit id is over ten minutes old.\n- `MEDIA_OFFLINE` — The asset cannot be fetched right now.\n- `MEDIA_UNAVAILABLE` — The asset is not usable for rendering.\n- `MEDIA_IMPORT_FAILED` — Importing media failed.\n- `FRAME_OUT_OF_RANGE` — The preview time is outside the project.\n- `PROJECT_TOO_LARGE` — The project exceeds the size limit.\n- `RESPONSE_TOO_LARGE` — The response would exceed its budget.\n- `EXPORT_FAILED` — The render failed; read `error.cause`.\n- `INVALID_PARAMS` — The request is malformed.\n- `PERMISSION_DENIED` — This credential may not do that here.\n- `NOT_IMPLEMENTED` — Not available on this platform yet.\n- `INTERNAL` — Unexpected failure; retry with the request id.\n<!-- cut-reference:end -->\n",
+        "description": "Edit the current timeline atomically using synchronous JavaScript source. Read state or timeline first, then pass its revision as expected_revision to detect concurrent changes. Unlike Shotstack, execute applies script edits to a persistent project in one transaction. Provide script or a saved edit_id with literal edits, never both; failures roll back writes. A revision conflict while preparing the response may follow a committed edit: retrieve state before retrying. Minimal script after creating a project: `const t = AddTrack(\"video\"); Insert(t, {type: \"color\", color: \"#123456\", start: 0, length: 3}); Print(t);`\n\n<!-- cut-reference:start -->\n### Script function, field and error reference\n\nEvery script function, clip field and error code has its own section, read one at a time:\n\n```\ncodemode.describe(\"praxis.cut.script.<Name>\")  // one function: signature, arguments, return, errors, example\ncodemode.describe(\"praxis.cut.fields.<name>\")  // one field: type, unit, range, default, where writable\ncodemode.describe(\"praxis.cut.errors.<CODE>\")  // one code: meaning, causes, fix\ncodemode.describe(\"praxis.cut.script\")         // names, one page at a time\n```\n\nPublished at https://docs.deepraxis.com/docs/developers/cut/script-reference with one anchor per entry. Names below omit the `praxis.cut.<kind>.` prefix.\n\n#### Script functions (script)\n\n- `GetTimeline` — Duration, tracks, joins; clips are under `items`.\n- `GetItem` — One clip's compact view, by id.\n- `FindItems` — Visit every clip with its track; collect results.\n- `GetMedia` — Media metadata; `duration` is seconds.\n- `GetTranscript` — Transcript words in source microseconds.\n- `GetAnalysis` — Silence, filler, scene or beat segments.\n- `ListTransitions` — Join transition kinds and parameters.\n- `ListEffects` — Visual-effect catalog and parameters.\n- `ListAnimations` — Animation presets by phase and target.\n- `ListFonts` — Font families, weights and scripts.\n- `ListTextStyles` — Text style presets for `style.preset`.\n- `ListTextTemplates` — Multi-layer templates and their slots.\n- `Insert` — Add a clip; a track never overlaps itself.\n- `Append` — Add a clip at the end of a track.\n- `Update` — Change named fields; the rest stay.\n- `SetSpeed` — Change rate, keeping source or duration.\n- `Delete` — Remove a clip. There is no `Remove`.\n- `Join` — Overlap clips; followers shift, track shortens.\n- `UpdateJoin` — Change a join's length or effect.\n- `DeleteJoin` — Remove a join; restore the butt cut.\n- `Split` — Cut a clip in two at a time.\n- `Trim` — Move one clip edge by seconds.\n- `Move` — Set a clip's start or track.\n- `RippleDeleteRange` — Cut a time range and close the gap.\n- `AddTrack` — Add a video, audio or caption track.\n- `UpdateTrack` — Change a track's name, lock, gain or role.\n- `DeleteTrack` — Remove a track and its clips.\n- `SetSettings` — Change canvas, frame rate or background.\n- `AddCaptionsFromTranscript` — Captions from a clip's kept words.\n- `InsertTemplate` — Insert a template and fill its slots.\n- `AlignCaptions` — Rebuild captions from text punctuation.\n- `ImportCaptions` — Import SRT or WebVTT onto captions.\n- `ExportCaptions` — Export captions as SRT or WebVTT.\n- `SetMarker` — Label a timeline position.\n- `Print` — Append values to the result's `prints`.\n- `Preview` — Up to 8 frames as inline PNG data URLs.\n\n#### Fields (fields)\n\n- `type` — Clip kind; decides which fields apply.\n- `start` — Clip start in seconds; snaps to frames.\n- `length` — Duration; video and audio may omit it or write \"auto\".\n- `media` — Source `{ libraryId, assetId }`.\n- `sourceIn` — First source second kept; default 0.\n- `sourceOut` — Exclusive source end; read-only.\n- `text` — Text of a text or caption clip.\n- `color` — Solid colour of a color clip.\n- `shape` — Shape clip kind: `rect` or `ellipse`.\n- `width` — Shape width, a fraction of canvas width.\n- `height` — Shape height, a fraction of canvas height.\n- `radius` — Rect corner rounding, in 1080-height px.\n- `fill` — Shape or text paint: colour or gradient.\n- `stroke` — Shape outline: colour and width.\n- `transform` — Position, scale, rotation, opacity, crop, blur.\n- `fit` — contain, cover, fill or none.\n- `blend` — Layer blend mode; null clears.\n- `style` — Text styling: font, fill, strokes, glow, position.\n- `style.position` — top, middle or bottom; omit it, never null.\n- `playback` — Rate, direction, audio policy, or freeze.\n- `volumeDb` — Audio level in dB; 0 is source level.\n- `gain` — Keyframed audio level in dB.\n- `fadeIn` — Fade-in seconds at the clip's start.\n- `fadeOut` — Fade-out seconds at the clip's end.\n- `duck` — Lower this clip while another track plays.\n- `animate` — Transform keyframes; `at` is clip-relative seconds.\n- `reveal` — Per-character, word or line reveal timing.\n- `animation` — Preset slots `{ in, out, loop }`; null clears.\n- `effects` — Effect stack, at most 8; null clears.\n- `transitionIn` — Entrance effect: kind plus seconds.\n- `transitionOut` — Exit effect: kind plus seconds.\n- `mask` — Shape, path or track matte.\n- `words` — Caption words with clip-local times.\n\n#### Error codes (errors)\n\n- `JOIN_CONFLICT` — A join is invalid or blocks this edit.\n- `INVALID_TRANSITION` — Bad transition kind, parameter or length.\n- `INVALID_STYLE` — A style value is out of range.\n- `INVALID_MASK` — A mask definition is malformed.\n- `MASK_IN_USE` — The edit would break a live mask.\n- `TOO_MANY_MASKS` — At most 16 masks per project.\n- `RATE_OUT_OF_RANGE` — A rate is outside 0.25-4.\n- `UNSUPPORTED_PLAYBACK` — Reverse without an explicit mute.\n- `INVALID_PLAYBACK` — A playback object is partial or malformed.\n- `UNKNOWN_FONT` — The family is not in `ListFonts()`.\n- `UNKNOWN_FIELD` — The field name is not accepted here.\n- `UNKNOWN_TEXT_STYLE` — `style.preset` is not in the catalog.\n- `TEXT_STYLE_TARGET_MISMATCH` — Preset on the wrong clip type.\n- `CAPTION_ALIGN_LOW_CONFIDENCE` — Alignment confidence too low; nothing changed.\n- `OVERLAP` — Two clips on one track would share time.\n- `OUT_OF_SOURCE` — The clip would read past its source.\n- `LOCKED_TRACK` — The edit targets a locked track.\n- `UNBOUND_LIBRARY` — The library is not bound to the project.\n- `TRACK_KIND_MISMATCH` — The clip type does not fit the track.\n- `NOT_FOUND` — The named id is not in this project.\n- `TOO_SHORT` — The result would be under one frame.\n- `INVALID_DUCK` — Bad `duck` level or a missing track.\n- `UNKNOWN_ANIMATION` — The preset is not in `ListAnimations()`.\n- `INVALID_ANIMATION_PARAM` — Bad slot, parameter or keyframe limit.\n- `ANIMATION_TOO_LONG` — In plus out exceed the clip length.\n- `ANIMATION_TARGET_MISMATCH` — The preset does not match the clip type.\n- `ANIMATION_PHASE_MISMATCH` — The preset is in the wrong slot.\n- `UNKNOWN_EFFECT` — The effect is not in `ListEffects()`.\n- `INVALID_EFFECT_PARAM` — Bad effect parameter or keyframe.\n- `TOO_MANY_EFFECTS` — More than 8 effects on one clip.\n- `PROJECT_NOT_FOUND` — No visible project has this id.\n- `EXPORT_NOT_FOUND` — No such export in this project.\n- `DRAFT_RENDER_NOT_FOUND` — No such draft render.\n- `VERSION_NOT_FOUND` — No saved version has this revision.\n- `LIBRARY_NOT_FOUND` — The library is missing or invisible.\n- `BINDING_INVALID` — The binding request is malformed.\n- `BINDING_IN_USE` — Clips still use this library's assets.\n- `NOTHING_TO_UNDO` — No earlier revision to return to.\n- `NOTHING_TO_REDO` — No undone revision is waiting.\n- `UNDO_CONFLICT` — The revision to undo is no longer head.\n- `REVISION_CONFLICT` — The project moved; your revision is stale.\n- `CUT_BUSY` — The project is busy; retry.\n- `INVALID_CAPTION_FILE` — The subtitle file is malformed or too big.\n- `SCRIPT_ERROR` — The script threw or did not parse.\n- `SCRIPT_LIMIT` — An execute budget was exceeded.\n- `OPS_REJECTED` — An op failed; the whole edit rolled back.\n- `EDIT_EXPIRED` — The saved edit id is over ten minutes old.\n- `MEDIA_NOT_FOUND` — The asset id is not in that library.\n- `MEDIA_OFFLINE` — The asset cannot be fetched right now.\n- `MEDIA_UNAVAILABLE` — The asset is not usable for rendering.\n- `MEDIA_IMPORT_FAILED` — Importing media failed.\n- `FRAME_OUT_OF_RANGE` — The preview time is outside the project.\n- `PROJECT_TOO_LARGE` — The project exceeds the size limit.\n- `RESPONSE_TOO_LARGE` — The response would exceed its budget.\n- `EXPORT_FAILED` — The render failed; read `error.cause`.\n- `INVALID_PARAMS` — The request is malformed.\n- `PERMISSION_DENIED` — This credential may not do that here.\n- `NOT_IMPLEMENTED` — Not available on this platform yet.\n- `INTERNAL` — Unexpected failure; retry with the request id.\n<!-- cut-reference:end -->\n",
         "http": "POST",
         "path": "/cut/v1/projects/{project_id}:execute",
         "streaming": "no",
@@ -20059,6 +20088,2121 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "studio.codexes",
+        "method": "list",
+        "summary": "List the reference libraries of this organization",
+        "description": "List the reference libraries this API key organization owns, each with how many entries it holds, so you can choose the one a work draws on. Continue with next_page_token until the answer stops carrying one. A library is shared across works, so the list is the whole organization's rather than one work's.",
+        "http": "GET",
+        "path": "/studio/v1/codexes",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.codexes",
+        "method": "create",
+        "summary": "Create a reference library",
+        "description": "Create a reference library: a shared store of the people, places, products and facts a piece draws on, reusable across works. Attach it to a work with the work update call, and the entries it holds then reach the context packs of that work's units. A library is not private to one work, so the same brand facts can serve every piece that mentions them.",
+        "http": "POST",
+        "path": "/studio/v1/codexes",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Name of the new library, written so a person can tell it apart from the organization's other libraries."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "What this library is for; it is shown wherever the library is chosen and reaches nobody's context pack by itself."
+                },
+                {
+                    "name": "labels",
+                    "type": "object",
+                    "required": false,
+                    "description": "Caller-chosen key and value pairs kept on a resource; the keys are the caller's own names and no platform meaning is attached to them."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.codexes",
+        "method": "delete",
+        "summary": "Delete a reference library",
+        "description": "Delete a library and every entry inside it. A library attached to any work is refused with CODEX_IN_USE, because deleting it would silently strip the reference material those units draw on; detach it from the work first. This cannot be undone, so confirm which library the identifier names.",
+        "http": "DELETE",
+        "path": "/studio/v1/codexes/{codex}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.codexes",
+        "method": "retrieve",
+        "summary": "Read one reference library",
+        "description": "Read one reference library: its name, its description, its labels and how many entries it holds. Read this to confirm a library exists before attaching it to a work; the entries themselves are listed with the entry list call, because a library may hold more of them than fit in one answer.",
+        "http": "GET",
+        "path": "/studio/v1/codexes/{codex}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.codexes",
+        "method": "update",
+        "summary": "Rename a reference library or change its description",
+        "description": "Change the library itself: its name, its description or its labels. Send update_mask naming exactly the fields you change; a field left out keeps its value. The entries inside are untouched, and a work that has the library attached keeps it attached under the new name.",
+        "http": "PATCH",
+        "path": "/studio/v1/codexes/{codex}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, such as name, description or labels; a field left out keeps its value."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": false,
+                    "description": "New name of the library, replacing the previous one when name is named in the update mask."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "New description of what the library is for; it replaces the previous description rather than appending to it."
+                },
+                {
+                    "name": "labels",
+                    "type": "object",
+                    "required": false,
+                    "description": "Caller-chosen key and value pairs kept on a resource; the keys are the caller's own names and no platform meaning is attached to them."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.codexes.entries",
+        "method": "list",
+        "summary": "List the entries of a reference library",
+        "description": "List the entries of one library in pages, each with its type, its name, its aliases and whether it is always present in context. Use it to see what a work already knows before adding an entry, since a duplicate name is refused rather than merged. Continue with next_page_token until the answer stops carrying one.",
+        "http": "GET",
+        "path": "/studio/v1/codexes/{codex}/entries",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            }
+        ],
+        "query": [
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.codexes.entries",
+        "method": "create",
+        "summary": "Add an entry to a reference library",
+        "description": "Add one entry: a character, a place, a product, a source of facts. Give it the type the genre uses, the name the text will mention, and the description and facts that should reach a writer when it is mentioned. Aliases and excluded phrases keep detection honest, so a common word inside an idiom is not mistaken for the entry. A name already used in the library is refused.",
+        "http": "POST",
+        "path": "/studio/v1/codexes/{codex}/entries",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "type",
+                    "type": "string",
+                    "enum": [
+                        "character",
+                        "location",
+                        "item",
+                        "lore",
+                        "event",
+                        "source",
+                        "fact",
+                        "reference",
+                        "product",
+                        "audience",
+                        "brand",
+                        "persona",
+                        "footage"
+                    ],
+                    "required": true,
+                    "description": "What kind of thing this entry is, from the types the genre's libraries carry."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Name as the text will mention it; it must be unique inside this library after normalization, and it is what a unit claims when it links this entry."
+                },
+                {
+                    "name": "aliases",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Other spellings the text may use, each matched like the name; use them instead of adding a second entry for the same thing."
+                },
+                {
+                    "name": "case_sensitive",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Whether matching distinguishes letter case; leave it false unless the name collides with an ordinary word in another case."
+                },
+                {
+                    "name": "exclude_phrases",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Phrases in which this name must not count as a mention, such as a longer idiom containing it."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "What a writer should know, in the words the piece should be able to use; this text reaches the context pack."
+                },
+                {
+                    "name": "facts",
+                    "type": "object",
+                    "required": false,
+                    "description": "Fact ledger entries for this entry, keyed by the caller's own names; they reach the context pack and are compared for consistency."
+                },
+                {
+                    "name": "notes",
+                    "type": "string",
+                    "required": false,
+                    "description": "Notes for people only, which never reach a writer's context pack."
+                },
+                {
+                    "name": "tracking",
+                    "type": "string",
+                    "enum": [
+                        "always",
+                        "when_mentioned",
+                        "never"
+                    ],
+                    "required": false,
+                    "description": "When this entry reaches a context pack; when_mentioned is the default and keeps the pack small."
+                },
+                {
+                    "name": "relations",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": false,
+                    "description": "Entries this one relates to at creation, each naming the target and the label that reads from this entry to it."
+                },
+                {
+                    "name": "images",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Images to attach, referenced by file identifiers that belong to this organization."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.codexes.entries",
+        "method": "delete",
+        "summary": "Delete a reference entry",
+        "description": "Delete one entry from a library, which also removes the mentions and the links that pointed at it. Units that claimed it keep their text; only the reference goes away. This cannot be undone, so confirm the name of the entry before deleting it, and prefer changing its tracking setting to never when it should stop reaching writers but stay recorded.",
+        "http": "DELETE",
+        "path": "/studio/v1/codexes/{codex}/entries/{entry}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            },
+            {
+                "name": "entry",
+                "sdkName": "entry",
+                "description": "Entry being addressed, by its name inside this library or by its ent_ identifier; a name containing a slash is passed by identifier instead."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.codexes.entries",
+        "method": "retrieve",
+        "summary": "Read one reference entry",
+        "description": "Read one entry in full: its description, its fact ledger, its relations to other entries, its detection settings and its images. Read it before changing it, because an update replaces the fields it names rather than merging them. The entry is addressed by its name in this library, or by its ent_ identifier.",
+        "http": "GET",
+        "path": "/studio/v1/codexes/{codex}/entries/{entry}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            },
+            {
+                "name": "entry",
+                "sdkName": "entry",
+                "description": "Entry being addressed, by its name inside this library or by its ent_ identifier; a name containing a slash is passed by identifier instead."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.codexes.entries",
+        "method": "update",
+        "summary": "Change what a reference entry says",
+        "description": "Change one entry: its type, its name, its aliases, its description, its facts, its notes, its tracking setting, its images or its relations. Send update_mask naming exactly the fields you change, because a field the mask leaves out keeps its value while a list field the mask names is replaced whole. Renaming an entry changes what the text has to mention for detection to find it.",
+        "http": "PATCH",
+        "path": "/studio/v1/codexes/{codex}/entries/{entry}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "codex",
+                "sdkName": "codex",
+                "description": "Reference library being addressed, given by its cdx_ identifier; a library has no name-based address, so read the library list first when only the name is known."
+            },
+            {
+                "name": "entry",
+                "sdkName": "entry",
+                "description": "Entry being addressed, by its name inside this library or by its ent_ identifier; a name containing a slash is passed by identifier instead."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, such as name, description or facts.成立年份; a field left out keeps its value, and a list field named here is replaced whole."
+                },
+                {
+                    "name": "type",
+                    "type": "string",
+                    "enum": [
+                        "character",
+                        "location",
+                        "item",
+                        "lore",
+                        "event",
+                        "source",
+                        "fact",
+                        "reference",
+                        "product",
+                        "audience",
+                        "brand",
+                        "persona",
+                        "footage"
+                    ],
+                    "required": false,
+                    "description": "New kind for this entry, which changes how it is shown and how genres treat it."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": false,
+                    "description": "New name for this entry, which also changes what the text has to mention for detection to find it."
+                },
+                {
+                    "name": "aliases",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of aliases, replacing the previous ones."
+                },
+                {
+                    "name": "case_sensitive",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Whether matching distinguishes letter case."
+                },
+                {
+                    "name": "exclude_phrases",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of phrases in which this name must not count as a mention."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "New text a writer should know, replacing the previous description rather than appending to it."
+                },
+                {
+                    "name": "facts",
+                    "type": "object",
+                    "required": false,
+                    "description": "Complete fact ledger for this entry, replacing the previous one, so a fact removed here stops reaching writers."
+                },
+                {
+                    "name": "notes",
+                    "type": "string",
+                    "required": false,
+                    "description": "New notes for people only, which never reach a writer's context pack."
+                },
+                {
+                    "name": "tracking",
+                    "type": "string",
+                    "enum": [
+                        "always",
+                        "when_mentioned",
+                        "never"
+                    ],
+                    "required": false,
+                    "description": "When this entry reaches a context pack."
+                },
+                {
+                    "name": "relations",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": false,
+                    "description": "Complete relation set for this entry, replacing the previous one; leave it out to keep the relations as they are."
+                },
+                {
+                    "name": "images",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of images, replacing the previous ones."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.genres",
+        "method": "list",
+        "summary": "List the genres Studio can write",
+        "description": "List the genre catalog so you can choose how a piece is structured before creating a draft. Each genre names its unit kinds, draft properties, deterministic checks and writing rules, and by default only the genres open today are returned. Read the chosen genre in full with studioGenresGet before the first write, because its kinds and limits decide what that draft accepts.",
+        "http": "GET",
+        "path": "/studio/v1/genres",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "include_unavailable",
+                "type": "boolean",
+                "required": false,
+                "description": "Set to true to also list genres that are catalogued but not open yet; their available_from field says which delivery stage opens them. Leave it false to see only the genres a draft can be created with today."
+            }
+        ]
+    },
+    {
+        "resource": "studio.genres",
+        "method": "retrieve",
+        "summary": "Read one genre with its built-in templates",
+        "description": "Read the full rules of one genre: its unit kinds and what each may contain, the draft properties with their limits, the deterministic checks the software runs, the semantic review list, and the built-in templates that can seed a draft. Ask for this before creating a draft of that genre, and again when a write is refused for an unknown kind, a property limit or a block type the genre does not allow.",
+        "http": "GET",
+        "path": "/studio/v1/genres/{genre}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "genre",
+                "sdkName": "genre",
+                "description": "Genre key from the genre list, such as novel_long or xiaohongshu_note; pass the key exactly, never the display name."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.platforms",
+        "method": "list",
+        "summary": "List the platforms a work can be produced for",
+        "description": "List rendition targets with the format each needs, whether it receives a finished piece through an API, a draft box or an export, and the hard limits a piece must respect. Pass a genre to see only the platforms that genre produces by default. Read one platform in full before rendering, because its limits decide whether the rendition validates.",
+        "http": "GET",
+        "path": "/studio/v1/platforms",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "genre",
+                "type": "string",
+                "required": false,
+                "description": "A genre key from the genre list; when given, only the platforms that genre produces by default are returned. Omit it to list every platform open today."
+            }
+        ]
+    },
+    {
+        "resource": "studio.platforms",
+        "method": "retrieve",
+        "summary": "Read the rules of one platform",
+        "description": "Read one platform in full: the format it consumes, how it receives a finished piece, the preview fidelity the Console can offer, the limits on title, body, image count and aspect, and whether a connected channel is required. Read this before creating a rendition, and again when validation reports that the piece breaks a platform limit.",
+        "http": "GET",
+        "path": "/studio/v1/platforms/{platform}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "platform",
+                "sdkName": "platform",
+                "description": "Versioned platform key from the platform list, such as x@1 or xiaohongshu@1; the version suffix is part of the key."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.styles",
+        "method": "list",
+        "summary": "List the writing styles of this organization",
+        "description": "List the styles this API key organization owns, each with its name and description, so you can choose the voice a work should be written in. Continue with next_page_token until the answer stops carrying one. Read one style in full before attaching it, because its samples are what actually shape the writing.",
+        "http": "GET",
+        "path": "/studio/v1/styles",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.styles",
+        "method": "create",
+        "summary": "Create a writing style",
+        "description": "Create a style: the voice a piece is written in, held as samples rather than as adjectives. Samples matter more than a description, so paste one to five paragraphs of writing the piece should sound like, and put the words to avoid into avoid so the banned-word check uses them. Attach a style to a work, or to one draft of it, and its samples then reach every context pack.",
+        "http": "POST",
+        "path": "/studio/v1/styles",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Name of the style, written so a person can tell it apart from the organization's other styles."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "Short description of the voice, shown wherever a style is chosen."
+                },
+                {
+                    "name": "samples",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "One to five paragraphs of writing in the intended voice; these paragraphs are what reach a writer, so choose them carefully."
+                },
+                {
+                    "name": "use",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Wording and habits to keep, stated as instructions a writer can follow rather than as adjectives."
+                },
+                {
+                    "name": "avoid",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Words and stock phrases to avoid, which also become the banned-word check for drafts that use this style."
+                },
+                {
+                    "name": "glossary",
+                    "type": "object",
+                    "required": false,
+                    "description": "Terms mapped from a wrong spelling to the right one; each pair becomes a deterministic check on the text."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.styles",
+        "method": "delete",
+        "summary": "Delete a writing style",
+        "description": "Delete a style, which detaches it from every work and draft that used it; those units then stop receiving its samples and glossary in their context packs. This cannot be undone, so confirm the style identifier before deleting it, and read the work first when it is not certain which style it uses.",
+        "http": "DELETE",
+        "path": "/studio/v1/styles/{style}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "style",
+                "sdkName": "style",
+                "description": "Style being addressed, by its sty_ identifier; a style has no name-based address, so read the style list first when only the name is known."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.styles",
+        "method": "retrieve",
+        "summary": "Read one writing style",
+        "description": "Read one style in full: its samples, the wording to use and to avoid, and its glossary of wrong-to-right terms. Read it before attaching it to a work, since samples decide the sound of the writing far more than the description does, and a glossary term also becomes a deterministic check against the text.",
+        "http": "GET",
+        "path": "/studio/v1/styles/{style}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "style",
+                "sdkName": "style",
+                "description": "Style being addressed, by its sty_ identifier; a style has no name-based address, so read the style list first when only the name is known."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.styles",
+        "method": "update",
+        "summary": "Change a writing style",
+        "description": "Change a style: its name, its description, its samples, its use and avoid lists, or its glossary. Send update_mask naming exactly the fields you change; a list the mask names is replaced whole. Adding a term to the glossary or to avoid also changes what the deterministic checks flag, so a work that uses this style sees new findings on its next check.",
+        "http": "PATCH",
+        "path": "/studio/v1/styles/{style}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "style",
+                "sdkName": "style",
+                "description": "Style being addressed, by its sty_ identifier; a style has no name-based address, so read the style list first when only the name is known."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, such as description, samples or avoid; a list named here is replaced whole and a field left out keeps its value."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": false,
+                    "description": "New name of the style, replacing the previous one when name is named in the update mask."
+                },
+                {
+                    "name": "description",
+                    "type": "string",
+                    "required": false,
+                    "description": "New description of the voice, replacing the previous one."
+                },
+                {
+                    "name": "samples",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of sample paragraphs, replacing the previous ones; removing a sample removes it from every later context pack."
+                },
+                {
+                    "name": "use",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of wording and habits to keep, replacing the previous ones."
+                },
+                {
+                    "name": "avoid",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of words and phrases to avoid, replacing the previous ones and with them the banned-word check."
+                },
+                {
+                    "name": "glossary",
+                    "type": "object",
+                    "required": false,
+                    "description": "Complete glossary, replacing the previous one; a pair removed here stops being checked."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.templates",
+        "method": "list",
+        "summary": "List the templates a genre can start from",
+        "description": "List templates: the built-in starting structures of each genre, followed by the ones this organization saved. Pass a genre to see only the templates that genre can use. A template is used once when a draft is created and is then detached, so changing a template never rewrites a draft that already started from it.",
+        "http": "GET",
+        "path": "/studio/v1/templates",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "genre",
+                "type": "string",
+                "required": false,
+                "description": "Genre key to filter by; when given, only the built-in and saved templates of that genre are returned. Omit it to list every genre's templates together."
+            },
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.templates",
+        "method": "create",
+        "summary": "Save a starting structure as a template",
+        "description": "Save a unit tree as a reusable template for one genre, so the same structure can seed later drafts. Give the genre, a name, the outline of units with their intents, and optionally the writing guidance a writer should follow. Creating a template from an existing draft is a separate milestone and answers NOT_IMPLEMENTED, so build the outline here instead.",
+        "http": "POST",
+        "path": "/studio/v1/templates",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "genre",
+                    "type": "string",
+                    "required": true,
+                    "description": "Genre the template belongs to; a draft of another genre cannot use it."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Name of the template, shown where a draft chooses its starting structure."
+                },
+                {
+                    "name": "guide",
+                    "type": "string",
+                    "required": false,
+                    "description": "Writing guidance that reaches the first context pack of a draft created from this template."
+                },
+                {
+                    "name": "outline",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": true,
+                    "description": "Unit tree the template creates, in draft order, with children nested inside their parent."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.templates",
+        "method": "delete",
+        "summary": "Delete a saved template",
+        "description": "Delete a template this organization saved. A built-in template belongs to the catalog and cannot be deleted, so this answers TEMPLATE_NOT_FOUND for one. Drafts that already started from the template are unaffected, because the template was detached when they were created. This cannot be undone.",
+        "http": "DELETE",
+        "path": "/studio/v1/templates/{template}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "template",
+                "sdkName": "template",
+                "description": "Template being addressed: a saved one by its tmpl_ identifier, or a built-in one by its key, optionally prefixed with its genre as in novel_long:three_act when several genres share the key."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.templates",
+        "method": "retrieve",
+        "summary": "Read one template",
+        "description": "Read one template: its genre, the writing guidance it carries and the unit outline it seeds, with each unit's intent. Address a saved template by its identifier and a built-in one by its key, alone or with its genre prefix such as novel_long:three_act when two genres share a key. Read it before creating a draft from it, because the template decides the structure the draft starts with.",
+        "http": "GET",
+        "path": "/studio/v1/templates/{template}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "template",
+                "sdkName": "template",
+                "description": "Template being addressed: a saved one by its tmpl_ identifier, or a built-in one by its key, optionally prefixed with its genre as in novel_long:three_act when several genres share the key."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.themes",
+        "method": "list",
+        "summary": "List the rendition themes of a platform",
+        "description": "List themes: the layouts a rendition is produced with, for one platform or for all of them. Pass a platform to see only the themes that platform can use. A theme decides the page or card a rendition is built into, so read the chosen theme before creating a rendition rather than after the output looks wrong.",
+        "http": "GET",
+        "path": "/studio/v1/themes",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "platform",
+                "type": "string",
+                "required": false,
+                "description": "Versioned platform key to filter by, such as wechat_mp@1; when given, only themes for that platform are returned. Omit it to list every platform's themes together."
+            },
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.themes",
+        "method": "create",
+        "summary": "Create a rendition theme",
+        "description": "Create a theme for one platform: the HTML and CSS a written piece is rendered into, plus the fixed header and footer every rendition carries. A DOCX platform takes a reference document instead of markup, and a card theme takes its aspect, width and fonts. An agent may write a theme here, which is how a new layout appears without a release.",
+        "http": "POST",
+        "path": "/studio/v1/themes",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "platform",
+                    "type": "string",
+                    "required": true,
+                    "description": "Versioned platform key this theme renders for, taken from the platform list."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Name of the theme, shown wherever a rendition chooses its layout."
+                },
+                {
+                    "name": "html",
+                    "type": "string",
+                    "required": false,
+                    "description": "HTML template with a small mustache-like subset over the title, the units and the pages; give it for a markup platform."
+                },
+                {
+                    "name": "css",
+                    "type": "string",
+                    "required": false,
+                    "description": "Stylesheet applied to the markup, folded inline for a platform that requires inline styles."
+                },
+                {
+                    "name": "reference_docx",
+                    "type": "string",
+                    "required": false,
+                    "description": "Reference document giving a DOCX rendition its styles, by file identifier; give it instead of markup for a word-processor platform."
+                },
+                {
+                    "name": "header",
+                    "type": "string",
+                    "required": false,
+                    "description": "Fragment placed at the top of every rendition this theme produces."
+                },
+                {
+                    "name": "footer",
+                    "type": "string",
+                    "required": false,
+                    "description": "Fragment placed at the bottom of every rendition this theme produces."
+                },
+                {
+                    "name": "card",
+                    "type": "object",
+                    "required": false,
+                    "description": "How a card rendition is laid out: its proportions, its width and the fonts it expects."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.themes",
+        "method": "delete",
+        "summary": "Delete a rendition theme",
+        "description": "Delete a theme this organization created. A built-in theme belongs to the platform and cannot be deleted, so this answers THEME_NOT_FOUND for one. Renditions already produced with the theme keep their output, because the produced file no longer depends on the theme. This cannot be undone.",
+        "http": "DELETE",
+        "path": "/studio/v1/themes/{theme}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "theme",
+                "sdkName": "theme",
+                "description": "Theme being addressed: a saved one by its thm_ identifier, or a built-in one by its key; the identifier is what the theme list returns for an organization's own theme."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.themes",
+        "method": "retrieve",
+        "summary": "Read one rendition theme",
+        "description": "Read one theme in full: the HTML template and stylesheet it renders with, the header and footer it always carries, the reference document a DOCX rendition uses, or the card proportions a card rendition uses. Read it before creating a rendition with it, because a theme decides what the output looks like and a DOCX theme is a file rather than markup.",
+        "http": "GET",
+        "path": "/studio/v1/themes/{theme}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "theme",
+                "sdkName": "theme",
+                "description": "Theme being addressed: a saved one by its thm_ identifier, or a built-in one by its key; the identifier is what the theme list returns for an organization's own theme."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.themes",
+        "method": "update",
+        "summary": "Change a rendition theme",
+        "description": "Change a theme: its name, its markup, its stylesheet, or the fixed fragments around every rendition. Send update_mask naming exactly the fields you change. Changing a theme does not rewrite renditions already produced with an earlier version, because each rendition records the theme version it was built from.",
+        "http": "PATCH",
+        "path": "/studio/v1/themes/{theme}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "theme",
+                "sdkName": "theme",
+                "description": "Theme being addressed: a saved one by its thm_ identifier, or a built-in one by its key; the identifier is what the theme list returns for an organization's own theme."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, such as name, css or footer; a field left out keeps its value."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": false,
+                    "description": "New name of the theme, replacing the previous one when name is named in the update mask."
+                },
+                {
+                    "name": "html",
+                    "type": "string",
+                    "required": false,
+                    "description": "New HTML template, replacing the previous one for renditions produced after this change."
+                },
+                {
+                    "name": "css",
+                    "type": "string",
+                    "required": false,
+                    "description": "New stylesheet, replacing the previous one."
+                },
+                {
+                    "name": "reference_docx",
+                    "type": "string",
+                    "required": false,
+                    "description": "New reference document for a DOCX rendition, by file identifier; it replaces the previous one."
+                },
+                {
+                    "name": "header",
+                    "type": "string",
+                    "required": false,
+                    "description": "New top fragment, replacing the previous one."
+                },
+                {
+                    "name": "footer",
+                    "type": "string",
+                    "required": false,
+                    "description": "New bottom fragment, replacing the previous one."
+                },
+                {
+                    "name": "card",
+                    "type": "object",
+                    "required": false,
+                    "description": "How a card rendition is laid out: its proportions, its width and the fonts it expects."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works",
+        "method": "list",
+        "summary": "List the works of this organization",
+        "description": "List works owned by the API key organization so you can find the one being discussed, with its drafts and how long ago each moved. Archived works are left out unless you ask for them. Continue with next_page_token until the answer stops carrying one; the summaries carry no unit bodies, so read a work before writing in it.",
+        "http": "GET",
+        "path": "/studio/v1/works",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            },
+            {
+                "name": "archived",
+                "type": "boolean",
+                "required": false,
+                "description": "Set to true to list archived works instead of active ones; each page lists one of the two, never both."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works",
+        "method": "create",
+        "summary": "Create a work with its goal",
+        "description": "Create a work: one deliverable piece plus everything around it. Pass the goal the writing serves — the reader, what that reader should get or do, the one-sentence message and the constraints — and the original brief the person gave in their own words. A slug is derived from the title unless you pass one. The work starts with no drafts; create the first one with the drafts create call, because the genre decides the structure.",
+        "http": "POST",
+        "path": "/studio/v1/works",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "title",
+                    "type": "string",
+                    "required": true,
+                    "description": "Working title of the new work, used in lists and in the Console; it does not become any rendition title."
+                },
+                {
+                    "name": "slug",
+                    "type": "string",
+                    "required": false,
+                    "description": "Organization-unique name to address the work by; omit it and one is derived from the title."
+                },
+                {
+                    "name": "goal",
+                    "type": "object",
+                    "required": true,
+                    "description": "What this work is for: who reads it, what that reader should get or do, the one message it carries, and the limits it is written under."
+                },
+                {
+                    "name": "brief",
+                    "type": "object",
+                    "required": false,
+                    "description": "The original requirement as it arrives with a new work: the person's text, any attached source files, and the points split from it."
+                },
+                {
+                    "name": "codexes",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Reference libraries to attach at creation; a library owned by another organization is refused rather than attached."
+                },
+                {
+                    "name": "style",
+                    "type": "string",
+                    "required": false,
+                    "description": "Style to attach to the work, whose samples and glossary then reach every context pack unless a draft overrides it."
+                },
+                {
+                    "name": "labels",
+                    "type": "object",
+                    "required": false,
+                    "description": "Caller-chosen key and value pairs kept on a resource; the keys are the caller's own names and no platform meaning is attached to them."
+                },
+                {
+                    "name": "requestId",
+                    "type": "string",
+                    "required": false,
+                    "description": "Caller-chosen key that makes this create safe to repeat: the same value answers the first result instead of creating a second work."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works",
+        "method": "retrieve",
+        "summary": "Read a work, optionally with one draft and unit",
+        "description": "Read a work and, in the same answer, whatever part of it the page needs: pass draft to get that draft with its todos, its unit outline and its properties, and unit to get one unit with its blocks and Markdown body. This is the call that opens an editing session, because it answers the goal, the brief, the current revisions and the unit to write in one round trip.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": [
+            {
+                "name": "draft",
+                "type": "string",
+                "required": false,
+                "description": "Draft to include in the answer, either its in-work key such as novel or its drf_ identifier; when it is given, the answer also carries that draft's todos, outline and current unit."
+            },
+            {
+                "name": "unit",
+                "type": "string",
+                "required": false,
+                "description": "Unit to include in the answer, written as its in-work number without a hash, such as 12; it returns that unit with its blocks and Markdown body."
+            },
+            {
+                "name": "expand",
+                "type": "array",
+                "itemType": "string",
+                "enum": [
+                    "status",
+                    "drafts",
+                    "outline",
+                    "unit"
+                ],
+                "required": false,
+                "description": "Extra parts to include, comma separated: status for the draft todo list, drafts for the draft summaries, outline for the unit tree without bodies, and unit for the current unit with its body."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works",
+        "method": "update",
+        "summary": "Change the title, goal or attached libraries",
+        "description": "Change work-level settings: the title, the slug, the goal, the attached reference libraries, the style or the archived flag. Send update_mask naming exactly the fields you change; a field left out keeps its value. Pass expected_revision to have the write refused when someone else changed the work first, and note that changing the message makes every draft derived from it stale.",
+        "http": "PATCH",
+        "path": "/studio/v1/works/{work}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, spelled as they appear in the work, such as title or goal.message; a field left out keeps its value."
+                },
+                {
+                    "name": "expectedRevision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Work revision the caller read; when the work moved past it the write is refused with REVISION_CONFLICT and nothing changes."
+                },
+                {
+                    "name": "title",
+                    "type": "string",
+                    "required": false,
+                    "description": "New working title of the work, replacing the previous one when title is named in the update mask."
+                },
+                {
+                    "name": "slug",
+                    "type": "string",
+                    "required": false,
+                    "description": "New organization-unique name; the previous slug keeps resolving so existing links do not break."
+                },
+                {
+                    "name": "goal",
+                    "type": "object",
+                    "required": false,
+                    "description": "What this work is for: who reads it, what that reader should get or do, the one message it carries, and the limits it is written under."
+                },
+                {
+                    "name": "codexes",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of reference libraries to keep attached; a library left out is detached from the work."
+                },
+                {
+                    "name": "style",
+                    "type": "string",
+                    "required": false,
+                    "description": "Style to attach to the work, replacing the previous one; send an empty value to detach the style entirely."
+                },
+                {
+                    "name": "labels",
+                    "type": "object",
+                    "required": false,
+                    "description": "Caller-chosen key and value pairs kept on a resource; the keys are the caller's own names and no platform meaning is attached to them."
+                },
+                {
+                    "name": "archived",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Set to true to archive the work, which hides it from the default list without deleting anything."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works",
+        "method": "updateBrief",
+        "summary": "Add to or correct the original brief",
+        "description": "Extend the original brief: append text, attach files, add points taken from an outline, edit one point, or drop a point. Points are how the software checks that every requirement landed in a written unit, so split the person's outline into points here rather than burying them in prose. The brief carries its own revision, separate from the work and from each draft.",
+        "http": "PATCH",
+        "path": "/studio/v1/works/{work}/brief",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expectedRevision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged."
+                },
+                {
+                    "name": "text",
+                    "type": "string",
+                    "required": false,
+                    "description": "Text to append to the stored brief, added after what is already there and never replacing it."
+                },
+                {
+                    "name": "attachments",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Source files to keep with the brief, added to the ones already attached."
+                },
+                {
+                    "name": "addPoints",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "New requirement points to split out of the brief; each receives the next free key in order."
+                },
+                {
+                    "name": "editPoints",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": false,
+                    "description": "Existing points to reword, each naming the key it keeps and the text that replaces it."
+                },
+                {
+                    "name": "removePoints",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Keys of points to drop; a dropped key is never reused, so later points keep their own keys."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "list",
+        "summary": "List the drafts a work carries",
+        "description": "List every draft of one work, each with its genre, its size and whether it is out of date against what it was derived from. Use it to choose the draft a later call works in: the key beside each draft is what the draft path segment takes. This list is not paged, because a work carries a handful of drafts rather than thousands.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "create",
+        "summary": "Create a draft of a genre inside a work",
+        "description": "Create a draft: one way of delivering the work, written in one genre. The genre decides the unit kinds, the properties and the checks, so read it first with the genre call and pass its key. A template may seed the unit tree, an outline may be given instead, and derived_from records that this draft is built from the goal message or from another draft of the work. The work may hold several drafts, one per platform or per length.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "genre",
+                    "type": "string",
+                    "required": true,
+                    "description": "Genre key the draft is written in, taken from the genre list; it decides the unit kinds, the properties and the checks."
+                },
+                {
+                    "name": "title",
+                    "type": "string",
+                    "required": false,
+                    "description": "Page title of the new draft; omit it and one is derived from the genre and the work title."
+                },
+                {
+                    "name": "mode",
+                    "type": "string",
+                    "enum": [
+                        "skeleton",
+                        "space"
+                    ],
+                    "required": false,
+                    "description": "Structure mode to create the draft in; omit it and the genre default applies, which is skeleton for most genres."
+                },
+                {
+                    "name": "template",
+                    "type": "string",
+                    "required": false,
+                    "description": "Template to seed the unit tree from, by template identifier or built-in key; when an outline is also given, the outline wins because the person's own structure is authoritative."
+                },
+                {
+                    "name": "outline",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": false,
+                    "description": "Unit tree to create the draft with, given by the caller instead of a template; children nest, and a unit without a kind takes the genre default for its position."
+                },
+                {
+                    "name": "derivedFrom",
+                    "type": "object",
+                    "required": false,
+                    "description": "What the new draft should be derived from, so the service can record the source revision for later staleness checks."
+                },
+                {
+                    "name": "props",
+                    "type": "object",
+                    "required": false,
+                    "description": "Initial values for the genre properties, keyed by property key; a value the genre does not define is refused rather than stored."
+                },
+                {
+                    "name": "requestId",
+                    "type": "string",
+                    "required": false,
+                    "description": "Caller-chosen key that makes this create safe to repeat: the same value answers the first draft instead of creating a second one."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "retrieve",
+        "summary": "Read one draft with optional units and todos",
+        "description": "Read one draft: its genre, its properties, its revisions, whether it is stale, and optionally its unit tree and its todo list. Pass expand to add the parts you need in this one call instead of reading them separately. Read this before writing to the draft, because the revision it returns is the precondition the next write has to carry.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts/{draft}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [
+            {
+                "name": "expand",
+                "type": "array",
+                "itemType": "string",
+                "enum": [
+                    "units",
+                    "status"
+                ],
+                "required": false,
+                "description": "Extra parts to include, comma separated: units adds the unit tree without bodies, and status adds the computed todo list of this draft."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "update",
+        "summary": "Change a draft title, key, properties or style",
+        "description": "Change the draft itself rather than its units: its page title, its in-work key, its generic properties, the style that overrides the work style, or its mode. Send update_mask naming exactly the fields you change. Changing the key keeps the previous one resolving, so old links and old references still work; a key another draft of the work already uses answers DRAFT_KEY_TAKEN.",
+        "http": "PATCH",
+        "path": "/studio/v1/works/{work}/drafts/{draft}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "updateMask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes, such as title, key or props.topics; a field left out keeps its value."
+                },
+                {
+                    "name": "expectedRevision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Draft revision the caller read; a mismatch is refused with REVISION_CONFLICT and nothing changes. Omit it only for structure calls that genuinely do not depend on the current state."
+                },
+                {
+                    "name": "title",
+                    "type": "string",
+                    "required": false,
+                    "description": "New page title of the draft, replacing the previous one when title is named in the update mask."
+                },
+                {
+                    "name": "key",
+                    "type": "string",
+                    "required": false,
+                    "description": "New in-work key; the previous key keeps resolving so existing links and references do not break."
+                },
+                {
+                    "name": "props",
+                    "type": "object",
+                    "required": false,
+                    "description": "Property values to set, keyed by the genre property key; a property the genre does not define is refused."
+                },
+                {
+                    "name": "style",
+                    "type": "string",
+                    "required": false,
+                    "description": "Style to attach to this draft, overriding the work style; send an empty value to fall back to the work style."
+                },
+                {
+                    "name": "mode",
+                    "type": "string",
+                    "enum": [
+                        "skeleton",
+                        "space"
+                    ],
+                    "required": false,
+                    "description": "Structure mode to switch the draft to; switching away from skeleton does not delete units that already exist."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "retrieveExport",
+        "summary": "Export the draft as Markdown or plain text",
+        "description": "Read the whole draft as one document in Markdown or plain text, returned synchronously in the answer. This is the quick path for a person who wants the text now; a file in a platform format, a card image or a docx comes from creating a rendition instead. Ask for text rather than markdown when the reader should not see block anchors or heading syntax.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/export",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [
+            {
+                "name": "format",
+                "type": "string",
+                "enum": [
+                    "markdown",
+                    "text"
+                ],
+                "required": true,
+                "description": "Format to render the draft in: markdown keeps headings, list markers and block anchors, and text drops the markup entirely."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "retrieveOutline",
+        "summary": "Read the whole unit outline as Markdown",
+        "description": "Read the draft structure as one Markdown page: one line per unit carrying its number, structure name, intent, status, length and revision, followed by the unit list itself. Use it to plan a sequence of writes without reading every unit, since it carries no body text. Read one unit in full with the unit call once you know which one to write.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/outline",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "retrieveReview",
+        "summary": "Read a review pass over the whole draft",
+        "description": "Read everything a reviewer needs in one answer: the deterministic check results, the semantic review list the genre asks a reader to judge, the brief coverage showing which unit claims each requirement point, and the body text. When the draft is long the body is a synopsis with an excerpt around each unit and next_page_token carries the full text. This is the call an agent makes before writing review comments.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/review",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.drafts.status",
+        "method": "list",
+        "summary": "Read the computed todo list of a draft",
+        "description": "Read what is outstanding in one draft, computed from the data rather than from a plan: a unit without an intent, a body behind its intent, an unclaimed brief point, a failed check, a stale rendition. Each item names the layer it belongs to and suggests the call that resolves it. Follow the list instead of inventing an order, and re-read it after a batch of writes.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/status",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.drafts.units",
+        "method": "create",
+        "summary": "Add one unit to the draft tree",
+        "description": "Add a unit to the structure: a chapter, a scene, a section, an argument or a product depending on the genre. Say where it goes with parent and after, give it the structure name people will use to manage it, and write the intent that says what it has to accomplish. Adding a unit changes the draft revision, so pass expected_revision, and the new unit itself starts with no body.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/units",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "kind",
+                    "type": "string",
+                    "required": true,
+                    "description": "Structural kind of the new unit, which must be one the genre allows at that position of the tree."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": true,
+                    "description": "Structure name used to manage the tree, such as 场景 2 · 找上门; it is not the heading the finished piece shows."
+                },
+                {
+                    "name": "heading",
+                    "type": "string",
+                    "required": false,
+                    "description": "Heading the finished piece shows for this unit; leave it out when the genre wants the structure name kept out of the output."
+                },
+                {
+                    "name": "parent",
+                    "type": "string",
+                    "required": false,
+                    "description": "Unit this one should sit under, by number or identifier; null or omitted places it at the top level."
+                },
+                {
+                    "name": "after",
+                    "type": "string",
+                    "required": false,
+                    "description": "Sibling this one should follow, by number or identifier; null or omitted appends it at the end of its level."
+                },
+                {
+                    "name": "synopsis",
+                    "type": "string",
+                    "required": false,
+                    "description": "What this unit has to accomplish, written as the story so far for the units after it; a unit with a synopsis is outlined rather than merely planned."
+                },
+                {
+                    "name": "points",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Points this unit hits, called beats, arguments or selling points depending on the genre."
+                },
+                {
+                    "name": "brief_points",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Keys of the brief points this unit claims, which is how the coverage check follows each requirement to a unit."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts.units",
+        "method": "batchCreate",
+        "summary": "Add a whole outline of units at once",
+        "description": "Create many units in one write from a nested outline, which is how a structure is built after the person approved a plan. Nesting in the outline becomes the parent chain, numbers are assigned in order, and the draft gets one revision for the whole batch rather than one per unit. Sending the same outline twice would duplicate it, so pass the draft revision you read and repeat the call only after a refusal.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/units:batchCreate",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expected_revision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Draft revision the caller read; a mismatch is refused, which is what stops a repeated batch from duplicating a structure."
+                },
+                {
+                    "name": "parent",
+                    "type": "string",
+                    "required": false,
+                    "description": "Unit the whole outline should hang under, by number or identifier; null or omitted builds it at the top level."
+                },
+                {
+                    "name": "outline",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": true,
+                    "description": "Units to create in order, with children nested inside their parent; the nesting becomes the parent chain of the created units."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts.units",
+        "method": "batchUpdate",
+        "summary": "Write intents for many units in one call",
+        "description": "Change the intent of several units in one write: the synopsis, the points and the brief points each of them claims. Bodies are not part of this call, because a body is written one unit at a time with its own revision; here the whole batch shares the draft revision you read. Use it to lay out a plan across the tree, then write bodies one by one.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/units:batchUpdate",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expected_revision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Draft revision the caller read; a mismatch is refused, so a plan written from a stale outline cannot land."
+                },
+                {
+                    "name": "updates",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": true,
+                    "description": "Units to change, each naming the unit and the intent fields it takes; a body is never part of a batch, because bodies are written one unit at a time."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.drafts",
+        "method": "rebase",
+        "summary": "Confirm a draft already follows its source",
+        "description": "Clear the stale flag after checking that the draft still matches what it was derived from: the recorded source revision moves to the source current revision without touching any unit. Call it after the source moved and you have brought this draft up to date, not to make the flag disappear while the text is still behind. It answers the same shape as a draft write, and the draft revision does not move.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts/{draft}:rebase",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": false,
+            "fields": [
+                {
+                    "name": "expectedRevision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Draft revision the caller read; a mismatch is refused rather than confirming a draft that changed under the caller."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.units",
+        "method": "retrieve",
+        "summary": "Read one unit with its blocks and Markdown",
+        "description": "Read one unit: its intent, its status, its revision, its links to reference entries, and its body as both blocks and Markdown. The Markdown carries each block identifier inline as an anchor comment, so a rewrite can keep the identifiers of the blocks it keeps. Read this before writing the body, because the revision it returns is the precondition that write has to carry.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/units/{unit}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "unit",
+                "sdkName": "unit",
+                "description": "Unit being addressed, written as its in-work number such as 12, as #12, or as its unt_ identifier; the number never changes when the unit is moved."
+            }
+        ],
+        "query": [
+            {
+                "name": "view",
+                "type": "string",
+                "enum": [
+                    "full",
+                    "basic"
+                ],
+                "required": false,
+                "description": "How much of the unit to return: full includes the blocks and the Markdown body, and basic returns the unit row without the body for a cheap status check."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.units",
+        "method": "update",
+        "summary": "Change a unit intent, body or status",
+        "description": "Change one unit: its name, its heading, its synopsis and points, the brief points it claims, its status, its links to reference entries, or its body as a whole Markdown text. A body write requires expected_revision, because replacing the whole text would drop blocks someone else inserted. The answer carries the unit as it now stands, so read the next field of the answer instead of re-reading the unit.",
+        "http": "PATCH",
+        "path": "/studio/v1/works/{work}/units/{unit}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "unit",
+                "sdkName": "unit",
+                "description": "Unit being addressed, written as its in-work number such as 12, as #12, or as its unt_ identifier; the number never changes when the unit is moved."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expected_revision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Unit revision the caller read; required whenever body is sent, because replacing the whole text would discard blocks another writer inserted since."
+                },
+                {
+                    "name": "name",
+                    "type": "string",
+                    "required": false,
+                    "description": "New structure name of the unit, used by people and agents to manage the tree."
+                },
+                {
+                    "name": "heading",
+                    "type": "string",
+                    "required": false,
+                    "description": "New heading the finished piece shows; send an empty value to remove the heading entirely."
+                },
+                {
+                    "name": "synopsis",
+                    "type": "string",
+                    "required": false,
+                    "description": "New synopsis of what this unit has to accomplish; changing it advances the intent revision, which leaves any existing body behind it."
+                },
+                {
+                    "name": "points",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of points this unit hits, replacing the previous ones."
+                },
+                {
+                    "name": "brief_points",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": false,
+                    "description": "Complete set of brief point keys this unit claims, replacing the previous claims so coverage follows the latest intent."
+                },
+                {
+                    "name": "body",
+                    "type": "string",
+                    "required": false,
+                    "description": "Whole body as Markdown with block anchors kept inline; the blocks named by anchors keep their identifiers, and paragraphs without an anchor become new blocks."
+                },
+                {
+                    "name": "synopsis_from_body",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Set to true together with body to record that the synopsis now describes what the text actually says rather than what was planned."
+                },
+                {
+                    "name": "status",
+                    "type": "string",
+                    "enum": [
+                        "idea",
+                        "outlined",
+                        "writing",
+                        "drafted",
+                        "revised",
+                        "final"
+                    ],
+                    "required": false,
+                    "description": "Unit status to set; moving to final declares the unit done, and changing it afterwards needs the confirmation flag."
+                },
+                {
+                    "name": "links",
+                    "type": "object",
+                    "required": false,
+                    "description": "Reference entries to tie to a unit or untie from it, beyond the mentions detected in its text."
+                },
+                {
+                    "name": "seconds",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Duration of this unit in seconds for a video genre, which its length checks measure; send null to clear it."
+                },
+                {
+                    "name": "confirm_final_edit",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Confirmation that a unit marked final may change; send it only when the person themselves asked for the change, never to make a refusal go away."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.units.blocks",
+        "method": "patch",
+        "summary": "Edit a unit body block by block",
+        "description": "Change a body by naming the blocks to insert, replace or delete instead of resending the whole text. This is the safe way for a writer that only touches part of a unit, because a block another writer changed after your revision is refused rather than overwritten. The revision is required, and the answer carries the unit with its blocks so the next edit can address them.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/units/{unit}/blocks:patch",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "unit",
+                "sdkName": "unit",
+                "description": "Unit being addressed, written as its in-work number such as 12, as #12, or as its unt_ identifier; the number never changes when the unit is moved."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expected_revision",
+                    "type": "integer",
+                    "required": true,
+                    "description": "Unit revision the caller read; it is required, and when a block this call touches changed after it the whole call is refused rather than applied partially."
+                },
+                {
+                    "name": "ops",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": true,
+                    "description": "Operations in the order they apply; each one addresses existing blocks by identifier, so an order that deletes before replacing what it deleted is refused."
+                },
+                {
+                    "name": "confirm_final_edit",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Confirmation that a unit marked final may change; send it only when the person themselves asked for the change."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.units",
+        "method": "retrieveContext",
+        "summary": "Read the context pack for writing one unit",
+        "description": "Read everything a writer needs before touching one unit: the genre rules, the goal, the brief, the style, the upstream source, the reference entries this unit draws on, the synopses of the units before it, and the intent of this unit, assembled in a fixed order and measured against a token budget. Entries left out say why, so a missing detail is visible rather than silent. Same input gives the same pack, which is what makes a written result reproducible.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/units/{unit}/context",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "unit",
+                "sdkName": "unit",
+                "description": "Unit being addressed, written as its in-work number such as 12, as #12, or as its unt_ identifier; the number never changes when the unit is moved."
+            }
+        ],
+        "query": [
+            {
+                "name": "budget_tokens",
+                "type": "integer",
+                "required": false,
+                "description": "Token budget the pack must fit into; the reference and previous sections are cut to fit it while the genre, brief and unit sections always arrive whole. Omit it to use the service default."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.units",
+        "method": "move",
+        "summary": "Move a unit to another place in the tree",
+        "description": "Move a unit under another parent or after another sibling, without changing its number, its identifier, its intent or its body. A move that would put a unit inside its own descendant, or that would cross into another draft, is refused. Only the moved unit changes, so the revision to pass is its own.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/units/{unit}:move",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "unit",
+                "sdkName": "unit",
+                "description": "Unit being addressed, written as its in-work number such as 12, as #12, or as its unt_ identifier; the number never changes when the unit is moved."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "expected_revision",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Unit revision the caller read; a mismatch is refused so a move never lands on a unit someone else just changed."
+                },
+                {
+                    "name": "parent",
+                    "type": "string",
+                    "required": false,
+                    "description": "Unit to move this one under, by number or identifier; null or omitted moves it to the top level."
+                },
+                {
+                    "name": "after",
+                    "type": "string",
+                    "required": false,
+                    "description": "Sibling to place this unit after, by number or identifier; null or omitted puts it first among its new siblings."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works",
+        "method": "resolve",
+        "summary": "Resolve a loose reference to a work, draft or unit",
+        "description": "Turn a loose reference into the address the other calls take: a slug, a work title, a draft key or a unit number, as a person or another tool would say it. A hit answers the work slug and, when the reference pointed deeper, the draft key and unit number; a miss answers an empty resolved value with up to three near matches instead of failing. Use it when a person names something instead of an id.",
+        "http": "GET",
+        "path": "/studio/v1/works:resolve",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [
+            {
+                "name": "ref",
+                "type": "string",
+                "required": true,
+                "description": "What the caller said, such as a work slug, a work title, a draft key with a unit number like novel#12, or a title with a typo; it is matched loosely and never has to be an identifier."
+            }
+        ]
+    },
     {
         "resource": "ticket.activity",
         "method": "retrieve",