@vertesia/client 1.1.1-dev.20260505.163000Z → 1.3.0-dev.20260620.061059Z

package/src/InteractionOutput.ts

@@ -1,5 +1,5 @@
-import { CompletionResult } from '@llumiverse/common';
-import { ExecutionRun, InteractionExecutionResult } from '@vertesia/common';
+import type { CompletionResult, JSONObject } from '@llumiverse/common';
+import type { ExecutionRun, InteractionExecutionResult } from '@vertesia/common';
 
 /**
  * Symbol used to mark InteractionOutputArray instances.
@@ -7,13 +7,17 @@ import { ExecutionRun, InteractionExecutionResult } from '@vertesia/common';
  */
 export const IS_INTERACTION_OUTPUT = Symbol('InteractionOutput');
 
-export function enhanceInteractionExecutionResult<ResultT = any, ParamsT = any>(r: InteractionExecutionResult<ParamsT>): EnhancedInteractionExecutionResult<ResultT, ParamsT> {
-    (r as any).result = InteractionOutput.from<ResultT>(r.result);
+export function enhanceInteractionExecutionResult<ResultT = unknown, ParamsT = unknown>(
+    r: InteractionExecutionResult<ParamsT>,
+): EnhancedInteractionExecutionResult<ResultT, ParamsT> {
+    r.result = InteractionOutput.from<ResultT>(r.result);
     return r as EnhancedInteractionExecutionResult<ResultT, ParamsT>;
 }
 
-export function enhanceExecutionRun<ResultT = any, ParamsT = any>(r: ExecutionRun<ParamsT>): EnhancedExecutionRun<ResultT, ParamsT> {
-    (r as any).result = InteractionOutput.from<ResultT>(r.result);
+export function enhanceExecutionRun<ResultT = unknown, ParamsT = unknown>(
+    r: ExecutionRun<ParamsT>,
+): EnhancedExecutionRun<ResultT, ParamsT> {
+    r.result = InteractionOutput.from<ResultT>(r.result);
     return r as EnhancedExecutionRun<ResultT, ParamsT>;
 }
 
@@ -44,12 +48,12 @@ export function enhanceExecutionRun<ResultT = any, ParamsT = any>(r: ExecutionRu
  * interface OtherType { title: string; }
  * ```
  */
-export class InteractionOutput<T = any> {
+export class InteractionOutput<T = unknown> {
     /**
      * The raw completion results array.
      * Access this when you need to work with the underlying CompletionResult[] directly.
      */
-    constructor(public readonly results: CompletionResult[]) { }
+    constructor(public readonly results: CompletionResult[]) {}
 
     /**
      * Create an interaction output that acts as both an array and has convenience methods.
@@ -73,12 +77,14 @@ export class InteractionOutput<T = any> {
      * const text = output.text();     // string
      * ```
      */
-    static from<T = any>(results: CompletionResult[] | InteractionOutputArray<T> | Record<string, any> | string | null | undefined): InteractionOutputArray<T> {
+    static from<T = unknown>(
+        results: CompletionResult[] | InteractionOutputArray<T> | JSONObject | string | null | undefined,
+    ): InteractionOutputArray<T> {
         if (!results) {
             return createInteractionOutput<T>([]);
         }
-        // Check if already wrapped using the symbol marker        
-        if ((results as any)[IS_INTERACTION_OUTPUT]) {
+        // Check if already wrapped using the symbol marker
+        if (isInteractionOutputMarker(results)) {
             return results as InteractionOutputArray<T>;
         }
         if (Array.isArray(results)) {
@@ -90,8 +96,8 @@ export class InteractionOutput<T = any> {
         }
     }
 
-    static isInteractionOutputArray(obj: any): boolean {
-        return obj && obj[IS_INTERACTION_OUTPUT] === true;
+    static isInteractionOutputArray(obj: unknown): boolean {
+        return isInteractionOutputMarker(obj);
     }
 
     get isEmpty() {
@@ -99,15 +105,15 @@ export class InteractionOutput<T = any> {
     }
 
     hasObject() {
-        return this.results.some(r => r.type === 'json');
+        return this.results.some((r) => r.type === 'json');
     }
 
     hasText() {
-        return this.results.some(r => r.type === 'text');
+        return this.results.some((r) => r.type === 'text');
     }
 
     hasImage() {
-        return this.results.some(r => r.type === 'image');
+        return this.results.some((r) => r.type === 'image');
     }
 
     /**
@@ -116,8 +122,8 @@ export class InteractionOutput<T = any> {
      */
     text(delimiter = '\n'): string {
         return this.results
-            .filter(r => r.type === 'text')
-            .map(r => r.value)
+            .filter((r) => r.type === 'text')
+            .map((r) => r.value)
             .join(delimiter);
     }
 
@@ -125,9 +131,7 @@ export class InteractionOutput<T = any> {
      * Get an array of all text values from text results.
      */
     texts(): string[] {
-        return this.results
-            .filter(r => r.type === 'text')
-            .map(r => r.value);
+        return this.results.filter((r) => r.type === 'text').map((r) => r.value);
     }
 
     /**
@@ -136,14 +140,14 @@ export class InteractionOutput<T = any> {
      * @returns The first JSON result typed as T (the class generic type)
      * @throws Error if no JSON result found and text cannot be parsed as JSON
      */
-    object(): T {
-        const jsonResult = this.results.find(r => r.type === 'json');
+    object<U = T>(): U {
+        const jsonResult = this.results.find((r) => r.type === 'json');
         if (jsonResult) {
-            return jsonResult.value as T;
+            return jsonResult.value as U;
         }
 
         // Fallback: try to parse the other text parts as JSON
-        return parseCompletionResultAsJson(this.results);
+        return parseCompletionResultAsJson<U>(this.results);
     }
 
     /**
@@ -151,9 +155,7 @@ export class InteractionOutput<T = any> {
      * @returns An array of all JSON results typed as T[] (the class generic type)
      */
     objects(): T[] {
-        return this.results
-            .filter(r => r.type === 'json')
-            .map(r => r.value as T);
+        return this.results.filter((r) => r.type === 'json').map((r) => r.value as T);
     }
 
     /**
@@ -181,7 +183,7 @@ export class InteractionOutput<T = any> {
      * @throws Error if no image result exists
      */
     image(): string {
-        const imageResult = this.results.find(r => r.type === 'image');
+        const imageResult = this.results.find((r) => r.type === 'image');
         if (!imageResult) {
             throw new Error('No image result found');
         }
@@ -192,9 +194,7 @@ export class InteractionOutput<T = any> {
      * Get an array of all image values (base64 data URLs or URLs).
      */
     images(): string[] {
-        return this.results
-            .filter(r => r.type === 'image')
-            .map(r => r.value);
+        return this.results.filter((r) => r.type === 'image').map((r) => r.value);
     }
 
     /**
@@ -216,7 +216,7 @@ export class InteractionOutput<T = any> {
      */
     stringify(separator = '\n', indent = 2): string {
         return this.results
-            .map(r => {
+            .map((r) => {
                 switch (r.type) {
                     case 'json':
                         return JSON.stringify(r.value, null, indent);
@@ -240,7 +240,7 @@ export class InteractionOutput<T = any> {
      * Attempts to return the first JSON object, falls back to concatenated text.
      */
     toJSON(): CompletionResult[] {
-        return this.results
+        return this.results;
     }
 }
 
@@ -248,13 +248,22 @@ export class InteractionOutput<T = any> {
  * Type representing a CompletionResult array enhanced with InteractionOutput methods.
  * This is the return type of InteractionOutput.from() - it acts as both an array and has convenience methods.
  */
-export type InteractionOutputArray<T = any> = CompletionResult[] & InteractionOutput<T>;
+export type InteractionOutputArray<T = unknown> = CompletionResult[] & InteractionOutput<T>;
+
+type InteractionOutputMarker = {
+    [IS_INTERACTION_OUTPUT]?: boolean;
+};
 
-export interface EnhancedInteractionExecutionResult<ResultT = any, ParamsT = any> extends InteractionExecutionResult<ParamsT> {
+function isInteractionOutputMarker(obj: unknown): obj is InteractionOutputMarker {
+    return !!obj && typeof obj === 'object' && (obj as InteractionOutputMarker)[IS_INTERACTION_OUTPUT] === true;
+}
+
+export interface EnhancedInteractionExecutionResult<ResultT = unknown, ParamsT = unknown>
+    extends InteractionExecutionResult<ParamsT> {
     result: InteractionOutputArray<ResultT>;
 }
 
-export interface EnhancedExecutionRun<ResultT = any, ParamsT = any> extends ExecutionRun<ParamsT> {
+export interface EnhancedExecutionRun<ResultT = unknown, ParamsT = unknown> extends ExecutionRun<ParamsT> {
     result: InteractionOutputArray<ResultT>;
 }
 
@@ -282,7 +291,7 @@ export interface EnhancedExecutionRun<ResultT = any, ParamsT = any> extends Exec
  * const img = output.image();     // string
  * ```
  */
-export function createInteractionOutput<T = any>(results: CompletionResult[]): InteractionOutputArray<T> {
+export function createInteractionOutput<T = unknown>(results: CompletionResult[]): InteractionOutputArray<T> {
     const wrapper = new InteractionOutput<T>(results);
 
     return new Proxy(results, {
@@ -294,7 +303,7 @@ export function createInteractionOutput<T = any>(results: CompletionResult[]): I
 
             // Check if the wrapper has this property/method
             if (prop in wrapper) {
-                const value = (wrapper as any)[prop];
+                const value = Reflect.get(wrapper, prop, wrapper) as unknown;
                 // If it's a function, bind it to the wrapper so 'this' works correctly
                 if (typeof value === 'function') {
                     return value.bind(wrapper);
@@ -304,25 +313,24 @@ export function createInteractionOutput<T = any>(results: CompletionResult[]): I
             }
             // Otherwise delegate to the array
             return Reflect.get(target, prop, receiver);
-        }
+        },
     }) as InteractionOutputArray<T>;
 }
 
-
-function parseCompletionResultAsJson(data: CompletionResult[]) {
+function parseCompletionResultAsJson<T>(data: CompletionResult[]): T {
     let lastError: Error | undefined;
     for (const part of data) {
-        if (part.type === "text") {
+        if (part.type === 'text') {
             const text = part.value.trim();
             try {
-                return JSON.parse(text);
-            } catch (error: any) {
-                lastError = error;
+                return JSON.parse(text) as T;
+            } catch (error: unknown) {
+                lastError = error instanceof Error ? error : new Error(String(error));
             }
         }
     }
     if (!lastError) {
-        lastError = new Error("No JSON result found and no text available to parse");
+        lastError = new Error('No JSON result found and no text available to parse');
     }
     throw lastError;
 }

package/src/InteractionResult.example.ts

@@ -4,7 +4,7 @@
  * an array and has convenience methods.
  */
 
-import { CompletionResult } from '@llumiverse/common';
+import type { CompletionResult } from '@llumiverse/common';
 import { InteractionOutput } from './InteractionOutput.js';
 
 // Sample data
@@ -13,27 +13,36 @@ const sampleResults: CompletionResult[] = [
     { type: 'text', value: 'World!' },
     { type: 'json', value: { name: 'Alice', age: 30 } },
     { type: 'json', value: { title: 'Engineer', level: 'Senior' } },
-    { type: 'image', value: 'data:image/png;base64,iVBORw0K...' }
+    { type: 'image', value: 'data:image/png;base64,iVBORw0K...' },
 ];
 
 // Example 1: Using InteractionOutput.from() (Proxy approach - RECOMMENDED)
 console.log('=== Example 1: Proxy Approach ===');
-interface Person { name: string; age: number; }
+interface Person {
+    name: string;
+    age: number;
+}
 const output = InteractionOutput.from<Person>(sampleResults);
 
 // Works as an array
-console.log('Array length:', output.length);           // 5
-console.log('First item:', output[0]);                 // { type: 'text', value: 'Hello, ' }
-console.log('Types:', output.map(r => r.type));        // ['text', 'text', 'json', 'json', 'image']
+console.log('Array length:', output.length); // 5
+console.log('First item:', output[0]); // { type: 'text', value: 'Hello, ' }
+console.log(
+    'Types:',
+    output.map((r) => r.type),
+); // ['text', 'text', 'json', 'json', 'image']
 
 // Has convenience methods
-console.log('All text:', output.text);                 // 'Hello, World!'
-console.log('First object:', output.object());         // { name: 'Alice', age: 30 } (typed as Person)
-console.log('All objects:', output.objects());         // [{ name: 'Alice', age: 30 }, { title: 'Engineer', level: 'Senior' }]
-console.log('First image:', output.image);             // 'data:image/png;base64,iVBORw0K...'
+console.log('All text:', output.text); // 'Hello, World!'
+console.log('First object:', output.object()); // { name: 'Alice', age: 30 } (typed as Person)
+console.log('All objects:', output.objects()); // [{ name: 'Alice', age: 30 }, { title: 'Engineer', level: 'Senior' }]
+console.log('First image:', output.image); // 'data:image/png;base64,iVBORw0K...'
 
 // Override type for specific objects
-interface Job { title: string; level: string; }
+interface Job {
+    title: string;
+    level: string;
+}
 console.log('Second object:', output.objectAt<Job>(1)); // { title: 'Engineer', level: 'Senior' } (typed as Job)
 
 // Example 2: Using InteractionOutput class directly
@@ -42,15 +51,18 @@ const wrapper = new InteractionOutput<Person>(sampleResults);
 
 // Access through wrapper properties (no array access)
 console.log('All text:', wrapper.text);
-console.log('Raw results:', wrapper.results);          // Original array
+console.log('Raw results:', wrapper.results); // Original array
 console.log('First object:', wrapper.object());
 
 // Example 3: Type safety demonstration
 console.log('\n=== Example 3: Type Safety ===');
 
-interface Contract { title: string; parties: string[]; }
+interface Contract {
+    title: string;
+    parties: string[];
+}
 const contractResults: CompletionResult[] = [
-    { type: 'json', value: { title: 'Sales Agreement', parties: ['Alice', 'Bob'] } }
+    { type: 'json', value: { title: 'Sales Agreement', parties: ['Alice', 'Bob'] } },
 ];
 
 const contractOutput = InteractionOutput.from<Contract>(contractResults);
@@ -63,10 +75,10 @@ console.log('\n=== Example 4: Mixed Content ===');
 const mixedResults: CompletionResult[] = [
     { type: 'text', value: 'Analysis complete. Results: ' },
     { type: 'json', value: { score: 0.95, confidence: 'high' } },
-    { type: 'text', value: '\nThank you!' }
+    { type: 'text', value: '\nThank you!' },
 ];
 
 const mixed = InteractionOutput.from(mixedResults);
-console.log('Full text:', mixed.text);                 // 'Analysis complete. Results: \nThank you!'
-console.log('Analysis:', mixed.object());              // { score: 0.95, confidence: 'high' }
-console.log('Text parts:', mixed.texts);               // ['Analysis complete. Results: ', '\nThank you!']
+console.log('Full text:', mixed.text); // 'Analysis complete. Results: \nThank you!'
+console.log('Analysis:', mixed.object()); // { score: 0.95, confidence: 'high' }
+console.log('Text parts:', mixed.texts); // ['Analysis complete. Results: ', '\nThank you!']

package/src/InteractionsApi.ts

@@ -1,23 +1,50 @@
-import { ApiTopic, ClientBase, ServerError } from "@vertesia/api-fetch-client";
-import {
-    AsyncExecutionPayload, AsyncExecutionResult, ComputeInteractionFacetPayload, ComputedFacetResponse, GenerateInteractionPayload, GenerateTestDataPayload, GeneratedInteractionDefinition, GeneratedTestDataRecord, ImprovePromptPayload,
+import { ApiTopic, type ClientBase, type IRequestParams, ServerError } from '@vertesia/api-fetch-client';
+import type {
+    AsyncExecutionPayload,
+    AsyncExecutionResult,
+    ComputedFacetResponse,
+    ComputeInteractionFacetPayload,
+    DeleteByIdResult,
+    GeneratedInteractionDefinition,
+    GeneratedTestDataRecord,
+    GenerateInteractionPayload,
+    GenerateTestDataPayload,
+    ImprovePromptPayload,
     ImprovePromptPayloadConfig,
-    Interaction, InteractionCreatePayload, InteractionEndpoint, InteractionEndpointQuery,
-    InteractionExecutionPayload, InteractionForkPayload,
-    InteractionPublishPayload, InteractionRef, InteractionRefWithSchema, InteractionSearchPayload, InteractionSearchQuery,
-    InteractionsExportPayload, InteractionTags, InteractionUpdatePayload, PromptImprovementResponse,
-    RateLimitRequestPayload, RateLimitRequestResponse, ResolvedInteractionExecutionInfo
-} from "@vertesia/common";
-import { VertesiaClient } from "./client.js";
-import { checkRateLimit, executeInteraction, executeInteractionAsync, executeInteractionByName } from "./execute.js";
-import { InteractionCatalogApi } from "./InteractionCatalogApi.js";
-import { EnhancedInteractionExecutionResult, enhanceInteractionExecutionResult } from "./InteractionOutput.js";
+    Interaction,
+    InteractionCreatePayload,
+    InteractionDeletePayload,
+    InteractionEndpoint,
+    InteractionEndpointQuery,
+    InteractionExecutionPayload,
+    InteractionForkPayload,
+    InteractionPublishPayload,
+    InteractionRef,
+    InteractionRefWithSchema,
+    InteractionSearchPayload,
+    InteractionSearchQuery,
+    InteractionsExportPayload,
+    InteractionTags,
+    InteractionUpdatePayload,
+    PromptImprovementResponse,
+    RateLimitRequestPayload,
+    RateLimitRequestResponse,
+    ResolvedInteractionExecutionInfo,
+} from '@vertesia/common';
+import type { VertesiaClient } from './client.js';
+import { checkRateLimit, executeInteraction, executeInteractionAsync, executeInteractionByName } from './execute.js';
+import { InteractionCatalogApi } from './InteractionCatalogApi.js';
+import { type EnhancedInteractionExecutionResult, enhanceInteractionExecutionResult } from './InteractionOutput.js';
+
+function hasIdPayload(payload: unknown): payload is { id: string } {
+    return !!payload && typeof payload === 'object' && 'id' in payload && typeof payload.id === 'string';
+}
 
 export default class InteractionsApi extends ApiTopic {
     catalog: InteractionCatalogApi;
 
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/interactions");
+        super(parent, '/api/v1/interactions');
         this.catalog = new InteractionCatalogApi(parent);
     }
 
@@ -26,21 +53,22 @@ export default class InteractionsApi extends ApiTopic {
      * @returns InteractionRef[]
      **/
     list(payload: InteractionSearchPayload = {}): Promise<InteractionRef[]> {
-        const query = payload.query || {} as InteractionSearchQuery;
+        const query = payload.query || ({} as InteractionSearchQuery);
 
-        return this.get("/", {
+        return this.get('/', {
             query: {
-                ...query
-            }
+                ...query,
+            },
         });
     }
+
     /**
      * Find interactions given a mongo match query.
      * You can also specify if prompts schemas are included in the result
      */
     listEndpoints(payload: InteractionEndpointQuery): Promise<InteractionEndpoint[]> {
-        return this.post("/endpoints", {
-            payload
+        return this.post('/endpoints', {
+            payload,
         });
     }
 
@@ -59,10 +87,10 @@ export default class InteractionsApi extends ApiTopic {
      * @returns InteractionTags[]
      **/
     listTags(query?: InteractionSearchQuery): Promise<InteractionTags[]> {
-        return this.get("/tags", {
+        return this.get('/tags', {
             query: {
-                ...query
-            }
+                ...query,
+            },
         });
     }
 
@@ -72,8 +100,8 @@ export default class InteractionsApi extends ApiTopic {
      * @returns ComputedFacetResponse
      **/
     computeFacets(query: ComputeInteractionFacetPayload): Promise<ComputedFacetResponse> {
-        return this.post("/facets", {
-            payload: query
+        return this.post('/facets', {
+            payload: query,
         });
     }
 
@@ -81,7 +109,7 @@ export default class InteractionsApi extends ApiTopic {
      * List interaction names in the current project
      * @returns
      */
-    listNames(): Promise<{ id: string, name: string }[]> {
+    listNames(): Promise<{ id: string; name: string }[]> {
         return this.get('/names');
     }
 
@@ -103,7 +131,7 @@ export default class InteractionsApi extends ApiTopic {
      **/
     create(payload: InteractionCreatePayload): Promise<Interaction> {
         return this.post('/', {
-            payload
+            payload,
         });
     }
 
@@ -128,10 +156,25 @@ export default class InteractionsApi extends ApiTopic {
      **/
     update(id: string, payload: InteractionUpdatePayload): Promise<Interaction> {
         return this.put(`/${id}`, {
-            payload
+            payload,
         });
     }
 
+    /**
+     * Delete an interaction. Pass `{ cascade: true }` to also delete every interaction in the
+     * target's family — see {@link InteractionDeletePayload}.
+     *
+     * The signature must stay assignment-compatible with the inherited
+     * `ApiTopic.delete(path, params)`, so the parameter is `IRequestParams & InteractionDeletePayload`.
+     * Callers can keep passing only the payload (`{ cascade: true }`); IRequestParams fields are all
+     * optional.
+     */
+    delete(id: string, payload?: IRequestParams & InteractionDeletePayload): Promise<DeleteByIdResult> {
+        const { cascade, query, ...rest } = payload ?? {};
+        const mergedQuery = cascade ? { ...(query ?? {}), cascade: 'true' } : (query ?? undefined);
+        return super.delete(`/${id}`, { ...rest, query: mergedQuery }) as Promise<DeleteByIdResult>;
+    }
+
     /**
      * Execute an interaction and return a promise which will be resolved with the executed run when
      * the run completes or fails.
@@ -148,15 +191,20 @@ export default class InteractionsApi extends ApiTopic {
      * @throws 500 if interaction execution fails
      * @throws 500 if interaction execution times out
      **/
-    async execute<ResultT = any, ParamsT = any>(id: string, payload: InteractionExecutionPayload = {},
-        onChunk?: (chunk: string) => void): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>> {
-        const r = await executeInteraction<ParamsT>(this.client as VertesiaClient, id, payload, onChunk).catch(err => {
-            if (err instanceof ServerError && err.payload?.id) {
-                throw err.updateDetails({ run_id: err.payload.id });
-            } else {
-                throw err;
-            }
-        });
+    async execute<ResultT = unknown, ParamsT = unknown>(
+        id: string,
+        payload: InteractionExecutionPayload = {},
+        onChunk?: (chunk: string) => void,
+    ): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>> {
+        const r = await executeInteraction<ParamsT>(this.client as VertesiaClient, id, payload, onChunk).catch(
+            (err) => {
+                if (err instanceof ServerError && hasIdPayload(err.payload)) {
+                    throw err.updateDetails({ run_id: err.payload.id });
+                } else {
+                    throw err;
+                }
+            },
+        );
         return enhanceInteractionExecutionResult<ResultT, ParamsT>(r);
     }
 
@@ -175,10 +223,18 @@ export default class InteractionsApi extends ApiTopic {
      * @param onChunk
      * @returns
      */
-    async executeByName<ResultT = any, ParamsT = any>(nameWithTag: string, payload: InteractionExecutionPayload = {},
-        onChunk?: (chunk: string) => void): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>> {
-        const r = await executeInteractionByName<ParamsT>(this.client as VertesiaClient, nameWithTag, payload, onChunk).catch(err => {
-            if (err instanceof ServerError && err.payload?.id) {
+    async executeByName<ResultT = unknown, ParamsT = unknown>(
+        nameWithTag: string,
+        payload: InteractionExecutionPayload = {},
+        onChunk?: (chunk: string) => void,
+    ): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>> {
+        const r = await executeInteractionByName<ParamsT>(
+            this.client as VertesiaClient,
+            nameWithTag,
+            payload,
+            onChunk,
+        ).catch((err) => {
+            if (err instanceof ServerError && hasIdPayload(err.payload)) {
                 throw err.updateDetails({ run_id: err.payload.id });
             } else {
                 throw err;
@@ -198,13 +254,13 @@ export default class InteractionsApi extends ApiTopic {
 
     publish(id: string, payload: InteractionPublishPayload): Promise<Interaction> {
         return this.post(`/${id}/publish`, {
-            payload
+            payload,
         });
     }
 
     fork(id: string, payload: InteractionForkPayload): Promise<Interaction> {
         return this.post(`/${id}/fork`, {
-            payload
+            payload,
         });
     }
 
@@ -212,20 +268,17 @@ export default class InteractionsApi extends ApiTopic {
      * Generate Composable definition of an interaction
      **/
     generateInteraction(id: string, payload: GenerateInteractionPayload): Promise<GeneratedInteractionDefinition[]> {
-
         return this.post(`${id}/generate-interaction`, {
-            payload
+            payload,
         });
-
     }
 
     /**
      * Generate Test Data for an interaction
      **/
     generateTestData(id: string, payload: GenerateTestDataPayload): Promise<GeneratedTestDataRecord[]> {
-
         return this.post(`${id}/generate-test-data`, {
-            payload
+            payload,
         });
     }
 
@@ -235,17 +288,16 @@ export default class InteractionsApi extends ApiTopic {
      */
     suggestImprovements(id: string, payload: ImprovePromptPayloadConfig): Promise<PromptImprovementResponse> {
         return this.post(`${id}/suggest-prompt-improvements`, {
-            payload
+            payload,
         });
     }
 
     suggestPromptImprovements(payload: ImprovePromptPayload): Promise<PromptImprovementResponse> {
         return this.post(`/improve`, {
-            payload
+            payload,
         });
     }
 
-
     /**
      * List the versions of the interaction. Returns an empty array if no versions are found
      * @param id
@@ -287,15 +339,17 @@ export default class InteractionsApi extends ApiTopic {
      * @param options Optional environment and/or model to resolve with
      * @returns ResolvedInteractionExecutionInfo with the resolved environment and model
      */
-    resolve(nameOrId: string, options?: {
-        environment?: string;
-        model?: string;
-        hasImage?: boolean;
-        hasVideo?: boolean;
-    }): Promise<ResolvedInteractionExecutionInfo> {
+    resolve(
+        nameOrId: string,
+        options?: {
+            environment?: string;
+            model?: string;
+            hasImage?: boolean;
+            hasVideo?: boolean;
+        },
+    ): Promise<ResolvedInteractionExecutionInfo> {
         return this.get(`/resolve/${encodeURIComponent(nameOrId)}`, {
-            query: options
+            query: options,
         });
     }
-
 }

package/src/OAuthClientsApi.ts

@@ -1,8 +1,9 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     CreateOAuthClientPayload,
     OAuthClient,
     OAuthClientCreateResponse,
+    OAuthClientScopeMetadata,
     SuccessResponse,
     UpdateOAuthClientPayload,
 } from '@vertesia/common';
@@ -20,6 +21,10 @@ export default class OAuthClientsApi extends ApiTopic {
         return this.get(`/${clientId}`);
     }
 
+    scopeMetadata(): Promise<OAuthClientScopeMetadata> {
+        return this.get('/scope-metadata');
+    }
+
     create(payload: CreateOAuthClientPayload): Promise<OAuthClientCreateResponse> {
         return this.post('/', { payload });
     }