@memberjunction/core-entities 5.33.0 → 5.34.0

package/dist/generated/entity_subclasses.js

@@ -2985,6 +2985,112 @@ each time the agent processes a prompt step.`),
         * * Display Name: Root Last Run
         * * SQL Data Type: uniqueidentifier`),
 });
+/**
+ * zod schema definition for the entity MJ: AI Agent Search Scopes
+ */
+export const MJAIAgentSearchScopeSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    AgentID: z.string().describe(`
+        * * Field Name: AgentID
+        * * Display Name: Agent
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)`),
+    Phase: z.union([z.literal('AgentInvoked'), z.literal('Both'), z.literal('PreExecution')]).describe(`
+        * * Field Name: Phase
+        * * Display Name: Execution Phase
+        * * SQL Data Type: nvarchar(20)
+        * * Default Value: Both
+    * * Value List Type: List
+    * * Possible Values 
+    *   * AgentInvoked
+    *   * Both
+    *   * PreExecution
+        * * Description: When this scope is used: PreExecution (injected as retrieved context before the agent runs), AgentInvoked (callable via the scoped search Action), or Both.`),
+    Status: z.union([z.literal('Active'), z.literal('Inactive')]).describe(`
+        * * Field Name: Status
+        * * Display Name: Status
+        * * SQL Data Type: nvarchar(20)
+        * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values 
+    *   * Active
+    *   * Inactive
+        * * Description: Lifecycle status. Only Active rows are considered at runtime.`),
+    StartAt: z.date().nullable().describe(`
+        * * Field Name: StartAt
+        * * Display Name: Start At
+        * * SQL Data Type: datetimeoffset
+        * * Description: Time-windowed activation for this agent-scope assignment. NULL = immediately active.`),
+    EndAt: z.date().nullable().describe(`
+        * * Field Name: EndAt
+        * * Display Name: End At
+        * * SQL Data Type: datetimeoffset
+        * * Description: Time-windowed deactivation for this agent-scope assignment. NULL = no expiry.`),
+    Priority: z.number().describe(`
+        * * Field Name: Priority
+        * * Display Name: Priority
+        * * SQL Data Type: int
+        * * Default Value: 100
+        * * Description: Ordering within Phase. Lower = higher priority. Used for pre-execution ordering and as default preference for agent-invoked scope selection.`),
+    MaxResults: z.number().nullable().describe(`
+        * * Field Name: MaxResults
+        * * Display Name: Max Results
+        * * SQL Data Type: int
+        * * Description: Override max results for this scope when used by this agent. NULL = use scope/engine default.`),
+    MinScore: z.number().nullable().describe(`
+        * * Field Name: MinScore
+        * * Display Name: Minimum Score
+        * * SQL Data Type: decimal(5, 4)
+        * * Description: Override min score threshold (0.0000–1.0000). NULL = use engine default.`),
+    QueryTemplateID: z.string().nullable().describe(`
+        * * Field Name: QueryTemplateID
+        * * Display Name: Query Template
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Templates (vwTemplates.ID)
+        * * Description: FK to Templates. MJ Template used to generate the search query from conversation context (lastUserMessage, recentMessages, payload, etc.). NULL = use lastUserMessage as-is. Can be further specialized per-provider via SearchScopeProvider.QueryTransformTemplateID.`),
+    FusionWeightsOverride: z.string().nullable().describe(`
+        * * Field Name: FusionWeightsOverride
+        * * Display Name: Fusion Weights Override
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON override for RRF per-provider fusion weights when this agent uses this scope. Resolution order: AIAgentSearchScope.FusionWeightsOverride > SearchScope.ScopeConfig.fusionWeights > engine defaults. Example: { "vector": 2.0, "fulltext": 1.0, "entity": 1.0 }.`),
+    IsDefault: z.boolean().describe(`
+        * * Field Name: IsDefault
+        * * Display Name: Is Default Scope
+        * * SQL Data Type: bit
+        * * Default Value: 0
+        * * Description: If true, this is the agent's default scope when no scope is specified in a tool call.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    Agent: z.string().nullable().describe(`
+        * * Field Name: Agent
+        * * Display Name: Agent Name
+        * * SQL Data Type: nvarchar(255)`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+    QueryTemplate: z.string().nullable().describe(`
+        * * Field Name: QueryTemplate
+        * * Display Name: Query Template Name
+        * * SQL Data Type: nvarchar(255)`),
+});
 /**
  * zod schema definition for the entity MJ: AI Agent Step Paths
  */
@@ -3330,7 +3436,7 @@ export const MJAIAgentSchema = z.object({
         * * Default Value: getutcdate()`),
     ParentID: z.string().nullable().describe(`
         * * Field Name: ParentID
-        * * Display Name: Parent
+        * * Display Name: Parent Agent
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
         * * Description: References the parent agent in the hierarchical structure. If NULL, this is a root (top-level) agent.`),
@@ -3364,22 +3470,22 @@ export const MJAIAgentSchema = z.object({
         * * Description: When true, enables automatic compression of conversation context when the message threshold is reached.`),
     ContextCompressionMessageThreshold: z.number().nullable().describe(`
         * * Field Name: ContextCompressionMessageThreshold
-        * * Display Name: Context Compression Message Threshold
+        * * Display Name: Message Threshold
         * * SQL Data Type: int
         * * Description: Number of messages that triggers context compression when EnableContextCompression is true.`),
     ContextCompressionPromptID: z.string().nullable().describe(`
         * * Field Name: ContextCompressionPromptID
-        * * Display Name: Context Compression Prompt
+        * * Display Name: Compression Prompt
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)`),
     ContextCompressionMessageRetentionCount: z.number().nullable().describe(`
         * * Field Name: ContextCompressionMessageRetentionCount
-        * * Display Name: Context Compression Message Retention Count
+        * * Display Name: Retention Count
         * * SQL Data Type: int
         * * Description: Number of recent messages to keep uncompressed when context compression is applied.`),
     TypeID: z.string().nullable().describe(`
         * * Field Name: TypeID
-        * * Display Name: Type
+        * * Display Name: Agent Type
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: AI Agent Types (vwAIAgentTypes.ID)
         * * Description: Reference to the AIAgentType that defines the category and system-level behavior for this agent. Cannot be null.`),
@@ -3416,25 +3522,25 @@ export const MJAIAgentSchema = z.object({
         * * Description: Controls whether model selection is driven by the Agent Type's system prompt or the Agent's specific prompt. Default is Agent Type for backward compatibility.`),
     PayloadDownstreamPaths: z.string().describe(`
         * * Field Name: PayloadDownstreamPaths
-        * * Display Name: Payload Downstream Paths
+        * * Display Name: Downstream Paths
         * * SQL Data Type: nvarchar(MAX)
         * * Default Value: ["*"]
         * * Description: JSON array of paths that define which parts of the payload should be sent downstream to sub-agents. Use ["*"] to send entire payload, or specify paths like ["customer.id", "campaign.*", "analysis.sentiment"]`),
     PayloadUpstreamPaths: z.string().describe(`
         * * Field Name: PayloadUpstreamPaths
-        * * Display Name: Payload Upstream Paths
+        * * Display Name: Upstream Paths
         * * SQL Data Type: nvarchar(MAX)
         * * Default Value: ["*"]
         * * Description: JSON array of paths that define which parts of the payload sub-agents are allowed to write back upstream. Use ["*"] to allow all writes, or specify paths like ["analysis.results", "recommendations.*"]`),
     PayloadSelfReadPaths: z.string().nullable().describe(`
         * * Field Name: PayloadSelfReadPaths
-        * * Display Name: Payload Self Read Paths
+        * * Display Name: Self Read Paths
         * * SQL Data Type: nvarchar(MAX)
         * * Description: JSON array of paths that specify what parts of the payload the agent's own prompt can read. Controls downstream data 
 flow when the agent executes its own prompt step.`),
     PayloadSelfWritePaths: z.string().nullable().describe(`
         * * Field Name: PayloadSelfWritePaths
-        * * Display Name: Payload Self Write Paths
+        * * Display Name: Self Write Paths
         * * SQL Data Type: nvarchar(MAX)
         * * Description: JSON array of paths that specify what parts of the payload the agent's own prompt can write back. Controls upstream 
 data flow when the agent executes its own prompt step.`),
@@ -3450,7 +3556,7 @@ data flow when the agent executes its own prompt step.`),
         * * Description: Optional JSON schema or requirements that define the expected structure and content of the agent's final payload. Used to validate the output when the agent declares success. Similar to OutputExample in AI Prompts.`),
     FinalPayloadValidationMode: z.union([z.literal('Fail'), z.literal('Retry'), z.literal('Warn')]).describe(`
         * * Field Name: FinalPayloadValidationMode
-        * * Display Name: Final Payload Validation Mode
+        * * Display Name: Final Validation Mode
         * * SQL Data Type: nvarchar(25)
         * * Default Value: Retry
     * * Value List Type: List
@@ -3461,7 +3567,7 @@ data flow when the agent executes its own prompt step.`),
         * * Description: Determines how to handle validation failures when FinalPayloadValidation is specified. Options: Retry (default) - retry the agent with validation feedback, Fail - fail the agent run immediately, Warn - log a warning but allow success.`),
     FinalPayloadValidationMaxRetries: z.number().describe(`
         * * Field Name: FinalPayloadValidationMaxRetries
-        * * Display Name: Final Payload Validation Max Retries
+        * * Display Name: Max Validation Retries
         * * SQL Data Type: int
         * * Default Value: 3
         * * Description: Maximum number of retry attempts allowed when FinalPayloadValidation fails with
@@ -3507,7 +3613,7 @@ if this limit is exceeded.`),
         * * Description: Optional JSON schema validation to apply to the input payload before agent execution begins. Uses the same JSONValidator format as FinalPayloadValidation.`),
     StartingPayloadValidationMode: z.union([z.literal('Fail'), z.literal('Warn')]).describe(`
         * * Field Name: StartingPayloadValidationMode
-        * * Display Name: Starting Payload Validation Mode
+        * * Display Name: Starting Validation Mode
         * * SQL Data Type: nvarchar(25)
         * * Default Value: Fail
     * * Value List Type: List
@@ -3517,7 +3623,7 @@ if this limit is exceeded.`),
         * * Description: Determines how to handle StartingPayloadValidation failures. Fail = reject invalid input, Warn = log warning but proceed.`),
     DefaultPromptEffortLevel: z.number().nullable().describe(`
         * * Field Name: DefaultPromptEffortLevel
-        * * Display Name: Default Prompt Effort Level
+        * * Display Name: Default Effort Level
         * * SQL Data Type: int
         * * Description: Default effort level for all prompts executed by this agent (1-100, where 1=minimal effort, 100=maximum effort). Takes precedence over individual prompt EffortLevel settings but can be overridden by runtime parameters. Inherited by sub-agents unless explicitly overridden.`),
     ChatHandlingOption: z.union([z.literal('Failed'), z.literal('Retry'), z.literal('Success')]).nullable().describe(`
@@ -3538,7 +3644,7 @@ if this limit is exceeded.`),
         * * Description: Default artifact type produced by this agent. This is the primary artifact type; additional artifact types can be linked via AIAgentArtifactType junction table. Can be NULL if agent does not produce artifacts by default.`),
     OwnerUserID: z.string().describe(`
         * * Field Name: OwnerUserID
-        * * Display Name: Owner User
+        * * Display Name: Owner
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
         * * Default Value: ECAFCCEC-6A37-EF11-86D4-000D3A4E707E
@@ -3583,7 +3689,7 @@ if this limit is exceeded.`),
         * * Description: When enabled, agent notes will be automatically injected into the agent context based on scoping rules.`),
     MaxNotesToInject: z.number().describe(`
         * * Field Name: MaxNotesToInject
-        * * Display Name: Max Notes To Inject
+        * * Display Name: Max Notes to Inject
         * * SQL Data Type: int
         * * Default Value: 5
         * * Description: Maximum number of notes to inject into agent context per request.`),
@@ -3606,7 +3712,7 @@ if this limit is exceeded.`),
         * * Description: When enabled, agent examples will be automatically injected into the agent context based on scoping rules.`),
     MaxExamplesToInject: z.number().describe(`
         * * Field Name: MaxExamplesToInject
-        * * Display Name: Max Examples To Inject
+        * * Display Name: Max Examples to Inject
         * * SQL Data Type: int
         * * Default Value: 3
         * * Description: Maximum number of examples to inject into agent context per request.`),
@@ -3646,23 +3752,23 @@ if this limit is exceeded.`),
         * * Description: Maximum number of conversation messages to include when MessageMode is 'Latest' or 'Bookend'. NULL means no limit (ignored for 'None' and 'All' modes). Must be greater than 0 if specified. For 'Latest': keeps most recent N messages. For 'Bookend': keeps first 2 + most recent (N-2) messages.`),
     AttachmentStorageProviderID: z.string().nullable().describe(`
         * * Field Name: AttachmentStorageProviderID
