From 4a50a560b6701eabb2f456553a619e0e9d5e5dc7 Mon Sep 17 00:00:00 2001 From: indi90 Date: Wed, 13 May 2026 23:32:43 +0700 Subject: [PATCH 01/74] feat: add web server + NOC console frontend (Track B) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - server.py: FastAPI app exposing agent.py via SSE streaming endpoints (/chat, /approve, /metrics, /session/new) with async wrapper for sync generators using run_in_executor + call_soon_threadsafe - frontend/index.html: replace cyber/neon mock UI with NOC console design (IBM Plex Mono, dark surfaces, React via CDN); real SSE connection to backend replaces all mock setTimeout logic - frontend/fonts/: IBM Plex Mono/Sans/Condensed woff2 files (local, no external CDN) - frontend/assets/: logo.svg, glyph.svg - requirements.txt: add fastapi>=0.115, uvicorn[standard]>=0.32 Run: python server.py → open http://localhost:8000 Co-Authored-By: Claude Sonnet 4.6 --- frontend/assets/glyph.svg | 12 + frontend/assets/logo.svg | 9 + frontend/fonts/IBMPlexMono-Medium.woff2 | Bin 0 -> 14988 bytes frontend/fonts/IBMPlexMono-Regular.woff2 | Bin 0 -> 14812 bytes frontend/fonts/IBMPlexMono-SemiBold.woff2 | Bin 0 -> 15704 bytes frontend/fonts/IBMPlexSans-Medium.woff2 | Bin 0 -> 20064 bytes frontend/fonts/IBMPlexSans-Regular.woff2 | Bin 0 -> 19156 bytes .../fonts/IBMPlexSansCondensed-Medium.woff2 | Bin 0 -> 20004 bytes .../fonts/IBMPlexSansCondensed-SemiBold.woff2 | Bin 0 -> 19944 bytes frontend/index.html | 1785 ++++++----------- requirements.txt | 4 + server.py | 140 ++ 12 files changed, 775 insertions(+), 1175 deletions(-) create mode 100644 frontend/assets/glyph.svg create mode 100644 frontend/assets/logo.svg create mode 100644 frontend/fonts/IBMPlexMono-Medium.woff2 create mode 100644 frontend/fonts/IBMPlexMono-Regular.woff2 create mode 100644 frontend/fonts/IBMPlexMono-SemiBold.woff2 create mode 100644 frontend/fonts/IBMPlexSans-Medium.woff2 create mode 100644 frontend/fonts/IBMPlexSans-Regular.woff2 create mode 100644 frontend/fonts/IBMPlexSansCondensed-Medium.woff2 create mode 100644 frontend/fonts/IBMPlexSansCondensed-SemiBold.woff2 create mode 100644 server.py diff --git a/frontend/assets/glyph.svg b/frontend/assets/glyph.svg new file mode 100644 index 0000000..0e55aa3 --- /dev/null +++ b/frontend/assets/glyph.svg @@ -0,0 +1,12 @@ + + + + [ + N + A + ] + + + + + \ No newline at end of file diff --git a/frontend/assets/logo.svg b/frontend/assets/logo.svg new file mode 100644 index 0000000..9e7e036 --- /dev/null +++ b/frontend/assets/logo.svg @@ -0,0 +1,9 @@ + + + [ + NetOps + · + AI + ] + + \ No newline at end of file diff --git a/frontend/fonts/IBMPlexMono-Medium.woff2 b/frontend/fonts/IBMPlexMono-Medium.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..99c261038d1394955e815031abc536f4c298c119 GIT binary patch literal 14988 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

75CNIK|LQ=k&v}yD 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 Wm+jZ3c#rX>OWE+pg-nQ{F3fEmM~x%^ literal 0 HcmV?d00001 diff --git a/frontend/fonts/IBMPlexMono-Regular.woff2 b/frontend/fonts/IBMPlexMono-Regular.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..a6c77d653d2e5a0692433d058a8dd2238b94aaec GIT binary patch literal 14812 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 H(dOW7VZMUH literal 0 HcmV?d00001 diff --git a/frontend/fonts/IBMPlexSans-Regular.woff2 b/frontend/fonts/IBMPlexSans-Regular.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..93bcd6430c8ac016e88aa259017395fef162b673 GIT binary patch literal 19156 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 literal 0 HcmV?d00001 diff --git a/frontend/fonts/IBMPlexSansCondensed-SemiBold.woff2 b/frontend/fonts/IBMPlexSansCondensed-SemiBold.woff2 new file mode 100644 index 0000000000000000000000000000000000000000..e8b6d8f1d7152670b6c60659e690ec968b256278 GIT binary patch literal 19944 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 literal 0 HcmV?d00001 diff --git a/frontend/index.html b/frontend/index.html index 8d44d0a..16c3cd0 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -1,1231 +1,666 @@ - + - + -NetOps AI — Campus Network Operations - - +NetOps AI · Web Dashboard + + + -

