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

package/dist/operations.generated.d.ts

@@ -8018,7 +8018,7 @@ export declare const operations: readonly [{
             readonly name: "to";
             readonly type: "number";
             readonly required: false;
-            readonly 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.";
+            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";
@@ -8145,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";
@@ -8160,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";
@@ -8246,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";
@@ -10861,6 +10861,37 @@ export declare const operations: readonly [{
             readonly description: "Understanding tasks enabled for new assets; omitted settings default to true.";
         }];
     };
+}, {
+    readonly resource: "media.libraries";
+    readonly method: "retrieveDefault";
+    readonly summary: "Get default library";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/media/v1/libraries/default";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+}, {
+    readonly resource: "media.libraries";
+    readonly method: "setDefault";
+    readonly summary: "Set default library";
+    readonly 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.";
+    readonly http: "PUT";
+    readonly path: "/media/v1/libraries/default";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "library_id";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Identifier of a library belonging to the caller.";
+        }];
+    };
 }, {
     readonly resource: "media.libraries";
     readonly method: "delete";
@@ -10961,6 +10992,12 @@ export declare const operations: readonly [{
         readonly enum: readonly ["image", "video", "raw"];
         readonly required: false;
         readonly description: "image, video (including audio), raw; auto is accepted by Upload actions only, and listing with auto returns 400.";
+    }, {
+        readonly name: "material_type";
+        readonly type: "string";
+        readonly enum: readonly ["image", "video", "audio", "voice", "sticker", "font", "text_style", "text_template", "animation_preset", "lut", "transition_map"];
+        readonly required: false;
+        readonly 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.";
     }, {
         readonly name: "cursor";
         readonly type: "string";
@@ -11247,6 +11284,55 @@ export declare const operations: readonly [{
             readonly description: "Replacement custom string-metadata map. Nonempty keys are required and serialized JSON must fit within 1024 UTF-8 bytes; an empty object clears the metadata.";
         }];
     };
+}, {
+    readonly resource: "media.assets";
+    readonly method: "edit";
+    readonly summary: "Edit asset";
+    readonly 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\"}}.";
+    readonly http: "POST";
+    readonly path: "/media/v1/libraries/{library_id}/assets/{asset_id}/edits";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "library_id";
+        readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
+    }, {
+        readonly name: "asset_id";
+        readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "operation";
+            readonly type: "object";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "model";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Router model that performs the edit; omit it to use the library default image model.";
+        }, {
+            readonly name: "asset_folder";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "understanding";
+            readonly type: "string";
+            readonly enum: readonly ["auto", "skip"];
+            readonly required: false;
+            readonly description: "Understanding behavior for the produced asset; defaults to auto.";
+        }, {
+            readonly name: "idempotency_key";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Stable key so a retried request reuses the same job instead of editing and charging again; reusing it with different content is rejected.";
+        }];
+    };
 }, {
     readonly resource: "media.libraries.assets.frames";
     readonly method: "create";
@@ -11282,6 +11368,25 @@ export declare const operations: readonly [{
             readonly description: "Maximum JPEG width in pixels: 160 is a small thumbnail, 320 a preview and 640 a larger preview. Defaults to 640; larger widths are unavailable.";
         }];
     };
+}, {
+    readonly resource: "media.assets";
+    readonly method: "lineage";
+    readonly summary: "Get asset lineage";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/media/v1/libraries/{library_id}/assets/{asset_id}/lineage";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "library_id";
+        readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
+    }, {
+        readonly name: "asset_id";
+        readonly sdkName: "asset_id";
+        readonly description: "32-character asset ID.";
+    }];
+    readonly query: readonly [];
 }, {
     readonly resource: "media.libraries.assets.reprocess";
     readonly method: "create";
@@ -11592,6 +11697,95 @@ export declare const operations: readonly [{
             readonly description: "Not supported in v1; omit this field. Only text-to-video is currently available.";
         }];
     };
