@vertesia/common 0.24.0-dev.202601221707

package/lib/types/apikey.d.ts

@@ -0,0 +1,98 @@
+import { UserGroupRef } from "./group.js";
+import { ProjectRef, ProjectRoles } from "./project.js";
+import { AccountRef } from "./user.js";
+export declare enum ApiKeyTypes {
+    secret = "sk"
+}
+export interface ApiKey {
+    id: string;
+    name: string;
+    type: ApiKeyTypes;
+    role: ProjectRoles;
+    maskedValue?: string;
+    account: string;
+    project: ProjectRef;
+    enabled: boolean;
+    created_by: string;
+    updated_by: string;
+    created_at: Date;
+    updated_at: Date;
+    expires_at?: Date;
+}
+export interface CreateOrUpdateApiKeyPayload extends Partial<ApiKey> {
+}
+export interface ApiKeyWithValue extends Omit<ApiKey, "maskedValue"> {
+    value: string;
+}
+export interface CreatePublicKeyPayload {
+    name?: string;
+    projectId?: string;
+    ttl?: number;
+}
+export interface AuthTokenResponse {
+    token: string;
+}
+export interface AuthTokenPayload {
+    sub: string;
+    name: string;
+    email?: string;
+    picture?: string;
+    type: PrincipalType;
+    account: AccountRef;
+    account_roles: ProjectRoles[];
+    accounts: AccountRef[];
+    project?: ProjectRef;
+    project_roles?: ProjectRoles[];
+    /**
+     * The app names enabled for this token. Defaults to an empty array if no apps are enabled.
+     */
+    apps: string[];
+    /**
+     * The user ID (if any) attached to the token.
+     * This is set when the token is a user token or an agent token running as a user.
+     * Not set for impersonating tokens like project tokens.
+     */
+    user_id?: string;
+    /** groups */
+    groups?: UserGroupRef[];
+    /**
+     * API endpoints information to be used with this token.
+     * Either a n API domain like 'api.vertesia.io' | 'api-preview.vertesia.io' | 'api-staging.vertesia.io' | 'local'
+     * or explicit studio, store, and token URLs.
+     */
+    endpoints?: string | {
+        studio: string;
+        store: string;
+        token?: string;
+    };
+    iss: string;
+    aud: string;
+    exp: number;
+    tags?: string[];
+    permissions?: string[];
+    scopes?: string[];
+    /**
+     * Service caller information for agent and service account tokens.
+     * Contains audit information about who/what initiated the token request.
+     * For agent tokens, includes `onBehalfOf` with the original user's token payload.
+     */
+    service_caller?: {
+        /** The principal that requested the token (e.g., service account identity) */
+        id?: string;
+        name?: string;
+        email?: string;
+        /**
+         * For agent tokens: the verified token payload of the user/apikey the agent acts on behalf of.
+         * Contains the original user's name, email, picture, user_id, etc.
+         */
+        onBehalfOf?: AuthTokenPayload;
+        [key: string]: unknown;
+    };
+}
+export declare enum PrincipalType {
+    User = "user",
+    Group = "group",
+    ApiKey = "apikey",
+    ServiceAccount = "service_account",
+    Agent = "agent"
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"apikey.d.ts","sourceRoot":"","sources":["../../src/apikey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,oBAAY,WAAW;IACnB,MAAM,OAAO;CAChB;AACD,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,2BAA4B,SAAQ,OAAO,CAAC,MAAM,CAAC;CAAG;AAEvE,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IAEpB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,EAAE,UAAU,EAAE,CAAC;IAEvB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAE/B;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,aAAa;IACb,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IAExB;;;;OAIG;IACH,SAAS,CAAC,EACJ,MAAM,GACN;QACI,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAER,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;;OAIG;IACH,cAAc,CAAC,EAAE;QACb,8EAA8E;QAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf;;;WAGG;QACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KAC1B,CAAC;CACL;AAED,oBAAY,aAAa;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,cAAc,oBAAoB;IAClC,KAAK,UAAU;CAClB"}

package/lib/types/apps.d.ts

@@ -0,0 +1,236 @@
+import { JSONSchema } from "@llumiverse/common";
+export interface AppUIConfig {
+    /**
+     * The source URL of the app. The src can be a template which contain
+     * a variable named `buildId` which will be replaced with the current build id.
+     * For example: `/plugins/vertesia-review-center-${buildId}`
+     */
+    src: string;
+    /**
+     * The isolation strategy. If not specified it defaults to shadow
+     * - shadow - use Shadow DOM to fully isolate the plugin from the host.
+     * - css - use CSS processing (like prefixing or other isolation techniques). Ligther but plugins may conflict with the host
+     */
+    isolation?: "shadow" | "css";
+}
+/**
+ * Authentication type for tool collections
+ */
+export type ToolCollectionAuthType = "oauth" | "other";
+/**
+ * Tool collection type
+ */
+export type ToolCollectionType = "mcp" | "vertesia_sdk";
+/**
+ * Base tool collection configuration
+ */
+interface BaseToolCollectionObject {
+    /**
+     * The URL endpoint for the tool collection
+     */
+    url: string;
+    /**
+     * Optional authentication type required for this tool collection
+     */
+    auth?: ToolCollectionAuthType;
+}
+/**
+ * MCP tool collection configuration (requires name, description, and namespace)
+ */
+export interface MCPToolCollectionObject extends BaseToolCollectionObject {
+    type: "mcp";
+    /**
+     * Name for the tool collection.
+     * Used as an identifier for the collection (e.g., for OAuth authentication).
+     */
+    name: string;
+    /**
+     * Description for the tool collection.
+     * Helps users understand what tools this collection provides.
+     */
+    description: string;
+    /**
+     * Prefix to use for tool names from this collection.
+     * Provides clean, readable tool names (e.g., "jira" instead of "https://mcp.atlassian.com/v1/mcp")
+     */
+    namespace: string;
+}
+/**
+ * Vertesia SDK tool collection configuration
+ */
+export interface VertesiaSDKToolCollectionObject extends BaseToolCollectionObject {
+    type: "vertesia_sdk";
+    /**
+     * Optional namespace to use for tool names from this collection.
+     * If not provided, the tool server default will be used.
+     */
+    namespace?: string;
+    /**
+     * Optional name for the tool collection.
+     * If not provided, the tool server default will be used.
+     */
+    name?: string;
+    /**
+     * Optional description for the tool collection.
+     * If not provided, the tool server default will be used.
+     */
+    description?: string;
+}
+/**
+ * Tool collection configuration (object format)
+ */
+export type ToolCollectionObject = MCPToolCollectionObject | VertesiaSDKToolCollectionObject;
+/**
+ * Tool collection can be either:
+ * - A string URL (legacy format, with "mcp:" prefix for MCP servers)
+ * - An object with url, type, and optional auth (new format)
+ */
+export type ToolCollection = string | ToolCollectionObject;
+/**
+ * Normalizes a tool collection to the object format.
+ * Handles backward compatibility with string URLs.
+ *
+ * @param collection - String URL or ToolCollectionObject
+ * @returns Normalized ToolCollectionObject
+ */
+export declare function normalizeToolCollection(collection: ToolCollection): ToolCollectionObject;
+export interface AppManifestData {
+    /**
+     * The name of the app, used as the id in the system.
+     * Must be in kebab case (e.g. my-app).
+     */
+    name: string;
+    /**
+     * Visibility level of the app:
+     * - "public": visible to all accounts
+     * - "private": visible only to the owning account
+     * - "vertesia": visible only to Vertesia team members (any project)
+     */
+    visibility: "public" | "private" | "vertesia";
+    title: string;
+    description: string;
+    publisher: string;
+    /**
+     * A svg icon for the app.
+     */
+    icon?: string;
+    /**
+     * A color name to be used as the color of the app card (e.g. blue, red, green, etc.)
+     * If not specified a random color will be picked.
+     */
+    color?: string;
+    status: "beta" | "stable" | "deprecated";
+    ui?: AppUIConfig;
+    /**
+     * A list of tool collections endpoints to be used by this app.
+     * A tools collection endpoint is an URL which may end with a `?import` query string.
+     * If the `?import` query string is used the tool will be imported as a javascript module and not executed through a POST on the collections endpoint.
+     */
+    tool_collections?: ToolCollection[];
+    /**
+     * An URL providing interactions definitions in JSON format.
+     * The URL must provide 2 endpoints:
+     * 1. GET URL - must return a JSON array with the list of interactions (as AppInteractionRef[])
+     * 2. GET URL/{interaction_name} - must return the full interaction definition for the specified interaction.
+     */
+    interactions?: string;
+    /**
+     * A JSON chema for the app installation settings.
+     */
+    settings_schema?: JSONSchema;
+}
+export interface AppManifest extends AppManifestData {
+    id: string;
+    account: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface AppInstallation {
+    id: string;
+    project: string;
+    manifest: string;
+    settings?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+export interface AppInstallationWithManifest extends Omit<AppInstallation, 'manifest'> {
+    manifest: AppManifest;
+}
+export interface AppInstallationPayload {
+    app_id: string;
+    settings?: Record<string, any>;
+}
+export type AppInstallationKind = 'ui' | 'tools' | 'all';
+/**
+ * A description of the tools provided by an app
+ */
+export interface AppToolCollection {
+    /**
+     * The collection name
+     */
+    name: string;
+    /**
+     * Optional collection description
+     */
+    description?: string;
+    /**
+     * the tools provided by this collection
+     */
+    tools: {
+        name: string;
+        description?: string;
+    }[];
+}
+/**
+ * Information about a tool and its associated app installation.
+ * Used to look up which app provides a specific tool.
+ */
+export interface ProjectToolInfo {
+    /**
+     * The tool name
+     */
+    tool_name: string;
+    /**
+     * Optional tool description
+     */
+    tool_description?: string;
+    /**
+     * The app name that provides this tool
+     */
+    app_name: string;
+    /**
+     * The app installation ID
+     */
+    app_install_id: string;
+    /**
+     * The app installation settings.
+     * Only included for agent tokens, not user tokens (security: may contain API keys).
+     */
+    settings?: Record<string, any>;
+}
+/**
+ * OAuth authentication status for an MCP tool collection
+ */
+export interface OAuthAuthStatus {
+    collection_name: string;
+    authenticated: boolean;
+    mcp_server_url: string;
+    expires_at?: string;
+    scope?: string;
+}
+/**
+ * Response from OAuth authorization endpoint
+ */
+export interface OAuthAuthorizeResponse {
+    authorization_url: string;
+    state: string;
+}
+/**
+ * Response from OAuth metadata endpoint
+ */
+export interface OAuthMetadataResponse {
+    collection_name: string;
+    mcp_server_url: string;
+    metadata: any;
+}
+export {};

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

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

package/lib/types/ask-user.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Types for ask_user tool UX configuration.
+ * These types enable the model to transmit structured UX parameters
+ * that render as interactive widgets instead of plain text.
+ */
+/** Option for user selection in ask_user widget */
+export interface AskUserOption {
+    /** Unique identifier returned when this option is selected */
+    id: string;
+    /** Display text for the option */
+    label: string;
+    /** Optional tooltip/description shown on hover */
+    description?: string;
+}
+/** UX configuration for ask_user messages */
+export interface AskUserUxConfig {
+    /** Predefined options for the user to select from */
+    options?: AskUserOption[];
+    /** Visual style variant */
+    variant?: 'default' | 'warning' | 'info' | 'success';
+    /** Allow selecting multiple options (renders checkboxes instead of buttons) */
+    multiSelect?: boolean;
+    /** Show text input for free-form response */
+    allowFreeResponse?: boolean;
+    /** Placeholder text for free-form input */
+    placeholder?: string;
+}
+/** Message details structure for REQUEST_INPUT messages with UX config */
+export interface AskUserMessageDetails {
+    /** UX configuration for rendering the ask_user widget */
+    ux?: AskUserUxConfig;
+}

package/lib/types/ask-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/ask-user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC1B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC5B,qDAAqD;IACrD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACrD,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IAClC,yDAAyD;IACzD,EAAE,CAAC,EAAE,eAAe,CAAC;CACxB"}

package/lib/types/channels.d.ts

@@ -0,0 +1,21 @@
+import { EmailChannel, UserChannel } from "./interaction.js";
+/**
+ * Find the email channel from a list of channels.
+ * @returns The email channel if found, undefined otherwise
+ */
+export declare function findEmailChannel(channels?: UserChannel[]): EmailChannel | undefined;
+/**
+ * Check if email channel is enabled in the channels list.
+ */
+export declare function hasEmailChannel(channels?: UserChannel[]): boolean;
+/**
+ * Update the email channel in a channels array (immutable).
+ * Returns a new array with the updated channel.
+ * If no email channel exists and to_email is provided, creates one.
+ */
+export declare function updateEmailChannel(channels: UserChannel[] | undefined, updates: Partial<Omit<EmailChannel, "type">>): UserChannel[];
+/**
+ * Update email threading info after sending or receiving an email.
+ * Adds the new messageId to references and updates in_reply_to.
+ */
+export declare function updateEmailThreading(channels: UserChannel[] | undefined, messageId: string, subject?: string): UserChannel[];

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,SAAS,CAEnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,EACnC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC7C,WAAW,EAAE,CAoBf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACjB,WAAW,EAAE,CAcf"}

package/lib/types/common.d.ts

@@ -0,0 +1,31 @@
+export interface FindPayload {
+    query: Record<string, any>;
+    offset?: number;
+    limit?: number;
+    select?: string;
+    all_revisions?: boolean;
+    from_root?: string;
+}
+export interface GenericCommandResponse {
+    status: string;
+    message: string;
+    err?: any;
+    details?: any;
+}
+export interface BulkOperationPayload {
+    /**
+     * The operation name
+     */
+    name: "change_type" | "delete" | "start_workflow" | "update";
+    /**
+     * The IDs of the objects to operate on
+     */
+    ids: string[];
+    /**
+     * The operation parameters.
+     */
+    params: Record<string, any>;
+}
+export interface BulkOperationResult {
+    status: "in_progress" | "completed" | "failed";
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/common.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAE7D;;OAEG;IACH,GAAG,EAAE,MAAM,EAAE,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;CAClD"}