@studyfetch/sdk 1.40.0 → 1.41.0

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

@@ -7,12 +7,17 @@ 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';
@@ -28,13 +33,13 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const materialResponse = await client.v1.materials.create({
+   * const material = await client.v1.materials.create({
    *   content: { type: 'text' },
    *   name: 'Chapter 1 - Introduction',
    * });
    * ```
    */
-  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<MaterialResponse> {
+  create(body: MaterialCreateParams, options?: RequestOptions): APIPromise<MaterialCreateResponse> {
     return this._client.post('/api/v1/materials', { body, ...options });
   }
 
@@ -43,27 +48,23 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const materialResponse = await client.v1.materials.retrieve(
-   *   'id',
-   * );
+   * const material = await client.v1.materials.retrieve('id');
    * ```
    */
-  retrieve(id: string, options?: RequestOptions): APIPromise<MaterialResponse> {
+  retrieve(id: string, options?: RequestOptions): APIPromise<MaterialRetrieveResponse> {
     return this._client.get(path`/api/v1/materials/${id}`, options);
   }
 
   /**
-   * Update material reference information
+   * Update a material
    *
    * @example
    * ```ts
-   * const materialResponse = await client.v1.materials.update(
-   *   'id',
-   * );
+   * const material = await client.v1.materials.update('id');
    * ```
    */
-  update(id: string, body: MaterialUpdateParams, options?: RequestOptions): APIPromise<MaterialResponse> {
-    return this._client.patch(path`/api/v1/materials/${id}`, { body, ...options });
+  update(id: string, options?: RequestOptions): APIPromise<MaterialUpdateResponse> {
+    return this._client.patch(path`/api/v1/materials/${id}`, options);
   }
 
   /**
@@ -102,17 +103,18 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const materialResponse =
-   *   await client.v1.materials.createAndProcess({
+   * const response = await client.v1.materials.createAndProcess(
+   *   {
    *     content: { type: 'text' },
    *     name: 'Chapter 1 - Introduction',
-   *   });
+   *   },
+   * );
    * ```
    */
   createAndProcess(
     body: MaterialCreateAndProcessParams,
     options?: RequestOptions,
-  ): APIPromise<MaterialResponse> {
+  ): APIPromise<MaterialCreateAndProcessResponse> {
     return this._client.post('/api/v1/materials/upload-and-process', { body, ...options });
   }
 
@@ -146,15 +148,14 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const generatedMaterialResponse =
-   *   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<GeneratedMaterialResponse> {
+  generate(body: MaterialGenerateParams, options?: RequestOptions): APIPromise<MaterialGenerateResponse> {
     return this._client.post('/api/v1/materials/generate', { body, ...options });
   }
 
@@ -164,7 +165,7 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const generatedMaterialResponse =
+   * const response =
    *   await client.v1.materials.generateAndProcess({
    *     name: 'Photosynthesis Study Plan',
    *     topic: 'Photosynthesis in plants',
@@ -175,7 +176,7 @@ export class Materials extends APIResource {
   generateAndProcess(
     body: MaterialGenerateAndProcessParams,
     options?: RequestOptions,
-  ): APIPromise<GeneratedMaterialResponse> {
+  ): APIPromise<MaterialGenerateAndProcessResponse> {
     return this._client.post('/api/v1/materials/generate-and-process', { body, ...options });
   }
 
@@ -216,13 +217,12 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const materialResponse = await client.v1.materials.move(
-   *   'id',
-   *   { folderId: 'folderId' },
-   * );
+   * const response = await client.v1.materials.move('id', {
+   *   folderId: 'folderId',
+   * });
    * ```
    */
-  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialResponse> {
+  move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialMoveResponse> {
     return this._client.post(path`/api/v1/materials/${id}/move`, { body, ...options });
   }
 
@@ -231,67 +231,824 @@ export class Materials extends APIResource {
    *
    * @example
    * ```ts
-   * const materialResponse = await client.v1.materials.rename(
-   *   'id',
-   *   { name: 'New Material Name' },
-   * );
+   * const response = await client.v1.materials.rename('id', {
+   *   name: 'New Material Name',
+   * });
+   * ```
+   */
+  rename(
+    id: string,
+    body: MaterialRenameParams,
+    options?: RequestOptions,
+  ): APIPromise<MaterialRenameResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/rename`, { body, ...options });
+  }
+
+  /**
+   * Reprocess material to regenerate embeddings and extract content
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.materials.reprocess('id');
+   * ```
+   */
+  reprocess(id: string, options?: RequestOptions): APIPromise<MaterialReprocessResponse> {
+    return this._client.post(path`/api/v1/materials/${id}/reprocess`, options);
+  }
+
+  /**
+   * Search materials using RAG (Retrieval-Augmented Generation)
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.materials.search({
+   *   query: 'What is photosynthesis?',
+   * });
    * ```
    */
-  rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<MaterialResponse> {
-    return this._client.post(path`/api/v1/materials/${id}/rename`, { body, ...options });
-  }
+  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;
+  }
+}
+
+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>;
 
   /**
-   * Reprocess material to regenerate embeddings and extract content
-   *
-   * @example
-   * ```ts
-   * const materialResponse =
-   *   await client.v1.materials.reprocess('id');
-   * ```
+   * Material ID
    */
-  reprocess(id: string, options?: RequestOptions): APIPromise<MaterialResponse> {
-    return this._client.post(path`/api/v1/materials/${id}/reprocess`, options);
-  }
+  materialId: string;
 
   /**
-   * Search materials using RAG (Retrieval-Augmented Generation)
-   *
-   * @example
-   * ```ts
-   * const response = await client.v1.materials.search({
-   *   query: 'What is photosynthesis?',
-   * });
-   * ```
+   * Material metadata
    */
-  search(body: MaterialSearchParams, options?: RequestOptions): APIPromise<MaterialSearchResponse> {
-    return this._client.post('/api/v1/materials/search', { body, ...options });
-  }
-}
+  metadata: unknown;
 
-export interface Content {
   /**
-   * Type of content
+   * Material name
    */
-  type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
+  name: string;
 
   /**
-   * URL to fetch content from
+   * Processing status
    */
-  sourceUrl?: string;
+  status: string;
 
   /**
-   * Text content (for text type)
+   * Transcript structure for videos
    */
-  text?: string;
+  transcriptStructure: unknown | null;
+}
+
+export namespace MaterialGetDebugInfoResponse {
+  export interface Image {
+    id?: string;
+
+    description?: string;
+
+    pageIndex?: number;
+
+    s3Key?: string;
+
+    s3Url?: string;
+  }
+}
 
+export interface MaterialGetDownloadURLResponse {
   /**
-   * URL to the content (for url type)
+   * Temporary download URL
    */
-  url?: string;
+  downloadUrl: string;
 }
 
-export interface GeneratedMaterialResponse {
+export interface MaterialMoveResponse {
   /**
    * Material ID
    */
@@ -300,7 +1057,7 @@ export interface GeneratedMaterialResponse {
   /**
    * Material content
    */
-  content: GeneratedMaterialResponse.Content;
+  content: MaterialMoveResponse.Content;
 
   /**
    * Content type
@@ -338,14 +1095,14 @@ export interface GeneratedMaterialResponse {
   updatedAt: string;
 
   /**
-   * Generation metadata
+   * Material metadata
    */
-  generationMetadata?: unknown;
+  metadata?: unknown;
 
   /**
-   * Material metadata
+   * References that this material cites
    */
-  metadata?: unknown;
+  references?: Array<MaterialMoveResponse.Reference>;
 
   /**
    * Usage information
@@ -353,7 +1110,7 @@ export interface GeneratedMaterialResponse {
   usage?: unknown;
 }
 
-export namespace GeneratedMaterialResponse {
+export namespace MaterialMoveResponse {
   /**
    * Material content
    */
@@ -372,9 +1129,21 @@ export namespace GeneratedMaterialResponse {
 
     url?: string;
   }
+
+  export interface Reference {
+    /**
+     * Reference title
+     */
+    title: string;
+
+    /**
+     * Reference URL
+     */
+    url?: string;
+  }
 }
 
-export interface MaterialResponse {
+export interface MaterialRenameResponse {
   /**
    * Material ID
    */
@@ -383,7 +1152,7 @@ export interface MaterialResponse {
   /**
    * Material content
    */
-  content: MaterialResponse.Content;
+  content: MaterialRenameResponse.Content;
 
   /**
    * Content type
@@ -425,13 +1194,18 @@ export interface MaterialResponse {
    */
   metadata?: unknown;
 
+  /**
+   * References that this material cites
+   */
+  references?: Array<MaterialRenameResponse.Reference>;
+
   /**
    * Usage information
    */
   usage?: unknown;
 }
 
-export namespace MaterialResponse {
+export namespace MaterialRenameResponse {
   /**
    * Material content
    */
@@ -450,70 +1224,45 @@ export namespace MaterialResponse {
 
     url?: string;
   }
-}
-
-export interface MaterialListResponse {
-  materials?: Array<MaterialResponse>;
-
-  page?: number;
-
-  totalCount?: number;
-
-  totalPages?: number;
-}
-
-export type MaterialCreateBatchUploadURLsResponse =
-  Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
-
-export namespace MaterialCreateBatchUploadURLsResponse {
-  export interface MaterialCreateBatchUploadURLsResponseItem {
-    /**
-     * Material ID
-     */
-    materialId: string;
-
-    /**
-     * Material name
-     */
-    name: string;
 
+  export interface Reference {
     /**
-     * S3 key
+     * Reference title
      */
-    s3Key: string;
+    title: string;
 
     /**
-     * Presigned upload URL
+     * Reference URL
      */
-    uploadUrl: string;
+    url?: string;
   }
 }
 
-export interface MaterialGetDebugInfoResponse {
+export interface MaterialReprocessResponse {
   /**
-   * Content details
+   * Material ID
    */
-  content: unknown;
+  _id: string;
 
   /**
-   * Content type
+   * Material content
    */
-  contentType: string;
+  content: MaterialReprocessResponse.Content;
 
   /**
-   * Processed images
+   * Content type
    */
-  images: Array<MaterialGetDebugInfoResponse.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
@@ -521,35 +1270,67 @@ export interface MaterialGetDebugInfoResponse {
   name: string;
 
   /**
-   * Processing status
+   * Organization ID
    */
-  status: string;
+  organizationId: string;
 
   /**
-   * Transcript structure for videos
+   * Material status
    */
-  transcriptStructure: unknown | null;
+  status: 'active' | 'processing' | 'pending_upload' | 'error' | 'deleted';
+
+  /**
+   * Last update timestamp
+   */
+  updatedAt: string;
+
+  /**
+   * Material metadata
+   */
+  metadata?: unknown;
+
+  /**
+   * References that this material cites
+   */
+  references?: Array<MaterialReprocessResponse.Reference>;
+
+  /**
+   * Usage information
+   */
+  usage?: unknown;
 }
 
-export namespace MaterialGetDebugInfoResponse {
-  export interface Image {
-    id?: string;
+export namespace MaterialReprocessResponse {
+  /**
+   * Material content
+   */
+  export interface Content {
+    filename?: string;
 
-    description?: string;
+    fileSize?: number;
 
-    pageIndex?: number;
+    mimeType?: string;
 
     s3Key?: string;
 
     s3Url?: string;
+
+    text?: string;
+
+    url?: string;
   }
-}
 
-export interface MaterialGetDownloadURLResponse {
-  /**
-   * Temporary download URL
-   */
-  downloadUrl: string;
+  export interface Reference {
+    /**
+     * Reference title
+     */
+    title: string;
+
+    /**
+     * Reference URL
+     */
+    url?: string;
+  }
 }
 
 export interface MaterialSearchResponse {
@@ -629,7 +1410,7 @@ export interface MaterialCreateParams {
   /**
    * Content details
    */
-  content: Content;
+  content: MaterialCreateParams.Content;
 
   /**
    * Name of the material
@@ -640,18 +1421,50 @@ export interface MaterialCreateParams {
    * Folder ID to place the material in
    */
   folderId?: string;
-}
 
-export interface MaterialUpdateParams {
   /**
-   * Reference title
+   * References that this material cites
    */
-  referenceTitle?: string;
+  references?: Array<MaterialCreateParams.Reference>;
+}
 
+export namespace MaterialCreateParams {
   /**
-   * Reference URL
+   * Content details
    */
-  referenceUrl?: string;
+  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 MaterialListParams {
@@ -680,7 +1493,7 @@ export interface MaterialCreateAndProcessParams {
   /**
    * Content details
    */
-  content: Content;
+  content: MaterialCreateAndProcessParams.Content;
 
   /**
    * Name of the material
@@ -697,12 +1510,56 @@ export interface MaterialCreateAndProcessParams {
    */
   pollIntervalMs?: number;
 
+  /**
+   * References that this material cites
+   */
+  references?: Array<MaterialCreateAndProcessParams.Reference>;
+
   /**
    * Maximum time to wait for processing in milliseconds (default: 5 minutes)
    */
   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
@@ -769,6 +1626,25 @@ export interface MaterialGenerateParams {
    * Target education level
    */
   level?: 'high_school' | 'college' | 'professional';
+
+  /**
+   * References that this material cites
+   */
+  references?: Array<MaterialGenerateParams.Reference>;
+}
+
+export namespace MaterialGenerateParams {
+  export interface Reference {
+    /**
+     * Reference title
+     */
+    title: string;
+
+    /**
+     * Reference URL
+     */
+    url?: string;
+  }
 }
 
 export interface MaterialGenerateAndProcessParams {
@@ -812,12 +1688,31 @@ export interface MaterialGenerateAndProcessParams {
    */
   pollIntervalMs?: number;
 
+  /**
+   * References that this material cites
+   */
+  references?: Array<MaterialGenerateAndProcessParams.Reference>;
+
   /**
    * Maximum time to wait for processing in milliseconds (default: 5 minutes)
    */
   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)
@@ -866,16 +1761,21 @@ Materials.Bulk = Bulk;
 
 export declare namespace Materials {
   export {
-    type Content as Content,
-    type GeneratedMaterialResponse as GeneratedMaterialResponse,
-    type MaterialResponse as MaterialResponse,
+    type MaterialCreateResponse as MaterialCreateResponse,
+    type MaterialRetrieveResponse as MaterialRetrieveResponse,
+    type MaterialUpdateResponse as MaterialUpdateResponse,
     type MaterialListResponse as MaterialListResponse,
+    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 MaterialUpdateParams as MaterialUpdateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
     type MaterialCreateBatchUploadURLsParams as MaterialCreateBatchUploadURLsParams,
@@ -889,7 +1789,12 @@ 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,