@surething/cockpit 1.0.190 → 1.0.192

package/.next-prod/types/app/api/sessions/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../src/app/api/sessions/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../src/app/api/sessions/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/settings/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../src/app/api/settings/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../src/app/api/settings/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/skills/[id]/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/skills/[id]/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/skills/[id]/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/skills/content/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/skills/content/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/skills/content/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/skills/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../src/app/api/skills/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../src/app/api/skills/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/terminal/aliases/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/terminal/aliases/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/terminal/aliases/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/terminal/autocomplete/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/terminal/autocomplete/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/terminal/autocomplete/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/terminal/bubble-order/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/terminal/bubble-order/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/terminal/bubble-order/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/terminal/env/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/terminal/env/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/terminal/env/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/terminal/history/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../../src/app/api/terminal/history/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../../src/app/api/terminal/history/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/api/version/route.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../src/app/api/version/route.js'
 import type { NextRequest } from 'next/server.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../src/app/api/version/route.js')
 
@@ -21,7 +21,8 @@ checkFields<Diff<{
   PATCH?: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/page.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../src/app/page.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../src/app/page.js')
 
@@ -15,7 +15,8 @@ checkFields<Diff<{
   default: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/project/page.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../src/app/project/page.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../src/app/project/page.js')
 
@@ -15,7 +15,8 @@ checkFields<Diff<{
   default: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/app/review/[id]/page.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../../../src/app/review/[id]/page.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 
-import type { PrefetchForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../../../src/app/review/[id]/page.js')
 
@@ -15,7 +15,8 @@ checkFields<Diff<{
   default: Function
   config?: {}
   generateStaticParams?: Function
-  unstable_prefetch?: PrefetchForTypeCheckInternal
+  unstable_instant?: InstantConfigForTypeCheckInternal
+  unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
   dynamicParams?: boolean

package/.next-prod/types/cache-life.d.ts

@@ -0,0 +1,145 @@
+// Type definitions for Next.js cacheLife configs
+
+declare module 'next/cache' {
+  export { unstable_cache } from 'next/dist/server/web/spec-extension/unstable-cache'
+  export {
+    updateTag,
+    revalidateTag,
+    revalidatePath,
+    refresh,
+  } from 'next/dist/server/web/spec-extension/revalidate'
+  export { unstable_noStore } from 'next/dist/server/web/spec-extension/unstable-no-store'
+
+  
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"default"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 900 seconds (15 minutes)
+     *   expire:     never
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 15 minutes, start revalidating new values in the background.
+     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
+     */
+    export function cacheLife(profile: "default"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"seconds"` profile.
+     * ```
+     *   stale:      30 seconds
+     *   revalidate: 1 seconds
+     *   expire:     60 seconds (1 minute)
+     * ```
+     * 
+     * This cache may be stale on clients for 30 seconds before checking with the server.
+     * If the server receives a new request after 1 seconds, start revalidating new values in the background.
+     * If this entry has no traffic for 1 minute it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "seconds"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"minutes"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 60 seconds (1 minute)
+     *   expire:     3600 seconds (1 hour)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 minute, start revalidating new values in the background.
+     * If this entry has no traffic for 1 hour it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "minutes"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"hours"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 3600 seconds (1 hour)
+     *   expire:     86400 seconds (1 day)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 hour, start revalidating new values in the background.
+     * If this entry has no traffic for 1 day it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "hours"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"days"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 86400 seconds (1 day)
+     *   expire:     604800 seconds (1 week)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 day, start revalidating new values in the background.
+     * If this entry has no traffic for 1 week it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "days"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"weeks"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 604800 seconds (1 week)
+     *   expire:     2592000 seconds (1 month)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 week, start revalidating new values in the background.
+     * If this entry has no traffic for 1 month it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "weeks"): void
+    
+    /**
+     * Cache this `"use cache"` for a timespan defined by the `"max"` profile.
+     * ```
+     *   stale:      300 seconds (5 minutes)
+     *   revalidate: 2592000 seconds (1 month)
+     *   expire:     31536000 seconds (365 days)
+     * ```
+     * 
+     * This cache may be stale on clients for 5 minutes before checking with the server.
+     * If the server receives a new request after 1 month, start revalidating new values in the background.
+     * If this entry has no traffic for 365 days it will expire. The next request will recompute it.
+     */
+    export function cacheLife(profile: "max"): void
+    
+    /**
+     * Cache this `"use cache"` using a custom timespan.
+     * ```
+     *   stale: ... // seconds
+     *   revalidate: ... // seconds
+     *   expire: ... // seconds
+     * ```
+     *
+     * This is similar to Cache-Control: max-age=`stale`,s-max-age=`revalidate`,stale-while-revalidate=`expire-revalidate`
+     *
+     * If a value is left out, the lowest of other cacheLife() calls or the default, is used instead.
+     */
+    export function cacheLife(profile: {
+      /**
+       * This cache may be stale on clients for ... seconds before checking with the server.
+       */
+      stale?: number,
+      /**
+       * If the server receives a new request after ... seconds, start revalidating new values in the background.
+       */
+      revalidate?: number,
+      /**
+       * If this entry has no traffic for ... seconds it will expire. The next request will recompute it.
+       */
+      expire?: number
+    }): void
+  
+
+  import { cacheTag } from 'next/dist/server/use-cache/cache-tag'
+  export { cacheTag }
+
+  export const unstable_cacheTag: typeof cacheTag
+  export const unstable_cacheLife: typeof cacheLife
+}

package/.next-prod/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/project" | "/review/[id]"
-type AppRouteHandlerRoutes = "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/global-state" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projects" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version"
+type AppRouteHandlerRoutes = "/api/bash" | "/api/chat" | "/api/chat/codex" | "/api/chat/kimi" | "/api/chat/ollama" | "/api/claude-stats" | "/api/commands" | "/api/comments" | "/api/db/columns" | "/api/db/connect" | "/api/db/disconnect" | "/api/db/export" | "/api/db/query" | "/api/db/schemas" | "/api/extension/version" | "/api/file" | "/api/files/blame" | "/api/files/clipboard" | "/api/files/copy" | "/api/files/delete" | "/api/files/expanded" | "/api/files/index" | "/api/files/init" | "/api/files/paste" | "/api/files/read" | "/api/files/readdir" | "/api/files/recent" | "/api/files/save" | "/api/files/search" | "/api/files/stat" | "/api/files/text" | "/api/git/branch-diff" | "/api/git/branches" | "/api/git/commit-diff" | "/api/git/commits" | "/api/git/diff" | "/api/git/discard" | "/api/git/stage" | "/api/git/status" | "/api/git/unstage" | "/api/git/worktree" | "/api/global-state" | "/api/jupyter/load" | "/api/jupyter/save" | "/api/jupyter/shutdown" | "/api/lsp/definition" | "/api/lsp/hover" | "/api/lsp/references" | "/api/lsp/status" | "/api/lsp/warmup" | "/api/mysql/columns" | "/api/mysql/connect" | "/api/mysql/disconnect" | "/api/mysql/export" | "/api/mysql/query" | "/api/mysql/schemas" | "/api/neo4j/connect" | "/api/neo4j/disconnect" | "/api/neo4j/query" | "/api/neo4j/schema" | "/api/note" | "/api/ollama/models" | "/api/ollama/start" | "/api/open-cursor" | "/api/open-vscode" | "/api/pick-folder" | "/api/pinned-sessions" | "/api/project-settings" | "/api/project-state" | "/api/projects" | "/api/redis/command" | "/api/redis/connect" | "/api/redis/delete" | "/api/redis/disconnect" | "/api/redis/get" | "/api/redis/keys" | "/api/redis/set" | "/api/review" | "/api/review/[id]" | "/api/review/[id]/comments" | "/api/review/[id]/replies" | "/api/review/identify" | "/api/review/order" | "/api/review/share-info" | "/api/review/users" | "/api/scheduled-tasks" | "/api/services/config" | "/api/services/scripts" | "/api/session-by-path" | "/api/session/[sessionId]/fork" | "/api/session/[sessionId]/history" | "/api/sessions" | "/api/sessions/projects" | "/api/sessions/projects/[encodedPath]" | "/api/settings" | "/api/skills" | "/api/skills/[id]" | "/api/skills/content" | "/api/terminal/aliases" | "/api/terminal/autocomplete" | "/api/terminal/bubble-order" | "/api/terminal/env" | "/api/terminal/history" | "/api/version"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -41,6 +41,8 @@ interface ParamMap {
   "/api/files/recent": {}
   "/api/files/save": {}
   "/api/files/search": {}
+  "/api/files/stat": {}
+  "/api/files/text": {}
   "/api/git/branch-diff": {}
   "/api/git/branches": {}
   "/api/git/commit-diff": {}

package/.next-prod/types/validator.ts

@@ -335,6 +335,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/files/stat/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/files/stat">> = Specific
+  const handler = {} as typeof import("../../src/app/api/files/stat/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/files/text/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/files/text">> = Specific
+  const handler = {} as typeof import("../../src/app/api/files/text/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/git/branch-diff/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/git/branch-diff">> = Specific

package/README.md

@@ -26,7 +26,7 @@ A unified development cockpit built on **Claude Code (Agent SDK)** — chat, cod
 - Syntax highlighting (Shiki) with Vi mode editing
 - Git blame, diff view, branch switching, worktree management
 - LSP integration — go to definition, find references, hover info
-- Fuzzy file search (Cmd+F), JSON viewer, Markdown preview, Mermaid diagrams
+- Fuzzy file search (Cmd+F), JSON viewer, Markdown preview
 
 ### Console — Terminal & Bubbles
 - Full terminal emulator (xterm.js) with shell integration

package/README.zh.md

@@ -28,7 +28,7 @@ https://github.com/user-attachments/assets/18f1a5dc-64f3-4ff6-b9fc-9cd08181fbb8
 - 语法高亮 (Shiki) + Vi 模式编辑
 - Git blame、Diff 视图、分支切换、Worktree 管理
 - LSP 集成 — 跳转定义、查找引用、悬浮类型信息
-- 模糊搜索 (Cmd+F)、JSON 可读视图、Markdown 预览、Mermaid 图表
+- 模糊搜索 (Cmd+F)、JSON 可读视图、Markdown 预览
 
 ### Console — 终端与气泡
 

package/bin/cock-browser.mjs

@@ -353,6 +353,32 @@ async function run() {
 
 async function formatOutput(action, data) {
   if (data === undefined || data === null) {
+    // evaluate-family silently returning undefined/null is a major source of
+    // confusion for LLM callers — they can't tell "code ran but produced no
+    // value" from "something broke". Write a concrete hint to stderr so the
+    // Bash tool's empty-stdout annotation surfaces it alongside the
+    // "(exit 0 — empty stdout)" note instead of guessing causes.
+    if (action === 'evaluate' || action === 'evaluate_chunk') {
+      process.stderr.write(
+        `(evaluate returned ${data === null ? 'null' : 'undefined'} — nothing to print.\n` +
+        ` Common causes:\n` +
+        `  (a) bare arrow function: \`() => x\` defines but does not invoke — wrap as \`(() => x)()\` or \`(async()=>{...})()\`.\n` +
+        `  (b) a .then(...) callback didn't return the value — add an explicit \`return\` in each step of the chain.\n` +
+        `  (c) accessed a missing property — e.g. \`d.chat.x\` when response has no \`chat\` field, yielding undefined.\n` +
+        ` To force output: wrap the final value with \`JSON.stringify(...)\`, or return a short scalar.\n`
+      );
+    }
+    return;
+  }
+  if (typeof data === 'function') {
+    // Structured clone usually drops functions into undefined before this
+    // point, but if one slips through (e.g. from a custom bridge), surface
+    // it explicitly instead of swallowing.
+    process.stderr.write(
+      `(evaluate returned a function reference, which cannot be serialized.\n` +
+      ` If you defined an arrow function, invoke it: \`(async()=>{...})()\`.\n` +
+      ` To return the function's *result*, call it; to inspect the source, use \`fn.toString()\`.\n`
+    );
     return;
   }
 

package/dist/wsServer.mjs

@@ -395,6 +395,43 @@ function notifyExitListeners(commandId, exitCode) {
 // src/lib/terminal/RunningCommandRegistry.ts
 var MAX_OUTPUT_LINES = 5e3;
 var OUTPUT_FILE_THRESHOLD = 4096;
+var PTY_RING_BUFFER_MAX = 2 * 1024 * 1024;
+var PtyRingBuffer = class {
+  constructor(max = PTY_RING_BUFFER_MAX) {
+    this.chunks = [];
+    this.totalLen = 0;
+    this.max = max;
+  }
+  append(data) {
+    if (!data) return;
+    this.chunks.push(data);
+    this.totalLen += data.length;
+    while (this.totalLen > this.max && this.chunks.length > 0) {
+      const overflow = this.totalLen - this.max;
+      const oldest = this.chunks[0];
+      if (oldest.length <= overflow) {
+        this.chunks.shift();
+        this.totalLen -= oldest.length;
+      } else {
+        this.chunks[0] = oldest.slice(overflow);
+        this.totalLen -= overflow;
+      }
+    }
+  }
+  snapshot() {
+    return this.chunks.length === 1 ? this.chunks[0] : this.chunks.join("");
+  }
+  get length() {
+    return this.totalLen;
+  }
+};
+function findSafeStart(s) {
+  const lf = s.indexOf("\n");
+  if (lf !== -1) return lf + 1;
+  const esc = s.indexOf("\x1B");
+  if (esc !== -1) return esc;
+  return 0;
+}
 var GLOBAL_KEY = /* @__PURE__ */ Symbol.for("terminal_running_commands");
 var SERVER_ID_KEY = /* @__PURE__ */ Symbol.for("terminal_server_id");
 function getServerId() {
@@ -415,17 +452,21 @@ function getRegistry2() {
 }
 function registerCommand(cmd) {
   console.log(`[registry] register: id=${cmd.commandId}, cmd="${cmd.command}", pid=${cmd.pid}, pty=${!!cmd.ptyProcess}, server=${getServerId()}`);
-  getRegistry2().set(cmd.commandId, {
+  const entry = {
     ...cmd,
     outputLines: [],
-    outputPartial: ""
-  });
+    outputPartial: "",
+    // Only PTY commands get a ring buffer — pipe mode replay still uses outputLines.
+    ...cmd.ptyProcess ? { ptyRingBuffer: new PtyRingBuffer() } : {}
+  };
+  getRegistry2().set(cmd.commandId, entry);
   registerTerminal(cmd.tabId, cmd.commandId, cmd.command, cmd.projectCwd);
   writeHistoryPlaceholder(cmd.commandId, cmd.command, cmd.timestamp, cmd.cwd, cmd.projectCwd, cmd.tabId, !!cmd.usePty).catch(() => {
   });
   if (cmd.ptyProcess) {
     const pty = cmd.ptyProcess;
     pty.onData((data) => {
+      entry.ptyRingBuffer?.append(data);
       notifyOutputListeners(cmd.commandId, data);
     });
     const ptyPid = cmd.pid;
@@ -557,6 +598,7 @@ async function finalizeCommand(commandId, exitCode, pid) {
   notifyExitListeners(commandId, exitCode);
   finalizeTerminal(commandId, exitCode);
   const output = getBufferedOutput(cmd);
+  cmd.ptyRingBuffer = void 0;
   registry2.delete(commandId);
   const entry = {
     id: cmd.commandId,
@@ -1059,9 +1101,17 @@ function handleTerminal(ws, projectCwd) {
         return;
       }
       send({ type: "pid", commandId, pid: cmd.pid });
-      const buffered = cmd.outputLines.join("\n") + (cmd.outputPartial ? "\n" + cmd.outputPartial : "");
-      if (buffered) {
-        send({ type: "stdout", commandId, data: buffered });
+      if (cmd.usePty && cmd.ptyRingBuffer) {
+        const snap = cmd.ptyRingBuffer.snapshot();
+        if (snap) {
+          const replay = snap.slice(findSafeStart(snap));
+          if (replay) send({ type: "stdout", commandId, data: replay });
+        }
+      } else {
+        const buffered = cmd.outputLines.join("\n") + (cmd.outputPartial ? "\n" + cmd.outputPartial : "");
+        if (buffered) {
+          send({ type: "stdout", commandId, data: buffered });
+        }
       }
       if (cmd.usePty && cmd.ptyProcess) {
         attachPtyListeners(commandId, cmd.ptyProcess);