@ai.ntellect/core 0.7.14 → 0.8.0

package/types/index.ts

@@ -14,10 +14,12 @@ import { IEventEmitter } from "../interfaces";
  */
 export interface CreateMemoryInput {
   id?: string;
-  data: string;
+  content: string;
+  metadata?: Record<string, any>;
   embedding?: number[];
   roomId: string;
   ttl?: number;
+  type?: string;
 }
 
 /**
@@ -32,7 +34,8 @@ export interface CreateMemoryInput {
  */
 export interface BaseMemoryType {
   id: string;
-  data: string;
+  content: string;
+  metadata?: Record<string, any>;
   embedding?: number[];
   roomId: string;
   createdAt: Date;
@@ -73,6 +76,22 @@ export type GraphContext<T extends ZodSchema> = {
   [key: string]: any;
 };
 
+/**
+ * Configuration for event handling in a node
+ */
+export type EventStrategy = {
+  type: "single" | "all" | "correlate";
+  correlation?: (events: any[]) => boolean;
+};
+
+export type EventConfig = {
+  events: string[];
+  timeout?: number;
+  strategy: EventStrategy;
+  onSuccess?: (events: any[]) => Promise<void>;
+  onTimeout?: () => Promise<void>;
+};
+
 /**
  * Interface representing a node in the graph
  * @interface
@@ -80,7 +99,7 @@ export type GraphContext<T extends ZodSchema> = {
  * @template I - Input schema type
  * @template O - Output schema type
  */
-export type GraphNodeConfig<T extends ZodSchema, P = any> = {
+export interface GraphNodeConfig<T extends ZodSchema, P = any> {
   /** Name of the node */
   name: string;
   /** Description of the node */
@@ -106,16 +125,8 @@ export type GraphNodeConfig<T extends ZodSchema, P = any> = {
     | ((context: GraphContext<T>) => string[]);
   /** Array of event names that trigger this node */
   events?: string[];
-  /** Wait for a single event before continuing */
-  waitForEvent?: boolean;
-  /** Wait for multiple events configuration */
-  waitForEvents?: WaitForEvents;
-  /** Event correlation configuration */
-  correlateEvents?: {
-    events: string[];
-    timeout: number;
-    correlation: (events: any[]) => boolean;
-  };
+  /** Event handling configuration */
+  when?: EventConfig;
   /** Retry configuration */
   retry?: {
     /** Maximum number of retry attempts */
@@ -129,7 +140,8 @@ export type GraphNodeConfig<T extends ZodSchema, P = any> = {
   };
   /** Error handler function */
   onError?: (error: Error) => void;
-};
+  agent?: string;
+}
 
 /**
  * Interface for graph definition
@@ -193,15 +205,59 @@ export type MeilisearchSettings = {
   sortableAttributes?: string[];
 };
 
-export interface GraphEvent<T extends ZodSchema> {
+export type GraphEvent<T extends ZodSchema> = {
   type: string;
   payload?: any;
   timestamp: number;
-}
+};
 
-export interface WaitForEvents {
+export type WaitForEvents<T extends ZodSchema> = {
   events: string[];
   timeout?: number;
   strategy: "all" | "any" | "race";
   onSuccess?: <T extends ZodSchema>(context: GraphContext<T>) => Promise<void>;
-}
+};
+
+/**
+ * Configuration interface for NLP Engine
+ * @interface NLPConfig
+ * @property {any} [corpus] - Training corpus data
+ * @property {Record<string, any>} [responses] - Response templates
+ * @property {Record<string, any>} [entities] - Entity definitions
+ * @property {string} [language] - Language code (default: 'en')
+ * @property {number} [threshold] - Entity recognition threshold (default: 0.5)
+ * @property {string} [path] - Path to save/load model
+ */
+export type NLPConfig = {
+  corpus?: any;
+  responses?: Record<string, any>;
+  entities?: Record<string, any>;
+  language?: string;
+  threshold?: number;
+  path?: string;
+};
+
+/**
+ * Type definition for action handlers
+ * @callback ActionHandler
+ * @param {any} data - Input data for the action
+ * @returns {Promise<any>} Result of the action
+ */
+export type ActionHandler = (data: any) => Promise<any>;
+
+/**
+ * Options for the observer
+ * @typedef {Object} ObserverOptions
+ * @property {number} [debounce] - Debounce time in milliseconds
+ * @property {number} [delay] - Delay time in milliseconds
+ * @property {boolean} [stream] - Whether to stream the response
+ * @property {(string | number)[]} [properties] - Properties to observe
+ */
+export type ObserverOptions = {
+  debounce?: number;
+  delay?: number;
+  stream?: boolean;
+  properties?: (string | number)[]; // Accepte uniquement string ou number comme clés
+  onStreamLetter?: (data: { letter: string; property: string }) => void;
+  onStreamComplete?: () => void;
+};