@vertesia/common 0.81.1 → 1.0.0-dev.20260203.130115Z

package/src/tool-execution.ts

@@ -0,0 +1,47 @@
+/**
+ * Types for tool execution payloads shared between workflows and tool servers
+ */
+
+/**
+ * Endpoint configuration that can override JWT-embedded endpoints
+ */
+export interface ToolEndpointOverrides {
+    /**
+     * Studio server URL
+     */
+    studio?: string;
+    /**
+     * Store/Zeno server URL
+     */
+    store?: string;
+    /**
+     * Token server URL
+     */
+    token?: string;
+}
+
+/**
+ * Metadata passed with tool execution requests from workflows to tool servers
+ */
+export interface ToolExecutionMetadata {
+    /**
+     * Workflow run ID
+     */
+    run_id?: string;
+    /**
+     * App installation ID
+     */
+    app_install_id?: string;
+    /**
+     * App-specific settings
+     */
+    app_settings?: Record<string, any>;
+    /**
+     * Endpoint overrides from workflow config (takes precedence over JWT endpoints)
+     */
+    endpoints?: ToolEndpointOverrides;
+    /**
+     * Additional metadata fields
+     */
+    [key: string]: any;
+}

package/src/user.ts

@@ -5,6 +5,7 @@ export interface UserWithAccounts extends User {
     accounts: AccountRef[];
 }
 
+
 export interface User {
     id: string;
     externalId: string;
@@ -19,12 +20,14 @@ export interface User {
     source?: 'firebase' | 'scim';
 }
 
+
 export interface UserRef {
     id: string;
     name: string;
     email: string;
     picture?: string;
 }
+
 export const UserRefPopulate = "id name email picture";
 
 export enum Datacenters {
@@ -33,6 +36,7 @@ export enum Datacenters {
     azure = 'azure'
 }
 
+
 export enum BillingMethod {
     stripe = 'stripe',
     invoice = 'invoice'
@@ -51,6 +55,7 @@ export interface AccountBilling {
     stripe_customer_id?: string;
 }
 
+
 export interface Account {
     id: string;
     name: string;
@@ -74,16 +79,19 @@ export interface Account {
     updated_at: string;
 }
 
+
 export interface UpdateAccountPayload {
     name?: string;
     email_domains?: string[];
     billing?: AccountBilling;
 }
 
+
 export interface AccountRef {
     id: string;
     name: string;
 }
+
 export const AccountRefPopulate = "id name";
 
 export interface InviteUserRequestPayload {
@@ -91,11 +99,13 @@ export interface InviteUserRequestPayload {
     role: ProjectRoles;
 }
 
+
 export interface InviteUserResponsePayload {
     action: 'invited' | 'added';
 }
 
 
+
 type UserOrApiKey<T extends User | ApiKey> = T extends User ? User : ApiKey;
 type SessionType<T extends User | ApiKey> = T extends User ? "user" : "apikey";
 export interface SessionInfo<T extends User | ApiKey> {
@@ -108,6 +118,7 @@ export interface SessionInfo<T extends User | ApiKey> {
     accounts: AccountRef[];
 }
 
+
 export interface UserSessionInfo extends SessionInfo<User> { }
 export interface ApiKeySessionInfo extends SessionInfo<ApiKey> { }
 
@@ -119,6 +130,7 @@ export interface OnboardingProgress {
 }
 
 
+
 /**
  * Data collected at signup
  * used for onboarding and segments
@@ -131,10 +143,11 @@ export interface SignupData {
     maturity?: string;
 }
 
+
 /**
  * Signup Payload: used to create a new user
  */
 export interface SignupPayload {
     firebaseToken: string;
     signupData: SignupData;
-}
+}