@memberjunction/core-entities 2.110.1 → 2.111.0

package/dist/generated/entity_subclasses.d.ts

@@ -569,18 +569,24 @@ export declare const AIAgentNoteTypeSchema: z.ZodObject<{
     Description: z.ZodNullable<z.ZodString>;
     __mj_CreatedAt: z.ZodDate;
     __mj_UpdatedAt: z.ZodDate;
+    Priority: z.ZodNumber;
+    Status: z.ZodUnion<[z.ZodLiteral<"Active">, z.ZodLiteral<"Pending">, z.ZodLiteral<"Revoked">]>;
 }, "strip", z.ZodTypeAny, {
     ID?: string;
     __mj_CreatedAt?: Date;
     __mj_UpdatedAt?: Date;
     Name?: string;
     Description?: string;
+    Status?: "Active" | "Pending" | "Revoked";
+    Priority?: number;
 }, {
     ID?: string;
     __mj_CreatedAt?: Date;
     __mj_UpdatedAt?: Date;
     Name?: string;
     Description?: string;
+    Status?: "Active" | "Pending" | "Revoked";
+    Priority?: number;
 }>;
 export type AIAgentNoteTypeEntityType = z.infer<typeof AIAgentNoteTypeSchema>;
 /**
@@ -593,35 +599,62 @@ export declare const AIAgentNoteSchema: z.ZodObject<{
     Note: z.ZodNullable<z.ZodString>;
     __mj_CreatedAt: z.ZodDate;
     __mj_UpdatedAt: z.ZodDate;
-    Type: z.ZodUnion<[z.ZodLiteral<"Global">, z.ZodLiteral<"User">]>;
     UserID: z.ZodNullable<z.ZodString>;
+    Type: z.ZodUnion<[z.ZodLiteral<"Constraint">, z.ZodLiteral<"Context">, z.ZodLiteral<"Example">, z.ZodLiteral<"Issue">, z.ZodLiteral<"Preference">]>;
+    IsAutoGenerated: z.ZodBoolean;
+    Comments: z.ZodNullable<z.ZodString>;
+    Status: z.ZodUnion<[z.ZodLiteral<"Active">, z.ZodLiteral<"Pending">, z.ZodLiteral<"Revoked">]>;
+    SourceConversationID: z.ZodNullable<z.ZodString>;
+    SourceConversationDetailID: z.ZodNullable<z.ZodString>;
+    SourceAIAgentRunID: z.ZodNullable<z.ZodString>;
+    CompanyID: z.ZodNullable<z.ZodString>;
     Agent: z.ZodNullable<z.ZodString>;
     AgentNoteType: z.ZodNullable<z.ZodString>;
     User: z.ZodNullable<z.ZodString>;
+    SourceConversation: z.ZodNullable<z.ZodString>;
+    Company: z.ZodNullable<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     ID?: string;
+    Comments?: string;
     __mj_CreatedAt?: Date;
     __mj_UpdatedAt?: Date;
+    Status?: "Active" | "Pending" | "Revoked";
     UserID?: string;
     User?: string;
-    Type?: "User" | "Global";
+    Type?: "Constraint" | "Context" | "Example" | "Issue" | "Preference";
     AgentID?: string;
     Agent?: string;
     AgentNoteTypeID?: string;
     Note?: string;
+    IsAutoGenerated?: boolean;
+    SourceConversationID?: string;
+    SourceConversationDetailID?: string;
+    SourceAIAgentRunID?: string;
+    CompanyID?: string;
     AgentNoteType?: string;
+    SourceConversation?: string;
+    Company?: string;
 }, {
     ID?: string;
+    Comments?: string;
     __mj_CreatedAt?: Date;
     __mj_UpdatedAt?: Date;
+    Status?: "Active" | "Pending" | "Revoked";
     UserID?: string;
     User?: string;
-    Type?: "User" | "Global";
+    Type?: "Constraint" | "Context" | "Example" | "Issue" | "Preference";
     AgentID?: string;
     Agent?: string;
     AgentNoteTypeID?: string;
     Note?: string;
+    IsAutoGenerated?: boolean;
+    SourceConversationID?: string;
+    SourceConversationDetailID?: string;
+    SourceAIAgentRunID?: string;
+    CompanyID?: string;
     AgentNoteType?: string;
+    SourceConversation?: string;
+    Company?: string;
 }>;
 export type AIAgentNoteEntityType = z.infer<typeof AIAgentNoteSchema>;
 /**
@@ -724,6 +757,12 @@ export declare const AIAgentSchema: z.ZodObject<{
     ArtifactCreationMode: z.ZodUnion<[z.ZodLiteral<"Always">, z.ZodLiteral<"Never">, z.ZodLiteral<"System Only">]>;
     FunctionalRequirements: z.ZodNullable<z.ZodString>;
     TechnicalDesign: z.ZodNullable<z.ZodString>;
+    InjectNotes: z.ZodBoolean;
+    MaxNotesToInject: z.ZodNumber;
+    NoteInjectionStrategy: z.ZodUnion<[z.ZodLiteral<"All">, z.ZodLiteral<"Recent">, z.ZodLiteral<"Relevant">]>;
+    InjectExamples: z.ZodBoolean;
+    MaxExamplesToInject: z.ZodNumber;
+    ExampleInjectionStrategy: z.ZodUnion<[z.ZodLiteral<"Rated">, z.ZodLiteral<"Recent">, z.ZodLiteral<"Semantic">]>;
     Parent: z.ZodNullable<z.ZodString>;
     ContextCompressionPrompt: z.ZodNullable<z.ZodString>;
     Type: z.ZodNullable<z.ZodString>;
@@ -777,6 +816,12 @@ export declare const AIAgentSchema: z.ZodObject<{
     ArtifactCreationMode?: "Always" | "Never" | "System Only";
     FunctionalRequirements?: string;
     TechnicalDesign?: string;
+    InjectNotes?: boolean;
+    MaxNotesToInject?: number;
+    NoteInjectionStrategy?: "All" | "Recent" | "Relevant";
+    InjectExamples?: boolean;
+    MaxExamplesToInject?: number;
+    ExampleInjectionStrategy?: "Recent" | "Rated" | "Semantic";
     ContextCompressionPrompt?: string;
     DefaultArtifactType?: string;
     OwnerUser?: string;
@@ -827,6 +872,12 @@ export declare const AIAgentSchema: z.ZodObject<{
     ArtifactCreationMode?: "Always" | "Never" | "System Only";
     FunctionalRequirements?: string;
     TechnicalDesign?: string;
+    InjectNotes?: boolean;
+    MaxNotesToInject?: number;
+    NoteInjectionStrategy?: "All" | "Recent" | "Relevant";
+    InjectExamples?: boolean;
+    MaxExamplesToInject?: number;
+    ExampleInjectionStrategy?: "Recent" | "Rated" | "Semantic";
     ContextCompressionPrompt?: string;
     DefaultArtifactType?: string;
     OwnerUser?: string;
@@ -1901,13 +1952,13 @@ export declare const CompanyIntegrationRunSchema: z.ZodObject<{
     Status?: "Pending" | "Failed" | "Success" | "In Progress";
     StartedAt?: Date;
     EndedAt?: Date;
+    Company?: string;
     CompanyIntegrationID?: string;
     RunByUserID?: string;
     TotalRecords?: number;
     ErrorLog?: string;
     ConfigData?: string;
     Integration?: string;
-    Company?: string;
     RunByUser?: string;
 }, {
     ID?: string;
@@ -1917,13 +1968,13 @@ export declare const CompanyIntegrationRunSchema: z.ZodObject<{
     Status?: "Pending" | "Failed" | "Success" | "In Progress";
     StartedAt?: Date;
     EndedAt?: Date;
+    Company?: string;
     CompanyIntegrationID?: string;
     RunByUserID?: string;
     TotalRecords?: number;
     ErrorLog?: string;
     ConfigData?: string;
     Integration?: string;
-    Company?: string;
     RunByUser?: string;
 }>;
 export type CompanyIntegrationRunEntityType = z.infer<typeof CompanyIntegrationRunSchema>;
@@ -1960,10 +2011,10 @@ export declare const CompanyIntegrationSchema: z.ZodObject<{
     __mj_UpdatedAt?: Date;
     Name?: string;
     IsActive?: boolean;
+    CompanyID?: string;
+    Company?: string;
     DriverImportPath?: string;
     Integration?: string;
-    Company?: string;
-    CompanyID?: string;
     IntegrationID?: string;
     AccessToken?: string;
     RefreshToken?: string;
@@ -1984,10 +2035,10 @@ export declare const CompanyIntegrationSchema: z.ZodObject<{
     __mj_UpdatedAt?: Date;
     Name?: string;
     IsActive?: boolean;
+    CompanyID?: string;
+    Company?: string;
     DriverImportPath?: string;
     Integration?: string;
-    Company?: string;
-    CompanyID?: string;
     IntegrationID?: string;
     AccessToken?: string;
     RefreshToken?: string;
@@ -2602,7 +2653,7 @@ export declare const DashboardSchema: z.ZodObject<{
     Environment?: string;
     UIConfigDetails?: string;
     Thumbnail?: string;
-    Scope?: "Global" | "App";
+    Scope?: "App" | "Global";
 }, {
     ID?: string;
     __mj_CreatedAt?: Date;
@@ -2622,7 +2673,7 @@ export declare const DashboardSchema: z.ZodObject<{
     Environment?: string;
     UIConfigDetails?: string;
     Thumbnail?: string;
-    Scope?: "Global" | "App";
+    Scope?: "App" | "Global";
 }>;
 export type DashboardEntityType = z.infer<typeof DashboardSchema>;
 /**
@@ -4358,6 +4409,7 @@ export declare const FileStorageProviderSchema: z.ZodObject<{
     IsActive: z.ZodBoolean;
     __mj_CreatedAt: z.ZodDate;
     __mj_UpdatedAt: z.ZodDate;
+    SupportsSearch: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
     ID?: string;
     __mj_CreatedAt?: Date;
@@ -4368,6 +4420,7 @@ export declare const FileStorageProviderSchema: z.ZodObject<{
     Priority?: number;
     ServerDriverKey?: string;
     ClientDriverKey?: string;
+    SupportsSearch?: boolean;
 }, {
     ID?: string;
     __mj_CreatedAt?: Date;
@@ -4378,6 +4431,7 @@ export declare const FileStorageProviderSchema: z.ZodObject<{
     Priority?: number;
     ServerDriverKey?: string;
     ClientDriverKey?: string;
+    SupportsSearch?: boolean;
 }>;
 export type FileStorageProviderEntityType = z.infer<typeof FileStorageProviderSchema>;
 /**
@@ -4940,6 +4994,74 @@ export declare const AIAgentDataSourceSchema: z.ZodObject<{
     DestinationPath?: string;
 }>;
 export type AIAgentDataSourceEntityType = z.infer<typeof AIAgentDataSourceSchema>;
+/**
+ * zod schema definition for the entity MJ: AI Agent Examples
+ */
+export declare const AIAgentExampleSchema: z.ZodObject<{
+    ID: z.ZodString;
+    AgentID: z.ZodString;
+    UserID: z.ZodNullable<z.ZodString>;
+    CompanyID: z.ZodNullable<z.ZodString>;
+    Type: z.ZodUnion<[z.ZodLiteral<"Constraint">, z.ZodLiteral<"Context">, z.ZodLiteral<"Example">, z.ZodLiteral<"Issue">, z.ZodLiteral<"Preference">]>;
+    ExampleInput: z.ZodString;
+    ExampleOutput: z.ZodString;
+    IsAutoGenerated: z.ZodBoolean;
+    SourceConversationID: z.ZodNullable<z.ZodString>;
+    SourceConversationDetailID: z.ZodNullable<z.ZodString>;
+    SourceAIAgentRunID: z.ZodNullable<z.ZodString>;
+    SuccessScore: z.ZodNullable<z.ZodNumber>;
+    Comments: z.ZodNullable<z.ZodString>;
+    Status: z.ZodUnion<[z.ZodLiteral<"Active">, z.ZodLiteral<"Pending">, z.ZodLiteral<"Revoked">]>;
+    __mj_CreatedAt: z.ZodDate;
+    __mj_UpdatedAt: z.ZodDate;
+    Agent: z.ZodNullable<z.ZodString>;
+    User: z.ZodNullable<z.ZodString>;
+    Company: z.ZodNullable<z.ZodString>;
+    SourceConversation: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ID?: string;
+    Comments?: string;
+    __mj_CreatedAt?: Date;
+    __mj_UpdatedAt?: Date;
+    Status?: "Active" | "Pending" | "Revoked";
+    UserID?: string;
+    User?: string;
+    Type?: "Constraint" | "Context" | "Example" | "Issue" | "Preference";
+    AgentID?: string;
+    Agent?: string;
+    IsAutoGenerated?: boolean;
+    SourceConversationID?: string;
+    SourceConversationDetailID?: string;
+    SourceAIAgentRunID?: string;
+    CompanyID?: string;
+    SourceConversation?: string;
+    Company?: string;
+    ExampleInput?: string;
+    ExampleOutput?: string;
+    SuccessScore?: number;
+}, {
+    ID?: string;
+    Comments?: string;
+    __mj_CreatedAt?: Date;
+    __mj_UpdatedAt?: Date;
+    Status?: "Active" | "Pending" | "Revoked";
+    UserID?: string;
+    User?: string;
+    Type?: "Constraint" | "Context" | "Example" | "Issue" | "Preference";
+    AgentID?: string;
+    Agent?: string;
+    IsAutoGenerated?: boolean;
+    SourceConversationID?: string;
+    SourceConversationDetailID?: string;
+    SourceAIAgentRunID?: string;
+    CompanyID?: string;
+    SourceConversation?: string;
+    Company?: string;
+    ExampleInput?: string;
+    ExampleOutput?: string;
+    SuccessScore?: number;
+}>;
+export type AIAgentExampleEntityType = z.infer<typeof AIAgentExampleSchema>;
 /**
  * zod schema definition for the entity MJ: AI Agent Permissions
  */
