paseo-smart-session 3.1.0 → 3.2.0

package/client/popover.tsx

@@ -1,18 +1,23 @@
 import { useState, useSyncExternalStore } from "react";
 import { Text, View } from "react-native";
+import { Icon } from "@getpaseo/plugin/client/ui";
 import { useRpc, type PluginButtonContentProps, type PluginClientContext } from "@getpaseo/plugin/client";
 import { useQuery } from "@tanstack/react-query";
 
-import { formatCompactTokens, formatDuration, formatRelative } from "../shared/format";
+import { formatClock, formatCompactTokens, formatDuration, formatRelative } from "../shared/format";
 import { contextOutlook } from "../shared/forecast";
 import { listCompactions, setEnrolment, type CompactionRequest } from "../shared/governor";
+import { cancelResumeRpc, dismissPauseRpc, resumeNowRpc, setProtectionRpc, statusRpc } from "../shared/guard/contracts";
+import { PAUSE_ACTIONS, governorNotice, pausePresentation } from "../shared/guard/presentation";
 import { contextStatus } from "../shared/smart-session";
 import { profileFor } from "../shared/thresholds";
 import type { AgentDirectory } from "./agents";
 import { Meter, Ring, toneFill } from "./charts";
-import { Switch, TextLink, errorText, text, useNow } from "./kit";
+import { governedPause, guardSnapshot, publishGuard, resumeMoment, sessionProtection, subscribeGuard } from "./guard/status";
+import { Button, Switch, TextLink, errorText, text, useNow } from "./kit";
 import { noteEnrolment, pillSnapshot, subscribePills } from "./pill-store";
 import { tabular, toneColor } from "./theme";
+import { SETTINGS_SCREEN } from "./screens";
 
 /** What the last compaction did, in one line. */
 function compactionLine(item: CompactionRequest | undefined, now: number): string {
@@ -24,19 +29,25 @@ function compactionLine(item: CompactionRequest | undefined, now: number): strin
   return item.preTokens !== null && item.postTokens !== null ? `${when} · ${formatCompactTokens(item.preTokens)} → ${formatCompactTokens(item.postTokens)}` : when;
 }
 