-        * * Display Name: Attachment Storage Provider
+        * * Display Name: Storage Provider
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: File Storage Providers (vwFileStorageProviders.ID)
         * * Description: File storage provider for large attachments. Overrides the default from AIConfiguration. NULL uses system default.`),
     AttachmentRootPath: z.string().nullable().describe(`
         * * Field Name: AttachmentRootPath
-        * * Display Name: Attachment Root Path
+        * * Display Name: Root Path
         * * SQL Data Type: nvarchar(500)
         * * Description: Base path within the storage provider for this agent's attachments. Agent run ID and sequence number are appended to create unique paths. Format: /folder/subfolder`),
     InlineStorageThresholdBytes: z.number().nullable().describe(`
         * * Field Name: InlineStorageThresholdBytes
-        * * Display Name: Inline Storage Threshold Bytes
+        * * Display Name: Inline Storage Threshold
         * * SQL Data Type: int
         * * Description: File size threshold for inline storage. Files <= this size are stored as base64 inline, larger files use MJStorage. NULL uses system default (1MB). Set to 0 to always use MJStorage.`),
     AgentTypePromptParams: z.string().nullable().describe(`
         * * Field Name: AgentTypePromptParams
-        * * Display Name: Agent Type Prompt Params
+        * * Display Name: Prompt Parameters
         * * SQL Data Type: nvarchar(MAX)
         * * Description: JSON object containing parameter values that customize how this agent's type-level system prompt is rendered. The schema is defined by the agent type's PromptParamsSchema field. Allows per-agent control over which prompt sections are included, enabling token savings by excluding unused documentation.`),
     ScopeConfig: z.string().nullable().describe(`
@@ -3701,23 +3807,34 @@ if this limit is exceeded.`),
         * * Description: Foreign key to AIAgentCategory. Assigns this agent to an organizational category for grouping, filtering, and inherited assignment strategy resolution.`),
     AllowEphemeralClientTools: z.boolean().describe(`
         * * Field Name: AllowEphemeralClientTools
-        * * Display Name: Allow Ephemeral Client Tools
+        * * Display Name: Allow Ephemeral Tools
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: When true (default), this agent accepts runtime-registered ephemeral client tools that are not defined in metadata. Set to false for agents that require strict tool governance.`),
     DefaultStorageAccountID: z.string().nullable().describe(`
         * * Field Name: DefaultStorageAccountID
-        * * Display Name: Default Storage Account ID
+        * * Display Name: Default Storage Account
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: File Storage Accounts (vwFileStorageAccounts.ID)
         * * Description: Default file storage account for this specific agent. Overrides both Type-level and Category-level defaults. Can be further overridden at runtime via ExecuteAgentParams.override.storageAccountId. FK to FileStorageAccount.`),
+    SearchScopeAccess: z.union([z.literal('All'), z.literal('Assigned'), z.literal('None')]).describe(`
+        * * Field Name: SearchScopeAccess
+        * * Display Name: Search Scope Access
+        * * SQL Data Type: nvarchar(20)
+        * * Default Value: None
+    * * Value List Type: List
+    * * Possible Values 
+    *   * All
+    *   * Assigned
+    *   * None
+        * * Description: Controls the agent's search capability. All = may use any scope including Global; search action does not restrict. Assigned = may use ONLY scopes explicitly linked via AIAgentSearchScope; scoped search action enforces this. None = agent has no search capability; the scoped search action rejects all requests.`),
     Parent: z.string().nullable().describe(`
         * * Field Name: Parent
         * * Display Name: Parent Name
         * * SQL Data Type: nvarchar(255)`),
     ContextCompressionPrompt: z.string().nullable().describe(`
         * * Field Name: ContextCompressionPrompt
-        * * Display Name: Context Compression Prompt
+        * * Display Name: Compression Prompt Name
         * * SQL Data Type: nvarchar(255)`),
     Type: z.string().nullable().describe(`
         * * Field Name: Type
@@ -3729,11 +3846,11 @@ if this limit is exceeded.`),
         * * SQL Data Type: nvarchar(100)`),
     OwnerUser: z.string().describe(`
         * * Field Name: OwnerUser
-        * * Display Name: Owner User Name
+        * * Display Name: Owner Name
         * * SQL Data Type: nvarchar(100)`),
     AttachmentStorageProvider: z.string().nullable().describe(`
         * * Field Name: AttachmentStorageProvider
-        * * Display Name: Attachment Storage Provider Name
+        * * Display Name: Storage Provider Name
         * * SQL Data Type: nvarchar(50)`),
     Category: z.string().nullable().describe(`
         * * Field Name: Category
@@ -3741,7 +3858,7 @@ if this limit is exceeded.`),
         * * SQL Data Type: nvarchar(200)`),
     DefaultStorageAccount: z.string().nullable().describe(`
         * * Field Name: DefaultStorageAccount
-        * * Display Name: Default Storage Account
+        * * Display Name: Default Storage Account Name
         * * SQL Data Type: nvarchar(200)`),
     RootParentID: z.string().nullable().describe(`
         * * Field Name: RootParentID
@@ -6127,7 +6244,7 @@ export const MJAIResultCacheSchema = z.object({
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: AI Configurations (vwAIConfigurations.ID)
         * * Description: The configuration used for this execution.`),
