agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/mcp/middleware/rate-limiter.d.ts

@@ -1,97 +0,0 @@
-/**
- * Rate Limiter Middleware for MCP Tools
- *
- * Implements token bucket algorithm to prevent DoS attacks on MCP endpoints.
- * Default: 100 requests per minute per client (identified by auth.userId or IP)
- *
- * Security Fix: Addresses HIGH-003 (Rate Limiting & DoS - INSUFFICIENT)
- */
-interface RateLimitConfig {
-    /**
-     * Maximum number of requests allowed in the time window
-     * @default 100
-     */
-    maxRequests: number;
-    /**
-     * Time window in milliseconds
-     * @default 60000 (1 minute)
-     */
-    windowMs: number;
-    /**
-     * Whether to block or just warn on rate limit exceeded
-     * @default true
-     */
-    blockOnExceed: boolean;
-    /**
-     * Custom message when rate limit is exceeded
-     * @default "Rate limit exceeded. Please try again later."
-     */
-    message?: string;
-}
-export declare class RateLimiter {
-    private config;
-    private buckets;
-    private readonly refillRate;
-    constructor(config?: Partial<RateLimitConfig>);
-    /**
-     * Check if a request should be allowed
-     * @param clientId Unique identifier for the client (userId or IP)
-     * @returns Object with allowed status and remaining tokens
-     */
-    checkLimit(clientId: string): {
-        allowed: boolean;
-        remaining: number;
-        resetAt: number;
-    };
-    /**
-     * Middleware function for MCP tool execution
-     * @param clientId Unique identifier for the client
-     * @param toolName Name of the tool being executed
-     * @returns Promise that resolves if allowed, rejects if rate limited
-     */
-    middleware(clientId: string, toolName: string): Promise<{
-        remaining: number;
-        resetAt: number;
-    }>;
-    /**
-     * Get current rate limit status for a client
-     * @param clientId Unique identifier for the client
-     * @returns Current bucket state
-     */
-    getStatus(clientId: string): {
-        tokens: number;
-        maxTokens: number;
-        resetAt: number;
-    };
-    /**
-     * Reset rate limit for a specific client
-     * @param clientId Unique identifier for the client
-     */
-    reset(clientId: string): void;
-    /**
-     * Reset all rate limits (admin function)
-     */
-    resetAll(): void;
-    /**
-     * Cleanup old buckets that haven't been used in 10 minutes
-     */
-    private cleanup;
-    /**
-     * Get statistics about rate limiter usage
-     */
-    getStats(): {
-        activeClients: number;
-        totalBuckets: number;
-        config: Required<RateLimitConfig>;
-    };
-}
-export declare const defaultRateLimiter: RateLimiter;
-export declare const criticalRateLimiter: RateLimiter;
-/**
- * Helper to get client ID from auth context or IP
- */
-export declare function getClientId(auth?: {
-    userId?: string;
-}, ip?: string): string;
-export {};
-//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/mcp/middleware/rate-limiter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/mcp/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,UAAU,eAAe;IACvB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAe7C;;;;OAIG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAsC7F;;;;;OAKG;IACU,UAAU,CACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAmBlD;;;;OAIG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAwB1F;;;OAGG;IACI,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAIvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACI,QAAQ,IAAI;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;KACnC;CAOF;AAGD,eAAO,MAAM,kBAAkB,aAK7B,CAAC;AAGH,eAAO,MAAM,mBAAmB,aAK9B,CAAC;AAEH;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/mcp/middleware/rate-limiter.js

