@futdevpro/fsm-dynamo 1.15.21 → 1.15.22

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',
+}

package/src/_modules/messaging/_modules/agent/_models/agt-process-step.interface.ts

@@ -1,55 +1,55 @@
-import { DyFM_Agt_ProcessStepType } from '../_enums/agt-process-step-type.enum';
-import { DyFM_Agt_ToolUsage } from './agt-tool-usage.interface';
-import { DyFM_Agt_ReasoningInfo } from './agt-reasoning-info.interface';
-
-/**
- * Agent Process Step Interface
- * Represents a single step in an AI agent's execution process
- * Used for visualizing agent reasoning and tool usage
- */
-export interface DyFM_Agt_ProcessStep {
-  /** Step name */
-  name: string;
-
-  /** Unique step ID */
-  stepId: string;
-  
-  /** Type of process step */
-  type: DyFM_Agt_ProcessStepType;
-  
-  /** Human-readable description of this step */
-  description: string;
-  
-  /** Detailed reasoning for this step */
-  reasoning?: DyFM_Agt_ReasoningInfo | string;
-  
-  /** Tool usage (if this step involves a tool) */
-  toolUsage?: DyFM_Agt_ToolUsage;
-  
-  /** Result/output of this step */
-  result?: string;
-  
-  /** Input to this step */
-  input?: any;
-  
-  /** Output from this step */
-  output?: any;
-  
-  /** Timestamp when step started */
-  timestamp: Date;
-  
-  /** Duration of this step in milliseconds */
-  durationMs?: number;
-  
-  /** Confidence level for this step (0.0 - 1.0) */
-  confidence?: number;
-  
-  /** Whether this step was successful */
-  success?: boolean;
-  
-  /** Error message if step failed */
-  error?: string;
-  
-  /** Metadata for the step */
-  metadata?: Record<string, any>;
-}
+import { DyFM_Agt_ProcessStepType } from '../_enums/agt-process-step-type.enum';
+import { DyFM_Agt_ToolUsage } from './agt-tool-usage.interface';
+import { DyFM_Agt_ReasoningInfo } from './agt-reasoning-info.interface';
+
+/**
+ * Agent Process Step Interface
+ * Represents a single step in an AI agent's execution process
+ * Used for visualizing agent reasoning and tool usage
+ */
+export interface DyFM_Agt_ProcessStep {
+  /** Step name */
+  name: string;
+
+  /** Unique step ID */
+  stepId: string;
+  
+  /** Type of process step */
+  type: DyFM_Agt_ProcessStepType;
+  
+  /** Human-readable description of this step */
+  description: string;
+  
+  /** Detailed reasoning for this step */
+  reasoning?: DyFM_Agt_ReasoningInfo | string;
+  
+  /** Tool usage (if this step involves a tool) */
+  toolUsage?: DyFM_Agt_ToolUsage;
+  
+  /** Result/output of this step */
+  result?: string;
+  
+  /** Input to this step */
+  input?: any;
+  
+  /** Output from this step */
+  output?: any;
+  
+  /** Timestamp when step started */
+  timestamp: Date;
+  
+  /** Duration of this step in milliseconds */
+  durationMs?: number;
+  
+  /** Confidence level for this step (0.0 - 1.0) */
+  confidence?: number;
+  
+  /** Whether this step was successful */
+  success?: boolean;
+  
+  /** Error message if step failed */
+  error?: string;
+  
+  /** Metadata for the step */
+  metadata?: Record<string, any>;
+}

package/src/_modules/messaging/_modules/agent/_models/agt-reasoning-info.interface.ts

@@ -1,26 +1,26 @@
-/**
- * Agent Reasoning Info Interface
- * Represents a reasoning step in the AI agent's thought process
- */
-export interface DyFM_Agt_ReasoningInfo {
-  /** Reasoning step ID */
-  id: string;
-  
-  /** Reasoning content/explanation */
-  content: string;
-  
-  /** Confidence level (0.0 - 1.0) */
-  confidence?: number;
-  
-  /** Timestamp */
-  timestamp: Date;
-  
-  /** Duration to generate this reasoning */
-  durationMs?: number;
-  
-  /** Whether this reasoning led to a tool call */
-  ledToToolCall?: boolean;
-  
-  /** Related tool call ID */
-  toolCallId?: string;
-}
+/**
+ * Agent Reasoning Info Interface
+ * Represents a reasoning step in the AI agent's thought process
+ */
+export interface DyFM_Agt_ReasoningInfo {
+  /** Reasoning step ID */
+  id: string;
+  
+  /** Reasoning content/explanation */
+  content: string;
+  
+  /** Confidence level (0.0 - 1.0) */
+  confidence?: number;
+  
+  /** Timestamp */
+  timestamp: Date;
+  
+  /** Duration to generate this reasoning */
+  durationMs?: number;
+  
+  /** Whether this reasoning led to a tool call */
+  ledToToolCall?: boolean;
+  
+  /** Related tool call ID */
+  toolCallId?: string;
+}

package/src/_modules/messaging/_modules/agent/_models/agt-tool-usage.interface.ts