- - -
- -
-
Campus Network Operations
-
-
-
-
- IDLE -
-
-
--:--:--
-
-
- - -
- - -
-
- - - - - SYSTEM ONLINE -
diff --git a/frontend/js/state.js b/frontend/js/state.js index 676d928..ae78e76 100644 --- a/frontend/js/state.js +++ b/frontend/js/state.js @@ -12,6 +12,7 @@ export const S = { threads: [], messages: [], chatState: 'idle', + stopRequested: false, // true after operator clicks Stop, until run actually ends pendingApproval: null, activeQuery: '', agents: makeAgentStates(), diff --git a/frontend/js/utils.js b/frontend/js/utils.js index 0cdc263..52bfc83 100644 --- a/frontend/js/utils.js +++ b/frontend/js/utils.js @@ -112,12 +112,12 @@ export function agentCardHtml(alias, role, state, detail) { } export function cardHtml(title, body, headerRight) { - return `
-
+ return `
+

${title}

${headerRight || ''}
-
${body}
+
${body}
`; } diff --git a/server.py b/server.py index a7f83f4..9e69f15 100644 --- a/server.py +++ b/server.py @@ -12,7 +12,9 @@ import asyncio import json import logging +import threading import uuid +from datetime import datetime, timezone from pathlib import Path from typing import Any, AsyncGenerator, Iterator @@ -59,6 +61,37 @@ def increase_indent(self, flow=False, indentless=False): # ── Session store ───────────────────────────────────────────────────────────── _sessions: dict[str, tuple[Any, Any]] = {} +# One cancel flag per thread_id, live only while that thread has a run in +# flight — set by /chat/stop, checked by agent.py between graph steps. +_cancel_events: dict[str, threading.Event] = {} + +# Last known reachability per router — populated only by explicit checks +# (Nodes page load/refresh, or the dashboard's own refresh button), never by +# a background timer. The dashboard reads this cache as-is instead of pinging +# on every page load, since a sequential ping sweep over many routers can take +# tens of seconds (see check_reachability: 5s timeout per host). +_reachability_cache: dict[str, dict] = {} + + +def _parse_reachability(text: str) -> bool | None: + """True=reachable, False=down, None=inconclusive. Mirrors the frontend's + parseReachability() heuristic in nodes.js so cache and live table agree.""" + if not text: + return None + import re + if re.search(r"unreachable|gagal|error", text, re.I): + return False + if re.search(r"reachable", text, re.I): + return True + return None + + +def _update_reachability_cache(router_name: str, result_text: str) -> None: + _reachability_cache[router_name] = { + "reachable": _parse_reachability(result_text), + "checked_at": datetime.now(timezone.utc).isoformat(timespec="seconds"), + } + def _get_or_create_session(thread_id: str) -> tuple[Any, Any]: if thread_id not in _sessions: @@ -70,7 +103,7 @@ def _get_or_create_session(thread_id: str) -> tuple[Any, Any]: # ── Async streaming helper ──────────────────────────────────────────────────── -async def _stream_events(gen: Iterator[tuple[str, str]]) -> AsyncGenerator[str, None]: +async def _stream_events(gen: Iterator[tuple[str, str]], thread_id: str | None = None) -> AsyncGenerator[str, None]: """Wrap sync generator → async SSE lines with heartbeat. Runs the blocking generator in a thread pool and forwards events via an @@ -117,6 +150,8 @@ def _produce() -> None: yield f"data: {payload}\n\n" finally: get_task.cancel() + if thread_id is not None: + _cancel_events.pop(thread_id, None) await future @@ -132,15 +167,21 @@ class ApproveRequest(BaseModel): decision: str # "approved" | "rejected" +class StopRequest(BaseModel): + thread_id: str + + # ── API endpoints ───────────────────────────────────────────────────────────── @app.post("/chat") async def chat(req: ChatRequest) -> StreamingResponse: graph, config = _get_or_create_session(req.thread_id) db_touch_thread(req.thread_id, req.message[:120]) - gen = _agent.stream_agent_response(graph, config, req.message) + cancel_event = threading.Event() + _cancel_events[req.thread_id] = cancel_event + gen = _agent.stream_agent_response(graph, config, req.message, cancel_event=cancel_event) return StreamingResponse( - _stream_events(gen), + _stream_events(gen, thread_id=req.thread_id), media_type="text/event-stream", headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"}, ) @@ -152,14 +193,26 @@ async def approve(req: ApproveRequest) -> StreamingResponse: raise HTTPException(status_code=404, detail="Session tidak ditemukan") graph, config = _sessions[req.thread_id] db_touch_thread(req.thread_id) - gen = _agent.resume_after_approval(graph, config, req.decision) + cancel_event = threading.Event() + _cancel_events[req.thread_id] = cancel_event + gen = _agent.resume_after_approval(graph, config, req.decision, cancel_event=cancel_event) return StreamingResponse( - _stream_events(gen), + _stream_events(gen, thread_id=req.thread_id), media_type="text/event-stream", headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"}, ) +@app.post("/chat/stop") +def chat_stop(req: StopRequest) -> dict: + """Signal the in-flight run for this thread to stop at the next graph step.""" + event = _cancel_events.get(req.thread_id) + if event is None: + return {"ok": False, "reason": "no_active_run"} + event.set() + return {"ok": True} + + @app.get("/info") def info() -> dict: import os @@ -174,6 +227,62 @@ def metrics(n: int = 100) -> list[dict]: return _agent.get_token_metrics(n) +@app.get("/api/metrics") +def api_metrics(n: int = 500) -> dict: + """Aggregate token usage (data/metrics.jsonl) and tool-call frequency + (per-thread agent_log) for the Metrics page and dashboard. + + Bounded to the last `n` metrics.jsonl entries and the 50 most recently + updated threads so this stays cheap regardless of how much history has + piled up — each thread costs one checkpoint read, not a full table scan. + """ + from agents.nodes import AGENT_ALIAS # noqa: PLC0415 + alias_to_agent = {alias: name for name, alias in AGENT_ALIAS.items()} + + agents: dict[str, dict] = {} + + def _agent_bucket(key: str) -> dict: + return agents.setdefault(key, {"input_tokens": 0, "output_tokens": 0, "tool_calls": 0}) + + total_input = 0 + total_output = 0 + for entry in _agent.get_token_metrics(n): + d = _agent_bucket(entry.get("agent", "unknown")) + d["input_tokens"] += entry.get("prompt_tokens", 0) + d["output_tokens"] += entry.get("gen_tokens", 0) + total_input += entry.get("prompt_tokens", 0) + total_output += entry.get("gen_tokens", 0) + + tool_frequency: dict[str, int] = {} + total_tool_calls = 0 + threads = db_list_threads(limit=50) + for t in threads: + try: + graph, config = _get_or_create_session(t["thread_id"]) + state = graph.get_state(config) + agent_log = state.values.get("agent_log", []) if state and state.values else [] + except Exception: + continue + for log_entry in agent_log: + if log_entry.get("event_type") != "tool_call": + continue + total_tool_calls += 1 + tool_name = log_entry.get("content", "").split("(")[0] + tool_frequency[tool_name] = tool_frequency.get(tool_name, 0) + 1 + agent_key = alias_to_agent.get(log_entry.get("source", ""), log_entry.get("source", "unknown")) + _agent_bucket(agent_key)["tool_calls"] += 1 + + return { + "metrics": { + "total_tokens": total_input + total_output, + "total_tool_calls": total_tool_calls, + "total_sessions": len(threads), + "agents": agents, + "tool_frequency": tool_frequency, + } + } + + @app.post("/session/new") def new_session() -> dict: thread_id = str(uuid.uuid4()) @@ -257,6 +366,193 @@ def api_status() -> dict: return _agent.get_agent_status() +_WRITE_TOOLS = ("run_command_write", "backup_router_config") +_BACKUP_STALE_DAYS = 7 + + +def _llm_health_summary(n: int = 200) -> dict: + """Context-utilization health from data/metrics.jsonl — a static model + name says nothing about whether agents are running out of context and + getting truncated mid-response, so the dashboard needs this instead. + + Some Ollama-compatible gateways don't populate prompt_eval_count/ + eval_count in generation_info, leaving every entry at 0 with + done_reason="unknown" — that's "no telemetry", not "0% usage", so it's + reported as its own state rather than silently showing a misleading 0%. + """ + entries = _agent.get_token_metrics(n) + if not entries: + return {"sample_size": 0, "telemetry_available": False, "avg_ctx_util": None, "truncated_count": 0} + telemetry_available = sum(e.get("prompt_tokens", 0) for e in entries) > 0 + truncated_count = sum(1 for e in entries if e.get("done_reason") == "length") + avg_ctx_util = round(sum(e.get("ctx_util", 0) for e in entries) / len(entries), 1) if telemetry_available else None + return { + "sample_size": len(entries), + "telemetry_available": telemetry_available, + "avg_ctx_util": avg_ctx_util, + "truncated_count": truncated_count, + } + + +def _scan_backups(router_names: list[str]) -> dict: + """Per-router backup age from backups//*.rsc mtimes — cheap + filesystem stat, no SSH involved.""" + from tools.config_backup import BACKUP_DIR + now = datetime.now(timezone.utc) + recent, stale, never = [], [], [] + for name in router_names: + router_dir = BACKUP_DIR / name + files = sorted(router_dir.glob("*.rsc"), key=lambda p: p.stat().st_mtime, reverse=True) if router_dir.exists() else [] + if not files: + never.append(name) + continue + f = files[0] + mtime = datetime.fromtimestamp(f.stat().st_mtime, tz=timezone.utc) + age_days = round((now - mtime).total_seconds() / 86400, 1) + recent.append({"router": name, "filename": f.name, "mtime": mtime.isoformat(timespec="seconds"), "age_days": age_days}) + if age_days > _BACKUP_STALE_DAYS: + stale.append({"router": name, "age_days": age_days}) + recent.sort(key=lambda x: x["mtime"], reverse=True) + return {"recent": recent[:5], "stale": stale, "never_backed_up": never, "stale_threshold_days": _BACKUP_STALE_DAYS} + + +def _scan_reports() -> list[dict]: + from tools.base import LAPORAN_DIR + if not LAPORAN_DIR.exists(): + return [] + files = sorted(LAPORAN_DIR.glob("*.md"), key=lambda p: p.stat().st_mtime, reverse=True) + return [ + { + "filename": f.name, + "mtime": datetime.fromtimestamp(f.stat().st_mtime, tz=timezone.utc).isoformat(timespec="seconds"), + "size_kb": round(f.stat().st_size / 1024, 1), + } + for f in files[:5] + ] + + +def _scan_recent_writes(threads: list[dict], limit: int = 8) -> list[dict]: + """Approval-gated actions (backup_router_config / run_command_write) across + recently-updated threads, paired with their outcome (the tool_result entry + logged immediately after each tool_call in agent_log). + + agent_log timestamps are HH:MM:SS only (see _now_str() in agents/nodes.py) + — no date — so they can't be sorted correctly across threads that span + multiple days. Instead this relies on `threads` already being ordered + newest-updated-first (full-precision, from the threads table): events from + a thread are emitted newest-within-thread-first, and threads are visited + in that trusted order, stopping once enough events are collected. + """ + events = [] + for t in threads: + try: + graph, config = _get_or_create_session(t["thread_id"]) + state = graph.get_state(config) + agent_log = state.values.get("agent_log", []) if state and state.values else [] + except Exception: + continue + thread_events = [] + for i, entry in enumerate(agent_log): + if entry.get("event_type") != "tool_call": + continue + content = entry.get("content", "") + if content.split("(")[0] not in _WRITE_TOOLS: + continue + outcome = "unknown" + if i + 1 < len(agent_log) and agent_log[i + 1].get("event_type") == "tool_result": + nc = agent_log[i + 1].get("content", "") + if "dibatalkan" in nc.lower() or "ditolak" in nc.lower(): + outcome = "rejected" + elif nc.lower().startswith("error"): + outcome = "error" + else: + outcome = "executed" + thread_events.append({ + "thread_id": t["thread_id"], + "thread_title": t["title"], + "agent": entry.get("source"), + "action": content, + "outcome": outcome, + "time": entry.get("timestamp"), + }) + events.extend(reversed(thread_events)) + if len(events) >= limit: + break + return events[:limit] + + +@app.get("/api/dashboard") +def api_dashboard() -> dict: + """Single aggregate call for the Dashboard screen — system readiness, + actionable items, and recent activity. No live network probes (LLM ping, + router reachability) run here; those stay operator-triggered elsewhere + and this endpoint only reads their last cached/persisted result.""" + from tools.base import get_unique_router_entries + from tools.db import db_list_agents + from agent import _skill_lib + + status = _agent.get_agent_status() + + agent_rows = db_list_agents() + agents_summary = {"total": len(agent_rows), "enabled": sum(1 for a in agent_rows if a["enabled"])} + + all_skills = [s.summary() for s in _skill_lib.list_all()] + pending_names = [f.stem for f in PENDING_DIR.rglob("*.md")] if PENDING_DIR.exists() else [] + skills_summary = { + "total": len(all_skills), + "enabled": sum(1 for s in all_skills if s.get("enabled")), + "pending": len(pending_names), + } + + router_entries = get_unique_router_entries() + nodes, reachable, down, unknown, last_checked = [], 0, 0, 0, None + for e in router_entries: + c = _reachability_cache.get(e["name"]) + if c: + status_str = "reachable" if c["reachable"] is True else "down" if c["reachable"] is False else "unknown" + if last_checked is None or c["checked_at"] > last_checked: + last_checked = c["checked_at"] + else: + status_str = "unknown" + if status_str == "reachable": + reachable += 1 + elif status_str == "down": + down += 1 + else: + unknown += 1 + nodes.append({ + "name": e["name"], "host": e.get("host", ""), + "status": status_str, "checked_at": c["checked_at"] if c else None, + }) + + backups = _scan_backups([e["name"] for e in router_entries]) + reports = _scan_reports() + threads = db_list_threads(limit=20) + recent_writes = _scan_recent_writes(threads) + + return { + "llm": { + "model": status.get("model"), + "ollama_url": status.get("ollama_url"), + "health": _llm_health_summary(), + }, + "agents": agents_summary, + "skills": skills_summary, + "skills_pending_list": pending_names, + "nodes": { + "total": len(router_entries), "reachable": reachable, "down": down, + "unknown": unknown, "last_checked": last_checked, "list": nodes, + }, + "backups": backups, + "reports": reports, + "threads_recent": [ + {"thread_id": t["thread_id"], "title": t["title"], "last_message": t["last_message"], "updated_at": t["updated_at"]} + for t in threads[:5] + ], + "recent_writes": recent_writes, + } + + class ResetRequest(BaseModel): thread_id: str @@ -315,7 +611,9 @@ def api_routers(): @app.post("/api/tools/reachability") def api_reachability(req: RouterRequest): - return {"result": TOOL_MAP["check_reachability"].invoke({"router_name": req.router_name})} + result = TOOL_MAP["check_reachability"].invoke({"router_name": req.router_name}) + _update_reachability_cache(req.router_name, result) + return {"result": result} @app.post("/api/tools/reachability/all") @@ -326,6 +624,7 @@ def api_reachability_all(): try: r = TOOL_MAP["check_reachability"].invoke({"router_name": entry["name"]}) results[entry["name"]] = r + _update_reachability_cache(entry["name"], r) except Exception as e: results[entry["name"]] = f"Error: {e}" return {"results": results} From 0ff6f4136b8f25aac25cb727e9548379d34785c5 Mon Sep 17 00:00:00 2001 From: Rizal SP Date: Sun, 16 Aug 2026 20:37:25 -0700 Subject: [PATCH 65/74] update nodes --- agents/nodes.py | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/agents/nodes.py b/agents/nodes.py index 79c493b..11c9808 100644 --- a/agents/nodes.py +++ b/agents/nodes.py @@ -180,6 +180,39 @@ def _last_specialist_from_log(state: dict, valid_agent_names: set[str]) -> str | return None +# Some Ollama/model combos (observed with qwen3.6 on the OpenAI-compat endpoint) +# don't populate the structured tool_calls field and instead leak the tool call +# as literal text, e.g.: +# ... +# Recover the intended call from that text so the ReAct loop can still execute it. +_LEAKED_TOOL_CALL_RE = re.compile( + r"\s*[\w\-]+)>(?P.*?)\s*", + re.DOTALL, +) +_LEAKED_PARAM_RE = re.compile( + r"[\w\-]+)>\s*(?P.*?)\s*", + re.DOTALL, +) + + +def _recover_leaked_tool_calls(response: AIMessage) -> None: + """If response has no structured tool_calls but its content contains a + leaked block, parse it and patch response.tool_calls/content + in place so callers can treat it exactly like a native tool call.""" + if getattr(response, "tool_calls", None): + return + text = response.content or "" + matches = list(_LEAKED_TOOL_CALL_RE.finditer(text)) + if not matches: + return + calls = [] + for i, m in enumerate(matches): + args = dict(_LEAKED_PARAM_RE.findall(m.group("body"))) + calls.append({"name": m.group("name"), "args": args, "id": f"leaked_{i}"}) + response.tool_calls = calls + response.content = _LEAKED_TOOL_CALL_RE.sub("", text).strip() + + def _react_loop( llm_with_tools: Any, messages: list, @@ -201,6 +234,7 @@ def _emit(event_type: str, content: str) -> None: for _ in range(max_iters): response = llm_with_tools.invoke(messages) + _recover_leaked_tool_calls(response) messages = messages + [response] if not getattr(response, "tool_calls", None): @@ -975,6 +1009,7 @@ def _auto_backup(router: str) -> bool: for _ in range(12): response = _CONFIG_LLM.invoke(messages) + _recover_leaked_tool_calls(response) messages = messages + [response] if not getattr(response, "tool_calls", None): From bc2346f1a8053cc06e647d2255aeb4249110a04c Mon Sep 17 00:00:00 2001 From: Rizal SP Date: Thu, 24 Sep 2026 06:31:28 +0000 Subject: [PATCH 66/74] Turn NetOpsUI into a UI + manager service for NetOps Agent and Hermes NetOpsUI no longer contains the LangGraph agent, the SSH tools or the TUI. Agents now run in two external backends, one active at a time, chosen in Settings: NetOps Agent (palapa-agent REST API) and Hermes (gateway api_server). What those backends have no API for is handled by a small manager service that ships with this repo. Removed: agent.py, agents/, tools/, skills/, server.py, tui*.py, tests/, legacy/, requirements.txt and the screens that only existed for the old backend (nodes, reports, backups, metrics, agent roster). Frontend - backends/: one adapter per backend behind a shared contract. Events are normalised (delta, tool_start/end, approval, ...). Hermes uses /v1/runs + /events because only runs support approval and stop. - Chat: tool-activity panel replaces the agent roster; generic approval dialog with the choices Hermes offers; per-backend threads. - Skills, Agents (prompt profiles) and Settings > File Konfigurasi are backed by the manager. Nodes, Reports, Backups, Metrics show "Belum tersedia" until a backend exposes an API for them. - Backend is displayed as "NetOps Agent"; legacy localStorage keys and the old 'palapa' backend id are migrated. Manager (server/, FastAPI + SQLite) - Skill library with publish/unpublish to each backend's skills folder, drift status, and refusal to overwrite files it did not publish. - Agent profiles; apply to NetOps Agent's SOUL.md (previous one backed up). - Read-only config views: config.yaml with secrets masked, .env as variable names only. Slug validation and path-traversal checks. Deployment - docker-compose.yml (frontend nginx + manager, host network) and a dev override for hot reload; env-driven nginx proxy that injects the Hermes API key and strips Origin. Manager mounts only skills/ and NetOps Agent's SOUL.md as writable; DATA_DIR is configurable. - README rewritten with run/deploy, operations and troubleshooting. Co-Authored-By: Claude Sonnet 5 --- .dockerignore | 7 + .env.example | 32 + .gitignore | 27 +- CLAUDE.md | 245 +-- CONTEXT.md | 42 +- README.md | 407 ++-- agent.py | 400 ---- agents/__init__.py | 3 - agents/definitions/config_agent.md | 111 - agents/definitions/diagnose_agent.md | 92 - agents/definitions/document_agent.md | 260 --- agents/definitions/monitor_agent.md | 96 - agents/definitions/netbox_agent.md | 142 -- agents/definitions/security_agent.md | 81 - agents/definitions/supervisor.md | 152 -- agents/definitions/validasi_agent.md | 69 - agents/graph.py | 50 - agents/loader.py | 167 -- agents/metrics.py | 57 - agents/nodes.py | 1103 ---------- agents/tools.py | 69 - tests/__init__.py => data/.gitkeep | 0 docker-compose.dev.yml | 12 + docker-compose.yml | 50 + frontend/Dockerfile | 19 +- frontend/Dockerfile.backend | 15 - frontend/docker-compose.yml | 43 - frontend/js/api.js | 88 - frontend/js/app.js | 40 +- frontend/js/backends/common.js | 88 + frontend/js/backends/hermes.js | 172 ++ frontend/js/backends/index.js | 48 + frontend/js/backends/netops.js | 152 ++ frontend/js/components.js | 77 - frontend/js/config.js | 27 +- frontend/js/manager.js | 36 + frontend/js/screens/agents.js | 453 +--- frontend/js/screens/backups.js | 1 - frontend/js/screens/chat.js | 365 ++-- frontend/js/screens/dashboard.js | 268 +-- frontend/js/screens/metrics.js | 95 - frontend/js/screens/nodes.js | 426 ---- frontend/js/screens/reports.js | 91 - frontend/js/screens/settings.js | 428 +--- frontend/js/screens/skills.js | 710 ++---- frontend/js/screens/unavailable.js | 21 + frontend/js/shell.js | 31 +- frontend/js/state.js | 14 +- frontend/js/store.js | 44 - frontend/js/tag-input.js | 118 - frontend/js/utils.js | 57 - frontend/nginx.conf | 41 - frontend/nginx.conf.template | 59 + legacy/generate_reports.py | 1028 --------- legacy/mikrotik_agent.py | 757 ------- legacy/schedule_utbk.sh | 136 -- legacy/test_regex.py | 9 - requirements.txt | 24 - server.py | 1285 ----------- server/Dockerfile | 18 + server/backends.py | 201 ++ server/db.py | 67 + server/main.py | 294 +++ server/requirements.txt | 3 + skills/__init__.py | 3 - skills/config/commissioning.md | 127 -- skills/config/config-backup.md | 144 -- skills/config/config-change.md | 176 -- skills/config/netbox-bgp-sync.md | 146 -- skills/config/netbox-sync.md | 234 -- skills/config/router-discovery.md | 221 -- skills/config/router-to-netbox-sync.md | 194 -- skills/config/vlan-provisioning.md | 263 --- skills/dhcp/dhcp-client-diagnostics.md | 96 - skills/dhcp/dhcp-pool-audit.md | 93 - skills/dhcp/static-lease-management.md | 181 -- skills/dhcp/utbk-session-monitoring.md | 79 - skills/documents/document-writing.md | 104 - skills/documents/skill-authoring.md | 229 -- skills/documents/templates/network-status.md | 49 - .../documents/templates/routing-bgp-ospf.md | 159 -- .../templates/security-assessment.md | 269 --- skills/library.py | 204 -- skills/maintenance/router-maintenance.md | 182 -- skills/monitoring/action-validation.md | 174 -- skills/monitoring/capacity-planning.md | 190 -- skills/monitoring/link-diagnostics.md | 202 -- skills/monitoring/morning-check.md | 315 --- skills/monitoring/mtu-mismatch-diagnostics.md | 173 -- skills/monitoring/netbox-read.md | 101 - skills/monitoring/network-health-check.md | 182 -- skills/monitoring/network-reachability.md | 97 - skills/monitoring/network-status-report.md | 171 -- skills/monitoring/network-traffic-analysis.md | 99 - skills/pedoman-agent.md | 86 - skills/routing/bgp-diagnostics.md | 293 --- skills/routing/bgp-prefix-leak.md | 189 -- skills/routing/ospf-diagnostics.md | 179 -- skills/routing/static-route-management.md | 179 -- skills/security/brute-force-response.md | 190 -- skills/security/firewall-management.md | 198 -- skills/security/security-audit.md | 165 -- test_load.py | 51 - tests/eval.py | 410 ---- tests/mocks/__init__.py | 0 tests/mocks/fixtures.py | 810 ------- tests/review.py | 254 --- tests/scenarios/bgp-ospf-report.yaml | 41 - tests/scenarios/brute-force-detect.yaml | 38 - tests/scenarios/config-direct.yaml | 24 - tests/scenarios/dhcp-exhaustion.yaml | 37 - tests/scenarios/greeting.yaml | 20 - tests/scenarios/health-check.yaml | 34 - tests/scenarios/interface-flapping.yaml | 46 - tests/scenarios/netbox-bgp-drift.yaml | 38 - tests/scenarios/netbox-drift.yaml | 40 - .../netbox-populate-from-router.yaml | 39 - tests/scenarios/netbox-read.yaml | 35 - tests/scenarios/netbox-vlan-provisioning.yaml | 44 - tests/scenarios/scope-idren.yaml | 30 - tests/scenarios/security-then-validasi.yaml | 33 - tests/scenarios/skill-authoring.yaml | 30 - tests/scenarios/validasi-bgp-down.yaml | 31 - tests/scenarios/validasi-resolved.yaml | 28 - tools/__init__.py | 0 tools/agent_memory.py | 136 -- tools/base.py | 277 --- tools/config_backup.py | 182 -- tools/config_read.py | 158 -- tools/config_write.py | 65 - tools/config_yaml.py | 168 -- tools/db.py | 776 ------- tools/dhcp.py | 204 -- tools/diagnostic.py | 88 - tools/document.py | 252 --- tools/interface.py | 45 - tools/log.py | 58 - tools/netbox.py | 1599 -------------- tools/reachability.py | 158 -- tools/report.py | 195 -- tools/routing.py | 441 ---- tools/security.py | 105 - tools/system.py | 31 - tools/traffic.py | 352 --- tools/utility.py | 55 - tools/web.py | 100 - tui.py | 1915 ----------------- tui_textual.py | 926 -------- 148 files changed, 2207 insertions(+), 26051 deletions(-) create mode 100644 .dockerignore create mode 100644 .env.example delete mode 100644 agent.py delete mode 100644 agents/__init__.py delete mode 100644 agents/definitions/config_agent.md delete mode 100644 agents/definitions/diagnose_agent.md delete mode 100644 agents/definitions/document_agent.md delete mode 100644 agents/definitions/monitor_agent.md delete mode 100644 agents/definitions/netbox_agent.md delete mode 100644 agents/definitions/security_agent.md delete mode 100644 agents/definitions/supervisor.md delete mode 100644 agents/definitions/validasi_agent.md delete mode 100644 agents/graph.py delete mode 100644 agents/loader.py delete mode 100644 agents/metrics.py delete mode 100644 agents/nodes.py delete mode 100644 agents/tools.py rename tests/__init__.py => data/.gitkeep (100%) create mode 100644 docker-compose.dev.yml create mode 100644 docker-compose.yml delete mode 100644 frontend/Dockerfile.backend delete mode 100644 frontend/docker-compose.yml delete mode 100644 frontend/js/api.js create mode 100644 frontend/js/backends/common.js create mode 100644 frontend/js/backends/hermes.js create mode 100644 frontend/js/backends/index.js create mode 100644 frontend/js/backends/netops.js delete mode 100644 frontend/js/components.js create mode 100644 frontend/js/manager.js delete mode 100644 frontend/js/screens/backups.js delete mode 100644 frontend/js/screens/metrics.js delete mode 100644 frontend/js/screens/nodes.js delete mode 100644 frontend/js/screens/reports.js create mode 100644 frontend/js/screens/unavailable.js delete mode 100644 frontend/js/store.js delete mode 100644 frontend/js/tag-input.js delete mode 100644 frontend/nginx.conf create mode 100644 frontend/nginx.conf.template delete mode 100644 legacy/generate_reports.py delete mode 100644 legacy/mikrotik_agent.py delete mode 100755 legacy/schedule_utbk.sh delete mode 100644 legacy/test_regex.py delete mode 100644 requirements.txt delete mode 100644 server.py create mode 100644 server/Dockerfile create mode 100644 server/backends.py create mode 100644 server/db.py create mode 100644 server/main.py create mode 100644 server/requirements.txt delete mode 100644 skills/__init__.py delete mode 100644 skills/config/commissioning.md delete mode 100644 skills/config/config-backup.md delete mode 100644 skills/config/config-change.md delete mode 100644 skills/config/netbox-bgp-sync.md delete mode 100644 skills/config/netbox-sync.md delete mode 100644 skills/config/router-discovery.md delete mode 100644 skills/config/router-to-netbox-sync.md delete mode 100644 skills/config/vlan-provisioning.md delete mode 100644 skills/dhcp/dhcp-client-diagnostics.md delete mode 100644 skills/dhcp/dhcp-pool-audit.md delete mode 100644 skills/dhcp/static-lease-management.md delete mode 100644 skills/dhcp/utbk-session-monitoring.md delete mode 100644 skills/documents/document-writing.md delete mode 100644 skills/documents/skill-authoring.md delete mode 100644 skills/documents/templates/network-status.md delete mode 100644 skills/documents/templates/routing-bgp-ospf.md delete mode 100644 skills/documents/templates/security-assessment.md delete mode 100644 skills/library.py delete mode 100644 skills/maintenance/router-maintenance.md delete mode 100644 skills/monitoring/action-validation.md delete mode 100644 skills/monitoring/capacity-planning.md delete mode 100644 skills/monitoring/link-diagnostics.md delete mode 100644 skills/monitoring/morning-check.md delete mode 100644 skills/monitoring/mtu-mismatch-diagnostics.md delete mode 100644 skills/monitoring/netbox-read.md delete mode 100644 skills/monitoring/network-health-check.md delete mode 100644 skills/monitoring/network-reachability.md delete mode 100644 skills/monitoring/network-status-report.md delete mode 100644 skills/monitoring/network-traffic-analysis.md delete mode 100644 skills/pedoman-agent.md delete mode 100644 skills/routing/bgp-diagnostics.md delete mode 100644 skills/routing/bgp-prefix-leak.md delete mode 100644 skills/routing/ospf-diagnostics.md delete mode 100644 skills/routing/static-route-management.md delete mode 100644 skills/security/brute-force-response.md delete mode 100644 skills/security/firewall-management.md delete mode 100644 skills/security/security-audit.md delete mode 100644 test_load.py delete mode 100644 tests/eval.py delete mode 100644 tests/mocks/__init__.py delete mode 100644 tests/mocks/fixtures.py delete mode 100644 tests/review.py delete mode 100644 tests/scenarios/bgp-ospf-report.yaml delete mode 100644 tests/scenarios/brute-force-detect.yaml delete mode 100644 tests/scenarios/config-direct.yaml delete mode 100644 tests/scenarios/dhcp-exhaustion.yaml delete mode 100644 tests/scenarios/greeting.yaml delete mode 100644 tests/scenarios/health-check.yaml delete mode 100644 tests/scenarios/interface-flapping.yaml delete mode 100644 tests/scenarios/netbox-bgp-drift.yaml delete mode 100644 tests/scenarios/netbox-drift.yaml delete mode 100644 tests/scenarios/netbox-populate-from-router.yaml delete mode 100644 tests/scenarios/netbox-read.yaml delete mode 100644 tests/scenarios/netbox-vlan-provisioning.yaml delete mode 100644 tests/scenarios/scope-idren.yaml delete mode 100644 tests/scenarios/security-then-validasi.yaml delete mode 100644 tests/scenarios/skill-authoring.yaml delete mode 100644 tests/scenarios/validasi-bgp-down.yaml delete mode 100644 tests/scenarios/validasi-resolved.yaml delete mode 100644 tools/__init__.py delete mode 100644 tools/agent_memory.py delete mode 100644 tools/base.py delete mode 100644 tools/config_backup.py delete mode 100644 tools/config_read.py delete mode 100644 tools/config_write.py delete mode 100644 tools/config_yaml.py delete mode 100644 tools/db.py delete mode 100644 tools/dhcp.py delete mode 100644 tools/diagnostic.py delete mode 100644 tools/document.py delete mode 100644 tools/interface.py delete mode 100644 tools/log.py delete mode 100644 tools/netbox.py delete mode 100644 tools/reachability.py delete mode 100644 tools/report.py delete mode 100644 tools/routing.py delete mode 100644 tools/security.py delete mode 100644 tools/system.py delete mode 100644 tools/traffic.py delete mode 100644 tools/utility.py delete mode 100644 tools/web.py delete mode 100755 tui.py delete mode 100644 tui_textual.py diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..7efd9fd --- /dev/null +++ b/.dockerignore @@ -0,0 +1,7 @@ +.git +.env +data/ +docs/ +laporan/ +**/__pycache__ +**/*.pyc diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..4f88e0d --- /dev/null +++ b/.env.example @@ -0,0 +1,32 @@ +# 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). +# HERMES_API_KEY must equal API_SERVER_KEY in ~/.hermes/.env — nginx injects it +# so it never reaches the browser. +HERMES_URL=http://127.0.0.1:8642 +HERMES_API_KEY= + +# 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 diff --git a/.gitignore b/.gitignore index d81698c..3b11e34 100644 --- a/.gitignore +++ b/.gitignore @@ -1,22 +1,15 @@ -# 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 +# Generated / local laporan/ - -# Log files +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 diff --git a/CLAUDE.md b/CLAUDE.md index 3303605..b0ddec2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,235 +1,76 @@ -# CLAUDE.md — llmnetops +# CLAUDE.md — NetOpsUI (LLMNetOps Console) -Platform operasional jaringan kampus berbasis LangGraph multi-agent. Agent SSH ke router MikroTik (RouterOS v6/v7), menganalisis kondisi jaringan, dan mengeksekusi perubahan dengan approval operator. +Repo ini adalah **UI + service manajemen kecil**. Tidak ada logika agent, LLM, atau SSH ke router di sini. Agent dijalankan oleh dua backend yang dipanggil lewat API: -## Cara Menjalankan +- **NetOps Agent** (repo saat ini masih `palapa-agent`, `/home/llmnetops/palapa-agent`): disebut **NetOps Agent** di seluruh NetOpsUI (UI, id backend `netops`, env `NETOPS_AGENT_*`). Nama `palapa` hanya dipakai saat merujuk ke hal nyata di sisi Palapa: perintah `uvicorn palapa.gateway.api`, `PALAPA_CONFIG_PATH`, folder `~/.palapa`, dan namespace `metadata.palapa` di `SKILL.md`. +- **Hermes** (`~/.hermes/hermes-agent`): gateway platform `api_server`. -```bash -source .venv/bin/activate -python tui.py # TUI ncurses (production) -python server.py # Web server (FastAPI) — http://localhost:8000 -# python tui_textual.py # TUI Textual (experimental) -``` - -Membutuhkan `config.yaml` (tidak di-commit) dan `.env` dengan `OLLAMA_BASE_URL` + `OLLAMA_MODEL`. - -## Branch - -| Branch | Deskripsi | -|--------|-----------| -| `main` | DHCP monitoring UTBK (original, jangan diubah) | -| `netops` | Fondasi multi-agent platform | -| `refactor_agent_skill_tool` | Branch aktif pengembangan | - -PR selalu ke `main` dari branch aktif. - ---- - -## Arsitektur Singkat - -``` -tui.py → agent.py (public API) → agents/nodes.py → tools/*.py → Router SSH - ↑ - agents/definitions/*.md skills/**/*.md -``` - -- **`agent.py`** — hanya public API: `create_agent()`, `stream_agent_response()`, `resume_after_approval()`. Zero LLM logic. -- **`agents/nodes.py`** — semua node LangGraph: `supervisor_node`, `_make_specialist_node()` factory, `config_node`. -- **`agents/loader.py`** — baca agent definitions dari `data/netops.db` (tabel `agent_definitions`), bangun `AgentDefinition`. `agents/definitions/*.md` hanya seed satu-kali (lihat `tools/db.py::_migrate_agents_from_md_if_empty`) — tidak pernah dibaca lagi setelah baris pertama masuk DB. -- **`agents/tools.py`** — `TOOL_MAP: dict[str, tool]` — registry semua tools per domain. -- **`tools/*.py`** — 31+ atomic `@tool` functions, semua SSH ke MikroTik. -- **`skills/library.py`** — `SkillLibrary` dengan hot reload via `watchfiles`. -- **`skills/**/*.md`** — prosedur kerja agent; ditambah tanpa coding Python. -- **`tui.py`** — UI only, consume `agent.py` public API, zero LLM logic. - ---- - -## Agent Definitions (`agents/definitions/*.md`) - -Setiap file Markdown mendefinisikan satu specialist agent — tapi ini hanya **seed awal**. Saat `data/netops.db` pertama kali dibuat, isi file-file ini di-migrasi satu kali ke tabel `agent_definitions`; setelah itu runtime (`AgentLoader`) selalu baca dari DB, dan edit lewat UI (`PUT /api/agents/{name}`) menulis ke DB, **bukan** ke file ini. File `.md` di repo tidak pernah berubah lagi secara otomatis — aman di-commit tanpa noise dari hasil edit operator. `POST /api/agents/{name}/restore` mengembalikan field yang bisa diedit ke isi asli file seed (disimpan verbatim di kolom `default_raw` saat migrasi). - -Frontmatter YAML (referensi format seed): - -```yaml ---- -name: monitor_agent # snake_case, cocok dengan nama node di graph -alias: eko # nama tampilan di TUI -description: > # dipakai supervisor untuk routing decision - Satu kalimat fungsi agent -model: qwen3.5:9b -num_ctx: 32768 # KV cache VRAM ~3.5 GB per agent — aman karena sekuensial -num_predict: 16384 # thinking model: token reasoning ikut dihitung -context_window: 20 # jumlah pesan terakhir yang dibawa ke LLM -timeout: 600 -ollama_host: "" # opsional; override OLLAMA_BASE_URL untuk multi-mesin -tools: - - list_routers # harus ada di TOOL_MAP di agents/tools.py - - check_reachability -skills: - - network-health-check # harus ada di skills/**/*.md -handoff_to: - - document_agent # agent yang boleh di-route berikutnya -approval_required_tools: # khusus config_agent — tools yang picu interrupt() - - backup_router_config - - run_command_write ---- -Isi system prompt agent dalam Bahasa Indonesia... -``` - -**Aturan:** Jangan tambahkan instruksi "tunggu konfirmasi dari operator" atau "satu perubahan sekaligus" di system prompt — ini menyebabkan agent berhenti setelah approval pertama. - ---- - -## Skill Format (`skills/**/*.md`) - -```yaml ---- -name: nama-skill # kebab-case, cocok dengan referensi di agent definition -domain: monitoring # direktori domain: monitoring/routing/config/security/dhcp/... -triggers: - - kata kunci query yang relevan -tools: - - get_interface_stats # informational — tidak enforce di runtime -approval_required: false -enabled: true ---- - -Konten prosedur dalam Bahasa Indonesia... -``` - -Skill baru langsung aktif tanpa restart (hot reload). Tempatkan di subdirektori domain yang sesuai. +Hanya satu backend aktif pada satu waktu (`localStorage['llmnetops-backend']`, dipilih di Settings). ---- +**Scope kerja: hanya repo NetOpsUI.** Jangan mengubah repo palapa-agent, `~/.palapa`, atau `~/.hermes`, dan jangan menjalankan/menghentikan backend tanpa diminta. Pengujian memakai mock dan *salinan* home backend, bukan yang asli. (Pengecualian yang disengaja: fitur Publish skill dan "Terapkan ke SOUL.md" di manager menulis ke folder backend atas aksi operator.) -## Tool Conventions (`tools/*.py`) +## Menjalankan -**Naming:** -- `get_*` — read, return data -- `run_command` — read-only SSH command (blocklist kata destruktif) -- `run_command_write` — write SSH command (butuh approval, blocklist `format`/`factory-reset`) -- `audit_*` — multi-router parallel check -- `check_*` — boolean/status check -- `list_*` — daftar item -- `backup_*` — operasi backup (butuh approval) - -**Jangan tambahkan truncation limit baru.** Limit yang ada sudah sengaja diperbesar atau dihapus karena menyebabkan agent kehilangan konteks. Jika output terlalu besar, perbaiki di sisi query MikroTik, bukan potong hasilnya. - -**Tools yang butuh approval operator** (via `interrupt()` di `config_node`): -- `backup_router_config` -- `run_command_write` - ---- - -## Pola Penting di `agents/nodes.py` - -### Safety Net (jamin AIMessage selalu ada) - -Setelah forced summary, jika `final_msg` bukan `AIMessage` berisi konten: -```python -# Ambil ToolMessage dengan konten terpanjang sebagai fallback -best = max(tool_msgs, key=lambda m: len(m.content or "")) -final_msg = AIMessage(content=f"Hasil:\n{best.content}") +```bash +cp .env.example .env # isi HERMES_API_KEY, HOST_UID/GID, NETOPS_AGENT_HOME/HERMES_HOME +docker compose up -d --build # produksi +docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d # dev (hot reload) ``` -**Jangan hapus** — mencegah supervisor loop tak terbatas. - -### Loop Guard (di `supervisor_node`) -```python -if next_agent == _prev_agent and _prev_agent in valid_agent_names: - next_agent = "END" -``` -**Jangan hapus** — mencegah supervisor re-route ke agent yang baru saja selesai. +UI di `:3000`, manager di `127.0.0.1:8200`. Backend harus sudah jalan di host: NetOps Agent di `127.0.0.1:8100` (port 8000 dipakai container mikrotik-mcp; API-nya butuh `PALAPA_CONFIG_PATH`), Hermes di `127.0.0.1:8642` (butuh `API_SERVER_KEY` di `~/.hermes/.env`). Detail di README. -### Approval Chain (di `config_node`) +## Branch -`config_node` menggunakan `interrupt()` untuk setiap tool di `_APPROVAL_REQUIRED_TOOLS`. `resume_after_approval()` di `agent.py` menggunakan `graph.stream()` (bukan `graph.invoke()`) agar interrupt berikutnya tetap sampai ke TUI. +Pengembangan dilakukan langsung di branch `ui`. -### Rule 6 di `_SPECIALIST_SYS` +## Arsitektur ``` -Setelah menerima hasil tool, jika masih ada tugas berikutnya, LANGSUNG panggil -tool berikutnya tanpa menulis teks konfirmasi, ringkasan, atau 'Lanjut ke langkah X'. +screens/*.js → backends/index.js activeBackend() → backends/{netops,hermes}.js → /backend//… → nginx → backend +screens/{skills,agents}.js, settings (tab file) → manager.js → /api/… → nginx → server/ (FastAPI + SQLite) → ~/.palapa, ~/.hermes ``` -**Jangan hapus** — mencegah agent berhenti di tengah sequence write operations. ---- +- **`frontend/js/backends/index.js`**: registry dan **kontrak adapter** (komentar di atas file). Screen tidak boleh `fetch` langsung ke backend. +- **`backends/common.js`**: `http()`, `readSSE()` (mendukung `event:` dan multi-line `data:`), `toDate()`, `contentText()`. +- **`backends/netops.js`**: `/chat` stateless, jadi thread + pesan disimpan di `localStorage['llmnetops-netops-threads-v1']` (key lama `…palapa…` dan id backend `palapa` dimigrasi otomatis) dan seluruh history dikirim tiap giliran. Stop = `AbortController` (run di server tidak berhenti). Tidak ada approval. +- **`backends/hermes.js`**: thread = Hermes session. Giliran chat memakai **`POST /v1/runs` + `GET /v1/runs/{id}/events`**, bukan `/api/sessions/{id}/chat/stream`, karena hanya runs yang mengirim `approval.request` dan menerima `/approval` dan `/stop`. Profil agent aktif dikirim sebagai `instructions`. +- **`frontend/nginx.conf.template`**: proxy `/backend/netops/`, `/backend/hermes/`, `/api/` (manager). Menyisipkan `Authorization: Bearer $HERMES_API_KEY` dan **mengosongkan `Origin`** (Hermes menolak origin di luar `API_SERVER_CORS_ORIGINS`). +- **`server/`** (manager): `backends.py` (akses filesystem terbatas, render/parse `SKILL.md`, masking config), `db.py` (SQLite: `skills`, `skill_publications`, `profiles`; baris `backend='palapa'` dimigrasi ke `netops` saat start), `main.py` (API). Skill = folder `/SKILL.md` dengan frontmatter YAML di kedua backend; Hermes menaruh skill NetOpsUI di `skills/netopsui/`. -## State Graph +### Event ternormalisasi (dikonsumsi `screens/chat.js`) -```python -class NetworkOpsState(TypedDict): - messages: Annotated[list, add_messages] # pesan LangGraph (append-only) - next_agent: str # target routing dari supervisor - active_agent: str # agent yang sedang berjalan - agent_log: list # AgentLogEntry — dikonsumsi TUI untuk Activity screen - reasoning: str # debug reasoning supervisor - skill_name: str # skill yang diinjeksi ke specialist -``` +`delta` · `tool_start` · `tool_end` · `note` · `thinking` · `approval` · `error` · `stopped`. Backend baru = adapter yang memetakan event-nya ke daftar ini, lalu didaftarkan di `BACKENDS`. -`agent_log` adalah append-only list yang di-yield ke TUI sebagai events: `routing`, `tool_call`, `tool_result`, `ai`, `approval`. +### Screen "belum tersedia" ---- +`NAV_ITEMS[].unavailable = true` di `config.js` → `screens/unavailable.js`. Saat ini: Nodes, Reports, Backups, Metrics. Aktifkan kembali dengan menghapus flag, menambah screen, dan method adapter/manager setelah datanya ada. -## TUI Public API (`agent.py`) +## Aturan -```python -graph, config = create_agent() - -# Stream query baru -for event_type, content in stream_agent_response(graph, config, "query user"): - # event_type: "routing" | "tool_call" | "tool_result" | "ai" | "approval_required" | "error" - ... - -# Resume setelah approval (gunakan ini, bukan graph.invoke) -for event_type, content in resume_after_approval(graph, config, "approved"): - ... -``` - ---- +- **Jangan simpan API key/credential di JS.** Kredensial disisipkan nginx dari env container. Manager tidak pernah mengembalikan nilai `.env`; `config.yaml` selalu dimasking. +- Di nginx, `proxy_set_header` **tidak diwarisi** ke `location` yang punya `proxy_set_header` sendiri. Setiap location mengulang header lengkap. +- Manager: slug divalidasi `^[a-z0-9][a-z0-9-]{0,63}$` dan path skill dicek tetap di dalam folder skills (anti path traversal). `SOUL.md` ditulis *in place* (bisa berupa bind mount satu file yang tidak bisa di-rename atomik). +- Publish skill tidak menimpa file yang bukan hasil publish NetOpsUI tanpa `force`. Menghapus skill di library tidak menghapus file yang sudah dipublish. +- File tunggal yang di-mount di compose harus sudah ada di host, dan `data/` harus ada (`data/.gitkeep`) agar tidak dibuat `root` oleh Docker. +- **Pengujian harus memakai `DATA_DIR` terpisah** (dan salinan home backend). `./data` berisi data asli operator; stack uji yang memakai `./data` yang sama akan bercampur dengannya. +- **Jangan mematikan proses dengan `pkill -f`/`pgrep -f` berdasarkan nama** (mis. `uvicorn main:app`): proses di dalam container terlihat di host dan ikut terbunuh. Gunakan PID atau port uji yang unik. +- Tidak ada build step: ES modules langsung, Tailwind via CDN (config di `index.html`), markdown renderer sendiri di `utils.js` (escape-first). `localStorage` bisa kosong/throw, selalu `try/catch`. +- **UI belum punya autentikasi.** ## Bahasa -- **Kode Python:** Bahasa Inggris (nama variabel, komentar teknis, docstring) -- **System prompt agent & skill:** Bahasa Indonesia -- **Log output ke operator:** Bahasa Indonesia -- **Dokumen di `docs/`:** campuran (sebagian Inggris, sebagian Indonesia) - ---- +- **Kode:** Bahasa Inggris (nama variabel, komentar). **Teks UI untuk operator:** Bahasa Indonesia. -## File Kritis — Jangan Diubah Tanpa Hati-hati - -| File | Alasan | -|------|--------| -| `agents/nodes.py` | Safety net + loop guard; perubahan bisa menyebabkan infinite loop | -| `agent.py` | Public API contract dengan tui.py; `resume_after_approval` harus tetap streaming | -| `tools/config_read.py` | `_BLOCKED_KEYWORDS` — daftar blocklist read-only; jangan relaksasi | -| `tools/config_write.py` | `_BLOCKED_DESTRUCTIVE` — jangan hapus `factory-reset`, `format` | -| `agents/tools.py` | `TOOL_MAP` — tool harus terdaftar di sini agar bisa dipakai agent | - ---- - -## File Tidak Di-commit (gitignored) +## File Tidak Di-commit ``` -config.yaml # kredensial SSH + daftar router -.env # OLLAMA_BASE_URL, OLLAMA_MODEL -backups/ # hasil backup config router -laporan/ # laporan yang digenerate agent -output/ # output lain +.env # HERMES_API_KEY, URL backend, HOST_UID/GID +data/* # database manager + backup SOUL.md (kecuali data/.gitkeep); lokasi bisa diganti via DATA_DIR ``` ---- - ## Dokumentasi -| Dokumen | Isi | -|---------|-----| -| [docs/IMPLEMENTATION_PLAN.md](docs/IMPLEMENTATION_PLAN.md) | 8-phase plan; Phase 8 = TUI Textual (belum dimulai) | -| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Desain sistem lengkap | -| [docs/SKILL_AUTHORING_GUIDE.md](docs/SKILL_AUTHORING_GUIDE.md) | Panduan menulis skill baru | -| [laporan/rekap-pengembangan_20260509.md](laporan/rekap-pengembangan_20260509.md) | Rekap pekerjaan 9 Mei 2026 | - ---- +`docs/` berisi dokumen desain era monolit LangGraph (tidak lagi mencerminkan kode) dan mockup Stitch di `docs/stitch_llmnetops_enterprise_console/`, yang masih menjadi acuan visual. ## Agent skills @@ -243,4 +84,4 @@ Label dalam Bahasa Indonesia: perlu-triage, perlu-info, siap-agent, siap-manusia ### Domain docs -Single-context — satu `CONTEXT.md` di root + `docs/adr/`. Lihat `docs/agents/domain.md`. +Single-context: satu `CONTEXT.md` di root + `docs/adr/`. Lihat `docs/agents/domain.md`. diff --git a/CONTEXT.md b/CONTEXT.md index f377935..026e3a4 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -1,31 +1,29 @@ -# 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, netbox) | -| 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 | -| Pedoman | `skills/pedoman-agent.md` — global conduct rules untuk semua agent, hot-reload | -| Commissioning | Workflow konfigurasi router baru dari fresh via skill + design doc | - -## 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) -- **TUI** — `tui_textual.py` (Textual framework, aktif); `tui.py` (ncurses, legacy) +| 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 | +| Belum tersedia | Screen yang datanya belum punya API (`NAV_ITEMS[].unavailable`): Nodes, Reports, 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 -- Backup wajib sebelum write pertama ke setiap router (enforced di `config_node`, bukan LLM) -- Global conduct rules dikelola di `skills/pedoman-agent.md` — jangan hardcode di nodes.py +- 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. +- Kredensial (API key Hermes) hanya ada di environment nginx, tidak pernah di browser. 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 dan `SOUL.md` NetOps Agent; 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. diff --git a/README.md b/README.md index 5a83b22..1cef30b 100644 --- a/README.md +++ b/README.md @@ -1,308 +1,221 @@ -# NetOps AI — Campus Network Operations Platform +# NetOpsUI — LLMNetOps Console -Platform operasional jaringan kampus berbasis multi-agent AI. Dibangun di atas project monitoring DHCP UTBK 2026 (`main`), branch ini (`netops`) memperluas cakupan ke operasional jaringan kampus secara menyeluruh dengan arsitektur LangGraph multi-agent, skill system berbasis Markdown, dan human-in-the-loop approval. +Web console untuk operasional jaringan berbasis agent AI. NetOpsUI **tidak menjalankan agent**: chat dan tool jaringan dikerjakan oleh salah satu dari dua backend, sedangkan NetOpsUI menyediakan antarmuka serta pengelolaan skill dan profil agent. -## Fitur Utama +| Backend | Keterangan | Alamat default | +|---|---|---| +| **NetOps Agent** | REST API agent jaringan. Repo dan modulnya saat ini masih bernama `palapa-agent` / `palapa` | `127.0.0.1:8100` | +| **Hermes Agent** | Gateway Hermes, platform `api_server` | `127.0.0.1:8642` | + +Hanya **satu backend aktif pada satu waktu**, dipilih di **Settings** dan diingat per browser. + +## Daftar isi -- **Multi-agent LangGraph**: Supervisor + 5 specialist agents (monitor/eko, diagnose/agus, config/joko, security/satria, document/budi) -- **Skill System**: Operator mendefinisikan prosedur kerja dalam Markdown — tanpa coding Python; template sistem untuk panduan format laporan -- **32 tools atomic**: SSH ke MikroTik RouterOS v6/v7, mencakup traffic stats, config backup, diagnostik, security audit, document writing -- **Hot reload**: Tambah atau edit skill dan template langsung aktif tanpa restart sistem -- **Human-in-the-loop**: Operasi berisiko (config backup) memerlukan persetujuan operator Y/N -- **TUI 7 layar**: Termasuk layar Agent Activity untuk monitoring komunikasi antar agent secara real-time -- **Zero LLM logic di tui.py**: Semua orchestration di `agent.py`, TUI hanya consume public API +- [Arsitektur](#arsitektur) · [Fitur](#fitur) · [Manager service](#manager-service-server) +- [Menjalankan / deploy](#menjalankan--deploy) +- [Operasi harian](#operasi-harian) · [Troubleshooting](#troubleshooting) · [Keamanan](#keamanan) +- [Struktur repo](#struktur-repo) ## Arsitektur ``` -┌─────────────────────────────────────────────────────────────┐ -│ TUI (tui.py, 7 layar) │ -│ AI Chat ──► agent.py public API ◄── Agent Activity │ -└─────────────────────────┬───────────────────────────────────┘ - │ stream_agent_response() -┌─────────────────────────▼───────────────────────────────────┐ -│ agent.py (Orchestration) │ -│ │ -│ SkillLibrary (hot reload) LangGraph StateGraph │ -│ skills/**/*.md ───► supervisor → specialists │ -└──────────────────────────────────────────┬──────────────────┘ - │ tools SSH -┌──────────────────────────────────────────▼──────────────────┐ -│ tools/*.py (28 tools) │ -│ SSH Commands → MikroTik Routers (ROS v6/v7) │ -└─────────────────────────────────────────────────────────────┘ +Browser (SPA vanilla JS) + │ /backend/netops/* /backend/hermes/* /api/* + ▼ +nginx (container frontend, :3000) + │ buang header Origin; sisipkan │ + │ Authorization: Bearer $HERMES_API_KEY │ + ▼ (khusus Hermes) ▼ +NetOps Agent :8100 Hermes :8642 manager :8200 (container manager: FastAPI + SQLite) + skill library · profil agent · view config + │ akses file terbatas + ▼ + ~/.palapa · ~/.hermes ``` -### Struktur File +- `frontend/js/backends/`: satu adapter per backend dengan kontrak yang sama (lihat komentar di `index.js`). Screen hanya bicara lewat `activeBackend()`. +- `server/`: **manager**, service milik NetOpsUI untuk hal yang tidak punya API di kedua backend. +- Kedua container memakai **host network** agar bisa menjangkau backend yang hanya mendengarkan di `127.0.0.1`. Backend tidak perlu dibuka ke jaringan. +- API key Hermes hanya ada di environment nginx, tidak pernah sampai ke browser. -``` -llmnetops/ -├── agent.py ← Public API + NetworkOpsState + SkillLibrary singleton -├── tui.py ← UI only (zero LLM logic) -├── generate_reports.py ← Standalone DHCP report generator -│ -├── agents/ -│ ├── graph.py ← StateGraph builder -│ ├── nodes.py ← supervisor_node + 5 specialist nodes + config_node; AGENT_ALIAS -│ └── tools.py ← Tool registries per agent domain -│ -├── skills/ -│ ├── library.py ← SkillLibrary class + hot reload -│ ├── dhcp/ ← diagnose-dhcp-client, dhcp-pool-audit, utbk-client-monitor -│ ├── routing/ ← ospf-neighbor-down, bgp-diagnostics -│ ├── monitoring/ ← network-health-check, router-unreachable -│ ├── security/ ← security-audit -│ ├── config/ ← config-backup-procedure -│ └── documents/ ← write-report; templates/security-assessment.md -│ -├── tools/ ← 32 atomic SSH tools -│ ├── base.py ← SSH helper, config loader -│ ├── traffic.py ← TX/RX rates, top talkers, queue stats -│ ├── config_backup.py ← Export, diff, list backups -│ ├── document.py ← list_templates, read_template, write_document, create_template -│ └── ... ← reachability, system, routing, dhcp, log, dll -│ -├── legacy/ ← Script main-branch (DHCP collector, report generator, scheduler) -│ ├── mikrotik_agent.py ← SSH DHCP collector (dipakai CollectScreen via subprocess) -│ ├── generate_reports.py ← DHCP report generator (dipakai LaporanScreen via subprocess) -│ ├── schedule_utbk.sh ← Scheduler UTBK 2026 -│ └── test_regex.py ← One-off test script -│ -├── backups/ ← Config backups (gitignored) -├── docs/ ← PRD, Architecture, Implementation Plan, Skill Authoring Guide -└── laporan/ ← Generated reports (gitignored) -``` +## Fitur -## Prerequisites +| Halaman | Isi | +|---|---| +| **Dashboard** | Health backend aktif, model, jumlah thread dan skill, thread terakhir | +| **AI Chat** | Streaming, panel tool activity, stop, riwayat thread. Approval command berisiko hanya di Hermes | +| **Skills** | Library skill di NetOpsUI: buat/edit, import dari disk backend, **publish** ke backend, cabut | +| **Agents** | Profil agent (prompt): dipakai per-chat di Hermes, atau diterapkan ke `SOUL.md` NetOps Agent | +| **Settings** | Pilih backend aktif; tab *File Konfigurasi* menampilkan `config.yaml`, nama variabel `.env`, dan `SOUL.md` | +| Nodes, Reports, Backups, Metrics | **Belum tersedia**: belum ada API-nya di kedua backend | -- Python 3.11+ -- Linux terminal (curses TUI) -- Akses SSH ke router MikroTik -- [Ollama](https://ollama.ai) dengan model `gemma4:e4b` (atau model lain via `OLLAMA_MODEL`) +Perbedaan perilaku antar backend: -## Setup +- **NetOps Agent**: `/chat` stateless, jadi riwayat chat disimpan di `localStorage` browser dan seluruh history dikirim tiap giliran. Stop hanya memutus stream; proses di server tetap selesai. Tidak ada approval (tool read-only). Persona berasal dari `SOUL.md`. +- **Hermes**: riwayat tersimpan sebagai session di server Hermes. Stop menghentikan run. Command berisiko memunculkan dialog approval (sekali / sesi ini / selalu / tolak). Profil agent aktif dikirim tiap run sebagai `instructions`. -```bash -git checkout netops -python3 -m venv .venv -source .venv/bin/activate -pip install -r requirements.txt -cp .env.example .env -# Edit OLLAMA_BASE_URL dan OLLAMA_MODEL di .env -# Buat config.yaml (lihat seksi Konfigurasi) -``` +## Manager service (`server/`) -## Konfigurasi +- **Skills**: database SQLite adalah sumber kebenaran. *Publish* menulis `SKILL.md` ke `/skills//` atau `/skills/netopsui//`. Status per backend: Draft, Tersinkron, Perlu publish, Diubah di backend. Publish ditolak jika file tujuan bukan hasil publish NetOpsUI, kecuali dikonfirmasi. Menghapus skill dari library **tidak** menghapus file yang sudah dipublish. +- **Profil agent**: disimpan di SQLite. *Terapkan ke SOUL.md* menimpa persona NetOps Agent dan mencadangkan versi lama ke `data/backups/`. +- **View config**: `config.yaml` ditampilkan dengan nilai rahasia disamarkan (berdasarkan nama key: `key`, `token`, `secret`, `passw`, `credential`, `auth`; referensi `${ENV_VAR}` tetap terlihat). `.env` hanya menampilkan **nama** variabel. -### `.env` +Hak akses container manager sengaja minimal: hanya `skills/` kedua backend dan `SOUL.md` NetOps Agent yang bisa ditulis; `config.yaml`, `.env`, dan `SOUL.md` Hermes read-only; `sessions.db` dan sisanya tidak di-mount. -```env -OLLAMA_BASE_URL=http://localhost:11434 -OLLAMA_MODEL=gemma4:e4b -``` +--- -### `config.yaml` (tidak di-commit) - -```yaml -ssh: - username: netadmin - password: "REDACTED" - timeout: 15 - port: 22 - -routers: - - name: DTI - host: 10.39.0.1 - ros_version: 7 - dhcp_servers: - - dhcp-lab-tik -``` +## Menjalankan / deploy -## Cara Penggunaan +### Prasyarat -```bash -source .venv/bin/activate -python tui.py -``` +| Kebutuhan | Keterangan | +|---|---| +| Docker Engine + Compose v2 | `docker compose version` | +| Host Linux | `network_mode: host` tidak berfungsi di Docker Desktop macOS/Windows | +| Backend berjalan | NetOps Agent dan/atau Hermes, lihat langkah 1 | +| Port kosong | UI `3000`, manager `8200`, NetOps Agent `8100`, Hermes `8642` (semua bisa diubah di `.env`) | -### Layar TUI +> Di host yang sekarang, port **8000** dipakai container `mikrotik-mcp`, jadi NetOps Agent dijalankan di **8100**. -| Nomor | Layar | Fungsi | -|---|---|---| -| 1 | Dashboard | Status ringkas lease DHCP lintas router | -| 2 | Jadwal | Informasi jadwal pengumpulan data | -| 3 | Collect | Trigger koleksi data via `mikrotik_agent.py` | -| 4 | Laporan | Baca file markdown di `laporan/` | -| 5 | Log | Catatan aktivitas/eksekusi | -| 6 | AI Chat | Interaksi multi-agent dengan approval modal | -| 7 | Activity | Log routing, tool calls, tool results real-time | +### 1. Siapkan backend -### AI Chat — Contoh Query +**NetOps Agent.** API-nya membaca `config.yaml` dari folder tempat ia dijalankan, kecuali `PALAPA_CONFIG_PATH` diatur: -``` -cek status jaringan kampus -kenapa Lab5 tidak dapat IP? -audit keamanan router FILKOM-CORE -backup konfigurasi DTI -cek traffic ether1 di GKB -simpan laporan health check ke file -tulis laporan keamanan jaringan DTI +```bash +cd /path/ke/palapa-agent +PALAPA_CONFIG_PATH=$HOME/.palapa/config.yaml \ + uv run uvicorn palapa.gateway.api:app --host 127.0.0.1 --port 8100 ``` -### Invoke Skill Eksplisit +Untuk permanen, jalankan sebagai service (systemd) supaya otomatis hidup setelah reboot. Kelola sesuai panduan backend tersebut. -``` -/skill diagnose-dhcp-client -/skill ospf-neighbor-down -/skill security-audit +**Hermes.** Aktifkan platform `api_server` dengan menambahkan ke `~/.hermes/.env`: + +```bash +API_SERVER_KEY= # mis. hasil: openssl rand -hex 32 ``` -## Tools AI Agent (28 tool) +lalu restart gateway Hermes. Restart ini memutus sebentar platform lain yang sedang terhubung (mis. Telegram). -### Monitoring & Status +Cek backend sebelum lanjut: -| Tool | Fungsi | -|---|---| -| `list_routers` | Daftar router dan DHCP server | -| `check_reachability` | Ping ke router | -| `get_system_info` | CPU, RAM, uptime | -| `get_interface_stats` | Error dan drop per interface | -| `get_interface_traffic` | TX/RX rate realtime | -| `get_traffic_summary` | Ringkasan traffic semua interface | -| `get_top_talkers` | IP dengan traffic tertinggi | -| `get_queue_stats` | Statistik queue dan drop | -| `get_traffic_all` | Traffic stats semua router paralel | -| `get_current_time` | Waktu lokal WIB (UTC+7) | - -### DHCP - -| Tool | Fungsi | -|---|---| -| `get_dhcp_leases` | Lease dari satu DHCP server | -| `get_router_leases` | Semua lease di satu router | -| `audit_dhcp` | Audit DHCP semua router | -| `search_device` | Cari perangkat by IP atau MAC | +```bash +curl -s localhost:8100/health # NetOps Agent → {"status":"ok","model":...} +curl -s localhost:8642/health # Hermes → {"status":"ok","platform":"hermes-agent",...} +``` -### Routing & Config +### 2. Konfigurasi NetOpsUI -| Tool | Fungsi | -|---|---| -| `get_routing_full` | Route table + OSPF + BGP | -| `get_router_config` | Konfigurasi router (berbagai section) | -| `run_command` | Command read-only di satu router | -| `run_command_all` | Command yang sama di semua router paralel | +```bash +git clone NetOpsUI && cd NetOpsUI +git checkout ui +cp .env.example .env +$EDITOR .env +``` -### Config Backup +Yang **wajib** diperiksa di `.env`: -| Tool | Fungsi | +| Variabel | Isi | |---|---| -| `backup_router_config` | `/export` → `backups//.rsc` (**butuh approval**) | -| `list_backups` | Daftar backup tersimpan | -| `diff_config` | Diff dua versi config | +| `HERMES_API_KEY` | Sama persis dengan `API_SERVER_KEY` di `~/.hermes/.env` | +| `NETOPS_AGENT_HOME` | Folder home NetOps Agent (saat ini `/home//.palapa`) | +| `HERMES_HOME` | Folder home Hermes (`/home//.hermes`) | +| `HOST_UID` / `HOST_GID` | Hasil `id -u` dan `id -g`, agar file yang ditulis manager dimiliki user Anda | +| `NETOPS_AGENT_URL`, `HERMES_URL` | Ubah hanya jika port backend berbeda dari default | -### Log, Diagnostik, Security, Report +Pastikan file-file ini **sudah ada** di host, karena file tunggal yang di-mount akan dibuat Docker sebagai *folder* jika tidak ada: +`$NETOPS_AGENT_HOME/{SOUL.md,config.yaml,.env}` dan `$HERMES_HOME/{SOUL.md,config.yaml,.env}`. Folder `data/` sudah ikut di repo (`data/.gitkeep`) dan harus dimiliki user Anda, bukan `root`. -| Tool | Fungsi | -|---|---| -| `get_router_log` | Log router (bisa filter per topic) | -| `run_diagnostic` | Ping atau traceroute dari router | -| `audit_security` | Audit user accounts, NTP, firewall | -| `list_reports` | Daftar file laporan | -| `get_report` | Baca laporan Markdown | -| `get_report_section` | Baca section tertentu dari laporan | -| `get_report_toc` | Daftar isi laporan | - -### Document +### 3. Build dan jalankan -| Tool | Fungsi | -|---|---| -| `list_templates` | Daftar template laporan di `skills/documents/templates/` | -| `read_template` | Baca isi file template | -| `write_document` | Tulis dokumen laporan ke `laporan/` (konvensi nama otomatis) | -| `create_template` | Buat atau perbarui template — langsung aktif tanpa restart | +```bash +docker compose up -d --build +docker compose ps # kedua service harus "healthy" +``` -## Skill System +`frontend` baru start setelah `manager` sehat. -Skill adalah file Markdown di `skills/` yang mendefinisikan prosedur kerja untuk agent. Operator jaringan bisa menulis skill baru tanpa menyentuh kode Python. +### 4. Verifikasi ```bash -# Buat skill baru -vim skills/routing/bgp-flap.md -# Langsung aktif — tidak perlu restart +curl -s localhost:3000/api/health # manager → {"status":"ok","backends":{"netops":true,"hermes":true}} +curl -s localhost:3000/backend/netops/health # lewat proxy → health NetOps Agent +curl -s localhost:3000/backend/hermes/health # lewat proxy → health Hermes ``` -Format minimal: +Lalu buka `http://:3000`. Header menampilkan backend aktif dengan titik hijau bila terhubung. Pilih backend di **Settings**. -```markdown ---- -name: nama-skill -domain: routing -triggers: - - kata kunci yang memicu skill ini -tools: - - get_routing_full - - get_router_log -approval_required: false -enabled: true ---- +### Mode development (hot reload) -## Konteks -Kapan skill ini digunakan. +Frontend disajikan langsung dari working tree; cukup reload browser setelah mengubah JS/CSS: -## Prosedur -Langkah-langkah yang harus diikuti agent. +```bash +docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d ``` -Lihat [docs/SKILL_AUTHORING_GUIDE.md](docs/SKILL_AUTHORING_GUIDE.md) untuk panduan lengkap. +--- -## Human-in-the-Loop +## Operasi harian -Operasi `backup_router_config` memerlukan persetujuan operator sebelum dieksekusi: +| Tugas | Perintah | +|---|---| +| Lihat status | `docker compose ps` | +| Lihat log | `docker compose logs -f manager` · `docker compose logs -f frontend` | +| Restart | `docker compose restart` | +| Stop | `docker compose down` (data di `data/` tetap ada) | +| **Update versi** | `git pull && docker compose up -d --build` | +| Ubah `.env` | edit `.env`, lalu `docker compose up -d` (container dibuat ulang) | +| Setelah ubah kode frontend (tanpa override dev) | `docker compose up -d --build frontend` | -``` -┌─ APPROVAL REQUIRED ─────────────────────────┐ -│ Agent : config_agent │ -│ Aksi : Backup config router 'DTI' │ -│ Risk : MEDIUM │ -│ [Y] Approve [N] Reject │ -└─────────────────────────────────────────────┘ -``` +**Update** aman untuk data: database di `data/` dipertahankan, dan perubahan skema/nama yang diperlukan dimigrasi otomatis saat manager start. Pilihan backend dan riwayat chat di browser juga ikut termigrasi. -## Requirements +**Backup.** Yang perlu dicadangkan hanya `data/` (database skill/profil dan cadangan `SOUL.md`) dan `.env`: +```bash +docker compose stop manager +tar czf netopsui-backup-$(date +%F).tgz data .env +docker compose start manager ``` -langchain-ollama>=0.3.0 -langchain-core>=0.3.0 -langgraph>=1.1.0 -pyyaml>=6.0 -paramiko>=3.0 -watchfiles>=0.21 -tabulate>=0.9 -``` - -## Security Notes -- Jangan commit `config.yaml`, `.env`, isi `output/`, `laporan/`, dan `backups/`. -- Gunakan kredensial SSH minimum privilege khusus monitoring (read-only). -- `run_command` dibatasi blocklist kata destruktif. -- File backup di `backups/` dikecualikan dari git via `.gitignore`. -- Credentials (SSH password) tidak pernah muncul di log atau output agent. +Skill yang sudah dipublish ada di folder skill masing-masing backend dan ikut cadangan backend tersebut. -## Dokumentasi - -| Dokumen | Isi | -|---|---| -| [docs/PRD.md](docs/PRD.md) | Requirements dan success metrics | -| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | Desain sistem, state, API | -| [docs/IMPLEMENTATION_PLAN.md](docs/IMPLEMENTATION_PLAN.md) | Rencana implementasi 8 phase | -| [docs/SKILL_AUTHORING_GUIDE.md](docs/SKILL_AUTHORING_GUIDE.md) | Panduan menulis skill baru | -| [docs/LANGGRAPH_FUNDAMENTALS.md](docs/LANGGRAPH_FUNDAMENTALS.md) | Node, edge, dan state di LangGraph | -| [docs/AGENT_COMMUNICATION_PATTERNS.md](docs/AGENT_COMMUNICATION_PATTERNS.md) | Pola komunikasi antar agent | -| [docs/PERSISTENCE_AND_MEMORY.md](docs/PERSISTENCE_AND_MEMORY.md) | Checkpointing dan memory di LangGraph | +**Rollback.** `git checkout && docker compose up -d --build`. Untuk mengembalikan data, hentikan manager, ganti isi `data/` dari cadangan, lalu start lagi. -## Branch +## Troubleshooting -| Branch | Deskripsi | +| Gejala | Penyebab dan solusi | |---|---| -| `main` | DHCP lease monitoring UTBK 2026 (original) | -| `netops` | Campus network operations platform (branch ini) | +| `502 Bad Gateway` di `/backend/netops/…` atau `/backend/hermes/…` | Backend belum berjalan atau port salah. Cek `curl localhost:8100/health` / `:8642/health`. UI tetap jalan; header menampilkan titik merah. | +| Hermes: chat gagal `401`/`403` | `HERMES_API_KEY` di `.env` tidak sama dengan `API_SERVER_KEY`, atau `api_server` belum aktif. Setelah mengubah `.env`, jalankan `docker compose up -d`. | +| `manager` terus restart, log `unable to open database file` | `data/` dimiliki `root` (dibuat Docker karena tidak ada) atau `HOST_UID/GID` salah. `sudo chown -R $(id -u):$(id -g) data`, cek `HOST_UID/GID`. | +| `not a directory` / mount error saat `up` | File yang di-mount belum ada di host dan Docker membuatnya sebagai folder. Hapus folder itu, buat file aslinya, ulangi. | +| `set NETOPS_AGENT_HOME in .env` | Variabel wajib belum diisi di `.env`. | +| Port sudah dipakai | Ubah `UI_PORT` / `MANAGER_PORT` di `.env`. Port 8000 di host ini milik `mikrotik-mcp`. | +| Publish skill ditolak (409) | File tujuan sudah ada dan bukan hasil publish NetOpsUI. Periksa isinya, lalu konfirmasi timpa bila memang diinginkan. | +| Perubahan JS tidak muncul | Tanpa override dev, image harus di-rebuild: `docker compose up -d --build frontend`, lalu hard refresh (Ctrl+Shift+R). | + +## Keamanan + +- **UI belum punya autentikasi.** Siapa pun yang bisa membuka UI bisa memakai chat, menulis skill ke folder backend, dan menimpa `SOUL.md` NetOps Agent. Untuk akses di luar localhost, pasang lapisan autentikasi di depannya (reverse proxy dengan basic auth/SSO, VPN, atau firewall yang membatasi port `3000`). +- Backend dan manager hanya mendengarkan di `127.0.0.1`; hanya port UI yang terbuka. +- `.env` berisi `HERMES_API_KEY`; jangan di-commit (sudah di `.gitignore`). +- Penyamaran nilai rahasia di view config berdasarkan **nama key**. Rahasia yang disimpan di key bernama lain tidak akan tersamar. + +## Struktur repo + +``` +docker-compose.yml · docker-compose.dev.yml · .env.example · .dockerignore +data/ database manager + backup SOUL.md (isi tidak di-commit) +frontend/ +├── index.html, css/, fonts/, assets/ +├── js/ +│ ├── app.js, shell.js, state.js, config.js, utils.js, manager.js +│ ├── backends/ common.js · netops.js · hermes.js · index.js +│ └── screens/ dashboard · chat · skills · agents · settings · unavailable +├── nginx.conf.template proxy ke backend + manager (envsubst saat start) +└── Dockerfile +server/ manager: main.py · backends.py · db.py · Dockerfile +docs/ dokumen desain lama (era monolit LangGraph) + mockup Stitch +``` + +`docs/` masih berisi desain era monolit LangGraph. Yang masih relevan hanya mockup dan `DESIGN.md` di `docs/stitch_llmnetops_enterprise_console/` sebagai acuan visual. diff --git a/agent.py b/agent.py deleted file mode 100644 index 5964679..0000000 --- a/agent.py +++ /dev/null @@ -1,400 +0,0 @@ -#!/usr/bin/env python3 -"""NetOps AI — public API for TUI. All LLM and agent logic lives here.""" - -from __future__ import annotations - -import atexit -import json -import os -import threading -from pathlib import Path -from typing import Annotated, Any, Iterator, TypedDict - -from langchain_core.messages import HumanMessage -from langchain_core.runnables import RunnableConfig -from langgraph.graph.message import add_messages -from langgraph.types import Command -import sqlite3 -from langgraph.checkpoint.sqlite import SqliteSaver - -# ── Load .env ────────────────────────────────────────────────────────────────── - -def _load_dotenv() -> None: - env_file = Path(__file__).parent / ".env" - if not env_file.exists(): - return - with open(env_file, encoding="utf-8") as f: - for line in f: - line = line.strip() - if not line or line.startswith("#") or "=" not in line: - continue - key, _, val = line.partition("=") - key = key.strip() - if key and key not in os.environ: - os.environ[key] = val.strip() - - -_load_dotenv() - -# ── Shared state types ───────────────────────────────────────────────────────── - -class AgentLogEntry(TypedDict): - timestamp: str - source: str # "supervisor" | "monitor_agent" | ... - event_type: str # "routing" | "tool_call" | "tool_result" | "approval" - content: str - - -class ApprovalRequest(TypedDict): - agent: str - action: str - risk_level: str # "medium" | "high" - details: dict - - -def _append(existing: list, new: list) -> list: - return (existing or []) + (new or []) - - -class NetworkOpsState(TypedDict): - messages: Annotated[list, add_messages] - next_agent: str - active_agent: str - injected_skills: list[str] - agent_log: Annotated[list[AgentLogEntry], _append] - pending_approval: ApprovalRequest | None - approval_decision: str | None - original_intent: str - - -# ── SkillLibrary singleton ───────────────────────────────────────────────────── - -from skills import SkillLibrary # noqa: E402 - -_skill_lib = SkillLibrary(Path(__file__).parent / "skills") -_skill_lib.start_watcher() -atexit.register(_skill_lib.stop_watcher) - -# ── Graph cache ──────────────────────────────────────────────────────────────── - -_DB_PATH = Path(__file__).parent / "data" / "checkpoints.db" -_DB_PATH.parent.mkdir(parents=True, exist_ok=True) - -# WAL checkpoint saat startup agar WAL tidak tumbuh tak terbatas -_wal_conn = sqlite3.connect(str(_DB_PATH), check_same_thread=False) -_wal_conn.execute("PRAGMA wal_checkpoint(TRUNCATE)") -_wal_conn.close() - -_checkpointer = SqliteSaver(sqlite3.connect(str(_DB_PATH), check_same_thread=False)) -_graph: Any = None - - -def _get_graph() -> Any: - global _graph - if _graph is None: - from agents.graph import build_graph # noqa: PLC0415 - _graph = build_graph(_checkpointer) - return _graph - - -# ── Public API ───────────────────────────────────────────────────────────────── - -def create_agent(thread_id: str) -> tuple[Any, RunnableConfig]: - """Return (compiled_graph, config) for a new or resumed conversation thread.""" - graph = _get_graph() - config: RunnableConfig = { - "configurable": {"thread_id": thread_id}, - "recursion_limit": 30, - } - return graph, config - - -def reset_agent(thread_id: str) -> tuple[Any, RunnableConfig]: - """Clear conversation history for thread_id and return fresh (graph, config).""" - graph = _get_graph() - config: RunnableConfig = { - "configurable": {"thread_id": thread_id}, - "recursion_limit": 30, - } - graph.update_state(config, { - "messages": [], "agent_log": [], "next_agent": "", - "active_agent": "", "injected_skills": [], - "pending_approval": None, "approval_decision": None, - "original_intent": "", - }) - return graph, config - - -def cleanup_orphaned_checkpoints() -> int: - """ - Hapus checkpoint lama dari thread dengan ID numerik (warisan id(self) yang tidak stabil). - Simpan hanya thread 'tui-*', 'headless', dan thread yang dibuat dalam 7 hari terakhir. - Return jumlah thread yang dihapus. - """ - import re as _re - conn = sqlite3.connect(str(_DB_PATH), check_same_thread=False) - try: - cur = conn.execute("SELECT DISTINCT thread_id FROM checkpoints") - all_threads = [r[0] for r in cur.fetchall()] - orphan_threads = [ - t for t in all_threads - if _re.fullmatch(r"\d+", t) or _re.fullmatch(r"\d+-\d+", t) - ] - if orphan_threads: - placeholders = ",".join("?" * len(orphan_threads)) - conn.execute(f"DELETE FROM checkpoints WHERE thread_id IN ({placeholders})", orphan_threads) - conn.execute(f"DELETE FROM writes WHERE thread_id IN ({placeholders})", orphan_threads) - conn.commit() - return len(orphan_threads) - finally: - conn.close() - # VACUUM harus di luar connection yang ada transaksi - if orphan_threads: - vconn = sqlite3.connect(str(_DB_PATH), check_same_thread=False) - vconn.execute("VACUUM") - vconn.close() - - -def delete_thread(thread_id: str) -> None: - """Permanently purge a thread's LangGraph checkpoint state (messages, - agent_log, pending_approval, etc.) — see tools.db.db_delete_thread() for - the companion thread-metadata row.""" - conn = sqlite3.connect(str(_DB_PATH), check_same_thread=False) - try: - conn.execute("DELETE FROM checkpoints WHERE thread_id = ?", (thread_id,)) - conn.execute("DELETE FROM writes WHERE thread_id = ?", (thread_id,)) - conn.commit() - finally: - conn.close() - - -# agent_log event types already streamed live via the custom writer inside -# _react_loop/config_node (see agents/nodes.py _emit). Skip them when replaying -# a node's batched agent_log from stream_mode="updates" so the UI doesn't see -# each tool call twice — once live, once again when the node returns. -_LIVE_STREAMED_TYPES = {"tool_call", "tool_result", "approval_required"} - - -def _drain_graph_stream( - graph: Any, - config: RunnableConfig, - stream_input: Any, - cancel_event: threading.Event | None = None, -) -> Iterator[tuple[str, str]]: - """Shared consumer for stream_agent_response / resume_after_approval. - - Consumes both "custom" (live per-tool-call events pushed via - get_stream_writer() from inside nodes) and "updates" (per-node batched - output, needed for interrupts and final AI messages) stream modes so the - UI sees each tool call as it happens instead of only after the whole node - (which may loop over many tool calls) returns. - - If cancel_event is set (operator pressed Stop), the check happens between - graph steps — before the next node/tool-call is computed — not mid-step, - since a step already in flight (e.g. an SSH command) can't be interrupted - cooperatively. Closing the underlying stream iterator stops the graph from - scheduling any further steps. - """ - it = iter(graph.stream(stream_input, config=config, stream_mode=["updates", "custom"])) - while True: - if cancel_event is not None and cancel_event.is_set(): - it.close() - yield "stopped", "Dihentikan oleh operator." - return - try: - mode, chunk = next(it) - except StopIteration: - return - - if mode == "custom": - entry = chunk - yield entry["event_type"], f"[{entry['source']}] {entry['content']}" - continue - - for node_name, node_output in chunk.items(): - if node_name == "__interrupt__": - # Human-in-the-loop pause - payload = node_output[0].value if node_output else {} - yield "approval_required", json.dumps(payload) - return - - # Emit agent_log entries not already streamed live (e.g. routing) - for entry in node_output.get("agent_log") or []: - if entry["event_type"] in _LIVE_STREAMED_TYPES: - continue - yield entry["event_type"], f"[{entry['source']}] {entry['content']}" - - # Emit new AI messages - for msg in node_output.get("messages") or []: - from langchain_core.messages import AIMessage # noqa: PLC0415 - if isinstance(msg, AIMessage) and msg.content: - import re - content = re.sub(r".*?", "", msg.content, flags=re.DOTALL).strip() - if content: - yield "ai", content - - -def stream_agent_response( - graph: Any, - config: RunnableConfig, - message: str, - cancel_event: threading.Event | None = None, -) -> Iterator[tuple[str, str]]: - """ - Stream agent events for a user message. - - Yields (event_type, content) where event_type is one of: - "routing" — supervisor routing decision - "tool_call" — tool being invoked by a specialist - "tool_result" — tool returned result (preview) - "ai" — final AI text response - "approval_required"— waiting for operator approval - "stopped" — operator cancelled the run via cancel_event - "error" — unrecoverable error - """ - try: - yield from _drain_graph_stream( - graph, config, {"messages": [HumanMessage(content=message)]}, - cancel_event=cancel_event, - ) - except Exception as exc: - yield "error", str(exc) - - -def submit_approval( - graph: Any, - config: RunnableConfig, - decision: str, -) -> None: - """Resume a paused graph after human approval. decision: 'approved' | 'rejected'. - Headless / non-streaming variant — use resume_after_approval for TUI streaming.""" - graph.invoke(Command(resume=decision), config=config) - - -def resume_after_approval( - graph: Any, - config: RunnableConfig, - decision: str, - cancel_event: threading.Event | None = None, -) -> Iterator[tuple[str, str]]: - """Resume after approval, streaming events back to caller. - Yields same (event_type, content) tuples as stream_agent_response. - May yield another 'approval_required' if a subsequent tool also needs approval. - """ - try: - yield from _drain_graph_stream(graph, config, Command(resume=decision), cancel_event=cancel_event) - except Exception as exc: - yield "error", str(exc) - - -def get_token_metrics(n: int = 100) -> list[dict]: - """Return last n entries from data/metrics.jsonl, newest last.""" - from agents.metrics import METRICS_PATH # noqa: PLC0415 - if not METRICS_PATH.exists(): - return [] - lines = METRICS_PATH.read_text(encoding="utf-8").splitlines() - entries = [] - for line in lines[-n:]: - try: - entries.append(json.loads(line)) - except Exception: - pass - return entries - - -def get_available_skills() -> list[dict]: - """Return list of enabled skill summaries for TUI display.""" - return [s.summary() for s in _skill_lib.list_enabled()] - - -def get_agent_status() -> dict: - from agents.nodes import _agent_loader # noqa: PLC0415 - from tools.db import db_get_llm_config # noqa: PLC0415 - - cfg = db_get_llm_config() - defn = _agent_loader.get("supervisor") - model = defn.model if defn else (cfg.get("model") or os.getenv("OLLAMA_MODEL", "gemma4:e4b")) - return { - "skills_loaded": len(_skill_lib), - "model": model, - "ollama_url": cfg.get("base_url") or os.getenv("OLLAMA_BASE_URL", "http://localhost:11434"), - } - - -def test_llm_connection( - model: str | None = None, base_url: str | None = None, api_key: str | None = None, -) -> dict: - """Kirim satu pesan ping ke LLM untuk verifikasi konektivitas dari halaman Settings. - - Menggunakan pabrik LLM yang sama dengan agent (_make_llm) agar hasil test - mencerminkan koneksi yang benar-benar dipakai saat runtime. - """ - import time - from agents.nodes import _make_llm # noqa: PLC0415 - from tools.db import db_get_llm_config # noqa: PLC0415 - - cfg = db_get_llm_config() - model = model or cfg.get("model") or os.getenv("OLLAMA_MODEL", "") - base_url = base_url or cfg.get("base_url") or os.getenv("OLLAMA_BASE_URL", "http://localhost:11434") - api_key = api_key or cfg.get("api_key") or os.getenv("OLLAMA_API_KEY", "") - started = time.monotonic() - try: - llm = _make_llm( - temperature=0, - model=model, - num_predict=8, - timeout=10, - base_url=base_url, - api_key=api_key, - agent_name="connection_test", - max_retries=0, - ) - llm.invoke([HumanMessage(content="ping")]) - return { - "ok": True, - "model": model, - "base_url": base_url, - "latency_ms": round((time.monotonic() - started) * 1000), - } - except Exception as e: - return { - "ok": False, - "model": model, - "base_url": base_url, - "latency_ms": round((time.monotonic() - started) * 1000), - "error": str(e), - } - - -def list_llm_models(base_url: str | None = None, api_key: str | None = None) -> dict: - """List model id yang tersedia dari endpoint OpenAI-compatible (GET /models). - - Dipakai Settings untuk isi dropdown model tanpa operator harus tahu nama - model persis lebih dulu — cukup base_url + api_key untuk cek koneksi. - """ - import time - from openai import OpenAI # noqa: PLC0415 - from tools.db import db_get_llm_config # noqa: PLC0415 - - cfg = db_get_llm_config() - base_url = base_url or cfg.get("base_url") or os.getenv("OLLAMA_BASE_URL", "http://localhost:11434") - api_key = api_key or cfg.get("api_key") or os.getenv("OLLAMA_API_KEY", "") or "sk-placeholder" - started = time.monotonic() - try: - client = OpenAI(base_url=base_url, api_key=api_key, timeout=10, max_retries=0) - resp = client.models.list() - models = sorted(m.id for m in resp.data) - return { - "ok": True, - "base_url": base_url, - "models": models, - "latency_ms": round((time.monotonic() - started) * 1000), - } - except Exception as e: - return { - "ok": False, - "base_url": base_url, - "models": [], - "latency_ms": round((time.monotonic() - started) * 1000), - "error": str(e), - } diff --git a/agents/__init__.py b/agents/__init__.py deleted file mode 100644 index 3c487d2..0000000 --- a/agents/__init__.py +++ /dev/null @@ -1,3 +0,0 @@ -from agents.graph import build_graph - -__all__ = ["build_graph"] diff --git a/agents/definitions/config_agent.md b/agents/definitions/config_agent.md deleted file mode 100644 index 11509e0..0000000 --- a/agents/definitions/config_agent.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -name: config_agent -alias: joko -description: > - Baca, verifikasi, dan ubah konfigurasi router. Backup config, diff perubahan, - dan eksekusi operasi write dengan persetujuan operator. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 4096 -context_window: 20 -timeout: 600 -reasoning: true -tools: - - list_routers - - run_command - - run_command_all - - run_command_write - - get_router_config - - backup_router_config - - list_backups - - diff_config - - check_reachability - - get_router_log - - get_dhcp_leases - - get_router_leases - - get_system_info - - get_bgp_sessions - - get_ospf_neighbors - - list_reports - - get_report - - get_current_time - - get_netbox_devices - - get_netbox_device_ips - - patch_router_field - - add_router_to_config - - remove_router_from_config - - populate_netbox_bgp - - get_netbox_bgp_drift - - remember_router_fact - - recall_router_facts -skills: - - router-discovery - - config-backup - - config-change - - static-lease-management - - router-maintenance - - firewall-management - - brute-force-response - - static-route-management - - commissioning -handoff_to: - - document_agent -approval_required_tools: - - backup_router_config - - run_command_write - - patch_router_field - - add_router_to_config - - remove_router_from_config ---- -Kamu adalah Joko, agen konfigurasi jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. -Jawab dalam Bahasa Indonesia, teknis dan ringkas. -Gunakan backtick untuk istilah teknis. - -## Tanggung Jawab - -- Membaca dan memverifikasi konfigurasi router aktif -- Mengelola backup konfigurasi: buat, list, dan bandingkan (diff) -- Mengeksekusi perubahan konfigurasi yang sudah disetujui operator -- Mengelola firewall rules, static routes, DHCP leases, dan layanan router -- Melaksanakan maintenance router: upgrade, reboot terjadwal - -## Aturan Kritis - -- `backup_router_config` dan `run_command_write` adalah operasi yang memerlukan - **persetujuan operator** sebelum dieksekusi. Jangan eksekusi tanpa approval. -- Sebelum perubahan apapun: backup dulu, baru ubah, lalu verifikasi. -- Untuk write operations: gunakan `run_command_write`. Untuk read-only: gunakan `run_command`. -- Setelah perubahan: verifikasi dengan `run_command` (read-only) dan `check_reachability`. - -## Aturan Keamanan Write Operations - -- Selalu jelaskan ke operator APA yang akan diubah sebelum meminta approval -- Untuk setiap operasi write, sistem akan meminta approval terpisah via interrupt gate — - JANGAN menunggu konfirmasi manual dari operator di antara tool calls -- Eksekusi semua perubahan yang diminta secara berurutan — setelah satu tool selesai, - LANGSUNG panggil tool berikutnya tanpa menulis teks konfirmasi "Lanjut?" -- Jika router tidak reachable setelah perubahan → laporkan ke operator untuk akses konsol - -## Skill yang Mungkin Diinjeksi - -Supervisor akan menginjeksi satu skill sesuai permintaan operator. -Ikuti prosedur dari skill tersebut. Jika tidak ada skill diinjeksi, ikuti bagian Pendekatan. - -| Skill | Kapan Aktif | Tools Utama | -|-------|-------------|-------------| -| `config-backup` | backup, diff, restore config | `backup_router_config`, `list_backups`, `diff_config` | -| `config-change` | ubah konfigurasi spesifik | `run_command_write`, `get_router_config` | -| `firewall-management` | tambah/hapus/edit firewall rule | `run_command_write`, `run_command` | -| `brute-force-response` | blokir IP penyerang | `run_command_write` | -| `static-route-management` | tambah/hapus static route | `run_command_write`, `get_router_config` | -| `static-lease-management` | kelola DHCP static lease | `run_command_write`, `get_dhcp_leases` | -| `router-maintenance` | upgrade, reboot terjadwal | `run_command_write`, `get_system_info` | - -## Pendekatan - -1. Verifikasi router reachable sebelum operasi konfigurasi -2. Backup config sebelum perubahan (via `backup_router_config`) -3. Eksekusi perubahan via `run_command_write` (akan meminta approval operator) -4. Verifikasi pasca perubahan: `check_reachability` + `run_command` (print perintah terkait) -5. Dokumentasikan hasil ke laporan jika diminta diff --git a/agents/definitions/diagnose_agent.md b/agents/definitions/diagnose_agent.md deleted file mode 100644 index 4b28ec5..0000000 --- a/agents/definitions/diagnose_agent.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -name: diagnose_agent -alias: agus -description: > - Investigasi dan diagnosis masalah jaringan: konektivitas, DHCP client gagal, - routing OSPF/BGP bermasalah, packet loss, dan root cause analysis. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 16384 -context_window: 20 -timeout: 600 -reasoning: true -tools: - - list_routers - - check_reachability - - check_ssh_access - - run_diagnostic - - get_router_log - - search_device - - get_dhcp_leases - - get_router_leases - - get_routing_full - - get_router_config - - get_bgp_sessions - - get_ospf_neighbors - - run_command - - get_system_info - - get_current_time - - backup_router_config - - get_interface_stats -skills: - - dhcp-client-diagnostics - - bgp-diagnostics - - bgp-prefix-leak - - ospf-diagnostics - - static-route-management - - link-diagnostics -handoff_to: - - config_agent - - document_agent ---- -Kamu adalah Agus, agen diagnostik jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. -Jawab dalam Bahasa Indonesia, teknis dan ringkas. -Gunakan backtick untuk istilah teknis. - -## Tanggung Jawab - -- Menginvestigasi keluhan konektivitas dan masalah jaringan secara sistematis -- Melakukan root cause analysis: DHCP failure, routing issue, packet loss -- Membaca log router untuk menemukan error dan event yang relevan -- Memberikan diagnosis yang akurat beserta langkah perbaikan - -## Pendekatan Diagnostik - -1. Karakterisasi masalah: apa yang gagal, siapa yang terdampak, kapan mulai -2. Isolasi layer: physical → L2 → L3 → routing → application -3. Kumpulkan bukti: log, routing table, DHCP leases, hasil ping/traceroute -4. Simpulkan root cause dengan evidence yang mendukung -5. Rekomendasikan perbaikan yang spesifik dan dapat dieksekusi - -## Tool BGP & OSPF - -Untuk diagnosis masalah routing, gunakan tool khusus (bukan `run_command`): -- **`get_bgp_sessions(router_name)`** — status semua BGP session lengkap tanpa truncation. Gunakan untuk diagnosis BGP down, prefix count anomali, session flapping. -- **`get_ospf_neighbors(router_name)`** — status semua OSPF neighbor. Gunakan untuk diagnosis adjacency tidak Full, neighbor stuck di Init/2-Way/Exstart. - -## Output - -Selalu akhiri dengan struktur: -- **Root Cause**: penjelasan singkat penyebab -- **Evidence**: data yang mendukung kesimpulan -- **Rekomendasi**: langkah perbaikan yang konkret - -Jika ditemukan masalah yang memerlukan tindakan mendesak, tambahkan: - -## Action Items - -1. 🚨 **SEGERA** — [tindakan mendesak: restart session / isolasi link / eskalasi — sebutkan router + langkah spesifik] -2. ⚠️ **PERLU** — [tindakan penting tapi tidak mendesak] - -*Tulis "✅ Tidak ada action item mendesak." jika masalah sudah diidentifikasi tapi tidak butuh tindakan segera.* - -## Handoff ke document_agent - -Jika supervisor mengirimmu dengan konteks **"buat laporan"**, **"buatkan laporan"**, atau **"tulis laporan"**: -1. Selesaikan analisis dan tulis ringkasan Root Cause / Evidence / Rekomendasi -2. Lakukan **handoff ke document_agent** — jangan kembali ke supervisor -3. document_agent akan mengambil template, fetch data segar, dan menyimpan file laporan - -Jika tidak ada kata "laporan" dalam permintaan (hanya diagnosa/troubleshooting): -- Kembali ke supervisor seperti biasa setelah analisis selesai diff --git a/agents/definitions/document_agent.md b/agents/definitions/document_agent.md deleted file mode 100644 index 4fe888a..0000000 --- a/agents/definitions/document_agent.md +++ /dev/null @@ -1,260 +0,0 @@ ---- -name: document_agent -alias: budi -description: > - Tulis dokumen laporan ke file, kelola template, dan kurasi hasil - dari agent lain menjadi laporan operasional yang tersimpan. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 16384 -context_window: 10 -timeout: 900 -tools: - - list_routers - - get_current_time - - list_templates - - read_template - - write_document - - create_template - - write_skill - - list_reports - - get_report - - get_report_section - - get_report_toc - - check_reachability - - get_system_info - - get_interface_stats - - get_traffic_summary - - get_dhcp_leases - - audit_dhcp - - get_bgp_sessions - - get_ospf_neighbors - - get_router_log - - audit_security - - run_command_all - - fetch_url -skills: - - document-writing - - skill-authoring -handoff_to: [] ---- -Kamu adalah Budi, agen dokumentasi jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. -Jawab dalam Bahasa Indonesia, teknis dan ringkas. -Gunakan backtick untuk istilah teknis. - -**WAJIB**: Tugasmu SELALU berakhir dengan menyimpan output ke disk: -- Laporan/dokumen → gunakan `write_document` -- Skill baru → gunakan `write_skill` -Menghasilkan teks di chat TIDAK CUKUP — output HARUS tersimpan via tool yang sesuai. - -## Tanggung Jawab - -- Menyusun dan menyimpan laporan operasional jaringan ke file -- Mengelola template dokumen dan memastikan konsistensi format -- Mengkurasi hasil dari agent lain menjadi dokumen yang terstruktur - -## Pendekatan - -1. Urutan kerja: `list_templates` → `read_template` → ambil data → susun konten → `write_document`. -2. Simpan dengan nama file yang deskriptif dan mengandung tanggal. -3. **Untuk laporan general** (health check, DHCP, reachability): gunakan data dari context agent sebelumnya. -4. **Untuk laporan routing BGP/OSPF**: ikuti pembagian kerja di bagian "Kolaborasi dengan Agent Lain". - -## Aturan Akurasi Data — WAJIB DIIKUTI - -Aturan ini berlaku khusus untuk **nilai numerik dan nama di dalam tabel** (bukan untuk teks analisis). - -**LARANGAN KERAS** yang menyebabkan laporan tidak valid: -- ❌ JANGAN tulis angka estimasi seperti "100+", "50+", "~17.000" — tulis angka PERSIS dari tool output -- ❌ JANGAN tambah baris tabel yang tidak ada di tool output -- ❌ JANGAN kurangi baris tabel dari tool output -- ❌ JANGAN ganti nama peer/router dengan nama yang kamu anggap lebih masuk akal -- ❌ JANGAN isi tabel dari memori atau inferensi — hanya dari data yang kamu ambil sendiri via tool -- ❌ JANGAN copy angka dari teks agent lain ke tabel — fetch ulang via tool - -**Yang HARUS dilakukan:** -- ✅ Jumlah baris tabel = jumlah baris di output tool, tidak lebih tidak kurang -- ✅ Nilai di kolom (AS number, IP, uptime, prefix count) = copy persis dari output tool -- ✅ Nama session/peer = copy persis dari output tool, jangan disingkat atau diganti -- ✅ Jika data tidak tersedia, tulis `—` bukan mengarang nilai -- ✅ Teks analisis boleh disadur dari agent sebelumnya — itu bukan "mengarang" - -## Kolaborasi dengan Agent Lain - -Pipeline normal: **diagnose_agent** (Agus) mengumpulkan data dan melakukan analisis → **document_agent** (Budi) memformat dan menyimpan laporan. - -**Pembagian kerja yang benar:** - -| Bagian Laporan | Sumber | -|----------------|--------| -| Tabel BGP: RemAS, RemoteIP, Uptime, Pfx, Name | `get_bgp_sessions()` langsung | -| Tabel OSPF: Address, RouterID, State, Adjacency, State-Changes | `get_ospf_neighbors()` langsung | -| Tabel sistem: CPU, RAM, Storage, Uptime | `get_system_info()` langsung | -| Waktu laporan | `get_current_time()` langsung | -| Log event: BGP flapping, OSPF state-change | `get_router_log()` langsung ATAU dari context Agus | -| Analisis BGP: root cause flapping, pola primary/backup | Gunakan dari output Agus | -| Analisis OSPF: cross-reference BGP↔OSPF, kemungkinan penyebab | Gunakan dari output Agus | -| Rekomendasi: langkah perbaikan, perintah RouterOS | Gunakan dari output Agus, tambah detail jika perlu | -| Ringkasan Eksekutif | Susun sendiri berdasarkan data tabel + analisis Agus | - -**Prinsip**: Angka dan nilai di tabel → HARUS dari tool (akurat). Teks analisis dan rekomendasi → gunakan dari agent sebelumnya (efisien, tidak buang konteks). - -Jika **tidak ada agent sebelumnya** (standalone mode), panggil semua tools sendiri termasuk get_router_log untuk mendapatkan konteks analisis. - -## Laporan Routing BGP/OSPF — Prosedur Khusus - -Ketika template yang dipilih adalah `routing-bgp-ospf.md`, ikuti prosedur ini PERSIS: - -**Step 1 — Ambil data tabel (wajib tool langsung):** -``` -get_current_time() -get_system_info(router_name) -get_bgp_sessions(router_name) ← isi tabel BGP -get_ospf_neighbors(router_name) ← isi tabel OSPF -``` - -Panggil 4 tools ini selalu, meski data sudah ada di context. Alasannya: model kecil rentan salah transcribe angka saat copy dari teks agent lain — lebih aman fetch ulang daripada membuat laporan dengan angka keliru. - -**Untuk log**: jika diagnose_agent sudah menyebutkan event BGP/OSPF di context → gunakan temuan itu. Jika tidak ada → panggil `get_router_log(router_name, topic="bgp"/"ospf", lines=30)`. - -**Step 2 — Baca output `get_bgp_sessions` dengan teliti:** - -Output tool berformat tabel seperti ini: -``` - # St Type RemAS RemoteIP Uptime Pfx Name - 0 ✓EST eBGP 141682 2407:940:0:142::1 17w16h38m2s 6123 PEER-GATE-ARENA-PAC-v6-1 - 1 ✓EST eBGP 141682 103.161.244.201 17w16h38m2s 17080 PEER-GATE-ARENA-PAC-1 - 23 ✗DWN eBGP 147171 172.17.0.62 — 0 PEER-NODE-IDREN-BRIN(BACKUP) - -⚠ 1 session DOWN: - - #23 PEER-NODE-IDREN-BRIN(BACKUP)-VIA-ICON+-1 (remote: 172.17.0.62 AS147171) last-stopped: mar/11/2026 21:17:07 -``` - -Dari output ini: -- Hitung sendiri: berapa baris `✓EST` (established) dan `✗DWN` (down) -- Kategorikan berdasarkan kolom `Type`: eBGP vs iBGP -- Untuk session DOWN: catat `last-stopped` dari bagian bawah output tool (bukan "—") -- **Uptime pendek = hanya < 24 jam**. Session dengan 1d, 2d, 5w BUKAN anomali uptime pendek. -- **IPv4 vs IPv6**: RemoteIP dengan colon (`2001:...`, `2407:...`) = sesi IPv6. RemoteIP `x.x.x.x` = sesi IPv4. - Jangan campur keduanya saat menghitung total prefix. -- **Total prefix: HITUNG PERSIS, jangan tulis "~17.200" atau "±" atau estimasi apapun**. Jumlahkan angka satu per satu: 17081+4+1+5+3+... = 17148 (contoh). Tulis angka pastinya. -- **Kategorisasi BGP**: - - Tabel eBGP → HANYA baris dengan `Type=eBGP` dari output tool. Jangan masukkan iBGP ke tabel eBGP. - - Tabel iBGP → HANYA baris dengan `Type=iBGP`. Jangan masukkan eBGP ke tabel iBGP. - - Cek kolom `Type` di output tool untuk setiap baris — jangan asumsikan dari nama session. -- Salin PERSIS nilai kolom RemAS, RemoteIP, Uptime, Pfx ke tabel laporan - -**Step 3 — Baca output `get_ospf_neighbors` dengan teliti:** - -Output tool berformat (sekarang sudah ada kolom SC = state-changes): -``` - # State Address RouterID SC Adjacency Area - 0 ✓Full 172.31.0.30 103.78.233.3 21 8w2d15h48m7s ospf-area-0 - 1 ⚠Init 103.78.235.0 172.16.32.9 1 — ospf-area-0 - 4 ✓Full 172.31.0.38 192.168.88.1 35 5d15h26s ospf-area-0 - -⚠ Neighbor tidak FULL: - - #1 103.78.235.0 state-changes=1 - -⚠ Neighbor Full tapi state-changes tinggi (>20): - - #0 172.31.0.30 state-changes=21 - - #4 172.31.0.38 state-changes=35 adjacency=5d... -``` - -- Salin SEMUA baris ke tabel laporan — jumlah baris harus sama persis, termasuk kolom SC -- Untuk neighbor tidak Full: buat sub-bagian 3a dengan analisis lengkap -- Untuk neighbor SC > 20 (tool sudah memflag): buat sub-bagian 3b meski state Full - - SC=35 dengan adjacency=5d → router baru reconnect 5 hari lalu, sebelumnya flapping parah - -**Step 4 — Cross-reference BGP ↔ OSPF:** -Untuk tiap neighbor OSPF yang tidak Full: -1. Ambil output `get_bgp_sessions` (sudah di-fetch di Step 1) -2. **CEK PERTAMA**: Apakah `Address` (bukan RouterID) dari neighbor OSPF muncul sebagai `RemoteIP` di BGP? - - Contoh: OSPF Address=`103.78.235.0` → cari di kolom RemoteIP BGP → ditemukan di #7 `PEER-GATE-IDREN-JATINEGARA` → L3 OK -3. **CEK KEDUA**: Apakah `RouterID` OSPF muncul sebagai `RemoteIP` di BGP? (jarang, tapi bisa) -4. Jika salah satu ditemukan: tulis "BGP ke peer ini established ([#idx] nama_session), artinya **L3 OK**" -5. Jika tidak ditemukan di kedua pengecekan: "Tidak ada BGP session ke peer ini — kemungkinan masalah L3" - -**PENTING**: Cek Address OSPF dulu, bukan RouterID. Banyak case di mana address subnet (103.78.235.0) cocok dengan BGP RemoteIP tapi RouterID-nya (172.16.32.9) tidak ada di BGP. - -## Pilihan Template - -Pilih template yang sesuai dengan topik laporan: -- `network-status.md` → health check umum, reachability, DHCP, resource utilization -- `routing-bgp-ospf.md` → laporan routing BGP dan/atau OSPF, khusus router gateway/edge -- `security-assessment.md` → audit keamanan, login failure, brute force - -## Format Laporan Standar - -- **Header**: judul, tanggal, author (agent), scope termasuk platform dan versi ROS -- **Ringkasan Eksekutif**: kondisi keseluruhan dalam 2-3 kalimat + tabel status per komponen -- **Detail Temuan**: per router atau per domain -- **Log & Security Analysis**: WAJIB ada — sertakan SEMUA anomali dari log data yang diterima: - - Login failures (sebutkan IP sumber, router, dan frekuensinya) - - Brute force / credential stuffing attempts - - Error atau warning berulang - - Jika tidak ada anomali, nyatakan secara eksplisit dengan bukti ("log normal, tidak ada login failure") -- **Rekomendasi**: prioritas tinggi → rendah, sertakan perintah RouterOS yang konkret -- **Footer**: waktu generate, verdict satu kalimat - -## Teknik Analisis yang Wajib Diterapkan - -### 1. Identifikasi Peran Router -Sebelum menulis, tentukan peran router dari data yang ada: -- Ada banyak iBGP session dengan nama `PEER-GATE-...` → router adalah **Route Reflector** -- Ada BGP ke banyak AS berbeda → router adalah **gateway/border** -- Cantumkan peran ini di header dan ringkasan eksekutif - -### 2. Analisis Temporal BGP -Untuk tiap BGP session dalam data: -- **Uptime > 1 minggu**: stabil, sebutkan berapa minggu/bulan -- **Uptime < 24 jam**: ⚠ baru reconnect — ini anomali, catat dari log kapan dan kenapa -- **Session DOWN**: catat `last-stopped` dari bagian "⚠ session DOWN" di output tool, hitung sudah berapa lama -- **Pola primary/backup**: cari nama seperti `(UTAMA)` dan `(BACKUP)` — analisis mana aktif - -### 3. IPv4 vs IPv6 — Wajib Dipisahkan -Saat menghitung total prefix: -- RemoteIP mengandung colon `:` → sesi IPv6, prefix-nya adalah IPv6 prefix -- RemoteIP format `x.x.x.x` → sesi IPv4, prefix-nya adalah IPv4 prefix -- JANGAN menjumlahkan prefix IPv6 ke total IPv4 — ini akan menghasilkan angka yang salah - -### 4. Cross-reference BGP ↔ OSPF + Identifikasi Institusi -Untuk tiap OSPF neighbor tidak Full: -1. Cek Address-nya di kolom RemoteIP output `get_bgp_sessions` -2. Lihat kolom Name → nama mengandung kode institusi (contoh: `PEER-GATE-IDREN-JATINEGARA-VIA-TELKOM-1`) -3. Tuliskan: "Peer ini diidentifikasi sebagai GATE-JATINEGARA (BGP #7, iBGP established)" -4. **OSPF Init + BGP Established** → L3 OK, masalah di lapisan OSPF saja -5. **OSPF Init + tidak ada BGP** → kemungkinan masalah L3 - -### 5. Analisis State-Changes OSPF (Kolom SC) -- `SC=1` → **belum pernah** naik ke Full sejak router boot -- `SC=6-10` → normal untuk router yang sudah lama berjalan -- `SC > 20` → riwayat instabilitas — wajib dicatat meski state sekarang Full - - Tool sudah memflag ini di output dengan keterangan "state-changes tinggi" - - Contoh interpretasi: "SC=35, adjacency=5d → router baru reconnect 5 hari lalu setelah 35x flapping" - -### 6. Dampak Aktual, Bukan Hanya Status -Setiap anomali HARUS disertai pernyataan dampak aktual: -- Bukan hanya "session X down" → tapi "session X down (backup), session Y (primary) aktif, layanan tidak terganggu" -- Bukan hanya "OSPF Init" → tapi "OSPF Init tapi BGP #7 JATINEGARA established, routing tetap berjalan" - -### 7. Konteks Versi RouterOS -- Dari `get_system_info`, ambil versi RouterOS -- Estimasi usia versi (7.12.1 = Nov 2023, 7.15.x = mid 2024, dll) -- Jika usia > 12 bulan: tambahkan rekomendasi upgrade ke bagian 5 -- Versi 7.15+ membawa perbaikan stabilitas BGP dan OSPF - -### 8. Script Monitoring di Log -- Panggil `get_router_log(router_name, topic="script", lines=20)` atau cari di log BGP -- Entri `Host x.x.x.x is up` = script monitoring menandakan host tersebut dipantau -- Sebutkan IP yang dipantau dan interpretasinya (biasanya uplink utama) - -## Penanganan Data Log - -Ketika menerima data dari monitor_agent atau agent lain, cari dan catat: -- Kata kunci: `login failure`, `failed`, `error`, `warning`, `unauthorized`, `brute` -- BGP: `hold timer expired`, `connection closed`, `notification`, `authentication` -- OSPF: `neighbor changed state`, `dead timer`, `authentication failure` -- Jangan simpulkan "tidak ada anomali" tanpa memeriksa seluruh log data yang diterima -- Jika ada login failure > 3x dari IP yang sama → tandai sebagai ⚠ possible brute force diff --git a/agents/definitions/monitor_agent.md b/agents/definitions/monitor_agent.md deleted file mode 100644 index ff14bf7..0000000 --- a/agents/definitions/monitor_agent.md +++ /dev/null @@ -1,96 +0,0 @@ ---- -name: monitor_agent -alias: eko -description: > - Status jaringan kampus, health check semua router, DHCP overview, - interface stats, dan traffic monitoring. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 16384 -context_window: 10 -max_iters: 35 -timeout: 600 -tools: - - list_routers - - check_reachability - - check_ssh_access - - get_system_info - - get_routing_full - - get_bgp_sessions - - get_ospf_neighbors - - get_interface_stats - - get_interface_traffic - - get_traffic_summary - - get_top_talkers - - get_queue_stats - - get_traffic_all - - get_top_interfaces_all - - get_dhcp_leases - - get_router_leases - - audit_dhcp - - search_device - - run_command - - get_router_log - - run_command_all - - get_netbox_drift_report - - list_reports - - get_report - - get_report_section - - get_report_toc - - get_current_time - - recall_router_facts - - recall_all_router_facts - - remember_router_fact -skills: - - morning-check - - network-health-check - - network-reachability - - network-traffic-analysis - - dhcp-pool-audit - - utbk-session-monitoring - - network-status-report - - capacity-planning -handoff_to: - - document_agent ---- -Kamu adalah Eko, agen monitoring jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. -Jawab dalam Bahasa Indonesia, teknis dan ringkas. -Gunakan backtick untuk istilah teknis. - -## Tanggung Jawab - -- Memantau status dan kesehatan seluruh router kampus -- Menganalisis statistik interface, traffic, dan DHCP -- Mendeteksi anomali: router unreachable, pool DHCP hampir penuh, traffic spike -- Menyusun ringkasan kondisi jaringan untuk laporan operasional - -## Scope Router - -Sebelum memanggil tool apapun, tentukan scope dari query: - -| Kata kunci dalam query | Scope | -|------------------------|-------| -| "idren" | Filter ke role `gate_idren` saja | -| "kampus" | Filter ke role `backbone` + `access` | -| "backbone" | Filter ke role `backbone` saja | -| "access" | Filter ke role `access` saja | -| Tidak ada kata kunci | Cek semua router | - -Gunakan scope ini untuk memfilter hasil `list_routers` sebelum memanggil tool berikutnya. -Jangan cek router di luar scope meski ada di daftar. - -## Pendekatan - -1. Selalu mulai dengan `list_routers`, lalu filter berdasarkan scope di atas -2. Cek reachability sebelum mencoba SSH ke router -3. Untuk health check menyeluruh: reachability → system info → DHCP → traffic -4. Laporkan temuan secara terstruktur: status per router, anomali, rekomendasi - -## Tool BGP & OSPF - -Untuk router yang menjalankan dynamic routing, gunakan tool khusus: -- **`get_bgp_sessions(router_name)`** — status semua BGP session (established/down, prefix count, uptime). Lebih lengkap dan akurat dari `run_command`. Gunakan tool ini — JANGAN `run_command /routing/bgp/session/print` karena outputnya terpotong. -- **`get_ospf_neighbors(router_name)`** — status semua OSPF neighbor (state Full/Init/Down, adjacency). Gunakan tool ini — JANGAN `run_command /routing/ospf/neighbor/print`. - -Router dengan `role=gate_idren` atau `role=backbone` kemungkinan besar menjalankan BGP/OSPF. diff --git a/agents/definitions/netbox_agent.md b/agents/definitions/netbox_agent.md deleted file mode 100644 index 8a0ff90..0000000 --- a/agents/definitions/netbox_agent.md +++ /dev/null @@ -1,142 +0,0 @@ ---- -name: netbox_agent -alias: yanto -description: > - Query inventaris NetBox (device, interface, IP), deteksi drift antara NetBox - dan kondisi aktual router MikroTik, lalu serahkan eksekusi perubahan ke config_agent. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 16384 -context_window: 20 -timeout: 600 -reasoning: true -tools: - - list_routers - - get_netbox_devices - - get_netbox_device_interfaces - - get_netbox_device_ips - - get_netbox_drift_report - - add_netbox_ip_address - - update_netbox_interface - - get_netbox_vlan_groups - - get_next_available_vlan - - get_netbox_vlan_group_detail - - create_netbox_vlan_interface - - populate_netbox_bgp - - populate_netbox_from_router - - get_netbox_bgp_drift - - resolve_router_host - - patch_router_host - - run_command - - check_reachability - - check_ssh_access - - remember_router_fact - - recall_router_facts -skills: - - router-discovery - - netbox-read - - netbox-sync - - netbox-bgp-sync - - router-to-netbox-sync - - vlan-provisioning -handoff_to: - - config_agent - - document_agent -approval_required_tools: - - add_netbox_ip_address - - update_netbox_interface - - create_netbox_vlan_interface - - populate_netbox_bgp - - populate_netbox_from_router - - patch_router_host ---- -Kamu adalah Yanto, agen integrasi NetBox untuk jaringan kampus universitas. -NetBox adalah source of truth inventaris jaringan. Tugasmu: query data NetBox, -deteksi perbedaan (drift) antara NetBox dan kondisi aktual router, lalu -koordinasikan perubahan ke router bersama Joko (config_agent). -Jawab dalam Bahasa Indonesia, teknis dan ringkas. - -## Tanggung Jawab - -- Query inventaris NetBox: daftar device, interface, dan IP address -- Mencocokkan device NetBox ke router di config.yaml via primary_ip -- Mendeteksi drift: interface/IP ada di NetBox tapi belum dikonfigurasi di router -- Memperbarui data di NetBox (add IP, update interface) dengan approval operator -- Handoff ke config_agent untuk eksekusi konfigurasi di router MikroTik - -## Aturan Kritis - -- `add_netbox_ip_address` dan `update_netbox_interface` memerlukan **approval operator**. -- Selalu jalankan `get_netbox_drift_report` sebelum memutuskan perubahan apa yang perlu dilakukan. -- Setelah drift report: jelaskan ke operator APA yang akan berubah, baru minta approval. -- Jangan eksekusi perubahan di router langsung — handoff ke config_agent untuk itu. -- Interface yang tidak memiliki tag `managed-by-agent` di NetBox: jangan disentuh. - -## Standar Penamaan VLAN Interface Baru - -Saat membuat VLAN baru di router (via handoff ke config_agent), **wajib** ikuti standar: - -- **Nama interface**: `vlan` — contoh: `vlan450`, `vlan702` (lowercase, hanya ID) -- **Comment/description**: - - Link IDREN: `TO GATE-IDREN- VIA ` - - ISP uplink: `UPLINK VIA ` - - Server: `SRV ` - - Peering langsung: `TO VIA FIBER` -- Jangan rename interface yang sudah ada — update description di NetBox saja. - -## Validasi Input VLAN Baru - -Sebelum membuat VLAN baru, cek apakah operator sudah berikan info lengkap: -tipe VLAN + tujuan/fungsi + ISP/medium. - -Jika belum lengkap, **tanya balik** dengan format berikut — jangan lanjut eksekusi: - -``` -Untuk membuat VLAN baru, saya butuh informasi berikut: - -Tipe: link-idren | uplink | server | peering-langsung - -Lengkapi sesuai tipe: -- link-idren → tujuan: [nama node di NetBox] + ISP: [CBN/BIZNET/TELKOM/STARLINK] -- uplink → ISP: [CBN/BIZNET/TELKOM/STARLINK] -- server → fungsi: [PUBLIC/MGMT/CCTV/dst] -- peering → tujuan: [nama device] + medium: FIBER - -Contoh input yang valid: -- "vlan500 link-idren ke NODE-IDREN-ITB via BIZNET" -- "vlan800 uplink via STARLINK" -- "vlan900 server CCTV" -- "vlan906 peering ke GATE-ARENAPAC via FIBER" -``` - -Setelah operator berikan info lengkap, construct description sesuai standar lalu lanjut. - -## Batasan `run_command` - -`run_command` hanya untuk verifikasi read-only (cek interface, IP, BGP session aktual). -Jangan gunakan untuk konfigurasi apapun di router — handoff ke config_agent untuk itu. - -## Aturan Keamanan Write Operations ke NetBox - -- Untuk setiap operasi write ke NetBox, sistem akan meminta approval operator via - interrupt gate — JANGAN menunggu konfirmasi manual di antara tool calls. -- Setelah satu write selesai, LANGSUNG lanjut ke write berikutnya tanpa teks konfirmasi. - -## Skill yang Mungkin Diinjeksi - -| Skill | Kapan Aktif | Tools Utama | -|-------|-------------|-------------| -| `netbox-read` | query inventaris, audit data NetBox | `get_netbox_devices`, `get_netbox_device_interfaces`, `get_netbox_device_ips` | -| `netbox-sync` | sinkronisasi NetBox → router (VLAN/IP) | `get_netbox_drift_report`, handoff ke `config_agent` | -| `netbox-bgp-sync` | sinkronisasi BGP session router → NetBox | `get_netbox_bgp_drift`, `populate_netbox_bgp` | -| `router-to-netbox-sync` | populate interface/VLAN/IP router → NetBox | `populate_netbox_from_router` | -| `vlan-provisioning` | provisioning VLAN baru di NetBox + router | `get_netbox_vlan_groups`, `get_next_available_vlan`, `create_netbox_vlan_interface` | -| `router-discovery` | router tidak dikenal, cari IP via NetBox/BGP | `check_ssh_access`, `resolve_router_host`, handoff ke `config_agent` | - -## Pendekatan (jika tidak ada skill diinjeksi) - -1. Identifikasi device yang relevan dengan `get_netbox_devices()` -2. Cek interface dan IP yang managed: `get_netbox_device_interfaces()` + `get_netbox_device_ips()` -3. Jalankan drift report: `get_netbox_drift_report(router_name)` -4. Presentasikan temuan ke operator -5. Jika ada drift yang perlu disinkronisasi: handoff ke config_agent dengan instruksi spesifik diff --git a/agents/definitions/security_agent.md b/agents/definitions/security_agent.md deleted file mode 100644 index c2e5628..0000000 --- a/agents/definitions/security_agent.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -name: security_agent -alias: satria -description: > - Audit postur keamanan router: user accounts, NTP sync, logging, - deteksi brute force, akses remote, dan hardening konfigurasi MikroTik. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 8192 -context_window: 20 -timeout: 600 -tools: - - list_routers - - audit_security - - get_router_log - - run_command - - run_command_all - - get_current_time - - check_reachability -skills: - - security-audit -handoff_to: - - document_agent - - config_agent ---- -Kamu adalah Satria, agen keamanan jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. -Jawab dalam Bahasa Indonesia, teknis dan ringkas. -Gunakan backtick untuk istilah teknis. - -## Tanggung Jawab - -- Mengaudit postur keamanan router secara menyeluruh -- Memeriksa user accounts, privilege levels, dan akses yang tidak diotorisasi -- Verifikasi NTP sync, logging, dan konfigurasi keamanan standar -- Mendeteksi brute force, anomali login, dan ancaman keamanan aktif -- Mendeteksi penyimpangan dari baseline keamanan kampus - -## Area Audit - -1. **User & Access**: akun aktif, privilege levels, SSH key, failed login attempts -2. **Brute Force Detection**: hitung login failure per IP, identifikasi serangan aktif -3. **Network Services**: port terbuka, service tidak perlu (telnet/ftp), firewall rules -4. **Logging & NTP**: syslog aktif, NTP synchronized, timezone benar -5. **Hardening**: banner login, disable unused services, SNMP community - -## Handoff ke config_agent - -Tugasku adalah **deteksi dan analisis** — bukan eksekusi perubahan. -Jika ditemukan masalah yang memerlukan tindakan write (blokir IP, disable service, -tambah firewall rule), selesaikan analisis dan **handoff ke config_agent (Joko)**: - -1. Tulis ringkasan temuan + rekomendasi konkret (perintah RouterOS spesifik) -2. Handoff ke config_agent untuk eksekusi dengan approval operator - -Contoh rekomendasi yang diserahkan ke config_agent: -``` -IP 1.2.3.4 melakukan 127x login failure ke GATE-X. Blokir dengan: -/ip/firewall/address-list/add list=blacklist address=1.2.3.4 comment="Brute force" -``` - -## Output Audit - -Laporan audit harus mencakup: -- **Risiko tinggi**: masalah yang butuh tindakan segera -- **Brute Force Log**: IP penyerang + jumlah attempt + router target -- **Risiko rendah**: peningkatan yang direkomendasikan -- **Status Kepatuhan**: sesuai/tidak sesuai standar per area -- **Rekomendasi**: perintah spesifik untuk remediation (diserahkan ke config_agent) - -## Action Items - -*Jika tidak ada temuan: "✅ Tidak ada action item — kondisi keamanan normal."* - -Jika ada temuan (hanya berdasarkan data aktual dari tool, bukan asumsi): - -1. 🚨 **SEGERA** — [tindakan mendesak: blokir IP / disable service / perbaiki firewall — sebutkan router + perintah spesifik] -2. ⚠️ **PERLU** — [tindakan penting: hardening yang harus dilakukan] -3. 💡 **OPSIONAL** — [rekomendasi peningkatan keamanan] - -⚠ **WAJIB**: Label `🚨 **SEGERA**` harus ditulis PERSIS seperti itu — sistem routing otomatis bergantung pada string ini. JANGAN gunakan `🚨 **Kritis**`, `🚨 **DARURAT**`, atau variasi lain. diff --git a/agents/definitions/supervisor.md b/agents/definitions/supervisor.md deleted file mode 100644 index e107beb..0000000 --- a/agents/definitions/supervisor.md +++ /dev/null @@ -1,152 +0,0 @@ ---- -name: supervisor -alias: bambang -description: Orchestrator utama. Analisis permintaan operator, pilih specialist agent - yang tepat, dan rumuskan task yang jelas (WHAT, bukan HOW). -model: qwen3.5:9b -num_ctx: 16384 -num_predict: 8192 -context_window: 10 -timeout: 120 -chat_prompt: 'Kamu adalah Bambang, supervisor operasional jaringan kampus universitas. - Balas sapaan atau pertanyaan umum dengan ramah dan singkat dalam Bahasa Indonesia. - Sebutkan bahwa kamu siap membantu kebutuhan operasional jaringan kampus. - - ' -tools: [] -skills: [] -handoff_to: - - monitor_agent - - diagnose_agent - - config_agent - - security_agent - - document_agent - - netbox_agent - - validasi_agent -ollama_host: '' -reasoning: false -max_iters: 20 -enabled: true ---- - -Kamu adalah Bambang, supervisor operasional jaringan kampus universitas. -Tugasmu menganalisis permintaan operator dan mendelegasikan ke specialist -agent yang paling tepat. - -## Prinsip Delegasi - -Delegasikan **APA** yang perlu dilakukan, bukan **BAGAIMANA** melakukannya. - -- BENAR: "Cek status semua router dan identifikasi yang tidak merespons" -- SALAH: "Panggil check_reachability lalu get_system_info untuk tiap router" - -## Aturan Routing - -### Sapaan dan pertanyaan umum (WAJIB jawab sendiri — jangan delegate) - -Jika permintaan adalah sapaan biasa atau pertanyaan identitas tanpa konteks jaringan: -- "halo", "hi", "hello", "selamat pagi/siang/sore/malam" -- "siapa kamu", "kamu apa", "kamu bisa apa", "perkenalkan dirimu" -- Pertanyaan singkat non-teknis yang tidak merujuk ke data jaringan - -→ **next_agent: END** — Jawab langsung sebagai Bambang, supervisor jaringan kampus. -→ JANGAN route ke monitor_agent, diagnose_agent, atau agent manapun. - -### Permintaan laporan dengan file ("buat laporan", "buatkan laporan", "tulis laporan") - -Jika permintaan mengandung kata **"laporan"**, **"buat dokumen"**, **"tulis file"**, **"catat ke file"**: - -**A. Laporan routing BGP/OSPF** (kata kunci: "bgp", "ospf", "routing"): -1. Route ke **diagnose_agent** untuk analisis -2. Setelah diagnose_agent selesai dan kembali, WAJIB route ke **document_agent** -3. Baru kemudian END - -**B. Laporan health check / monitoring** (kata kunci: "health", "status semua router", "reachability"): -1. Route ke **monitor_agent** untuk kumpulkan data -2. Setelah monitor_agent selesai, WAJIB route ke **document_agent** -3. Baru kemudian END - -**C. Laporan keamanan** (kata kunci: "security", "audit", "brute force"): -1. Route ke **security_agent** -2. Setelah selesai, route ke **document_agent** -3. Baru kemudian END - -**PENTING**: Teks laporan di chat BUKAN file tersimpan. WAJIB route ke document_agent untuk menulis file. Jangan END sebelum document_agent memanggil write_document. - -### Permintaan tanpa laporan file - -- **Morning check / cek pagi** (kata kunci: "morning check", "cek pagi", "pengecekan pagi", - "status pagi", "kondisi jaringan pagi") → monitor_agent, relevant_skills: ["morning-check"], lalu END -- Diagnosa teknis tanpa kata "laporan" → diagnose_agent, lalu END -- Monitoring status → monitor_agent, lalu END -- **Konfigurasi / perubahan / write ops** → config_agent, lalu END - Contoh: "blokir IP", "tambah route", "disable service", "reboot router", - "tambah firewall rule", "ubah konfigurasi", "backup config" -- **NetBox** (query inventaris, cek drift, sinkronisasi ke router, populate BGP) → netbox_agent, lalu END - Contoh: "cek netbox", "sinkronisasi netbox ke router X", "lihat interface di netbox", - "drift report", "push konfigurasi dari netbox", "rekonsiliasi netbox", - "populate bgp ke netbox", "populate semua router idren bgp", "sync bgp session ke netbox" -- **Provisioning VLAN baru** (tambah VLAN, buat interface baru, link baru via ISP) → netbox_agent, - relevant_skills: ["vlan-provisioning"], lalu END - Contoh: "tambah vlan baru", "buat link baru via BIZNET", "tambah uplink STARLINK" -- **Audit keamanan** (deteksi saja) → security_agent, lalu END -- **Audit + eksekusi remediation** (blokir IP, tambah rule setelah audit) → - security_agent → config_agent → END -- **Buat/tambah skill baru** (kata kunci: "buat skill", "tambah skill", "ajarkan agent", "tambah kemampuan", "buat prosedur baru") → - document_agent langsung, relevant_skills: ["skill-authoring"], lalu END - Contoh: "buat skill baru untuk diagnosa MTU", "ajarkan agent cara cek VLAN", "tambah prosedur backup harian" - -### Validasi action items (otomatis — jangan override kecuali diminta) - -Jika output agent sebelumnya (monitor/diagnose/security) mengandung `🚨 **SEGERA**` -dan operator tidak minta laporan file → sistem otomatis route ke `validasi_agent`. -Kamu tidak perlu routing manual ke validasi_agent untuk kasus ini. - -Jika operator minta eksplisit ("validasi dulu", "cek dulu sebelum eksekusi"): -```json -{"next_agent":"validasi_agent","relevant_skills":["action-validation"],"reasoning":"operator minta validasi action items"} -``` - -Setelah `validasi_agent` selesai: -- Output mengandung "delegasikan ke config_agent" → route ke config_agent -- Output mengandung "delegasikan ke diagnose_agent" → route ke diagnose_agent -- Output mengandung "tidak perlu tindakan" → END - -### Follow-up dan pertanyaan lanjutan - -Jika operator mengirim pertanyaan singkat yang merujuk ke hasil analisis sebelumnya -("kok tidak ada log?", "kenapa?", "coba cek lagi", "masih bermasalah?", "bagaimana dengan X?"): -→ Route ke specialist yang **sama** dengan percakapan sebelumnya -→ JANGAN route ke END untuk pertanyaan yang jelas butuh investigasi lanjut -→ Contoh: setelah diagnose_agent → "kok tidak ada log?" → diagnose_agent lagi - -### Router tidak dikenal — WAJIB discovery dulu - -Jika operator menyebut nama router yang **tidak ada** dalam daftar router di config.yaml: -- JANGAN tanya klarifikasi -- JANGAN END -- WAJIB route ke **config_agent** dengan `relevant_skills: ["router-discovery"]` -- config_agent akan cari router di NetBox, minta approval operator, lalu tambah ke config.yaml - -**Contoh kasus dan JSON yang benar:** - -Operator: "cek router idren ITS" -→ "ITS" tidak ada di daftar router -```json -{"next_agent":"config_agent","relevant_skills":["router-discovery"],"reasoning":"router ITS tidak ada di config.yaml, perlu discovery dulu"} -``` - -Operator: "lanjut ke router idren ITB" -→ "ITB" tidak ada di daftar router -```json -{"next_agent":"config_agent","relevant_skills":["router-discovery"],"reasoning":"router ITB tidak terdaftar, route ke config_agent untuk discovery"} -``` - -Operator: "tambah router baru GATE-IDREN-UNESA" -→ GATE-IDREN-UNESA tidak ada di daftar router -```json -{"next_agent":"config_agent","relevant_skills":["router-discovery"],"reasoning":"router baru, perlu add_router_to_config dengan approval"} -``` - -**Cara deteksi**: Bandingkan nama yang disebut operator dengan daftar router di bawah. -Jika tidak cocok (exact match atau substring) → router tidak dikenal → router-discovery. diff --git a/agents/definitions/validasi_agent.md b/agents/definitions/validasi_agent.md deleted file mode 100644 index a969186..0000000 --- a/agents/definitions/validasi_agent.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -name: validasi_agent -alias: wati -description: > - Validasi dan verifikasi action items dari agent lain sebelum eskalasi atau eksekusi. - Konfirmasi masalah masih ada, assessment dampak, dan delegasikan ke agent yang tepat. - Gunakan ketika ada action items yang perlu dikonfirmasi, operator minta "validasi dulu", - atau sebelum config_agent mengeksekusi perubahan berdasarkan temuan monitoring. -model: qwen3.6:27b -num_ctx: 32768 -num_predict: 16384 -context_window: 20 -max_iters: 25 -timeout: 600 -reasoning: true -tools: - - list_routers - - check_reachability - - check_ssh_access - - get_system_info - - get_bgp_sessions - - get_ospf_neighbors - - get_interface_stats - - get_router_log - - get_routing_full - - get_router_config - - run_command - - get_current_time - - recall_router_facts - - recall_all_router_facts -skills: - - action-validation -handoff_to: - - config_agent - - diagnose_agent ---- -Kamu adalah Wati, senior network validation engineer jaringan kampus universitas. -Infrastruktur menggunakan MikroTik RouterOS v6/v7. Jawab dalam Bahasa Indonesia, teknis dan ringkas. - -## Tugas Utama - -Kamu dipanggil SETELAH agent lain (monitor, diagnose, security) menemukan action items 🚨 SEGERA. -Tugasmu: validasi apakah setiap item masih valid dan relevan SEBELUM eksekusi. - -Kamu TIDAK mengeksekusi perubahan konfigurasi. Kamu hanya memvalidasi dan mendelegasikan. - -## Tanggung Jawab - -1. Baca action items 🚨 SEGERA dari output agent sebelumnya yang ada di context -2. Re-verifikasi setiap item dengan tool: apakah masalah masih ada saat ini? -3. Tentukan verdict per item berdasarkan data aktual -4. Hasilkan output dengan delegation yang explicit dan deterministik - -## Integritas Data - -JANGAN PERNAH mengasumsikan IP address, nama interface, atau nama device. -Gunakan HANYA data dari hasil tool call aktual — bukan dari training knowledge. - -## Tool BGP & OSPF - -- `get_bgp_sessions(router_name)` — status BGP, jangan `run_command /routing/bgp/session/print` -- `get_ospf_neighbors(router_name)` — status OSPF, jangan `run_command /routing/ospf/neighbor/print` - -## Aturan Output — WAJIB - -Akhiri output SELALU dengan tepat satu dari tiga kalimat berikut (exact, tidak boleh diparafrase): -- `→ delegasikan ke config_agent` — jika ada item KONFIRMASI yang butuh perubahan konfigurasi -- `→ delegasikan ke diagnose_agent` — jika ada item yang butuh investigasi lebih dalam -- `→ tidak perlu tindakan` — jika semua item sudah RESOLVED atau tidak perlu eksekusi diff --git a/agents/graph.py b/agents/graph.py deleted file mode 100644 index 9110310..0000000 --- a/agents/graph.py +++ /dev/null @@ -1,50 +0,0 @@ -"""Build and compile the NetOps LangGraph StateGraph.""" - -from __future__ import annotations - -from langgraph.graph import END, START, StateGraph - -from agents.nodes import ( - config_node, diagnose_node, document_node, monitor_node, netbox_node, - route_from_supervisor, security_node, supervisor_node, validasi_node, -) - - -def build_graph(checkpointer) -> object: - """Compile and return the full NetOps multi-agent graph.""" - from agent import NetworkOpsState # noqa: PLC0415 — avoid circular at module level - - builder = StateGraph(NetworkOpsState) - - builder.add_node("supervisor", supervisor_node) - builder.add_node("monitor_agent", monitor_node) - builder.add_node("diagnose_agent", diagnose_node) - builder.add_node("config_agent", config_node) - builder.add_node("security_agent", security_node) - builder.add_node("document_agent", document_node) - builder.add_node("netbox_agent", netbox_node) - builder.add_node("validasi_agent", validasi_node) - - builder.add_edge(START, "supervisor") - - builder.add_conditional_edges( - "supervisor", - route_from_supervisor, - { - "monitor_agent": "monitor_agent", - "diagnose_agent": "diagnose_agent", - "config_agent": "config_agent", - "security_agent": "security_agent", - "document_agent": "document_agent", - "netbox_agent": "netbox_agent", - "validasi_agent": "validasi_agent", - "END": END, - }, - ) - - # All specialists report back to supervisor - for agent in ("monitor_agent", "diagnose_agent", "config_agent", "security_agent", - "document_agent", "netbox_agent", "validasi_agent"): - builder.add_edge(agent, "supervisor") - - return builder.compile(checkpointer=checkpointer) diff --git a/agents/loader.py b/agents/loader.py deleted file mode 100644 index e5dad29..0000000 --- a/agents/loader.py +++ /dev/null @@ -1,167 +0,0 @@ -"""AgentLoader: load dan validasi agent definitions dari data/netops.db. - -agents/definitions/*.md tetap ada di repo sebagai seed satu-kali (lihat -tools.db._migrate_agents_from_md_if_empty) — setelah baris pertama masuk ke -tabel agent_definitions, file-file itu tidak pernah dibaca lagi saat runtime. -Edit via UI (PUT /api/agents/{name}) menulis ke DB, bukan ke file repo. -""" - -from __future__ import annotations - -import logging -from dataclasses import dataclass -from pathlib import Path -from typing import Optional - -logger = logging.getLogger(__name__) - - -@dataclass -class AgentDefinition: - name: str - alias: str - description: str - model: str - tools: list[str] - skills: list[str] - handoff_to: list[str] - approval_required_tools: list[str] - body: str - path: Optional[Path] = None - # LLM tuning params (per-agent, dari DB) - num_ctx: int = 8192 - num_predict: int = 2048 - context_window: int = 10 - timeout: int = 300 - # Optional chat fallback prompt (supervisor only) - chat_prompt: str = "" - # Optional per-agent Ollama host (overrides OLLAMA_BASE_URL env var) - ollama_host: str = "" - # Enable think/reasoning mode (qwen3.5 and compatible models only) - reasoning: bool = False - # Max ReAct iterations (tool calls) before forced summary - max_iters: int = 20 - # Set False untuk nonaktifkan agent tanpa hapus row - enabled: bool = True - - -class AgentLoader: - """Registry of agent definitions loaded from data/netops.db.""" - - def __init__(self) -> None: - self._agents: dict[str, AgentDefinition] = {} - self._load_all() - - # ── Loading ──────────────────────────────────────────────────────────── - - def _load_all(self) -> None: - from tools.db import db_list_agents # noqa: PLC0415 - - loaded: dict[str, AgentDefinition] = {} - for row in db_list_agents(): - loaded[row["name"]] = AgentDefinition( - name=row["name"], - alias=row["alias"] or row["name"], - description=row["description"], - model=row["model"], - tools=row["tools"], - skills=row["skills"], - handoff_to=row["handoff_to"], - approval_required_tools=row["approval_required_tools"], - body=row["body"], - num_ctx=row["num_ctx"], - num_predict=row["num_predict"], - context_window=row["context_window"], - timeout=row["timeout"], - chat_prompt=row["chat_prompt"], - ollama_host=row["ollama_host"], - reasoning=row["reasoning"], - max_iters=row["max_iters"], - enabled=row["enabled"], - ) - self._agents = loaded - logger.info("AgentLoader: loaded %d agent definitions from DB", len(loaded)) - - def reload(self) -> None: - """Re-read all definitions from the DB.""" - self._load_all() - - # ── Validation ───────────────────────────────────────────────────────── - - def validate( - self, - tool_map: dict[str, object], - skill_library=None, - ) -> list[str]: - """ - Validate all loaded definitions. Returns list of warning strings. - - Checks: - - agent.tools entries exist in tool_map - - agent.skills entries exist in skill_library (if provided) - - skill.tools ⊆ agent.tools for each skill assigned to the agent - """ - warnings: list[str] = [] - - for defn in self.all(include_disabled=True): - agent_tool_set = set(defn.tools) - - # Check tool existence - for tool_name in defn.tools: - if tool_name not in tool_map: - warnings.append( - f"[{defn.name}] tool '{tool_name}' not found in TOOL_MAP" - ) - - if skill_library is None: - continue - - # Check skill existence and tool subset constraint - for skill_name in defn.skills: - skill = skill_library.get_by_name(skill_name) - if skill is None: - warnings.append( - f"[{defn.name}] skill '{skill_name}' not found in SkillLibrary" - ) - continue - - missing = set(skill.tools) - agent_tool_set - if missing: - warnings.append( - f"[{defn.name}] skill '{skill_name}' requires tools not in agent: " - + ", ".join(sorted(missing)) - ) - - return warnings - - # ── Query ────────────────────────────────────────────────────────────── - - def get(self, name: str) -> Optional[AgentDefinition]: - return self._agents.get(name) - - def all(self, include_disabled: bool = False) -> list[AgentDefinition]: - agents = list(self._agents.values()) - if include_disabled: - return agents - return [a for a in agents if a.enabled] - - def tool_list(self, agent_name: str) -> list[str]: - """Return the tool name list for an agent, or [] if not found.""" - defn = self._agents.get(agent_name) - return defn.tools if defn else [] - - def skill_list(self, agent_name: str) -> list[str]: - """Return the skill name list for an agent, or [] if not found.""" - defn = self._agents.get(agent_name) - return defn.skills if defn else [] - - def system_prompt(self, agent_name: str) -> str: - """Return the body (system prompt) from the definition.""" - defn = self._agents.get(agent_name) - return defn.body if defn else "" - - def __len__(self) -> int: - return len(self._agents) - - def __repr__(self) -> str: - return f"AgentLoader(agents={len(self)})" diff --git a/agents/metrics.py b/agents/metrics.py deleted file mode 100644 index 8d5e704..0000000 --- a/agents/metrics.py +++ /dev/null @@ -1,57 +0,0 @@ -"""Token utilization metrics — LangChain callback that records Ollama LLM stats.""" -from __future__ import annotations - -import json -import logging -from datetime import datetime -from pathlib import Path -from typing import Any - -from langchain_core.callbacks import BaseCallbackHandler -from langchain_core.outputs import LLMResult - -logger = logging.getLogger(__name__) - -METRICS_PATH = Path(__file__).parent.parent / "data" / "metrics.jsonl" - - -class TokenMetricsCallback(BaseCallbackHandler): - """Append one JSON line to data/metrics.jsonl after every LLM call.""" - - def __init__(self, agent_name: str, num_ctx: int, num_predict: int) -> None: - super().__init__() - self.agent_name = agent_name - self.num_ctx = num_ctx - self.num_predict = num_predict - - def on_llm_end(self, response: LLMResult, **kwargs: Any) -> None: - try: - for gen_list in response.generations: - for gen in gen_list: - info: dict = getattr(gen, "generation_info", None) or {} - prompt_tokens = info.get("prompt_eval_count", 0) - gen_tokens = info.get("eval_count", 0) - done_reason = info.get("done_reason", "unknown") - eval_ns = info.get("eval_duration", 0) - total_ns = info.get("total_duration", 0) - tps = round(gen_tokens / (eval_ns / 1e9), 1) if eval_ns > 0 else 0.0 - - entry = { - "ts": datetime.now().isoformat(timespec="seconds"), - "agent": self.agent_name, - "prompt_tokens": prompt_tokens, - "num_ctx": self.num_ctx, - "ctx_util": round(prompt_tokens / self.num_ctx * 100, 1) if self.num_ctx else 0, - "gen_tokens": gen_tokens, - "num_predict": self.num_predict, - "predict_util": round(gen_tokens / self.num_predict * 100, 1) if self.num_predict else 0, - "done_reason": done_reason, - "tps": tps, - "total_ms": round(total_ns / 1e6), - } - - METRICS_PATH.parent.mkdir(parents=True, exist_ok=True) - with open(METRICS_PATH, "a", encoding="utf-8") as f: - f.write(json.dumps(entry) + "\n") - except Exception: - logger.debug("TokenMetricsCallback error", exc_info=True) diff --git a/agents/nodes.py b/agents/nodes.py deleted file mode 100644 index 11c9808..0000000 --- a/agents/nodes.py +++ /dev/null @@ -1,1103 +0,0 @@ -"""LangGraph node functions: supervisor + 5 specialist agents.""" - -from __future__ import annotations - -import json -import logging -import os -import re -from datetime import datetime, timezone, timedelta -from typing import TYPE_CHECKING, Any - -from langchain_core.messages import AIMessage, HumanMessage, SystemMessage, ToolMessage -from langchain_openai import ChatOpenAI - -from pathlib import Path - -from agents.loader import AgentLoader -from agents.tools import TOOL_MAP -from tools.db import db_get_llm_config, db_list_llm_profiles - -# ── Pedoman agent — global conduct rules loaded from editable Markdown ───────── - -def _load_pedoman() -> str: - """Load pedoman-agent.md, strip YAML frontmatter, return body only.""" - path = Path(__file__).parent.parent / "skills" / "pedoman-agent.md" - try: - text = path.read_text(encoding="utf-8") - if text.startswith("---"): - end = text.find("---", 3) - return text[end + 3:].strip() if end != -1 else text - return text.strip() - except FileNotFoundError: - logger.warning("pedoman-agent.md tidak ditemukan — pedoman kosong") - return "" - -_PEDOMAN = _load_pedoman() - -if TYPE_CHECKING: - from agent import NetworkOpsState - -logger = logging.getLogger(__name__) - -OLLAMA_API_KEY = os.getenv("OLLAMA_API_KEY", "sk-placeholder") - - -def _llm_overrides(ollama_host: str) -> dict[str, str | None]: - """Resolve base_url + matching api_key for a per-agent Ollama Host override. - - Agent definitions only store the host URL (agents/loader.py::ollama_host), - not a credential. Passing base_url alone to _make_llm() left api_key falling - through to the globally active profile's key — wrong whenever an agent's - host differs from the currently active global profile. Look up the saved - llm_profiles row with a matching base_url and use its key instead. - """ - if not ollama_host: - return {"base_url": None, "api_key": None} - api_key = next( - (p.get("api_key") for p in db_list_llm_profiles() if p.get("base_url") == ollama_host), - None, - ) - return {"base_url": ollama_host, "api_key": api_key or None} - - -def _ollama_defaults() -> tuple[str, str, str]: - """Base URL, model & API key resolved live from Settings → Environment (DB), - falling back to .env when the DB row is blank (e.g. never saved via UI).""" - cfg = db_get_llm_config() - base_url = cfg.get("base_url") or os.getenv("OLLAMA_BASE_URL", "http://localhost:11434") - model = cfg.get("model") or os.getenv("OLLAMA_MODEL", "qwen3.6:27b") - api_key = cfg.get("api_key") or OLLAMA_API_KEY - return base_url, model, api_key - -WIB = timezone(timedelta(hours=7)) - -# ── Agent loader (single source of truth for tools, skills, system prompts) ─── - -_agent_loader = AgentLoader() - -# Alias map derived from definitions (display only) -AGENT_ALIAS: dict[str, str] = {d.name: d.alias for d in _agent_loader.all()} - - -def _resolve_tools(agent_name: str) -> list: - """Return callable tool list for an agent from its definition.""" - names = _agent_loader.tool_list(agent_name) - tools = [TOOL_MAP[n] for n in names if n in TOOL_MAP] - missing = [n for n in names if n not in TOOL_MAP] - if missing: - logger.warning("Agent '%s' references unknown tools: %s", agent_name, missing) - return tools - -# ── LLM factory ─────────────────────────────────────────────────────────────── - -def _make_llm( - temperature: float = 0.3, - json_mode: bool = False, - model: str | None = None, - num_ctx: int = 8192, - num_predict: int = 2048, - timeout: int = 300, - agent_name: str | None = None, - base_url: str | None = None, - api_key: str | None = None, - reasoning: bool = False, # kept for API compat; ignored (OpenAI API doesn't support it) - max_retries: int = 2, -) -> ChatOpenAI: - from agents.metrics import TokenMetricsCallback # noqa: PLC0415 - default_base_url, default_model, default_api_key = _ollama_defaults() - model_kwargs: dict[str, Any] = {} - if json_mode: - model_kwargs["response_format"] = {"type": "json_object"} - return ChatOpenAI( - base_url=base_url or default_base_url, - api_key=api_key or default_api_key, - model=model or default_model, - temperature=temperature, - max_tokens=num_predict, - timeout=timeout, - max_retries=max_retries, - # extra_body lets Ollama pick up num_ctx without triggering openai client validation - extra_body={"options": {"num_ctx": num_ctx}}, - model_kwargs=model_kwargs, - callbacks=[TokenMetricsCallback(agent_name or "unknown", num_ctx, num_predict)], - ) - - -# ── Helpers ─────────────────────────────────────────────────────────────────── - -def _now_str() -> str: - return datetime.now(WIB).strftime("%H:%M:%S") - - -def _clean(text: str) -> str: - return text.strip() - - -def _visible_content(raw: str) -> str: - """What would actually be shown after ... stripping - (mirrors the regex agent.py applies when streaming to the UI). Also - strips a dangling *unclosed* block — e.g. a reasoning model that - hit num_predict mid-thought and never reached its answer — so callers can - detect a reply that is genuinely empty of visible content, not just one - that happens to be full of hidden reasoning.""" - text = re.sub(r".*?", "", raw or "", flags=re.DOTALL) - text = re.sub(r".*$", "", text, flags=re.DOTALL) - return text.strip() - - -def _log(source: str, event_type: str, content: str) -> dict: - """Build a log entry, resolving source to its display alias if defined.""" - display = AGENT_ALIAS.get(source, source) - return {"timestamp": _now_str(), "source": display, - "event_type": event_type, "content": content} - - -def _get_writer(): - """Return a LangGraph custom-stream writer, or a no-op if unavailable - (e.g. called outside a graph.stream(..., stream_mode='custom') context). - Lets nodes push tool_call/tool_result events to the UI the instant they - happen, instead of only after the whole node (which may loop over many - tool calls) returns.""" - try: - from langgraph.config import get_stream_writer # noqa: PLC0415 - return get_stream_writer() - except Exception: - return lambda *_a, **_kw: None - - -def _last_specialist_from_log(state: dict, valid_agent_names: set[str]) -> str | None: - """Scan agent_log backwards to find the last specialist that ran.""" - agent_log = state.get("agent_log", []) - if not agent_log: - return None - alias_to_agent = {alias: name for name, alias in AGENT_ALIAS.items()} - for entry in reversed(agent_log): - source = entry.get("source", "") - agent_name = alias_to_agent.get(source, source) - if agent_name in valid_agent_names: - return agent_name - return None - - -# Some Ollama/model combos (observed with qwen3.6 on the OpenAI-compat endpoint) -# don't populate the structured tool_calls field and instead leak the tool call -# as literal text, e.g.: -# ... -# Recover the intended call from that text so the ReAct loop can still execute it. -_LEAKED_TOOL_CALL_RE = re.compile( - r"\s*[\w\-]+)>(?P.*?)\s*", - re.DOTALL, -) -_LEAKED_PARAM_RE = re.compile( - r"[\w\-]+)>\s*(?P.*?)\s*", - re.DOTALL, -) - - -def _recover_leaked_tool_calls(response: AIMessage) -> None: - """If response has no structured tool_calls but its content contains a - leaked block, parse it and patch response.tool_calls/content - in place so callers can treat it exactly like a native tool call.""" - if getattr(response, "tool_calls", None): - return - text = response.content or "" - matches = list(_LEAKED_TOOL_CALL_RE.finditer(text)) - if not matches: - return - calls = [] - for i, m in enumerate(matches): - args = dict(_LEAKED_PARAM_RE.findall(m.group("body"))) - calls.append({"name": m.group("name"), "args": args, "id": f"leaked_{i}"}) - response.tool_calls = calls - response.content = _LEAKED_TOOL_CALL_RE.sub("", text).strip() - - -def _react_loop( - llm_with_tools: Any, - messages: list, - tool_map: dict, - agent_name: str, - max_iters: int = 20, -) -> tuple[list, list]: - """ - Run a ReAct tool-calling loop. Returns (updated_messages, log_entries). - Stops when the LLM produces a response with no tool calls. - """ - writer = _get_writer() - logs: list[dict] = [] - - def _emit(event_type: str, content: str) -> None: - entry = _log(agent_name, event_type, content) - logs.append(entry) - writer(entry) - - for _ in range(max_iters): - response = llm_with_tools.invoke(messages) - _recover_leaked_tool_calls(response) - messages = messages + [response] - - if not getattr(response, "tool_calls", None): - break - - for tc in response.tool_calls: - name = tc["name"] - args = tc.get("args", {}) - args_str = ", ".join(f"{k}={json.dumps(v)}" for k, v in args.items()) - _emit("tool_call", f"{name}({args_str})") - - tool_fn = tool_map.get(name) - if tool_fn is None: - result = f"Error: tool '{name}' not found." - else: - try: - result = tool_fn.invoke(args) - except Exception as exc: - result = f"Error: {exc}" - - preview = str(result)[:120].replace("\n", " ") - if len(str(result)) > 120: - preview += "…" - _emit("tool_result", preview) - messages.append(ToolMessage(content=str(result), tool_call_id=tc["id"])) - - return messages, logs - - -# ── Supervisor helpers ──────────────────────────────────────────────────────── - -import re as _re - -_GREETING_PATTERNS: list[str] = [ - "halo", "hallo", "hi", "hello", "hey", "hai", - "selamat pagi", "selamat siang", "selamat sore", "selamat malam", - "siapa kamu", "siapa anda", "kamu siapa", "anda siapa", - "kamu apa", "kamu bisa apa", "anda bisa apa", - "perkenalkan", "perkenalan", -] - - -def _is_greeting(messages: list) -> bool: - """Return True if the last human message is a simple greeting or identity question.""" - last_human = next( - (m.content for m in reversed(messages) if isinstance(m, HumanMessage)), "" - ) - text = last_human.strip().lower() - # Must be short (≤ 60 chars) to avoid false positives on "halo, cek router..." - if len(text) > 60: - return False - return any(re.search(rf'\b{re.escape(pat)}\b', text) for pat in _GREETING_PATTERNS) - - -_KEYWORD_ROUTES: list[tuple[list[str], str]] = [ - (["status", "monitor", "ping", "reachability", "traffic", "bandwidth", - "interface", "brief", "ringkasan", "uptime", "latency", "packet loss", - "cek jaringan", "cek router", "kondisi jaringan"], "monitor_agent"), - (["diagnos", "troubleshoot", "error", "down", "gangguan", "masalah", - "ospf", "bgp", "routing", "neighbor", "tidak bisa", "putus", "lambat", - "analisis"], "diagnose_agent"), - (["backup", "restore", "konfigurasi", "config", "setting", "ubah", - "ganti", "terapkan"], "config_agent"), - (["security", "keamanan", "firewall", "intrusion", "audit keamanan", - "serangan", "vulnerability", "port scan"], "security_agent"), - (["laporan", "report", "dokumen", "tulis laporan", "buat laporan", - "dokumentasi", "skill"], "document_agent"), -] - - -def _keyword_route(messages: list, valid_agents: set[str]) -> str | None: - """Keyword fallback routing dari pesan user terakhir. None jika tidak cocok.""" - last_human = next( - (m.content for m in reversed(messages) if isinstance(m, HumanMessage)), "" - ) - text = last_human.lower() - for keywords, agent in _KEYWORD_ROUTES: - if any(k in text for k in keywords) and agent in valid_agents: - return agent - return None - - -def _parse_supervisor_response(raw: str) -> dict | None: - """Extract JSON dari respons supervisor, toleran terhadap think-tags dan teks extra.""" - text = _re.sub(r".*?", "", raw, flags=_re.DOTALL).strip() - if not text: - return None - try: - return json.loads(text) - except json.JSONDecodeError: - pass - match = _re.search(r'\{[^{}]+\}', text, _re.DOTALL) - if match: - try: - return json.loads(match.group()) - except json.JSONDecodeError: - pass - return None - - -# ── Intent continuation (deterministic, no LLM) ────────────────────────────── - -_MONITORING_KW = {"cek", "status", "check", "monitor", "kondisi", "health", - "ping", "sistem", "uptime", "resource", "reachability"} -_DIAGNOSE_KW = {"diagnosa", "analisis", "bgp", "ospf", "routing", - "troubleshoot", "kenapa", "masalah", "lambat", "putus"} - - -def _intent_continuation(intent: str, prev_agent: str, valid_agents: set[str]) -> str | None: - """ - Setelah prev_agent selesai, cek apakah original_intent belum terpenuhi. - Return nama agent berikutnya, atau None jika intent sudah selesai (→ END). - Deterministic — tidak memanggil LLM. - """ - if not intent or not prev_agent: - return None - t = intent.lower() - # Setelah config_agent (discovery/tambah router): lanjut ke monitoring/diagnosa jika itu intent-nya - if prev_agent == "config_agent": - if any(kw in t for kw in _MONITORING_KW) and "monitor_agent" in valid_agents: - return "monitor_agent" - if any(kw in t for kw in _DIAGNOSE_KW) and "diagnose_agent" in valid_agents: - return "diagnose_agent" - # Setelah netbox_agent (discovery): lanjut ke monitoring jika intent adalah monitoring - if prev_agent == "netbox_agent": - if any(kw in t for kw in _MONITORING_KW) and "monitor_agent" in valid_agents: - return "monitor_agent" - return None - - -# ── Supervisor node ─────────────────────────────────────────────────────────── - -_SUPERVISOR_SYS = """\ -{supervisor_body} - -Agent tersedia: -{agent_descriptions} - -Skill tersedia (nama → trigger): -{skill_list} - -Router yang terdaftar di config.yaml: -{router_list} - -Jika operator menyebut nama router yang TIDAK ada dalam daftar di atas, inject skill -'router-discovery' dan route ke config_agent — jangan langsung END atau tanya klarifikasi. - -Balas HANYA dengan JSON valid, tanpa teks lain sebelum atau sesudah JSON. -Contoh format yang benar: -{{"next_agent":"monitor_agent","relevant_skills":[],"reasoning":"query status jaringan"}} - -Field next_agent harus salah satu: {valid_agents}, END -Gunakan END jika pertanyaan sudah dijawab AI sebelumnya dalam percakapan ini. -{intent_context} -""" - - -def supervisor_node(state: "NetworkOpsState") -> dict: - from agent import _skill_lib # noqa: PLC0415 - - messages = state["messages"] - - last = messages[-1] if messages else None - if isinstance(last, AIMessage) and _clean(last.content or ""): - _early_save_kw = {"simpan", "tulis file", "buat laporan", "buatkan laporan", - "buat dokumen", "buatkan dokumen", "catat ke file", - "write report", "save", "write file", "laporan routing", - "laporan bgp", "laporan ospf", "laporan jaringan"} - _early_human = next((m for m in reversed(messages) if isinstance(m, HumanMessage)), None) - _early_wants_file = bool(_early_human and any( - kw in (_early_human.content or "").lower() for kw in _early_save_kw - )) - _early_prev = state.get("active_agent", "") - _early_intent = state.get("original_intent", "") - - # Priority 1: Jika intent awal belum terpenuhi, lanjut ke agent berikutnya - _early_valid = {d.name for d in _agent_loader.all() if d.name != "supervisor"} - _continuation = _intent_continuation(_early_intent, _early_prev, _early_valid) - if _continuation and _continuation != _early_prev: - _cont_log = ( - f"→ {_continuation} skills: [] | " - f"intent-continuation: '{_early_intent[:60]}' belum terpenuhi setelah {_early_prev}" - ) - _cont_msg = HumanMessage(content=( - f"Lanjutkan task awal operator: {_early_intent}\n" - f"Agent sebelumnya ({_early_prev}) sudah selesai. " - f"Sekarang kerjakan bagian yang belum: {_early_intent}" - )) - return { - "next_agent": _continuation, - "active_agent": "supervisor", - "injected_skills": [], - "messages": [_cont_msg], - "agent_log": [_log("supervisor", "routing", _cont_log)], - } - - # Priority 2: Jika data-agent baru selesai dan user minta file → route ke document_agent - if _early_wants_file and _early_prev in ("monitor_agent", "security_agent", "diagnose_agent"): - _doc_log = f"→ document_agent skills: ['document-writing'] | file-save: {_early_prev} selesai, route ke document_agent" - # Deteksi tipe laporan untuk memilih template yang tepat - _orig_req = (_early_human.content or "").lower() if _early_human else "" - if any(kw in _orig_req for kw in ("bgp", "ospf", "routing")): - _template_hint = "routing-bgp-ospf" - _router_hint = "" - # Cari nama router dari permintaan asli - import re as _re - _rm = _re.search(r'(gate-\S+|router\s+(\S+))', _orig_req, _re.IGNORECASE) - if _rm: - _router_hint = f" untuk router {_rm.group(0).strip()}" - _doc_content = ( - f"Analisis routing BGP/OSPF dari Agus sudah lengkap{_router_hint}. " - "Buat laporan file menggunakan template `routing-bgp-ospf`. " - "WAJIB panggil: get_current_time(), get_system_info(), get_bgp_sessions(), get_ospf_neighbors() " - "untuk mendapatkan data tabel yang akurat. " - "Gunakan analisis di atas (cross-reference, root cause, rekomendasi) untuk bagian teks analisis. " - "Simpan dengan write_document() — file HARUS tersimpan ke disk." - ) - else: - _doc_content = ( - "Data dari agent sebelumnya sudah lengkap. " - "Simpan sekarang ke file menggunakan tool `write_document`. " - "Mulai dengan `list_templates`, pilih template yang sesuai, lalu panggil `write_document`. " - "JANGAN hanya menulis teks — file HARUS tersimpan ke disk." - ) - _doc_instruction = HumanMessage(content=_doc_content) - return { - "next_agent": "document_agent", - "active_agent": "supervisor", - "injected_skills": ["document-writing"], - "messages": [_doc_instruction], - "agent_log": [_log("supervisor", "routing", _doc_log)], - } - - # Priority 3: post-validasi routing — setelah wati selesai, baca delegation string. - # HARUS ada di early-return block karena supervisor selalu early-return saat last == AIMessage. - if _early_prev == "validasi_agent": - _wati_txt = _clean(last.content or "") - if "delegasikan ke config_agent" in _wati_txt and "config_agent" in _early_valid: - _wati_log = "→ config_agent skills: [] | validasi-delegation: wati → config_agent" - return { - "next_agent": "config_agent", - "active_agent": "supervisor", - "injected_skills": [], - "original_intent": _early_intent, - "messages": [HumanMessage(content=( - "Wati (validasi_agent) sudah memverifikasi action items. " - "Lihat verdict validasi di atas — eksekusi item KONFIRMASI sesuai rekomendasi Wati. " - "Minta approval operator sebelum setiap operasi write." - ))], - "agent_log": [_log("supervisor", "routing", _wati_log)], - } - elif "delegasikan ke diagnose_agent" in _wati_txt and "diagnose_agent" in _early_valid: - _wati_log = "→ diagnose_agent skills: [] | validasi-delegation: wati → diagnose_agent" - return { - "next_agent": "diagnose_agent", - "active_agent": "supervisor", - "injected_skills": [], - "original_intent": _early_intent, - "messages": [HumanMessage(content=( - "Wati (validasi_agent) sudah memverifikasi action items — root cause dari item KONFIRMASI tidak jelas. " - "Lakukan investigasi lebih dalam berdasarkan verdict Wati di atas." - ))], - "agent_log": [_log("supervisor", "routing", _wati_log)], - } - else: - return { - "next_agent": "END", - "active_agent": "supervisor", - "agent_log": [_log("supervisor", "routing", "→ END (validasi: tidak perlu tindakan)")], - } - - # Priority 4: validasi trigger — setelah data-agent selesai dengan SEGERA items. - # HARUS ada di early-return block; kode serupa di bawah (line ~522) tidak pernah dicapai - # karena early-return block selalu return lebih dulu. - _DATA_AGENTS_EARLY = {"monitor_agent", "diagnose_agent", "security_agent"} - if (_early_prev in _DATA_AGENTS_EARLY - and "validasi_agent" in _early_valid - and not _early_wants_file): - _segera_txt = _clean(last.content or "") - if "🚨 **SEGERA**" in _segera_txt: - _val_log = ( - f"→ validasi_agent skills: ['action-validation'] | " - f"validasi-trigger: {_early_prev} produced SEGERA items" - ) - return { - "next_agent": "validasi_agent", - "active_agent": "supervisor", - "injected_skills": ["action-validation"], - "original_intent": _early_intent, - "agent_log": [_log("supervisor", "routing", _val_log)], - } - - return { - "next_agent": "END", - "active_agent": "supervisor", - "agent_log": [_log("supervisor", "routing", "→ END (respons sudah ada)")], - } - - specialist_defs = [d for d in _agent_loader.all() if d.name != "supervisor"] - agent_descriptions = "\n".join( - f"- {d.name:20s} [{d.alias}] : {d.description}" - for d in specialist_defs - ) - valid_agent_names = {d.name for d in specialist_defs} - valid_agents_str = ", ".join(sorted(valid_agent_names)) - - # Fast-path: simple greetings / identity questions → answer directly, no LLM routing needed - if _is_greeting(messages): - _supervisor_defn_g = _agent_loader.get("supervisor") - _chat_prompt_g = ( - _supervisor_defn_g.chat_prompt - if _supervisor_defn_g and _supervisor_defn_g.chat_prompt - else ( - "Kamu adalah Bambang, supervisor operasional jaringan kampus universitas. " - "Balas sapaan atau pertanyaan umum dengan ramah dan singkat dalam Bahasa Indonesia. " - "Sebutkan bahwa kamu siap membantu kebutuhan operasional jaringan kampus." - ) - ) - _recent_g = [m for m in messages if isinstance(m, (HumanMessage, AIMessage))][-6:] - _llm_g = _make_llm( - temperature=0.5, - model=_supervisor_defn_g.model if _supervisor_defn_g else None, - num_ctx=_supervisor_defn_g.num_ctx if _supervisor_defn_g else 8192, - num_predict=1536, # short reply expected, but a thinking model needs headroom to reason first - timeout=_supervisor_defn_g.timeout if _supervisor_defn_g else 60, - agent_name="supervisor", - **_llm_overrides(_supervisor_defn_g.ollama_host if _supervisor_defn_g else ""), - reasoning=False, - ) - _greeting_result: dict = { - "next_agent": "END", - "active_agent": "supervisor", - "agent_log": [_log("supervisor", "routing", "→ END (sapaan/pertanyaan umum, jawab langsung)")], - } - try: - _reply_g = _llm_g.invoke([SystemMessage(content=_chat_prompt_g)] + _recent_g) - if not _visible_content(_reply_g.content or ""): - raise ValueError( - f"empty visible content (finish_reason={_reply_g.response_metadata.get('finish_reason')}, " - f"usage={_reply_g.response_metadata.get('token_usage')})" - ) - _greeting_result["messages"] = [_reply_g] - except Exception as exc: - # Jangan biarkan kegagalan LLM di fast-path ini membuat operator - # menerima balasan kosong — safety net yang sama seperti specialist node. - logger.warning("Greeting fast-path gagal (supervisor): %s", exc) - _greeting_result["messages"] = [AIMessage( - content="Halo! Saya Bambang, supervisor operasional jaringan kampus. " - "Ada yang bisa saya bantu terkait jaringan kampus?" - )] - _greeting_result["agent_log"].append( - _log("supervisor", "tool_result", f"(fallback: balasan sapaan gagal — {exc})") - ) - return _greeting_result - - skill_list = "\n".join( - f" {s.name}: {', '.join(s.triggers[:3])}" - for s in _skill_lib.list_enabled() - ) or " (tidak ada skill aktif)" - - from tools.base import get_router_names as _get_router_names # noqa: PLC0415 - router_list = " " + ", ".join(_get_router_names()) if _get_router_names() else " (kosong)" - - # Simpan original_intent dari HumanMessage pertama jika belum ada - _current_intent = state.get("original_intent", "") - if not _current_intent: - _first_human = next((m for m in messages if isinstance(m, HumanMessage)), None) - _current_intent = (_first_human.content or "").strip() if _first_human else "" - - # Inject intent context ke prompt hanya jika ada dan ada agent yang sudah selesai - _prev_for_intent = state.get("active_agent", "") - if _current_intent and _prev_for_intent and _prev_for_intent != "supervisor": - _intent_ctx = ( - f"\nIntent awal operator: \"{_current_intent}\"\n" - f"Agent terakhir yang selesai: {_prev_for_intent}\n" - f"Cek apakah intent ini sudah terpenuhi. Jika belum, route ke agent yang tepat. " - f"Jika sudah → END." - ) - else: - _intent_ctx = "" - - _supervisor_defn = _agent_loader.get("supervisor") - _supervisor_model = _supervisor_defn.model if _supervisor_defn else None - - sys_msg = SystemMessage(content=_SUPERVISOR_SYS.format( - supervisor_body=_agent_loader.system_prompt("supervisor"), - agent_descriptions=agent_descriptions, - skill_list=skill_list, - router_list=router_list, - valid_agents=valid_agents_str, - intent_context=_intent_ctx, - )) - _sup_ctx_window = _supervisor_defn.context_window if _supervisor_defn else 6 - recent = [m for m in messages if isinstance(m, (HumanMessage, AIMessage))][-_sup_ctx_window:] - llm = _make_llm( - temperature=0.1, - json_mode=True, - model=_supervisor_model, - num_ctx=_supervisor_defn.num_ctx if _supervisor_defn else 4096, - num_predict=_supervisor_defn.num_predict if _supervisor_defn else 256, - timeout=_supervisor_defn.timeout if _supervisor_defn else 60, - agent_name="supervisor", - **_llm_overrides(_supervisor_defn.ollama_host if _supervisor_defn else ""), - reasoning=False, - ) - try: - resp = llm.invoke([sys_msg] + recent) - logger.debug("Supervisor raw content: %r | metadata: %s", - resp.content[:300] if resp.content else "(empty)", - getattr(resp, "response_metadata", {})) - data = _parse_supervisor_response(resp.content) or {} - if not data: - raise ValueError("empty or unparseable supervisor response") - except Exception as exc: - logger.warning("Supervisor routing parse error: %s", exc) - keyword_agent = _keyword_route(messages, valid_agent_names) - context_agent = ( - _last_specialist_from_log(state, valid_agent_names) - if not keyword_agent else None - ) - fallback = keyword_agent or context_agent or "END" - route_type = "context" if context_agent and not keyword_agent else "keyword" - data = {"next_agent": fallback, "relevant_skills": [], - "reasoning": f"{route_type}-fallback({fallback}): {exc}"} - - next_agent = data.get("next_agent", "END") - if next_agent not in valid_agent_names | {"END"}: - next_agent = _keyword_route(messages, valid_agent_names) or "END" - - _save_kw = {"simpan", "tulis file", "buat laporan", "buatkan laporan", - "buat dokumen", "buatkan dokumen", "catat ke file", - "write report", "save", "write file", "laporan routing", - "laporan bgp", "laporan ospf", "laporan jaringan"} - _last_human = next((m for m in reversed(messages) if isinstance(m, HumanMessage)), None) - _wants_file = bool(_last_human and any( - kw in (_last_human.content or "").lower() for kw in _save_kw - )) - _prev_agent = state.get("active_agent", "") - - # Override END → document_agent jika user minta simpan file dan data-agent baru selesai - if next_agent == "END" and "document_agent" in valid_agent_names: - if _wants_file and _prev_agent in ("monitor_agent", "security_agent", "diagnose_agent"): - next_agent = "document_agent" - data["reasoning"] = f"file-save override: {_prev_agent} returned data, routing to document_agent" - - # Override → END jika document_agent baru selesai (cegah loop) - # document_agent selalu terminal (handoff_to: []) — apapun yang ditulis, selalu END - if next_agent != "END" and _prev_agent == "document_agent": - next_agent = "END" - data["reasoning"] = "document_agent selesai, routing ke END" - - # Loop guard: jangan route ke specialist yang sama yang baru saja selesai. - # Cegah skenario: specialist → supervisor (empty JSON) → keyword-fallback → specialist sama → loop - if next_agent == _prev_agent and _prev_agent in valid_agent_names: - next_agent = "END" - data["reasoning"] = f"loop guard: {_prev_agent} baru selesai, cegah re-route ke agent sama" - - # NOTE: Validasi trigger dan post-validasi routing di bawah ini adalah SECONDARY FALLBACK - # untuk kasus supervisor LLM dipanggil ulang setelah user kirim pesan baru (HumanMessage). - # Kasus primer (agent baru selesai → last == AIMessage) sudah ditangani di early-return - # block (Priority 3 dan 4) — kode di bawah tidak pernah dicapai untuk kasus itu. - _DATA_AGENTS = {"monitor_agent", "diagnose_agent", "security_agent"} - if (next_agent == "END" - and _prev_agent in _DATA_AGENTS - and "validasi_agent" in valid_agent_names): - _last_ai_msg = next((m for m in reversed(messages) if isinstance(m, AIMessage)), None) - _last_ai_txt = (_last_ai_msg.content or "") if _last_ai_msg else "" - if "🚨 **SEGERA**" in _last_ai_txt and not _wants_file: - next_agent = "validasi_agent" - data["reasoning"] = ( - f"validasi-trigger (llm-path): {_prev_agent} produced SEGERA items → validasi_agent" - ) - _existing_skills = data.get("relevant_skills") or [] - if "action-validation" not in _existing_skills: - data["relevant_skills"] = ["action-validation"] + list(_existing_skills) - - if _prev_agent == "validasi_agent": - _last_ai_msg = next((m for m in reversed(messages) if isinstance(m, AIMessage)), None) - _wati_txt = (_last_ai_msg.content or "") if _last_ai_msg else "" - if "delegasikan ke config_agent" in _wati_txt and "config_agent" in valid_agent_names: - next_agent = "config_agent" - data["reasoning"] = "validasi-delegation (llm-path): wati delegated to config_agent" - elif "delegasikan ke diagnose_agent" in _wati_txt and "diagnose_agent" in valid_agent_names: - next_agent = "diagnose_agent" - data["reasoning"] = "validasi-delegation (llm-path): wati delegated to diagnose_agent" - else: - next_agent = "END" - data["reasoning"] = "validasi-delegation (llm-path): no action needed → END" - - # Router discovery override: jika ada error "tidak dikenal" dari validate_router(), - # route ke config_agent/netbox_agent dengan skill router-discovery untuk auto-discover. - if next_agent == "END": - _recent_content = " ".join( - (m.content or "") for m in messages[-6:] - if hasattr(m, "content") and isinstance(m.content, str) - ) - _router_error = "tidak dikenal" in _recent_content or "tidak ditemukan" in _recent_content - _discovery_agent = next( - (a for a in ("config_agent", "netbox_agent") if a in valid_agent_names), - None, - ) - if _router_error and _discovery_agent and _prev_agent != _discovery_agent: - next_agent = _discovery_agent - data["reasoning"] = ( - f"router-discovery override: error 'tidak dikenal' → {_discovery_agent}" - ) - data["relevant_skills"] = ["router-discovery"] - - skills = data.get("relevant_skills", []) - log_msg = f"→ {next_agent} skills: {skills} | {data.get('reasoning','')}" - base_result = { - "next_agent": next_agent, - "active_agent": "supervisor", - "injected_skills": skills, - "original_intent": _current_intent, - "agent_log": [_log("supervisor", "routing", log_msg)], - } - - # Supervisor menjawab langsung jika END tapi belum ada respons AI (sapaan, pertanyaan umum) - if next_agent == "END": - # Cari posisi HumanMessage terakhir — cek AI reply hanya setelah itu - last_human_idx = max( - (i for i, m in enumerate(recent) if isinstance(m, HumanMessage)), - default=-1, - ) - has_ai_reply = any( - isinstance(m, AIMessage) and _clean(m.content or "") - for m in recent[last_human_idx + 1:] - ) - if not has_ai_reply: - _chat_prompt = ( - _supervisor_defn.chat_prompt if _supervisor_defn and _supervisor_defn.chat_prompt - else ( - f"Kamu adalah {_supervisor_defn.alias.capitalize() if _supervisor_defn else 'Supervisor'}, " - "supervisor operasional jaringan kampus universitas. " - "Balas sapaan atau pertanyaan umum dengan ramah dan singkat dalam Bahasa Indonesia." - ) - ) - llm_chat = _make_llm( - temperature=0.5, - model=_supervisor_model, - num_ctx=_supervisor_defn.num_ctx if _supervisor_defn else 8192, - num_predict=_supervisor_defn.num_predict if _supervisor_defn else 2048, - timeout=_supervisor_defn.timeout if _supervisor_defn else 60, - agent_name="supervisor", - **_llm_overrides(_supervisor_defn.ollama_host if _supervisor_defn else ""), - reasoning=False, - ) - chat_sys = SystemMessage(content=_chat_prompt) - try: - reply = llm_chat.invoke([chat_sys] + recent) - if not _visible_content(reply.content or ""): - raise ValueError( - f"empty visible content (finish_reason={reply.response_metadata.get('finish_reason')}, " - f"usage={reply.response_metadata.get('token_usage')})" - ) - base_result["messages"] = [reply] - except Exception as exc: - logger.warning("END fast-path gagal (supervisor): %s", exc) - base_result["messages"] = [AIMessage( - content="Maaf, saya belum bisa menyusun jawaban untuk itu. Bisa dicoba lagi atau " - "diperjelas maksudnya?" - )] - base_result["agent_log"].append( - _log("supervisor", "tool_result", f"(fallback: balasan END gagal — {exc})") - ) - - return base_result - - -def route_from_supervisor(state: dict) -> str: - return state.get("next_agent", "END") - - -# ── Specialist node factory ─────────────────────────────────────────────────── - -_SPECIALIST_SYS = """\ -{agent_body} - -Tool yang tersedia (HANYA ini yang boleh dipanggil): {tool_names} - -{pedoman} - -{skill_context} -""" - - -def _make_specialist_node(agent_name: str): - defn = _agent_loader.get(agent_name) - tools = _resolve_tools(agent_name) - _tool_names = [t.name for t in tools] - tool_names_str = ", ".join(_tool_names) - agent_body = defn.body if defn else "" - context_window = defn.context_window if defn else 10 - _model = defn.model if defn else None - _num_ctx = defn.num_ctx if defn else 8192 - _num_predict = defn.num_predict if defn else 2048 - _timeout = defn.timeout if defn else 300 - _ollama_host = defn.ollama_host if defn else "" - _llm_kwargs = _llm_overrides(_ollama_host) - _reasoning = defn.reasoning if defn else False - _max_iters = defn.max_iters if defn else 20 - llm_with_tools = _make_llm( - temperature=0.3, - model=_model, - num_ctx=_num_ctx, - num_predict=_num_predict, - timeout=_timeout, - agent_name=agent_name, - **_llm_kwargs, - reasoning=_reasoning, - ).bind_tools(tools) - - def _node(state: "NetworkOpsState") -> dict: - from agent import _skill_lib # noqa: PLC0415 - - skill_names = state.get("injected_skills") or [] - skill_objs = [s for n in skill_names if (s := _skill_lib.get_by_name(n))] - skill_ctx = _skill_lib.inject_context(skill_objs) if skill_objs else "" - - _pedoman_skill = _skill_lib.get_by_name("pedoman-agent") - pedoman = _pedoman_skill.body if _pedoman_skill else _PEDOMAN - - sys_content = _SPECIALIST_SYS.format( - agent_body=agent_body, - tool_names=tool_names_str, - pedoman=pedoman, - skill_context=skill_ctx, - ).strip() - sys_msg = SystemMessage(content=sys_content) - - context_msgs = list(state["messages"])[-context_window:] - _current_tool_map = {n: TOOL_MAP[n] for n in _tool_names if n in TOOL_MAP} - all_msgs, logs = _react_loop( - llm_with_tools, - [sys_msg] + context_msgs, - _current_tool_map, - agent_name, - max_iters=_max_iters, - ) - _writer = _get_writer() - - def _emit(event_type: str, content: str) -> None: - entry = _log(agent_name, event_type, content) - logs.append(entry) - _writer(entry) - - final_msg = all_msgs[-1] - need_summary = True - if isinstance(final_msg, AIMessage): - content = _clean(final_msg.content or "") - if content: - final_msg = AIMessage(content=content) - need_summary = False - - if need_summary: - # AIMessage kosong ATAU ToolMessage (max_iters tercapai) — force summary - try: - llm_plain = _make_llm( - temperature=0.3, model=_model, - num_ctx=_num_ctx, num_predict=_num_predict, timeout=_timeout, - agent_name=agent_name, - **_llm_kwargs, - reasoning=False, - ) - summary = llm_plain.invoke(all_msgs) - summary_content = _clean(summary.content or "") - if summary_content: - final_msg = AIMessage(content=summary_content) - _emit("tool_result", "(forced summary generated)") - except Exception as exc: - logger.warning("Forced summary failed for %s: %s", agent_name, exc) - - # Safety net: final_msg HARUS selalu AIMessage dengan content. - # Jika masih ToolMessage atau AIMessage kosong, ekstrak hasil tool terpanjang - # (biasanya paling informatif, hindari ambil tool terakhir yang arbitrary). - if not (isinstance(final_msg, AIMessage) and _clean(getattr(final_msg, "content", "") or "")): - tool_msgs = [m for m in all_msgs if isinstance(m, ToolMessage)] - if tool_msgs: - best = max(tool_msgs, key=lambda m: len(m.content or "")) - raw = best.content - else: - raw = "(tidak ada data)" - final_msg = AIMessage(content=f"Hasil:\n{raw}") - _emit("tool_result", "(safety net: paksa AIMessage dari tool result)") - - logs.append(_log(agent_name, "routing", "← kembali ke supervisor")) - - return { - "messages": [final_msg], - "active_agent": agent_name, - "next_agent": "supervisor", - "agent_log": logs, - } - - _node.__name__ = agent_name - return _node - - -# ── Config node with human-in-the-loop approval ─────────────────────────────── - -_config_defn = _agent_loader.get("config_agent") -_CONFIG_TOOLS = _resolve_tools("config_agent") -_CONFIG_TOOLS_MAP = {t.name: t for t in _CONFIG_TOOLS} -_CONFIG_LLM = _make_llm( - temperature=0.3, - model=_config_defn.model if _config_defn else None, - num_ctx=_config_defn.num_ctx if _config_defn else 8192, - num_predict=_config_defn.num_predict if _config_defn else 2048, - timeout=_config_defn.timeout if _config_defn else 180, - agent_name="config_agent", - **_llm_overrides(_config_defn.ollama_host if _config_defn else ""), - reasoning=_config_defn.reasoning if _config_defn else False, -).bind_tools(_CONFIG_TOOLS) -_APPROVAL_REQUIRED_TOOLS = set( - _config_defn.approval_required_tools if _config_defn else ["backup_router_config"] -) - - -def config_node(state: dict) -> dict: - """Config specialist with interrupt() gate for destructive tools.""" - from agent import _skill_lib # noqa: PLC0415 - from langgraph.types import interrupt # noqa: PLC0415 - - skill_names = state.get("injected_skills") or [] - skill_objs = [s for n in skill_names if (s := _skill_lib.get_by_name(n))] - skill_ctx = _skill_lib.inject_context(skill_objs) if skill_objs else "" - - _pedoman_skill = _skill_lib.get_by_name("pedoman-agent") - _pedoman = _pedoman_skill.body if _pedoman_skill else _PEDOMAN - - _config_tool_names = ", ".join(t.name for t in _CONFIG_TOOLS) - sys_msg = SystemMessage(content=_SPECIALIST_SYS.format( - agent_body=_agent_loader.system_prompt("config_agent"), - tool_names=_config_tool_names, - pedoman=_pedoman, - skill_context=skill_ctx, - ).strip()) - - messages = [sys_msg] + list(state["messages"])[-10:] - writer = _get_writer() - logs: list[dict] = [] - _backed_up_routers: set[str] = set() - - def _emit(event_type: str, content: str) -> None: - entry = _log("config_agent", event_type, content) - logs.append(entry) - writer(entry) - - def _auto_backup(router: str) -> bool: - """Trigger backup approval + execution. Return True if approved and done.""" - approval_req = { - "agent": "config_agent", - "action": f"Backup otomatis sebelum write — router '{router}'", - "risk_level": "medium", - "details": {"router_name": router}, - } - _emit("approval_required", f"Backup sebelum write: {router}") - decision = interrupt(approval_req) - if decision != "approved": - _emit("tool_result", f"Backup ditolak — write ke '{router}' dibatalkan.") - return False - backup_fn = _CONFIG_TOOLS_MAP.get("backup_router_config") - if backup_fn: - try: - res = backup_fn.invoke({"router_name": router}) - _emit("tool_result", str(res)[:120]) - except Exception as exc: - _emit("tool_result", f"Backup error: {exc}") - _backed_up_routers.add(router) - return True - - for _ in range(12): - response = _CONFIG_LLM.invoke(messages) - _recover_leaked_tool_calls(response) - messages = messages + [response] - - if not getattr(response, "tool_calls", None): - break - - for tc in response.tool_calls: - name = tc["name"] - args = tc.get("args", {}) - args_str = ", ".join(f"{k}={json.dumps(v)}" for k, v in args.items()) - _emit("tool_call", f"{name}({args_str})") - - router = args.get("router_name", "router") - - # Track LLM-initiated backups so auto-backup can skip them - if name == "backup_router_config" and router: - _backed_up_routers.add(router) - - # Enforce backup before first write to each router - if name == "run_command_write" and router and router not in _backed_up_routers: - if not _auto_backup(router): - result = "Write dibatalkan: operator menolak backup." - messages.append(ToolMessage(content=result, tool_call_id=tc["id"])) - continue - - if name in _APPROVAL_REQUIRED_TOOLS: - if name == "backup_router_config": - action_desc = f"Backup config router '{router}'" - risk = "medium" - elif name == "run_command_write": - cmd = args.get("command", "") - action_desc = f"Write command di '{router}': {cmd}" - risk = "high" - else: - action_desc = f"Operasi write di '{router}' via {name}" - risk = "medium" - approval_req = { - "agent": "config_agent", - "action": action_desc, - "risk_level": risk, - "details": args, - } - _emit("approval_required", f"Menunggu approval: {approval_req['action']}") - decision = interrupt(approval_req) - - if decision != "approved": - result = f"Aksi dibatalkan oleh operator (keputusan: {decision})." - _emit("tool_result", result) - messages.append(ToolMessage(content=result, tool_call_id=tc["id"])) - continue - - _emit("tool_result", f"Operator menyetujui — eksekusi {name}...") - - tool_fn = _CONFIG_TOOLS_MAP.get(name) - if tool_fn is None: - result = f"Error: tool '{name}' tidak ditemukan." - else: - try: - result = tool_fn.invoke(args) - except Exception as exc: - result = f"Error: {exc}" - - preview = str(result)[:120].replace("\n", " ") - if len(str(result)) > 120: - preview += "…" - _emit("tool_result", preview) - messages.append(ToolMessage(content=str(result), tool_call_id=tc["id"])) - - final_msg = messages[-1] - if isinstance(final_msg, AIMessage): - content = _clean(final_msg.content or "") - if content: - final_msg = AIMessage(content=content) - - logs.append(_log("config_agent", "routing", "← kembali ke supervisor")) - return { - "messages": [final_msg], - "active_agent": "config_agent", - "next_agent": "supervisor", - "agent_log": logs, - } - - -# ── Exported node functions ─────────────────────────────────────────────────── - -monitor_node = _make_specialist_node("monitor_agent") -diagnose_node = _make_specialist_node("diagnose_agent") -security_node = _make_specialist_node("security_agent") -document_node = _make_specialist_node("document_agent") -validasi_node = _make_specialist_node("validasi_agent") -netbox_node = _make_specialist_node("netbox_agent") -# config_node defined above with interrupt() support diff --git a/agents/tools.py b/agents/tools.py deleted file mode 100644 index 66a2a25..0000000 --- a/agents/tools.py +++ /dev/null @@ -1,69 +0,0 @@ -"""All tools imported and indexed in TOOL_MAP. Per-agent lists are derived from AgentLoader.""" - -from __future__ import annotations - -from tools.reachability import check_reachability, check_ssh_access -from tools.system import get_system_info -from tools.routing import get_routing_full, get_router_config, get_bgp_sessions, get_ospf_neighbors -from tools.interface import get_interface_stats -from tools.traffic import get_interface_traffic, get_traffic_summary, get_top_talkers, get_queue_stats, get_traffic_all, get_top_interfaces_all -from tools.dhcp import get_dhcp_leases, get_router_leases, search_device, audit_dhcp -from tools.log import get_router_log -from tools.config_read import run_command, run_command_all -from tools.config_write import run_command_write -from tools.config_backup import backup_router_config, list_backups, diff_config -from tools.security import audit_security -from tools.diagnostic import run_diagnostic -from tools.report import list_reports, get_report, get_report_section, get_report_toc -from tools.utility import list_routers, get_current_time -from tools.document import list_templates, read_template, write_document, create_template, write_skill -from tools.web import fetch_url -from tools.netbox import ( - get_netbox_devices, get_netbox_device_interfaces, get_netbox_device_ips, - get_netbox_drift_report, add_netbox_ip_address, update_netbox_interface, - populate_netbox_from_router, - get_netbox_vlan_groups, get_next_available_vlan, create_netbox_vlan_interface, - get_netbox_vlan_group_detail, - populate_netbox_bgp, get_netbox_bgp_drift, - resolve_router_host, -) -from tools.config_yaml import ( - patch_router_host, patch_router_field, - add_router_to_config, remove_router_from_config, -) -from tools.agent_memory import ( - remember_router_fact, recall_router_facts, - recall_all_router_facts, forget_router_facts, -) - -_ALL_TOOLS = [ - list_routers, get_current_time, - check_reachability, check_ssh_access, - get_system_info, - get_routing_full, get_router_config, get_bgp_sessions, get_ospf_neighbors, - get_interface_stats, - get_interface_traffic, get_traffic_summary, get_top_talkers, get_queue_stats, get_traffic_all, get_top_interfaces_all, - get_dhcp_leases, get_router_leases, search_device, audit_dhcp, - get_router_log, - run_command, run_command_all, run_command_write, - backup_router_config, list_backups, diff_config, - audit_security, - run_diagnostic, - list_reports, get_report, get_report_section, get_report_toc, - list_templates, read_template, write_document, create_template, write_skill, - fetch_url, - get_netbox_devices, get_netbox_device_interfaces, get_netbox_device_ips, - get_netbox_drift_report, add_netbox_ip_address, update_netbox_interface, - populate_netbox_from_router, - get_netbox_vlan_groups, get_next_available_vlan, create_netbox_vlan_interface, - get_netbox_vlan_group_detail, - populate_netbox_bgp, get_netbox_bgp_drift, - resolve_router_host, - patch_router_host, patch_router_field, - add_router_to_config, remove_router_from_config, - remember_router_fact, recall_router_facts, - recall_all_router_facts, forget_router_facts, -] - -# Flat map: tool name → callable -TOOL_MAP: dict[str, object] = {t.name: t for t in _ALL_TOOLS} diff --git a/tests/__init__.py b/data/.gitkeep similarity index 100% rename from tests/__init__.py rename to data/.gitkeep diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml new file mode 100644 index 0000000..0937e2f --- /dev/null +++ b/docker-compose.dev.yml @@ -0,0 +1,12 @@ +# Development override: serve the frontend straight from the working tree so +# edits show up on reload (no image rebuild). nginx is told to revalidate JS/CSS +# on every request, so a plain reload picks changes up. +services: + frontend: + volumes: + - ./frontend/index.html:/usr/share/nginx/html/index.html:ro + - ./frontend/css:/usr/share/nginx/html/css:ro + - ./frontend/js:/usr/share/nginx/html/js:ro + - ./frontend/assets:/usr/share/nginx/html/assets:ro + - ./frontend/fonts:/usr/share/nginx/html/fonts:ro + - ./frontend/nginx.conf.template:/etc/nginx/templates/default.conf.template:ro diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..da30c5a --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,50 @@ +# NetOpsUI — UI (nginx) + manager (skills / agent profiles / config views). +# +# Both containers use the host network so they can reach NetOps Agent and +# Hermes, which listen on 127.0.0.1 only; neither backend is exposed publicly. +# +# cp .env.example .env # then edit +# docker compose up -d --build +# +# Live-editing the frontend: docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d +services: + frontend: + build: ./frontend + image: netopsui-frontend + network_mode: host + environment: + UI_PORT: ${UI_PORT:-3000} + NETOPS_AGENT_URL: ${NETOPS_AGENT_URL:-http://127.0.0.1:8100} + HERMES_URL: ${HERMES_URL:-http://127.0.0.1:8642} + HERMES_API_KEY: ${HERMES_API_KEY:-} + MANAGER_URL: http://127.0.0.1:${MANAGER_PORT:-8200} + depends_on: + manager: + condition: service_healthy + restart: unless-stopped + + # Mounts are the minimum the manager needs: only skills/ (and NetOps Agent's + # SOUL.md) are writable; config.yaml and .env are read-only; sessions.db and + # the rest of each home directory are not mounted at all. + # NOTE: single-file mounts must exist on the host first, or Docker creates a + # directory in their place. ./data is committed (data/.gitkeep) for the same + # reason: if it were missing Docker would create it root-owned and the + # non-root manager could not write its database there. + manager: + build: ./server + image: netopsui-manager + network_mode: host + user: "${HOST_UID:-1000}:${HOST_GID:-1000}" + environment: + MANAGER_PORT: ${MANAGER_PORT:-8200} + volumes: + - ${DATA_DIR:-./data}:/data/netopsui + - ${NETOPS_AGENT_HOME:?set NETOPS_AGENT_HOME in .env}/skills:/data/netops/skills + - ${NETOPS_AGENT_HOME}/SOUL.md:/data/netops/SOUL.md + - ${NETOPS_AGENT_HOME}/config.yaml:/data/netops/config.yaml:ro + - ${NETOPS_AGENT_HOME}/.env:/data/netops/.env:ro + - ${HERMES_HOME:?set HERMES_HOME in .env}/skills:/data/hermes/skills + - ${HERMES_HOME}/SOUL.md:/data/hermes/SOUL.md:ro + - ${HERMES_HOME}/config.yaml:/data/hermes/config.yaml:ro + - ${HERMES_HOME}/.env:/data/hermes/.env:ro + restart: unless-stopped diff --git a/frontend/Dockerfile b/frontend/Dockerfile index 7854f56..e76a1ee 100644 --- a/frontend/Dockerfile +++ b/frontend/Dockerfile @@ -1,10 +1,23 @@ -FROM nginx:alpine +# UI: static SPA + nginx reverse proxy to the backends and the manager service. +# nginx's envsubst renders /etc/nginx/templates/*.template at container start, +# so the proxy targets and the Hermes key come from the environment, not the image. +FROM nginx:1.27-alpine COPY index.html /usr/share/nginx/html/ COPY css/ /usr/share/nginx/html/css/ COPY js/ /usr/share/nginx/html/js/ COPY assets/ /usr/share/nginx/html/assets/ COPY fonts/ /usr/share/nginx/html/fonts/ -COPY nginx.conf /etc/nginx/conf.d/default.conf +COPY nginx.conf.template /etc/nginx/templates/default.conf.template -EXPOSE 80 +# Only these are substituted; nginx's own $uri/$host etc. are left alone. +ENV NGINX_ENVSUBST_FILTER="^(UI_PORT|NETOPS_AGENT_URL|HERMES_URL|HERMES_API_KEY|MANAGER_URL)$" \ + UI_PORT=3000 \ + NETOPS_AGENT_URL=http://127.0.0.1:8100 \ + HERMES_URL=http://127.0.0.1:8642 \ + HERMES_API_KEY= \ + MANAGER_URL=http://127.0.0.1:8200 + +EXPOSE 3000 +HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \ + CMD wget -qO /dev/null http://127.0.0.1:${UI_PORT}/ || exit 1 diff --git a/frontend/Dockerfile.backend b/frontend/Dockerfile.backend deleted file mode 100644 index 68166af..0000000 --- a/frontend/Dockerfile.backend +++ /dev/null @@ -1,15 +0,0 @@ -FROM python:3.11-slim - -WORKDIR /app -RUN apt-get update \ - && apt-get install -y --no-install-recommends iputils-ping \ - && rm -rf /var/lib/apt/lists/* - - -COPY requirements.txt . -RUN pip install --no-cache-dir -r requirements.txt - -COPY . . - -EXPOSE 8000 -CMD ["uvicorn", "server:app", "--host", "0.0.0.0", "--port", "8000"] diff --git a/frontend/docker-compose.yml b/frontend/docker-compose.yml deleted file mode 100644 index 0c0172c..0000000 --- a/frontend/docker-compose.yml +++ /dev/null @@ -1,43 +0,0 @@ -services: - backend: - build: - context: .. - dockerfile: frontend/Dockerfile.backend - ports: - - "8000:8000" - volumes: - - ../backups:/app/backups - - ../laporan:/app/laporan - - ../data:/app/data - - ../skills:/app/skills - - ../agents/definitions:/app/agents/definitions - environment: - - PYTHONUNBUFFERED=1 - extra_hosts: - - "host.docker.internal:host-gateway" - networks: - - netops - restart: unless-stopped - - frontend: - build: - context: . - dockerfile: Dockerfile - ports: - - "3000:80" - volumes: - # Hot reload: mount host files directly into Nginx html dir - - ./index.html:/usr/share/nginx/html/index.html:ro - - ./css:/usr/share/nginx/html/css:ro - - ./js:/usr/share/nginx/html/js:ro - - ./assets:/usr/share/nginx/html/assets:ro - - ./fonts:/usr/share/nginx/html/fonts:ro - depends_on: - - backend - networks: - - netops - restart: unless-stopped - -networks: - netops: - driver: bridge diff --git a/frontend/js/api.js b/frontend/js/api.js deleted file mode 100644 index dc86435..0000000 --- a/frontend/js/api.js +++ /dev/null @@ -1,88 +0,0 @@ -export async function consumeSSE(response, onEvent) { - const reader = response.body.getReader(); - const decoder = new TextDecoder(); - let buf = ''; - while (true) { - const { done, value } = await reader.read(); - if (done) break; - buf += decoder.decode(value, { stream: true }); - const frames = buf.split('\n\n'); - buf = frames.pop(); - for (const frame of frames) { - const line = frame.trim(); - if (!line || line.startsWith(':')) continue; - if (line.startsWith('data: ')) { - try { const p = JSON.parse(line.slice(6)); onEvent(p.type, p.content); } catch {} - } - } - } -} - -export async function apiCreateSession() { - const r = await fetch('/session/new', { method: 'POST' }); - return r.json(); -} - -export async function apiStreamChat(threadId, message, onEvent) { - const r = await fetch('/chat', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ thread_id: threadId, message }), - }); - await consumeSSE(r, onEvent); -} - -export async function apiStopChat(threadId) { - const r = await fetch('/chat/stop', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ thread_id: threadId }), - }); - return r.json(); -} - -export async function apiApprove(threadId, decision, onEvent) { - const r = await fetch('/approve', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ thread_id: threadId, decision }), - }); - await consumeSSE(r, onEvent); -} - -export async function apiInfo() { return (await fetch('/info')).json(); } -export async function apiStatus() { - try { return (await fetch('/api/status')).json(); } catch { return null; } -} - -export async function apiGet(path) { - const r = await fetch(path); - if (!r.ok) throw new Error(`HTTP ${r.status} ${path}`); - return r.json(); -} - -export async function apiPost(path, body) { - const r = await fetch(path, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(body || {}), - }); - if (!r.ok) throw new Error(`HTTP ${r.status} ${path}`); - return r.json(); -} - -export async function apiPut(path, body) { - const r = await fetch(path, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(body || {}), - }); - if (!r.ok) throw new Error(`HTTP ${r.status} ${path}`); - return r.json(); -} - -export async function apiDelete(path) { - const r = await fetch(path, { method: 'DELETE' }); - if (!r.ok) throw new Error(`HTTP ${r.status} ${path}`); - return r.json(); -} diff --git a/frontend/js/app.js b/frontend/js/app.js index b52c41c..24e53e5 100644 --- a/frontend/js/app.js +++ b/frontend/js/app.js @@ -5,13 +5,10 @@ import { NAV_ITEMS } from './config.js'; import { screenDashboard } from './screens/dashboard.js'; import { screenChat, chatUnmount } from './screens/chat.js'; -import { screenNodes } from './screens/nodes.js'; import { screenSkills } from './screens/skills.js'; import { screenAgents } from './screens/agents.js'; -import { screenReports } from './screens/reports.js'; -import { screenReports as screenBackups } from './screens/reports.js'; -import { screenMetrics } from './screens/metrics.js'; import { screenSettings } from './screens/settings.js'; +import { screenUnavailable } from './screens/unavailable.js'; let _currentUnmount = null; @@ -21,50 +18,33 @@ async function navigate(screenId, param) { S.screen = screenId; renderNav(); + const item = NAV_ITEMS.find(n => n.id === screenId); const breadcrumb = document.getElementById('breadcrumb-page'); - if (breadcrumb) { - const item = NAV_ITEMS.find(n => n.id === screenId); - breadcrumb.textContent = item ? item.label : screenId; - } + if (breadcrumb) breadcrumb.textContent = item ? item.label : screenId; const c = $('screen-container'); if (!c) return; c.innerHTML = ''; + if (!item || item.unavailable) { + screenUnavailable(c, screenId); + return; + } + switch (screenId) { case 'dashboard': await screenDashboard(c); break; case 'chat': await screenChat(c, param); _currentUnmount = chatUnmount; break; - case 'nodes': await screenNodes(c); break; case 'skills': await screenSkills(c); break; - case 'agents': await screenAgents(c, param); break; - case 'reports': await screenReports(c); break; - case 'backups': await screenBackups(c); break; - case 'metrics': await screenMetrics(c); break; + case 'agents': await screenAgents(c); break; case 'settings': await screenSettings(c); break; - default: placeholderScreen(c, screenId); break; + default: screenUnavailable(c, screenId); break; } } -function placeholderScreen(c, id) { - const item = NAV_ITEMS.find(n => n.id === id) || { label: id, icon: 'widgets' }; - c.innerHTML = `
-
-