@@ -1,166 +0,0 @@
-/**
- * Rate Limiter Middleware for MCP Tools
- *
- * Implements token bucket algorithm to prevent DoS attacks on MCP endpoints.
- * Default: 100 requests per minute per client (identified by auth.userId or IP)
- *
- * Security Fix: Addresses HIGH-003 (Rate Limiting & DoS - INSUFFICIENT)
- */
-export class RateLimiter {
-    config;
-    buckets;
-    refillRate; // tokens per ms
-    constructor(config) {
-        this.config = {
-            maxRequests: config?.maxRequests ?? 100,
-            windowMs: config?.windowMs ?? 60000,
-            blockOnExceed: config?.blockOnExceed ?? true,
-            message: config?.message ?? 'Rate limit exceeded. Please try again later.'
-        };
-        this.buckets = new Map();
-        this.refillRate = this.config.maxRequests / this.config.windowMs;
-        // Cleanup old buckets every 5 minutes
-        setInterval(() => this.cleanup(), 5 * 60 * 1000);
-    }
-    /**
-     * Check if a request should be allowed
-     * @param clientId Unique identifier for the client (userId or IP)
-     * @returns Object with allowed status and remaining tokens
-     */
-    checkLimit(clientId) {
-        const now = Date.now();
-        let bucket = this.buckets.get(clientId);
-        if (!bucket) {
-            // New client - create bucket with full capacity
-            bucket = {
-                tokens: this.config.maxRequests,
-                lastRefill: now
-            };
-            this.buckets.set(clientId, bucket);
-        }
-        // Refill tokens based on time elapsed
-        const elapsed = now - bucket.lastRefill;
-        const tokensToAdd = elapsed * this.refillRate;
-        bucket.tokens = Math.min(this.config.maxRequests, bucket.tokens + tokensToAdd);
-        bucket.lastRefill = now;
-        // Check if request can proceed
-        if (bucket.tokens >= 1) {
-            bucket.tokens -= 1;
-            return {
-                allowed: true,
-                remaining: Math.floor(bucket.tokens),
-                resetAt: now + ((this.config.maxRequests - bucket.tokens) / this.refillRate)
-            };
-        }
-        // Rate limit exceeded
-        const resetAt = now + ((1 - bucket.tokens) / this.refillRate);
-        return {
-            allowed: false,
-            remaining: 0,
-            resetAt: Math.ceil(resetAt)
-        };
-    }
-    /**
-     * Middleware function for MCP tool execution
-     * @param clientId Unique identifier for the client
-     * @param toolName Name of the tool being executed
-     * @returns Promise that resolves if allowed, rejects if rate limited
-     */
-    async middleware(clientId, toolName) {
-        const result = this.checkLimit(clientId);
-        if (!result.allowed && this.config.blockOnExceed) {
-            const error = new Error(this.config.message);
-            error.code = 'RATE_LIMIT_EXCEEDED';
-            error.remaining = result.remaining;
-            error.resetAt = result.resetAt;
-            error.toolName = toolName;
-            error.clientId = clientId;
-            throw error;
-        }
-        return {
-            remaining: result.remaining,
-            resetAt: result.resetAt
-        };
-    }
-    /**
-     * Get current rate limit status for a client
-     * @param clientId Unique identifier for the client
-     * @returns Current bucket state
-     */
-    getStatus(clientId) {
-        const now = Date.now();
-        const bucket = this.buckets.get(clientId);
-        if (!bucket) {
-            return {
-                tokens: this.config.maxRequests,
-                maxTokens: this.config.maxRequests,
-                resetAt: now
-            };
-        }
-        // Calculate current tokens with refill
-        const elapsed = now - bucket.lastRefill;
-        const tokensToAdd = elapsed * this.refillRate;
-        const currentTokens = Math.min(this.config.maxRequests, bucket.tokens + tokensToAdd);
-        return {
-            tokens: Math.floor(currentTokens),
-            maxTokens: this.config.maxRequests,
-            resetAt: now + ((this.config.maxRequests - currentTokens) / this.refillRate)
-        };
-    }
-    /**
-     * Reset rate limit for a specific client
-     * @param clientId Unique identifier for the client
-     */
-    reset(clientId) {
-        this.buckets.delete(clientId);
-    }
-    /**
-     * Reset all rate limits (admin function)
-     */
-    resetAll() {
-        this.buckets.clear();
-    }
-    /**
-     * Cleanup old buckets that haven't been used in 10 minutes
-     */
-    cleanup() {
-        const now = Date.now();
-        const maxAge = 10 * 60 * 1000; // 10 minutes
-        for (const [clientId, bucket] of this.buckets.entries()) {
-            if (now - bucket.lastRefill > maxAge) {
-                this.buckets.delete(clientId);
-            }
-        }
-    }
-    /**
-     * Get statistics about rate limiter usage
-     */
-    getStats() {
-        return {
-            activeClients: this.buckets.size,
-            totalBuckets: this.buckets.size,
-            config: this.config
-        };
-    }
-}
-// Export singleton instance with default config
-export const defaultRateLimiter = new RateLimiter({
-    maxRequests: 100,
-    windowMs: 60000,
-    blockOnExceed: true,
-    message: 'Rate limit exceeded. Please try again later.'
-});
-// Export per-tool rate limiters for critical operations
-export const criticalRateLimiter = new RateLimiter({
-    maxRequests: 10,
-    windowMs: 60000,
-    blockOnExceed: true,
-    message: 'Rate limit exceeded for critical operation. Please try again later.'
-});
-/**
- * Helper to get client ID from auth context or IP
- */
-export function getClientId(auth, ip) {
-    return auth?.userId ?? ip ?? 'anonymous';
-}
-//# sourceMappingURL=rate-limiter.js.map

