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

package/dist/operations.generated.js

@@ -9931,7 +9931,7 @@ export const operations = [
                     "name": "to",
                     "type": "number",
                     "required": false,
-                    "description": "Range end for kind mix, in seconds on the project clock, exclusive. A range longer than 120 seconds is refused; request several ranges instead."
+                    "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."
                 },
                 {
                     "name": "revision",
@@ -10085,7 +10085,7 @@ export const operations = [
                     "name": "folder",
                     "type": "string",
                     "required": false,
-                    "description": "Optional destination path within the bound media library; omitted uses its default folder."
+                    "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."
                 },
                 {
                     "name": "name",
@@ -10103,7 +10103,7 @@ export const operations = [
                     "name": "binding",
                     "type": "string",
                     "required": false,
-                    "description": "Writable binding name used as the export destination; omission uses default_upload."
+                    "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."
                 },
                 {
                     "name": "revision",
@@ -10208,7 +10208,7 @@ export const operations = [
         "resource": "cut.projects.renders",
         "method": "create",
         "summary": "Create draft range render",
-        "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.",
+        "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.",
         "http": "POST",
         "path": "/cut/v1/projects/{project_id}/renders",
         "streaming": "no",
@@ -13441,6 +13441,41 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "media.libraries",
+        "method": "retrieveDefault",
+        "summary": "Get default library",
+        "description": "Return this organization’s default library. Calling ensures the organization’s default library exists (ADR-093): the first call creates it and later calls return the same library, so this is the method to call before writing when no library id is known. Generated and edited media land here when no library is named. The path segment {lib} accepts the literal default, which resolves to this library before the credential check — so an agent that has never listed libraries can still write to the right place. Returns the same Library object as libraries.retrieve; a credential bound to one library reaches this only when that binding covers the default library.",
+        "http": "GET",
+        "path": "/media/v1/libraries/default",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": []
+    },
+    {
+        "resource": "media.libraries",
+        "method": "setDefault",
+        "summary": "Set default library",
+        "description": "Point this organization’s default library at an existing library. Calling ensures the organization’s default library exists (ADR-093): the path is resolved before the credential check, so a first call creates the default library when there is none and then repoints it. The path segment {lib} accepts the literal default, which resolves to this library before the credential check. Supply library_id from library creation or listing; the library must be active and belong to the organization. This changes where library-less generation and uploads land across the whole organization, so it affects other callers as well as this one. It does not move or copy any asset — assets already in the previous default library stay there. Returns the library now set as the default. Deleting the default library is refused with LIBRARY_IS_DEFAULT until another library is made the default.",
+        "http": "PUT",
+        "path": "/media/v1/libraries/default",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "library_id",
+                    "type": "string",
+                    "required": true,
+                    "description": "Identifier of a library belonging to the caller."
+                }
+            ]
+        }
+    },
     {
         "resource": "media.libraries",
         "method": "delete",
@@ -13565,6 +13600,25 @@ export const operations = [
                 "required": false,
                 "description": "image, video (including audio), raw; auto is accepted by Upload actions only, and listing with auto returns 400."
             },
+            {
+                "name": "material_type",
+                "type": "string",
+                "enum": [
+                    "image",
+                    "video",
+                    "audio",
+                    "voice",
+                    "sticker",
+                    "font",
+                    "text_style",
+                    "text_template",
+                    "animation_preset",
+                    "lut",
+                    "transition_map"
+                ],
+                "required": false,
+                "description": "Filter assets to one kind of material, independent of the stored resource_type. Omit to list every material type. Assets stored before this field existed match no material_type filter."
+            },
             {
                 "name": "cursor",
                 "type": "string",
@@ -13925,6 +13979,68 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "media.assets",
+        "method": "edit",
+        "summary": "Edit asset",
+        "description": "Edit an existing asset and store the result as a new asset. Use library_id from creation or listing and asset_id from asset creation or listing; library_id also accepts the literal default, which resolves to the organization’s default library before the credential check. The source asset is never overwritten: the new asset hangs under it in the edit chain, records it in derived_from, and reads back with assets.lineage, so earlier steps stay reachable. The body is operation plus the optional model, asset_folder, understanding and idempotency_key; operation.type selects the edit and carries that operation’s own fields. This release performs variations, inpaint, erase, replace_object, recolor, remove_background and replace_background on images; every other type in the operation vocabulary — the video and audio edits — is refused with OPERATION_NOT_SUPPORTED. inpaint takes mask, a PNG File identifier beginning with file- whose transparent area marks the region to replace, plus the prompt describing what belongs there. Aspects beyond the source asset’s material type return REFERENCE_TYPE_MISMATCH. Editing is charged through Router and the job records the charge in usage. The response is 202 with a queued Job whose type is image, whose operation is the edit applied, and whose source_asset_id is the asset edited; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until it is completed or failed, then read the produced asset. Example: POST /media/v1/libraries/lib_example/assets/9dfa312ef9bc4b00816339b598b1152c/edits with {\"operation\":{\"type\":\"variations\",\"strength\":\"subtle\"}}.",
+        "http": "POST",
+        "path": "/media/v1/libraries/{library_id}/assets/{asset_id}/edits",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "library_id",
+                "sdkName": "library_id",
+                "description": "Library ID returned by creation."
+            },
+            {
+                "name": "asset_id",
+                "sdkName": "asset_id",
+                "description": "32-character asset ID."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "operation",
+                    "type": "object",
+                    "required": true,
+                    "description": "One edit to apply to the source asset. type selects the operation and the discriminating branch carries that operation’s fields. This release performs variations, inpaint, erase, replace_object, recolor, remove_background and replace_background on images; every other type here describes the operation vocabulary and is refused with OPERATION_NOT_SUPPORTED."
+                },
+                {
+                    "name": "model",
+                    "type": "string",
+                    "required": false,
+                    "description": "Router model that performs the edit; omit it to use the library default image model."
+                },
+                {
+                    "name": "asset_folder",
+                    "type": "string",
+                    "required": false,
+                    "description": "Folder the produced asset is filed under; defaults to the source asset’s folder. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out."
+                },
+                {
+                    "name": "understanding",
+                    "type": "string",
+                    "enum": [
+                        "auto",
+                        "skip"
+                    ],
+                    "required": false,
+                    "description": "Understanding behavior for the produced asset; defaults to auto."
+                },
+                {
+                    "name": "idempotency_key",
+                    "type": "string",
+                    "required": false,
+                    "description": "Stable key so a retried request reuses the same job instead of editing and charging again; reusing it with different content is rejected."
+                }
+            ]
+        }
+    },
     {
         "resource": "media.libraries.assets.frames",
         "method": "create",
@@ -13971,6 +14087,29 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "media.assets",
+        "method": "lineage",
+        "summary": "Get asset lineage",
+        "description": "Read the whole edit tree containing one asset, so a caller sees what it was edited from and what was edited from it. Use library_id from creation or listing and asset_id from asset creation or listing; library_id also accepts the literal default, which resolves to the organization’s default library before the credential check. The response names the root the tree descends from, the asset asked about, and every step between them, each with the operation, prompt and creation time that produced it. Deleted assets stay in the tree, marked deleted, so the chain stays connected after cleanup. This is a read: it starts no processing and changes no asset. Example: GET /media/v1/libraries/lib_example/assets/9dfa312ef9bc4b00816339b598b1152c/lineage.",
+        "http": "GET",
+        "path": "/media/v1/libraries/{library_id}/assets/{asset_id}/lineage",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "library_id",
+                "sdkName": "library_id",
+                "description": "Library ID returned by creation."
+            },
+            {
+                "name": "asset_id",
+                "sdkName": "asset_id",
+                "description": "32-character asset ID."
+            }
+        ],
+        "query": []
+    },
     {
         "resource": "media.libraries.assets.reprocess",
         "method": "create",
@@ -14372,6 +14511,126 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "media.images",
+        "method": "generate",
+        "summary": "Generate image",
+        "description": "Generate one or more images from a text prompt and store them straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still generate. The request body is the image request itself: prompt is required, and n, size, background, output_format, output, references, seed, model, asset_folder and understanding are optional. Set output to sticker for a cut-out with a transparent background. references attach existing assets with a role — edit_target, style, structure or subject — and a model that cannot honour a role returns REFERENCE_TYPE_MISMATCH. Aspect ratio is not accepted for images; name size instead. Generation is charged through Router and the job records the charge in usage; nothing is charged for a request refused before it starts. The response is 202 with a queued Job whose type is image and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced assets from the library. Send Idempotency-Key, or idempotency_key in the body, to retry without generating and charging twice. Example: POST /media/v1/libraries/default/images/generations with {\"prompt\":\"A red kite above a calm sea at sunrise\",\"n\":1,\"output\":\"sticker\"}.",
+        "http": "POST",
+        "path": "/media/v1/libraries/{library_id}/images/generations",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "library_id",
+                "sdkName": "library_id",
+                "description": "Library ID returned by creation."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "prompt",
+                    "type": "string",
+                    "required": true,
+                    "description": "Text prompt describing the image to generate; Router forwards it to the image model unchanged."
+                },
+                {
+                    "name": "negative_prompt",
+                    "type": "string",
+                    "required": false,
+                    "description": "What the image must not contain. Models without a negative-prompt control ignore it."
+                },
+                {
+                    "name": "n",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Images to generate in one job, from 1 to 10; defaults to 1. Each produced image is charged separately."
+                },
+                {
+                    "name": "size",
+                    "type": "string",
+                    "required": false,
+                    "description": "Requested pixel size written as width x height. Router validates it against the chosen model and rejects an unsupported size with INVALID_PARAMS."
+                },
+                {
+                    "name": "background",
+                    "type": "string",
+                    "enum": [
+                        "transparent",
+                        "opaque",
+                        "auto"
+                    ],
+                    "required": false,
+                    "description": "Background handling; defaults to auto. Whether transparency is honoured depends on the model."
+                },
+                {
+                    "name": "output_format",
+                    "type": "string",
+                    "enum": [
+                        "png",
+                        "jpeg",
+                        "webp"
+                    ],
+                    "required": false,
+                    "description": "Encoding of the stored image; defaults to png. Transparency requires png or webp."
+                },
+                {
+                    "name": "output",
+                    "type": "string",
+                    "enum": [
+                        "image",
+                        "sticker"
+                    ],
+                    "required": false,
+                    "description": "How the result is stored: image for a normal picture, or sticker for a cut-out committed with material_type sticker; defaults to image."
+                },
+                {
+                    "name": "references",
+                    "type": "array",
+                    "itemType": "object",
+                    "required": false,
+                    "description": "Existing assets the model may use, each with the role it plays. Router answers REFERENCE_TYPE_MISMATCH when the chosen model cannot honour a role."
+                },
+                {
+                    "name": "seed",
+                    "type": "integer",
+                    "required": false,
+                    "description": "Seed for reproducible sampling; omit it to let the model choose one."
+                },
+                {
+                    "name": "model",
+                    "type": "string",
+                    "required": false,
+                    "description": "Router model with image-generation capability; omit it to use the library default image model."
+                },
+                {
+                    "name": "asset_folder",
+                    "type": "string",
+                    "required": false,
+                    "description": "Folder the produced asset is filed under; defaults to the library root. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out."
+                },
+                {
+                    "name": "understanding",
+                    "type": "string",
+                    "enum": [
+                        "auto",
+                        "skip"
+                    ],
+                    "required": false,
+                    "description": "Understanding behavior for the produced asset; defaults to auto."
+                },
+                {
+                    "name": "idempotency_key",
+                    "type": "string",
+                    "required": false,
+                    "description": "Stable key so a retried request reuses the same job instead of generating and charging again; reusing it with different content is rejected."
+                }
+            ]
+        }
+    },
     {
         "resource": "media.libraries.jobs",
         "method": "list",
@@ -14394,11 +14653,13 @@ export const operations = [
                 "type": "string",
                 "enum": [
                     "queued",
+                    "in_progress",
                     "running",
                     "completed",
                     "completed_with_errors",
                     "failed",
-                    "cancelled"
+                    "cancelled",
+                    "canceled"
                 ],
                 "required": false,
                 "description": "Filter jobs by their current status."
@@ -14597,7 +14858,7 @@ export const operations = [
                     "name": "top_k",
                     "type": "integer",
                     "required": false,
-                    "description": "Maximum search hits, from 1 to 50; defaults to 20."
+                    "description": "Maximum search hits, from 1 to 50; defaults to 20. top_k takes effect and bounds how many distinct hits come back, counting collapsed duplicates as one hit."
                 },
                 {
                     "name": "mode",
@@ -14608,6 +14869,25 @@ export const operations = [
                     ],
                     "required": false,
                     "description": "Ranking mode: hybrid combines semantic and keyword matches; semantic uses vector similarity only. Defaults to hybrid."
+                },
+                {
+                    "name": "material_type",
+                    "type": "string",
+                    "enum": [
+                        "image",
+                        "video",
+                        "audio",
+                        "voice",
+                        "sticker",
+                        "font",
+                        "text_style",
+                        "text_template",
+                        "animation_preset",
+                        "lut",
+                        "transition_map"
+                    ],
+                    "required": false,
+                    "description": "What this asset is as a reusable material, as opposed to resource_type (its stored file category). Omitted on assets stored before this field existed and on raw assets that are not materials."
                 }
             ]
         }
