@studyfetch/sdk 1.25.0 → 1.26.0

package/src/resources/v1/data-analyst/data-analyst.ts

@@ -0,0 +1,233 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as SessionsAPI from './sessions';
+import { SessionRetrieveParams, Sessions } from './sessions';
+import * as TestAPI from './test';
+import { Test } from './test';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class DataAnalyst extends APIResource {
+  sessions: SessionsAPI.Sessions = new SessionsAPI.Sessions(this._client);
+  test: TestAPI.Test = new TestAPI.Test(this._client);
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.getHistory();
+   * ```
+   */
+  getHistory(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/data-analyst/history', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.retrieveSession('sessionId', {
+   *   userId: 'userId',
+   * });
+   * ```
+   */
+  retrieveSession(
+    sessionID: string,
+    query: DataAnalystRetrieveSessionParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.get(path`/api/v1/data-analyst/session/${sessionID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.sendFollowups();
+   * ```
+   */
+  sendFollowups(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/data-analyst/followups', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.sendMessage({
+   *   componentId: 'componentId',
+   *   message: {},
+   *   'x-component-id': 'x-component-id',
+   * });
+   * ```
+   */
+  sendMessage(params: DataAnalystSendMessageParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-component-id': xComponentID, ...body } = params;
+    return this._client.post('/api/v1/data-analyst/message', {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*', 'x-component-id': xComponentID }, options?.headers]),
+    });
+  }
+
+  /**
+   * Stream chat responses
+   *
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.stream();
+   * ```
+   */
+  stream(params: DataAnalystStreamParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-component-id': xComponentID, ...body } = params;
+    return this._client.post('/api/v1/data-analyst/stream', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xComponentID != null ? { 'x-component-id': xComponentID } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface DataAnalystRetrieveSessionParams {
+  userId: string;
+}
+
+export interface DataAnalystSendMessageParams {
+  /**
+   * Body param: Component ID for context
+   */
+  componentId: string;
+
+  /**
+   * Body param: Chat message content
+   */
+  message: DataAnalystSendMessageParams.Message;
+
+  /**
+   * Header param:
+   */
+  'x-component-id': string;
+
+  /**
+   * Body param: Additional context data
+   */
+  context?: unknown;
+
+  /**
+   * Body param: Group IDs for collaboration
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * Body param: Session ID for conversation continuity
+   */
+  sessionId?: string;
+
+  /**
+   * Body param: User ID for tracking
+   */
+  userId?: string;
+}
+
+export namespace DataAnalystSendMessageParams {
+  /**
+   * Chat message content
+   */
+  export interface Message {
+    /**
+     * Images attached to the message
+     */
+    images?: Array<Message.Image>;
+
+    /**
+     * Text content of the message
+     */
+    text?: string;
+  }
+
+  export namespace Message {
+    export interface Image {
+      /**
+       * Base64 encoded image data
+       */
+      base64?: string;
+
+      /**
+       * Caption for the image
+       */
+      caption?: string;
+
+      /**
+       * MIME type of the image
+       */
+      mimeType?: string;
+
+      /**
+       * URL of the image
+       */
+      url?: string;
+    }
+  }
+}
+
+export interface DataAnalystStreamParams {
+  /**
+   * Body param:
+   */
+  context?: unknown;
+
+  /**
+   * Body param:
+   */
+  groupId?: string;
+
+  /**
+   * Body param:
+   */
+  messages?: Array<DataAnalystStreamParams.Message>;
+
+  /**
+   * Body param:
+   */
+  userId?: string;
+
+  /**
+   * Header param: Component ID for context
+   */
+  'x-component-id'?: string;
+}
+
+export namespace DataAnalystStreamParams {
+  export interface Message {
+    content?: string;
+
+    role?: 'user' | 'assistant' | 'system';
+  }
+}
+
+DataAnalyst.Sessions = Sessions;
+DataAnalyst.Test = Test;
+
+export declare namespace DataAnalyst {
+  export {
+    type DataAnalystRetrieveSessionParams as DataAnalystRetrieveSessionParams,
+    type DataAnalystSendMessageParams as DataAnalystSendMessageParams,
+    type DataAnalystStreamParams as DataAnalystStreamParams,
+  };
+
+  export { Sessions as Sessions, type SessionRetrieveParams as SessionRetrieveParams };
+
+  export { Test as Test };
+}

package/src/resources/v1/data-analyst/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  DataAnalyst,
+  type DataAnalystRetrieveSessionParams,
+  type DataAnalystSendMessageParams,
+  type DataAnalystStreamParams,
+} from './data-analyst';
+export { Sessions, type SessionRetrieveParams } from './sessions';
+export { Test } from './test';

package/src/resources/v1/data-analyst/sessions.ts

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Sessions extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.sessions.create();
+   * ```
+   */
+  create(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/data-analyst/sessions/create', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.sessions.retrieve('userId', {
+   *   limit: 'limit',
+   * });
+   * ```
+   */
+  retrieve(userID: string, query: SessionRetrieveParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/api/v1/data-analyst/sessions/${userID}`, {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface SessionRetrieveParams {
+  limit: string;
+}
+
+export declare namespace Sessions {
+  export { type SessionRetrieveParams as SessionRetrieveParams };
+}

package/src/resources/v1/data-analyst/test.ts

@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Test extends APIResource {
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.test.uploadImage();
+   * ```
+   */
+  uploadImage(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/data-analyst/test/image', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * @example
+   * ```ts
+   * await client.v1.dataAnalyst.test.uploadImageCitation();
+   * ```
+   */
+  uploadImageCitation(options?: RequestOptions): APIPromise<void> {
+    return this._client.post('/api/v1/data-analyst/test/image-citation', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}

package/src/resources/v1/data-analyst.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './data-analyst/index';

package/src/resources/v1/index.ts

@@ -13,6 +13,7 @@ export {
 } from './audio-recaps/index';
 export {
   Chat,
+  type Interaction,
   type ChatGetSessionParams,
   type ChatSendMessageParams,
   type ChatStreamParams,
@@ -27,6 +28,12 @@ export {
   type ComponentListParams,
   type ComponentGenerateEmbedParams,
 } from './components';
+export {
+  DataAnalyst,
+  type DataAnalystRetrieveSessionParams,
+  type DataAnalystSendMessageParams,
+  type DataAnalystStreamParams,
+} from './data-analyst/index';
 export { Embed, type EmbedGetThemeParams, type EmbedVerifyParams } from './embed/index';
 export { Explainers, type ExplainerCreateParams, type ExplainerHandleWebhookParams } from './explainers';
 export {
@@ -43,6 +50,7 @@ export {
 export { Folders, type FolderCreateParams, type FolderUpdateParams, type FolderListParams } from './folders';
 export {
   Materials,
+  type Content,
   type Material,
   type MaterialListResponse,
   type MaterialBatchCreateResponse,
@@ -52,6 +60,7 @@ export {
   type MaterialCreateParams,
   type MaterialListParams,
   type MaterialBatchCreateParams,
+  type MaterialCreateAndProcessParams,
   type MaterialGetDownloadURLParams,
   type MaterialMoveParams,
   type MaterialRenameParams,

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

@@ -3,6 +3,7 @@
 export { Bulk, type BulkMoveResponse, type BulkMoveParams } from './bulk';
 export {
   Materials,
+  type Content,
   type Material,
   type MaterialListResponse,
   type MaterialBatchCreateResponse,
@@ -12,6 +13,7 @@ export {
   type MaterialCreateParams,
   type MaterialListParams,
   type MaterialBatchCreateParams,
+  type MaterialCreateAndProcessParams,
   type MaterialGetDownloadURLParams,
   type MaterialMoveParams,
   type MaterialRenameParams,
@@ -26,9 +28,12 @@ export {
 } from './test';
 export {
   Upload,
+  type Complete,
   type UploadCreatePresignedURLResponse,
   type UploadCompleteUploadParams,
   type UploadCreatePresignedURLParams,
   type UploadUploadFileParams,
+  type UploadUploadFileAndProcessParams,
   type UploadUploadFromURLParams,
+  type UploadUploadURLAndProcessParams,
 } from './upload';

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

@@ -13,12 +13,15 @@ import {
 } from './test';
 import * as UploadAPI from './upload';
 import {
+  Complete,
   Upload,
   UploadCompleteUploadParams,
   UploadCreatePresignedURLParams,
   UploadCreatePresignedURLResponse,
+  UploadUploadFileAndProcessParams,
   UploadUploadFileParams,
   UploadUploadFromURLParams,
+  UploadUploadURLAndProcessParams,
 } from './upload';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
@@ -110,6 +113,24 @@ export class Materials extends APIResource {
     return this._client.post('/api/v1/materials/batch', { body, ...options });
   }
 
+  /**
+   * Creates a material and waits for processing to finish before returning. Useful
+   * for synchronous API usage.
+   *
+   * @example
+   * ```ts
+   * const material = await client.v1.materials.createAndProcess(
+   *   {
+   *     content: { type: 'text' },
+   *     name: 'Chapter 1 - Introduction',
+   *   },
+   * );
+   * ```
+   */
+  createAndProcess(body: MaterialCreateAndProcessParams, options?: RequestOptions): APIPromise<Material> {
+    return this._client.post('/api/v1/materials/upload-and-process', { body, ...options });
+  }
+
   /**
    * Get debug information for a material including extracted content
    *
@@ -195,6 +216,28 @@ export class Materials extends APIResource {
   }
 }
 
+export interface Content {
+  /**
+   * Type of content
+   */
+  type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
+
+  /**
+   * URL to fetch content from
+   */
+  sourceUrl?: string;
+
+  /**
+   * Text content (for text type)
+   */
+  text?: string;
+
+  /**
+   * URL to the content (for url type)
+   */
+  url?: string;
+}
+
 export interface Material {
   /**
    * Material ID
@@ -441,7 +484,7 @@ export interface MaterialCreateParams {
   /**
    * Content details
    */
-  content: MaterialCreateParams.Content;
+  content: Content;
 
   /**
    * Name of the material
@@ -454,33 +497,6 @@ export interface MaterialCreateParams {
   folderId?: string;
 }
 
-export namespace MaterialCreateParams {
-  /**
-   * Content details
-   */
-  export interface Content {
-    /**
-     * Type of content
-     */
-    type: 'text' | 'pdf' | 'video' | 'audio' | 'url';
-
-    /**
-     * URL to fetch content from
-     */
-    sourceUrl?: string;
-
-    /**
-     * Text content (for text type)
-     */
-    text?: string;
-
-    /**
-     * URL to the content (for url type)
-     */
-    url?: string;
-  }
-}
-
 export interface MaterialListParams {
   /**
    * Filter by folder ID
@@ -519,6 +535,33 @@ export namespace MaterialBatchCreateParams {
   }
 }
 
+export interface MaterialCreateAndProcessParams {
+  /**
+   * Content details
+   */
+  content: Content;
+
+  /**
+   * Name of the material
+   */
+  name: string;
+
+  /**
+   * Folder ID to place the material in
+   */
+  folderId?: string;
+
+  /**
+   * Polling interval in milliseconds (default: 2 seconds)
+   */
+  pollIntervalMs?: number;
+
+  /**
+   * Maximum time to wait for processing in milliseconds (default: 5 minutes)
+   */
+  timeoutMs?: number;
+}
+
 export interface MaterialGetDownloadURLParams {
   /**
    * URL expiration time in seconds (default: 3600)
@@ -568,6 +611,7 @@ Materials.Test = Test;
 
 export declare namespace Materials {
   export {
+    type Content as Content,
     type Material as Material,
     type MaterialListResponse as MaterialListResponse,
     type MaterialBatchCreateResponse as MaterialBatchCreateResponse,
@@ -577,6 +621,7 @@ export declare namespace Materials {
     type MaterialCreateParams as MaterialCreateParams,
     type MaterialListParams as MaterialListParams,
     type MaterialBatchCreateParams as MaterialBatchCreateParams,
+    type MaterialCreateAndProcessParams as MaterialCreateAndProcessParams,
     type MaterialGetDownloadURLParams as MaterialGetDownloadURLParams,
     type MaterialMoveParams as MaterialMoveParams,
     type MaterialRenameParams as MaterialRenameParams,
@@ -585,11 +630,14 @@ export declare namespace Materials {
 
   export {
     Upload as Upload,
+    type Complete as Complete,
     type UploadCreatePresignedURLResponse as UploadCreatePresignedURLResponse,
     type UploadCompleteUploadParams as UploadCompleteUploadParams,
     type UploadCreatePresignedURLParams as UploadCreatePresignedURLParams,
     type UploadUploadFileParams as UploadUploadFileParams,
+    type UploadUploadFileAndProcessParams as UploadUploadFileAndProcessParams,
     type UploadUploadFromURLParams as UploadUploadFromURLParams,
+    type UploadUploadURLAndProcessParams as UploadUploadURLAndProcessParams,
   };
 
   export { Bulk as Bulk, type BulkMoveResponse as BulkMoveResponse, type BulkMoveParams as BulkMoveParams };