twelvelabs-js 1.2.2 → 1.2.3

package/dist/api/resources/analyzeAsync/resources/tasks/client/Client.js

@@ -71,7 +71,10 @@ class Tasks {
      *     await client.analyzeAsync.tasks.list({
      *         page: 1,
      *         pageLimit: 10,
-     *         status: "queued"
+     *         status: "queued",
+     *         videoUrl: "https://example.com/video.mp4",
+     *         assetId: "69abc123def456789012abcd",
+     *         analysisMode: "time_based_metadata"
      *     })
      */
     list(request = {}, requestOptions) {
@@ -80,7 +83,7 @@ class Tasks {
     __list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b;
-            const { page, pageLimit, status } = request;
+            const { page, pageLimit, status, videoUrl, assetId, analysisMode } = request;
             const _queryParams = {};
             if (page != null) {
                 _queryParams["page"] = page.toString();
@@ -93,10 +96,19 @@ class Tasks {
                     unrecognizedObjectKeys: "strip",
                 });
             }
+            if (videoUrl != null) {
+                _queryParams["video_url"] = videoUrl;
+            }
+            if (assetId != null) {
+                _queryParams["asset_id"] = assetId;
+            }
+            if (analysisMode != null) {
+                _queryParams["analysis_mode"] = serializers.analyzeAsync.TasksListRequestAnalysisMode.jsonOrThrow(analysisMode, { unrecognizedObjectKeys: "strip" });
+            }
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 queryParameters: _queryParams,
                 requestType: "json",
@@ -145,7 +157,7 @@ class Tasks {
         });
     }
     /**
-     * This method asynchronously analyzes your videos and generates fully customizable text based on your prompts.
+     * This method asynchronously analyzes your videos. It supports two modes: general analysis (prompt-based text generation) with Pegasus 1.2 and video segmentation with Pegasus 1.5.
      *
      * <Accordion title="Input requirements">
      * - Minimum duration: 4 seconds
@@ -156,6 +168,8 @@ class Tasks {
      * </Accordion>
      *
      * **When to use this method**:
+     * - Generate custom text from your video using a prompt (Pegasus 1.2 only)
+     * - Extract timestamped metadata with custom fields from your video (Pegasus 1.5 only)
      * - Analyze videos longer than 1 hour
      * - Process videos asynchronously without blocking your application
      *
@@ -188,6 +202,38 @@ class Tasks {
      *         temperature: 0.2,
      *         maxTokens: 1000
      *     })
+     *
+     * @example
+     *     await client.analyzeAsync.tasks.create({
+     *         modelName: "pegasus1.5",
+     *         video: {
+     *             type: "url",
+     *             url: "https://example.com/video.mp4"
+     *         },
+     *         analysisMode: "time_based_metadata",
+     *         responseFormat: {
+     *             type: "segment_definitions",
+     *             segmentDefinitions: [{
+     *                     id: "scene",
+     *                     description: "A distinct scene or setting change in the video",
+     *                     fields: [{
+     *                             name: "sentiment",
+     *                             type: "string",
+     *                             description: "The emotional tone of this segment",
+     *                             enum: ["positive", "negative", "neutral"]
+     *                         }, {
+     *                             name: "key_objects",
+     *                             type: "array",
+     *                             description: "Notable objects visible in this segment",
+     *                             items: {
+     *                                 type: "string"
+     *                             }
+     *                         }]
+     *                 }]
+     *         },
+     *         minSegmentDuration: 5,
+     *         maxSegmentDuration: 30
+     *     })
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
@@ -198,7 +244,7 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "analyze/tasks"),
                 method: "POST",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.analyzeAsync.CreateAsyncAnalyzeRequest.jsonOrThrow(request, {
@@ -279,7 +325,7 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -347,7 +393,7 @@ class Tasks {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `analyze/tasks/${encodeURIComponent(taskId)}`),
                 method: "DELETE",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -362,12 +408,7 @@ class Tasks {
                     case 404:
                         throw new TwelvelabsApi.NotFoundError(_response.error.body, _response.rawResponse);
                     case 409:
-                        throw new TwelvelabsApi.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
-                            unrecognizedObjectKeys: "passthrough",
-                            allowUnrecognizedUnionMembers: true,
-                            allowUnrecognizedEnumValues: true,
-                            breadcrumbsPrefix: ["response"],
-                        }), _response.rawResponse);
+                        throw new TwelvelabsApi.ConflictError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.TwelvelabsApiError({
                             statusCode: _response.error.statusCode,

package/dist/api/resources/analyzeAsync/resources/tasks/client/requests/CreateAsyncAnalyzeRequest.d.ts

@@ -13,11 +13,82 @@ import * as TwelvelabsApi from "../../../../../../index";
  *         temperature: 0.2,
  *         maxTokens: 1000
  *     }
+ *
+ * @example
+ *     {
+ *         modelName: "pegasus1.5",
+ *         video: {
+ *             type: "url",
+ *             url: "https://example.com/video.mp4"
+ *         },
+ *         analysisMode: "time_based_metadata",
+ *         responseFormat: {
+ *             type: "segment_definitions",
+ *             segmentDefinitions: [{
+ *                     id: "scene",
+ *                     description: "A distinct scene or setting change in the video",
+ *                     fields: [{
+ *                             name: "sentiment",
+ *                             type: "string",
+ *                             description: "The emotional tone of this segment",
+ *                             enum: ["positive", "negative", "neutral"]
+ *                         }, {
+ *                             name: "key_objects",
+ *                             type: "array",
+ *                             description: "Notable objects visible in this segment",
+ *                             items: {
+ *                                 type: "string"
+ *                             }
+ *                         }]
+ *                 }]
+ *         },
+ *         minSegmentDuration: 5,
+ *         maxSegmentDuration: 30
+ *     }
  */
 export interface CreateAsyncAnalyzeRequest {
+    /**
+     * The video understanding model to use for analysis.
+     * - `pegasus1.2` (default): Analyzes pre-indexed videos. Pass a `video_id` to reference your video.
+     * - `pegasus1.5`: Analyzes videos directly from a URL, asset, or base64 string. Supports video segmentation with custom segment definitions.
+     */
+    modelName?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestModelName;
     video: TwelvelabsApi.VideoContext;
-    prompt: TwelvelabsApi.AnalyzeTextPrompt;
+    /**
+     * A natural-language text that provides instructions for analyzing the video. Required for general-mode analysis. Not supported when `analysis_mode` is `time_based_metadata`.
+     *
+     * <Note title="Notes">
+     * - Even though the model behind this endpoint is trained to a high degree of accuracy, the preciseness of the generated text may vary based on the nature and quality of the video and the clarity of the prompt.
+     * - Your prompts can be instructive or descriptive, or you can also phrase them as questions.
+     * - The maximum length of a prompt is 2,000 tokens.
+     * </Note>
+     *
+     * **Examples**:
+     *
+     * - Based on this video, I want to generate five keywords for SEO (Search Engine Optimization).
+     * - I want to generate a description for my video with the following format: Title of the video, followed by a summary in 2-3 sentences, highlighting the main topic, key events, and concluding remarks.
+     */
+    prompt?: string;
+    /** Sets the analysis mode to `time_based_metadata`, which segments your video into time-based intervals and extracts custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`. */
+    analysisMode?: TwelvelabsApi.analyzeAsync.CreateAsyncAnalyzeRequestAnalysisMode;
     temperature?: TwelvelabsApi.AnalyzeTemperature;
-    maxTokens?: TwelvelabsApi.AnalyzeMaxTokens;
-    responseFormat?: TwelvelabsApi.ResponseFormat;
+    /**
+     * The maximum number of tokens to generate. The allowed range depends on the model:
+     * - `pegasus1.2`: **Min:** 1, **Max:** 4,096
+     * - `pegasus1.5`: **Min:** 2,048, **Max:** 32,768, **Default:** 32,768
+     */
+    maxTokens?: number;
+    responseFormat?: TwelvelabsApi.AsyncResponseFormat;
+    /**
+     * Minimum duration for each extracted segment, in seconds. Set this to prevent the model from creating very short segments. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`.
+     *
+     * **Min:** 2
+     */
+    minSegmentDuration?: number;
+    /**
+     * Maximum duration for each extracted segment, in seconds. Set this to break long continuous sections into shorter segments. Must be greater than or equal to `min_segment_duration`. Requires `model_name` set to `pegasus1.5` and `analysis_mode` set to `time_based_metadata`.
+     *
+     * **Min:** 2
+     */
+    maxSegmentDuration?: number;
 }

