@ai.ntellect/core 0.6.17 → 0.6.20

package/types/index.ts

@@ -1,4 +1,6 @@
-import { z, ZodSchema } from "zod";
+import { EventEmitter } from "events";
+import { IEventEmitter } from "interfaces";
+import { ZodSchema } from "zod";
 
 /* ======================== MEMORY ======================== */
 
@@ -10,13 +12,13 @@ import { z, ZodSchema } from "zod";
  * @property {string} roomId - The room identifier.
  * @property {number} [ttl] - Time-to-live in seconds (optional).
  */
-export type CreateMemoryInput = {
+export interface CreateMemoryInput {
   id?: string;
-  data: any;
+  data: string;
   embedding?: number[];
   roomId: string;
   ttl?: number;
-};
+}
 
 /**
  * Represents a stored memory entry.
@@ -28,248 +30,137 @@ export type CreateMemoryInput = {
  * @property {string} roomId - The associated room ID.
  * @property {Date} createdAt - Creation date.
  */
-export type BaseMemoryType = {
+export interface BaseMemoryType {
   id: string;
-  data: any;
-  embedding: number[] | null;
+  data: string;
+  embedding?: number[];
   roomId: string;
   createdAt: Date;
-};
-
-/* ======================== QUEUE ======================== */
-
-/**
- * Represents a single parameter for a queued action.
- * @typedef {Object} QueueItemParameter
- * @property {string} name - Parameter name.
- * @property {string} value - Parameter value.
- */
-export type QueueItemParameter = {
-  name: string;
-  value: string;
-};
-
-/**
- * Represents an action in the queue.
- * @typedef {Object} QueueItem
- * @property {string} name - Name of the action.
- * @property {QueueItemParameter[]} parameters - List of parameters.
- */
-export type QueueItem = {
-  name: string;
-  parameters: QueueItemParameter[];
-};
-
-/**
- * Represents the result of a processed queue action.
- * @typedef {Object} QueueResult
- * @property {string} name - Action name.
- * @property {Record<string, string>} parameters - Executed parameters.
- * @property {any} result - The execution result.
- * @property {string | null} error - Error message if any.
- * @property {boolean} [cancelled] - Indicates if the action was cancelled.
- */
-export type QueueResult = {
-  name: string;
-  parameters: Record<string, string>;
-  result: any;
-  error: string | null;
-  cancelled?: boolean;
-};
-
-/**
- * Defines callback functions for queue execution events.
- * @typedef {Object} QueueCallbacks
- * @property {(action: QueueItem) => void} [onActionStart] - Triggered when an action starts.
- * @property {(result: QueueResult) => void} [onActionComplete] - Triggered when an action completes.
- * @property {(results: QueueResult[]) => void} [onQueueComplete] - Triggered when the queue is fully processed.
- * @property {(message: string) => Promise<boolean>} [onConfirmationRequired] - Triggered when confirmation is needed.
- */
-export type QueueCallbacks = {
-  onActionStart?: (action: QueueItem) => void;
-  onActionComplete?: (result: QueueResult) => void;
-  onQueueComplete?: (results: QueueResult[]) => void;
-  onConfirmationRequired?: (message: string) => Promise<boolean>;
-};
-
-/* ======================== ACTION ======================== */
-
-/**
- * Represents an executable action schema.
- * @typedef {Object} ActionSchema
- * @property {string} name - Action name.
- * @property {string} description - Action description.
- * @property {z.ZodObject<Record<string, z.ZodType>>} parameters - Schema for input parameters.
- * @property {(args: any) => Promise<any>} execute - Function to execute the action.
- * @property {Object[]} [examples] - Example usages of the action.
- * @property {Object} [confirmation] - Confirmation requirements.
- * @property {boolean} confirmation.requireConfirmation - Whether confirmation is needed.
- * @property {string} confirmation.message - The confirmation message.
- */
-export type ActionSchema = {
-  name: string;
-  description: string;
-  parameters: z.ZodObject<{ [key: string]: z.ZodType }>;
-  execute: (args: any) => Promise<any>;
-  examples?: {
-    role: string;
-    content: string;
-    parameters?: Record<string, any>;
-  }[];
-  confirmation?: {
-    requireConfirmation: boolean;
-    message: string;
-  };
-};
+}
 
 /* ======================== SCHEDULING ======================== */
 
 /**
- * Represents a scheduled action with optional recurrence.
- * @typedef {Object} ScheduledAction
- * @property {string} id - Unique identifier for the scheduled action.
- * @property {Object} action - The action details.
- * @property {string} action.name - The action name.
- * @property {QueueItemParameter[]} action.parameters - Action parameters.
- * @property {Date} scheduledTime - The scheduled execution time.
- * @property {string} userId - Associated user identifier.
- * @property {"pending" | "completed" | "failed"} status - The execution status.
- * @property {Object} [recurrence] - Recurrence details (optional).
- * @property {"daily" | "weekly" | "monthly"} recurrence.type - Recurrence type.
- * @property {number} recurrence.interval - Recurrence interval.
- */
-export type ScheduledAction = {
-  id: string;
-  action: {
-    name: string;
-    parameters: QueueItemParameter[];
-  };
-  scheduledTime: Date;
-  userId: string;
-  status: "pending" | "completed" | "failed";
-  recurrence?: {
-    type: "daily" | "weekly" | "monthly";
-    interval: number;
-  };
-};
-
-/**
- * Represents a scheduled request.
+ * Type for scheduled request entries
  * @typedef {Object} ScheduledRequest
- * @property {string} id - Unique identifier for the scheduled request.
- * @property {string} originalRequest - The original request string.
- * @property {string} cronExpression - The cron expression for scheduling.
- * @property {boolean} isRecurring - Whether the request is recurring.
- * @property {Date} createdAt - The creation date.
  */
 export type ScheduledRequest = {
+  /** Unique identifier for the scheduled request */
   id: string;
+  /** The original request string */
   originalRequest: string;
+  /** The cron expression for scheduling */
   cronExpression: string;
+  /** Whether the request is recurring */
   isRecurring: boolean;
+  /** The creation date */
   createdAt: Date;
 };
 
 /* ======================== GRAPH ======================== */
 
