@mndrk/agx 2.0.55 → 2.1.0

package/cloud-runtime/standalone/apps/local/lib/terminal-server.ts

@@ -0,0 +1,182 @@
+import type { IncomingMessage, Server as HttpServer } from "http";
+import type { Duplex } from "stream";
+import { parse } from "url";
+import { WebSocketServer, WebSocket } from "ws";
+import {
+  createSession,
+  getSession,
+  destroySession,
+  resizeSession,
+  destroyAll,
+  subscribeToSession,
+} from "./pty-manager";
+
+type HeartbeatWebSocket = WebSocket & { isAlive?: boolean };
+
+export type TerminalServerBridge = {
+  close: () => void;
+  handleUpgrade: (req: IncomingMessage, socket: Duplex, head: Buffer) => boolean;
+};
+
+function parsePositiveInt(value: string | undefined, fallback: number): number {
+  const parsed = Number.parseInt(value || "", 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+export function createTerminalServerBridge(server?: HttpServer): TerminalServerBridge {
+  const heartbeatIntervalMs = parsePositiveInt(
+    process.env.AGX_TERMINAL_HEARTBEAT_MS,
+    30_000,
+  );
+  const wss = new WebSocketServer({ noServer: true });
+  const heartbeatInterval = setInterval(() => {
+    for (const client of wss.clients) {
+      const heartbeatClient = client as HeartbeatWebSocket;
+
+      if (heartbeatClient.isAlive === false) {
+        client.terminate();
+        continue;
+      }
+
+      heartbeatClient.isAlive = false;
+      if (client.readyState === WebSocket.OPEN) {
+        client.ping();
+      }
+    }
+  }, heartbeatIntervalMs);
+  heartbeatInterval.unref?.();
+
+  let closed = false;
+  const close = () => {
+    if (closed) return;
+    closed = true;
+    clearInterval(heartbeatInterval);
+    for (const client of wss.clients) {
+      client.terminate();
+    }
+    wss.close();
+    destroyAll();
+  };
+
+  server?.once("close", close);
+
+  wss.on("connection", (ws: WebSocket) => {
+    const heartbeatSocket = ws as HeartbeatWebSocket;
+    heartbeatSocket.isAlive = true;
+    let sessionId: string | null = null;
+    let unsubscribe: (() => void) | null = null;
+
+    ws.on("pong", () => {
+      heartbeatSocket.isAlive = true;
+    });
+
+    ws.on("message", (raw) => {
+      let msg: { type: string; [key: string]: unknown };
+      try {
+        msg = JSON.parse(raw.toString());
+      } catch {
+        return;
+      }
+
+      switch (msg.type) {
+        case "create": {
+          const id = msg.id as string;
+          const cwd = (msg.cwd as string) || undefined;
+
+          try {
+            let session = getSession(id);
+            if (!session) {
+              session = createSession(id, cwd);
+            }
+            sessionId = id;
+
+            unsubscribe?.();
+            unsubscribe = subscribeToSession(id, {
+              onData(data: string) {
+                if (ws.readyState === WebSocket.OPEN) {
+                  ws.send(JSON.stringify({ type: "data", data }));
+                }
+              },
+              onExit({ exitCode }) {
+                if (ws.readyState === WebSocket.OPEN) {
+                  ws.send(JSON.stringify({ type: "exit", exitCode }));
+                }
+              },
+            });
+
+            ws.send(JSON.stringify({ type: "ready", id, backend: session.backend }));
+          } catch (error) {
+            const message =
+              error instanceof Error ? error.message : "Failed to start terminal session";
+            if (ws.readyState === WebSocket.OPEN) {
+              ws.send(JSON.stringify({ type: "error", message }));
+              ws.close(1011, "terminal-create-failed");
+            }
+          }
+          break;
+        }
+
+        case "data": {
+          if (!sessionId) return;
+          const session = getSession(sessionId);
+          session?.process.write(msg.data as string);
+          break;
+        }
+
+        case "resize": {
+          if (!sessionId) return;
+          const cols = msg.cols as number;
+          const rows = msg.rows as number;
+          if (cols > 0 && rows > 0) {
+            resizeSession(sessionId, cols, rows);
+          }
+          break;
+        }
+
+        case "destroy": {
+          const id = (msg.id as string) || sessionId;
+          if (id) {
+            if (id === sessionId) {
+              unsubscribe?.();
+              unsubscribe = null;
+              sessionId = null;
+            }
+            destroySession(id);
+          }
+          break;
+        }
+
+        case "destroy-all": {
+          unsubscribe?.();
+          unsubscribe = null;
+          sessionId = null;
+          destroyAll();
+          break;
+        }
+
+        default: {
+          break;
+        }
+      }
+    });
+
+    ws.on("close", () => {
+      unsubscribe?.();
+      unsubscribe = null;
+    });
+  });
+
+  const handleUpgrade = (req: IncomingMessage, socket: Duplex, head: Buffer): boolean => {
+    const { pathname } = parse(req.url || "", true);
+    if (pathname !== "/ws/terminal") {
+      return false;
+    }
+
+    wss.handleUpgrade(req, socket, head, (ws) => {
+      wss.emit("connection", ws, req);
+    });
+    return true;
+  };
+
+  return { close, handleUpgrade };
+}

package/cloud-runtime/standalone/apps/local/next.config.ts

@@ -1,9 +1,10 @@
 import path from "path";
 import type { NextConfig } from "next";
-import { getConfiguredBoardBaseUrl } from "./lib/app-config";
+import { getAllowedDevOrigins, getConfiguredBoardBaseUrl } from "./lib/app-config";
 
 const nextConfig: NextConfig = {
   output: "standalone",
+  allowedDevOrigins: getAllowedDevOrigins(),
   serverExternalPackages: ["node-pty"],
   turbopack: {
     root: path.resolve(__dirname, "..", ".."),

package/cloud-runtime/standalone/apps/local/package.json

@@ -6,10 +6,10 @@
     "node": ">=22.16.0"
   },
   "scripts": {
-    "dev": "node server.js",
+    "dev": "node agx-server.js",
     "nuke": "lsof -ti :41741 | xargs kill -9 2>/dev/null; pkill -9 -f 'apps/local' 2>/dev/null; echo 'All processes killed'",
     "build": "echo 'standalone build - nothing to build'",
-    "start": "node server.js",
+    "start": "node agx-server.js",
     "lint": "next lint",
     "test": "node --localstorage-file=/tmp/agx-local-jest-localstorage ./node_modules/jest/bin/jest.js",
     "test:watch": "node --localstorage-file=/tmp/agx-local-jest-localstorage ./node_modules/jest/bin/jest.js --watch",

package/cloud-runtime/standalone/apps/local/playwright.config.ts

@@ -47,6 +47,14 @@ export default defineConfig({
       name: 'chromium',
       use: { ...devices['Desktop Chrome'] },
     },
+    {
+      name: 'mobile-safari',
+      use: { ...devices['iPhone 15'] },
+    },
+    {
+      name: 'tablet-safari',
+      use: { ...devices['iPad Pro 11'] },
+    },
   ],
 
   // Run local dev server before starting the tests

package/cloud-runtime/standalone/apps/local/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":false,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":".","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["node-pty"],"turbopack":{"root":"."},"distDirRoot":".next"}
+const nextConfig = {"env":{},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":false,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":".","allowedDevOrigins":["localhost","127.0.0.1","**.ts.net"],"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["node-pty"],"turbopack":{"root":"."},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/cloud-runtime/standalone/apps/local/server.ts

@@ -1,184 +1,40 @@
 import { createServer } from "http";
 import { parse } from "url";
 import next from "next";
-import { WebSocketServer, WebSocket } from "ws";
-import {
-  createSession,
-  getSession,
-  destroySession,
-  resizeSession,
-  destroyAll,
-  subscribeToSession,
-} from "./lib/pty-manager";
+import { createTerminalServerBridge } from "./lib/terminal-server";
 
 const dev = process.env.NODE_ENV !== "production";
 const port = parseInt(process.env.PORT || "41741", 10);
-const heartbeatIntervalMs = parsePositiveInt(
-  process.env.AGX_TERMINAL_HEARTBEAT_MS,
-  30_000,
-);
+const host = "127.0.0.1";
 
-type HeartbeatWebSocket = WebSocket & { isAlive?: boolean };
-
-function parsePositiveInt(value: string | undefined, fallback: number): number {
-  const parsed = Number.parseInt(value || "", 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-
-const app = next({ dev, port });
-const handle = app.getRequestHandler();
+const app = next({ dev, port, hostname: host });
 
 app.prepare().then(() => {
+  const handle = app.getRequestHandler();
+  const handleUpgrade = app.getUpgradeHandler();
+
   const server = createServer((req, res) => {
     const parsedUrl = parse(req.url!, true);
     handle(req, res, parsedUrl);
   });
 
-  const wss = new WebSocketServer({ noServer: true });
-  const heartbeatInterval = setInterval(() => {
-    for (const client of wss.clients) {
-      const heartbeatClient = client as HeartbeatWebSocket;
-
-      if (heartbeatClient.isAlive === false) {
-        client.terminate();
-        continue;
-      }
-
-      heartbeatClient.isAlive = false;
-      if (client.readyState === WebSocket.OPEN) {
-        client.ping();
-      }
-    }
-  }, heartbeatIntervalMs);
-  heartbeatInterval.unref?.();
+  const terminalBridge = createTerminalServerBridge(server);
 
   server.on("upgrade", (req, socket, head) => {
-    const { pathname } = parse(req.url!, true);
-
-    if (pathname === "/ws/terminal") {
-      wss.handleUpgrade(req, socket, head, (ws) => {
-        wss.emit("connection", ws, req);
-      });
-    }
-    // Let Next.js handle its own WebSocket upgrades (HMR, etc.)
-  });
-
-  wss.on("connection", (ws: WebSocket) => {
-    const heartbeatSocket = ws as HeartbeatWebSocket;
-    heartbeatSocket.isAlive = true;
-    let sessionId: string | null = null;
-    let unsubscribe: (() => void) | null = null;
-
-    ws.on("pong", () => {
-      heartbeatSocket.isAlive = true;
-    });
-
-    ws.on("message", (raw) => {
-      let msg: { type: string; [key: string]: unknown };
-      try {
-        msg = JSON.parse(raw.toString());
-      } catch {
-        return;
-      }
-
-      switch (msg.type) {
-        case "create": {
-          const id = msg.id as string;
-          const cwd = (msg.cwd as string) || undefined;
-
-          try {
-            // Reuse existing session or create new one
-            let session = getSession(id);
-            if (!session) {
-              session = createSession(id, cwd);
-            }
-            sessionId = id;
-
-            unsubscribe?.();
-            unsubscribe = subscribeToSession(id, {
-              onData(data: string) {
-                if (ws.readyState === WebSocket.OPEN) {
-                  ws.send(JSON.stringify({ type: "data", data }));
-                }
-              },
-              onExit({ exitCode }) {
-                if (ws.readyState === WebSocket.OPEN) {
-                  ws.send(JSON.stringify({ type: "exit", exitCode }));
-                }
-              },
-            });
-
-            ws.send(JSON.stringify({ type: "ready", id, backend: session.backend }));
-          } catch (error) {
-            const message =
-              error instanceof Error ? error.message : "Failed to start terminal session";
-            if (ws.readyState === WebSocket.OPEN) {
-              ws.send(JSON.stringify({ type: "error", message }));
-              ws.close(1011, "terminal-create-failed");
-            }
-          }
-          break;
-        }
-
-        case "data": {
-          if (!sessionId) return;
-          const session = getSession(sessionId);
-          session?.process.write(msg.data as string);
-          break;
-        }
-
-        case "resize": {
-          if (!sessionId) return;
-          const cols = msg.cols as number;
-          const rows = msg.rows as number;
-          if (cols > 0 && rows > 0) {
-            resizeSession(sessionId, cols, rows);
-          }
-          break;
-        }
-
-        case "destroy": {
-          const id = (msg.id as string) || sessionId;
-          if (id) {
-            if (id === sessionId) {
-              unsubscribe?.();
-              unsubscribe = null;
-              sessionId = null;
-            }
-            destroySession(id);
-          }
-          break;
-        }
-
-        case "destroy-all": {
-          unsubscribe?.();
-          unsubscribe = null;
-          sessionId = null;
-          destroyAll();
-          break;
-        }
-
-        default: {
-          break;
-        }
-      }
-    });
-
-    ws.on("close", () => {
-      unsubscribe?.();
-      unsubscribe = null;
-      // Don't destroy session on disconnect — allow reconnect
+    if (terminalBridge.handleUpgrade(req, socket, head)) return;
+    void handleUpgrade(req, socket, head).catch((error) => {
+      console.error("Failed to handle Next.js websocket upgrade:", error);
+      socket.destroy();
     });
   });
 
-  server.listen(port, () => {
-    console.log(`> AGX Local ready on http://localhost:${port}`);
+  server.listen(port, host, () => {
+    console.log(`> AGX Local ready on http://${host}:${port}`);
   });
 
   // Cleanup on exit
   const cleanup = () => {
-    clearInterval(heartbeatInterval);
-    destroyAll();
+    terminalBridge.close();
     process.exit();
   };
   process.on("SIGINT", cleanup);

package/cloud-runtime/standalone/apps/local/skills-lock.json

@@ -0,0 +1,20 @@
+{
+  "version": 1,
+  "skills": {
+    "dispatching-parallel-agents": {
+      "source": "obra/superpowers",
+      "sourceType": "github",
+      "computedHash": "e21044ae7496fc285f1df9ff3fb518a3a20bea6f5216c1f59f4987e12c769a0a"
+    },
+    "requesting-code-review": {
+      "source": "obra/superpowers",
+      "sourceType": "github",
+      "computedHash": "246e65cd72a7e360987d94e6c61564ce6d71c6361d1784d529d70e4cbbe8522d"
+    },
+    "verification-before-completion": {
+      "source": "obra/superpowers",
+      "sourceType": "github",
+      "computedHash": "9b446f0c7fe1cfb560b1d34439523b1a76d5f177290007b2c053a1c749a4a8ba"
+    }
+  }
+}

package/cloud-runtime/standalone/apps/local/src/automations/adapters.ts

@@ -56,6 +56,9 @@ export function automationRecordToPromptJob(record: AutomationRecord): PromptJob
     catchUpPolicy: execution.catchUpPolicy,
     cancelCheckSec: execution.cancelCheckSec,
     executionMode: record.definition.target.executionMode ?? DEFAULT_PROMPT_JOB_EXECUTION_MODE,
+    scriptPrompt: record.definition.target.scriptPrompt ?? "",
+    teamId: record.definition.target.teamId ?? "",
+    builtIn: record.definition.target.builtIn === true || record.definition.target.executionMode === "objective_worker" || record.definition.target.executionMode === "linear_worker",
     condition: execution.condition ?? (trigger.type === "condition" ? trigger.condition : ""),
     nextRunAt: record.runtimeState.nextRunAt ?? null,
     lastRunAt: record.runtimeState.lastRunAt ?? null,
@@ -93,6 +96,8 @@ export function promptJobToAutomationDefinition(job: LegacyPromptJobLike): Autom
       ...(job.executionMode !== DEFAULT_PROMPT_JOB_EXECUTION_MODE
         ? { executionMode: job.executionMode }
         : {}),
+      ...(job.scriptPrompt ? { scriptPrompt: job.scriptPrompt } : {}),
+      ...(job.teamId ? { teamId: job.teamId } : {}),
     },
     createdAt: job.createdAt,
     body: job.prompt,

package/cloud-runtime/standalone/apps/local/src/automations/types.ts

@@ -38,11 +38,16 @@ export interface AutomationExecution {
 
 export interface PromptJobAutomationTarget {
   type: "prompt_job";
+  builtIn?: boolean;
   agentId?: string;
   provider?: string;
   model?: string;
   cliArgs?: string;
   prompt?: string;
+  /** For linear_worker: the prompt injected into the agent chat session when working a ticket. */
+  scriptPrompt?: string;
+  /** For linear_worker: the team whose agents participate in the linear chat session. */
+  teamId?: string;
   objectiveId?: string;
   objectiveKey?: string;
   executionMode?: PromptJobExecutionMode;

package/cloud-runtime/standalone/apps/local/src/automations/validation.ts

@@ -212,20 +212,25 @@ function normalizePromptTarget(value: unknown): PromptJobAutomationTarget {
   const prompt = typeof raw.prompt === "string" && raw.prompt.length > 0
     ? raw.prompt
     : undefined;
+  const scriptPrompt = typeof raw.scriptPrompt === "string" && raw.scriptPrompt.length > 0
+    ? raw.scriptPrompt
+    : undefined;
+  const teamId = asTrimmedString(raw.teamId);
   const objectiveId = asTrimmedString(raw.objectiveId);
   const objectiveKey = asTrimmedString(raw.objectiveKey);
   const executionMode = asTrimmedString(raw.executionMode);
 
-  if (!provider && !agentId) {
-    throw new Error("Prompt-job target requires provider or agentId.");
+  if (!provider && !agentId && !teamId) {
+    throw new Error("Prompt-job target requires provider, agentId, or teamId.");
   }
   if (
     executionMode &&
     executionMode !== "prompt" &&
-    executionMode !== "objective_linear_ticket"
+    executionMode !== "objective_worker" &&
+    executionMode !== "linear_worker"
   ) {
     throw new Error(
-      'Prompt-job target.executionMode must be "prompt" or "objective_linear_ticket".',
+      'Prompt-job target.executionMode must be "prompt", "objective_worker", or "linear_worker".',
     );
   }
 
@@ -234,9 +239,11 @@ function normalizePromptTarget(value: unknown): PromptJobAutomationTarget {
   if (model) target.model = model;
   if (cliArgs !== undefined) target.cliArgs = cliArgs;
   if (prompt !== undefined) target.prompt = prompt;
+  if (scriptPrompt !== undefined) target.scriptPrompt = scriptPrompt;
+  if (teamId) target.teamId = teamId;
   if (objectiveId) target.objectiveId = objectiveId;
   if (objectiveKey) target.objectiveKey = objectiveKey;
-  if (executionMode === "prompt" || executionMode === "objective_linear_ticket") {
+  if (executionMode === "prompt" || executionMode === "objective_worker" || executionMode === "linear_worker") {
     target.executionMode = executionMode;
   }
   return target;

package/cloud-runtime/standalone/apps/local/src/graph/types.ts

@@ -359,6 +359,8 @@ export interface GraphSchedule {
   name?: string;
   /** Optional description */
   description?: string;
+  /** Computed: previous cron occurrence (not persisted) */
+  prevScheduledAt?: number;
 }
 
 export interface ExecutionGraph {

package/cloud-runtime/standalone/apps/local/src/objectives/parser.ts

@@ -64,8 +64,6 @@ export function parseObjectiveFrontmatter(raw: Record<string, unknown>, summary:
     chatSessionVersion: readNonNegativeInteger(raw.chatSessionVersion, 0),
     scheduledTaskIds: readStringArray(raw.scheduledTaskIds),
     summary,
-    cadence: readString(raw.cadence),
-    condition: readString(raw.condition),
     progress: readProgress(raw.progress),
     status: readHealth(raw.status),
     createdAt,

package/cloud-runtime/standalone/apps/local/src/objectives/serializer.ts

@@ -25,8 +25,6 @@ function serializeObjectiveFrontmatter(objective: ProjectObjective): string {
     key: objective.key,
     status: objective.status,
     progress: objective.progress || undefined,
-    cadence: objective.cadence,
-    condition: objective.condition,
     threadId: objective.threadId,
     chatSessionVersion: objective.chatSessionVersion || undefined,
     scheduledTaskIds: objective.scheduledTaskIds.length > 0 ? objective.scheduledTaskIds : undefined,

package/cloud-runtime/standalone/apps/local/src/prompt-scheduler/cron.ts

@@ -40,6 +40,17 @@ export function computeNextRun(cronExpr: string, fromMs?: number): number | null
   }
 }
 
+export function computePrevRun(cronExpr: string, fromMs?: number): number | null {
+  try {
+    const expr = CronExpressionParser.parse(cronExpr, {
+      currentDate: fromMs ? new Date(fromMs) : new Date(),
+    });
+    return expr.prev().toDate().getTime();
+  } catch {
+    return null;
+  }
+}
+
 export function formatIntervalCadence(intervalMs: number): string {
   const normalizedMs = Math.max(60_000, intervalMs);
 

package/cloud-runtime/standalone/apps/local/src/prompt-scheduler/linear-worker-constants.ts

@@ -0,0 +1,38 @@
+export const LINEAR_WORKER_JOB_NAME = 'Linear worker';
+export const LINEAR_WORKER_DEFAULT_CADENCE = 'every 30 minutes';
+
+/**
+ * Default selection prompt — guides the controller LLM when picking which ticket to work on.
+ */
+export const LINEAR_WORKER_DEFAULT_PROMPT = `Pick the highest-priority actionable ticket. Prefer tickets that:
+1. Are already started (existing branches, PRs, or prior comments) — continue where you left off.
+2. Are assigned to you or unassigned.
+3. Have the most urgent priority or earliest due date.
+
+Skip tickets with the \`active-session\` label — another agent is already working on them.`;
+
+/**
+ * Default execution prompt — injected into the agent chat session when working a selected ticket.
+ * When empty, the system falls back to the built-in linear execution prompt (buildLinearExecutionPrompt).
+ * Supports template variables: {{ticket.identifier}}, {{ticket.title}}, {{ticket.status}},
+ * {{ticket.assignee}}, {{project.name}}, {{project.slug}}, {{knowledge_base.root}},
+ * {{knowledge_base.issue_path}}, {{worktree.path}}.
+ */
+export const LINEAR_WORKER_DEFAULT_SCRIPT_PROMPT = `Work on {{ticket.identifier}}: {{ticket.title}}
+
+## Workflow
+
+1. **Read the ticket** — Read the full issue and comment thread via Linear MCP before acting.
+2. **Resume existing work** — Check for existing branches, PRs, knowledge-base notes, or prior discussion. Continue where things left off.
+3. **If unclear** — Post a clarifying comment on the ticket and stop. Don't guess.
+4. **If fresh** — Investigate the codebase, draft a plan, post it as a comment. Stop and wait for approval.
+5. **If plan is approved** — Create a git worktree, implement the fix, run tests, commit, push, and create a PR linking the ticket.
+6. **If PR exists** — Check CI, address review feedback, or confirm merge. Don't start over.
+
+## Rules
+
+- Work in an isolated git worktree — never modify the main checkout directly.
+- Keep Linear accurate: update status, post comments, link PRs.
+- Add the \`active-session\` label when starting. Remove it when done.
+- Leave everything in a resumable state. Clean up worktrees when finished.
+- One ticket per session.`;