dank-ai 1.0.46 → 1.0.49

package/README.md

@@ -70,6 +70,7 @@ dank logs assistant --follow
 ```
 my-project/
 ├── dank.config.js         # Agent configuration
+├── .dankignore           # Build ignore patterns (optional)
 ├── agents/                # Custom agent code (optional)
 │   └── example-agent.js
 └── .dank/                 # Generated files
@@ -243,7 +244,7 @@ agent
 
 #### Passing Custom Data to Handlers
 
-You can pass any custom data in the request body to the `/prompt` endpoint, and it will be available in your handlers via `data.metadata`. This enables powerful use cases like user authentication, conversation tracking, RAG (Retrieval-Augmented Generation), and custom lookups.
+You can pass any custom data in the request body to the `/prompt` endpoint, and it will be available in your handlers via `data.params`. This enables powerful use cases like user authentication, conversation tracking, RAG (Retrieval-Augmented Generation), and custom lookups.
 
 **Client Request:**
 ```javascript
@@ -264,9 +265,9 @@ You can pass any custom data in the request body to the `/prompt` endpoint, and
 ```javascript
 agent
   .addHandler('request_output:start', async (data) => {
-    // Access custom data via data.metadata
-    const userId = data.metadata.userId;
-    const conversationId = data.metadata.conversationId;
+    // Access custom data via data.params
+    const userId = data.params.userId;
+    const conversationId = data.params.conversationId;
     
     // Perform authentication
     const user = await authenticateUser(userId);
@@ -287,16 +288,16 @@ agent
   .addHandler('request_output', async (data) => {
     // Log with user context
     await logInteraction({
-      userId: data.metadata.userId,
-      conversationId: data.metadata.conversationId,
+      userId: data.params.userId,
+      conversationId: data.params.conversationId,
       prompt: data.prompt,
       response: data.response,
       timestamp: data.timestamp
     });
     
     // Update user preferences based on interaction
-    if (data.metadata.userPreferences) {
-      await updateUserPreferences(data.metadata.userId, data.metadata.userPreferences);
+    if (data.params.userPreferences) {
+      await updateUserPreferences(data.params.userId, data.params.userPreferences);
     }
   });
 ```
@@ -495,6 +496,68 @@ Dank uses a layered Docker approach:
 2. **Agent Images**: Extend base image with agent-specific code
 3. **Containers**: Running instances with resource limits and networking
 
+### Build File Management (.dankignore)
+
+Dank automatically copies files from your project directory into Docker containers during the build process. Use `.dankignore` to control which files are included.
+
+**Default Behavior:**
+- If `.dankignore` doesn't exist: **All files** are copied to the container
+- If `.dankignore` exists: Only files **not matching** the patterns are copied
+
+**Creating `.dankignore`:**
+```bash
+# Created automatically during dank init
+dank init my-project
+
+# Or create manually
+touch .dankignore
+```
+
+**Example `.dankignore`:**
+```
+# Security - Environment variables (IMPORTANT: Never commit .env files!)
+.env
+.env.*
+*.key
+*.pem
+secrets/
+
+# Dependencies (installed fresh in container)
+node_modules/
+
+# Version control
+.git/
+
+# Build artifacts
+dist/
+build/
+coverage/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+
+# Logs
+*.log
+logs/
+```
+
+**Pattern Matching:**
+- `node_modules` - Exact match
+- `*.log` - Wildcard (matches any `.log` file)
+- `dist/` - Directory pattern (matches `dist` directory and contents)
+- `.env.*` - Pattern matching (matches `.env.local`, `.env.production`, etc.)
+
+**Best Practices:**
+- ✅ Always exclude `.env` files (security)
+- ✅ Exclude `node_modules/` (dependencies installed in container)
+- ✅ Exclude build artifacts (`dist/`, `build/`)
+- ✅ Include source files, assets, and configuration needed at runtime
+
 ### Container Features
 - **Isolated Environments**: Each agent runs in its own container
 - **Resource Limits**: Memory and CPU constraints per agent
