@solongate/proxy 0.81.26 → 0.81.27

package/dist/index.js

@@ -8916,6 +8916,7 @@ function AuditPanel({ active: active2, focused }) {
   const [sessSel, setSessSel] = useState6(0);
   const [confirm, setConfirm] = useState6(null);
   const [msg, setMsg] = useState6(null);
+  const [showHelp, setShowHelp] = useState6(false);
   const toTop = () => setSel(0);
   const statsQ = useLoader(() => source === "cloud" ? api.stats.get() : Promise.resolve(null), [source]);
   const tsQ = useLoader(() => source === "cloud" ? api.stats.timeseries({ period: "24h" }) : Promise.resolve(null), [source]);
@@ -9028,6 +9029,14 @@ function AuditPanel({ active: active2, focused }) {
   };
   useInput5(
     (input, key) => {
+      if (showHelp) {
+        setShowHelp(false);
+        return;
+      }
+      if (input === "?") {
+        setShowHelp(true);
+        return;
+      }
       if (view === "detail") {
         if (key.leftArrow || key.escape) setView("logs");
         else if (key.upArrow) setDetailScroll((n) => Math.max(0, n - 1));
@@ -9175,6 +9184,19 @@ function AuditPanel({ active: active2, focused }) {
     /* @__PURE__ */ jsx6(Text6, { color: source === "local" ? theme.ok : "#4f6db8", bold: true, children: source }),
     /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: " (s) " })
   ] });
+  if (showHelp) {
+    return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Text6, { bold: true, color: theme.accentBright, children: "AUDIT \u2014 all keys" }),
+      AUDIT_HELP.map(([group, keys]) => /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx6(Text6, { bold: true, color: theme.accent, children: group }),
+        keys.map(([k, desc]) => /* @__PURE__ */ jsxs6(Text6, { wrap: "truncate", children: [
+          /* @__PURE__ */ jsx6(Text6, { color: theme.accentBright, children: ("  " + k).padEnd(20) }),
+          /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: desc })
+        ] }, k))
+      ] }, group)),
+      /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: "press any key to close" }) })
+    ] });
+  }
   if (view === "detail" && current) {
     const sessionCalls = source === "cloud" ? (sessionQ.data?.entries ?? []).map(cloudRow) : localAll.filter((r) => r.session && r.session === current.session).slice(0, 40);
     const bodyW = Math.max(20, cols - 2);
@@ -9254,7 +9276,7 @@ function AuditPanel({ active: active2, focused }) {
         chip("status", SESS_STATUS[si] ?? "all", si !== 0),
         chip("search", sessSearch || "\xB7", !!sessSearch)
       ] }),
