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

package/lib/ToolsApi.d.ts

@@ -0,0 +1,36 @@
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { AggregatedTool, ListProjectToolsQuery, ValidateToolNamesResponse } from '@vertesia/common';
+/**
+ * Project-scoped unified tool registry.
+ *
+ * Wraps:
+ *  - `GET  /api/v1/tools`         — list every tool visible to the current principal across all sources
+ *  - `POST /api/v1/tools/validate` — resolve a list of names against the same registry
+ *
+ * Note: this is distinct from `client.store.tools` (the static builtin catalog exposed by zeno-server)
+ * — that one is global and source-incomplete (no app/interaction tools). Use this client for anything
+ * project-aware.
+ */
+export default class ToolsApi extends ApiTopic {
+    constructor(parent: ClientBase);
+    /**
+     * List the project's unified tool registry as seen by the current principal.
+     * Use `sources` for an allowlist or `exclude` for a denylist. Excluded sources
+     * are not fetched, so denylisting `'app'` skips the per-installation HTTP calls.
+     *
+     * **Interactive UI consumers should prefer `{ exclude: ['app'] }`** and fetch
+     * app tools directly via `client.apps.getInstalledApps()` + per-app
+     * `client.apps.listAppInstallationTools(id)`. Reason: app tools require N
+     * per-installation HTTP fetches; doing them browser-side keeps studio-server's
+     * fetch budget free, lets one slow app fail in isolation, and exploits browser
+     * parallelism. Server-side aggregation of the `app` source is intended for
+     * one-shot consumers (validation, CLI, agent tools) — not hot UI paths.
+     */
+    list(query?: ListProjectToolsQuery): Promise<AggregatedTool[]>;
+    /**
+     * Validate a list of tool names. Each result reports validity, source, app provenance,
+     * and (for invalid names) a closest-match suggestion.
+     */
+    validate(names: string[]): Promise<ValidateToolNamesResponse>;
+}
+//# sourceMappingURL=ToolsApi.d.ts.map

package/lib/ToolsApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsApi.d.ts","sourceRoot":"","sources":["../src/ToolsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,cAAc,EACd,qBAAqB,EAErB,yBAAyB,EAC5B,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,QAAQ;gBAC9B,MAAM,EAAE,UAAU;IAI9B;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO9D;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAGhE"}

package/lib/ToolsApi.js

@@ -0,0 +1,46 @@
+import { ApiTopic } from '@vertesia/api-fetch-client';
+/**
+ * Project-scoped unified tool registry.
+ *
+ * Wraps:
+ *  - `GET  /api/v1/tools`         — list every tool visible to the current principal across all sources
+ *  - `POST /api/v1/tools/validate` — resolve a list of names against the same registry
+ *
+ * Note: this is distinct from `client.store.tools` (the static builtin catalog exposed by zeno-server)
+ * — that one is global and source-incomplete (no app/interaction tools). Use this client for anything
+ * project-aware.
+ */
+export default class ToolsApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, '/api/v1/tools');
+    }
+    /**
+     * List the project's unified tool registry as seen by the current principal.
+     * Use `sources` for an allowlist or `exclude` for a denylist. Excluded sources
+     * are not fetched, so denylisting `'app'` skips the per-installation HTTP calls.
+     *
+     * **Interactive UI consumers should prefer `{ exclude: ['app'] }`** and fetch
+     * app tools directly via `client.apps.getInstalledApps()` + per-app
+     * `client.apps.listAppInstallationTools(id)`. Reason: app tools require N
+     * per-installation HTTP fetches; doing them browser-side keeps studio-server's
+     * fetch budget free, lets one slow app fail in isolation, and exploits browser
+     * parallelism. Server-side aggregation of the `app` source is intended for
+     * one-shot consumers (validation, CLI, agent tools) — not hot UI paths.
+     */
+    list(query) {
+        const params = {};
+        if (query?.sources?.length)
+            params.sources = query.sources.join(',');
+        if (query?.exclude?.length)
+            params.exclude = query.exclude.join(',');
+        return this.get('/', { query: Object.keys(params).length > 0 ? params : undefined });
+    }
+    /**
+     * Validate a list of tool names. Each result reports validity, source, app provenance,
+     * and (for invalid names) a closest-match suggestion.
+     */
+    validate(names) {
+        return this.post('/validate', { payload: { names } });
+    }
+}
+//# sourceMappingURL=ToolsApi.js.map

