@devries-cameron20 / t3code-1 / commits / dcf158c591
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

feat(server): setting and managed policy to turn off the preview tunnel (#39415)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Julius Marminge committed Nov 19, 2026 at 15:47 UTC dcf158c5915baaf961ddc1bce06cafd4d2eeeb00
46 files changed +472 -30
apps/mobile/src/features/browser/BrowserTabMenu.tsx
+3 -1
@@ -16,6 +16,7 @@ import { msg, useGT, useMessages } from "gt-react-native";
16 import { ControlPill } from "../../components/ui/ControlPill";
17 import { Menu } from "../../components/ui/Menu";
18 import { m } from "../../i18n/messages";
19 +import { useEnvironmentPreviewTunnelOff } from "../../state/entities";
20 import { previewEnvironment } from "../../state/preview";
21 import { useAtomCommand } from "../../state/use-atom-command";
22 import { browserTabUrl, loopbackUrlForDevice } from "./browserTabs";
@@ -65,6 +66,7 @@ export function BrowserTabMenu({
66 readonly onReleaseControl?: () => void;
67 }) {
68 const openLocalPreview = useOpenLocalPreview();
69 + const tunnelOff = useEnvironmentPreviewTunnelOff(environmentId);
70 const adjust = useAtomCommand(previewEnvironment.adjust, "browser tab change");
71 const resize = useAtomCommand(previewEnvironment.resize, "browser viewport change");
72 const close = useAtomCommand(previewEnvironment.close, "browser tab close");
@@ -92,7 +94,7 @@ export function BrowserTabMenu({
94 image: "xmark",
95 attributes: { destructive: true, disabled: !canClose },
96 };
95 - const deviceUrl = loopbackUrlForDevice(browserTabUrl(tab));
97 + const deviceUrl = tunnelOff ? null : loopbackUrlForDevice(browserTabUrl(tab));
98 // The device preview has its own webview and tunnel, so it doesn't wait for the stream.
99 const openOnDevice: MenuAction[] = deviceUrl
100 ? [{ id: "open-on-device", title: gt("Open on this device"), image: "iphone" }]
apps/mobile/src/features/browser/LocalPreviewRouteScreen.tsx
+21 -2
@@ -10,6 +10,7 @@ import { AppText } from "../../components/ui/AppText";
10 import * as Dialog from "../../components/ui/Dialog";
11 import { EmptyState } from "../../components/ui/EmptyState";
12 import { m } from "../../i18n/messages";
13 +import { useEnvironmentPreviewTunnelOff } from "../../state/entities";
14 import { useEnvironments } from "../../state/environments";
15 import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
16 import { BrowserChrome } from "./BrowserBar";
@@ -49,6 +50,7 @@ export function LocalPreviewScreen(props: {
50 useEnvironments().presentationById.get(environmentId)?.entry.target.label ??
51 gt("the environment", { $context: "stands in for an environment name in a sentence" });
52 const { themeVariables } = useAppearancePreferences();
53 + const tunnelOff = useEnvironmentPreviewTunnelOff(environmentId);
54 const webView = useRef<TunnelWebViewRef>(null);
55 const [requested, setRequested] = useState(initialUrl);
56 const [page, setPage] = useState<TunnelNavigation | null>(null);
@@ -77,7 +79,7 @@ export function LocalPreviewScreen(props: {
79 };
80 const back = () => void webView.current?.goBack();
81 const canGoBack = page?.canGoBack ?? false;
80 - const pageColor = failed || unsupported !== null ? null : page?.pageColor || null;
82 + const pageColor = failed || tunnelOff || unsupported !== null ? null : page?.pageColor || null;
83
84 return (
85 // Full screen spans the Duo's rail, so it insets its own sides; the pane is inset already.
@@ -127,7 +129,24 @@ export function LocalPreviewScreen(props: {
129 setFailed(true);
130 }}
131 />
130 - {unsupported !== null ? (
132 + {tunnelOff ? (
133 + <View
134 + className="absolute inset-0 items-center justify-center"
135 + style={{ backgroundColor: themeVariables["--color-sheet-solid"] }}
136 + >
137 + <View className="w-full max-w-md">
138 + <EmptyState
139 + variant="plain"
140 + title={gt("{environment} doesn't share its localhost", {
141 + environment: environmentLabel,
142 + })}
143 + detail={gt(
144 + "The preview tunnel is off there, so its local servers only open in the streamed browser.",
145 + )}
146 + />
147 + </View>
148 + </View>
149 + ) : unsupported !== null ? (
150 <View
151 className="absolute inset-0 items-center justify-center"
152 style={{ backgroundColor: themeVariables["--color-sheet-solid"] }}
apps/mobile/src/features/threads/ThreadFeed.tsx
+8 -3
@@ -289,6 +289,7 @@ import {
289 } from "@t3tools/client-runtime/workspace-basename-lookup";
290 import {
291 resolveThreadLink,
292 + useEnvironmentPreviewTunnelOff,
293 useLiveThreadLinkLabels,
294 useQuietThreadShell,
295 useThreadChipIcons,
@@ -3139,6 +3140,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3140 const navigation = useNavigation();
3141 const openLinkedThread = useOpenLinkedThread();
3142 const openLocalPreview = useOpenLocalPreview();
3143 + const previewTunnelOff = useEnvironmentPreviewTunnelOff(props.environmentId);
3144 + // Without the tunnel, loopback links fall through to the system browser like any other link.
3145 + const deviceLoopbackUrl = (href: string) =>
3146 + previewTunnelOff ? null : loopbackUrlForDevice(href);
3147 // Recycling a row disposes its native audio player, so a started clip's row stays rendered.
3148 const [retainedMediaRowId, setRetainedMediaRowId] = useState<string | null>(null);
3149 const focused = useIsFocused();
@@ -3421,7 +3426,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3426 return;
3427 }
3428 // Safari would open the phone's own localhost, so these open on the device by default.
3424 - const deviceUrl = loopbackUrlForDevice(href);
3429 + const deviceUrl = deviceLoopbackUrl(href);
3430 if (deviceUrl) {
3431 openLocalPreview(
3432 { environmentId: String(props.environmentId), threadId: String(props.threadId) },
@@ -3559,7 +3564,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3564 };
3565 }
3566 // The environment's localhost, which this device can only reach through the tunnel.
3562 - if (loopbackUrlForDevice(href)) {
3567 + if (deviceLoopbackUrl(href)) {
3568 return {
3569 title: href,
3570 actions: [
@@ -3585,7 +3590,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3590 else if (actionId === "copy-thread-link") copyTextWithHaptic(hostedThreadLink(thread));
3591 return;
3592 }
3588 - const deviceUrl = loopbackUrlForDevice(href);
3593 + const deviceUrl = deviceLoopbackUrl(href);
3594 if (deviceUrl) {
3595 if (actionId === "open-on-device") {
3596 markdownLinkRequest.current?.abort();
apps/mobile/src/i18n/translations/de.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Die Richtlinie von {organization} erlaubt T3 Connect nicht.",
24 "986b0873f913a840": "Die Richtlinie von {organization} erlaubt keine Webhook-Aufgaben.",
25 "eebc538e25b09fe2": "Die Richtlinie von {organization} erlaubt keinen Import von Browser-Cookies.",
26 + "7642a133db05f164": "Die Richtlinie von {organization} erlaubt nicht, die lokalen Server dieses Rechners auf anderen Geräten zu öffnen.",
27 "39f6771b49f9b3b6": "Standard verwenden",
28 "45bb0e90e1c42046": "Wenn du zurückkommst",
29 "d8fa0a55446bbb0d": "Bevor der Cache abläuft (Beta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Cache leeren",
1782 "4d7f5af0445371fd": "Optionen für Browser-Tab",
1783 "27025b00be488485": "die Umgebung",
1784 + "4391875125b7882c": "{environment} teilt seinen localhost nicht",
1785 + "ec7a78dd403ccf6a": "Der Vorschau-Tunnel ist dort ausgeschaltet, daher öffnen sich seine lokalen Server nur im gestreamten Browser.",
1786 "e1ffd0532d64e52c": "Dieses Gerät kann keine localhost-Seiten öffnen",
1787 "f72cc72b321f93a5": "{reason} Für diesen Tab kannst du weiterhin den gestreamten Browser verwenden.",
1788 "6bf09d4b7e4ba53b": "T3 Code auf {environment} aktualisieren",
apps/mobile/src/i18n/translations/en.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization}'s policy does not allow T3 Connect.",
24 "986b0873f913a840": "{organization}'s policy does not allow webhook tasks.",
25 "eebc538e25b09fe2": "{organization}'s policy does not allow importing browser cookies.",
26 + "7642a133db05f164": "{organization}'s policy does not allow opening this machine's local servers on other devices.",
27 "39f6771b49f9b3b6": "Use default",
28 "45bb0e90e1c42046": "When you return",
29 "d8fa0a55446bbb0d": "Before the cache expires (beta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Clear cache",
1782 "4d7f5af0445371fd": "Browser tab options",
1783 "27025b00be488485": "the environment",
1784 + "4391875125b7882c": "{environment} doesn't share its localhost",
1785 + "ec7a78dd403ccf6a": "The preview tunnel is off there, so its local servers only open in the streamed browser.",
1786 "e1ffd0532d64e52c": "This device can't open localhost pages",
1787 "f72cc72b321f93a5": "{reason} You can still use the streamed browser for this tab.",
1788 "6bf09d4b7e4ba53b": "Update T3 Code on {environment}",
apps/mobile/src/i18n/translations/es.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "La política de {organization} no permite T3 Connect.",
24 "986b0873f913a840": "La política de {organization} no permite tareas de webhook.",
25 "eebc538e25b09fe2": "La política de {organization} no permite importar cookies del navegador.",
26 + "7642a133db05f164": "La política de {organization} no permite abrir los servidores locales de esta máquina en otros dispositivos.",
27 "39f6771b49f9b3b6": "Usar valor predeterminado",
28 "45bb0e90e1c42046": "Cuando vuelvas",
29 "d8fa0a55446bbb0d": "Antes de que caduque la caché (beta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Borrar caché",
1782 "4d7f5af0445371fd": "Opciones de la pestaña del navegador",
1783 "27025b00be488485": "el entorno",
1784 + "4391875125b7882c": "{environment} no comparte su localhost",
1785 + "ec7a78dd403ccf6a": "El túnel de vista previa está desactivado allí, así que sus servidores locales solo se abren en el navegador transmitido.",
1786 "e1ffd0532d64e52c": "Este dispositivo no puede abrir páginas de localhost",
1787 "f72cc72b321f93a5": "{reason} Aún puedes usar el navegador transmitido para esta pestaña.",
1788 "6bf09d4b7e4ba53b": "Actualiza T3 Code en {environment}",
apps/mobile/src/i18n/translations/fr.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "La politique de {organization} n’autorise pas T3 Connect.",
24 "986b0873f913a840": "La politique de {organization} n’autorise pas les tâches webhook.",
25 "eebc538e25b09fe2": "La politique de {organization} n’autorise pas l’import des cookies du navigateur.",
26 + "7642a133db05f164": "La stratégie de {organization} n’autorise pas l’ouverture des serveurs locaux de cette machine sur d’autres appareils.",
27 "39f6771b49f9b3b6": "Utiliser la valeur par défaut",
28 "45bb0e90e1c42046": "À votre retour",
29 "d8fa0a55446bbb0d": "Avant l’expiration du cache (bêta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Vider le cache",
1782 "4d7f5af0445371fd": "Options de l’onglet du navigateur",
1783 "27025b00be488485": "l’environnement",
1784 + "4391875125b7882c": "{environment} ne partage pas son localhost",
1785 + "ec7a78dd403ccf6a": "Le tunnel d’aperçu y est désactivé, ses serveurs locaux ne s’ouvrent donc que dans le navigateur diffusé.",
1786 "e1ffd0532d64e52c": "Cet appareil ne peut pas ouvrir les pages localhost",
1787 "f72cc72b321f93a5": "{reason} Tu peux toujours utiliser le navigateur diffusé pour cet onglet.",
1788 "6bf09d4b7e4ba53b": "Mettez à jour T3 Code sur {environment}",
apps/mobile/src/i18n/translations/ja.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization} のポリシーでは、T3 Connect は許可されていません。",
24 "986b0873f913a840": "{organization} のポリシーでは、Webhook タスクは許可されていません。",
25 "eebc538e25b09fe2": "{organization} のポリシーでは、ブラウザーの Cookie のインポートは許可されていません。",
26 + "7642a133db05f164": "{organization} のポリシーでは、このマシンのローカルサーバーを他のデバイスで開くことは許可されていません。",
27 "39f6771b49f9b3b6": "デフォルトを使用",
28 "45bb0e90e1c42046": "戻ってきたとき",
29 "d8fa0a55446bbb0d": "キャッシュの期限切れ前 (ベータ)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "キャッシュを消去",
1782 "4d7f5af0445371fd": "ブラウザータブのオプション",
1783 "27025b00be488485": "環境",
1784 + "4391875125b7882c": "{environment} は localhost を共有していません",
1785 + "ec7a78dd403ccf6a": "そちらではプレビュートンネルがオフのため、ローカルサーバーはストリーミングブラウザでのみ開けます。",
1786 "e1ffd0532d64e52c": "このデバイスでは localhost のページを開けません",
1787 "f72cc72b321f93a5": "{reason} このタブではストリーミングブラウザを引き続き使えます。",
1788 "6bf09d4b7e4ba53b": "{environment} の T3 Code を更新してください",
apps/mobile/src/i18n/translations/ko.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization}의 정책상 T3 Connect를 사용할 수 없습니다.",
24 "986b0873f913a840": "{organization}의 정책상 웹후크 작업을 사용할 수 없습니다.",
25 "eebc538e25b09fe2": "{organization}의 정책상 브라우저 쿠키를 가져올 수 없습니다.",
26 + "7642a133db05f164": "{organization}의 정책은 이 컴퓨터의 로컬 서버를 다른 기기에서 여는 것을 허용하지 않습니다.",
27 "39f6771b49f9b3b6": "기본값 사용",
28 "45bb0e90e1c42046": "돌아왔을 때",
29 "d8fa0a55446bbb0d": "캐시가 만료되기 전(베타)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "캐시 지우기",
1782 "4d7f5af0445371fd": "브라우저 탭 옵션",
1783 "27025b00be488485": "환경",
1784 + "4391875125b7882c": "{environment}에서 localhost를 공유하지 않습니다",
1785 + "ec7a78dd403ccf6a": "그곳에서 미리보기 터널이 꺼져 있어 로컬 서버는 스트리밍 브라우저에서만 열립니다.",
1786 "e1ffd0532d64e52c": "이 기기에서는 localhost 페이지를 열 수 없습니다",
1787 "f72cc72b321f93a5": "{reason} 이 탭에서는 스트리밍 브라우저를 계속 사용할 수 있습니다.",
1788 "6bf09d4b7e4ba53b": "{environment}의 T3 Code를 업데이트하세요",
apps/mobile/src/i18n/translations/pt-BR.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "A política de {organization} não permite o T3 Connect.",
24 "986b0873f913a840": "A política de {organization} não permite tarefas de webhook.",
25 "eebc538e25b09fe2": "A política de {organization} não permite importar cookies do navegador.",
26 + "7642a133db05f164": "A política de {organization} não permite abrir os servidores locais desta máquina em outros dispositivos.",
27 "39f6771b49f9b3b6": "Usar padrão",
28 "45bb0e90e1c42046": "Quando você voltar",
29 "d8fa0a55446bbb0d": "Antes de o cache expirar (beta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Limpar cache",
1782 "4d7f5af0445371fd": "Opções da aba do navegador",
1783 "27025b00be488485": "o ambiente",
1784 + "4391875125b7882c": "{environment} não compartilha seu localhost",
1785 + "ec7a78dd403ccf6a": "O túnel de pré-visualização está desativado lá, então seus servidores locais só abrem no navegador transmitido.",
1786 "e1ffd0532d64e52c": "Este dispositivo não consegue abrir páginas de localhost",
1787 "f72cc72b321f93a5": "{reason} Você ainda pode usar o navegador transmitido para esta aba.",
1788 "6bf09d4b7e4ba53b": "Atualize o T3 Code em {environment}",
apps/mobile/src/i18n/translations/ru.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Политика {organization} запрещает T3 Connect.",
24 "986b0873f913a840": "Политика {organization} запрещает задачи по вебхуку.",
25 "eebc538e25b09fe2": "Политика {organization} запрещает импорт cookie браузера.",
26 + "7642a133db05f164": "Политика {organization} не разрешает открывать локальные серверы этого компьютера на других устройствах.",
27 "39f6771b49f9b3b6": "По умолчанию",
28 "45bb0e90e1c42046": "Когда вы вернётесь",
29 "d8fa0a55446bbb0d": "До истечения кеша (бета)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Очистить кеш",
1782 "4d7f5af0445371fd": "Параметры вкладки браузера",
1783 "27025b00be488485": "окружение",
1784 + "4391875125b7882c": "{environment} не открывает доступ к своему localhost",
1785 + "ec7a78dd403ccf6a": "Там выключен туннель предпросмотра, поэтому его локальные серверы открываются только в транслируемом браузере.",
1786 "e1ffd0532d64e52c": "Это устройство не может открывать страницы localhost",
1787 "f72cc72b321f93a5": "{reason} Для этой вкладки можно по-прежнему использовать транслируемый браузер.",
1788 "6bf09d4b7e4ba53b": "Обновите T3 Code на {environment}",
apps/mobile/src/i18n/translations/sv.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Policyn för {organization} tillåter inte T3 Connect.",
24 "986b0873f913a840": "Policyn för {organization} tillåter inte webhook-uppgifter.",
25 "eebc538e25b09fe2": "Policyn för {organization} tillåter inte import av cookies från webbläsare.",
26 + "7642a133db05f164": "{organization}s policy tillåter inte att den här datorns lokala servrar öppnas på andra enheter.",
27 "39f6771b49f9b3b6": "Använd standard",
28 "45bb0e90e1c42046": "När du kommer tillbaka",
29 "d8fa0a55446bbb0d": "Innan cachen går ut (beta)",
@@ -1780,6 +1781,8 @@
1781 "9bce41be8fc55a47": "Rensa cache",
1782 "4d7f5af0445371fd": "Alternativ för webbläsarflik",
1783 "27025b00be488485": "miljön",
1784 + "4391875125b7882c": "{environment} delar inte sin localhost",
1785 + "ec7a78dd403ccf6a": "Förhandsgranskningstunneln är avstängd där, så dess lokala servrar öppnas bara i den strömmade webbläsaren.",
1786 "e1ffd0532d64e52c": "Den här enheten kan inte öppna localhost-sidor",
1787 "f72cc72b321f93a5": "{reason} Du kan fortfarande använda den strömmade webbläsaren för den här fliken.",
1788 "6bf09d4b7e4ba53b": "Uppdatera T3 Code på {environment}",
apps/mobile/src/i18n/translations/zh.json
+3
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization} 的策略不允许使用 T3 Connect。",
24 "986b0873f913a840": "{organization} 的策略不允许使用 webhook 任务。",
25 "eebc538e25b09fe2": "{organization} 的策略不允许导入浏览器 Cookie。",
26 + "7642a133db05f164": "{organization} 的策略不允许在其他设备上打开此机器的本地服务器。",
27 "39f6771b49f9b3b6": "使用默认值",
28 "45bb0e90e1c42046": "在你回来后",
29 "d8fa0a55446bbb0d": "缓存过期前(测试版)",
@@ -1781,6 +1782,8 @@
1782 "9bce41be8fc55a47": "清除缓存",
1783 "4d7f5af0445371fd": "浏览器标签页选项",
1784 "27025b00be488485": "该环境",
1785 + "4391875125b7882c": "{environment} 未共享其 localhost",
1786 + "ec7a78dd403ccf6a": "那里的预览隧道已关闭,因此其本地服务器只能在串流浏览器中打开。",
1787 "e1ffd0532d64e52c": "此设备无法打开 localhost 页面",
1788 "f72cc72b321f93a5": "{reason} 你仍可以为此标签页使用流式浏览器。",
1789 "6bf09d4b7e4ba53b": "请更新 {environment} 上的 T3 Code",
apps/mobile/src/lib/filePreview.test.ts
+1
@@ -184,6 +184,7 @@ vi.mock("../state/threads", () => ({ environmentThreadShells: {}, threadEnvironm
184 vi.mock("../state/entities", () => ({
185 useLiveThreadLinkLabels: (text: string) => text,
186 useThreadChipIcons: () => new Map(),
187 + useEnvironmentPreviewTunnelOff: () => false,
188 }));
189 vi.mock("../state/use-thread-selection", () => ({
190 useThreadSelection: () => ({ selectedThread: null }),
apps/mobile/src/state/entities.ts
+7
@@ -8,6 +8,7 @@ import type {
8 EnvironmentThreadShell,
9 } from "@t3tools/client-runtime/state/shell";
10 import {
11 + allowsPreviewTunnel,
12 EnvironmentId,
13 ThreadId,
14 type ComposerContextRecord,
@@ -304,6 +305,12 @@ export function useEnvironmentServerConfig(
305 );
306 }
307
308 +/** Whether the environment turned its preview tunnel off; false until its config loads. */
309 +export function useEnvironmentPreviewTunnelOff(environmentId: EnvironmentId | null): boolean {
310 + const config = useEnvironmentServerConfig(environmentId);
311 + return config !== null && !allowsPreviewTunnel(config);
312 +}
313 +
314 export function useServerConfigs(): ReadonlyMap<EnvironmentId, ServerConfig> {
315 return useAtomValue(environmentServerConfigsAtom);
316 }
apps/server/src/environment/ServerEnvironment.ts
+1
@@ -273,6 +273,7 @@ export const make = Effect.gen(function* () {
273 serverResolvedCommandContext: true,
274 threadStop: true,
275 ...(hostPlatform === "win32" ? {} : { localServerStop: true }),
276 + previewTunnelSetting: true,
277 environmentIcon: true,
278 projectCloneTracking: true,
279 projectOrganization: true,
apps/server/src/policy/ManagedPolicy.test.ts
+7 -2
@@ -60,11 +60,16 @@ it.layer(NodeServices.layer)("ManagedPolicy.load", (it) => {
60 JSON.stringify({
61 schemaVersion: 1,
62 organization: "Example Corp",
63 - limits: { webhookTasks: false, telemetry: true },
63 + limits: { webhookTasks: false, telemetry: true, previewTunnel: false },
64 }),
65 );
66 - assert.deepEqual(policy.summary?.limits, { webhookTasks: false, telemetry: true });
66 + assert.deepEqual(policy.summary?.limits, {
67 + webhookTasks: false,
68 + telemetry: true,
69 + previewTunnel: false,
70 + });
71 assert.equal(ManagedPolicy.deniedBy(policy, "webhookTasks"), "Example Corp");
72 + assert.equal(ManagedPolicy.deniedBy(policy, "previewTunnel"), "Example Corp");
73 assert.isUndefined(ManagedPolicy.deniedBy(policy, "telemetry"));
74 }),
75 );
apps/server/src/policy/ManagedPolicy.ts
+3 -1
@@ -70,7 +70,7 @@ export const loadedPolicy = Effect.fn("ManagedPolicy.loadedPolicy")(function* (
70 */
71 export function deniedBy(
72 policy: Pick<ManagedPolicy["Service"], "document">,
73 - capability: "webhookTasks" | "telemetry",
73 + capability: "webhookTasks" | "telemetry" | "previewTunnel",
74 ): string | undefined {
75 return policy.document?.limits?.[capability] === false ? policy.document.organization : undefined;
76 }
@@ -135,6 +135,7 @@ function summarizeLimits(
135 webhookTasks,
136 telemetry,
137 browserCookieImport,
138 + previewTunnel,
139 providers,
140 updates,
141 } = document.limits ?? {};
@@ -146,6 +147,7 @@ function summarizeLimits(
147 ...(webhookTasks === undefined ? {} : { webhookTasks }),
148 ...(telemetry === undefined ? {} : { telemetry }),
149 ...(browserCookieImport === undefined ? {} : { browserCookieImport }),
150 + ...(previewTunnel === undefined ? {} : { previewTunnel }),
151 ...(providers?.allowedDrivers === undefined && Object.keys(lockedInstanceFields).length === 0
152 ? {}
153 : {
apps/server/src/policy/policyTemplates.ts
+6
@@ -119,6 +119,12 @@ const policies = (): ReadonlyArray<Policy> => [
119 help: "Disabled stops users from importing cookies from another browser into T3 Code's browser.",
120 toggle: "BrowserCookieImport",
121 },
122 + {
123 + id: "PreviewTunnel",
124 + title: "Allow the preview tunnel",
125 + help: "Disabled stops other devices from opening this machine's local servers through T3 Code: no in-app browser tabs loaded on the device, no Open on this device, no port forwarding. Browser tabs still stream from this machine.",
126 + toggle: "PreviewTunnel",
127 + },
128 {
129 id: "Telemetry",
130 title: "Allow usage data",
apps/server/src/preview/PreviewTunnel.test.ts
+113 -2
@@ -5,16 +5,23 @@ import {
5 AuthOrchestrationReadScope,
6 AuthSessionId,
7 AuthTerminalOperateScope,
8 + DEFAULT_SERVER_SETTINGS,
9 + type ManagedPolicySummary,
10 + type ServerSettings,
11 } from "@t3tools/contracts";
12 import * as NodeNet from "node:net";
13 import * as Context from "effect/Context";
14 import * as Deferred from "effect/Deferred";
15 import * as Effect from "effect/Effect";
16 import * as Layer from "effect/Layer";
17 +import * as PubSub from "effect/PubSub";
18 +import * as Ref from "effect/Ref";
19 +import * as Stream from "effect/Stream";
20 import { HttpRouter, HttpServer } from "effect/http";
21
22 import * as EnvironmentAuth from "../auth/EnvironmentAuth.ts";
23 import * as SessionStore from "../auth/SessionStore.ts";
24 +import { ServerSettingsService } from "../serverSettings.ts";
25 import * as PreviewTunnel from "./PreviewTunnel.ts";
26
27 const listen = (onConnection: (socket: NodeNet.Socket) => void) =>
@@ -40,13 +47,51 @@ const listen = (onConnection: (socket: NodeNet.Socket) => void) =>
47 ),
48 ).pipe(Effect.map(({ server }) => ({ port: (server.address() as NodeNet.AddressInfo).port })));
49
50 +/** Settings the route reads; `set` publishes a change as the real service does. */
51 +const makeSettings = Effect.fn(function* (
52 + enablePreviewTunnel = true,
53 + managedPolicy?: ManagedPolicySummary,
54 + /** Applied right after the first read, as a change landing while a tunnel dials. */
55 + afterFirstRead?: Partial<ServerSettings>,
56 +) {
57 + const current = yield* Ref.make<ServerSettings>({
58 + ...DEFAULT_SERVER_SETTINGS,
59 + enablePreviewTunnel,
60 + });
61 + const changes = yield* PubSub.unbounded<ServerSettings>();
62 + const set = (patch: Partial<ServerSettings>) =>
63 + Ref.updateAndGet(current, (settings) => ({ ...settings, ...patch })).pipe(
64 + Effect.flatMap((settings) => PubSub.publish(changes, settings)),
65 + );
66 + let pendingChange = afterFirstRead;
67 + return {
68 + set,
69 + layer: Layer.mock(ServerSettingsService, {
70 + managedPolicy,
71 + getSettings: Ref.get(current).pipe(
72 + Effect.tap(() => {
73 + const change = pendingChange;
74 + pendingChange = undefined;
75 + return change ? set(change) : Effect.void;
76 + }),
77 + ),
78 + streamChanges: Stream.fromPubSub(changes),
79 + subscribeChanges: PubSub.subscribe(changes).pipe(Effect.map(Stream.fromSubscription)),
80 + }),
81 + };
82 +});
83 +
84 /** Serves the tunnel route; `wsTicket=reader` authenticates without terminal:operate. */
44 -const serveTunnel = (sessionInvalidated: Effect.Effect<void> = Effect.never) =>
85 +const serveTunnel = (
86 + sessionInvalidated: Effect.Effect<void> = Effect.never,
87 + settings?: Layer.Layer<ServerSettingsService>,
88 +) =>
89 Effect.gen(function* () {
90 + const settingsLayer = settings ?? (yield* makeSettings()).layer;
91 const services = yield* Layer.build(
92 HttpRouter.serve(PreviewTunnel.routeLayer, { disableListenLog: true }).pipe(
93 Layer.provideMerge(NodeHttpServer.layerTest),
49 - Layer.provide(PreviewTunnel.layer),
94 + Layer.provide(PreviewTunnel.layer.pipe(Layer.provide(settingsLayer))),
95 Layer.provide(
96 Layer.mock(SessionStore.SessionStore, {
97 cookieName: "t3_session",
@@ -183,3 +228,69 @@ it.effect("closes an open tunnel when its session is revoked", () =>
228 yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
229 }),
230 );
231 +
232 +it.effect.each([
233 + { case: "the setting", enabled: false, policy: undefined },
234 + {
235 + case: "a policy, whatever the setting",
236 + enabled: true,
237 + policy: {
238 + organization: "Example Corp",
239 + lockedSettings: [],
240 + limits: { previewTunnel: false },
241 + } satisfies ManagedPolicySummary,
242 + },
243 +])("refuses every tunnel with 403 when $case turns it off", ({ enabled, policy }) =>
244 + Effect.gen(function* () {
245 + let dialled = 0;
246 + const listed = yield* listen((socket) => {
247 + dialled++;
248 + socket.destroy();
249 + });
250 + const settings = yield* makeSettings(enabled, policy);
251 + const tunnel = yield* serveTunnel(Effect.never, settings.layer);
252 + const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${listed.port}`);
253 + const status = yield* Effect.promise(
254 + () =>
255 + new Promise<{ status: number | undefined; disabled: boolean }>((resolve, reject) => {
256 + client.on("unexpected-response", (_request, response) =>
257 + resolve({
258 + status: response.statusCode,
259 + disabled:
260 + response.headers[PreviewTunnel.PREVIEW_TUNNEL_DISABLED_HEADER] !== undefined,
261 + }),
262 + );
263 + client.on("open", () => reject(new Error("tunnel opened")));
264 + client.on("error", reject);
265 + }),
266 + );
267 + expect(status).toEqual({ status: 403, disabled: true });
268 + expect(dialled).toBe(0);
269 + }),
270 +);
271 +
272 +it.effect("closes an open tunnel when the setting turns it off", () =>
273 + Effect.gen(function* () {
274 + const upstreamClosed = Promise.withResolvers<void>();
275 + const upstream = yield* listen((socket) => socket.on("close", () => upstreamClosed.resolve()));
276 + const settings = yield* makeSettings();
277 + const tunnel = yield* serveTunnel(Effect.never, settings.layer);
278 + const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${upstream.port}`);
279 + yield* Effect.promise(() => new Promise((resolve) => client.once("open", resolve)));
280 + const clientClosed = new Promise((resolve) => client.once("close", resolve));
281 + yield* settings.set({ enablePreviewTunnel: false });
282 + yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
283 + }),
284 +);
285 +
286 +it.effect("closes a tunnel the setting turns off while it is still dialling", () =>
287 + Effect.gen(function* () {
288 + const settings = yield* makeSettings(true, undefined, { enablePreviewTunnel: false });
289 + const upstreamClosed = Promise.withResolvers<void>();
290 + const upstream = yield* listen((socket) => socket.on("close", () => upstreamClosed.resolve()));
291 + const tunnel = yield* serveTunnel(Effect.never, settings.layer);
292 + const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${upstream.port}`);
293 + const clientClosed = new Promise((resolve) => client.once("close", resolve));
294 + yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
295 + }),
296 +);
apps/server/src/preview/PreviewTunnel.ts
+54 -5
@@ -2,7 +2,7 @@
2 // connection per WebSocket. Raw bytes, so pages keep their own origin, HMR sockets and TLS.
3 import * as NodeHttpServerRequest from "@effect/platform-node/NodeHttpServerRequest";
4 import * as NodeSocket from "@effect/platform-node/NodeSocket";
5 -import { AuthTerminalOperateScope } from "@t3tools/contracts";
5 +import { allowsPreviewTunnel, AuthTerminalOperateScope } from "@t3tools/contracts";
6 import type * as NodeNet from "node:net";
7 import * as Context from "effect/Context";
8 import * as Effect from "effect/Effect";
@@ -10,12 +10,14 @@ import * as Layer from "effect/Layer";
10 import * as Option from "effect/Option";
11 import * as Schema from "effect/Schema";
12 import type * as Scope from "effect/Scope";
13 +import * as Stream from "effect/Stream";
14 import { HttpRouter, HttpServerRequest, HttpServerResponse } from "effect/http";
15 import type * as Socket from "effect/socket/Socket";
16
17 import { authenticateMediaRequest } from "../auth/http.ts";
18 import * as SessionStore from "../auth/SessionStore.ts";
19 import { requestUrl } from "../requestUrl.ts";
20 +import { ServerSettingsService } from "../serverSettings.ts";
21
22 const PREVIEW_TUNNEL_ROUTE = "/api/preview/tunnel";
23 /**
@@ -23,6 +25,8 @@ const PREVIEW_TUNNEL_ROUTE = "/api/preview/tunnel";
25 * in front of the environment answering 502 because the environment is down.
26 */
27 export const PREVIEW_TUNNEL_PORT_REFUSED_HEADER = "x-t3-tunnel-port-refused";
28 +/** Marks a refusal because the tunnel is switched off here, by the setting or by policy. */
29 +export const PREVIEW_TUNNEL_DISABLED_HEADER = "x-t3-tunnel-disabled";
30
31 const CONNECT_TIMEOUT = "5 seconds";
32
@@ -35,6 +39,15 @@ export class PreviewTunnelPortRefusedError extends Schema.TaggedError<PreviewTun
39 }
40 }
41
42 +export class PreviewTunnelDisabledError extends Schema.TaggedError<PreviewTunnelDisabledError>()(
43 + "PreviewTunnelDisabledError",
44 + {},
45 +) {
46 + override get message(): string {
47 + return "The preview tunnel is turned off on this T3 Code server.";
48 + }
49 +}
50 +
51 export class PreviewTunnelConnectError extends Schema.TaggedError<PreviewTunnelConnectError>()(
52 "PreviewTunnelConnectError",
53 { port: Schema.Number, cause: Schema.Defect() },
@@ -53,13 +66,38 @@ export class PreviewTunnel extends Context.Service<
66 readonly servedPort: number | undefined;
67 }) => Effect.Effect<
68 { readonly reader: Socket.Reader; readonly writer: Socket.Writer },
56 - PreviewTunnelPortRefusedError | PreviewTunnelConnectError,
69 + PreviewTunnelDisabledError | PreviewTunnelPortRefusedError | PreviewTunnelConnectError,
70 Scope.Scope
71 >;
72 + /**
73 + * Subscribes now, before `connect` reads the setting, so a switch-off during dialling isn't
74 + * missed. The returned effect completes once the tunnel is switched off.
75 + */
76 + readonly watchTurnedOff: Effect.Effect<Effect.Effect<void>, never, Scope.Scope>;
77 }
78 >()("t3/preview/PreviewTunnel") {}
79
62 -const make = Effect.sync(() => {
80 +const make = Effect.gen(function* () {
81 + const serverSettings = yield* ServerSettingsService;
82 + const managedPolicy = serverSettings.managedPolicy;
83 + const allowedBy = (settings: { readonly enablePreviewTunnel: boolean }) =>
84 + allowsPreviewTunnel({ settings, managedPolicy });
85 + // Unreadable settings fail closed: the tunnel is raw TCP into the host.
86 + const enabled = serverSettings.getSettings.pipe(
87 + Effect.map(allowedBy),
88 + Effect.orElseSucceed(() => false),
89 + );
90 + const watchTurnedOff = serverSettings.subscribeChanges.pipe(
91 + Effect.map((changes) =>
92 + changes.pipe(
93 + Stream.filter((settings) => !allowedBy(settings)),
94 + Stream.runHead,
95 + // A change stream that ends without switching the tunnel off never does.
96 + Effect.flatMap((change) => (Option.isSome(change) ? Effect.void : Effect.never)),
97 + ),
98 + ),
99 + );
100 +
101 const dial = Effect.fnUntraced(function* (host: string, port: number) {
102 const socket = yield* NodeSocket.makeNet({ host, port, openTimeout: CONNECT_TIMEOUT });
103 return { reader: yield* socket.reader, writer: yield* socket.writer };
@@ -68,6 +106,7 @@ const make = Effect.sync(() => {
106 const connect: PreviewTunnel["Service"]["connect"] = Effect.fn("PreviewTunnel.connect")(
107 function* ({ port, servedPort }) {
108 yield* Effect.annotateCurrentSpan({ port });
109 + if (!(yield* enabled)) return yield* new PreviewTunnelDisabledError();
110 // Tunnelling to this server would hand the page an unauthenticated loopback client.
111 if (port === servedPort) {
112 return yield* new PreviewTunnelPortRefusedError({ port });
@@ -79,7 +118,7 @@ const make = Effect.sync(() => {
118 },
119 );
120
82 - return PreviewTunnel.of({ connect });
121 + return PreviewTunnel.of({ connect, watchTurnedOff });
122 });
123
124 export const layer = Layer.effect(PreviewTunnel, make);
@@ -133,23 +172,32 @@ const handler = Effect.gen(function* () {
172 const connection = NodeHttpServerRequest.toIncomingMessage(request).socket;
173 const servedPort = connection.localPort;
174 return yield* Effect.gen(function* () {
175 + const turnedOff = yield* tunnel.watchTurnedOff;
176 // Dialled before the upgrade so a dead port fails the handshake instead of an open socket.
177 const upstream = yield* tunnel.connect({ port, servedPort });
178 const client = yield* request.upgrade;
179 const clientReader = yield* client.reader;
180 const clientWriter = yield* client.writer;
181 // A tunnel is raw TCP into the host, so it closes with its session like the RPC socket.
182 + // So does switching the tunnel off.
183 yield* Effect.raceFirst(
184 Effect.raceFirst(
185 pump(upstream.reader, clientWriter, drained(connection)),
186 pump(clientReader, upstream.writer),
187 ),
147 - sessions.awaitInvalidation(session.sessionId, session.proofKeyThumbprint),
188 + Effect.raceFirst(
189 + sessions.awaitInvalidation(session.sessionId, session.proofKeyThumbprint),
190 + turnedOff,
191 + ),
192 ).pipe(Effect.ignoreCause);
193 return HttpServerResponse.empty();
194 }).pipe(
195 Effect.scoped,
196 Effect.catchTags({
197 + PreviewTunnelDisabledError: (error) =>
198 + Effect.succeed(
199 + HttpServerResponse.text(error.message, { status: 403, headers: DISABLED_HEADERS }),
200 + ),
201 PreviewTunnelPortRefusedError: (error) =>
202 Effect.succeed(
203 HttpServerResponse.text(error.message, { status: 403, headers: PORT_REFUSED_HEADERS }),
@@ -163,5 +211,6 @@ const handler = Effect.gen(function* () {
211 });
212
213 const PORT_REFUSED_HEADERS = { [PREVIEW_TUNNEL_PORT_REFUSED_HEADER]: "1" };
214 +const DISABLED_HEADERS = { [PREVIEW_TUNNEL_DISABLED_HEADER]: "1" };
215
216 export const routeLayer = HttpRouter.add("GET", PREVIEW_TUNNEL_ROUTE, handler);
apps/web/src/browser/previewRuntime.ts
+31 -3
@@ -1,6 +1,13 @@
1 import { useAtomValue } from "@effect/atom-react";
2 -import type { EnvironmentId, PreviewRuntime, PreviewSessionSnapshot } from "@t3tools/contracts";
2 +import {
3 + allowsPreviewTunnel,
4 + type EnvironmentId,
5 + type PreviewRuntime,
6 + type PreviewSessionSnapshot,
7 +} from "@t3tools/contracts";
8 +import { Atom } from "effect/reactivity";
9
10 +import { environmentCatalog } from "~/connection/catalog";
11 import { isElectron } from "~/env";
12 import { isPreviewSupportedInRuntime } from "~/previewStateStore";
13 import { appAtomRegistry } from "~/rpc/atomRegistry";
@@ -9,12 +16,27 @@ import {
16 readEnvironmentSupportsServerBrowser,
17 useEnvironmentSupportsServerBrowser,
18 } from "~/state/entities";
19 +import { environmentServerConfigsAtom } from "~/state/server";
20 +
21 +import { tunnelsEnvironmentLoopback } from "./browserTargetResolver";
22 +
23 +/** Whether this desktop loads the environment's localhost itself: it is local, or its tunnel is on. */
24 +const desktopLoadsLoopbackAtom = Atom.family((environmentId: EnvironmentId) =>
25 + Atom.make((get) => {
26 + const target = get(environmentCatalog.catalogValueAtom).entries.get(environmentId)?.target;
27 + if (!tunnelsEnvironmentLoopback(target)) return true;
28 + const config = get(environmentServerConfigsAtom).get(environmentId);
29 + return config !== undefined && allowsPreviewTunnel(config);
30 + }).pipe(Atom.withLabel(`preview:desktop-loads-loopback:${environmentId}`)),
31 +);
32
33 export function previewRuntimeFor(environmentId: EnvironmentId): PreviewRuntime | undefined {
34 if (!readEnvironmentSupportsServerBrowser(environmentId)) return undefined;
35 + // Without its tunnel, another environment's tabs stream from it, as on the web.
36 if (
37 isPreviewSupportedInRuntime() &&
17 - environmentId !== appAtomRegistry.get(primaryEnvironmentIdAtom)
38 + environmentId !== appAtomRegistry.get(primaryEnvironmentIdAtom) &&
39 + appAtomRegistry.get(desktopLoadsLoopbackAtom(environmentId))
40 ) {
41 return undefined;
42 }
@@ -25,11 +47,17 @@ export function alternatePreviewRuntime(
47 environmentId: EnvironmentId,
48 primaryEnvironmentId: EnvironmentId | null,
49 serverBrowser: boolean,
50 + desktopLoadsLoopback: boolean,
51 snapshot: Pick<PreviewSessionSnapshot, "runtime"> | null | undefined,
52 ): PreviewRuntime | null {
53 if (!snapshot || !serverBrowser || !isPreviewSupportedInRuntime()) return null;
54 if (environmentId === primaryEnvironmentId) return null;
32 - return snapshot.runtime === "server" ? "desktop" : "server";
55 + if (snapshot.runtime === "server") return desktopLoadsLoopback ? "desktop" : null;
56 + return "server";
57 +}
58 +
59 +export function useDesktopLoadsLoopback(environmentId: EnvironmentId): boolean {
60 + return useAtomValue(desktopLoadsLoopbackAtom(environmentId));
61 }
62
63 export function isPreviewAvailableFor(environmentId: EnvironmentId): boolean {
apps/web/src/components/CommandPalettePortForwardItems.tsx
+1 -2
@@ -54,8 +54,7 @@ export function useCommandPalettePortForwardItem(input: {
54 const forwards = usePortForwards();
55 const { environments } = useEnvironments();
56 const reachable = environments.filter(
57 - (environment) =>
58 - environment.connection.phase === "connected" && canForwardPorts(environment.entry.target),
57 + (environment) => environment.connection.phase === "connected" && canForwardPorts(environment),
58 );
59 const tunnelling = useEnvironmentsWithScope(reachable, AuthTerminalOperateScope);
60 const tunnelled = reachable.filter((environment) => tunnelling.has(environment.environmentId));
apps/web/src/components/chat/ThreadServersPanel.tsx
+23 -2
@@ -12,12 +12,16 @@ import {
12 isAtomCommandInterrupted,
13 squashAtomCommandFailure,
14 } from "@t3tools/client-runtime/state/runtime";
15 +import { isLoopbackHost } from "@t3tools/shared/preview";
16 import { T, useGT, Var } from "gt-react";
17 import { m } from "~/i18n/messages";
18 import { CableIcon, GlobeIcon, SquareIcon, ChevronDownIcon, ChevronUpIcon } from "lucide-react";
19 import { type MouseEvent, useState } from "react";
20
20 -import { resolveExternalServerUrl } from "../../browser/browserTargetResolver";
21 +import {
22 + resolveExternalServerUrl,
23 + tunnelsEnvironmentLoopback,
24 +} from "../../browser/browserTargetResolver";
25 import { readLocalApi } from "../../localApi";
26 import { cn, isMacPlatform } from "../../lib/utils";
27 import { useThreadDiscoveredPorts } from "../../portDiscoveryState";
@@ -69,7 +73,7 @@ function ThreadServersList(props: ThreadServersPanelProps) {
73 const forwardable =
74 useEnvironmentScope(props.environmentId, AuthTerminalOperateScope) &&
75 environment?.connection.phase === "connected" &&
72 - canForwardPorts(environment.entry.target);
76 + canForwardPorts(environment);
77 const locality = useForwardLocality(forwardable ? props.environmentId : null);
78 const canForward = locality === "remote";
79 const openPreview = useAtomCommand(previewEnvironment.open, { reportFailure: false });
@@ -113,6 +117,23 @@ function ThreadServersList(props: ThreadServersPanelProps) {
117 )
118 : resolveExternalServerUrl(props.environmentId, server.url);
119 if (url === null) return;
120 + // Without a forward, a remote environment's localhost would open this machine's instead.
121 + if (
122 + locality !== "local" &&
123 + tunnelsEnvironmentLoopback(environment?.entry.target) &&
124 + isLoopbackHost(new URL(url).hostname)
125 + ) {
126 + reportFailure(
127 + gt("Unable to open in browser"),
128 + new Error(
129 + gt(
130 + "localhost:{port} runs on another machine, and port forwarding isn't available for it right now.",
131 + { port: server.port },
132 + ),
133 + ),
134 + );
135 + return;
136 + }
137 await readLocalApi()
138 ?.shell.openExternal(url)
139 .catch((error: unknown) => reportFailure(gt("Unable to open in browser"), error));
apps/web/src/components/preview/PreviewView.tsx
+7 -1
@@ -91,7 +91,11 @@ import type { MessageResolver } from "~/i18n/messages";
91 import { revealInFileExplorerLabel } from "./fileExplorerLabel";
92 import { Badge } from "~/components/ui/badge";
93 import { BrowserSurfaceSlot } from "~/browser/BrowserSurfaceSlot";
94 -import { alternatePreviewRuntime, useRendersServerTabNatively } from "~/browser/previewRuntime";
94 +import {
95 + alternatePreviewRuntime,
96 + useDesktopLoadsLoopback,
97 + useRendersServerTabNatively,
98 +} from "~/browser/previewRuntime";
99 import { ServerBrowserSurface, type ServerBrowserHandle } from "~/browser/ServerBrowserSurface";
100 import { cn } from "~/lib/utils";
101 import { useBrowserSurfaceStore } from "~/browser/browserSurfaceStore";
@@ -205,6 +209,7 @@ export function PreviewView({
209 const environmentLabel = useEnvironment(threadRef.environmentId)?.label ?? null;
210 const primaryEnvironmentId = usePrimaryEnvironmentId();
211 const serverBrowser = useEnvironmentSupportsServerBrowser(threadRef.environmentId);
212 + const desktopLoadsLoopback = useDesktopLoadsLoopback(threadRef.environmentId);
213 const adjust = useAtomCommand(previewEnvironment.adjust, "preview appearance or zoom");
214
215 usePreviewSession(threadRef);
@@ -463,6 +468,7 @@ export function PreviewView({
468 threadRef.environmentId,
469 primaryEnvironmentId,
470 serverBrowser,
471 + desktopLoadsLoopback,
472 snapshot,
473 );
474 const moveLabel =
apps/web/src/components/settings/ConnectionsSettings.tsx
+27
@@ -13,6 +13,8 @@ import {
13 AuthEnvironmentMaintainScope,
14 AuthRelayReadScope,
15 AuthRelayWriteScope,
16 + allowsPreviewTunnel,
17 + isManagedSettingPath,
18 type AuthClientSession,
19 type AuthPairingLink,
20 type AuthPairingCredentialResult,
@@ -1255,6 +1257,12 @@ function ConnectionsSettingsContent({
1257 );
1258
1259 const accessServerConfig = accessEnvironment?.serverConfig ?? null;
1260 + const accessPolicy = accessServerConfig?.managedPolicy;
1261 + const previewTunnelDenial =
1262 + managedCapabilityDenial(accessPolicy, "previewTunnel", m) ??
1263 + (accessPolicy !== undefined && isManagedSettingPath(accessPolicy, "enablePreviewTunnel")
1264 + ? gt("Managed by {organization}.", { organization: accessPolicy.organization })
1265 + : undefined);
1266 const primarySettings = (
1267 <>
1268 {accessEnvironmentPicker}
@@ -1377,6 +1385,25 @@ function ConnectionsSettingsContent({
1385 }
1386 />
1387 ) : null}
1388 + {accessServerConfig?.environment.capabilities.previewTunnelSetting ? (
1389 + <SettingsRow
1390 + title={searchableSetting("preview-tunnel").title}
1391 + description={gt(
1392 + "Lets other devices open this machine's local servers: browser tabs loaded on the device, Open on this device, and port forwarding. Off: browser tabs stream from this machine.",
1393 + )}
1394 + managed={previewTunnelDenial}
1395 + control={
1396 + <Switch
1397 + checked={allowsPreviewTunnel(accessServerConfig)}
1398 + disabled={!canWriteAccess}
1399 + aria-label={gt("Allow the preview tunnel")}
1400 + onCheckedChange={(enabled) =>
1401 + void updateAccessSettings({ enablePreviewTunnel: enabled })
1402 + }
1403 + />
1404 + }
1405 + />
1406 + ) : null}
1407 {accessEnvironment ? (
1408 <details className="group px-3 sm:px-4">
1409 <summary className="flex min-h-11 cursor-pointer list-none items-center gap-2 rounded-md text-sm font-medium outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring [&::-webkit-details-marker]:hidden">
apps/web/src/components/settings/settingsSearch.ts
+9
@@ -1391,6 +1391,15 @@ export const SETTINGS_SEARCH_ITEMS = [
1391 searchTerms: [msg("mobile push notifications live activities cloud tunnel")],
1392 cloudOnly: true,
1393 },
1394 + {
1395 + id: "preview-tunnel",
1396 + title: msg("Preview tunnel"),
1397 + to: "/settings/access",
1398 + targetId: "connections-environment",
1399 + searchTerms: [
1400 + msg("localhost loopback port forwarding open on this device browser tabs stream security"),
1401 + ],
1402 + },
1403 {
1404 id: "connections-environment",
1405 title: msg("This machine"),
apps/web/src/i18n/translations/de.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Die Richtlinie von {organization} erlaubt T3 Connect nicht.",
24 "986b0873f913a840": "Die Richtlinie von {organization} erlaubt keine Webhook-Aufgaben.",
25 "eebc538e25b09fe2": "Die Richtlinie von {organization} erlaubt keinen Import von Browser-Cookies.",
26 + "7642a133db05f164": "Die Richtlinie von {organization} erlaubt nicht, die lokalen Server dieses Rechners auf anderen Geräten zu öffnen.",
27 "39f6771b49f9b3b6": "Standard verwenden",
28 "45bb0e90e1c42046": "Wenn du zurückkommst",
29 "d8fa0a55446bbb0d": "Bevor der Cache abläuft (Beta)",
@@ -4198,6 +4199,7 @@
4199 "075398ac562d74b0": "Agentensitzung trennen",
4200 "1d2025060ba3d1c3": "Port {port} konnte nicht weitergeleitet werden",
4201 "086ecbb6f4c2e959": "Kann nicht im Browser geöffnet werden",
4202 + "112173d046bfc910": "localhost:{port} läuft auf einem anderen Rechner, und Portweiterleitung ist dafür gerade nicht verfügbar.",
4203 "51052c00ab1ac8cc": "Vorschau kann nicht geöffnet werden",
4204 "0ccd37739f9cf2b6": "Server konnte nicht gestoppt werden",
4205 "a610a81c4061bb4c": "Server",
@@ -8006,6 +8008,8 @@
8008 "9bfddd9a835be5de": "Server",
8009 "43b545c01503eee4": "Update wiederholen",
8010 "2f015e6d5459dce9": "Auf {version} aktualisieren",
8011 + "8ebba639f92932c3": "Erlaubt anderen Geräten, die lokalen Server dieses Rechners zu öffnen: auf dem Gerät geladene Browser-Tabs, Auf diesem Gerät öffnen und Portweiterleitung. Aus: Browser-Tabs werden von diesem Rechner gestreamt.",
8012 + "1c5266bf18d0ed24": "Vorschau-Tunnel erlauben",
8013 "a0e93cca71d0417e": "Autorisierte Clients",
8014 "03b9501ae07b5cf3": "Netzwerkzugriff aktivieren?",
8015 "a09aff32ef3d89c7": "Netzwerkzugriff deaktivieren?",
@@ -11630,6 +11634,8 @@
11634 "b5cd79513a06e7c3": "Webhooks offline zurückhalten",
11635 "fadd0fcd7b9e1651": "webhook automatisierungen offline warteschlange postfach t3 connect",
11636 "9bebacdcfbde18d4": "mobil push-benachrichtigungen live-aktivitäten cloud tunnel",
11637 + "a4e6dee662edc3cf": "Vorschau-Tunnel",
11638 + "8ed7c2a2226f4663": "localhost loopback portweiterleitung auf diesem gerät öffnen browser tabs streamen sicherheit port forwarding",
11639 "1c3e0ac06c8a1f1e": "verbindungen server backend lokal remote zugriff administrativ berechtigungen bereich kopplungslinks qr-code autorisierte clients sitzungen widerrufen endpunkt",
11640 "744fd34e8049efeb": "verknüpfen peer anderer rechner vps agenten dort arbeiten übergabe kopplungscode",
11641 "3d00c452287f50bd": "hinzufügen koppeln backend host code ssh konfiguration agent tunnel gespeichert t3 connect",
apps/web/src/i18n/translations/en.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization}'s policy does not allow T3 Connect.",
24 "986b0873f913a840": "{organization}'s policy does not allow webhook tasks.",
25 "eebc538e25b09fe2": "{organization}'s policy does not allow importing browser cookies.",
26 + "7642a133db05f164": "{organization}'s policy does not allow opening this machine's local servers on other devices.",
27 "39f6771b49f9b3b6": "Use default",
28 "45bb0e90e1c42046": "When you return",
29 "d8fa0a55446bbb0d": "Before the cache expires (beta)",
@@ -4197,6 +4198,7 @@
4198 "075398ac562d74b0": "Disconnect agent session",
4199 "1d2025060ba3d1c3": "Could not forward port {port}",
4200 "086ecbb6f4c2e959": "Unable to open in browser",
4201 + "112173d046bfc910": "localhost:{port} runs on another machine, and port forwarding isn't available for it right now.",
4202 "51052c00ab1ac8cc": "Unable to open preview",
4203 "0ccd37739f9cf2b6": "Could not stop server",
4204 "a610a81c4061bb4c": "Servers",
@@ -8013,6 +8015,8 @@
8015 "9bfddd9a835be5de": "server",
8016 "43b545c01503eee4": "Retry update",
8017 "2f015e6d5459dce9": "Update to {version}",
8018 + "8ebba639f92932c3": "Lets other devices open this machine's local servers: browser tabs loaded on the device, Open on this device, and port forwarding. Off: browser tabs stream from this machine.",
8019 + "1c5266bf18d0ed24": "Allow the preview tunnel",
8020 "a0e93cca71d0417e": "Authorized clients",
8021 "03b9501ae07b5cf3": "Enable network access?",
8022 "a09aff32ef3d89c7": "Disable network access?",
@@ -11638,6 +11642,8 @@
11642 "b5cd79513a06e7c3": "Hold webhooks while offline",
11643 "fadd0fcd7b9e1651": "webhook automations offline queue mailbox t3 connect",
11644 "9bebacdcfbde18d4": "mobile push notifications live activities cloud tunnel",
11645 + "a4e6dee662edc3cf": "Preview tunnel",
11646 + "8ed7c2a2226f4663": "localhost loopback port forwarding open on this device browser tabs stream security",
11647 "1c3e0ac06c8a1f1e": "connections server backend local remote access administrative permissions scope pairing links qr code authorized clients sessions revoke endpoint",
11648 "744fd34e8049efeb": "link peer another machine vps agents work there handoff pairing code",
11649 "3d00c452287f50bd": "add pair backend host code ssh config agent tunnel saved t3 connect",
apps/web/src/i18n/translations/es.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "La política de {organization} no permite T3 Connect.",
24 "986b0873f913a840": "La política de {organization} no permite tareas de webhook.",
25 "eebc538e25b09fe2": "La política de {organization} no permite importar cookies del navegador.",
26 + "7642a133db05f164": "La política de {organization} no permite abrir los servidores locales de esta máquina en otros dispositivos.",
27 "39f6771b49f9b3b6": "Usar valor predeterminado",
28 "45bb0e90e1c42046": "Cuando vuelvas",
29 "d8fa0a55446bbb0d": "Antes de que caduque la caché (beta)",
@@ -4195,6 +4196,7 @@
4196 "075398ac562d74b0": "Desconectar la sesión del agente",
4197 "1d2025060ba3d1c3": "No se pudo reenviar el puerto {port}",
4198 "086ecbb6f4c2e959": "No se puede abrir en el navegador",
4199 + "112173d046bfc910": "localhost:{port} se ejecuta en otro equipo y el reenvío de puertos no está disponible para él ahora.",
4200 "51052c00ab1ac8cc": "No se puede abrir la vista previa",
4201 "0ccd37739f9cf2b6": "No se pudo detener el servidor",
4202 "a610a81c4061bb4c": "Servidores",
@@ -8005,6 +8007,8 @@
8007 "9bfddd9a835be5de": "servidor",
8008 "43b545c01503eee4": "Reintentar actualización",
8009 "2f015e6d5459dce9": "Actualizar a {version}",
8010 + "8ebba639f92932c3": "Permite que otros dispositivos abran los servidores locales de esta máquina: pestañas del navegador cargadas en el dispositivo, Abrir en este dispositivo y reenvío de puertos. Desactivado: las pestañas del navegador se transmiten desde esta máquina.",
8011 + "1c5266bf18d0ed24": "Permitir el túnel de vista previa",
8012 "a0e93cca71d0417e": "Clientes autorizados",
8013 "03b9501ae07b5cf3": "¿Activar el acceso a la red?",
8014 "a09aff32ef3d89c7": "¿Desactivar el acceso a la red?",
@@ -11623,6 +11627,8 @@
11627 "b5cd79513a06e7c3": "Retener webhooks sin conexión",
11628 "fadd0fcd7b9e1651": "webhook automatizaciones sin conexión cola buzón t3 connect",
11629 "9bebacdcfbde18d4": "móvil notificaciones push actividades en directo live activities nube túnel",
11630 + "a4e6dee662edc3cf": "Túnel de vista previa",
11631 + "8ed7c2a2226f4663": "localhost loopback reenvío de puertos abrir en este dispositivo pestañas navegador transmitir seguridad port forwarding",
11632 "1c3e0ac06c8a1f1e": "conexiones servidor backend local remoto acceso administrativo permisos ámbito enlaces de emparejamiento código qr clientes autorizados sesiones revocar endpoint",
11633 "744fd34e8049efeb": "vincular par otra máquina vps agentes trabajar allí traspaso código de emparejamiento",
11634 "3d00c452287f50bd": "añadir emparejar backend host código ssh config agente túnel guardado t3 connect",
apps/web/src/i18n/translations/fr.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "La politique de {organization} n’autorise pas T3 Connect.",
24 "986b0873f913a840": "La politique de {organization} n’autorise pas les tâches webhook.",
25 "eebc538e25b09fe2": "La politique de {organization} n’autorise pas l’import des cookies du navigateur.",
26 + "7642a133db05f164": "La stratégie de {organization} n’autorise pas l’ouverture des serveurs locaux de cette machine sur d’autres appareils.",
27 "39f6771b49f9b3b6": "Utiliser la valeur par défaut",
28 "45bb0e90e1c42046": "À votre retour",
29 "d8fa0a55446bbb0d": "Avant l’expiration du cache (bêta)",
@@ -4196,6 +4197,7 @@
4197 "075398ac562d74b0": "Déconnecter la session de l’agent",
4198 "1d2025060ba3d1c3": "Impossible de rediriger le port {port}",
4199 "086ecbb6f4c2e959": "Impossible d’ouvrir dans le navigateur",
4200 + "112173d046bfc910": "localhost:{port} tourne sur une autre machine, et la redirection de ports n’est pas disponible pour elle pour le moment.",
4201 "51052c00ab1ac8cc": "Impossible d’ouvrir l’aperçu",
4202 "0ccd37739f9cf2b6": "Impossible d’arrêter le serveur",
4203 "a610a81c4061bb4c": "Serveurs",
@@ -8006,6 +8008,8 @@
8008 "9bfddd9a835be5de": "serveur",
8009 "43b545c01503eee4": "Réessayer la mise à jour",
8010 "2f015e6d5459dce9": "Mettre à jour vers {version}",
8011 + "8ebba639f92932c3": "Permet à d’autres appareils d’ouvrir les serveurs locaux de cette machine : onglets de navigateur chargés sur l’appareil, Ouvrir sur cet appareil et redirection de ports. Désactivé : les onglets du navigateur sont diffusés depuis cette machine.",
8012 + "1c5266bf18d0ed24": "Autoriser le tunnel d’aperçu",
8013 "a0e93cca71d0417e": "Clients autorisés",
8014 "03b9501ae07b5cf3": "Activer l’accès réseau ?",
8015 "a09aff32ef3d89c7": "Désactiver l’accès réseau ?",
@@ -11628,6 +11632,8 @@
11632 "b5cd79513a06e7c3": "Conserver les webhooks hors ligne",
11633 "fadd0fcd7b9e1651": "webhook automatisations file d’attente hors ligne boîte aux lettres t3 connect",
11634 "9bebacdcfbde18d4": "mobile notifications push live activities tunnel cloud",
11635 + "a4e6dee662edc3cf": "Tunnel d’aperçu",
11636 + "8ed7c2a2226f4663": "localhost loopback redirection de ports ouvrir sur cet appareil onglets navigateur diffusion sécurité port forwarding",
11637 "1c3e0ac06c8a1f1e": "connexions serveur backend local accès distant autorisations administratives portée liens d’appairage code qr clients autorisés sessions révoquer point de terminaison",
11638 "744fd34e8049efeb": "associer pair autre machine vps agents y travaillent transfert code d’appairage",
11639 "3d00c452287f50bd": "ajouter appairer backend hôte code ssh config agent tunnel enregistré t3 connect",
apps/web/src/i18n/translations/ja.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization} のポリシーでは、T3 Connect は許可されていません。",
24 "986b0873f913a840": "{organization} のポリシーでは、Webhook タスクは許可されていません。",
25 "eebc538e25b09fe2": "{organization} のポリシーでは、ブラウザーの Cookie のインポートは許可されていません。",
26 + "7642a133db05f164": "{organization} のポリシーでは、このマシンのローカルサーバーを他のデバイスで開くことは許可されていません。",
27 "39f6771b49f9b3b6": "デフォルトを使用",
28 "45bb0e90e1c42046": "戻ってきたとき",
29 "d8fa0a55446bbb0d": "キャッシュの期限切れ前 (ベータ)",
@@ -4186,6 +4187,7 @@
4187 "075398ac562d74b0": "エージェントのセッションを切断",
4188 "1d2025060ba3d1c3": "ポート {port} を転送できませんでした",
4189 "086ecbb6f4c2e959": "ブラウザーで開けません",
4190 + "112173d046bfc910": "localhost:{port} は別のマシンで動いており、現在このポートは転送できません。",
4191 "51052c00ab1ac8cc": "プレビューを開けません",
4192 "0ccd37739f9cf2b6": "サーバーを停止できませんでした",
4193 "a610a81c4061bb4c": "サーバー",
@@ -7966,6 +7968,8 @@
7968 "9bfddd9a835be5de": "サーバー",
7969 "43b545c01503eee4": "更新を再試行",
7970 "2f015e6d5459dce9": "{version} に更新",
7971 + "8ebba639f92932c3": "他のデバイスがこのマシンのローカルサーバーを開けるようにします:デバイス上で読み込むブラウザタブ、「このデバイスで開く」、ポートフォワーディング。オフ:ブラウザタブはこのマシンからストリーミングされます。",
7972 + "1c5266bf18d0ed24": "プレビュートンネルを許可",
7973 "a0e93cca71d0417e": "承認済みクライアント",
7974 "03b9501ae07b5cf3": "ネットワークアクセスを有効にしますか?",
7975 "a09aff32ef3d89c7": "ネットワークアクセスを無効にしますか?",
@@ -11578,6 +11582,8 @@
11582 "b5cd79513a06e7c3": "オフライン中の Webhook を保持",
11583 "fadd0fcd7b9e1651": "Webhook オートメーション オフライン キュー メールボックス T3 Connect webhook",
11584 "9bebacdcfbde18d4": "モバイル プッシュ通知 ライブアクティビティ クラウド トンネル push",
11585 + "a4e6dee662edc3cf": "プレビュートンネル",
11586 + "8ed7c2a2226f4663": "localhost ループバック ポートフォワーディング このデバイスで開く ブラウザ タブ ストリーミング セキュリティ port forwarding",
11587 "1c3e0ac06c8a1f1e": "接続 サーバー バックエンド ローカル リモート アクセス 管理者 権限 スコープ ペアリングリンク QR コード 認可済みクライアント セッション 取り消し エンドポイント connections",
11588 "744fd34e8049efeb": "リンク ピア 別のマシン VPS エージェント そこで作業 引き継ぎ ペアリングコード link machine",
11589 "3d00c452287f50bd": "追加 ペアリング バックエンド ホスト コード SSH 構成 エージェント トンネル 保存済み T3 Connect add pair",
apps/web/src/i18n/translations/ko.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization}의 정책상 T3 Connect를 사용할 수 없습니다.",
24 "986b0873f913a840": "{organization}의 정책상 웹후크 작업을 사용할 수 없습니다.",
25 "eebc538e25b09fe2": "{organization}의 정책상 브라우저 쿠키를 가져올 수 없습니다.",
26 + "7642a133db05f164": "{organization}의 정책은 이 컴퓨터의 로컬 서버를 다른 기기에서 여는 것을 허용하지 않습니다.",
27 "39f6771b49f9b3b6": "기본값 사용",
28 "45bb0e90e1c42046": "돌아왔을 때",
29 "d8fa0a55446bbb0d": "캐시가 만료되기 전(베타)",
@@ -4183,6 +4184,7 @@
4184 "075398ac562d74b0": "에이전트 세션 연결 끊기",
4185 "1d2025060ba3d1c3": "포트 {port}을(를) 포워딩할 수 없습니다",
4186 "086ecbb6f4c2e959": "브라우저에서 열 수 없습니다",
4187 + "112173d046bfc910": "localhost:{port}는 다른 컴퓨터에서 실행 중이며, 지금은 포트 포워딩을 사용할 수 없습니다.",
4188 "51052c00ab1ac8cc": "미리 보기를 열 수 없습니다",
4189 "0ccd37739f9cf2b6": "서버를 중지할 수 없습니다",
4190 "a610a81c4061bb4c": "서버",
@@ -7968,6 +7970,8 @@
7970 "9bfddd9a835be5de": "서버",
7971 "43b545c01503eee4": "업데이트 다시 시도",
7972 "2f015e6d5459dce9": "{version}(으)로 업데이트",
7973 + "8ebba639f92932c3": "다른 기기에서 이 컴퓨터의 로컬 서버를 열 수 있게 합니다: 기기에서 불러오는 브라우저 탭, 이 기기에서 열기, 포트 포워딩. 끄면 브라우저 탭이 이 컴퓨터에서 스트리밍됩니다.",
7974 + "1c5266bf18d0ed24": "미리보기 터널 허용",
7975 "a0e93cca71d0417e": "승인된 클라이언트",
7976 "03b9501ae07b5cf3": "네트워크 액세스를 켤까요?",
7977 "a09aff32ef3d89c7": "네트워크 액세스를 끌까요?",
@@ -11575,6 +11579,8 @@
11579 "b5cd79513a06e7c3": "오프라인 동안 웹후크 보관",
11580 "fadd0fcd7b9e1651": "웹후크 자동화 오프라인 대기열 메일함 T3 Connect",
11581 "9bebacdcfbde18d4": "모바일 푸시 알림 실시간 현황 클라우드 터널",
11582 + "a4e6dee662edc3cf": "미리보기 터널",
11583 + "8ed7c2a2226f4663": "localhost 루프백 포트 포워딩 이 기기에서 열기 브라우저 탭 스트리밍 보안 port forwarding",
11584 "1c3e0ac06c8a1f1e": "연결 서버 백엔드 로컬 원격 액세스 관리 권한 범위 페어링 링크 QR 코드 인증된 클라이언트 세션 취소 엔드포인트",
11585 "744fd34e8049efeb": "다른 머신 연결 피어 vps 에이전트 원격 작업 넘기기 페어링 코드",
11586 "3d00c452287f50bd": "추가 페어링 백엔드 호스트 코드 ssh 구성 에이전트 터널 저장됨 T3 Connect",
apps/web/src/i18n/translations/pt-BR.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "A política de {organization} não permite o T3 Connect.",
24 "986b0873f913a840": "A política de {organization} não permite tarefas de webhook.",
25 "eebc538e25b09fe2": "A política de {organization} não permite importar cookies do navegador.",
26 + "7642a133db05f164": "A política de {organization} não permite abrir os servidores locais desta máquina em outros dispositivos.",
27 "39f6771b49f9b3b6": "Usar padrão",
28 "45bb0e90e1c42046": "Quando você voltar",
29 "d8fa0a55446bbb0d": "Antes de o cache expirar (beta)",
@@ -4195,6 +4196,7 @@
4196 "075398ac562d74b0": "Desconectar a sessão do agente",
4197 "1d2025060ba3d1c3": "Não foi possível encaminhar a porta {port}",
4198 "086ecbb6f4c2e959": "Não foi possível abrir no navegador",
4199 + "112173d046bfc910": "localhost:{port} roda em outra máquina, e o encaminhamento de portas não está disponível para ela agora.",
4200 "51052c00ab1ac8cc": "Não foi possível abrir a pré-visualização",
4201 "0ccd37739f9cf2b6": "Não foi possível parar o servidor",
4202 "a610a81c4061bb4c": "Servidores",
@@ -8005,6 +8007,8 @@
8007 "9bfddd9a835be5de": "servidor",
8008 "43b545c01503eee4": "Tentar atualizar novamente",
8009 "2f015e6d5459dce9": "Atualizar para {version}",
8010 + "8ebba639f92932c3": "Permite que outros dispositivos abram os servidores locais desta máquina: abas do navegador carregadas no dispositivo, Abrir neste dispositivo e encaminhamento de portas. Desativado: as abas do navegador são transmitidas desta máquina.",
8011 + "1c5266bf18d0ed24": "Permitir o túnel de pré-visualização",
8012 "a0e93cca71d0417e": "Clientes autorizados",
8013 "03b9501ae07b5cf3": "Ativar o acesso à rede?",
8014 "a09aff32ef3d89c7": "Desativar o acesso à rede?",
@@ -11627,6 +11631,8 @@
11631 "b5cd79513a06e7c3": "Reter webhooks enquanto offline",
11632 "fadd0fcd7b9e1651": "webhook automações offline fila caixa de correio t3 connect",
11633 "9bebacdcfbde18d4": "celular notificações push live activities nuvem túnel",
11634 + "a4e6dee662edc3cf": "Túnel de pré-visualização",
11635 + "8ed7c2a2226f4663": "localhost loopback encaminhamento de portas abrir neste dispositivo abas navegador transmitir segurança port forwarding",
11636 "1c3e0ac06c8a1f1e": "conexões servidor backend local remoto acesso administrativo permissões escopo links de pareamento código qr clientes autorizados sessões revogar endpoint",
11637 "744fd34e8049efeb": "vincular par outra máquina vps agentes trabalham lá transferir código de pareamento",
11638 "3d00c452287f50bd": "adicionar parear backend host código ssh config agente túnel salvo t3 connect",
apps/web/src/i18n/translations/ru.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Политика {organization} запрещает T3 Connect.",
24 "986b0873f913a840": "Политика {organization} запрещает задачи по вебхуку.",
25 "eebc538e25b09fe2": "Политика {organization} запрещает импорт cookie браузера.",
26 + "7642a133db05f164": "Политика {organization} не разрешает открывать локальные серверы этого компьютера на других устройствах.",
27 "39f6771b49f9b3b6": "По умолчанию",
28 "45bb0e90e1c42046": "Когда вы вернётесь",
29 "d8fa0a55446bbb0d": "До истечения кеша (бета)",
@@ -4195,6 +4196,7 @@
4196 "075398ac562d74b0": "Отключить сеанс агента",
4197 "1d2025060ba3d1c3": "Не удалось перенаправить порт {port}",
4198 "086ecbb6f4c2e959": "Не удалось открыть в браузере",
4199 + "112173d046bfc910": "localhost:{port} работает на другом компьютере, и перенаправление портов для него сейчас недоступно.",
4200 "51052c00ab1ac8cc": "Не удалось открыть предпросмотр",
4201 "0ccd37739f9cf2b6": "Не удалось остановить сервер",
4202 "a610a81c4061bb4c": "Серверы",
@@ -8005,6 +8007,8 @@
8007 "9bfddd9a835be5de": "сервер",
8008 "43b545c01503eee4": "Повторить обновление",
8009 "2f015e6d5459dce9": "Обновить до {version}",
8010 + "8ebba639f92932c3": "Позволяет другим устройствам открывать локальные серверы этого компьютера: вкладки браузера, загружаемые на устройстве, «Открыть на этом устройстве» и перенаправление портов. Выключено: вкладки браузера транслируются с этого компьютера.",
8011 + "1c5266bf18d0ed24": "Разрешить туннель предпросмотра",
8012 "a0e93cca71d0417e": "Авторизованные клиенты",
8013 "03b9501ae07b5cf3": "Включить сетевой доступ?",
8014 "a09aff32ef3d89c7": "Отключить сетевой доступ?",
@@ -11628,6 +11632,8 @@
11632 "b5cd79513a06e7c3": "Удерживать вебхуки в офлайне",
11633 "fadd0fcd7b9e1651": "вебхук автоматизации офлайн очередь почтовый ящик t3 connect",
11634 "9bebacdcfbde18d4": "мобильные push-уведомления live activities облако туннель",
11635 + "a4e6dee662edc3cf": "Туннель предпросмотра",
11636 + "8ed7c2a2226f4663": "localhost loopback перенаправление портов открыть на этом устройстве вкладки браузер трансляция безопасность port forwarding",
11637 "1c3e0ac06c8a1f1e": "подключения сервер бэкенд локальный удалённый доступ административные разрешения область ссылки сопряжения qr-код авторизованные клиенты сеансы отозвать конечная точка",
11638 "744fd34e8049efeb": "привязать другой компьютер vps агенты работают там передача код сопряжения",
11639 "3d00c452287f50bd": "добавить сопряжение бэкенд хост код ssh конфигурация агент туннель сохранённые t3 connect",
apps/web/src/i18n/translations/sv.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "Policyn för {organization} tillåter inte T3 Connect.",
24 "986b0873f913a840": "Policyn för {organization} tillåter inte webhook-uppgifter.",
25 "eebc538e25b09fe2": "Policyn för {organization} tillåter inte import av cookies från webbläsare.",
26 + "7642a133db05f164": "{organization}s policy tillåter inte att den här datorns lokala servrar öppnas på andra enheter.",
27 "39f6771b49f9b3b6": "Använd standard",
28 "45bb0e90e1c42046": "När du kommer tillbaka",
29 "d8fa0a55446bbb0d": "Innan cachen går ut (beta)",
@@ -4196,6 +4197,7 @@
4197 "075398ac562d74b0": "Koppla från agentsession",
4198 "1d2025060ba3d1c3": "Kunde inte vidarebefordra port {port}",
4199 "086ecbb6f4c2e959": "Det gick inte att öppna i webbläsaren",
4200 + "112173d046bfc910": "localhost:{port} körs på en annan dator, och portvidarebefordring är inte tillgänglig för den just nu.",
4201 "51052c00ab1ac8cc": "Det gick inte att öppna förhandsvisningen",
4202 "0ccd37739f9cf2b6": "Kunde inte stoppa servern",
4203 "a610a81c4061bb4c": "Servrar",
@@ -8011,6 +8013,8 @@
8013 "9bfddd9a835be5de": "server",
8014 "43b545c01503eee4": "Försök uppdatera igen",
8015 "2f015e6d5459dce9": "Uppdatera till {version}",
8016 + "8ebba639f92932c3": "Låter andra enheter öppna den här datorns lokala servrar: webbläsarflikar som läses in på enheten, Öppna på den här enheten och portvidarebefordran. Av: webbläsarflikar strömmas från den här datorn.",
8017 + "1c5266bf18d0ed24": "Tillåt förhandsgranskningstunneln",
8018 "a0e93cca71d0417e": "Auktoriserade klienter",
8019 "03b9501ae07b5cf3": "Aktivera nätverksåtkomst?",
8020 "a09aff32ef3d89c7": "Inaktivera nätverksåtkomst?",
@@ -11636,6 +11640,8 @@
11640 "b5cd79513a06e7c3": "Håll kvar webhooks i offlineläge",
11641 "fadd0fcd7b9e1651": "webhook automatiseringar offline kö brevlåda t3 connect",
11642 "9bebacdcfbde18d4": "mobil pushaviseringar liveaktiviteter live activities moln tunnel",
11643 + "a4e6dee662edc3cf": "Förhandsgranskningstunnel",
11644 + "8ed7c2a2226f4663": "localhost loopback portvidarebefordran öppna på den här enheten webbläsarflikar strömma säkerhet port forwarding",
11645 "1c3e0ac06c8a1f1e": "anslutningar server backend lokal fjärråtkomst administrativa behörigheter omfång parkopplingslänkar qr-kod auktoriserade klienter sessioner återkalla slutpunkt",
11646 "744fd34e8049efeb": "länka peer annan dator vps agenter arbetar där överlämning parkopplingskod",
11647 "3d00c452287f50bd": "lägg till parkoppla backend värd kod ssh-konfiguration agent tunnel sparad t3 connect",
apps/web/src/i18n/translations/zh.json
+6
@@ -23,6 +23,7 @@
23 "ef9533bcc048f17b": "{organization} 的策略不允许使用 T3 Connect。",
24 "986b0873f913a840": "{organization} 的策略不允许使用 webhook 任务。",
25 "eebc538e25b09fe2": "{organization} 的策略不允许导入浏览器 Cookie。",
26 + "7642a133db05f164": "{organization} 的策略不允许在其他设备上打开此机器的本地服务器。",
27 "39f6771b49f9b3b6": "使用默认值",
28 "45bb0e90e1c42046": "在你回来后",
29 "d8fa0a55446bbb0d": "缓存过期前(测试版)",
@@ -4202,6 +4203,7 @@
4203 "075398ac562d74b0": "断开智能体会话",
4204 "1d2025060ba3d1c3": "无法转发端口 {port}",
4205 "086ecbb6f4c2e959": "无法在浏览器中打开",
4206 + "112173d046bfc910": "localhost:{port} 运行在另一台机器上,目前无法为它转发端口。",
4207 "51052c00ab1ac8cc": "无法打开预览",
4208 "0ccd37739f9cf2b6": "无法停止服务器",
4209 "a610a81c4061bb4c": "服务器",
@@ -8024,6 +8026,8 @@
8026 "9bfddd9a835be5de": "服务器",
8027 "43b545c01503eee4": "重试更新",
8028 "2f015e6d5459dce9": "更新到 {version}",
8029 + "8ebba639f92932c3": "允许其他设备打开此机器的本地服务器:在设备上加载的浏览器标签页、“在此设备上打开”以及端口转发。关闭后:浏览器标签页从此机器串流。",
8030 + "1c5266bf18d0ed24": "允许预览隧道",
8031 "a0e93cca71d0417e": "已授权的客户端",
8032 "03b9501ae07b5cf3": "启用网络访问?",
8033 "a09aff32ef3d89c7": "停用网络访问?",
@@ -11652,6 +11656,8 @@
11656 "b5cd79513a06e7c3": "离线时保留 webhook",
11657 "fadd0fcd7b9e1651": "webhook 自动化 离线 队列 邮箱 t3 connect",
11658 "9bebacdcfbde18d4": "移动 推送通知 实时活动 云 隧道",
11659 + "a4e6dee662edc3cf": "预览隧道",
11660 + "8ed7c2a2226f4663": "localhost 回环 端口转发 在此设备上打开 浏览器 标签页 串流 安全 port forwarding",
11661 "1c3e0ac06c8a1f1e": "连接 服务器 后端 本地 远程 访问 管理员 权限 范围 配对链接 二维码 已授权的客户端 客户端连接 撤销 端点",
11662 "744fd34e8049efeb": "关联 对等 另一台机器 vps 智能体 在那里工作 移交 配对码",
11663 "3d00c452287f50bd": "添加 配对 后端 主机 代码 ssh 配置 认证代理 隧道 已保存 t3 connect",
apps/web/src/state/portForwards.ts
+14 -4
@@ -1,5 +1,9 @@
1 import { useAtomValue } from "@effect/atom-react";
2 -import type { DesktopPortForward, EnvironmentId } from "@t3tools/contracts";
2 +import {
3 + allowsPreviewTunnel,
4 + type DesktopPortForward,
5 + type EnvironmentId,
6 +} from "@t3tools/contracts";
7 import * as Effect from "effect/Effect";
8 import * as Option from "effect/Option";
9 import * as Queue from "effect/Queue";
@@ -49,9 +53,15 @@ export function usePortForwards(): ReadonlyArray<DesktopPortForward> {
53 return AsyncResult.getOrElse(useAtomValue(portForwardsAtom), () => EMPTY_FORWARDS);
54 }
55
52 -/** Only the desktop app forwards, and only from environments it reaches through the tunnel. */
53 -export const canForwardPorts = (target: ConnectionTarget | undefined): boolean =>
54 - previewBridge() !== undefined && tunnelsEnvironmentLoopback(target);
56 +/** Only the desktop app forwards, and only from environments whose tunnel it may use. */
57 +export const canForwardPorts = (environment: {
58 + readonly entry: { readonly target: ConnectionTarget };
59 + readonly serverConfig: Parameters<typeof allowsPreviewTunnel>[0] | null;
60 +}): boolean =>
61 + previewBridge() !== undefined &&
62 + tunnelsEnvironmentLoopback(environment.entry.target) &&
63 + environment.serverConfig !== null &&
64 + allowsPreviewTunnel(environment.serverConfig);
65
66 /**
67 * Whether the environment runs on another machine. A saved route can still lead back to this
docs/internals/remote.md
+3
@@ -181,6 +181,9 @@ undo by accident:
181 up in `/proc/net/tcp` and refuses other users. macOS and Windows have no such check yet. The
182 mobile app's device preview has the same listener while it is open: iOS suspends other apps, but
183 Android lets any app reach it, and apps cannot see another app's socket owner there.
184 +- **Off stays routed.** `allowsPreviewTunnel` (setting plus policy) gates the route and, from
185 + server config, the clients, which then stream. The partition keeps its tunnel proxy anyway, so a
186 + desktop tab left open fails instead of loading the reviewer's own localhost.
187 - **System browser links** have no tunnel. They keep the private-network rewrite in
188 [`browserTargetResolver.ts`](../../apps/web/src/browser/browserTargetResolver.ts).
189
docs/user/managed-policy.md
+5
@@ -169,6 +169,7 @@ A few settings need care:
169 "connect": false,
170 "webhookTasks": false,
171 "browserCookieImport": false,
172 + "previewTunnel": false,
173 "telemetry": false,
174 "providers": {
175 "allowedDrivers": ["claudeAgent", "codex"],
@@ -250,6 +251,10 @@ so restart T3 Code after that.
251 but do not run, and cannot be turned back on. Users can still edit or delete them.
252 - `browserCookieImport: false`: users cannot import cookies from another browser into T3 Code's
253 browser.
254 +- `previewTunnel: false`: other devices cannot load this machine's `localhost` pages themselves.
255 + Browser tabs stream from it instead, and port forwarding and **Open on this device** are
256 + unavailable. This wins over the user's
257 + [Preview tunnel setting](./remote-access.md#browser-on-a-remote-environment).
258 - `telemetry: false`: the server and desktop app send no [product usage data](./telemetry.md) or
259 relay connection traces. A policy cannot turn them on. A browser that opens the server, such as
260 app.t3.codes, still sends its own relay traces.
docs/user/remote-access.md
+8
@@ -330,6 +330,14 @@ and site data on the phone. On iPhone and iPad the page runs under a stand-in
330 address while the address bar shows `localhost`, so browser features that need
331 a secure page, such as the clipboard or service workers, aren't available there.
332
333 +All of this rides the host's preview tunnel. Turn off **Settings → Sharing &
334 +access → Preview tunnel** on the host to stop other devices from loading its
335 +`localhost` pages themselves: port forwarding and **Open on this device** go
336 +away, and open tunnels close. Tabs keep working by streaming from the host, so
337 +anyone who can use the host's browser tabs can still view its `localhost` pages
338 +there. An administrator can also turn it off with a
339 +[managed policy](./managed-policy.md#other-capabilities).
340 +
341 The first tab downloads a headless Chrome, about 120 MB, into the T3 home. It
342 is the same browser [HTML renders](html-renders.md) use, so a host downloads it
343 only once. Some Linux hosts need [setup](#browser-host-setup) before it can
packages/client-runtime/src/contractLabels.ts
+9 -1
@@ -129,7 +129,8 @@ export type ManagedCapability =
129 | "remoteClients"
130 | "connect"
131 | "webhookTasks"
132 - | "browserCookieImport";
132 + | "browserCookieImport"
133 + | "previewTunnel";
134
135 function managedCapabilityDeniedMessage(
136 organization: string,
@@ -155,6 +156,13 @@ function managedCapabilityDeniedMessage(
156 organization,
157 }),
158 );
159 + case "previewTunnel":
160 + return resolve(
161 + msg(
162 + "{organization}'s policy does not allow opening this machine's local servers on other devices.",
163 + { organization },
164 + ),
165 + );
166 }
167 }
168
packages/contracts/src/environment.ts
+2
@@ -146,6 +146,8 @@ export const ExecutionEnvironmentCapabilities = Schema.Struct({
146 threadStop: Schema.optionalKey(Schema.Boolean),
147 /** Absent on older servers and on Windows hosts, which cannot stop a discovered server. */
148 localServerStop: Schema.optionalKey(Schema.Boolean),
149 + /** Honors `enablePreviewTunnel`; hide the switch where absent, since the tunnel stays on there. */
150 + previewTunnelSetting: Schema.optionalKey(Schema.Boolean),
151 threadPullRequests: Schema.optionalKey(Schema.Boolean),
152 threadPullRequestWatch: Schema.optionalKey(Schema.Boolean),
153 pullRequestStackActions: Schema.optionalKey(Schema.Boolean),
packages/contracts/src/managedPolicy.ts
+14
@@ -81,6 +81,8 @@ export const ManagedPolicyLimits = Schema.Struct({
81 /** Can only turn product analytics off, never force it on. */
82 telemetry: Schema.optionalKey(Schema.Boolean),
83 browserCookieImport: Schema.optionalKey(Schema.Boolean),
84 + /** `false` turns the preview tunnel off: no client reaches this machine's loopback ports. */
85 + previewTunnel: Schema.optionalKey(Schema.Boolean),
86 providers: Schema.optionalKey(ManagedProviderLimits),
87 updates: Schema.optionalKey(ManagedUpdatesPolicy),
88 });
@@ -95,6 +97,7 @@ export const ManagedPolicySummaryLimits = Schema.Struct({
97 webhookTasks: Schema.optionalKey(Schema.Boolean),
98 telemetry: Schema.optionalKey(Schema.Boolean),
99 browserCookieImport: Schema.optionalKey(Schema.Boolean),
100 + previewTunnel: Schema.optionalKey(Schema.Boolean),
101 providers: Schema.optionalKey(
102 Schema.Struct({
103 /** Absent means every driver is allowed. */
@@ -209,6 +212,7 @@ const CAPABILITY_LABELS = {
212 connect: "T3 Connect",
213 webhookTasks: "webhook tasks",
214 browserCookieImport: "importing browser cookies",
215 + previewTunnel: "opening this machine's local servers on other devices",
216 } as const;
217
218 /** Why a capability is unavailable on an environment with `summary`, or undefined when allowed. */
@@ -227,6 +231,16 @@ export function managedCapabilityDenial(
231 : undefined;
232 }
233
234 +/** Whether the preview tunnel serves: the setting is on and no policy switches it off. */
235 +export function allowsPreviewTunnel(config: {
236 + readonly settings: { readonly enablePreviewTunnel: boolean };
237 + readonly managedPolicy?: ManagedPolicySummary | undefined;
238 +}): boolean {
239 + return (
240 + config.settings.enablePreviewTunnel && config.managedPolicy?.limits?.previewTunnel !== false
241 + );
242 +}
243 +
244 /** Whether the policy lets `driver` run; clients name it with their own provider label. */
245 export function isManagedDriverAllowed(
246 summary: ManagedPolicySummary | undefined,
packages/contracts/src/settings.ts
+4 -1
@@ -1396,6 +1396,8 @@ export const ServerSettings = Schema.Struct({
1396 ),
1397
1398 enableAgentBrowserAccess: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
1399 + /** Lets clients reach this machine's loopback ports over `/api/preview/tunnel`. */
1400 + enablePreviewTunnel: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
1401 cloudSpeechCredentials: CloudSpeechCredentials.pipe(
1402 Schema.withDecodingDefault(Effect.succeed({ openai: "", xai: "", openrouter: "" })),
1403 ),
@@ -1858,6 +1860,7 @@ export const ServerSettingsPatch = Schema.Struct({
1860 keepAwakeWhileAgentsWork: Schema.optionalKey(Schema.Boolean),
1861 requireConnectDeviceApproval: Schema.optionalKey(Schema.Boolean),
1862 enableAgentBrowserAccess: Schema.optionalKey(Schema.Boolean),
1863 + enablePreviewTunnel: Schema.optionalKey(Schema.Boolean),
1864 cloudSpeechCredentials: Schema.optionalKey(
1865 Schema.Struct({
1866 openai: Schema.optionalKey(SettingsSecretValue),
@@ -2006,7 +2009,7 @@ export function requiredScopesForServerSettingsPatch(
2009 let changesAccess = false;
2010 for (const [key, value] of Object.entries(patch)) {
2011 if (value === undefined) continue;
2009 - if (key === "requireConnectDeviceApproval") {
2012 + if (key === "requireConnectDeviceApproval" || key === "enablePreviewTunnel") {
2013 changesAccess = true;
2014 } else if (
2015 key === "providers" ||
packages/shared/src/managedPolicyFile.ts
+1
@@ -114,6 +114,7 @@ export const WINDOWS_POLICY_VALUES = {
114 WebhookTasks: { type: "boolean", path: ["limits", "webhookTasks"] },
115 Telemetry: { type: "boolean", path: ["limits", "telemetry"] },
116 BrowserCookieImport: { type: "boolean", path: ["limits", "browserCookieImport"] },
117 + PreviewTunnel: { type: "boolean", path: ["limits", "previewTunnel"] },
118 ProviderInstances: { type: "json", path: ["limits", "providers", "instances"] },
119 UpdatesMode: { type: "string", path: ["limits", "updates", "mode"] },
120 UpdatesFeedUrl: { type: "string", path: ["limits", "updates", "feedUrl"] },