@@ -1,37 +1,37 @@
-import { DyFM_Agt_ToolStatus } from '../_enums/agt-tool-status.enum';
-
-/**
- * Agent Tool Usage Interface
- * Represents the usage of a tool/function by an AI agent
- */
-export interface DyFM_Agt_ToolUsage {
-  /** Tool/function name */
-  toolName: string;
-  
-  /** Tool description */
-  toolDescription?: string;
-  
-  /** Input parameters passed to the tool */
-  input: Record<string, any>;
-  
-  /** Output/result from the tool */
-  output?: any;
-  
-  /** Execution status */
-  status: DyFM_Agt_ToolStatus;
-  
-  /** Error message if failed */
-  error?: string;
-  
-  /** When tool execution started */
-  startedAt: Date;
-  
-  /** When tool execution completed */
-  completedAt?: Date;
-  
-  /** Duration in milliseconds */
-  durationMs?: number;
-  
-  /** Cost of tool execution (if applicable) */
-  cost?: number;
-}
+import { DyFM_Agt_ToolStatus } from '../_enums/agt-tool-status.enum';
+
+/**
+ * Agent Tool Usage Interface
+ * Represents the usage of a tool/function by an AI agent
+ */
+export interface DyFM_Agt_ToolUsage {
+  /** Tool/function name */
+  toolName: string;
+  
+  /** Tool description */
+  toolDescription?: string;
+  
+  /** Input parameters passed to the tool */
+  input: Record<string, any>;
+  
+  /** Output/result from the tool */
+  output?: any;
+  
+  /** Execution status */
+  status: DyFM_Agt_ToolStatus;
+  
+  /** Error message if failed */
+  error?: string;
+  
+  /** When tool execution started */
+  startedAt: Date;
+  
+  /** When tool execution completed */
+  completedAt?: Date;
+  
+  /** Duration in milliseconds */
+  durationMs?: number;
+  
+  /** Cost of tool execution (if applicable) */
+  cost?: number;
+}

package/src/_modules/messaging/_modules/agent/index.ts

@@ -1,8 +1,8 @@
-// ENUMS
-export * from './_enums/agt-process-step-type.enum';
-export * from './_enums/agt-tool-status.enum';
-
-// MODELS
-export * from './_models/agt-process-step.interface';
-export * from './_models/agt-tool-usage.interface';
-export * from './_models/agt-reasoning-info.interface';
+// ENUMS
+export * from './_enums/agt-process-step-type.enum';
+export * from './_enums/agt-tool-status.enum';
+
+// MODELS
+export * from './_models/agt-process-step.interface';
+export * from './_models/agt-tool-usage.interface';
+export * from './_models/agt-reasoning-info.interface';

package/src/_modules/messaging/index.ts

@@ -1,28 +1,28 @@
-//
-// Messaging Module
-//
-// Unified messaging system for user↔user and user↔AI communication
-// Supports integration with bot module and assistant module
-//
-
-// ENUMS
-export * from './_enums/msg-type.enum';
-export * from './_enums/msg-status.enum';
-export * from './_enums/msg-delivery-status.enum';
-export * from './_enums/msg-conversation-type.enum';
-export * from './_enums/msg-participant-role.enum';
-export * from './_enums/msg-provider-type.enum';
-export * from './_enums/msg-attachment-type.enum';
-export * from './_enums/msg-event-key.enum';
-
-// MODELS
-export * from './_models/msg-message.data-model';
-export * from './_models/msg-conversation.data-model';
-export * from './_models/msg-participant.interface';
-export * from './_models/msg-attachment.interface';
-export * from './_models/msg-mention.interface';
-export * from './_models/msg-reaction.interface';
-export * from './_models/msg-thread-info.interface';
-
-// COLLECTIONS
-export * from './_collections/msg-module-settings.const';
+//
+// Messaging Module
+//
+// Unified messaging system for user↔user and user↔AI communication
+// Supports integration with bot module and assistant module
+//
+
+// ENUMS
+export * from './_enums/msg-type.enum';
+export * from './_enums/msg-status.enum';
+export * from './_enums/msg-delivery-status.enum';
+export * from './_enums/msg-conversation-type.enum';
+export * from './_enums/msg-participant-role.enum';
+export * from './_enums/msg-provider-type.enum';
+export * from './_enums/msg-attachment-type.enum';
+export * from './_enums/msg-event-key.enum';
+
+// MODELS
+export * from './_models/msg-message.data-model';
+export * from './_models/msg-conversation.data-model';
+export * from './_models/msg-participant.interface';
+export * from './_models/msg-attachment.interface';
+export * from './_models/msg-mention.interface';
+export * from './_models/msg-reaction.interface';
+export * from './_models/msg-thread-info.interface';
+
+// COLLECTIONS
+export * from './_collections/msg-module-settings.const';

package/src/_modules/ngx-models/_collections/angular-placeholders.ts

@@ -0,0 +1,35 @@
+
+/**
+ * Lightweight substitute for an Angular Signal.
+ * It simply returns the current value when called.
+ *
+ * @example
+ * ```ts
+ * const num$: DyFM_SignalPlaceholder<number> = () => 5;
+ * console.log(num$());
+ * ```
+ */
+export type DyFM_SignalPlaceholder<T> = () => T;
+
+/**
+ * Represents a signal that can also be updated.
+ *
+ * @example
+ * ```ts
+ * const counter: DyFM_WritableSignalPlaceholder<number> = (() => 0) as any;
+ * counter.set(1);
+ * ```
+ */
+export type DyFM_WritableSignalPlaceholder<T> = DyFM_SignalPlaceholder<T> & { set(value: T): void; };
+
+/**
+ * Union of readable and writable signal placeholders.
+ */
+export type DyFM_AnySignalPlaceholder<T> = DyFM_SignalPlaceholder<T> | DyFM_WritableSignalPlaceholder<T>;
+
+/**
+ * Generic key-value map used to store arbitrary parameters.
+ */
+export type DyFM_ParamsPlaceholder = {
+  [key: string]: any;
+};