@vertesia/client 1.3.0 → 1.4.0-dev.20260615.042033Z

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@vertesia/client",
-  "version": "1.3.0",
+  "version": "1.4.0-dev.20260615.042033Z",
   "type": "module",
-  "types": "./lib/types/index.d.ts",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
   "files": [
     "lib",
     "src",
@@ -10,38 +11,30 @@
   ],
   "license": "Apache-2.0",
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/node": "^24.1.0",
-    "eslint": "^10.0.2",
-    "rollup": "^4.59.0",
-    "ts-dual-module": "^0.6.3",
-    "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.1",
-    "vitest": "^4.0.16"
+    "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@types/node": "^24.12.4",
+    "rollup": "^4.61.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "@vertesia/tsconfig": "0.1.0"
   },
   "dependencies": {
-    "eventsource": "^3.0.6",
+    "eventsource": "^4.1.0",
     "@llumiverse/common": "1.3.0",
-    "@vertesia/common": "1.3.0",
-    "@vertesia/api-fetch-client": "1.3.0"
-  },
-  "ts_dual_module": {
-    "outDir": "lib"
+    "@vertesia/api-fetch-client": "1.4.0-dev.20260615.042033Z",
+    "@vertesia/common": "1.4.0-dev.20260615.042033Z"
   },
   "exports": {
     ".": {
-      "types": "./lib/types/index.d.ts",
-      "import": "./lib/esm/index.js",
-      "require": "./lib/cjs/index.js"
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
     },
+    "./package.json": "./package.json",
     "./node": {
-      "types": "./lib/types/nodejs/index.d.ts",
-      "import": "./lib/esm/nodejs/index.js",
-      "require": "./lib/cjs/nodejs/index.js"
+      "types": "./lib/nodejs/index.d.ts",
+      "default": "./lib/nodejs/index.js"
     }
   },
   "repository": {
@@ -58,17 +51,11 @@
     "ai",
     "typescript"
   ],
-  "typesVersions": {
-    "*": {
-      "node": [
-        "./lib/types/nodejs/index.d.ts"
-      ]
-    }
-  },
   "scripts": {
-    "lint": "eslint './src/**/*.{jsx,js,tsx,ts}'",
-    "build": "pnpm exec tsmod build && pnpm exec rollup -c",
-    "clean": "rimraf ./node_modules ./lib ./tsconfig.tsbuildinfo",
-    "test": "vitest run"
+    "lint": "biome lint src",
+    "build": "rm -rf ./lib ./tsconfig.tsbuildinfo && tsc && pnpm exec rollup -c",
+    "clean": "rm -rf ./node_modules ./lib ./tsconfig.tsbuildinfo",
+    "test": "vitest run",
+    "typecheck:test": "tsc -p tsconfig.test.json --noEmit"
   }
 }

package/src/AccountApi.ts

@@ -1,8 +1,7 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import {
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     Account,
     AccountProjectsResponse,
-    GoogleProjectTokenResponse,
     InviteAcceptanceResponse,
     InviteDeclineResponse,
     InviteUserRequestPayload,
@@ -14,12 +13,11 @@ import {
     UpdateAccountPayload,
     User,
     UserInviteTokenData,
-} from "@vertesia/common";
+} from '@vertesia/common';
 
 export default class AccountApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/account")
+        super(parent, '/api/v1/account');
     }
 
     /**
@@ -40,13 +38,13 @@ export default class AccountApi extends ApiTopic {
 
     /**
      * Get all projects for account
-    */
+     */
     projects(): Promise<ProjectRef[]> {
-        return this.get('/projects').then((res: AccountProjectsResponse) => res.data);
+        return this.get<AccountProjectsResponse>('/projects').then((res) => res.data);
     }
 
     members(): Promise<User[]> {
-        return this.get('/members')
+        return this.get('/members');
     }
 
     /**
@@ -68,7 +66,7 @@ export default class AccountApi extends ApiTopic {
      * @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<TransientToken<UserInviteTokenData>[]> {
         return this.get(`/invites/${type}`);
     }
 
@@ -85,7 +83,7 @@ export default class AccountApi extends ApiTopic {
      * @returns InviteDeclineResponse
      * */
     rejectInvite(id: string): Promise<InviteDeclineResponse> {
-        return this.delete(`/invites/${id}`);
+        return this.del(`/invites/${id}`);
     }
 
     /**
@@ -95,17 +93,7 @@ export default class AccountApi extends ApiTopic {
         return this.get('/onboarding');
     }
 
-    /**
-     * Get a google auth token for the current project.
-     * This token can be used to access exposed google cloud services
-     * @returns
-     */
-    getGoogleToken(): Promise<GoogleProjectTokenResponse> {
-        return this.get('/google-token');
-    }
-
     getStripeBillingStatus(): Promise<StripeBillingStatusResponse> {
-        return this.get('/stripe-billing-status')
+        return this.get('/stripe-billing-status');
     }
