@solongate/proxy 0.81.20 → 0.81.22

package/dist/index.js

@@ -7356,7 +7356,6 @@ function LivePanel({ active: active2 }) {
   const [actionMsg, setActionMsg] = useState2(null);
   const notifiedRef = useRef2(/* @__PURE__ */ new Set());
   const openedAtRef = useRef2(Date.now());
-  const activePolicyRef = useRef2(null);
   const [mode, setMode] = useState2("stream");
   const [pickIdx, setPickIdx] = useState2(0);
   const [detail, setDetail] = useState2(null);
@@ -7375,6 +7374,7 @@ function LivePanel({ active: active2 }) {
   const [frozen, setFrozen] = useState2(false);
   const frozenRef = useRef2(false);
   frozenRef.current = frozen;
+  const [showHelp, setShowHelp] = useState2(false);
   const pushLog = useCallback2((msg, level = "ok") => {
     setLog((prev) => [...prev.slice(-59), { ts: Date.now(), msg, level }]);
   }, []);
@@ -7679,18 +7679,14 @@ function LivePanel({ active: active2 }) {
     }
     setActionMsg({ text: act === "whitelist" ? "whitelisting\u2026" : "blocking\u2026", level: "ok", until: Date.now() + 4e3 });
     try {
+      const a = await api.policies.active();
+      const pid = a.policy?.id ?? null;
+      if (!pid) throw new Error("no active policy \u2014 rule NOT added. Activate a policy first (Policies section).");
       let res;
       if (e.source === "cloud") {
         const realId = e.id.slice(2);
         res = act === "whitelist" ? await api.audit.whitelist(realId) : await api.audit.block(realId);
       } else {
-        let pid = activePolicyRef.current;
-        if (!pid) {
-          const a = await api.policies.active();
-          pid = a.policy?.id ?? null;
-          activePolicyRef.current = pid;
-        }
-        if (!pid) throw new Error("no active policy resolves for this machine");
         const t = extractTarget(e.detail);
         res = await api.policies.addRule(pid, { toolPattern: e.tool, kind: t?.kind ?? "tool", value: t?.value, effect: act === "whitelist" ? "ALLOW" : "DENY" });
       }
@@ -7712,6 +7708,14 @@ function LivePanel({ active: active2 }) {
         return;
       }
       if (frozen) return;
+      if (showHelp) {
+        setShowHelp(false);
+        return;
+      }
+      if (input === "?") {
+        setShowHelp(true);
+        return;
+      }
       if (input === "/" && mode !== "pick") {
         setEditingSearch(true);
         return;
@@ -7834,6 +7838,20 @@ function LivePanel({ active: active2 }) {
     /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: ` ${spin} up ${fmtUp(nowMs - startRef.current)} \xB7 ${hhmmss(nowMs)} \xB7 api ${latNow}ms ` }),
     frozen ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#123d1f", color: "#7bd88f", bold: true, children: " \u23F5 COPY MODE \u2014 screen frozen, select & copy freely \xB7 space resume " }) : backingOff ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#3d2a12", color: "#ffb454", bold: true, children: " RATE LIMITED \xB7 backing off " }) : lastDeny ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#3d1220", color: "#ff6b6b", bold: true, children: ` \u26A0 ${hhmmss(lastDeny.at)} ${lastDeny.tool} DENIED ` }) : /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#4f6db8", children: " \u2713 clean " })
   ] });
+  if (showHelp) {
+    return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", paddingX: 1, children: [
+      titleBar,
+      /* @__PURE__ */ jsx2(Text2, { bold: true, color: theme.accentBright, children: "LIVE \u2014 all keys" }),
+      /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", marginTop: 1, children: LIVE_HELP.map(([group, keys]) => /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ jsx2(Text2, { bold: true, color: theme.accent, children: group }),
+        keys.map(([k, desc]) => /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
+          /* @__PURE__ */ jsx2(Text2, { color: theme.accentBright, children: ("  " + k).padEnd(20) }),
+          /* @__PURE__ */ jsx2(Text2, { color: theme.dim, children: desc })
+        ] }, k))
+      ] }, group)) }),
+      /* @__PURE__ */ jsx2(Text2, { color: theme.dim, children: "press any key to close" })
+    ] });
+  }
   if (mode === "inspect" && inspect) {
     const e = inspect;
     const bodyW = Math.max(20, cols - 4);
@@ -7876,7 +7894,7 @@ function LivePanel({ active: active2 }) {
       /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " ENTRY " }),
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` ${e.id} ` }),
-        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 scroll \xB7 space copy mode \xB7 \u2190 back \xB7 esc menu " })
+        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 scroll \xB7 space copy \xB7 ? all keys \xB7 \u2190 back \xB7 esc menu " })
       ] })
     ] });
   }
