@vertesia/client 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260901.005903Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/client",
-  "version": "1.5.0-dev.20260807.073259Z",
+  "version": "1.5.0-dev.20260901.005903Z",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -12,16 +12,16 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/node": "^24.13.3",
-    "rolldown": "1.2.0",
+    "rolldown": "1.2.4",
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
     "@vertesia/tsconfig": "0.1.0"
   },
   "dependencies": {
-    "eventsource": "^4.1.0",
-    "@vertesia/api-fetch-client": "1.5.0-dev.20260807.073259Z",
-    "@vertesia/common": "1.5.0-dev.20260807.073259Z",
-    "@llumiverse/common": "1.5.0-dev.20260807.072147Z"
+    "eventsource": "^5.0.0",
+    "@llumiverse/common": "1.5.0-dev.20260831.235912Z",
+    "@vertesia/common": "1.5.0-dev.20260901.005903Z",
+    "@vertesia/api-fetch-client": "1.5.0-dev.20260901.005903Z"
   },
   "exports": {
     ".": {
@@ -48,7 +48,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "e6ebc1482ad6c4df965d74c79f82eb25fc6e2ce3",
+  "gitHead": "73de8716696201bda20b5ec0d0134bafd597387e",
   "scripts": {
     "lint": "biome lint src",
     "clean:lib": "rimraf ./lib ./tsconfig.tsbuildinfo",

package/src/AppsApi.ts

@@ -1,5 +1,6 @@
 import { ApiTopic, type ClientBase, type ServerError } from '@vertesia/api-fetch-client';
 import type {
+    AgentRunResponse,
     AppApiKeyCollectionParams,
     AppBuildProgress,
     AppDeleteSummary,
@@ -21,6 +22,7 @@ import type {
     AppRepoRefs,
     AppRepoTree,
     AppScaffoldProgress,
+    AppsQuery,
     AppToolCollection,
     AppVersionListQuery,
     AppVersionRecord,
@@ -34,17 +36,17 @@ import type {
     SetMcpApiKeyRequest,
     StartAppBuildRequest,
     StartAppBuildResponse,
+    StartAppDevelopmentTaskRequest,
     StartAppScaffoldRequest,
     StartAppScaffoldResponse,
     UpdateAppInstallationToolAllowlistPayload,
+    UpdateAppPayload,
     UpsertAppVersionRequest,
     ValidateUrlRequest,
     ValidateUrlResponse,
 } from '@vertesia/common';
 
-export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
-    manifest: null;
-}
+export type { OrphanedAppInstallation } from '@vertesia/common';
 
 export default class AppsApi extends ApiTopic {
     constructor(parent: ClientBase) {
@@ -55,7 +57,7 @@ export default class AppsApi extends ApiTopic {
         return this.post('/', { payload: manifest });
     }
 
-    update(id: string, manifest: AppManifestData): Promise<AppManifest> {
+    update(id: string, manifest: UpdateAppPayload): Promise<AppManifest> {
         return this.put(`/${id}`, { payload: manifest });
     }
 
@@ -251,11 +253,22 @@ export default class AppsApi extends ApiTopic {
         return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks`);
     }
 
-    /** Get a development task and its latest parent Studio Assistant run, when started. */
+    /** Get a development task and its latest App Builder parent run, when started. */
     getDevelopmentTask(appIdOrName: string, taskId: string): Promise<AppDevelopmentTaskDetails> {
         return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks/${encodeURIComponent(taskId)}`);
     }
 
+    /** Start the policy-controlled App Builder parent on an existing development-task branch. */
+    startDevelopmentTask(
+        appIdOrName: string,
+        taskId: string,
+        payload: StartAppDevelopmentTaskRequest,
+    ): Promise<AgentRunResponse> {
+        return this.post(`/${encodeURIComponent(appIdOrName)}/development-tasks/${encodeURIComponent(taskId)}/runs`, {
+            payload,
+        });
+    }
+
     /** Create a repository branch from an existing branch, tag, or commit. */
     createRepoBranch(appIdOrName: string, payload: CreateAppRepoBranchRequest): Promise<AppRepoBranch> {
         return this.post(`/${encodeURIComponent(appIdOrName)}/repo/branches`, { payload });
@@ -296,11 +309,12 @@ export default class AppsApi extends ApiTopic {
     }
 
     /**
-     * @param ids - ids to filter by
+     * @param query - pass `{ scope: 'project' }` to list only the apps installed in, or built in,
+     * the current project. Defaults to every app visible to the account, including the public catalog.
      * @returns the app manifests but without the agent.tool property which can be big.
      */
-    list(): Promise<AppManifest[]> {
-        return this.get('/');
+    list(query?: AppsQuery): Promise<AppManifest[]> {
+        return this.get('/', { query: { ...(query?.scope && { scope: query.scope }) } });
     }
 
     /**

package/src/GroupsApi.ts

@@ -2,20 +2,14 @@ import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     CreateUserGroupPayload,
     DeleteByIdResult,
+    ListUserGroupsQuery,
     UpdateUserGroupPayload,
     UserGroup,
     UserRef,
 } from '@vertesia/common';
 
-export interface GroupsQueryOptions {
-    search?: string;
-    tags?: string[];
-    limit?: number;
-    offset?: number;
-    /** Only return groups usable in this project (org-wide + restricted-to-this-project). */
-    project?: string;
-    [key: string]: string | string[] | number | undefined;
-}
+/** @deprecated Use ListUserGroupsQuery from @vertesia/common. */
+export type GroupsQueryOptions = ListUserGroupsQuery;
 
 export class GroupsApi extends ApiTopic {
     constructor(parent: ClientBase) {
@@ -27,7 +21,7 @@ export class GroupsApi extends ApiTopic {
      * @param options Query options for filtering and pagination
      * @returns Array of UserGroup objects
      */
-    list(options?: GroupsQueryOptions): Promise<UserGroup[]> {
+    list(options?: ListUserGroupsQuery): Promise<UserGroup[]> {
         return this.get('/', { query: options });
     }
 

package/src/InteractionCatalogApi.ts

@@ -1,5 +1,5 @@
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { CatalogInteractionRef, InCodeInteraction, InteractionStatus } from '@vertesia/common';
+import type { CatalogInteractionRef, InteractionStatus, ResolvedCatalogInteraction } from '@vertesia/common';
 
 export class InteractionCatalogApi extends ApiTopic {
     constructor(parent: ClientBase) {
@@ -58,10 +58,10 @@ export class InteractionCatalogApi extends ApiTopic {
     }
 
     /**
-     * Resolve an interaction given its id to a InCodeInteraction
+     * Resolve an interaction by ID to its complete executable definition.
      * @param id Interaction id
      */
-    resolve(id: string): Promise<InCodeInteraction> {
+    resolve(id: string): Promise<ResolvedCatalogInteraction> {
         return this.get(`/resolve/${id}`);
     }
 }

package/src/InteractionOutput.test.ts

@@ -10,6 +10,7 @@ describe('InteractionOutput', () => {
         { type: 'json', value: { title: 'Engineer', level: 'Senior' } },
         { type: 'image', value: 'data:image/png;base64,iVBORw0K...' },
         { type: 'image', value: 'https://example.com/image.jpg' },
+        { type: 'video', value: 'gs://project-bucket/runs/run-1/media/video.mp4' },
     ];
 
     describe('text accessors', () => {
@@ -29,6 +30,22 @@ describe('InteractionOutput', () => {
         });
     });
 
+    describe('thought accessors', () => {
+        it('keeps thoughts separate from normal answer text', () => {
+            const output = InteractionOutput.from([
+                { type: 'thoughts', value: 'First reason' },
+                { type: 'thoughts', value: 'Second reason' },
+                { type: 'text', value: 'Answer' },
+            ]);
+
+            expect(output.hasThoughts()).toBe(true);
+            expect(output.thoughts(' | ')).toBe('First reason | Second reason');
+            expect(output.thoughtParts()).toEqual(['First reason', 'Second reason']);
+            expect(output.text()).toBe('Answer');
+            expect(output.stringify()).toBe('Answer');
+        });
+    });
+
     describe('object accessors', () => {
         it('should return first JSON object', () => {
             const output = InteractionOutput.from<{ name: string; age: number }>(sampleResults);
@@ -78,6 +95,24 @@ describe('InteractionOutput', () => {
         });
     });
 
+    describe('video accessors', () => {
+        it('should return video results', () => {
+            const output = InteractionOutput.from(sampleResults);
+
+            expect(output.hasVideo()).toBe(true);
+            expect(output.video()).toBe('gs://project-bucket/runs/run-1/media/video.mp4');
+            expect(output.videos()).toEqual(['gs://project-bucket/runs/run-1/media/video.mp4']);
+        });
+
+        it('should throw when no video result exists', () => {
+            const output = InteractionOutput.from([{ type: 'text', value: 'hello' }]);
+
+            expect(output.hasVideo()).toBe(false);
+            expect(output.videos()).toEqual([]);
+            expect(() => output.video()).toThrow('No video result found');
+        });
+    });
+
     describe('utility methods', () => {
         it('should convert to string (concatenated text)', () => {
             const output = InteractionOutput.from(sampleResults);
@@ -99,7 +134,8 @@ describe('InteractionOutput', () => {
                     '{"name":"Alice","age":30}\n' +
                     '{"title":"Engineer","level":"Senior"}\n' +
                     'data:image/png;base64,iVBORw0K...\n' +
-                    'https://example.com/image.jpg',
+                    'https://example.com/image.jpg\n' +
+                    'gs://project-bucket/runs/run-1/media/video.mp4',
             );
         });
 
@@ -147,11 +183,11 @@ describe('InteractionOutput', () => {
             expect(output[1]).toEqual({ type: 'text', value: 'World!' });
 
             // Array properties
-            expect(output.length).toBe(6);
+            expect(output.length).toBe(7);
 
             // Array methods
             const types = output.map((r) => r.type);
-            expect(types).toEqual(['text', 'text', 'json', 'json', 'image', 'image']);
+            expect(types).toEqual(['text', 'text', 'json', 'json', 'image', 'image', 'video']);
 
             const textResults = output.filter((r) => r.type === 'text');
             expect(textResults).toHaveLength(2);
@@ -161,7 +197,7 @@ describe('InteractionOutput', () => {
             const output = InteractionOutput.from<{ name: string; age: number }>(sampleResults);
 
             // Should work as array AND have custom methods
-            expect(output.length).toBe(6);
+            expect(output.length).toBe(7);
             expect(output.text('')).toBe('Hello, World!');
             expect(output.object()).toEqual({ name: 'Alice', age: 30 });
         });
@@ -185,7 +221,7 @@ describe('InteractionOutput', () => {
 
             // Verify it still works correctly
             expect(output2.text()).toBe('Hello, \nWorld!');
-            expect(output2.length).toBe(6);
+            expect(output2.length).toBe(7);
         });
 
         it('should not double-wrap when passing an InteractionOutputArray', () => {

package/src/InteractionOutput.ts

@@ -23,7 +23,7 @@ export function enhanceExecutionRun<ResultT = unknown, ParamsT = unknown>(
 
 /**
  * A convenient wrapper around CompletionResult[] that provides ergonomic accessors
- * for different result types (text, JSON/objects, images) from interaction executions.
+ * for different result types (text, thoughts, JSON/objects, images) from interaction executions.
  *
  * Use the static from() method to create a proxied array that acts as both
  * an array and has these convenience methods.
@@ -112,10 +112,18 @@ export class InteractionOutput<T = unknown> {
         return this.results.some((r) => r.type === 'text');
     }
 
+    hasThoughts() {
+        return this.results.some((r) => r.type === 'thoughts');
+    }
+
     hasImage() {
         return this.results.some((r) => r.type === 'image');
     }
 
+    hasVideo() {
+        return this.results.some((r) => r.type === 'video');
+    }
+
     /**
      * Get the concatenated text from all text results.
      * Returns an empty string if no text results exist.
@@ -134,6 +142,18 @@ export class InteractionOutput<T = unknown> {
         return this.results.filter((r) => r.type === 'text').map((r) => r.value);
     }
 
+    /** Get visible reasoning without mixing it into the assistant answer. */
+    thoughts(delimiter = '\n'): string {
+        return this.results
+            .filter((r) => r.type === 'thoughts')
+            .map((r) => r.value)
+            .join(delimiter);
+    }
+
+    thoughtParts(): string[] {
+        return this.results.filter((r) => r.type === 'thoughts').map((r) => r.value);
+    }
+
     /**
      * Get the first JSON result as a parsed object.
      * If no JSON result exists, attempts to parse the concatenated text as JSON.
@@ -197,9 +217,24 @@ export class InteractionOutput<T = unknown> {
         return this.results.filter((r) => r.type === 'image').map((r) => r.value);
     }
 
+    /** Get the first video result URI. */
+    video(): string {
+        const videoResult = this.results.find((r) => r.type === 'video');
+        if (!videoResult) {
+            throw new Error('No video result found');
+        }
+        return videoResult.value;
+    }
+
+    /** Get all video result URIs. */
+    videos(): string[] {
+        return this.results.filter((r) => r.type === 'video').map((r) => r.value);
+    }
+
     /**
-     * Convert all results to a string representation.
-     * Text and image results are used as-is, JSON results are stringified with the specified indent.
+     * Convert all answer results to a string representation.
+     * Thoughts are available through thoughts() and remain separate from the answer.
+     * Text and media results are used as-is, JSON results are stringified with the specified indent.
      * All parts are joined using the specified separator.
      *
      * @param separator - The separator to use between parts (default: '\n')
@@ -216,6 +251,7 @@ export class InteractionOutput<T = unknown> {
      */
     stringify(separator = '\n', indent = 2): string {
         return this.results
+            .filter((r) => r.type !== 'thoughts')
             .map((r) => {
                 switch (r.type) {
                     case 'json':

package/src/OAuthServerApi.test.ts

@@ -0,0 +1,56 @@
+import type { CreateOAuthAuthorizationRequestPayload } from '@vertesia/common';
+import { describe, expect, it, vi } from 'vitest';
+import { VertesiaClient } from './client.js';
+
+const payload: CreateOAuthAuthorizationRequestPayload = {
+    response_type: 'code',
+    client_id: 'client-1',
+    redirect_uri: 'http://127.0.0.1/callback',
+    resource: 'https://mcp-dev-main.api.dev1.vertesia.io/mcp',
+    code_challenge: 'A'.repeat(43),
+    code_challenge_method: 'S256',
+};
+
+function createClient(requests: Request[]) {
+    return new VertesiaClient({
+        serverUrl: 'https://studio.example.com',
+        storeUrl: 'https://zeno.example.com',
+        tokenServerUrl: 'https://sts.dev1.vertesia.io',
+        fetch: vi.fn(async () =>
+            Response.json({
+                request_id: 'vor_1',
+                client_id: 'client-1',
+                client_name: 'Codex',
+                redirect_uri: payload.redirect_uri,
+                redirect_origin: 'http://127.0.0.1',
+                requested_scopes: [],
+                project_binding_mode: 'user_select',
+                status: 'pending',
+                created_at: '2026-08-10T00:00:00.000Z',
+                expires_at: '2026-08-10T00:10:00.000Z',
+            }),
+        ),
+        onRequest: (request) => requests.push(request),
+    });
+}
+
+describe('OAuthServerApi.createAuthorizationRequest', () => {
+    it('posts the initial request to the path-based tenant issuer', async () => {
+        const requests: Request[] = [];
+        const client = createClient(requests);
+
+        await client.oauthServer.createAuthorizationRequest(payload, '/env/dev1/dev-main');
+
+        expect(requests[0]?.url).toBe('https://sts.dev1.vertesia.io/env/dev1/dev-main/requests');
+    });
+
+    it('rejects an untrusted authorization-server path before making a request', async () => {
+        const requests: Request[] = [];
+        const client = createClient(requests);
+
+        await expect(
+            client.oauthServer.createAuthorizationRequest(payload, 'https://attacker.example.com/oauth'),
+        ).rejects.toThrow('Invalid OAuth authorization server path');
+        expect(requests).toHaveLength(0);
+    });
+});

package/src/OAuthServerApi.ts

@@ -44,8 +44,18 @@ export default class OAuthServerApi extends ClientBase {
         return this.parent.getRetryPolicy();
     }
 
-    createAuthorizationRequest(payload: CreateOAuthAuthorizationRequestPayload): Promise<OAuthAuthorizationRequest> {
-        return this.post('/requests', { payload });
+    createAuthorizationRequest(
+        payload: CreateOAuthAuthorizationRequestPayload,
+        authorizationServerPath?: string,
+    ): Promise<OAuthAuthorizationRequest> {
+        if (!authorizationServerPath) {
+            return this.post('/requests', { payload });
+        }
+        if (!/^\/env\/[a-z][a-z0-9-]{1,15}\/dev-[a-z0-9-]+$/.test(authorizationServerPath)) {
+            return Promise.reject(new Error('Invalid OAuth authorization server path'));
+        }
+        const url = new URL(`${authorizationServerPath}/requests`, this.baseUrl).toString();
+        return this.post(url, { payload });
     }
 
     createDeviceAuthorization(payload: OAuthDeviceAuthorizationRequest): Promise<OAuthDeviceAuthorizationResponse> {

package/src/ProjectsApi.ts

@@ -19,6 +19,8 @@ import type {
     RenderingTemplateDefinition,
     RenderingTemplateDefinitionRef,
     SupportedIntegrations,
+    UpdateProjectConfigurationPayload,
+    UpdateProjectPayload,
 } from '@vertesia/common';
 
 export default class ProjectsApi extends ApiTopic {
@@ -43,7 +45,7 @@ export default class ProjectsApi extends ApiTopic {
         });
     }
 
-    update(projectId: string, payload: Partial<Project>): Promise<Project> {
+    update(projectId: string, payload: UpdateProjectPayload): Promise<Project> {
         return this.put(`/${projectId}`, {
             payload,
         });
@@ -53,7 +55,7 @@ export default class ProjectsApi extends ApiTopic {
         return this.del(`/${projectId}`);
     }
 
-    updateConfiguration(projectId: string, payload: Partial<ProjectConfiguration>): Promise<ProjectConfiguration> {
+    updateConfiguration(projectId: string, payload: UpdateProjectConfigurationPayload): Promise<ProjectConfiguration> {
         return this.put(`/${projectId}/configuration`, {
             payload,
         });

package/src/RunsApi.ts

@@ -2,10 +2,13 @@ import type { ExecutionResponse } from '@llumiverse/common';
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     ComputeRunFacetPayload,
+    ComputeRunFacetsResponse,
     ExecutionRun,
     ExecutionRunDocRef,
     ExecutionRunRef,
     FindPayload,
+    FindRunResult,
+    InteractionExecutionResult,
     PopulatedExecutionRun,
     RunClonePayload,
     RunCreatePayload,
@@ -16,7 +19,12 @@ import type {
     UserMessagePayload,
 } from '@vertesia/common';
 import type { VertesiaClient } from './client.js';
-import { type EnhancedExecutionRun, enhanceExecutionRun } from './InteractionOutput.js';
+import {
+    type EnhancedExecutionRun,
+    type EnhancedInteractionExecutionResult,
+    enhanceExecutionRun,
+    enhanceInteractionExecutionResult,
+} from './InteractionOutput.js';
 
 export interface FilterOption {
     id: string;
@@ -24,14 +32,7 @@ export interface FilterOption {
     count: number;
 }
 
-export interface ComputeRunFacetsResponse {
-    environments?: { _id: string; count: number }[];
-    interactions?: { _id: string; count: number }[];
-    models?: { _id: string; count: number }[];
-    tags?: { _id: string; count: number }[];
-    status?: { _id: string; count: number }[];
-    total?: number;
-}
+export type { ComputeRunFacetsResponse } from '@vertesia/common';
 
 export class RunsApi extends ApiTopic {
     constructor(parent: ClientBase) {
@@ -54,7 +55,7 @@ export class RunsApi extends ApiTopic {
         return this.get('/', { query: query });
     }
 
-    find(payload: FindPayload): Promise<ExecutionRun[]> {
+    find(payload: FindPayload): Promise<FindRunResult[]> {
         return this.post('/find', {
             payload,
         });
@@ -91,7 +92,7 @@ export class RunsApi extends ApiTopic {
     async create<ResultT = unknown, ParamsT = unknown>(
         payload: RunCreatePayload,
         options?: { timeoutMs?: number | false | null; signal?: AbortSignal },
-    ): Promise<EnhancedExecutionRun<ResultT, ParamsT>> {
+    ): Promise<EnhancedInteractionExecutionResult<ResultT, ParamsT>> {
         const sessionTags = (this.client as VertesiaClient).sessionTags;
         if (sessionTags) {
             let tags = Array.isArray(sessionTags) ? sessionTags : [sessionTags];
@@ -102,12 +103,12 @@ export class RunsApi extends ApiTopic {
             }
             payload = { ...payload, tags };
         }
-        const r = await this.post<ExecutionRun<ParamsT>>('/', {
+        const r = await this.post<InteractionExecutionResult<ParamsT>>('/', {
             payload,
             timeoutMs: options?.timeoutMs,
             signal: options?.signal,
         });
-        return enhanceExecutionRun<ResultT, ParamsT>(r);
+        return enhanceInteractionExecutionResult<ResultT, ParamsT>(r);
     }
 
     /**
@@ -145,7 +146,7 @@ export class RunsApi extends ApiTopic {
     /**
      * Get the list of all runs facets
      * @param payload query payload to filter facet search
-     * @returns ComputeRunFacetsResponse[]
+     * @returns Facet buckets and the total number of matching runs
      **/
     computeFacets(query: ComputeRunFacetPayload): Promise<ComputeRunFacetsResponse> {
         return this.post('/facets', {

package/src/ToolsApi.ts

@@ -1,7 +1,9 @@
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     AggregatedTool,
+    InspectProjectToolQuery,
     ListProjectToolsQuery,
+    ToolInspection,
     ValidateToolNamesPayload,
     ValidateToolNamesResponse,
 } from '@vertesia/common';
@@ -37,9 +39,17 @@ export default class ToolsApi extends ApiTopic {
         const params: Record<string, string> = {};
         if (query?.sources?.length) params.sources = query.sources.join(',');
         if (query?.exclude?.length) params.exclude = query.exclude.join(',');
+        if (query?.context) params.context = query.context;
         return this.get('/', { query: Object.keys(params).length > 0 ? params : undefined });
     }
 
+    inspect(name: string, query?: InspectProjectToolQuery): Promise<ToolInspection> {
+        if (!name.trim()) throw new Error('Tool name must not be empty');
+        return this.get(`/${encodeURIComponent(name)}`, {
+            query: query?.context ? { context: query.context } : undefined,
+        });
+    }
+
     /**
      * List only Vertesia-provided builtin tools and system skills.
      */

package/src/ViewsApi.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it, vi } from 'vitest';
 import { VertesiaClient } from './client.js';
 
 describe('ViewsApi', () => {
-    it('keeps CRUD on Studio and proxies execution to Zeno', async () => {
+    it('keeps CRUD on Studio and proxies persisted and app-contributed execution to Zeno', async () => {
         const requests: Request[] = [];
         const fetchMock = vi.fn(async () => {
             return new Response(JSON.stringify({}), {
@@ -19,6 +19,7 @@ describe('ViewsApi', () => {
 
         await client.views.retrieve('document-library');
         await client.views.execute('document-library');
+        await client.views.execute('app:content:document-library');
         await client.views.preview({
             configuration: {
                 name: 'Document library',
@@ -30,6 +31,7 @@ describe('ViewsApi', () => {
         expect(requests.map((request) => request.url)).toEqual([
             'https://studio.example.com/api/v1/views/document-library',
             'https://zeno.example.com/api/v1/view-executions/document-library/execute',
+            'https://zeno.example.com/api/v1/view-executions/app%3Acontent%3Adocument-library/execute',
             'https://zeno.example.com/api/v1/view-executions/preview',
         ]);
     });

package/src/ViewsApi.ts

@@ -45,7 +45,7 @@ export default class ViewsApi extends ApiTopic {
     }
 
     /**
-     * Execute a persisted or app-contributed View through the content service.
+     * Execute a persisted, built-in system, or app-contributed View through the content service.
      */
     execute(id: string, payload: ExecuteViewRequest = {}): Promise<ViewExecutionResult> {
         return this.executionApi.execute(id, payload);

package/src/client.ts

@@ -350,6 +350,10 @@ export class VertesiaClient extends AbstractFetchClient<VertesiaClient> {
         return this.store.processes;
     }
 
+    get processTestRuns() {
+        return this.store.processTestRuns;
+    }
+
     get tasks() {
         return this.store.tasks;
     }

package/src/execute.ts

@@ -47,7 +47,7 @@ export async function executeInteraction<P = unknown>(
     onChunk?: (chunk: string) => void,
 ): Promise<InteractionExecutionResult<P>> {
     const stream = !!onChunk;
-    const response = (await client.runs.create(
+    const response = await client.runs.create<P, P>(
         {
             ...payload,
             interaction: interactionId,
@@ -56,7 +56,7 @@ export async function executeInteraction<P = unknown>(
         // Synchronous interaction execution blocks on the model; keep a long client timeout.
         // (Streaming returns the run immediately, then streams over a separate channel — see below.)
         { timeoutMs: stream ? undefined : INTERACTION_EXECUTION_TIMEOUT_MS },
-    )) as unknown as InteractionExecutionResult<P>;
+    );
     if (stream) {
         if (response.status === ExecutionRunStatus.failed) {
             return response;