@@ -14720,7 +15000,7 @@ export const operations = [
                     "name": "top_k",
                     "type": "integer",
                     "required": false,
-                    "description": "Maximum search hits, from 1 to 50; defaults to 20."
+                    "description": "Maximum search hits, from 1 to 50; defaults to 20. top_k takes effect and bounds how many distinct hits come back, counting collapsed duplicates as one hit."
                 },
                 {
                     "name": "mode",
@@ -14731,6 +15011,25 @@ export const operations = [
                     ],
                     "required": false,
                     "description": "Ranking mode: hybrid combines semantic and keyword matches; semantic uses vector similarity only. Defaults to hybrid."
+                },
+                {
+                    "name": "material_type",
+                    "type": "string",
+                    "enum": [
+                        "image",
+                        "video",
+                        "audio",
+                        "voice",
+                        "sticker",
+                        "font",
+                        "text_style",
+                        "text_template",
+                        "animation_preset",
+                        "lut",
+                        "transition_map"
+                    ],
+                    "required": false,
+                    "description": "What this asset is as a reusable material, as opposed to resource_type (its stored file category). Omitted on assets stored before this field existed and on raw assets that are not materials."
                 }
             ]
         }
@@ -17209,7 +17508,7 @@ export const operations = [
         "resource": "ontology.nodes",
         "method": "create",
         "summary": "Create node",
-        "description": "Record one entity in the graph, for a system mirroring a record it owns. type must already be registered and ref, when given, must match that type's ref_prefix. Send an Idempotency-Key header; repeating the same key with the same content returns the first result instead of creating a second node. This writes structure only — to give an agent something to remember, use POST /agent/v1/agents/{agent_id}/consolidations.",
+        "description": "Record one entity in the graph, for a system mirroring a record it owns. type must already be registered and ref, when given, must match that type's ref_prefix. Send an Idempotency-Key header; repeating the same key with the same content returns the first result instead of creating a second node. This writes structure only; it does not give any agent a memory.",
         "http": "POST",
         "path": "/ontology/v1/nodes",
         "streaming": "no",
@@ -17364,6 +17663,60 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "ontology.nodes",
+        "method": "retrieveNeighborhood",
+        "summary": "Retrieve neighborhood",
+        "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.",
+        "http": "GET",
+        "path": "/ontology/v1/nodes/{node_id}/neighborhood",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "node_id",
+                "sdkName": "node_id",
+                "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."
+            }
+        ],
+        "query": [
+            {
+                "name": "depth",
+                "type": "integer",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "limit",
+                "type": "integer",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "direction",
+                "type": "string",
+                "enum": [
+                    "out",
+                    "in",
+                    "both"
+                ],
+                "required": false,
+                "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."
+            },
+            {
+                "name": "as_of",
+                "type": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "include_invalid",
+                "type": "boolean",
+                "required": false,
+                "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."
+            }
+        ]
+    },
     {
         "resource": "ontology.relations",
         "method": "list",
@@ -17429,7 +17782,7 @@ export const operations = [
         "resource": "ontology.relations",
         "method": "create",
         "summary": "Create relation",
-        "description": "Record one fact between two existing nodes, for a system mirroring a relationship it owns. type must be registered and must admit these endpoints; fact states the relationship in one sentence. Send an Idempotency-Key header; repeating the same key returns the first result instead of writing a second relation. This writes structure only — to give an agent something to remember, use POST /agent/v1/agents/{agent_id}/consolidations.",
+        "description": "Record one fact between two existing nodes, for a system mirroring a relationship it owns. type must be registered and must admit these endpoints; fact states the relationship in one sentence. Send an Idempotency-Key header; repeating the same key returns the first result instead of writing a second relation. This writes structure only; it does not give any agent a memory.",
         "http": "POST",
         "path": "/ontology/v1/relations",
         "streaming": "no",
@@ -17541,7 +17894,7 @@ export const operations = [
         "resource": "ontology.search",
         "method": "create",
         "summary": "Search nodes",
-        "description": "Resolve text to the nodes it most likely names, when a mirror holds a name and needs the node id it corresponds to. Results are ranked candidates, not an answer, each reporting whether the match came from the node's name, an alias, its description or a relation's fact. Narrow with types, and cap the result count with limit (1–50, default 20). This reads structure; it is not an agent recall — agents recall through POST /agent/v1/agents/{agent_id}/consolidations.",
+        "description": "Resolve text to the nodes it most likely names, when a mirror holds a name and needs the node id it corresponds to. Results are ranked candidates, not an answer, each reporting whether the match came from the node's name, an alias, its description or a relation's fact. Narrow with types, and cap the result count with limit (1–50, default 20). This reads structure; it is not an agent's recall, which reads the graph from that agent's own viewpoint inside its sessions.",
         "http": "POST",
         "path": "/ontology/v1/search",
         "streaming": "no",
@@ -20205,7 +20558,7 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
@@ -20448,7 +20801,7 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
@@ -20759,7 +21112,7 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
@@ -20920,7 +21273,7 @@ export const operations = [
         "resource": "studio.themes",
         "method": "list",
         "summary": "List the rendition themes of a platform",
-        "description": "List themes: the layouts a rendition is produced with, for one platform or for all of them. Pass a platform to see only the themes that platform can use. A theme decides the page or card a rendition is built into, so read the chosen theme before creating a rendition rather than after the output looks wrong.",
+        "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. The first page starts with the built-in themes (builtin true, such as warm-card@1 for Xiaohongshu cards and plain-mono@1 for WeChat articles), which every organization can use and nobody can change or delete; your organization's own themes follow. A theme decides the page or card a rendition is built into, so read the chosen theme before creating a rendition rather than after the output looks wrong.",
         "http": "GET",
         "path": "/studio/v1/themes",
         "streaming": "no",
@@ -21069,7 +21422,7 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
@@ -21209,7 +21562,7 @@ export const operations = [
                     "description": "Caller-chosen key and value pairs kept on a resource; the keys are the caller's own names and no platform meaning is attached to them."
                 },
                 {
-                    "name": "requestId",
+                    "name": "request_id",
                     "type": "string",
                     "required": false,
                     "description": "Caller-chosen key that makes this create safe to repeat: the same value answers the first result instead of creating a second work."
@@ -21282,14 +21635,14 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
                     "description": "Field paths this call changes, spelled as they appear in the work, such as title or goal.message; a field left out keeps its value."
                 },
                 {
-                    "name": "expectedRevision",
+                    "name": "expected_revision",
                     "type": "integer",
                     "required": false,
                     "description": "Work revision the caller read; when the work moved past it the write is refused with REVISION_CONFLICT and nothing changes."
@@ -21361,7 +21714,7 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "expectedRevision",
+                    "name": "expected_revision",
                     "type": "integer",
                     "required": false,
                     "description": "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged."
@@ -21380,21 +21733,21 @@ export const operations = [
                     "description": "Source files to keep with the brief, added to the ones already attached."
                 },
                 {
-                    "name": "addPoints",
+                    "name": "add_points",
                     "type": "array",
-                    "itemType": "string",
+                    "itemType": "object",
                     "required": false,
-                    "description": "New requirement points to split out of the brief; each receives the next free key in order."
+                    "description": "New requirement points to split out of the brief; each receives the next free key in order. A plain string is a unit point; pass { text, scope: work } for a constraint on the whole piece (period, voice, point of view, cast, words to avoid)."
                 },
                 {
-                    "name": "editPoints",
+                    "name": "edit_points",
                     "type": "array",
                     "itemType": "object",
                     "required": false,
                     "description": "Existing points to reword, each naming the key it keeps and the text that replaces it."
                 },
                 {
-                    "name": "removePoints",
+                    "name": "remove_points",
                     "type": "array",
                     "itemType": "string",
                     "required": false,
@@ -21477,7 +21830,7 @@ export const operations = [
                     "description": "Unit tree to create the draft with, given by the caller instead of a template; children nest, and a unit without a kind takes the genre default for its position."
                 },
                 {
-                    "name": "derivedFrom",
+                    "name": "derived_from",
                     "type": "object",
                     "required": false,
                     "description": "What the new draft should be derived from, so the service can record the source revision for later staleness checks."
@@ -21489,7 +21842,7 @@ export const operations = [
                     "description": "Initial values for the genre properties, keyed by property key; a value the genre does not define is refused rather than stored."
                 },
                 {
-                    "name": "requestId",
+                    "name": "request_id",
                     "type": "string",
                     "required": false,
                     "description": "Caller-chosen key that makes this create safe to repeat: the same value answers the first draft instead of creating a second one."
@@ -21558,14 +21911,14 @@ export const operations = [
             "required": true,
             "fields": [
                 {
-                    "name": "updateMask",
+                    "name": "update_mask",
                     "type": "array",
                     "itemType": "string",
                     "required": true,
                     "description": "Field paths this call changes, such as title, key or props.topics; a field left out keeps its value."
                 },
                 {
-                    "name": "expectedRevision",
+                    "name": "expected_revision",
                     "type": "integer",
                     "required": false,
                     "description": "Draft revision the caller read; a mismatch is refused with REVISION_CONFLICT and nothing changes. Omit it only for structure calls that genuinely do not depend on the current state."
@@ -21664,6 +22017,64 @@ export const operations = [
         ],
         "query": []
     },
+    {
+        "resource": "studio.works.drafts.renditions",
+        "method": "create",
+        "summary": "Create a rendition of a draft for a platform",
+        "description": "Create a rendition: the form of one draft that a platform receives, such as a Xiaohongshu card set, a DOCX file or a Markdown file. Read the platform first with the platform call and pass its versioned key; pass a theme only to override the platform's default layout. Pass render true to render in the same call and read render_state and issues in the answer; without it the rendition starts as pending and the render call produces it. Rendering a Xiaohongshu card set is billed by Browser Rendering time (meter browser_ms, product studio-render); DOCX and Markdown renditions are not billed. A draft with no body renders as invalid with a draft_empty issue, and an unavailable render service leaves render_state failed with a render_unavailable issue, so repeat the render call later. Send a request_id to make a repeated call return the first rendition instead of creating another. Next, publish the rendition to export it.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/drafts/{draft}/renditions",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "draft",
+                "sdkName": "draft",
+                "description": "Draft being addressed, either its in-work key such as novel or its drf_ identifier; a key renamed earlier still resolves through its previous value."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "platform",
+                    "type": "string",
+                    "required": true,
+                    "description": "Versioned platform key from the platform list. Export platforms today are markdown@1, docx@1 and xiaohongshu@1; a platform that only publishes to an account answers PLATFORM_NOT_AVAILABLE."
+                },
+                {
+                    "name": "theme",
+                    "type": "string",
+                    "required": false,
+                    "description": "Theme to render with, a thm_ identifier or a built-in key from the theme list; omit it to use the platform default."
+                },
+                {
+                    "name": "settings",
+                    "type": "object",
+                    "required": false,
+                    "description": "Per-rendition settings; each platform reads only the settings that apply to it and ignores the rest."
+                },
+                {
+                    "name": "render",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Whether to render in the same call. True returns a rendition that is already rendered, invalid or failed; false or omitted returns it pending, to be rendered by the render operation."
+                },
+                {
+                    "name": "request_id",
+                    "type": "string",
+                    "required": false,
+                    "description": "Caller-chosen key that makes a repeated create return the first rendition instead of making another; use a new value for each distinct rendition."
+                }
+            ]
+        }
+    },
     {
         "resource": "studio.works.drafts",
         "method": "retrieveReview",
@@ -21909,7 +22320,7 @@ export const operations = [
             "required": false,
             "fields": [
                 {
-                    "name": "expectedRevision",
+                    "name": "expected_revision",
                     "type": "integer",
                     "required": false,
                     "description": "Draft revision the caller read; a mismatch is refused rather than confirming a draft that changed under the caller."
@@ -21917,6 +22328,212 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "studio.works.renditions",
+        "method": "list",
+        "summary": "List the renditions of a work",
+        "description": "List the renditions of one work, each with its platform, render state, stale flag and publish state. Pass draft to see only the renditions of one draft. Use it to find the rendition to publish or to render again, and read stale before exporting: a stale rendition was built from an older draft and cannot be exported until the render call has rebuilt it. The answer is one page; keep following next_page_token while it is present.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/renditions",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            }
+        ],
+        "query": [
+            {
+                "name": "draft",
+                "type": "string",
+                "required": false,
+                "description": "Draft key such as novel or its drf_ identifier; when given, only the renditions of that draft are returned. Omit it to list the renditions of every draft in the work."
+            },
+            {
+                "name": "page_size",
+                "type": "integer",
+                "required": false,
+                "description": "How many items this page returns, 1 to 100; omitted uses the service default. Treat the answer as one page, not the whole set, and keep following next_page_token while it is present."
+            },
+            {
+                "name": "page_token",
+                "type": "string",
+                "required": false,
+                "description": "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "delete",
+        "summary": "Delete a rendition",
+        "description": "Delete a rendition and stop listing it. The draft it was built from is untouched, and a new rendition can be created from it at any time. Files already downloaded from an earlier export are not affected. Use it to clear a failed or abandoned rendition; to refresh one, call the render operation instead.",
+        "http": "DELETE",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "retrieve",
+        "summary": "Read one rendition",
+        "description": "Read one rendition in full: its render state, the validation issues the render found, the parts (one per card page or thread post), the files it produced and its publish state. Call it after create, render or publish to see the outcome, because a render that finished invalid or failed is reported here and not as an HTTP error. stale is true when the draft has changed since source_revision; call the render operation before exporting a stale rendition.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "update",
+        "summary": "Change the theme or settings of a rendition",
+        "description": "Change a rendition's theme or settings. Send update_mask naming exactly the fields you change, such as theme or settings; a field left out keeps its value. The produced files are not rebuilt by this call, so call the render operation afterwards to apply the change. A rendition whose export or publish has started is locked and answers RENDITION_PUBLISH_LOCKED; create a new rendition for new content.",
+        "http": "PATCH",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "update_mask",
+                    "type": "array",
+                    "itemType": "string",
+                    "required": true,
+                    "description": "Field paths this call changes: theme, settings or both; a field left out keeps its value."
+                },
+                {
+                    "name": "theme",
+                    "type": "string",
+                    "required": false,
+                    "description": "New theme, a thm_ identifier or a built-in key, used when theme is named in the update mask; render again to apply it."
+                },
+                {
+                    "name": "settings",
+                    "type": "object",
+                    "required": false,
+                    "description": "Per-rendition settings; each platform reads only the settings that apply to it and ignores the rest."
+                }
+            ]
+        }
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "retrieveContent",
+        "summary": "Get a download URL for a rendition file",
+        "description": "Get a signed, short-lived URL to download what a rendition produced. Without part it points to the rendition's own first file: the ZIP of pages for a card rendition, the DOCX for docx@1. With part it points to that part's first file, such as one card PNG; a part that has no file, or a rendition not rendered yet, answers RENDITION_NOT_RENDERED, and an index no part has answers INVALID_PARAMS. Call it after a successful render or export, download the url before expire_time, and call again for a fresh one when it has expired. The URL is a credential: do not store or share it.",
+        "http": "GET",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}/content",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": [
+            {
+                "name": "part",
+                "type": "integer",
+                "required": false,
+                "description": "Index of the part to download, the index value of an entry in the rendition's parts list; omit it to get the rendition's own first file."
+            }
+        ]
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "publish",
+        "summary": "Export a rendition",
+        "description": "Export a rendition for the platforms that deliver a file: markdown@1, docx@1 and xiaohongshu@1 end with publish.state exported, and a card rendition gains one ZIP of its pages in files. Publishing to a platform account such as X or WeChat is not available yet and answers PLATFORM_NOT_AVAILABLE; export instead. The rendition must be rendered, not stale and without error-level issues: RENDITION_NOT_RENDERED means call the render operation first, RENDITION_STALE means the draft changed so render again, RENDITION_INVALID means fix the draft problems listed in issues and render again. Exporting the same rendition twice at once answers REVISION_CONFLICT; retry shortly. Next, call the content operation to download the file.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}:publish",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "studio.works.renditions",
+        "method": "render",
+        "summary": "Render a rendition again from the current draft",
+        "description": "Render the rendition from the draft as it is now, replacing its parts and files and clearing stale. Call it after the draft changed, after a theme or settings change, or after a failed render. The answer carries render_state: rendered, invalid when the draft has an error-level issue (for example draft_empty on a draft with no body), or failed when the render service was unavailable (issue render_unavailable; repeat later). A render does not fail the HTTP call for those outcomes, so read render_state and issues. Rendering a Xiaohongshu card set is billed by Browser Rendering time (meter browser_ms, product studio-render); DOCX and Markdown are not billed. Rendering the same rendition twice at once answers REVISION_CONFLICT; retry shortly. Next, publish the rendition to export it.",
+        "http": "POST",
+        "path": "/studio/v1/works/{work}/renditions/{rendition}:render",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "work",
+                "sdkName": "work",
+                "description": "The work being addressed, either its organization-unique slug or its wk_ identifier; a slug case is what a person would say, and a renamed slug still resolves through its old value."
+            },
+            {
+                "name": "rendition",
+                "sdkName": "rendition",
+                "description": "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer."
+            }
+        ],
+        "query": []
+    },
     {
         "resource": "studio.works.units",
         "method": "retrieve",