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

package/src/OAuthGrantsApi.ts

@@ -1,4 +1,4 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     BulkRevokeOAuthGrantsPayload,
     ListOAuthGrantsQuery,

package/src/OAuthProvidersApi.ts

@@ -1,16 +1,15 @@
-import { ApiTopic, ClientBase } from '@vertesia/api-fetch-client';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     CreateOAuthProviderPayload,
-    OAuthProviderAccessTokenResponse,
     OAuthProvider,
-    OAuthProviderAuthStatus,
+    OAuthProviderAccessTokenResponse,
     OAuthProviderAuthorizeResponse,
+    OAuthProviderAuthStatus,
     SuccessResponse,
     UpdateOAuthProviderPayload,
 } from '@vertesia/common';
 
 export default class OAuthProvidersApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
         super(parent, '/api/v1/oauth-providers');
     }

package/src/OAuthServerApi.ts

@@ -1,26 +1,73 @@
-import { ApiTopic } from '@vertesia/api-fetch-client';
+import { ClientBase, type IRequestParamsWithPayload } from '@vertesia/api-fetch-client';
 import type {
     ApproveOAuthAuthorizationRequestPayload,
     CreateOAuthAuthorizationRequestPayload,
     OAuthAuthorizationDecisionResponse,
     OAuthAuthorizationRequest,
+    OAuthDeviceAuthorizationRequest,
+    OAuthDeviceAuthorizationResponse,
+    OAuthGrantableScopesResponse,
 } from '@vertesia/common';
-import type { ClientBase } from '@vertesia/api-fetch-client';
 
