@memberjunction/ai-engine-base 3.4.0 → 4.1.0

package/README.md

@@ -0,0 +1,216 @@
+# @memberjunction/ai-engine-base
+
+Base AI Engine package for MemberJunction. Provides a comprehensive metadata cache for all AI-related entities -- models, vendors, prompts, agents, configurations, modalities, permissions, and more. This package extends `BaseEngine` to load and cache AI metadata in a single batch, making it available on both server and client without duplicating data loading logic.
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph Dependencies
+        CORE["@memberjunction/core<br/>BaseEngine"]
+        style CORE fill:#2d6a9f,stroke:#1a4971,color:#fff
+
+        CE["@memberjunction/core-entities"]
+        style CE fill:#2d6a9f,stroke:#1a4971,color:#fff
+
+        ACP["@memberjunction/ai-core-plus<br/>Extended Entities"]
+        style ACP fill:#2d6a9f,stroke:#1a4971,color:#fff
+    end
+
+    AIB["AIEngineBase<br/>Singleton Metadata Cache"]
+    style AIB fill:#2d8659,stroke:#1a5c3a,color:#fff
+
+    subgraph "Cached Metadata"
+        M["Models & Model Types"]
+        style M fill:#7c5295,stroke:#563a6b,color:#fff
+
+        V["Vendors & Model Vendors"]
+        style V fill:#7c5295,stroke:#563a6b,color:#fff
+
+        P["Prompts, Categories & Types"]
+        style P fill:#7c5295,stroke:#563a6b,color:#fff
+
+        A["Agents, Types & Relationships"]
+        style A fill:#7c5295,stroke:#563a6b,color:#fff
+
+        CFG["Configurations & Params"]
+        style CFG fill:#b8762f,stroke:#8a5722,color:#fff
+
+        MOD["Modalities & Limits"]
+        style MOD fill:#b8762f,stroke:#8a5722,color:#fff
+
+        PERM["Permissions & Credentials"]
+        style PERM fill:#b8762f,stroke:#8a5722,color:#fff
+    end
+
+    CORE --> AIB
+    CE --> AIB
+    ACP --> AIB
+    AIB --> M
+    AIB --> V
+    AIB --> P
+    AIB --> A
+    AIB --> CFG
+    AIB --> MOD
+    AIB --> PERM
+
+    SRV["AIEngine (Server)"]
+    style SRV fill:#2d6a9f,stroke:#1a4971,color:#fff
+
+    AIB --> SRV
+```
+
+## Installation
+
+```bash
+npm install @memberjunction/ai-engine-base
+```
+
+## Key Exports
+
+### AIEngineBase (Singleton)
+
+The core class that loads and caches all AI metadata. Access via `AIEngineBase.Instance`.
+
+```typescript
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+
+// Initialize (typically at app startup)
+await AIEngineBase.Instance.Config(false, contextUser);
+
+// Access cached metadata
+const models = AIEngineBase.Instance.Models;
+const agents = AIEngineBase.Instance.Agents;
+const prompts = AIEngineBase.Instance.Prompts;
+```
+
+#### Cached Entity Collections
+
+| Property | Entity | Description |
+|---|---|---|
+| `Models` | AI Models | All registered AI models with extended properties |
+| `ModelTypes` | AI Model Types | Model type categories (LLM, Embeddings, etc.) |
+| `Vendors` | MJ: AI Vendors | AI service providers |
+| `ModelVendors` | MJ: AI Model Vendors | Model-vendor associations |
+| `Prompts` | AI Prompts | All prompt definitions with category associations |
+| `PromptModels` | MJ: AI Prompt Models | Prompt-model associations |
+| `PromptTypes` | AI Prompt Types | Prompt type categories |
+| `PromptCategories` | AI Prompt Categories | Hierarchical prompt organization |
+| `Agents` | AI Agents | All agent definitions with actions and notes |
+| `AgentTypes` | MJ: AI Agent Types | Agent type definitions |
+| `AgentActions` | AI Agent Actions | Actions associated with agents |
+| `AgentPrompts` | MJ: AI Agent Prompts | Prompts associated with agents |
+| `AgentSteps` | MJ: AI Agent Steps | Flow agent step definitions |
+| `AgentStepPaths` | MJ: AI Agent Step Paths | Transitions between flow steps |
+| `AgentRelationships` | MJ: AI Agent Relationships | Sub-agent relationships |
+| `AgentPermissions` | MJ: AI Agent Permissions | User/role permission grants |
+| `AgentConfigurations` | MJ: AI Agent Configurations | Semantic presets (Fast, High Quality) |
+| `Configurations` | MJ: AI Configurations | Global AI configurations with inheritance |
+| `ConfigurationParams` | MJ: AI Configuration Params | Key-value parameters for configurations |
+| `ModelCosts` | MJ: AI Model Costs | Cost tracking per model/vendor |
+| `ModelPriceTypes` | MJ: AI Model Price Types | Price type definitions |
+| `ModelPriceUnitTypes` | MJ: AI Model Price Unit Types | Unit type definitions |
+| `CredentialBindings` | MJ: AI Credential Bindings | Credential bindings for vendors/models |
+| `Modalities` | MJ: AI Modalities | Input/output modality definitions |
+| `AgentModalities` | MJ: AI Agent Modalities | Agent modality support |
+| `ModelModalities` | MJ: AI Model Modalities | Model modality support |
+| `VectorDatabases` | Vector Databases | Vector database configurations |
+| `ArtifactTypes` | MJ: Artifact Types | Artifact type definitions |
+
+#### Convenience Methods
+
+```typescript
+// Get the highest-power model of a given type
+const bestLLM = await AIEngineBase.Instance.GetHighestPowerLLM('OpenAI', contextUser);
+const bestEmbedding = await AIEngineBase.Instance.GetHighestPowerModel('OpenAI', 'Embeddings', contextUser);
+
+// Get agent by name
+const agent = AIEngineBase.Instance.GetAgentByName('Customer Support Agent');
+
+// Get sub-agents (children + relationships)
+const subAgents = AIEngineBase.Instance.GetSubAgents(agentId, 'Active');
+
+// Configuration presets
+const presets = AIEngineBase.Instance.GetAgentConfigurationPresets(agentId);
+const defaultPreset = AIEngineBase.Instance.GetDefaultAgentConfigurationPreset(agentId);
+```
+
+#### Configuration Inheritance
+
+Configurations support parent-child inheritance chains:
+
+```typescript
+// Get the full inheritance chain (child -> parent -> grandparent)
+const chain = AIEngineBase.Instance.GetConfigurationChain(configId);
+
+// Get parameters with inheritance (child overrides parent)
+const params = AIEngineBase.Instance.GetConfigurationParamsWithInheritance(configId);
+```
+
+#### Model Cost Tracking
+
+```typescript
+// Get active cost for a model/vendor combination
+const cost = AIEngineBase.Instance.GetActiveModelCost(modelId, vendorId, 'Realtime');
+```
+
+#### Credential Bindings
+
+```typescript
+// Get credential bindings for a vendor
+const bindings = AIEngineBase.Instance.GetCredentialBindingsForTarget('Vendor', vendorId);
+
+// Check if bindings exist
+const hasBindings = AIEngineBase.Instance.HasCredentialBindings('ModelVendor', modelVendorId);
+```
+
+### Modality System
+
+The modality system tracks which input/output types (Text, Image, Audio, Video, File) agents and models support.
+
+```typescript
+// Check if an agent supports image input
+const supportsImages = AIEngineBase.Instance.AgentSupportsModality(agentId, 'Image', 'Input');
+
+// Check if agent accepts any attachments
+const supportsAttachments = AIEngineBase.Instance.AgentSupportsAttachments(agentId);
+
+// Get aggregated attachment limits for UI configuration
+const limits = AIEngineBase.Instance.GetAgentAttachmentLimits(agentId, modelId);
+// limits.enabled, limits.maxAttachments, limits.maxAttachmentSizeBytes, limits.acceptedFileTypes
+```
+
+### Agent Permission Helper
+
+```typescript
+// Check individual permissions
+const canView = await AIEngineBase.Instance.CanUserViewAgent(agentId, user);
+const canRun = await AIEngineBase.Instance.CanUserRunAgent(agentId, user);
+
+// Get all permissions at once
+const perms = await AIEngineBase.Instance.GetUserAgentPermissions(agentId, user);
+// perms.canView, perms.canRun, perms.canEdit, perms.canDelete, perms.isOwner
+
+// Get all accessible agents for a user
+const agents = await AIEngineBase.Instance.GetAccessibleAgents(user, 'run');
+```
+
+### Additional Exports
+
+| Export | Purpose |
+|---|---|
+| `ModalityLimits` | Resolved limits for a specific modality (size, count, dimension, formats) |
+| `AgentAttachmentLimits` | Aggregated attachment limits for UI components |
+| `PriceUnitTypes` | Price unit type utilities |
+| `AIAgentPermissionHelper` | Static helper for agent permission checks |
+| `EffectiveAgentPermissions` | Complete permission set for a user/agent combination |
+| `AICredentialBindingEntityExtended` | Extended credential binding entity |
+
+## Dependencies
+
+- `@memberjunction/core` -- BaseEngine, Metadata, RunView
+- `@memberjunction/core-entities` -- Generated entity classes
+- `@memberjunction/ai` -- Core AI abstractions
+- `@memberjunction/ai-core-plus` -- Extended entity classes
+- `@memberjunction/global` -- Class factory
+- `@memberjunction/templates-base-types` -- Template engine integration

package/dist/AIAgentPermissionHelper.d.ts

@@ -1,5 +1,8 @@
 import { UserInfo } from "@memberjunction/core";
 import { AIAgentEntity } from "@memberjunction/core-entities";
+/**
+ * Effective permissions for a user on a specific AI agent
+ */
 export interface EffectiveAgentPermissions {
     canView: boolean;
     canRun: boolean;
@@ -7,11 +10,53 @@ export interface EffectiveAgentPermissions {
     canDelete: boolean;
     isOwner: boolean;
 }
+/**
+ * Helper class for managing AI Agent permissions.
+ * Provides methods to check user permissions, get accessible agents, and uses AIEngineBase cached metadata.
+ */
 export declare class AIAgentPermissionHelper {
+    /**
+     * Checks if a user has a specific permission for an agent.
+     * @param agentId - The ID of the agent to check
+     * @param user - The user to check permissions for
+     * @param permission - The permission level to check ('view', 'run', 'edit', or 'delete')
+     * @returns True if the user has the specified permission
+     */
     static HasPermission(agentId: string, user: UserInfo, permission: 'view' | 'run' | 'edit' | 'delete'): Promise<boolean>;
+    /**
+     * Gets the aggregate permissions for a user on a specific agent.
+     * Implements hierarchical permission logic:
+     * - Delete implies Edit, Run, and View
+     * - Edit implies Run and View
+     * - Run implies View
+     *
+     * Default behavior when no permission records exist:
+     * - Anyone can View and Run (open by default)
+     * - Only owner can Edit and Delete
+     *
+     * Checks ownership first, then combines all matching user and role permissions.
+     * @param agentId - The ID of the agent
+     * @param user - The user to check permissions for
+     * @returns Object containing all effective permissions and ownership status
+     */
     static GetEffectivePermissions(agentId: string, user: UserInfo): Promise<EffectiveAgentPermissions>;
+    /**
+     * Gets all agents that a user has access to with a specific permission level.
+     * Uses cached metadata from AIEngineBase instead of querying database.
+     * @param user - The user to check permissions for
+     * @param permission - The minimum permission level required ('view', 'run', 'edit', or 'delete')
+     * @returns Array of agents the user can access with the specified permission
+     */
     static GetAccessibleAgents(user: UserInfo, permission: 'view' | 'run' | 'edit' | 'delete'): Promise<AIAgentEntity[]>;
+    /**
+     * Clears the AIEngineBase cache. Useful when permissions have been modified.
+     * This forces a reload of all cached metadata including permissions.
+     */
     static ClearCache(): void;
+    /**
+     * Refreshes the AIEngineBase cache to pick up permission changes.
+     * @param user - The user context for server-side operations
+     */
     static RefreshCache(user: UserInfo): Promise<void>;
 }
 //# sourceMappingURL=AIAgentPermissionHelper.d.ts.map

package/dist/AIAgentPermissionHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIAgentPermissionHelper.d.ts","sourceRoot":"","sources":["../src/AIAgentPermissionHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAM9D,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB;AAMD,qBAAa,uBAAuB;WAQZ,aAAa,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAC/C,OAAO,CAAC,OAAO,CAAC;WAiCC,uBAAuB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,yBAAyB,CAAC;WAwFjB,mBAAmB,CACnC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAC/C,OAAO,CAAC,aAAa,EAAE,CAAC;WA0Bb,UAAU,IAAI,IAAI;WAWZ,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlE"}
+{"version":3,"file":"AIAgentPermissionHelper.d.ts","sourceRoot":"","sources":["../src/AIAgentPermissionHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAChC;;;;;;OAMG;WACiB,aAAa,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAC/C,OAAO,CAAC,OAAO,CAAC;IAiBnB;;;;;;;;;;;;;;;OAeG;WACiB,uBAAuB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,yBAAyB,CAAC;IAiFrC;;;;;;OAMG;WACiB,mBAAmB,CACnC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAC/C,OAAO,CAAC,aAAa,EAAE,CAAC;IAsB3B;;;OAGG;WACW,UAAU,IAAI,IAAI;IAOhC;;;OAGG;WACiB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlE"}

package/dist/AIAgentPermissionHelper.js

@@ -1,9 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIAgentPermissionHelper = void 0;
-const core_1 = require("@memberjunction/core");
-const BaseAIEngine_1 = require("./BaseAIEngine");
-class AIAgentPermissionHelper {
+import { LogError } from "@memberjunction/core";
+import { AIEngineBase } from "./BaseAIEngine.js";
+/**
+ * Helper class for managing AI Agent permissions.
+ * Provides methods to check user permissions, get accessible agents, and uses AIEngineBase cached metadata.
+ */
+export class AIAgentPermissionHelper {
+    /**
+     * Checks if a user has a specific permission for an agent.
+     * @param agentId - The ID of the agent to check
+     * @param user - The user to check permissions for
+     * @param permission - The permission level to check ('view', 'run', 'edit', or 'delete')
+     * @returns True if the user has the specified permission
+     */
     static async HasPermission(agentId, user, permission) {
         const effective = await this.GetEffectivePermissions(agentId, user);
         switch (permission) {
@@ -19,13 +27,32 @@ class AIAgentPermissionHelper {
                 return false;
         }
     }
+    /**
+     * Gets the aggregate permissions for a user on a specific agent.
+     * Implements hierarchical permission logic:
+     * - Delete implies Edit, Run, and View
+     * - Edit implies Run and View
+     * - Run implies View
+     *
+     * Default behavior when no permission records exist:
+     * - Anyone can View and Run (open by default)
+     * - Only owner can Edit and Delete
+     *
+     * Checks ownership first, then combines all matching user and role permissions.
+     * @param agentId - The ID of the agent
+     * @param user - The user to check permissions for
+     * @returns Object containing all effective permissions and ownership status
+     */
     static async GetEffectivePermissions(agentId, user) {
         try {
-            await BaseAIEngine_1.AIEngineBase.Instance.Config(false, user);
-            const agent = BaseAIEngine_1.AIEngineBase.Instance.Agents.find(a => a.ID === agentId);
+            // Ensure AIEngineBase is loaded with cached metadata
+            await AIEngineBase.Instance.Config(false, user);
+            // Find agent from cached metadata
+            const agent = AIEngineBase.Instance.Agents.find(a => a.ID === agentId);
             if (!agent) {
                 throw new Error(`Agent ${agentId} not found in cached metadata`);
             }
+            // Check if user is owner - owners have all permissions
             const isOwner = agent.OwnerUserID === user.ID;
             if (isOwner) {
                 return {
@@ -36,22 +63,30 @@ class AIAgentPermissionHelper {
                     isOwner: true
                 };
             }
-            const agentPermissions = BaseAIEngine_1.AIEngineBase.Instance.AgentPermissions.filter(p => p.AgentID === agentId);
+            // Get permissions from cached metadata
+            const agentPermissions = AIEngineBase.Instance.AgentPermissions.filter(p => p.AgentID === agentId);
+            // DEFAULT BEHAVIOR: If no permission records exist, grant View and Run to everyone
+            // This minimizes administrative overhead while protecting Edit/Delete through ownership
             if (agentPermissions.length === 0) {
                 return {
                     canView: true,
                     canRun: true,
-                    canEdit: false,
-                    canDelete: false,
+                    canEdit: false, // Only owner can edit
+                    canDelete: false, // Only owner can delete
                     isOwner: false
                 };
             }
+            // Get user's role IDs
             const userRoleIds = user.UserRoles?.map(ur => ur.RoleID) || [];
+            // Find all matching permissions (direct user permissions or role permissions)
             const matchingPermissions = agentPermissions.filter(p => p.UserID === user.ID || (p.RoleID && userRoleIds.includes(p.RoleID)));
+            // Aggregate base permissions - any matching permission grants access (OR logic)
             const hasDelete = matchingPermissions.some(p => p.CanDelete === true);
             const hasEdit = matchingPermissions.some(p => p.CanEdit === true);
             const hasRun = matchingPermissions.some(p => p.CanRun === true);
             const hasView = matchingPermissions.some(p => p.CanView === true);
+            // Apply hierarchical logic:
+            // Delete → Edit → Run → View
             const canDelete = hasDelete;
             const canEdit = hasDelete || hasEdit;
             const canRun = hasDelete || hasEdit || hasRun;
@@ -65,7 +100,8 @@ class AIAgentPermissionHelper {
             };
         }
         catch (error) {
-            (0, core_1.LogError)(error, 'Error getting effective permissions for agent');
+            LogError(error, 'Error getting effective permissions for agent');
+            // Fail closed - deny all permissions on error
             return {
                 canView: false,
                 canRun: false,
@@ -75,11 +111,20 @@ class AIAgentPermissionHelper {
             };
         }
     }
+    /**
+     * Gets all agents that a user has access to with a specific permission level.
+     * Uses cached metadata from AIEngineBase instead of querying database.
+     * @param user - The user to check permissions for
+     * @param permission - The minimum permission level required ('view', 'run', 'edit', or 'delete')
+     * @returns Array of agents the user can access with the specified permission
+     */
     static async GetAccessibleAgents(user, permission) {
         try {
-            await BaseAIEngine_1.AIEngineBase.Instance.Config(false, user);
+            // Ensure AIEngineBase is loaded with cached metadata
+            await AIEngineBase.Instance.Config(false, user);
+            // Filter agents from cached metadata based on permissions
             const accessibleAgents = [];
-            for (const agent of BaseAIEngine_1.AIEngineBase.Instance.Agents) {
+            for (const agent of AIEngineBase.Instance.Agents) {
                 const hasAccess = await this.HasPermission(agent.ID, user, permission);
                 if (hasAccess) {
                     accessibleAgents.push(agent);
@@ -88,23 +133,31 @@ class AIAgentPermissionHelper {
             return accessibleAgents;
         }
         catch (error) {
-            (0, core_1.LogError)(error, 'Error getting accessible agents');
+            LogError(error, 'Error getting accessible agents');
             return [];
         }
     }
+    /**
+     * Clears the AIEngineBase cache. Useful when permissions have been modified.
+     * This forces a reload of all cached metadata including permissions.
+     */
     static ClearCache() {
-        BaseAIEngine_1.AIEngineBase.Instance.Config(true).catch(error => {
-            (0, core_1.LogError)(error, 'Error clearing AIEngineBase cache');
+        // Force reload by calling Config with forceRefresh=true
+        AIEngineBase.Instance.Config(true).catch(error => {
+            LogError(error, 'Error clearing AIEngineBase cache');
         });
     }
+    /**
+     * Refreshes the AIEngineBase cache to pick up permission changes.
+     * @param user - The user context for server-side operations
+     */
     static async RefreshCache(user) {
         try {
-            await BaseAIEngine_1.AIEngineBase.Instance.Config(true, user);
+            await AIEngineBase.Instance.Config(true, user);
         }
         catch (error) {
-            (0, core_1.LogError)(error, 'Error refreshing AIEngineBase cache');
+            LogError(error, 'Error refreshing AIEngineBase cache');
         }
     }
 }
-exports.AIAgentPermissionHelper = AIAgentPermissionHelper;
 //# sourceMappingURL=AIAgentPermissionHelper.js.map

package/dist/AIAgentPermissionHelper.js.map

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

package/dist/AICredentialBindingEntityExtended.d.ts

@@ -1,13 +1,45 @@
 import { ValidationResult } from '@memberjunction/core';
 import { AICredentialBindingEntity } from '@memberjunction/core-entities';
+/**
+ * Extended AICredentialBindingEntity class that validates credential types match vendor expectations.
+ * When a credential is bound, this validates that the credential's CredentialTypeID matches the
+ * CredentialTypeID expected by the vendor (as declared on the AIVendor record).
+ */
 export declare class AICredentialBindingEntityExtended extends AICredentialBindingEntity {
+    /**
+     * Async validation that checks credential type compatibility.
+     * Uses AIEngineBase.Instance for cached AI entity data and RunView for credentials.
+     */
     ValidateAsync(): Promise<ValidationResult>;
+    /**
+     * Turn on async validation
+     */
     get DefaultSkipAsyncValidation(): boolean;
+    /**
+     * Validates that the bound credential's type matches the vendor's expected credential type.
+     * The vendor is determined based on the binding type:
+     * - Vendor binding: directly references the vendor
+     * - ModelVendor binding: gets vendor from the ModelVendor record
+     * - PromptModel binding: gets vendor from the PromptModel -> ModelVendor -> Vendor chain
+     */
     private validateCredentialTypeMatch;
+    /**
+     * Gets the expected CredentialTypeID from the vendor based on the binding type.
+     * Uses AIEngineBase cached data for lookups.
+     */
     private getExpectedCredentialTypeId;
+    /**
+     * Gets the expected credential type name for error messages.
+     */
     private getExpectedCredentialTypeName;
+    /**
+     * Gets the vendor name for error messages based on the binding type.
+     */
     private getVendorNameForError;
+    /**
+     * Loads the credential using RunView.
+     * Credentials are not cached in AIEngineBase, so we need to query them.
+     */
     private loadCredential;
 }
-export declare function LoadAICredentialBindingEntityExtended(): void;
 //# sourceMappingURL=AICredentialBindingEntityExtended.d.ts.map

package/dist/AICredentialBindingEntityExtended.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AICredentialBindingEntityExtended.d.ts","sourceRoot":"","sources":["../src/AICredentialBindingEntityExtended.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AACvH,OAAO,EAAE,yBAAyB,EAAoB,MAAM,+BAA+B,CAAC;AAQ5F,qBACa,iCAAkC,SAAQ,yBAAyB;IAMtD,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAehE,IAAa,0BAA0B,IAAI,OAAO,CAEjD;YASa,2BAA2B;IAuCzC,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,6BAA6B;IAgCrC,OAAO,CAAC,qBAAqB;YAiCf,cAAc;CAkB/B;AAKD,wBAAgB,qCAAqC,SAGpD"}
+{"version":3,"file":"AICredentialBindingEntityExtended.d.ts","sourceRoot":"","sources":["../src/AICredentialBindingEntityExtended.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,gBAAgB,EAA4C,MAAM,sBAAsB,CAAC;AACvH,OAAO,EAAE,yBAAyB,EAAoB,MAAM,+BAA+B,CAAC;AAG5F;;;;GAIG;AACH,qBACa,iCAAkC,SAAQ,yBAAyB;IAE5E;;;OAGG;IACmB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAYhE;;OAEG;IACH,IAAa,0BAA0B,IAAI,OAAO,CAEjD;IAED;;;;;;OAMG;YACW,2BAA2B;IAmCzC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAgCnC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA6BrC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6B7B;;;OAGG;YACW,cAAc;CAkB/B"}