Feat: Sandbox Logs

.gitignore

@@ -40,18 +40,6 @@ next-env.d.ts
 # AI agents and related files
 CLAUDE.md
 .agent
-.cursor/
-.claude/
-.agents/
-.vscode/
-.idea/
-.agents/
-.ai/
-.codex/
-.copilot/
-.github/copilot/
-.anthropic/
-.openai/
 
 
 # tooling

spec/openapi.infra.yaml

@@ -306,6 +306,17 @@ components:
           items:
             $ref: '#/components/schemas/SandboxLogEntry'
 
+    SandboxLogsV2Response:
+      required:
+        - logs
+      properties:
+        logs:
+          default: []
+          description: Sandbox logs structured
+          type: array
+          items:
+            $ref: "#/components/schemas/SandboxLogEntry"
+
     SandboxMetric:
       description: Metric entry with timestamp and line
       required:
@@ -1914,6 +1925,50 @@ paths:
         '500':
           $ref: '#/components/responses/500'
 
+  /v2/sandboxes/{sandboxID}/logs:
+    get:
+      description: Get sandbox logs (v2)
+      tags: [sandboxes]
+      security:
+        - ApiKeyAuth: []
+        - Supabase1TokenAuth: []
+          Supabase2TeamAuth: []
+      parameters:
+        - $ref: "#/components/parameters/sandboxID"
+        - in: query
+          name: cursor
+          schema:
+            type: integer
+            format: int64
+            minimum: 0
+          description: Starting timestamp of the logs that should be returned in milliseconds
+        - in: query
+          name: limit
+          schema:
+            default: 1000
+            type: integer
+            format: int32
+            minimum: 0
+            maximum: 1000
+          description: Maximum number of logs that should be returned
+        - in: query
+          name: direction
+          schema:
+            $ref: "#/components/schemas/LogsDirection"
+      responses:
+        "200":
+          description: Successfully returned the sandbox logs
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SandboxLogsV2Response"
+        "401":
+          $ref: "#/components/responses/401"
+        "404":
+          $ref: "#/components/responses/404"
+        "500":
+          $ref: "#/components/responses/500"
+
   /sandboxes/{sandboxID}:
     get:
       description: Get a sandbox by id

src/app/dashboard/[teamIdOrSlug]/sandboxes/[sandboxId]/layout.tsx

@@ -1,4 +1,5 @@
 import { SandboxProvider } from '@/features/dashboard/sandbox/context'
+import SandboxDetailsControls from '@/features/dashboard/sandbox/header/controls'
 import SandboxDetailsHeader from '@/features/dashboard/sandbox/header/header'
 import SandboxLayoutClient from '@/features/dashboard/sandbox/layout'
 import { getSandboxDetails } from '@/server/sandboxes/get-sandbox-details'
@@ -30,12 +31,8 @@ export default async function SandboxLayout({
     <SandboxProvider serverSandboxInfo={res?.data} isRunning={exists}>
       <SandboxLayoutClient
         teamIdOrSlug={teamIdOrSlug}
-        header={
-          <SandboxDetailsHeader
-            teamIdOrSlug={teamIdOrSlug}
-            state={exists ? 'running' : 'paused'}
-          />
-        }
+        tabsHeaderAccessory={<SandboxDetailsControls />}
+        header={<SandboxDetailsHeader state={exists ? 'running' : 'paused'} />}
       >
         {children}
       </SandboxLayoutClient>

src/app/dashboard/[teamIdOrSlug]/sandboxes/[sandboxId]/logs/loading.tsx

@@ -0,0 +1 @@
+export { default } from '@/features/dashboard/loading-layout'

src/app/dashboard/[teamIdOrSlug]/sandboxes/[sandboxId]/logs/page.tsx

@@ -0,0 +1,11 @@
+import SandboxLogsView from '@/features/dashboard/sandbox/logs/view'
+
+export default async function SandboxLogsPage({
+  params,
+}: {
+  params: Promise<{ teamIdOrSlug: string; sandboxId: string }>
+}) {
+  const { teamIdOrSlug, sandboxId } = await params
+
+  return <SandboxLogsView teamIdOrSlug={teamIdOrSlug} sandboxId={sandboxId} />
+}

src/app/sbx/new/route.ts

@@ -44,12 +44,12 @@ export const GET = async (req: NextRequest) => {
       },
     })
 
