@vertesia/client 1.4.0-dev.20260615.051508Z → 1.4.0

package/README.md

@@ -41,9 +41,38 @@ const client = new VertesiaClient({
 
   // Optional session tags
   sessionTags: ["tag1", "tag2"],
+
+  // Optional default per-request HTTP timeout in milliseconds. Applies to every request
+  // made by the client (studio API + content store). Omit for no timeout; pass `false`
+  // or `0` to explicitly disable it. See "Request Timeouts" below.
+  timeout: 60_000,
 });
 ```
 
+### Request Timeouts
+
+By default the client applies no HTTP request timeout. Set a default for every request via the
+`timeout` constructor option (or `client.withTimeout(ms)` at runtime); it propagates to both the
+studio API and the content store, and to all of their sub-topics. The timeout is implemented with
+a browser-standard `AbortSignal`, so it behaves the same in the browser and in Node:
+
+```typescript
+// A 60s default for every request on this client.
+const client = new VertesiaClient({ apikey: "sk-***", timeout: 60_000 });
+
+// Change (or disable) it later.
+client.withTimeout(30_000);
+client.withTimeout(false); // no timeout
+```
+
+**Interaction execution is exempt from a short default.** A synchronous (non-streaming) interaction
+execution blocks on the server until the model finishes — and the LLM (e.g. image generation) can
+legitimately take minutes — so `client.interactions.execute(...)` / `executeByName(...)` use their
+own long per-request timeout (30 minutes by default, overridable via the
+`VERTESIA_INTERACTION_TIMEOUT_MS` env var), which overrides any shorter client default. Streaming
+executions return immediately and stream over a separate channel, so they are never given a
+total-request timeout.
+
 ### Available APIs
 
 The client provides access to several API endpoints:

package/lib/AppsApi.d.ts

@@ -1,5 +1,5 @@
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { ActivateAppVersionResponse, AppBuildProgress, AppDeleteSummary, AppInspectionResult, AppInstallation, AppInstallationKind, AppInstallationListEntry, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData, AppPackage, AppPackageScope, AppToolCollection, AppVersionListQuery, AppVersionRecord, CountResult, ProjectRef, RequireAtLeastOne, StartAppBuildRequest, StartAppBuildResponse, UpsertAppVersionRequest, ValidateUrlResponse } from '@vertesia/common';
+import type { AppInstallation, AppInstallationKind, AppInstallationListEntry, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData, AppToolCollection, CountResult, ProjectRef, RequireAtLeastOne, ValidateUrlResponse } from '@vertesia/common';
 export interface OrphanedAppInstallation extends Omit<AppInstallation, 'manifest'> {
     manifest: null;
 }
@@ -8,45 +8,17 @@ export default class AppsApi extends ApiTopic {
     create(manifest: AppManifestData): Promise<AppManifest>;
     update(id: string, manifest: AppManifestData): Promise<AppManifest>;
     /**
-     * Preview what the cascade delete would remove. Calls DELETE without confirm,
-     * which the server treats as a dry-run and returns counts + paths.
+     * Delete an app manifest by id. The owning account must permit the operation.
+     * Note: also uninstall any existing installations of this manifest before deleting,
+     * otherwise the server may refuse or leave orphaned installation records.
      */
-    previewDelete(id: string): Promise<AppDeleteSummary>;
-    /**
-     * 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>;
-    listVersions(query?: AppVersionListQuery): Promise<AppVersionRecord[]>;
-    upsertVersion(payload: UpsertAppVersionRequest): Promise<AppVersionRecord>;
-    getVersion(recordId: string): Promise<AppVersionRecord>;
-    activateVersion(recordId: string): Promise<ActivateAppVersionResponse>;
-    startBuild(appIdOrRecordId: string, payload: StartAppBuildRequest): Promise<StartAppBuildResponse>;
-    getBuildProgress(appIdOrRecordId: string, workflowId: string, runId: string): Promise<AppBuildProgress>;
+    delete(id: string): Promise<CountResult>;
     /**
      * Get the list if tools provided by the given app.
      * @param appId
      * @returns
      */
     listAppInstallationTools(appInstallId: string): Promise<AppToolCollection[]>;
-    /**
-     * 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>;
-    /**
-     * Get package capabilities exposed by an app installation.
-     */
-    getAppInstallationPackage(appInstallId: string, scope?: AppPackageScope | AppPackageScope[]): Promise<AppPackage>;
-    /**
-     * 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): Promise<AppPackage>;
     /**
      * @param ids - ids to filter by
      * @returns the app manifests but without the agent.tool property which can be big.

package/lib/AppsApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppsApi.d.ts","sourceRoot":"","sources":["../src/AppsApi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AppsApi.d.ts","sourceRoot":"","sources":["../src/AppsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAoB,MAAM,4BAA4B,CAAC;AACzF,OAAO,KAAK,EACR,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,iBAAiB,EAGjB,mBAAmB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC;IAC9E,QAAQ,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,QAAQ;gBAC7B,MAAM,EAAE,UAAU;IAI9B,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAInE;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxC;;;;OAIG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAI5E;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9B;;;OAGG;IACH,OAAO,CACH,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EAC/F,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GACxG,OAAO,CAAC,eAAe,CAAC;IAW3B;;;;OAIG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD;;;OAGG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAUtF;;;;;OAKG;IACH,0BAA0B,CACtB,GAAG,EAAE,iBAAiB,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,GAAG,MAAM,CAAC,GACtE,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBxB;;;OAGG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAQpF;;;;;;OAMG;IACH,sBAAsB,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAI7D;;OAEG;IACH,iBAAiB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI/C,0BAA0B,CAAC,eAAe,EAAE,sBAAsB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAazG;;;OAGG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAM7G;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAGzD"}

package/lib/AppsApi.js

@@ -10,45 +10,13 @@ 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.
+     * Delete an app manifest by id. The owning account must permit the operation.
+     * Note: also uninstall any existing installations of this manifest before deleting,
+     * otherwise the server may refuse or leave orphaned installation records.
      */
-    previewDelete(id) {
+    delete(id) {
         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) {
-        return this.del(`/${id}`, { query: { confirm: 'true' } });
-    }
-    listVersions(query) {
-        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) {
-        return this.post('/versions', { payload });
-    }
-    getVersion(recordId) {
-        return this.get(`/versions/${recordId}`);
-    }
-    activateVersion(recordId) {
-        return this.post(`/versions/${recordId}/activate`);
-    }
-    startBuild(appIdOrRecordId, payload) {
-        return this.post(`/${encodeURIComponent(appIdOrRecordId)}/builds`, { payload });
-    }
-    getBuildProgress(appIdOrRecordId, workflowId, runId) {
-        return this.get(`/${encodeURIComponent(appIdOrRecordId)}/builds/${encodeURIComponent(workflowId)}/${encodeURIComponent(runId)}/progress`);
-    }
     /**
      * Get the list if tools provided by the given app.
      * @param appId
@@ -57,33 +25,6 @@ export default class AppsApi extends ApiTopic {
     listAppInstallationTools(appInstallId) {
         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) {
-        return this.get(`/${appIdOrName}/inspect`);
-    }
-    /**
-     * Get package capabilities exposed by an app installation.
-     */
-    getAppInstallationPackage(appInstallId, scope = 'all') {
-        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 = 'tools') {
-        return this.get('/studio-tools/package', { query: { scope } });
-    }
     /**
      * @param ids - ids to filter by
      * @returns the app manifests but without the agent.tool property which can be big.

package/lib/AppsApi.js.map

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

package/lib/IamApi.d.ts

@@ -1,5 +1,5 @@
 import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
-import type { ACECreatePayload, ACEUpdatePayload, AccessControlEntry, AcesQueryOptions, DeleteByIdResult, PrincipalIdentity, RoleDefinition } from '@vertesia/common';
+import type { ACECreatePayload, ACEUpdatePayload, AccessControlEntry, AcesQueryOptions, DeleteByIdResult, PrincipalIdentity, RoleDefinition, SystemRoleDefinition } from '@vertesia/common';
 import { GroupsApi } from './GroupsApi.js';
 export interface FilterOption {
     id: string;
@@ -22,7 +22,14 @@ export declare class IamApi extends ApiTopic {
 }
 export declare class RolesApi extends ApiTopic {
     constructor(parent: ClientBase);
+    /** List every built-in role across all partitions. Permissions are loosely typed (`string[]`). */
     list(): Promise<RoleDefinition[]>;
+    /**
+     * List system-domain roles only. Permissions are tightly typed as `Permission[]` —
+     * suited for client-side permission gating (button visibility, route guards).
+     * ABAC roles are excluded and must be consumed via the JWT `content_security` claim.
+     */
+    listSystem(): Promise<SystemRoleDefinition[]>;
 }
 export declare class AcesApi extends ApiTopic {
     constructor(parent: ClientBase);

package/lib/IamApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IamApi.d.ts","sourceRoot":"","sources":["../src/IamApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,MAAO,SAAQ,QAAQ;gBACpB,MAAM,EAAE,UAAU;IAI9B,IAAI,UAAqB;IACzB,KAAK,WAAsB;IAC3B,MAAM,YAAuB;IAE7B;;;;;;OAMG;IACH,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAGrD;AAED,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,MAAM,EAAE,UAAU;IAI9B,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAGpC;AAED,qBAAa,OAAQ,SAAQ,QAAQ;gBACrB,MAAM,EAAE,UAAU;IAI9B;;;;;QAKI;IACJ,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI9D;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIhD;;;;QAII;IACJ,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjD,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGhD"}
+{"version":3,"file":"IamApi.d.ts","sourceRoot":"","sources":["../src/IamApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,MAAO,SAAQ,QAAQ;gBACpB,MAAM,EAAE,UAAU;IAI9B,IAAI,UAAqB;IACzB,KAAK,WAAsB;IAC3B,MAAM,YAAuB;IAE7B;;;;;;OAMG;IACH,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAGrD;AAED,qBAAa,QAAS,SAAQ,QAAQ;gBACtB,MAAM,EAAE,UAAU;IAI9B,kGAAkG;IAClG,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIjC;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAGhD;AAED,qBAAa,OAAQ,SAAQ,QAAQ;gBACrB,MAAM,EAAE,UAAU;IAI9B;;;;;QAKI;IACJ,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI9D;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIhD;;;;QAII;IACJ,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIjD,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGhD"}

package/lib/IamApi.js

@@ -22,9 +22,18 @@ export class RolesApi extends ApiTopic {
     constructor(parent) {
         super(parent, '/roles');
     }
+    /** List every built-in role across all partitions. Permissions are loosely typed (`string[]`). */
     list() {
         return this.get('/');
     }
+    /**
+     * List system-domain roles only. Permissions are tightly typed as `Permission[]` —
+     * suited for client-side permission gating (button visibility, route guards).
+     * ABAC roles are excluded and must be consumed via the JWT `content_security` claim.
+     */
+    listSystem() {
+        return this.get('/system');
+    }
 }
 export class AcesApi extends ApiTopic {
     constructor(parent) {

package/lib/IamApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"IamApi.js","sourceRoot":"","sources":["../src/IamApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAUvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ3C,MAAM,OAAO,MAAO,SAAQ,QAAQ;IAChC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,oBAAoB;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAClC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ;AAED,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IACjC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;QAKI;IACJ,IAAI,CAAC,OAAyB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;;;QAII;IACJ,QAAQ,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,OAAyB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,OAAyB;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;CACJ"}
+{"version":3,"file":"IamApi.js","sourceRoot":"","sources":["../src/IamApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAWvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ3C,MAAM,OAAO,MAAO,SAAQ,QAAQ;IAChC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B;;;;;;OAMG;IACH,oBAAoB;QAChB,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACJ;AAED,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAClC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,kGAAkG;IAClG,IAAI;QACA,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,UAAU;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACJ;AAED,MAAM,OAAO,OAAQ,SAAQ,QAAQ;IACjC,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;QAKI;IACJ,IAAI,CAAC,OAAyB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;;;QAII;IACJ,QAAQ,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,OAAyB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,OAAyB;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;CACJ"}

package/lib/RemoteMcpConnectionsApi.d.ts

@@ -6,6 +6,7 @@ export default class RemoteMcpConnectionsApi extends ApiTopic {
     getCollectionStatus(appInstallId: string, collectionId: string): Promise<OAuthAuthStatus>;
     getMetadata(appInstallId: string, collectionId: string): Promise<OAuthMetadataResponse>;
     authorize(appInstallId: string, collectionId: string): Promise<OAuthAuthorizeResponse>;
+    exchange(code: string, state: string): Promise<McpOAuthConnectResponse>;
     connect(appInstallId: string, collectionId: string): Promise<McpOAuthConnectResponse>;
     disconnect(appInstallId: string, collectionId: string): Promise<McpOAuthDisconnectResponse>;
     getCollectionToken(appInstallId: string, collectionId: string): Promise<McpOAuthTokenResponse>;

package/lib/RemoteMcpConnectionsApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteMcpConnectionsApi.d.ts","sourceRoot":"","sources":["../src/RemoteMcpConnectionsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,uBAAuB,EACvB,0BAA0B,EAE1B,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ;gBAC7C,MAAM,EAAE,UAAU;IAI9B,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI3D,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzF,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIvF,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAItF,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIrF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAI3F,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM9F,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAKjE"}
+{"version":3,"file":"RemoteMcpConnectionsApi.d.ts","sourceRoot":"","sources":["../src/RemoteMcpConnectionsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,uBAAuB,EACvB,0BAA0B,EAE1B,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EAExB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ;gBAC7C,MAAM,EAAE,UAAU;IAI9B,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI3D,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzF,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIvF,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAItF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMvE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIrF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAI3F,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM9F,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAKjE"}

package/lib/RemoteMcpConnectionsApi.js

@@ -15,6 +15,11 @@ export default class RemoteMcpConnectionsApi extends ApiTopic {
     authorize(appInstallId, collectionId) {
         return this.get(`/authorize/${appInstallId}/${collectionId}`);
     }
+    exchange(code, state) {
+        return this.post('/exchange', {
+            payload: { code, state },
+        });
+    }
     connect(appInstallId, collectionId) {
         return this.post(`/connect/${appInstallId}/${collectionId}`, {});
     }

package/lib/RemoteMcpConnectionsApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteMcpConnectionsApi.js","sourceRoot":"","sources":["../src/RemoteMcpConnectionsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAWvE,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ;IACzD,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,CAAC,YAAoB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,YAAY,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,mBAAmB,CAAC,YAAoB,EAAE,YAAoB;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,YAAoB,EAAE,YAAoB;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,YAAoB,EAAE,YAAoB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAC,YAAoB,EAAE,YAAoB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,YAAY,IAAI,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,YAAoB;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB,CAAC,YAAoB,EAAE,YAAoB;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAiC;SACxG,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,CAAC,YAAoB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAiC;SAC3E,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"RemoteMcpConnectionsApi.js","sourceRoot":"","sources":["../src/RemoteMcpConnectionsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAYvE,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ;IACzD,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,CAAC,YAAoB;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,YAAY,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,mBAAmB,CAAC,YAAoB,EAAE,YAAoB;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,YAAoB,EAAE,YAAoB;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,YAAoB,EAAE,YAAoB;QAChD,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,KAAa;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAyC;SAClE,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,YAAoB,EAAE,YAAoB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,YAAY,IAAI,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,YAAoB;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB,CAAC,YAAoB,EAAE,YAAoB;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAiC;SACxG,CAAC,CAAC;IACP,CAAC;IAED,QAAQ,CAAC,YAAoB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,EAAiC;SAC3E,CAAC,CAAC;IACP,CAAC;CACJ"}

package/lib/RunsApi.d.ts

@@ -53,7 +53,10 @@ export declare class RunsApi extends ApiTopic {
      * return FilterOption[]
      */
     filterOptions(field: string, filters: RunListingFilters): Promise<FilterOption[]>;
-    create<ResultT = unknown, ParamsT = unknown>(payload: RunCreatePayload): Promise<EnhancedExecutionRun<ResultT, ParamsT>>;
+    create<ResultT = unknown, ParamsT = unknown>(payload: RunCreatePayload, options?: {
+        timeoutMs?: number | false | null;
+        signal?: AbortSignal;
+    }): Promise<EnhancedExecutionRun<ResultT, ParamsT>>;
     /**
      * Send tool results and continues the conversation
      * @param payload

package/lib/RunsApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RunsApi.d.ts","sourceRoot":"","sources":["../src/RunsApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACR,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,wBAAwB,CAAC;AAExF,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACrC,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,YAAY,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,OAAQ,SAAQ,QAAQ;gBACrB,MAAM,EAAE,UAAU;IAI9B;;;;;QAKI;IACJ,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUpF,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMnD;;;;;QAKI;IACE,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAKjH,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAM7E;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO3E,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC7C,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAiBlD;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMxE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMxE;;;;QAII;IACJ,aAAa,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAM/E,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAM7D;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG/D"}
+{"version":3,"file":"RunsApi.d.ts","sourceRoot":"","sources":["../src/RunsApi.ts"],"names":[],"mappings":"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"}

package/lib/RunsApi.js

@@ -48,7 +48,7 @@ export class RunsApi extends ApiTopic {
         };
         return this.get(`/filter-options/${field}`, { query });
     }
-    async create(payload) {
+    async create(payload, options) {
         const sessionTags = this.client.sessionTags;
         if (sessionTags) {
             let tags = Array.isArray(sessionTags) ? sessionTags : [sessionTags];
@@ -62,6 +62,8 @@ export class RunsApi extends ApiTopic {
         }
         const r = await this.post('/', {
             payload,
+            timeoutMs: options?.timeoutMs,
+            signal: options?.signal,
         });
         return enhanceExecutionRun(r);
     }

package/lib/RunsApi.js.map

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

package/lib/ToolsApi.d.ts

@@ -7,9 +7,7 @@ import type { AggregatedTool, ListProjectToolsQuery, ValidateToolNamesResponse }
  *  - `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.