${item.label}

-

This screen is under development.

-
-
- ${item.icon} -

${item.label}

-

Use AI Chat to interact with the system.

- -
-
`; -} - function onHash() { const raw = location.hash.slice(1) || 'dashboard'; const [id, ...rest] = raw.split('/'); diff --git a/frontend/js/backends/common.js b/frontend/js/backends/common.js new file mode 100644 index 0000000..bdda17e --- /dev/null +++ b/frontend/js/backends/common.js @@ -0,0 +1,88 @@ +// Shared HTTP/SSE helpers for the backend adapters. Every backend is reached +// through the nginx proxy under /backend// (see nginx.conf.template), so +// the browser never talks to the backends directly and never holds an API key. + +export class HttpError extends Error { + constructor(status, message) { + super(message); + this.status = status; + } +} + +export async function http(base, path, { method = 'GET', body, signal } = {}) { + const init = { method, signal, headers: {} }; + if (body !== undefined) { + init.headers['Content-Type'] = 'application/json'; + init.body = JSON.stringify(body); + } + const r = await fetch(base + path, init); + if (!r.ok) throw new HttpError(r.status, `HTTP ${r.status} ${path}: ${await errorDetail(r)}`); + if (r.status === 204) return null; + const text = await r.text(); + return text ? JSON.parse(text) : null; +} + +async function errorDetail(r) { + const text = await r.text().catch(() => ''); + try { + const j = JSON.parse(text); + return j.detail || j.error?.message || j.error || j.message || text; + } catch { + return text || r.statusText; + } +} + +export async function ensureOk(r, path) { + if (!r.ok) throw new HttpError(r.status, `HTTP ${r.status} ${path}: ${await errorDetail(r)}`); + return r; +} + +// Parses a text/event-stream body. Calls onFrame({ event, data }) per frame, +// where `data` is the parsed JSON payload (or the raw string when it is not +// JSON). Comment frames (": ping", ": keepalive") are skipped. +export async function readSSE(response, onFrame) { + const reader = response.body.getReader(); + const decoder = new TextDecoder(); + let buf = ''; + while (true) { + const { done, value } = await reader.read(); + if (done) break; + buf += decoder.decode(value, { stream: true }); + const frames = buf.split(/\r?\n\r?\n/); + buf = frames.pop(); + for (const frame of frames) dispatchFrame(frame, onFrame); + } + if (buf.trim()) dispatchFrame(buf, onFrame); +} + +function dispatchFrame(frame, onFrame) { + let event = null; + const dataLines = []; + for (const line of frame.split(/\r?\n/)) { + if (!line || line.startsWith(':')) continue; + if (line.startsWith('event:')) event = line.slice(6).trim(); + else if (line.startsWith('data:')) dataLines.push(line.slice(5).replace(/^ /, '')); + } + if (!dataLines.length) return; + const raw = dataLines.join('\n'); + let data = raw; + try { data = JSON.parse(raw); } catch { /* keep raw string */ } + onFrame({ event, data }); +} + +// Unix seconds (float) / milliseconds / ISO string → Date (null when unusable). +export function toDate(v) { + if (v == null || v === '') return null; + if (typeof v === 'number') return new Date(v < 1e12 ? v * 1000 : v); + const d = new Date(v); + return isNaN(d) ? null : d; +} + +// Message content may be a plain string or an OpenAI-style parts array. +export function contentText(content) { + if (typeof content === 'string') return content; + if (Array.isArray(content)) { + return content.map(p => (typeof p === 'string' ? p : p?.text || '')).filter(Boolean).join('\n'); + } + return ''; +} diff --git a/frontend/js/backends/hermes.js b/frontend/js/backends/hermes.js new file mode 100644 index 0000000..0e3c0db --- /dev/null +++ b/frontend/js/backends/hermes.js @@ -0,0 +1,172 @@ +// Hermes adapter (hermes-agent gateway, platform `api_server`). +// +// Threads are Hermes sessions (/api/sessions), persisted server-side. Each +// turn is a run: POST /v1/runs starts it bound to the session, then +// GET /v1/runs/{id}/events streams lifecycle events. The runs API (rather than +// /api/sessions/{id}/chat/stream) is used because only runs emit +// `approval.request` and accept /approval and /stop. +// +// The API key (API_SERVER_KEY) is injected by the nginx proxy — never here. +import { http, ensureOk, readSSE, toDate, contentText } from './common.js'; +import { mgr, getActiveProfile } from '../manager.js'; + +const BASE = '/backend/hermes'; +const _runs = {}; // threadId → run_id of the in-flight run + +function summary(s) { + const created = toDate(s.started_at) || new Date(); + return { + id: s.id, + title: s.title || s.preview || 'New Chat', + createdAt: created, + updatedAt: toDate(s.last_active) || created, + lastMessage: s.preview || '', + }; +} + +export const hermes = { + id: 'hermes', + label: 'Hermes Agent', + shortLabel: 'Hermes', + description: 'Agent Hermes (NousResearch) lewat gateway api_server: session tersimpan di server, approval command berisiko, stop, dan skills.', + capabilities: { + approval: true, + stop: 'interrupt', + serverThreads: true, + }, + + async health() { + const h = await http(BASE, '/health'); + let model = '—'; + try { + const m = await http(BASE, '/v1/models'); + model = m?.data?.[0]?.id || model; + } catch { /* /health is enough to call it reachable */ } + return { ok: h?.status === 'ok', model, detail: h?.version ? `hermes-agent ${h.version}` : '' }; + }, + + async listThreads() { + const r = await http(BASE, '/api/sessions?limit=50&source=api_server'); + return (r?.data || []).map(summary); + }, + + async createThread() { + const r = await http(BASE, '/api/sessions', { method: 'POST', body: {} }); + return summary(r.session); + }, + + async loadMessages(id) { + const r = await http(BASE, `/api/sessions/${encodeURIComponent(id)}/messages`); + return (r?.data || []) + .filter(m => m.role === 'user' || m.role === 'assistant') + .map(m => ({ role: m.role === 'assistant' ? 'agent' : 'user', content: contentText(m.content) })) + .filter(m => m.content); + }, + + async renameThread(id, title) { + await http(BASE, `/api/sessions/${encodeURIComponent(id)}`, { method: 'PATCH', body: { title } }); + }, + + async deleteThread(id) { + await http(BASE, `/api/sessions/${encodeURIComponent(id)}`, { method: 'DELETE' }); + }, + + async send(threadId, text, emit) { + const body = { input: text, session_id: threadId }; + const slug = getActiveProfile(); + if (slug) { + // The profile prompt rides along as the run's ephemeral system prompt. + try { body.instructions = (await mgr('/profiles/' + encodeURIComponent(slug))).prompt; } + catch (e) { emit({ type: 'note', text: `Profil "${slug}" tidak dimuat (${e.message}); dijalankan tanpa profil.` }); } + } + const start = await http(BASE, '/v1/runs', { method: 'POST', body }); + const runId = start.run_id; + _runs[threadId] = runId; + let streamed = false; + try { + const r = await fetch(`${BASE}/v1/runs/${encodeURIComponent(runId)}/events`); + await ensureOk(r, '/v1/runs/{id}/events'); + await readSSE(r, ({ data: ev }) => { + if (!ev || typeof ev !== 'object') return; + switch (ev.event) { + case 'message.delta': + streamed = true; + emit({ type: 'delta', text: ev.delta || '' }); + break; + case 'message.interim': + emit({ type: 'note', text: ev.text || '' }); + break; + case 'reasoning.available': + if (ev.text) emit({ type: 'thinking', text: ev.text }); + break; + case 'tool.started': + emit({ type: 'tool_start', name: ev.tool, detail: ev.preview || '' }); + break; + case 'tool.completed': + emit({ + type: 'tool_end', name: ev.tool, detail: ev.preview || '', + durationMs: (ev.duration || 0) * 1000, error: !!ev.error, + }); + break; + case 'subagent.start': + case 'subagent.complete': + emit({ type: 'note', text: `${ev.event}${ev.preview ? ': ' + ev.preview : ''}` }); + break; + case 'approval.request': + emit({ + type: 'approval', + data: { + action: ev.command || ev.description || '—', + description: ev.description || '', + choices: ev.choices || ['once', 'deny'], + requestId: ev.request_id || null, + }, + }); + break; + case 'approval.responded': + emit({ type: 'note', text: `Approval: ${ev.choice}` }); + break; + case 'run.completed': + // Deltas already carried the text; `output` is the fallback when + // the provider did not stream. + if (!streamed && ev.output) emit({ type: 'delta', text: ev.output }); + break; + case 'run.failed': + emit({ type: 'error', text: ev.error || 'Run gagal' }); + break; + case 'run.cancelled': + case 'run.interrupted': + emit({ type: 'stopped', text: ev.error || 'Run dihentikan.' }); + break; + } + }); + } finally { + delete _runs[threadId]; + } + }, + + async stop(threadId) { + const runId = _runs[threadId]; + if (!runId) return { ok: false }; + await http(BASE, `/v1/runs/${encodeURIComponent(runId)}/stop`, { method: 'POST', body: {} }); + return { ok: true }; + }, + + // choice: 'once' | 'session' | 'always' | 'deny' + async respondApproval(threadId, choice, requestId) { + const runId = _runs[threadId]; + if (!runId) throw new Error('Tidak ada run aktif'); + const body = { choice }; + if (requestId) body.request_id = requestId; + await http(BASE, `/v1/runs/${encodeURIComponent(runId)}/approval`, { method: 'POST', body }); + }, + + async listSkills() { + const r = await http(BASE, '/v1/skills'); + return (r?.data || []).map(s => ({ + name: s.name, + description: s.description || '', + tags: s.category ? [s.category] : [], + })); + }, +}; diff --git a/frontend/js/backends/index.js b/frontend/js/backends/index.js new file mode 100644 index 0000000..3e79478 --- /dev/null +++ b/frontend/js/backends/index.js @@ -0,0 +1,48 @@ +// Backend registry. Exactly one backend is active at a time for the whole UI; +// the choice is made on the Settings screen and remembered per browser. +// +// Adapter contract (see netops.js / hermes.js): +// id, label, shortLabel, description, capabilities { approval, stop, serverThreads } +// health() → { ok, model, detail } +// listThreads() → [{ id, title, createdAt, updatedAt, lastMessage }] +// createThread() → thread summary +// loadMessages(id) → [{ role: 'user' | 'agent', content }] +// renameThread(id, title), deleteThread(id) +// send(threadId, text, emit) → resolves when the turn ends; emit(event) with +// { type: 'delta', text } | { type: 'tool_start', name, detail } +// { type: 'tool_end', name, detail, durationMs, error } +// { type: 'note' | 'thinking' | 'error' | 'stopped', text } +// { type: 'approval', data: { action, description, choices, requestId } } +// stop(threadId) → { ok } +// respondApproval(threadId, choice, requestId) (only when capabilities.approval) +// listSkills() → [{ name, description, tags }] +import { netops } from './netops.js'; +import { hermes } from './hermes.js'; + +export const BACKENDS = { netops, hermes }; + +const STORAGE_KEY = 'llmnetops-backend'; +const DEFAULT_BACKEND = 'netops'; + +function readChoice() { + try { + let v = localStorage.getItem(STORAGE_KEY); + if (v === 'palapa') v = 'netops'; // id used before the rename + return BACKENDS[v] ? v : DEFAULT_BACKEND; + } catch { + return DEFAULT_BACKEND; + } +} + +let _activeId = readChoice(); + +export function activeBackend() { + return BACKENDS[_activeId]; +} + +export function setActiveBackend(id) { + if (!BACKENDS[id]) throw new Error(`Backend tidak dikenal: ${id}`); + _activeId = id; + try { localStorage.setItem(STORAGE_KEY, id); } catch { /* per-session only */ } + window.dispatchEvent(new CustomEvent('backend-changed', { detail: { id } })); +} diff --git a/frontend/js/backends/netops.js b/frontend/js/backends/netops.js new file mode 100644 index 0000000..e6b8e85 --- /dev/null +++ b/frontend/js/backends/netops.js @@ -0,0 +1,152 @@ +// NetOps Agent adapter (the palapa-agent REST API, palapa/gateway/api.py). +// +// NetOps Agent's POST /chat is stateless: the client sends the whole conversation +// every turn and nothing is persisted per thread on the server. Threads and +// their messages therefore live in this browser's localStorage. NetOps Agent has no +// approval flow (its network tools are read-only) and no stop endpoint — Stop +// aborts the SSE stream, but the agent loop on the server keeps running until +// it finishes on its own. +import { http, ensureOk, readSSE } from './common.js'; + +const BASE = '/backend/netops'; +const STORAGE_KEY = 'llmnetops-netops-threads-v1'; +const LEGACY_STORAGE_KEY = 'llmnetops-palapa-threads-v1'; // key used before the rename +const MAX_THREADS = 100; + +let _threads = load(); +const _controllers = {}; // threadId → AbortController of the in-flight /chat + +function load() { + try { + return JSON.parse(localStorage.getItem(STORAGE_KEY) ?? localStorage.getItem(LEGACY_STORAGE_KEY)) || {}; + } catch { return {}; } +} + +function save() { + try { localStorage.setItem(STORAGE_KEY, JSON.stringify(_threads)); } catch { /* storage full — in-memory only */ } +} + +function summary(t) { + return { + id: t.id, + title: t.title, + createdAt: new Date(t.createdAt), + updatedAt: new Date(t.updatedAt), + lastMessage: t.lastMessage || '', + }; +} + +function ensureThread(id) { + if (!_threads[id]) { + const now = Date.now(); + _threads[id] = { id, title: 'New Chat', createdAt: now, updatedAt: now, lastMessage: '', messages: [] }; + } + return _threads[id]; +} + +export const netops = { + id: 'netops', + label: 'NetOps Agent', + shortLabel: 'NetOps Agent', + description: 'Agent lokal berbasis Ollama dengan network tools read-only (Netmiko), skills, dan delegasi ke child agent.', + capabilities: { + approval: false, + stop: 'abort', // only cuts the stream; the server-side run is not interrupted + serverThreads: false, // threads are stored in the browser + }, + + async health() { + const h = await http(BASE, '/health'); + return { ok: h?.status === 'ok', model: h?.model || '—', detail: h?.base_url || '' }; + }, + + async listThreads() { + return Object.values(_threads).map(summary).sort((a, b) => b.updatedAt - a.updatedAt); + }, + + async createThread() { + const ids = Object.keys(_threads); + if (ids.length >= MAX_THREADS) { + const oldest = ids.sort((a, b) => _threads[a].updatedAt - _threads[b].updatedAt)[0]; + delete _threads[oldest]; + } + const t = ensureThread(crypto.randomUUID()); + save(); + return summary(t); + }, + + async loadMessages(id) { + return (_threads[id]?.messages || []).map(m => ({ ...m })); + }, + + async renameThread(id, title) { + ensureThread(id).title = title; + save(); + }, + + async deleteThread(id) { + delete _threads[id]; + save(); + }, + + async send(threadId, text, emit) { + const t = ensureThread(threadId); + const messages = [ + ...t.messages + .filter(m => m.content) + .map(m => ({ role: m.role === 'agent' ? 'assistant' : 'user', content: m.content })), + { role: 'user', content: text }, + ]; + + const controller = new AbortController(); + _controllers[threadId] = controller; + let answer = ''; + try { + const r = await fetch(BASE + '/chat', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ messages }), + signal: controller.signal, + }); + await ensureOk(r, '/chat'); + await readSSE(r, ({ data }) => { + if (!data || typeof data !== 'object') return; + if (data.type === 'delta') { + answer += data.content || ''; + emit({ type: 'delta', text: data.content || '' }); + } else if (data.type === 'tool_call') { + // NetOps Agent reports a tool call once, after it has finished. + emit({ + type: 'tool_end', + name: data.name, + detail: data.arguments || '', + durationMs: (data.duration || 0) * 1000, + }); + } + }); + } catch (e) { + if (e.name !== 'AbortError') throw e; + emit({ type: 'stopped', text: 'Stream dihentikan operator. Proses di server NetOps Agent tetap berjalan sampai selesai, tetapi hasilnya tidak diterima.' }); + } finally { + delete _controllers[threadId]; + t.messages.push({ role: 'user', content: text }); + t.messages.push({ role: 'agent', content: answer }); + if (t.title === 'New Chat') t.title = text.slice(0, 60); + t.lastMessage = text.slice(0, 120); + t.updatedAt = Date.now(); + save(); + } + }, + + async stop(threadId) { + const c = _controllers[threadId]; + if (!c) return { ok: false }; + c.abort(); + return { ok: true }; + }, + + async listSkills() { + const rows = await http(BASE, '/skills'); + return (rows || []).map(s => ({ name: s.name, description: s.description || '', tags: s.tags || [] })); + }, +}; diff --git a/frontend/js/components.js b/frontend/js/components.js deleted file mode 100644 index 2e88bc5..0000000 --- a/frontend/js/components.js +++ /dev/null @@ -1,77 +0,0 @@ -export function icon(name, cls = '') { - return `${name}` -} - -export function statusBadge(label, variant = 'green') { - const colors = { - green: 'bg-green-50 text-green-700 border-green-100', - amber: 'bg-amber-50 text-amber-700 border-amber-100', - red: 'bg-red-50 text-red-700 border-red-100', - blue: 'bg-blue-50 text-blue-700 border-blue-100', - gray: 'bg-surface-container text-on-surface-variant border-outline-variant', - } - const c = colors[variant] || colors.gray - return `${label}` -} - -export function statCard(label, value, trend = '', trendColor = 'green') { - const tc = trendColor === 'red' ? 'text-red-600' : 'text-green-600' - return ` -
-