package/dist/mcp/middleware/rate-limiter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../../src/mcp/middleware/rate-limiter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Rate Limiter Middleware for MCP Tools\n *\n * Implements token bucket algorithm to prevent DoS attacks on MCP endpoints.\n * Default: 100 requests per minute per client (identified by auth.userId or IP)\n *\n * Security Fix: Addresses HIGH-003 (Rate Limiting & DoS - INSUFFICIENT)\n */\n\ninterface RateLimitConfig {\n  /**\n   * Maximum number of requests allowed in the time window\n   * @default 100\n   */\n  maxRequests: number;\n\n  /**\n   * Time window in milliseconds\n   * @default 60000 (1 minute)\n   */\n  windowMs: number;\n\n  /**\n   * Whether to block or just warn on rate limit exceeded\n   * @default true\n   */\n  blockOnExceed: boolean;\n\n  /**\n   * Custom message when rate limit is exceeded\n   * @default \"Rate limit exceeded. Please try again later.\"\n   */\n  message?: string;\n}\n\ninterface ClientBucket {\n  tokens: number;\n  lastRefill: number;\n}\n\nexport class RateLimiter {\n  private config: Required<RateLimitConfig>;\n  private buckets: Map<string, ClientBucket>;\n  private readonly refillRate: number; // tokens per ms\n\n  constructor(config?: Partial<RateLimitConfig>) {\n    this.config = {\n      maxRequests: config?.maxRequests ?? 100,\n      windowMs: config?.windowMs ?? 60000,\n      blockOnExceed: config?.blockOnExceed ?? true,\n      message: config?.message ?? 'Rate limit exceeded. Please try again later.'\n    };\n\n    this.buckets = new Map();\n    this.refillRate = this.config.maxRequests / this.config.windowMs;\n\n    // Cleanup old buckets every 5 minutes\n    setInterval(() => this.cleanup(), 5 * 60 * 1000);\n  }\n\n  /**\n   * Check if a request should be allowed\n   * @param clientId Unique identifier for the client (userId or IP)\n   * @returns Object with allowed status and remaining tokens\n   */\n  public checkLimit(clientId: string): { allowed: boolean; remaining: number; resetAt: number } {\n    const now = Date.now();\n    let bucket = this.buckets.get(clientId);\n\n    if (!bucket) {\n      // New client - create bucket with full capacity\n      bucket = {\n        tokens: this.config.maxRequests,\n        lastRefill: now\n      };\n      this.buckets.set(clientId, bucket);\n    }\n\n    // Refill tokens based on time elapsed\n    const elapsed = now - bucket.lastRefill;\n    const tokensToAdd = elapsed * this.refillRate;\n    bucket.tokens = Math.min(this.config.maxRequests, bucket.tokens + tokensToAdd);\n    bucket.lastRefill = now;\n\n    // Check if request can proceed\n    if (bucket.tokens >= 1) {\n      bucket.tokens -= 1;\n      return {\n        allowed: true,\n        remaining: Math.floor(bucket.tokens),\n        resetAt: now + ((this.config.maxRequests - bucket.tokens) / this.refillRate)\n      };\n    }\n\n    // Rate limit exceeded\n    const resetAt = now + ((1 - bucket.tokens) / this.refillRate);\n    return {\n      allowed: false,\n      remaining: 0,\n      resetAt: Math.ceil(resetAt)\n    };\n  }\n\n  /**\n   * Middleware function for MCP tool execution\n   * @param clientId Unique identifier for the client\n   * @param toolName Name of the tool being executed\n   * @returns Promise that resolves if allowed, rejects if rate limited\n   */\n  public async middleware(\n    clientId: string,\n    toolName: string\n  ): Promise<{ remaining: number; resetAt: number }> {\n    const result = this.checkLimit(clientId);\n\n    if (!result.allowed && this.config.blockOnExceed) {\n      const error: any = new Error(this.config.message);\n      error.code = 'RATE_LIMIT_EXCEEDED';\n      error.remaining = result.remaining;\n      error.resetAt = result.resetAt;\n      error.toolName = toolName;\n      error.clientId = clientId;\n      throw error;\n    }\n\n    return {\n      remaining: result.remaining,\n      resetAt: result.resetAt\n    };\n  }\n\n  /**\n   * Get current rate limit status for a client\n   * @param clientId Unique identifier for the client\n   * @returns Current bucket state\n   */\n  public getStatus(clientId: string): { tokens: number; maxTokens: number; resetAt: number } {\n    const now = Date.now();\n    const bucket = this.buckets.get(clientId);\n\n    if (!bucket) {\n      return {\n        tokens: this.config.maxRequests,\n        maxTokens: this.config.maxRequests,\n        resetAt: now\n      };\n    }\n\n    // Calculate current tokens with refill\n    const elapsed = now - bucket.lastRefill;\n    const tokensToAdd = elapsed * this.refillRate;\n    const currentTokens = Math.min(this.config.maxRequests, bucket.tokens + tokensToAdd);\n\n    return {\n      tokens: Math.floor(currentTokens),\n      maxTokens: this.config.maxRequests,\n      resetAt: now + ((this.config.maxRequests - currentTokens) / this.refillRate)\n    };\n  }\n\n  /**\n   * Reset rate limit for a specific client\n   * @param clientId Unique identifier for the client\n   */\n  public reset(clientId: string): void {\n    this.buckets.delete(clientId);\n  }\n\n  /**\n   * Reset all rate limits (admin function)\n   */\n  public resetAll(): void {\n    this.buckets.clear();\n  }\n\n  /**\n   * Cleanup old buckets that haven't been used in 10 minutes\n   */\n  private cleanup(): void {\n    const now = Date.now();\n    const maxAge = 10 * 60 * 1000; // 10 minutes\n\n    for (const [clientId, bucket] of this.buckets.entries()) {\n      if (now - bucket.lastRefill > maxAge) {\n        this.buckets.delete(clientId);\n      }\n    }\n  }\n\n  /**\n   * Get statistics about rate limiter usage\n   */\n  public getStats(): {\n    activeClients: number;\n    totalBuckets: number;\n    config: Required<RateLimitConfig>;\n  } {\n    return {\n      activeClients: this.buckets.size,\n      totalBuckets: this.buckets.size,\n      config: this.config\n    };\n  }\n}\n\n// Export singleton instance with default config\nexport const defaultRateLimiter = new RateLimiter({\n  maxRequests: 100,\n  windowMs: 60000,\n  blockOnExceed: true,\n  message: 'Rate limit exceeded. Please try again later.'\n});\n\n// Export per-tool rate limiters for critical operations\nexport const criticalRateLimiter = new RateLimiter({\n  maxRequests: 10,\n  windowMs: 60000,\n  blockOnExceed: true,\n  message: 'Rate limit exceeded for critical operation. Please try again later.'\n});\n\n/**\n * Helper to get client ID from auth context or IP\n */\nexport function getClientId(auth?: { userId?: string }, ip?: string): string {\n  return auth?.userId ?? ip ?? 'anonymous';\n}\n"]}

package/dist/mcp/standalone-stdio-fixed.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=standalone-stdio-fixed.d.ts.map

package/dist/mcp/standalone-stdio-fixed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"standalone-stdio-fixed.d.ts","sourceRoot":"","sources":["../../src/mcp/standalone-stdio-fixed.ts"],"names":[],"mappings":""}