-
 }

package/src/AccountsApi.ts

@@ -1,10 +1,9 @@
-import { Account } from "@vertesia/common";
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { Account } from '@vertesia/common';
 
 export default class AccountsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/accounts")
+        super(parent, '/api/v1/accounts');
     }
 
     create(name: string): Promise<Account> {
@@ -14,9 +13,4 @@ export default class AccountsApi extends ApiTopic {
     list(): Promise<Account[]> {
         return this.get('/');
     }
-
-
-
-
-
 }

package/src/AnalyticsApi.ts

@@ -1,10 +1,9 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import { DateRangeQuery, RunsAnalyticsSummary, TokenUsageSummary } from "@vertesia/common";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { DateRangeQuery, RunsAnalyticsSummary, TokenUsageSummary } from '@vertesia/common';
 
 export default class AnalyticsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/analytics")
+        super(parent, '/api/v1/analytics');
     }
 
     runsSummary(query?: DateRangeQuery, environmentId?: string): Promise<RunsAnalyticsSummary> {
@@ -13,7 +12,7 @@ export default class AnalyticsApi extends ApiTopic {
         if (query?.end) params.set('end', query.end);
         if (environmentId) params.set('environment', environmentId);
         const qs = params.toString();
-        return this.get('/runs/summary' + (qs ? '?' + qs : ''));
+        return this.get(`/runs/summary${qs ? `?${qs}` : ''}`);
     }
 
     runsTimeSeries(query?: DateRangeQuery, environmentId?: string): Promise<Array<{ timestamp: Date; count: number }>> {
@@ -22,7 +21,7 @@ export default class AnalyticsApi extends ApiTopic {
         if (query?.end) params.set('end', query.end);
         if (environmentId) params.set('environment', environmentId);
         const qs = params.toString();
-        return this.get('/runs/time-series' + (qs ? '?' + qs : ''));
+        return this.get(`/runs/time-series${qs ? `?${qs}` : ''}`);
     }
 
     runsTokenUsage(query?: DateRangeQuery, environmentId?: string): Promise<TokenUsageSummary> {
@@ -31,7 +30,6 @@ export default class AnalyticsApi extends ApiTopic {
         if (query?.end) params.set('end', query.end);
         if (environmentId) params.set('environment', environmentId);
         const qs = params.toString();
-        return this.get('/runs/token-usage' + (qs ? '?' + qs : ''));
+        return this.get(`/runs/token-usage${qs ? `?${qs}` : ''}`);
     }
-
 }

package/src/ApiKeysApi.ts

@@ -1,5 +1,13 @@
-import { ApiKey, ApiKeyReadResponse, ApiKeyWithValue, AuthTokenResponse, CreateOrUpdateApiKeyPayload, CreatePublicKeyPayload, DeleteOperationResult } from '@vertesia/common';
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
+    ApiKey,
+    ApiKeyReadResponse,
+    ApiKeyWithValue,
+    AuthTokenResponse,
+    CreateOrUpdateApiKeyPayload,
+    CreatePublicKeyPayload,
+    DeleteOperationResult,
+} from '@vertesia/common';
 
 export class ApiKeysApi extends ApiTopic {
     constructor(parent: ClientBase) {

package/src/AppsApi.ts

@@ -1,5 +1,9 @@
-import { ApiTopic, ClientBase, ServerError } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase, type ServerError } from '@vertesia/api-fetch-client';
 import type {
+    ActivateAppVersionResponse,
+    AppBuildProgress,
+    AppDeleteSummary,
+    AppInspectionResult,
     AppInstallation,
     AppInstallationKind,
     AppInstallationListEntry,
@@ -7,19 +11,29 @@ import type {
     AppInstallationWithManifest,
     AppManifest,
     AppManifestData,
+    AppPackage,
+    AppPackageScope,
     AppToolCollection,
+    AppVersionListQuery,
+    AppVersionRecord,
     CountResult,
     ProjectRef,
     RequireAtLeastOne,
+    StartAppBuildRequest,
+    StartAppBuildResponse,
     UpdateAppInstallationToolAllowlistPayload,
+    UpsertAppVersionRequest,
     ValidateUrlRequest,
     ValidateUrlResponse,
-} from "@vertesia/common";
+} from '@vertesia/common';
 
-export default class AppsApi extends ApiTopic {
+export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
+    manifest: null;
+}
 
+export default class AppsApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/apps")
+        super(parent, '/api/v1/apps');
     }
 
     create(manifest: AppManifestData): Promise<AppManifest> {
@@ -30,13 +44,96 @@ export default class AppsApi extends ApiTopic {
         return this.put(`/${id}`, { payload: manifest });
     }
 
+    /**
+     * Preview what the cascade delete would remove. Calls DELETE without confirm,
+     * which the server treats as a dry-run and returns counts + paths.
+     */
+    previewDelete(id: string): Promise<AppDeleteSummary> {
+        return this.del(`/${id}`);
+    }
+
+    /**
+     * Cascade-delete an app and everything attached to it (versions,
+     * installations + ACEs, git repo on the app-git server). Pass through
+     * the dry-run summary; confirm flag is required server-side.
+     */
+    deleteApp(id: string): Promise<AppDeleteSummary> {
+        return this.del(`/${id}`, { query: { confirm: 'true' } });
+    }
+
+    listVersions(query?: AppVersionListQuery): Promise<AppVersionRecord[]> {
+        return this.get('/versions', {
+            query: {
+                ...(query?.app_id && { app_id: query.app_id }),
+                ...(query?.kind && { kind: query.kind }),
+                ...(query?.include_expired !== undefined && { include_expired: query.include_expired }),
+                ...(query?.limit !== undefined && { limit: query.limit }),
+            },
+        });
+    }
+
+    upsertVersion(payload: UpsertAppVersionRequest): Promise<AppVersionRecord> {
+        return this.post('/versions', { payload });
+    }
+
+    getVersion(recordId: string): Promise<AppVersionRecord> {
+        return this.get(`/versions/${recordId}`);
+    }
+
+    activateVersion(recordId: string): Promise<ActivateAppVersionResponse> {
+        return this.post(`/versions/${recordId}/activate`);
+    }
+
+    startBuild(appIdOrRecordId: string, payload: StartAppBuildRequest): Promise<StartAppBuildResponse> {
+        return this.post(`/${encodeURIComponent(appIdOrRecordId)}/builds`, { payload });
+    }
+
+    getBuildProgress(appIdOrRecordId: string, workflowId: string, runId: string): Promise<AppBuildProgress> {
+        return this.get(
+            `/${encodeURIComponent(appIdOrRecordId)}/builds/${encodeURIComponent(workflowId)}/${encodeURIComponent(runId)}/progress`,
+        );
+    }
+
     /**
      * Get the list if tools provided by the given app.
-     * @param appId 
-     * @returns 
+     * @param appId
+     * @returns
      */
     listAppInstallationTools(appInstallId: string): Promise<AppToolCollection[]> {
-        return this.get(`/installations/${appInstallId}/tools`)
+        return this.get(`/installations/${appInstallId}/tools`);
+    }
+
+    /**
+     * Inspect an app's registration: resolved manifest state, what the published
+     * package actually exposes per capability, endpoint reachability, install
+     * state, and diagnostics. Use this to verify what an app registers vs what it
+     * declares, instead of inferring it from failed object/import calls.
+     */
+    inspect(appIdOrName: string): Promise<AppInspectionResult> {
+        return this.get(`/${appIdOrName}/inspect`);
+    }
+
+    /**
+     * Get package capabilities exposed by an app installation.
+     */
+    getAppInstallationPackage(
+        appInstallId: string,
+        scope: AppPackageScope | AppPackageScope[] = 'all',
+    ): Promise<AppPackage> {
+        return this.get(`/installations/${appInstallId}/package`, {
+            query: {
+                scope: Array.isArray(scope) ? scope.join(',') : scope,
+            },
+        });
+    }
+
+    /**
+     * Fetch the always-on system tools package served by studio-server.
+     * Tools and skills (`learn_*`) are returned on separate fields so UIs can
+     * render them distinctly. URLs are already resolved per deployment.
+     */
+    getSystemToolsPackage(scope: string = 'tools'): Promise<AppPackage> {
+        return this.get('/studio-tools/package', { query: { scope } });
     }
 
     /**
@@ -63,7 +160,7 @@ export default class AppsApi extends ApiTopic {
                 settings,
                 oauth_params: oauthParams,
                 oauth_provider_params: oauthProviderParams,
-            } satisfies AppInstallationPayload
+            } satisfies AppInstallationPayload,
         });
     }
 
@@ -78,35 +175,39 @@ export default class AppsApi extends ApiTopic {
 
     /**
      * get an app unstallation given its name or null if the app is not installed
-     * @returns 
+     * @returns
      */
     getAppInstallationByName(appName: string): Promise<AppInstallationWithManifest | null> {
-        return this.get(`/installations/name/${appName}`).catch((err: ServerError) => {
+        return this.get<AppInstallationWithManifest>(`/installations/name/${appName}`).catch((err: ServerError) => {
             if (err.status === 404) {
                 return null;
             } else {
                 throw err;
             }
-        })
+        });
     }
 
     /**
      * Get the project refs where the application is visible by the current user.
      * The application is specified either by id or by name.
-     * @param param0 
-     * @returns 
+     * @param param0
+     * @returns
      */
-    getAppInstallationProjects(app: RequireAtLeastOne<{ id?: string, name?: string }, 'id' | 'name'>): Promise<ProjectRef[]> {
+    getAppInstallationProjects(
+        app: RequireAtLeastOne<{ id?: string; name?: string }, 'id' | 'name'>,
+    ): Promise<ProjectRef[]> {
         if (!app.id && !app.name) {
-            throw new Error("Invalid arguments: appId or appName must be specified");
-        }
-        const query = app.id ? {
-            id: app.id
-        } : {
-            name: app.name
+            throw new Error('Invalid arguments: appId or appName must be specified');
         }
-        return this.get("/installations/projects", {
-            query
+        const query = app.id
+            ? {
+                  id: app.id,
+              }
+            : {
+                  name: app.name,
+              };
+        return this.get('/installations/projects', {
+            query,
         });
     }
 
@@ -118,7 +219,7 @@ export default class AppsApi extends ApiTopic {
         return this.get('/installations', {
             query: {
                 kind,
-            }
+            },
         });
     }
 
@@ -127,7 +228,7 @@ export default class AppsApi extends ApiTopic {
      * including orphaned installations
      * This requires project admin since access is not checked on the insytallations.
      * For a user level list of available installations (with user permission check) use getInstalledApps
-     * @returns 
+     * @returns
      */
     getAllAppInstallations(): Promise<AppInstallationListEntry[]> {
         return this.get('/installations/all');
@@ -144,8 +245,12 @@ export default class AppsApi extends ApiTopic {
         return this.put(`/installations/settings/${settingsPayload.app_id}`, {
             payload: {
                 app_id: settingsPayload.app_id,
-                settings: settingsPayload.settings
-            } satisfies AppInstallationPayload
+                settings: settingsPayload.settings,
+                // Forward access_control when the caller provided it (including explicit null to
+                // clear an override). The server uses `'access_control' in payload` to distinguish
+                // "leave unchanged" from "clear", so only spread the key when it was supplied.
+                ...('access_control' in settingsPayload ? { access_control: settingsPayload.access_control } : {}),
+            } satisfies AppInstallationPayload,
         });
     }
 
@@ -166,5 +271,4 @@ export default class AppsApi extends ApiTopic {
     validateUrl(url: string): Promise<ValidateUrlResponse> {
         return this.post('/validate-url', { payload: { url } satisfies ValidateUrlRequest });
     }
-
 }

package/src/AuditTrailApi.ts

@@ -1,8 +1,7 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type { AuditTrailQuery, AuditTrailResponse } from '@vertesia/common';
 
 export default class AuditTrailApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
         super(parent, '/api/v1/audit-trail');
     }
@@ -15,13 +14,14 @@ export default class AuditTrailApi extends ApiTopic {
         if (query?.principalId) params.set('principalId', query.principalId);
         if (query?.principalType) params.set('principalType', query.principalType);
         if (query?.effectivePrincipalId) params.set('effectivePrincipalId', query.effectivePrincipalId);
-        if (query?.hasEffectivePrincipal !== undefined) params.set('hasEffectivePrincipal', String(query.hasEffectivePrincipal));
+        if (query?.hasEffectivePrincipal !== undefined)
+            params.set('hasEffectivePrincipal', String(query.hasEffectivePrincipal));
         if (query?.projectId) params.set('projectId', query.projectId);
         if (query?.from) params.set('from', query.from);
         if (query?.to) params.set('to', query.to);
         if (query?.limit) params.set('limit', String(query.limit));
         if (query?.offset) params.set('offset', String(query.offset));
         const qs = params.toString();
-        return this.get('/' + (qs ? '?' + qs : ''));
+        return this.get(`/${qs ? `?${qs}` : ''}`);
     }
 }

package/src/CommandsApi.ts

@@ -1,23 +1,22 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import { GenericCommandResponse } from "@vertesia/common";
-
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { GenericCommandResponse } from '@vertesia/common';
 
 /**
  * Various utility commands
  */
 
 export default class CommandsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/commands")
+        super(parent, '/api/v1/commands');
     }
 
     async isNamespaceAvailable(name: string): Promise<boolean> {
-        return this.get(`/namespaces/${name}/is_available`).then((response) => response.available);
+        return this.get<{ available: boolean }>(`/namespaces/${name}/is_available`).then(
+            (response) => response.available,
+        );
     }
 
     async initSamples(): Promise<GenericCommandResponse> {
-        return this.post("/onboarding/init-samples");
+        return this.post('/onboarding/init-samples');
     }
-
 }

package/src/EnvironmentsApi.ts

@@ -1,6 +1,8 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import type { AIModel, EmbeddingsOptions, EmbeddingsResult, ModelSearchPayload } from "@llumiverse/common";
-import {
+import type { AIModel, ModelSearchPayload } from '@llumiverse/common';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
+    EmbeddingsApiRequest,
+    EmbeddingsApiResult,
     ExecutionEnvironment,
     ExecutionEnvironmentCreatePayload,
     ExecutionEnvironmentRef,
@@ -8,12 +10,12 @@ import {
     LoadBalancingEnvConfig,
     MediatorEnvConfig,
     MigrateInteractionsPayload,
-    MigrateInteractionsResult
-} from "@vertesia/common";
+    MigrateInteractionsResult,
+} from '@vertesia/common';
 
 export default class EnvironmentsApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/environments");
+        super(parent, '/api/v1/environments');
     }
 
     /**
@@ -28,17 +30,17 @@ export default class EnvironmentsApi extends ApiTopic {
 
     create(payload: ExecutionEnvironmentCreatePayload): Promise<ExecutionEnvironment> {
         return this.post('/', {
-            payload
+            payload,
         });
     }
 
     retrieve(id: string): Promise<ExecutionEnvironment> {
-        return this.get('/' + id);
+        return this.get(`/${id}`);
     }
 
     update(id: string, payload: ExecutionEnvironmentUpdatePayload): Promise<ExecutionEnvironment> {
-        return this.put('/' + id, {
-            payload
+        return this.put(`/${id}`, {
+            payload,
         });
     }
 
@@ -51,18 +53,21 @@ export default class EnvironmentsApi extends ApiTopic {
      * @param payload
      * @returns
      */
