Open History to see the last commit
1import { useAtomValue } from "@effect/atom-react";
2import { scopeThreadRef } from "@t3tools/client-runtime/environment";
3import {
4 AuthPreviewOperateScope,
5 type DiscoveredLocalServer,
6 type EnvironmentId,
7 type ThreadId,
8} from "@t3tools/contracts";
9import {
10 isAtomCommandInterrupted,
11 squashAtomCommandFailure,
12} from "@t3tools/client-runtime/state/runtime";
13import {
14 GlobeIcon,
15 LoaderCircleIcon,
16 SquareIcon,
17 ChevronDownIcon,
18 ChevronUpIcon,
19} from "lucide-react";
20import { type MouseEvent, useState } from "react";
21
22import { resolveDiscoveredServerUrl } from "../../browser/browserTargetResolver";
23import { readLocalApi } from "../../localApi";
24import { cn, isMacPlatform } from "../../lib/utils";
25import { useThreadDiscoveredPorts } from "../../portDiscoveryState";
26import { useEnvironment } from "../../state/environments";
27import { previewEnvironment } from "../../state/preview";
28import { useEnvironmentScope } from "../../state/session";
29import { useAtomCommand } from "../../state/use-atom-command";
30import { openDiscoveredPort } from "../preview/openDiscoveredPort";
31import { stackedThreadToast, toastManager } from "../ui/toast";
32import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";
33import { ThreadDetailsControl } from "./ThreadDetailsControl";
34import { ThreadDetailsSection } from "./ThreadDetailsSection";
35import { THREAD_DETAILS_PANEL_ICON_CLASS } from "./threadDetailsPanelStyles";
36
37const SERVER_PAGE_COUNT = 4;
38
39const serverKey = (server: DiscoveredLocalServer) => `${server.pid}:${server.port}`;
40
41interface ThreadServersPanelProps {
42 readonly environmentId: EnvironmentId;
43 readonly threadId: ThreadId;
44}
45
46/** Local servers the thread's terminals and agent started. Hidden while none run. */
47export function ThreadServersPanel(props: ThreadServersPanelProps) {
48 return <ThreadServersList key={`${props.environmentId}:${props.threadId}`} {...props} />;
49}
50
51function ThreadServersList(props: ThreadServersPanelProps) {
52 const servers = useThreadDiscoveredPorts(props);
53 const canOpen = useEnvironmentScope(props.environmentId, AuthPreviewOperateScope);
54 const canStop = useAtomValue(
55 previewEnvironment.stopLocalServer.permissionAtom(props.environmentId),
56 );
57 const supportsStop =
58 useEnvironment(props.environmentId)?.serverConfig?.environment.capabilities.localServerStop ===
59 true;
60 const openPreview = useAtomCommand(previewEnvironment.open, { reportFailure: false });
61 const stopServer = useAtomCommand(previewEnvironment.stopLocalServer, {
62 label: "thread server stop",
63 });
64 const [stoppingKey, setStoppingKey] = useState<string | null>(null);
65 const [visibleCount, setVisibleCount] = useState(SERVER_PAGE_COUNT);
66
67 if (servers.length === 0) return null;
68 const externalClickLabel = isMacPlatform(navigator.platform) ? "⌘-click" : "Ctrl-click";
69 const threadRef = scopeThreadRef(props.environmentId, props.threadId);
70 const hiddenCount = Math.max(0, servers.length - visibleCount);
71
72 const reportFailure = (title: string, error: unknown) => {
73 toastManager.add(
74 stackedThreadToast({
75 type: "error",
76 title,
77 description: error instanceof Error ? error.message : String(error),
78 }),
79 );
80 };
81
82 const open = async (server: DiscoveredLocalServer, event: MouseEvent<HTMLElement>) => {
83 if (event.button > 1) return;
84 // Like links: modified and middle clicks go to the system browser.
85 if (event.metaKey || event.ctrlKey || event.button === 1) {
86 event.preventDefault();
87 const url = resolveDiscoveredServerUrl(props.environmentId, server.url);
88 await readLocalApi()
89 ?.shell.openExternal(url)
90 .catch((error: unknown) => reportFailure("Unable to open in browser", error));
91 return;
92 }
93 const result = await openDiscoveredPort({ threadRef, port: server, openPreview });
94 if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
95 reportFailure("Unable to open preview", squashAtomCommandFailure(result));
96 }
97 };
98
99 const stop = async (server: DiscoveredLocalServer) => {
100 if (server.pid === null || stoppingKey !== null) return;
101 setStoppingKey(serverKey(server));
102 const result = await stopServer({
103 environmentId: props.environmentId,
104 input: { pid: server.pid, port: server.port },
105 });
106 setStoppingKey(null);
107 if (result._tag === "Failure" && !isAtomCommandInterrupted(result)) {
108 reportFailure("Could not stop server", squashAtomCommandFailure(result));
109 }
110 };
111
112 return (
113 <ThreadDetailsSection headingId="thread-details-servers-heading" title="Servers">
114 <ul className="m-0 list-none p-0">
115 {servers.slice(0, visibleCount).map((server, index) => {
116 const key = serverKey(server);
117 const stoppable = canStop && supportsStop && server.pid !== null;
118 return (
119 <li
120 key={key}
121 data-thread-details-server-overflow={index >= SERVER_PAGE_COUNT || undefined}
122 className="group relative flex items-center rounded-lg"
123 >
124 <Tooltip>
125 <TooltipTrigger
126 delay={200}
127 render={
128 <ThreadDetailsControl
129 size="sm"
130 variant="ghost"
131 part="row"
132 multiline
133 disabled={!canOpen}
134 onClick={(event) => void open(server, event)}
135 onAuxClick={(event) => void open(server, event)}
136 />
137 }
138 >
139 <GlobeIcon aria-hidden className={THREAD_DETAILS_PANEL_ICON_CLASS} />
140 {/* The end padding keeps text clear of the stop button. */}
141 <span className={cn("flex min-w-0 flex-1 flex-col gap-0.5", stoppable && "pe-6")}>
142 <span className="truncate text-sm font-medium leading-4 text-foreground/85">
143 localhost:{server.port}
144 </span>
145 <span className="truncate text-2xs font-normal leading-4 text-muted-foreground">
146 {[server.terminal === null ? "Agent" : "Terminal", server.processName]
147 .filter(Boolean)
148 .join(" · ")}
149 </span>
150 </span>
151 </TooltipTrigger>
152 <TooltipPopup side="left">
153 Open in the browser panel. {externalClickLabel} for your browser.
154 </TooltipPopup>
155 </Tooltip>
156 {stoppable ? (
157 <div className="pointer-events-none absolute right-1 top-1/2 -translate-y-1/2 opacity-0 group-hover:pointer-events-auto group-hover:opacity-100 group-focus-within:pointer-events-auto group-focus-within:opacity-100 pointer-coarse:pointer-events-auto pointer-coarse:opacity-100 [@media(hover:none)]:pointer-events-auto [@media(hover:none)]:opacity-100">
158 <Tooltip>
159 <TooltipTrigger
160 render={
161 <ThreadDetailsControl
162 size="icon-xs"
163 variant="ghost"
164 part="icon"
165 tone="destructive"
166 aria-label={`Stop localhost:${server.port}`}
167 disabled={stoppingKey !== null}
168 onClick={() => void stop(server)}
169 />
170 }
171 >
172 {stoppingKey === key ? (
173 <LoaderCircleIcon aria-hidden className="size-3 animate-spin" />
174 ) : (
175 <SquareIcon aria-hidden className="size-3 fill-current" />
176 )}
177 </TooltipTrigger>
178 <TooltipPopup side="left">Stop server</TooltipPopup>
179 </Tooltip>
180 </div>
181 ) : null}
182 </li>
183 );
184 })}
185 </ul>
186 {servers.length > SERVER_PAGE_COUNT ? (
187 <ThreadDetailsControl
188 variant="ghost"
189 size="sm"
190 onClick={() =>
191 setVisibleCount(hiddenCount > 0 ? visibleCount + SERVER_PAGE_COUNT : SERVER_PAGE_COUNT)
192 }
193 part="row"
194 tone="muted"
195 className="w-full active:scale-100"
196 >
197 {hiddenCount > 0 ? (
198 <ChevronDownIcon aria-hidden className="size-4 shrink-0" />
199 ) : (
200 <ChevronUpIcon aria-hidden className="size-4 shrink-0" />
201 )}
202 {hiddenCount > 0 ? `Show ${Math.min(hiddenCount, SERVER_PAGE_COUNT)} more` : "Show less"}
203 </ThreadDetailsControl>
204 ) : null}
205 </ThreadDetailsSection>
206 );
207}