@ai.ntellect/core 0.8.0 → 0.8.1

package/README.md

@@ -5,10 +5,15 @@
 ## Features
 
 - **GraphFlow** – Graph-based execution engine for automating business processes
+- **AI Agents** – Built-in support for LLM-powered agents with memory and tools
 - **Event-Driven** – Nodes can react to real-time events and trigger actions dynamically
 - **Modular** – Plug-and-play modules and adapters for memory, scheduling, and external APIs
 - **Extensible** – Custom nodes, adapters, and interactions with third-party services
 - **Observable** – Complete state and event monitoring
+- **Type-Safe** – Built with TypeScript for robust type checking
+- **Schema Validation** – Integrated Zod schema validation
+- **Retry Mechanisms** – Built-in retry strategies for resilient workflows
+- **Event Correlation** – Advanced event handling with correlation strategies
 
 ## Installation
 
@@ -31,70 +36,125 @@ npm -v
 npm install @ai.ntellect/core zod
 ```
 
-## Example
+## Quick Start
+
+### 1. Basic Workflow
 
 ```typescript
 import { GraphFlow } from "@ai.ntellect/core";
 import { z } from "zod";
 
-// Definition of the context schema
-const ContextSchema = z.object({
-  message: z.string(),
+// Define schema
+const EmailSchema = z.object({
+  to: z.string(),
+  subject: z.string(),
+  content: z.string(),
+  status: z.string().default("pending"),
 });
 
-type ContextSchema = typeof ContextSchema;
-
-// Definition of the graph
-const myGraph = new GraphFlow<ContextSchema>("TestGraph", {
-  name: "TestGraph",
-  context: { message: "Installation success" },
-  schema: ContextSchema,
+// Create workflow
+const emailFlow = new GraphFlow("email", {
+  name: "email",
+  schema: EmailSchema,
+  context: {
+    to: "",
+    subject: "",
+    content: "",
+    status: "pending",
+  },
   nodes: [
     {
-      name: "printMessage",
+      name: "send",
       execute: async (context) => {
-        console.log(context.message);
+        console.log(`Sending email to ${context.to}`);
+        // Logic to send email
+        context.status = "sent";
       },
-      next: [],
     },
   ],
 });
+```
+
+### 2. AI-Powered Assistant
+
+```typescript
+import { Agent } from "@ai.ntellect/core";
+
+const assistant = new Agent({
+  role: "Email Assistant",
+  goal: "Help users send emails efficiently",
+  backstory: "I am an AI assistant specialized in email communications",
+  tools: [emailFlow],
+  llmConfig: {
+    provider: "openai",
+    model: "gpt-4",
+    apiKey: "YOUR_API_KEY",
+  },
+});
 
-// Execution of the graph
-(async () => {
-  await myGraph.execute("printMessage");
-})();
+// Use the assistant
+const result = await assistant.process(
+  "Send an email to john@example.com about tomorrow's meeting"
+);
 ```
 
-## Features
+## Advanced Features
 
-### Event handling
+### Event Handling
 
 ```typescript
-// Event-driven node
-{
-  name: "waitForEvent",
-  events: ["dataReceived"],
-  execute: async (context, event) => {
-    context.data = event.payload;
-  }
-}
+const workflow = new GraphFlow("notification", {
+  nodes: [
+    {
+      name: "waitForEvent",
+      events: ["emailSent"],
+      execute: async (context, event) => {
+        console.log(`Email sent to ${event.payload.recipient}`);
+      },
+    },
+  ],
+});
 
 // Emit events
-graph.emit("dataReceived", { value: 42 });
+workflow.emit("emailSent", { recipient: "john@example.com" });
 ```
 
-### State observation
+### Retry Mechanisms
 
 ```typescript
-// Observe specific node
-graph.observe().node("myNode").subscribe(console.log);
+const node = {
+  name: "sendEmail",
+  execute: async (context) => {
+    // Email sending logic
+  },
+  retry: {
+    maxAttempts: 3,
+    delay: 1000,
+    onRetryFailed: async (error, context) => {
+      console.error(`Failed to send email to ${context.to}`);
+    },
+  },
+};
+```
 
-// Observe specific properties
-graph.observe().property("counter").subscribe(console.log);
+### State Observation
 
-// Observe events
-graph.observe().event("nodeCompleted").subscribe(console.log);
+```typescript
+// Observe specific properties
+workflow
+  .observe()
+  .property("status")
+  .subscribe((status) => {
+    console.log(`Email status changed to: ${status}`);
+  });
+
+// Observe specific nodes
+workflow
+  .observe()
+  .node("sendEmail")
+  .subscribe((state) => {
+    console.log(`Send email node state:`, state);
+  });
 ```
 
 ## Documentation
@@ -103,14 +163,14 @@ For complete documentation, visit our [GitBook](https://ai-ntellect.gitbook.io/c
 
 ## Contributing
 
-Contributions are welcome! To suggest an improvement or report an issue:
+We welcome contributions! To get started:
+
+1. Fork the repository
+2. Create a feature branch
+3. Submit a pull request
 
-- Join our [Discord community](https://discord.gg/kEc5gWXJ)
-- Explore the [GitBook documentation](https://ai-ntellect.gitbook.io/core)
-- Open an issue on GitHub
+Join our [Discord community](https://discord.gg/kEc5gWXJ) for discussions and support.
 
-## Useful links
+## License
 
-- Documentation: [GitBook](https://ai-ntellect.gitbook.io/core)
-- Community: [Discord](https://discord.gg/kEc5gWXJ)
-- GitHub Repository: [@ai.ntellect/core](https://github.com/ai-ntellect/core)
+MIT

package/dist/index.d.ts

@@ -11,6 +11,7 @@
  * - Utility functions for action schema generation and header building
  */
 export * from "./modules/agent/agent";
+export * from "./modules/agent/prompt-builder";
 export * from "./graph/controller";
 export * from "./graph/event-manager";
 export * from "./graph/index";
@@ -20,6 +21,7 @@ export * from "./graph/visualizer";
 export * from "./interfaces";
 export * from "./modules/agenda";
 export * from "./modules/embedding";
+export * from "./modules/memory";
 export * from "./types";
 export * from "./utils/generate-action-schema";
 export * from "./utils/header-builder";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,SAAS,CAAC;AAExB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAE/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,SAAS,CAAC;AAExB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -27,6 +27,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./modules/agent/agent"), exports);
+__exportStar(require("./modules/agent/prompt-builder"), exports);
 __exportStar(require("./graph/controller"), exports);
 __exportStar(require("./graph/event-manager"), exports);
 __exportStar(require("./graph/index"), exports);
@@ -36,6 +37,7 @@ __exportStar(require("./graph/visualizer"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./modules/agenda"), exports);
 __exportStar(require("./modules/embedding"), exports);
+__exportStar(require("./modules/memory"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils/generate-action-schema"), exports);
 __exportStar(require("./utils/header-builder"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;AAEH,wDAAsC;AAEtC,qDAAmC;AACnC,wDAAsC;AACtC,gDAA8B;AAC9B,+CAA6B;AAC7B,mDAAiC;AACjC,qDAAmC;AAEnC,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AAEpC,0CAAwB;AAExB,iEAA+C;AAC/C,yDAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;AAEH,wDAAsC;AACtC,iEAA+C;AAE/C,qDAAmC;AACnC,wDAAsC;AACtC,gDAA8B;AAC9B,+CAA6B;AAC7B,mDAAiC;AACjC,qDAAmC;AAEnC,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AACpC,mDAAiC;AAEjC,0CAAwB;AAExB,iEAA+C;AAC/C,yDAAuC"}

package/index.ts

@@ -12,6 +12,7 @@
  */
 
 export * from "./modules/agent/agent";
+export * from "./modules/agent/prompt-builder";
 
 export * from "./graph/controller";
 export * from "./graph/event-manager";
@@ -23,6 +24,7 @@ export * from "./graph/visualizer";
 export * from "./interfaces";
 export * from "./modules/agenda";
 export * from "./modules/embedding";
+export * from "./modules/memory";
 
 export * from "./types";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai.ntellect/core",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "",
   "main": "dist/index.js",
   "scripts": {