@studyfetch/sdk 1.41.0 → 1.43.0

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

@@ -7,17 +7,12 @@ import * as UploadAPI from './upload';
 import {
   Upload,
   UploadCompleteUploadParams,
-  UploadCompleteUploadResponse,
   UploadGetPresignedURLParams,
   UploadGetPresignedURLResponse,
   UploadUploadFileAndProcessParams,
-  UploadUploadFileAndProcessResponse,
   UploadUploadFileParams,
-  UploadUploadFileResponse,
   UploadUploadFromURLAndProcessParams,
-  UploadUploadFromURLAndProcessResponse,
   UploadUploadFromURLParams,
-  UploadUploadFromURLResponse,
 } from './upload';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
@@ -33,13 +28,13 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.create({
+   * const materialResponse = await client.v1.materials.create({
    *   content: { type: 'text' },
    *   name: 'Chapter 1 - Introduction',
    * });
    * ```
    */
-  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<MaterialCreateResponse> {
+  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<MaterialResponse> {
     return this._client.post('/api/v1/materials', { body, ...options });
   }
 
@@ -48,10 +43,12 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.retrieve('id');
+   * const materialResponse = await client.v1.materials.retrieve(
+   *   'id',
+   * );
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<MaterialRetrieveResponse> {
+  retrieve(id: string, options?: RequestOptions): APIPromise<MaterialResponse> {
     return this._client.get(path`/api/v1/materials/${id}`, options);
   }
 
@@ -60,11 +57,13 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const material = await client.v1.materials.update('id');
+   * const materialResponse = await client.v1.materials.update(
+   *   'id',
+   * );
    * ```
    */
-  update(id: string, options?: RequestOptions): APIPromise<MaterialUpdateResponse> {
-    return this._client.patch(path`/api/v1/materials/${id}`, options);
+  update(id: string, body: MaterialUpdateParams, options?: RequestOptions): APIPromise<MaterialResponse> {
+    return this._client.patch(path`/api/v1/materials/${id}`, { body, ...options });
   }
 
   /**
@@ -97,24 +96,35 @@ export class Materials extends APIResource {
     });
   }
 
+  /**
+   * Attempts to cancel a currently running PDF processing job
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.materials.cancelJob('id');
+   * ```
+   */
+  cancelJob(id: string, options?: RequestOptions): APIPromise<MaterialCancelJobResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/cancel-job`, options);
+  }
+
   /**
    * Creates a material and waits for processing to finish before returning. Useful
    * for synchronous API usage.
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.createAndProcess(
-   *   {
+   * const materialResponse =
+   *   await client.v1.materials.createAndProcess({
    *     content: { type: 'text' },
    *     name: 'Chapter 1 - Introduction',
-   *   },
-   * );
+   *   });
    * ```
    */
   createAndProcess(
     body: MaterialCreateAndProcessParams,
     options?: RequestOptions,
-  ): APIPromise<MaterialCreateAndProcessResponse> {
+  ): APIPromise<MaterialResponse> {
     return this._client.post('/api/v1/materials/upload-and-process', { body, ...options });
   }
 
@@ -148,14 +158,15 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.generate({
-   *   name: 'Photosynthesis Study Plan',
-   *   topic: 'Photosynthesis in plants',
-   *   type: 'notes',
-   * });
+   * const generatedMaterialResponse =
+   *   await client.v1.materials.generate({
+   *     name: 'Photosynthesis Study Plan',
+   *     topic: 'Photosynthesis in plants',
+   *     type: 'notes',
+   *   });
    * ```
    */
-  generate(body: MaterialGenerateParams, options?: RequestOptions): APIPromise<MaterialGenerateResponse> {
+  generate(body: MaterialGenerateParams, options?: RequestOptions): APIPromise<GeneratedMaterialResponse> {
     return this._client.post('/api/v1/materials/generate', { body, ...options });
   }
 
@@ -165,7 +176,7 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const response =
+   * const generatedMaterialResponse =
    *   await client.v1.materials.generateAndProcess({
    *     name: 'Photosynthesis Study Plan',
    *     topic: 'Photosynthesis in plants',
@@ -176,7 +187,7 @@ export class Materials extends APIResource {
   generateAndProcess(
     body: MaterialGenerateAndProcessParams,
     options?: RequestOptions,
-  ): APIPromise<MaterialGenerateAndProcessResponse> {
+  ): APIPromise<GeneratedMaterialResponse> {
     return this._client.post('/api/v1/materials/generate-and-process', { body, ...options });
   }
 
@@ -213,842 +224,101 @@ export class Materials extends APIResource {
   }
 
   /**
-   * Move material to a different folder
+   * Returns the current status of a PDF processing job including progress
+   * information
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.move('id', {
-   *   folderId: 'folderId',
-   * });
+   * const response = await client.v1.materials.getJobStatus(
+   *   'id',
+   * );
    * ```
    */
-  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialMoveResponse> {
-    return this._client.post(path`/api/v1/materials/${id}/move`, { body, ...options });
+  getJobStatus(id: string, options?: RequestOptions): APIPromise<MaterialGetJobStatusResponse> {
+    return this._client.get(path`/api/v1/materials/${id}/job-status`, options);
   }
 
   /**
-   * Rename a material
+   * Move material to a different folder
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.rename('id', {
-   *   name: 'New Material Name',
-   * });
+   * const materialResponse = await client.v1.materials.move(
+   *   'id',
+   *   { folderId: 'folderId' },
+   * );
    * ```
    */
-  rename(
-    id: string,
-    body: MaterialRenameParams,
-    options?: RequestOptions,
-  ): APIPromise<MaterialRenameResponse> {
-    return this._client.post(path`/api/v1/materials/${id}/rename`, { body, ...options });
+  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/move`, { body, ...options });
   }
 
   /**
-   * Reprocess material to regenerate embeddings and extract content
+   * Rename a material
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.reprocess('id');
+   * const materialResponse = await client.v1.materials.rename(
+   *   'id',
+   *   { name: 'New Material Name' },
+   * );
    * ```
    */
-  reprocess(id: string, options?: RequestOptions): APIPromise<MaterialReprocessResponse> {
-    return this._client.post(path`/api/v1/materials/${id}/reprocess`, options);
+  rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<MaterialResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/rename`, { body, ...options });
   }
 
   /**
-   * Search materials using RAG (Retrieval-Augmented Generation)
+   * Reprocess material to regenerate embeddings and extract content
    *
    * @example
    * ```ts
-   * const response = await client.v1.materials.search({
-   *   query: 'What is photosynthesis?',
-   * });
+   * const materialResponse =
+   *   await client.v1.materials.reprocess('id');
    * ```
    */
-  search(body: MaterialSearchParams, options?: RequestOptions): APIPromise<MaterialSearchResponse> {
-    return this._client.post('/api/v1/materials/search', { body, ...options });
-  }
-}
-
-export interface MaterialCreateResponse {
-  /**
-   * Material ID
-   */
-  _id: string;
-
-  /**
-   * Material content
-   */
-  content: MaterialCreateResponse.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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialCreateResponse.Reference>;
-
-  /**
-   * Usage information
-   */
-  usage?: unknown;
-}
-
-export namespace MaterialCreateResponse {
-  /**
-   * Material content
-   */
-  export interface Content {
-    filename?: string;
-
-    fileSize?: number;
-
-    mimeType?: string;
-
-    s3Key?: string;
-
-    s3Url?: string;
-
-    text?: string;
-
-    url?: string;
-  }
-
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
-}
-
-export interface MaterialRetrieveResponse {
-  /**
-   * Material ID
-   */
-  _id: string;
-
-  /**
-   * Material content
-   */
-  content: MaterialRetrieveResponse.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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialRetrieveResponse.Reference>;
-
-  /**
-   * Usage information
-   */
-  usage?: unknown;
-}
-
-export namespace MaterialRetrieveResponse {
-  /**
-   * Material content
-   */
-  export interface Content {
-    filename?: string;
-
-    fileSize?: number;
-
-    mimeType?: string;
-
-    s3Key?: string;
-
-    s3Url?: string;
-
-    text?: string;
-
-    url?: string;
-  }
-
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
+  reprocess(id: string, options?: RequestOptions): APIPromise<MaterialResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/reprocess`, options);
   }
-}
-
-export interface MaterialUpdateResponse {
-  /**
-   * Material ID
-   */
-  _id: string;
-
-  /**
-   * Material content
-   */
-  content: MaterialUpdateResponse.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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialUpdateResponse.Reference>;
-
-  /**
-   * Usage information
-   */
-  usage?: unknown;
-}
-
-export namespace MaterialUpdateResponse {
-  /**
-   * Material content
-   */
-  export interface Content {
-    filename?: string;
-
-    fileSize?: number;
-
-    mimeType?: string;
-
-    s3Key?: string;
-
-    s3Url?: string;
-
-    text?: string;
-
-    url?: string;
-  }
-
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
-}
-
-export interface MaterialListResponse {
-  materials?: Array<MaterialListResponse.Material>;
-
-  page?: number;
-
-  totalCount?: number;
-
-  totalPages?: number;
-}
-
-export namespace MaterialListResponse {
-  export interface Material {
-    /**
-     * Material ID
-     */
-    _id: string;
-
-    /**
-     * Material content
-     */
-    content: Material.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;
-
-    /**
-     * References that this material cites
-     */
-    references?: Array<Material.Reference>;
-
-    /**
-     * Usage information
-     */
-    usage?: unknown;
-  }
-
-  export namespace Material {
-    /**
-     * Material content
-     */
-    export interface Content {
-      filename?: string;
-
-      fileSize?: number;
-
-      mimeType?: string;
-
-      s3Key?: string;
-
-      s3Url?: string;
-
-      text?: string;
-
-      url?: string;
-    }
-
-    export interface Reference {
-      /**
-       * Reference title
-       */
-      title: string;
-
-      /**
-       * Reference URL
-       */
-      url?: string;
-    }
-  }
-}
-
-export interface MaterialCreateAndProcessResponse {
-  /**
-   * Material ID
-   */
-  _id: string;
-
-  /**
-   * Material content
-   */
-  content: MaterialCreateAndProcessResponse.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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialCreateAndProcessResponse.Reference>;
-
-  /**
-   * Usage information
-   */
-  usage?: unknown;
-}
-
-export namespace MaterialCreateAndProcessResponse {
-  /**
-   * Material content
-   */
-  export interface Content {
-    filename?: string;
-
-    fileSize?: number;
-
-    mimeType?: string;
-
-    s3Key?: string;
-
-    s3Url?: string;
-
-    text?: string;
-
-    url?: string;
-  }
-
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
-}
-
-export type MaterialCreateBatchUploadURLsResponse =
-  Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
-
-export namespace MaterialCreateBatchUploadURLsResponse {
-  export interface MaterialCreateBatchUploadURLsResponseItem {
-    /**
-     * Material ID
-     */
-    materialId: string;
-
-    /**
-     * Material name
-     */
-    name: string;
-
-    /**
-     * S3 key
-     */
-    s3Key: string;
-
-    /**
-     * Presigned upload URL
-     */
-    uploadUrl: string;
-  }
-}
-
-export interface MaterialGenerateResponse {
-  /**
-   * Material ID
-   */
-  _id: string;
-
-  /**
-   * Material content
-   */
-  content: MaterialGenerateResponse.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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialGenerateResponse.Reference>;
-
-  /**
-   * 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 Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    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;
-
-  /**
-   * References that this material cites
-   */
-  references?: Array<MaterialGenerateAndProcessResponse.Reference>;
-
-  /**
-   * 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 Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    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
+   * Search materials using RAG (Retrieval-Augmented Generation)
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.materials.search({
+   *   query: 'What is photosynthesis?',
+   * });
+   * ```
    */
-  metadata: unknown;
+  search(body: MaterialSearchParams, options?: RequestOptions): APIPromise<MaterialSearchResponse> {
+    return this._client.post('/api/v1/materials/search', { body, ...options });
+  }
+}
 
+export interface Content {
   /**
-   * Material name
+   * Type of content
    */
-  name: string;
+  type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
 
   /**
-   * Processing status
+   * URL to fetch content from
    */
-  status: string;
+  sourceUrl?: string;
 
   /**
-   * Transcript structure for videos
+   * Text content (for text type)
    */
-  transcriptStructure: unknown | null;
-}
-
-export namespace MaterialGetDebugInfoResponse {
-  export interface Image {
-    id?: string;
-
-    description?: string;
-
-    pageIndex?: number;
-
-    s3Key?: string;
-
-    s3Url?: string;
-  }
-}
+  text?: string;
 
-export interface MaterialGetDownloadURLResponse {
   /**
-   * Temporary download URL
+   * URL to the content (for url type)
    */
-  downloadUrl: string;
+  url?: string;
 }
 
-export interface MaterialMoveResponse {
+export interface GeneratedMaterialResponse {
   /**
    * Material ID
    */
@@ -1057,7 +327,7 @@ export interface MaterialMoveResponse {
   /**
    * Material content
    */
-  content: MaterialMoveResponse.Content;
+  content: GeneratedMaterialResponse.Content;
 
   /**
    * Content type
@@ -1094,6 +364,11 @@ export interface MaterialMoveResponse {
    */
   updatedAt: string;
 
+  /**
+   * Generation metadata
+   */
+  generationMetadata?: unknown;
+
   /**
    * Material metadata
    */
@@ -1102,7 +377,7 @@ export interface MaterialMoveResponse {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialMoveResponse.Reference>;
+  references?: Array<Reference>;
 
   /**
    * Usage information
@@ -1110,7 +385,7 @@ export interface MaterialMoveResponse {
   usage?: unknown;
 }
 
-export namespace MaterialMoveResponse {
+export namespace GeneratedMaterialResponse {
   /**
    * Material content
    */
@@ -1129,21 +404,9 @@ export namespace MaterialMoveResponse {
 
     url?: string;
   }
-
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
 }
 
-export interface MaterialRenameResponse {
+export interface MaterialResponse {
   /**
    * Material ID
    */
@@ -1152,7 +415,7 @@ export interface MaterialRenameResponse {
   /**
    * Material content
    */
-  content: MaterialRenameResponse.Content;
+  content: MaterialResponse.Content;
 
   /**
    * Content type
@@ -1197,7 +460,7 @@ export interface MaterialRenameResponse {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialRenameResponse.Reference>;
+  references?: Array<Reference>;
 
   /**
    * Usage information
@@ -1205,7 +468,7 @@ export interface MaterialRenameResponse {
   usage?: unknown;
 }
 
-export namespace MaterialRenameResponse {
+export namespace MaterialResponse {
   /**
    * Material content
    */
@@ -1224,45 +487,88 @@ export namespace MaterialRenameResponse {
 
     url?: string;
   }
+}
 
-  export interface Reference {
+export interface Reference {
+  /**
+   * Reference title
+   */
+  title: string;
+
+  /**
+   * Reference URL
+   */
+  url?: string;
+}
+
+export interface MaterialListResponse {
+  materials?: Array<MaterialResponse>;
+
+  page?: number;
+
+  totalCount?: number;
+
+  totalPages?: number;
+}
+
+export interface MaterialCancelJobResponse {
+  message?: string;
+
+  success?: boolean;
+}
+
+export type MaterialCreateBatchUploadURLsResponse =
+  Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
+
+export namespace MaterialCreateBatchUploadURLsResponse {
+  export interface MaterialCreateBatchUploadURLsResponseItem {
     /**
-     * Reference title
+     * Material ID
      */
-    title: string;
+    materialId: string;
 
     /**
-     * Reference URL
+     * Material name
      */
-    url?: string;
+    name: string;
+
+    /**
+     * S3 key
+     */
+    s3Key: string;
+
+    /**
+     * Presigned upload URL
+     */
+    uploadUrl: string;
   }
 }
 
-export interface MaterialReprocessResponse {
+export interface MaterialGetDebugInfoResponse {
   /**
-   * Material ID
+   * Content details
    */
-  _id: string;
+  content: unknown;
 
   /**
-   * Material content
+   * Content type
    */
-  content: MaterialReprocessResponse.Content;
+  contentType: string;
 
   /**
-   * Content type
+   * Processed images
    */
-  contentType: 'text' | 'pdf' | 'video' | 'audio' | 'image' | 'epub';
+  images: Array<MaterialGetDebugInfoResponse.Image>;
 
   /**
-   * Creation timestamp
+   * Material ID
    */
-  createdAt: string;
+  materialId: string;
 
   /**
-   * Folder ID
+   * Material metadata
    */
-  folderId: string | null;
+  metadata: unknown;
 
   /**
    * Material name
@@ -1270,66 +576,116 @@ export interface MaterialReprocessResponse {
   name: string;
 
   /**
-   * Organization ID
+   * Processing status
    */
-  organizationId: string;
+  status: string;
 
   /**
-   * Material status
+   * Transcript structure for videos
    */
-  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+  transcriptStructure: unknown | null;
+}
+
+export namespace MaterialGetDebugInfoResponse {
+  export interface Image {
+    id?: string;
 
+    description?: string;
+
+    pageIndex?: number;
+
+    s3Key?: string;
+
+    s3Url?: string;
+  }
+}
+
+export interface MaterialGetDownloadURLResponse {
   /**
-   * Last update timestamp
+   * Temporary download URL
    */
-  updatedAt: string;
+  downloadUrl: string;
+}
 
+export interface MaterialGetJobStatusResponse {
   /**
-   * Material metadata
+   * Job completion time
    */
-  metadata?: unknown;
+  completedAt?: string;
 
   /**
-   * References that this material cites
+   * Error message if job failed
    */
-  references?: Array<MaterialReprocessResponse.Reference>;
+  error?: string;
 
   /**
-   * Usage information
+   * Unique job identifier
    */
-  usage?: unknown;
-}
+  jobId?: string;
+
+  progress?: MaterialGetJobStatusResponse.Progress;
+
+  resultSummary?: MaterialGetJobStatusResponse.ResultSummary;
 
-export namespace MaterialReprocessResponse {
   /**
-   * Material content
+   * Job start time
    */
-  export interface Content {
-    filename?: string;
+  startedAt?: string;
 
-    fileSize?: number;
+  /**
+   * Current job status
+   */
+  status?: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+}
 
-    mimeType?: string;
+export namespace MaterialGetJobStatusResponse {
+  export interface Progress {
+    /**
+     * Current batch being processed
+     */
+    currentBatch?: number;
 
-    s3Key?: string;
+    /**
+     * Completion percentage (0-100)
+     */
+    percentage?: number;
 
-    s3Url?: string;
+    /**
+     * Images processed so far
+     */
+    processedImages?: number;
 
-    text?: string;
+    /**
+     * Total number of batches
+     */
+    totalBatches?: number;
 
-    url?: string;
+    /**
+     * Total images to process
+     */
+    totalImages?: number;
   }
 
-  export interface Reference {
+  export interface ResultSummary {
     /**
-     * Reference title
+     * Number of images processed
      */
-    title: string;
+    imagesProcessed?: number;
 
     /**
-     * Reference URL
+     * Total processing time in milliseconds
      */
-    url?: string;
+    processingTimeMs?: number;
+
+    /**
+     * Whether text was extracted
+     */
+    textExtracted?: boolean;
+
+    /**
+     * Length of extracted text
+     */
+    textLength?: number;
   }
 }
 
@@ -1410,7 +766,7 @@ export interface MaterialCreateParams {
   /**
    * Content details
    */
-  content: MaterialCreateParams.Content;
+  content: Content;
 
   /**
    * Name of the material
@@ -1425,35 +781,17 @@ export interface MaterialCreateParams {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialCreateParams.Reference>;
+  references?: Array<Reference>;
 }
 
-export namespace MaterialCreateParams {
+export interface MaterialUpdateParams {
   /**
-   * Content details
+   * Array of references to update (optional)
    */
-  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;
-  }
+  references?: Array<MaterialUpdateParams.Reference>;
+}
 
+export namespace MaterialUpdateParams {
   export interface Reference {
     /**
      * Reference title
@@ -1461,7 +799,7 @@ export namespace MaterialCreateParams {
     title: string;
 
     /**
-     * Reference URL
+     * Reference URL (optional)
      */
     url?: string;
   }
@@ -1493,7 +831,7 @@ export interface MaterialCreateAndProcessParams {
   /**
    * Content details
    */
-  content: MaterialCreateAndProcessParams.Content;
+  content: Content;
 
   /**
    * Name of the material
@@ -1513,7 +851,7 @@ export interface MaterialCreateAndProcessParams {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialCreateAndProcessParams.Reference>;
+  references?: Array<Reference>;
 
   /**
    * Maximum time to wait for processing in milliseconds (default: 5 minutes)
@@ -1521,45 +859,6 @@ 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 Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
-}
-
 export interface MaterialCreateBatchUploadURLsParams {
   /**
    * Array of materials to create
@@ -1630,21 +929,7 @@ export interface MaterialGenerateParams {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialGenerateParams.Reference>;
-}
-
-export namespace MaterialGenerateParams {
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
+  references?: Array<Reference>;
 }
 
 export interface MaterialGenerateAndProcessParams {
@@ -1691,7 +976,7 @@ export interface MaterialGenerateAndProcessParams {
   /**
    * References that this material cites
    */
-  references?: Array<MaterialGenerateAndProcessParams.Reference>;
+  references?: Array<Reference>;
 
   /**
    * Maximum time to wait for processing in milliseconds (default: 5 minutes)
@@ -1699,20 +984,6 @@ export interface MaterialGenerateAndProcessParams {
   timeoutMs?: number;
 }
 
-export namespace MaterialGenerateAndProcessParams {
-  export interface Reference {
-    /**
-     * Reference title
-     */
-    title: string;
-
-    /**
-     * Reference URL
-     */
-    url?: string;
-  }
-}
-
 export interface MaterialGetDownloadURLParams {
   /**
    * URL expiration time in seconds (default: 3600)
@@ -1761,21 +1032,19 @@ Materials.Bulk = Bulk;
 
 export declare namespace Materials {
   export {
-    type MaterialCreateResponse as MaterialCreateResponse,
-    type MaterialRetrieveResponse as MaterialRetrieveResponse,
-    type MaterialUpdateResponse as MaterialUpdateResponse,
+    type Content as Content,
+    type GeneratedMaterialResponse as GeneratedMaterialResponse,
+    type MaterialResponse as MaterialResponse,
+    type Reference as Reference,
     type MaterialListResponse as MaterialListResponse,
-    type MaterialCreateAndProcessResponse as MaterialCreateAndProcessResponse,
+    type MaterialCancelJobResponse as MaterialCancelJobResponse,
     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 MaterialGetJobStatusResponse as MaterialGetJobStatusResponse,
     type MaterialSearchResponse as MaterialSearchResponse,
     type MaterialCreateParams as MaterialCreateParams,
+    type MaterialUpdateParams as MaterialUpdateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
     type MaterialCreateBatchUploadURLsParams as MaterialCreateBatchUploadURLsParams,
@@ -1789,12 +1058,7 @@ export declare namespace Materials {
 
   export {
     Upload as Upload,
-    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 UploadGetPresignedURLParams as UploadGetPresignedURLParams,
     type UploadUploadFileParams as UploadUploadFileParams,