-      /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter \u2192 session logs \xB7 f status \xB7 / search \xB7 s source \xB7 v logs \xB7 c clear" : "press \u2192 to browse" }),
+      /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter \u2192 session logs \xB7 v logs \xB7 ? all keys" : "press \u2192 to browse" }),
       editing === "sess-search" ? /* @__PURE__ */ jsxs6(Box6, { children: [
         /* @__PURE__ */ jsx6(Text6, { color: theme.warn, children: "search: " }),
         /* @__PURE__ */ jsx6(
@@ -9328,7 +9350,7 @@ function AuditPanel({ active: active2, focused }) {
       chip("search", search || "\xB7", !!search),
       sessFilter ? chip("sess", sessFilter.slice(0, 8), true) : null
     ] }),
-    /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter full entry \xB7 \u2190\u2192 page \xB7 f dec \xB7 g sig \xB7 t tool \xB7 n agent \xB7 / search \xB7 x del \xB7 X del ALL \xB7 s source \xB7 v sessions \xB7 c clear" : "press \u2192 to browse" }),
+    /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter full entry \xB7 \u2190\u2192 page \xB7 v sessions \xB7 ? all keys" : "press \u2192 to browse" }),
     msg ? /* @__PURE__ */ jsx6(Text6, { color: msg.level === "bad" ? theme.bad : theme.ok, children: truncate2(msg.text, cols) }) : null,
     editing && editing !== "sess-search" ? /* @__PURE__ */ jsxs6(Box6, { children: [
       /* @__PURE__ */ jsxs6(Text6, { color: theme.warn, children: [
@@ -9388,7 +9410,7 @@ function Detail({ label, value, color }) {
     /* @__PURE__ */ jsx6(Text6, { color, wrap: "truncate", children: value })
   ] });
 }
-var DECISIONS, SIGNALS, SESS_STATUS, PAGE, LOCAL_MAX_BYTES, cloudRow, sessStatus2, STATUS_DOT;
+var DECISIONS, SIGNALS, SESS_STATUS, PAGE, LOCAL_MAX_BYTES, cloudRow, AUDIT_HELP, sessStatus2, STATUS_DOT;
 var init_Audit = __esm({
   "src/tui/panels/Audit.tsx"() {
     "use strict";
@@ -9418,6 +9440,43 @@ var init_Audit = __esm({
       burst: !!e.rate_limit_burst,
       args: e.arguments_summary ? JSON.stringify(e.arguments_summary) : null
     });
+    AUDIT_HELP = [
+      [
+        "Logs",
+        [
+          ["\u2191\u2193 / PgUp PgDn", "select a row (window follows)"],
+          ["enter", "open the FULL entry (reason + arguments)"],
+          ["\u2190 \u2192", "previous / next page (500 per page, jumps to top)"],
+          ["f", "decision filter: all \u2192 DENY \u2192 ALLOW"],
+          ["g", "signal filter: all \u2192 dlp \u2192 ratelimit"],
+          ["t / n", "tool / agent filter (type, enter done)"],
+          ["/", "free-text search"],
+          ["x", "delete the selected entry (press x twice)"],
+          ["X", "delete ALL logs of the current source (press X twice)"],
+          ["c", "clear every filter (incl. session)"]
+        ]
+      ],
+      [
+        "Sessions",
+        [
+          ["\u2191\u2193", "select a session"],
+          ["enter", "open that session's logs"],
+          ["f", "status filter: all \u2192 active \u2192 idle \u2192 ended"],
+          ["/", "search agent / session id"],
+          ["c", "clear session filters"]
+        ]
+      ],
+      [
+        "Anywhere in Audit",
+        [
+          ["v", "switch logs \u2194 sessions"],
+          ["s", "switch source cloud \u2194 local file"],
+          ["?", "this help \xB7 any key closes"],
+          ["esc", "back to the menu"]
+        ]
+      ],
+      ["Entry detail", [["\u2191\u2193 / PgUp PgDn", "scroll the arguments"], ["\u2190 / esc", "back to the list"]]]
+    ];
     sessStatus2 = (lastAt) => Date.now() - lastAt < 6e4 ? "active" : Date.now() - lastAt < 3e5 ? "idle" : "ended";
     STATUS_DOT = {
       active: { ch: "\u25CF", color: theme.ok },

package/dist/tui/index.js

@@ -2255,6 +2255,43 @@ function loadLocalRows() {
     args: j.arguments ? JSON.stringify(j.arguments) : null
   })).sort((a, b) => b.at - a.at);
 }
+var AUDIT_HELP = [
+  [
+    "Logs",
+    [
+      ["\u2191\u2193 / PgUp PgDn", "select a row (window follows)"],
+      ["enter", "open the FULL entry (reason + arguments)"],
+      ["\u2190 \u2192", "previous / next page (500 per page, jumps to top)"],
+      ["f", "decision filter: all \u2192 DENY \u2192 ALLOW"],
+      ["g", "signal filter: all \u2192 dlp \u2192 ratelimit"],
+      ["t / n", "tool / agent filter (type, enter done)"],
+      ["/", "free-text search"],
+      ["x", "delete the selected entry (press x twice)"],
+      ["X", "delete ALL logs of the current source (press X twice)"],
+      ["c", "clear every filter (incl. session)"]
+    ]
+  ],
+  [
+    "Sessions",
+    [
+      ["\u2191\u2193", "select a session"],
+      ["enter", "open that session's logs"],
+      ["f", "status filter: all \u2192 active \u2192 idle \u2192 ended"],
+      ["/", "search agent / session id"],
+      ["c", "clear session filters"]
+    ]
+  ],
+  [
+    "Anywhere in Audit",
+    [
+      ["v", "switch logs \u2194 sessions"],
+      ["s", "switch source cloud \u2194 local file"],
+      ["?", "this help \xB7 any key closes"],
+      ["esc", "back to the menu"]
+    ]
+  ],
+  ["Entry detail", [["\u2191\u2193 / PgUp PgDn", "scroll the arguments"], ["\u2190 / esc", "back to the list"]]]
+];
 var sessStatus2 = (lastAt) => Date.now() - lastAt < 6e4 ? "active" : Date.now() - lastAt < 3e5 ? "idle" : "ended";
 var STATUS_DOT = {
   active: { ch: "\u25CF", color: theme.ok },
@@ -2280,6 +2317,7 @@ function AuditPanel({ active: active2, focused }) {
   const [sessSel, setSessSel] = useState6(0);
   const [confirm, setConfirm] = useState6(null);
   const [msg, setMsg] = useState6(null);
+  const [showHelp, setShowHelp] = useState6(false);
   const toTop = () => setSel(0);
   const statsQ = useLoader(() => source === "cloud" ? api.stats.get() : Promise.resolve(null), [source]);
   const tsQ = useLoader(() => source === "cloud" ? api.stats.timeseries({ period: "24h" }) : Promise.resolve(null), [source]);
@@ -2392,6 +2430,14 @@ function AuditPanel({ active: active2, focused }) {
   };
   useInput5(
     (input, key) => {
+      if (showHelp) {
+        setShowHelp(false);
+        return;
+      }
+      if (input === "?") {
+        setShowHelp(true);
+        return;
+      }
       if (view === "detail") {
         if (key.leftArrow || key.escape) setView("logs");
         else if (key.upArrow) setDetailScroll((n) => Math.max(0, n - 1));
@@ -2539,6 +2585,19 @@ function AuditPanel({ active: active2, focused }) {
     /* @__PURE__ */ jsx6(Text6, { color: source === "local" ? theme.ok : "#4f6db8", bold: true, children: source }),
     /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: " (s) " })
   ] });
+  if (showHelp) {
+    return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx6(Text6, { bold: true, color: theme.accentBright, children: "AUDIT \u2014 all keys" }),
+      AUDIT_HELP.map(([group, keys]) => /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx6(Text6, { bold: true, color: theme.accent, children: group }),
+        keys.map(([k, desc]) => /* @__PURE__ */ jsxs6(Text6, { wrap: "truncate", children: [
+          /* @__PURE__ */ jsx6(Text6, { color: theme.accentBright, children: ("  " + k).padEnd(20) }),
+          /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: desc })
+        ] }, k))
+      ] }, group)),
+      /* @__PURE__ */ jsx6(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx6(Text6, { color: theme.dim, children: "press any key to close" }) })
+    ] });
+  }
   if (view === "detail" && current) {
     const sessionCalls = source === "cloud" ? (sessionQ.data?.entries ?? []).map(cloudRow) : localAll.filter((r) => r.session && r.session === current.session).slice(0, 40);
     const bodyW = Math.max(20, cols - 2);
@@ -2618,7 +2677,7 @@ function AuditPanel({ active: active2, focused }) {
         chip("status", SESS_STATUS[si] ?? "all", si !== 0),
         chip("search", sessSearch || "\xB7", !!sessSearch)
       ] }),
