ACP-Connector

Der acp-connector bridged das Agent Client Protocol (ACP) zu lokalen Agent-Prozessen über stdio und stellt die Steuerung als MCP-Tools bereit. Er ist für lokale Agent-Runtimes gedacht, die über ACP initialisiert werden, Sessions öffnen, Prompts entgegennehmen und Status- oder Permission-Requests an den Host zurückgeben.

Start und Konfiguration

ai-hub-cli acp-connector \
  --acp-agents-config /pfad/zu/agents.json \
  --workspace /pfad/zum/projekt

{
  "agents": [
    {
      "id": "local-agent",
      "command": "mein-agent",
      "args": ["--stdio"],
      "description": "Lokaler ACP-Agent"
    }
  ]
}

Flag	Standard	Beschreibung
--acp-agents-config	ACP_AGENTS_CONFIG	JSON-Datei mit Agent-Profilen.
--workspace	Aktuelles Verzeichnis	Default-Workspace für fs/*-Validierung.
--acp-auto-approve	true	Genehmigt session/request_permission automatisch.

MCP-Tools

Tool	Parameter	Beschreibung
acp_list_agents	-	Listet konfigurierte Agent-Profile.
acp_agent_info	agent_id (Pflicht)	Lädt ein Agent-Profil per ID.
acp_spawn	command (Pflicht), args, cwd, env, workspace, enable_fs, enable_terminal	Startet einen ACP-Agent-Prozess, initialisiert ihn und registriert eine Verbindung.
acp_session_new	connection_id (Pflicht), cwd, mcp_servers	Erstellt eine ACP-Session.
acp_session_prompt	connection_id (Pflicht), session_id (Pflicht), prompt_text, prompt_blocks	Sendet einen Prompt und gibt Stop-Reason plus gepufferte Updates zurück.
acp_session_cancel	connection_id (Pflicht), session_id (Pflicht)	Sendet session/cancel.
acp_run	command (Pflicht), args, cwd, workspace, prompt_text (Pflicht)	One-shot-Ablauf: Spawn, Initialize, Session und Prompt in einem Tool.
acp_list_runs	-	Listet gespeicherte Run-IDs aus acp_run.
acp_run_status	run_id (Pflicht)	Gibt Statusdaten für einen Run zurück.
acp_status	connection_id	Zeigt Prozessstatus für eine Verbindung oder alle Verbindungen.
acp_stop	connection_id (Pflicht)	Beendet den Agent-Prozess und entfernt die Verbindung.

workspace begrenzt Dateisystem-Clientmethoden des Agents. enable_fs und enable_terminal steuern, welche Client-Capabilities gegenüber dem ACP-Agent beworben werden.