@studyfetch/sdk 1.41.0 → 1.43.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, UploadCompleteUploadResponse, UploadGetPresignedURLParams, UploadGetPresignedURLResponse, UploadUploadFileAndProcessParams, UploadUploadFileAndProcessResponse, UploadUploadFileParams, UploadUploadFileResponse, UploadUploadFromURLAndProcessParams, UploadUploadFromURLAndProcessResponse, UploadUploadFromURLParams, UploadUploadFromURLResponse } from "./upload.mjs";
+import { Upload, UploadCompleteUploadParams, UploadGetPresignedURLParams, UploadGetPresignedURLResponse, UploadUploadFileAndProcessParams, UploadUploadFileParams, UploadUploadFromURLAndProcessParams, UploadUploadFromURLParams } from "./upload.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
 export declare class Materials extends APIResource {
@@ -13,31 +13,35 @@ export declare 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>;
     /**
      * Get material by ID
      *
      * @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>;
     /**
      * Update a material
      *
      * @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>;
+    update(id: string, body: MaterialUpdateParams, options?: RequestOptions): APIPromise<MaterialResponse>;
     /**
      * Get all materials for organization
      *
@@ -56,21 +60,29 @@ export declare class Materials extends APIResource {
      * ```
      */
     delete(id: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * 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>;
     /**
      * 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>;
+    createAndProcess(body: MaterialCreateAndProcessParams, options?: RequestOptions): APIPromise<MaterialResponse>;
     /**
      * Create batch upload URLs for multiple materials
      *
@@ -95,21 +107,22 @@ export declare 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>;
     /**
      * Uses AI to generate study materials like outlines, notes, summaries, etc. from a
      * given topic and waits for processing to complete
      *
      * @example
      * ```ts
-     * const response =
+     * const generatedMaterialResponse =
      *   await client.v1.materials.generateAndProcess({
      *     name: 'Photosynthesis Study Plan',
      *     topic: 'Photosynthesis in plants',
@@ -117,7 +130,7 @@ export declare class Materials extends APIResource {
      *   });
      * ```
      */
-    generateAndProcess(body: MaterialGenerateAndProcessParams, options?: RequestOptions): APIPromise<MaterialGenerateAndProcessResponse>;
+    generateAndProcess(body: MaterialGenerateAndProcessParams, options?: RequestOptions): APIPromise<GeneratedMaterialResponse>;
     /**
      * Get debug information for a material including extracted content
      *
@@ -131,663 +144,92 @@ export declare class Materials extends APIResource {
     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 {
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.getDownloadURL(
+     *   'id',
+     * );
+     * ```
+     */
+    getDownloadURL(id: string, query?: MaterialGetDownloadURLParams | null | undefined, options?: RequestOptions): APIPromise<MaterialGetDownloadURLResponse>;
     /**
-     * Content details
+     * Returns the current status of a PDF processing job including progress
+     * information
+     *
+     * @example
+     * ```ts
+     * const response = await client.v1.materials.getJobStatus(
+     *   'id',
+     * );
+     * ```
      */
-    content: unknown;
+    getJobStatus(id: string, options?: RequestOptions): APIPromise<MaterialGetJobStatusResponse>;
     /**
-     * Content type
+     * Move material to a different folder
+     *
+     * @example
+     * ```ts
+     * const materialResponse = await client.v1.materials.move(
+     *   'id',
+     *   { folderId: 'folderId' },
+     * );
+     * ```
      */
-    contentType: string;
+    move(id: string, body: MaterialMoveParams, options?: RequestOptions): APIPromise<MaterialResponse>;
     /**
-     * Processed images
+     * Rename a material
+     *
+     * @example
+     * ```ts
+     * const materialResponse = await client.v1.materials.rename(
+     *   'id',
+     *   { name: 'New Material Name' },
+     * );
+     * ```
      */
-    images: Array<MaterialGetDebugInfoResponse.Image>;
+    rename(id: string, body: MaterialRenameParams, options?: RequestOptions): APIPromise<MaterialResponse>;
     /**
-     * Material ID
+     * Reprocess material to regenerate embeddings and extract content
+     *
+     * @example
+     * ```ts
+     * const materialResponse =
+     *   await client.v1.materials.reprocess('id');
+     * ```
      */
-    materialId: string;
+    reprocess(id: string, options?: RequestOptions): APIPromise<MaterialResponse>;
     /**
-     * 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>;
+}
+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 declare namespace MaterialGetDebugInfoResponse {
-    interface Image {
-        id?: string;
-        description?: string;
-        pageIndex?: number;
-        s3Key?: string;
-        s3Url?: string;
-    }
-}
-export interface MaterialGetDownloadURLResponse {
+    text?: string;
     /**
-     * Temporary download URL
+     * URL to the content (for url type)
      */
-    downloadUrl: string;
+    url?: string;
 }
-export interface MaterialMoveResponse {
+export interface GeneratedMaterialResponse {
     /**
      * Material ID
      */
@@ -795,7 +237,7 @@ export interface MaterialMoveResponse {
     /**
      * Material content
      */
-    content: MaterialMoveResponse.Content;
+    content: GeneratedMaterialResponse.Content;
     /**
      * Content type
      */
@@ -824,6 +266,10 @@ export interface MaterialMoveResponse {
      * Last update timestamp
      */
     updatedAt: string;
+    /**
+     * Generation metadata
+     */
+    generationMetadata?: unknown;
     /**
      * Material metadata
      */
@@ -831,13 +277,13 @@ export interface MaterialMoveResponse {
     /**
      * References that this material cites
      */
-    references?: Array<MaterialMoveResponse.Reference>;
+    references?: Array<Reference>;
     /**
      * Usage information
      */
     usage?: unknown;
 }
-export declare namespace MaterialMoveResponse {
+export declare namespace GeneratedMaterialResponse {
     /**
      * Material content
      */
@@ -850,18 +296,8 @@ export declare namespace MaterialMoveResponse {
         text?: string;
         url?: string;
     }
-    interface Reference {
-        /**
-         * Reference title
-         */
-        title: string;
-        /**
-         * Reference URL
-         */
-        url?: string;
-    }
 }
-export interface MaterialRenameResponse {
+export interface MaterialResponse {
     /**
      * Material ID
      */
@@ -869,7 +305,7 @@ export interface MaterialRenameResponse {
     /**
      * Material content
      */
-    content: MaterialRenameResponse.Content;
+    content: MaterialResponse.Content;
     /**
      * Content type
      */
@@ -905,13 +341,13 @@ export interface MaterialRenameResponse {
     /**
      * References that this material cites
      */
-    references?: Array<MaterialRenameResponse.Reference>;
+    references?: Array<Reference>;
     /**
      * Usage information
      */
     usage?: unknown;
 }
-export declare namespace MaterialRenameResponse {
+export declare namespace MaterialResponse {
     /**
      * Material content
      */
@@ -924,89 +360,161 @@ export declare namespace MaterialRenameResponse {
         text?: string;
         url?: string;
     }
-    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 declare namespace MaterialCreateBatchUploadURLsResponse {
+    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
      */
     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 declare namespace MaterialGetDebugInfoResponse {
+    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;
-}
-export declare namespace MaterialReprocessResponse {
+    jobId?: string;
+    progress?: MaterialGetJobStatusResponse.Progress;
+    resultSummary?: MaterialGetJobStatusResponse.ResultSummary;
     /**
-     * Material content
+     * Job start time
      */
-    interface Content {
-        filename?: string;
-        fileSize?: number;
-        mimeType?: string;
-        s3Key?: string;
-        s3Url?: string;
-        text?: string;
-        url?: string;
+    startedAt?: string;
+    /**
+     * Current job status
+     */
+    status?: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+}
+export declare namespace MaterialGetJobStatusResponse {
+    interface Progress {
+        /**
+         * Current batch being processed
+         */
+        currentBatch?: number;
+        /**
+         * Completion percentage (0-100)
+         */
+        percentage?: number;
+        /**
+         * Images processed so far
+         */
+        processedImages?: number;
+        /**
+         * Total number of batches
+         */
+        totalBatches?: number;
+        /**
+         * Total images to process
+         */
+        totalImages?: number;
     }
-    interface Reference {
+    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;
     }
 }
 export interface MaterialSearchResponse {
@@ -1072,7 +580,7 @@ export interface MaterialCreateParams {
     /**
      * Content details
      */
-    content: MaterialCreateParams.Content;
+    content: Content;
     /**
      * Name of the material
      */
@@ -1084,37 +592,22 @@ export interface MaterialCreateParams {
     /**
      * References that this material cites
      */
-    references?: Array<MaterialCreateParams.Reference>;
+    references?: Array<Reference>;
 }
-export declare namespace MaterialCreateParams {
+export interface MaterialUpdateParams {
     /**
-     * Content details
+     * Array of references to update (optional)
      */
-    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 declare namespace MaterialUpdateParams {
     interface Reference {
         /**
          * Reference title
          */
         title: string;
         /**
-         * Reference URL
+         * Reference URL (optional)
          */
         url?: string;
     }
@@ -1141,7 +634,7 @@ export interface MaterialCreateAndProcessParams {
     /**
      * Content details
      */
-    content: MaterialCreateAndProcessParams.Content;
+    content: Content;
     /**
      * Name of the material
      */
@@ -1157,45 +650,12 @@ 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)
      */
     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
@@ -1254,19 +714,7 @@ export interface MaterialGenerateParams {
     /**
      * References that this material cites
      */
-    references?: Array<MaterialGenerateParams.Reference>;
-}
-export declare namespace MaterialGenerateParams {
-    interface Reference {
-        /**
-         * Reference title
-         */
-        title: string;
-        /**
-         * Reference URL
-         */
-        url?: string;
-    }
+    references?: Array<Reference>;
 }
 export interface MaterialGenerateAndProcessParams {
     /**
@@ -1304,24 +752,12 @@ 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)
      */
     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)
@@ -1359,8 +795,8 @@ export interface MaterialSearchParams {
     topK?: number;
 }
 export declare namespace Materials {
-    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 { type Content as Content, type GeneratedMaterialResponse as GeneratedMaterialResponse, type MaterialResponse as MaterialResponse, type Reference as Reference, type MaterialListResponse as MaterialListResponse, type MaterialCancelJobResponse as MaterialCancelJobResponse, type MaterialCreateBatchUploadURLsResponse as MaterialCreateBatchUploadURLsResponse, type MaterialGetDebugInfoResponse as MaterialGetDebugInfoResponse, type MaterialGetDownloadURLResponse as MaterialGetDownloadURLResponse, 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, 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 { Bulk as Bulk, type BulkMoveResponse as BulkMoveResponse, type BulkMoveParams as BulkMoveParams };
 }
 //# sourceMappingURL=materials.d.mts.map