@aviaryhq/cloudglue-js 0.4.1 → 0.4.2

package/dist/generated/Segments.d.ts

@@ -25,6 +25,8 @@ type ShotConfig = Partial<{
 }>;
 type NarrativeConfig = Partial<{
     prompt: string;
+    strategy: "direct" | "long" | "balanced";
+    number_of_chapters: number;
 }>;
 type Segment = {
     start_time: number;
@@ -68,8 +70,12 @@ export declare const schemas: {
     }>>;
     NarrativeConfig: z.ZodType<Partial<{
         prompt: string;
+        strategy: "direct" | "long" | "balanced";
+        number_of_chapters: number;
     }>, z.ZodTypeDef, Partial<{
         prompt: string;
+        strategy: "direct" | "long" | "balanced";
+        number_of_chapters: number;
     }>>;
     NewSegments: z.ZodType<NewSegments, z.ZodTypeDef, NewSegments>;
     Segment: z.ZodType<Segment, z.ZodTypeDef, Segment>;
@@ -81,7 +87,7 @@ export declare const SegmentsApi: import("@zodios/core").ZodiosInstance<[{
     method: "post";
     path: "/segments";
     alias: "createSegments";
-    description: "Create intelligent video segments based on shot detection or narrative analysis.\n\n**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.";
+    description: "Create intelligent video segments based on shot detection or narrative analysis.\n\n**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.\n\n**Narrative Segmentation Strategies:**\n\n• **balanced** (default): Uses multimodal describe job for comprehensive analysis.\n  Recommended for most videos. Supports YouTube URLs.\n\n• **direct**: Directly analyzes the full video URL with AI.\n  Ideal for videos less than 10 minutes long. Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.\n\n• **long**: Optimized for longer videos beyond 10 minutes.\n  Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.\n\n**YouTube URLs**: Automatically use the &#x27;balanced&#x27; strategy. The strategy field is ignored for YouTube URLs, and other strategies will be rejected with an error.";
     requestFormat: "json";
     parameters: [{
         name: "body";
@@ -265,7 +271,7 @@ export declare function createApiClient(baseUrl: string, options?: ZodiosOptions
     method: "post";
     path: "/segments";
     alias: "createSegments";
-    description: "Create intelligent video segments based on shot detection or narrative analysis.\n\n**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.";
+    description: "Create intelligent video segments based on shot detection or narrative analysis.\n\n**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.\n\n**Narrative Segmentation Strategies:**\n\n• **balanced** (default): Uses multimodal describe job for comprehensive analysis.\n  Recommended for most videos. Supports YouTube URLs.\n\n• **direct**: Directly analyzes the full video URL with AI.\n  Ideal for videos less than 10 minutes long. Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.\n\n• **long**: Optimized for longer videos beyond 10 minutes.\n  Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.\n\n**YouTube URLs**: Automatically use the &#x27;balanced&#x27; strategy. The strategy field is ignored for YouTube URLs, and other strategies will be rejected with an error.";
     requestFormat: "json";
     parameters: [{
         name: "body";

package/dist/generated/Segments.js

@@ -14,7 +14,11 @@ const ShotConfig = zod_1.z
     .strict()
     .passthrough();
 const NarrativeConfig = zod_1.z
-    .object({ prompt: zod_1.z.string() })
+    .object({
+    prompt: zod_1.z.string(),
+    strategy: zod_1.z.enum(["direct", "long", "balanced"]).default("balanced"),
+    number_of_chapters: zod_1.z.number().int().gte(1),
+})
     .partial()
     .strict()
     .passthrough();
@@ -90,7 +94,20 @@ const endpoints = (0, core_1.makeApi)([
         alias: "createSegments",
         description: `Create intelligent video segments based on shot detection or narrative analysis.
 
-**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.`,
+**⚠️ Note: YouTube URLs are supported for narrative-based segmentation only.** Shot-based segmentation requires direct video file access. Use Cloudglue Files, HTTP URLs, or files from data connectors for shot-based segmentation.
+
+**Narrative Segmentation Strategies:**
+
+• **balanced** (default): Uses multimodal describe job for comprehensive analysis.
+  Recommended for most videos. Supports YouTube URLs.
+
+• **direct**: Directly analyzes the full video URL with AI.
+  Ideal for videos less than 10 minutes long. Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.
+
+• **long**: Optimized for longer videos beyond 10 minutes.
+  Provides finer grain control and expressibility with direct integration of your prompt with the Video AI model.
+
+**YouTube URLs**: Automatically use the 'balanced' strategy. The strategy field is ignored for YouTube URLs, and other strategies will be rejected with an error.`,
         requestFormat: "json",
         parameters: [
             {
@@ -104,7 +121,7 @@ const endpoints = (0, core_1.makeApi)([
         errors: [
             {
                 status: 400,
-                description: `Invalid request, missing required parameters, or unsupported URL type (e.g., YouTube URLs with shot-based segmentation are not supported)`,
+                description: `Invalid request, missing required parameters, unsupported URL type (e.g., YouTube URLs with shot-based segmentation), or unsupported strategy for YouTube URLs (YouTube URLs only support 'balanced' strategy)`,
                 schema: zod_1.z.object({ error: zod_1.z.string() }).strict().passthrough(),
             },
             {

package/dist/src/client.d.ts

@@ -199,7 +199,7 @@ declare class EnhancedFilesApi {
         limit: number;
         offset: number;
     }>;
-    uploadFile(params: UploadFileParams): Promise<import("axios").AxiosResponse<any, any, {}>>;
+    uploadFile(params: UploadFileParams): Promise<import("axios").AxiosResponse<any, any>>;
     getFile(fileId: string): Promise<import("zod").objectOutputType<{
         id: import("zod").ZodString;
         status: import("zod").ZodEnum<["pending", "processing", "completed", "failed", "not_applicable"]>;
@@ -2057,6 +2057,8 @@ declare class EnhancedSegmentsApi {
             }> | undefined;
             narrative_config?: Partial<{
                 prompt: string;
+                strategy: "direct" | "long" | "balanced";
+                number_of_chapters: number;
             }> | undefined;
         }>;
         total: number;
@@ -2077,6 +2079,8 @@ declare class EnhancedSegmentsApi {
         }> | undefined;
         narrative_config?: Partial<{
             prompt: string;
+            strategy: "direct" | "long" | "balanced";
+            number_of_chapters: number;
         }> | undefined;
         total_segments?: number | undefined;
         segments?: Array<{
@@ -2105,6 +2109,8 @@ declare class EnhancedSegmentsApi {
         }> | undefined;
         narrative_config?: Partial<{
             prompt: string;
+            strategy: "direct" | "long" | "balanced";
+            number_of_chapters: number;
         }> | undefined;
         total_segments?: number | undefined;
         segments?: Array<{
@@ -2131,6 +2137,8 @@ declare class EnhancedSegmentsApi {
         }> | undefined;
         narrative_config?: Partial<{
             prompt: string;
+            strategy: "direct" | "long" | "balanced";
+            number_of_chapters: number;
         }> | undefined;
         total_segments?: number | undefined;
         segments?: Array<{

package/dist/src/client.js

@@ -645,7 +645,7 @@ class CloudGlue {
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,
                 'x-sdk-client': 'cloudglue-js',
-                'x-sdk-version': '0.4.1',
+                'x-sdk-version': '0.4.2',
             },
             baseURL: this.baseUrl,
             timeout: this.timeout,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aviaryhq/cloudglue-js",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Cloudglue API client for Node.js",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",