-    PromptEmbedding: z.number().nullable().describe(`
+    PromptEmbedding: z.string().nullable().describe(`
         * * Field Name: PromptEmbedding
         * * Display Name: Prompt Embedding
         * * SQL Data Type: varbinary
@@ -14339,7 +14456,7 @@ export const MJEntityFieldSchema = z.object({
         * * Default Value: newsequentialid()`),
     EntityID: z.string().describe(`
         * * Field Name: EntityID
-        * * Display Name: Entity ID
+        * * Display Name: Entity
         * * SQL Data Type: uniqueidentifier
         * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)`),
     Sequence: z.number().describe(`
@@ -14350,7 +14467,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: Display order of the field within the entity`),
     Name: z.string().describe(`
         * * Field Name: Name
-        * * Display Name: Name
+        * * Display Name: Field Name
         * * SQL Data Type: nvarchar(255)
         * * Description: Name of the field within the database table`),
     DisplayName: z.string().nullable().describe(`
@@ -14388,7 +14505,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: Used for generating custom tabs in the generated forms, only utilized if GeneratedFormSection=Category`),
     Type: z.string().describe(`
         * * Field Name: Type
-        * * Display Name: Data Type
+        * * Display Name: SQL Type
         * * SQL Data Type: nvarchar(100)
         * * Description: SQL Data type (auto maintained by CodeGen)`),
     Length: z.number().nullable().describe(`
@@ -14504,7 +14621,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: If set to 1, and if AllowUpdateAPI=1, the field can be edited within a view when the view is in edit mode.`),
     IncludeInUserSearchAPI: z.boolean().describe(`
         * * Field Name: IncludeInUserSearchAPI
-        * * Display Name: Include In User Search
+        * * Display Name: Include In Search
         * * SQL Data Type: bit
         * * Default Value: 0
         * * Description: If set to 1, this column will be included in user search queries for both traditional and full text search`),
@@ -14521,13 +14638,13 @@ export const MJEntityFieldSchema = z.object({
         * * Description: NULL`),
     IncludeInGeneratedForm: z.boolean().describe(`
         * * Field Name: IncludeInGeneratedForm
-        * * Display Name: Include In Generated Form
+        * * Display Name: Include In Form
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: If set to 1, this field will be included in the generated form by CodeGen. If set to 0, this field will be excluded from the generated form. For custom forms, this field has no effect as the layout is controlled independently.`),
     GeneratedFormSection: z.union([z.literal('Category'), z.literal('Details'), z.literal('Top')]).describe(`
         * * Field Name: GeneratedFormSection
-        * * Display Name: Generated Form Section
+        * * Display Name: Form Section
         * * SQL Data Type: nvarchar(10)
         * * Default Value: Details
     * * Value List Type: List
@@ -14541,7 +14658,7 @@ export const MJEntityFieldSchema = z.object({
         * * Display Name: Is Virtual
         * * SQL Data Type: bit
         * * Default Value: 0
-        * * Description: NULL`),
+        * * Description: When 1, this field is read-only at the API layer (excluded from spCreate / spUpdate / GraphQL input types). Set automatically when the column is either (a) not present in the base table — e.g., a joined name lookup in the base view, or (b) a SQL Server computed column or PostgreSQL generated column. Cases (a) and (b) are distinguished by the IsComputed flag: IsVirtual=1, IsComputed=0 means view-only; IsVirtual=1, IsComputed=1 means computed/generated and physically present in the base table.`),
     IsNameField: z.boolean().describe(`
         * * Field Name: IsNameField
         * * Display Name: Is Name Field
@@ -14603,7 +14720,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: Indicates whether the related entity information should be automatically updated from the database schema. When set to 0, relationships not part of the database schema can be manually defined at the application and AI agent level. Defaults to 1.`),
     ValuesToPackWithSchema: z.union([z.literal('All'), z.literal('Auto'), z.literal('None')]).describe(`
         * * Field Name: ValuesToPackWithSchema
-        * * Display Name: Values To Pack With Schema
+        * * Display Name: Values To Pack
         * * SQL Data Type: nvarchar(10)
         * * Default Value: Auto
     * * Value List Type: List
@@ -14625,13 +14742,13 @@ export const MJEntityFieldSchema = z.object({
         * * Description: Current status of the entity field - Active fields are available for use, Deprecated fields are discouraged but still functional, Disabled fields are not available for use`),
     AutoUpdateIsNameField: z.boolean().describe(`
         * * Field Name: AutoUpdateIsNameField
-        * * Display Name: Auto Update Is Name Field
+        * * Display Name: Auto Update Name Field
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: When 1, allows system/LLM to auto-update IsNameField; when 0, user has locked this field`),
     AutoUpdateDefaultInView: z.boolean().describe(`
         * * Field Name: AutoUpdateDefaultInView
-        * * Display Name: Auto Update Default In View
+        * * Display Name: Auto Update View Default
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: When 1, allows system/LLM to auto-update DefaultInView; when 0, user has locked this field`),
@@ -14691,7 +14808,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: When 1, indicates RelatedEntityID/RelatedEntityFieldName were set via metadata (not a database constraint). Protects these fields from being cleared by schema sync.`),
     RelatedEntityJoinFields: z.string().nullable().describe(`
         * * Field Name: RelatedEntityJoinFields
-        * * Display Name: Related Entity Join Fields
+        * * Display Name: Related Join Fields
         * * SQL Data Type: nvarchar(MAX)
         * * Description: JSON configuration for additional fields to join from the related entity into this entity's base view. Supports modes: extend (add to NameField), override (replace NameField), disable (no joins). Schema: { mode?: string, fields?: [{ field: string, alias?: string }] }`),
     JSONType: z.string().nullable().describe(`
@@ -14701,7 +14818,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: The name of the TypeScript interface/type for this JSON field. When set, CodeGen emits a strongly-typed Object-suffixed accessor using this type instead of only the default string getter/setter.`),
     JSONTypeIsArray: z.boolean().describe(`
         * * Field Name: JSONTypeIsArray
-        * * Display Name: JSON Type Is Array
+        * * Display Name: JSON Is Array
         * * SQL Data Type: bit
         * * Default Value: 0
         * * Description: If true, the field holds a JSON array of JSONType items. The Object accessor returns Array<JSONType> | null and the setter accepts Array<JSONType> | null.`),
@@ -14710,11 +14827,17 @@ export const MJEntityFieldSchema = z.object({
         * * Display Name: JSON Type Definition
         * * SQL Data Type: nvarchar(MAX)
         * * Description: Raw TypeScript code emitted by CodeGen above the entity class definition. Typically contains the interface/type definition referenced by JSONType. Can include imports, multiple types, or any valid TypeScript.`),
-    UserSearchPredicateAPI: z.string().describe(`
+    UserSearchPredicateAPI: z.union([z.literal('BeginsWith'), z.literal('Contains'), z.literal('EndsWith'), z.literal('Exact')]).describe(`
         * * Field Name: UserSearchPredicateAPI
-        * * Display Name: User Search Predicate
+        * * Display Name: Search Predicate
         * * SQL Data Type: nvarchar(20)
         * * Default Value: Contains
+    * * Value List Type: List
+    * * Possible Values 
+    *   * BeginsWith
+    *   * Contains
+    *   * EndsWith
+    *   * Exact
         * * Description: Search predicate controlling how user search queries match against this field. Valid values: BeginsWith, Contains, EndsWith, Exact.`),
     AutoUpdateUserSearchPredicate: z.boolean().describe(`
         * * Field Name: AutoUpdateUserSearchPredicate
@@ -14724,7 +14847,7 @@ export const MJEntityFieldSchema = z.object({
         * * Description: When true, CodeGen LLM can auto-set the UserSearchPredicateAPI value during code generation runs.`),
     AutoUpdateFullTextSearch: z.boolean().describe(`
         * * Field Name: AutoUpdateFullTextSearch
-        * * Display Name: Auto Update Full Text Search
+        * * Display Name: Auto Update Full Text
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: When true, CodeGen LLM can auto-set the FullTextSearchEnabled value during code generation runs.`),
@@ -14734,6 +14857,12 @@ export const MJEntityFieldSchema = z.object({
         * * SQL Data Type: bit
         * * Default Value: 1
         * * Description: When true (default), CodeGen can automatically suggest and apply ExtendedType values (GeoLatitude, GeoLongitude, GeoAddress, etc.) during LLM field categorization. Set to 0 to lock admin-specified ExtendedType.`),
+    IsComputed: z.boolean().describe(`
+        * * Field Name: IsComputed
+        * * Display Name: Is Computed
+        * * SQL Data Type: bit
+        * * Default Value: 0
+        * * Description: When 1, this field is a SQL Server computed column or PostgreSQL generated column — physically present in the base table but read-only at the SQL layer. Distinct from IsVirtual, which means the column is not in the base table at all (e.g., joined name lookups in the base view). A computed column has both IsVirtual=1 (read-only at the API layer) and IsComputed=1 (physically in the table). The difference matters for base-view JOIN target selection: when an FK's related Name Field is computed, the generated view joins to the related entity's base table instead of its view.`),
     FieldCodeName: z.string().nullable().describe(`
         * * Field Name: FieldCodeName
         * * Display Name: Field Code Name
@@ -14772,11 +14901,11 @@ export const MJEntityFieldSchema = z.object({
         * * SQL Data Type: nvarchar(255)`),
     RelatedEntityBaseTable: z.string().nullable().describe(`
         * * Field Name: RelatedEntityBaseTable
-        * * Display Name: Related Entity Table
+        * * Display Name: Related Entity Base Table
         * * SQL Data Type: nvarchar(255)`),
     RelatedEntityBaseView: z.string().nullable().describe(`
         * * Field Name: RelatedEntityBaseView
-        * * Display Name: Related Entity View
+        * * Display Name: Related Entity Base View
         * * SQL Data Type: nvarchar(255)`),
     RelatedEntityCodeName: z.string().nullable().describe(`
         * * Field Name: RelatedEntityCodeName
@@ -21335,6 +21464,102 @@ export const MJSchemaInfoSchema = z.object({
         * * SQL Data Type: nvarchar(25)
         * * Description: Optional suffix to append to entity names generated for this schema. Can be overridden by mj.config.cjs NameRulesBySchema settings.`),
 });
+/**
+ * zod schema definition for the entity MJ: Search Execution Logs
+ */
+export const MJSearchExecutionLogSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().nullable().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+        * * Description: The SearchScope this invocation targeted. NULL for unscoped global search.`),
+    UserID: z.string().nullable().describe(`
+        * * Field Name: UserID
+        * * Display Name: User
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+        * * Description: The User who initiated the search. NULL for system / unauthenticated callers.`),
+    AIAgentID: z.string().nullable().describe(`
+        * * Field Name: AIAgentID
+        * * Display Name: AI Agent
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
+        * * Description: The AIAgent identity if the search was invoked from an agent (e.g. ScopedSearchAction). NULL for direct human-initiated searches.`),
+    Query: z.string().describe(`
+        * * Field Name: Query
+        * * Display Name: Query
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: Raw query string the user / agent submitted. NVARCHAR(MAX) because some queries are long (full sentences, snippets). Stored verbatim for analytics — do NOT rely on this for permission decisions.`),
+    TotalDurationMs: z.number().describe(`
+        * * Field Name: TotalDurationMs
+        * * Display Name: Total Duration (ms)
+        * * SQL Data Type: int
+        * * Description: End-to-end search duration in milliseconds, measured at the SearchEngine.search call boundary (provider runs + fusion + rerank + permission filter + enrichment).`),
+    ResultCount: z.number().describe(`
+        * * Field Name: ResultCount
+        * * Display Name: Result Count
+        * * SQL Data Type: int
+        * * Default Value: 0
+        * * Description: Number of results returned to the caller after permission filtering, deduplication, and score-threshold trimming. Use this as the hit-rate denominator (rows where ResultCount > 0).`),
+    RerankerName: z.string().nullable().describe(`
+        * * Field Name: RerankerName
+        * * Display Name: Reranker Name
+        * * SQL Data Type: nvarchar(100)
+        * * Description: BaseReRanker.Name of the reranker that ran (e.g. 'Cohere', 'Voyage', 'OpenAI', 'BGE', 'NoopReRanker'). NULL when no rerank stage executed for this invocation.`),
+    RerankerCostCents: z.number().nullable().describe(`
+        * * Field Name: RerankerCostCents
+        * * Display Name: Reranker Cost (Cents)
+        * * SQL Data Type: decimal(10, 4)
+        * * Description: Total reranker spend in cents for this invocation, populated from the BaseReRanker.CostReporter callback via RerankerBudgetGuard. NULL when no rerank ran or no real-provider cost was incurred (Noop / BGE).`),
+    Status: z.union([z.literal('Failure'), z.literal('Forbidden'), z.literal('Success')]).describe(`
+        * * Field Name: Status
+        * * Display Name: Status
+        * * SQL Data Type: nvarchar(20)
+    * * Value List Type: List
+    * * Possible Values 
+    *   * Failure
+    *   * Forbidden
+    *   * Success
+        * * Description: Outcome of the search: 'Success' (results returned, possibly empty), 'Failure' (an exception bubbled out — see FailureReason), 'Forbidden' (the caller lacked SearchScopePermission for the requested scope). Constrained by CK_SearchExecutionLog_Status.`),
+    FailureReason: z.string().nullable().describe(`
+        * * Field Name: FailureReason
+        * * Display Name: Failure Reason
+        * * SQL Data Type: nvarchar(500)
+        * * Description: Short human-readable failure reason when Status = 'Failure' or 'Forbidden'. NULL on success.`),
+    ProvidersJSON: z.string().nullable().describe(`
+        * * Field Name: ProvidersJSON
+        * * Display Name: Providers Breakdown
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON array of per-provider breakdown entries: [{"Provider":"Vector","DurationMs":123,"ResultCount":5,"ErrorMessage":null}, ...]. Used by the analytics dashboard for p50/p95 latency-by-provider charts and to spot consistently slow providers.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().nullable().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+    User: z.string().nullable().describe(`
+        * * Field Name: User
+        * * Display Name: User Name
+        * * SQL Data Type: nvarchar(100)`),
+    AIAgent: z.string().nullable().describe(`
+        * * Field Name: AIAgent
+        * * Display Name: AI Agent Name
+        * * SQL Data Type: nvarchar(255)`),
+});
 /**
  * zod schema definition for the entity MJ: Search Providers
  */
@@ -21428,6 +21653,438 @@ export const MJSearchProviderSchema = z.object({
         * * Display Name: Credential Name
         * * SQL Data Type: nvarchar(200)`),
 });
+/**
+ * zod schema definition for the entity MJ: Search Scope Entities
+ */
+export const MJSearchScopeEntitySchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope ID
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)`),
+    EntityID: z.string().describe(`
+        * * Field Name: EntityID
+        * * Display Name: Entity ID
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)`),
+    ExtraFilter: z.string().nullable().describe(`
+        * * Field Name: ExtraFilter
+        * * Display Name: Extra Filter
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: Optional SQL filter applied to this entity's search within this scope. Example: Status='Published' AND DepartmentID='abc'. Rendered as a Nunjucks template with SearchContext variables for multi-tenant filtering.`),
+    UserSearchString: z.string().nullable().describe(`
+        * * Field Name: UserSearchString
+        * * Display Name: User Search String
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: Optional override for the UserSearchString passed to RunView for this entity within this scope. Nunjucks template (e.g., "{{ query }} AND type:policy"). NULL = pass the user's actual query through as-is.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope
+        * * SQL Data Type: nvarchar(200)`),
+    Entity: z.string().describe(`
+        * * Field Name: Entity
+        * * Display Name: Entity
+        * * SQL Data Type: nvarchar(255)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scope External Indexes
+ */
+export const MJSearchScopeExternalIndexSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope ID
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)`),
+    IndexType: z.union([z.literal('AzureAISearch'), z.literal('Elasticsearch'), z.literal('OpenSearch'), z.literal('Other'), z.literal('Typesense'), z.literal('Vector')]).describe(`
+        * * Field Name: IndexType
+        * * Display Name: Index Type
+        * * SQL Data Type: nvarchar(40)
+        * * Default Value: Vector
+    * * Value List Type: List
+    * * Possible Values 
+    *   * AzureAISearch
+    *   * Elasticsearch
+    *   * OpenSearch
+    *   * Other
+    *   * Typesense
+    *   * Vector
+        * * Description: Discriminator. Determines which provider class consumes this row: Vector | Elasticsearch | Typesense | AzureAISearch | OpenSearch | Other.`),
+    VectorIndexID: z.string().nullable().describe(`
+        * * Field Name: VectorIndexID
+        * * Display Name: Vector Index ID
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Vector Indexes (vwVectorIndexes.ID)
+        * * Description: FK to VectorIndex. REQUIRED when IndexType='Vector'. NULL for all other IndexType values.`),
+    ExternalIndexName: z.string().nullable().describe(`
+        * * Field Name: ExternalIndexName
+        * * Display Name: External Index Name
+        * * SQL Data Type: nvarchar(400)
+        * * Description: For non-vector IndexTypes: the remote engine's index/collection/alias name (e.g., Elasticsearch index "kb_docs_v3", Typesense collection "articles"). NULL for IndexType='Vector' (VectorIndexID resolves the name instead).`),
+    ExternalIndexConfig: z.string().nullable().describe(`
+        * * Field Name: ExternalIndexConfig
+        * * Display Name: External Index Config
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON with extra connection/config hints the provider needs (cluster alias, routing key, custom analyzer, etc.). Provider-interpreted.`),
+    MetadataFilter: z.string().nullable().describe(`
+        * * Field Name: MetadataFilter
+        * * Display Name: Metadata Filter
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON filter expression applied as a native metadata filter on the remote engine. Pinecone/Qdrant/PGVector metadata filter, or Elasticsearch filter DSL, etc. Rendered as a Nunjucks template so SearchContext.PrimaryScopeRecordID and SearchContext.SecondaryScopes.* can be interpolated for multi-tenant filtering.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope
+        * * SQL Data Type: nvarchar(200)`),
+    VectorIndex: z.string().nullable().describe(`
+        * * Field Name: VectorIndex
+        * * Display Name: Vector Index
+        * * SQL Data Type: nvarchar(255)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scope Permissions
+ */
+export const MJSearchScopePermissionSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()
+        * * Description: Primary key. Auto-generated.`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+        * * Description: The SearchScope this permission row applies to.`),
+    UserID: z.string().nullable().describe(`
+        * * Field Name: UserID
+        * * Display Name: User
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+        * * Description: The user this permission applies to. Mutually exclusive with RoleID — exactly one must be set.`),
+    RoleID: z.string().nullable().describe(`
+        * * Field Name: RoleID
+        * * Display Name: Role
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Roles (vwRoles.ID)
+        * * Description: The role this permission applies to. Mutually exclusive with UserID — exactly one must be set. Permissions granted via roles flow to all users in that role.`),
+    PermissionLevel: z.union([z.literal('Manage'), z.literal('None'), z.literal('Read'), z.literal('Search')]).describe(`
+        * * Field Name: PermissionLevel
+        * * Display Name: Permission Level
+        * * SQL Data Type: nvarchar(20)
+    * * Value List Type: List
+    * * Possible Values 
+    *   * Manage
+    *   * None
+    *   * Read
+    *   * Search
+        * * Description: Capability granted on this SearchScope. None = explicit deny (overrides role grants), Read = view scope metadata, Search = invoke ScopedSearchAction, Manage = full edit including authoring of permission rows. The resolver picks the highest level when multiple grants apply (direct + role).`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+    User: z.string().nullable().describe(`
+        * * Field Name: User
+        * * Display Name: User Name
+        * * SQL Data Type: nvarchar(100)`),
+    Role: z.string().nullable().describe(`
+        * * Field Name: Role
+        * * Display Name: Role Name
+        * * SQL Data Type: nvarchar(50)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scope Providers
+ */
+export const MJSearchScopeProviderSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)`),
+    SearchProviderID: z.string().describe(`
+        * * Field Name: SearchProviderID
+        * * Display Name: Search Provider
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Providers (vwSearchProviders.ID)`),
+    Enabled: z.boolean().describe(`
+        * * Field Name: Enabled
+        * * Display Name: Enabled
+        * * SQL Data Type: bit
+        * * Default Value: 1
+        * * Description: Whether this provider is active for this scope. Lets an admin toggle providers off per-scope without deleting the row.`),
+    MaxResultsOverride: z.number().nullable().describe(`
+        * * Field Name: MaxResultsOverride
+        * * Display Name: Max Results Override
+        * * SQL Data Type: int
+        * * Description: Override the max-results value for this provider within this scope. NULL = use the provider's default.`),
+    ProviderConfigOverride: z.string().nullable().describe(`
+        * * Field Name: ProviderConfigOverride
+        * * Display Name: Provider Config Override
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON override for provider-specific configuration within this scope. Provider interprets.`),
+    QueryTransformTemplateID: z.string().nullable().describe(`
+        * * Field Name: QueryTransformTemplateID
+        * * Display Name: Query Transform Template
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Templates (vwTemplates.ID)
+        * * Description: Optional FK to Templates. When set, the user/agent query is rewritten through this Template before being sent to this provider. Lets vector providers get a chunk-shaped rewrite while FTS providers get keyword extraction within the same scope. Resolution order: this > AIAgentSearchScope.QueryTemplateID > raw lastUserMessage.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+    SearchProvider: z.string().describe(`
+        * * Field Name: SearchProvider
+        * * Display Name: Search Provider Name
+        * * SQL Data Type: nvarchar(200)`),
+    QueryTransformTemplate: z.string().nullable().describe(`
+        * * Field Name: QueryTransformTemplate
+        * * Display Name: Query Transform Template Name
+        * * SQL Data Type: nvarchar(255)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scope Storage Accounts
+ */
+export const MJSearchScopeStorageAccountSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)`),
+    FileStorageAccountID: z.string().describe(`
+        * * Field Name: FileStorageAccountID
+        * * Display Name: Storage Account
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: File Storage Accounts (vwFileStorageAccounts.ID)`),
+    FolderPath: z.string().nullable().describe(`
+        * * Field Name: FolderPath
+        * * Display Name: Folder Path
+        * * SQL Data Type: nvarchar(1000)
+        * * Description: Optional folder path restriction. NULL = entire storage account. Example: /policies/hr/. Rendered as a Nunjucks template with SearchContext variables so platforms can do per-tenant folder routing like /tenants/{{ context.PrimaryScopeRecordID }}/.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+    FileStorageAccount: z.string().describe(`
+        * * Field Name: FileStorageAccount
+        * * Display Name: Storage Account Name
+        * * SQL Data Type: nvarchar(200)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scope Test Queries
+ */
+export const MJSearchScopeTestQuerySchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    SearchScopeID: z.string().describe(`
+        * * Field Name: SearchScopeID
+        * * Display Name: Search Scope
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+        * * Description: The SearchScope this test query belongs to. Cascade-restricted via FK so accidental scope deletion preserves test history.`),
+    Label: z.string().describe(`
+        * * Field Name: Label
+        * * Display Name: Label
+        * * SQL Data Type: nvarchar(200)
+        * * Description: Short human-readable label for the test query, shown in the form's test-query grid (e.g. "VIP customer escalation", "expense reimbursement policy").`),
+    Query: z.string().describe(`
+        * * Field Name: Query
+        * * Display Name: Query
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: The query text itself. NVARCHAR(MAX) because canonical queries can be full sentences or chunks of natural-language context.`),
+    ExpectedTopResultEntity: z.string().nullable().describe(`
+        * * Field Name: ExpectedTopResultEntity
+        * * Display Name: Expected Top Result Entity
+        * * SQL Data Type: nvarchar(255)
+        * * Description: Optional MJ entity name (e.g. "Contacts", "Documents") of the expected top result. When set together with ExpectedTopResultRecordID, lets the test runner assert that the tuned scope returns the right record at rank #1 — a regression tripwire for fusion / reranker changes.`),
+    ExpectedTopResultRecordID: z.string().nullable().describe(`
+        * * Field Name: ExpectedTopResultRecordID
+        * * Display Name: Expected Top Result Record ID
+        * * SQL Data Type: uniqueidentifier
+        * * Description: Optional record ID of the expected top result, paired with ExpectedTopResultEntity. NULL = no assertion (the query is exploratory).`),
+    Notes: z.string().nullable().describe(`
+        * * Field Name: Notes
+        * * Display Name: Notes
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: Free-form notes explaining why this query is canonical or what edge case it represents.`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    SearchScope: z.string().describe(`
+        * * Field Name: SearchScope
+        * * Display Name: Search Scope Name
+        * * SQL Data Type: nvarchar(200)`),
+});
+/**
+ * zod schema definition for the entity MJ: Search Scopes
+ */
+export const MJSearchScopeSchema = z.object({
+    ID: z.string().describe(`
+        * * Field Name: ID
+        * * Display Name: ID
+        * * SQL Data Type: uniqueidentifier
+        * * Default Value: newsequentialid()`),
+    Name: z.string().describe(`
+        * * Field Name: Name
+        * * Display Name: Name
+        * * SQL Data Type: nvarchar(200)
+        * * Description: Human-readable scope name (e.g., "HR Policies", "Engineering Docs"). Unique across the system.`),
+    Description: z.string().nullable().describe(`
+        * * Field Name: Description
+        * * Display Name: Description
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: Detailed description of what this scope covers. Surfaced to agents in the available-scopes prompt injection so the LLM can choose a scope.`),
+    Icon: z.string().nullable().describe(`
+        * * Field Name: Icon
+        * * Display Name: Icon
+        * * SQL Data Type: nvarchar(200)
+        * * Description: Font Awesome (or equivalent) icon class used by the scope selector UI.`),
+    IsGlobal: z.boolean().describe(`
+        * * Field Name: IsGlobal
+        * * Display Name: Is Global
+        * * SQL Data Type: bit
+        * * Default Value: 0
+        * * Description: If true, this scope includes everything (equivalent to no scope filtering). Exactly one Global scope should exist; it is seeded via metadata sync.`),
+    IsDefault: z.boolean().describe(`
+        * * Field Name: IsDefault
+        * * Display Name: Is Default
+        * * SQL Data Type: bit
+        * * Default Value: 0
+        * * Description: If true, this is the default scope for users/agents that do not specify one.`),
+    OwnerUserID: z.string().nullable().describe(`
+        * * Field Name: OwnerUserID
+        * * Display Name: Owner User
+        * * SQL Data Type: uniqueidentifier
+        * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+        * * Description: NULL = organization-wide scope. Set = personal scope owned by this user (visible/usable only by that user unless explicitly shared).`),
+    Status: z.union([z.literal('Active'), z.literal('Inactive')]).describe(`
+        * * Field Name: Status
+        * * Display Name: Status
+        * * SQL Data Type: nvarchar(20)
+        * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values 
+    *   * Active
+    *   * Inactive
+        * * Description: Lifecycle status. Only Active scopes are considered at query time.`),
+    StartAt: z.date().nullable().describe(`
+        * * Field Name: StartAt
+        * * Display Name: Start At
+        * * SQL Data Type: datetimeoffset
+        * * Description: Optional time-window activation. Scope is inactive before StartAt. NULL = immediately active.`),
+    EndAt: z.date().nullable().describe(`
+        * * Field Name: EndAt
+        * * Display Name: End At
+        * * SQL Data Type: datetimeoffset
+        * * Description: Optional time-window deactivation. Scope is inactive after EndAt. NULL = no expiry.`),
+    ScopeConfig: z.string().nullable().describe(`
+        * * Field Name: ScopeConfig
+        * * Display Name: Scope Configuration
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON configuration for advanced scope behavior. Recognized keys: rrfK (RRF k parameter), fusionWeights (per-provider weights), reRanker (optional re-ranker stage config: driverClass, inputTopN, outputTopN, config), permissionOverfetchFactor.`),
+    SearchContextConfig: z.string().nullable().describe(`
+        * * Field Name: SearchContextConfig
+        * * Display Name: Search Context Configuration
+        * * SQL Data Type: nvarchar(MAX)
+        * * Description: JSON defining available multi-tenant SearchContext dimensions, inheritance modes, and validation rules. Uses the SecondaryScopeConfig structure shared with the agent memory system (@memberjunction/ai-core-plus). NULL = scope is not multi-tenant aware.`),
+    RerankerBudgetCents: z.number().nullable().describe(`
+        * * Field Name: RerankerBudgetCents
+        * * Display Name: Reranker Budget (Cents)
+        * * SQL Data Type: int
+        * * Description: Optional cap on reranker spend (in cents) per search invocation against this scope. NULL means uncapped — existing behavior. When set, the SearchEngine's budget guard short-circuits any reranker call whose projected cost would push the run total past this value, and accumulates actual post-call cost via each reranker's CostReporter callback (BaseReRanker.CostReporter). Real-provider rerankers (Cohere, Voyage, OpenAI) report cost; NoopReRanker and BGEReRanker report zero (local / pass-through).`),
+    __mj_CreatedAt: z.date().describe(`
+        * * Field Name: __mj_CreatedAt
+        * * Display Name: Created At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    __mj_UpdatedAt: z.date().describe(`
+        * * Field Name: __mj_UpdatedAt
+        * * Display Name: Updated At
+        * * SQL Data Type: datetimeoffset
+        * * Default Value: getutcdate()`),
+    OwnerUser: z.string().nullable().describe(`
+        * * Field Name: OwnerUser
+        * * Display Name: Owner User Name
+        * * SQL Data Type: nvarchar(100)`),
+});
 /**
  * zod schema definition for the entity MJ: Skills
  */
@@ -32680,6 +33337,251 @@ MJAIAgentRunEntity = __decorate([
     RegisterClass(BaseEntity, 'MJ: AI Agent Runs')
 ], MJAIAgentRunEntity);
 export { MJAIAgentRunEntity };
+/**
+ * MJ: AI Agent Search Scopes - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: AIAgentSearchScope
+ * * Base View: vwAIAgentSearchScopes
+ * * @description Many-to-many between agents and search scopes, with phase and scheduling control. Drives both pre-execution RAG and agent-invoked scoped search.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJAIAgentSearchScopeEntity = class MJAIAgentSearchScopeEntity extends BaseEntity {
+    /**
+    * Loads the MJ: AI Agent Search Scopes record from the database
+    * @param ID: string - primary key value to load the MJ: AI Agent Search Scopes record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJAIAgentSearchScopeEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: AgentID
+    * * Display Name: Agent
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
+    */
+    get AgentID() {
+        return this.Get('AgentID');
+    }
+    set AgentID(value) {
+        this.Set('AgentID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: Phase
+    * * Display Name: Execution Phase
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Both
+    * * Value List Type: List
+    * * Possible Values
+    *   * AgentInvoked
+    *   * Both
+    *   * PreExecution
+    * * Description: When this scope is used: PreExecution (injected as retrieved context before the agent runs), AgentInvoked (callable via the scoped search Action), or Both.
+    */
+    get Phase() {
+        return this.Get('Phase');
+    }
+    set Phase(value) {
+        this.Set('Phase', value);
+    }
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Inactive
+    * * Description: Lifecycle status. Only Active rows are considered at runtime.
+    */
+    get Status() {
+        return this.Get('Status');
+    }
+    set Status(value) {
+        this.Set('Status', value);
+    }
+    /**
+    * * Field Name: StartAt
+    * * Display Name: Start At
+    * * SQL Data Type: datetimeoffset
+    * * Description: Time-windowed activation for this agent-scope assignment. NULL = immediately active.
+    */
+    get StartAt() {
+        return this.Get('StartAt');
+    }
+    set StartAt(value) {
+        this.Set('StartAt', value);
+    }
+    /**
+    * * Field Name: EndAt
+    * * Display Name: End At
+    * * SQL Data Type: datetimeoffset
+    * * Description: Time-windowed deactivation for this agent-scope assignment. NULL = no expiry.
+    */
+    get EndAt() {
+        return this.Get('EndAt');
+    }
+    set EndAt(value) {
+        this.Set('EndAt', value);
+    }
+    /**
+    * * Field Name: Priority
+    * * Display Name: Priority
+    * * SQL Data Type: int
+    * * Default Value: 100
+    * * Description: Ordering within Phase. Lower = higher priority. Used for pre-execution ordering and as default preference for agent-invoked scope selection.
+    */
+    get Priority() {
+        return this.Get('Priority');
+    }
+    set Priority(value) {
+        this.Set('Priority', value);
+    }
+    /**
+    * * Field Name: MaxResults
+    * * Display Name: Max Results
+    * * SQL Data Type: int
+    * * Description: Override max results for this scope when used by this agent. NULL = use scope/engine default.
+    */
+    get MaxResults() {
+        return this.Get('MaxResults');
+    }
+    set MaxResults(value) {
+        this.Set('MaxResults', value);
+    }
+    /**
+    * * Field Name: MinScore
+    * * Display Name: Minimum Score
+    * * SQL Data Type: decimal(5, 4)
+    * * Description: Override min score threshold (0.0000–1.0000). NULL = use engine default.
+    */
+    get MinScore() {
+        return this.Get('MinScore');
+    }
+    set MinScore(value) {
+        this.Set('MinScore', value);
+    }
+    /**
+    * * Field Name: QueryTemplateID
+    * * Display Name: Query Template
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Templates (vwTemplates.ID)
+    * * Description: FK to Templates. MJ Template used to generate the search query from conversation context (lastUserMessage, recentMessages, payload, etc.). NULL = use lastUserMessage as-is. Can be further specialized per-provider via SearchScopeProvider.QueryTransformTemplateID.
+    */
+    get QueryTemplateID() {
+        return this.Get('QueryTemplateID');
+    }
+    set QueryTemplateID(value) {
+        this.Set('QueryTemplateID', value);
+    }
+    /**
+    * * Field Name: FusionWeightsOverride
+    * * Display Name: Fusion Weights Override
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON override for RRF per-provider fusion weights when this agent uses this scope. Resolution order: AIAgentSearchScope.FusionWeightsOverride > SearchScope.ScopeConfig.fusionWeights > engine defaults. Example: { "vector": 2.0, "fulltext": 1.0, "entity": 1.0 }.
+    */
+    get FusionWeightsOverride() {
+        return this.Get('FusionWeightsOverride');
+    }
+    set FusionWeightsOverride(value) {
+        this.Set('FusionWeightsOverride', value);
+    }
+    /**
+    * * Field Name: IsDefault
+    * * Display Name: Is Default Scope
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: If true, this is the agent's default scope when no scope is specified in a tool call.
+    */
+    get IsDefault() {
+        return this.Get('IsDefault');
+    }
+    set IsDefault(value) {
+        this.Set('IsDefault', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: Agent
+    * * Display Name: Agent Name
+    * * SQL Data Type: nvarchar(255)
+    */
+    get Agent() {
+        return this.Get('Agent');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: QueryTemplate
+    * * Display Name: Query Template Name
+    * * SQL Data Type: nvarchar(255)
+    */
+    get QueryTemplate() {
+        return this.Get('QueryTemplate');
+    }
+};
+MJAIAgentSearchScopeEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: AI Agent Search Scopes')
+], MJAIAgentSearchScopeEntity);
+export { MJAIAgentSearchScopeEntity };
 /**
  * MJ: AI Agent Step Paths - strongly typed entity sub-class
  * * Schema: __mj
@@ -33755,7 +34657,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: ParentID
-    * * Display Name: Parent
+    * * Display Name: Parent Agent
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
     * * Description: References the parent agent in the hierarchical structure. If NULL, this is a root (top-level) agent.
@@ -33824,7 +34726,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: ContextCompressionMessageThreshold
-    * * Display Name: Context Compression Message Threshold
+    * * Display Name: Message Threshold
     * * SQL Data Type: int
     * * Description: Number of messages that triggers context compression when EnableContextCompression is true.
     */
@@ -33836,7 +34738,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: ContextCompressionPromptID
-    * * Display Name: Context Compression Prompt
+    * * Display Name: Compression Prompt
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)
     */
@@ -33848,7 +34750,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: ContextCompressionMessageRetentionCount
-    * * Display Name: Context Compression Message Retention Count
+    * * Display Name: Retention Count
     * * SQL Data Type: int
     * * Description: Number of recent messages to keep uncompressed when context compression is applied.
     */
@@ -33860,7 +34762,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: TypeID
-    * * Display Name: Type
+    * * Display Name: Agent Type
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Agent Types (vwAIAgentTypes.ID)
     * * Description: Reference to the AIAgentType that defines the category and system-level behavior for this agent. Cannot be null.
@@ -33932,7 +34834,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: PayloadDownstreamPaths
-    * * Display Name: Payload Downstream Paths
+    * * Display Name: Downstream Paths
     * * SQL Data Type: nvarchar(MAX)
     * * Default Value: ["*"]
     * * Description: JSON array of paths that define which parts of the payload should be sent downstream to sub-agents. Use ["*"] to send entire payload, or specify paths like ["customer.id", "campaign.*", "analysis.sentiment"]
@@ -33945,7 +34847,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: PayloadUpstreamPaths
-    * * Display Name: Payload Upstream Paths
+    * * Display Name: Upstream Paths
     * * SQL Data Type: nvarchar(MAX)
     * * Default Value: ["*"]
     * * Description: JSON array of paths that define which parts of the payload sub-agents are allowed to write back upstream. Use ["*"] to allow all writes, or specify paths like ["analysis.results", "recommendations.*"]
@@ -33958,7 +34860,7 @@ let MJAIAgentEntity = class MJAIAgentEntity extends BaseEntity {
     }
     /**
     * * Field Name: PayloadSelfReadPaths
-    * * Display Name: Payload Self Read Paths
+    * * Display Name: Self Read Paths
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON array of paths that specify what parts of the payload the agent's own prompt can read. Controls downstream data
 flow when the agent executes its own prompt step.
@@ -33971,7 +34873,7 @@ flow when the agent executes its own prompt step.
     }
     /**
     * * Field Name: PayloadSelfWritePaths
-    * * Display Name: Payload Self Write Paths
+    * * Display Name: Self Write Paths
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON array of paths that specify what parts of the payload the agent's own prompt can write back. Controls upstream
 data flow when the agent executes its own prompt step.
@@ -34008,7 +34910,7 @@ data flow when the agent executes its own prompt step.
     }
     /**
     * * Field Name: FinalPayloadValidationMode
-    * * Display Name: Final Payload Validation Mode
+    * * Display Name: Final Validation Mode
     * * SQL Data Type: nvarchar(25)
     * * Default Value: Retry
     * * Value List Type: List
@@ -34026,7 +34928,7 @@ data flow when the agent executes its own prompt step.
     }
     /**
     * * Field Name: FinalPayloadValidationMaxRetries
-    * * Display Name: Final Payload Validation Max Retries
+    * * Display Name: Max Validation Retries
     * * SQL Data Type: int
     * * Default Value: 3
     * * Description: Maximum number of retry attempts allowed when FinalPayloadValidation fails with
@@ -34128,7 +35030,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: StartingPayloadValidationMode
-    * * Display Name: Starting Payload Validation Mode
+    * * Display Name: Starting Validation Mode
     * * SQL Data Type: nvarchar(25)
     * * Default Value: Fail
     * * Value List Type: List
@@ -34145,7 +35047,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: DefaultPromptEffortLevel
-    * * Display Name: Default Prompt Effort Level
+    * * Display Name: Default Effort Level
     * * SQL Data Type: int
     * * Description: Default effort level for all prompts executed by this agent (1-100, where 1=minimal effort, 100=maximum effort). Takes precedence over individual prompt EffortLevel settings but can be overridden by runtime parameters. Inherited by sub-agents unless explicitly overridden.
     */
@@ -34187,7 +35089,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: OwnerUserID
-    * * Display Name: Owner User
+    * * Display Name: Owner
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
     * * Default Value: ECAFCCEC-6A37-EF11-86D4-000D3A4E707E
@@ -34274,7 +35176,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: MaxNotesToInject
-    * * Display Name: Max Notes To Inject
+    * * Display Name: Max Notes to Inject
     * * SQL Data Type: int
     * * Default Value: 5
     * * Description: Maximum number of notes to inject into agent context per request.
@@ -34318,7 +35220,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: MaxExamplesToInject
-    * * Display Name: Max Examples To Inject
+    * * Display Name: Max Examples to Inject
     * * SQL Data Type: int
     * * Default Value: 3
     * * Description: Maximum number of examples to inject into agent context per request.
@@ -34393,7 +35295,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: AttachmentStorageProviderID
-    * * Display Name: Attachment Storage Provider
+    * * Display Name: Storage Provider
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: File Storage Providers (vwFileStorageProviders.ID)
     * * Description: File storage provider for large attachments. Overrides the default from AIConfiguration. NULL uses system default.
@@ -34406,7 +35308,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: AttachmentRootPath
-    * * Display Name: Attachment Root Path
+    * * Display Name: Root Path
     * * SQL Data Type: nvarchar(500)
     * * Description: Base path within the storage provider for this agent's attachments. Agent run ID and sequence number are appended to create unique paths. Format: /folder/subfolder
     */
@@ -34418,7 +35320,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: InlineStorageThresholdBytes
-    * * Display Name: Inline Storage Threshold Bytes
+    * * Display Name: Inline Storage Threshold
     * * SQL Data Type: int
     * * Description: File size threshold for inline storage. Files <= this size are stored as base64 inline, larger files use MJStorage. NULL uses system default (1MB). Set to 0 to always use MJStorage.
     */
@@ -34430,7 +35332,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: AgentTypePromptParams
-    * * Display Name: Agent Type Prompt Params
+    * * Display Name: Prompt Parameters
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON object containing parameter values that customize how this agent's type-level system prompt is rendered. The schema is defined by the agent type's PromptParamsSchema field. Allows per-agent control over which prompt sections are included, enabling token savings by excluding unused documentation.
     */
@@ -34518,7 +35420,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: AllowEphemeralClientTools
-    * * Display Name: Allow Ephemeral Client Tools
+    * * Display Name: Allow Ephemeral Tools
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: When true (default), this agent accepts runtime-registered ephemeral client tools that are not defined in metadata. Set to false for agents that require strict tool governance.
@@ -34531,7 +35433,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: DefaultStorageAccountID
-    * * Display Name: Default Storage Account ID
+    * * Display Name: Default Storage Account
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: File Storage Accounts (vwFileStorageAccounts.ID)
     * * Description: Default file storage account for this specific agent. Overrides both Type-level and Category-level defaults. Can be further overridden at runtime via ExecuteAgentParams.override.storageAccountId. FK to FileStorageAccount.
@@ -34543,6 +35445,24 @@ if this limit is exceeded.
         this.Set('DefaultStorageAccountID', value);
     }
     /**
+    * * Field Name: SearchScopeAccess
+    * * Display Name: Search Scope Access
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: None
+    * * Value List Type: List
+    * * Possible Values
+    *   * All
+    *   * Assigned
+    *   * None
+    * * Description: Controls the agent's search capability. All = may use any scope including Global; search action does not restrict. Assigned = may use ONLY scopes explicitly linked via AIAgentSearchScope; scoped search action enforces this. None = agent has no search capability; the scoped search action rejects all requests.
+    */
+    get SearchScopeAccess() {
+        return this.Get('SearchScopeAccess');
+    }
+    set SearchScopeAccess(value) {
+        this.Set('SearchScopeAccess', value);
+    }
+    /**
     * * Field Name: Parent
     * * Display Name: Parent Name
     * * SQL Data Type: nvarchar(255)
@@ -34552,7 +35472,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: ContextCompressionPrompt
-    * * Display Name: Context Compression Prompt
+    * * Display Name: Compression Prompt Name
     * * SQL Data Type: nvarchar(255)
     */
     get ContextCompressionPrompt() {
@@ -34576,7 +35496,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: OwnerUser
-    * * Display Name: Owner User Name
+    * * Display Name: Owner Name
     * * SQL Data Type: nvarchar(100)
     */
     get OwnerUser() {
@@ -34584,7 +35504,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: AttachmentStorageProvider
-    * * Display Name: Attachment Storage Provider Name
+    * * Display Name: Storage Provider Name
     * * SQL Data Type: nvarchar(50)
     */
     get AttachmentStorageProvider() {
@@ -34600,7 +35520,7 @@ if this limit is exceeded.
     }
     /**
     * * Field Name: DefaultStorageAccount
-    * * Display Name: Default Storage Account
+    * * Display Name: Default Storage Account Name
     * * SQL Data Type: nvarchar(200)
     */
     get DefaultStorageAccount() {
@@ -61468,7 +62388,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: EntityID
-    * * Display Name: Entity ID
+    * * Display Name: Entity
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)
     */
@@ -61487,7 +62407,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: Name
-    * * Display Name: Name
+    * * Display Name: Field Name
     * * SQL Data Type: nvarchar(255)
     * * Description: Name of the field within the database table
     */
@@ -61571,7 +62491,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: Type
-    * * Display Name: Data Type
+    * * Display Name: SQL Type
     * * SQL Data Type: nvarchar(100)
     * * Description: SQL Data type (auto maintained by CodeGen)
     */
@@ -61771,7 +62691,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: IncludeInUserSearchAPI
-    * * Display Name: Include In User Search
+    * * Display Name: Include In Search
     * * SQL Data Type: bit
     * * Default Value: 0
     * * Description: If set to 1, this column will be included in user search queries for both traditional and full text search
@@ -61809,7 +62729,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: IncludeInGeneratedForm
-    * * Display Name: Include In Generated Form
+    * * Display Name: Include In Form
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: If set to 1, this field will be included in the generated form by CodeGen. If set to 0, this field will be excluded from the generated form. For custom forms, this field has no effect as the layout is controlled independently.
@@ -61822,7 +62742,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: GeneratedFormSection
-    * * Display Name: Generated Form Section
+    * * Display Name: Form Section
     * * SQL Data Type: nvarchar(10)
     * * Default Value: Details
     * * Value List Type: List
@@ -61843,7 +62763,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     * * Display Name: Is Virtual
     * * SQL Data Type: bit
     * * Default Value: 0
-    * * Description: NULL
+    * * Description: When 1, this field is read-only at the API layer (excluded from spCreate / spUpdate / GraphQL input types). Set automatically when the column is either (a) not present in the base table — e.g., a joined name lookup in the base view, or (b) a SQL Server computed column or PostgreSQL generated column. Cases (a) and (b) are distinguished by the IsComputed flag: IsVirtual=1, IsComputed=0 means view-only; IsVirtual=1, IsComputed=1 means computed/generated and physically present in the base table.
     */
     get IsVirtual() {
         return this.Get('IsVirtual');
@@ -61980,7 +62900,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: ValuesToPackWithSchema
-    * * Display Name: Values To Pack With Schema
+    * * Display Name: Values To Pack
     * * SQL Data Type: nvarchar(10)
     * * Default Value: Auto
     * * Value List Type: List
@@ -62016,7 +62936,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: AutoUpdateIsNameField
-    * * Display Name: Auto Update Is Name Field
+    * * Display Name: Auto Update Name Field
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: When 1, allows system/LLM to auto-update IsNameField; when 0, user has locked this field
@@ -62029,7 +62949,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: AutoUpdateDefaultInView
-    * * Display Name: Auto Update Default In View
+    * * Display Name: Auto Update View Default
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: When 1, allows system/LLM to auto-update DefaultInView; when 0, user has locked this field
@@ -62159,7 +63079,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: RelatedEntityJoinFields
-    * * Display Name: Related Entity Join Fields
+    * * Display Name: Related Join Fields
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON configuration for additional fields to join from the related entity into this entity's base view. Supports modes: extend (add to NameField), override (replace NameField), disable (no joins). Schema: { mode?: string, fields?: [{ field: string, alias?: string }] }
     */
@@ -62183,7 +63103,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: JSONTypeIsArray
-    * * Display Name: JSON Type Is Array
+    * * Display Name: JSON Is Array
     * * SQL Data Type: bit
     * * Default Value: 0
     * * Description: If true, the field holds a JSON array of JSONType items. The Object accessor returns Array<JSONType> | null and the setter accepts Array<JSONType> | null.
@@ -62208,9 +63128,15 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: UserSearchPredicateAPI
-    * * Display Name: User Search Predicate
+    * * Display Name: Search Predicate
     * * SQL Data Type: nvarchar(20)
     * * Default Value: Contains
+    * * Value List Type: List
+    * * Possible Values
+    *   * BeginsWith
+    *   * Contains
+    *   * EndsWith
+    *   * Exact
     * * Description: Search predicate controlling how user search queries match against this field. Valid values: BeginsWith, Contains, EndsWith, Exact.
     */
     get UserSearchPredicateAPI() {
@@ -62234,7 +63160,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: AutoUpdateFullTextSearch
-    * * Display Name: Auto Update Full Text Search
+    * * Display Name: Auto Update Full Text
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: When true, CodeGen LLM can auto-set the FullTextSearchEnabled value during code generation runs.
@@ -62259,6 +63185,19 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
         this.Set('AutoUpdateExtendedType', value);
     }
     /**
+    * * Field Name: IsComputed
+    * * Display Name: Is Computed
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: When 1, this field is a SQL Server computed column or PostgreSQL generated column — physically present in the base table but read-only at the SQL layer. Distinct from IsVirtual, which means the column is not in the base table at all (e.g., joined name lookups in the base view). A computed column has both IsVirtual=1 (read-only at the API layer) and IsComputed=1 (physically in the table). The difference matters for base-view JOIN target selection: when an FK's related Name Field is computed, the generated view joins to the related entity's base table instead of its view.
+    */
+    get IsComputed() {
+        return this.Get('IsComputed');
+    }
+    set IsComputed(value) {
+        this.Set('IsComputed', value);
+    }
+    /**
     * * Field Name: FieldCodeName
     * * Display Name: Field Code Name
     * * SQL Data Type: nvarchar(MAX)
@@ -62332,7 +63271,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: RelatedEntityBaseTable
-    * * Display Name: Related Entity Table
+    * * Display Name: Related Entity Base Table
     * * SQL Data Type: nvarchar(255)
     */
     get RelatedEntityBaseTable() {
@@ -62340,7 +63279,7 @@ let MJEntityFieldEntity = class MJEntityFieldEntity extends BaseEntity {
     }
     /**
     * * Field Name: RelatedEntityBaseView
-    * * Display Name: Related Entity View
+    * * Display Name: Related Entity Base View
     * * SQL Data Type: nvarchar(255)
     */
     get RelatedEntityBaseView() {
@@ -78961,6 +79900,234 @@ MJSchemaInfoEntity = __decorate([
     RegisterClass(BaseEntity, 'MJ: Schema Info')
 ], MJSchemaInfoEntity);
 export { MJSchemaInfoEntity };
+/**
+ * MJ: Search Execution Logs - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchExecutionLog
+ * * Base View: vwSearchExecutionLogs
+ * * @description One row per SearchEngine.search invocation. Populated by SearchEngine's post-fusion logging hook (Phase 3.2). Read by the Knowledge Hub Search Analytics dashboard (Phase 3.3) and the per-scope tuning CSV export (Phase 3.4).
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchExecutionLogEntity = class MJSearchExecutionLogEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Execution Logs record from the database
+    * @param ID: string - primary key value to load the MJ: Search Execution Logs record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchExecutionLogEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    * * Description: The SearchScope this invocation targeted. NULL for unscoped global search.
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: UserID
+    * * Display Name: User
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+    * * Description: The User who initiated the search. NULL for system / unauthenticated callers.
+    */
+    get UserID() {
+        return this.Get('UserID');
+    }
+    set UserID(value) {
+        this.Set('UserID', value);
+    }
+    /**
+    * * Field Name: AIAgentID
+    * * Display Name: AI Agent
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
+    * * Description: The AIAgent identity if the search was invoked from an agent (e.g. ScopedSearchAction). NULL for direct human-initiated searches.
+    */
+    get AIAgentID() {
+        return this.Get('AIAgentID');
+    }
+    set AIAgentID(value) {
+        this.Set('AIAgentID', value);
+    }
+    /**
+    * * Field Name: Query
+    * * Display Name: Query
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Raw query string the user / agent submitted. NVARCHAR(MAX) because some queries are long (full sentences, snippets). Stored verbatim for analytics — do NOT rely on this for permission decisions.
+    */
+    get Query() {
+        return this.Get('Query');
+    }
+    set Query(value) {
+        this.Set('Query', value);
+    }
+    /**
+    * * Field Name: TotalDurationMs
+    * * Display Name: Total Duration (ms)
+    * * SQL Data Type: int
+    * * Description: End-to-end search duration in milliseconds, measured at the SearchEngine.search call boundary (provider runs + fusion + rerank + permission filter + enrichment).
+    */
+    get TotalDurationMs() {
+        return this.Get('TotalDurationMs');
+    }
+    set TotalDurationMs(value) {
+        this.Set('TotalDurationMs', value);
+    }
+    /**
+    * * Field Name: ResultCount
+    * * Display Name: Result Count
+    * * SQL Data Type: int
+    * * Default Value: 0
+    * * Description: Number of results returned to the caller after permission filtering, deduplication, and score-threshold trimming. Use this as the hit-rate denominator (rows where ResultCount > 0).
+    */
+    get ResultCount() {
+        return this.Get('ResultCount');
+    }
+    set ResultCount(value) {
+        this.Set('ResultCount', value);
+    }
+    /**
+    * * Field Name: RerankerName
+    * * Display Name: Reranker Name
+    * * SQL Data Type: nvarchar(100)
+    * * Description: BaseReRanker.Name of the reranker that ran (e.g. 'Cohere', 'Voyage', 'OpenAI', 'BGE', 'NoopReRanker'). NULL when no rerank stage executed for this invocation.
+    */
+    get RerankerName() {
+        return this.Get('RerankerName');
+    }
+    set RerankerName(value) {
+        this.Set('RerankerName', value);
+    }
+    /**
+    * * Field Name: RerankerCostCents
+    * * Display Name: Reranker Cost (Cents)
+    * * SQL Data Type: decimal(10, 4)
+    * * Description: Total reranker spend in cents for this invocation, populated from the BaseReRanker.CostReporter callback via RerankerBudgetGuard. NULL when no rerank ran or no real-provider cost was incurred (Noop / BGE).
+    */
+    get RerankerCostCents() {
+        return this.Get('RerankerCostCents');
+    }
+    set RerankerCostCents(value) {
+        this.Set('RerankerCostCents', value);
+    }
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Value List Type: List
+    * * Possible Values
+    *   * Failure
+    *   * Forbidden
+    *   * Success
+    * * Description: Outcome of the search: 'Success' (results returned, possibly empty), 'Failure' (an exception bubbled out — see FailureReason), 'Forbidden' (the caller lacked SearchScopePermission for the requested scope). Constrained by CK_SearchExecutionLog_Status.
+    */
+    get Status() {
+        return this.Get('Status');
+    }
+    set Status(value) {
+        this.Set('Status', value);
+    }
+    /**
+    * * Field Name: FailureReason
+    * * Display Name: Failure Reason
+    * * SQL Data Type: nvarchar(500)
+    * * Description: Short human-readable failure reason when Status = 'Failure' or 'Forbidden'. NULL on success.
+    */
+    get FailureReason() {
+        return this.Get('FailureReason');
+    }
+    set FailureReason(value) {
+        this.Set('FailureReason', value);
+    }
+    /**
+    * * Field Name: ProvidersJSON
+    * * Display Name: Providers Breakdown
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON array of per-provider breakdown entries: [{"Provider":"Vector","DurationMs":123,"ResultCount":5,"ErrorMessage":null}, ...]. Used by the analytics dashboard for p50/p95 latency-by-provider charts and to spot consistently slow providers.
+    */
+    get ProvidersJSON() {
+        return this.Get('ProvidersJSON');
+    }
+    set ProvidersJSON(value) {
+        this.Set('ProvidersJSON', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: User
+    * * Display Name: User Name
+    * * SQL Data Type: nvarchar(100)
+    */
+    get User() {
+        return this.Get('User');
+    }
+    /**
+    * * Field Name: AIAgent
+    * * Display Name: AI Agent Name
+    * * SQL Data Type: nvarchar(255)
+    */
+    get AIAgent() {
+        return this.Get('AIAgent');
+    }
+};
+MJSearchExecutionLogEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Execution Logs')
+], MJSearchExecutionLogEntity);
+export { MJSearchExecutionLogEntity };
 /**
  * MJ: Search Providers - strongly typed entity sub-class
  * * Schema: __mj
@@ -79208,6 +80375,1140 @@ MJSearchProviderEntity = __decorate([
     RegisterClass(BaseEntity, 'MJ: Search Providers')
 ], MJSearchProviderEntity);
 export { MJSearchProviderEntity };
+/**
+ * MJ: Search Scope Entities - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopeEntity
+ * * Base View: vwSearchScopeEntities
+ * * @description Controls which entities participate in entity and full-text search within a scope, with optional per-entity filter and user-search-string overrides.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeEntityEntity = class MJSearchScopeEntityEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope Entities record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope Entities record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeEntityEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: EntityID
+    * * Display Name: Entity ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Entities (vwEntities.ID)
+    */
+    get EntityID() {
+        return this.Get('EntityID');
+    }
+    set EntityID(value) {
+        this.Set('EntityID', value);
+    }
+    /**
+    * * Field Name: ExtraFilter
+    * * Display Name: Extra Filter
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Optional SQL filter applied to this entity's search within this scope. Example: Status='Published' AND DepartmentID='abc'. Rendered as a Nunjucks template with SearchContext variables for multi-tenant filtering.
+    */
+    get ExtraFilter() {
+        return this.Get('ExtraFilter');
+    }
+    set ExtraFilter(value) {
+        this.Set('ExtraFilter', value);
+    }
+    /**
+    * * Field Name: UserSearchString
+    * * Display Name: User Search String
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Optional override for the UserSearchString passed to RunView for this entity within this scope. Nunjucks template (e.g., "{{ query }} AND type:policy"). NULL = pass the user's actual query through as-is.
+    */
+    get UserSearchString() {
+        return this.Get('UserSearchString');
+    }
+    set UserSearchString(value) {
+        this.Set('UserSearchString', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: Entity
+    * * Display Name: Entity
+    * * SQL Data Type: nvarchar(255)
+    */
+    get Entity() {
+        return this.Get('Entity');
+    }
+};
+MJSearchScopeEntityEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope Entities')
+], MJSearchScopeEntityEntity);
+export { MJSearchScopeEntityEntity };
+/**
+ * MJ: Search Scope External Indexes - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopeExternalIndex
+ * * Base View: vwSearchScopeExternalIndexes
+ * * @description Scoped external/provider-owned indexes. Generic — covers vector stores (Pinecone, Qdrant, PGVector) and text/hybrid engines (Elasticsearch, Typesense, Azure AI Search, OpenSearch). A single scope can mix types; each row is consumed only by the provider matching its IndexType.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeExternalIndexEntity = class MJSearchScopeExternalIndexEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope External Indexes record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope External Indexes record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeExternalIndexEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * Validate() method override for MJ: Search Scope External Indexes entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
+    * * Table-Level: To ensure search functionality works correctly, vector-based indexes must have a Vector Index ID assigned, while all other index types must have an External Index Name specified.
+    * @public
+    * @method
+    * @override
+    */
+    Validate() {
+        const result = super.Validate();
+        this.ValidateIndexTypeRequirements(result);
+        result.Success = result.Success && (result.Errors.length === 0);
+        return result;
+    }
+    /**
+    * To ensure search functionality works correctly, vector-based indexes must have a Vector Index ID assigned, while all other index types must have an External Index Name specified.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateIndexTypeRequirements(result) {
+        // If the index is a Vector type, ensure a Vector Index ID is provided
+        if (this.IndexType === 'Vector' && this.VectorIndexID == null) {
+            result.Errors.push(new ValidationErrorInfo("VectorIndexID", "A Vector Index ID is required when the Index Type is set to 'Vector'.", this.VectorIndexID, ValidationErrorType.Failure));
+        }
+        // If the index is not a Vector type, ensure an External Index Name is provided
+        if (this.IndexType !== 'Vector' && (this.ExternalIndexName == null || this.ExternalIndexName.length === 0)) {
+            result.Errors.push(new ValidationErrorInfo("ExternalIndexName", "An External Index Name is required for the selected Index Type.", this.ExternalIndexName, ValidationErrorType.Failure));
+        }
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: IndexType
+    * * Display Name: Index Type
+    * * SQL Data Type: nvarchar(40)
+    * * Default Value: Vector
+    * * Value List Type: List
+    * * Possible Values
+    *   * AzureAISearch
+    *   * Elasticsearch
+    *   * OpenSearch
+    *   * Other
+    *   * Typesense
+    *   * Vector
+    * * Description: Discriminator. Determines which provider class consumes this row: Vector | Elasticsearch | Typesense | AzureAISearch | OpenSearch | Other.
+    */
+    get IndexType() {
+        return this.Get('IndexType');
+    }
+    set IndexType(value) {
+        this.Set('IndexType', value);
+    }
+    /**
+    * * Field Name: VectorIndexID
+    * * Display Name: Vector Index ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Vector Indexes (vwVectorIndexes.ID)
+    * * Description: FK to VectorIndex. REQUIRED when IndexType='Vector'. NULL for all other IndexType values.
+    */
+    get VectorIndexID() {
+        return this.Get('VectorIndexID');
+    }
+    set VectorIndexID(value) {
+        this.Set('VectorIndexID', value);
+    }
+    /**
+    * * Field Name: ExternalIndexName
+    * * Display Name: External Index Name
+    * * SQL Data Type: nvarchar(400)
+    * * Description: For non-vector IndexTypes: the remote engine's index/collection/alias name (e.g., Elasticsearch index "kb_docs_v3", Typesense collection "articles"). NULL for IndexType='Vector' (VectorIndexID resolves the name instead).
+    */
+    get ExternalIndexName() {
+        return this.Get('ExternalIndexName');
+    }
+    set ExternalIndexName(value) {
+        this.Set('ExternalIndexName', value);
+    }
+    /**
+    * * Field Name: ExternalIndexConfig
+    * * Display Name: External Index Config
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON with extra connection/config hints the provider needs (cluster alias, routing key, custom analyzer, etc.). Provider-interpreted.
+    */
+    get ExternalIndexConfig() {
+        return this.Get('ExternalIndexConfig');
+    }
+    set ExternalIndexConfig(value) {
+        this.Set('ExternalIndexConfig', value);
+    }
+    /**
+    * * Field Name: MetadataFilter
+    * * Display Name: Metadata Filter
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON filter expression applied as a native metadata filter on the remote engine. Pinecone/Qdrant/PGVector metadata filter, or Elasticsearch filter DSL, etc. Rendered as a Nunjucks template so SearchContext.PrimaryScopeRecordID and SearchContext.SecondaryScopes.* can be interpolated for multi-tenant filtering.
+    */
+    get MetadataFilter() {
+        return this.Get('MetadataFilter');
+    }
+    set MetadataFilter(value) {
+        this.Set('MetadataFilter', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: VectorIndex
+    * * Display Name: Vector Index
+    * * SQL Data Type: nvarchar(255)
+    */
+    get VectorIndex() {
+        return this.Get('VectorIndex');
+    }
+};
+MJSearchScopeExternalIndexEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope External Indexes')
+], MJSearchScopeExternalIndexEntity);
+export { MJSearchScopeExternalIndexEntity };
+/**
+ * MJ: Search Scope Permissions - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopePermission
+ * * Base View: vwSearchScopePermissions
+ * * @description Per-user or per-role permission grant on a SearchScope. Exactly one of UserID or RoleID is set on each row; the other is NULL. PermissionLevel is one of None, Read, Search, Manage. Combined with AIAgent.SearchScopeAccess for agent-side fallbacks via the SearchScopePermissionResolver.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopePermissionEntity = class MJSearchScopePermissionEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope Permissions record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope Permissions record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopePermissionEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * Validate() method override for MJ: Search Scope Permissions entity. This is an auto-generated method that invokes the generated validators for this entity for the following fields:
+    * * Table-Level: Each record must be assigned to either a specific user or a specific role, but not both. This ensures that permissions or scopes are clearly defined for a single entity type and prevents ambiguous assignments.
+    * @public
+    * @method
+    * @override
+    */
+    Validate() {
+        const result = super.Validate();
+        this.ValidateUserIDAndRoleIDExclusiveAssignment(result);
+        result.Success = result.Success && (result.Errors.length === 0);
+        return result;
+    }
+    /**
+    * Each record must be assigned to either a specific user or a specific role, but not both. This ensures that permissions or scopes are clearly defined for a single entity type and prevents ambiguous assignments.
+    * @param result - the ValidationResult object to add any errors or warnings to
+    * @public
+    * @method
+    */
+    ValidateUserIDAndRoleIDExclusiveAssignment(result) {
+        // Check if both fields are null (violates the requirement that at least one must be set)
+        if (this.UserID == null && this.RoleID == null) {
+            result.Errors.push(new ValidationErrorInfo("UserID", "Each record must be assigned to either a User or a Role.", this.UserID, ValidationErrorType.Failure));
+        }
+        // Check if both fields are populated (violates the requirement that only one can be set)
+        if (this.UserID != null && this.RoleID != null) {
+            result.Errors.push(new ValidationErrorInfo("UserID", "A record cannot be assigned to both a User and a Role simultaneously.", this.UserID, ValidationErrorType.Failure));
+        }
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    * * Description: Primary key. Auto-generated.
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    * * Description: The SearchScope this permission row applies to.
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: UserID
+    * * Display Name: User
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+    * * Description: The user this permission applies to. Mutually exclusive with RoleID — exactly one must be set.
+    */
+    get UserID() {
+        return this.Get('UserID');
+    }
+    set UserID(value) {
+        this.Set('UserID', value);
+    }
+    /**
+    * * Field Name: RoleID
+    * * Display Name: Role
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Roles (vwRoles.ID)
+    * * Description: The role this permission applies to. Mutually exclusive with UserID — exactly one must be set. Permissions granted via roles flow to all users in that role.
+    */
+    get RoleID() {
+        return this.Get('RoleID');
+    }
+    set RoleID(value) {
+        this.Set('RoleID', value);
+    }
+    /**
+    * * Field Name: PermissionLevel
+    * * Display Name: Permission Level
+    * * SQL Data Type: nvarchar(20)
+    * * Value List Type: List
+    * * Possible Values
+    *   * Manage
+    *   * None
+    *   * Read
+    *   * Search
+    * * Description: Capability granted on this SearchScope. None = explicit deny (overrides role grants), Read = view scope metadata, Search = invoke ScopedSearchAction, Manage = full edit including authoring of permission rows. The resolver picks the highest level when multiple grants apply (direct + role).
+    */
+    get PermissionLevel() {
+        return this.Get('PermissionLevel');
+    }
+    set PermissionLevel(value) {
+        this.Set('PermissionLevel', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: User
+    * * Display Name: User Name
+    * * SQL Data Type: nvarchar(100)
+    */
+    get User() {
+        return this.Get('User');
+    }
+    /**
+    * * Field Name: Role
+    * * Display Name: Role Name
+    * * SQL Data Type: nvarchar(50)
+    */
+    get Role() {
+        return this.Get('Role');
+    }
+};
+MJSearchScopePermissionEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope Permissions')
+], MJSearchScopePermissionEntity);
+export { MJSearchScopePermissionEntity };
+/**
+ * MJ: Search Scope Providers - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopeProvider
+ * * Base View: vwSearchScopeProviders
+ * * @description Controls which SearchProviders participate in a given SearchScope. Each row enables one provider within one scope, with optional overrides.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeProviderEntity = class MJSearchScopeProviderEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope Providers record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope Providers record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeProviderEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: SearchProviderID
+    * * Display Name: Search Provider
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Providers (vwSearchProviders.ID)
+    */
+    get SearchProviderID() {
+        return this.Get('SearchProviderID');
+    }
+    set SearchProviderID(value) {
+        this.Set('SearchProviderID', value);
+    }
+    /**
+    * * Field Name: Enabled
+    * * Display Name: Enabled
+    * * SQL Data Type: bit
+    * * Default Value: 1
+    * * Description: Whether this provider is active for this scope. Lets an admin toggle providers off per-scope without deleting the row.
+    */
+    get Enabled() {
+        return this.Get('Enabled');
+    }
+    set Enabled(value) {
+        this.Set('Enabled', value);
+    }
+    /**
+    * * Field Name: MaxResultsOverride
+    * * Display Name: Max Results Override
+    * * SQL Data Type: int
+    * * Description: Override the max-results value for this provider within this scope. NULL = use the provider's default.
+    */
+    get MaxResultsOverride() {
+        return this.Get('MaxResultsOverride');
+    }
+    set MaxResultsOverride(value) {
+        this.Set('MaxResultsOverride', value);
+    }
+    /**
+    * * Field Name: ProviderConfigOverride
+    * * Display Name: Provider Config Override
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON override for provider-specific configuration within this scope. Provider interprets.
+    */
+    get ProviderConfigOverride() {
+        return this.Get('ProviderConfigOverride');
+    }
+    set ProviderConfigOverride(value) {
+        this.Set('ProviderConfigOverride', value);
+    }
+    /**
+    * * Field Name: QueryTransformTemplateID
+    * * Display Name: Query Transform Template
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Templates (vwTemplates.ID)
+    * * Description: Optional FK to Templates. When set, the user/agent query is rewritten through this Template before being sent to this provider. Lets vector providers get a chunk-shaped rewrite while FTS providers get keyword extraction within the same scope. Resolution order: this > AIAgentSearchScope.QueryTemplateID > raw lastUserMessage.
+    */
+    get QueryTransformTemplateID() {
+        return this.Get('QueryTransformTemplateID');
+    }
+    set QueryTransformTemplateID(value) {
+        this.Set('QueryTransformTemplateID', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: SearchProvider
+    * * Display Name: Search Provider Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchProvider() {
+        return this.Get('SearchProvider');
+    }
+    /**
+    * * Field Name: QueryTransformTemplate
+    * * Display Name: Query Transform Template Name
+    * * SQL Data Type: nvarchar(255)
+    */
+    get QueryTransformTemplate() {
+        return this.Get('QueryTransformTemplate');
+    }
+};
+MJSearchScopeProviderEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope Providers')
+], MJSearchScopeProviderEntity);
+export { MJSearchScopeProviderEntity };
+/**
+ * MJ: Search Scope Storage Accounts - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopeStorageAccount
+ * * Base View: vwSearchScopeStorageAccounts
+ * * @description Controls which file storage accounts/folders participate in a scope.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeStorageAccountEntity = class MJSearchScopeStorageAccountEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope Storage Accounts record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope Storage Accounts record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeStorageAccountEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: FileStorageAccountID
+    * * Display Name: Storage Account
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: File Storage Accounts (vwFileStorageAccounts.ID)
+    */
+    get FileStorageAccountID() {
+        return this.Get('FileStorageAccountID');
+    }
+    set FileStorageAccountID(value) {
+        this.Set('FileStorageAccountID', value);
+    }
+    /**
+    * * Field Name: FolderPath
+    * * Display Name: Folder Path
+    * * SQL Data Type: nvarchar(1000)
+    * * Description: Optional folder path restriction. NULL = entire storage account. Example: /policies/hr/. Rendered as a Nunjucks template with SearchContext variables so platforms can do per-tenant folder routing like /tenants/{{ context.PrimaryScopeRecordID }}/.
+    */
+    get FolderPath() {
+        return this.Get('FolderPath');
+    }
+    set FolderPath(value) {
+        this.Set('FolderPath', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+    /**
+    * * Field Name: FileStorageAccount
+    * * Display Name: Storage Account Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get FileStorageAccount() {
+        return this.Get('FileStorageAccount');
+    }
+};
+MJSearchScopeStorageAccountEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope Storage Accounts')
+], MJSearchScopeStorageAccountEntity);
+export { MJSearchScopeStorageAccountEntity };
+/**
+ * MJ: Search Scope Test Queries - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScopeTestQuery
+ * * Base View: vwSearchScopeTestQueries
+ * * @description Canonical test queries owned by a SearchScope. Used by scope authors to validate tuning changes — re-run a saved query after swapping the reranker or adjusting fusion weights and compare results to the prior run.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeTestQueryEntity = class MJSearchScopeTestQueryEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scope Test Queries record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scope Test Queries record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeTestQueryEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: SearchScopeID
+    * * Display Name: Search Scope
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Search Scopes (vwSearchScopes.ID)
+    * * Description: The SearchScope this test query belongs to. Cascade-restricted via FK so accidental scope deletion preserves test history.
+    */
+    get SearchScopeID() {
+        return this.Get('SearchScopeID');
+    }
+    set SearchScopeID(value) {
+        this.Set('SearchScopeID', value);
+    }
+    /**
+    * * Field Name: Label
+    * * Display Name: Label
+    * * SQL Data Type: nvarchar(200)
+    * * Description: Short human-readable label for the test query, shown in the form's test-query grid (e.g. "VIP customer escalation", "expense reimbursement policy").
+    */
+    get Label() {
+        return this.Get('Label');
+    }
+    set Label(value) {
+        this.Set('Label', value);
+    }
+    /**
+    * * Field Name: Query
+    * * Display Name: Query
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: The query text itself. NVARCHAR(MAX) because canonical queries can be full sentences or chunks of natural-language context.
+    */
+    get Query() {
+        return this.Get('Query');
+    }
+    set Query(value) {
+        this.Set('Query', value);
+    }
+    /**
+    * * Field Name: ExpectedTopResultEntity
+    * * Display Name: Expected Top Result Entity
+    * * SQL Data Type: nvarchar(255)
+    * * Description: Optional MJ entity name (e.g. "Contacts", "Documents") of the expected top result. When set together with ExpectedTopResultRecordID, lets the test runner assert that the tuned scope returns the right record at rank #1 — a regression tripwire for fusion / reranker changes.
+    */
+    get ExpectedTopResultEntity() {
+        return this.Get('ExpectedTopResultEntity');
+    }
+    set ExpectedTopResultEntity(value) {
+        this.Set('ExpectedTopResultEntity', value);
+    }
+    /**
+    * * Field Name: ExpectedTopResultRecordID
+    * * Display Name: Expected Top Result Record ID
+    * * SQL Data Type: uniqueidentifier
+    * * Description: Optional record ID of the expected top result, paired with ExpectedTopResultEntity. NULL = no assertion (the query is exploratory).
+    */
+    get ExpectedTopResultRecordID() {
+        return this.Get('ExpectedTopResultRecordID');
+    }
+    set ExpectedTopResultRecordID(value) {
+        this.Set('ExpectedTopResultRecordID', value);
+    }
+    /**
+    * * Field Name: Notes
+    * * Display Name: Notes
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Free-form notes explaining why this query is canonical or what edge case it represents.
+    */
+    get Notes() {
+        return this.Get('Notes');
+    }
+    set Notes(value) {
+        this.Set('Notes', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: SearchScope
+    * * Display Name: Search Scope Name
+    * * SQL Data Type: nvarchar(200)
+    */
+    get SearchScope() {
+        return this.Get('SearchScope');
+    }
+};
+MJSearchScopeTestQueryEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scope Test Queries')
+], MJSearchScopeTestQueryEntity);
+export { MJSearchScopeTestQueryEntity };
+/**
+ * MJ: Search Scopes - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: SearchScope
+ * * Base View: vwSearchScopes
+ * * @description A named, reusable boundary defining WHICH content participates in a search (providers, external indexes, entities, storage accounts). Combined with a runtime SearchContext, it enables multi-tenant, permission-aware, agent-friendly retrieval. See plans/search-scopes-rag-plus.md.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+let MJSearchScopeEntity = class MJSearchScopeEntity extends BaseEntity {
+    /**
+    * Loads the MJ: Search Scopes record from the database
+    * @param ID: string - primary key value to load the MJ: Search Scopes record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJSearchScopeEntity
+    * @method
+    * @override
+    */
+    async Load(ID, EntityRelationshipsToLoad) {
+        const compositeKey = new CompositeKey();
+        compositeKey.KeyValuePairs.push({ FieldName: 'ID', Value: ID });
+        return await super.InnerLoad(compositeKey, EntityRelationshipsToLoad);
+    }
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID() {
+        return this.Get('ID');
+    }
+    set ID(value) {
+        this.Set('ID', value);
+    }
+    /**
+    * * Field Name: Name
+    * * Display Name: Name
+    * * SQL Data Type: nvarchar(200)
+    * * Description: Human-readable scope name (e.g., "HR Policies", "Engineering Docs"). Unique across the system.
+    */
+    get Name() {
+        return this.Get('Name');
+    }
+    set Name(value) {
+        this.Set('Name', value);
+    }
+    /**
+    * * Field Name: Description
+    * * Display Name: Description
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Detailed description of what this scope covers. Surfaced to agents in the available-scopes prompt injection so the LLM can choose a scope.
+    */
+    get Description() {
+        return this.Get('Description');
+    }
+    set Description(value) {
+        this.Set('Description', value);
+    }
+    /**
+    * * Field Name: Icon
+    * * Display Name: Icon
+    * * SQL Data Type: nvarchar(200)
+    * * Description: Font Awesome (or equivalent) icon class used by the scope selector UI.
+    */
+    get Icon() {
+        return this.Get('Icon');
+    }
+    set Icon(value) {
+        this.Set('Icon', value);
+    }
+    /**
+    * * Field Name: IsGlobal
+    * * Display Name: Is Global
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: If true, this scope includes everything (equivalent to no scope filtering). Exactly one Global scope should exist; it is seeded via metadata sync.
+    */
+    get IsGlobal() {
+        return this.Get('IsGlobal');
+    }
+    set IsGlobal(value) {
+        this.Set('IsGlobal', value);
+    }
+    /**
+    * * Field Name: IsDefault
+    * * Display Name: Is Default
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: If true, this is the default scope for users/agents that do not specify one.
+    */
+    get IsDefault() {
+        return this.Get('IsDefault');
+    }
+    set IsDefault(value) {
+        this.Set('IsDefault', value);
+    }
+    /**
+    * * Field Name: OwnerUserID
+    * * Display Name: Owner User
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
+    * * Description: NULL = organization-wide scope. Set = personal scope owned by this user (visible/usable only by that user unless explicitly shared).
+    */
+    get OwnerUserID() {
+        return this.Get('OwnerUserID');
+    }
+    set OwnerUserID(value) {
+        this.Set('OwnerUserID', value);
+    }
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Inactive
+    * * Description: Lifecycle status. Only Active scopes are considered at query time.
+    */
+    get Status() {
+        return this.Get('Status');
+    }
+    set Status(value) {
+        this.Set('Status', value);
+    }
+    /**
+    * * Field Name: StartAt
+    * * Display Name: Start At
+    * * SQL Data Type: datetimeoffset
+    * * Description: Optional time-window activation. Scope is inactive before StartAt. NULL = immediately active.
+    */
+    get StartAt() {
+        return this.Get('StartAt');
+    }
+    set StartAt(value) {
+        this.Set('StartAt', value);
+    }
+    /**
+    * * Field Name: EndAt
+    * * Display Name: End At
+    * * SQL Data Type: datetimeoffset
+    * * Description: Optional time-window deactivation. Scope is inactive after EndAt. NULL = no expiry.
+    */
+    get EndAt() {
+        return this.Get('EndAt');
+    }
+    set EndAt(value) {
+        this.Set('EndAt', value);
+    }
+    /**
+    * * Field Name: ScopeConfig
+    * * Display Name: Scope Configuration
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON configuration for advanced scope behavior. Recognized keys: rrfK (RRF k parameter), fusionWeights (per-provider weights), reRanker (optional re-ranker stage config: driverClass, inputTopN, outputTopN, config), permissionOverfetchFactor.
+    */
+    get ScopeConfig() {
+        return this.Get('ScopeConfig');
+    }
+    set ScopeConfig(value) {
+        this.Set('ScopeConfig', value);
+    }
+    /**
+    * * Field Name: SearchContextConfig
+    * * Display Name: Search Context Configuration
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON defining available multi-tenant SearchContext dimensions, inheritance modes, and validation rules. Uses the SecondaryScopeConfig structure shared with the agent memory system (@memberjunction/ai-core-plus). NULL = scope is not multi-tenant aware.
+    */
+    get SearchContextConfig() {
+        return this.Get('SearchContextConfig');
+    }
+    set SearchContextConfig(value) {
+        this.Set('SearchContextConfig', value);
+    }
+    /**
+    * * Field Name: RerankerBudgetCents
+    * * Display Name: Reranker Budget (Cents)
+    * * SQL Data Type: int
+    * * Description: Optional cap on reranker spend (in cents) per search invocation against this scope. NULL means uncapped — existing behavior. When set, the SearchEngine's budget guard short-circuits any reranker call whose projected cost would push the run total past this value, and accumulates actual post-call cost via each reranker's CostReporter callback (BaseReRanker.CostReporter). Real-provider rerankers (Cohere, Voyage, OpenAI) report cost; NoopReRanker and BGEReRanker report zero (local / pass-through).
+    */
+    get RerankerBudgetCents() {
+        return this.Get('RerankerBudgetCents');
+    }
+    set RerankerBudgetCents(value) {
+        this.Set('RerankerBudgetCents', value);
+    }
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt() {
+        return this.Get('__mj_CreatedAt');
+    }
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt() {
+        return this.Get('__mj_UpdatedAt');
+    }
+    /**
+    * * Field Name: OwnerUser
+    * * Display Name: Owner User Name
+    * * SQL Data Type: nvarchar(100)
+    */
+    get OwnerUser() {
+        return this.Get('OwnerUser');
+    }
+};
+MJSearchScopeEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ: Search Scopes')
+], MJSearchScopeEntity);
+export { MJSearchScopeEntity };
 /**
  * MJ: Skills - strongly typed entity sub-class
  * * Schema: __mj