@@ -7949,7 +7967,7 @@ function LivePanel({ active: active2 }) {
       /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " SESSION " }),
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` ${detail.id} ` }),
-        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full entry \xB7 \u2190 back \xB7 esc menu " })
+        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full entry \xB7 ? all keys \xB7 \u2190 back \xB7 esc menu " })
       ] })
     ] });
   }
@@ -8062,7 +8080,7 @@ function LivePanel({ active: active2 }) {
       PaneTitle,
       {
         label: "TOOL STREAM",
-        extra: `${selClamped + 1}/${visibleDesc.length}${signal !== "none" ? ` \xB7 ${signal}` : ""}${q ? " \xB7 search" : ""} \xB7 \u2191\u2193 select \xB7 enter full \xB7 w allow \xB7 b block \xB7 d/x/r ${filter} \xB7 s`,
+        extra: `${selClamped + 1}/${visibleDesc.length}${signal !== "none" ? ` \xB7 ${signal}` : ""}${q ? " \xB7 search" : ""}${filter !== "all" ? ` \xB7 source:${filter}` : ""} \xB7 enter full entry \xB7 ? all keys`,
         width: innerW
       }
     ),
@@ -8081,11 +8099,11 @@ function LivePanel({ active: active2 }) {
     /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
       /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " LIVE " }),
       /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` local ${localOn ? "on" : "off"} \xB7 ${localBuf.length} loc/${cloudBuf.length} cld \xB7 top ${topTools.map(([t, c2]) => `${t}\xD7${c2}`).join(" ") || "\u2014"} ` }),
-      /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full \xB7 w allow \xB7 b block \xB7 d/x/r \xB7 / search \xB7 f \xB7 s \xB7 space copy \xB7 esc \xB7 q " })
+      /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: ` \u2191\u2193 select \xB7 enter full entry \xB7 / search \xB7 space copy \xB7 ? all keys \xB7 esc menu \xB7 q quit ` })
     ] })
   ] });
 }
