@vertesia/client 0.69.0 → 0.71.0

package/src/AppsApi.ts

@@ -0,0 +1,82 @@
+import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import type { AppInstallation, AppInstallationKind, AppInstallationPayload, AppInstallationWithManifest, AppManifest, AppManifestData } from "@vertesia/common";
+
+export default class AppsApi extends ApiTopic {
+
+    constructor(parent: ClientBase) {
+        super(parent, "/api/v1/apps")
+    }
+
+    create(manifest: AppManifestData): Promise<AppManifest> {
+        return this.post('/', { payload: manifest });
+    }
+
+    update(id: string, manifest: AppManifestData): Promise<AppManifest> {
+        return this.put(`/${id}`, { payload: manifest });
+    }
+
+    /**
+     * @param ids - ids to filter by
+     * @returns the app manifests but without the agent.tool property which can be big.
+     */
+    list(): Promise<AppManifest[]> {
+        return this.get('/');
+    }
+
+    /**
+     * Install the app with the given id in the current project.
+     * @param appId - the id of the app to install
+     */
+    install(appId: string, settings?: Record<string, any>): Promise<AppInstallation> {
+        return this.post(`/install`, {
+            payload: {
+                app_id: appId,
+                settings
+            } satisfies AppInstallationPayload
+        });
+    }
+
+    /**
+     * Remove the given app from the current project.
+     * @param installationId - the id of the app installation
+     * @returns
+     */
+    uninstall(installationId: string) {
+        return this.del(`/install/${installationId}`);
+    }
+
+    /**
+     * Get the apps installed for the current authenticated project
+     * @param kind - the kind of app installations to filter by (e.g., 'agent', 'tool', etc.)
+     */
+    getInstalledApps(kind?: AppInstallationKind): Promise<AppInstallationWithManifest[]> {
+        return this.get('/installations', {
+            query: {
+                kind,
+            }
+        });
+    }
+
+
+    /**
+     * Get the apps installed for the given project.
+     * @param projectId - the id of the project to get the installed apps for
+     * @param kind - the kind of app installations to filter by (e.g., 'agent', 'tool', etc.)
+     */
+    getInstalledAppsForProject(projectId?: string, kind?: AppInstallationKind): Promise<AppInstallationWithManifest[]> {
+        return this.get(`/installations/${projectId}`, {
+            query: {
+                kind,
+            }
+        });
+    }
+
+    /**
+     * List the app installations of the current project.
+     */
+    listInstallations(): Promise<AppInstallation[]> {
+        return this.get('/installation-refs');
+    }
+
+
+}

package/src/ProjectsApi.ts

@@ -26,14 +26,6 @@ export default class ProjectsApi extends ApiTopic {
         });
     }
 
-    listPlugins(projectId: string): Promise<string[]> {
-        return this.get(`/${projectId}/plugins`);
-    }
-
-    setPlugins(projectId: string, pluginIds: string[]): Promise<{ count: number }> {
-        return this.post(`/${projectId}/plugins`, { payload: { plugins: pluginIds } });
-    }
-
     integrations: IntegrationsConfigurationApi = new IntegrationsConfigurationApi(this);
 
 }

package/src/client.ts

@@ -4,11 +4,11 @@ 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 CommandsApi from "./CommandsApi.js";
 import EnvironmentsApi from "./EnvironmentsApi.js";
 import { IamApi } from "./IamApi.js";
 import InteractionsApi from "./InteractionsApi.js";
-import PluginsApi from "./PluginsApi.js";
 import ProjectsApi from "./ProjectsApi.js";
 import PromptsApi from "./PromptsApi.js";
 import { RefsApi } from "./RefsApi.js";
