@rexvane/piweb 0.3.20 → 0.3.22

package/.next/types/app/layout.ts

@@ -2,7 +2,7 @@
 import * as entry from '../../../src/app/layout.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 
-import type { InstantConfigForTypeCheckInternal, Prefetch } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal, Prefetch, EnsureStatic } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../src/app/layout.js')
 
@@ -15,8 +15,11 @@ checkFields<Diff<{
   default: Function
   config?: {}
   generateStaticParams?: Function
+  unstable_paramMatching?: {}
+  unstable_generateParamMatching?: Function
   instant?: InstantConfigForTypeCheckInternal
   prefetch?: Prefetch
+  ensureStatic?: EnsureStatic
   unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'

package/.next/types/app/login/page.ts

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

package/.next/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 { InstantConfigForTypeCheckInternal, Prefetch } from 'next/dist/build/segment-config/app/app-segment-config.js'
+import type { InstantConfigForTypeCheckInternal, Prefetch, EnsureStatic } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
 type TEntry = typeof import('../../../src/app/page.js')
 
@@ -15,8 +15,11 @@ checkFields<Diff<{
   default: Function
   config?: {}
   generateStaticParams?: Function
+  unstable_paramMatching?: {}
+  unstable_generateParamMatching?: Function
   instant?: InstantConfigForTypeCheckInternal
   prefetch?: Prefetch
+  ensureStatic?: EnsureStatic
   unstable_dynamicStaleTime?: number
   revalidate?: RevalidateRange<TEntry> | false
   dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'

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

@@ -1,16 +1,17 @@
 // 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'
-  export { io } from 'next/dist/server/request/io'
+export {}
 
+declare module 'next/cache' {
+  export interface CacheLifeProfiles {
+    "default": true
+    "seconds": true
+    "minutes": true
+    "hours": true
+    "days": true
+    "weeks": true
+    "max": true
+  }
   
     /**
      * Cache this `"use cache"` for a timespan defined by the `"default"` profile.
@@ -110,37 +111,4 @@ declare module 'next/cache' {
      */
     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/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/login"
-type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/events" | "/api/agent/[id]/tree" | "/api/agent/new" | "/api/config" | "/api/files" | "/api/fs" | "/api/git" | "/api/growth" | "/api/health" | "/api/models" | "/api/pi-settings" | "/api/plugins" | "/api/prompts" | "/api/remote" | "/api/security" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/export" | "/api/sessions/import" | "/api/skills" | "/api/update" | "/api/version" | "/api/web-auth" | "/api/workspaces"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/events" | "/api/agent/[id]/tree" | "/api/agent/new" | "/api/config" | "/api/files" | "/api/fs" | "/api/git" | "/api/github" | "/api/growth" | "/api/health" | "/api/models" | "/api/models/defaults" | "/api/pi-settings" | "/api/plugins" | "/api/prompts" | "/api/remote" | "/api/security" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/export" | "/api/sessions/import" | "/api/skills" | "/api/update" | "/api/version" | "/api/web-auth" | "/api/workspaces"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -20,9 +20,11 @@ interface ParamMap {
   "/api/files": {}
   "/api/fs": {}
   "/api/git": {}
+  "/api/github": {}
   "/api/growth": {}
   "/api/health": {}
   "/api/models": {}
+  "/api/models/defaults": {}
   "/api/pi-settings": {}
   "/api/plugins": {}
   "/api/prompts": {}

package/.next/types/validator.ts

@@ -6,6 +6,11 @@ import type { AppRoutes, LayoutRoutes, ParamMap, AppRouteHandlerRoutes } from ".
 import type { ResolvingMetadata, ResolvingViewport } from "next/types.js"
 import type { NextRequest } from 'next/server.js'
 
+type ParamMatchFragment<Route extends keyof ParamMap> = Partial<Record<keyof ParamMap[Route], string>>
+type ParamMatchingExports<Route extends keyof ParamMap> =
+  | { unstable_paramMatching?: ParamMatchFragment<Route>; unstable_generateParamMatching?: never }
+  | { unstable_paramMatching?: never; unstable_generateParamMatching?: () => Promise<ParamMatchFragment<Route>> | ParamMatchFragment<Route> }
+
 type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
   default: React.ComponentType<{ params: Promise<ParamMap[Route]> } & any> | ((props: { params: Promise<ParamMap[Route]> } & any) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
   generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
@@ -19,7 +24,7 @@ type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
   ) => Promise<any> | any
   metadata?: any
   viewport?: any
-}
+} & ParamMatchingExports<Route>
 
 type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
   default: React.ComponentType<LayoutProps<Route>> | ((props: LayoutProps<Route>) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
@@ -34,7 +39,7 @@ type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
   ) => Promise<any> | any
   metadata?: any
   viewport?: any
-}
+} & ParamMatchingExports<Route>
 
 type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRoutes> = {
   GET?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
@@ -52,6 +57,14 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends AppPageConfig<"/login">> = Specific
   const handler = {} as typeof import("../../src/app/login/page.js")
   type __Check = __IsExpected<typeof handler>
+  
+  type __ParamMatchingValue =
+    typeof handler extends { unstable_paramMatching: infer Matcher } ? Matcher :
+    typeof handler extends { unstable_generateParamMatching: (...args: any[]) => infer Matcher } ? Awaited<Matcher> : {}
+  type __InvalidParamMatchingKeys = Exclude<keyof __ParamMatchingValue, keyof ParamMap["/login"]>
+  type __AssertNoInvalidParamMatchingKeys<Invalid extends never> = Invalid
+  const __paramMatchingKeyCheck: __AssertNoInvalidParamMatchingKeys<__InvalidParamMatchingKeys> | undefined = undefined
+  void __paramMatchingKeyCheck
   // @ts-ignore
   type __Unused = __Check
 }