-export type GraphContext<T extends ZodSchema> = z.infer<T>;
+/**
+ * Utility type for extracting schema type from Zod schema
+ * @template T - Zod schema type
+ */
+export type SchemaType<T> = T extends ZodSchema<infer U> ? U : never;
+
+/**
+ * Type for graph context based on schema
+ * @template T - Schema type
+ */
+export type GraphContext<T> = SchemaType<T>;
 
-export type Node<T extends ZodSchema, P extends ZodSchema = ZodSchema> = {
+/**
+ * Interface representing a node in the graph
+ * @interface
+ * @template T - Schema type
+ * @template I - Input schema type
+ * @template O - Output schema type
+ */
+export interface Node<T extends ZodSchema, I = any> {
+  /** Name of the node */
   name: string;
-  execute?: (context: GraphContext<T>) => Promise<void>;
-  executeWithParams?: (
+  /** Schema for node inputs */
+  inputs?: I extends void ? never : ZodSchema<I>;
+  /** Schema for node outputs */
+  outputs?: ZodSchema;
+  /** Execute function for the node */
+  execute: (
     context: GraphContext<T>,
-    params: z.infer<P>
-  ) => Promise<void>; // ✅ Nouvelle méthode
-  next?: string[];
+    inputs: I extends void ? never : I
+  ) => Promise<void>;
+  /** Optional condition for node execution */
   condition?: (context: GraphContext<T>) => boolean;
-  onError?: (error: Error) => void;
+  /** Array of next node names */
+  next?: string[] | ((context: GraphContext<T>) => string[]);
+  /** Array of event names */
   events?: string[];
-  schema?: T;
-  parameters?: P; // ✅ Ajout d'un schéma spécifique aux paramètres du nœud
+  /** Wait for event */
+  waitForEvent?: boolean;
+  /** Retry configuration */
   retry?: {
+    /** Maximum number of retry attempts */
     maxAttempts: number;
+    /** Delay between retries in milliseconds */
     delay: number;
+    /** Error handler function */
+    onRetryFailed?: (error: Error, context: GraphContext<T>) => Promise<void>;
+    /** Continue execution on failed retry */
+    continueOnFailed?: boolean;
   };
-};
-
-export type GraphConfig<T extends ZodSchema> = {
-  name: string;
-  nodes: Node<T>[];
-  initialContext?: GraphContext<T>;
-  validator?: T;
-  globalErrorHandler?: (error: Error, context: GraphContext<T>) => void;
-};
-
-export type GraphDefinition<T extends ZodSchema> = {
-  name: string;
-  nodes: Record<string, Node<T>>;
-  entryNode: string;
-};
-
-/**
- * Defines a shared state context for execution graphs.
- * @typedef {Object} SharedState
- * @property {Partial<T>} context - The execution context.
- */
-export type SharedState<T> = T;
+  /** Error handler function */
+  onError?: (error: Error) => void;
+}
 
 /**
- * Defines a node relationship in an execution graph.
- * @typedef {Object} NodeRelationship
- * @property {string} name - Relationship name.
- * @property {string} [description] - Optional description.
+ * Interface for graph definition
+ * @interface
+ * @template T - Schema type
  */
