@studyfetch/sdk 1.33.0 → 1.34.0

package/src/resources/v1/materials/materials.ts

@@ -6,22 +6,26 @@ import { Bulk, BulkMoveParams, BulkMoveResponse } from './bulk';
 import * as TestAPI from './test';
 import {
   Test,
-  TestPerformOcrResponse,
-  TestProcessEpubResponse,
-  TestProcessImageResponse,
-  TestProcessVideoResponse,
+  TestTestEpubProcessingResponse,
+  TestTestImageProcessingResponse,
+  TestTestOcrResponse,
+  TestTestVideoProcessingResponse,
 } from './test';
 import * as UploadAPI from './upload';
 import {
-  Complete,
   Upload,
   UploadCompleteUploadParams,
-  UploadCreatePresignedURLParams,
-  UploadCreatePresignedURLResponse,
+  UploadCompleteUploadResponse,
+  UploadGetPresignedURLParams,
+  UploadGetPresignedURLResponse,
   UploadUploadFileAndProcessParams,
+  UploadUploadFileAndProcessResponse,
   UploadUploadFileParams,
+  UploadUploadFileResponse,
+  UploadUploadFromURLAndProcessParams,
+  UploadUploadFromURLAndProcessResponse,
   UploadUploadFromURLParams,
-  UploadUploadURLAndProcessParams,
+  UploadUploadFromURLResponse,
 } from './upload';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
@@ -44,7 +48,7 @@ export class Materials extends APIResource {
    * });
    * ```
    */
-  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<Material> {
+  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<MaterialCreateResponse> {
     return this._client.post('/api/v1/materials', { body, ...options });
   }
 
@@ -56,7 +60,7 @@ export class Materials extends APIResource {
    * const material = await client.v1.materials.retrieve('id');
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Material> {
+  retrieve(id: string, options?: RequestOptions): APIPromise<MaterialRetrieveResponse> {
     return this._client.get(path`/api/v1/materials/${id}`, options);
   }
 
@@ -90,36 +94,13 @@ export class Materials extends APIResource {
     });
   }
 
-  /**
-   * Create batch upload URLs for multiple materials
-   *
-   * @example
-   * ```ts
-   * const response = await client.v1.materials.batchCreate({
-   *   materials: [
-   *     {
-   *       contentType: 'application/pdf',
-   *       filename: 'document.pdf',
-   *       name: 'Chapter 1',
-   *     },
-   *   ],
-   * });
-   * ```
-   */
-  batchCreate(
-    body: MaterialBatchCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<MaterialBatchCreateResponse> {
-    return this._client.post('/api/v1/materials/batch', { body, ...options });
-  }
-
   /**
    * Creates a material and waits for processing to finish before returning. Useful
    * for synchronous API usage.
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.createAndProcess(
+   * const response = await client.v1.materials.createAndProcess(
    *   {
    *     content: { type: 'text' },
    *     name: 'Chapter 1 - Introduction',
@@ -127,20 +108,35 @@ export class Materials extends APIResource {
    * );
    * ```
    */