package/dist/mcp/standalone-stdio-fixed.js

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from 'child_process';
-// [Previous code unchanged until agent_booster_edit_file tool - lines 1-363]
-// Helper function to safely execute agent-booster
-async function safeAgentBoosterApply(originalCode, codeEdit, language) {
-    // Validate language parameter
-    const allowedLanguages = ['typescript', 'javascript', 'python', 'rust', 'go', 'java', 'c', 'cpp'];
-    if (!allowedLanguages.includes(language)) {
-        throw new Error(`Invalid language: ${language}. Must be one of: ${allowedLanguages.join(', ')}`);
-    }
-    const result = spawnSync('npx', ['--yes', 'agent-booster@0.2.2', 'apply', '--language', language], {
-        encoding: 'utf-8',
-        input: JSON.stringify({ code: originalCode, edit: codeEdit }),
-        maxBuffer: 10 * 1024 * 1024,
-        timeout: 30000,
-        shell: false // CVE-2026-003: Prevent shell injection
-    });
-    if (result.error) {
-        return { stdout: '', stderr: result.stderr || '', error: result.error };
-    }
-    if (result.status !== 0) {
-        return { stdout: '', stderr: result.stderr || result.stdout || '', error: new Error('Agent Booster failed') };
-    }
-    return { stdout: result.stdout, stderr: result.stderr || '' };
-}
-// Note: The full file would need to be updated. Since it's 813 lines, I'll create a patch file instead.
-//# sourceMappingURL=standalone-stdio-fixed.js.map