@@ -62,6 +62,29 @@ export class VertesiaClient extends AbstractFetchClient<VertesiaClient> {
      */
     sessionTags?: string | string[];
 
+
+    /**
+     * 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.
+     * 
+     * @param token the raw JWT token
+     * @param payload the decoded JWT token as an AuthTokenPayload - optional
+     */
+    static async fromAuthToken(token: string, payload?: AuthTokenPayload) {
+        if (!payload) {
+            payload = decodeJWT(token);
+        }
+        const endpoints = decodeEndpoints(payload!.endpoints);
+        return await new VertesiaClient({
+            serverUrl: endpoints.studio,
+            storeUrl: endpoints.store
+        }).withApiKey(token);
+    }
+
+    static decodeEndpoints() {
+
+    }
+
     constructor(
         opts: VertesiaClientProps = {
             site: 'api.vertesia.io',
@@ -218,7 +241,7 @@ export class VertesiaClient extends AbstractFetchClient<VertesiaClient> {
     iam = new IamApi(this);
     refs = new RefsApi(this);
     commands = new CommandsApi(this);
-    plugins = new PluginsApi(this);
+    apps = new AppsApi(this);
 }
 
 function isApiKey(apiKey: string) {
@@ -236,7 +259,7 @@ function isTokenExpired(token: string | null) {
     return (currentTime <= exp * 1000 - EXPIRATION_THRESHOLD);
 }
 
-function decodeJWT(jwt: string) {
+export function decodeJWT(jwt: string): AuthTokenPayload {
     const payloadBase64 = jwt.split('.')[1];
     const decodedJson = base64UrlDecode(payloadBase64);
     return JSON.parse(decodedJson)
@@ -260,4 +283,30 @@ function base64UrlDecode(input: string): string {
     } else {
         throw new Error('No base64 decoder available');
     }
-}
+}
+
+export function decodeEndpoints(endpoints: string | Record<string, string> | undefined): Record<string, string> {
+    if (!endpoints) {
+        return getEndpointsFromDomain("api.vertesia.io")
+    }
+    if (typeof endpoints === "string") {
+        return getEndpointsFromDomain(endpoints);
+    } else {
+        return endpoints;
+    }
+}
+
+function getEndpointsFromDomain(domain: string) {
+    if (domain === "local") {
+        return {
+            studio: `http://localhost:8091`,
+            store: `http://localhost:8092`,
+        }
+    } else {
+        const url = `https://${domain}`;
+        return {
+            studio: url,
+            store: url,
+        }
+    }
+}

package/tsconfig.dist.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "composite": true,
+        "declaration": true,
+        "declarationMap": true,
+        "jsx": "react-jsx",
+        "target": "ES2022",
+        "module": "ESNext",
+        "moduleResolution": "Bundler",
+        "rootDir": "./src",
+        "outDir": "./lib"
+    },
+    "include": [
+        "src"
+    ],
+    "exclude": [
+        "**/*.test.*",
+        "**/*.spec.*"
+    ]
+}

package/lib/cjs/PluginsApi.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const api_fetch_client_1 = require("@vertesia/api-fetch-client");
-class PluginsApi extends api_fetch_client_1.ApiTopic {
-    constructor(parent) {
-        super(parent, "/api/v1/plugins");
-    }
-    create(manifest) {
-        return this.post('/', { payload: manifest });
-    }
-    update(manifest) {
-        return this.put(`/${manifest.id}`, { payload: manifest });
-    }
-    /**
-     * @param ids - ids to filter by
-     * @returns
-     */
-    list(ids) {
-        return this.get('/', {
-            query: {
-                ids: ids ? ids.join(',') : undefined,
-            }
-        });
-    }
-}
-exports.default = PluginsApi;
-//# sourceMappingURL=PluginsApi.js.map

package/lib/cjs/PluginsApi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginsApi.js","sourceRoot":"","sources":["../../src/PluginsApi.ts"],"names":[],"mappings":";;AAAA,iEAAkE;AAGlE,MAAqB,UAAW,SAAQ,2BAAQ;IAE5C,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,QAAoC;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,QAAwB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAc;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;YACjB,KAAK,EAAE;gBACH,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aACvC;SACJ,CAAC,CAAC;IACP,CAAC;CAEJ;AA1BD,6BA0BC"}

package/lib/esm/PluginsApi.js

@@ -1,24 +0,0 @@
-import { ApiTopic } from "@vertesia/api-fetch-client";
-export default class PluginsApi extends ApiTopic {
-    constructor(parent) {
-        super(parent, "/api/v1/plugins");
-    }
-    create(manifest) {
-        return this.post('/', { payload: manifest });
-    }
-    update(manifest) {
-        return this.put(`/${manifest.id}`, { payload: manifest });
-    }
-    /**
-     * @param ids - ids to filter by
-     * @returns
-     */
-    list(ids) {
-        return this.get('/', {
-            query: {
-                ids: ids ? ids.join(',') : undefined,
-            }
-        });
-    }
-}
-//# sourceMappingURL=PluginsApi.js.map

package/lib/esm/PluginsApi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginsApi.js","sourceRoot":"","sources":["../../src/PluginsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAGlE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,QAAQ;IAE5C,YAAY,MAAkB;QAC1B,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,QAAoC;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,QAAwB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAc;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;YACjB,KAAK,EAAE;gBACH,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;aACvC;SACJ,CAAC,CAAC;IACP,CAAC;CAEJ"}

package/lib/types/PluginsApi.d.ts

@@ -1,12 +0,0 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import type { PluginManifest } from "@vertesia/common";
-export default class PluginsApi extends ApiTopic {
-    constructor(parent: ClientBase);
-    create(manifest: Omit<PluginManifest, 'id'>): Promise<PluginManifest>;
-    update(manifest: PluginManifest): Promise<any>;
-    /**
-     * @param ids - ids to filter by
-     * @returns
-     */
-    list(ids?: string[]): Promise<PluginManifest[]>;
-}

package/lib/types/PluginsApi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginsApi.d.ts","sourceRoot":"","sources":["../../src/PluginsApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,QAAQ;gBAEhC,MAAM,EAAE,UAAU;IAI9B,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAIrE,MAAM,CAAC,QAAQ,EAAE,cAAc;IAI/B;;;OAGG;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAQlD"}

package/src/PluginsApi.ts

@@ -1,30 +0,0 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import type { PluginManifest } from "@vertesia/common";
-
-export default class PluginsApi extends ApiTopic {
-
-    constructor(parent: ClientBase) {
-        super(parent, "/api/v1/plugins")
-    }
-
-    create(manifest: Omit<PluginManifest, 'id'>): Promise<PluginManifest> {
-        return this.post('/', { payload: manifest });
-    }
-
-    update(manifest: PluginManifest) {
-        return this.put(`/${manifest.id}`, { payload: manifest });
-    }
-
-    /**
-     * @param ids - ids to filter by
-     * @returns
-     */
-    list(ids?: string[]): Promise<PluginManifest[]> {
-        return this.get('/', {
-            query: {
-                ids: ids ? ids.join(',') : undefined,
-            }
-        });
-    }
-
-}