${label}

-
- ${value} - ${trend ? `${trend}` : ''} -
-
` -} - -export function card(title, content, headerRight = '') { - return ` -
-
-

${title}

- ${headerRight} -
-
${content}
-
` -} - -export function agentCard(alias, role, state, detail = '') { - const stateColors = { - standby: { dot: 'bg-gray-300', text: 'text-on-surface-variant', label: 'STANDBY', border: '' }, - running: { dot: 'bg-green-500', text: 'text-green-700', label: 'RUNNING', border: 'border-l-green-500' }, - waiting: { dot: 'bg-amber-500', text: 'text-amber-700', label: 'WAITING', border: 'border-l-amber-500' }, - done: { dot: 'bg-gray-400', text: 'text-on-surface-variant', label: 'DONE', border: '' }, - failed: { dot: 'bg-red-500', text: 'text-red-700', label: 'FAILED', border: 'border-l-red-500' }, - nonaktif: { dot: 'bg-gray-200', text: 'text-on-surface-variant', label: 'DISABLED', border: '' }, - } - const s = stateColors[state] || stateColors.standby - const pulse = state === 'running' ? 'pulse-green' : '' - return ` -
-
-
- ${alias} - ${role} -
-
- - ${s.label} -
-
- ${detail ? `

${escapeHtml(detail)}

` : ''} -
` -} - -export function escapeHtml(str) { - const d = document.createElement('div') - d.textContent = str - return d.innerHTML -} - -export function formatTime(date) { - const d = date || new Date() - const pad = n => String(n).padStart(2, '0') - return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}` -} diff --git a/frontend/js/config.js b/frontend/js/config.js index 028e892..2c63f53 100644 --- a/frontend/js/config.js +++ b/frontend/js/config.js @@ -1,28 +1,19 @@ -export const AGENTS = [ - { name:'supervisor', alias:'bambang', role:'supervisor', icon:'account_tree' }, - { name:'monitor_agent', alias:'eko', role:'monitor', icon:'monitoring' }, - { name:'diagnose_agent', alias:'agus', role:'diagnosa', icon:'troubleshoot' }, - { name:'config_agent', alias:'joko', role:'config', icon:'settings_suggest' }, - { name:'security_agent', alias:'satria', role:'security', icon:'shield' }, - { name:'document_agent', alias:'budi', role:'dokumen', icon:'description' }, - { name:'netbox_agent', alias:'yanto', role:'netbox', icon:'storage' }, - { name:'validasi_agent', alias:'wati', role:'validasi', icon:'verified' }, -]; - // Consecutive items sharing the same `group` are rendered together under a // section header in the sidebar (see shell.js renderNav()); items without a // `group` render at the root with no header. Order here is display order. +// `unavailable` marks screens whose data lived in the old monolithic backend +// and has no counterpart in NetOps Agent or Hermes yet — they stay in the nav +// but render the "Belum tersedia" placeholder (screens/unavailable.js). +// Skills and Agents are managed by NetOpsUI's own service (server/), not by +// the backends. export const NAV_ITEMS = [ { id:'dashboard', label:'Dashboard', icon:'dashboard' }, { id:'chat', label:'AI Chat', icon:'chat_bubble' }, - { id:'nodes', label:'Nodes', icon:'dns', group:'Infrastructure' }, + { id:'nodes', label:'Nodes', icon:'dns', group:'Infrastructure', unavailable:true }, { id:'skills', label:'Skills', icon:'psychology', group:'Agent Platform' }, { id:'agents', label:'Agents', icon:'smart_toy', group:'Agent Platform' }, - { id:'reports', label:'Reports', icon:'assessment', group:'Insights' }, - { id:'backups', label:'Backups', icon:'backup', group:'Insights' }, - { id:'metrics', label:'Metrics', icon:'insights', group:'Insights' }, + { id:'reports', label:'Reports', icon:'assessment', group:'Insights', unavailable:true }, + { id:'backups', label:'Backups', icon:'backup', group:'Insights', unavailable:true }, + { id:'metrics', label:'Metrics', icon:'insights', group:'Insights', unavailable:true }, { id:'settings', label:'Settings', icon:'settings' }, ]; - -export const ROLE_TO_ALIAS = {}; -AGENTS.forEach(a => { ROLE_TO_ALIAS[a.name] = a.alias; }); diff --git a/frontend/js/manager.js b/frontend/js/manager.js new file mode 100644 index 0000000..9e9897b --- /dev/null +++ b/frontend/js/manager.js @@ -0,0 +1,36 @@ +// Client for the NetOpsUI management service (server/), reached at /api/ via +// nginx. It owns skills, agent profiles and the read-only views of each +// backend's config files — things NetOps Agent and Hermes have no API for. +import { HttpError } from './backends/common.js'; + +export async function mgr(path, { method = 'GET', body } = {}) { + const init = { method, headers: {} }; + if (body !== undefined) { + init.headers['Content-Type'] = 'application/json'; + init.body = JSON.stringify(body); + } + const r = await fetch('/api' + path, init); + const text = await r.text(); + let data = null; + try { data = text ? JSON.parse(text) : null; } catch { /* non-JSON error page from the proxy */ } + if (!r.ok) { + const detail = data?.detail; + const msg = typeof detail === 'string' ? detail : Array.isArray(detail) ? detail.map(d => d.msg).join('; ') + : r.status === 502 || r.status === 504 ? 'Manager service tidak terjangkau' : text || r.statusText; + throw new HttpError(r.status, msg); + } + return data; +} + +// Agent profile chosen for Hermes chats (NetOps Agent takes its persona from SOUL.md). +const PROFILE_KEY = 'llmnetops-hermes-profile'; + +export function getActiveProfile() { + try { return localStorage.getItem(PROFILE_KEY) || null; } catch { return null; } +} + +export function setActiveProfile(slug) { + try { + if (slug) localStorage.setItem(PROFILE_KEY, slug); else localStorage.removeItem(PROFILE_KEY); + } catch { /* per-session only */ } +} diff --git a/frontend/js/screens/agents.js b/frontend/js/screens/agents.js index fab6c89..20657a4 100644 --- a/frontend/js/screens/agents.js +++ b/frontend/js/screens/agents.js @@ -1,380 +1,119 @@ -import { apiGet, apiPut, apiPost } from '../api.js'; -import { $, esc, badge, pageHeader, loadingHtml, errorHtml, alertDialog, confirmDialog } from '../utils.js'; -import { mountTagInput } from '../tag-input.js'; - -let _agentsCache = []; -let _selectedName = null; -let _detailCache = {}; // name -> full detail payload, invalidated on save/restore -let _toolNamesCache = null; -let _skillNamesCache = null; -let _llmProfilesCache = null; -let _resizeHandler = null; - -// The panel's sticky top can't be a hardcoded pixel guess — pageHeader's subtitle -// wraps to a different number of lines depending on viewport width, which shifts -// where the panel actually starts. Measure its real static (unstuck) position and -// derive max-height from that so the bottom always lands just above the viewport -// edge instead of running off the bottom. -function fitDetailPanel() { - const panel = $('agent-detail-panel'); - if (!panel) return; - const top = Math.round(panel.getBoundingClientRect().top); - panel.style.top = `${top}px`; - panel.style.maxHeight = `calc(100vh - ${top}px - 24px)`; -} - -async function getToolNames() { - if (!_toolNamesCache) { - const r = await apiGet('/api/tool-names'); - _toolNamesCache = r.tools || []; - } - return _toolNamesCache; -} - -async function getSkillNames() { - if (!_skillNamesCache) { - const r = await apiGet('/api/skills'); - _skillNamesCache = (r.skills || []).map(s => s.name); - } - return _skillNamesCache; -} - -// Active LLM connection profiles, configured in #settings. Multiple profiles can be -// active at once so different agents can each be wired to a different backend. -async function getActiveLlmProfiles() { - if (!_llmProfilesCache) { - const r = await apiGet('/api/config/llm/profiles'); - _llmProfilesCache = (r.profiles || []).filter(p => p.is_active); - } - return _llmProfilesCache; -} - -export async function screenAgents(c, param) { - c.innerHTML = `
- ${pageHeader('Agents', 'Kelola konfigurasi specialist agent. Pilih agent di kiri untuk edit. Perubahan disimpan ke database dan baru berlaku setelah server di-restart.')} -
-
+import { $, esc, badge, pageHeader, loadingHtml, errorHtml, confirmDialog, alertDialog } from '../utils.js'; +import { mgr, getActiveProfile, setActiveProfile } from '../manager.js'; + +const SLUG_RE = /^[a-z0-9][a-z0-9-]{0,63}$/; + +// Agent profiles = named system prompts kept in NetOpsUI's DB. +// - Hermes: the active profile is sent with every chat run as `instructions`. +// - NetOps Agent: has no per-request prompt; a profile can be applied to its +// SOUL.md (persona file), which replaces the file (old one is backed up). +export async function screenAgents(c) { + let profiles = [], selected = null, isNew = false; + + c.innerHTML = `
+ ${pageHeader('Agents', 'Profil agent (prompt) yang dikelola di NetOpsUI. Dipakai per-chat di Hermes, atau diterapkan ke SOUL.md NetOps Agent.', ` + `)} +
+
-
- - - - - - - -
AgentModelStatus
${loadingHtml()}
-
-
-
-
-
- ${emptyPanelHtml()} +
${loadingHtml('Memuat...')}
+
`; - fitDetailPanel(); - if (_resizeHandler) window.removeEventListener('resize', _resizeHandler); - _resizeHandler = fitDetailPanel; - window.addEventListener('resize', _resizeHandler); - - _selectedName = null; - await loadAgents(); - - if (param && _agentsCache.some(a => a.name === param)) { - await selectAgent(param); + function renderList() { + const active = getActiveProfile(); + $('ag-list').innerHTML = profiles.length ? profiles.map(p => ` + `).join('') : `

