@studyfetch/sdk 1.40.0 → 1.41.0

package/resources/v1/materials/materials.d.mts

@@ -2,7 +2,7 @@ import { APIResource } from "../../../core/resource.mjs";
 import * as BulkAPI from "./bulk.mjs";
 import { Bulk, BulkMoveParams, BulkMoveResponse } from "./bulk.mjs";
 import * as UploadAPI from "./upload.mjs";
-import { Upload, UploadCompleteUploadParams, UploadGetPresignedURLParams, UploadGetPresignedURLResponse, UploadUploadFileAndProcessParams, UploadUploadFileParams, UploadUploadFromURLAndProcessParams, UploadUploadFromURLParams } from "./upload.mjs";
+import { Upload, UploadCompleteUploadParams, UploadCompleteUploadResponse, UploadGetPresignedURLParams, UploadGetPresignedURLResponse, UploadUploadFileAndProcessParams, UploadUploadFileAndProcessResponse, UploadUploadFileParams, UploadUploadFileResponse, UploadUploadFromURLAndProcessParams, UploadUploadFromURLAndProcessResponse, UploadUploadFromURLParams, UploadUploadFromURLResponse } from "./upload.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Materials extends APIResource {
@@ -13,35 +13,31 @@ export declare 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>;
     /**
      * Get material by ID
      *
      * @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>;
     /**
-     * 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>;
+    update(id: string, options?: RequestOptions): APIPromise<MaterialUpdateResponse>;
     /**
      * Get all materials for organization
      *
@@ -66,14 +62,15 @@ export declare 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>;
+    createAndProcess(body: MaterialCreateAndProcessParams, options?: RequestOptions): APIPromise<MaterialCreateAndProcessResponse>;
     /**
      * Create batch upload URLs for multiple materials
      *
@@ -98,22 +95,21 @@ export declare 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>;
     /**
      * Uses AI to generate study materials like outlines, notes, summaries, etc. from a
      * given topic and waits for processing to complete
      *
      * @example
      * ```ts
-     * const generatedMaterialResponse =
+     * const response =
      *   await client.v1.materials.generateAndProcess({
      *     name: 'Photosynthesis Study Plan',
      *     topic: 'Photosynthesis in plants',
@@ -121,7 +117,7 @@ export declare class Materials extends APIResource {
      *   });
      * ```
      */
-    generateAndProcess(body: MaterialGenerateAndProcessParams, options?: RequestOptions): APIPromise<GeneratedMaterialResponse>;
+    generateAndProcess(body: MaterialGenerateAndProcessParams, options?: RequestOptions): APIPromise<MaterialGenerateAndProcessResponse>;
     /**
      * Get debug information for a material including extracted content
      *
@@ -132,83 +128,666 @@ export declare class Materials extends APIResource {
      * );
      * ```
      */
