@deepraxis/sdk 0.1.1-dev.ea219e1 → 0.1.1-dev.ea4a5dd

package/dist/generated/types.gen.d.ts

@@ -7948,9 +7948,9 @@ export type ApplicationApplicationError = {
      */
     error: {
         /**
-         * Error code: *_NOT_FOUND (404; also for objects of another account), WORKER_NAME_TAKEN (409), WORKER_INVALID_STATE (409), DEPLOYMENT_IN_PROGRESS (409, retry later), INVALID_PARAMS (400), UNSUPPORTED (400, a Cloudflare feature this platform does not offer), LIMIT_EXCEEDED (400), DEPLOY_TIMEOUT (504), PROVIDER_FAILED (502), PROVIDER_CAPACITY (503), NOT_IMPLEMENTED (501).
+         * Error code: *_NOT_FOUND (404; also for objects of another account), WORKER_NAME_TAKEN (409), GRANT_ALIAS_CONFLICT (409), GRANT_CONFLICT (409), WORKER_INVALID_STATE (409), DEPLOYMENT_IN_PROGRESS (409, retry later), INVALID_PARAMS (400), UNSUPPORTED (400, a Cloudflare feature this platform does not offer), LIMIT_EXCEEDED (400), DEPLOY_TIMEOUT (504), PROVIDER_FAILED (502), PROVIDER_CAPACITY (503), NOT_IMPLEMENTED (501).
          */
-        code: 'WORKER_NOT_FOUND' | 'VERSION_NOT_FOUND' | 'DEPLOYMENT_NOT_FOUND' | 'COMPONENT_NOT_FOUND' | 'SECRET_NOT_FOUND' | 'GRANT_NOT_FOUND' | 'RESOURCE_NOT_FOUND' | 'WORKER_NAME_TAKEN' | 'WORKER_INVALID_STATE' | 'DEPLOYMENT_IN_PROGRESS' | 'INVALID_PARAMS' | 'UNSUPPORTED' | 'LIMIT_EXCEEDED' | 'DEPLOY_TIMEOUT' | 'PROVIDER_FAILED' | 'PROVIDER_CAPACITY' | 'NOT_IMPLEMENTED';
+        code: 'WORKER_NOT_FOUND' | 'VERSION_NOT_FOUND' | 'DEPLOYMENT_NOT_FOUND' | 'COMPONENT_NOT_FOUND' | 'SECRET_NOT_FOUND' | 'GRANT_NOT_FOUND' | 'GRANT_ALIAS_CONFLICT' | 'GRANT_CONFLICT' | 'RESOURCE_NOT_FOUND' | 'WORKER_NAME_TAKEN' | 'WORKER_INVALID_STATE' | 'DEPLOYMENT_IN_PROGRESS' | 'INVALID_PARAMS' | 'UNSUPPORTED' | 'LIMIT_EXCEEDED' | 'DEPLOY_TIMEOUT' | 'PROVIDER_FAILED' | 'PROVIDER_CAPACITY' | 'NOT_IMPLEMENTED';
         /**
          * What went wrong.
          */
@@ -8614,14 +8614,18 @@ export type ApplicationGrant = {
         /**
          * Resource type.
          */
-        type: 'database' | 'folder' | 'knowledge';
+        type: 'database' | 'files' | 'knowledge' | 'models';
         /**
-         * Resource ID.
+         * Database or knowledge base ID; * for files and models.
          */
         id: string;
     };
     /**
-     * Access level.
+     * Optional name, unique within this Worker. Conflicts return GRANT_ALIAS_CONFLICT (409).
+     */
+    alias?: string;
+    /**
+     * Access level; models accepts read only.
      */
     access: 'read' | 'read_write';
     /**
@@ -8631,20 +8635,24 @@ export type ApplicationGrant = {
 };
 export type ApplicationCreateGrantInput = {
     /**
-     * Resource to grant.
+     * Resource to grant. Each (type, id) may be granted once per Worker; duplicates return GRANT_CONFLICT (409).
      */
     resource: {
         /**
          * Resource type.
          */
-        type: 'database' | 'folder' | 'knowledge';
+        type: 'database' | 'files' | 'knowledge' | 'models';
         /**
-         * Resource ID in your account.
+         * Database or knowledge base ID in your organization; * for files and models.
          */
         id: string;
     };
     /**
-     * Access level.
+     * Optional name, unique within this Worker. Available for reuse after the grant is deleted.
+     */
+    alias?: string;
+    /**
+     * Access level; models accepts read only.
      */
     access: 'read' | 'read_write';
 };
@@ -10945,6 +10953,848 @@ export type AutomationHumanTaskDelegateInput = {
      */
     to_user: string;
 };
+export type CanvasCreateCanvasInput = {
+    /**
+     * Display name for the new canvas, at most 200 characters; omission uses Untitled.
+     */
+    name?: string;
+};
+export type CanvasCanvas = {
+    /**
+     * Assigned canvas identifier, cvs_ followed by 16 lowercase letters or digits; reuse it as canvas_id in subsequent requests.
+     */
+    id: string;
+    /**
+     * Resource discriminator; canvas identifies a design canvas.
+     */
+    object: 'canvas';
+    /**
+     * Display name supplied at creation; defaults to Untitled if omitted and is not an API identifier.
+     */
+    name: string;
+    version: CanvasVersion;
+    /**
+     * Number of visible top-level frames in this canvas; hidden frames do not contribute.
+     */
+    page_count: number;
+    /**
+     * Total number of design nodes currently in the canvas.
+     */
+    node_count: number;
+    /**
+     * ISO 8601 timestamp recording when this canvas was created.
+     */
+    created_at: string;
+    /**
+     * ISO 8601 timestamp of the latest canvas update; list orders canvases newest first by this value.
+     */
+    updated_at: string;
+    /**
+     * Console URL where a person can watch this canvas update live; open it to review drawing results.
+     */
+    viewer_url: string;
+};
+export type CanvasCanvasPage = {
+    /**
+     * Canvases accessible to the API key's organization, ordered by updated_at descending.
+     */
+    data: Array<CanvasCanvas>;
+    /**
+     * Opaque cursor to pass as cursor on the next list request; null means no more results.
+     */
+    next_cursor: string | null;
+};
+export type CanvasCanvasDetail = CanvasCanvas & {
+    /**
+     * Summaries of top-level nodes in canvas order; use their ids to read full node documents or render images.
+     */
+    frames: Array<CanvasFrame>;
+    /**
+     * Reusable components in this canvas; use their ids when inspecting or referencing component designs.
+     */
+    components: Array<{
+        /**
+         * Node identifier of the reusable component; usable in node reads and script references.
+         */
+        id: string;
+        /**
+         * Display name of the reusable component for choosing which design to reuse.
+         */
+        name: string;
+    }>;
+};
+export type CanvasDeletedCanvas = {
+    /**
+     * Identifier of the canvas that was permanently deleted by this request.
+     */
+    id: string;
+    /**
+     * Resource discriminator; canvas identifies the deleted design canvas.
+     */
+    object: 'canvas';
+    /**
+     * Always true on successful permanent deletion; this content cannot be restored.
+     */
+    deleted: true;
+};
+export type CanvasNodesResult = {
+    version: CanvasVersion;
+    /**
+     * Map keyed by each requested node id or instance path; null means that id was not found.
+     */
+    nodes: {
+        [key: string]: {
+            /**
+             * Pencil .pen 2.21 node content, with descendants limited by depth when specified; use these design properties when preparing edits.
+             */
+            document: CanvasPenNode;
+        } | null;
+    };
+};
+export type CanvasImagesResult = {
+    /**
+     * Always null for a successful render response; request failures use the error envelope with a non-2xx status.
+     */
+    err: null;
+    /**
+     * Map keyed by requested node id, containing a PNG data URL or null when an image is unavailable; these are inline images rather than hosted URLs.
+     */
+    images: {
+        [key: string]: string | null;
+    };
+};
+export type CanvasCanvasError = {
+    /**
+     * Failure details for a non-2xx response; choose a recovery action using the operation's status and code description.
+     */
+    error: {
+        /**
+         * Machine-readable failure category; see this operation's error responses for triggering conditions and recovery actions.
+         */
+        code: string;
+        /**
+         * Human-readable explanation of why the request failed; use code and details for programmatic recovery.
+         */
+        message: string;
+        /**
+         * Optional error-specific context; script failures provide edit_id with optional line, column and rejection, and REVISION_CONFLICT provides the current version.
+         */
+        details?: {
+            /**
+             * Saved failed script id, valid for ten minutes; send it with edits to repair and rerun without resending the complete source.
+             */
+            edit_id?: string;
+            /**
+             * Optional source line reported for the script failure; use it to locate text for an edit.
+             */
+            line?: number;
+            /**
+             * Optional source column reported for the script failure; use it with line to locate the problem.
+             */
+            column?: number;
+            /**
+             * Optional operation rejection information; inspect it to correct the rejected design operation.
+             */
+            rejection?: unknown;
+            /**
+             * Current decimal revision on REVISION_CONFLICT; retrieve and merge the current canvas before retrying a guarded write.
+             */
+            version?: string;
+            [key: string]: unknown;
+        };
+    };
+};
+export type CanvasExecuteInput = unknown & {
+    /**
+     * New synchronous Pencil execute source using document as the root; provide this or edit_id, never both. See the operation's first-frame example.
+     */
+    script?: string;
+    /**
+     * Saved failed-script identifier from error.details.edit_id; use with edits instead of script within ten minutes of the failure.
+     */
+    edit_id?: string;
+    /**
+     * Text replacements applied to the source identified by edit_id before rerunning; use error line, column or rejection to choose the correction.
+     */
+    edits?: Array<{
+        /**
+         * Literal text to locate in the failed source saved under edit_id.
+         */
+        find: string;
+        /**
+         * Corrected text to substitute for the matched find text before execution.
+         */
+        replace: string;
+        /**
+         * Set true to replace every occurrence of find; omitted or false requires find to occur exactly once, and a missing or repeated match fails the retry without applying anything.
+         */
+        all?: boolean;
+    }>;
+    /**
+     * Revision from retrieve, nodes.list or the previous execute response; omit for an unguarded write. A mismatch returns 409 REVISION_CONFLICT with details.version.
+     */
+    expected_version?: string;
+};
+export type CanvasExecuteResult = {
+    version: CanvasVersion;
+    /**
+     * Number of design operations performed by the committed script.
+     */
+    operation_count: number;
+    /**
+     * Map from created result names to node identifiers; reuse the ids in nodes.list, images.list or subsequent scripts.
+     */
+    created: {
+        [key: string]: string;
+    };
+    /**
+     * String outputs produced by Print calls in script execution order.
+     */
+    prints: Array<string>;
+    /**
+     * Non-fatal design warnings from this execution; writes have committed, so inspect the affected nodes before making another edit.
+     */
+    warnings: Array<{
+        /**
+         * Machine-readable warning category identifying what to inspect in the design.
+         */
+        code: string;
+        /**
+         * Identifier of the node to inspect with nodes.list or images.list.
+         */
+        node_id: string;
+        /**
+         * Human-readable explanation of the design issue and its context.
+         */
+        message: string;
+    }>;
+    /**
+     * Node ids requested through TakeScreenshot; call images.list with up to four ids to obtain the actual PNG images.
+     */
+    screenshots: Array<string>;
+    /**
+     * Identifiers of top-level frames affected by the script; render these frames to review the edit.
+     */
+    touched_frames: Array<string>;
+    /**
+     * Global variable names still available for reuse in the next execute call on this canvas.
+     */
+    globals: Array<string>;
+    /**
+     * Console URL where a person can watch the canvas and inspect the committed visual result live.
+     */
+    viewer_url: string;
+};
+/**
+ * Organization-owned editing project; reuse its id for project operations.
+ */
+export type CutProject = {
+    /**
+     * Project id assigned by create; pass as project_id on subsequent requests.
+     */
+    id: string;
+    /**
+     * Human-readable editing project name; not an API identifier.
+     */
+    name: string;
+    /**
+     * Organization that owns the project and its editing history.
+     */
+    owner: string;
+    /**
+     * User-defined string labels for organizing projects; label keys retain their original spelling.
+     */
+    labels: {
+        [key: string]: string;
+    };
+    /**
+     * active projects can be edited; deleted projects are retained until purge_time and may be undeleted.
+     */
+    state: 'active' | 'deleted';
+    revision: CutRevision;
+    /**
+     * Rendering dimensions, frame rate and audio sample rate for this project.
+     */
+    settings: CutSettings;
+    /**
+     * Named library bindings available to scripts, imports and exports.
+     */
+    bindings: Array<CutBinding>;
+    /**
+     * ISO 8601 timestamp when this project was created.
+     */
+    create_time: string;
+    /**
+     * ISO 8601 timestamp of the latest committed project update.
+     */
+    update_time: string;
+    /**
+     * ISO 8601 deadline for permanent removal of a deleted project; absent for active projects.
+     */
+    purge_time?: string;
+};
+/**
+ * Create a blank project bound to the media libraries it may use.
+ */
+export type CutCreateProjectInput = {
+    /**
+     * Human-readable project name; required and must contain non-whitespace text.
+     */
+    name: string;
+    /**
+     * User-defined string labels for organizing projects; label keys retain their original spelling.
+     */
+    labels?: {
+        [key: string]: string;
+    };
+    settings: CutSettingsInput;
+    /**
+     * Accessible library bindings; exactly one read_write entry must have default_upload true.
+     */
+    bindings: Array<CutBinding>;
+};
+/**
+ * One page of organization-accessible projects.
+ */
+export type CutProjectPage = {
+    /**
+     * Resources in this page; continue with next_page_token when present.
+     */
+    projects: Array<CutProject>;
+    /**
+     * Opaque continuation token for page_token on the next request; absent when no more results remain.
+     */
+    next_page_token?: string;
+};
+export type CutProjectDetail = CutProject & {
+    /**
+     * Complete second-based timeline, present when expand includes timeline.
+     */
+    timeline?: CutTimeline;
+    /**
+     * Project exports, present when expand includes exports.
+     */
+    exports?: Array<CutExport>;
+    /**
+     * Saved project versions, present when expand includes versions.
+     */
+    versions?: Array<CutVersion>;
+};
+/**
+ * Update only the named project metadata fields; timeline edits use execute.
+ */
+export type CutUpdateProjectInput = {
+    /**
+     * Replacement display name when update_mask includes name.
+     */
+    name?: string;
+    /**
+     * User-defined string labels for organizing projects; label keys retain their original spelling.
+     */
+    labels?: {
+        [key: string]: string;
+    };
+    /**
+     * Metadata fields to replace; name changes the display name and labels replaces all labels.
+     */
+    update_mask: Array<'name' | 'labels'>;
+};
+/**
+ * Committed revision and outputs from a successful synchronous editing script.
+ */
+export type CutExecuteResult = {
+    revision: CutRevision;
+    /**
+     * Committed edit counts and second-based duration changes.
+     */
+    summary: CutSummary;
+    /**
+     * Script result names mapped to newly created clip or track ids; keys retain their original spelling.
+     */
+    created: {
+        [key: string]: string;
+    };
+    /**
+     * String output from Print calls in execution order.
+     */
+    prints: Array<string>;
+    /**
+     * Non-fatal issues to inspect after the edit committed.
+     */
+    warnings: Array<{
+        /**
+         * Machine-readable warning category used to select a follow-up check.
+         */
+        code: string;
+        /**
+         * Affected clip identifier; use GetItem or inspect the timeline.
+         */
+        clip_id?: string;
+        /**
+         * Human-readable explanation of the warning.
+         */
+        message: string;
+    }>;
+    /**
+     * Optional rendered previews keyed by requested time in seconds.
+     */
+    frames?: {
+        [key: string]: CutRenderRef;
+    };
+};
+export type CutExecuteInput = unknown & {
+    /**
+     * Synchronous editing source using Cut execute functions; submit this or edit_id, never both. Script source is opaque: function names and object fields inside JavaScript use their documented camelCase spelling.
+     */
+    script?: string;
+    /**
+     * Saved failed script identifier from error.details.edit_id; valid for ten minutes.
+     */
+    edit_id?: string;
+    /**
+     * Literal replacements applied to the saved source before rerunning.
+     */
+    edits?: Array<{
+        /**
+         * Literal source text to locate in the saved script.
+         */
+        find: string;
+        /**
+         * Replacement source text; passed to the script without renaming fields.
+         */
+        replace: string;
+        /**
+         * True replaces every occurrence; false or omission requires exactly one match.
+         */
+        all?: boolean;
+    }>;
+    expected_revision?: CutRevision;
+};
+/**
+ * Lightweight editing context before preparing a script.
+ */
+export type CutState = {
+    revision: CutRevision;
+    /**
+     * Current rendering settings for the project.
+     */
+    settings: CutSettings;
+    /**
+     * Current project duration. In seconds, not frames or microseconds.
+     */
+    duration_sec: number;
+    /**
+     * Track summaries and clip counts.
+     */
+    tracks: Array<CutTrackSummary>;
+    /**
+     * Libraries currently available to the project.
+     */
+    bindings: Array<CutBinding>;
+    /**
+     * Number of clips with unavailable media requiring attention.
+     */
+    offline_count: number;
+};
+export type CutTimelineResult = {
+    revision: CutRevision;
+    /**
+     * full returns the structured timeline.
+     */
+    view: 'full';
+    timeline: CutTimeline;
+} | {
+    revision: CutRevision;
+    /**
+     * compact returns human-readable editing context.
+     */
+    view: 'compact';
+    /**
+     * Compact timeline description with second-based positions, suitable as context for an editing script.
+     */
+    text: string;
+};
+/**
+ * Rendered images from one project revision.
+ */
+export type CutFramesResult = {
+    revision: CutRevision;
+    /**
+     * Requested times in seconds mapped to rendered images; keys retain their numeric spelling.
+     */
+    images: {
+        [key: string]: CutRenderRef;
+    };
+};
+/**
+ * Analysis status and available ranges for each source asset and kind.
+ */
+export type CutAnalysisResult = {
+    /**
+     * Per-asset analysis outcomes.
+     */
+    results: Array<{
+        media: CutMediaRef;
+        /**
+         * Source asset version analyzed; changes when that asset is overwritten.
+         */
+        version: number;
+        /**
+         * silence identifies quiet spans; filler identifies filler-word spans; scenes identifies scene ranges.
+         */
+        kind: 'silence' | 'filler' | 'scenes';
+        /**
+         * pending means analysis is still running; ready means segments are available; unsupported means this asset or analysis kind is inapplicable; failed means analysis did not complete.
+         */
+        status: 'pending' | 'ready' | 'unsupported' | 'failed';
+        /**
+         * Detected source ranges in seconds, available when status is ready.
+         */
+        segments?: Array<{
+            /**
+             * Inclusive source range start. In seconds, not frames or microseconds.
+             */
+            from: number;
+            /**
+             * Source range end. In seconds, not frames or microseconds.
+             */
+            to: number;
+            /**
+             * Optional human-readable classification for this range.
+             */
+            label?: string;
+            /**
+             * Optional confidence score for this detection.
+             */
+            confidence?: number;
+        }>;
+        /**
+         * Suggested delay before checking a pending analysis again. In seconds, not frames or microseconds.
+         */
+        retry_after_sec?: number;
+    }>;
+};
+/**
+ * Select analysis kinds and optionally limit source assets.
+ */
+export type CutAnalysisInput = {
+    /**
+     * Bound-library assets to analyze; omission selects project media.
+     */
+    media?: Array<CutMediaRef>;
+    /**
+     * Analysis types to request for the selected source assets.
+     */
+    kinds: Array<'silence' | 'filler' | 'scenes'>;
+};
+/**
+ * Current project media library bindings.
+ */
+export type CutBindingsResult = {
+    /**
+     * Named libraries available to scripts and media operations.
+     */
+    bindings: Array<CutBinding>;
+};
+/**
+ * A named project link to a media library. Exactly one read_write binding must be default_upload.
+ */
+export type CutBinding = {
+    /**
+     * Unique binding alias used in imports and exports; begins with a lowercase letter.
+     */
+    name: string;
+    /**
+     * Media library id from praxis.media.libraries.create or list; must be accessible to this organization.
+     */
+    library_id: string;
+    /**
+     * read permits using library assets; read_write also permits imports and exports into the library.
+     */
+    access: 'read' | 'read_write';
+    /**
+     * True selects the one read_write library used when an import or export omits binding.
+     */
+    default_upload: boolean;
+};
+/**
+ * Attach a media library using a project-local name.
+ */
+export type CutBindingInput = {
+    binding: CutBinding;
+};
+/**
+ * Confirmation that the unused binding was detached.
+ */
+export type CutDeletedBinding = {
+    /**
+     * Always true after the requested binding has been removed.
+     */
+    deleted: boolean;
+};
+export type CutImportedMedia = CutMediaRef & {
+    /**
+     * Source media facts returned after import.
+     */
+    info: {
+        /**
+         * Destination library containing the imported asset.
+         */
+        library_id: string;
+        /**
+         * New asset identifier to use in execute script MediaRef objects.
+         */
+        asset_id: string;
+        /**
+         * Current source asset version after import.
+         */
+        version: number;
+        /**
+         * video is moving footage; audio is sound-only; image is a still visual.
+         */
+        kind: 'video' | 'audio' | 'image';
+        /**
+         * Source media duration, when time-based. In seconds, not frames or microseconds.
+         */
+        duration_sec?: number;
+        /**
+         * Source visual width in pixels, if available.
+         */
+        width?: number;
+        /**
+         * Source visual height in pixels, if available.
+         */
+        height?: number;
+        /**
+         * Source frames per second, if the source is video.
+         */
+        fps?: number;
+        /**
+         * True when the source includes an audio stream.
+         */
+        has_audio: boolean;
+    };
+};
+/**
+ * Import one external asset into a writable project library.
+ */
+export type CutMediaImportInput = {
+    /**
+     * Writable binding name from project bindings; omission uses default_upload.
+     */
+    binding?: string;
+    source: unknown & {
+        /**
+         * Publicly readable source URL to import.
+         */
+        url?: string;
+        /**
+         * Inline data URI containing the source bytes.
+         */
+        data_uri?: string;
+        /**
+         * Existing platform file id whose bytes should be imported.
+         */
+        file_id?: string;
+    };
+    /**
+     * Optional human-readable display name for the new media asset.
+     */
+    display_name?: string;
+};
+/**
+ * Asynchronous rendering job; retrieve by id until it reaches a terminal state.
+ */
+export type CutExport = {
+    /**
+     * Export id returned by create; use as export_id for retrieve or cancel.
+     */
+    id: string;
+    /**
+     * Project id whose timeline is being exported.
+     */
+    project_id: string;
+    /**
+     * Organization that owns this export job.
+     */
+    owner: string;
+    revision: CutRevision;
+    /**
+     * queued awaits capacity; fetching loads sources; rendering renders chunks; stitching joins chunks; saving writes the asset; done means output is ready; failed means inspect error; canceled means no further output is expected.
+     */
+    status: 'queued' | 'fetching' | 'rendering' | 'stitching' | 'saving' | 'done' | 'failed' | 'canceled';
+    /**
+     * Effective video rendering options for this job.
+     */
+    output: CutExportOutput;
+    /**
+     * Bound library receiving the completed export.
+     */
+    target: {
+        /**
+         * Project binding alias chosen for the output.
+         */
+        binding: string;
+        /**
+         * Destination media library identifier.
+         */
+        library_id: string;
+    };
+    /**
+     * Rendering progress; partial progress is not successful completion.
+     */
+    progress: {
+        /**
+         * Number of render work units completed.
+         */
+        done: number;
+        /**
+         * Total render work units planned.
+         */
+        total: number;
+        /**
+         * pending means audio processing has not finished; done means audio is ready.
+         */
+        audio: 'pending' | 'done';
+    };
+    /**
+     * Output media reference, available after the export reaches done.
+     */
+    asset?: CutMediaRef;
+    /**
+     * Failure information, present when the export failed.
+     */
+    error?: {
+        /**
+         * Machine-readable failure code used to choose a recovery action.
+         */
+        code: string;
+        /**
+         * Human-readable explanation of the export failure.
+         */
+        message: string;
+        /**
+         * Optional index of the failed render chunk.
+         */
+        chunk?: number;
+        /**
+         * Optional lower-level explanation of the render failure.
+         */
+        cause?: string;
+    };
+    /**
+     * ISO 8601 timestamp when this export was accepted.
+     */
+    create_time: string;
+    /**
+     * ISO 8601 timestamp when this export reached a terminal state.
+     */
+    finish_time?: string;
+    /**
+     * Elapsed wall-clock rendering time in milliseconds, when available.
+     */
+    wall_ms?: number;
+};
+/**
+ * Start an export from a project revision into a bound library.
+ */
+export type CutExportInput = {
+    /**
+     * Optional render settings; omitted fields use the project export defaults.
+     */
+    output?: CutExportOutput;
+    /**
+     * Writable binding name used as the export destination; omission uses default_upload.
+     */
+    binding?: string;
+    revision?: CutRevision;
+};
+/**
+ * One page of organization-accessible exports.
+ */
+export type CutExportPage = {
+    /**
+     * Resources in this page; continue with next_page_token when present.
+     */
+    exports: Array<CutExport>;
+    /**
+     * Opaque continuation token for page_token on the next request; absent when no more results remain.
+     */
+    next_page_token?: string;
+};
+/**
+ * One page of organization-accessible versions.
+ */
+export type CutVersionPage = {
+    /**
+     * Resources in this page; continue with next_page_token when present.
+     */
+    versions: Array<CutVersion>;
+    /**
+     * Opaque continuation token for page_token on the next request; absent when no more results remain.
+     */
+    next_page_token?: string;
+};
+/**
+ * Saved project snapshot; restore its id to create a new current revision.
+ */
+export type CutVersion = {
+    /**
+     * Version id returned by versions.create or list; pass as version_id to restore.
+     */
+    id: string;
+    /**
+     * Identifier of the project this version belongs to.
+     */
+    project_id: string;
+    revision: CutRevision;
+    /**
+     * Optional human-readable label supplied when saving this version.
+     */
+    label?: string;
+    /**
+     * ISO 8601 timestamp when this version was saved.
+     */
+    create_time: string;
+    /**
+     * Creator identity recorded as human:<user-id> or agent:<user-id>.
+     */
+    actor: string;
+};
+/**
+ * Save the current project revision with an optional label.
+ */
+export type CutVersionInput = {
+    /**
+     * Human-readable snapshot label, such as Before captions.
+     */
+    label?: string;
+};
+/**
+ * Committed transaction produced by restoring a saved version.
+ */
+export type CutTransaction = {
+    revision: CutRevision;
+    /**
+     * Identity that restored the version, as human:<id> or agent:<id>.
+     */
+    actor: string;
+    /**
+     * Applied operation records; time values are seconds and other fields depend on op.
+     */
+    ops: Array<{
+        /**
+         * Operation name such as insert, update, delete, split, trim, move, track_add or settings_update.
+         */
+        op: string;
+        [key: string]: unknown;
+    }>;
+    summary: CutSummary;
+    /**
+     * ISO 8601 timestamp when this transaction committed.
+     */
+    time: string;
+};
 export type DatabaseCreateDatabaseInput = {
     /**
      * Display name for the database: 1–64 visible characters after trimming; control characters are rejected. It is not an identifier, so later calls still use the returned id.
@@ -19097,7 +19947,7 @@ export type AgentManaged89 = {
     type: 'text';
 };
 /**
- * Model identifier and configuration of the agent.
+ * Conversation model; required on creation except for kind assume. Forbidden and omitted on assume agents, which are driven by an external MCP client.
  */
 export type AgentManaged38 = {
     /**
@@ -21625,6 +22475,315 @@ export type AutomationHumanTaskOutcome = {
      */
     responses: Array<AutomationHumanTaskResponse>;
 };
+/**
+ * Current revision as a decimal string, incremented by one after each successful write; pass it as expected_version to guard a subsequent execute call.
+ */
+export type CanvasVersion = string;
+export type CanvasFrame = {
+    /**
+     * Top-level node identifier; use in nodes.list, images.list or an execute script.
+     */
+    id: string;
+    /**
+     * Human-readable node name, or null if no name is assigned.
+     */
+    name: string | null;
+    /**
+     * Pencil node kind for this top-level item, such as frame or group; read nodes.list for its full content.
+     */
+    type: string;
+    /**
+     * Horizontal position of the top-level node on the canvas, in design pixels.
+     */
+    x: number;
+    /**
+     * Vertical position of the top-level node on the canvas, in design pixels.
+     */
+    y: number;
+    /**
+     * Current width of the top-level node in design pixels.
+     */
+    width: number;
+    /**
+     * Current height of the top-level node in design pixels.
+     */
+    height: number;
+    /**
+     * Number of design nodes in this top-level node's subtree.
+     */
+    node_count: number;
+    /**
+     * Whether this top-level node defines a reusable component.
+     */
+    component: boolean;
+    /**
+     * Whether this top-level node is a placeholder awaiting design content.
+     */
+    placeholder: boolean;
+    /**
+     * Whether this top-level node is visible on the canvas.
+     */
+    visible: boolean;
+};
+/**
+ * A node document in pen.dev (Pencil) .pen schema 2.21, not a Figma node. Node-specific design properties are preserved as open fields; frame/group/rectangle/ellipse/polygon/path/text/icon/ref/note use their .pen properties.
+ */
+export type CanvasPenNode = {
+    [key: string]: unknown;
+};
+/**
+ * Committed project revision from retrieve, state, timeline or execute; increases after each successful write.
+ */
+export type CutRevision = number;
+/**
+ * Current project rendering settings, including the normalized rational frame rate.
+ */
+export type CutSettings = {
+    /**
+     * Output width in pixels; even integer between 16 and 4096.
+     */
+    width: number;
+    /**
+     * Output height in pixels; even integer between 16 and 4096.
+     */
+    height: number;
+    /**
+     * Exact frames-per-second fraction used to snap second-based edits to project frames.
+     */
+    fps: CutFrameRate;
+    /**
+     * Background color as #RRGGBB or #RRGGBBAA; omission uses black.
+     */
+    background: string;
+    /**
+     * Project audio sample rate in hertz; fixed at 48000.
+     */
+    sample_rate: 48000;
+};
+/**
+ * Failure envelope returned with a non-success HTTP status.
+ */
+export type CutCutError = {
+    /**
+     * Domain failure and optional recovery context.
+     */
+    error: {
+        /**
+         * Machine-readable Cut error code; use the operation status description to choose recovery.
+         */
+        code: string;
+        /**
+         * Human-readable explanation of the failed request.
+         */
+        message: string;
+        /**
+         * Error-specific context; script failures may include an edit_id for a source-patch retry.
+         */
+        details?: {
+            /**
+             * Saved failed script id; use with edits within ten minutes.
+             */
+            edit_id?: string;
+            /**
+             * Committed project revision from retrieve, state, timeline or execute; increases after each successful write.
+             */
+            revision?: number;
+            /**
+             * Optional source line where script evaluation failed.
+             */
+            line?: number;
+            /**
+             * Optional source column where script evaluation failed.
+             */
+            column?: number;
+            /**
+             * Number of timeline references preventing the requested binding removal.
+             */
+            references?: number;
+            /**
+             * Rejected editing operations; the whole transaction was rolled back.
+             */
+            rejections?: Array<{
+                /**
+                 * Zero-based index of the rejected operation in the transaction.
+                 */
+                op_index: number;
+                /**
+                 * Machine-readable rejection cause, such as LOCKED_TRACK or OUT_OF_SOURCE.
+                 */
+                code: string;
+                /**
+                 * Human-readable explanation of the rejected operation.
+                 */
+                message: string;
+            }>;
+            [key: string]: unknown;
+        };
+    };
+};
+/**
+ * Dimensions and frame rate for a new editing project.
+ */
+export type CutSettingsInput = {
+    /**
+     * Output width in pixels; even integer between 16 and 4096.
+     */
+    width: number;
+    /**
+     * Output height in pixels; even integer between 16 and 4096.
+     */
+    height: number;
+    /**
+     * Project frames per second, as a positive number or an exact num/den fraction.
+     */
+    fps: number | CutFrameRate;
+    /**
+     * Background color as #RRGGBB or #RRGGBBAA; omission uses black.
+     */
+    background?: string;
+};
+/**
+ * Full timeline at one revision; positions and lengths are seconds.
+ */
+export type CutTimeline = {
+    /**
+     * Total duration derived from the latest clip end. In seconds, not frames or microseconds.
+     */
+    duration: number;
+    /**
+     * Ordered tracks, topmost visual layer first.
+     */
+    tracks: Array<CutTrack>;
+    /**
+     * Named points on the timeline.
+     */
+    markers: Array<CutMarker>;
+};
+/**
+ * Counts and duration changes committed by an editing transaction.
+ */
+export type CutSummary = {
+    /**
+     * Number of clips added by the transaction.
+     */
+    added: number;
+    /**
+     * Number of clips removed by the transaction.
+     */
+    removed: number;
+    /**
+     * Number of clips changed by the transaction.
+     */
+    modified: number;
+    /**
+     * Project duration before the transaction. In seconds, not frames or microseconds.
+     */
+    duration_before: number;
+    /**
+     * Project duration after the transaction. In seconds, not frames or microseconds.
+     */
+    duration_after: number;
+    /**
+     * Human-readable descriptions of the committed edits.
+     */
+    lines: Array<string>;
+};
+/**
+ * Rendered image available until its signed URL expires.
+ */
+export type CutRenderRef = {
+    /**
+     * Fetchable image URL for this render result.
+     */
+    url: string;
+    /**
+     * Rendered image width in pixels.
+     */
+    width: number;
+    /**
+     * Rendered image height in pixels.
+     */
+    height: number;
+    /**
+     * ISO 8601 timestamp after which the image URL must be refreshed.
+     */
+    expires_at: string;
+};
+/**
+ * Compact track metadata without individual clip documents.
+ */
+export type CutTrackSummary = {
+    /**
+     * Track id created by AddTrack; reuse in Insert, UpdateTrack or DeleteTrack.
+     */
+    id: string;
+    /**
+     * Human-readable track name chosen by the editing script.
+     */
+    name: string;
+    /**
+     * video contains visual clips; audio contains sound clips; caption contains timed text.
+     */
+    kind: 'video' | 'audio' | 'caption';
+    /**
+     * True prevents editing clips on this track.
+     */
+    locked: boolean;
+    /**
+     * True hides a visual or caption track from the rendered output.
+     */
+    hidden?: boolean;
+    /**
+     * True silences an audio track.
+     */
+    muted?: boolean;
+    /**
+     * Zero-based layer order; zero is topmost.
+     */
+    index: number;
+    /**
+     * Number of clips on this track.
+     */
+    items: number;
+};
+/**
+ * Reference to an asset in a bound library; follows asset overwrites to the latest version rather than pinning a version.
+ */
+export type CutMediaRef = {
+    /**
+     * Identifier of a library present in the project bindings.
+     */
+    library_id: string;
+    /**
+     * Asset identifier returned by media import or praxis.media asset operations.
+     */
+    asset_id: string;
+};
+/**
+ * Rendering options for an exported video.
+ */
+export type CutExportOutput = {
+    /**
+     * mp4 produces an MPEG-4 video file.
+     */
+    format?: 'mp4';
+    /**
+     * Output video width in pixels.
+     */
+    width?: number;
+    /**
+     * Output video height in pixels.
+     */
+    height?: number;
+    /**
+     * Output frames per second.
+     */
+    fps?: number;
+    /**
+     * draft favors faster review renders; high favors final delivery quality.
+     */
+    quality?: 'draft' | 'high';
+};
 export type DatabaseField = {
     /**
      * Field identifier, prefixed fld_. Stable across renames; accepted wherever a field path parameter takes an id or name.
@@ -26517,6 +27676,77 @@ export type AutomationHumanTaskActor = {
      */
     display_name: string | null;
 };
+/**
+ * Exact project frame rate; num divided by den gives frames per second.
+ */
+export type CutFrameRate = {
+    /**
+     * Positive numerator of the project frame rate.
+     */
+    num: number;
+    /**
+     * Positive denominator of the project frame rate.
+     */
+    den: number;
+};
+/**
+ * Ordered timeline layer; index zero is the topmost layer.
+ */
+export type CutTrack = {
+    /**
+     * Track id created by AddTrack; reuse in Insert, UpdateTrack or DeleteTrack.
+     */
+    id: string;
+    /**
+     * Human-readable track name chosen by the editing script.
+     */
+    name: string;
+    /**
+     * video contains visual clips; audio contains sound clips; caption contains timed text.
+     */
+    kind: 'video' | 'audio' | 'caption';
+    /**
+     * True prevents editing clips on this track.
+     */
+    locked: boolean;
+    /**
+     * True hides a visual or caption track from the rendered output.
+     */
+    hidden?: boolean;
+    /**
+     * True silences an audio track.
+     */
+    muted?: boolean;
+    /**
+     * Audio track gain in decibels; added to the clip audio level.
+     */
+    gain_db?: number;
+    /**
+     * Default caption styling for this track.
+     */
+    style?: CutTextStyle;
+    /**
+     * Clips on the track in timeline order.
+     */
+    items: Array<CutItem>;
+};
+/**
+ * A named point on the project timeline.
+ */
+export type CutMarker = {
+    /**
+     * Marker identifier used in the editing transaction.
+     */
+    id: string;
+    /**
+     * Marker position on the project timeline. In seconds, not frames or microseconds.
+     */
+    at: number;
+    /**
+     * Human-readable annotation shown at this timeline point.
+     */
+    label: string;
+};
 export type KnowledgeStaticChunking = {
     /**
      * static selects explicit chunk-size and overlap settings.
@@ -27253,6 +28483,166 @@ export type AnthropicToolReferenceBlock = {
      */
     type: 'tool_reference';
 };
+/**
+ * Text and caption styling in output pixels.
+ */
+export type CutTextStyle = {
+    /**
+     * Geist is the Latin typeface; Noto Sans SC is the simplified Chinese typeface.
+     */
+    font_family?: 'Geist' | 'Noto Sans SC';
+    /**
+     * Text size in output pixels.
+     */
+    font_size?: number;
+    /**
+     * Font weight: 400 is regular, 500 is medium and 700 is bold.
+     */
+    font_weight?: 400 | 500 | 700;
+    /**
+     * Text color in #RRGGBB or #RRGGBBAA notation.
+     */
+    color?: string;
+    /**
+     * Optional text outline.
+     */
+    stroke?: {
+        /**
+         * Outline color as a hexadecimal RGB or RGBA color.
+         */
+        color?: string;
+        /**
+         * Outline width in output pixels.
+         */
+        width?: number;
+    };
+    /**
+     * Optional text background color as hexadecimal RGB or RGBA.
+     */
+    background?: string;
+    /**
+     * left aligns the text to its left edge; center centers it; right aligns its right edge.
+     */
+    align?: 'left' | 'center' | 'right';
+    /**
+     * Maximum text width as a fraction of the output canvas width.
+     */
+    max_width?: number;
+    /**
+     * Caption placement: top is near the upper edge, middle is centered, bottom is near the lower edge.
+     */
+    position?: 'top' | 'middle' | 'bottom';
+    /**
+     * Optional color applied to the currently spoken caption word.
+     */
+    highlight_color?: string;
+    /**
+     * Maximum caption line count; fixed at 2.
+     */
+    max_lines?: 2;
+};
+/**
+ * Timeline clip or caption; fields depend on type and all media positions use seconds.
+ */
+export type CutItem = {
+    /**
+     * Clip identifier used by GetItem, Update, Delete, Split, Trim and Move.
+     */
+    id: string;
+    /**
+     * video references moving footage; image references a still; text displays styled text; color fills a region; audio plays sound; caption displays transcript text.
+     */
+    type: 'video' | 'image' | 'text' | 'color' | 'audio' | 'caption';
+    /**
+     * Clip start on the project timeline. In seconds, not frames or microseconds.
+     */
+    start: number;
+    /**
+     * Clip duration on the project timeline. In seconds, not frames or microseconds.
+     */
+    length: number;
+    /**
+     * Bound-library source asset used by video, image or audio clips.
+     */
+    media?: CutMediaRef;
+    /**
+     * Source media offset where this clip starts reading. In seconds, not frames or microseconds.
+     */
+    source_in?: number;
+    /**
+     * Playback speed multiplier; fixed at 1.
+     */
+    speed?: 1;
+    /**
+     * Clip audio level in decibels; 0 preserves the source level.
+     */
+    volume_db?: number;
+    /**
+     * Visual placement for this clip.
+     */
+    transform?: CutTransform;
+    /**
+     * contain preserves all content with possible empty margins; cover crops to fill; fill stretches; none keeps natural size.
+     */
+    fit?: 'contain' | 'cover' | 'fill' | 'none';
+    /**
+     * asset_deleted means the asset is gone; library_unbound means the binding was removed; access_denied means the caller cannot read it; source_shorter means the source no longer covers this clip.
+     */
+    offline?: 'asset_deleted' | 'library_unbound' | 'access_denied' | 'source_shorter';
+    /**
+     * Visible text for a text clip or caption.
+     */
+    text?: string;
+    /**
+     * Per-clip text styling where this clip type supports it.
+     */
+    style?: CutTextStyle;
+    /**
+     * Fill color for a color clip as #RRGGBB or #RRGGBBAA.
+     */
+    color?: string;
+    /**
+     * Audio fade-in duration. In seconds, not frames or microseconds.
+     */
+    fade_in?: number;
+    /**
+     * Audio fade-out duration. In seconds, not frames or microseconds.
+     */
+    fade_out?: number;
+    /**
+     * Audio ducking relative to another track.
+     */
+    duck?: {
+        /**
+         * Track id whose activity triggers ducking.
+         */
+        under?: string;
+        /**
+         * Attenuated level in decibels while the other track is active.
+         */
+        to_db?: number;
+        /**
+         * Time to reach the attenuated level. In seconds, not frames or microseconds.
+         */
+        attack?: number;
+        /**
+         * Time to recover the original level. In seconds, not frames or microseconds.
+         */
+        release?: number;
+    };
+    /**
+     * Transition at the incoming clip edge.
+     */
+    transition_in?: CutTransition;
+    /**
+     * Transition at the outgoing clip edge.
+     */
+    transition_out?: CutTransition;
+    /**
+     * Optional per-word timing for a caption.
+     */
+    words?: Array<CutCaptionWord>;
+};
 export type SandboxSandboxIamToken = {
     /**
      * Audience of the workload token, stored exactly as provided.
@@ -27438,6 +28828,82 @@ export type AnthropicCitationsConfig = {
      */
     enabled: boolean;
 };
+/**
+ * Visual placement; coordinates are normalized canvas centers.
+ */
+export type CutTransform = {
+    /**
+     * Horizontal center as a fraction of the canvas width.
+     */
+    x?: number;
+    /**
+     * Vertical center as a fraction of the canvas height.
+     */
+    y?: number;
+    /**
+     * Scale multiplier relative to the fitted visual size; 1 keeps fitted size.
+     */
+    scale?: number;
+    /**
+     * Clockwise visual rotation in degrees.
+     */
+    rotation?: number;
+    /**
+     * Visible opacity from 0 for transparent to 1 for opaque.
+     */
+    opacity?: number;
+    /**
+     * Crop inset fractions for each edge.
+     */
+    crop?: {
+        /**
+         * Normalized crop inset at the top edge.
+         */
+        top?: number;
+        /**
+         * Normalized crop inset at the right edge.
+         */
+        right?: number;
+        /**
+         * Normalized crop inset at the bottom edge.
+         */
+        bottom?: number;
+        /**
+         * Normalized crop inset at the left edge.
+         */
+        left?: number;
+    };
+};
+/**
+ * Transition attached to the incoming or outgoing edge of a clip.
+ */
+export type CutTransition = {
+    /**
+     * fade blends with the background; dissolve blends clips; push_left and push_right slide clips; wipe_left reveals the next clip.
+     */
+    kind: 'fade' | 'dissolve' | 'push_left' | 'push_right' | 'wipe_left';
+    /**
+     * Transition duration. In seconds, not frames or microseconds.
+     */
+    length: number;
+};
+/**
+ * One word positioned on the caption timeline.
+ */
+export type CutCaptionWord = {
+    /**
+     * Displayed word text from the selected transcript.
+     */
+    text: string;
+    /**
+     * Word start on the project timeline. In seconds, not frames or microseconds.
+     */
+    start: number;
+    /**
+     * Word display duration. In seconds, not frames or microseconds.
+     */
+    length: number;
+};
 export type PraxisSdkSseGetBrowserV1SessionsSessionIdStream = BrowserStreamMessage;
 /**
  * One decoded SSE event. The data field contains the decoded JSON payload, or a documented string sentinel. SSE comments are keepalives, not events. Optional id/event fields are absent when the server does not send them.
@@ -27847,6 +29313,26 @@ export type AgentManaged34Writable = {
  * Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.
  */
 export type SandboxSandboxId = string;
+/**
+ * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+ */
+export type CanvasCanvasId = string;
+/**
+ * Project identifier returned by its create or list operation; use the id, not a display name.
+ */
+export type CutProjectId = string;
+/**
+ * Project-local binding alias from bindings.list; detach only after removing all clips that reference its library.
+ */
+export type CutBindingName = string;
+/**
+ * Export identifier returned by its create or list operation; use the id, not a display name.
+ */
+export type CutExportId = string;
+/**
+ * Version identifier returned by its create or list operation; use the id, not a display name.
+ */
+export type CutVersionId = string;
 /**
  * Cursor to start the list from
  */
@@ -27863,7 +29349,7 @@ export type ApplyAgentVersionData = {
     body?: never;
     path: {
         /**
-         * Agent identifier from agents.create or agents.list.
+         * Agent identifier from agents.create or agents.list. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -27926,7 +29412,7 @@ export type ApplyAgentVersionResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -27960,7 +29446,7 @@ export type ApplyAgentVersionResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | AgentManaged39;
+        multiagent?: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -28070,9 +29556,9 @@ export type ApplyAgentVersionResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -28454,7 +29940,7 @@ export type ApplyAgentVersionResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -28468,7 +29954,7 @@ export type UnarchiveAgentData = {
     body?: never;
     path: {
         /**
-         * Agent id from creation or listing.
+         * Agent id from creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -28597,7 +30083,7 @@ export type UnarchiveAgentResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -28656,7 +30142,7 @@ export type UnarchiveAgentResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | {
+        multiagent?: null | {
             /**
              * Agents the coordinator may spawn as session threads, each resolved to a specific
              * version.
@@ -29262,9 +30748,9 @@ export type UnarchiveAgentResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -29646,7 +31132,7 @@ export type UnarchiveAgentResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -29780,7 +31266,7 @@ export type ListCustomersData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -29889,7 +31375,7 @@ export type DeleteCustomerData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -29944,7 +31430,7 @@ export type GetCustomerData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -30048,7 +31534,7 @@ export type GetCustomerDeletionData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -30135,7 +31621,7 @@ export type BlockCustomerData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -30218,7 +31704,7 @@ export type UnblockCustomerData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -30297,7 +31783,7 @@ export type RevokeCustomerTokensData = {
     body?: never;
     path: {
         /**
-         * Active service agent id from agent creation or listing.
+         * Active service agent id from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
         /**
@@ -30343,7 +31829,7 @@ export type GetAgentAppearanceData = {
     body?: never;
     path: {
         /**
-         * Service agent id from agent creation or listing; with a customer access token, the agent the token was issued for.
+         * Service agent id from agent creation or listing; with a customer access token, the agent the token was issued for. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -30654,7 +32140,7 @@ export type CreateCustomerGrantCodeData = {
     };
     path: {
         /**
-         * Service agent id (agent_…) or its short identity number, from agent creation or listing.
+         * Service agent id (agent_…) or its short identity number, from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -30730,7 +32216,7 @@ export type CreateCustomerAccessTokenData = {
     };
     path: {
         /**
-         * Service agent id (agent_…) or its short identity number, from agent creation or listing.
+         * Service agent id (agent_…) or its short identity number, from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -30804,7 +32290,7 @@ export type RenewCustomerAccessTokenData = {
     body?: never;
     path: {
         /**
-         * Service agent id (agent_…) or its short identity number, from agent creation or listing.
+         * Service agent id (agent_…) or its short identity number, from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -30866,7 +32352,7 @@ export type DeleteCurrentCustomerAccessTokenData = {
     body?: never;
     path: {
         /**
-         * Service agent id (agent_…) or its short identity number, from agent creation or listing.
+         * Service agent id (agent_…) or its short identity number, from agent creation or listing. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -38550,7 +40036,7 @@ export type ListModelsData = {
         /**
          * Match any comma-separated declared protocol ID; omitted or empty includes all models. Combined with type and output_modalities using AND. Invalid IDs return 400 with all legal values.
          */
-        supported_api?: Array<'anthropic.messages' | 'cohere.rerank' | 'google.generateContent' | 'mistral.ocr' | 'openai.audio.speech' | 'openai.audio.transcriptions' | 'openai.chat.completions' | 'openai.embeddings' | 'openai.images.edits' | 'openai.images.generations' | 'openai.responses' | 'openai.videos'>;
+        supported_api?: Array<'anthropic.messages' | 'cohere.rerank' | 'google.generateContent' | 'mistral.ocr' | 'openai.audio.speech' | 'openai.audio.transcriptions' | 'openai.chat.completions' | 'openai.embeddings' | 'openai.images.edits' | 'openai.images.generations' | 'openai.responses' | 'openai.videos' | 'typesafe.systemone'>;
         /**
          * Filter by one or more model types (comma-separated).
          */
@@ -39534,6 +41020,251 @@ export type RemixVideoErrors = {
      */
     400: unknown;
 };
+export type CreateSystemoneData = {
+    body: {
+        /**
+         * Published model id from model.models.list with supported_apis containing typesafe.systemone; returned unchanged in the response.
+         */
+        model: string;
+        /**
+         * Shared content evaluated by every question, supplied as text, a JSON object or an array.
+         */
+        state: string | {
+            [key: string]: unknown;
+        } | Array<unknown>;
+        /**
+         * Non-empty map of caller-chosen question ids to typed questions; answers preserve these ids. noul evaluates yes/no, choice selects a named option, score rates ordered levels. box is unsupported.
+         */
+        questions: {
+            [key: string]: {
+                /**
+                 * noul asks a yes/no question and returns the probability of yes.
+                 */
+                type: 'noul';
+                /**
+                 * Optional instructions for this question; text, object, array or null. Omit to let the criteria supply the question context.
+                 */
+                instructions?: string | {
+                    [key: string]: unknown;
+                } | Array<unknown> | null;
+                /**
+                 * Optional descriptions of the true and false outcomes; only these two keys are accepted.
+                 */
+                criteria?: {
+                    /**
+                     * Description of the yes outcome used to evaluate this noul question.
+                     */
+                    true?: string | {
+                        [key: string]: unknown;
+                    } | Array<unknown> | null;
+                    /**
+                     * Description of the no outcome used to evaluate this noul question.
+                     */
+                    false?: string | {
+                        [key: string]: unknown;
+                    } | Array<unknown> | null;
+                };
+            } | {
+                /**
+                 * choice selects an option from the named criteria and returns every option probability.
+                 */
+                type: 'choice';
+                /**
+                 * Optional instructions for this question; text, object, array or null. Omit to let the criteria supply the question context.
+                 */
+                instructions?: string | {
+                    [key: string]: unknown;
+                } | Array<unknown> | null;
+                /**
+                 * One to 255 named options; each value describes that option as text, object, array or null. The selected choice is one of these keys.
+                 */
+                criteria: {
+                    [key: string]: string | {
+                        [key: string]: unknown;
+                    } | Array<unknown> | null;
+                };
+            } | {
+                /**
+                 * score evaluates ordered criteria from low to high and returns a normalized score.
+                 */
+                type: 'score';
+                /**
+                 * Optional instructions for this question; text, object, array or null. Omit to let the criteria supply the question context.
+                 */
+                instructions?: string | {
+                    [key: string]: unknown;
+                } | Array<unknown> | null;
+                /**
+                 * One to ten descriptive levels ordered from low to high; each is text, an object or an array. Legend keys in the answer index these levels.
+                 */
+                criteria: Array<string | {
+                    [key: string]: unknown;
+                } | Array<unknown>>;
+            };
+        };
+        /**
+         * Unsupported image assets. Supplying this field, including null or an empty collection, returns 400: images are not supported.
+         */
+        assets?: {
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    path?: never;
+    query?: never;
+    url: '/model/v1/systemone';
+};
+export type CreateSystemoneErrors = {
+    /**
+     * Missing model, state or questions; invalid question type or criteria size; box or assets unsupported. Correct the named field before retrying.
+     */
+    400: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Missing or invalid API credentials; supply a valid platform API key in Authorization: Bearer.
+     */
+    401: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Unknown model or MODEL_PROTOCOL_NOT_OFFERED; select a catalog model declaring typesafe.systemone.
+     */
+    404: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+    /**
+     * The platform or upstream is rate limited; wait before retrying the request.
+     */
+    429: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Upstream credentials, transport or response failed; retry later or choose another declared model.
+     */
+    502: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+    /**
+     * No available native System One line; retry later or choose another declared model.
+     */
+    503: {
+        type: string;
+        title: string;
+        status: number;
+        detail: string;
+        [key: string]: unknown;
+    };
+};
+export type CreateSystemoneError = CreateSystemoneErrors[keyof CreateSystemoneErrors];
+export type CreateSystemoneResponses = {
+    /**
+     * Typed answers keyed by the original question ids, token usage, and the actual customer charge in USD.
+     */
+    200: {
+        /**
+         * Model id exactly as supplied in the request, including any public alias or creator prefix.
+         */
+        model: string;
+        /**
+         * Results mapped by the caller's question ids; each discriminator matches that question's type.
+         */
+        answers: {
+            [key: string]: {
+                /**
+                 * Answer discriminator: noul corresponds to the question of the same type.
+                 */
+                type: 'noul';
+                /**
+                 * Calibrated probability that the answer to the yes/no question is yes.
+                 */
+                noul: number;
+            } | {
+                /**
+                 * Answer discriminator: choice corresponds to the question of the same type.
+                 */
+                type: 'choice';
+                /**
+                 * Selected option name, always a key from this question's criteria.
+                 */
+                choice: string;
+                /**
+                 * Certainty of the selected choice or score, distinct from the per-option probabilities.
+                 */
+                confidence: number;
+                /**
+                 * Probability of each caller-defined choice or zero-based score level; the probabilities sum to one.
+                 */
+                probabilities: {
+                    [key: string]: number;
+                };
+            } | {
+                /**
+                 * Answer discriminator: score corresponds to the question of the same type.
+                 */
+                type: 'score';
+                /**
+                 * Normalized rating across the ordered criteria, from the lowest to the highest level.
+                 */
+                score: number;
+                /**
+                 * Certainty of the selected choice or score, distinct from the per-option probabilities.
+                 */
+                confidence: number;
+                /**
+                 * Zero-based level keys mapped to their descriptions, with one key per request criterion.
+                 */
+                legend: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Probability of each caller-defined choice or zero-based score level; the probabilities sum to one.
+                 */
+                probabilities: {
+                    [key: string]: number;
+                };
+            };
+        };
+        /**
+         * Provider token counts and the actual input-only customer charge; output tokens are free.
+         */
+        usage: {
+            /**
+             * Authoritative upstream count of input tokens; the sole billed quantity for this operation.
+             */
+            input_tokens: number;
+            /**
+             * Upstream count of output tokens, returned for visibility and never charged.
+             */
+            output_tokens: number;
+            /**
+             * Actual customer charge in USD after micro-dollar rounding; exactly the value in X-Praxis-Cost-Usd, never upstream procurement cost.
+             */
+            cost: number;
+        };
+    };
+};
+export type CreateSystemoneResponse = CreateSystemoneResponses[keyof CreateSystemoneResponses];
 export type CreateAudioTranscriptionData = {
     body: {
         /**
@@ -45152,15 +46883,15 @@ export type AgentsListData = {
         limit?: number;
         page?: null | string;
         /**
-         * General agents use a durable computer and act for their owner; personal agents behave like general agents for now and are reserved for the personal agent; service agents use a clean environment per session.
+         * General agents use a durable computer and act for their owner; personal agents behave like general agents for now and are reserved for the personal agent; service agents use a clean environment per session. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind?: 'general' | 'personal' | 'service';
+        kind?: 'general' | 'personal' | 'service' | 'assume';
     };
     url: '/agent/v1/agents';
 };
 export type AgentsListErrors = {
     /**
-     * include_archived is not true or false, kind is not general, personal or service, a created_at bound is not an RFC 3339 timestamp, or INVALID_PARAMS when limit is not an integer from 1 to 100 (limit must be an integer between 1 and 100), or INVALID_PAGE_TOKEN when page is not a cursor from this same query (restart from the first page). Pass next_page unchanged, with the same filters, to continue.
+     * include_archived is not true or false, kind is not general, personal, service or assume, a created_at bound is not an RFC 3339 timestamp, or INVALID_PARAMS when limit is not an integer from 1 to 100 (limit must be an integer between 1 and 100), or INVALID_PAGE_TOKEN when page is not a cursor from this same query (restart from the first page). Pass next_page unchanged, with the same filters, to continue.
      */
     400: AgentError;
     /**
@@ -45206,7 +46937,7 @@ export type AgentsListResponses = {
             /**
              * Model identifier and configuration.
              */
-            model: {
+            model?: {
                 /**
                  * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
                  */
@@ -45240,7 +46971,7 @@ export type AgentsListResponses = {
             /**
              * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
              */
-            multiagent: null | AgentManaged39;
+            multiagent?: null | AgentManaged39;
             /**
              * Display name of the agent, as set on create or update. It is a label, not a unique key.
              */
@@ -45346,9 +47077,9 @@ export type AgentsListResponses = {
                 enabled?: boolean;
             }>;
             /**
-             * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+             * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
              */
-            kind: 'general' | 'personal' | 'service';
+            kind: 'general' | 'personal' | 'service' | 'assume';
             /**
              * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
              */
@@ -45730,7 +47461,7 @@ export type AgentsListResponses = {
              */
             environment_id?: string | null;
             /**
-             * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+             * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
              */
             vault_ids?: Array<string>;
             /**
@@ -45748,9 +47479,9 @@ export type AgentsListResponse = AgentsListResponses[keyof AgentsListResponses];
 export type AgentsCreateData = {
     body: {
         /**
-         * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
+         * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected. Forbidden and omitted on assume agents.
          */
-        model: string | {
+        model?: string | {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -45860,9 +47591,9 @@ export type AgentsCreateData = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
+         * Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind?: 'general' | 'personal' | 'service';
+        kind?: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined.
          */
@@ -46250,7 +47981,7 @@ export type AgentsCreateData = {
 };
 export type AgentsCreateErrors = {
     /**
-     * The body failed validation and the message names the field: an unknown field, name outside 1 to 256 characters, a model that is not in the catalog or cannot run an agent, invalid tools or tools: null, a skill that is anthropic, repeated or not found, invalid bindings or vault_ids, or an environment_id that does not exist. Correct the field and retry.
+     * The body failed validation and the message names the field: an unknown field, name outside 1 to 256 characters, a model that is not in the catalog or cannot run an agent, invalid tools or tools: null, a skill that is anthropic, repeated or not found, invalid bindings or vault_ids, or an environment_id that does not exist, or model, models, subagent_model, subagents or multiagent supplied on an assume agent. Correct the field and retry.
      */
     400: AgentError;
     /**
@@ -46296,7 +48027,7 @@ export type AgentsCreateResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -46330,7 +48061,7 @@ export type AgentsCreateResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | AgentManaged39;
+        multiagent?: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -46436,9 +48167,9 @@ export type AgentsCreateResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -46820,7 +48551,7 @@ export type AgentsCreateResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -46834,7 +48565,7 @@ export type AgentsRetrieveData = {
     body?: never;
     path: {
         /**
-         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.
+         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -46895,7 +48626,7 @@ export type AgentsRetrieveResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -46929,7 +48660,7 @@ export type AgentsRetrieveResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | AgentManaged39;
+        multiagent?: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -47039,9 +48770,9 @@ export type AgentsRetrieveResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -47423,7 +49154,7 @@ export type AgentsRetrieveResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -47450,7 +49181,7 @@ export type AgentsUpdateData = {
          */
         metadata?: null | AgentManaged58Writable;
         /**
-         * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
+         * A model id from the Praxis model catalog (`praxis.model.models.list`), or a `model_config` object for additional configuration control. Unlike Anthropic, Claude model ids other than those in the catalog are rejected. Forbidden and omitted on assume agents.
          */
         model?: string | {
             /**
@@ -47562,9 +49293,9 @@ export type AgentsUpdateData = {
             enabled?: boolean;
         }> | null;
         /**
-         * Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error.
+         * Immutable agent kind. general and personal require computer_id; service cannot bind a computer. Omit on create to infer from computer_id (general with a computer, service without). On update, the same kind is ignored; changing kind or crossing its computer binding returns 400 invalid_request_error. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind?: 'general' | 'personal' | 'service';
+        kind?: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined.
          */
@@ -47948,7 +49679,7 @@ export type AgentsUpdateData = {
     };
     path: {
         /**
-         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.
+         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -48007,7 +49738,7 @@ export type AgentsUpdateResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -48041,7 +49772,7 @@ export type AgentsUpdateResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | AgentManaged39;
+        multiagent?: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -48151,9 +49882,9 @@ export type AgentsUpdateResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -48535,7 +50266,7 @@ export type AgentsUpdateResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -48549,7 +50280,7 @@ export type AgentsArchiveData = {
     body?: never;
     path: {
         /**
-         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.
+         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -48600,7 +50331,7 @@ export type AgentsArchiveResponses = {
         /**
          * Model identifier and configuration.
          */
-        model: {
+        model?: {
             /**
              * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
              */
@@ -48634,7 +50365,7 @@ export type AgentsArchiveResponses = {
         /**
          * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
          */
-        multiagent: null | AgentManaged39;
+        multiagent?: null | AgentManaged39;
         /**
          * Display name of the agent, as set on create or update. It is a label, not a unique key.
          */
@@ -48740,9 +50471,9 @@ export type AgentsArchiveResponses = {
             enabled?: boolean;
         }>;
         /**
-         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+         * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
          */
-        kind: 'general' | 'personal' | 'service';
+        kind: 'general' | 'personal' | 'service' | 'assume';
         /**
          * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
          */
@@ -49124,7 +50855,7 @@ export type AgentsArchiveResponses = {
          */
         environment_id?: string | null;
         /**
-         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+         * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
          */
         vault_ids?: Array<string>;
         /**
@@ -49138,7 +50869,7 @@ export type AgentsVersionsListData = {
     body?: never;
     path: {
         /**
-         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name.
+         * Agent id, as returned by agents.create or agents.list (for a session filter, the agent the session was created with). Not the agent name. Also accepts an 8-character identity number (0–9, A–Z); malformed, absent and foreign references return 404, and response ids always use agent_….
          */
         agent_id: string;
     };
@@ -49203,7 +50934,7 @@ export type AgentsVersionsListResponses = {
             /**
              * Model identifier and configuration.
              */
-            model: {
+            model?: {
                 /**
                  * A model id from the Praxis model catalog (`praxis.model.models.list`). Unlike Anthropic, Claude model ids other than those in the catalog are rejected.
                  */
@@ -49237,7 +50968,7 @@ export type AgentsVersionsListResponses = {
             /**
              * Coordinator roster. A bare string agent id is equivalent to {type: "agent", id}; omitting its version pins the referenced agent's current saved version when this roster is saved. {type: "self"} refers to this agent. Specify a concrete version to pin it explicitly.
              */
-            multiagent: null | AgentManaged39;
+            multiagent?: null | AgentManaged39;
             /**
              * Display name of the agent, as set on create or update. It is a label, not a unique key.
              */
@@ -49347,9 +51078,9 @@ export type AgentsVersionsListResponses = {
                 enabled?: boolean;
             }>;
             /**
-             * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general.
+             * Immutable agent kind. general uses a durable computer and acts for its owner; personal behaves like general for now and is reserved for the personal agent; service uses a clean environment per session. Historical agents infer kind from their computer binding and read as general. Assume agents use a durable computer driven over MCP without a conversation model; model, models, subagent_model, subagents and multiagent are forbidden and omitted.
              */
-            kind: 'general' | 'personal' | 'service';
+            kind: 'general' | 'personal' | 'service' | 'assume';
             /**
              * Praxis extension: MA only has session-scoped temporary containers and memory_stores, not durable browsable computers. computer_id selects a tenant-owned active computer. Session selection overrides the agent default; a sandbox environment_id and computer_id cannot be combined. Omitted when no computer is selected.
              */
@@ -49731,7 +51462,7 @@ export type AgentsVersionsListResponses = {
              */
             environment_id?: string | null;
             /**
-             * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service agents only. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
+             * Default vaults of this service agent version: the vault_ids new sessions get when they name none. Present for service and assume agents. Follows the version like other configuration: a version saved with apply=false does not change the vaults in effect. Versions saved before this field existed read as []. /agent/v1 only.
              */
             vault_ids?: Array<string>;
             /**
@@ -50138,7 +51869,7 @@ export type SessionsCreateData = {
 };
 export type SessionsCreateErrors = {
     /**
-     * The body failed validation and the message names the field: an unknown field, environment_id together with computer_id, a model or thinking selection the agent does not allow, an invalid budget or vault_ids, invalid initial_events, or an agent reference with an unsupported override.
+     * The body failed validation and the message names the field: an unknown field, environment_id together with computer_id, a model or thinking selection the agent does not allow, an invalid budget or vault_ids, invalid initial_events, or an agent reference with an unsupported override, or an assume agent (use /agent/v1/agents/{id}/mcp; assume agents do not take sessions).
      */
     400: AgentError;
     /**
@@ -60140,6 +61871,1394 @@ export type AutomationHumanTasksDelegateResponses = {
     200: AutomationHumanTask;
 };
 export type AutomationHumanTasksDelegateResponse = AutomationHumanTasksDelegateResponses[keyof AutomationHumanTasksDelegateResponses];
+export type CanvasListCanvasesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Maximum canvases to return per page, from 1 to 100; defaults to 50 when omitted.
+         */
+        limit?: number;
+        /**
+         * Opaque next_cursor from the preceding list response; omit for the first page and stop when next_cursor is null.
+         */
+        cursor?: string;
+    };
+    url: '/canvas/v1/canvases';
+};
+export type CanvasListCanvasesErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasListCanvasesError = CanvasListCanvasesErrors[keyof CanvasListCanvasesErrors];
+export type CanvasListCanvasesResponses = {
+    /**
+     * One page of organization canvases, ordered by most recently updated first.
+     */
+    200: CanvasCanvasPage;
+};
+export type CanvasListCanvasesResponse = CanvasListCanvasesResponses[keyof CanvasListCanvasesResponses];
+export type CanvasCreateCanvasData = {
+    /**
+     * Optional display name for the new canvas; omit the body or send an empty object to use Untitled.
+     */
+    body?: CanvasCreateCanvasInput;
+    path?: never;
+    query?: never;
+    url: '/canvas/v1/canvases';
+};
+export type CanvasCreateCanvasErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasCreateCanvasError = CanvasCreateCanvasErrors[keyof CanvasCreateCanvasErrors];
+export type CanvasCreateCanvasResponses = {
+    /**
+     * The newly created canvas; use id for API calls and viewer_url to watch it in Console.
+     */
+    201: CanvasCanvas;
+};
+export type CanvasCreateCanvasResponse = CanvasCreateCanvasResponses[keyof CanvasCreateCanvasResponses];
+export type CanvasDeleteCanvasData = {
+    body?: never;
+    path: {
+        /**
+         * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+         */
+        canvas_id: string;
+    };
+    query?: never;
+    url: '/canvas/v1/canvases/{canvas_id}';
+};
+export type CanvasDeleteCanvasErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * CANVAS_NOT_FOUND means the canvas does not exist, was deleted or belongs to another organization; choose an accessible canvas id from list or create a new canvas.
+     */
+    404: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasDeleteCanvasError = CanvasDeleteCanvasErrors[keyof CanvasDeleteCanvasErrors];
+export type CanvasDeleteCanvasResponses = {
+    /**
+     * Confirmation that this canvas has been permanently deleted.
+     */
+    200: CanvasDeletedCanvas;
+};
+export type CanvasDeleteCanvasResponse = CanvasDeleteCanvasResponses[keyof CanvasDeleteCanvasResponses];
+export type CanvasRetrieveCanvasData = {
+    body?: never;
+    path: {
+        /**
+         * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+         */
+        canvas_id: string;
+    };
+    query?: never;
+    url: '/canvas/v1/canvases/{canvas_id}';
+};
+export type CanvasRetrieveCanvasErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * CANVAS_NOT_FOUND means the canvas does not exist, was deleted or belongs to another organization; choose an accessible canvas id from list or create a new canvas.
+     */
+    404: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasRetrieveCanvasError = CanvasRetrieveCanvasErrors[keyof CanvasRetrieveCanvasErrors];
+export type CanvasRetrieveCanvasResponses = {
+    /**
+     * Current canvas metadata, top-level frame summaries and reusable components.
+     */
+    200: CanvasCanvasDetail;
+};
+export type CanvasRetrieveCanvasResponse = CanvasRetrieveCanvasResponses[keyof CanvasRetrieveCanvasResponses];
+export type CanvasListNodesData = {
+    body?: never;
+    path: {
+        /**
+         * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+         */
+        canvas_id: string;
+    };
+    query: {
+        /**
+         * Comma-separated list of 1–100 node ids from retrieve or execute, or instance paths such as a/b; missing ids map to null.
+         */
+        ids: string;
+        /**
+         * Maximum child depth below each requested node, as an integer at least 0; 0 returns the node without descendants, and omission returns the complete subtree.
+         */
+        depth?: number;
+    };
+    url: '/canvas/v1/canvases/{canvas_id}/nodes';
+};
+export type CanvasListNodesErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * CANVAS_NOT_FOUND means the canvas does not exist, was deleted or belongs to another organization; choose an accessible canvas id from list or create a new canvas.
+     */
+    404: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasListNodesError = CanvasListNodesErrors[keyof CanvasListNodesErrors];
+export type CanvasListNodesResponses = {
+    /**
+     * Current revision and requested node documents; absent ids map to null rather than failing the request.
+     */
+    200: CanvasNodesResult;
+};
+export type CanvasListNodesResponse = CanvasListNodesResponses[keyof CanvasListNodesResponses];
+export type CanvasListImagesData = {
+    body?: never;
+    path: {
+        /**
+         * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+         */
+        canvas_id: string;
+    };
+    query: {
+        /**
+         * Comma-separated list of 1–4 node ids to render, from retrieve, execute.created or execute.screenshots.
+         */
+        ids: string;
+        /**
+         * Output pixel scale relative to canvas dimensions, from 0.25 to 4 inclusive; defaults to 1 when omitted.
+         */
+        scale?: number;
+        /**
+         * Image encoding; png produces a PNG data URL and is the only supported value. Omit to use png.
+         */
+        format?: 'png';
+    };
+    url: '/canvas/v1/canvases/{canvas_id}/images';
+};
+export type CanvasListImagesErrors = {
+    /**
+     * INVALID_PARAMS means a field, query value or identifier violates the documented format or range; correct the indicated input before retrying.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * CANVAS_NOT_FOUND means the canvas does not exist, was deleted or belongs to another organization; choose an accessible canvas id from list or create a new canvas.
+     */
+    404: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+    /**
+     * RENDER_FAILED occurs when rendering cannot complete; retry the render later, using nodes.list to inspect the design in the meantime.
+     */
+    503: CanvasCanvasError;
+};
+export type CanvasListImagesError = CanvasListImagesErrors[keyof CanvasListImagesErrors];
+export type CanvasListImagesResponses = {
+    /**
+     * A node-id-to-PNG-data-URL map, with err=null; individual unavailable images have null values.
+     */
+    200: CanvasImagesResult;
+};
+export type CanvasListImagesResponse = CanvasListImagesResponses[keyof CanvasListImagesResponses];
+export type CanvasExecuteData = {
+    /**
+     * Either new script source or the edit_id of a failed script with replacement edits; expected_version optionally guards against concurrent changes.
+     */
+    body: CanvasExecuteInput;
+    path: {
+        /**
+         * Canvas id returned by create or list, in the form cvs_ followed by 16 lowercase letters or digits; a display name is not accepted.
+         */
+        canvas_id: string;
+    };
+    query?: never;
+    url: '/canvas/v1/canvases/{canvas_id}:execute';
+};
+export type CanvasExecuteErrors = {
+    /**
+     * INVALID_PARAMS: script and edit_id are not exclusive or fields violate constraints; correct the request. SCRIPT_ERROR, SCRIPT_LIMIT or OPS_REJECTED: execution failed and all writes rolled back; patch the saved source with details.edit_id and edits, using line, column or rejection if supplied. EDIT_EXPIRED: edit_id is older than ten minutes; submit a corrected new script.
+     */
+    400: CanvasCanvasError;
+    /**
+     * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
+     */
+    401: CanvasCanvasError;
+    /**
+     * The API key lacks permission for this operation; use a key with the required canvas access in the owning organization.
+     */
+    403: CanvasCanvasError;
+    /**
+     * CANVAS_NOT_FOUND means the canvas is missing, deleted or outside your organization; select an id from list. NODE_NOT_FOUND means a script targets a missing node; retrieve current frames or nodes and correct the node reference before retrying.
+     */
+    404: CanvasCanvasError;
+    /**
+     * REVISION_CONFLICT means expected_version differs from the current revision in error.details.version; retrieve the latest canvas, merge concurrent changes and retry with that version.
+     */
+    409: CanvasCanvasError;
+    /**
+     * CANVAS_BUSY means the same canvas has more than four calls queued; wait for pending work to finish before retrying.
+     */
+    429: CanvasCanvasError;
+    /**
+     * INTERNAL means the service could not complete the request; inspect the current canvas before retrying a write to avoid duplicating an already committed edit.
+     */
+    500: CanvasCanvasError;
+};
+export type CanvasExecuteError = CanvasExecuteErrors[keyof CanvasExecuteErrors];
+export type CanvasExecuteResponses = {
+    /**
+     * Committed revision, operation results and viewer URL; screenshots contains node ids to pass to images.list.
+     */
+    200: CanvasExecuteResult;
+};
+export type CanvasExecuteResponse = CanvasExecuteResponses[keyof CanvasExecuteResponses];
+export type CutListProjectsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Maximum resources in one page, from 1 to 100; defaults to 50.
+         */
+        page_size?: number;
+        /**
+         * Opaque next_page_token from the preceding page; omit on the first request.
+         */
+        page_token?: string;
+        /**
+         * Optional resource filter; projects supports state = "active" or state = "deleted".
+         */
+        filter?: string;
+        /**
+         * Optional ordering expression; projects supports updateTime desc.
+         */
+        order_by?: string;
+    };
+    url: '/cut/v1/projects';
+};
+export type CutListProjectsErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutListProjectsError = CutListProjectsErrors[keyof CutListProjectsErrors];
+export type CutListProjectsResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutProjectPage;
+};
+export type CutListProjectsResponse = CutListProjectsResponses[keyof CutListProjectsResponses];
+export type CutCreateProjectData = {
+    /**
+     * Create a blank project bound to the media libraries it may use.
+     */
+    body: CutCreateProjectInput;
+    path?: never;
+    query?: never;
+    url: '/cut/v1/projects';
+};
+export type CutCreateProjectErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutCreateProjectError = CutCreateProjectErrors[keyof CutCreateProjectErrors];
+export type CutCreateProjectResponses = {
+    /**
+     * New resource; save its id for subsequent calls.
+     */
+    201: CutProject;
+};
+export type CutCreateProjectResponse = CutCreateProjectResponses[keyof CutCreateProjectResponses];
+export type CutDeleteProjectData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}';
+};
+export type CutDeleteProjectErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutDeleteProjectError = CutDeleteProjectErrors[keyof CutDeleteProjectErrors];
+export type CutDeleteProjectResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutProject;
+};
+export type CutDeleteProjectResponse = CutDeleteProjectResponses[keyof CutDeleteProjectResponses];
+export type CutRetrieveProjectData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: {
+        /**
+         * Comma-separated expansions: timeline includes clips, exports includes render jobs, versions includes saved snapshots.
+         */
+        expand?: string;
+    };
+    url: '/cut/v1/projects/{project_id}';
+};
+export type CutRetrieveProjectErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * PROJECT_TOO_LARGE or RESPONSE_TOO_LARGE means an edit or response exceeds its size limit; reduce the edit batch or narrow the requested timeline range.
+     */
+    413: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutRetrieveProjectError = CutRetrieveProjectErrors[keyof CutRetrieveProjectErrors];
+export type CutRetrieveProjectResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutProjectDetail;
+};
+export type CutRetrieveProjectResponse = CutRetrieveProjectResponses[keyof CutRetrieveProjectResponses];
+export type CutUpdateProjectData = {
+    /**
+     * Update only the named project metadata fields; timeline edits use execute.
+     */
+    body: CutUpdateProjectInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}';
+};
+export type CutUpdateProjectErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutUpdateProjectError = CutUpdateProjectErrors[keyof CutUpdateProjectErrors];
+export type CutUpdateProjectResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutProject;
+};
+export type CutUpdateProjectResponse = CutUpdateProjectResponses[keyof CutUpdateProjectResponses];
+export type CutUndeleteProjectData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}:undelete';
+};
+export type CutUndeleteProjectErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutUndeleteProjectError = CutUndeleteProjectErrors[keyof CutUndeleteProjectErrors];
+export type CutUndeleteProjectResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutProject;
+};
+export type CutUndeleteProjectResponse = CutUndeleteProjectResponses[keyof CutUndeleteProjectResponses];
+export type CutExecuteData = {
+    /**
+     * Submit new synchronous source or patch a saved failed script; script and edit_id are exclusive.
+     */
+    body: CutExecuteInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}:execute';
+};
+export type CutExecuteErrors = {
+    /**
+     * SCRIPT_ERROR, SCRIPT_LIMIT or OPS_REJECTED means the script failed and its writes rolled back; correct the source using error.details.edit_id and edits when provided. EDIT_EXPIRED means the saved source is older than ten minutes; resubmit corrected script source.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * REVISION_CONFLICT means the project changed since expected_revision or while preparing the second-based response; retrieve the current state and inspect whether a write committed before retrying, then merge concurrent edits.
+     */
+    409: CutCutError;
+    /**
+     * PROJECT_TOO_LARGE or RESPONSE_TOO_LARGE means an edit or response exceeds its size limit; reduce the edit batch or narrow the requested timeline range.
+     */
+    413: CutCutError;
+    /**
+     * CUT_BUSY means too much work is queued for this project; let pending work complete before retrying.
+     */
+    429: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+    /**
+     * MEDIA_OFFLINE, MEDIA_UNAVAILABLE, MEDIA_IMPORT_FAILED or EXPORT_FAILED means required media or rendering could not complete; inspect source availability or the export error before retrying.
+     */
+    503: CutCutError;
+};
+export type CutExecuteError = CutExecuteErrors[keyof CutExecuteErrors];
+export type CutExecuteResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutExecuteResult;
+};
+export type CutExecuteResponse = CutExecuteResponses[keyof CutExecuteResponses];
+export type CutRetrieveStateData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/state';
+};
+export type CutRetrieveStateErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutRetrieveStateError = CutRetrieveStateErrors[keyof CutRetrieveStateErrors];
+export type CutRetrieveStateResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutState;
+};
+export type CutRetrieveStateResponse = CutRetrieveStateResponses[keyof CutRetrieveStateResponses];
+export type CutRetrieveTimelineData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: {
+        /**
+         * full returns structured clips; compact returns compact textual editing context.
+         */
+        view?: 'full' | 'compact';
+        /**
+         * Optional start of the selected project range in seconds; omit for the beginning.
+         */
+        from?: number;
+        /**
+         * Optional end of the selected project range in seconds; omit for the end.
+         */
+        to?: number;
+        /**
+         * Comma-separated track ids from state to include; omit to include every track.
+         */
+        tracks?: string;
+    };
+    url: '/cut/v1/projects/{project_id}/timeline';
+};
+export type CutRetrieveTimelineErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * REVISION_CONFLICT means the project changed since expected_revision or while preparing the second-based response; retrieve the current state and inspect whether a write committed before retrying, then merge concurrent edits.
+     */
+    409: CutCutError;
+    /**
+     * PROJECT_TOO_LARGE or RESPONSE_TOO_LARGE means an edit or response exceeds its size limit; reduce the edit batch or narrow the requested timeline range.
+     */
+    413: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutRetrieveTimelineError = CutRetrieveTimelineErrors[keyof CutRetrieveTimelineErrors];
+export type CutRetrieveTimelineResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutTimelineResult;
+};
+export type CutRetrieveTimelineResponse = CutRetrieveTimelineResponses[keyof CutRetrieveTimelineResponses];
+export type CutListFramesData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query: {
+        /**
+         * Required comma-separated non-negative project times in seconds, for example 12,15.5.
+         */
+        at: string;
+        /**
+         * Positive image size multiplier; 0.5 renders at half the project dimensions.
+         */
+        scale?: number;
+        /**
+         * Committed project revision from retrieve, state, timeline or execute; increases after each successful write.
+         */
+        revision?: number;
+    };
+    url: '/cut/v1/projects/{project_id}/frames';
+};
+export type CutListFramesErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * PROJECT_TOO_LARGE or RESPONSE_TOO_LARGE means an edit or response exceeds its size limit; reduce the edit batch or narrow the requested timeline range.
+     */
+    413: CutCutError;
+    /**
+     * CUT_BUSY means too much work is queued for this project; let pending work complete before retrying.
+     */
+    429: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+    /**
+     * MEDIA_OFFLINE, MEDIA_UNAVAILABLE, MEDIA_IMPORT_FAILED or EXPORT_FAILED means required media or rendering could not complete; inspect source availability or the export error before retrying.
+     */
+    503: CutCutError;
+};
+export type CutListFramesError = CutListFramesErrors[keyof CutListFramesErrors];
+export type CutListFramesResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutFramesResult;
+};
+export type CutListFramesResponse = CutListFramesResponses[keyof CutListFramesResponses];
+export type CutCreateAnalysisData = {
+    /**
+     * Select analysis kinds and optionally limit source assets.
+     */
+    body: CutAnalysisInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/analysis';
+};
+export type CutCreateAnalysisErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+    /**
+     * MEDIA_OFFLINE, MEDIA_UNAVAILABLE, MEDIA_IMPORT_FAILED or EXPORT_FAILED means required media or rendering could not complete; inspect source availability or the export error before retrying.
+     */
+    503: CutCutError;
+};
+export type CutCreateAnalysisError = CutCreateAnalysisErrors[keyof CutCreateAnalysisErrors];
+export type CutCreateAnalysisResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutAnalysisResult;
+};
+export type CutCreateAnalysisResponse = CutCreateAnalysisResponses[keyof CutCreateAnalysisResponses];
+export type CutListBindingsData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/bindings';
+};
+export type CutListBindingsErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutListBindingsError = CutListBindingsErrors[keyof CutListBindingsErrors];
+export type CutListBindingsResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutBindingsResult;
+};
+export type CutListBindingsResponse = CutListBindingsResponses[keyof CutListBindingsResponses];
+export type CutCreateBindingData = {
+    /**
+     * Attach a media library using a project-local name.
+     */
+    body: CutBindingInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/bindings';
+};
+export type CutCreateBindingErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutCreateBindingError = CutCreateBindingErrors[keyof CutCreateBindingErrors];
+export type CutCreateBindingResponses = {
+    /**
+     * New resource; save its id for subsequent calls.
+     */
+    201: CutBinding;
+};
+export type CutCreateBindingResponse = CutCreateBindingResponses[keyof CutCreateBindingResponses];
+export type CutDeleteBindingData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+        /**
+         * Project-local binding alias from bindings.list; detach only after removing all clips that reference its library.
+         */
+        name: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/bindings/{name}';
+};
+export type CutDeleteBindingErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * BINDING_IN_USE means timeline clips still reference this library; remove or replace those clips before detaching the binding.
+     */
+    409: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutDeleteBindingError = CutDeleteBindingErrors[keyof CutDeleteBindingErrors];
+export type CutDeleteBindingResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutDeletedBinding;
+};
+export type CutDeleteBindingResponse = CutDeleteBindingResponses[keyof CutDeleteBindingResponses];
+export type CutImportMediaData = {
+    /**
+     * Import one external asset into a writable project library.
+     */
+    body: CutMediaImportInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/media:import';
+};
+export type CutImportMediaErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+    /**
+     * MEDIA_OFFLINE, MEDIA_UNAVAILABLE, MEDIA_IMPORT_FAILED or EXPORT_FAILED means required media or rendering could not complete; inspect source availability or the export error before retrying.
+     */
+    503: CutCutError;
+};
+export type CutImportMediaError = CutImportMediaErrors[keyof CutImportMediaErrors];
+export type CutImportMediaResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutImportedMedia;
+};
+export type CutImportMediaResponse = CutImportMediaResponses[keyof CutImportMediaResponses];
+export type CutListExportsData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: {
+        /**
+         * Maximum resources in one page, from 1 to 100; defaults to 50.
+         */
+        page_size?: number;
+        /**
+         * Opaque next_page_token from the preceding page; omit on the first request.
+         */
+        page_token?: string;
+        /**
+         * Optional resource filter; projects supports state = "active" or state = "deleted".
+         */
+        filter?: string;
+        /**
+         * Optional ordering expression; projects supports updateTime desc.
+         */
+        order_by?: string;
+    };
+    url: '/cut/v1/projects/{project_id}/exports';
+};
+export type CutListExportsErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutListExportsError = CutListExportsErrors[keyof CutListExportsErrors];
+export type CutListExportsResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutExportPage;
+};
+export type CutListExportsResponse = CutListExportsResponses[keyof CutListExportsResponses];
+export type CutCreateExportData = {
+    /**
+     * Start an export from a project revision into a bound library.
+     */
+    body: CutExportInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/exports';
+};
+export type CutCreateExportErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * CUT_BUSY means too much work is queued for this project; let pending work complete before retrying.
+     */
+    429: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+    /**
+     * MEDIA_OFFLINE, MEDIA_UNAVAILABLE, MEDIA_IMPORT_FAILED or EXPORT_FAILED means required media or rendering could not complete; inspect source availability or the export error before retrying.
+     */
+    503: CutCutError;
+};
+export type CutCreateExportError = CutCreateExportErrors[keyof CutCreateExportErrors];
+export type CutCreateExportResponses = {
+    /**
+     * Export accepted; poll exports.retrieve until status is done, failed or canceled.
+     */
+    202: CutExport;
+};
+export type CutCreateExportResponse = CutCreateExportResponses[keyof CutCreateExportResponses];
+export type CutRetrieveExportData = {
+    body?: never;
+    path: {
+        /**
+         * Export identifier returned by its create or list operation; use the id, not a display name.
+         */
+        export_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/exports/{export_id}';
+};
+export type CutRetrieveExportErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutRetrieveExportError = CutRetrieveExportErrors[keyof CutRetrieveExportErrors];
+export type CutRetrieveExportResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutExport;
+};
+export type CutRetrieveExportResponse = CutRetrieveExportResponses[keyof CutRetrieveExportResponses];
+export type CutCancelExportData = {
+    body?: never;
+    path: {
+        /**
+         * Export identifier returned by its create or list operation; use the id, not a display name.
+         */
+        export_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/exports/{export_id}:cancel';
+};
+export type CutCancelExportErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutCancelExportError = CutCancelExportErrors[keyof CutCancelExportErrors];
+export type CutCancelExportResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutExport;
+};
+export type CutCancelExportResponse = CutCancelExportResponses[keyof CutCancelExportResponses];
+export type CutListVersionsData = {
+    body?: never;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: {
+        /**
+         * Maximum resources in one page, from 1 to 100; defaults to 50.
+         */
+        page_size?: number;
+        /**
+         * Opaque next_page_token from the preceding page; omit on the first request.
+         */
+        page_token?: string;
+        /**
+         * Optional resource filter; projects supports state = "active" or state = "deleted".
+         */
+        filter?: string;
+        /**
+         * Optional ordering expression; projects supports updateTime desc.
+         */
+        order_by?: string;
+    };
+    url: '/cut/v1/projects/{project_id}/versions';
+};
+export type CutListVersionsErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutListVersionsError = CutListVersionsErrors[keyof CutListVersionsErrors];
+export type CutListVersionsResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutVersionPage;
+};
+export type CutListVersionsResponse = CutListVersionsResponses[keyof CutListVersionsResponses];
+export type CutCreateVersionData = {
+    /**
+     * Save the current project revision with an optional label.
+     */
+    body: CutVersionInput;
+    path: {
+        /**
+         * Project identifier returned by its create or list operation; use the id, not a display name.
+         */
+        project_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/projects/{project_id}/versions';
+};
+export type CutCreateVersionErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutCreateVersionError = CutCreateVersionErrors[keyof CutCreateVersionErrors];
+export type CutCreateVersionResponses = {
+    /**
+     * New resource; save its id for subsequent calls.
+     */
+    201: CutVersion;
+};
+export type CutCreateVersionResponse = CutCreateVersionResponses[keyof CutCreateVersionResponses];
+export type CutRestoreVersionData = {
+    body?: never;
+    path: {
+        /**
+         * Version identifier returned by its create or list operation; use the id, not a display name.
+         */
+        version_id: string;
+    };
+    query?: never;
+    url: '/cut/v1/versions/{version_id}:restore';
+};
+export type CutRestoreVersionErrors = {
+    /**
+     * INVALID_PARAMS or BINDING_INVALID means a request field, identifier or library binding is invalid; correct the indicated input before retrying.
+     */
+    400: CutCutError;
+    /**
+     * The API key is missing, invalid or has no organization; supply a valid organization API key before retrying.
+     */
+    401: CutCutError;
+    /**
+     * PERMISSION_DENIED means the credential cannot perform this operation; use a key with the required Cut access in the owning organization.
+     */
+    403: CutCutError;
+    /**
+     * PROJECT_NOT_FOUND, EXPORT_NOT_FOUND, VERSION_NOT_FOUND or LIBRARY_NOT_FOUND means the requested resource is missing, deleted or outside the organization; choose an accessible identifier from its list operation.
+     */
+    404: CutCutError;
+    /**
+     * REVISION_CONFLICT means the project changed since expected_revision or while preparing the second-based response; retrieve the current state and inspect whether a write committed before retrying, then merge concurrent edits.
+     */
+    409: CutCutError;
+    /**
+     * PROJECT_TOO_LARGE or RESPONSE_TOO_LARGE means an edit or response exceeds its size limit; reduce the edit batch or narrow the requested timeline range.
+     */
+    413: CutCutError;
+    /**
+     * INTERNAL means the request could not complete; inspect current project state before retrying a write to avoid duplicating a committed edit.
+     */
+    500: CutCutError;
+};
+export type CutRestoreVersionError = CutRestoreVersionErrors[keyof CutRestoreVersionErrors];
+export type CutRestoreVersionResponses = {
+    /**
+     * Requested resource or operation result; use its revision when preparing a guarded edit.
+     */
+    200: CutTransaction;
+};
+export type CutRestoreVersionResponse = CutRestoreVersionResponses[keyof CutRestoreVersionResponses];
 export type DatabaseListDatabasesData = {
     body?: never;
     path?: never;