@studyfetch/sdk 1.42.0 → 1.45.0

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';

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

@@ -0,0 +1,214 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ConversationsAPI from './conversations';
+import {
+  ConversationCreateParams,
+  ConversationDeleteParams,
+  ConversationListParams,
+  ConversationPushMessagesParams,
+  ConversationRenameParams,
+  ConversationRetrieveParams,
+  Conversations,
+} from './conversations';
+import { APIPromise } from '../../../core/api-promise';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class PerformanceInsights extends APIResource {
+  conversations: ConversationsAPI.Conversations = new ConversationsAPI.Conversations(this._client);
+
+  /**
+   * Generate an embeddable URL and token for the Performance Insights dashboard.
+   * Requires a TrueLearn userContextJwt to authenticate data access.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.performanceInsights.generateEmbed({
+   *   userContextJwt: 'userContextJwt',
+   * });
+   * ```
+   */
+  generateEmbed(
+    body: PerformanceInsightsGenerateEmbedParams,
+    options?: RequestOptions,
+  ): APIPromise<PerformanceInsightsGenerateEmbedResponse> {
+    return this._client.post('/api/v1/performance-insights/embed', { body, ...options });
+  }
+
+  /**
+   * Stream an AI-powered analytics response using server-sent events (SSE).
+   *
+   * @example
+   * ```ts
+   * await client.v1.performanceInsights.stream();
+   * ```
+   */
+  stream(
+    params: PerformanceInsightsStreamParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { 'x-embed-token': xEmbedToken, 'x-user-id': xUserID, ...body } = params ?? {};
+    return this._client.post('/api/v1/performance-insights/stream', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xEmbedToken != null ? { 'x-embed-token': xEmbedToken } : undefined),
+          ...(xUserID != null ? { 'x-user-id': xUserID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface PerformanceInsightsGenerateEmbedResponse {
+  /**
+   * Full embed URL for iframe integration
+   */
+  embedUrl: string;
+
+  /**
+   * JWT embed token
+   */
+  token: string;
+
+  /**
+   * Token expiration timestamp (1 hour from creation)
+   */
+  expiresAt: string;
+}
+
+export interface PerformanceInsightsGenerateEmbedParams {
+  /**
+   * TrueLearn user context JWT for data access
+   */
+  userContextJwt: string;
+
+  /**
+   * Show Python code execution details in the embed
+   */
+  debug?: boolean;
+
+  /**
+   * Group IDs for access control
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * Embed height (e.g., "400px", "100vh")
+   */
+  height?: string;
+
+  /**
+   * Swagger/OpenAPI JSON path appended to the API base URL. Scopes which endpoints
+   * the bot can discover. Defaults to swagger/v1/swagger.json when omitted.
+   */
+  swaggerDocPath?: string;
+
+  /**
+   * IANA timezone string for data analysis (e.g., "America/New_York"). Timestamps in
+   * reports will be shown in this timezone.
+   */
+  timezone?: string;
+
+  /**
+   * TrueLearn API origin (https). Defaults to QA when omitted.
+   */
+  trueLearnApiBase?: string;
+
+  /**
+   * TrueLearn OAuth token URL (must include connect/token path). Defaults to QA login
+   * when omitted.
+   */
+  trueLearnTokenUrl?: string;
+
+  /**
+   * User ID for tracking. If omitted, derived from userContextJwt hash.
+   */
+  userId?: string;
+
+  /**
+   * Embed width (e.g., "100%", "600px")
+   */
+  width?: string;
+}
+
+export interface PerformanceInsightsStreamParams {
+  /**
+   * Body param: Session / conversation ID (AI SDK uses "id")
+   */
+  id?: string;
+
+  /**
+   * Body param: Component ID
+   */
+  componentId?: string;
+
+  /**
+   * Body param: Additional context
+   */
+  context?: unknown;
+
+  /**
+   * Body param: Group IDs for access control
+   */
+  groupIds?: Array<string>;
+
+  /**
+   * Body param: Messages array for AI SDK format
+   */
+  messages?: Array<string>;
+
+  /**
+   * Body param: Session ID
+   */
+  sessionId?: string;
+
+  /**
+   * Body param: IANA timezone string for data analysis
+   */
+  timezone?: string;
+
+  /**
+   * Body param: Trigger for AI SDK (what triggered the message)
+   */
+  trigger?: string;
+
+  /**
+   * Body param: User ID
+   */
+  userId?: string;
+
+  /**
+   * Header param: Embed token containing the TrueLearn userContextJwt
+   */
+  'x-embed-token'?: string;
+
+  /**
+   * Header param: User ID header (used when authenticating via API key)
+   */
+  'x-user-id'?: string;
+}
+
+PerformanceInsights.Conversations = Conversations;
+
+export declare namespace PerformanceInsights {
+  export {
+    type PerformanceInsightsGenerateEmbedResponse as PerformanceInsightsGenerateEmbedResponse,
+    type PerformanceInsightsGenerateEmbedParams as PerformanceInsightsGenerateEmbedParams,
+    type PerformanceInsightsStreamParams as PerformanceInsightsStreamParams,
+  };
+
+  export {
+    Conversations as Conversations,
+    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.ts

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

package/src/resources/v1/usage.ts

@@ -63,6 +63,11 @@ export class Usage extends APIResource {
 }
 
 export interface UsageGetStatsParams {
+  /**
+   * Filter by component type
+   */
+  componentType?: string;
+
   /**
    * End date for stats (ISO 8601)
    */
@@ -82,6 +87,11 @@ export interface UsageGetStatsParams {
    * Filter by user ID
    */
   userId?: string;
+
+  /**
+   * Filter by resource ID (component ID)
+   */
+  resourceId?: string;
 }
 
 export interface UsageGetSummaryParams {

package/src/resources/v1/v1.ts

@@ -2,7 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as ChatAPI from './chat';
-import { Chat, ChatStreamParams } from './chat';
+import { Chat, ChatRetrieveFeedbackParams, ChatStreamParams } from './chat';
 import * as ChatAnalyticsAPI from './chat-analytics';
 import {
   ChatAnalytics,
@@ -27,6 +27,8 @@ import * as FoldersAPI from './folders';
 import {
   FolderCreateParams,
   FolderCreateResponse,
+  FolderGetByNameParams,
+  FolderGetByNameResponse,
   FolderGetTreeResponse,
   FolderListMaterialsParams,
   FolderListMaterialsResponse,
@@ -66,6 +68,7 @@ import * as MaterialsAPI from './materials/materials';
 import {
   Content,
   GeneratedMaterialResponse,
+  MaterialCancelJobResponse,
   MaterialCreateAndProcessParams,
   MaterialCreateBatchUploadURLsParams,
   MaterialCreateBatchUploadURLsResponse,
@@ -75,6 +78,7 @@ import {
   MaterialGetDebugInfoResponse,
   MaterialGetDownloadURLParams,
   MaterialGetDownloadURLResponse,
+  MaterialGetJobStatusResponse,
   MaterialListParams,
   MaterialListResponse,
   MaterialMoveParams,
@@ -86,6 +90,21 @@ import {
   Materials,
   Reference,
 } from './materials/materials';
+import * as PdfGeneratorAPI from './pdf-generator/pdf-generator';
+import {
+  PdfGenerator,
+  PdfGeneratorCreateParams,
+  PdfGeneratorCreateResponse,
+  PdfGeneratorDeleteResponse,
+  PdfGeneratorGetAllResponse,
+} from './pdf-generator/pdf-generator';
+import * as PerformanceInsightsAPI from './performance-insights/performance-insights';
+import {
+  PerformanceInsights,
+  PerformanceInsightsGenerateEmbedParams,
+  PerformanceInsightsGenerateEmbedResponse,
+  PerformanceInsightsStreamParams,
+} from './performance-insights/performance-insights';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -102,6 +121,9 @@ export class V1 extends APIResource {
     this._client,
   );
   materials: MaterialsAPI.Materials = new MaterialsAPI.Materials(this._client);
+  pdfGenerator: PdfGeneratorAPI.PdfGenerator = new PdfGeneratorAPI.PdfGenerator(this._client);
+  performanceInsights: PerformanceInsightsAPI.PerformanceInsights =
+    new PerformanceInsightsAPI.PerformanceInsights(this._client);
 
   /**
    * Test MongoDB connection and get outbound IP
@@ -128,12 +150,15 @@ V1.Chat = Chat;
 V1.ChatAnalytics = ChatAnalytics;
 V1.AssignmentGrader = AssignmentGrader;
 V1.Materials = Materials;
+V1.PdfGenerator = PdfGenerator;
+V1.PerformanceInsights = PerformanceInsights;
 
 export declare namespace V1 {
   export {
     Folders as Folders,
     type FolderMetadata as FolderMetadata,
     type FolderCreateResponse as FolderCreateResponse,
+    type FolderGetByNameResponse as FolderGetByNameResponse,
     type FolderRetrieveResponse as FolderRetrieveResponse,
     type FolderUpdateResponse as FolderUpdateResponse,
     type FolderListResponse as FolderListResponse,
@@ -141,6 +166,7 @@ export declare namespace V1 {
     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,
@@ -179,7 +205,11 @@ export declare namespace V1 {
     type EmbedVerifyParams as EmbedVerifyParams,
   };
 
-  export { Chat as Chat, type ChatStreamParams as ChatStreamParams };
+  export {
+    Chat as Chat,
+    type ChatRetrieveFeedbackParams as ChatRetrieveFeedbackParams,
+    type ChatStreamParams as ChatStreamParams,
+  };
 
   export {
     ChatAnalytics as ChatAnalytics,
@@ -207,9 +237,11 @@ export declare namespace V1 {
     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,
@@ -223,4 +255,19 @@ export declare namespace V1 {
     type MaterialRenameParams as MaterialRenameParams,
     type MaterialSearchParams as MaterialSearchParams,
   };
+
+  export {
+    PdfGenerator as PdfGenerator,
+    type PdfGeneratorCreateResponse as PdfGeneratorCreateResponse,
+    type PdfGeneratorDeleteResponse as PdfGeneratorDeleteResponse,
+    type PdfGeneratorGetAllResponse as PdfGeneratorGetAllResponse,
+    type PdfGeneratorCreateParams as PdfGeneratorCreateParams,
+  };
+
+  export {
+    PerformanceInsights as PerformanceInsights,
+    type PerformanceInsightsGenerateEmbedResponse as PerformanceInsightsGenerateEmbedResponse,
+    type PerformanceInsightsGenerateEmbedParams as PerformanceInsightsGenerateEmbedParams,
+    type PerformanceInsightsStreamParams as PerformanceInsightsStreamParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.42.0'; // x-release-please-version
+export const VERSION = '1.45.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.42.0";
+export declare const VERSION = "1.45.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.42.0";
+export declare const VERSION = "1.45.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.42.0'; // x-release-please-version
+exports.VERSION = '1.45.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.42.0'; // x-release-please-version
+export const VERSION = '1.45.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map