-    getDebugInfo(id: string, options?: RequestOptions): APIPromise<MaterialGetDebugInfoResponse>;
+    getDebugInfo(id: string, options?: RequestOptions): APIPromise<MaterialGetDebugInfoResponse>;
+    /**
+     * Get temporary download URL for material
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.getDownloadURL(
+     *   'id',
+     * );
+     * ```
+     */
+    getDownloadURL(id: string, query?: MaterialGetDownloadURLParams | null | undefined, options?: RequestOptions): APIPromise<MaterialGetDownloadURLResponse>;
+    /**
+     * Move material to a different folder
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.move('id', {
+     *   folderId: 'folderId',
+     * });
+     * ```
+     */
+    move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialMoveResponse>;
+    /**
+     * Rename a material
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.rename('id', {
+     *   name: 'New Material Name',
+     * });
+     * ```
+     */
+    rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<MaterialRenameResponse>;
+    /**
+     * 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>;
+    /**
+     * Search materials using RAG (Retrieval-Augmented Generation)
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.search({
+     *   query: 'What is photosynthesis?',
+     * });
+     * ```
+     */
+    search(body: MaterialSearchParams, options?: RequestOptions): APIPromise<MaterialSearchResponse>;
+}
+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 declare namespace MaterialCreateResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    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 declare namespace MaterialRetrieveResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    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 declare namespace MaterialUpdateResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
+}
+export interface MaterialListResponse {
+    materials?: Array<MaterialListResponse.Material>;
+    page?: number;
+    totalCount?: number;
+    totalPages?: number;
+}
+export declare namespace MaterialListResponse {
+    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;
+    }
+    namespace Material {
+        /**
+         * Material content
+         */
+        interface Content {
+            filename?: string;
+            fileSize?: number;
+            mimeType?: string;
+            s3Key?: string;
+            s3Url?: string;
+            text?: string;
+            url?: string;
+        }
+        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 declare namespace MaterialCreateAndProcessResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
+}
+export type MaterialCreateBatchUploadURLsResponse = Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
+export declare namespace MaterialCreateBatchUploadURLsResponse {
+    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 declare namespace MaterialGenerateResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    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 declare namespace MaterialGenerateAndProcessResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
+        s3Key?: string;
+        s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
+}
+export interface MaterialGetDebugInfoResponse {
     /**
-     * Get temporary download URL for material
-     *
-     * @example
-     * ```ts
-     * const response = await client.v1.materials.getDownloadURL(
-     *   'id',
-     * );
-     * ```
+     * Content details
      */
-    getDownloadURL(id: string, query?: MaterialGetDownloadURLParams | null | undefined, options?: RequestOptions): APIPromise<MaterialGetDownloadURLResponse>;
+    content: unknown;
     /**
-     * Move material to a different folder
-     *
-     * @example
-     * ```ts
-     * const materialResponse = await client.v1.materials.move(
-     *   'id',
-     *   { folderId: 'folderId' },
-     * );
-     * ```
+     * Content type
      */
-    move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialResponse>;
+    contentType: string;
     /**
-     * Rename a material
-     *
-     * @example
-     * ```ts
-     * const materialResponse = await client.v1.materials.rename(
-     *   'id',
-     *   { name: 'New Material Name' },
-     * );
-     * ```
+     * Processed images
      */
-    rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<MaterialResponse>;
+    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>;
+    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>;
-}
-export interface Content {
+    metadata: unknown;
     /**
-     * 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 declare namespace MaterialGetDebugInfoResponse {
+    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
      */
@@ -216,7 +795,7 @@ export interface GeneratedMaterialResponse {
     /**
      * Material content
      */
-    content: GeneratedMaterialResponse.Content;
+    content: MaterialMoveResponse.Content;
     /**
      * Content type
      */
@@ -245,20 +824,20 @@ export interface GeneratedMaterialResponse {
      * Last update timestamp
      */
     updatedAt: string;
-    /**
-     * Generation metadata
-     */
-    generationMetadata?: unknown;
     /**
      * Material metadata
      */
     metadata?: unknown;
+    /**
+     * References that this material cites
+     */
+    references?: Array<MaterialMoveResponse.Reference>;
     /**
      * Usage information
      */
     usage?: unknown;
 }
-export declare namespace GeneratedMaterialResponse {
+export declare namespace MaterialMoveResponse {
     /**
      * Material content
      */
@@ -271,8 +850,18 @@ export declare namespace GeneratedMaterialResponse {
         text?: string;
         url?: string;
     }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
 }
-export interface MaterialResponse {
+export interface MaterialRenameResponse {
     /**
      * Material ID
      */
@@ -280,7 +869,7 @@ export interface MaterialResponse {
     /**
      * Material content
      */
-    content: MaterialResponse.Content;
+    content: MaterialRenameResponse.Content;
     /**
      * Content type
      */
@@ -313,12 +902,16 @@ export interface MaterialResponse {
      * Material metadata
      */
     metadata?: unknown;
+    /**
+     * References that this material cites
+     */
+    references?: Array<MaterialRenameResponse.Reference>;
     /**
      * Usage information
      */
     usage?: unknown;
 }
-export declare namespace MaterialResponse {
+export declare namespace MaterialRenameResponse {
     /**
      * Material content
      */
@@ -331,82 +924,90 @@ export declare namespace MaterialResponse {
         text?: string;
         url?: string;
     }
-}
-export interface MaterialListResponse {
-    materials?: Array<MaterialResponse>;
-    page?: number;
-    totalCount?: number;
-    totalPages?: number;
-}
-export type MaterialCreateBatchUploadURLsResponse = Array<MaterialCreateBatchUploadURLsResponse.MaterialCreateBatchUploadURLsResponseItem>;
-export declare namespace MaterialCreateBatchUploadURLsResponse {
-    interface MaterialCreateBatchUploadURLsResponseItem {
+    interface Reference {
         /**
-         * Material ID
-         */
-        materialId: string;
-        /**
-         * Material name
-         */
-        name: string;
-        /**
-         * 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
      */
     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 declare namespace MaterialGetDebugInfoResponse {
-    interface Image {
-        id?: string;
-        description?: string;
-        pageIndex?: number;
+export declare namespace MaterialReprocessResponse {
+    /**
+     * Material content
+     */
+    interface Content {
+        filename?: string;
+        fileSize?: number;
+        mimeType?: string;
         s3Key?: string;
         s3Url?: string;
+        text?: string;
+        url?: string;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
     }
-}
-export interface MaterialGetDownloadURLResponse {
-    /**
-     * Temporary download URL
-     */
-    downloadUrl: string;
 }
 export interface MaterialSearchResponse {
     /**
@@ -471,7 +1072,7 @@ export interface MaterialCreateParams {
     /**
      * Content details
      */
-    content: Content;
+    content: MaterialCreateParams.Content;
     /**
      * Name of the material
      */
@@ -480,16 +1081,43 @@ 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 declare namespace MaterialCreateParams {
     /**
-     * Reference URL
+     * Content details
      */
-    referenceUrl?: string;
+    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;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
 }
 export interface MaterialListParams {
     /**
@@ -513,7 +1141,7 @@ export interface MaterialCreateAndProcessParams {
     /**
      * Content details
      */
-    content: Content;
+    content: MaterialCreateAndProcessParams.Content;
     /**
      * Name of the material
      */
@@ -526,11 +1154,48 @@ export interface MaterialCreateAndProcessParams {
      * Polling interval in milliseconds (default: 2 seconds)
      */
     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 declare namespace MaterialCreateAndProcessParams {
+    /**
+     * Content details
+     */
+    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;
+    }
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
+}
 export interface MaterialCreateBatchUploadURLsParams {
     /**
      * Array of materials to create
@@ -586,6 +1251,22 @@ export interface MaterialGenerateParams {
      * Target education level
      */
     level?: 'high_school' | 'college' | 'professional';
+    /**
+     * References that this material cites
+     */
+    references?: Array<MaterialGenerateParams.Reference>;
+}
+export declare namespace MaterialGenerateParams {
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
 }
 export interface MaterialGenerateAndProcessParams {
     /**
@@ -620,11 +1301,27 @@ export interface MaterialGenerateAndProcessParams {
      * Polling interval in milliseconds (default: 2 seconds)
      */
     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 declare namespace MaterialGenerateAndProcessParams {
+    interface Reference {
+        /**
+         * Reference title
+         */
+        title: string;
+        /**
+         * Reference URL
+         */
+        url?: string;
+    }
+}
 export interface MaterialGetDownloadURLParams {
     /**
      * URL expiration time in seconds (default: 3600)
@@ -662,8 +1359,8 @@ export interface MaterialSearchParams {
     topK?: number;
 }
 export declare namespace Materials {
-    export { type Content as Content, type GeneratedMaterialResponse as GeneratedMaterialResponse, type MaterialResponse as MaterialResponse, type MaterialListResponse as MaterialListResponse, type MaterialCreateBatchUploadURLsResponse as MaterialCreateBatchUploadURLsResponse, type MaterialGetDebugInfoResponse as MaterialGetDebugInfoResponse, type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse, type MaterialSearchResponse as MaterialSearchResponse, type MaterialCreateParams as MaterialCreateParams, type MaterialUpdateParams as MaterialUpdateParams, type MaterialListParams as MaterialListParams, type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams, type MaterialCreateBatchUploadURLsParams as MaterialCreateBatchUploadURLsParams, type MaterialGenerateParams as MaterialGenerateParams, type MaterialGenerateAndProcessParams as MaterialGenerateAndProcessParams, type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams, type MaterialMoveParams as MaterialMoveParams, type MaterialRenameParams as MaterialRenameParams, type MaterialSearchParams as MaterialSearchParams, };
-    export { Upload as Upload, type UploadGetPresignedURLResponse as UploadGetPresignedURLResponse, type UploadCompleteUploadParams as UploadCompleteUploadParams, type UploadGetPresignedURLParams as UploadGetPresignedURLParams, type UploadUploadFileParams as UploadUploadFileParams, type UploadUploadFileAndProcessParams as UploadUploadFileAndProcessParams, type UploadUploadFromURLParams as UploadUploadFromURLParams, type UploadUploadFromURLAndProcessParams as UploadUploadFromURLAndProcessParams, };
+    export { 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 MaterialListParams as MaterialListParams, type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams, type MaterialCreateBatchUploadURLsParams as MaterialCreateBatchUploadURLsParams, type MaterialGenerateParams as MaterialGenerateParams, type MaterialGenerateAndProcessParams as MaterialGenerateAndProcessParams, type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams, type MaterialMoveParams as MaterialMoveParams, type MaterialRenameParams as MaterialRenameParams, type MaterialSearchParams as MaterialSearchParams, };
+    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, type UploadUploadFileAndProcessParams as UploadUploadFileAndProcessParams, type UploadUploadFromURLParams as UploadUploadFromURLParams, type UploadUploadFromURLAndProcessParams as UploadUploadFromURLAndProcessParams, };
     export { Bulk as Bulk, type BulkMoveResponse as BulkMoveResponse, type BulkMoveParams as BulkMoveParams };
 }
 //# sourceMappingURL=materials.d.mts.map