-export type NodeRelationship = {
+export interface GraphDefinition<T extends ZodSchema> {
+  /** Name of the graph */
   name: string;
-  description?: string;
-};
-
-/* ======================== SEARCH ======================== */
+  /** Array of nodes in the graph */
+  nodes: Node<T, any>[];
+  /** Initial context */
+  context: SchemaType<T>;
+  /** Schema for validation */
+  schema: T;
+  /** Global error handler */
+  onError?: (error: Error, context: GraphContext<T>) => void;
+  /** Entry node name */
+  entryNode?: string;
+  /** Event emitter instance */
+  eventEmitter?: IEventEmitter | EventEmitter;
+  /** Array of events */
+  events?: string[];
+}
 
-/**
- * Represents a document that can be indexed and searched.
- * @typedef {Object} SearchDocument
- * @property {string} [id] - Optional unique identifier of the document.
- * @property {string} content - The searchable text content.
- * @property {Record<string, any>} [metadata] - Additional metadata for context.
- */
-export type SearchDocument = {
-  id?: string;
-  content: string;
-  metadata?: Record<string, any>;
-};
+/* ======================== MEILISEARCH ======================== */
 
 /**
- * Represents a search result with a similarity score.
- * @typedef {Object} SearchResult
- * @property {SearchDocument} document - The matched document.
- * @property {number} score - The similarity score.
+ * Configuration type for Meilisearch
+ * @typedef {Object} MeilisearchConfig
  */
-export type SearchResult = {
-  document: SearchDocument;
-  score: number;
-};
-
-/* ======================== MEILISEARCH ======================== */
 export type MeilisearchConfig = {
+  /** Meilisearch host URL */
   host: string;
+  /** API key for authentication */
   apiKey: string;
+  /** Array of searchable attributes */
   searchableAttributes?: string[];
+  /** Array of sortable attributes */
   sortableAttributes?: string[];
 };
 
+/**
+ * Settings type for Meilisearch
+ * @typedef {Object} MeilisearchSettings
+ */
 export type MeilisearchSettings = {
+  /** Array of searchable attributes */
   searchableAttributes?: string[];
+  /** Array of sortable attributes */
   sortableAttributes?: string[];
 };
-
-/* ======================== ACTIONS ======================== */
-
-export type Action = {
-  name: string;
-  parameters: {
-    name: string;
-    value: string;
-  }[];
-};

package/utils/{stringifiy-zod-schema.ts → generate-action-schema.ts}

@@ -1,11 +1,11 @@
 import { z } from "zod";
 import { Node } from "../types";
 
-export const stringifyZodSchema = (nodes: Node<any>[]) => {
+export const generateActionSchema = (nodes: Node<any>[]) => {
   return nodes
     .map((node) => {
-      const schemaStr = node.parameters
-        ? getSchemaString(node.parameters)
+      const schemaStr = node.inputs
+        ? getSchemaString(node.inputs)
         : "No parameters";
       return `Workflow: ${node.name}\nParameters: ${schemaStr}`;
     })

package/app/README.md

@@ -1,36 +0,0 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
-
-## Getting Started
-
-First, run the development server:
-
-```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
-# or
-bun dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
-
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
-
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
-
-## Learn More
-
-To learn more about Next.js, take a look at the following resources:
-
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
-
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
-
-## Deploy on Vercel
-
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
-
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/app/app/globals.css

@@ -1,21 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-:root {
-  --background: #ffffff;
-  --foreground: #171717;
-}
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    --background: #0a0a0a;
-    --foreground: #ededed;
-  }
-}
-
-body {
-  color: var(--foreground);
-  background: var(--background);
-  font-family: Arial, Helvetica, sans-serif;
-}

package/app/app/layout.tsx

@@ -1,18 +0,0 @@
-import type { Metadata } from "next";
-import "./globals.css";
-export const metadata: Metadata = {
-  title: "Create Next App",
-  description: "Generated by create next app",
-};
-
-export default function RootLayout({
-  children,
-}: Readonly<{
-  children: React.ReactNode;
-}>) {
-  return (
-    <html lang="en">
-      <body>{children}</body>
-    </html>
-  );
-}