-var CONFIG, SPIN, BG, DIM_FLOOR, LOCAL_LOG, RING, hhmmss, fmtUp, FILTERS, sessStatus, STATUS_STYLE;
+var CONFIG, SPIN, BG, DIM_FLOOR, LOCAL_LOG, RING, hhmmss, fmtUp, FILTERS, sessStatus, STATUS_STYLE, LIVE_HELP;
 var init_Live = __esm({
   "src/tui/panels/Live.tsx"() {
     "use strict";
@@ -8116,6 +8134,45 @@ var init_Live = __esm({
       idle: { dot: "\u25D0", label: "IDLE", color: theme.warn },
       ended: { dot: "\u25CB", label: "ENDED", color: theme.dim }
     };
+    LIVE_HELP = [
+      [
+        "Stream",
+        [
+          ["\u2191\u2193 / PgUp PgDn", "select a row (window follows)"],
+          ["enter", "open the FULL entry content"],
+          ["w", "whitelist the selected DENY (adds ALLOW rule)"],
+          ["b", "block the selected ALLOW (adds DENY rule)"],
+          ["d / x / r", "filter: denies / dlp hits / rate-limit bursts"],
+          ["f", "source filter: all \u2192 local \u2192 cloud"],
+          ["/", "live search (tool, agent, command\u2026) \xB7 enter done"],
+          ["s", "session picker"],
+          ["e", "export visible rows \u2192 ~/.solongate/live-export.jsonl"],
+          ["space", "copy mode: freeze screen for mouse selection"],
+          ["esc", "back to menu"],
+          ["q", "quit dataroom"]
+        ]
+      ],
+      [
+        "Entry (full content)",
+        [
+          ["\u2191\u2193 / PgUp PgDn", "scroll the content"],
+          ["space", "copy mode (freeze, then select with mouse)"],
+          ["\u2190", "back to where you came from"]
+        ]
+      ],
+      [
+        "Sessions",
+        [
+          ["\u2191\u2193 + enter", "pick & open a session (picker)"],
+          ["s or \u2190", "cancel the picker"],
+          ["\u2191\u2193", "select a timeline row (detail)"],
+          ["enter", "full entry content of the selected row"],
+          ["/", "search within the timeline"],
+          ["\u2190", "back to stream"]
+        ]
+      ],
+      ["Anywhere", [["?", "this help"], ["any key", "close this help"]]]
+    ];
   }
 });
 

package/dist/tui/index.js

@@ -745,6 +745,45 @@ var STATUS_STYLE = {
   idle: { dot: "\u25D0", label: "IDLE", color: theme.warn },
   ended: { dot: "\u25CB", label: "ENDED", color: theme.dim }
 };
+var LIVE_HELP = [
+  [
+    "Stream",
+    [
+      ["\u2191\u2193 / PgUp PgDn", "select a row (window follows)"],
+      ["enter", "open the FULL entry content"],
+      ["w", "whitelist the selected DENY (adds ALLOW rule)"],
+      ["b", "block the selected ALLOW (adds DENY rule)"],
+      ["d / x / r", "filter: denies / dlp hits / rate-limit bursts"],
+      ["f", "source filter: all \u2192 local \u2192 cloud"],
+      ["/", "live search (tool, agent, command\u2026) \xB7 enter done"],
+      ["s", "session picker"],
+      ["e", "export visible rows \u2192 ~/.solongate/live-export.jsonl"],
+      ["space", "copy mode: freeze screen for mouse selection"],
+      ["esc", "back to menu"],
+      ["q", "quit dataroom"]
+    ]
+  ],
+  [
+    "Entry (full content)",
+    [
+      ["\u2191\u2193 / PgUp PgDn", "scroll the content"],
+      ["space", "copy mode (freeze, then select with mouse)"],
+      ["\u2190", "back to where you came from"]
+    ]
+  ],
+  [
+    "Sessions",
+    [
+      ["\u2191\u2193 + enter", "pick & open a session (picker)"],
+      ["s or \u2190", "cancel the picker"],
+      ["\u2191\u2193", "select a timeline row (detail)"],
+      ["enter", "full entry content of the selected row"],
+      ["/", "search within the timeline"],
+      ["\u2190", "back to stream"]
+    ]
+  ],
+  ["Anywhere", [["?", "this help"], ["any key", "close this help"]]]
+];
 function LivePanel({ active: active2 }) {
   const [s, setS] = useState2(null);
   const [lat, setLat] = useState2([]);
@@ -761,7 +800,6 @@ function LivePanel({ active: active2 }) {
   const [actionMsg, setActionMsg] = useState2(null);
   const notifiedRef = useRef2(/* @__PURE__ */ new Set());
   const openedAtRef = useRef2(Date.now());
-  const activePolicyRef = useRef2(null);
   const [mode, setMode] = useState2("stream");
   const [pickIdx, setPickIdx] = useState2(0);
   const [detail, setDetail] = useState2(null);
@@ -780,6 +818,7 @@ function LivePanel({ active: active2 }) {
   const [frozen, setFrozen] = useState2(false);
   const frozenRef = useRef2(false);
   frozenRef.current = frozen;
+  const [showHelp, setShowHelp] = useState2(false);
   const pushLog = useCallback2((msg, level = "ok") => {
     setLog((prev) => [...prev.slice(-59), { ts: Date.now(), msg, level }]);
   }, []);
@@ -1084,18 +1123,14 @@ function LivePanel({ active: active2 }) {
     }
     setActionMsg({ text: act === "whitelist" ? "whitelisting\u2026" : "blocking\u2026", level: "ok", until: Date.now() + 4e3 });
     try {
+      const a = await api.policies.active();
+      const pid = a.policy?.id ?? null;
+      if (!pid) throw new Error("no active policy \u2014 rule NOT added. Activate a policy first (Policies section).");
       let res;
       if (e.source === "cloud") {
         const realId = e.id.slice(2);
         res = act === "whitelist" ? await api.audit.whitelist(realId) : await api.audit.block(realId);
       } else {
-        let pid = activePolicyRef.current;
-        if (!pid) {
-          const a = await api.policies.active();
-          pid = a.policy?.id ?? null;
-          activePolicyRef.current = pid;
-        }
-        if (!pid) throw new Error("no active policy resolves for this machine");
         const t = extractTarget(e.detail);
         res = await api.policies.addRule(pid, { toolPattern: e.tool, kind: t?.kind ?? "tool", value: t?.value, effect: act === "whitelist" ? "ALLOW" : "DENY" });
       }
@@ -1117,6 +1152,14 @@ function LivePanel({ active: active2 }) {
         return;
       }
       if (frozen) return;
+      if (showHelp) {
+        setShowHelp(false);
+        return;
+      }
+      if (input === "?") {
+        setShowHelp(true);
+        return;
+      }
       if (input === "/" && mode !== "pick") {
         setEditingSearch(true);
         return;
@@ -1239,6 +1282,20 @@ function LivePanel({ active: active2 }) {
     /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: ` ${spin} up ${fmtUp(nowMs - startRef.current)} \xB7 ${hhmmss(nowMs)} \xB7 api ${latNow}ms ` }),
     frozen ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#123d1f", color: "#7bd88f", bold: true, children: " \u23F5 COPY MODE \u2014 screen frozen, select & copy freely \xB7 space resume " }) : backingOff ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#3d2a12", color: "#ffb454", bold: true, children: " RATE LIMITED \xB7 backing off " }) : lastDeny ? /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#3d1220", color: "#ff6b6b", bold: true, children: ` \u26A0 ${hhmmss(lastDeny.at)} ${lastDeny.tool} DENIED ` }) : /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#4f6db8", children: " \u2713 clean " })
   ] });
+  if (showHelp) {
+    return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", paddingX: 1, children: [
+      titleBar,
+      /* @__PURE__ */ jsx2(Text2, { bold: true, color: theme.accentBright, children: "LIVE \u2014 all keys" }),
+      /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", marginTop: 1, children: LIVE_HELP.map(([group, keys]) => /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ jsx2(Text2, { bold: true, color: theme.accent, children: group }),
+        keys.map(([k, desc]) => /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
+          /* @__PURE__ */ jsx2(Text2, { color: theme.accentBright, children: ("  " + k).padEnd(20) }),
+          /* @__PURE__ */ jsx2(Text2, { color: theme.dim, children: desc })
+        ] }, k))
+      ] }, group)) }),
+      /* @__PURE__ */ jsx2(Text2, { color: theme.dim, children: "press any key to close" })
+    ] });
+  }
   if (mode === "inspect" && inspect) {
     const e = inspect;
     const bodyW = Math.max(20, cols - 4);
@@ -1281,7 +1338,7 @@ function LivePanel({ active: active2 }) {
       /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " ENTRY " }),
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` ${e.id} ` }),
-        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 scroll \xB7 space copy mode \xB7 \u2190 back \xB7 esc menu " })
+        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 scroll \xB7 space copy \xB7 ? all keys \xB7 \u2190 back \xB7 esc menu " })
       ] })
     ] });
   }