package/lib/ToolsApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolsApi.js","sourceRoot":"","sources":["../src/ToolsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAQvE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,QAAQ;IAC1C,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,KAA6B;QAC9B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,KAAK,EAAE,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAe;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,KAAK,EAAqC,EAAE,CAAC,CAAC;IAC7F,CAAC;CACJ"}

package/lib/{types/TrainingApi.d.ts → TrainingApi.d.ts}

@@ -1,6 +1,6 @@
-import type { TrainingJob } from "@llumiverse/common";
-import { ExecutionRunRef, ListTrainingSessionsQuery, TrainingSession, TrainingSessionCreatePayload, TrainingSessionRef } from "@vertesia/common";
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import type { TrainingJob } from '@llumiverse/common';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { ExecutionRunRef, ListTrainingSessionsQuery, TrainingSession, TrainingSessionCreatePayload, TrainingSessionRef } from '@vertesia/common';
 export default class TrainingApi extends ApiTopic {
     constructor(parent: ClientBase);
     listSessions(query?: ListTrainingSessionsQuery): Promise<TrainingSessionRef[]>;
@@ -10,9 +10,9 @@ export default class TrainingApi extends ApiTopic {
     }[]>;
     createSession(payload: TrainingSessionCreatePayload): Promise<TrainingSession>;
     getSession(sessionId: string): Promise<TrainingSession>;
-    addToSession(sessionId: string, runs: string[]): Promise<any>;
+    addToSession(sessionId: string, runs: string[]): Promise<unknown>;
     listSessionRuns(sessionId: string, limit?: number, offset?: number): Promise<ExecutionRunRef[]>;
-    buildSession(sessionId: string): Promise<any>;
+    buildSession(sessionId: string): Promise<unknown>;
     getDataUrl(sessionId: string): Promise<{
         url: string;
     }>;
@@ -23,5 +23,6 @@ export default class TrainingApi extends ApiTopic {
     cancelTraining(sessionId: string): Promise<TrainingJob>;
     getTrainingJob(jobId: string): Promise<TrainingJob>;
     getAndSyncTrainingJob(jobId: string): Promise<TrainingJob>;
-    setDataset(sessionId: string, name?: string): Promise<any>;
+    setDataset(sessionId: string, name?: string): Promise<unknown>;
 }
+//# sourceMappingURL=TrainingApi.d.ts.map

package/lib/TrainingApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrainingApi.d.ts","sourceRoot":"","sources":["../src/TrainingApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,4BAA4B,EAC5B,kBAAkB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,QAAQ;gBACjC,MAAM,EAAE,UAAU;IAI9B,YAAY,CAAC,KAAK,GAAE,yBAA8B,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIlF,gBAAgB,CAAC,KAAK,GAAE,yBAA8B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAIhG,aAAa,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC;IAI9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIvD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAM,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIvF,YAAY,CAAC,SAAS,EAAE,MAAM;IAI9B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlF,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAItD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAInD,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM1D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5E"}

package/lib/TrainingApi.js

@@ -0,0 +1,51 @@
+import { ApiTopic } from '@vertesia/api-fetch-client';
+export default class TrainingApi extends ApiTopic {
+    constructor(parent) {
+        super(parent, '/api/v1/training');
+    }
+    listSessions(query = {}) {
+        return this.get('/', { query: { ...query } });
+    }
+    listSessionNames(query = {}) {
+        return this.get('/names', { query: { ...query } });
+    }
+    createSession(payload) {
+        return this.post('/', { payload });
+    }
+    getSession(sessionId) {
+        return this.get(`/${sessionId}`);
+    }
+    addToSession(sessionId, runs) {
+        return this.post(`/${sessionId}/add`, { payload: { runs } });
+    }
+    listSessionRuns(sessionId, limit = 100, offset = 0) {
+        return this.get(`/${sessionId}/runs`, { query: { limit, offset } });
+    }
+    buildSession(sessionId) {
+        return this.post(`/${sessionId}/build`);
+    }
+    getDataUrl(sessionId) {
+        return this.get(`/${sessionId}/url`);
+    }
+    getDataUploadUrl(sessionId, isResumable = false) {
+        return this.get(`/${sessionId}/upload-url`, isResumable ? { query: { resumable: 'true' } } : {});
+    }
+    startTraining(sessionId) {
+        return this.post(`/${sessionId}/start`);
+    }
+    cancelTraining(sessionId) {
+        return this.post(`/${sessionId}/cancel`);
+    }
+    getTrainingJob(jobId) {
+        return this.get(`/job/${jobId}`);
+    }
+    getAndSyncTrainingJob(jobId) {
+        return this.get(`/job/${jobId}`, {
+            query: { sync: 'true' },
+        });
+    }
+    setDataset(sessionId, name = 'default') {
+        return this.post(`/${sessionId}/dataset`, { payload: { dataset: name } });
+    }
+}
+//# sourceMappingURL=TrainingApi.js.map

package/lib/TrainingApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrainingApi.js","sourceRoot":"","sources":["../src/TrainingApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AASvE,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,QAAQ;IAC7C,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED,YAAY,CAAC,QAAmC,EAAE;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB,CAAC,QAAmC,EAAE;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,aAAa,CAAC,OAAqC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,IAAc;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,eAAe,CAAC,SAAiB,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,YAAY,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,UAAU,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB,CAAC,SAAiB,EAAE,WAAW,GAAG,KAAK;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,aAAa,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,cAAc,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,cAAc,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,qBAAqB,CAAC,KAAa;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE,EAAE;YAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC1B,CAAC,CAAC;IACP,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,OAAe,SAAS;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;CACJ"}

package/lib/{types/UsersApi.d.ts → UsersApi.d.ts}

@@ -1,8 +1,9 @@
-import { DeleteByIdResult, UpdateUserPayload, User } from '@vertesia/common';
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { DeleteByIdResult, UpdateUserPayload, User } from '@vertesia/common';
 export default class UsersApi extends ApiTopic {
     constructor(parent: ClientBase);
     retrieve(userId: string): Promise<User>;
     update(userId: string, payload: UpdateUserPayload): Promise<User>;
     delete(userId: string): Promise<DeleteByIdResult>;
 }
+//# sourceMappingURL=UsersApi.d.ts.map

package/lib/UsersApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsersApi.d.ts","sourceRoot":"","sources":["../src/UsersApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,QAAQ;gBAC9B,MAAM,EAAE,UAAU;IAI9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGpD"}

package/lib/{esm/UsersApi.js → UsersApi.js}

@@ -4,13 +4,13 @@ export default class UsersApi extends ApiTopic {
         super(parent, '/api/v1/users');
     }
     retrieve(userId) {
-        return this.get('/' + userId);
+        return this.get(`/${userId}`);
     }
     update(userId, payload) {
-        return this.put('/' + userId, { payload });
+        return this.put(`/${userId}`, { payload });
     }
     delete(userId) {
-        return this.del('/' + userId);
+        return this.del(`/${userId}`);
     }
 }
 //# sourceMappingURL=UsersApi.js.map

