v2.5.0: CLI Arguments Support & Simplified Stdio Transport

🎉 What's New in v2.5.0

✨ Major Features Added

• 🖥️ Comprehensive CLI Argument Support - New command-line interface with 20+ configuration options

  • OpenAI: --model, --temperature, --max-tokens, --api-key, --timeout, --max-retries
  • Transport: --transport, --cubicler-url, --sse-url, --agent-id
  • Memory: --memory-db-path, --memory-max-tokens
  • JWT: --jwt, --jwt-type, --jwt-token
  • Help: --help, --version

• 🔗 MCP-Style Stdio Usage - Perfect for Cubicler agent spawning

  npx @cubicler/cubicagent-openai --model gpt-4o --memory-db-path ./agent-memory.db

• ⚙️ Smart Configuration Merging - CLI args override environment variables seamlessly

🔄 Breaking Changes

• Removed stdio configuration complexity:
  • ❌ STDIO_COMMAND, STDIO_ARGS, STDIO_CWD environment variables no longer supported
  • ✅ Stdio agents now use parameter-less initialization for better MCP compatibility

🚀 Improvements

• Upgraded CubicAgentKit to v2.5.0 for latest features
• Enhanced documentation with unified guidelines across all files
• Better Docker support with TRANSPORT_MODE configuration
• Improved CLI defaults - respects environment variables for Docker deployments

📦 Installation & Usage

# Install globally for CLI usage
npm install -g @cubicler/cubicagent-openai@2.5.0

# Basic usage (stdio mode by default)
npx @cubicler/cubicagent-openai --model gpt-4o

# With memory enabled
npx @cubicler/cubicagent-openai --memory-db-path ./memories.db

# HTTP mode with custom settings  
npx @cubicler/cubicagent-openai --transport http --cubicler-url http://localhost:8080

🔧 MCP Agent Configuration

For Cubicler agents.json:

{
  "agents": {
    "openai-agent": {
      "transport": "stdio",
      "command": "npx", 
      "args": ["@cubicler/cubicagent-openai", "--model", "gpt-4o", "--memory-db-path", "./agent-memory.db"],
      "env": {
        "OPENAI_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

🔗 Compatibility

• CubicAgentKit: v2.5.0
• OpenAI SDK: ^4.63.0
• Node.js: >=18.0.0

💥 Breaking Changes Details

If you're upgrading from v2.4.0 or earlier:

1. Environment Variables Removed:

   • STDIO_COMMAND - No longer needed
   • STDIO_ARGS - No longer needed
   • STDIO_CWD - No longer needed

2. Migration Guide:

   • Remove stdio environment variables from your .env files
   • CLI usage now defaults to stdio mode automatically

---

Full Changelog: v2.4.0...v2.5.0