@vertesia/client 1.5.0-dev.20260722.120446Z → 1.5.0-dev.20260804.124748Z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/client",
-  "version": "1.5.0-dev.20260722.120446Z",
+  "version": "1.5.0-dev.20260804.124748Z",
   "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.1.5",
+    "rolldown": "1.2.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "@vertesia/tsconfig": "0.1.0"
   },
   "dependencies": {
     "eventsource": "^4.1.0",
-    "@llumiverse/common": "1.5.0-dev.20260722.112223Z",
-    "@vertesia/common": "1.5.0-dev.20260722.120446Z",
-    "@vertesia/api-fetch-client": "1.5.0-dev.20260722.120446Z"
+    "@llumiverse/common": "1.5.0-dev.20260804.122431Z",
+    "@vertesia/common": "1.5.0-dev.20260804.124748Z",
+    "@vertesia/api-fetch-client": "1.5.0-dev.20260804.124748Z"
   },
   "exports": {
     ".": {
@@ -48,7 +48,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "203c30e5a8ddc583ac9f1acce0f5445eb38a9551",
+  "gitHead": "87ac9166db2b38bd1be6e37adf0414ea83e402ee",
   "scripts": {
     "lint": "biome lint src",
     "clean:lib": "rimraf ./lib ./tsconfig.tsbuildinfo",

package/src/AccountApi.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it, vi } from 'vitest';
+import { VertesiaClient } from './client.js';
+
+describe('AccountApi', () => {
+    it('returns onboarding.completed_at as the ISO string received over JSON', async () => {
+        const completedAt = '2026-07-29T10:00:00.000Z';
+        const fetchMock = vi.fn(async () => {
+            return new Response(
+                JSON.stringify({
+                    id: 'account-id',
+                    onboarding: { completed: true, completed_at: completedAt },
+                }),
+                {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                },
+            );
+        });
+        const client = new VertesiaClient({
+            serverUrl: 'https://api.example.com',
+            storeUrl: 'https://api.example.com',
+            fetch: fetchMock,
+        });
+
+        const account = await client.account.info();
+
+        expect(account.onboarding.completed_at).toBe(completedAt);
+        expect(account.onboarding.completed_at).not.toBeInstanceOf(Date);
+    });
+});

package/src/AccountApi.ts

@@ -9,10 +9,9 @@ import type {
     OnboardingProgress,
     ProjectRef,
     StripeBillingStatusResponse,
-    TransientToken,
     UpdateAccountPayload,
     User,
-    UserInviteTokenData,
+    UserInviteToken,
 } from '@vertesia/common';
 
 export default class AccountApi extends ApiTopic {
@@ -56,17 +55,20 @@ export default class AccountApi extends ApiTopic {
 
     /**
      * Fetch Invites for Principal
-     * @returns UserInviteTokenData[]
-     * */
-    listInvites(): Promise<TransientToken<UserInviteTokenData>[]> {
+     *
+     * Returns `UserInviteToken[]`, not `TransientToken<UserInviteTokenData>[]`. The latter declared
+     * `Date` for `expires`, `created_at` and `updated_at`, which no HTTP response can carry — the
+     * client hands back whatever `JSON.parse` produced, so those three were always strings. It now
+     * says so.
+     */
+    listInvites(): Promise<UserInviteToken[]> {
         return this.get('/invites');
     }
     /**
      * Fetch Invites for specific account or project
      * @param type Filter for the type of invitation, either "project" or "account"
-     * @returns UserInviteTokenData[]
-     * */
-    listInvitation(type: 'project' | 'account' = 'project'): Promise<TransientToken<UserInviteTokenData>[]> {
+     */
+    listInvitation(type: 'project' | 'account' = 'project'): Promise<UserInviteToken[]> {
         return this.get(`/invites/${type}`);
     }
 

package/src/ApiKeysApi.ts

@@ -4,9 +4,10 @@ import type {
     ApiKeyReadResponse,
     ApiKeyWithValue,
     AuthTokenResponse,
-    CreateOrUpdateApiKeyPayload,
+    CreateApiKeyPayload,
     CreatePublicKeyPayload,
     DeleteOperationResult,
+    UpdateApiKeyPayload,
 } from '@vertesia/common';
 
 export class ApiKeysApi extends ApiTopic {
@@ -28,7 +29,7 @@ export class ApiKeysApi extends ApiTopic {
      * ALL REQUESTS ARE LOGGED IN SECURITY AUDIT LOG
      * @returns ApiKeyWithValue
      */
-    create(payload: CreateOrUpdateApiKeyPayload): Promise<ApiKeyWithValue> {
+    create(payload: CreateApiKeyPayload): Promise<ApiKeyWithValue> {
         return this.post('/', { payload });
     }
 
@@ -36,7 +37,7 @@ export class ApiKeysApi extends ApiTopic {
      * Update an existing ApiKey for account
      * @returns ApiKey
      */
-    update(id: string, payload: CreateOrUpdateApiKeyPayload): Promise<ApiKey> {
+    update(id: string, payload: UpdateApiKeyPayload): Promise<ApiKey> {
         return this.put(`/${id}`, { payload });
     }
 

package/src/AppsApi.test.ts

@@ -106,10 +106,13 @@ describe('AppsApi', () => {
 
         expect(result.commit).toBe('2'.repeat(40));
         const request = requests[0];
-        expect(request?.url).toBe('https://studio.example.com/api/v1/apps/sample-app/repo/documents');
-        expect(request?.headers.get('content-type')).toContain('multipart/form-data; boundary=');
-        const form = await request?.formData();
-        expect(JSON.parse(String(form?.get('metadata')))).toEqual({
+        if (!request) {
+            throw new Error('Expected a multipart document request');
+        }
+        expect(request.url).toBe('https://studio.example.com/api/v1/apps/sample-app/repo/documents');
+        expect(request.headers.get('content-type')).toContain('multipart/form-data; boundary=');
+        const form = await request.formData();
+        expect(JSON.parse(String(form.get('metadata')))).toEqual({
             ref: 'main',
             expected_head: '1'.repeat(40),
             message: 'Add docs',
@@ -118,7 +121,12 @@ describe('AppsApi', () => {
                 { field: 'file_1', path: 'docs/diagram.png' },
             ],
         });
-        expect((form?.get('file_0') as File).name).toBe('guide.md');
-        expect((form?.get('file_1') as File).size).toBe(3);
+        const guideFile = form.get('file_0');
+        const diagramFile = form.get('file_1');
+        if (!(guideFile instanceof File) || !(diagramFile instanceof File)) {
+            throw new Error('Expected multipart file entries');
+        }
+        expect(guideFile.name).toBe('guide.md');
+        expect(diagramFile.size).toBe(3);
     });
 });

package/src/AppsApi.ts

@@ -2,6 +2,8 @@ import { ApiTopic, type ClientBase, type ServerError } from '@vertesia/api-fetch
 import type {
     AppBuildProgress,
     AppDeleteSummary,
+    AppDevelopmentTaskDetails,
+    AppDevelopmentTaskList,
     AppInspectionResult,
     AppInstallation,
     AppInstallationKind,
@@ -12,6 +14,7 @@ import type {
     AppManifestData,
     AppPackage,
     AppPackageScope,
+    AppRepoBranch,
     AppRepoCommits,
     AppRepoDocumentCommit,
     AppRepoRefs,
@@ -21,6 +24,7 @@ import type {
     AppVersionListQuery,
     AppVersionRecord,
     CountResult,
+    CreateAppRepoBranchRequest,
     DeleteAppVersionResponse,
     ProjectRef,
     PromoteAppVersionResponse,
@@ -218,6 +222,21 @@ export default class AppsApi extends ApiTopic {
         return this.get(`/${encodeURIComponent(appIdOrName)}/repo/refs`);
     }
 
+    /** List mutable development tasks represented by `agent/*` repository branches. */
+    listDevelopmentTasks(appIdOrName: string): Promise<AppDevelopmentTaskList> {
+        return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks`);
+    }
+
+    /** Get a development task and its latest parent Studio Assistant run, when started. */
+    getDevelopmentTask(appIdOrName: string, taskId: string): Promise<AppDevelopmentTaskDetails> {
+        return this.get(`/${encodeURIComponent(appIdOrName)}/development-tasks/${encodeURIComponent(taskId)}`);
+    }
+
+    /** 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 });
+    }
+
     /**
      * Get the promoted package an app exposes, filtered by scope. App-owned (in-code) artifacts are
      * package-resolved (no per-id route), so this is how a client reads the full definition — type

package/src/EnvironmentsApi.ts

@@ -5,11 +5,9 @@ import type {
     EmbeddingsApiResult,
     EnableEnvironmentModelPayload,
     ExecutionEnvironment,
+    ExecutionEnvironmentConfigUpdatePayload,
     ExecutionEnvironmentCreatePayload,
-    ExecutionEnvironmentRef,
     ExecutionEnvironmentUpdatePayload,
-    LoadBalancingEnvConfig,
-    MediatorEnvConfig,
     MigrateInteractionsPayload,
     MigrateInteractionsResult,
 } from '@vertesia/common';
@@ -23,7 +21,7 @@ export default class EnvironmentsApi extends ApiTopic {
      * List all environments for the current project
      * @param all if true, list all environments, otherwise only the ones for the current project
      */
-    list(all: boolean = false): Promise<ExecutionEnvironmentRef[]> {
+    list(all: boolean = false): Promise<ExecutionEnvironment[]> {
         const query = all ? { all: true } : undefined;
 
         return this.get('/', { query });
@@ -54,13 +52,7 @@ export default class EnvironmentsApi extends ApiTopic {
      * @param payload
      * @returns
      */
-    updateConfig(
-        id: string,
-        payload: {
-            enabled_models?: AIModel[];
-            config?: MediatorEnvConfig | LoadBalancingEnvConfig;
-        },
-    ): Promise<ExecutionEnvironment> {
+    updateConfig(id: string, payload: ExecutionEnvironmentConfigUpdatePayload): Promise<ExecutionEnvironment> {
         return this.put(`/${id}/config`, {
             payload,
         });

package/src/GroupsApi.ts

@@ -12,6 +12,8 @@ export interface GroupsQueryOptions {
     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;
 }
 

package/src/OAuthGrantsApi.ts

@@ -5,6 +5,7 @@ import type {
     OAuthGrant,
     OAuthGrantListResponse,
     OAuthGrantRevokeResponse,
+    RevokeOAuthGrantQuery,
 } from '@vertesia/common';
 
 function toQueryRecord(query?: ListOAuthGrantsQuery): Record<string, string> | undefined {
@@ -32,7 +33,7 @@ export default class OAuthGrantsApi extends ApiTopic {
         return this.get(`/${grantId}`);
     }
 
-    revoke(grantId: string, query?: { include_consent?: boolean }): Promise<OAuthGrantRevokeResponse> {
+    revoke(grantId: string, query?: RevokeOAuthGrantQuery): Promise<OAuthGrantRevokeResponse> {
         return this.del(`/${grantId}`, { query });
     }
 

package/src/OAuthProvidersApi.ts

@@ -30,7 +30,12 @@ export default class OAuthProvidersApi extends ApiTopic {
         return this.put(`/${id}`, { payload });
     }
 
-    remove(id: string): Promise<void> {
+    /**
+     * `SuccessResponse`, not `void`: the endpoint has always returned `{ success: true }` and the
+     * document has always published it. Typing it as `void` meant a caller could not read the one
+     * field it sends without casting.
+     */
+    remove(id: string): Promise<SuccessResponse> {
         return this.del(`/${id}`);
     }
 

package/src/PromptsApi.ts

@@ -1,29 +1,28 @@
-import type { PromptRole } from '@llumiverse/common';
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
+    ComputedFacetResponse,
     ComputePromptFacetPayload,
     PromptSearchPayload,
     PromptSearchQuery,
     PromptTemplate,
     PromptTemplateCreatePayload,
     PromptTemplateForkPayload,
+    PromptTemplateInteractionsResponse,
     PromptTemplateRef,
     PromptTemplateUpdatePayload,
-    TemplateType,
+    RenderPromptPayload,
+    RenderPromptResponse,
 } from '@vertesia/common';
 
-export interface ComputePromptFacetsResponse {
-    role?: { _id: string; count: number }[];
-    total?: { count: number }[];
-}
+/**
+ * @deprecated Use `ComputedFacetResponse` from `@vertesia/common`, which is what the endpoint
+ * publishes. This restated the facet buckets in their pre-collapse shape: `total` is a number by
+ * the time the response is written, not a one-element array.
+ */
+export type ComputePromptFacetsResponse = ComputedFacetResponse;
 
-export interface PromptRenderResponse {
-    id: string;
-    name: string;
-    role: PromptRole;
-    content_type: TemplateType;
-    rendered: string;
-}
+/** @deprecated Use `RenderPromptResponse` from `@vertesia/common`. */
+export type PromptRenderResponse = RenderPromptResponse;
 
 export default class PromptsApi extends ApiTopic {
     constructor(parent: ClientBase) {
@@ -48,9 +47,9 @@ export default class PromptsApi extends ApiTopic {
     /**
      * Get the list of all prompt facets
      * @param payload query payload to filter facet search
-     * @returns ComputePromptFacetsResponse[]
+     * @returns ComputedFacetResponse
      **/
-    computeFacets(query: ComputePromptFacetPayload): Promise<ComputePromptFacetsResponse> {
+    computeFacets(query: ComputePromptFacetPayload): Promise<ComputedFacetResponse> {
         return this.post('/facets', {
             payload: query,
         });
@@ -125,7 +124,7 @@ export default class PromptsApi extends ApiTopic {
      * @throws 404 if not found
      * @throws 403 if the prompt is not in the current project
      */
-    render(id: string, payload: object): Promise<PromptRenderResponse> {
+    render(id: string, payload: RenderPromptPayload): Promise<RenderPromptResponse> {
         return this.post(`/${id}/render`, {
             payload,
         });
@@ -153,7 +152,7 @@ export default class PromptsApi extends ApiTopic {
     /**
      * Retrieve list of interactions that use the prompt template
      */
-    listInteractions(id: string): Promise<ListInteractionsResponse> {
+    listInteractions(id: string): Promise<PromptTemplateInteractionsResponse> {
         return this.get(`/${id}/interactions`);
     }
 
@@ -167,11 +166,9 @@ export default class PromptsApi extends ApiTopic {
     }
 }
 
-export interface ListInteractionsResponse {
-    prompt: string;
-    interactions: {
-        id: string;
-        name: string;
-        versions: string[];
-    }[];
-}
+/**
+ * @deprecated Use `PromptTemplateInteractionsResponse` from `@vertesia/common`, which is what the
+ * endpoint publishes. This declared `versions: string[]`; the endpoint has always sent
+ * `[{ version: number }]`.
+ */
+export type ListInteractionsResponse = PromptTemplateInteractionsResponse;