package/lib/UsersApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsersApi.js","sourceRoot":"","sources":["../src/UsersApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAGvE,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,QAAQ;IAC1C,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,OAA0B;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;CACJ"}

package/lib/{types/client.d.ts → client.d.ts}

@@ -1,28 +1,30 @@
-import { AbstractFetchClient } from "@vertesia/api-fetch-client";
-import { AuthTokenPayload, AuthTokenResponse } from "@vertesia/common";
-import AccountApi from "./AccountApi.js";
-import AccountsApi from "./AccountsApi.js";
-import AnalyticsApi from "./AnalyticsApi.js";
-import { ApiKeysApi } from "./ApiKeysApi.js";
-import AppsApi from "./AppsApi.js";
-import AuditTrailApi from "./AuditTrailApi.js";
-import CommandsApi from "./CommandsApi.js";
-import EnvironmentsApi from "./EnvironmentsApi.js";
-import { IamApi } from "./IamApi.js";
-import InteractionsApi from "./InteractionsApi.js";
-import OAuthClientsApi from "./OAuthClientsApi.js";
-import OAuthGrantsApi from "./OAuthGrantsApi.js";
-import OAuthProvidersApi from "./OAuthProvidersApi.js";
-import OAuthServerApi from "./OAuthServerApi.js";
-import ProjectsApi from "./ProjectsApi.js";
-import PromptsApi from "./PromptsApi.js";
-import { RefsApi } from "./RefsApi.js";
-import RemoteMcpConnectionsApi from "./RemoteMcpConnectionsApi.js";
-import { RunsApi } from "./RunsApi.js";
-import SkillsApi from "./SkillsApi.js";
-import { ZenoClient } from "./store/client.js";
-import TrainingApi from "./TrainingApi.js";
-import UsersApi from "./UsersApi.js";
+import { AbstractFetchClient, type FETCH_FN, type IRequestRetryPolicy } from '@vertesia/api-fetch-client';
+import { type AuthTokenPayload, type AuthTokenResponse } from '@vertesia/common';
+import AccountApi from './AccountApi.js';
+import AccountsApi from './AccountsApi.js';
+import AnalyticsApi from './AnalyticsApi.js';
+import { ApiKeysApi } from './ApiKeysApi.js';
+import AppsApi from './AppsApi.js';
+import AuditTrailApi from './AuditTrailApi.js';
+import CommandsApi from './CommandsApi.js';
+import EnvironmentsApi from './EnvironmentsApi.js';
+import { IamApi } from './IamApi.js';
+import InteractionsApi from './InteractionsApi.js';
+import OAuthClientsApi from './OAuthClientsApi.js';
+import OAuthGrantsApi from './OAuthGrantsApi.js';
+import OAuthProvidersApi from './OAuthProvidersApi.js';
+import OAuthServerApi from './OAuthServerApi.js';
+import ProjectsApi from './ProjectsApi.js';
+import PromptsApi from './PromptsApi.js';
+import { RefsApi } from './RefsApi.js';
+import RemoteMcpConnectionsApi from './RemoteMcpConnectionsApi.js';
+import { RunsApi } from './RunsApi.js';
+import SecretsApi from './SecretsApi.js';
+import SkillsApi from './SkillsApi.js';
+import { ZenoClient } from './store/client.js';
+import ToolsApi from './ToolsApi.js';
+import TrainingApi from './TrainingApi.js';
+import UsersApi from './UsersApi.js';
 export type VertesiaClientProps = {
     /**
      * The site name of Vertesia.
@@ -36,7 +38,7 @@ export type VertesiaClientProps = {
      * @default api.vertesia.io
      * @since 0.52.0
      */
-    site?: "api.vertesia.io" | "api-preview.vertesia.io" | "api.us1.vertesia.io" | "api-preview.us1.vertesia.io" | "api.eu1.vertesia.io" | "api-preview.eu1.vertesia.io" | "api.jp1.vertesia.io" | "api-preview.jp1.vertesia.io" | "api.dev1.vertesia.io";
+    site?: 'api.vertesia.io' | 'api-preview.vertesia.io' | 'api.us1.vertesia.io' | 'api-preview.us1.vertesia.io' | 'api.eu1.vertesia.io' | 'api-preview.eu1.vertesia.io' | 'api.jp1.vertesia.io' | 'api-preview.jp1.vertesia.io' | 'api.dev1.vertesia.io' | 'api-preview.dev1.vertesia.io';
     serverUrl?: string;
     storeUrl?: string;
     tokenServerUrl?: string;
@@ -45,6 +47,14 @@ export type VertesiaClientProps = {
     sessionTags?: string | string[];
     onRequest?: (request: Request) => void;
     onResponse?: (response: Response) => void;
+    retryPolicy?: IRequestRetryPolicy;
+    /**
+     * Default request timeout in ms applied to every request (studio + store) unless overridden
+     * per-request via `timeoutMs`. `false`/`null`/`0` disables it. Aborts the whole request
+     * (connection + headers + body) via AbortSignal — browser + Node safe.
+     */
+    timeout?: number | false | null;
+    fetch?: FETCH_FN | Promise<FETCH_FN>;
 };
 export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient> {
     /**
@@ -68,6 +78,7 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
     oauthServer: OAuthServerApi;
     oauthProviders: OAuthProvidersApi;
     remoteMcpConnections: RemoteMcpConnectionsApi;
+    secrets: SecretsApi;
     /**
      * Create a client from the given token.
      * If you already have the decoded token you can pass it as the second argument to avoid decodinf it again.
@@ -80,16 +91,25 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
         studio: string;
         store: string;
         token?: string;
+        git?: string;
     }): Promise<VertesiaClient>;
     static decodeEndpoints(): void;
     constructor(opts?: VertesiaClientProps);
     withApiVersion(version: string | number | null): this;
+    /**
+     * Pin the app version this client's requests resolve against. A generated app's UI sets this from
+     * its build-time `VITE_APP_VERSION` so studio/zeno resolve its `app:<app>:…` refs against that
+     * published version (candidate testing) instead of current. Pass null/empty to clear (→ current).
+     */
+    withAppVersion(version: string | null | undefined): this;
     /**
      * Overwrite to keep store and composable clients synchronized on the auth callback
      * @param authCb
      * @returns
      */
     withAuthCallback(authCb?: (() => Promise<string>) | null): this;
+    withRetryPolicy(policy?: IRequestRetryPolicy | null): this;
+    withTimeout(timeoutMs?: number | false | null): this;
     withApiKey(apiKey: string | null): Promise<this>;
     getRawJWT(): Promise<string | null>;
     getDecodedJWT(): Promise<AuthTokenPayload | null>;
@@ -108,6 +128,8 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
      */
     get objects(): import("./index.js").ObjectsApi;
     get files(): import("./index.js").FilesApi;
+    get processes(): import("./index.js").ProcessApi;
+    get tasks(): import("./index.js").TaskApi;
     /**
      * Alias for store.types
      */
@@ -126,7 +148,6 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
     getAuthToken(token?: string): Promise<AuthTokenResponse>;
     get initialHeaders(): {
         "x-api-version": string;
-        accept: string;
     };
     projects: ProjectsApi;
     environments: EnvironmentsApi;
@@ -145,6 +166,13 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
     refs: RefsApi;
     commands: CommandsApi;
     apps: AppsApi;
+    tools: ToolsApi;
 }
+/**
+ * Returns true when the token should be refreshed: either missing, or within
+ * EXPIRATION_THRESHOLD of its `exp` claim, or already expired. Exported for tests.
+ */
+export declare function isTokenExpired(token: string | null): boolean;
 export declare function decodeJWT(jwt: string): AuthTokenPayload;
 export declare function decodeEndpoints(endpoints: string | Record<string, string> | undefined): Record<string, string>;
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}