-    const inspectUrl = PROTECTED_URLS.SANDBOX_INSPECT(
+    const filesystemUrl = PROTECTED_URLS.SANDBOX_FILESYSTEM(
       defaultTeam.slug,
       sbx.sandboxId
     )
 
-    return NextResponse.redirect(new URL(inspectUrl, req.url))
+    return NextResponse.redirect(new URL(filesystemUrl, req.url))
   } catch (error) {
     l.warn(
       {

src/configs/layout.ts

@@ -13,6 +13,7 @@ export interface TitleSegment {
 export interface DashboardLayoutConfig {
   title: string | TitleSegment[]
   type: 'default' | 'custom'
+  copyValue?: string
   custom?: {
     includeHeaderBottomStyles: boolean
   }
@@ -27,10 +28,24 @@ const DASHBOARD_LAYOUT_CONFIGS: Record<
     title: 'Sandboxes',
     type: 'custom',
   }),
-  '/dashboard/*/sandboxes/**/*': () => ({
-    title: 'Sandbox',
-    type: 'custom',
-  }),
+  '/dashboard/*/sandboxes/*/*': (pathname) => {
+    const parts = pathname.split('/')
+    const teamIdOrSlug = parts[2]!
+    const sandboxId = parts[4]!
+    const sandboxIdSliced = `${sandboxId.slice(0, 6)}...${sandboxId.slice(-6)}`
+
+    return {
+      title: [
+        {
+          label: 'Sandboxes',
+          href: PROTECTED_URLS.SANDBOXES_LIST(teamIdOrSlug),
+        },
+        { label: sandboxIdSliced },
+      ],
+      type: 'custom',
+      copyValue: sandboxId,
+    }
+  },
   '/dashboard/*/templates': () => ({
     title: 'Templates',
     type: 'custom',
@@ -50,6 +65,7 @@ const DASHBOARD_LAYOUT_CONFIGS: Record<
         { label: `Build ${buildIdSliced}` },
       ],
       type: 'custom',
+      copyValue: buildId,
       custom: {
         includeHeaderBottomStyles: true,
       },

src/configs/logs.ts

@@ -0,0 +1 @@
+export const LOG_RETENTION_MS = 7 * 24 * 60 * 60 * 1000 // 7 days

src/configs/urls.ts

@@ -29,9 +29,11 @@ export const PROTECTED_URLS = {
     `/dashboard/${teamIdOrSlug}/sandboxes?tab=list`,
 
   SANDBOX: (teamIdOrSlug: string, sandboxId: string) =>
-    `/dashboard/${teamIdOrSlug}/sandboxes/${sandboxId}`,
-  SANDBOX_INSPECT: (teamIdOrSlug: string, sandboxId: string) =>
-    `/dashboard/${teamIdOrSlug}/sandboxes/${sandboxId}/inspect`,
+    `/dashboard/${teamIdOrSlug}/sandboxes/${sandboxId}/logs`,
+  SANDBOX_FILESYSTEM: (teamIdOrSlug: string, sandboxId: string) =>
+    `/dashboard/${teamIdOrSlug}/sandboxes/${sandboxId}/filesystem`,
+  SANDBOX_LOGS: (teamIdOrSlug: string, sandboxId: string) =>
+    `/dashboard/${teamIdOrSlug}/sandboxes/${sandboxId}/logs`,
 
   WEBHOOKS: (teamIdOrSlug: string) => `/dashboard/${teamIdOrSlug}/webhooks`,