dank-ai 1.0.35 → 1.0.37

package/README.md

@@ -533,22 +533,7 @@ agent
 }
 ```
 
-**Tool HTTP Event Data:**
-```javascript
-{
-  requestId: "unique-request-id",
-  method: "POST",
-  path: "/api/chat",
-  headers: { "content-type": "application/json" },
-  body: { message: "Hello" },
-  query: {},
-  params: {},
-  statusCode: 200,
-  responseData: { response: "Hi there!" },
-  processingTime: 45,
-  timestamp: "2024-01-15T10:30:00.000Z"
-}
-```
+npm 
 
 #### 🎛️ **Communication Method Control**
 

package/lib/agent.js

@@ -6,6 +6,7 @@
  */
 
 const Joi = require('joi');
+const { validate: validateUUID } = require('uuid');
 const { DEFAULT_CONFIG, SUPPORTED_LLMS, DOCKER_CONFIG, INSTANCE_TYPES } = require('./constants');
 const { ToolRegistry, ToolExecutor } = require('./tools');
 const builtinTools = require('./tools/builtin');
@@ -15,7 +16,8 @@ class DankAgent {
     this.name = name;
     this.config = this._validateConfig(config);
     this.handlers = new Map();
-    this.id = this._generateId();
+    // id is required and must be set via setId() - validated in _validateConfig
+    this.id = this.config.id;
     this.status = 'defined'; // defined, building, running, stopped, error
     this.containerId = null;
     this.createdAt = new Date().toISOString();
@@ -51,6 +53,33 @@ class DankAgent {
     return this;
   }
 
+  /**
+   * Set the unique ID for this agent (required, must be UUIDv4)
+   * @param {string} id - UUIDv4 string that must be unique and never used before
+   */
+  setId(id) {
+    if (!id || typeof id !== 'string') {
+      throw new Error('Agent ID must be a non-empty string');
+    }
+    
+    const trimmedId = id.trim();
+    
+    // Validate UUIDv4 format
+    if (!validateUUID(trimmedId)) {
+      throw new Error(`Agent ID must be a valid UUIDv4. Received: ${trimmedId}`);
+    }
+    
+    // Check if it's actually v4 (UUIDv4 has '4' in the version position)
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(trimmedId)) {
+      throw new Error(`Agent ID must be a valid UUIDv4. Received: ${trimmedId}`);
+    }
+    
+    this.config.id = trimmedId;
+    this.id = trimmedId;
+    return this;
+  }
+
   /**
    * Set the system prompt for the agent
    */
@@ -611,7 +640,29 @@ class DankAgent {
    * Validate agent configuration
    */
   _validateConfig(config) {
+    // Validate ID separately (must be UUIDv4)
+    if (!config.id) {
+      throw new Error('Agent ID is required. Use .setId(uuidv4) to set a unique UUIDv4 identifier.');
+    }
+    
+    if (typeof config.id !== 'string') {
+      throw new Error('Agent ID must be a string');
+    }
+    
+    const trimmedId = config.id.trim();
+    if (!validateUUID(trimmedId)) {
+      throw new Error(`Agent ID must be a valid UUIDv4. Received: ${trimmedId}`);
+    }
+    
+    // Check if it's actually v4 (UUIDv4 has '4' in the version position)
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(trimmedId)) {
+      throw new Error(`Agent ID must be a valid UUIDv4. Received: ${trimmedId}`);
+    }
+    
     const schema = Joi.object({
+      id: Joi.string().required(), // Required UUIDv4 - validated above
+      
       llm: Joi.object({
         provider: Joi.string().valid(...SUPPORTED_LLMS).required(),
         apiKey: Joi.string().allow('').default(''),
@@ -686,12 +737,6 @@ class DankAgent {
     return value;
   }
 
-  /**
-   * Generate a unique ID
-   */
-  _generateId() {
-    return `agent_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-  }
 
   /**
    * Serialize handlers for storage (functions can't be serialized)

package/lib/cli/init.js

@@ -93,6 +93,11 @@ async function initCommand(projectName, options) {
     console.log(chalk.gray('  2. Run "npm install" to install dependencies'));
     console.log(chalk.gray('  3. Edit dank.config.js to configure your agents'));
     console.log(chalk.gray('  4. Run "dank run" to start your agents'));
+    console.log(chalk.yellow('\n📝 Note about Agent IDs:'));
+    console.log(chalk.gray('  - Unique UUIDv4 IDs have been generated for each agent'));
+    console.log(chalk.gray('  - These IDs are stored in dank.config.js as AGENT_IDS constants'));
+    console.log(chalk.gray('  - Once agents register with Dank Cloud, these IDs become locked to your account'));
+    console.log(chalk.gray('  - You can generate new UUIDs if needed: require(\'uuid\').v4()'));
     console.log(chalk.gray('\nFor more information, visit: https://github.com/your-org/dank'));
 
     process.exit(0);
@@ -334,6 +339,16 @@ Handle agent lifecycle and errors:
 })
 \`\`\`
 
+## Agent IDs (UUIDv4)
+
+Each agent in your project has a unique UUIDv4 identifier that is automatically generated when you initialize your project. These IDs are stored in \`dank.config.js\` as constants in the \`AGENT_IDS\` object.
+
+**Important Notes:**
+- Agent IDs are generated automatically during project initialization
+- These IDs uniquely identify your agents across deployments
+- Once agents register with Dank Cloud services, these IDs become locked to your account
+- You can generate new UUIDs if needed: \`require('uuid').v4()\`
+
 ## Configuration
 
 Edit \`dank.config.js\` to:
@@ -343,6 +358,7 @@ Edit \`dank.config.js\` to:
 - Configure event handlers
 - Set Docker and resource limits
 - Enable/disable communication features
+- Manage agent IDs (UUIDv4 identifiers)
 
 ## Documentation
 

package/lib/cli/production-build.js

@@ -91,6 +91,7 @@ function extractAgentMetadata(agent, buildOptions, imageName) {
   };
 
   return {
+    id: agent.id, // Agent UUIDv4 identifier from setId()
     name: agent.name,
     imageName: imageName,
     baseImage: {

package/lib/project.js

@@ -6,6 +6,7 @@
 
 const fs = require('fs-extra');
 const path = require('path');
+const { v4: uuidv4 } = require('uuid');
 
 class DankProject {
   constructor(name, options = {}) {
@@ -56,15 +57,33 @@ class DankProject {
     
     const requirePath = isDevelopment ? '../lib/index.js' : 'dank-ai';
     
+    // Generate UUIDv4 IDs for each agent in the template
+    const promptAgentId = uuidv4();
+    
     return `/**
  * Dank Agent Configuration
  * 
  * This file defines your AI agents and their configurations.
  * Run 'dank run' to start all defined agents.
+ * 
+ * IMPORTANT: Agent IDs (UUIDv4)
+ * ==============================
+ * Each agent has a unique UUIDv4 identifier that is generated when you initialize
+ * your project. These IDs are used to identify and track your agents.
+ * 
+ * - You can generate new UUIDv4s if needed (use: require('uuid').v4())
+ * - Once agents register with Dank Cloud services using these IDs, they become
+ *   locked in and owned by your account
  */
 
 const { createAgent } = require('${requirePath}');
 
+// Agent IDs - Generated UUIDv4 identifiers for each agent
+// These IDs are used to uniquely identify your agents across deployments
+const AGENT_IDS = {
+  PROMPT_AGENT: '${promptAgentId}'
+};
+
 module.exports = {
   // Project configuration
   name: '${this.name}',
@@ -74,6 +93,7 @@ module.exports = {
   agents: [
     // Example 1: Direct Prompting Agent with Event Handlers
     createAgent('prompt-agent')
+      .setId(AGENT_IDS.PROMPT_AGENT) // Required: Unique UUIDv4 identifier
       .setLLM('openai', {
         apiKey: process.env.OPENAI_API_KEY,
         model: 'gpt-3.5-turbo',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dank-ai",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "description": "Dank Agent Service - Docker-based AI agent orchestration platform",
   "main": "lib/index.js",
   "exports": {