agent-swarm-kit 1.0.164 → 1.0.166

package/README.md

@@ -4,7 +4,7 @@
 
 Unleash the power of collaborative AI with `agent-swarm-kit`! This library empowers you to create intelligent, modular agent networks that work together seamlessly—perfect for automating workflows, solving complex problems, or designing next-gen AI systems. With a simple API, robust validation, and flexible architecture, it’s your toolkit for building smarter solutions, faster.
 
-📚 **[Full Documentation](https://agent-swarm.github.io/documents/agent-swarm-kit.html)** | 🌟 **[Try It Now](#quick-example)**
+📚 **[Full Documentation](https://agent-swarm.github.io/documents/agent-swarm-kit.html)** | 🌟 **[Try It Now](https://github.com/tripolskypetr/agent-swarm-kit/blob/master/demo/repl-phone-seller/src/logic/agent/sales.agent.ts)**
 
 ![Agent Swarm Schema](https://raw.githubusercontent.com/tripolskypetr/agent-swarm-kit/master/schema.png)
 
@@ -22,6 +22,8 @@ Unleash the power of collaborative AI with `agent-swarm-kit`! This library empow
 
 ## 🚀 Getting Started
 
+**Want a real-world demo?** Check out our **[REPL Phone Seller App](https://github.com/tripolskypetr/agent-swarm-kit/blob/master/demo/repl-phone-seller/src/logic/agent/sales.agent.ts)**—a practical example of a sales agent in action!
+
 ### Installation
 
 Get up and running in seconds:
@@ -201,15 +203,15 @@ complete("I need a refund!").then(console.log);
 - **`addSwarm`**: Group agents into a coordinated network.
 - **`session`**: Start a client session with real-time message handling.
 - **`addTool`**: Create reusable tools with validation and execution logic.
-- **`Storage.take`**: Search and retrieve data using embeddings (e.g., vector search).
+- **`Storage.take`**: Search and retrieve data using embeddings (e.g., vector search, RAG).
 
-Check out the **[API Reference](https://github.com/tripolskypetr/agent-swarm-kit/blob/master/docs/api-reference.md)** for more!
+Check out the **[API Reference](https://agent-swarm.github.io/documents/agent-swarm-kit.html)** for more!
 
 ---
 
 ## 🛠 Advanced Example: Vector Search with Embeddings
 
-Integrate vector search with embeddings for smarter agents:
+Integrate vector search with embeddings (RAG) for smarter agents:
 
 ```typescript
 import { addAgent, addSwarm, addStorage, addEmbedding, session, Storage } from "agent-swarm-kit";
@@ -252,8 +254,8 @@ const TEST_STORAGE = addStorage({
 // Create an agent with storage
 const TEST_AGENT = addAgent({
   agentName: "test_agent",
-  completion: {/* completion config */},
-  prompt: "Search and assist.",
+  completion: TEST_COMPLETION
+  prompt: "...",
   storages: [TEST_STORAGE],
 });
 
@@ -268,9 +270,24 @@ const TEST_SWARM = addSwarm({
 const { complete } = session("client-123", TEST_SWARM);
 complete("I need a refund!").then(console.log);
 
+...
+
+export interface PhoneModel {
+    id: number;
+    title: string;
+    description: string;
+    diagonal: number;
+}
+
 // Use vector search in a tool call
-Storage.take("reduce pain, fever", 1, "client-xyz", TEST_AGENT, TEST_STORAGE)
-  .then(result => console.log("Found:", result));
+Storage.take<PhoneModel>({
+  search: "8 inch phone",
+  agentName: AgentName.TestAgent,
+  clientId,
+  storageName: StorageName.PhoneStorage,
+  total: 1,
+  score: 0.68,
+}).then((phones) => console.log(phones));
 ```
 
 ## ❓ Orchestration Principles

package/build/index.cjs

@@ -10528,7 +10528,7 @@ class DocService {
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
                 });
-            if (!(await functoolsKit.not(exists(dirName)))) {
+            if (await functoolsKit.not(exists(dirName))) {
                 await fs.mkdir(dirName, { recursive: true });
             }
             await writeFileAtomic(path.join(dirName, `${clientId}.${getMomentStamp.getMomentStamp()}.json`), JSON.stringify(await this.perfService.toClientRecord(clientId)));

package/build/index.mjs

@@ -10526,7 +10526,7 @@ class DocService {
                 this.loggerService.info("docService dumpPerfomance", {
                     dirName,
                 });
-            if (!(await not(exists(dirName)))) {
+            if (await not(exists(dirName))) {
                 await mkdir(dirName, { recursive: true });
             }
             await writeFileAtomic(join(dirName, `${clientId}.${getMomentStamp()}.json`), JSON.stringify(await this.perfService.toClientRecord(clientId)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-swarm-kit",
-  "version": "1.0.164",
+  "version": "1.0.166",
   "description": "A TypeScript library for building orchestrated framework-agnostic multi-agent AI systems",
   "author": {
     "name": "Petr Tripolsky",