CLI

edge-connector Developer Workflow

Quickstart

npm install -g @nara/edge-connector

edge-connector auth --token "<ADMIN_JWT>"
edge-connector generate --language typescript --tool my_tool
edge-connector test --implementations ./custom-implementations --tool my_tool
edge-connector package
edge-connector upload

Kernbefehle

Authentifiziere die CLI gegen deine Organisation.

edge-connector auth --token "<ADMIN_JWT>"

speichert das Token in auth-token.json (via AUTH_TOKEN_PATH konfigurierbar)
prüft, dass das Token gültig ist und zu einer Organisation gehört
wird vor generate, package, upload und den meisten test‑Flows benötigt

Optionen:

-t, --token <token> – JWT oder Service‑Token für deine nara‑Organisation
-i, --interactive – führt durch einen interaktiven Auth‑Dialog

Generiere Boilerplate‑Code für ein bestimmtes Tool.

edge-connector generate \
  --language typescript \
  --tool my_tool \
  --output ./custom-implementations

Was passiert:

verbindet sich mit dem Tool‑RPC‑Server unter Verwendung deines Tokens
entdeckt Tools, die auf EDGE oder DESKTOP laufen dürfen
erzeugt typisierte Stubs (TypeScript oder Python) für das gewählte Tool

Optionen:

-l, --language <language> – typescript oder python
-t, --tool <tool> – Tool‑Name wie in nara registriert
-o, --output <path> – Ausgabeverzeichnis (Standard ./custom-implementations)
-i, --interactive – Sprache und Tool per Prompt auswählen

Führe eine Implementierung lokal aus und inspiziere das Ergebnis.

edge-connector test \
  --implementations ./custom-implementations \
  --tool my_tool \
  --args '{"foo":"bar"}'

Je nach Flags:

läuft die Implementierung rein lokal, oder
verbindet sich mit Tool RPC, um Tool‑Definition und Kontext zu laden

Wichtige Optionen:

-i, --implementations <path> – Pfad zum Implementierungs‑Root
-t, --tool <name> – zu testender Tool‑Name
-a, --args <json> – JSON‑String mit Argumenten (oder Editor‑Prompt nutzen)
-h, --host <host> – Tool‑RPC‑Host (Standard localhost)
-p, --port <port> – Tool‑RPC‑Port (Standard 3001)
-u, --url <url> – vollständige Tool‑RPC‑URL, überschreibt Host/Port

Baue ein distributables Bundle (.tgz) deiner Tool‑Implementierungen.

edge-connector package \
  --implementations ./custom-implementations \
  --out ./artifacts

Das Bundle enthält:

kompilierte Implementierungen (typischerweise aus dist/)
ein manifest.json mit Organisation, Sprache, Tools, Checksumme und Build‑Zeitpunkt

Optionen:

-i, --implementations <path> – Implementierungsverzeichnis (Standard ./custom-implementations)
-o, --out <dir> – Ausgabeverzeichnis (Standard ./artifacts)
--no-build – überspringt pnpm build (setzt bereits kompiliertes TS voraus)

Lade ein Bundle in die nara Plattform hoch.

edge-connector upload \
  --file ./artifacts/edge-bundle-org-123.tgz \
  --api https://your-nara-webapp.example.com

Ohne --file kann upload zunächst package ausführen und das Ergebnis direkt hochladen.

Wichtige Optionen:

-f, --file <path> – Pfad zu einem .tgz‑Bundle (von package erzeugt)
-i, --implementations <path> – Implementierungsverzeichnis bei On‑the‑fly‑Packaging
--no-build – kein Build vor dem Packaging
--api <url> – Plattform‑API‑Basis‑URL (Standard: konfigurierte platformApiUrl)
--notes <text> – Freitext‑Notizen zur Bundle‑Version

Konfigurationsdateien und Pfade

.
├─ config.json                # Runtime-Konfiguration (Tool-RPC-URL, Pfade)
├─ auth-token.json            # gespeichertes Auth-Token für CLI/Runtime
├─ deployment-credentials.json# deploymentId + deploymentSecret (Server-Modus)
└─ custom-implementations/    # deine Tool-Implementierungen