-      /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter \u2192 session logs \xB7 f status \xB7 / search \xB7 s source \xB7 v logs \xB7 c clear" : "press \u2192 to browse" }),
+      /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter \u2192 session logs \xB7 v logs \xB7 ? all keys" : "press \u2192 to browse" }),
       editing === "sess-search" ? /* @__PURE__ */ jsxs6(Box6, { children: [
         /* @__PURE__ */ jsx6(Text6, { color: theme.warn, children: "search: " }),
         /* @__PURE__ */ jsx6(
@@ -2692,7 +2751,7 @@ function AuditPanel({ active: active2, focused }) {
       chip("search", search || "\xB7", !!search),
       sessFilter ? chip("sess", sessFilter.slice(0, 8), true) : null
     ] }),
-    /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter full entry \xB7 \u2190\u2192 page \xB7 f dec \xB7 g sig \xB7 t tool \xB7 n agent \xB7 / search \xB7 x del \xB7 X del ALL \xB7 s source \xB7 v sessions \xB7 c clear" : "press \u2192 to browse" }),
+    /* @__PURE__ */ jsx6(Text6, { color: theme.dim, wrap: "truncate", children: focused ? "\u2191\u2193 select \xB7 enter full entry \xB7 \u2190\u2192 page \xB7 v sessions \xB7 ? all keys" : "press \u2192 to browse" }),
     msg ? /* @__PURE__ */ jsx6(Text6, { color: msg.level === "bad" ? theme.bad : theme.ok, children: truncate(msg.text, cols) }) : null,
     editing && editing !== "sess-search" ? /* @__PURE__ */ jsxs6(Box6, { children: [
       /* @__PURE__ */ jsxs6(Text6, { color: theme.warn, children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solongate/proxy",
-  "version": "0.81.26",
+  "version": "0.81.27",
   "description": "AI tool security proxy: protect any AI tool server with customizable policies, path/command constraints, rate limiting, and audit logging. No code changes required.",
   "type": "module",
   "bin": {