package/dist/mcp/standalone-stdio-fixed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"standalone-stdio-fixed.js","sourceRoot":"","sources":["../../src/mcp/standalone-stdio-fixed.ts"],"names":[],"mappings":";AAKA,OAAO,EAAY,SAAS,EAAE,MAAM,eAAe,CAAC;AAIpD,6EAA6E;AAE7E,kDAAkD;AAClD,KAAK,UAAU,qBAAqB,CAAC,YAAoB,EAAE,QAAgB,EAAE,QAAgB;IAC3F,8BAA8B;IAC9B,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE;QACjG,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7D,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QAC3B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK,CAAC,wCAAwC;KACtD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC;IAChH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,wGAAwG","sourcesContent":["#!/usr/bin/env node\n// Standalone agentic-flow MCP server - runs directly via stdio without spawning subprocesses\n// SECURITY: All CVE-2026-003 and CVE-2026-004 fixes applied\nimport { FastMCP } from 'fastmcp';\nimport { z } from 'zod';\nimport { execSync, spawnSync } from 'child_process';\nimport { resolve } from 'path';\nimport { validateReadPath, validateWritePath } from '../security/path-validator.js';\n\n// [Previous code unchanged until agent_booster_edit_file tool - lines 1-363]\n\n// Helper function to safely execute agent-booster\nasync function safeAgentBoosterApply(originalCode: string, codeEdit: string, language: string): Promise<{ stdout: string; stderr: string; error?: Error }> {\n  // Validate language parameter\n  const allowedLanguages = ['typescript', 'javascript', 'python', 'rust', 'go', 'java', 'c', 'cpp'];\n  if (!allowedLanguages.includes(language)) {\n    throw new Error(`Invalid language: ${language}. Must be one of: ${allowedLanguages.join(', ')}`);\n  }\n\n  const result = spawnSync('npx', ['--yes', 'agent-booster@0.2.2', 'apply', '--language', language], {\n    encoding: 'utf-8',\n    input: JSON.stringify({ code: originalCode, edit: codeEdit }),\n    maxBuffer: 10 * 1024 * 1024,\n    timeout: 30000,\n    shell: false // CVE-2026-003: Prevent shell injection\n  });\n\n  if (result.error) {\n    return { stdout: '', stderr: result.stderr || '', error: result.error };\n  }\n\n  if (result.status !== 0) {\n    return { stdout: '', stderr: result.stderr || result.stdout || '', error: new Error('Agent Booster failed') };\n  }\n\n  return { stdout: result.stdout, stderr: result.stderr || '' };\n}\n\n// Note: The full file would need to be updated. Since it's 813 lines, I'll create a patch file instead.\n"]}

