@studyfetch/sdk 1.9.0 → 1.11.0

package/src/resources/v1/explainers.ts

@@ -11,7 +11,13 @@ export class Explainers extends APIResource {
    *
    * @example
    * ```ts
-   * await client.v1.explainers.create();
+   * await client.v1.explainers.create({
+   *   componentId: 'componentId',
+   *   folderIds: ['string'],
+   *   materialIds: ['string'],
+   *   targetLength: 15,
+   *   title: 'title',
+   * });
    * ```
    */
   create(body: ExplainerCreateParams, options?: RequestOptions): APIPromise<void> {
@@ -23,27 +29,154 @@ export class Explainers extends APIResource {
   }
 
   /**
-   * Handle webhook events
+   * Handle explainer video webhook events
    *
    * @example
    * ```ts
-   * await client.v1.explainers.handleWebhook({ body: 'body' });
+   * await client.v1.explainers.handleWebhook({
+   *   event: 'video.completed',
+   *   video: { id: 'id' },
+   * });
    * ```
    */
-  handleWebhook(params: ExplainerHandleWebhookParams, options?: RequestOptions): APIPromise<void> {
-    const { body } = params;
+  handleWebhook(body: ExplainerHandleWebhookParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post('/api/v1/explainers/webhook', {
-      body: body,
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 }
 
-export interface ExplainerCreateParams {}
+export interface ExplainerCreateParams {
+  /**
+   * Component ID
+   */
+  componentId: string;
+
+  /**
+   * Folder IDs to include
+   */
+  folderIds: Array<string>;
+
+  /**
+   * Material IDs to include
+   */
+  materialIds: Array<string>;
+
+  /**
+   * Target video length in seconds
+   */
+  targetLength: number;
+
+  /**
+   * Title for the explainer video
+   */
+  title: string;
+
+  /**
+   * Enable image search for visuals
+   */
+  imageSearch?: boolean;
+
+  /**
+   * AI model to use
+   */
+  model?: string;
+
+  /**
+   * Video style
+   */
+  style?: string;
+
+  /**
+   * User ID
+   */
+  userId?: string;
+
+  /**
+   * Create vertical video format (9:16)
+   */
+  verticalVideo?: boolean;
+
+  /**
+   * Enable web search for additional content
+   */
+  webSearch?: boolean;
+}
 
 export interface ExplainerHandleWebhookParams {
-  body: string;
+  /**
+   * Webhook event type
+   */
+  event: 'video.completed' | 'video.progress' | 'video.failed';
+
+  /**
+   * Video data
+   */
+  video: ExplainerHandleWebhookParams.Video;
+}
+
+export namespace ExplainerHandleWebhookParams {
+  /**
+   * Video data
+   */
+  export interface Video {
+    /**
+     * Video ID
+     */
+    id: string;
+
+    /**
+     * Image sources
+     */
+    imageSources?: unknown;
+
+    /**
+     * Progress percentage
+     */
+    progress?: number;
+
+    /**
+     * Video sections
+     */
+    sections?: Array<string>;
+
+    /**
+     * Stream ID
+     */
+    streamId?: string;
+
+    /**
+     * Stream URL
+     */
+    streamUrl?: string;
+
+    /**
+     * Thumbnail URL
+     */
+    thumbnailUrl?: string;
+
+    /**
+     * Video transcript
+     */
+    transcript?: string;
+
+    /**
+     * Video URL
+     */
+    videoUrl?: string;
+
+    /**
+     * Web search results
+     */
+    webSearchResults?: unknown;
+
+    /**
+     * Web search sources
+     */
+    webSearchSources?: unknown;
+  }
 }
 
 export declare namespace Explainers {

package/src/resources/v1/index.ts

@@ -49,7 +49,12 @@ export {
   type MaterialGetDownloadURLParams,
 } from './materials/index';
 export { Organizations } from './organizations/index';
-export { Scenarios, type ScenarioCreateParams, type ScenarioUpdateParams } from './scenarios/index';
+export {
+  Scenarios,
+  type ScenarioCreateParams,
+  type ScenarioUpdateParams,
+  type ScenarioSubmitParams,
+} from './scenarios/index';
 export {
   Tests,
   type TestCreateParams,

package/src/resources/v1/scenarios/component.ts

@@ -28,14 +28,14 @@ export class Component extends APIResource {
    * @example
    * ```ts
    * await client.v1.scenarios.component.update('componentId', {
-   *   body: 'body',
+   *   body_componentId: 'componentId',
+   *   name: 'name',
    * });
    * ```
    */
-  update(componentID: string, params: ComponentUpdateParams, options?: RequestOptions): APIPromise<void> {
-    const { body } = params;
+  update(componentID: string, body: ComponentUpdateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.put(path`/api/v1/scenarios/component/${componentID}`, {
-      body: body,
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -58,7 +58,65 @@ export class Component extends APIResource {
 }
 
 export interface ComponentUpdateParams {
-  body: string;
+  /**
+   * Associated component ID
+   */
+  body_componentId: string;
+
+  /**
+   * Scenario name
+   */
+  name: string;
+
+  /**
+   * Scenario characters
+   */
+  characters?: Array<unknown>;
+
+  /**
+   * Scenario context
+   */
+  context?: string;
+
+  /**
+   * Scenario description
+   */
+  description?: string;
+
+  /**
+   * Prompt for final answer
+   */
+  finalAnswerPrompt?: string;
+
+  /**
+   * Interaction format
+   */
+  format?: string;
+
+  /**
+   * Scenario goal
+   */
+  goal?: string;
+
+  /**
+   * Character ID for greeting
+   */
+  greetingCharacterId?: string;
+
+  /**
+   * Greeting message
+   */
+  greetingMessage?: string;
+
+  /**
+   * Whether scenario requires a final answer
+   */
+  requiresFinalAnswer?: boolean;
+
+  /**
+   * Available tools
+   */
+  tools?: Array<unknown>;
 }
 
 export declare namespace Component {

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

@@ -1,6 +1,11 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Component, type ComponentUpdateParams } from './component';
-export { Scenarios, type ScenarioCreateParams, type ScenarioUpdateParams } from './scenarios';
+export {
+  Scenarios,
+  type ScenarioCreateParams,
+  type ScenarioUpdateParams,
+  type ScenarioSubmitParams,
+} from './scenarios';
 export { Sessions } from './sessions';
 export { Submissions } from './submissions/index';

package/src/resources/v1/scenarios/scenarios.ts

@@ -22,13 +22,15 @@ export class Scenarios extends APIResource {
    *
    * @example
    * ```ts
-   * await client.v1.scenarios.create({ body: 'body' });
+   * await client.v1.scenarios.create({
+   *   componentId: 'componentId',
+   *   name: 'name',
+   * });
    * ```
    */
-  create(params: ScenarioCreateParams, options?: RequestOptions): APIPromise<void> {
-    const { body } = params;
+  create(body: ScenarioCreateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post('/api/v1/scenarios', {
-      body: body,
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -54,13 +56,15 @@ export class Scenarios extends APIResource {
    *
    * @example
    * ```ts
-   * await client.v1.scenarios.update('id', { body: 'body' });
+   * await client.v1.scenarios.update('id', {
+   *   componentId: 'componentId',
+   *   name: 'name',
+   * });
    * ```
    */
-  update(id: string, params: ScenarioUpdateParams, options?: RequestOptions): APIPromise<void> {
-    const { body } = params;
+  update(id: string, body: ScenarioUpdateParams, options?: RequestOptions): APIPromise<void> {
     return this._client.put(path`/api/v1/scenarios/${id}`, {
-      body: body,
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -110,13 +114,18 @@ export class Scenarios extends APIResource {
   }
 
   /**
+   * Submit scenario answer
+   *
    * @example
    * ```ts
-   * await client.v1.scenarios.submit('id');
+   * await client.v1.scenarios.submit('id', {
+   *   conversationHistory: [{}],
+   * });
    * ```
    */
-  submit(id: string, options?: RequestOptions): APIPromise<void> {
+  submit(id: string, body: ScenarioSubmitParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post(path`/api/v1/scenarios/${id}/submit`, {
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -124,11 +133,139 @@ export class Scenarios extends APIResource {
 }
 
 export interface ScenarioCreateParams {
-  body: string;
+  /**
+   * Associated component ID
+   */
+  componentId: string;
+
+  /**
+   * Scenario name
+   */
+  name: string;
+
+  /**
+   * Scenario characters
+   */
+  characters?: Array<unknown>;
+
+  /**
+   * Scenario context
+   */
+  context?: string;
+
+  /**
+   * Scenario description
+   */
+  description?: string;
+
+  /**
+   * Prompt for final answer
+   */
+  finalAnswerPrompt?: string;
+
+  /**
+   * Interaction format
+   */
+  format?: string;
+
+  /**
+   * Scenario goal
+   */
+  goal?: string;
+
+  /**
+   * Character ID for greeting
+   */
+  greetingCharacterId?: string;
+
+  /**
+   * Greeting message
+   */
+  greetingMessage?: string;
+
+  /**
+   * Whether scenario requires a final answer
+   */
+  requiresFinalAnswer?: boolean;
+
+  /**
+   * Available tools
+   */
+  tools?: Array<unknown>;
 }
 
 export interface ScenarioUpdateParams {
-  body: string;
+  /**
+   * Associated component ID
+   */
+  componentId: string;
+
+  /**
+   * Scenario name
+   */
+  name: string;
+
+  /**
+   * Scenario characters
+   */
+  characters?: Array<unknown>;
+
+  /**
+   * Scenario context
+   */
+  context?: string;
+
+  /**
+   * Scenario description
+   */
+  description?: string;
+
+  /**
+   * Prompt for final answer
+   */
+  finalAnswerPrompt?: string;
+
+  /**
+   * Interaction format
+   */
+  format?: string;
+
+  /**
+   * Scenario goal
+   */
+  goal?: string;
+
+  /**
+   * Character ID for greeting
+   */
+  greetingCharacterId?: string;
+
+  /**
+   * Greeting message
+   */
+  greetingMessage?: string;
+
+  /**
+   * Whether scenario requires a final answer
+   */
+  requiresFinalAnswer?: boolean;
+
+  /**
+   * Available tools
+   */
+  tools?: Array<unknown>;
+}
+
+export interface ScenarioSubmitParams {
+  /**
+   * Conversation history
+   */
+  conversationHistory: Array<unknown>;
+
+  /**
+   * Final answer for the scenario
+   */
+  finalAnswer?: string;
 }
 
 Scenarios.Component = Component;
@@ -139,6 +276,7 @@ export declare namespace Scenarios {
   export {
     type ScenarioCreateParams as ScenarioCreateParams,
     type ScenarioUpdateParams as ScenarioUpdateParams,
+    type ScenarioSubmitParams as ScenarioSubmitParams,
   };
 
   export { Component as Component, type ComponentUpdateParams as ComponentUpdateParams };

package/src/resources/v1/v1.ts

@@ -59,7 +59,12 @@ import {
 import * as OrganizationsAPI from './organizations/organizations';
 import { Organizations } from './organizations/organizations';
 import * as ScenariosAPI from './scenarios/scenarios';
-import { ScenarioCreateParams, ScenarioUpdateParams, Scenarios } from './scenarios/scenarios';
+import {
+  ScenarioCreateParams,
+  ScenarioSubmitParams,
+  ScenarioUpdateParams,
+  Scenarios,
+} from './scenarios/scenarios';
 import * as TestsAPI from './tests/tests';
 import {
   TestCreateParams,
@@ -190,6 +195,7 @@ export declare namespace V1 {
     Scenarios as Scenarios,
     type ScenarioCreateParams as ScenarioCreateParams,
     type ScenarioUpdateParams as ScenarioUpdateParams,
+    type ScenarioSubmitParams as ScenarioSubmitParams,
   };
 
   export {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.9.0'; // x-release-please-version
+export const VERSION = '1.11.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.d.ts

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

package/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/version.js

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

package/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}

package/version.mjs

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

package/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,2BAA2B"}