@@ -780,7 +843,7 @@ docker logs container-id
 - **Authentication**: `docker login ghcr.io`
 - **Push Permissions**: Check namespace permissions
 - **Image Exists**: Use different tag or `--force`
-- **Build Context**: Add `.dockerignore` file
+- **Build Context**: Add `.dankignore` file to control which files are copied
 </details>
 
 ## 📦 Package Exports

package/docker/entrypoint.js

@@ -1218,12 +1218,12 @@ class AgentRuntime {
           });
         }
 
-        // Build metadata object with all user-provided fields from request body (except prompt)
-        const metadata = {
+        // Build params object with all user-provided fields from request body (except prompt)
+        const params = {
           ...requestBodyFields,
         };
 
-        const response = await this.processDirectPrompt(prompt, metadata, {
+        const response = await this.processDirectPrompt(prompt, params, {
           protocol: "http",
           clientIp: req.ip,
         });
@@ -1251,7 +1251,7 @@ class AgentRuntime {
   /**
    * Process a direct prompt and emit events
    */
-  async processDirectPrompt(prompt, metadata = {}, systemFields = {}) {
+  async processDirectPrompt(prompt, params = {}, systemFields = {}) {
     const startTime = Date.now();
     let finalPrompt = prompt; // Declare outside try block so it's available in catch
 
@@ -1259,7 +1259,7 @@ class AgentRuntime {
       // Emit request start event and allow handlers to modify the prompt
       const startEventData = {
         prompt,
-        metadata,
+        params,
         ...systemFields, // protocol, clientIp, etc.
         timestamp: new Date().toISOString(),
       };
@@ -1302,7 +1302,7 @@ class AgentRuntime {
         prompt,
         finalPrompt, // Include the final prompt that was sent to LLM
         response: response.content,
-        metadata,
+        params,
         ...systemFields, // protocol, clientIp, etc.
         usage: response.usage,
         model: response.model,
@@ -1316,7 +1316,7 @@ class AgentRuntime {
         prompt,
         finalPrompt,
         response: response.content,
-        metadata,
+        params,
         ...systemFields, // protocol, clientIp, etc.
         usage: response.usage,
         model: response.model,
@@ -1347,7 +1347,7 @@ class AgentRuntime {
       await this.emitEvent("request_output:error", {
         prompt,
         finalPrompt,
-        metadata,
+        params,
         ...systemFields, // protocol, clientIp, etc.
         error: error.message,
         processingTime,

package/lib/cli/init.js

@@ -84,6 +84,9 @@ async function initCommand(projectName, options) {
     // Create .gitignore
     await createGitignore(project.projectPath);
 
+    // Create .dankignore
+    await createDankIgnore(project.projectPath);
+
     // Create README.md
     await createReadme(name, project.projectPath);
 
@@ -260,6 +263,65 @@ jspm_packages/
   console.log(chalk.green(`Created .gitignore: ${gitignorePath}`));
 }
 
+/**
+ * Create .dankignore file
+ */
+async function createDankIgnore(projectPath) {
+  const dankIgnore = `# Dank Build Ignore Patterns
+# Files and directories to exclude from Docker builds
+# This file is optional - if it doesn't exist, all files will be copied
+
+# Security - Environment variables (IMPORTANT: Never commit .env files!)
+.env
+.env.*
+*.key
+*.pem
+secrets/
+
+# Dependencies (installed fresh in container)
+node_modules/
+
+# Version control
+.git/
+
+# Build artifacts
+dist/
+build/
+coverage/
+.nyc_output/
+
+# OS files
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# IDE files
+.vscode/
+.idea/
+*.sublime-*
+*.code-workspace
+
+# Logs
+*.log
+logs/
+
+# Dank framework
+.dank/
+.build-context-*
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+`;
+
+  const dankIgnorePath = path.join(projectPath, '.dankignore');
+  await fs.writeFile(dankIgnorePath, dankIgnore, 'utf8');
+  console.log(chalk.green(`Created .dankignore: ${dankIgnorePath}`));
+}
+
 /**
  * Create README.md for the project
  */

package/lib/docker/manager.js

@@ -1759,6 +1759,141 @@ class DockerManager {
    * @param {object} options - Additional options
    * @param {string} options.projectRoot - Root directory for package.json (defaults to process.cwd())
    */
+  /**
+   * Read .dankignore file if it exists
+   * @param {string} projectDir - Project directory
+   * @returns {string[]} Array of ignore patterns
+   */
+  async readDankIgnore(projectDir) {
+    const dankIgnorePath = path.join(projectDir, '.dankignore');
+    
+    if (!(await fs.pathExists(dankIgnorePath))) {
+      // No .dankignore = copy everything
+      return [];
+    }
+    
+    try {
+      const content = await fs.readFile(dankIgnorePath, 'utf8');
+      return content
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => {
+          // Remove comments and empty lines
+          return line && !line.startsWith('#');
+        });
+    } catch (error) {
+      this.logger.warn(`⚠️  Failed to read .dankignore: ${error.message}`);
+      return [];
+    }
+  }
+
+  /**
+   * Check if a file path should be ignored based on .dankignore patterns
+   * @param {string} filePath - Full path to the file
+   * @param {string} projectDir - Project root directory
+   * @param {string[]} ignorePatterns - Patterns from .dankignore
+   * @returns {boolean} True if file should be ignored
+   */
+  shouldIgnoreFile(filePath, projectDir, ignorePatterns) {
+    if (ignorePatterns.length === 0) {
+      return false; // No patterns = don't ignore anything
+    }
+
+    // Get relative path from project directory
+    const relativePath = path.relative(projectDir, filePath);
+    const normalizedPath = relativePath.replace(/\\/g, '/'); // Normalize to forward slashes
+    
+    // Also check just the filename for patterns like "*.log"
+    const fileName = path.basename(filePath);
+    
+    for (const pattern of ignorePatterns) {
+      // Skip package.json and package-lock.json as they're handled separately
+      if (pattern === 'package.json' || pattern === 'package-lock.json') {
+        continue;
+      }
+      
+      // Convert pattern to regex
+      // Support:
+      // - Exact matches: "node_modules"
+      // - Wildcards: "*.log", ".env.*"
+      // - Directory patterns: "dist/", "node_modules/"
+      // - Path patterns: "secrets/*.key"
+      
+      // Use a placeholder for * to avoid escaping issues
+      const placeholder = '__WILDCARD_PLACEHOLDER__';
+      let regexPattern = pattern.replace(/\*/g, placeholder);
+      
+      // Escape special regex characters (except our placeholder)
+      regexPattern = regexPattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+      
+      // Replace placeholder with .* for wildcard matching
+      regexPattern = regexPattern.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), '.*');
+      
+      // If pattern ends with /, it's a directory pattern
+      const isDirectoryPattern = pattern.endsWith('/');
+      
+      // For directory patterns, match anywhere in path
+      // For file patterns, match full path or filename
+      if (isDirectoryPattern) {
+        // Remove trailing / from pattern for matching
+        const dirPattern = regexPattern.replace(/\/$/, '');
+        // Match if path contains this directory (at any level)
+        const dirRegex = new RegExp(`(^|/)${dirPattern}(/|$)`);
+        if (dirRegex.test(normalizedPath)) {
+          return true;
+        }
+      } else {
+        // File pattern - check full path and filename
+        const fileRegex = new RegExp(`^${regexPattern}$`);
+        if (fileRegex.test(normalizedPath) || fileRegex.test(fileName)) {
+          return true;
+        }
+        
+        // Also check if pattern matches any path segment
+        const pathSegments = normalizedPath.split('/');
+        for (const segment of pathSegments) {
+          if (fileRegex.test(segment)) {
+            return true;
+          }
+        }
+      }
+    }
+    
+    return false;
+  }
+
+  /**
+   * Recursively copy files respecting .dankignore patterns
+   * @param {string} sourceDir - Source directory
+   * @param {string} destDir - Destination directory
+   * @param {string} projectDir - Project root (for relative path calculation)
+   * @param {string[]} ignorePatterns - Patterns from .dankignore
+   */
+  async copyFilesRecursive(sourceDir, destDir, projectDir, ignorePatterns) {
+    const items = await fs.readdir(sourceDir);
+    
+    for (const item of items) {
+      const sourcePath = path.join(sourceDir, item);
+      const destPath = path.join(destDir, item);
+      
+      // Check if this file/directory should be ignored
+      if (this.shouldIgnoreFile(sourcePath, projectDir, ignorePatterns)) {
+        continue;
+      }
+      
+      const stat = await fs.stat(sourcePath);
+      
+      if (stat.isDirectory()) {
+        // Recursively copy directory
+        await fs.ensureDir(destPath);
+        await this.copyFilesRecursive(sourcePath, destPath, projectDir, ignorePatterns);
+      } else if (stat.isFile()) {
+        // Copy file
+        await fs.copy(sourcePath, destPath);
+      }
+    }
+  }
+
   async copyProjectFiles(projectDir, contextDir, options = {}) {
     const agentCodeDir = path.join(contextDir, "agent-code");
     await fs.ensureDir(agentCodeDir);
@@ -1783,53 +1918,22 @@ class DockerManager {
       this.logger.warn(`⚠️ Failed to copy package files: ${error.message}`);
     }
     
-    // Patterns to exclude when copying project files
-    const ignorePatterns = [
-      'node_modules',
-      '.git',
-      '.build-context-*',
-      '.env',
-      '.env.*',
-      '*.log',
-      '.DS_Store',
-      'dist',
-      'build',
-      '.dank',
-      'coverage',
-      '.nyc_output',
-      'package.json',      // Already copied from project root
-      'package-lock.json'  // Already copied from project root
-    ];
+    // Read .dankignore patterns from project root (optional - if file doesn't exist, copy everything)
+    // Check both projectRoot and projectDir for .dankignore
+    let ignorePatterns = await this.readDankIgnore(projectRoot);
+    if (ignorePatterns.length === 0 && projectDir !== projectRoot) {
+      ignorePatterns = await this.readDankIgnore(projectDir);
+    }
+    
+    if (ignorePatterns.length > 0) {
+      this.logger.info(`📋 Using .dankignore with ${ignorePatterns.length} pattern(s)`);
+    } else {
+      this.logger.info(`📋 No .dankignore found - copying all files from ${projectDir}`);
+    }
     
     try {
-      // Copy all files from project directory, filtering out ignored patterns
-      const items = await fs.readdir(projectDir);
-      
-      for (const item of items) {
-        const sourcePath = path.join(projectDir, item);
-        const destPath = path.join(agentCodeDir, item);
-        const stat = await fs.stat(sourcePath);
-        
-        // Skip if matches ignore pattern
-        const shouldIgnore = ignorePatterns.some(pattern => {
-          if (pattern.includes('*')) {
-            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
-            return regex.test(item);
-          }
-          return item === pattern;
-        });
-        
-        if (shouldIgnore) {
-          continue;
-        }
-        
-        // Copy file or directory
-        if (stat.isDirectory()) {
-          await fs.copy(sourcePath, destPath);
-        } else if (stat.isFile()) {
-          await fs.copy(sourcePath, destPath);
-        }
-      }
+      // Copy files recursively, respecting .dankignore patterns
+      await this.copyFilesRecursive(projectDir, agentCodeDir, projectDir, ignorePatterns);
       
       this.logger.info(`📁 Copied project files from ${projectDir} to build context`);
     } catch (error) {

package/package.json

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