package/dist/memory/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Memory Management Exports
- *
- * Provides shared memory pool and optimization utilities
- */
-export { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';
-export type { SharedMemoryPoolConfig } from './SharedMemoryPool.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/memory/index.js

@@ -1,7 +0,0 @@
-/**
- * Memory Management Exports
- *
- * Provides shared memory pool and optimization utilities
- */
-export { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';
-//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * Memory Management Exports\n *\n * Provides shared memory pool and optimization utilities\n */\n\nexport { SharedMemoryPool, getSharedMemoryPool } from './SharedMemoryPool.js';\nexport type { SharedMemoryPoolConfig } from './SharedMemoryPool.js';\n"]}

package/dist/packages/agentdb/src/backends/GraphBackend.d.ts

@@ -1,196 +0,0 @@
-/**
- * GraphBackend Interface - Graph database capabilities (Optional)
- *
- * Provides property graph storage and Cypher-like query capabilities.
- * Available when @ruvector/graph-node is installed.
- *
- * Features:
- * - Node and relationship management
- * - Cypher query execution
- * - Graph traversal and pattern matching
- * - Integration with vector search
- */
-/**
- * Graph node representation
- */
-export interface GraphNode {
-    /** Unique node identifier */
-    id: string;
-    /** Node labels (types) */
-    labels: string[];
-    /** Node properties */
-    properties: Record<string, any>;
-    /** Optional vector embedding for hybrid search */
-    embedding?: Float32Array;
-}
-/**
- * Graph relationship representation
- */
-export interface GraphRelationship {
-    /** Unique relationship identifier */
-    id: string;
-    /** Source node ID */
-    from: string;
-    /** Target node ID */
-    to: string;
-    /** Relationship type */
-    type: string;
-    /** Relationship properties */
-    properties?: Record<string, any>;
-}
-/**
- * Cypher query result
- */
-export interface QueryResult {
-    /** Result rows */
-    rows: Record<string, any>[];
-    /** Result columns */
-    columns: string[];
-    /** Number of rows returned */
-    count: number;
-    /** Query execution time in milliseconds */
-    executionTime: number;
-}
-/**
- * Graph traversal options
- */
-export interface TraversalOptions {
-    /** Maximum traversal depth */
-    maxDepth?: number;
-    /** Relationship types to follow (empty = all) */
-    relationshipTypes?: string[];
-    /** Node label filter */
-    nodeLabels?: string[];
-    /** Direction: 'outgoing', 'incoming', 'both' */
-    direction?: 'outgoing' | 'incoming' | 'both';
-}
-/**
- * Graph statistics
- */
-export interface GraphStats {
-    /** Total number of nodes */
-    nodeCount: number;
-    /** Total number of relationships */
-    relationshipCount: number;
-    /** Node label distribution */
-    nodeLabelCounts: Record<string, number>;
-    /** Relationship type distribution */
-    relationshipTypeCounts: Record<string, number>;
-    /** Estimated memory usage in bytes */
-    memoryUsage: number;
-}
-/**
- * GraphBackend - Optional graph database interface
- *
- * Implementations:
- * - RuVectorGraph: Native Rust graph with @ruvector/graph-node
- * - MockGraphBackend: No-op implementation for testing
- */
-export interface GraphBackend {
-    /**
-     * Execute a Cypher query
-     *
-     * @param cypher - Cypher query string
-     * @param params - Query parameters
-     * @returns Query result with rows and metadata
-     */
-    execute(cypher: string, params?: Record<string, any>): Promise<QueryResult>;
-    /**
-     * Create a new node
-     *
-     * @param labels - Node labels (types)
-     * @param properties - Node properties
-     * @returns Created node ID
-     */
-    createNode(labels: string[], properties: Record<string, any>): Promise<string>;
-    /**
-     * Get a node by ID
-     *
-     * @param id - Node identifier
-     * @returns Node or null if not found
-     */
-    getNode(id: string): Promise<GraphNode | null>;
-    /**
-     * Update node properties
-     *
-     * @param id - Node identifier
-     * @param properties - Properties to update
-     * @returns True if updated, false if not found
-     */
-    updateNode(id: string, properties: Record<string, any>): Promise<boolean>;
-    /**
-     * Delete a node and its relationships
-     *
-     * @param id - Node identifier
-     * @returns True if deleted, false if not found
-     */
-    deleteNode(id: string): Promise<boolean>;
-    /**
-     * Create a relationship between nodes
-     *
-     * @param from - Source node ID
-     * @param to - Target node ID
-     * @param type - Relationship type
-     * @param properties - Optional relationship properties
-     * @returns Created relationship ID
-     */
-    createRelationship(from: string, to: string, type: string, properties?: Record<string, any>): Promise<string>;
-    /**
-     * Get a relationship by ID
-     *
-     * @param id - Relationship identifier
-     * @returns Relationship or null if not found
-     */
-    getRelationship(id: string): Promise<GraphRelationship | null>;
-    /**
-     * Delete a relationship
-     *
-     * @param id - Relationship identifier
-     * @returns True if deleted, false if not found
-     */
-    deleteRelationship(id: string): Promise<boolean>;
-    /**
-     * Traverse the graph from a starting node
-     *
-     * @param startId - Starting node ID
-     * @param pattern - Traversal pattern (e.g., "()-[:RELATES_TO]->(:Entity)")
-     * @param options - Traversal options
-     * @returns Array of nodes found during traversal
-     */
-    traverse(startId: string, pattern: string, options?: TraversalOptions): Promise<GraphNode[]>;
-    /**
-     * Find shortest path between two nodes
-     *
-     * @param fromId - Source node ID
-     * @param toId - Target node ID
-     * @param options - Traversal options
-     * @returns Array of nodes representing the path, or empty if no path exists
-     */
-    shortestPath(fromId: string, toId: string, options?: TraversalOptions): Promise<GraphNode[]>;
-    /**
-     * Find nodes similar to a query vector within a graph context
-     *
-     * Combines vector similarity search with graph structure
-     *
-     * @param query - Query vector
-     * @param k - Number of results
-     * @param contextNodeId - Optional context node for graph-based filtering
-     * @returns Array of nodes sorted by similarity
-     */
-    vectorSearch(query: Float32Array, k: number, contextNodeId?: string): Promise<GraphNode[]>;
-    /**
-     * Get graph statistics
-     *
-     * @returns Current statistics of the graph
-     */
-    getStats(): GraphStats;
-    /**
-     * Clear the entire graph
-     */
-    clear(): Promise<void>;
-}
-/**
- * Type guard to check if an object implements GraphBackend
- */
-export declare function isGraphBackend(obj: any): obj is GraphBackend;
-//# sourceMappingURL=GraphBackend.d.ts.map

package/dist/packages/agentdb/src/backends/GraphBackend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphBackend.d.ts","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/backends/GraphBackend.ts"],"names":[],"mappings":"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"}

package/dist/packages/agentdb/src/backends/GraphBackend.js

@@ -1,33 +0,0 @@
-/**
- * GraphBackend Interface - Graph database capabilities (Optional)
- *
- * Provides property graph storage and Cypher-like query capabilities.
- * Available when @ruvector/graph-node is installed.
- *
- * Features:
- * - Node and relationship management
- * - Cypher query execution
- * - Graph traversal and pattern matching
- * - Integration with vector search
- */
-/**
- * Type guard to check if an object implements GraphBackend
- */
-export function isGraphBackend(obj) {
-    return (typeof obj === 'object' &&
-        obj !== null &&
-        typeof obj.execute === 'function' &&
-        typeof obj.createNode === 'function' &&
-        typeof obj.getNode === 'function' &&
-        typeof obj.updateNode === 'function' &&
-        typeof obj.deleteNode === 'function' &&
-        typeof obj.createRelationship === 'function' &&
-        typeof obj.getRelationship === 'function' &&
-        typeof obj.deleteRelationship === 'function' &&
-        typeof obj.traverse === 'function' &&
-        typeof obj.shortestPath === 'function' &&
-        typeof obj.vectorSearch === 'function' &&
-        typeof obj.getStats === 'function' &&
-        typeof obj.clear === 'function');
-}
-//# sourceMappingURL=GraphBackend.js.map

package/dist/packages/agentdb/src/backends/GraphBackend.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GraphBackend.js","sourceRoot":"","sources":["../../../../../../packages/agentdb/src/backends/GraphBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiQH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ;IACrC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU;QACjC,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU;QACpC,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU;QACjC,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU;QACpC,OAAO,GAAG,CAAC,UAAU,KAAK,UAAU;QACpC,OAAO,GAAG,CAAC,kBAAkB,KAAK,UAAU;QAC5C,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU;QACzC,OAAO,GAAG,CAAC,kBAAkB,KAAK,UAAU;QAC5C,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU;QAClC,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;QACtC,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;QACtC,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU;QAClC,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,CAChC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * GraphBackend Interface - Graph database capabilities (Optional)\n *\n * Provides property graph storage and Cypher-like query capabilities.\n * Available when @ruvector/graph-node is installed.\n *\n * Features:\n * - Node and relationship management\n * - Cypher query execution\n * - Graph traversal and pattern matching\n * - Integration with vector search\n */\n\n/**\n * Graph node representation\n */\nexport interface GraphNode {\n  /** Unique node identifier */\n  id: string;\n\n  /** Node labels (types) */\n  labels: string[];\n\n  /** Node properties */\n  properties: Record<string, any>;\n\n  /** Optional vector embedding for hybrid search */\n  embedding?: Float32Array;\n}\n\n/**\n * Graph relationship representation\n */\nexport interface GraphRelationship {\n  /** Unique relationship identifier */\n  id: string;\n\n  /** Source node ID */\n  from: string;\n\n  /** Target node ID */\n  to: string;\n\n  /** Relationship type */\n  type: string;\n\n  /** Relationship properties */\n  properties?: Record<string, any>;\n}\n\n/**\n * Cypher query result\n */\nexport interface QueryResult {\n  /** Result rows */\n  rows: Record<string, any>[];\n\n  /** Result columns */\n  columns: string[];\n\n  /** Number of rows returned */\n  count: number;\n\n  /** Query execution time in milliseconds */\n  executionTime: number;\n}\n\n/**\n * Graph traversal options\n */\nexport interface TraversalOptions {\n  /** Maximum traversal depth */\n  maxDepth?: number;\n\n  /** Relationship types to follow (empty = all) */\n  relationshipTypes?: string[];\n\n  /** Node label filter */\n  nodeLabels?: string[];\n\n  /** Direction: 'outgoing', 'incoming', 'both' */\n  direction?: 'outgoing' | 'incoming' | 'both';\n}\n\n/**\n * Graph statistics\n */\nexport interface GraphStats {\n  /** Total number of nodes */\n  nodeCount: number;\n\n  /** Total number of relationships */\n  relationshipCount: number;\n\n  /** Node label distribution */\n  nodeLabelCounts: Record<string, number>;\n\n  /** Relationship type distribution */\n  relationshipTypeCounts: Record<string, number>;\n\n  /** Estimated memory usage in bytes */\n  memoryUsage: number;\n}\n\n/**\n * GraphBackend - Optional graph database interface\n *\n * Implementations:\n * - RuVectorGraph: Native Rust graph with @ruvector/graph-node\n * - MockGraphBackend: No-op implementation for testing\n */\nexport interface GraphBackend {\n  // ============================================================================\n  // Cypher Execution\n  // ============================================================================\n\n  /**\n   * Execute a Cypher query\n   *\n   * @param cypher - Cypher query string\n   * @param params - Query parameters\n   * @returns Query result with rows and metadata\n   */\n  execute(cypher: string, params?: Record<string, any>): Promise<QueryResult>;\n\n  // ============================================================================\n  // Node Operations\n  // ============================================================================\n\n  /**\n   * Create a new node\n   *\n   * @param labels - Node labels (types)\n   * @param properties - Node properties\n   * @returns Created node ID\n   */\n  createNode(labels: string[], properties: Record<string, any>): Promise<string>;\n\n  /**\n   * Get a node by ID\n   *\n   * @param id - Node identifier\n   * @returns Node or null if not found\n   */\n  getNode(id: string): Promise<GraphNode | null>;\n\n  /**\n   * Update node properties\n   *\n   * @param id - Node identifier\n   * @param properties - Properties to update\n   * @returns True if updated, false if not found\n   */\n  updateNode(id: string, properties: Record<string, any>): Promise<boolean>;\n\n  /**\n   * Delete a node and its relationships\n   *\n   * @param id - Node identifier\n   * @returns True if deleted, false if not found\n   */\n  deleteNode(id: string): Promise<boolean>;\n\n  // ============================================================================\n  // Relationship Operations\n  // ============================================================================\n\n  /**\n   * Create a relationship between nodes\n   *\n   * @param from - Source node ID\n   * @param to - Target node ID\n   * @param type - Relationship type\n   * @param properties - Optional relationship properties\n   * @returns Created relationship ID\n   */\n  createRelationship(\n    from: string,\n    to: string,\n    type: string,\n    properties?: Record<string, any>\n  ): Promise<string>;\n\n  /**\n   * Get a relationship by ID\n   *\n   * @param id - Relationship identifier\n   * @returns Relationship or null if not found\n   */\n  getRelationship(id: string): Promise<GraphRelationship | null>;\n\n  /**\n   * Delete a relationship\n   *\n   * @param id - Relationship identifier\n   * @returns True if deleted, false if not found\n   */\n  deleteRelationship(id: string): Promise<boolean>;\n\n  // ============================================================================\n  // Traversal\n  // ============================================================================\n\n  /**\n   * Traverse the graph from a starting node\n   *\n   * @param startId - Starting node ID\n   * @param pattern - Traversal pattern (e.g., \"()-[:RELATES_TO]->(:Entity)\")\n   * @param options - Traversal options\n   * @returns Array of nodes found during traversal\n   */\n  traverse(\n    startId: string,\n    pattern: string,\n    options?: TraversalOptions\n  ): Promise<GraphNode[]>;\n\n  /**\n   * Find shortest path between two nodes\n   *\n   * @param fromId - Source node ID\n   * @param toId - Target node ID\n   * @param options - Traversal options\n   * @returns Array of nodes representing the path, or empty if no path exists\n   */\n  shortestPath(\n    fromId: string,\n    toId: string,\n    options?: TraversalOptions\n  ): Promise<GraphNode[]>;\n\n  // ============================================================================\n  // Hybrid Operations (Graph + Vector)\n  // ============================================================================\n\n  /**\n   * Find nodes similar to a query vector within a graph context\n   *\n   * Combines vector similarity search with graph structure\n   *\n   * @param query - Query vector\n   * @param k - Number of results\n   * @param contextNodeId - Optional context node for graph-based filtering\n   * @returns Array of nodes sorted by similarity\n   */\n  vectorSearch(\n    query: Float32Array,\n    k: number,\n    contextNodeId?: string\n  ): Promise<GraphNode[]>;\n\n  // ============================================================================\n  // Stats\n  // ============================================================================\n\n  /**\n   * Get graph statistics\n   *\n   * @returns Current statistics of the graph\n   */\n  getStats(): GraphStats;\n\n  /**\n   * Clear the entire graph\n   */\n  clear(): Promise<void>;\n}\n\n/**\n * Type guard to check if an object implements GraphBackend\n */\nexport function isGraphBackend(obj: any): obj is GraphBackend {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    typeof obj.execute === 'function' &&\n    typeof obj.createNode === 'function' &&\n    typeof obj.getNode === 'function' &&\n    typeof obj.updateNode === 'function' &&\n    typeof obj.deleteNode === 'function' &&\n    typeof obj.createRelationship === 'function' &&\n    typeof obj.getRelationship === 'function' &&\n    typeof obj.deleteRelationship === 'function' &&\n    typeof obj.traverse === 'function' &&\n    typeof obj.shortestPath === 'function' &&\n    typeof obj.vectorSearch === 'function' &&\n    typeof obj.getStats === 'function' &&\n    typeof obj.clear === 'function'\n  );\n}\n"]}