@@ -61,6 +74,14 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
   const handler = {} as typeof import("../../src/app/page.js")
   type __Check = __IsExpected<typeof handler>
+  
+  type __ParamMatchingValue =
+    typeof handler extends { unstable_paramMatching: infer Matcher } ? Matcher :
+    typeof handler extends { unstable_generateParamMatching: (...args: any[]) => infer Matcher } ? Awaited<Matcher> : {}
+  type __InvalidParamMatchingKeys = Exclude<keyof __ParamMatchingValue, keyof ParamMap["/"]>
+  type __AssertNoInvalidParamMatchingKeys<Invalid extends never> = Invalid
+  const __paramMatchingKeyCheck: __AssertNoInvalidParamMatchingKeys<__InvalidParamMatchingKeys> | undefined = undefined
+  void __paramMatchingKeyCheck
   // @ts-ignore
   type __Unused = __Check
 }
@@ -70,6 +91,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]/events">> = Specific
   const handler = {} as typeof import("../../src/app/api/agent/[id]/events/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -79,6 +101,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]">> = Specific
   const handler = {} as typeof import("../../src/app/api/agent/[id]/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -88,6 +111,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/[id]/tree">> = Specific
   const handler = {} as typeof import("../../src/app/api/agent/[id]/tree/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -97,6 +121,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/new">> = Specific
   const handler = {} as typeof import("../../src/app/api/agent/new/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -106,6 +131,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/config">> = Specific
   const handler = {} as typeof import("../../src/app/api/config/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -115,6 +141,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/files">> = Specific
   const handler = {} as typeof import("../../src/app/api/files/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -124,6 +151,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/fs">> = Specific
   const handler = {} as typeof import("../../src/app/api/fs/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -133,6 +161,17 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/git">> = Specific
   const handler = {} as typeof import("../../src/app/api/git/route.js")
   type __Check = __IsExpected<typeof handler>
+  
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/github/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/github">> = Specific
+  const handler = {} as typeof import("../../src/app/api/github/route.js")
+  type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -142,6 +181,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/growth">> = Specific
   const handler = {} as typeof import("../../src/app/api/growth/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -151,6 +191,17 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/health">> = Specific
   const handler = {} as typeof import("../../src/app/api/health/route.js")
   type __Check = __IsExpected<typeof handler>
+  
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/models/defaults/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/models/defaults">> = Specific
+  const handler = {} as typeof import("../../src/app/api/models/defaults/route.js")
+  type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -160,6 +211,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/models">> = Specific
   const handler = {} as typeof import("../../src/app/api/models/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -169,6 +221,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/pi-settings">> = Specific
   const handler = {} as typeof import("../../src/app/api/pi-settings/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -178,6 +231,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/plugins">> = Specific
   const handler = {} as typeof import("../../src/app/api/plugins/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -187,6 +241,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/prompts">> = Specific
   const handler = {} as typeof import("../../src/app/api/prompts/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -196,6 +251,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/remote">> = Specific
   const handler = {} as typeof import("../../src/app/api/remote/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -205,6 +261,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/security">> = Specific
   const handler = {} as typeof import("../../src/app/api/security/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -214,6 +271,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]/export">> = Specific
   const handler = {} as typeof import("../../src/app/api/sessions/[id]/export/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -223,6 +281,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/[id]">> = Specific
   const handler = {} as typeof import("../../src/app/api/sessions/[id]/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -232,6 +291,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions/import">> = Specific
   const handler = {} as typeof import("../../src/app/api/sessions/import/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -241,6 +301,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sessions">> = Specific
   const handler = {} as typeof import("../../src/app/api/sessions/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -250,6 +311,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/skills">> = Specific
   const handler = {} as typeof import("../../src/app/api/skills/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -259,6 +321,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/update">> = Specific
   const handler = {} as typeof import("../../src/app/api/update/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -268,6 +331,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/version">> = Specific
   const handler = {} as typeof import("../../src/app/api/version/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -277,6 +341,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/web-auth">> = Specific
   const handler = {} as typeof import("../../src/app/api/web-auth/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -286,6 +351,7 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/workspaces">> = Specific
   const handler = {} as typeof import("../../src/app/api/workspaces/route.js")
   type __Check = __IsExpected<typeof handler>
+  
   // @ts-ignore
   type __Unused = __Check
 }
@@ -299,6 +365,14 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
   const handler = {} as typeof import("../../src/app/layout.js")
   type __Check = __IsExpected<typeof handler>
+  
+  type __ParamMatchingValue =
+    typeof handler extends { unstable_paramMatching: infer Matcher } ? Matcher :
+    typeof handler extends { unstable_generateParamMatching: (...args: any[]) => infer Matcher } ? Awaited<Matcher> : {}
+  type __InvalidParamMatchingKeys = Exclude<keyof __ParamMatchingValue, keyof ParamMap["/"]>
+  type __AssertNoInvalidParamMatchingKeys<Invalid extends never> = Invalid
+  const __paramMatchingKeyCheck: __AssertNoInvalidParamMatchingKeys<__InvalidParamMatchingKeys> | undefined = undefined
+  void __paramMatchingKeyCheck
   // @ts-ignore
   type __Unused = __Check
 }

package/README.md

@@ -105,14 +105,23 @@ The package registers only the `piweb` command, so it never conflicts with the o
 npm install -g @rexvane/piweb@latest
 ```
 
-npm replaces the installed version in place, so there is nothing to uninstall first. This is
-the same command the in-app "Check for updates" button runs. `latest` is npm's default tag,
-so `npm install -g @rexvane/piweb` behaves identically; if your registry is a mirror that
-syncs with a delay, add `--registry=https://registry.npmjs.org` to get a release the moment
-it is published. Restart `piweb` afterwards to serve the new version.
+npm replaces the installed version in place, so there is nothing to uninstall first. `latest`
+is npm's default tag, so `npm install -g @rexvane/piweb` behaves identically; if your registry
+is a mirror that syncs with a delay, add `--registry=https://registry.npmjs.org` to get a
+release the moment it is published. Restart `piweb` afterwards to serve the new version.
 
 Or install a specific version: `npm install -g @rexvane/piweb@0.3.4`.
 
+**Updating from the UI**: every time PiWeb starts it checks PiWeb and pi for new versions in the
+background. When one is available it prints `[更新] 有新版本：…` in the terminal and shows a notice
+in the bottom-right corner of the page (once per start). Click "Update" in the notice or in
+Settings → General to install in place — no trip to the repository. Restart `piweb` when it says
+so; the process never restarts itself.
+
+- The pi engine can be updated on its own (npm installs swap only pi's two packages, no rebuild).
+- On Windows a running npm install cannot replace itself (files are locked), so the PiWeb entry shows the command with a copy button: stop `piweb` first, then run the command above.
+- To skip the network check, set `PI_WEB_UPDATE_CHECK=0` before starting; "Check for updates" in Settings still works.
+
 ### Uninstall
 
 ```bash

package/next.config.ts

@@ -43,8 +43,10 @@ export default (phase: string): NextConfig => {
 		// Webpack's dev chunk names are stable. A per-process prefix prevents an older
 		// browser cache entry from hydrating HTML emitted by a newer dev server.
 		assetPrefix: development ? `/_piweb-dev/${devAssetId}` : undefined,
-		// pi SDK 与其动态加载的扩展都运行在服务端（Node runtime），不对客户端打包
-		serverExternalPackages: ["@earendil-works/pi-coding-agent"],
+		// pi SDK 与其动态加载的扩展都运行在服务端（Node runtime），不对客户端打包。
+		// pi-ai 也走运行时加载：打进 .next 的话，服务里会有两份 pi-ai（pi-coding-agent 自己从
+		// node_modules 再加载一份），npm 成品包单独更新 pi 后打包的那份还停在旧版本。
+		serverExternalPackages: ["@earendil-works/pi-coding-agent", "@earendil-works/pi-ai"],
 		// Image prompts allow 268 MB of base64 plus text and JSON framing.
 		experimental: { proxyClientMaxBodySize: "272mb" },
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rexvane/piweb",
-	"version": "0.3.20",
+	"version": "0.3.22",
 	"license": "MIT",
 	"type": "module",
 	"description": "Modern web UI for the pi coding agent, driven by the official pi SDK without modifying pi",
@@ -62,7 +62,7 @@
 		"@types/react-dom": "^19",
 		"highlight.js": "^11.11.1",
 		"jsonc-parser": "3.3.1",
-		"next": "16.3.4",
+		"next": "16.4.0",
 		"postcss": "^8.5.26",
 		"proper-lockfile": "4.1.2",
 		"react": "^19.3.0",

package/scripts/release.mjs

@@ -93,7 +93,7 @@ export async function verifyReleaseConfig(root = process.cwd(), env = process.en
 }
 
 export const PI_PACKAGE = "@earendil-works/pi-coding-agent";
-const PI_AI_PACKAGE = "@earendil-works/pi-ai";
+export const PI_AI_PACKAGE = "@earendil-works/pi-ai";
 
 /**
  * Shared by the UI and update:pi; called only after the building state is durable.

package/src/app/api/agent/[id]/events/route.ts

@@ -1,11 +1,23 @@
-import { buildSnapshot, getManaged, parseLastEventId, sseEventId, subscribe, unsubscribe } from "@/lib/agent-manager";
+import { buildSnapshot, getManaged, holdViewer, parseLastEventId, sseEventId, subscribe, unsubscribe } from "@/lib/agent-manager";
 import { BoundaryError, resolveSessionPath } from "@/lib/path-security";
 
 export const dynamic = "force-dynamic";
 
-/** SSE：先推完整快照，再推增量；心跳保活；断线由浏览器 EventSource 自动重连（带 Last-Event-ID） */
+/** 轮询模式：第一条事件写出后再等这么久把同一批凑齐，然后结束响应 */
+const POLL_BATCH_MS = 50;
+/** 轮询模式：一直没有事件就在这么久后空着结束，浏览器马上再来 */
+const POLL_HOLD_MS = 25_000;
+/** 轮询模式：两次请求之间仍算有人在看（扩展弹窗不被当成无人值守、会话不被回收） */
+const POLL_VIEWER_GRACE_MS = 30_000;
+
+/**
+ * SSE：先推完整快照，再推增量；心跳保活；断线由浏览器 EventSource 自动重连（带 Last-Event-ID）。
+ * `?poll=1` 是给 Cloudflare 快速隧道用的长轮询（隧道不支持 SSE，见 lib/chat/event-stream）：
+ * 同样的帧格式，但发完一批就结束响应，由浏览器带着 Last-Event-ID 再来取下一批。
+ */
 export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
 	const { id } = await params;
+	const poll = new URL(req.url).searchParams.get("poll") === "1";
 	let sessionPath: string;
 	try {
 		// allowPending：Hero 发首条消息时订阅先于 JSONL 落盘；此时拒绝会让
@@ -28,6 +40,17 @@ export async function GET(req: Request, { params }: { params: Promise<{ id: stri
 	let closed = false;
 	let subscriber: ((seq: number, json: string) => void) | null = null;
 	let ping: ReturnType<typeof setInterval> | null = null;
+	let pollTimer: ReturnType<typeof setTimeout> | null = null;
+	let batchTimer: ReturnType<typeof setTimeout> | null = null;
+
+	const stop = () => {
+		closed = true;
+		if (ping) clearInterval(ping);
+		if (pollTimer) clearTimeout(pollTimer);
+		if (batchTimer) clearTimeout(batchTimer);
+		if (subscriber) unsubscribe(m, subscriber);
+		if (poll) holdViewer(m, POLL_VIEWER_GRACE_MS);
+	};
 
 	const stream = new ReadableStream<Uint8Array>({
 		async start(controller) {
@@ -36,9 +59,7 @@ export async function GET(req: Request, { params }: { params: Promise<{ id: stri
 			};
 			const close = () => {
 				if (closed) return;
-				closed = true;
-				if (ping) clearInterval(ping);
-				if (subscriber) unsubscribe(m, subscriber);
+				stop();
 				try {
 					controller.close();
 				} catch {
@@ -48,11 +69,15 @@ export async function GET(req: Request, { params }: { params: Promise<{ id: stri
 			subscriber = (seq: number, json: string) => {
 				write(`id: ${sseEventId(m, seq)}\ndata: ${json}\n\n`);
 				if (json.includes('"state":"disposed"')) close();
+				else if (poll && !batchTimer) batchTimer = setTimeout(close, POLL_BATCH_MS);
 			};
 			const send = subscriber;
 
-			ping = setInterval(() => write(`: ping\n\n`), 15_000);
-			write(`retry: 2000\n\n`);
+			if (poll) pollTimer = setTimeout(close, POLL_HOLD_MS);
+			else {
+				ping = setInterval(() => write(`: ping\n\n`), 15_000);
+				write(`retry: 2000\n\n`);
+			}
 
 			req.signal.addEventListener("abort", close, { once: true });
 
@@ -61,24 +86,28 @@ export async function GET(req: Request, { params }: { params: Promise<{ id: stri
 			const snap = await buildSnapshot(m);
 			if (closed) return;
 			send(snap.seq, JSON.stringify({ type: "snapshot", snapshot: snap, ts: Date.now() }));
+			// send 里可能已经关了流：这时再订阅就是一个永远不退订的死订阅者，会话也永远回收不掉
+			if (closed) return;
 			if (!subscribe(m, send, snap.seq)) {
 				const latest = await buildSnapshot(m);
 				if (closed) return;
 				send(latest.seq, JSON.stringify({ type: "snapshot", snapshot: latest, ts: Date.now() }));
-				subscribe(m, send, latest.seq);
+				if (!closed) subscribe(m, send, latest.seq);
 			}
 		},
 		cancel() {
-			closed = true;
-			if (ping) clearInterval(ping);
-			if (subscriber) unsubscribe(m, subscriber);
+			if (!closed) stop();
 		},
 	});
 
 	return new Response(stream, {
 		headers: {
-			"Content-Type": "text/event-stream; charset=utf-8",
-			"Cache-Control": "no-cache, no-transform",
+			// 轮询的响应不标成 SSE：隧道对 text/event-stream 另有处理，普通文本响应结束时一定整份送达
+			"Content-Type": poll ? "text/plain; charset=utf-8" : "text/event-stream; charset=utf-8",
+			// no-transform 让中间代理（Cloudflare 隧道边缘）不再压缩：SSE 必须带（压缩会把流攒住）；
+			// 轮询的响应很快就结束，放开让隧道压（实测快照 41 KB → 8.5 KB，流式批次约少九成）。
+			// Next 自己不压缩路由处理器的响应，所以本机、局域网不受影响
+			"Cache-Control": poll ? "no-cache" : "no-cache, no-transform",
 			Connection: "keep-alive",
 			"X-Accel-Buffering": "no",
 		},

package/src/app/api/files/route.ts

@@ -1,16 +1,19 @@
 import { NextResponse } from "next/server";
 import { BoundaryError } from "@/lib/path-security";
-import { listWorkspaceDir, openInEditor, parseUploadLength, readWorkspaceFile, saveUploadStream } from "@/lib/files-service";
+import { listWorkspaceDir, listWorkspaceIndex, openInEditor, parseUploadLength, readWorkspaceFile, saveUploadStream } from "@/lib/files-service";
 
 export const dynamic = "force-dynamic";
 
-/** 工作区文件浏览：?cwd=&path=（目录列表）；?read=1&cwd=&path=（文本预览） */
+/** 工作区文件浏览：?cwd=&path=（目录列表）；?read=1&cwd=&path=（文本预览）；?index=1&cwd=（@ 引用候选全量清单） */
 export async function GET(req: Request) {
 	const url = new URL(req.url);
 	try {
 		if (url.searchParams.get("read") === "1") {
 			return NextResponse.json({ success: true, data: await readWorkspaceFile(url.searchParams.get("cwd"), url.searchParams.get("path")) });
 		}
+		if (url.searchParams.get("index") === "1") {
+			return NextResponse.json({ success: true, data: await listWorkspaceIndex(url.searchParams.get("cwd")) });
+		}
 		return NextResponse.json({ success: true, data: await listWorkspaceDir(url.searchParams.get("cwd"), url.searchParams.get("path"), url.searchParams.get("offset")) });
 	} catch (err: any) {
 		return NextResponse.json(