-  createAndProcess(body: MaterialCreateAndProcessParams, options?: RequestOptions): APIPromise<Material> {
+  createAndProcess(
+    body: MaterialCreateAndProcessParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialCreateAndProcessResponse> {
     return this._client.post('/api/v1/materials/upload-and-process', { body, ...options });
   }
 
   /**
-   * Get debug information for a material including extracted content
+   * Create batch upload URLs for multiple materials
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.debug('id');
+   * const response =
+   *   await client.v1.materials.createBatchUploadURLs({
+   *     materials: [
+   *       {
+   *         contentType: 'application/pdf',
+   *         filename: 'document.pdf',
+   *         name: 'Chapter 1',
+   *       },
+   *     ],
+   *   });
    * ```
    */
-  debug(id: string, options?: RequestOptions): APIPromise<MaterialDebugResponse> {
-    return this._client.get(path`/api/v1/materials/${id}/debug`, options);
+  createBatchUploadURLs(
+    body: MaterialCreateBatchUploadURLsParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialCreateBatchUploadURLsResponse> {
+    return this._client.post('/api/v1/materials/batch', { body, ...options });
   }
 
   /**
@@ -149,15 +145,14 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const generatedMaterial =
-   *   await client.v1.materials.generate({
-   *     name: 'Photosynthesis Study Plan',
-   *     topic: 'Photosynthesis in plants',
-   *     type: 'notes',
-   *   });
+   * const response = await client.v1.materials.generate({
+   *   name: 'Photosynthesis Study Plan',
+   *   topic: 'Photosynthesis in plants',
+   *   type: 'notes',
+   * });
    * ```
    */
-  generate(body: MaterialGenerateParams, options?: RequestOptions): APIPromise<GeneratedMaterial> {
+  generate(body: MaterialGenerateParams, options?: RequestOptions): APIPromise<MaterialGenerateResponse> {
     return this._client.post('/api/v1/materials/generate', { body, ...options });
   }
 
@@ -167,7 +162,7 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const generatedMaterial =
+   * const response =
    *   await client.v1.materials.generateAndProcess({
    *     name: 'Photosynthesis Study Plan',
    *     topic: 'Photosynthesis in plants',
@@ -178,10 +173,24 @@ export class Materials extends APIResource {
   generateAndProcess(
     body: MaterialGenerateAndProcessParams,
     options?: RequestOptions,
-  ): APIPromise<GeneratedMaterial> {
+  ): APIPromise<MaterialGenerateAndProcessResponse> {
     return this._client.post('/api/v1/materials/generate-and-process', { body, ...options });
   }
 
+  /**
+   * Get debug information for a material including extracted content
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.materials.getDebugInfo(
+   *   'id',
+   * );
+   * ```
+   */
+  getDebugInfo(id: string, options?: RequestOptions): APIPromise<MaterialGetDebugInfoResponse> {
+    return this._client.get(path`/api/v1/materials/${id}/debug`, options);
+  }
+
   /**
    * Get temporary download URL for material
    *
@@ -205,12 +214,12 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.move('id', {
+   * const response = await client.v1.materials.move('id', {
    *   folderId: 'folderId',
    * });
    * ```
    */
-  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<Material> {
+  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialMoveResponse> {
     return this._client.post(path`/api/v1/materials/${id}/move`, { body, ...options });
   }
 
@@ -219,12 +228,16 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.rename('id', {
+   * const response = await client.v1.materials.rename('id', {
    *   name: 'New Material Name',
    * });
    * ```
    */
-  rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<Material> {
+  rename(
+    id: string,
+    body: MaterialRenameParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialRenameResponse> {
     return this._client.post(path`/api/v1/materials/${id}/rename`, { body, ...options });
   }
 
@@ -233,10 +246,10 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.reprocess('id');
+   * const response = await client.v1.materials.reprocess('id');
    * ```
    */
-  reprocess(id: string, options?: RequestOptions): APIPromise<Material> {
+  reprocess(id: string, options?: RequestOptions): APIPromise<MaterialReprocessResponse> {
     return this._client.post(path`/api/v1/materials/${id}/reprocess`, options);
   }
 
@@ -255,29 +268,7 @@ export class Materials extends APIResource {
   }
 }
 
-export interface Content {
-  /**
-   * Type of content
-   */
-  type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
-
-  /**
-   * URL to fetch content from
-   */
-  sourceUrl?: string;
-
-  /**
-   * Text content (for text type)
-   */
-  text?: string;
-
-  /**
-   * URL to the content (for url type)
-   */
-  url?: string;
-}
-
-export interface GeneratedMaterial {
+export interface MaterialCreateResponse {
   /**
    * Material ID
    */
@@ -286,7 +277,7 @@ export interface GeneratedMaterial {
   /**
    * Material content
    */
-  content: GeneratedMaterial.Content;
+  content: MaterialCreateResponse.Content;
 
   /**
    * Content type
@@ -323,11 +314,6 @@ export interface GeneratedMaterial {
    */
   updatedAt: string;
 
-  /**
-   * Generation metadata
-   */
-  generationMetadata?: unknown;
-
   /**
    * Material metadata
    */
@@ -339,7 +325,7 @@ export interface GeneratedMaterial {
   usage?: unknown;
 }
 
-export namespace GeneratedMaterial {
+export namespace MaterialCreateResponse {
   /**
    * Material content
    */
@@ -360,7 +346,7 @@ export namespace GeneratedMaterial {
   }
 }
 
-export interface Material {
+export interface MaterialRetrieveResponse {
   /**
    * Material ID
    */
@@ -369,7 +355,7 @@ export interface Material {
   /**
    * Material content
    */
-  content: Material.Content;
+  content: MaterialRetrieveResponse.Content;
 
   /**
    * Content type
@@ -417,7 +403,7 @@ export interface Material {
   usage?: unknown;
 }
 
-export namespace Material {
+export namespace MaterialRetrieveResponse {
   /**
    * Material content
    */
@@ -438,16 +424,34 @@ export namespace Material {
   }
 }
 
-export type MaterialListResponse = Array<Material>;
+export type MaterialListResponse = Array<MaterialListResponse.MaterialListResponseItem>;
 
-export type MaterialBatchCreateResponse = Array<MaterialBatchCreateResponse.MaterialBatchCreateResponseItem>;
-
-export namespace MaterialBatchCreateResponse {
-  export interface MaterialBatchCreateResponseItem {
+export namespace MaterialListResponse {
+  export interface MaterialListResponseItem {
     /**
      * Material ID
      */
-    materialId: string;
+    _id: string;
+
+    /**
+     * Material content
+     */
+    content: MaterialListResponseItem.Content;
+
+    /**
+     * Content type
+     */
+    contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+    /**
+     * Creation timestamp
+     */
+    createdAt: string;
+
+    /**
+     * Folder ID
+     */
+    folderId: string | null;
 
     /**
      * Material name
@@ -455,42 +459,78 @@ export namespace MaterialBatchCreateResponse {
     name: string;
 
     /**
-     * S3 key
+     * Organization ID
      */
-    s3Key: string;
+    organizationId: string;
 
     /**
-     * Presigned upload URL
+     * Material status
      */
-    uploadUrl: string;
+    status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+
+    /**
+     * Material metadata
+     */
+    metadata?: unknown;
+
+    /**
+     * Usage information
+     */
+    usage?: unknown;
+  }
+
+  export namespace MaterialListResponseItem {
+    /**
+     * Material content
+     */
+    export interface Content {
+      filename?: string;
+
+      fileSize?: number;
+
+      mimeType?: string;
+
+      s3Key?: string;
+
+      s3Url?: string;
+
+      text?: string;
+
+      url?: string;
+    }
   }
 }
 
-export interface MaterialDebugResponse {
+export interface MaterialCreateAndProcessResponse {
   /**
-   * Content details
+   * Material ID
    */
-  content: unknown;
+  _id: string;
 
   /**
-   * Content type
+   * Material content
    */
-  contentType: string;
+  content: MaterialCreateAndProcessResponse.Content;
 
   /**
-   * Processed images
+   * Content type
    */
-  images: Array<MaterialDebugResponse.Image>;
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
 
   /**
-   * Material ID
+   * Creation timestamp
    */
-  materialId: string;
+  createdAt: string;
 
   /**
-   * Material metadata
+   * Folder ID
    */
-  metadata: unknown;
+  folderId: string | null;
 
   /**
    * Material name
@@ -498,170 +538,671 @@ export interface MaterialDebugResponse {
   name: string;
 
   /**
-   * Processing status
+   * Organization ID
    */
-  status: string;
+  organizationId: string;
 
   /**
-   * Transcript structure for videos
+   * Material status
    */
-  transcriptStructure: unknown | null;
-}
-
-export namespace MaterialDebugResponse {
-  export interface Image {
-    id?: string;
-
-    description?: string;
-
-    pageIndex?: number;
-
-    s3Key?: string;
-
-    s3Url?: string;
-  }
-}
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
 
-export interface MaterialGetDownloadURLResponse {
   /**
-   * Temporary download URL
+   * Last update timestamp
    */
-  downloadUrl: string;
-}
+  updatedAt: string;
 
-export interface MaterialSearchResponse {
   /**
-   * Whether results were filtered by scope
+   * Material metadata
    */
-  filtered: boolean;
+  metadata?: unknown;
 
   /**
-   * Original search query
+   * Usage information
    */
-  query: string;
+  usage?: unknown;
+}
 
+export namespace MaterialCreateAndProcessResponse {
   /**
-   * Search results
+   * Material content
    */
-  results: Array<MaterialSearchResponse.Result>;
+  export interface Content {
+    filename?: string;
 
-  /**
-   * Search scope
-   */
-  scope: MaterialSearchResponse.Scope;
+    fileSize?: number;
 
-  /**
-   * Total number of results
-   */
-  totalResults: number;
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
 }
 
-export namespace MaterialSearchResponse {
-  export interface Result {
-    /**
-     * Chunk index within the material
-     */
-    chunkIndex: number;
+export type MaterialCreateBatchUploadURLsResponse =
+  Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
 
+export namespace MaterialCreateBatchUploadURLsResponse {
+  export interface MaterialCreateBatchUploadURLsResponseItem {
     /**
-     * Material information
+     * Material ID
      */
-    material: Result.Material | null;
+    materialId: string;
 
     /**
-     * Relevance score (0-1)
+     * Material name
      */
-    score: number;
+    name: string;
 
     /**
-     * Matched text chunk
+     * S3 key
      */
-    text: string;
-  }
+    s3Key: string;
 
-  export namespace Result {
     /**
-     * Material information
+     * Presigned upload URL
      */
-    export interface Material {
-      id?: string;
+    uploadUrl: string;
+  }
+}
 
-      contentType?: string;
+export interface MaterialGenerateResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
 
-      name?: string;
-    }
-  }
+  /**
+   * Material content
+   */
+  content: MaterialGenerateResponse.Content;
 
   /**
-   * Search scope
+   * Content type
    */
-  export interface Scope {
-    folderIds?: Array<string>;
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
 
-    materialIds?: Array<string>;
-  }
-}
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
 
-export interface MaterialCreateParams {
   /**
-   * Content details
+   * Folder ID
    */
-  content: Content;
+  folderId: string | null;
 
   /**
-   * Name of the material
+   * Material name
    */
   name: string;
 
   /**
-   * Folder ID to place the material in
+   * Organization ID
    */
-  folderId?: string;
-}
+  organizationId: string;
 
-export interface MaterialListParams {
   /**
-   * Filter by folder ID
+   * Material status
    */
-  folderId?: string;
-}
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
 
-export interface MaterialBatchCreateParams {
   /**
-   * Array of materials to create
+   * Last update timestamp
    */
-  materials: Array<MaterialBatchCreateParams.Material>;
-}
+  updatedAt: string;
 
-export namespace MaterialBatchCreateParams {
-  export interface Material {
-    /**
-     * MIME type
-     */
-    contentType: string;
+  /**
+   * Generation metadata
+   */
+  generationMetadata?: unknown;
 
-    /**
-     * Filename
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialGenerateResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
+export interface MaterialGenerateAndProcessResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
+
+  /**
+   * Material content
+   */
+  content: MaterialGenerateAndProcessResponse.Content;
+
+  /**
+   * Content type
+   */
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Folder ID
+   */
+  folderId: string | null;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Organization ID
+   */
+  organizationId: string;
+
+  /**
+   * Material status
+   */
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Generation metadata
+   */
+  generationMetadata?: unknown;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialGenerateAndProcessResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
+export interface MaterialGetDebugInfoResponse {
+  /**
+   * Content details
+   */
+  content: unknown;
+
+  /**
+   * Content type
+   */
+  contentType: string;
+
+  /**
+   * Processed images
+   */
+  images: Array<MaterialGetDebugInfoResponse.Image>;
+
+  /**
+   * Material ID
+   */
+  materialId: string;
+
+  /**
+   * Material metadata
+   */
+  metadata: unknown;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Processing status
+   */
+  status: string;
+
+  /**
+   * Transcript structure for videos
+   */
+  transcriptStructure: unknown | null;
+}
+
+export namespace MaterialGetDebugInfoResponse {
+  export interface Image {
+    id?: string;
+
+    description?: string;
+
+    pageIndex?: number;
+
+    s3Key?: string;
+
+    s3Url?: string;
+  }
+}
+
+export interface MaterialGetDownloadURLResponse {
+  /**
+   * Temporary download URL
+   */
+  downloadUrl: string;
+}
+
+export interface MaterialMoveResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
+
+  /**
+   * Material content
+   */
+  content: MaterialMoveResponse.Content;
+
+  /**
+   * Content type
+   */
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Folder ID
+   */
+  folderId: string | null;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Organization ID
+   */
+  organizationId: string;
+
+  /**
+   * Material status
+   */
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialMoveResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
+export interface MaterialRenameResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
+
+  /**
+   * Material content
+   */
+  content: MaterialRenameResponse.Content;
+
+  /**
+   * Content type
+   */
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Folder ID
+   */
+  folderId: string | null;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Organization ID
+   */
+  organizationId: string;
+
+  /**
+   * Material status
+   */
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialRenameResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
+export interface MaterialReprocessResponse {
+  /**
+   * Material ID
+   */
+  _id: string;
+
+  /**
+   * Material content
+   */
+  content: MaterialReprocessResponse.Content;
+
+  /**
+   * Content type
+   */
+  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+
+  /**
+   * Creation timestamp
+   */
+  createdAt: string;
+
+  /**
+   * Folder ID
+   */
+  folderId: string | null;
+
+  /**
+   * Material name
+   */
+  name: string;
+
+  /**
+   * Organization ID
+   */
+  organizationId: string;
+
+  /**
+   * Material status
+   */
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
+}
+
+export namespace MaterialReprocessResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
+
+    fileSize?: number;
+
+    mimeType?: string;
+
+    s3Key?: string;
+
+    s3Url?: string;
+
+    text?: string;
+
+    url?: string;
+  }
+}
+
+export interface MaterialSearchResponse {
+  /**
+   * Whether results were filtered by scope
+   */
+  filtered: boolean;
+
+  /**
+   * Original search query
+   */
+  query: string;
+
+  /**
+   * Search results
+   */
+  results: Array<MaterialSearchResponse.Result>;
+
+  /**
+   * Search scope
+   */
+  scope: MaterialSearchResponse.Scope;
+
+  /**
+   * Total number of results
+   */
+  totalResults: number;
+}
+
+export namespace MaterialSearchResponse {
+  export interface Result {
+    /**
+     * Chunk index within the material
      */
-    filename: string;
+    chunkIndex: number;
 
     /**
-     * Material name
+     * Material information
      */
-    name: string;
+    material: Result.Material | null;
 
     /**
-     * Folder ID
+     * Relevance score (0-1)
      */
-    folderId?: string;
+    score: number;
+
+    /**
+     * Matched text chunk
+     */
+    text: string;
+  }
+
+  export namespace Result {
+    /**
+     * Material information
+     */
+    export interface Material {
+      id?: string;
+
+      contentType?: string;
+
+      name?: string;
+    }
+  }
+
+  /**
+   * Search scope
+   */
+  export interface Scope {
+    folderIds?: Array<string>;
+
+    materialIds?: Array<string>;
+  }
+}
+
+export interface MaterialCreateParams {
+  /**
+   * Content details
+   */
+  content: MaterialCreateParams.Content;
+
+  /**
+   * Name of the material
+   */
+  name: string;
+
+  /**
+   * Folder ID to place the material in
+   */
+  folderId?: string;
+}
+
+export namespace MaterialCreateParams {
+  /**
+   * Content details
+   */
+  export interface Content {
+    /**
+     * Type of content
+     */
+    type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
+
+    /**
+     * URL to fetch content from
+     */
+    sourceUrl?: string;
+
+    /**
+     * Text content (for text type)
+     */
+    text?: string;
+
+    /**
+     * URL to the content (for url type)
+     */
+    url?: string;
   }
 }
 
+export interface MaterialListParams {
+  /**
+   * Filter by folder ID
+   */
+  folderId?: string;
+}
+
 export interface MaterialCreateAndProcessParams {
   /**
    * Content details
    */
-  content: Content;
+  content: MaterialCreateAndProcessParams.Content;
 
   /**
    * Name of the material
@@ -684,6 +1225,64 @@ export interface MaterialCreateAndProcessParams {
   timeoutMs?: number;
 }
 
+export namespace MaterialCreateAndProcessParams {
+  /**
+   * Content details
+   */
+  export interface Content {
+    /**
+     * Type of content
+     */
+    type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
+
+    /**
+     * URL to fetch content from
+     */
+    sourceUrl?: string;
+
+    /**
+     * Text content (for text type)
+     */
+    text?: string;
+
+    /**
+     * URL to the content (for url type)
+     */
+    url?: string;
+  }
+}
+
+export interface MaterialCreateBatchUploadURLsParams {
+  /**
+   * Array of materials to create
+   */
+  materials: Array<MaterialCreateBatchUploadURLsParams.Material>;
+}
+
+export namespace MaterialCreateBatchUploadURLsParams {
+  export interface Material {
+    /**
+     * MIME type
+     */
+    contentType: string;
+
+    /**
+     * Filename
+     */
+    filename: string;
+
+    /**
+     * Material name
+     */
+    name: string;
+
+    /**
+     * Folder ID
+     */
+    folderId?: string;
+  }
+}
+
 export interface MaterialGenerateParams {
   /**
    * Name for the generated material
@@ -817,18 +1416,23 @@ Materials.Test = Test;
 
 export declare namespace Materials {
   export {
-    type Content as Content,
-    type GeneratedMaterial as GeneratedMaterial,
-    type Material as Material,
+    type MaterialCreateResponse as MaterialCreateResponse,
+    type MaterialRetrieveResponse as MaterialRetrieveResponse,
     type MaterialListResponse as MaterialListResponse,
-    type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
-    type MaterialDebugResponse as MaterialDebugResponse,
+    type MaterialCreateAndProcessResponse as MaterialCreateAndProcessResponse,
+    type MaterialCreateBatchUploadURLsResponse as MaterialCreateBatchUploadURLsResponse,
+    type MaterialGenerateResponse as MaterialGenerateResponse,
+    type MaterialGenerateAndProcessResponse as MaterialGenerateAndProcessResponse,
+    type MaterialGetDebugInfoResponse as MaterialGetDebugInfoResponse,
     type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse,
+    type MaterialMoveResponse as MaterialMoveResponse,
+    type MaterialRenameResponse as MaterialRenameResponse,
+    type MaterialReprocessResponse as MaterialReprocessResponse,
     type MaterialSearchResponse as MaterialSearchResponse,
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
-    type MaterialBatchCreateParams as MaterialBatchCreateParams,
     type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
+    type MaterialCreateBatchUploadURLsParams as MaterialCreateBatchUploadURLsParams,
     type MaterialGenerateParams as MaterialGenerateParams,
     type MaterialGenerateAndProcessParams as MaterialGenerateAndProcessParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
@@ -839,23 +1443,27 @@ export declare namespace Materials {
 
   export {
     Upload as Upload,
-    type Complete as Complete,
-    type UploadCreatePresignedURLResponse as UploadCreatePresignedURLResponse,
+    type UploadCompleteUploadResponse as UploadCompleteUploadResponse,
+    type UploadGetPresignedURLResponse as UploadGetPresignedURLResponse,
+    type UploadUploadFileResponse as UploadUploadFileResponse,
+    type UploadUploadFileAndProcessResponse as UploadUploadFileAndProcessResponse,
+    type UploadUploadFromURLResponse as UploadUploadFromURLResponse,
+    type UploadUploadFromURLAndProcessResponse as UploadUploadFromURLAndProcessResponse,
     type UploadCompleteUploadParams as UploadCompleteUploadParams,
-    type UploadCreatePresignedURLParams as UploadCreatePresignedURLParams,
+    type UploadGetPresignedURLParams as UploadGetPresignedURLParams,
     type UploadUploadFileParams as UploadUploadFileParams,
     type UploadUploadFileAndProcessParams as UploadUploadFileAndProcessParams,
     type UploadUploadFromURLParams as UploadUploadFromURLParams,
-    type UploadUploadURLAndProcessParams as UploadUploadURLAndProcessParams,
+    type UploadUploadFromURLAndProcessParams as UploadUploadFromURLAndProcessParams,
   };
 
   export { Bulk as Bulk, type BulkMoveResponse as BulkMoveResponse, type BulkMoveParams as BulkMoveParams };
 
   export {
     Test as Test,
-    type TestPerformOcrResponse as TestPerformOcrResponse,
-    type TestProcessEpubResponse as TestProcessEpubResponse,
-    type TestProcessImageResponse as TestProcessImageResponse,
-    type TestProcessVideoResponse as TestProcessVideoResponse,
+    type TestTestEpubProcessingResponse as TestTestEpubProcessingResponse,
+    type TestTestImageProcessingResponse as TestTestImageProcessingResponse,
+    type TestTestOcrResponse as TestTestOcrResponse,
+    type TestTestVideoProcessingResponse as TestTestVideoProcessingResponse,
   };
 }