@studyfetch/sdk 1.43.0 → 1.46.0

package/src/resources/v1/embed/embed.ts

@@ -3,12 +3,15 @@
 import { APIResource } from '../../../core/resource';
 import * as ComponentAPI from './component';
 import { Component, ComponentInteractParams, ComponentRetrieveParams } from './component';
+import * as ContextAPI from './context';
+import { Context, ContextClearParams, ContextPushParams, ContextRetrieveParams } from './context';
 import { APIPromise } from '../../../core/api-promise';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 
 export class Embed extends APIResource {
   component: ComponentAPI.Component = new ComponentAPI.Component(this._client);
+  context: ContextAPI.Context = new ContextAPI.Context(this._client);
 
   /**
    * Get theme CSS for embed
@@ -73,6 +76,7 @@ export interface EmbedVerifyParams {
 }
 
 Embed.Component = Component;
+Embed.Context = Context;
 
 export declare namespace Embed {
   export { type EmbedGetThemeParams as EmbedGetThemeParams, type EmbedVerifyParams as EmbedVerifyParams };
@@ -82,4 +86,11 @@ export declare namespace Embed {
     type ComponentRetrieveParams as ComponentRetrieveParams,
     type ComponentInteractParams as ComponentInteractParams,
   };
+
+  export {
+    Context as Context,
+    type ContextRetrieveParams as ContextRetrieveParams,
+    type ContextClearParams as ContextClearParams,
+    type ContextPushParams as ContextPushParams,
+  };
 }

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

@@ -1,4 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Component, type ComponentRetrieveParams, type ComponentInteractParams } from './component';
+export {
+  Context,
+  type ContextRetrieveParams,
+  type ContextClearParams,
+  type ContextPushParams,
+} from './context';
 export { Embed, type EmbedGetThemeParams, type EmbedVerifyParams } from './embed';

package/src/resources/v1/folders.ts

@@ -23,6 +23,22 @@ export class Folders extends APIResource {
     return this._client.post('/api/v1/folders', { body, ...options });
   }
 
+  /**
+   * Get folder ID by folder name
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.folders.getByName('name');
+   * ```
+   */
+  getByName(
+    name: string,
+    query: FolderGetByNameParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FolderGetByNameResponse> {
+    return this._client.get(path`/api/v1/folders/by-name/${name}`, { query, ...options });
+  }
+
   /**
    * Get folder by ID
    *
@@ -196,6 +212,16 @@ export interface FolderCreateResponse {
   parentFolderId?: string | null;
 }
 
+/**
+ * Response for getting folder ID by name
+ */
+export interface FolderGetByNameResponse {
+  /**
+   * Folder ID
+   */
+  folderId: string;
+}
+
 export interface FolderRetrieveResponse {
   /**
    * Folder ID
@@ -486,6 +512,13 @@ export interface FolderCreateParams {
   parentFolderId?: string;
 }
 
+export interface FolderGetByNameParams {
+  /**
+   * Parent folder ID for accurate matching (optional)
+   */
+  parentFolderId?: string;
+}
+
 export interface FolderUpdateParams {
   /**
    * New folder description
@@ -543,6 +576,7 @@ export declare namespace Folders {
   export {
     type FolderMetadata as FolderMetadata,
     type FolderCreateResponse as FolderCreateResponse,
+    type FolderGetByNameResponse as FolderGetByNameResponse,
     type FolderRetrieveResponse as FolderRetrieveResponse,
     type FolderUpdateResponse as FolderUpdateResponse,
     type FolderListResponse as FolderListResponse,
@@ -550,6 +584,7 @@ export declare namespace Folders {
     type FolderListMaterialsResponse as FolderListMaterialsResponse,
     type FolderMoveResponse as FolderMoveResponse,
     type FolderCreateParams as FolderCreateParams,
+    type FolderGetByNameParams as FolderGetByNameParams,
     type FolderUpdateParams as FolderUpdateParams,
     type FolderListParams as FolderListParams,
     type FolderListMaterialsParams as FolderListMaterialsParams,

package/src/resources/v1/index.ts

@@ -9,7 +9,7 @@ export {
   type AssignmentGraderGetAllResponse,
   type AssignmentGraderCreateParams,
 } from './assignment-grader/index';
-export { Chat, type ChatStreamParams } from './chat';
+export { Chat, type ChatRetrieveFeedbackParams, type ChatStreamParams } from './chat';
 export {
   ChatAnalytics,
   type ChatAnalyticsResponse,
@@ -33,6 +33,7 @@ export {
   Folders,
   type FolderMetadata,
   type FolderCreateResponse,
+  type FolderGetByNameResponse,
   type FolderRetrieveResponse,
   type FolderUpdateResponse,
   type FolderListResponse,
@@ -40,6 +41,7 @@ export {
   type FolderListMaterialsResponse,
   type FolderMoveResponse,
   type FolderCreateParams,
+  type FolderGetByNameParams,
   type FolderUpdateParams,
   type FolderListParams,
   type FolderListMaterialsParams,
@@ -77,6 +79,12 @@ export {
   type PdfGeneratorGetAllResponse,
   type PdfGeneratorCreateParams,
 } from './pdf-generator/index';
+export {
+  PerformanceInsights,
+  type PerformanceInsightsGenerateEmbedResponse,
+  type PerformanceInsightsGenerateEmbedParams,
+  type PerformanceInsightsStreamParams,
+} from './performance-insights/index';
 export {
   Usage,
   type UsageGetStatsParams,

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

@@ -3,7 +3,7 @@
 import { APIResource } from '../../../core/resource';
 import * as MaterialsAPI from './materials';
 import { APIPromise } from '../../../core/api-promise';
-import { type Uploadable } from '../../../core/uploads';
+import { toFile, type Uploadable } from '../../../core/uploads';
 import { RequestOptions } from '../../../internal/request-options';
 import { multipartFormRequestOptions } from '../../../internal/uploads';
 
@@ -65,7 +65,7 @@ export class Upload extends APIResource {
   ): APIPromise<MaterialsAPI.MaterialResponse> {
     return this._client.post(
       '/api/v1/materials/upload',
-      multipartFormRequestOptions({ body, ...options }, this._client),
+      multipartUploadRequestOptions(body, options, this._client),
     );
   }
 
@@ -88,7 +88,7 @@ export class Upload extends APIResource {
   ): APIPromise<MaterialsAPI.MaterialResponse> {
     return this._client.post(
       '/api/v1/materials/upload/file-and-process',
-      multipartFormRequestOptions({ body, ...options }, this._client),
+      multipartUploadRequestOptions(body, options, this._client),
     );
   }
 
@@ -201,16 +201,29 @@ export interface UploadUploadFileParams {
    */
   name: string;
 
+  /**
+   * Content-Type/MIME type of the file (e.g., video/mp4, application/pdf).
+   * If not provided, the uploadable's existing type is used.
+   */
+  contentType?: string;
+
   /**
    * Whether to extract images from files (true/false, default: true)
    */
   extractImages?: string;
 
   /**
-   * Folder ID (optional)
+   * Folder ID (optional). If folderPath is provided, folderId will be ignored.
    */
   folderId?: string;
 
+  /**
+   * Relative folder path (e.g., "folder1/folder2"). Folders will be created if
+   * they don't exist. The filename can be included and will be extracted
+   * automatically.
+   */
+  folderPath?: string;
+
   /**
    * JSON string of references array (optional)
    */
@@ -225,16 +238,29 @@ export interface UploadUploadFileAndProcessParams {
    */
   name: string;
 
+  /**
+   * Content-Type/MIME type of the file (e.g., video/mp4, application/pdf).
+   * If not provided, the uploadable's existing type is used.
+   */
+  contentType?: string;
+
   /**
    * Whether to extract images from files (true/false, default: true)
    */
   extractImages?: string;
 
   /**
-   * Folder ID (optional)
+   * Folder ID (optional). If folderPath is provided, folderId will be ignored.
    */
   folderId?: string;
 
+  /**
+   * Relative folder path (e.g., "folder1/folder2"). Folders will be created if
+   * they don't exist. The filename can be included and will be extracted
+   * automatically.
+   */
+  folderPath?: string;
+
   /**
    * Polling interval in milliseconds (default: 2000)
    */
@@ -258,9 +284,16 @@ export interface UploadUploadFromURLParams {
   url: string;
 
   /**
-   * Folder ID (optional)
+   * Folder ID (optional). If folderPath is provided, folderId will be ignored.
    */
   folderId?: string;
+
+  /**
+   * Relative folder path (e.g., "folder1/folder2"). Folders will be created if
+   * they don't exist. The filename can be included and will be extracted
+   * automatically.
+   */
+  folderPath?: string;
 }
 
 export interface UploadUploadFromURLAndProcessParams {
@@ -275,10 +308,17 @@ export interface UploadUploadFromURLAndProcessParams {
   url: string;
 
   /**
-   * Folder ID (optional)
+   * Folder ID (optional). If folderPath is provided, folderId will be ignored.
    */
   folderId?: string;
 
+  /**
+   * Relative folder path (e.g., "folder1/folder2"). Folders will be created if
+   * they don't exist. The filename can be included and will be extracted
+   * automatically.
+   */
+  folderPath?: string;
+
   /**
    * Polling interval in milliseconds (default: 2 seconds)
    */
@@ -306,3 +346,30 @@ export declare namespace Upload {
     type UploadUploadFromURLAndProcessParams as UploadUploadFromURLAndProcessParams,
   };
 }
+
+type MultipartClient = Parameters<typeof multipartFormRequestOptions>[1];
+type MultipartUploadBody = UploadUploadFileParams | UploadUploadFileAndProcessParams;
+
+async function multipartUploadRequestOptions(
+  body: MultipartUploadBody,
+  options: RequestOptions | undefined,
+  client: MultipartClient,
+): Promise<RequestOptions> {
+  const { contentType, ...bodyWithoutContentType } = body;
+  const multipartBody =
+    contentType ?
+      { ...bodyWithoutContentType, file: await toUploadableWithContentType(body.file, contentType) }
+    : bodyWithoutContentType;
+
+  return multipartFormRequestOptions({ body: multipartBody, ...options }, client);
+}
+
+async function toUploadableWithContentType(file: Uploadable, contentType: string): Promise<Uploadable> {
+  const typedFile = await toFile(file, undefined, { type: contentType });
+  if (typedFile.type === contentType) return typedFile;
+
+  return new File([typedFile], typedFile.name, {
+    type: contentType,
+    lastModified: typedFile.lastModified,
+  });
+}

package/src/resources/v1/pdf-generator/get.ts

@@ -50,6 +50,11 @@ export interface PdfResponse {
    */
   url: string;
 
+  /**
+   * URL to the generated PowerPoint (PPTX) on S3
+   */
+  pptxUrl?: string;
+
   /**
    * User ID
    */

package/src/resources/v1/pdf-generator/pdf-generator.ts

@@ -96,6 +96,41 @@ export interface PdfGeneratorCreateParams {
    * The topic for the PDF presentation
    */
   topic: string;
+
+  /**
+   * Custom images to use (required when imageMode is "provide-own")
+   */
+  customImages?: Array<PdfGeneratorCreateParams.CustomImage>;
+
+  /**
+   * Image handling mode: search (auto-search), provide-own (use custom images), none
+   * (no images, use icons)
+   */
+  imageMode?: 'search' | 'provide-own' | 'none';
+
+  /**
+   * Custom logo URL to use (optional, falls back to default StudyFetch logo)
+   */
+  logoUrl?: string;
+}
+
+export namespace PdfGeneratorCreateParams {
+  export interface CustomImage {
+    /**
+     * Description of what this image shows
+     */
+    description: string;
+
+    /**
+     * Base64-encoded image data (provide either url or base64)
+     */
+    base64?: string;
+
+    /**
+     * Image URL to download and use (provide either url or base64)
+     */
+    url?: string;
+  }
 }
 
 PdfGenerator.Get = Get;

package/src/resources/v1/performance-insights/conversations.ts

@@ -0,0 +1,238 @@
+// 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 Conversations extends APIResource {
+  /**
+   * List Performance Insights conversations for the current user.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.list();
+   * ```
+   */
+  list(params: ConversationListParams | null | undefined = {}, options?: RequestOptions): APIPromise<void> {
+    const { 'x-user-id': xUserID, 'x-group-ids': xGroupIDs, ...query } = params ?? {};
+    return this._client.get('/api/v1/performance-insights/sessions', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xUserID != null ? { 'x-user-id': xUserID } : undefined),
+          ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Create a new Performance Insights conversation.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.create();
+   * ```
+   */
+  create(
+    params: ConversationCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-group-ids': xGroupIDs, ...body } = params ?? {};
+    return this._client.post('/api/v1/performance-insights/sessions/create', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Retrieve a single conversation with its full message history.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.retrieve('sessionId');
+   * ```
+   */
+  retrieve(
+    sessionID: string,
+    params: ConversationRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-group-ids': xGroupIDs } = params ?? {};
+    return this._client.get(path`/api/v1/performance-insights/session/${sessionID}`, {
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Push messages to a conversation. Creates the conversation if it does not exist.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.pushMessages('sessionId', {
+   *   messages: [],
+   * });
+   * ```
+   */
+  pushMessages(
+    sessionID: string,
+    params: ConversationPushMessagesParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-group-ids': xGroupIDs, ...body } = params;
+    return this._client.put(path`/api/v1/performance-insights/session/${sessionID}/messages`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Rename a conversation.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.rename('sessionId', {
+   *   title: 'New title',
+   * });
+   * ```
+   */
+  rename(sessionID: string, params: ConversationRenameParams, options?: RequestOptions): APIPromise<void> {
+    const { 'x-group-ids': xGroupIDs, ...body } = params;
+    return this._client.patch(path`/api/v1/performance-insights/session/${sessionID}/title`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Delete a conversation.
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.conversations.delete('sessionId');
+   * ```
+   */
+  delete(
+    sessionID: string,
+    params: ConversationDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-group-ids': xGroupIDs } = params ?? {};
+    return this._client.delete(path`/api/v1/performance-insights/session/${sessionID}`, {
+      ...options,
+      headers: buildHeaders([
+        { Accept: '*/*', ...(xGroupIDs != null ? { 'x-group-ids': xGroupIDs } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface ConversationListParams {
+  /**
+   * Query param: Maximum number of conversations to return (default 50)
+   */
+  limit?: string;
+
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+
+  /**
+   * Header param: User ID header (used when authenticating via API key)
+   */
+  'x-user-id'?: string;
+}
+
+export interface ConversationCreateParams {
+  /**
+   * Body param: Custom session ID. Auto-generated if omitted.
+   */
+  sessionId?: string;
+
+  /**
+   * Body param: Conversation title (default "New Chat")
+   */
+  title?: string;
+
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+}
+
+export interface ConversationRetrieveParams {
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+}
+
+export interface ConversationPushMessagesParams {
+  /**
+   * Body param: Array of AI SDK UIMessage objects to persist
+   */
+  messages: unknown;
+
+  /**
+   * Body param: Update the conversation title
+   */
+  title?: string;
+
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+}
+
+export interface ConversationRenameParams {
+  /**
+   * Body param: New conversation title
+   */
+  title: string;
+
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+}
+
+export interface ConversationDeleteParams {
+  /**
+   * Header param: Group IDs header (comma-separated) to scope sessions by group
+   */
+  'x-group-ids'?: string;
+}
+
+export declare namespace Conversations {
+  export {
+    type ConversationListParams as ConversationListParams,
+    type ConversationCreateParams as ConversationCreateParams,
+    type ConversationRetrieveParams as ConversationRetrieveParams,
+    type ConversationPushMessagesParams as ConversationPushMessagesParams,
+    type ConversationRenameParams as ConversationRenameParams,
+    type ConversationDeleteParams as ConversationDeleteParams,
+  };
+}

package/src/resources/v1/performance-insights/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Conversations,
+  type ConversationListParams,
+  type ConversationCreateParams,
+  type ConversationRetrieveParams,
+  type ConversationPushMessagesParams,
+  type ConversationRenameParams,
+  type ConversationDeleteParams,
+} from './conversations';
+export {
+  PerformanceInsights,
+  type PerformanceInsightsGenerateEmbedResponse,
+  type PerformanceInsightsGenerateEmbedParams,
+  type PerformanceInsightsStreamParams,
+} from './performance-insights';