@@ -5088,7 +5210,7 @@ export declare const AIAgentRunStepSchema: 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<"Prompt">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"Validation">]>;
+    StepType: z.ZodUnion<[z.ZodLiteral<"Actions">, z.ZodLiteral<"Chat">, z.ZodLiteral<"Decision">, z.ZodLiteral<"ForEach">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Sub-Agent">, 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">]>;
@@ -5121,7 +5243,7 @@ export declare const AIAgentRunStepSchema: z.ZodObject<{
     ErrorMessage?: string;
     AgentRunID?: string;
     StepNumber?: number;
-    StepType?: "Sub-Agent" | "Prompt" | "Actions" | "Chat" | "Decision" | "Validation";
+    StepType?: "Sub-Agent" | "Prompt" | "Actions" | "Chat" | "Decision" | "ForEach" | "Validation" | "While";
     StepName?: string;
     TargetID?: string;
     CompletedAt?: Date;
@@ -5145,7 +5267,7 @@ export declare const AIAgentRunStepSchema: z.ZodObject<{
     ErrorMessage?: string;
     AgentRunID?: string;
     StepNumber?: number;
-    StepType?: "Sub-Agent" | "Prompt" | "Actions" | "Chat" | "Decision" | "Validation";
+    StepType?: "Sub-Agent" | "Prompt" | "Actions" | "Chat" | "Decision" | "ForEach" | "Validation" | "While";
     StepName?: string;
     TargetID?: string;
     CompletedAt?: Date;
@@ -5187,7 +5309,7 @@ export declare const AIAgentRunSchema: z.ZodObject<{
     ConversationDetailID: z.ZodNullable<z.ZodString>;
     ConversationDetailSequence: z.ZodNullable<z.ZodNumber>;
     CancellationReason: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"System">, z.ZodLiteral<"Timeout">, z.ZodLiteral<"User Request">]>>;
-    FinalStep: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Actions">, z.ZodLiteral<"Chat">, z.ZodLiteral<"Failed">, z.ZodLiteral<"Retry">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"Success">]>>;
+    FinalStep: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Actions">, z.ZodLiteral<"Chat">, z.ZodLiteral<"Failed">, z.ZodLiteral<"ForEach">, z.ZodLiteral<"Retry">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"Success">, z.ZodLiteral<"While">]>>;
     FinalPayload: z.ZodNullable<z.ZodString>;
     Message: z.ZodNullable<z.ZodString>;
     LastRunID: z.ZodNullable<z.ZodString>;
@@ -5246,7 +5368,7 @@ export declare const AIAgentRunSchema: z.ZodObject<{
     ConversationDetailID?: string;
     ConversationDetailSequence?: number;
     CancellationReason?: "System" | "Timeout" | "User Request";
-    FinalStep?: "Failed" | "Retry" | "Success" | "Sub-Agent" | "Actions" | "Chat";
+    FinalStep?: "Failed" | "Retry" | "Success" | "Sub-Agent" | "Actions" | "Chat" | "ForEach" | "While";
     FinalPayload?: string;
     StartingPayload?: string;
     TotalPromptIterations?: number;
@@ -5295,7 +5417,7 @@ export declare const AIAgentRunSchema: z.ZodObject<{
     ConversationDetailID?: string;
     ConversationDetailSequence?: number;
     CancellationReason?: "System" | "Timeout" | "User Request";
-    FinalStep?: "Failed" | "Retry" | "Success" | "Sub-Agent" | "Actions" | "Chat";
+    FinalStep?: "Failed" | "Retry" | "Success" | "Sub-Agent" | "Actions" | "Chat" | "ForEach" | "While";
     FinalPayload?: string;
     StartingPayload?: string;
     TotalPromptIterations?: number;
@@ -5359,7 +5481,7 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     AgentID: z.ZodString;
     Name: z.ZodString;
     Description: z.ZodNullable<z.ZodString>;
-    StepType: z.ZodUnion<[z.ZodLiteral<"Action">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Sub-Agent">]>;
+    StepType: z.ZodUnion<[z.ZodLiteral<"Action">, z.ZodLiteral<"ForEach">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Sub-Agent">, z.ZodLiteral<"While">]>;
     StartingStep: z.ZodBoolean;
     TimeoutSeconds: z.ZodNullable<z.ZodNumber>;
     RetryCount: z.ZodNumber;
@@ -5376,6 +5498,8 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     __mj_UpdatedAt: z.ZodDate;
     Status: z.ZodUnion<[z.ZodLiteral<"Active">, z.ZodLiteral<"Disabled">, z.ZodLiteral<"Pending">]>;
     ActionInputMapping: z.ZodNullable<z.ZodString>;
+    LoopBodyType: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Action">, z.ZodLiteral<"Prompt">, z.ZodLiteral<"Sub-Agent">]>>;
+    Configuration: z.ZodNullable<z.ZodString>;
     Agent: z.ZodNullable<z.ZodString>;
     Action: z.ZodNullable<z.ZodString>;
     SubAgent: z.ZodNullable<z.ZodString>;
@@ -5391,11 +5515,12 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     Status?: "Active" | "Disabled" | "Pending";
     AgentID?: string;
     Agent?: string;
+    Configuration?: string;
     Prompt?: string;
     PromptID?: string;
     SubAgentID?: string;
     SubAgent?: string;
-    StepType?: "Action" | "Sub-Agent" | "Prompt";
+    StepType?: "Action" | "Sub-Agent" | "Prompt" | "ForEach" | "While";
     StartingStep?: boolean;
     TimeoutSeconds?: number;
     RetryCount?: number;
@@ -5406,6 +5531,7 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     Width?: number;
     Height?: number;
     ActionInputMapping?: string;
+    LoopBodyType?: "Action" | "Sub-Agent" | "Prompt";
 }, {
     ID?: string;
     ActionID?: string;
@@ -5417,11 +5543,12 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     Status?: "Active" | "Disabled" | "Pending";
     AgentID?: string;
     Agent?: string;
+    Configuration?: string;
     Prompt?: string;
     PromptID?: string;
     SubAgentID?: string;
     SubAgent?: string;
-    StepType?: "Action" | "Sub-Agent" | "Prompt";
+    StepType?: "Action" | "Sub-Agent" | "Prompt" | "ForEach" | "While";
     StartingStep?: boolean;
     TimeoutSeconds?: number;
     RetryCount?: number;
@@ -5432,6 +5559,7 @@ export declare const AIAgentStepSchema: z.ZodObject<{
     Width?: number;
     Height?: number;
     ActionInputMapping?: string;
+    LoopBodyType?: "Action" | "Sub-Agent" | "Prompt";
 }>;
 export type AIAgentStepEntityType = z.infer<typeof AIAgentStepSchema>;
 /**
@@ -6925,7 +7053,7 @@ export declare const DashboardUserPreferenceSchema: z.ZodObject<{
     User?: string;
     ApplicationID?: string;
     Application?: string;
-    Scope?: "Global" | "App";
+    Scope?: "App" | "Global";
     Dashboard?: string;
     DashboardID?: string;
     DisplayOrder?: number;
@@ -6937,7 +7065,7 @@ export declare const DashboardUserPreferenceSchema: z.ZodObject<{
     User?: string;
     ApplicationID?: string;
     Application?: string;
-    Scope?: "Global" | "App";
+    Scope?: "App" | "Global";
     Dashboard?: string;
     DashboardID?: string;
     DisplayOrder?: number;
@@ -11626,13 +11754,36 @@ export declare class AIAgentNoteTypeEntity extends BaseEntity<AIAgentNoteTypeEnt
     * * Default Value: getutcdate()
     */
     get __mj_UpdatedAt(): Date;
+    /**
+    * * Field Name: Priority
+    * * Display Name: Priority
+    * * SQL Data Type: int
+    * * Default Value: 0
+    * * Description: Priority for injection ordering. Lower numbers are injected first (0 is highest priority).
+    */
+    get Priority(): number;
+    set Priority(value: number);
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Pending
+    *   * Revoked
+    * * Description: Status of the note type: Pending (awaiting approval), Active (available for use), or Revoked (deprecated).
+    */
+    get Status(): 'Active' | 'Pending' | 'Revoked';
+    set Status(value: 'Active' | 'Pending' | 'Revoked');
 }
 /**
  * AI Agent Notes - strongly typed entity sub-class
  * * Schema: __mj
  * * Base Table: AIAgentNote
  * * Base View: vwAIAgentNotes
- * * @description Stores notes, observations, and learnings generated by AI agents during their operations, linked to specific agent runs and categorized by note type. Can be user-specific or general.
+ * * @description Stores notes, observations, and learnings for AI agents with multi-dimensional scoping (Agent, User, company). Scoping is determined by which FK fields are populated: all NULL = global, AgentID only = agent-specific, UserID only = user-specific across all agents, etc.
  * * Primary Key: ID
  * @extends {BaseEntity}
  * @class
@@ -11698,26 +11849,97 @@ export declare class AIAgentNoteEntity extends BaseEntity<AIAgentNoteEntityType>
     */
     get __mj_UpdatedAt(): Date;
     /**
+    * * Field Name: UserID
+    * * Display Name: User ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Users (vwUsers.ID)
+    * * Description: Foreign key referencing the ID column in the User table, indicating the user associated with the note. Used when Type=User
+    */
+    get UserID(): string | null;
+    set UserID(value: string | null);
+    /**
     * * Field Name: Type
     * * Display Name: Type
     * * SQL Data Type: nvarchar(20)
+    * * Default Value: Preference
     * * Value List Type: List
     * * Possible Values
-    *   * Global
-    *   * User
-    * * Description: Indicates the type of note, either User-specific or Global.
+    *   * Constraint
+    *   * Context
+    *   * Example
+    *   * Issue
+    *   * Preference
+    * * Description: Quick categorization of the note content: Preference (user preferences), Constraint (hard rules/requirements), Context (background information), Example (sample interactions), or Issue (known problems/limitations). Complements the more detailed AIAgentNoteType categorization.
     */
-    get Type(): 'Global' | 'User';
-    set Type(value: 'Global' | 'User');
+    get Type(): 'Constraint' | 'Context' | 'Example' | 'Issue' | 'Preference';
+    set Type(value: 'Constraint' | 'Context' | 'Example' | 'Issue' | 'Preference');
     /**
-    * * Field Name: UserID
-    * * Display Name: User ID
+    * * Field Name: IsAutoGenerated
+    * * Display Name: Is Auto Generated
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: Indicates whether this note was automatically generated by an AI agent (1) or manually created (0).
+    */
+    get IsAutoGenerated(): boolean;
+    set IsAutoGenerated(value: boolean);
+    /**
+    * * Field Name: Comments
+    * * Display Name: Comments
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Internal comments about this note, not included in agent context injection.
+    */
+    get Comments(): string | null;
+    set Comments(value: string | null);
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Pending
+    *   * Revoked
+    * * Description: Status of the note: Pending (awaiting review), Active (in use), or Revoked (disabled).
+    */
+    get Status(): 'Active' | 'Pending' | 'Revoked';
+    set Status(value: 'Active' | 'Pending' | 'Revoked');
+    /**
+    * * Field Name: SourceConversationID
+    * * Display Name: Source Conversation ID
     * * SQL Data Type: uniqueidentifier
-    * * Related Entity/Foreign Key: Users (vwUsers.ID)
-    * * Description: Foreign key referencing the ID column in the User table, indicating the user associated with the note. Used when Type=User
+    * * Related Entity/Foreign Key: Conversations (vwConversations.ID)
+    * * Description: Optional reference to the conversation that inspired or generated this note.
     */
-    get UserID(): string | null;
-    set UserID(value: string | null);
+    get SourceConversationID(): string | null;
+    set SourceConversationID(value: string | null);
+    /**
+    * * Field Name: SourceConversationDetailID
+    * * Display Name: Source Conversation Detail ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Conversation Details (vwConversationDetails.ID)
+    * * Description: Optional reference to the specific conversation message that inspired this note.
+    */
+    get SourceConversationDetailID(): string | null;
+    set SourceConversationDetailID(value: string | null);
+    /**
+    * * Field Name: SourceAIAgentRunID
+    * * Display Name: Source AI Agent Run ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Agent Runs (vwAIAgentRuns.ID)
+    * * Description: Optional reference to the AI agent run that generated this note.
+    */
+    get SourceAIAgentRunID(): string | null;
+    set SourceAIAgentRunID(value: string | null);
+    /**
+    * * Field Name: CompanyID
+    * * Display Name: Company ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Companies (vwCompanies.ID)
+    * * Description: Optional company scope for this note. When populated with UserID, creates org+user specific notes.
+    */
+    get CompanyID(): string | null;
+    set CompanyID(value: string | null);
     /**
     * * Field Name: Agent
     * * Display Name: Agent
@@ -11736,6 +11958,18 @@ export declare class AIAgentNoteEntity extends BaseEntity<AIAgentNoteEntityType>
     * * SQL Data Type: nvarchar(100)
     */
     get User(): string | null;
+    /**
+    * * Field Name: SourceConversation
+    * * Display Name: Source Conversation
+    * * SQL Data Type: nvarchar(255)
+    */
+    get SourceConversation(): string | null;
+    /**
+    * * Field Name: Company
+    * * Display Name: Company
+    * * SQL Data Type: nvarchar(50)
+    */
+    get Company(): string | null;
 }
 /**
  * AI Agent Requests - strongly typed entity sub-class
@@ -12345,8 +12579,8 @@ if this limit is exceeded.
     * * Default Value: Always
     * * Value List Type: List
     * * Possible Values
-    *   * Never
     *   * Always
+    *   * Never
     *   * System Only
     * * Description: Controls how artifacts are created from this agent's payloads. "Always" creates visible artifacts, "Never" skips artifact creation, "System Only" creates hidden system artifacts.
     */
@@ -12369,6 +12603,70 @@ if this limit is exceeded.
     get TechnicalDesign(): string | null;
     set TechnicalDesign(value: string | null);
     /**
+    * * Field Name: InjectNotes
+    * * Display Name: Inject Notes
+    * * SQL Data Type: bit
+    * * Default Value: 1
+    * * Description: When enabled, agent notes will be automatically injected into the agent context based on scoping rules.
+    */
+    get InjectNotes(): boolean;
+    set InjectNotes(value: boolean);
+    /**
+    * * Field Name: MaxNotesToInject
+    * * 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.
+    */
+    get MaxNotesToInject(): number;
+    set MaxNotesToInject(value: number);
+    /**
+    * * Field Name: NoteInjectionStrategy
+    * * Display Name: Note Injection Strategy
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Relevant
+    * * Value List Type: List
+    * * Possible Values
+    *   * All
+    *   * Recent
+    *   * Relevant
+    * * Description: Strategy for selecting which notes to inject: Relevant (semantic search), Recent (most recent first), or All (up to max limit).
+    */
+    get NoteInjectionStrategy(): 'All' | 'Recent' | 'Relevant';
+    set NoteInjectionStrategy(value: 'All' | 'Recent' | 'Relevant');
+    /**
+    * * Field Name: InjectExamples
+    * * Display Name: Inject Examples
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: When enabled, agent examples will be automatically injected into the agent context based on scoping rules.
+    */
+    get InjectExamples(): boolean;
+    set InjectExamples(value: boolean);
+    /**
+    * * Field Name: MaxExamplesToInject
+    * * 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.
+    */
+    get MaxExamplesToInject(): number;
+    set MaxExamplesToInject(value: number);
+    /**
+    * * Field Name: ExampleInjectionStrategy
+    * * Display Name: Example Injection Strategy
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Semantic
+    * * Value List Type: List
+    * * Possible Values
+    *   * Rated
+    *   * Recent
+    *   * Semantic
+    * * Description: Strategy for selecting which examples to inject: Semantic (vector similarity), Recent (most recent first), or Rated (highest success score first).
+    */
+    get ExampleInjectionStrategy(): 'Rated' | 'Recent' | 'Semantic';
+    set ExampleInjectionStrategy(value: 'Rated' | 'Recent' | 'Semantic');
+    /**
     * * Field Name: Parent
     * * Display Name: Parent
     * * SQL Data Type: nvarchar(255)
@@ -22212,6 +22510,15 @@ export declare class FileStorageProviderEntity extends BaseEntity<FileStoragePro
     * * Default Value: getutcdate()
     */
     get __mj_UpdatedAt(): Date;
+    /**
+    * * Field Name: SupportsSearch
+    * * Display Name: Supports Search
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: Indicates whether this storage provider supports native full-text search across file names and content. Providers with native search APIs (Google Drive, SharePoint, Dropbox, Box) have this set to true.
+    */
+    get SupportsSearch(): boolean;
+    set SupportsSearch(value: boolean);
 }
 /**
  * Files - strongly typed entity sub-class
@@ -23775,6 +24082,202 @@ export declare class AIAgentDataSourceEntity extends BaseEntity<AIAgentDataSourc
     */
     get Agent(): string | null;
 }
+/**
+ * MJ: AI Agent Examples - strongly typed entity sub-class
+ * * Schema: __mj
+ * * Base Table: AIAgentExample
+ * * Base View: vwAIAgentExamples
+ * * @description Stores example input/output pairs for AI agents to learn from successful interactions. Examples are always agent-specific and support optional user/company scoping for personalized examples.
+ * * Primary Key: ID
+ * @extends {BaseEntity}
+ * @class
+ * @public
+ */
+export declare class AIAgentExampleEntity extends BaseEntity<AIAgentExampleEntityType> {
+    /**
+    * Loads the MJ: AI Agent Examples record from the database
+    * @param ID: string - primary key value to load the MJ: AI Agent Examples record.
+    * @param EntityRelationshipsToLoad - (optional) the relationships to load
+    * @returns {Promise<boolean>} - true if successful, false otherwise
+    * @public
+    * @async
+    * @memberof AIAgentExampleEntity
+    * @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: AgentID
+    * * Display Name: Agent ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: AI Agents (vwAIAgents.ID)
+    * * Description: The AI agent this example is associated with. Examples are always agent-specific.
+    */
+    get AgentID(): string;
+    set AgentID(value: string);
+    /**
+    * * Field Name: UserID
+    * * Display Name: User ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Users (vwUsers.ID)
+    * * Description: Optional user scope. When populated, this example is specific to this user.
+    */
+    get UserID(): string | null;
+    set UserID(value: string | null);
+    /**
+    * * Field Name: CompanyID
+    * * Display Name: Company ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Companies (vwCompanies.ID)
+    * * Description: Optional company scope. When populated, this example is specific to this company.
+    */
+    get CompanyID(): string | null;
+    set CompanyID(value: string | null);
+    /**
+    * * Field Name: Type
+    * * Display Name: Type
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Example
+    * * Value List Type: List
+    * * Possible Values
+    *   * Constraint
+    *   * Context
+    *   * Example
+    *   * Issue
+    *   * Preference
+    * * Description: Quick categorization of the example: Preference (demonstrates user preference), Constraint (shows constraint compliance), Context (provides contextual example), Example (typical successful interaction - most common), or Issue (demonstrates handling of known issue).
+    */
+    get Type(): 'Constraint' | 'Context' | 'Example' | 'Issue' | 'Preference';
+    set Type(value: 'Constraint' | 'Context' | 'Example' | 'Issue' | 'Preference');
+    /**
+    * * Field Name: ExampleInput
+    * * Display Name: Example Input
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: The input text or prompt that was provided in this example interaction.
+    */
+    get ExampleInput(): string;
+    set ExampleInput(value: string);
+    /**
+    * * Field Name: ExampleOutput
+    * * Display Name: Example Output
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: The successful output or response that the agent provided for this example.
+    */
+    get ExampleOutput(): string;
+    set ExampleOutput(value: string);
+    /**
+    * * Field Name: IsAutoGenerated
+    * * Display Name: Is Auto Generated
+    * * SQL Data Type: bit
+    * * Default Value: 0
+    * * Description: Indicates whether this example was automatically captured (1) or manually created (0).
+    */
+    get IsAutoGenerated(): boolean;
+    set IsAutoGenerated(value: boolean);
+    /**
+    * * Field Name: SourceConversationID
+    * * Display Name: Source Conversation ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Conversations (vwConversations.ID)
+    * * Description: Optional reference to the conversation where this example originated.
+    */
+    get SourceConversationID(): string | null;
+    set SourceConversationID(value: string | null);
+    /**
+    * * Field Name: SourceConversationDetailID
+    * * Display Name: Source Conversation Detail ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: Conversation Details (vwConversationDetails.ID)
+    * * Description: Optional reference to the specific conversation message that represents this example.
+    */
+    get SourceConversationDetailID(): string | null;
+    set SourceConversationDetailID(value: string | null);
+    /**
+    * * Field Name: SourceAIAgentRunID
+    * * Display Name: Source AI Agent Run ID
+    * * SQL Data Type: uniqueidentifier
+    * * Related Entity/Foreign Key: MJ: AI Agent Runs (vwAIAgentRuns.ID)
+    * * Description: Optional reference to the AI agent run that generated this example.
+    */
+    get SourceAIAgentRunID(): string | null;
+    set SourceAIAgentRunID(value: string | null);
+    /**
+    * * Field Name: SuccessScore
+    * * Display Name: Success Score
+    * * SQL Data Type: decimal(5, 2)
+    * * Description: Optional success score (0-100) indicating the quality or effectiveness of this example based on user feedback or metrics.
+    */
+    get SuccessScore(): number | null;
+    set SuccessScore(value: number | null);
+    /**
+    * * Field Name: Comments
+    * * Display Name: Comments
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: Internal comments about this example, not included in agent context injection.
+    */
+    get Comments(): string | null;
+    set Comments(value: string | null);
+    /**
+    * * Field Name: Status
+    * * Display Name: Status
+    * * SQL Data Type: nvarchar(20)
+    * * Default Value: Active
+    * * Value List Type: List
+    * * Possible Values
+    *   * Active
+    *   * Pending
+    *   * Revoked
+    * * Description: Status of the example: Pending (awaiting review), Active (in use), or Revoked (disabled).
+    */
+    get Status(): 'Active' | 'Pending' | 'Revoked';
+    set Status(value: 'Active' | 'Pending' | 'Revoked');
+    /**
+    * * 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;
+    /**
+    * * Field Name: Agent
+    * * Display Name: Agent
+    * * SQL Data Type: nvarchar(255)
+    */
+    get Agent(): string | null;
+    /**
+    * * Field Name: User
+    * * Display Name: User
+    * * SQL Data Type: nvarchar(100)
+    */
+    get User(): string | null;
+    /**
+    * * Field Name: Company
+    * * Display Name: Company
+    * * SQL Data Type: nvarchar(50)
+    */
+    get Company(): string | null;
+    /**
+    * * Field Name: SourceConversation
+    * * Display Name: Source Conversation
+    * * SQL Data Type: nvarchar(255)
+    */
+    get SourceConversation(): string | null;
+}
 /**
  * MJ: AI Agent Permissions - strongly typed entity sub-class
  * * Schema: __mj
@@ -24279,13 +24782,15 @@ export declare class AIAgentRunStepEntity extends BaseEntity<AIAgentRunStepEntit
     *   * Actions
     *   * Chat
     *   * Decision
+    *   * ForEach
     *   * Prompt
     *   * Sub-Agent
     *   * Validation
+    *   * While
     * * Description: Type of execution step: Prompt, Actions, Sub-Agent, Decision, Chat, Validation
     */
-    get StepType(): 'Actions' | 'Chat' | 'Decision' | 'Prompt' | 'Sub-Agent' | 'Validation';
-    set StepType(value: 'Actions' | 'Chat' | 'Decision' | 'Prompt' | 'Sub-Agent' | 'Validation');
+    get StepType(): 'Actions' | 'Chat' | 'Decision' | 'ForEach' | 'Prompt' | 'Sub-Agent' | 'Validation' | 'While';
+    set StepType(value: 'Actions' | 'Chat' | 'Decision' | 'ForEach' | 'Prompt' | 'Sub-Agent' | 'Validation' | 'While');
     /**
     * * Field Name: StepName
     * * Display Name: Step Name
@@ -24726,13 +25231,15 @@ export declare class AIAgentRunEntity extends BaseEntity<AIAgentRunEntityType> {
     *   * Actions
     *   * Chat
     *   * Failed
+    *   * ForEach
     *   * Retry
     *   * Sub-Agent
     *   * Success
+    *   * While
     * * Description: The final step type that concluded the agent run
     */
-    get FinalStep(): 'Actions' | 'Chat' | 'Failed' | 'Retry' | 'Sub-Agent' | 'Success' | null;
-    set FinalStep(value: 'Actions' | 'Chat' | 'Failed' | 'Retry' | 'Sub-Agent' | 'Success' | null);
+    get FinalStep(): 'Actions' | 'Chat' | 'Failed' | 'ForEach' | 'Retry' | 'Sub-Agent' | 'Success' | 'While' | null;
+    set FinalStep(value: 'Actions' | 'Chat' | 'Failed' | 'ForEach' | 'Retry' | 'Sub-Agent' | 'Success' | 'While' | null);
     /**
     * * Field Name: FinalPayload
     * * Display Name: Final Payload
@@ -25107,12 +25614,14 @@ export declare class AIAgentStepEntity extends BaseEntity<AIAgentStepEntityType>
     * * Value List Type: List
     * * Possible Values
     *   * Action
+    *   * ForEach
     *   * Prompt
     *   * Sub-Agent
+    *   * While
     * * Description: Type of step: Action (execute an action), Sub-Agent (delegate to another agent), or Prompt (run an AI prompt)
     */
-    get StepType(): 'Action' | 'Prompt' | 'Sub-Agent';
-    set StepType(value: 'Action' | 'Prompt' | 'Sub-Agent');
+    get StepType(): 'Action' | 'ForEach' | 'Prompt' | 'Sub-Agent' | 'While';
+    set StepType(value: 'Action' | 'ForEach' | 'Prompt' | 'Sub-Agent' | 'While');
     /**
     * * Field Name: StartingStep
     * * Display Name: Starting Step
@@ -25252,6 +25761,27 @@ export declare class AIAgentStepEntity extends BaseEntity<AIAgentStepEntityType>
     get ActionInputMapping(): string | null;
     set ActionInputMapping(value: string | null);
     /**
+    * * Field Name: LoopBodyType
+    * * Display Name: Loop Body Type
+    * * SQL Data Type: nvarchar(50)
+    * * Value List Type: List
+    * * Possible Values
+    *   * Action
+    *   * Prompt
+    *   * Sub-Agent
+    * * Description: Specifies what type of operation executes in the loop body. Values: Action, Sub-Agent, Prompt. Only used when StepType is ForEach or While.
+    */
+    get LoopBodyType(): 'Action' | 'Prompt' | 'Sub-Agent' | null;
+    set LoopBodyType(value: 'Action' | 'Prompt' | 'Sub-Agent' | null);
+    /**
+    * * Field Name: Configuration
+    * * Display Name: Configuration
+    * * SQL Data Type: nvarchar(MAX)
+    * * Description: JSON configuration object for step-specific settings. For loop steps: { type: "ForEach"|"While", collectionPath?, itemVariable?, indexVariable?, maxIterations?, continueOnError?, condition? }. For other step types: reserved for future use.
+    */
+    get Configuration(): string | null;
+    set Configuration(value: string | null);
+    /**
     * * Field Name: Agent
     * * Display Name: Agent
     * * SQL Data Type: nvarchar(255)
@@ -28072,8 +28602,8 @@ export declare class ArtifactEntity extends BaseEntity<ArtifactEntityType> {
     * * Default Value: Always
     * * Value List Type: List
     * * Possible Values
-    *   * System Only
     *   * Always
+    *   * System Only
     * * Description: Controls artifact visibility in user-facing lists. "Always" shows in all lists, "System Only" hides from normal views (for system-generated artifacts like agent routing payloads).
     */
     get Visibility(): 'Always' | 'System Only';
@@ -34542,6 +35072,7 @@ export declare class RoleEntity extends BaseEntity<RoleEntityType> {
     /**
     * * Field Name: Name
     * * SQL Data Type: nvarchar(50)
+    * * Description: Role with full permissions to manage AI agents and all related entities. This role is required for AgentSpecSync operations to function correctly, allowing create, read, update, and delete operations on agents, prompts, actions, relationships, steps, and paths.
     */
     get Name(): string;
     set Name(value: string);