-    updateConfig(id: string, payload: {
-        enabled_models?: AIModel[],
-        config?: MediatorEnvConfig | LoadBalancingEnvConfig
-    }): Promise<ExecutionEnvironment> {
-        return this.put('/' + id + '/config', {
-            payload
+    updateConfig(
+        id: string,
+        payload: {
+            enabled_models?: AIModel[];
+            config?: MediatorEnvConfig | LoadBalancingEnvConfig;
+        },
+    ): Promise<ExecutionEnvironment> {
+        return this.put(`/${id}/config`, {
+            payload,
         });
     }
 
     listModels(id: string, payload?: ModelSearchPayload): Promise<AIModel[]> {
-        return this.get('/' + id + '/models', {
-            query: payload ? { ...payload } : undefined
+        return this.get(`/${id}/models`, {
+            query: payload ? { ...payload } : undefined,
         });
     }
 
@@ -70,9 +75,9 @@ export default class EnvironmentsApi extends ApiTopic {
         return this.get(`/${id}/trainable-models`);
     }
 
-    embeddings(id: string, payload?: EmbeddingsOptions): Promise<EmbeddingsResult> {
-        return this.post('/' + id + '/embeddings', {
-            payload
+    embeddings(id: string, payload: EmbeddingsApiRequest): Promise<EmbeddingsApiResult> {
+        return this.post(`/${id}/embeddings`, {
+            payload,
         });
     }
 
@@ -87,8 +92,7 @@ export default class EnvironmentsApi extends ApiTopic {
      */
     migrateInteractions(payload: MigrateInteractionsPayload): Promise<MigrateInteractionsResult> {
         return this.post(`/migrate-interactions`, {
-            payload
+            payload,
         });
     }
-
 }