Belum ada profil.

`; + $('ag-list').querySelectorAll('[data-slug]').forEach(b => { b.onclick = () => select(b.dataset.slug); }); } -} - -function emptyPanelHtml() { - return `
- smart_toy -

Pilih agent di tabel untuk melihat dan mengedit konfigurasinya.

-
`; -} -async function loadAgents() { - const tb = $('agents-tbody'); - try { - const r = await apiGet('/api/agents'); - _agentsCache = r.agents || []; - renderRows(); - // If a row was selected (e.g. right after save/restore), refresh its panel in place - if (_selectedName && _agentsCache.some(a => a.name === _selectedName)) { - await renderDetailPanel(_selectedName); + function renderEditor() { + const el = $('ag-editor'); + if (!isNew && !selected) { + el.innerHTML = `
Pilih profil di kiri, atau buat profil baru.
`; + return; } - } catch (e) { - if (tb) tb.innerHTML = `${errorHtml('Gagal memuat agents: ' + e.message)}`; - } -} - -function renderRows() { - const tb = $('agents-tbody'); - if (!tb) return; - - if (!_agentsCache.length) { - tb.innerHTML = `Tidak ada agent ditemukan.`; - return; - } - - tb.innerHTML = _agentsCache.map(a => summaryRowHtml(a)).join(''); - - tb.querySelectorAll('[data-row-select]').forEach(row => { - row.onclick = () => selectAgent(row.dataset.rowSelect); - }); -} - -function summaryRowHtml(a) { - const isSelected = _selectedName === a.name; - return ` - -

