@deepraxis/sdk 0.1.1-dev.da8587f → 0.1.1-dev.daf2585

package/dist/operations.generated.d.ts

@@ -5670,13 +5670,18 @@ export declare const operations: readonly [{
     readonly resource: "browser.contexts";
     readonly method: "list";
     readonly summary: "列出浏览器上下文";
-    readonly description: "分页列出当前账户保存的登录态，按登录态 ID 升序排列。每项返回名称、标签及保存内容的统计信息；将 nextCursor 原样传入读取下一页，直到其为 null。";
+    readonly description: "分页列出当前账户保存的登录态，按登录态 ID 升序排列。每项返回名称、标签及保存内容的统计信息；将 nextCursor 原样传入读取下一页，直到其为 null。传 name 时只返回该名称的登录态；名称在当前账户内唯一，所以最多一条。";
     readonly http: "GET";
     readonly path: "/browser/v1/contexts";
     readonly streaming: "no";
     readonly pagination: false;
     readonly pathParams: readonly [];
     readonly query: readonly [{
+        readonly name: "name";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "按登录态名称精确匹配；名称在当前账户内唯一，所以最多返回一条。省略时列出全部登录态。";
+    }, {
         readonly name: "cursor";
         readonly type: "string";
         readonly required: false;
@@ -5963,6 +5968,25 @@ export declare const operations: readonly [{
             readonly description: "会话操作指令；REQUEST_RELEASE 表示请求关闭浏览器并结束会话。";
         }];
     };
+}, {
+    readonly resource: "browser.sessions.actions";
+    readonly method: "create";
+    readonly summary: "执行页面动作";
+    readonly description: "在会话的浏览器里执行一个页面动作并返回结果，由浏览器服务执行，客户端不需要 Playwright。同一会话的动作按到达顺序串行执行，单个动作 30 秒内完成。先用 snapshot 读取页面：元素带 [ref=eN]，click、fill 按 ref 操作；ref 只在最近一次快照里有效，页面跳转后失效（409 ACTION_REF_STALE，重新 snapshot）。省略 tab 时作用于当前标签页。";
+    readonly http: "POST";
+    readonly path: "/browser/v1/sessions/{sessionId}/actions";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "sessionId";
+        readonly sdkName: "sessionId";
+        readonly description: "浏览器会话 ID；使用创建或列出会话返回的 id，以 bss_ 开头。";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [];
+    };
 }, {
     readonly resource: "browser.sessions";
     readonly method: "retrieveDebug";
@@ -7958,8 +7982,8 @@ export declare const operations: readonly [{
 }, {
     readonly resource: "cut.projects.analysis";
     readonly method: "create";
-    readonly summary: "Analyze project media";
-    readonly description: "Request silence, filler-word or scene analysis for selected bound assets before editing. 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.";
+    readonly summary: "Analyze project media or measure the project mix";
+    readonly 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.";
     readonly http: "POST";
     readonly path: "/cut/v1/projects/{project_id}/analysis";
     readonly streaming: "no";
@@ -7982,9 +8006,29 @@ export declare const operations: readonly [{
             readonly name: "kinds";
             readonly type: "array";
             readonly itemType: "string";
-            readonly enum: readonly ["silence", "filler", "scenes"];
+            readonly enum: readonly ["silence", "filler", "scenes", "beats", "mix"];
             readonly required: true;
-            readonly description: "Analysis types to request for the selected source assets.";
+            readonly 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.";
+        }, {
+            readonly name: "from";
+            readonly type: "number";
+            readonly required: false;
+            readonly description: "Range start for kind mix, in seconds on the project clock. Omitted with to, the whole timeline is measured, capped at 120 seconds. Ignored by the asset kinds.";
+        }, {
+            readonly name: "to";
+            readonly type: "number";
+            readonly required: false;
+            readonly description: "Range end for kind mix, in seconds on the project clock, exclusive. An end up to 0.05 s past the timeline's end (a rounded duration) is read as the end; further past is refused. A range longer than 120 seconds is refused; request several ranges instead.";
+        }, {
+            readonly name: "revision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Optional committed project revision to measure; omission uses the current revision. Mix only.";
+        }, {
+            readonly name: "id";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Poll one running mix measurement by the id its first call returned. Sending id reads that measurement and renders nothing.";
         }];
     };
 }, {
@@ -8101,7 +8145,7 @@ export declare const operations: readonly [{
             readonly name: "folder";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Optional destination path within the bound media library; omitted uses its default folder.";
+            readonly description: "Optional destination path within the bound media library; omitted uses its default folder. Naming a binding or a folder also imports the finished video into that media library as an asset. Omit both and the export is a file only: read file.url to download it.";
         }, {
             readonly name: "name";
             readonly type: "string";
@@ -8116,7 +8160,7 @@ export declare const operations: readonly [{
             readonly name: "binding";
             readonly type: "string";
             readonly required: false;
-            readonly description: "Writable binding name used as the export destination; omission uses default_upload.";
+            readonly description: "Writable binding name used as the export destination; omission uses default_upload. Naming a binding or a folder also imports the finished video into that media library as an asset. Omit both and the export is a file only; read file.url to download it.";
         }, {
             readonly name: "revision";
             readonly type: "integer";
@@ -8127,6 +8171,11 @@ export declare const operations: readonly [{
             readonly type: "object";
             readonly required: false;
             readonly description: "Loudness normalization target. Omitted, the export is normalized to -14 LUFS integrated and -1 dBTP true peak, the level short-video and streaming platforms play at; null renders without normalization. Normalization adds analysis and rendering work.";
+        }, {
+            readonly name: "poster";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Cover frame, in seconds on the project clock. Omitted, the cover is the first frame with picture that is not inside a fade-in or a transition — a black opening no longer makes the library thumbnail black. A frame inside a transition is skipped, and a timeline that is black throughout keeps its first frame (reported as BLACK_FIRST_FRAME). The frame actually used is reported as poster_at on the export.";
         }];
     };
 }, {
@@ -8197,7 +8246,7 @@ export declare const operations: readonly [{
     readonly resource: "cut.projects.renders";
     readonly method: "create";
     readonly summary: "Create draft range render";
-    readonly description: "Render one interval of the timeline so you can hear or look at how that passage comes out, without publishing anything to a media library. Choose kind audio for the mixed soundtrack as an .m4a file, or kind video for a draft-quality .mp4 with picture and sound. from and to are seconds on the project clock and must satisfy 0 <= from < to, to <= the timeline duration, and to - from <= 120; a longer passage is requested in several 分段请求 ranges and joined by the caller. The result is a temporary file (purpose user_data) that expires 24 hours after it is stored and is never imported into a library, so it is not a deliverable and carries no cut-export tag. HTTP 202 only accepts the job; poll praxis.cut.renders.retrieve using the returned id until status is done or failed, then read url while it lasts. A draft also bills like a draft export, by rendered seconds. Each project runs at most 2 draft renders at a time, a budget separate from its exports; a third answers HTTP 429 CUT_BUSY and the same call succeeds once one finishes.";
+    readonly description: "Render one interval of the timeline so you can hear or look at how that passage comes out, without publishing anything to a media library. Choose kind audio for the mixed soundtrack as an .m4a file, or kind video for a draft-quality .mp4 with picture and sound. from and to are seconds on the project clock and must satisfy 0 <= from < to, to <= the timeline duration (an end up to 0.05 s past it, a rounded duration, is read as the end), and to - from <= 120; a longer passage is requested in several 分段请求 ranges and joined by the caller. The result is a temporary file (purpose user_data) that expires 24 hours after it is stored and is never imported into a library, so it is not a deliverable and carries no cut-export tag. HTTP 202 only accepts the job; poll praxis.cut.renders.retrieve using the returned id until status is done or failed, then read url while it lasts. A draft also bills like a draft export, by rendered seconds. Each project runs at most 2 draft renders at a time, a budget separate from its exports; a third answers HTTP 429 CUT_BUSY and the same call succeeds once one finishes.";
     readonly http: "POST";
     readonly path: "/cut/v1/projects/{project_id}/renders";
     readonly streaming: "no";
@@ -8347,7 +8396,7 @@ export declare const operations: readonly [{
     readonly resource: "cut.projects";
     readonly method: "execute";
     readonly summary: "Execute editing script";
-    readonly 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- `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";
+    readonly 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";
     readonly http: "POST";
     readonly path: "/cut/v1/projects/{project_id}:execute";
     readonly streaming: "no";
@@ -9367,7 +9416,7 @@ export declare const operations: readonly [{
     readonly resource: "devops.projects.testReports";
     readonly method: "create";
     readonly summary: "Upload an external test report";
-    readonly description: "Record the results of a run executed outside Praxis by uploading a CTRF or JUnit report. The report is folded into the run named by ref and the run's counts and verdict are recomputed from it. Uploading the same reportId again is idempotent and counts once, so a retry after a timeout is safe; a different reportId for the same run adds its results. Pass the run you created with executor external — a report for a run that does not exist is NOT_FOUND, never silently recorded against another run.";
+    readonly description: "Record the results of a run executed outside Praxis by uploading a CTRF or JUnit report. Nothing has to exist first: a first upload from CI creates the run it reports on (executor external) and catalogues the cases the report names, so there is no setup call before the first result. When the report already belongs to a run, pass ref and the upload joins it; the run's counts and verdict are recomputed from the report. Uploading the same reportId again is idempotent and counts once, so a retry after a timeout is safe — and a reported case is catalogued once, however many reports carry it. The report's bytes are kept as a file (the file field of the answer) rather than in the results database, so the original document stays retrievable.";
     readonly http: "POST";
     readonly path: "/devops/v1/projects/{project}/test-reports";
     readonly streaming: "no";
@@ -9442,7 +9491,7 @@ export declare const operations: readonly [{
     readonly resource: "devops.projects.testRuns";
     readonly method: "create";
     readonly summary: "Create a test run";
-    readonly description: "Start a run of the project's tests at one commit. Name a plan to use its selector, or pass a selector directly for this run alone; the ref says which commit to test and is required, because a run without a commit has nothing to report against. waitUntil decides how far the call waits before answering — queued returns as soon as the run exists, finished waits for a verdict and may take minutes. A retry of an earlier run is a new run: pass its commit and selector, and read the earlier run to compare.";
+    readonly description: "Start a run of the project's tests at one commit. Name a plan to use its selector, or pass a selector directly for this run alone; the ref says which commit to test and is required, because a run without a commit has nothing to report against. waitUntil decides how far the call waits before answering — queued, the default, returns as soon as the run exists; started waits until the run has begun, except for an external run, which is answered at once because it leaves queued only when your own CI uploads; finished waits for a verdict. The wait is bounded at about 25 seconds, and a wait that reaches that bound returns the run as it stands rather than failing — read state to see whether it finished. A retry of an earlier run is a new run: pass its commit and selector, and read the earlier run to compare.";
     readonly http: "POST";
     readonly path: "/devops/v1/projects/{project}/test-runs";
     readonly streaming: "no";
@@ -9485,7 +9534,18 @@ export declare const operations: readonly [{
             readonly type: "string";
             readonly enum: readonly ["queued", "started", "finished"];
             readonly required: false;
-            readonly description: "How far the call waits before answering — queued returns at once, started waits for execution to begin, finished waits for a verdict and may take minutes.";
+            readonly description: "How far the call waits before answering, bounded at about 25 seconds; omit it for queued, which returns at once. The wait reads the run's own state, so a wait that reaches the bound returns the run as it stands instead of failing — check state before assuming the request was honoured.";
+        }, {
+            readonly name: "executor";
+            readonly type: "string";
+            readonly enum: readonly ["cloud", "external"];
+            readonly required: false;
+            readonly description: "Who carries the run out. cloud, the default, runs the selected cases in Praxis at the commit; external creates a run that waits for your own CI to upload a report with test-reports.";
+        }, {
+            readonly name: "requestId";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "A key you choose to make creating this run idempotent: repeating the call with the same requestId returns the run it created instead of starting another, so a retry after a timeout is safe.";
         }];
     };
 }, {
@@ -9706,6 +9766,11 @@ export declare const operations: readonly [{
         readonly type: "string";
         readonly required: false;
         readonly description: "The cursor from the previous page's nextPageToken. Treat it as opaque and never build one yourself; omit it for the first page.";
+    }, {
+        readonly name: "filter";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "AIP-160 equality filter over one declared field, for example result=failed to read only a run's failures. Fields an execution list does not declare are refused with INVALID_ARGUMENT rather than ignored.";
     }, {
         readonly name: "orderBy";
         readonly type: "string";
@@ -13908,6 +13973,47 @@ export declare const operations: readonly [{
             readonly description: "Node id that should survive, from nodes.list or search; the merged node's relations and aliases move to it.";
         }];
     };
+}, {
+    readonly resource: "ontology.nodes";
+    readonly method: "retrieveNeighborhood";
+    readonly summary: "Retrieve neighborhood";
+    readonly description: "Load the subgraph around one node instead of the whole graph — the read to use when a screen or an agent needs the context of one entity. Returns the start node, every node within depth hops of it, the relations whose both ends are in that set, and truncated true when the node limit cut the walk short. direction chooses which way relations are followed; as_of and include_invalid read the graph as those parameters do elsewhere. Visibility is exactly nodes.retrieve's — a node you may reach but not read comes back restricted with its name only, and relations touching it are withheld, so this read never reaches further than a node read does. The node id comes from nodes.list, nodes.create or a changeset; an unknown one answers ONTOLOGY_NODE_NOT_FOUND, the same answer nodes.retrieve gives.";
+    readonly http: "GET";
+    readonly path: "/ontology/v1/nodes/{node_id}/neighborhood";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "node_id";
+        readonly sdkName: "node_id";
+        readonly description: "Node id returned by nodes.list, nodes.create or a changeset, in the form ond_ followed by 32 lowercase letters or digits; a name or an external record id is not accepted.";
+    }];
+    readonly query: readonly [{
+        readonly name: "depth";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "How many hops from the given node to walk, 1 to 3; defaults to 1. A value outside that range is refused 400 rather than clamped, so the answer is never a smaller graph than the one asked for.";
+    }, {
+        readonly name: "limit";
+        readonly type: "integer";
+        readonly required: false;
+        readonly description: "Maximum nodes to return, 1 to 500; defaults to 200. When the walk reaches this many nodes it stops and reports truncated true, so treat a truncated answer as a sample of the neighborhood rather than all of it. This bound is not the list routes' page size, and there is no cursor to resume from.";
+    }, {
+        readonly name: "direction";
+        readonly type: "string";
+        readonly enum: readonly ["out", "in", "both"];
+        readonly required: false;
+        readonly description: "Which way to follow relations from each node walked; out follows relations the node is the source of, in follows those it is the target of, both follows either. Defaults to both. Relations between two returned nodes are included whichever direction brought the second node in.";
+    }, {
+        readonly name: "as_of";
+        readonly type: "string";
+        readonly required: false;
+        readonly description: "ISO 8601 timestamp; walk the graph as it was then — a node recorded later is absent and a relation invalidated since still counts. Omit to read current state.";
+    }, {
+        readonly name: "include_invalid";
+        readonly type: "boolean";
+        readonly required: false;
+        readonly description: "Set true to walk relations whose invalid_at has passed, which is how a fact that stopped being true stays reachable. Omit or false to walk currently valid relations only.";
+    }];
 }, {
     readonly resource: "ontology.relations";
     readonly method: "list";
@@ -15982,6 +16088,1718 @@ export declare const operations: readonly [{
             readonly description: "Whether to filter out adult or unsafe content from results. Not supported for `fast` or `ultra-fast` search depths.";
         }];
     };
+}, {
+    readonly resource: "studio.codexes";
+    readonly method: "list";
+    readonly summary: "List the reference libraries of this organization";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/codexes";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.codexes";
+    readonly method: "create";
+    readonly summary: "Create a reference library";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/codexes";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Name of the new library, written so a person can tell it apart from the organization's other libraries.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "What this library is for; it is shown wherever the library is chosen and reaches nobody's context pack by itself.";
+        }, {
+            readonly name: "labels";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }];
+    };
+}, {
+    readonly resource: "studio.codexes";
+    readonly method: "delete";
+    readonly summary: "Delete a reference library";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/codexes/{codex}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.codexes";
+    readonly method: "retrieve";
+    readonly summary: "Read one reference library";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/codexes/{codex}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.codexes";
+    readonly method: "update";
+    readonly summary: "Rename a reference library or change its description";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/codexes/{codex}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "Field paths this call changes, such as name, description or labels; a field left out keeps its value.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New name of the library, replacing the previous one when name is named in the update mask.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New description of what the library is for; it replaces the previous description rather than appending to it.";
+        }, {
+            readonly name: "labels";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }];
+    };
+}, {
+    readonly resource: "studio.codexes.entries";
+    readonly method: "list";
+    readonly summary: "List the entries of a reference library";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/codexes/{codex}/entries";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.codexes.entries";
+    readonly method: "create";
+    readonly summary: "Add an entry to a reference library";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/codexes/{codex}/entries";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "type";
+            readonly type: "string";
+            readonly enum: readonly ["character", "location", "item", "lore", "event", "source", "fact", "reference", "product", "audience", "brand", "persona", "footage"];
+            readonly required: true;
+            readonly description: "What kind of thing this entry is, from the types the genre's libraries carry.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "aliases";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Other spellings the text may use, each matched like the name; use them instead of adding a second entry for the same thing.";
+        }, {
+            readonly name: "case_sensitive";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Whether matching distinguishes letter case; leave it false unless the name collides with an ordinary word in another case.";
+        }, {
+            readonly name: "exclude_phrases";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Phrases in which this name must not count as a mention, such as a longer idiom containing it.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "What a writer should know, in the words the piece should be able to use; this text reaches the context pack.";
+        }, {
+            readonly name: "facts";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Fact ledger entries for this entry, keyed by the caller's own names; they reach the context pack and are compared for consistency.";
+        }, {
+            readonly name: "notes";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Notes for people only, which never reach a writer's context pack.";
+        }, {
+            readonly name: "tracking";
+            readonly type: "string";
+            readonly enum: readonly ["always", "when_mentioned", "never"];
+            readonly required: false;
+            readonly description: "When this entry reaches a context pack; when_mentioned is the default and keeps the pack small.";
+        }, {
+            readonly name: "relations";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Entries this one relates to at creation, each naming the target and the label that reads from this entry to it.";
+        }, {
+            readonly name: "images";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Images to attach, referenced by file identifiers that belong to this organization.";
+        }];
+    };
+}, {
+    readonly resource: "studio.codexes.entries";
+    readonly method: "delete";
+    readonly summary: "Delete a reference entry";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/codexes/{codex}/entries/{entry}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }, {
+        readonly name: "entry";
+        readonly sdkName: "entry";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.codexes.entries";
+    readonly method: "retrieve";
+    readonly summary: "Read one reference entry";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/codexes/{codex}/entries/{entry}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }, {
+        readonly name: "entry";
+        readonly sdkName: "entry";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.codexes.entries";
+    readonly method: "update";
+    readonly summary: "Change what a reference entry says";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/codexes/{codex}/entries/{entry}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "codex";
+        readonly sdkName: "codex";
+        readonly 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.";
+    }, {
+        readonly name: "entry";
+        readonly sdkName: "entry";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "type";
+            readonly type: "string";
+            readonly enum: readonly ["character", "location", "item", "lore", "event", "source", "fact", "reference", "product", "audience", "brand", "persona", "footage"];
+            readonly required: false;
+            readonly description: "New kind for this entry, which changes how it is shown and how genres treat it.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New name for this entry, which also changes what the text has to mention for detection to find it.";
+        }, {
+            readonly name: "aliases";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of aliases, replacing the previous ones.";
+        }, {
+            readonly name: "case_sensitive";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Whether matching distinguishes letter case.";
+        }, {
+            readonly name: "exclude_phrases";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of phrases in which this name must not count as a mention.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New text a writer should know, replacing the previous description rather than appending to it.";
+        }, {
+            readonly name: "facts";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Complete fact ledger for this entry, replacing the previous one, so a fact removed here stops reaching writers.";
+        }, {
+            readonly name: "notes";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New notes for people only, which never reach a writer's context pack.";
+        }, {
+            readonly name: "tracking";
+            readonly type: "string";
+            readonly enum: readonly ["always", "when_mentioned", "never"];
+            readonly required: false;
+            readonly description: "When this entry reaches a context pack.";
+        }, {
+            readonly name: "relations";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Complete relation set for this entry, replacing the previous one; leave it out to keep the relations as they are.";
+        }, {
+            readonly name: "images";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of images, replacing the previous ones.";
+        }];
+    };
+}, {
+    readonly resource: "studio.genres";
+    readonly method: "list";
+    readonly summary: "List the genres Studio can write";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/genres";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "include_unavailable";
+        readonly type: "boolean";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.genres";
+    readonly method: "retrieve";
+    readonly summary: "Read one genre with its built-in templates";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/genres/{genre}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "genre";
+        readonly sdkName: "genre";
+        readonly description: "Genre key from the genre list, such as novel_long or xiaohongshu_note; pass the key exactly, never the display name.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.platforms";
+    readonly method: "list";
+    readonly summary: "List the platforms a work can be produced for";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/platforms";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "genre";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.platforms";
+    readonly method: "retrieve";
+    readonly summary: "Read the rules of one platform";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/platforms/{platform}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "platform";
+        readonly sdkName: "platform";
+        readonly description: "Versioned platform key from the platform list, such as x@1 or xiaohongshu@1; the version suffix is part of the key.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.styles";
+    readonly method: "list";
+    readonly summary: "List the writing styles of this organization";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/styles";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.styles";
+    readonly method: "create";
+    readonly summary: "Create a writing style";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/styles";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Name of the style, written so a person can tell it apart from the organization's other styles.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Short description of the voice, shown wherever a style is chosen.";
+        }, {
+            readonly name: "samples";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "One to five paragraphs of writing in the intended voice; these paragraphs are what reach a writer, so choose them carefully.";
+        }, {
+            readonly name: "use";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Wording and habits to keep, stated as instructions a writer can follow rather than as adjectives.";
+        }, {
+            readonly name: "avoid";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Words and stock phrases to avoid, which also become the banned-word check for drafts that use this style.";
+        }, {
+            readonly name: "glossary";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Terms mapped from a wrong spelling to the right one; each pair becomes a deterministic check on the text.";
+        }];
+    };
+}, {
+    readonly resource: "studio.styles";
+    readonly method: "delete";
+    readonly summary: "Delete a writing style";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/styles/{style}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "style";
+        readonly sdkName: "style";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.styles";
+    readonly method: "retrieve";
+    readonly summary: "Read one writing style";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/styles/{style}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "style";
+        readonly sdkName: "style";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.styles";
+    readonly method: "update";
+    readonly summary: "Change a writing style";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/styles/{style}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "style";
+        readonly sdkName: "style";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New name of the style, replacing the previous one when name is named in the update mask.";
+        }, {
+            readonly name: "description";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New description of the voice, replacing the previous one.";
+        }, {
+            readonly name: "samples";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of sample paragraphs, replacing the previous ones; removing a sample removes it from every later context pack.";
+        }, {
+            readonly name: "use";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of wording and habits to keep, replacing the previous ones.";
+        }, {
+            readonly name: "avoid";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of words and phrases to avoid, replacing the previous ones and with them the banned-word check.";
+        }, {
+            readonly name: "glossary";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Complete glossary, replacing the previous one; a pair removed here stops being checked.";
+        }];
+    };
+}, {
+    readonly resource: "studio.templates";
+    readonly method: "list";
+    readonly summary: "List the templates a genre can start from";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/templates";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "genre";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.templates";
+    readonly method: "create";
+    readonly summary: "Save a starting structure as a template";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/templates";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "genre";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Genre the template belongs to; a draft of another genre cannot use it.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Name of the template, shown where a draft chooses its starting structure.";
+        }, {
+            readonly name: "guide";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Writing guidance that reaches the first context pack of a draft created from this template.";
+        }, {
+            readonly name: "outline";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: true;
+            readonly description: "Unit tree the template creates, in draft order, with children nested inside their parent.";
+        }];
+    };
+}, {
+    readonly resource: "studio.templates";
+    readonly method: "delete";
+    readonly summary: "Delete a saved template";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/templates/{template}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "template";
+        readonly sdkName: "template";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.templates";
+    readonly method: "retrieve";
+    readonly summary: "Read one template";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/templates/{template}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "template";
+        readonly sdkName: "template";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.themes";
+    readonly method: "list";
+    readonly summary: "List the rendition themes of a platform";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/themes";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "platform";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.themes";
+    readonly method: "create";
+    readonly summary: "Create a rendition theme";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/themes";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "platform";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Versioned platform key this theme renders for, taken from the platform list.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Name of the theme, shown wherever a rendition chooses its layout.";
+        }, {
+            readonly name: "html";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "HTML template with a small mustache-like subset over the title, the units and the pages; give it for a markup platform.";
+        }, {
+            readonly name: "css";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Stylesheet applied to the markup, folded inline for a platform that requires inline styles.";
+        }, {
+            readonly name: "reference_docx";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Reference document giving a DOCX rendition its styles, by file identifier; give it instead of markup for a word-processor platform.";
+        }, {
+            readonly name: "header";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Fragment placed at the top of every rendition this theme produces.";
+        }, {
+            readonly name: "footer";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Fragment placed at the bottom of every rendition this theme produces.";
+        }, {
+            readonly name: "card";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "How a card rendition is laid out: its proportions, its width and the fonts it expects.";
+        }];
+    };
+}, {
+    readonly resource: "studio.themes";
+    readonly method: "delete";
+    readonly summary: "Delete a rendition theme";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/themes/{theme}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "theme";
+        readonly sdkName: "theme";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.themes";
+    readonly method: "retrieve";
+    readonly summary: "Read one rendition theme";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/themes/{theme}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "theme";
+        readonly sdkName: "theme";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.themes";
+    readonly method: "update";
+    readonly summary: "Change a rendition theme";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/themes/{theme}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "theme";
+        readonly sdkName: "theme";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "Field paths this call changes, such as name, css or footer; a field left out keeps its value.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New name of the theme, replacing the previous one when name is named in the update mask.";
+        }, {
+            readonly name: "html";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New HTML template, replacing the previous one for renditions produced after this change.";
+        }, {
+            readonly name: "css";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New stylesheet, replacing the previous one.";
+        }, {
+            readonly name: "reference_docx";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New reference document for a DOCX rendition, by file identifier; it replaces the previous one.";
+        }, {
+            readonly name: "header";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New top fragment, replacing the previous one.";
+        }, {
+            readonly name: "footer";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New bottom fragment, replacing the previous one.";
+        }, {
+            readonly name: "card";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "How a card rendition is laid out: its proportions, its width and the fonts it expects.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works";
+    readonly method: "list";
+    readonly summary: "List the works of this organization";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "page_size";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "archived";
+        readonly type: "boolean";
+        readonly required: false;
+        readonly description: "Set to true to list archived works instead of active ones; each page lists one of the two, never both.";
+    }];
+}, {
+    readonly resource: "studio.works";
+    readonly method: "create";
+    readonly summary: "Create a work with its goal";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "title";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Working title of the new work, used in lists and in the Console; it does not become any rendition title.";
+        }, {
+            readonly name: "slug";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Organization-unique name to address the work by; omit it and one is derived from the title.";
+        }, {
+            readonly name: "goal";
+            readonly type: "object";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "brief";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "codexes";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Reference libraries to attach at creation; a library owned by another organization is refused rather than attached.";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Style to attach to the work, whose samples and glossary then reach every context pack unless a draft overrides it.";
+        }, {
+            readonly name: "labels";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "requestId";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Caller-chosen key that makes this create safe to repeat: the same value answers the first result instead of creating a second work.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works";
+    readonly method: "retrieve";
+    readonly summary: "Read a work, optionally with one draft and unit";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "draft";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }, {
+        readonly name: "expand";
+        readonly type: "array";
+        readonly itemType: "string";
+        readonly enum: readonly ["status", "drafts", "outline", "unit"];
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.works";
+    readonly method: "update";
+    readonly summary: "Change the title, goal or attached libraries";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/works/{work}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "expectedRevision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Work revision the caller read; when the work moved past it the write is refused with REVISION_CONFLICT and nothing changes.";
+        }, {
+            readonly name: "title";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New working title of the work, replacing the previous one when title is named in the update mask.";
+        }, {
+            readonly name: "slug";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New organization-unique name; the previous slug keeps resolving so existing links do not break.";
+        }, {
+            readonly name: "goal";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "codexes";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of reference libraries to keep attached; a library left out is detached from the work.";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Style to attach to the work, replacing the previous one; send an empty value to detach the style entirely.";
+        }, {
+            readonly name: "labels";
+            readonly type: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "archived";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Set to true to archive the work, which hides it from the default list without deleting anything.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works";
+    readonly method: "updateBrief";
+    readonly summary: "Add to or correct the original brief";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/works/{work}/brief";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expectedRevision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged.";
+        }, {
+            readonly name: "text";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Text to append to the stored brief, added after what is already there and never replacing it.";
+        }, {
+            readonly name: "attachments";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Source files to keep with the brief, added to the ones already attached.";
+        }, {
+            readonly name: "addPoints";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "New requirement points to split out of the brief; each receives the next free key in order.";
+        }, {
+            readonly name: "editPoints";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly description: "Existing points to reword, each naming the key it keeps and the text that replaces it.";
+        }, {
+            readonly name: "removePoints";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Keys of points to drop; a dropped key is never reused, so later points keep their own keys.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "list";
+    readonly summary: "List the drafts a work carries";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "create";
+    readonly summary: "Create a draft of a genre inside a work";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "genre";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Genre key the draft is written in, taken from the genre list; it decides the unit kinds, the properties and the checks.";
+        }, {
+            readonly name: "title";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Page title of the new draft; omit it and one is derived from the genre and the work title.";
+        }, {
+            readonly name: "mode";
+            readonly type: "string";
+            readonly enum: readonly ["skeleton", "space"];
+            readonly required: false;
+            readonly description: "Structure mode to create the draft in; omit it and the genre default applies, which is skeleton for most genres.";
+        }, {
+            readonly name: "template";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "outline";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "derivedFrom";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "What the new draft should be derived from, so the service can record the source revision for later staleness checks.";
+        }, {
+            readonly name: "props";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Initial values for the genre properties, keyed by property key; a value the genre does not define is refused rather than stored.";
+        }, {
+            readonly name: "requestId";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Caller-chosen key that makes this create safe to repeat: the same value answers the first draft instead of creating a second one.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "retrieve";
+    readonly summary: "Read one draft with optional units and todos";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "expand";
+        readonly type: "array";
+        readonly itemType: "string";
+        readonly enum: readonly ["units", "status"];
+        readonly required: false;
+        readonly description: "Extra parts to include, comma separated: units adds the unit tree without bodies, and status adds the computed todo list of this draft.";
+    }];
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "update";
+    readonly summary: "Change a draft title, key, properties or style";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "updateMask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "Field paths this call changes, such as title, key or props.topics; a field left out keeps its value.";
+        }, {
+            readonly name: "expectedRevision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "title";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New page title of the draft, replacing the previous one when title is named in the update mask.";
+        }, {
+            readonly name: "key";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New in-work key; the previous key keeps resolving so existing links and references do not break.";
+        }, {
+            readonly name: "props";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Property values to set, keyed by the genre property key; a property the genre does not define is refused.";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Style to attach to this draft, overriding the work style; send an empty value to fall back to the work style.";
+        }, {
+            readonly name: "mode";
+            readonly type: "string";
+            readonly enum: readonly ["skeleton", "space"];
+            readonly required: false;
+            readonly description: "Structure mode to switch the draft to; switching away from skeleton does not delete units that already exist.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "retrieveExport";
+    readonly summary: "Export the draft as Markdown or plain text";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/export";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "format";
+        readonly type: "string";
+        readonly enum: readonly ["markdown", "text"];
+        readonly required: true;
+        readonly description: "Format to render the draft in: markdown keeps headings, list markers and block anchors, and text drops the markup entirely.";
+    }];
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "retrieveOutline";
+    readonly summary: "Read the whole unit outline as Markdown";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/outline";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "retrieveReview";
+    readonly summary: "Read a review pass over the whole draft";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/review";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "page_token";
+        readonly type: "string";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.works.drafts.status";
+    readonly method: "list";
+    readonly summary: "Read the computed todo list of a draft";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/status";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.drafts.units";
+    readonly method: "create";
+    readonly summary: "Add one unit to the draft tree";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/units";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "kind";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Structural kind of the new unit, which must be one the genre allows at that position of the tree.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Structure name used to manage the tree, such as 场景 2 · 找上门; it is not the heading the finished piece shows.";
+        }, {
+            readonly name: "heading";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Heading the finished piece shows for this unit; leave it out when the genre wants the structure name kept out of the output.";
+        }, {
+            readonly name: "parent";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Unit this one should sit under, by number or identifier; null or omitted places it at the top level.";
+        }, {
+            readonly name: "after";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Sibling this one should follow, by number or identifier; null or omitted appends it at the end of its level.";
+        }, {
+            readonly name: "synopsis";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "points";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Points this unit hits, called beats, arguments or selling points depending on the genre.";
+        }, {
+            readonly name: "brief_points";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Keys of the brief points this unit claims, which is how the coverage check follows each requirement to a unit.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts.units";
+    readonly method: "batchCreate";
+    readonly summary: "Add a whole outline of units at once";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/units:batchCreate";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expected_revision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Draft revision the caller read; a mismatch is refused, which is what stops a repeated batch from duplicating a structure.";
+        }, {
+            readonly name: "parent";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Unit the whole outline should hang under, by number or identifier; null or omitted builds it at the top level.";
+        }, {
+            readonly name: "outline";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: true;
+            readonly description: "Units to create in order, with children nested inside their parent; the nesting becomes the parent chain of the created units.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts.units";
+    readonly method: "batchUpdate";
+    readonly summary: "Write intents for many units in one call";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/units:batchUpdate";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expected_revision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Draft revision the caller read; a mismatch is refused, so a plan written from a stale outline cannot land.";
+        }, {
+            readonly name: "updates";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: true;
+            readonly 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.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.drafts";
+    readonly method: "rebase";
+    readonly summary: "Confirm a draft already follows its source";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}:rebase";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "draft";
+        readonly sdkName: "draft";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: false;
+        readonly fields: readonly [{
+            readonly name: "expectedRevision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Draft revision the caller read; a mismatch is refused rather than confirming a draft that changed under the caller.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.units";
+    readonly method: "retrieve";
+    readonly summary: "Read one unit with its blocks and Markdown";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/units/{unit}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly sdkName: "unit";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "view";
+        readonly type: "string";
+        readonly enum: readonly ["full", "basic"];
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.works.units";
+    readonly method: "update";
+    readonly summary: "Change a unit intent, body or status";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/works/{work}/units/{unit}";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly sdkName: "unit";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expected_revision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Unit revision the caller read; required whenever body is sent, because replacing the whole text would discard blocks another writer inserted since.";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New structure name of the unit, used by people and agents to manage the tree.";
+        }, {
+            readonly name: "heading";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New heading the finished piece shows; send an empty value to remove the heading entirely.";
+        }, {
+            readonly name: "synopsis";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "New synopsis of what this unit has to accomplish; changing it advances the intent revision, which leaves any existing body behind it.";
+        }, {
+            readonly name: "points";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of points this unit hits, replacing the previous ones.";
+        }, {
+            readonly name: "brief_points";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: false;
+            readonly description: "Complete set of brief point keys this unit claims, replacing the previous claims so coverage follows the latest intent.";
+        }, {
+            readonly name: "body";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "synopsis_from_body";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Set to true together with body to record that the synopsis now describes what the text actually says rather than what was planned.";
+        }, {
+            readonly name: "status";
+            readonly type: "string";
+            readonly enum: readonly ["idea", "outlined", "writing", "drafted", "revised", "final"];
+            readonly required: false;
+            readonly description: "Unit status to set; moving to final declares the unit done, and changing it afterwards needs the confirmation flag.";
+        }, {
+            readonly name: "links";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Reference entries to tie to a unit or untie from it, beyond the mentions detected in its text.";
+        }, {
+            readonly name: "seconds";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Duration of this unit in seconds for a video genre, which its length checks measure; send null to clear it.";
+        }, {
+            readonly name: "confirm_final_edit";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly 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.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.units.blocks";
+    readonly method: "patch";
+    readonly summary: "Edit a unit body block by block";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/units/{unit}/blocks:patch";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly sdkName: "unit";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expected_revision";
+            readonly type: "integer";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "ops";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "confirm_final_edit";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly description: "Confirmation that a unit marked final may change; send it only when the person themselves asked for the change.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.units";
+    readonly method: "retrieveContext";
+    readonly summary: "Read the context pack for writing one unit";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/units/{unit}/context";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly sdkName: "unit";
+        readonly 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.";
+    }];
+    readonly query: readonly [{
+        readonly name: "budget_tokens";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.works.units";
+    readonly method: "move";
+    readonly summary: "Move a unit to another place in the tree";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/units/{unit}:move";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "work";
+        readonly sdkName: "work";
+        readonly 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.";
+    }, {
+        readonly name: "unit";
+        readonly sdkName: "unit";
+        readonly 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.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "expected_revision";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Unit revision the caller read; a mismatch is refused so a move never lands on a unit someone else just changed.";
+        }, {
+            readonly name: "parent";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Unit to move this one under, by number or identifier; null or omitted moves it to the top level.";
+        }, {
+            readonly name: "after";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Sibling to place this unit after, by number or identifier; null or omitted puts it first among its new siblings.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works";
+    readonly method: "resolve";
+    readonly summary: "Resolve a loose reference to a work, draft or unit";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works:resolve";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [{
+        readonly name: "ref";
+        readonly type: "string";
+        readonly required: true;
+        readonly 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.";
+    }];
 }, {
     readonly resource: "ticket.activity";
     readonly method: "retrieve";