Warp AI Bridge API

Technical documentation for the Warp AI Bridge integration.

Overview

The Warp AI Bridge provides intelligent command suggestions and context-aware assistance by connecting Warp's AI capabilities with SWORDSwarm's agent ecosystem.

Architecture

Warp AI → MCP Context → Warp AI Bridge → SWORDSwarm Agents

---

WarpAIBridge Class

Initialization

from integrations.warp_ai_bridge import WarpAIBridge

bridge = WarpAIBridge()
bridge.initialize()

Methods

initialize()

Initialize the Warp AI bridge and setup MCP context.

Returns: bool - Success status

success = bridge.initialize()
if success:
    print("Bridge initialized")

---

suggest_command(natural_language: str) -> Optional[str]

Convert natural language to SWORDSwarm command.

Parameters:

• natural_language - Natural language description

Returns: Command string or None

cmd = bridge.suggest_command("run security audit")
# → "python3 -c \"from claude_agents import get_agent; ..."

---

get_agent_context_for_warp(agent_name: str) -> Dict[str, Any]

Get agent context for Warp AI suggestions.

Parameters:

• agent_name - Name of the agent

Returns: Context dictionary

context = bridge.get_agent_context_for_warp("python-internal")
# → {
#     "name": "python-internal",
#     "capabilities": ["code_analysis", "optimization"],
#     "usage_examples": [...],
#     "common_tasks": [...]
# }

---

enable_warp_ai_mode()

Enable enhanced Warp AI mode with SWORDSwarm awareness.

bridge.enable_warp_ai_mode()
# Prints configuration and hardware status

---

Model Context Protocol (MCP)

Location

~/.warp/mcp_context.json

Structure

{
  "system": "SWORDSwarm",
  "version": "v42.0",
  "agent_count": 88,
  "agents": {
    "agent-name": {
      "available": true,
      "capabilities": ["capability1", "capability2"]
    }
  },
  "hardware_acceleration": {
    "npu_available": true,
    "avx512_available": true,
    "acceleration_active": true
  },
  "common_commands": [
    {
      "command": "...",
      "description": "...",
      "category": "..."
    }
  ]
}

---

Command Suggestion Patterns

Pattern Matching

# Natural language → Command mapping
patterns = {
    "list.*agent": "python3 -c \"from claude_agents import list_agents; ...\"",
    "security.*audit": "python3 -c \"from claude_agents import get_agent('security'); ...\"",
    "hardware.*check": "python3 hardware/milspec_hardware_analyzer.py",
    "test": "pytest -v --cov=claude_agents"
}

Adding Custom Patterns

Extend suggest_command() method:

def suggest_command(self, natural_language: str) -> Optional[str]:
    nl_lower = natural_language.lower()

    # Add your custom patterns
    if "my custom pattern" in nl_lower:
        return "my custom command"

    # Fallback to default patterns
    # ...

---

Usage Examples

Basic Usage

from integrations.warp_ai_bridge import WarpAIBridge

# Initialize
bridge = WarpAIBridge()
bridge.initialize()

# Get command suggestion
cmd = bridge.suggest_command("list all agents")
print(cmd)

# Get agent context
context = bridge.get_agent_context_for_warp("security")
print(f"Capabilities: {context['capabilities']}")

Advanced Usage

# Custom initialization with caching
bridge = WarpAIBridge()
bridge.initialize()

# Batch command suggestions
queries = [
    "run security audit",
    "check hardware",
    "deploy to production"
]

commands = [bridge.suggest_command(q) for q in queries]

# Get all agent contexts
agents = list_agents()
contexts = {
    agent: bridge.get_agent_context_for_warp(agent)
    for agent in agents
}

---

Integration Points

Warp AI

Warp AI reads MCP context to provide suggestions.

Trigger: Type # followed by natural language

Flow:

1. User types: # run security audit
2. Warp AI reads ~/.warp/mcp_context.json
3. Warp AI suggests: python3 -c "from claude_agents import get_agent('security'); ..."

Warp Drive

Team knowledge sharing via MCP.

Setup:

1. Initialize bridge in project
2. Commit .warp/ directory
3. Team members pull and Warp syncs context

---

Troubleshooting

MCP Context Not Updating

# Force re-initialization
bridge = WarpAIBridge()
bridge._setup_mcp_context()

Command Suggestions Not Working

# Verify MCP context file
import json
with open("~/.warp/mcp_context.json") as f:
    context = json.load(f)
    print(f"Agents: {len(context['agents'])}")

Hardware Not Detected

# Check hardware info
hw_info = bridge._get_hardware_info()
print(hw_info)

---

API Reference

Module: integrations.warp_ai_bridge

Class: WarpAIBridge

Public Methods:

• initialize() -> bool
• suggest_command(natural_language: str) -> Optional[str]
• get_agent_context_for_warp(agent_name: str) -> Dict[str, Any]
• enable_warp_ai_mode() -> None

Private Methods:

• _setup_mcp_context() -> Dict[str, Any]
• _get_agent_capabilities(agent_name: str) -> Dict[str, Any]
• _get_hardware_info() -> Dict[str, Any]
• _get_common_commands() -> List[Dict[str, str]]
• _get_usage_examples(agent_name: str) -> List[str]
• _get_common_tasks(agent_name: str) -> List[str]

---

Full source: integrations/warp_ai_bridge.py