-export default class OAuthServerApi extends ApiTopic {
-    constructor(parent: ClientBase) {
-        super(parent, '/oauth');
+export default class OAuthServerApi extends ClientBase {
+    constructor(
+        private readonly parent: ClientBase,
+        baseUrl?: string,
+    ) {
+        super(new URL('/oauth', `${baseUrl || parent.baseUrl}/`).toString(), parent._fetch);
+        this.createServerError = parent.createServerError;
+        this.errorFactory = parent.errorFactory;
+        this.verboseErrors = parent.verboseErrors;
+    }
+
+    get headers() {
+        return this.parent.headers;
+    }
+
+    createRequest(url: string, init: RequestInit): Promise<Request> {
+        return this.parent.createRequest(url, init);
+    }
+
+    handleResponse<T = unknown>(
+        req: Request,
+        res: Response,
+        params: IRequestParamsWithPayload | undefined,
+    ): T | Promise<T> {
+        return this.parent.handleResponse<T>(req, res, params);
+    }
+
+    handleFetchResponse(req: Request, res: Response): void {
+        this.parent.handleFetchResponse(req, res);
+    }
+
+    getRetryPolicy() {
+        return this.parent.getRetryPolicy();
     }
 
     createAuthorizationRequest(payload: CreateOAuthAuthorizationRequestPayload): Promise<OAuthAuthorizationRequest> {
         return this.post('/requests', { payload });
     }
 
+    createDeviceAuthorization(payload: OAuthDeviceAuthorizationRequest): Promise<OAuthDeviceAuthorizationResponse> {
+        return this.post('/device_authorization', { payload });
+    }
+
+    retrieveDeviceRequest(userCode: string): Promise<OAuthAuthorizationRequest> {
+        return this.get(`/device/${encodeURIComponent(userCode)}`);
+    }
+
     retrieveRequest(requestId: string): Promise<OAuthAuthorizationRequest> {
         return this.get(`/requests/${requestId}`);
     }
 
-    approveRequest(requestId: string, payload: ApproveOAuthAuthorizationRequestPayload): Promise<OAuthAuthorizationDecisionResponse> {
+    retrieveGrantableScopes(requestId: string, projectId: string): Promise<OAuthGrantableScopesResponse> {
+        return this.get(`/requests/${requestId}/grantable-scopes`, { query: { project_id: projectId } });
+    }
+
+    approveRequest(
+        requestId: string,
+        payload: ApproveOAuthAuthorizationRequestPayload,
+    ): Promise<OAuthAuthorizationDecisionResponse> {
         return this.post(`/requests/${requestId}/approve`, { payload });
     }
 

package/src/ProjectsApi.ts

@@ -1,9 +1,31 @@
-import { ApiTopic, ClientBase, ServerError } from "@vertesia/api-fetch-client";
-import { AwsConfiguration, CompositeAppConfig, CompositeAppConfigPayload, CountResult, DeleteByIdResult, ExaConfiguration, GithubConfiguration, GladiaConfiguration, ICreateProjectPayload, InCodeTypeDefinition, LinkupConfiguration, MagicPdfConfiguration, Project, ProjectConfiguration, ProjectIntegrationListEntry, ProjectIntegrationListResponse, ProjectRef, ProjectToolInfo, RenderingTemplateDefinition, RenderingTemplateDefinitionRef, ResendConfiguration, SerperConfiguration, SupportedIntegrations } from "@vertesia/common";
+import { ApiTopic, type ClientBase, type ServerError } from '@vertesia/api-fetch-client';
+import type {
+    CompositeAppConfig,
+    CompositeAppConfigPayload,
+    CountResult,
+    DeleteByIdResult,
+    ICreateProjectPayload,
+    InCodeProcessDefinition,
+    InCodeTypeDefinition,
+    Project,
+    ProjectConfiguration,
+    ProjectIntegrationConfigRequest,
+    ProjectIntegrationConfigResponse,
+    ProjectIntegrationListEntry,
+    ProjectIntegrationListResponse,
+    ProjectRef,
+    ProjectToolInfo,
+    RenderingTemplateDefinition,
+    RenderingTemplateDefinitionRef,
+    SupportedIntegrations,
+} from '@vertesia/common';
 
 export default class ProjectsApi extends ApiTopic {
+    integrations: IntegrationsConfigurationApi;
+
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/projects");
+        super(parent, '/api/v1/projects');
+        this.integrations = new IntegrationsConfigurationApi(this);
     }
 
     list(account?: string[]): Promise<ProjectRef[]> {
@@ -16,13 +38,13 @@ export default class ProjectsApi extends ApiTopic {
 
     create(payload: ICreateProjectPayload): Promise<Project> {
         return this.post('/', {
-            payload
+            payload,
         });
     }
 
     update(projectId: string, payload: Partial<Project>): Promise<Project> {
         return this.put(`/${projectId}`, {
-            payload
+            payload,
         });
     }
 
@@ -32,12 +54,10 @@ export default class ProjectsApi extends ApiTopic {
 
     updateConfiguration(projectId: string, payload: Partial<ProjectConfiguration>): Promise<ProjectConfiguration> {
         return this.put(`/${projectId}/configuration`, {
-            payload
+            payload,
         });
     }
 
-    integrations: IntegrationsConfigurationApi = new IntegrationsConfigurationApi(this);
-
     /**
      * List all tools available in the project with their app installation info.
      * Settings are only included for agent tokens (security: may contain API keys).
@@ -51,7 +71,7 @@ export default class ProjectsApi extends ApiTopic {
      * Returns null if the tool is not found.
      */
     getToolByName(projectId: string, toolName: string): Promise<ProjectToolInfo | null> {
-        return this.get(`/${projectId}/tools/${toolName}`).catch((err: ServerError) => {
+        return this.get<ProjectToolInfo>(`/${projectId}/tools/${toolName}`).catch((err: ServerError) => {
             if (err.status === 404) {
                 return null;
             }
@@ -61,7 +81,7 @@ export default class ProjectsApi extends ApiTopic {
 
     listAppContentTypes(projectId: string, tag?: string): Promise<InCodeTypeDefinition[]> {
         return this.get(`/${projectId}/app-types`, {
-            query: { tag }
+            query: { tag },
         });
     }
 
@@ -69,9 +89,19 @@ export default class ProjectsApi extends ApiTopic {
         return this.get(`/${projectId}/app-types/${typeId}`);
     }
 
+    listAppProcesses(projectId: string, tag?: string): Promise<InCodeProcessDefinition[]> {
+        return this.get(`/${projectId}/app-processes`, {
+            query: { tag },
+        });
+    }
+
+    getAppProcess(projectId: string, processId: string): Promise<InCodeProcessDefinition> {
+        return this.get(`/${projectId}/app-processes/${processId}`);
+    }
+
     listAppRenderingTemplates(projectId: string, tag?: string): Promise<RenderingTemplateDefinitionRef[]> {
         return this.get(`/${projectId}/app-templates`, {
-            query: { tag }
+            query: { tag },
         });
     }
 
@@ -83,36 +113,46 @@ export default class ProjectsApi extends ApiTopic {
         return this.get(`/${projectId}/composite-app`);
     }
 
-    updateCompositeAppConfiguration(projectId: string, payload: CompositeAppConfigPayload): Promise<CompositeAppConfig> {
+    updateCompositeAppConfiguration(
+        projectId: string,
+        payload: CompositeAppConfigPayload,
+    ): Promise<CompositeAppConfig> {
         return this.put(`/${projectId}/composite-app`, {
-            payload
+            payload,
         });
     }
-
 }
 
 class IntegrationsConfigurationApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/");
+        super(parent, '/');
     }
 
     list(projectId: string): Promise<ProjectIntegrationListEntry[]> {
-        return this.get(`/${projectId}/integrations`).then((res: ProjectIntegrationListResponse) => res.integrations);
-    }
-
-    retrieve(projectId: string, integrationId: SupportedIntegrations): Promise<GladiaConfiguration | GithubConfiguration | AwsConfiguration | MagicPdfConfiguration | SerperConfiguration | ExaConfiguration | LinkupConfiguration | ResendConfiguration | undefined> {
-        return this.get(`/${projectId}/integrations/${integrationId}`).catch(err => {
-            if (err.status === 404) {
-                return undefined;
-            }
-            throw err;
-        });
-    }
-
-    update(projectId: string, integrationId: string, payload: any): Promise<GladiaConfiguration | GithubConfiguration> {
+        return this.get<ProjectIntegrationListResponse>(`/${projectId}/integrations`).then((res) => res.integrations);
+    }
+
+    retrieve(
+        projectId: string,
+        integrationId: SupportedIntegrations,
+    ): Promise<ProjectIntegrationConfigResponse | undefined> {
+        return this.get<ProjectIntegrationConfigResponse>(`/${projectId}/integrations/${integrationId}`).catch(
+            (err) => {
+                if (err.status === 404) {
+                    return undefined;
+                }
+                throw err;
+            },
+        );
+    }
+
+    update(
+        projectId: string,
+        integrationId: string,
+        payload: ProjectIntegrationConfigRequest,
+    ): Promise<ProjectIntegrationConfigResponse> {
         return this.put(`/${projectId}/integrations/${integrationId}`, {
-            payload
+            payload,
         });
     }
 
@@ -123,5 +163,4 @@ class IntegrationsConfigurationApi extends ApiTopic {
     listPlugins(projectId: string): Promise<string[]> {
         return this.get(`/${projectId}/plugins`);
     }
-
 }

package/src/PromptsApi.ts

@@ -1,14 +1,33 @@
-import { ComputePromptFacetPayload, PromptSearchPayload, PromptSearchQuery, PromptTemplate, PromptTemplateForkPayload, PromptTemplateCreatePayload, PromptTemplateRef, PromptTemplateUpdatePayload } from "@vertesia/common";
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import type { PromptRole } from '@llumiverse/common';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
+    ComputePromptFacetPayload,
+    PromptSearchPayload,
+    PromptSearchQuery,
+    PromptTemplate,
+    PromptTemplateCreatePayload,
+    PromptTemplateForkPayload,
+    PromptTemplateRef,
+    PromptTemplateUpdatePayload,
+    TemplateType,
+} from '@vertesia/common';
 
 export interface ComputePromptFacetsResponse {
-    role?: { _id: string, count: number }[];
+    role?: { _id: string; count: number }[];
     total?: { count: number }[];
 }
 
+export interface PromptRenderResponse {
+    id: string;
+    name: string;
+    role: PromptRole;
+    content_type: TemplateType;
+    rendered: string;
+}
+
 export default class PromptsApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/prompts")
+        super(parent, '/api/v1/prompts');
     }
 
     /**
@@ -17,12 +36,12 @@ export default class PromptsApi extends ApiTopic {
      * @returns PromptTemplateRef[]
      **/
     list(payload: PromptSearchPayload = {}): Promise<PromptTemplateRef[]> {
-        const query = payload.query || {} as PromptSearchQuery;
+        const query = payload.query || ({} as PromptSearchQuery);
 
-        return this.get("/", {
+        return this.get('/', {
             query: {
-                ...query
-            }
+                ...query,
+            },
         });
     }
 
@@ -32,8 +51,8 @@ export default class PromptsApi extends ApiTopic {
      * @returns ComputePromptFacetsResponse[]
      **/
     computeFacets(query: ComputePromptFacetPayload): Promise<ComputePromptFacetsResponse> {
-        return this.post("/facets", {
-            payload: query
+        return this.post('/facets', {
+            payload: query,
         });
     }
 
@@ -47,7 +66,7 @@ export default class PromptsApi extends ApiTopic {
      **/
     create(payload: PromptTemplateCreatePayload): Promise<PromptTemplate> {
         return this.post('/', {
-            payload
+            payload,
         });
     }
 
@@ -72,7 +91,7 @@ export default class PromptsApi extends ApiTopic {
      **/
     update(id: string, payload: PromptTemplateUpdatePayload): Promise<PromptTemplate> {
         return this.put(`/${id}`, {
-            payload
+            payload,
         });
     }
 
@@ -93,24 +112,22 @@ export default class PromptsApi extends ApiTopic {
      */
     fork(id: string, payload: PromptTemplateForkPayload): Promise<PromptTemplate> {
         return this.post(`/${id}/fork`, {
-            payload
+            payload,
         });
     }
 
-    //TODO - Does this exist?
     /**
-     * Render a prompt template
+     * Render a prompt template with the given variables.
      * @param id of the prompt template to render
-     * @param payload that will be passed to the prompt template to generate the prompts
-     * @returns PromptTemplate
+     * @param payload variables to apply to the template
+     * @returns { id, name, role, content_type, rendered }
      * @throws ApiError
      * @throws 404 if not found
-     * @throws 400 if payload is invalid
-     * @throws 500 if render fails
-     **/
-    render(id: string, payload: object): Promise<PromptTemplate> {
+     * @throws 403 if the prompt is not in the current project
+     */
+    render(id: string, payload: object): Promise<PromptRenderResponse> {
         return this.post(`/${id}/render`, {
-            payload
+            payload,
         });
     }
 
@@ -133,7 +150,6 @@ export default class PromptsApi extends ApiTopic {
         return this.get(`/${id}/versions`);
     }
 
-
     /**
      * Retrieve list of interactions that use the prompt template
      */
@@ -149,14 +165,13 @@ export default class PromptsApi extends ApiTopic {
     listForks(id: string): Promise<PromptTemplateRef[]> {
         return this.get(`/${id}/forks`);
     }
-
 }
 
 export interface ListInteractionsResponse {
-    prompt: string,
+    prompt: string;
     interactions: {
-        id: string,
-        name: string,
-        versions: string[],
-    }[]
+        id: string;
+        name: string;
+        versions: string[];
+    }[];
 }

package/src/RefsApi.ts

@@ -1,18 +1,12 @@
-import { ResolvableRef, ResourceRef } from "@vertesia/common"
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client"
-
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type { ResolvableRef, ResourceRef } from '@vertesia/common';
 
 export class RefsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/refs")
+        super(parent, '/api/v1/refs');
     }
 
-
     resolve(refs: ResolvableRef[]): Promise<ResourceRef[]> {
-
-        return this.post('/resolve', { payload: { refs } })
-
+        return this.post('/resolve', { payload: { refs } });
     }
-
 }

package/src/RemoteMcpConnectionsApi.ts

@@ -1,18 +1,17 @@
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
 import type {
     McpOAuthConnectResponse,
     McpOAuthDisconnectResponse,
     McpOAuthTokenRequest,
     McpOAuthTokenResponse,
-    OAuthAuthStatus,
     OAuthAuthorizeResponse,
-    OAuthMetadataResponse
-} from "@vertesia/common";
+    OAuthAuthStatus,
+    OAuthMetadataResponse,
+} from '@vertesia/common';
 
 export default class RemoteMcpConnectionsApi extends ApiTopic {
-
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/remote-mcp-connections");
+        super(parent, '/api/v1/remote-mcp-connections');
     }
 
     getStatus(appInstallId: string): Promise<OAuthAuthStatus[]> {
@@ -47,7 +46,7 @@ export default class RemoteMcpConnectionsApi extends ApiTopic {
 
     getToken(mcpServerUrl: string): Promise<McpOAuthTokenResponse> {
         return this.post('/token', {
-            payload: { mcp_server_url: mcpServerUrl } satisfies McpOAuthTokenRequest
+            payload: { mcp_server_url: mcpServerUrl } satisfies McpOAuthTokenRequest,
         });
     }
 }

package/src/RunsApi.ts

@@ -1,22 +1,22 @@
-import type { ExecutionResponse } from "@llumiverse/common";
-import { ApiTopic, ClientBase } from "@vertesia/api-fetch-client";
-import {
+import type { ExecutionResponse } from '@llumiverse/common';
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
     ComputeRunFacetPayload,
     ExecutionRun,
+    ExecutionRunDocRef,
     ExecutionRunRef,
     FindPayload,
     PopulatedExecutionRun,
-    RunCreatePayload,
-    ExecutionRunDocRef,
     RunClonePayload,
+    RunCreatePayload,
     RunListingFilters,
     RunListingQueryOptions,
     RunSearchPayload,
     ToolResultsPayload,
     UserMessagePayload,
-} from "@vertesia/common";
-import { VertesiaClient } from "./client.js";
-import { EnhancedExecutionRun, enhanceExecutionRun } from "./InteractionOutput.js";
+} from '@vertesia/common';
+import type { VertesiaClient } from './client.js';
+import { type EnhancedExecutionRun, enhanceExecutionRun } from './InteractionOutput.js';
 
 export interface FilterOption {
     id: string;
@@ -35,7 +35,7 @@ export interface ComputeRunFacetsResponse {
 
 export class RunsApi extends ApiTopic {
     constructor(parent: ClientBase) {
-        super(parent, "/api/v1/runs");
+        super(parent, '/api/v1/runs');
     }
 
     /**
@@ -51,11 +51,11 @@ export class RunsApi extends ApiTopic {
             ...filters,
         };
 
-        return this.get("/", { query: query });
+        return this.get('/', { query: query });
     }
 
     find(payload: FindPayload): Promise<ExecutionRun[]> {
-        return this.post("/find", {
+        return this.post('/find', {
             payload,
         });
     }
@@ -66,14 +66,14 @@ export class RunsApi extends ApiTopic {
      * @param id
      * @returns InteractionResult
      **/
-    async retrieve<ResultT = any, ParamsT = any>(id: string): Promise<EnhancedExecutionRun<ResultT, ParamsT>> {
-        const r = await this.get("/" + id);
+    async retrieve<ResultT = unknown, ParamsT = unknown>(id: string): Promise<EnhancedExecutionRun<ResultT, ParamsT>> {
+        const r = await this.get<ExecutionRun<ParamsT>>(`/${id}`);
         return enhanceExecutionRun<ResultT, ParamsT>(r);
     }
 
-    retrievePopulated<P = any>(id: string): Promise<PopulatedExecutionRun<P>> {
-        return this.get("/" + id, {
-            query: { populate: "true" },
+    retrievePopulated<P = unknown>(id: string): Promise<PopulatedExecutionRun<P>> {
+        return this.get(`/${id}`, {
+            query: { populate: 'true' },
         });
     }
 
@@ -88,7 +88,9 @@ export class RunsApi extends ApiTopic {
         return this.get(`/filter-options/${field}`, { query });
     }
 
-    async create<ResultT = any, ParamsT = any>(payload: RunCreatePayload): Promise<EnhancedExecutionRun<ResultT, ParamsT>> {
+    async create<ResultT = unknown, ParamsT = unknown>(
+        payload: RunCreatePayload,
+    ): Promise<EnhancedExecutionRun<ResultT, ParamsT>> {
         const sessionTags = (this.client as VertesiaClient).sessionTags;
         if (sessionTags) {
             let tags = Array.isArray(sessionTags) ? sessionTags : [sessionTags];
@@ -99,7 +101,7 @@ export class RunsApi extends ApiTopic {
             }
             payload = { ...payload, tags };
         }
-        const r = await this.post("/", {
+        const r = await this.post<ExecutionRun<ParamsT>>('/', {
             payload,
         });
         return enhanceExecutionRun<ResultT, ParamsT>(r);
@@ -133,13 +135,13 @@ export class RunsApi extends ApiTopic {
      * @returns ComputeRunFacetsResponse[]
      **/
     computeFacets(query: ComputeRunFacetPayload): Promise<ComputeRunFacetsResponse> {
-        return this.post("/facets", {
+        return this.post('/facets', {
             payload: query,
         });
     }
 
     search(payload: RunSearchPayload): Promise<ExecutionRunRef[]> {
-        return this.post("/search", {
+        return this.post('/search', {
             payload,
         });
     }

package/src/SecretsApi.ts

@@ -0,0 +1,56 @@
+import { ApiTopic, type ClientBase } from '@vertesia/api-fetch-client';
+import type {
+    CreateSecretRequest,
+    ListSecretsQuery,
+    SecretKind,
+    SecretRecord,
+    UpdateSecretRequest,
+    WebsiteCredentialFillRequest,
+    WebsiteCredentialFillResponse,
+} from '@vertesia/common';
+
+export default class SecretsApi extends ApiTopic {
+    constructor(parent: ClientBase) {
+        super(parent, '/api/v1/secrets');
+    }
+
+    list(projectId: string, query?: Omit<ListSecretsQuery, 'project_id'>): Promise<SecretRecord[]> {
+        return this.get<{ secrets: SecretRecord[] }>('/', { query: { ...query, project_id: projectId } }).then(
+            (res) => res.secrets,
+        );
+    }
+
+    retrieve(projectId: string, secretId: string, query?: { kind?: SecretKind }): Promise<SecretRecord | undefined> {
+        return this.get<SecretRecord>(`/${secretId}`, { query: { ...query, project_id: projectId } }).catch((err) => {
+            if (err.status === 404) {
+                return undefined;
+            }
+            throw err;
+        });
+    }
+
+    create(projectId: string, payload: CreateSecretRequest): Promise<SecretRecord> {
+        return this.post('/', { query: { project_id: projectId }, payload });
+    }
+
+    update(
+        projectId: string,
+        secretId: string,
+        payload: UpdateSecretRequest,
+        query?: { kind?: SecretKind },
+    ): Promise<SecretRecord> {
+        return this.put(`/${secretId}`, { query: { ...query, project_id: projectId }, payload });
+    }
+
+    remove(projectId: string, secretId: string, query?: { kind?: SecretKind }): Promise<void> {
+        return this.del(`/${secretId}`, { query: { ...query, project_id: projectId } });
+    }
+
+    fillWebsiteCredential(
+        projectId: string,
+        secretId: string,
+        payload: WebsiteCredentialFillRequest,
+    ): Promise<WebsiteCredentialFillResponse> {
+        return this.post(`/${secretId}/actions/fill-browser`, { query: { project_id: projectId }, payload });
+    }
+}