package/dist/api/resources/analyzeAsync/resources/tasks/client/requests/TasksListRequest.d.ts

@@ -7,7 +7,20 @@ import * as TwelvelabsApi from "../../../../../../index";
  *     {
  *         page: 1,
  *         pageLimit: 10,
- *         status: "queued"
+ *         status: "queued",
+ *         videoUrl: "https://example.com/video.mp4",
+ *         assetId: "69abc123def456789012abcd",
+ *         analysisMode: "time_based_metadata"
+ *     }
+ *
+ * @example
+ *     {
+ *         page: 1,
+ *         pageLimit: 10,
+ *         status: "queued",
+ *         videoUrl: "https://example.com/video.mp4",
+ *         assetId: "69abc123def456789012abcd",
+ *         analysisMode: "time_based_metadata"
  *     }
  */
 export interface TasksListRequest {
@@ -29,4 +42,16 @@ export interface TasksListRequest {
      * Possible values: `queued`, `pending`, `processing`, `ready`, `failed`.
      */
     status?: TwelvelabsApi.AnalyzeTaskStatus;
+    /**
+     * Filter tasks by exact video source URL.
+     */
+    videoUrl?: string;
+    /**
+     * Filter tasks by asset ID.
+     */
+    assetId?: string;
+    /**
+     * Filter tasks by the analysis mode used when creating the task.
+     */
+    analysisMode?: TwelvelabsApi.analyzeAsync.TasksListRequestAnalysisMode;
 }

package/dist/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Sets the analysis mode to `time_based_metadata`, which segments your video into time-based intervals and extracts custom metadata for each segment. Requires `model_name` set to `pegasus1.5` and `response_format.type` set to `segment_definitions`.
+ */
+export type CreateAsyncAnalyzeRequestAnalysisMode = "time_based_metadata";
+export declare const CreateAsyncAnalyzeRequestAnalysisMode: {
+    readonly TimeBasedMetadata: "time_based_metadata";
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestAnalysisMode.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAsyncAnalyzeRequestAnalysisMode = void 0;
+exports.CreateAsyncAnalyzeRequestAnalysisMode = {
+    TimeBasedMetadata: "time_based_metadata",
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestModelName.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * The video understanding model to use for analysis.
+ * - `pegasus1.2` (default): Analyzes pre-indexed videos. Pass a `video_id` to reference your video.
+ * - `pegasus1.5`: Analyzes videos directly from a URL, asset, or base64 string. Supports video segmentation with custom segment definitions.
+ */
+export type CreateAsyncAnalyzeRequestModelName = "pegasus1.2" | "pegasus1.5";
+export declare const CreateAsyncAnalyzeRequestModelName: {
+    readonly Pegasus12: "pegasus1.2";
+    readonly Pegasus15: "pegasus1.5";
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/CreateAsyncAnalyzeRequestModelName.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAsyncAnalyzeRequestModelName = void 0;
+exports.CreateAsyncAnalyzeRequestModelName = {
+    Pegasus12: "pegasus1.2",
+    Pegasus15: "pegasus1.5",
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type TasksListRequestAnalysisMode = "time_based_metadata";
+export declare const TasksListRequestAnalysisMode: {
+    readonly TimeBasedMetadata: "time_based_metadata";
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/TasksListRequestAnalysisMode.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksListRequestAnalysisMode = void 0;
+exports.TasksListRequestAnalysisMode = {
+    TimeBasedMetadata: "time_based_metadata",
+};

package/dist/api/resources/analyzeAsync/resources/tasks/types/index.d.ts

@@ -1 +1,4 @@
+export * from "./TasksListRequestAnalysisMode";
 export * from "./TasksListResponse";
+export * from "./CreateAsyncAnalyzeRequestModelName";
+export * from "./CreateAsyncAnalyzeRequestAnalysisMode";

package/dist/api/resources/analyzeAsync/resources/tasks/types/index.js

@@ -14,4 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./TasksListRequestAnalysisMode"), exports);
 __exportStar(require("./TasksListResponse"), exports);
+__exportStar(require("./CreateAsyncAnalyzeRequestModelName"), exports);
+__exportStar(require("./CreateAsyncAnalyzeRequestAnalysisMode"), exports);

package/dist/api/resources/assets/client/Client.d.ts

@@ -38,10 +38,11 @@ export declare class Assets {
      * @example
      *     await client.assets.list({
      *         page: 1,
-     *         pageLimit: 10
+     *         pageLimit: 10,
+     *         filename: "meeting"
      *     })
      */
-    list(request?: TwelvelabsApi.AssetsListRequest, requestOptions?: Assets.RequestOptions): Promise<core.Page<TwelvelabsApi.Asset>>;
+    list(request?: TwelvelabsApi.AssetsListRequest, requestOptions?: Assets.RequestOptions): Promise<core.Page<TwelvelabsApi.AssetDetail>>;
     /**
      * This method creates an asset by uploading a file to the platform. Assets are media files that you can use in downstream workflows, including indexing, analyzing video content, and creating entities.
      *
@@ -51,7 +52,7 @@ export declare class Assets {
      * - **Local file**: Set the `method` parameter to `direct` and use the `file` parameter to specify the file.
      * - **Publicly accessible URL**: Set the `method` parameter to `url` and use the `url` parameter to specify the URL of your file.
      *
-     * **File size**: 200MB maximum for local file uploads, 4GB maximum for URL uploads.
+     * **File size**: Up to 4 GB.
      *
      * **Additional requirements** depend on your workflow:
      * - **Search**: [Marengo requirements](/v1.3/docs/concepts/models/marengo#video-file-requirements)
@@ -86,20 +87,30 @@ export declare class Assets {
      * @example
      *     await client.assets.retrieve("6298d673f1090f1100476d4c")
      */
-    retrieve(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<TwelvelabsApi.Asset>;
+    retrieve(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<TwelvelabsApi.AssetDetail>;
     private __retrieve;
     /**
      * This method deletes the specified asset. This action cannot be undone.
      *
+     * By default, the platform checks whether any indexed assets reference the asset. If references exist, the platform rejects the request with a `409 Conflict` error. To skip this check and delete the asset anyway, set the `force` query parameter to `true`. The platform unlinks any entity associations.
+     *
+     * Before deleting, you can inspect existing references:
+     * - [`GET`](/v1.3/api-reference/index-content/list-indexed-assets-by-asset) `/assets/{asset_id}/indexed-assets` returns a list of the indexed assets that will block deletion unless the `force` query parameter is set to `true`.
+     * - [`GET`](/v1.3/api-reference/entities/list-entities-by-asset) `/assets/{asset_id}/entities` returns a list of the entities whose associations the platform will unlink.
+     *
      * @param {string} assetId - The unique identifier of the asset to delete.
+     * @param {TwelvelabsApi.AssetsDeleteRequest} request
      * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TwelvelabsApi.BadRequestError}
+     * @throws {@link TwelvelabsApi.ConflictError}
      *
      * @example
-     *     await client.assets.delete("6298d673f1090f1100476d4c")
+     *     await client.assets.delete("6298d673f1090f1100476d4c", {
+     *         force: true
+     *     })
      */
-    delete(assetId: string, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
+    delete(assetId: string, request?: TwelvelabsApi.AssetsDeleteRequest, requestOptions?: Assets.RequestOptions): core.HttpResponsePromise<void>;
     private __delete;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "x-api-key": string;

package/dist/api/resources/assets/client/Client.js

@@ -72,14 +72,15 @@ class Assets {
      * @example
      *     await client.assets.list({
      *         page: 1,
-     *         pageLimit: 10
+     *         pageLimit: 10,
+     *         filename: "meeting"
      *     })
      */
     list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b;
-                const { page, pageLimit, assetIds, assetTypes } = request;
+                const { page, pageLimit, assetIds, assetTypes, filename } = request;
                 const _queryParams = {};
                 if (page != null) {
                     _queryParams["page"] = page.toString();
@@ -105,10 +106,13 @@ class Assets {
                         _queryParams["asset_types"] = serializers.AssetsListRequestAssetTypesItem.jsonOrThrow(assetTypes, { unrecognizedObjectKeys: "strip" });
                     }
                 }
+                if (filename != null) {
+                    _queryParams["filename"] = filename;
+                }
                 const _response = yield core.fetcher({
                     url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "assets"),
                     method: "GET",
-                    headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                    headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                     contentType: "application/json",
                     queryParameters: _queryParams,
                     requestType: "json",
@@ -178,7 +182,7 @@ class Assets {
      * - **Local file**: Set the `method` parameter to `direct` and use the `file` parameter to specify the file.
      * - **Publicly accessible URL**: Set the `method` parameter to `url` and use the `url` parameter to specify the URL of your file.
      *
-     * **File size**: 200MB maximum for local file uploads, 4GB maximum for URL uploads.
+     * **File size**: Up to 4 GB.
      *
      * **Additional requirements** depend on your workflow:
      * - **Search**: [Marengo requirements](/v1.3/docs/concepts/models/marengo#video-file-requirements)
@@ -217,11 +221,17 @@ class Assets {
             if (request.filename != null) {
                 _request.append("filename", request.filename);
             }
+            if (request.enableHls != null) {
+                _request.append("enable_hls", request.enableHls.toString());
+            }
+            if (request.enableThumbnail != null) {
+                _request.append("enable_thumbnail", request.enableThumbnail.toString());
+            }
             const _maybeEncodedRequest = yield _request.getRequest();
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, "assets"),
                 method: "POST",
-                headers: Object.assign(Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), _maybeEncodedRequest.headers), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 requestType: "file",
                 duplex: _maybeEncodedRequest.duplex,
                 body: _maybeEncodedRequest.body,
@@ -289,7 +299,7 @@ class Assets {
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `assets/${encodeURIComponent(assetId)}`),
                 method: "GET",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -298,7 +308,7 @@ class Assets {
             });
             if (_response.ok) {
                 return {
-                    data: serializers.Asset.parseOrThrow(_response.body, {
+                    data: serializers.AssetDetail.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -339,25 +349,41 @@ class Assets {
     /**
      * This method deletes the specified asset. This action cannot be undone.
      *
+     * By default, the platform checks whether any indexed assets reference the asset. If references exist, the platform rejects the request with a `409 Conflict` error. To skip this check and delete the asset anyway, set the `force` query parameter to `true`. The platform unlinks any entity associations.
+     *
+     * Before deleting, you can inspect existing references:
+     * - [`GET`](/v1.3/api-reference/index-content/list-indexed-assets-by-asset) `/assets/{asset_id}/indexed-assets` returns a list of the indexed assets that will block deletion unless the `force` query parameter is set to `true`.
+     * - [`GET`](/v1.3/api-reference/entities/list-entities-by-asset) `/assets/{asset_id}/entities` returns a list of the entities whose associations the platform will unlink.
+     *
      * @param {string} assetId - The unique identifier of the asset to delete.
+     * @param {TwelvelabsApi.AssetsDeleteRequest} request
      * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link TwelvelabsApi.BadRequestError}
+     * @throws {@link TwelvelabsApi.ConflictError}
      *
      * @example
-     *     await client.assets.delete("6298d673f1090f1100476d4c")
+     *     await client.assets.delete("6298d673f1090f1100476d4c", {
+     *         force: true
+     *     })
      */
-    delete(assetId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__delete(assetId, requestOptions));
+    delete(assetId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(assetId, request, requestOptions));
     }
-    __delete(assetId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __delete(assetId_1) {
+        return __awaiter(this, arguments, void 0, function* (assetId, request = {}, requestOptions) {
             var _a, _b;
+            const { force } = request;
+            const _queryParams = {};
+            if (force != null) {
+                _queryParams["force"] = force.toString();
+            }
             const _response = yield core.fetcher({
                 url: (0, url_join_1.default)((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.TwelvelabsApiEnvironment.Default, `assets/${encodeURIComponent(assetId)}`),
                 method: "DELETE",
-                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.2", "User-Agent": "twelvelabs-js/1.2.2", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign(Object.assign({ "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "twelvelabs-js", "X-Fern-SDK-Version": "1.2.3", "User-Agent": "twelvelabs-js/1.2.3", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, (yield this._getCustomAuthorizationHeaders())), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
+                queryParameters: _queryParams,
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
@@ -370,6 +396,8 @@ class Assets {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new TwelvelabsApi.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new TwelvelabsApi.ConflictError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.TwelvelabsApiError({
                             statusCode: _response.error.statusCode,

package/dist/api/resources/assets/client/requests/AssetsCreateRequest.d.ts

@@ -16,9 +16,21 @@ export interface AssetsCreateRequest {
     /**
      * Specify this parameter to upload a file from a publicly accessible URL. This parameter is required when `method` is set to `url`.
      *
-     * URL uploads have a maximum limit of 4GB.
+     * URL uploads have a maximum limit of 4 GB.
      */
     url?: string;
     /** The optional filename of the asset. If not provided, the platform will determine the filename from the file or URL. */
     filename?: string;
+    /**
+     * When set to `true`, the platform generates an HLS playlist and segments for streaming. Applicable to video and audio assets only.
+     *
+     * **Default**: `false`.
+     */
+    enableHls?: boolean;
+    /**
+     * When set to `true`, the platform generates thumbnail images from the uploaded content.
+     *
+     * **Default**: `false`.
+     */
+    enableThumbnail?: boolean;
 }

package/dist/api/resources/assets/client/requests/AssetsDeleteRequest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         force: true
+ *     }
+ */
+export interface AssetsDeleteRequest {
+    /**
+     * When set to `true`, the platform deletes the asset even if indexed assets reference it. When set to `false` or omitted, the request fails with `409 Conflict` if references exist.
+     *
+     * **Default**: `false`.
+     */
+    force?: boolean;
+}

package/dist/api/resources/assets/client/requests/AssetsDeleteRequest.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/assets/client/requests/AssetsListRequest.d.ts

@@ -6,7 +6,8 @@ import * as TwelvelabsApi from "../../../../index";
  * @example
  *     {
  *         page: 1,
- *         pageLimit: 10
+ *         pageLimit: 10,
+ *         filename: "meeting"
  *     }
  */
 export interface AssetsListRequest {
@@ -31,4 +32,8 @@ export interface AssetsListRequest {
      * Filters the response to include only assets of the specified types. Provide one or more asset types. When you specify multiple types, the platform returns all matching assets.
      */
     assetTypes?: TwelvelabsApi.AssetsListRequestAssetTypesItem | TwelvelabsApi.AssetsListRequestAssetTypesItem[];
+    /**
+     * Filters the response to include only assets whose filename contains the specified string. The match is case-insensitive and supports partial matching.
+     */
+    filename?: string;
 }

package/dist/api/resources/assets/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export { type AssetsListRequest } from "./AssetsListRequest";
 export { type AssetsCreateRequest } from "./AssetsCreateRequest";
+export { type AssetsDeleteRequest } from "./AssetsDeleteRequest";

package/dist/api/resources/assets/types/AssetsListResponse.d.ts

@@ -4,6 +4,6 @@
 import * as TwelvelabsApi from "../../../index";
 export interface AssetsListResponse {
     /** An array containing the assets. */
-    data?: TwelvelabsApi.Asset[];
+    data?: TwelvelabsApi.AssetDetail[];
     pageInfo?: TwelvelabsApi.PageInfo;
 }