Skip to content
Open

UI #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
74 commits
Select commit Hold shift + click to select a range
4a50a56
feat: add web server + NOC console frontend (Track B)
indi9o May 13, 2026
c0053e4
fix: align web frontend behavior with tui.py + routing/streaming bugs
indi9o May 13, 2026
b5148b6
feat: add NetBox IPAM integration — agent budi + populate from router
indi9o May 15, 2026
6634ad0
docs: add VLAN naming standard + input validation to netbox agent
indi9o May 15, 2026
8c25dcf
feat: add morning-check skill (M1) — 5-item daily briefing
indi9o May 15, 2026
eebc328
fix: morning-check scope — cover all routers (campus + IDREN), dynami…
indi9o May 15, 2026
d446a1d
feat: morning-check — scope filter by router role
indi9o May 15, 2026
b87511c
feat: BGP session drop response protocol (T2) + prefix leak skill (T3)
indi9o May 15, 2026
d1b52ae
feat: VLAN provisioning skill (P2) — NetBox-first workflow
indi9o May 15, 2026
0acd4ee
fix: VLAN group tools — pisahkan status active/reserved/kosong
indi9o May 15, 2026
105610c
docs: update vlan-provisioning skill — reflect active/reserved/kosong…
indi9o May 15, 2026
8e52ba0
feat: dual NetBox support — idren + kampus instances
indi9o May 15, 2026
af13dab
feat: router-discovery skill + autonomous config.yaml management + sk…
indi9o May 15, 2026
fd65099
fix: check_reachability + check_ssh_access accept raw host IP for dis…
indi9o May 15, 2026
3253f25
fix: router-discovery Fase 3 — loop semua gate_idren, bukan hardcode UB
indi9o May 15, 2026
5cb8b70
feat: router-discovery — BGP reasoning + jejak penemuan lengkap di la…
indi9o May 15, 2026
727dbde
feat: supervisor orchestration — original_intent + intent continuation
indi9o May 15, 2026
5540243
fix: state memory — original_intent reset + stable thread_id + orphan…
indi9o May 15, 2026
5566b9d
feat: cross-session memory (memory.db) + WAL checkpoint fix
indi9o May 15, 2026
fe7761d
fix: populate_netbox_bgp tersedia di config_agent + routing hint supe…
indi9o May 15, 2026
09f2042
perf: tuning num_predict + num_ctx berdasarkan analisis metrics aktual
indi9o May 15, 2026
00ea9d1
fix: morning-check completeness + traffic tools + agent tuning
indi9o May 15, 2026
34d6435
feat: Phase 8 Textual TUI + netbox_agent graph + link-diagnostics fix
indi9o May 16, 2026
8646ba4
feat: copy/view chat log — ctrl+y, ctrl+b, ctrl+e (tui_textual)
indi9o May 16, 2026
4fbd8e1
fix: ctrl+y copy selection in LogViewModal (ctrl+c blocked by priorit…
indi9o May 16, 2026
e5b7ff3
fix: reliable clipboard + ctrl+e opens less instead of modal
indi9o May 16, 2026
eec805f
fix: suspend() sync not async in Textual 8.2.6
indi9o May 16, 2026
fe2db02
feat: markdown rendering for AI response in RichLog
indi9o May 16, 2026
f1cbb06
fix: run xsel in asyncio thread — prevent event loop block on ctrl+y/…
indi9o May 16, 2026
71ca60e
feat: global output formatting standard — emoji + markdown tables sem…
indi9o May 16, 2026
f10051d
fix: TopBar + StatusBar overflow dan clipping
indi9o May 16, 2026
af47e2a
fix: TopBar/StatusBar clipping — nest inside left-col vertical column
indi9o May 16, 2026
eb9c5dc
fix: btn-stop/btn-clear border crushed text + sb-hint clipping
indi9o May 16, 2026
7a10b0f
fix: prevent agent hallucination from example contamination
indi9o May 16, 2026
e2200ff
fix: remove LARANGAN KERAS from format template section
indi9o May 16, 2026
4232b15
fix: add explicit step transitions to prevent premature output
indi9o May 16, 2026
d217417
fix: ApprovalModal buttons not visible (border: tall + height: 1)
indi9o May 16, 2026
37cbbd7
feat: add containerlab commissioning workflow
indi9o May 16, 2026
84a700b
docs: add containerlab commissioning scenario documentation
indi9o May 16, 2026
f69ff31
feat: add educational narrative requirement to all agent outputs
indi9o May 16, 2026
8113bf0
fix: enforce backup-before-write in config_node + fix /add blocklist FP
indi9o May 16, 2026
33251c1
fix: prohibit passive action items (monitor/verifikasi/pertimbangkan)
indi9o May 16, 2026
e17f2da
refactor: extract global agent rules to skills/pedoman-agent.md
indi9o May 16, 2026
c61e488
fix: prevent hallucinated router names + N/A values in health check o…
indi9o May 16, 2026
5ee30d9
feat: validasi_agent (wati) + eval framework + 12 test scenarios
indi9o May 17, 2026
d64ddd9
Add MTU Mismatch Diagnostics Skill for Monitoring
indi9o May 18, 2026
fac78fa
feat: Enhance netbox_agent and related skills for improved synchroniz…
indi9o May 19, 2026
712bc25
feat: agent enable/disable via frontmatter + NONAKTIF kanban column
indi9o May 19, 2026
59c0acf
update
Jun 29, 2026
1185527
update
Jun 29, 2026
057f71d
update
Aug 7, 2026
15a95d2
update
Aug 7, 2026
ce15e0d
fixing the console log of agent activity
Aug 8, 2026
3e40e2e
modifikasi beberapa utility
Aug 8, 2026
7ffda9f
Add browser-based agent/skill config editor with grouped nav
Aug 12, 2026
80910f0
update ui for agents and llm
Aug 14, 2026
87ebcec
backend update
Aug 14, 2026
04ced5d
clean config
Aug 14, 2026
04abc71
Remove DHCP and NetBox menu from frontend
Aug 14, 2026
1c36a32
Move agent definitions from files to DB-backed storage
Aug 14, 2026
bdd8d13
Add node type field; list available LLM models from Settings
Aug 14, 2026
7a63707
update fitur
Aug 14, 2026
557fd43
update
Aug 14, 2026
b0ed2fe
update
Aug 14, 2026
0ff6f41
update nodes
Aug 17, 2026
bc2346f
Turn NetOpsUI into a UI + manager service for NetOps Agent and Hermes
Sep 24, 2026
8ce18d3
Add LLM provider management and nodes screen
Sep 24, 2026
9d5d8ae
Add login/auth, dashboard rework, server-side NetOps chat runs, and s…
rizalespe Sep 24, 2026
2f10dac
Use PATCH for node update and validate credential pair in nodes form
rizalespe Sep 24, 2026
b571cbf
Summarize tool activity, and allow switching threads while a run is i…
rizalespe Sep 24, 2026
bed7817
README: real clone URL, logo, and login/dashboard screenshots
rizalespe Sep 24, 2026
22056ec
README: larger logo and revised wording to match current features
rizalespe Sep 24, 2026
1d38005
Set executable permissions for app files
indi9o Nov 4, 2026
f345bdf
Set permissions for Nginx HTML and template files
indi9o Nov 4, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .dockerignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
.git
.env
data/
docs/
**/__pycache__
**/*.pyc
33 changes: 31 additions & 2 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,2 +1,31 @@
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=gemma4:e4b
# Copy to .env and adjust (read by docker compose; .env is gitignored).

# Port the UI listens on.
UI_PORT=3000

# NetOps Agent REST API (repo: palapa-agent). Start it on a free port, e.g.:
# PALAPA_CONFIG_PATH=~/.palapa/config.yaml uv run uvicorn palapa.gateway.api:app --host 127.0.0.1 --port 8100
# (port 8000 on this host is taken by the mikrotik-mcp container)
NETOPS_AGENT_URL=http://127.0.0.1:8100

# Hermes gateway `api_server` platform (default port 8642).
# The Hermes API key is NOT set here: enter it in Settings > Backend. It is stored
# in the manager's database, never in an environment variable.
HERMES_URL=http://127.0.0.1:8642

# Where the manager keeps its database and SOUL.md backups. Default: ./data
# (committed with a .gitkeep so it is owned by you, not root). Point it elsewhere
# for a separate instance, e.g. when testing.
# DATA_DIR=./data

# Manager service port (loopback only, reached through the UI's /api/).
MANAGER_PORT=8200

# Home directories of the two backends (absolute paths).
NETOPS_AGENT_HOME=/home/llmnetops/.palapa
HERMES_HOME=/home/llmnetops/.hermes

# Container user for the manager, so files it writes into the backends' skill
# folders stay owned by you. Get yours with: id -u / id -g
HOST_UID=1006
HOST_GID=1006
28 changes: 10 additions & 18 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,22 +1,14 @@
# Abaikan file sensitif dan generated
config.yaml
# Environment (holds the Hermes API key)
.env
output/
.venv/
__pycache__/
*.pyc

# Data DHCP lease (berisi MAC address & IP perangkat nyata)
*.txt
laporan/

# Log files
# Generated / local
output/
*.log
schedule.log

# Config backups (berisi konfigurasi router lengkap)
backups/
!backups/.gitkeep
.scratch/
node_modules/

# SQLite checkpoints (berisi riwayat percakapan)
data/
# Manager service database and SOUL.md backups
data/*
!data/.gitkeep
__pycache__/
*.pyc
243 changes: 44 additions & 199 deletions CLAUDE.md

Large diffs are not rendered by default.

38 changes: 21 additions & 17 deletions CONTEXT.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,30 @@
# CONTEXT.md — llmnetops
# CONTEXT.md — NetOpsUI

Platform operasional jaringan kampus berbasis LangGraph multi-agent.
Web console untuk operasional jaringan berbasis agent AI. Agent berjalan di backend terpisah; NetOpsUI menyediakan UI dan pengelolaan skill/profil agent.

## Domain Language

| Istilah | Definisi |
|---------|----------|
| Agent | Specialist LLM node di LangGraph graph (monitor, diagnose, config, security, document) |
| Skill | Prosedur kerja dalam Markdown; dibaca agent saat handle query relevan |
| Tool | Atomic `@tool` function yang SSH ke router MikroTik |
| Supervisor | Orchestrator agent yang route query ke specialist yang tepat |
| Approval | Interrupt mechanism — operator harus confirm sebelum write command dieksekusi |

## Entitas Utama

- **Router** — MikroTik RouterOS v6/v7, diakses via SSH dari `config.yaml`
- **Operator** — manusia yang approve/tolak write commands di TUI
- **Agent Log** — append-only list events yang dikonsumsi TUI (`agent_log` di state)
| Backend | Layanan agent yang dipanggil UI lewat API: **NetOps Agent** (repo saat ini masih bernama palapa-agent) atau **Hermes**. Tepat satu yang aktif. |
| Adapter | Modul di `frontend/js/backends/` yang menerjemahkan API satu backend ke kontrak bersama UI |
| Manager | Service milik NetOpsUI (`server/`, FastAPI + SQLite) untuk skill, profil agent, dan view config yang tidak punya API di backend |
| Thread | Satu percakapan chat. Di NetOps Agent disimpan di browser; di Hermes berupa *session* di server. |
| Run / Giliran | Satu pesan operator beserta seluruh kerja agent sampai jawaban selesai |
| Tool activity | Tool call yang dijalankan agent selama satu giliran (panel kanan AI Chat) |
| Approval | Izin operator sebelum agent menjalankan command berisiko (hanya Hermes: `approval.request`) |
| Skill | Prosedur kerja agent berbentuk `SKILL.md`. Library-nya ada di DB NetOpsUI; *Publish* menyalinnya ke folder skill backend |
| Publish | Menulis `SKILL.md` dari library ke folder skill sebuah backend. Status: Draft / Tersinkron / Perlu publish / Diubah di backend |
| Profil agent | Prompt bernama di DB NetOpsUI. Hermes: dikirim per run sebagai `instructions`. NetOps Agent: diterapkan ke `SOUL.md` |
| SOUL.md | File persona agent (dibaca backend). NetOpsUI hanya menulisnya lewat aksi "Terapkan ke SOUL.md" pada NetOps Agent |
| Provider LLM | Profil endpoint OpenAI-compatible (Base URL, model, API key write-only) di DB NetOpsUI. *Terapkan* menulis blok `model:` di config.yaml backend; backend perlu di-restart oleh operator |
| Belum tersedia | Screen yang datanya belum punya API (`NAV_ITEMS[].unavailable`): Nodes, Backups, Metrics |

## Invariant Sistem

- Agent tidak boleh eksekusi write command tanpa approval operator
- `tui.py` tidak boleh punya LLM logic — hanya consume `agent.py` public API
- Safety net AIMessage dan loop guard di `agents/nodes.py` tidak boleh dihapus
- `TOOL_MAP` di `agents/tools.py` adalah source of truth untuk tool availability per agent
- UI tidak memuat logika agent/LLM dan tidak pernah memanggil router secara langsung.
- Screen hanya berkomunikasi dengan backend melalui `activeBackend()`; tidak ada `fetch` langsung ke backend dari screen.
- Credential (API key Hermes, key provider LLM) hanya disimpan di database manager, tidak pernah di environment/`.env` dan tidak pernah di browser; API hanya mengembalikan status `has_key`. Satu-satunya tempat lain key provider berada adalah config backend setelah operator menekan *Terapkan*. Manager tidak pernah mengembalikan nilai `.env`, dan `config.yaml` selalu dimasking.
- Thread milik satu backend; mengganti backend aktif memuat ulang daftar thread dari backend itu.
- Manager hanya menulis ke `skills/` kedua backend, `SOUL.md` NetOps Agent, dan blok `model:` di `config.yaml` kedua backend (dengan backup dan verifikasi); sisanya read-only. Publish tidak menimpa file yang bukan hasil publish NetOpsUI tanpa konfirmasi.
- Repo NetOpsUI tidak mengubah repo palapa-agent maupun home backend di luar dua jalur tulis di atas.
Loading