@memberjunction/core-entities 5.48.0 → 5.49.0

package/dist/generated/entity_subclasses.d.ts

@@ -1626,7 +1626,7 @@ export declare const MJAIAgentRunStepSchema: z.ZodObject<{
     ID: z.ZodString;
     AgentRunID: z.ZodString;
     StepNumber: z.ZodNumber;
-    StepType: z.ZodUnion<[z.ZodLiteral<"Actions">, z.ZodLiteral<"Chat">, z.ZodLiteral<"Decision">, z.ZodLiteral<"ForEach">, z.ZodLiteral<"Plan">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Skill">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"Tool">, z.ZodLiteral<"Validation">, z.ZodLiteral<"While">]>;
+    StepType: z.ZodUnion<[z.ZodLiteral<"Actions">, z.ZodLiteral<"Chat">, z.ZodLiteral<"Compaction">, z.ZodLiteral<"Decision">, z.ZodLiteral<"ForEach">, z.ZodLiteral<"Plan">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Skill">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"Tool">, z.ZodLiteral<"Validation">, z.ZodLiteral<"While">]>;
     StepName: z.ZodString;
     TargetID: z.ZodNullable<z.ZodString>;
     Status: z.ZodUnion<[z.ZodLiteral<"Cancelled">, z.ZodLiteral<"Completed">, z.ZodLiteral<"Failed">, z.ZodLiteral<"Running">]>;
@@ -1662,7 +1662,7 @@ export declare const MJAIAgentRunStepSchema: z.ZodObject<{
     AgentRunID?: string;
     AgentRun?: string;
     StepNumber?: number;
-    StepType?: "Prompt" | "Actions" | "Chat" | "Decision" | "ForEach" | "Plan" | "Skill" | "Sub-Agent" | "Tool" | "Validation" | "While";
+    StepType?: "Prompt" | "Actions" | "Chat" | "Compaction" | "Decision" | "ForEach" | "Plan" | "Skill" | "Sub-Agent" | "Tool" | "Validation" | "While";
     StepName?: string;
     TargetID?: string;
     CompletedAt?: Date;
@@ -1689,7 +1689,7 @@ export declare const MJAIAgentRunStepSchema: z.ZodObject<{
     AgentRunID?: string;
     AgentRun?: string;
     StepNumber?: number;
-    StepType?: "Prompt" | "Actions" | "Chat" | "Decision" | "ForEach" | "Plan" | "Skill" | "Sub-Agent" | "Tool" | "Validation" | "While";
+    StepType?: "Prompt" | "Actions" | "Chat" | "Compaction" | "Decision" | "ForEach" | "Plan" | "Skill" | "Sub-Agent" | "Tool" | "Validation" | "While";
     StepName?: string;
     TargetID?: string;
     CompletedAt?: Date;
@@ -2386,8 +2386,17 @@ export declare const MJAIAgentTypeSchema: z.ZodObject<{
     DefaultStorageAccountID: z.ZodNullable<z.ZodString>;
     ConfigSchema: z.ZodNullable<z.ZodString>;
     DefaultConfiguration: z.ZodNullable<z.ZodString>;
+    ContextCompressionMessageThreshold: z.ZodNullable<z.ZodNumber>;
+    ContextCompressionPromptID: z.ZodNullable<z.ZodString>;
+    ContextCompressionMessageRetentionCount: z.ZodNullable<z.ZodNumber>;
+    ContextWindowMaxTokens: z.ZodNullable<z.ZodNumber>;
+    CompactionTriggerPercent: z.ZodNumber;
+    CompactionTargetPercent: z.ZodNumber;
+    ConversationSummaryPromptID: z.ZodNullable<z.ZodString>;
     SystemPrompt: z.ZodNullable<z.ZodString>;
     DefaultStorageAccount: z.ZodNullable<z.ZodString>;
+    ContextCompressionPrompt: z.ZodNullable<z.ZodString>;
+    ConversationSummaryPrompt: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ID?: string;
     __mj_CreatedAt?: Date;
@@ -2407,7 +2416,16 @@ export declare const MJAIAgentTypeSchema: z.ZodObject<{
     UIFormSectionExpandedByDefault?: boolean;
     PromptParamsSchema?: string;
     DefaultConfiguration?: string;
+    ContextCompressionMessageThreshold?: number;
+    ContextCompressionPromptID?: string;
+    ContextCompressionMessageRetentionCount?: number;
+    ContextWindowMaxTokens?: number;
+    CompactionTriggerPercent?: number;
+    CompactionTargetPercent?: number;
+    ConversationSummaryPromptID?: string;
     SystemPrompt?: string;
+    ContextCompressionPrompt?: string;
+    ConversationSummaryPrompt?: string;
 }, {
     ID?: string;
     __mj_CreatedAt?: Date;
@@ -2427,7 +2445,16 @@ export declare const MJAIAgentTypeSchema: z.ZodObject<{
     UIFormSectionExpandedByDefault?: boolean;
     PromptParamsSchema?: string;
     DefaultConfiguration?: string;
+    ContextCompressionMessageThreshold?: number;
+    ContextCompressionPromptID?: string;
+    ContextCompressionMessageRetentionCount?: number;
+    ContextWindowMaxTokens?: number;
+    CompactionTriggerPercent?: number;
+    CompactionTargetPercent?: number;
+    ConversationSummaryPromptID?: string;
     SystemPrompt?: string;
+    ContextCompressionPrompt?: string;
+    ConversationSummaryPrompt?: string;
 }>;
 export type MJAIAgentTypeEntityType = z.infer<typeof MJAIAgentTypeSchema>;
 /**
@@ -2510,6 +2537,10 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     AcceptsSkills: z.ZodUnion<[z.ZodLiteral<"All">, z.ZodLiteral<"Limited">, z.ZodLiteral<"None">]>;
     SkillActivationMode: z.ZodUnion<[z.ZodLiteral<"Auto">, z.ZodLiteral<"RequestedOnly">]>;
     RequirePlanMode: z.ZodBoolean;
+    ContextWindowMaxTokens: z.ZodNullable<z.ZodNumber>;
+    CompactionTriggerPercent: z.ZodNullable<z.ZodNumber>;
+    CompactionTargetPercent: z.ZodNullable<z.ZodNumber>;
+    ConversationSummaryPromptID: z.ZodNullable<z.ZodString>;
     Parent: z.ZodNullable<z.ZodString>;
     ContextCompressionPrompt: z.ZodNullable<z.ZodString>;
     Type: z.ZodNullable<z.ZodString>;
@@ -2521,6 +2552,7 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     DefaultCoAgent: z.ZodNullable<z.ZodString>;
     RecordingStorageProvider: z.ZodNullable<z.ZodString>;
     DefaultMediaCollection: z.ZodNullable<z.ZodString>;
+    ConversationSummaryPrompt: z.ZodNullable<z.ZodString>;
     RootParentID: z.ZodNullable<z.ZodString>;
     RootDefaultCoAgentID: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -2545,13 +2577,19 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     ExecutionOrder?: number;
     MessageMode?: "None" | "All" | "Bookend" | "Latest";
     MaxMessages?: number;
+    ContextCompressionMessageThreshold?: number;
+    ContextCompressionPromptID?: string;
+    ContextCompressionMessageRetentionCount?: number;
+    ContextWindowMaxTokens?: number;
+    CompactionTriggerPercent?: number;
+    CompactionTargetPercent?: number;
+    ConversationSummaryPromptID?: string;
+    ContextCompressionPrompt?: string;
+    ConversationSummaryPrompt?: string;
     LogoURL?: string;
     ExposeAsAction?: boolean;
     ExecutionMode?: "Parallel" | "Sequential";
     EnableContextCompression?: boolean;
-    ContextCompressionMessageThreshold?: number;
-    ContextCompressionPromptID?: string;
-    ContextCompressionMessageRetentionCount?: number;
     TypeID?: string;
     ModelSelectionMode?: "Agent" | "Agent Type";
     PayloadDownstreamPaths?: string;
@@ -2605,7 +2643,6 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     AcceptsSkills?: "None" | "All" | "Limited";
     SkillActivationMode?: "Auto" | "RequestedOnly";
     RequirePlanMode?: boolean;
-    ContextCompressionPrompt?: string;
     DefaultArtifactType?: string;
     OwnerUser?: string;
     AttachmentStorageProvider?: string;
@@ -2635,13 +2672,19 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     ExecutionOrder?: number;
     MessageMode?: "None" | "All" | "Bookend" | "Latest";
     MaxMessages?: number;
+    ContextCompressionMessageThreshold?: number;
+    ContextCompressionPromptID?: string;
+    ContextCompressionMessageRetentionCount?: number;
+    ContextWindowMaxTokens?: number;
+    CompactionTriggerPercent?: number;
+    CompactionTargetPercent?: number;
+    ConversationSummaryPromptID?: string;
+    ContextCompressionPrompt?: string;
+    ConversationSummaryPrompt?: string;
     LogoURL?: string;
     ExposeAsAction?: boolean;
     ExecutionMode?: "Parallel" | "Sequential";
     EnableContextCompression?: boolean;
-    ContextCompressionMessageThreshold?: number;
-    ContextCompressionPromptID?: string;
-    ContextCompressionMessageRetentionCount?: number;
     TypeID?: string;
     ModelSelectionMode?: "Agent" | "Agent Type";
     PayloadDownstreamPaths?: string;
@@ -2695,7 +2738,6 @@ export declare const MJAIAgentSchema: z.ZodObject<{
     AcceptsSkills?: "None" | "All" | "Limited";
     SkillActivationMode?: "Auto" | "RequestedOnly";
     RequirePlanMode?: boolean;
-    ContextCompressionPrompt?: string;
     DefaultArtifactType?: string;
     OwnerUser?: string;
     AttachmentStorageProvider?: string;
@@ -7802,6 +7844,8 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     UtteranceStartMs: z.ZodNullable<z.ZodNumber>;
     UtteranceEndMs: z.ZodNullable<z.ZodNumber>;
     MediaType: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Audio">, z.ZodLiteral<"Text">, z.ZodLiteral<"Video">]>>;
+    Sequence: z.ZodNumber;
+    SummaryPromptRunID: z.ZodNullable<z.ZodString>;
     Conversation: z.ZodNullable<z.ZodString>;
     User: z.ZodNullable<z.ZodString>;
     Artifact: z.ZodNullable<z.ZodString>;
@@ -7809,6 +7853,7 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     Parent: z.ZodNullable<z.ZodString>;
     Agent: z.ZodNullable<z.ZodString>;
     TestRun: z.ZodNullable<z.ZodString>;
+    SummaryPromptRun: z.ZodNullable<z.ZodString>;
     RootParentID: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ID?: string;
@@ -7824,6 +7869,7 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     Message?: string;
     AgentID?: string;
     Agent?: string;
+    Sequence?: number;
     Conversation?: string;
     ConversationID?: string;
     TestRunID?: string;
@@ -7851,6 +7897,8 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     UtteranceStartMs?: number;
     UtteranceEndMs?: number;
     MediaType?: "Audio" | "Video" | "Text";
+    SummaryPromptRunID?: string;
+    SummaryPromptRun?: string;
 }, {
     ID?: string;
     Role?: "User" | "Error" | "AI";
@@ -7865,6 +7913,7 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     Message?: string;
     AgentID?: string;
     Agent?: string;
+    Sequence?: number;
     Conversation?: string;
     ConversationID?: string;
     TestRunID?: string;
@@ -7892,6 +7941,8 @@ export declare const MJConversationDetailSchema: z.ZodObject<{
     UtteranceStartMs?: number;
     UtteranceEndMs?: number;
     MediaType?: "Audio" | "Video" | "Text";
+    SummaryPromptRunID?: string;
+    SummaryPromptRun?: string;
 }>;
 export type MJConversationDetailEntityType = z.infer<typeof MJConversationDetailSchema>;
 /**
@@ -18125,6 +18176,56 @@ export declare const MJTestSchema: z.ZodObject<{
     RepeatCount?: number;
 }>;
 export type MJTestEntityType = z.infer<typeof MJTestSchema>;
+/**
+ * zod schema definition for the entity MJ: Themes
+ */
+export declare const MJThemeSchema: z.ZodObject<{
+    ID: z.ZodString;
+    Name: z.ZodString;
+    Description: z.ZodNullable<z.ZodString>;
+    Seeds: z.ZodString;
+    LightMarkURL: z.ZodNullable<z.ZodString>;
+    DarkMarkURL: z.ZodNullable<z.ZodString>;
+    WordmarkURL: z.ZodNullable<z.ZodString>;
+    MonochromeURL: z.ZodNullable<z.ZodString>;
+    IsDefault: z.ZodBoolean;
+    Status: z.ZodUnion<[z.ZodLiteral<"Active">, z.ZodLiteral<"Draft">, z.ZodLiteral<"Inactive">]>;
+    Overrides: z.ZodNullable<z.ZodString>;
+    CustomCSS: z.ZodNullable<z.ZodString>;
+    __mj_CreatedAt: z.ZodDate;
+    __mj_UpdatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    ID?: string;
+    __mj_CreatedAt?: Date;
+    __mj_UpdatedAt?: Date;
+    Name?: string;
+    Description?: string;
+    Status?: "Active" | "Inactive" | "Draft";
+    IsDefault?: boolean;
+    Seeds?: string;
+    LightMarkURL?: string;
+    DarkMarkURL?: string;
+    WordmarkURL?: string;
+    MonochromeURL?: string;
+    Overrides?: string;
+    CustomCSS?: string;
+}, {
+    ID?: string;
+    __mj_CreatedAt?: Date;
+    __mj_UpdatedAt?: Date;
+    Name?: string;
+    Description?: string;
+    Status?: "Active" | "Inactive" | "Draft";
+    IsDefault?: boolean;
+    Seeds?: string;
+    LightMarkURL?: string;
+    DarkMarkURL?: string;
+    WordmarkURL?: string;
+    MonochromeURL?: string;
+    Overrides?: string;
+    CustomCSS?: string;
+}>;
+export type MJThemeEntityType = z.infer<typeof MJThemeSchema>;
 /**
  * zod schema definition for the entity MJ: User Application Entities
  */
@@ -24562,6 +24663,7 @@ export declare class MJAIAgentRunStepEntity extends BaseEntity<MJAIAgentRunStepE
     * * Possible Values
     *   * Actions
     *   * Chat
+    *   * Compaction
     *   * Decision
     *   * ForEach
     *   * Plan
@@ -24573,8 +24675,8 @@ export declare class MJAIAgentRunStepEntity extends BaseEntity<MJAIAgentRunStepE
     *   * While
     * * Description: Type of execution step: Prompt, Actions, Sub-Agent, Decision, Chat, Validation, ForEach, While, Tool
     */
-    get StepType(): 'Actions' | 'Chat' | 'Decision' | 'ForEach' | 'Plan' | 'Prompt' | 'Skill' | 'Sub-Agent' | 'Tool' | 'Validation' | 'While';
-    set StepType(value: 'Actions' | 'Chat' | 'Decision' | 'ForEach' | 'Plan' | 'Prompt' | 'Skill' | 'Sub-Agent' | 'Tool' | 'Validation' | 'While');
+    get StepType(): 'Actions' | 'Chat' | 'Compaction' | 'Decision' | 'ForEach' | 'Plan' | 'Prompt' | 'Skill' | 'Sub-Agent' | 'Tool' | 'Validation' | 'While';
+    set StepType(value: 'Actions' | 'Chat' | 'Compaction' | 'Decision' | 'ForEach' | 'Plan' | 'Prompt' | 'Skill' | 'Sub-Agent' | 'Tool' | 'Validation' | 'While');
     /**
     * * Field Name: StepName
     * * Display Name: Step Name
@@ -26840,7 +26942,7 @@ export declare class MJAIAgentTypeEntity extends BaseEntity<MJAIAgentTypeEntityT
     set SystemPromptID(value: string | null);
     /**
     * * Field Name: IsActive
-    * * Display Name: Is Active
+    * * Display Name: Active
     * * SQL Data Type: bit
     * * Default Value: 1
     * * Description: Indicates whether this agent type is available for use. Inactive types cannot be assigned to new agents.
@@ -26904,7 +27006,7 @@ export declare class MJAIAgentTypeEntity extends BaseEntity<MJAIAgentTypeEntityT
     set UIFormSectionExpandedByDefault(value: boolean);
     /**
     * * Field Name: PromptParamsSchema
-    * * Display Name: Prompt Parameters Schema
+    * * Display Name: Prompt Params Schema
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON Schema defining the available prompt parameters for this agent type. Includes property definitions with types, defaults, and descriptions. Used by agents of this type to customize which prompt sections are included in the system prompt. The schema follows JSON Schema draft-07 format.
     */
@@ -26920,7 +27022,7 @@ export declare class MJAIAgentTypeEntity extends BaseEntity<MJAIAgentTypeEntityT
     set AssignmentStrategy(value: string | null);
     /**
     * * Field Name: DefaultStorageAccountID
-    * * Display Name: Default Storage Account
+    * * Display Name: Default Storage Account ID
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: File Storage Accounts (vwFileStorageAccounts.ID)
     * * Description: Default file storage account for agents of this type. Lowest priority in the resolution chain (Type → Category tree → Agent → Runtime override). When set, all agents of this type use this storage account unless overridden at a more specific level. FK to FileStorageAccount.
@@ -26929,7 +27031,7 @@ export declare class MJAIAgentTypeEntity extends BaseEntity<MJAIAgentTypeEntityT
     set DefaultStorageAccountID(value: string | null);
     /**
     * * Field Name: ConfigSchema
-    * * Display Name: Configuration Schema
+    * * Display Name: Config Schema
     * * SQL Data Type: nvarchar(MAX)
     * * Description: JSON Schema (draft-07) describing the shape of TypeConfiguration payloads on agents of this type. When present, agent saves validate their TypeConfiguration against it server-side (MJAIAgentEntityServer.ValidateAsync); null = TypeConfiguration is freeform for this type.
     */
@@ -26944,17 +27046,89 @@ export declare class MJAIAgentTypeEntity extends BaseEntity<MJAIAgentTypeEntityT
     get DefaultConfiguration(): string | null;
     set DefaultConfiguration(value: string | null);
     /**
+    * * Field Name: ContextCompressionMessageThreshold
+    * * Display Name: Context Compression Message Threshold
+    * * SQL Data Type: int
+    * * Description: Type-level default for the in-turn context-compression message-count threshold. Overridable per agent via AIAgent.ContextCompressionMessageThreshold.
+    */
+    get ContextCompressionMessageThreshold(): number | null;
+    set ContextCompressionMessageThreshold(value: number | null);
+    /**
+    * * Field Name: ContextCompressionPromptID
+    * * Display Name: Context Compression Prompt ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)
+    * * Description: Type-level default prompt used for in-turn context compression. Overridable per agent via AIAgent.ContextCompressionPromptID.
+    */
+    get ContextCompressionPromptID(): string | null;
+    set ContextCompressionPromptID(value: string | null);
+    /**
+    * * Field Name: ContextCompressionMessageRetentionCount
+    * * Display Name: Context Compression Message Retention Count
+    * * SQL Data Type: int
+    * * Description: Type-level default for the number of most-recent messages kept uncompressed (the "hot tail") when context compression is applied. Overridable per agent via AIAgent.ContextCompressionMessageRetentionCount.
+    */
+    get ContextCompressionMessageRetentionCount(): number | null;
+    set ContextCompressionMessageRetentionCount(value: number | null);
+    /**
+    * * Field Name: ContextWindowMaxTokens
+    * * Display Name: Context Window Max Tokens
+    * * SQL Data Type: int
+    * * Description: Type-level default effective working-context budget, in tokens. Null means use the selected model's MaxInputTokens. The resolved value is clamped to the model's limit at runtime (a warning is logged if it would exceed it). Overridable per agent via AIAgent.ContextWindowMaxTokens.
+    */
+    get ContextWindowMaxTokens(): number | null;
+    set ContextWindowMaxTokens(value: number | null);
+    /**
+    * * Field Name: CompactionTriggerPercent
+    * * Display Name: Compaction Trigger Percent
+    * * SQL Data Type: int
+    * * Default Value: 75
+    * * Description: Type-level default: the percentage of the effective context budget at which cross-turn conversation compaction is triggered. Defaults to 75. Overridable per agent via AIAgent.CompactionTriggerPercent.
+    */
+    get CompactionTriggerPercent(): number;
+    set CompactionTriggerPercent(value: number);
+    /**
+    * * Field Name: CompactionTargetPercent
+    * * Display Name: Compaction Target Percent
+    * * SQL Data Type: int
+    * * Default Value: 30
+    * * Description: Type-level default: the target percentage of the effective context budget to reduce to after a cross-turn compaction. Defaults to 30. Overridable per agent via AIAgent.CompactionTargetPercent.
+    */
+    get CompactionTargetPercent(): number;
+    set CompactionTargetPercent(value: number);
+    /**
+    * * Field Name: ConversationSummaryPromptID
+    * * Display Name: Conversation Summary Prompt ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)
+    * * Description: Type-level default prompt used for cross-turn conversation compaction (the durable summary baseline). Distinct from ContextCompressionPromptID, which governs in-turn compression. Overridable per agent via AIAgent.ConversationSummaryPromptID.
+    */
+    get ConversationSummaryPromptID(): string | null;
+    set ConversationSummaryPromptID(value: string | null);
+    /**
     * * Field Name: SystemPrompt
-    * * Display Name: System Prompt Content
+    * * Display Name: System Prompt
     * * SQL Data Type: nvarchar(255)
     */
     get SystemPrompt(): string | null;
     /**
     * * Field Name: DefaultStorageAccount
-    * * Display Name: Default Storage Account Name
+    * * Display Name: Default Storage Account
     * * SQL Data Type: nvarchar(200)
     */
     get DefaultStorageAccount(): string | null;
+    /**
+    * * Field Name: ContextCompressionPrompt
+    * * Display Name: Context Compression Prompt
+    * * SQL Data Type: nvarchar(255)
+    */
+    get ContextCompressionPrompt(): string | null;
+    /**
+    * * Field Name: ConversationSummaryPrompt
+    * * Display Name: Conversation Summary Prompt
+    * * SQL Data Type: nvarchar(255)
+    */
+    get ConversationSummaryPrompt(): string | null;
 }
 /**
  * MJ: AI Agents - strongly typed entity sub-class
@@ -27102,7 +27276,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     get __mj_UpdatedAt(): Date;
     /**
     * * Field Name: ParentID
-    * * Display Name: Parent Agent
+    * * Display Name: Parent
     * * 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.
@@ -27151,7 +27325,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set EnableContextCompression(value: boolean);
     /**
     * * Field Name: ContextCompressionMessageThreshold
-    * * Display Name: Compression Message Threshold
+    * * Display Name: Context Compression Message Threshold
     * * SQL Data Type: int
     * * Description: Number of messages that triggers context compression when EnableContextCompression is true.
     */
@@ -27159,7 +27333,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set ContextCompressionMessageThreshold(value: number | null);
     /**
     * * Field Name: ContextCompressionPromptID
-    * * Display Name: Compression Prompt
+    * * Display Name: Context Compression Prompt ID
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)
     */
@@ -27167,7 +27341,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set ContextCompressionPromptID(value: string | null);
     /**
     * * Field Name: ContextCompressionMessageRetentionCount
-    * * Display Name: Compression Retention Count
+    * * Display Name: Context Compression Message Retention Count
     * * SQL Data Type: int
     * * Description: Number of recent messages to keep uncompressed when context compression is applied.
     */
@@ -27175,7 +27349,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set ContextCompressionMessageRetentionCount(value: number | null);
     /**
     * * Field Name: TypeID
-    * * Display Name: Agent Type
+    * * Display Name: 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.
@@ -27227,7 +27401,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set ModelSelectionMode(value: 'Agent' | 'Agent Type');
     /**
     * * Field Name: PayloadDownstreamPaths
-    * * Display Name: Downstream Payload Paths
+    * * Display Name: Payload 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"]
@@ -27236,7 +27410,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set PayloadDownstreamPaths(value: string);
     /**
     * * Field Name: PayloadUpstreamPaths
-    * * Display Name: Upstream Payload Paths
+    * * Display Name: Payload 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.*"]
@@ -27245,7 +27419,7 @@ export declare class MJAIAgentEntity extends BaseEntity<MJAIAgentEntityType> {
     set PayloadUpstreamPaths(value: string);
     /**
     * * Field Name: PayloadSelfReadPaths
-    * * Display Name: Self-Read Payload Paths
+    * * Display Name: Payload 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.
@@ -27254,7 +27428,7 @@ flow when the agent executes its own prompt step.
     set PayloadSelfReadPaths(value: string | null);
     /**
     * * Field Name: PayloadSelfWritePaths
-    * * Display Name: Self-Write Payload Paths
+    * * Display Name: Payload 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.
@@ -27279,7 +27453,7 @@ data flow when the agent executes its own prompt step.
     set FinalPayloadValidation(value: string | null);
     /**
     * * Field Name: FinalPayloadValidationMode
-    * * Display Name: Final Validation Mode
+    * * Display Name: Final Payload Validation Mode
     * * SQL Data Type: nvarchar(25)
     * * Default Value: Retry
     * * Value List Type: List
@@ -27293,7 +27467,7 @@ data flow when the agent executes its own prompt step.
     set FinalPayloadValidationMode(value: 'Fail' | 'Retry' | 'Warn');
     /**
     * * Field Name: FinalPayloadValidationMaxRetries
-    * * Display Name: Final Validation Max Retries
+    * * Display Name: Final Payload Validation Max Retries
     * * SQL Data Type: int
     * * Default Value: 3
     * * Description: Maximum number of retry attempts allowed when FinalPayloadValidation fails with
@@ -27363,7 +27537,7 @@ if this limit is exceeded.
     set StartingPayloadValidation(value: string | null);
     /**
     * * Field Name: StartingPayloadValidationMode
-    * * Display Name: Starting Validation Mode
+    * * Display Name: Starting Payload Validation Mode
     * * SQL Data Type: nvarchar(25)
     * * Default Value: Fail
     * * Value List Type: List
@@ -27406,7 +27580,7 @@ if this limit is exceeded.
     set DefaultArtifactTypeID(value: string | null);
     /**
     * * Field Name: OwnerUserID
-    * * Display Name: Owner
+    * * Display Name: Owner User
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
     * * Default Value: ECAFCCEC-6A37-EF11-86D4-000D3A4E707E
@@ -27581,7 +27755,7 @@ if this limit is exceeded.
     set InlineStorageThresholdBytes(value: number | null);
     /**
     * * Field Name: AgentTypePromptParams
-    * * Display Name: Prompt Parameters
+    * * Display Name: Agent Type Prompt Params
     * * 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.
     */
@@ -27783,14 +27957,47 @@ if this limit is exceeded.
     get RequirePlanMode(): boolean;
     set RequirePlanMode(value: boolean);
     /**
+    * * Field Name: ContextWindowMaxTokens
+    * * Display Name: Context Window Max Tokens
+    * * SQL Data Type: int
+    * * Description: Per-agent override for the effective working-context budget, in tokens. Null inherits the agent type's value (which, if also null, falls back to the selected model's MaxInputTokens). The resolved value is clamped to the model's limit at runtime.
+    */
+    get ContextWindowMaxTokens(): number | null;
+    set ContextWindowMaxTokens(value: number | null);
+    /**
+    * * Field Name: CompactionTriggerPercent
+    * * Display Name: Compaction Trigger Percent
+    * * SQL Data Type: int
+    * * Description: Per-agent override for the cross-turn compaction trigger percentage. Null inherits the agent type's value.
+    */
+    get CompactionTriggerPercent(): number | null;
+    set CompactionTriggerPercent(value: number | null);
+    /**
+    * * Field Name: CompactionTargetPercent
+    * * Display Name: Compaction Target Percent
+    * * SQL Data Type: int
+    * * Description: Per-agent override for the cross-turn compaction target percentage. Null inherits the agent type's value.
+    */
+    get CompactionTargetPercent(): number | null;
+    set CompactionTargetPercent(value: number | null);
+    /**
+    * * Field Name: ConversationSummaryPromptID
+    * * Display Name: Conversation Summary Prompt ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Prompts (vwAIPrompts.ID)
+    * * Description: Per-agent override for the cross-turn conversation compaction prompt. Null inherits the agent type's value.
+    */
+    get ConversationSummaryPromptID(): string | null;
+    set ConversationSummaryPromptID(value: string | null);
+    /**
     * * Field Name: Parent
-    * * Display Name: Parent Agent Name
+    * * Display Name: Parent
     * * SQL Data Type: nvarchar(255)
     */
     get Parent(): string | null;
     /**
     * * Field Name: ContextCompressionPrompt
-    * * Display Name: Compression Prompt Name
+    * * Display Name: Context Compression Prompt
     * * SQL Data Type: nvarchar(255)
     */
     get ContextCompressionPrompt(): string | null;
@@ -27802,13 +28009,13 @@ if this limit is exceeded.
     get Type(): string | null;
     /**
     * * Field Name: DefaultArtifactType
-    * * Display Name: Default Artifact Type Name
+    * * Display Name: Default Artifact Type
     * * SQL Data Type: nvarchar(100)
     */
     get DefaultArtifactType(): string | null;
     /**
     * * Field Name: OwnerUser
-    * * Display Name: Owner Name
+    * * Display Name: Owner User
     * * SQL Data Type: nvarchar(100)
     */
     get OwnerUser(): string;
@@ -27820,7 +28027,7 @@ if this limit is exceeded.
     get AttachmentStorageProvider(): string | null;
     /**
     * * Field Name: Category
-    * * Display Name: Category Name
+    * * Display Name: Category
     * * SQL Data Type: nvarchar(200)
     */
     get Category(): string | null;
@@ -27849,14 +28056,20 @@ if this limit is exceeded.
     */
     get DefaultMediaCollection(): string | null;
     /**
+    * * Field Name: ConversationSummaryPrompt
+    * * Display Name: Conversation Summary Prompt
+    * * SQL Data Type: nvarchar(255)
+    */
+    get ConversationSummaryPrompt(): string | null;
+    /**
     * * Field Name: RootParentID
-    * * Display Name: Root Parent
+    * * Display Name: Root Parent ID
     * * SQL Data Type: uniqueidentifier
     */
     get RootParentID(): string | null;
     /**
     * * Field Name: RootDefaultCoAgentID
-    * * Display Name: Root Default Co-Agent
+    * * Display Name: Root Default Co-Agent ID
     * * SQL Data Type: uniqueidentifier
     */
     get RootDefaultCoAgentID(): string | null;
@@ -42947,7 +43160,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set Error(value: string | null);
     /**
     * * Field Name: HiddenToUser
-    * * Display Name: Hidden to User
+    * * Display Name: Hidden To User
     * * SQL Data Type: bit
     * * Default Value: 0
     * * Description: Flag indicating if this message should be hidden from end users (system messages, function calls, etc.).
@@ -42994,7 +43207,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set ReflectionInsights(value: string | null);
     /**
     * * Field Name: SummaryOfEarlierConversation
-    * * Display Name: Summary of Earlier Conversation
+    * * Display Name: Summary Of Earlier Conversation
     * * SQL Data Type: nvarchar(MAX)
     * * Description: This column optionally stores a summary of the entire conversation leading up to this particular conversation detail record. It is used in long-running conversations to optimize performance by summarizing earlier parts.
     */
@@ -43002,7 +43215,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set SummaryOfEarlierConversation(value: string | null);
     /**
     * * Field Name: UserID
-    * * Display Name: User ID
+    * * Display Name: User
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Users (vwUsers.ID)
     * * Description: This field, when populated, overrides the UserID at the Conversation level to specify a different user created the message.
@@ -43011,7 +43224,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set UserID(value: string | null);
     /**
     * * Field Name: ArtifactID
-    * * Display Name: Artifact ID
+    * * Display Name: Artifact
     * *
     * * @deprecated This field is deprecated and will be removed in a future version. Using it will result in console warnings.SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Conversation Artifacts (vwConversationArtifacts.ID)
@@ -43021,7 +43234,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set ArtifactID(value: string | null);
     /**
     * * Field Name: ArtifactVersionID
-    * * Display Name: Artifact Version ID
+    * * Display Name: Artifact Version
     * *
     * * @deprecated This field is deprecated and will be removed in a future version. Using it will result in console warnings.SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Conversation Artifact Versions (vwConversationArtifactVersions.ID)
@@ -43031,7 +43244,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set ArtifactVersionID(value: string | null);
     /**
     * * Field Name: CompletionTime
-    * * Display Name: Completion Time (ms)
+    * * Display Name: Completion Time
     * * SQL Data Type: bigint
     * * Description: Duration in milliseconds representing how long the AI response processing took to complete for this conversation detail.
     */
@@ -43048,7 +43261,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set IsPinned(value: boolean);
     /**
     * * Field Name: ParentID
-    * * Display Name: Parent ID
+    * * Display Name: Parent
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Conversation Details (vwConversationDetails.ID)
     * * Description: Optional reference to parent message for threaded conversations. NULL for top-level messages.
@@ -43057,7 +43270,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set ParentID(value: string | null);
     /**
     * * Field Name: AgentID
-    * * Display Name: Agent ID
+    * * Display Name: Agent
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Agents (vwAIAgents.ID)
     * * Description: Denormalized agent ID for quick lookup of agent name and icon without joining through AgentRun
@@ -43089,7 +43302,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set SuggestedResponses(value: string | null);
     /**
     * * Field Name: TestRunID
-    * * Display Name: Test Run ID
+    * * Display Name: Test Run
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: Test Runs (vwTestRuns.ID)
     * * Description: Optional Foreign Key - Links this conversation detail to a test run if this message was part of a test conversation. Allows filtering and analyzing test-specific conversation turns.
@@ -43131,7 +43344,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set OriginalMessageChanged(value: boolean);
     /**
     * * Field Name: AgentSessionID
-    * * Display Name: Agent Session ID
+    * * Display Name: Agent Session
     * * SQL Data Type: uniqueidentifier
     * * Related Entity/Foreign Key: MJ: AI Agent Sessions (vwAIAgentSessions.ID)
     * * Description: Links this message to the AIAgentSession that was active when it was created. NULL for messages typed in standard text chat outside any live session. Lets the conversation timeline group a sessions messages into a single collapsible block.
@@ -43148,7 +43361,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set TurnEndedAt(value: Date | null);
     /**
     * * Field Name: UtteranceStartMs
-    * * Display Name: Utterance Start (ms)
+    * * Display Name: Utterance Start Ms
     * * SQL Data Type: int
     * * Description: Precise media-relative start of this turn, in integer milliseconds from the recording t0 (AIAgentSession.RecordingStartedAt). Populated only when the realtime driver supplies frame timing; NULL otherwise (fall back to __mj_CreatedAt - t0). Used by the evidence player for click-to-seek.
     */
@@ -43156,7 +43369,7 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     set UtteranceStartMs(value: number | null);
     /**
     * * Field Name: UtteranceEndMs
-    * * Display Name: Utterance End (ms)
+    * * Display Name: Utterance End Ms
     * * SQL Data Type: int
     * * Description: Precise media-relative end of this turn, in integer milliseconds from the recording t0 (AIAgentSession.RecordingStartedAt). Populated only when the realtime driver supplies frame timing; NULL otherwise. Used by the evidence player for click-to-seek.
     */
@@ -43176,6 +43389,24 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     get MediaType(): 'Audio' | 'Text' | 'Video' | null;
     set MediaType(value: 'Audio' | 'Text' | 'Video' | null);
     /**
+    * * Field Name: Sequence
+    * * Display Name: Sequence
+    * * SQL Data Type: int
+    * * Default Value: 0
+    * * Description: Monotonic, per-conversation ordinal assigned on insert (1-based). Provides a stable symbolic handle used by conversation-history retrieval tools and by the sequence markers embedded in compaction summaries. A summary stored in SummaryOfEarlierConversation on a given row covers all rows with a lower Sequence in the same conversation.
+    */
+    get Sequence(): number;
+    set Sequence(value: number);
+    /**
+    * * Field Name: SummaryPromptRunID
+    * * Display Name: Summary Prompt Run
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Prompt Runs (vwAIPromptRuns.ID)
+    * * Description: When SummaryOfEarlierConversation is populated by a cross-turn compaction, this links to the AIPromptRun that produced it (model, tokens, cost, prompt version). Null for ordinary (non-summary) rows.
+    */
+    get SummaryPromptRunID(): string | null;
+    set SummaryPromptRunID(value: string | null);
+    /**
     * * Field Name: Conversation
     * * Display Name: Conversation
     * * SQL Data Type: nvarchar(255)
@@ -43218,8 +43449,14 @@ export declare class MJConversationDetailEntity extends BaseEntity<MJConversatio
     */
     get TestRun(): string | null;
     /**
+    * * Field Name: SummaryPromptRun
+    * * Display Name: Summary Prompt Run
+    * * SQL Data Type: nvarchar(255)
+    */
+    get SummaryPromptRun(): string | null;
+    /**
     * * Field Name: RootParentID
-    * * Display Name: Root Parent ID
+    * * Display Name: Root Parent
     * * SQL Data Type: uniqueidentifier
     */
     get RootParentID(): string | null;
@@ -71957,6 +72194,148 @@ export declare class MJTestEntity extends BaseEntity<MJTestEntityType> {
     */
     get Type(): string;
 }
+/**
+ * MJ: Themes - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: Theme
+ * * Base View: vwThemes
+ * * @description A named brand theme. Stores ~8 brand seeds (color hue anchors, neutral character, vibrancy, shape, depth, type, viz palette) as JSON; the full --mj-* design-token contract is derived from the seeds at load. A theme is a brand — light/dark is the user's mode layered under it, so a theme carries no per-mode values.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+export declare class MJThemeEntity extends BaseEntity<MJThemeEntityType> {
+    /**
+    * Loads the MJ: Themes record from the database
+    * @param ID: string - primary key value to load the MJ: Themes record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof MJThemeEntity
+    * @method
+    * @override
+    */
+    Load(ID: string, EntityRelationshipsToLoad?: string[]): Promise<boolean>;
+    /**
+    * * Field Name: ID
+    * * Display Name: ID
+    * * SQL Data Type: uniqueidentifier
+    * * Default Value: newsequentialid()
+    */
+    get ID(): string;
+    set ID(value: string);
+    /**
+    * * Field Name: Name
+    * * Display Name: Name
+    * * SQL Data Type: nvarchar(100)
+    * * Description: Display name for the theme (unique).
+    */
+    get Name(): string;
+    set Name(value: string);
+    /**
+    * * Field Name: Description
+    * * Display Name: Description
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Optional description of the theme.
+    */
+    get Description(): string | null;
+    set Description(value: string | null);
+    /**
+    * * Field Name: Seeds
+    * * Display Name: Seeds
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Brand seeds as JSON (the ThemeSeeds shape from @memberjunction/theme-engine): primary/accent/tertiary hue anchors, neutralChroma, vibrancy, radius, depth, fontFamily, and an optional vizPalette override. Source of truth — the full token contract is derived from this, not stored.
+    */
+    get Seeds(): string;
+    set Seeds(value: string);
+    /**
+    * * Field Name: LightMarkURL
+    * * Display Name: Light Mode Logo
+    * * SQL Data Type: nvarchar(1000)
+    * * Description: Public URL of the logo mark for light surfaces. Logos are variant uploads, never recolored.
+    */
+    get LightMarkURL(): string | null;
+    set LightMarkURL(value: string | null);
+    /**
+    * * Field Name: DarkMarkURL
+    * * Display Name: Dark Mode Logo
+    * * SQL Data Type: nvarchar(1000)
+    * * Description: Public URL of the logo mark for dark surfaces. Dark mode swaps to this artwork rather than transforming the light mark.
+    */
+    get DarkMarkURL(): string | null;
+    set DarkMarkURL(value: string | null);
+    /**
+    * * Field Name: WordmarkURL
+    * * Display Name: Wordmark Logo
+    * * SQL Data Type: nvarchar(1000)
+    * * Description: Optional public URL of the full wordmark logo.
+    */
+    get WordmarkURL(): string | null;
+    set WordmarkURL(value: string | null);
+    /**
+    * * Field Name: MonochromeURL
+    * * Display Name: Monochrome Logo
+    * * SQL Data Type: nvarchar(1000)
+    * * Description: Optional public URL of a single-fill monochrome logo variant.
+    */
+    get MonochromeURL(): string | null;
+    set MonochromeURL(value: string | null);
+    /**
+    * * Field Name: IsDefault
+    * * Display Name: Is Default Theme
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: When 1, this is the default theme applied when no other is selected. Single-default enforcement is handled at the application layer.
+    */
+    get IsDefault(): boolean;
+    set IsDefault(value: boolean);
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Draft
+    *   * Inactive
+    * * Description: Lifecycle status: Active (available), Inactive (retired), or Draft (in progress, not applied).
+    */
+    get Status(): 'Active' | 'Draft' | 'Inactive';
+    set Status(value: 'Active' | 'Draft' | 'Inactive');
+    /**
+    * * Field Name: Overrides
+    * * Display Name: Token Overrides
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Optional advanced token overrides as a JSON object mapping a --mj-* CSS custom property name to a value (e.g. {"--mj-brand-primary-hover":"#0a5cff"}). Applied on top of the seed-derived token contract at load, before CustomCSS. Leave null to use the pure derived theme.
+    */
+    get Overrides(): string | null;
+    set Overrides(value: string | null);
+    /**
+    * * Field Name: CustomCSS
+    * * Display Name: Custom CSS
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Optional advanced raw CSS appended to the theme overlay and auto-scoped under [data-theme-overlay="<id>"]. Applied last, after the derived tokens and Overrides. Escape hatch for rules the seed/token model cannot express; leave null for none.
+    */
+    get CustomCSS(): string | null;
+    set CustomCSS(value: string | null);
+    /**
+    * * Field Name: __mj_CreatedAt
+    * * Display Name: Created At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_CreatedAt(): Date;
+    /**
+    * * Field Name: __mj_UpdatedAt
+    * * Display Name: Updated At
+    * * SQL Data Type: datetimeoffset
+    * * Default Value: getutcdate()
+    */
+    get __mj_UpdatedAt(): Date;
+}
 /**
  * MJ: User Application Entities - strongly typed entity sub-class
  * * Schema: __mj