@@ -1354,7 +1411,7 @@ function LivePanel({ active: active2 }) {
       /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " SESSION " }),
         /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` ${detail.id} ` }),
-        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full entry \xB7 \u2190 back \xB7 esc menu " })
+        /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full entry \xB7 ? all keys \xB7 \u2190 back \xB7 esc menu " })
       ] })
     ] });
   }
@@ -1467,7 +1524,7 @@ function LivePanel({ active: active2 }) {
       PaneTitle,
       {
         label: "TOOL STREAM",
-        extra: `${selClamped + 1}/${visibleDesc.length}${signal !== "none" ? ` \xB7 ${signal}` : ""}${q ? " \xB7 search" : ""} \xB7 \u2191\u2193 select \xB7 enter full \xB7 w allow \xB7 b block \xB7 d/x/r ${filter} \xB7 s`,
+        extra: `${selClamped + 1}/${visibleDesc.length}${signal !== "none" ? ` \xB7 ${signal}` : ""}${q ? " \xB7 search" : ""}${filter !== "all" ? ` \xB7 source:${filter}` : ""} \xB7 enter full entry \xB7 ? all keys`,
         width: innerW
       }
     ),
@@ -1486,7 +1543,7 @@ function LivePanel({ active: active2 }) {
     /* @__PURE__ */ jsxs2(Text2, { wrap: "truncate", children: [
       /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", bold: true, children: " LIVE " }),
       /* @__PURE__ */ jsx2(Text2, { backgroundColor: "#0b1530", color: "#4f6db8", children: ` local ${localOn ? "on" : "off"} \xB7 ${localBuf.length} loc/${cloudBuf.length} cld \xB7 top ${topTools.map(([t, c2]) => `${t}\xD7${c2}`).join(" ") || "\u2014"} ` }),
-      /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: " \u2191\u2193 select \xB7 enter full \xB7 w allow \xB7 b block \xB7 d/x/r \xB7 / search \xB7 f \xB7 s \xB7 space copy \xB7 esc \xB7 q " })
+      /* @__PURE__ */ jsx2(Text2, { backgroundColor: BG, color: "#82AAF0", children: ` \u2191\u2193 select \xB7 enter full entry \xB7 / search \xB7 space copy \xB7 ? all keys \xB7 esc menu \xB7 q quit ` })
     ] })
   ] });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solongate/proxy",
-  "version": "0.81.20",
+  "version": "0.81.22",
   "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": {