@futdevpro/fsm-dynamo 1.16.38 → 1.16.40

package/src/_modules/messaging/_models/msg-message.data-model.ts

@@ -1,127 +1,127 @@
-import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
-import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
-import { DyFM_Msg_Type } from '../_enums/msg-type.enum';
-import { DyFM_Msg_Status } from '../_enums/msg-status.enum';
-import { DyFM_Msg_Attachment } from './msg-attachment.interface';
-import { DyFM_Msg_Mention } from './msg-mention.interface';
-import { DyFM_Msg_Reaction } from './msg-reaction.interface';
-import { DyFM_Msg_ThreadInfo } from './msg-thread-info.interface';
-import { DyFM_Agt_ProcessStep } from '../_modules/agent/_models/agt-process-step.interface';
-
-/**
- * Core message model for unified messaging system.
- * Supports user↔user, user↔AI, and agent process communications.
- */
-export class DyFM_Msg_Message extends DyFM_Metadata {
-  conversationId: string;
-  
-  // Content
-  content: string;
-  type: DyFM_Msg_Type;
-  status: DyFM_Msg_Status;
-  
-  // Sender/Recipient
-  senderId: string;
-  senderName?: string;
-  senderDisplayName?: string;
-  recipientIds?: string[];
-  
-  // Threading
-  parentMessageId?: string;
-  threadId?: string;
-  threadInfo?: DyFM_Msg_ThreadInfo;
-  
-  // Rich Content
-  attachments?: DyFM_Msg_Attachment[];
-  mentions?: DyFM_Msg_Mention[];
-  reactions?: DyFM_Msg_Reaction[];
-  
-  // AI-Specific Fields
-  aiProvider?: string;
-  aiModel?: string;
-  isAIGenerated?: boolean;
-  systemPrompt?: string;
-  
-  // Agent Process Fields
-  agentProcessSteps?: DyFM_Agt_ProcessStep[];
-  
-  // Platform Integration
-  platformSource?: string;
-  platformMessageId?: string;
-  platformChannelId?: string;
-  
-  // Timestamps
-  sentAt?: Date;
-  deliveredAt?: Date;
-  readAt?: Date;
-  editedAt?: Date;
-  
-  constructor(set?: DyFM_Msg_Message) {
-    super(set);
-    
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const DyFM_msgMessage_dataParams: DyFM_DataModel_Params<DyFM_Msg_Message> = 
-  new DyFM_DataModel_Params<DyFM_Msg_Message>({
-    dataName: 'msg_message',
-    properties: {
-      conversationId: { key: 'conversationId', type: 'string', 
-        required: true, index: true,
-      },
-      
-      content: { key: 'content', type: 'string', 
-        required: true,
-      },
-      type: { key: 'type', type: 'string', 
-        required: true,
-      },
-      status: { key: 'status', type: 'string', 
-        required: true, index: true,
-      },
-      
-      senderId: { key: 'senderId', type: 'string', 
-        required: true, index: true,
-      },
-      senderName: { key: 'senderName', type: 'string' },
-      senderDisplayName: { key: 'senderDisplayName', type: 'string' },
-      recipientIds: { key: 'recipientIds', type: 'string[]' },
-      
-      parentMessageId: { key: 'parentMessageId', type: 'string', 
-        index: true,
-      },
-      threadId: { key: 'threadId', type: 'string', 
-        index: true,
-      },
-      threadInfo: { key: 'threadInfo', type: 'object' },
-      
-      attachments: { key: 'attachments', type: 'object[]' },
-      mentions: { key: 'mentions', type: 'object[]' },
-      reactions: { key: 'reactions', type: 'object[]' },
-      
-      aiProvider: { key: 'aiProvider', type: 'string' },
-      aiModel: { key: 'aiModel', type: 'string' },
-      isAIGenerated: { key: 'isAIGenerated', type: 'boolean' },
-      systemPrompt: { key: 'systemPrompt', type: 'string' },
-      
-      agentProcessSteps: { key: 'agentProcessSteps', type: 'object[]' },
-      
-      platformSource: { key: 'platformSource', type: 'string' },
-      platformMessageId: { key: 'platformMessageId', type: 'string', 
-        index: true,
-      },
-      platformChannelId: { key: 'platformChannelId', type: 'string', 
-        index: true,
-      },
-      
-      sentAt: { key: 'sentAt', type: 'Date', 
-        index: true,
-      },
-      deliveredAt: { key: 'deliveredAt', type: 'Date' },
-      readAt: { key: 'readAt', type: 'Date' },
-      editedAt: { key: 'editedAt', type: 'Date' },
-    },
-  });
+import { DyFM_Metadata } from '../../../_models/data-models/metadata.data-model';
+import { DyFM_DataModel_Params } from '../../../_models/control-models/data-model-params.control-model';
+import { DyFM_Msg_Type } from '../_enums/msg-type.enum';
+import { DyFM_Msg_Status } from '../_enums/msg-status.enum';
+import { DyFM_Msg_Attachment } from './msg-attachment.interface';
+import { DyFM_Msg_Mention } from './msg-mention.interface';
+import { DyFM_Msg_Reaction } from './msg-reaction.interface';
+import { DyFM_Msg_ThreadInfo } from './msg-thread-info.interface';
+import { DyFM_Agt_ProcessStep } from '../_modules/agent/_models/agt-process-step.interface';
+
+/**
+ * Core message model for unified messaging system.
+ * Supports user↔user, user↔AI, and agent process communications.
+ */
+export class DyFM_Msg_Message extends DyFM_Metadata {
+  conversationId: string;
+  
+  // Content
+  content: string;
+  type: DyFM_Msg_Type;
+  status: DyFM_Msg_Status;
+  
+  // Sender/Recipient
+  senderId: string;
+  senderName?: string;
+  senderDisplayName?: string;
+  recipientIds?: string[];
+  
+  // Threading
+  parentMessageId?: string;
+  threadId?: string;
+  threadInfo?: DyFM_Msg_ThreadInfo;
+  
+  // Rich Content
+  attachments?: DyFM_Msg_Attachment[];
+  mentions?: DyFM_Msg_Mention[];
+  reactions?: DyFM_Msg_Reaction[];
+  
+  // AI-Specific Fields
+  aiProvider?: string;
+  aiModel?: string;
+  isAIGenerated?: boolean;
+  systemPrompt?: string;
+  
+  // Agent Process Fields
+  agentProcessSteps?: DyFM_Agt_ProcessStep[];
+  
+  // Platform Integration
+  platformSource?: string;
+  platformMessageId?: string;
+  platformChannelId?: string;
+  
+  // Timestamps
+  sentAt?: Date;
+  deliveredAt?: Date;
+  readAt?: Date;
+  editedAt?: Date;
+  
+  constructor(set?: DyFM_Msg_Message) {
+    super(set);
+    
+    if (set) {
+      Object.assign(this, set);
+    }
+  }
+}
+
+export const DyFM_msgMessage_dataParams: DyFM_DataModel_Params<DyFM_Msg_Message> = 
+  new DyFM_DataModel_Params<DyFM_Msg_Message>({
+    dataName: 'msg_message',
+    properties: {
+      conversationId: { key: 'conversationId', type: 'string', 
+        required: true, index: true,
+      },
+      
+      content: { key: 'content', type: 'string', 
+        required: true,
+      },
+      type: { key: 'type', type: 'string', 
+        required: true,
+      },
+      status: { key: 'status', type: 'string', 
+        required: true, index: true,
+      },
+      
+      senderId: { key: 'senderId', type: 'string', 
+        required: true, index: true,
+      },
+      senderName: { key: 'senderName', type: 'string' },
+      senderDisplayName: { key: 'senderDisplayName', type: 'string' },
+      recipientIds: { key: 'recipientIds', type: 'string[]' },
+      
+      parentMessageId: { key: 'parentMessageId', type: 'string', 
+        index: true,
+      },
+      threadId: { key: 'threadId', type: 'string', 
+        index: true,
+      },
+      threadInfo: { key: 'threadInfo', type: 'object' },
+      
+      attachments: { key: 'attachments', type: 'object[]' },
+      mentions: { key: 'mentions', type: 'object[]' },
+      reactions: { key: 'reactions', type: 'object[]' },
+      
+      aiProvider: { key: 'aiProvider', type: 'string' },
+      aiModel: { key: 'aiModel', type: 'string' },
+      isAIGenerated: { key: 'isAIGenerated', type: 'boolean' },
+      systemPrompt: { key: 'systemPrompt', type: 'string' },
+      
+      agentProcessSteps: { key: 'agentProcessSteps', type: 'object[]' },
+      
+      platformSource: { key: 'platformSource', type: 'string' },
+      platformMessageId: { key: 'platformMessageId', type: 'string', 
+        index: true,
+      },
+      platformChannelId: { key: 'platformChannelId', type: 'string', 
+        index: true,
+      },
+      
+      sentAt: { key: 'sentAt', type: 'Date', 
+        index: true,
+      },
+      deliveredAt: { key: 'deliveredAt', type: 'Date' },
+      readAt: { key: 'readAt', type: 'Date' },
+      editedAt: { key: 'editedAt', type: 'Date' },
+    },
+  });

package/src/_modules/messaging/_models/msg-participant.interface.ts

@@ -1,46 +1,46 @@
-import { DyFM_Msg_ParticipantRole } from '../_enums/msg-participant-role.enum';
-
-/**
- * Message Participant Interface
- * Represents a participant in a conversation
- */
-export interface DyFM_Msg_Participant {
-  /** User/bot/AI ID */
-  userId: string;
-  
-  /** Display name */
-  displayName?: string;
-  
-  /** Username */
-  username?: string;
-  
-  /** Role in the conversation */
-  role: DyFM_Msg_ParticipantRole;
-  
-  /** When the participant joined */
-  joinedAt: Date;
-  
-  /** Last time the participant was active */
-  lastActiveAt?: Date;
-  
-  /** Last message ID read by this participant */
-  lastReadMessageId?: string;
-  
-  /** Timestamp of last read */
-  lastReadAt?: Date;
-  
-  /** Whether participant has muted this conversation */
-  isMuted?: boolean;
-  
-  /** Custom notification settings */
-  notificationSettings?: {
-    muteUntil?: Date;
-    onlyMentions?: boolean;
-  };
-  
-  /** Platform-specific participant ID (Discord, Slack, etc.) */
-  platformUserId?: string;
-  
-  /** Is this participant currently typing? (real-time state) */
-  isTyping?: boolean;
-}
+import { DyFM_Msg_ParticipantRole } from '../_enums/msg-participant-role.enum';
+
+/**
+ * Message Participant Interface
+ * Represents a participant in a conversation
+ */
+export interface DyFM_Msg_Participant {
+  /** User/bot/AI ID */
+  userId: string;
+  
+  /** Display name */
+  displayName?: string;
+  
+  /** Username */
+  username?: string;
+  
+  /** Role in the conversation */
+  role: DyFM_Msg_ParticipantRole;
+  
+  /** When the participant joined */
+  joinedAt: Date;
+  
+  /** Last time the participant was active */
+  lastActiveAt?: Date;
+  
+  /** Last message ID read by this participant */
+  lastReadMessageId?: string;
+  
+  /** Timestamp of last read */
+  lastReadAt?: Date;
+  
+  /** Whether participant has muted this conversation */
+  isMuted?: boolean;
+  
+  /** Custom notification settings */
+  notificationSettings?: {
+    muteUntil?: Date;
+    onlyMentions?: boolean;
+  };
+  
+  /** Platform-specific participant ID (Discord, Slack, etc.) */
+  platformUserId?: string;
+  
+  /** Is this participant currently typing? (real-time state) */
+  isTyping?: boolean;
+}

package/src/_modules/messaging/_models/msg-reaction.interface.ts

@@ -1,20 +1,20 @@
-/**
- * Message Reaction Interface
- * Represents an individual emoji reaction to a message
- */
-export interface DyFM_Msg_Reaction {
-  /** Emoji or reaction identifier */
-  emoji: string;
-  
-  /** User ID who reacted */
-  userId: string;
-  
-  /** Timestamp when user reacted */
-  reactedAt: Date;
-  
-  /** Unicode representation of emoji */
-  unicode?: string;
-  
-  /** Custom emoji ID (if custom emoji) */
-  customEmojiId?: string;
-}
+/**
+ * Message Reaction Interface
+ * Represents an individual emoji reaction to a message
+ */
+export interface DyFM_Msg_Reaction {
+  /** Emoji or reaction identifier */
+  emoji: string;
+  
+  /** User ID who reacted */
+  userId: string;
+  
+  /** Timestamp when user reacted */
+  reactedAt: Date;
+  
+  /** Unicode representation of emoji */
+  unicode?: string;
+  
+  /** Custom emoji ID (if custom emoji) */
+  customEmojiId?: string;
+}

package/src/_modules/messaging/_models/msg-thread-info.interface.ts

@@ -1,35 +1,35 @@
-/**
- * Message Thread Info Interface
- * Represents metadata about a message thread
- */
-export interface DyFM_Msg_ThreadInfo {
-  /** Unique thread ID */
-  threadId: string;
-  
-  /** ID of the parent message that started the thread */
-  parentMessageId: string;
-  
-  /** Thread title (optional) */
-  title?: string;
-  
-  /** Number of messages in the thread */
-  messageCount: number;
-  
-  /** IDs of participants in the thread */
-  participantIds: string[];
-  
-  /** Last message in the thread */
-  lastMessageId?: string;
-  
-  /** Timestamp of last message */
-  lastMessageAt?: Date;
-  
-  /** Preview of last message */
-  lastMessagePreview?: string;
-  
-  /** Whether thread is locked (no new messages) */
-  isLocked?: boolean;
-  
-  /** Whether thread is resolved (for support threads) */
-  isResolved?: boolean;
-}
+/**
+ * Message Thread Info Interface
+ * Represents metadata about a message thread
+ */
+export interface DyFM_Msg_ThreadInfo {
+  /** Unique thread ID */
+  threadId: string;
+  
+  /** ID of the parent message that started the thread */
+  parentMessageId: string;
+  
+  /** Thread title (optional) */
+  title?: string;
+  
+  /** Number of messages in the thread */
+  messageCount: number;
+  
+  /** IDs of participants in the thread */
+  participantIds: string[];
+  
+  /** Last message in the thread */
+  lastMessageId?: string;
+  
+  /** Timestamp of last message */
+  lastMessageAt?: Date;
+  
+  /** Preview of last message */
+  lastMessagePreview?: string;
+  
+  /** Whether thread is locked (no new messages) */
+  isLocked?: boolean;
+  
+  /** Whether thread is resolved (for support threads) */
+  isResolved?: boolean;
+}

package/src/_modules/messaging/_modules/agent/_enums/agt-process-step-type.enum.ts

@@ -1,35 +1,35 @@
-/**
- * Agent Process Step Type Enum
- * Types of steps in an AI agent's reasoning process
- */
-export enum DyFM_Agt_ProcessStepType {
-  /** Agent is collecting context */
-  collectContext = 'collect-context',
-
-  /** Agent is analyzing the input/question */
-  analyze = 'analyze',
-  
-  /** Agent is reasoning about the solution */
-  reason = 'reason',
-  
-  /** Agent is planning its approach */
-  plan = 'plan',
-  
-  /** Agent is executing a tool/function */
-  toolUse = 'tool-use',
-  
-  /** Agent is retrieving information */
-  retrieve = 'retrieve',
-  
-  /** Agent is generating a response */
-  generate = 'generate',
-  
-  /** Agent is validating/checking results */
-  validate = 'validate',
-  
-  /** Agent encountered an error */
-  error = 'error',
-  
-  /** Agent completed the process */
-  complete = 'complete',
-}
+/**
+ * Agent Process Step Type Enum
+ * Types of steps in an AI agent's reasoning process
+ */
+export enum DyFM_Agt_ProcessStepType {
+  /** Agent is collecting context */
+  collectContext = 'collect-context',
+
+  /** Agent is analyzing the input/question */
+  analyze = 'analyze',
+  
+  /** Agent is reasoning about the solution */
+  reason = 'reason',
+  
+  /** Agent is planning its approach */
+  plan = 'plan',
+  
+  /** Agent is executing a tool/function */
+  toolUse = 'tool-use',
+  
+  /** Agent is retrieving information */
+  retrieve = 'retrieve',
+  
+  /** Agent is generating a response */
+  generate = 'generate',
+  
+  /** Agent is validating/checking results */
+  validate = 'validate',
+  
+  /** Agent encountered an error */
+  error = 'error',
+  
+  /** Agent completed the process */
+  complete = 'complete',
+}

package/src/_modules/messaging/_modules/agent/_enums/agt-tool-status.enum.ts

@@ -1,23 +1,23 @@
-/**
- * Agent Tool Status Enum
- * Status of a tool execution in the agent process
- */
-export enum DyFM_Agt_ToolStatus {
-  /** Tool execution is pending */
-  pending = 'pending',
-  
-  /** Tool is currently executing */
-  running = 'running',
-  
-  /** Tool execution completed successfully */
-  success = 'success',
-  
-  /** Tool execution failed */
-  failed = 'failed',
-  
-  /** Tool execution was cancelled */
-  cancelled = 'cancelled',
-  
-  /** Tool execution timed out */
-  timeout = 'timeout',
-}
+/**
+ * Agent Tool Status Enum
+ * Status of a tool execution in the agent process
+ */
+export enum DyFM_Agt_ToolStatus {
+  /** Tool execution is pending */
+  pending = 'pending',
+  
+  /** Tool is currently executing */
+  running = 'running',
+  
+  /** Tool execution completed successfully */
+  success = 'success',
+  
+  /** Tool execution failed */
+  failed = 'failed',
+  
+  /** Tool execution was cancelled */
+  cancelled = 'cancelled',
+  
+  /** Tool execution timed out */
+  timeout = 'timeout',
+}