+}, {
+    readonly resource: "media.images";
+    readonly method: "generate";
+    readonly summary: "Generate image";
+    readonly 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\"}.";
+    readonly http: "POST";
+    readonly path: "/media/v1/libraries/{library_id}/images/generations";
+    readonly streaming: "no";
+    readonly pagination: false;
+    readonly pathParams: readonly [{
+        readonly name: "library_id";
+        readonly sdkName: "library_id";
+        readonly description: "Library ID returned by creation.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "prompt";
+            readonly type: "string";
+            readonly required: true;
+            readonly description: "Text prompt describing the image to generate; Router forwards it to the image model unchanged.";
+        }, {
+            readonly name: "negative_prompt";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "What the image must not contain. Models without a negative-prompt control ignore it.";
+        }, {
+            readonly name: "n";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Images to generate in one job, from 1 to 10; defaults to 1. Each produced image is charged separately.";
+        }, {
+            readonly name: "size";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Requested pixel size written as width x height. Router validates it against the chosen model and rejects an unsupported size with INVALID_PARAMS.";
+        }, {
+            readonly name: "background";
+            readonly type: "string";
+            readonly enum: readonly ["transparent", "opaque", "auto"];
+            readonly required: false;
+            readonly description: "Background handling; defaults to auto. Whether transparency is honoured depends on the model.";
+        }, {
+            readonly name: "output_format";
+            readonly type: "string";
+            readonly enum: readonly ["png", "jpeg", "webp"];
+            readonly required: false;
+            readonly description: "Encoding of the stored image; defaults to png. Transparency requires png or webp.";
+        }, {
+            readonly name: "output";
+            readonly type: "string";
+            readonly enum: readonly ["image", "sticker"];
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "references";
+            readonly type: "array";
+            readonly itemType: "object";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "seed";
+            readonly type: "integer";
+            readonly required: false;
+            readonly description: "Seed for reproducible sampling; omit it to let the model choose one.";
+        }, {
+            readonly name: "model";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Router model with image-generation capability; omit it to use the library default image model.";
+        }, {
+            readonly name: "asset_folder";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "understanding";
+            readonly type: "string";
+            readonly enum: readonly ["auto", "skip"];
+            readonly required: false;
+            readonly description: "Understanding behavior for the produced asset; defaults to auto.";
+        }, {
+            readonly name: "idempotency_key";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Stable key so a retried request reuses the same job instead of generating and charging again; reusing it with different content is rejected.";
+        }];
+    };
 }, {
     readonly resource: "media.libraries.jobs";
     readonly method: "list";
@@ -11609,7 +11803,7 @@ export declare const operations: readonly [{
     readonly query: readonly [{
         readonly name: "status";
         readonly type: "string";
-        readonly enum: readonly ["queued", "running", "completed", "completed_with_errors", "failed", "cancelled"];
+        readonly enum: readonly ["queued", "in_progress", "running", "completed", "completed_with_errors", "failed", "cancelled", "canceled"];
         readonly required: false;
         readonly description: "Filter jobs by their current status.";
     }, {
@@ -11771,13 +11965,19 @@ export declare const operations: readonly [{
             readonly name: "top_k";
             readonly type: "integer";
             readonly required: false;
-            readonly description: "Maximum search hits, from 1 to 50; defaults to 20.";
+            readonly 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.";
         }, {
             readonly name: "mode";
             readonly type: "string";
             readonly enum: readonly ["hybrid", "semantic"];
             readonly required: false;
             readonly description: "Ranking mode: hybrid combines semantic and keyword matches; semantic uses vector similarity only. Defaults to hybrid.";
+        }, {
+            readonly name: "material_type";
+            readonly type: "string";
+            readonly enum: readonly ["image", "video", "audio", "voice", "sticker", "font", "text_style", "text_template", "animation_preset", "lut", "transition_map"];
+            readonly required: false;
+            readonly 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.";
         }];
     };
 }, {
@@ -11865,13 +12065,19 @@ export declare const operations: readonly [{
             readonly name: "top_k";
             readonly type: "integer";
             readonly required: false;
-            readonly description: "Maximum search hits, from 1 to 50; defaults to 20.";
+            readonly 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.";
         }, {
             readonly name: "mode";
             readonly type: "string";
             readonly enum: readonly ["hybrid", "semantic"];
             readonly required: false;
             readonly description: "Ranking mode: hybrid combines semantic and keyword matches; semantic uses vector similarity only. Defaults to hybrid.";
+        }, {
+            readonly name: "material_type";
+            readonly type: "string";
+            readonly enum: readonly ["image", "video", "audio", "voice", "sticker", "font", "text_style", "text_template", "animation_preset", "lut", "transition_map"];
+            readonly required: false;
+            readonly 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.";
         }];
     };
 }, {
@@ -13846,7 +14052,7 @@ export declare const operations: readonly [{
     readonly resource: "ontology.nodes";
     readonly method: "create";
     readonly summary: "Create node";
-    readonly 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.";
+    readonly 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.";
     readonly http: "POST";
     readonly path: "/ontology/v1/nodes";
     readonly streaming: "no";
@@ -13973,6 +14179,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";
@@ -14025,7 +14272,7 @@ export declare const operations: readonly [{
     readonly resource: "ontology.relations";
     readonly method: "create";
     readonly summary: "Create relation";
-    readonly 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.";
+    readonly 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.";
     readonly http: "POST";
     readonly path: "/ontology/v1/relations";
     readonly streaming: "no";
@@ -14119,7 +14366,7 @@ export declare const operations: readonly [{
     readonly resource: "ontology.search";
     readonly method: "create";
     readonly summary: "Search nodes";
-    readonly 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.";
+    readonly 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.";
     readonly http: "POST";
     readonly path: "/ontology/v1/search";
     readonly streaming: "no";
@@ -16146,7 +16393,7 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             readonly type: "array";
             readonly itemType: "string";
             readonly required: true;
@@ -16333,7 +16580,7 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             readonly type: "array";
             readonly itemType: "string";
             readonly required: true;
@@ -16580,7 +16827,7 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             readonly type: "array";
             readonly itemType: "string";
             readonly required: true;
@@ -16716,7 +16963,7 @@ export declare const operations: 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 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.";
     readonly http: "GET";
     readonly path: "/studio/v1/themes";
     readonly streaming: "no";
@@ -16841,7 +17088,7 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             readonly type: "array";
             readonly itemType: "string";
             readonly required: true;
@@ -16959,7 +17206,7 @@ export declare const operations: readonly [{
             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 name: "request_id";
             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.";
@@ -17015,13 +17262,13 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             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 name: "expected_revision";
             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.";
@@ -17081,7 +17328,7 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "expectedRevision";
+            readonly name: "expected_revision";
             readonly type: "integer";
             readonly required: false;
             readonly description: "Brief revision the caller read; a mismatch is refused with REVISION_CONFLICT rather than merged.";
@@ -17097,19 +17344,19 @@ export declare const operations: readonly [{
             readonly required: false;
             readonly description: "Source files to keep with the brief, added to the ones already attached.";
         }, {
-            readonly name: "addPoints";
+            readonly name: "add_points";
             readonly type: "array";
-            readonly itemType: "string";
+            readonly itemType: "object";
             readonly required: false;
-            readonly description: "New requirement points to split out of the brief; each receives the next free key in order.";
+            readonly 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).";
         }, {
-            readonly name: "editPoints";
+            readonly name: "edit_points";
             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 name: "remove_points";
             readonly type: "array";
             readonly itemType: "string";
             readonly required: false;
@@ -17176,7 +17423,7 @@ export declare const operations: readonly [{
             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 name: "derived_from";
             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.";
@@ -17186,7 +17433,7 @@ export declare const operations: readonly [{
             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 name: "request_id";
             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.";
@@ -17240,13 +17487,13 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: true;
         readonly fields: readonly [{
-            readonly name: "updateMask";
+            readonly name: "update_mask";
             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 name: "expected_revision";
             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.";
@@ -17322,6 +17569,54 @@ export declare const operations: readonly [{
         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.renditions";
+    readonly method: "create";
+    readonly summary: "Create a rendition of a draft for a platform";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/drafts/{draft}/renditions";
+    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: "platform";
+            readonly type: "string";
+            readonly required: true;
+            readonly 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.";
+        }, {
+            readonly name: "theme";
+            readonly type: "string";
+            readonly required: false;
+            readonly description: "Theme to render with, a thm_ identifier or a built-in key from the theme list; omit it to use the platform default.";
+        }, {
+            readonly name: "settings";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Per-rendition settings; each platform reads only the settings that apply to it and ignores the rest.";
+        }, {
+            readonly name: "render";
+            readonly type: "boolean";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "request_id";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }];
+    };
 }, {
     readonly resource: "studio.works.drafts";
     readonly method: "retrieveReview";
@@ -17525,12 +17820,181 @@ export declare const operations: readonly [{
     readonly body: {
         readonly required: false;
         readonly fields: readonly [{
-            readonly name: "expectedRevision";
+            readonly name: "expected_revision";
             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.renditions";
+    readonly method: "list";
+    readonly summary: "List the renditions of a work";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/renditions";
+    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 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.";
+    }, {
+        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.works.renditions";
+    readonly method: "delete";
+    readonly summary: "Delete a rendition";
+    readonly 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.";
+    readonly http: "DELETE";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.renditions";
+    readonly method: "retrieve";
+    readonly summary: "Read one rendition";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.renditions";
+    readonly method: "update";
+    readonly summary: "Change the theme or settings of a rendition";
+    readonly 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.";
+    readonly http: "PATCH";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [];
+    readonly body: {
+        readonly required: true;
+        readonly fields: readonly [{
+            readonly name: "update_mask";
+            readonly type: "array";
+            readonly itemType: "string";
+            readonly required: true;
+            readonly description: "Field paths this call changes: theme, settings or both; a field left out keeps its value.";
+        }, {
+            readonly name: "theme";
+            readonly type: "string";
+            readonly required: false;
+            readonly 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.";
+        }, {
+            readonly name: "settings";
+            readonly type: "object";
+            readonly required: false;
+            readonly description: "Per-rendition settings; each platform reads only the settings that apply to it and ignores the rest.";
+        }];
+    };
+}, {
+    readonly resource: "studio.works.renditions";
+    readonly method: "retrieveContent";
+    readonly summary: "Get a download URL for a rendition file";
+    readonly 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.";
+    readonly http: "GET";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}/content";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [{
+        readonly name: "part";
+        readonly type: "integer";
+        readonly required: false;
+        readonly 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.";
+    }];
+}, {
+    readonly resource: "studio.works.renditions";
+    readonly method: "publish";
+    readonly summary: "Export a rendition";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}:publish";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [];
+}, {
+    readonly resource: "studio.works.renditions";
+    readonly method: "render";
+    readonly summary: "Render a rendition again from the current draft";
+    readonly 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.";
+    readonly http: "POST";
+    readonly path: "/studio/v1/works/{work}/renditions/{rendition}:render";
+    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: "rendition";
+        readonly sdkName: "rendition";
+        readonly description: "Rendition being addressed, by its rnd_ identifier from the rendition list or from the create answer.";
+    }];
+    readonly query: readonly [];
 }, {
     readonly resource: "studio.works.units";
     readonly method: "retrieve";