NPM Packages Developer Guides

Separation of Duties: See Separation of Duties - NPM packages are responsible for infrastructure and shared services. They do NOT own agent manifests, execution, or platform implementations.

Vast.ai Integration: See BULLETPROOF_VASTAI_PLAN.md - Complete Vast.ai implementation plan with agent-docker integration.

Comprehensive developer documentation for all 15 @bluefly NPM packages in the LLM Platform ecosystem.

Package Index

Agent Infrastructure

1. Agent Brain - Vector database orchestration platform

   • Qdrant integration, semantic search, knowledge graphs, scientific research agents

2. Agent Mesh - Backend coordination layer

   • gRPC server, MCP integration, agent discovery, load balancing

3. Agent Protocol - MCP server and OSSA protocol

   • Tool registry, context routing, security layer, MCPB CLI

4. Agent Router - Unified LLM gateway

   • Multi-provider routing, GraphQL federation, LibreChat integration

5. Agent Tracer - AI operations intelligence

   • Phoenix Arize, Jaeger, Neo4j correlation, ACE/ATLAS analytics

Developer Tools

1. Agent Studio - Multi-platform IDE

   • macOS/iOS/iPadOS apps, NeuronLink AI, cross-device sync

2. Agent Docker - Container orchestration

   • Docker lifecycle management, multi-registry support, OSSA v0.1.9

3. Agent Chat - Enterprise chat interface

   • LibreChat-compatible, multi-model routing, vector search

Workflow & Automation

1. Agentic Flows - Multi-agent workflows

   • N8N custom nodes, CrewAI integration, Langflow, MLflow tracking

2. Workflow Engine - Langflow-Drupal bridge

   • Visual workflow builder, GraphQL server, MCP integration

Governance & Compliance

1. Compliance Engine - Policy enforcement

   • FedRAMP, NIST, HIPAA, GDPR compliance, audit logging

2. Foundation Bridge - Apple & cryptography

   • GnuPG, Duo MFA, Keychain integration, certificate management

Documentation & UI

1. Doc Engine - API documentation engine

   • OpenAPI-first, Swagger UI, ReDoc, Apidog integration

2. Studio UI - React component library

   • Tailwind CSS, Radix UI, charts, dashboard components

3. RFP Automation - AI-powered proposals

   • Multi-agent system, RAG pipeline, government compliance

Quick Reference

Installation

All packages are available via npm:

npm install @bluefly/<package-name>

Common Dependencies

Most packages require:

• Node.js 20+
• TypeScript
• Redis (caching)
• PostgreSQL (data storage)

Environment Setup

Create ~/.tokens/ directory for API keys:

mkdir -p ~/.tokens
chmod 700 ~/.tokens

# Store API keys
echo "your-key" > ~/.tokens/anthropic
echo "your-key" > ~/.tokens/openai
chmod 600 ~/.tokens/*

Architecture Overview

         Frontend Layer                      
  Agent Studio, Agent Chat, Studio UI        

               

         API Gateway Layer                   
  Agent Router, Agent Protocol, Doc Engine   

               

         Coordination Layer                  
  Agent Mesh, Workflow Engine, Agentic Flows 

               

         Intelligence Layer                  
  Agent Brain, Agent Tracer, Compliance      

               

         Infrastructure Layer                
  Agent Docker, Foundation Bridge, RFP       

Integration Matrix

OSSA Compliance

All packages are OSSA 1.0 compliant:

• Agent Protocol: Full OSSA implementation
• Agent Architecture: Governor/Worker/Critic/Observer patterns
• Capability Discovery: Standardized agent capabilities
• Health Monitoring: Real-time agent health checks
• Lifecycle Management: Complete agent lifecycle control

Observability Stack

Phoenix Arize (AI Tracing)

open http://localhost:6006

Jaeger (Distributed Tracing)

open http://localhost:16686

Prometheus (Metrics)

open http://localhost:9090

Grafana (Dashboards)

open http://localhost:3000

Development Workflow

1. Setup Environment

# Install Node.js 20+
nvm install 20
nvm use 20

# Create tokens directory
mkdir -p ~/.tokens
chmod 700 ~/.tokens

2. Install Package

npm install @bluefly/<package-name>

3. Configure

# Set environment variables
export PACKAGE_NAME_PORT=3000
export PACKAGE_NAME_API_KEY=$(cat ~/.tokens/api-key)

4. Run Tests

npm test
npm run test:integration
npm run test:coverage

5. Build & Deploy

npm run build
npm run deploy

Support & Resources

Documentation

• GitLab Wiki: https://gitlab.com/blueflyio/agent-platform/technical-guide/-/wikis
• OpenAPI Registry: $LLM_ROOT/technical-guide/openapi/
• Source Code: https://gitlab.com/blueflyio/agent-platform/npm/

Issue Tracking

• Report Issues: https://gitlab.com/blueflyio/agent-platform/npm/<package-name>/-/issues
• Feature Requests: Create issue with enhancement label
• Bug Reports: Create issue with bug label

Community

• GitLab Discussions: https://gitlab.com/blueflyio/agent-platform/-/discussions
• CI/CD Pipelines: https://gitlab.com/blueflyio/agent-platform/npm/<package-name>/-/pipelines

License

All packages are licensed under:

• MIT: agent-brain, agent-chat, agent-mesh, agent-studio, agent-tracer, agentic-flows, doc-engine, rfp-automation, workflow-engine
• GPL-2.0+: agent-router, compliance-engine, foundation-bridge, studio-ui

Version History

All packages follow semantic versioning (semver):

• Major: Breaking changes
• Minor: New features (backward compatible)
• Patch: Bug fixes (backward compatible)

Check individual package README files for specific version history.

---

Last Updated: 2025-11-22 Total Packages: 15 Documentation Coverage: 100%