PARTNER-KOMMUNIKATION TOOLS - Partner-Erkennung und Message-Routing
===================================================================

Stand: 2026-01-23
Pfad: docs/help/tools/partner.txt

BESCHREIBUNG
------------
Diese Tools ermöglichen die Kommunikation zwischen BACH und
externen Partnern (Ollama, Gemini, etc.), System-Analyse und 
automatisches Routing von Aufgaben.

Pfad: tools/partner_communication/

ÜBERSICHT
----------

  Tool                        Zeilen   Funktion
  ─────────────────────────────────────────────────────────
  communication.py            678      Partner-Erkennung, Health-Checks
  system_explorer.py          458      OS-Software-Erkennung
  interaction_protocol.py     1225     Instanz-Handshake, DNA-Tracking
  ai_compatible.py            200      AI-kompatible Software filtern
  real_tools.py               198      Echte CLI-Tools identifizieren

  GESAMT: 5 Tools, ~2.759 Zeilen

───────────────────────────────────────────────────────────────

TOOL 1: communication.py
========================
Zentrales Tool für Partner-Erkennung und Message-Routing.

FUNKTIONEN:
  - Automatische Partner-Erkennung (Claude, Ollama, Gemini, etc.)
  - Health-Checks für Partner-Verfügbarkeit
  - Token-aware Message-Routing
  - Partner-Status-Abfragen

VERWENDUNG (Python):
  from tools.partner_communication.communication import (
      detect_partners,
      check_health,
      route_message
  )
  
  # Partner erkennen
  partners = detect_partners()
  
  # Health prüfen
  status = check_health("ollama")
  
  # Nachricht routen
  route_message("Recherche-Aufgabe", target="gemini")

CLI (geplant):
  bach partner detect "Task-Beschreibung"
  bach partner health
  bach partner route --to gemini --message "..."

───────────────────────────────────────────────────────────────

TOOL 2: system_explorer.py
==========================
Scannt das Betriebssystem nach installierter Software.

FUNKTIONEN:
  - Windows Registry scannen
  - AI-kompatible Software identifizieren
  - Tool-Capabilities katalogisieren
  - Software-Inventar erstellen

VERWENDUNG (Python):
  from tools.partner_communication.system_explorer import (
      scan_system,
      get_ai_tools,
      list_capabilities
  )
  
  # System scannen
  software = scan_system()
  
  # Nur AI-Tools
  ai_tools = get_ai_tools()

CLI (geplant):
  bach partner scan
  bach partner scan --ai-only

───────────────────────────────────────────────────────────────

TOOL 3: interaction_protocol.py
===============================
Handshake und Protokolle zwischen BACH-Instanzen.

FUNKTIONEN:
  - Instanz-zu-Instanz Handshake
  - DNA-Tracking (Instanz-Identitaet)
  - 5 Interaktionsprotokolle:
    * Handshake - Gegenseitige Erkennung
    * Compare   - Fähigkeiten vergleichen
    * Request   - Import-Anfragen
    * Transfer  - Datenübertragung
    * Receipt   - Empfangsbestaetigung

VERWENDUNG (Python):
  from tools.partner_communication.interaction_protocol import (
      initiate_handshake,
      execute_protocol
  )
  
  # Handshake starten
  result = initiate_handshake("gemini")
  
  # Protokoll ausführen
  execute_protocol("transfer", target="ollama", data=payload)

───────────────────────────────────────────────────────────────

TOOL 4: ai_compatible.py
========================
Filtert AI-kompatible Software aus dem System-Scan.

FUNKTIONEN:
  - Registry nach AI-Tools durchsuchen
  - LLM-Clients identifizieren (Ollama, LM Studio, etc.)
  - API-Endpoints erkennen
  - Capabilities extrahieren

VERWENDUNG (Python):
  from tools.partner_communication.ai_compatible import (
      scan_ai_software,
      get_llm_clients
  )
  
  ai_tools = scan_ai_software()
  llms = get_llm_clients()

───────────────────────────────────────────────────────────────

TOOL 5: real_tools.py
=====================
Identifiziert echte CLI-Tools für Delegation.

FUNKTIONEN:
  - EXE/CMD/BAT-Tools finden
  - Python-Scripts katalogisieren
  - Tool-Argumente analysieren
  - Delegations-Kandidaten ermitteln

VERWENDUNG (Python):
  from tools.partner_communication.real_tools import (
      find_cli_tools,
      analyze_tool
  )
  
  tools = find_cli_tools()
  info = analyze_tool("git")

───────────────────────────────────────────────────────────────

DATENBANK-INTEGRATION
---------------------
Die Tools nutzen folgende BACH-Tabellen:

  connections        Partner-Endpoints und URLs
  partner_recognition   Capabilities, Zonen, Status
  delegation_rules   Token-basierte Routing-Regeln
  comm_messages      Nachrichtenprotokoll

PARTNER-WORKSPACE
-----------------
  partners/
  ├── _TASKS.md           # Zentrale Task-Zuweisung
  ├── claude/
  │   ├── inbox/          # Eingehende Auftraege
  │   ├── outbox/         # Berichte
  │   └── workspace/      # Arbeitsdateien
  ├── gemini/
  └── ollama/

SIEHE AUCH
----------
  docs/help/partner.txt        Partner-System CLI-Befehle
  docs/help/partners.txt       Partner-Netzwerk Übersicht
  docs/help/delegate.txt       Delegation-Details
  docs/help/communicate.txt    Kommunikationsprotokolle
  
  skills/_services/communicate.md   Skill-Definition
  tools/partner_communication/README.md   Entwickler-Doku

VERSION: v1.0.0 (2026-01-23)
Quelle: tools/partner_communication/README.md