+ * This is the canonical client for tool discovery and validation.
  */
 export default class ToolsApi extends ApiTopic {
     constructor(parent: ClientBase);
@@ -27,6 +25,10 @@ export default class ToolsApi extends ApiTopic {
      * one-shot consumers (validation, CLI, agent tools) — not hot UI paths.
      */
     list(query?: ListProjectToolsQuery): Promise<AggregatedTool[]>;
+    /**
+     * List only Vertesia-provided builtin tools and system skills.
+     */
+    listBuiltins(): Promise<AggregatedTool[]>;
     /**
      * Validate a list of tool names. Each result reports validity, source, app provenance,
      * and (for invalid names) a closest-match suggestion.

package/lib/ToolsApi.d.ts.map

@@ -1 +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"}
+{"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;;;;;;;;GAQG;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;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAGhE"}

package/lib/ToolsApi.js

@@ -6,9 +6,7 @@ import { ApiTopic } from '@vertesia/api-fetch-client';
  *  - `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.
+ * This is the canonical client for tool discovery and validation.
  */
 export default class ToolsApi extends ApiTopic {
     constructor(parent) {
@@ -35,6 +33,12 @@ export default class ToolsApi extends ApiTopic {
             params.exclude = query.exclude.join(',');
         return this.get('/', { query: Object.keys(params).length > 0 ? params : undefined });
     }
+    /**
+     * List only Vertesia-provided builtin tools and system skills.
+     */
+    listBuiltins() {
+        return this.list({ sources: ['builtin'] });
+    }
     /**
      * Validate a list of tool names. Each result reports validity, source, app provenance,
      * and (for invalid names) a closest-match suggestion.

package/lib/ToolsApi.js.map

@@ -1 +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"}
+{"version":3,"file":"ToolsApi.js","sourceRoot":"","sources":["../src/ToolsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,4BAA4B,CAAC;AAQvE;;;;;;;;GAQG;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;;OAEG;IACH,YAAY;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC/C,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/client.d.ts

@@ -48,6 +48,12 @@ export type VertesiaClientProps = {
     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> {
@@ -85,7 +91,6 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
         studio: string;
         store: string;
         token?: string;
-        git?: string;
     }): Promise<VertesiaClient>;
     static decodeEndpoints(): void;
     constructor(opts?: VertesiaClientProps);
@@ -97,6 +102,7 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
      */
     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>;

package/lib/client.d.ts.map

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

package/lib/client.js

@@ -100,14 +100,17 @@ export class VertesiaClient extends AbstractFetchClient {
             this.tokenServerUrl = opts.tokenServerUrl;
         }
         else if (opts.site) {
-            // Strip -preview (preview uses the same STS as production for the same region),
-            // then replace api prefix with sts.
+            // Replace the leading api prefix with sts, preserving the env segment so each
+            // environment hits its own STS. preview/preprod run a separately versioned STS
+            // (sts-preview / sts-preprod); collapsing them onto the production sts.<region>
+            // can route to an older STS that rejects scopes the env-matched STS supports
+            // (e.g. `offline_access`).
             // Examples:
-            //   api.vertesia.io          -> sts.vertesia.io
-            //   api-preview.vertesia.io  -> sts.vertesia.io
-            //   api.us1.vertesia.io      -> sts.us1.vertesia.io
-            //   api-preview.eu1.vertesia.io -> sts.eu1.vertesia.io
-            const stsHost = opts.site.replace('api-preview.', 'api.').replace(/^api/, 'sts');
+            //   api.vertesia.io             -> sts.vertesia.io
+            //   api-preview.vertesia.io     -> sts-preview.vertesia.io
+            //   api.us1.vertesia.io         -> sts.us1.vertesia.io
+            //   api-preview.eu1.vertesia.io -> sts-preview.eu1.vertesia.io
+            const stsHost = opts.site.replace(/^api/, 'sts');
             this.tokenServerUrl = `https://${stsHost}`;
         }
         else if (opts.serverUrl || opts.storeUrl) {
@@ -116,11 +119,12 @@ export class VertesiaClient extends AbstractFetchClient {
             try {
                 const url = new URL(urlToCheck);
                 if (url.hostname.startsWith('api')) {
-                    // Strip -preview and replace api with sts.
+                    // Replace the leading api prefix with sts, preserving the env segment so
+                    // preview/preprod hit their own STS rather than production's.
                     // api.us1.vertesia.io         -> sts.us1.vertesia.io
-                    // api-preview.us1.vertesia.io -> sts.us1.vertesia.io
+                    // api-preview.us1.vertesia.io -> sts-preview.us1.vertesia.io
                     // api.vertesia.io             -> sts.vertesia.io
-                    const stsHost = url.hostname.replace('api-preview.', 'api.').replace(/^api/, 'sts');
+                    const stsHost = url.hostname.replace(/^api/, 'sts');
                     this.tokenServerUrl = `https://${stsHost}`;
                 }
                 else {
@@ -141,11 +145,15 @@ export class VertesiaClient extends AbstractFetchClient {
             onRequest: opts.onRequest,
             onResponse: opts.onResponse,
             retryPolicy: opts.retryPolicy,
+            timeout: opts.timeout,
             fetch: opts.fetch,
         });
         if (opts.retryPolicy) {
             this.withRetryPolicy(opts.retryPolicy);
         }
+        if (opts.timeout !== undefined) {
+            this.withTimeout(opts.timeout);
+        }
         if (opts.apikey) {
             void this.withApiKey(opts.apikey);
         }
@@ -181,6 +189,10 @@ export class VertesiaClient extends AbstractFetchClient {
         this.store.withRetryPolicy(policy);
         return super.withRetryPolicy(policy);
     }
+    withTimeout(timeoutMs) {
+        this.store.withTimeout(timeoutMs);
+        return super.withTimeout(timeoutMs);
+    }
     async withApiKey(apiKey) {
         return this.withAuthCallback(apiKey
             ? async () => {
@@ -377,7 +389,6 @@ function getEndpointsFromDomain(domain) {
             studio: `http://localhost:8091`,
             store: `http://localhost:8092`,
             token: getRuntimeStsUrl() ?? 'https://sts.dev1.vertesia.io',
-            git: 'https://git.dev1.vertesia.io',
         };
     }
     else {
@@ -388,7 +399,6 @@ function getEndpointsFromDomain(domain) {
             studio: url,
             store: url,
             token: url.replace('api', 'sts'),
-            git: url.replace('api', 'git'),
         };
     }
 }