-/** The pill's popover: this session's context, its compact line, task state and enrolment. */
+/** The pill's popover: a pause when there is one, this session's context and both of its switches. */
 export function makeContextPopover(client: PluginClientContext, agents: AgentDirectory) {
   return function ContextPopover({ theme, layout, close, ...rest }: PluginButtonContentProps) {
     const agentId = rest.context === "agent" ? rest.agentId : "";
     const c = theme.colors;
     const t = text(c);
-    const now = useNow(30_000);
+    const now = useNow(15_000);
     const pills = useSyncExternalStore(subscribePills, pillSnapshot, pillSnapshot);
+    const guard = useSyncExternalStore(subscribeGuard, guardSnapshot, guardSnapshot);
     useSyncExternalStore(agents.subscribe, agents.version, agents.version);
     const readContext = useRpc(contextStatus);
     const readCompactions = useRpc(listCompactions);
     const writeEnrolment = useRpc(setEnrolment);
-    const [saving, setSaving] = useState(false);
+    const readGuard = useRpc(statusRpc);
+    const writeProtection = useRpc(setProtectionRpc);
+    const cancelResume = useRpc(cancelResumeRpc);
+    const resumeNow = useRpc(resumeNowRpc);
+    const dismissPause = useRpc(dismissPauseRpc);
+    const [saving, setSaving] = useState<"compact" | "protect" | "release" | "resume" | "dismiss" | null>(null);
     const [problem, setProblem] = useState<string | null>(null);
     const detail = useQuery({ queryKey: ["smart-session", "context", agentId], queryFn: () => readContext({ agentId }), refetchInterval: 30_000 });
     const compactions = useQuery({ queryKey: ["smart-session", "compactions", agentId], queryFn: () => readCompactions({ agentId }), refetchInterval: 30_000 });
@@ -45,20 +56,43 @@ export function makeContextPopover(client: PluginClientContext, agents: AgentDir
     const row = detail.data?.agents[0];
     const used = agent?.usedTokens ?? row?.usedTokens ?? null;
     const max = agent?.maxTokens ?? row?.maxTokens ?? null;
-    const enrolled = pills.enrolled.has(agentId);
+    const compactOn = pills.compactOn;
+    const enrolled = compactOn && pills.enrolled.has(agentId);
     const compact = layout.compact;
+    const pause = governedPause(guard, agentId);
+    const protection = sessionProtection(guard, agentId);
 
-    async function toggle(next: boolean) {
-      setSaving(true); setProblem(null);
+    async function run(kind: "compact" | "protect" | "release" | "resume" | "dismiss", work: () => Promise<void>) {
+      setSaving(kind); setProblem(null);
       try {
-        const { agent: saved } = await writeEnrolment({ agentId, enrolled: next });
-        noteEnrolment(saved.agentId, saved.enrolled);
+        await work();
       } catch (error) {
         setProblem(errorText(error));
       } finally {
-        setSaving(false);
+        setSaving(null);
       }
     }
+    const toggleCompact = (next: boolean) => run("compact", async () => {
+      const { agent: saved } = await writeEnrolment({ agentId, enrolled: next });
+      noteEnrolment(saved.agentId, saved.enrolled);
+    });
+    // Back to the default is the same as no override, so the switch never leaves a redundant one.
+    const setProtected = (next: boolean | null) => run("protect", async () => {
+      const enabled = protection.kind === "on" && next === protection.byDefault ? null : next;
+      await writeProtection({ agentId, enabled });
+      publishGuard(await readGuard({}));
+    });
+    // A stuck pause can only be released; a waiting one gets the same two actions as its chat card.
+    const release = () => run("release", async () => {
+      await cancelResume({ agentId });
+      publishGuard(await readGuard({}));
+    });
+    const settle = (kind: "resume" | "dismiss", pauseId: string) => run(kind, async () => {
+      await (kind === "resume" ? resumeNow : dismissPause)({ agentId, pauseId });
+      publishGuard(await readGuard({}));
+    });
+    const openOverview = (focus?: string) => { close(); client.openScreen({ screenId: "overview", params: focus ? { focus } : undefined }); };
+    const openSettings = () => { close(); client.openSettings(SETTINGS_SCREEN); };
 
     const head = (() => {
       if (used === null || max === null) return null;
@@ -68,7 +102,7 @@ export function makeContextPopover(client: PluginClientContext, agents: AgentDir
     const sentence = head === null
       ? { line: "No context reading yet. A session reports one after its first turn.", tone: "default" as const }
       : head.outlook.past
-        ? { line: enrolled ? "Past its compact line. Smart Compact asks it at the end of a turn whether to compact." : "Past its compact line, but not enrolled, so nothing will ask it.", tone: head.outlook.tone }
+        ? { line: enrolled ? "Past its compact line. Smart Compact asks it at the end of a turn whether to compact." : compactOn ? "Past its compact line, but not enrolled, so nothing will ask it." : "Past its compact line. Smart Compact is off, so nothing will ask it.", tone: head.outlook.tone }
         : head.outlook.untilCompactMs !== null
           ? { line: `Reaches its compact line in about ${formatDuration(head.outlook.untilCompactMs)} at +${formatCompactTokens(row!.growthTokensPerHour!)}/h.`, tone: "default" as const }
           : { line: "Below its compact line and not growing right now.", tone: "default" as const };
@@ -79,35 +113,117 @@ export function makeContextPopover(client: PluginClientContext, agents: AgentDir
       ["Last compaction", compactions.data === undefined ? "…" : compactionLine(latest, now)],
     ];
     const ringColor = head === null ? c.foregroundMuted : head.outlook.tone !== "default" ? toneFill(c, head.outlook.tone) : enrolled ? c.foreground : c.foregroundMuted;
+    const part = { gap: 6, paddingTop: 10, borderTopWidth: 1, borderTopColor: c.border } as const;
 
-    return <View style={{ width: compact ? "100%" : 340, padding: compact ? 16 : 14, gap: 12 }}>
-      <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
-        <Ring size={40} color={ringColor} fraction={head === null ? 0 : head.outlook.pct / 100} mark={head === null ? null : head.compactAtPct / 100} />
-        <View style={{ flex: 1, gap: 1 }}>
-          <View style={{ flexDirection: "row", alignItems: "baseline", gap: 6 }}>
-            <Text style={{ color: c.foreground, fontSize: 22, lineHeight: 28, fontWeight: "600" }}>{head === null ? "—" : `${Math.round(head.outlook.pct)}%`}</Text>
-            <Text style={t.meta}>{max === null ? "context" : `of ${formatCompactTokens(max)} context`}</Text>
+    // The loud state: what happened, when it comes back, and the one way to let it go.
+    const pausePart = (() => {
+      if (pause === undefined || guard === null) return null;
+      const look = pausePresentation(pause, guard.policy, now);
+      const stuck = pause.phase === "attention";
+      const reset = resumeMoment(pause);
+      const auto = guard.policy.enabled && guard.policy.autoResume;
+      const moment = stuck ? "Needs a look" : pause.demo ? "Test pause" : reset === null ? "Reset time unknown" : reset <= now ? "Reset due" : `${auto ? "Resumes" : "Resets"} ${formatClock(pause.anchorResetsAt)}`;
+      const after = stuck ? (pause.note ?? "It stopped before the pause was confirmed. Check it before continuing by hand.")
+        : pause.demo ? "a test pause that waits for you"
+          : reset === null ? "Waiting for the provider to report the reset"
+            : reset <= now ? "Waiting for a fresh usage reading"
+              : `in ${formatDuration(reset - now)} · ${auto ? "continues in this conversation" : "continue it by hand"}`;
+      const tone = stuck ? c.statusDanger : c.statusWarning;
+      const meta = [stuck ? null : "Paused at the session limit", after, look.coverage.toLowerCase()].filter(Boolean).join(" · ");
+      const waiting = pause.phase === "waiting";
+      return <View style={{ gap: 8 }}>
+        <View style={{ flexDirection: "row", alignItems: "center", gap: 8 }}>
+          <Icon name={stuck ? "TriangleAlert" : "Pause"} size={18} color={tone} />
+          <Text style={{ color: c.foreground, fontSize: 20, lineHeight: 26, fontWeight: "600", flexShrink: 1, ...tabular }}>{moment}</Text>
+        </View>
+        <Text style={{ ...t.meta, color: stuck ? c.statusDanger : c.foregroundMuted }}>{meta}</Text>
+        <View style={{ flexDirection: "row", alignItems: "center", flexWrap: "wrap", gap: 6 }}>
+          {waiting ? <>
+            <Button theme={theme} small compact={compact} icon={PAUSE_ACTIONS.resume.icon} title={saving === "resume" ? PAUSE_ACTIONS.resume.busy : PAUSE_ACTIONS.resume.label} disabled={saving !== null}
+              accessibilityHint={PAUSE_ACTIONS.resume.hint} onPress={() => void settle("resume", pause.id)} />
+            <Button theme={theme} small compact={compact} kind="ghost" title={saving === "dismiss" ? PAUSE_ACTIONS.dismiss.busy : PAUSE_ACTIONS.dismiss.label} disabled={saving !== null}
+              accessibilityHint={PAUSE_ACTIONS.dismiss.hint} onPress={() => void settle("dismiss", pause.id)} />
+          </> : stuck ? <Button theme={theme} small compact={compact} title={saving === "release" ? "Updating…" : look.actionLabel} disabled={saving !== null}
+            accessibilityHint={look.actionHint} onPress={() => void release()} /> : null}
+          <View style={{ flex: 1 }} />
+          <TextLink theme={theme} compact={compact} label="All paused sessions" onPress={() => openOverview("paused")} />
+        </View>
+        {waiting ? <Text style={t.small}>{PAUSE_ACTIONS.note}</Text> : null}
+      </View>;
+    })();
+
+    const protectionPart = (() => {
+      if (pause !== undefined) return null;
+      if (protection.kind === "unknown") return null;
+      if (protection.kind === "on") {
+        const meta = protection.protected
+          ? `Pauses at ${protection.thresholdPct}% of the session window, ${protection.autoResume ? "continues after the reset" : "you continue it after the reset"}`
+          : "Off for this session · at the limit the provider refuses work and nothing continues it";
+        const source = protection.override === null ? (protection.byDefault ? "Your default" : "Your default is off") : "Changed for this session";
+        return <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
+          <View style={{ flex: 1, gap: 2 }}>
+            <Text style={t.label}>Pause at the limit</Text>
+            <Text style={t.meta}>{meta}</Text>
+            <View style={{ flexDirection: "row", alignItems: "center", gap: 10, flexWrap: "wrap" }}>
+              <Text style={t.small}>{source}</Text>
+              {protection.override !== null ? <TextLink theme={theme} compact={compact} icon="RotateCcw" label="Use default" onPress={() => void setProtected(null)} /> : null}
+            </View>
+          </View>
+          <Switch theme={theme} label="Pause this session at the limit" hideLabel value={protection.protected} disabled={saving !== null} compact={compact} onChange={(next) => void setProtected(next)} />
+        </View>;
+      }
+      // Not running here: one calm line, and where to change it.
+      const line = protection.kind === "off" ? "Pause at the limit is off on this host"
+        : protection.kind === "elsewhere" ? (protection.standalone ? "The standalone Session Guard plugin handles pausing at the limit here" : "Another process handles pausing at the limit here")
+          : (governorNotice(guard!)?.title ?? "Pause at the limit isn't running");
+      return <View style={{ flexDirection: "row", alignItems: "center", gap: 8 }}>
+        <Icon name="CirclePause" size={13} color={c.foregroundMuted} />
+        <Text style={{ ...t.meta, flex: 1 }}>{line}</Text>
+        {protection.kind === "off" ? <TextLink theme={theme} compact={compact} icon="Settings" label="Turn on" onPress={openSettings} /> : null}
+      </View>;
+    })();
+
+    return <View style={{ width: compact ? "100%" : 340, padding: compact ? 16 : 14, paddingTop: compact ? 4 : 14, gap: 12 }}>
+      {pausePart}
+      <View style={[{ gap: 12 }, pausePart === null ? null : part]}>
+        <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
+          <Ring size={pausePart === null ? 40 : 28} color={ringColor} fraction={head === null ? 0 : head.outlook.pct / 100} mark={head === null || !enrolled ? null : head.compactAtPct / 100} />
+          <View style={{ flex: 1, gap: 1 }}>
+            <View style={{ flexDirection: "row", alignItems: "baseline", gap: 6 }}>
+              <Text style={{ color: c.foreground, fontSize: pausePart === null ? 22 : 15, lineHeight: pausePart === null ? 28 : 20, fontWeight: "600", ...tabular }}>{head === null ? "—" : `${Math.round(head.outlook.pct)}%`}</Text>
+              <Text style={t.meta}>{max === null ? "context" : `of ${formatCompactTokens(max)} context`}</Text>
+            </View>
+            <Text style={t.meta}>{head === null || used === null ? "Waiting for a reading" : `${formatCompactTokens(used)} tokens · compacts at ${head.compactAtPct}% (${formatCompactTokens(head.outlook.compactTokens)})`}</Text>
           </View>
-          <Text style={t.meta}>{head === null || used === null ? "Waiting for a reading" : `${formatCompactTokens(used)} tokens · compacts at ${head.compactAtPct}% (${formatCompactTokens(head.outlook.compactTokens)})`}</Text>
         </View>
+        {head === null || pausePart !== null ? null : <Meter theme={theme} pct={head.outlook.pct} tone={head.outlook.tone} mark={head.compactAtPct} height={6} label={`Context ${Math.round(head.outlook.pct)}% full, compacts at ${head.compactAtPct}%`} />}
+        {pausePart !== null ? null : <Text style={{ ...t.body, color: sentence.tone === "default" ? c.foreground : toneColor(c, sentence.tone) }}>{sentence.line}</Text>}
       </View>
-      {head === null ? null : <Meter theme={theme} pct={head.outlook.pct} tone={head.outlook.tone} mark={head.compactAtPct} height={6} label={`Context ${Math.round(head.outlook.pct)}% full, compacts at ${head.compactAtPct}%`} />}
-      <Text style={{ ...t.body, color: sentence.tone === "default" ? c.foreground : toneColor(c, sentence.tone) }}>{sentence.line}</Text>
-      <View style={{ gap: 6, paddingTop: 10, borderTopWidth: 1, borderTopColor: c.border }}>
+      {pausePart !== null ? null : <View style={part}>
         {facts.map(([label, value]) => <View key={label} style={{ flexDirection: "row", gap: 12 }}>
           <Text style={{ ...t.meta, width: 112 }}>{label}</Text>
           <Text style={{ ...t.meta, flex: 1, color: c.foreground, ...tabular }}>{value}</Text>
         </View>)}
-      </View>
-      <View style={{ flexDirection: "row", alignItems: "center", gap: 12, paddingTop: 10, borderTopWidth: 1, borderTopColor: c.border }}>
-        <View style={{ flex: 1, gap: 2 }}>
-          <Text style={t.label}>Smart Compact for this session</Text>
-          <Text style={t.meta}>{enrolled ? `Asked to compact itself once past ${head?.compactAtPct ?? "its"}%${head === null ? " line" : ""}. Never forced.` : "Never asked to compact. The agent can still request it."}</Text>
-        </View>
-        <Switch theme={theme} label="Smart Compact for this session" hideLabel value={enrolled} disabled={saving} compact={compact} onChange={(next) => void toggle(next)} />
+      </View>}
+      <View style={{ ...part, gap: 12 }}>
+        {compactOn ? <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}>
+          <View style={{ flex: 1, gap: 2 }}>
+            <Text style={t.label}>Smart Compact</Text>
+            <Text style={t.meta}>{enrolled ? `Asked to compact itself once past ${head?.compactAtPct ?? "its"}%${head === null ? " line" : ""}. Never forced.` : "Never asked to compact. The agent can still request it."}</Text>
+          </View>
+          <Switch theme={theme} label="Smart Compact for this session" hideLabel value={enrolled} disabled={saving !== null} compact={compact} onChange={(next) => void toggleCompact(next)} />
+        </View> : <View style={{ flexDirection: "row", alignItems: "center", gap: 8 }}>
+          <Icon name="FoldVertical" size={13} color={c.foregroundMuted} />
+          <Text style={{ ...t.meta, flex: 1 }}>Smart Compact is off on this host</Text>
+        </View>}
+        {protectionPart}
       </View>
       {problem ? <Text accessibilityRole="alert" style={{ ...t.meta, color: c.statusDanger }}>{problem}</Text> : null}
-      <TextLink theme={theme} compact={compact} label="Plan usage and every session" onPress={() => { close(); client.openScreen({ screenId: "overview" }); }} />
+      <View style={{ flexDirection: "row", alignItems: "center", gap: 16, flexWrap: "wrap" }}>
+        <TextLink theme={theme} compact={compact} label="Plan usage and every session" onPress={() => openOverview()} />
+        <View style={{ flex: 1 }} />
+        <TextLink theme={theme} compact={compact} icon="Settings" label="Settings" onPress={openSettings} />
+      </View>
     </View>;
   };
 }

package/client/screens.ts

@@ -0,0 +1,6 @@
+/** Where Smart Session's screens live, in one place for the pill, the views and the Command Center. */
+export const OVERVIEW_SCREEN = "overview";
+/** The old Paused sessions screen id, kept as the overview opened at its paused list. */
+export const PAUSED_SCREEN = "paused-sessions";
+/** The one settings screen. It kept Smart Compact's id so links to the old first page still land. */
+export const SETTINGS_SCREEN = "smart-compact";