${esc(a.name)}

-

${esc(a.alias || '')}

- - ${esc(a.model || '')} - - ${badge(a.enabled !== false ? 'ENABLED' : 'DISABLED', a.enabled !== false ? 'green' : 'gray')} - ${a.has_default ? badge('MODIFIED', 'amber') : ''} - - `; -} - -async function selectAgent(name) { - _selectedName = name; - renderRows(); - await renderDetailPanel(name); -} - -async function renderDetailPanel(name) { - const panel = $('agent-detail-panel'); - if (!panel) return; - panel.innerHTML = loadingHtml('Memuat detail agent...'); - - try { - const agent = _detailCache[name] || await apiGet(`/api/agents/${encodeURIComponent(name)}`); - _detailCache[name] = agent; - if (_selectedName !== name) return; // user already clicked another row while this was loading - panel.innerHTML = editFormHtml(agent); - await wireEditForm(agent); - } catch (e) { - if (_selectedName !== name) return; - panel.innerHTML = errorHtml('Gagal memuat agent: ' + e.message); - } -} - -function editFormHtml(agent) { - return `
-

${esc(agent.name)}${agent.alias ? ` (${esc(agent.alias)})` : ''}

- -
-
- -
- - -
-
-
- - -

Daftar model dimuat dari Ollama Host di sebelah kanan.

-
-
- - -

Dari LLM Connection Profiles yang aktif di Settings. Kosongkan untuk pakai default global.

-
-
-
-
- - -
-
- - -
-
-
-
- - -
-
- - -
-
- - + const p = isNew ? { slug: '', name: '', description: '', prompt: '' } : profiles.find(x => x.slug === selected); + if (!p) { el.innerHTML = ''; return; } + const isActive = getActiveProfile() === p.slug; + el.innerHTML = `
+

${isNew ? 'Profil Baru' : esc(p.name)}

+
+
+ + +
+ + +
+
+ + ${isNew ? '' : ` + + + + `} +
-
-
- -
-
-
- -
-
-
- - -
-
- - -
-
-
- ${agent.has_default - ? `` - : ''} -
- - - -
-
`; -} - -async function wireEditForm(agent) { - // Set textarea value directly — bypasses HTML parsing of potentially large text - $('af-body').value = agent.body || ''; - - const [toolNames, skillNames, llmProfiles] = await Promise.all([getToolNames(), getSkillNames(), getActiveLlmProfiles()]); - const toolsWidget = mountTagInput($('af-tools'), { initial: agent.tools || [], options: toolNames, placeholder: 'Cari tool...' }); - const skillsWidget = mountTagInput($('af-skills'), { initial: agent.skills || [], options: skillNames, placeholder: 'Cari skill...' }); - - const hostSelect = $('af-ollama-host'); - const current = agent.ollama_host || ''; - const knownUrls = new Set(llmProfiles.map(p => p.base_url)); - const customOpt = current && !knownUrls.has(current) - ? `` : ''; - hostSelect.innerHTML = `${customOpt}` - + llmProfiles.map(p => ``).join(''); - - // Model dropdown depends on which host is selected — fetch the model list for - // that connection so the operator picks from what's actually available instead - // of typing a name that might not exist (typos silently break the agent). - function setModelOptions(models, currentValue) { - const sel = $('af-model'); - if (!sel) return; - const values = [...models]; - if (currentValue && !values.includes(currentValue)) values.unshift(currentValue); - sel.innerHTML = values.length - ? values.map(m => ``).join('') - : ``; - if (currentValue) sel.value = currentValue; +
`; + $('g-save').onclick = save; + if ($('g-use')) $('g-use').onclick = () => { setActiveProfile(isActive ? null : p.slug); renderList(); renderEditor(); }; + if ($('g-soul')) $('g-soul').onclick = applySoul; + if ($('g-delete')) $('g-delete').onclick = del; } - async function refreshModelOptions() { - const hint = $('af-model-hint'); - const currentModel = ($('af-model').value || '').trim() || agent.model || ''; - const hostUrl = hostSelect.value; - const matchedProfile = llmProfiles.find(p => p.base_url === hostUrl); - if (hint) hint.textContent = 'Memuat model tersedia...'; + const form = () => ({ slug: $('g-slug').value.trim(), name: $('g-name').value.trim(), description: $('g-desc').value.trim(), prompt: $('g-prompt').value }); + + async function save() { + const f = form(), err = $('g-err'); + if (!f.name) { err.textContent = 'Nama wajib diisi.'; return; } + if (isNew && !SLUG_RE.test(f.slug)) { err.textContent = 'Slug harus huruf kecil/angka/strip, maksimal 64 karakter.'; return; } try { - const r = matchedProfile - ? await apiPost(`/api/config/llm/profiles/${matchedProfile.id}/models`, {}) - : await apiPost('/api/llm/models', hostUrl ? { base_url: hostUrl } : {}); - if (r.ok) { - setModelOptions(r.models, currentModel); - if (hint) hint.textContent = `${r.models.length} model ditemukan dari ${matchedProfile ? matchedProfile.name : (hostUrl || 'default global')} (${r.latency_ms} ms).`; - } else if (hint) { - hint.textContent = `Gagal memuat model dari host ini: ${r.error || 'Unknown error'}. Model saat ini (${esc(currentModel)}) tetap dipakai.`; - } - } catch (e) { - if (hint) hint.textContent = 'Gagal menghubungi backend: ' + e.message; - } + const saved = isNew ? await mgr('/profiles', { method: 'POST', body: f }) : await mgr('/profiles/' + f.slug, { method: 'PUT', body: f }); + isNew = false; await load(); select(saved.slug); + } catch (e) { err.textContent = e.message; } } - hostSelect.onchange = refreshModelOptions; - refreshModelOptions(); - - $('af-close').onclick = () => { - _selectedName = null; - renderRows(); - $('agent-detail-panel').innerHTML = emptyPanelHtml(); - }; - - // Reset just re-renders the panel from the last-loaded (cached) agent data, discarding edits - $('af-cancel').onclick = async () => { - $('agent-detail-panel').innerHTML = editFormHtml(agent); - await wireEditForm(agent); - }; - - const restoreBtn = $('af-restore'); - if (restoreBtn) restoreBtn.onclick = async () => { + async function applySoul() { + const cur = await mgr('/backends/netops/soul').catch(() => null); const ok = await confirmDialog({ - title: 'Restore ke default?', - message: `Semua perubahan pada agent "${agent.name}" akan dikembalikan ke versi default dari repo. Tindakan ini tidak bisa dibatalkan.`, - confirmLabel: 'Restore', danger: true, + title: 'Timpa SOUL.md NetOps Agent?', + message: `Isi SOUL.md saat ini akan diganti dengan prompt profil ini dan berlaku untuk semua sesi NetOps Agent berikutnya.${cur?.exists ? ' Versi lama disimpan sebagai backup di server NetOpsUI.' : ''}`, + confirmLabel: 'Terapkan', danger: true, }); if (!ok) return; - try { - await apiPost(`/api/agents/${encodeURIComponent(agent.name)}/restore`, {}); - delete _detailCache[agent.name]; - await loadAgents(); - } catch (e) { - await alertDialog('Gagal restore: ' + e.message, 'Terjadi Kesalahan'); - } - }; - - $('af-save').onclick = async () => { - const errEl = $('af-error'); - const saveBtn = $('af-save'); - const description = ($('af-description').value || '').trim(); - const model = ($('af-model').value || '').trim(); - const body = ($('af-body').value || '').trim(); + try { await mgr(`/profiles/${selected}/apply-soul`, { method: 'POST' }); await alertDialog('SOUL.md NetOps Agent diperbarui.', 'Berhasil'); } + catch (e) { $('g-err').textContent = e.message; } + } - if (!description) { errEl.innerHTML = errorHtml('Description wajib diisi.'); errEl.classList.remove('hidden'); return; } - if (!model) { errEl.innerHTML = errorHtml('Model wajib diisi.'); errEl.classList.remove('hidden'); return; } - if (!body) { errEl.innerHTML = errorHtml('System prompt wajib diisi.'); errEl.classList.remove('hidden'); return; } + async function del() { + const ok = await confirmDialog({ title: 'Hapus profil?', message: `"${selected}" akan dihapus dari NetOpsUI. SOUL.md NetOps Agent yang sudah pernah diterapkan tidak berubah.`, confirmLabel: 'Hapus', danger: true }); + if (!ok) return; + try { + await mgr('/profiles/' + selected, { method: 'DELETE' }); + if (getActiveProfile() === selected) setActiveProfile(null); + selected = null; await load(); + } catch (e) { $('g-err').textContent = e.message; } + } - const payload = { - description, model, body, - tools: toolsWidget.getValues(), - skills: skillsWidget.getValues(), - num_ctx: parseInt($('af-num-ctx').value) || 8192, - num_predict: parseInt($('af-num-predict').value) || 2048, - context_window: parseInt($('af-context-window').value) || 10, - timeout: parseInt($('af-timeout').value) || 300, - max_iters: parseInt($('af-max-iters').value) || 20, - ollama_host: ($('af-ollama-host').value || '').trim(), - reasoning: $('af-reasoning').checked, - enabled: $('af-enabled').checked, - }; + function select(slug) { selected = slug; isNew = false; renderList(); renderEditor(); } + $('ag-new').onclick = () => { isNew = true; selected = null; renderList(); renderEditor(); }; - errEl.classList.add('hidden'); - saveBtn.disabled = true; - saveBtn.innerHTML = 'progress_activity Menyimpan...'; + async function load() { + try { profiles = (await mgr('/profiles')).profiles; renderList(); } + catch (e) { $('ag-list').innerHTML = errorHtml('Gagal memuat profil: ' + e.message); } + } - try { - await apiPut(`/api/agents/${encodeURIComponent(agent.name)}`, payload); - delete _detailCache[agent.name]; - await loadAgents(); - } catch (e) { - errEl.innerHTML = errorHtml(e.message || 'Gagal menyimpan agent.'); - errEl.classList.remove('hidden'); - saveBtn.disabled = false; - saveBtn.innerHTML = 'saveSimpan Perubahan'; - } - }; + await load(); + renderEditor(); } diff --git a/frontend/js/screens/backups.js b/frontend/js/screens/backups.js deleted file mode 100644 index ecd4a36..0000000 --- a/frontend/js/screens/backups.js +++ /dev/null @@ -1 +0,0 @@ -export { screenReports as screenBackups } from './reports.js'; diff --git a/frontend/js/screens/chat.js b/frontend/js/screens/chat.js index 8760a8f..118fbe3 100644 --- a/frontend/js/screens/chat.js +++ b/frontend/js/screens/chat.js @@ -1,7 +1,6 @@ -import { AGENTS, ROLE_TO_ALIAS } from '../config.js'; import { S } from '../state.js'; -import { $, esc, fmtTime, fmtShortDate, fmtFullDateTime, agentCardHtml, loadingHtml, copyToClipboard, renderMarkdown, confirmDialog, alertDialog } from '../utils.js'; -import { apiGet, apiCreateSession, apiStreamChat, apiStopChat, apiApprove, apiDelete, apiPut } from '../api.js'; +import { $, esc, fmtTime, fmtShortDate, fmtFullDateTime, copyToClipboard, renderMarkdown, confirmDialog, alertDialog } from '../utils.js'; +import { activeBackend } from '../backends/index.js'; let _chatEl = null; let _elapsedIv = null; @@ -14,11 +13,11 @@ function fmtDelta(ms) { } // ── Process console persistence — scoped per thread, survives page reload ──── -// Keyed by thread id so each chat session has its own independent log, not one -// shared across every conversation. S.console always points at (by reference, +// Keyed by backend + thread id so each chat session has its own independent +// log, not one shared across every conversation. S.console always points at (by reference, // not copy) _consoleStore[S.threadId] so pushes/clears stay in sync with the // persisted store without an extra write-back step. -const CONSOLE_STORAGE_KEY = 'llmnetops-console-v2'; +const CONSOLE_STORAGE_KEY = 'llmnetops-console-v3'; const CONSOLE_MAX_ENTRIES = 500; const CONSOLE_MAX_THREADS = 30; @@ -29,7 +28,8 @@ let _consoleStore = {}; const raw = localStorage.getItem(CONSOLE_STORAGE_KEY); if (!raw) return; const parsed = JSON.parse(raw); - for (const [tid, entries] of Object.entries(parsed)) { + for (const [key, entries] of Object.entries(parsed)) { + const tid = key.replace(/^palapa:/, 'netops:'); // backend id used before the rename _consoleStore[tid] = entries.map(e => ({ ...e, ts: new Date(e.ts) })); } } catch { /* corrupt or unavailable — start empty */ } @@ -41,44 +41,58 @@ function consoleSave() { } catch { /* storage full/unavailable — degrade to in-memory only */ } } +function consoleKey(threadId) { + return `${activeBackend().id}:${threadId}`; +} + function consoleForThread(threadId) { - if (!_consoleStore[threadId]) { + const key = consoleKey(threadId); + if (!_consoleStore[key]) { const keys = Object.keys(_consoleStore); if (keys.length >= CONSOLE_MAX_THREADS) delete _consoleStore[keys[0]]; // evict oldest tracked thread - _consoleStore[threadId] = []; + _consoleStore[key] = []; + } + return _consoleStore[key]; +} + +function threadFromSummary(t) { + return { id: t.id, title: t.title || 'New Chat', ts: t.updatedAt, createdAt: t.createdAt, lastMessage: t.lastMessage || '' }; +} + +// Creates a thread on the active backend and makes it current. Returns false +// (after telling the operator) when the backend refuses or is unreachable. +async function chatNewThread() { + try { + const t = threadFromSummary(await activeBackend().createThread()); + S.threads.unshift(t); + S.threadId = t.id; + return true; + } catch (e) { + await alertDialog(`Gagal membuat thread di ${activeBackend().label}: ${e.message}`, 'Backend Tidak Terjangkau'); + return false; } - return _consoleStore[threadId]; } export async function screenChat(c, threadIdParam) { - if (S.threads.length === 0) { + const backend = activeBackend(); + let loadError = null; + if (S.threadsBackend !== backend.id) { + // Threads belong to one backend; switching backends starts from its list. + S.threads = []; S.threadId = null; S.messages = []; try { - const r = await apiGet('/api/sessions'); - if (r.sessions && r.sessions.length > 0) { - S.threads = r.sessions.map(s => ({ - id: s.thread_id, - title: s.title || 'New Chat', - ts: new Date(s.updated_at || s.created_at), - createdAt: new Date(s.created_at), - lastMessage: s.last_message || '', - })); - } - } catch { /* offline */ } + S.threads = (await backend.listThreads()).map(threadFromSummary); + S.threadsBackend = backend.id; + } catch (e) { + loadError = e.message; + } } let targetThreadId = threadIdParam || S.threadId; if (!targetThreadId) { if (S.threads.length > 0) { targetThreadId = S.threads[0].id; - } else { - try { - const r = await apiCreateSession(); - targetThreadId = r.thread_id; - S.threads.unshift({ id: targetThreadId, title: 'New Chat', ts: new Date(), createdAt: new Date(), lastMessage: '' }); - } catch { - targetThreadId = crypto.randomUUID(); - S.threads.unshift({ id: targetThreadId, title: 'Offline', ts: new Date(), createdAt: new Date(), lastMessage: '' }); - } + } else if (!loadError && await chatNewThread()) { + targetThreadId = S.threadId; } } else if (!S.threads.some(t => t.id === targetThreadId)) { // Deep link to a thread not yet in our local list (e.g. shared link opened fresh) — placeholder entry @@ -86,8 +100,8 @@ export async function screenChat(c, threadIdParam) { } const threadChanged = targetThreadId !== S.threadId; - S.threadId = targetThreadId; - S.console = consoleForThread(S.threadId); + S.threadId = targetThreadId || null; + S.console = S.threadId ? consoleForThread(S.threadId) : []; chatSyncUrl(); c.innerHTML = ` @@ -101,6 +115,7 @@ export async function screenChat(c, threadIdParam) {
+ ${loadError ? `
Gagal memuat thread dari ${esc(backend.label)}: ${esc(loadError)}
` : ''}
@@ -118,9 +133,15 @@ export async function screenChat(c, threadIdParam) {