@tasselx/pi-web 1.2.1 → 1.3.0

package/.next/types/app/api/provider-usage/query/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/provider-usage/query/route.ts
+// File: /private/tmp/pi-web-merge/app/api/provider-usage/query/route.ts
 import * as entry from '../../../../../../app/api/provider-usage/query/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/push/config/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/push/config/route.ts
+// File: /private/tmp/pi-web-merge/app/api/push/config/route.ts
 import * as entry from '../../../../../../app/api/push/config/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/push/subscribe/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/push/subscribe/route.ts
+// File: /private/tmp/pi-web-merge/app/api/push/subscribe/route.ts
 import * as entry from '../../../../../../app/api/push/subscribe/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/auto-name/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/auto-name/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/auto-name/route.ts
 import * as entry from '../../../../../../../app/api/sessions/[id]/auto-name/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/context/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/context/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/context/route.ts
 import * as entry from '../../../../../../../app/api/sessions/[id]/context/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/entries/[entryId]/thinking/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/entries/[entryId]/thinking/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/entries/[entryId]/thinking/route.ts
 import * as entry from '../../../../../../../../../app/api/sessions/[id]/entries/[entryId]/thinking/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/entries/[entryId]/tool-result-image/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/entries/[entryId]/tool-result-image/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/entries/[entryId]/tool-result-image/route.ts
 import * as entry from '../../../../../../../../../app/api/sessions/[id]/entries/[entryId]/tool-result-image/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/export/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/export/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/export/route.ts
 import * as entry from '../../../../../../../app/api/sessions/[id]/export/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/fork/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/fork/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/fork/route.ts
 import * as entry from '../../../../../../../app/api/sessions/[id]/fork/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/route.ts
 import * as entry from '../../../../../../app/api/sessions/[id]/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/[id]/state/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/[id]/state/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/[id]/state/route.ts
 import * as entry from '../../../../../../../app/api/sessions/[id]/state/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/delete/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/delete/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/delete/route.ts
 import * as entry from '../../../../../../app/api/sessions/delete/route.js'
 import type { NextRequest } from 'next/server.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/route.ts
 import * as entry from '../../../../../app/api/sessions/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/search/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/search/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/search/route.ts
 import * as entry from '../../../../../../app/api/sessions/search/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/stats/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/stats/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/stats/route.ts
 import * as entry from '../../../../../../app/api/sessions/stats/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sessions/ui-state/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sessions/ui-state/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sessions/ui-state/route.ts
 import * as entry from '../../../../../../app/api/sessions/ui-state/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/skills/check/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/check/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/check/route.ts
 import * as entry from '../../../../../../app/api/skills/check/route.js'
 import type { NextRequest } from 'next/server.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/content/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/content/route.ts
 import * as entry from '../../../../../../app/api/skills/content/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/skills/install/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/install/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/install/route.ts
 import * as entry from '../../../../../../app/api/skills/install/route.js'
 import type { NextRequest } from 'next/server.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/route.ts
 import * as entry from '../../../../../app/api/skills/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/skills/search/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/search/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/search/route.ts
 import * as entry from '../../../../../../app/api/skills/search/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/skills/update/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/skills/update/route.ts
+// File: /private/tmp/pi-web-merge/app/api/skills/update/route.ts
 import * as entry from '../../../../../../app/api/skills/update/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/sleep-inhibit/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/sleep-inhibit/route.ts
+// File: /private/tmp/pi-web-merge/app/api/sleep-inhibit/route.ts
 import * as entry from '../../../../../app/api/sleep-inhibit/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/subagents/[id]/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/subagents/[id]/route.ts
+// File: /private/tmp/pi-web-merge/app/api/subagents/[id]/route.ts
 import * as entry from '../../../../../../app/api/subagents/[id]/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/subagents/profiles/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/subagents/profiles/route.ts
+// File: /private/tmp/pi-web-merge/app/api/subagents/profiles/route.ts
 import * as entry from '../../../../../../app/api/subagents/profiles/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/subagents/settings/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/subagents/settings/route.ts
+// File: /private/tmp/pi-web-merge/app/api/subagents/settings/route.ts
 import * as entry from '../../../../../../app/api/subagents/settings/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/terminal/[id]/events/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/terminal/[id]/events/route.ts
+// File: /private/tmp/pi-web-merge/app/api/terminal/[id]/events/route.ts
 import * as entry from '../../../../../../../app/api/terminal/[id]/events/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/terminal/[id]/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/terminal/[id]/route.ts
+// File: /private/tmp/pi-web-merge/app/api/terminal/[id]/route.ts
 import * as entry from '../../../../../../app/api/terminal/[id]/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/terminal/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/terminal/route.ts
+// File: /private/tmp/pi-web-merge/app/api/terminal/route.ts
 import * as entry from '../../../../../app/api/terminal/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/tools/settings/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/tools/settings/route.ts
+// File: /private/tmp/pi-web-merge/app/api/tools/settings/route.ts
 import * as entry from '../../../../../../app/api/tools/settings/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/web-auth/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/web-auth/route.ts
+// File: /private/tmp/pi-web-merge/app/api/web-auth/route.ts
 import * as entry from '../../../../../app/api/web-auth/route.js'
 import type { NextRequest } from 'next/server.js'
 

package/.next/types/app/api/worktrees/route.ts

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/api/worktrees/route.ts
+// File: /private/tmp/pi-web-merge/app/api/worktrees/route.ts
 import * as entry from '../../../../../app/api/worktrees/route.js'
 import type { NextRequest } from 'next/server.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/layout.tsx
+// File: /private/tmp/pi-web-merge/app/layout.tsx
 import * as entry from '../../../app/layout.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/login/page.tsx
+// File: /private/tmp/pi-web-merge/app/login/page.tsx
 import * as entry from '../../../../app/login/page.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 

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

@@ -1,4 +1,4 @@
-// File: /Users/tassel/pi-web/app/page.tsx
+// File: /private/tmp/pi-web-merge/app/page.tsx
 import * as entry from '../../../app/page.js'
 import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
 

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]/bash-output" | "/api/agent/[id]/events" | "/api/agent/[id]/lease" | "/api/agent/new" | "/api/agent/running" | "/api/app-update" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cache-miss-notices" | "/api/cwd/browse" | "/api/cwd/pick" | "/api/cwd/validate" | "/api/default-cwd" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/home" | "/api/mcp" | "/api/mcp/sign-in" | "/api/mcp/sign-in/[flowId]" | "/api/mcp/test" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/models/default" | "/api/models/enabled" | "/api/models/refresh" | "/api/open-in-explorer" | "/api/plugins" | "/api/plugins/check" | "/api/project-trust" | "/api/provider-usage/query" | "/api/push/config" | "/api/push/subscribe" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/entries/[entryId]/tool-result-image" | "/api/sessions/[id]/export" | "/api/sessions/[id]/fork" | "/api/sessions/[id]/state" | "/api/sessions/delete" | "/api/sessions/search" | "/api/sessions/stats" | "/api/sessions/ui-state" | "/api/skills" | "/api/skills/check" | "/api/skills/content" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/sleep-inhibit" | "/api/subagents/[id]" | "/api/subagents/profiles" | "/api/subagents/settings" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/tools/settings" | "/api/web-auth" | "/api/worktrees"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/[id]/lease" | "/api/agent/debug" | "/api/agent/new" | "/api/agent/running" | "/api/app-update" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cache-miss-notices" | "/api/cwd/browse" | "/api/cwd/pick" | "/api/cwd/validate" | "/api/default-cwd" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/home" | "/api/mcp" | "/api/mcp/sign-in" | "/api/mcp/sign-in/[flowId]" | "/api/mcp/test" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/models/default" | "/api/models/enabled" | "/api/models/refresh" | "/api/open-in-explorer" | "/api/plugins" | "/api/plugins/check" | "/api/project-trust" | "/api/provider-usage/query" | "/api/push/config" | "/api/push/subscribe" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/entries/[entryId]/tool-result-image" | "/api/sessions/[id]/export" | "/api/sessions/[id]/fork" | "/api/sessions/[id]/state" | "/api/sessions/delete" | "/api/sessions/search" | "/api/sessions/stats" | "/api/sessions/ui-state" | "/api/skills" | "/api/skills/check" | "/api/skills/content" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/sleep-inhibit" | "/api/subagents/[id]" | "/api/subagents/profiles" | "/api/subagents/settings" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/tools/settings" | "/api/web-auth" | "/api/worktrees"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -16,6 +16,7 @@ interface ParamMap {
   "/api/agent/[id]/bash-output": { "id": string; }
   "/api/agent/[id]/events": { "id": string; }
   "/api/agent/[id]/lease": { "id": string; }
+  "/api/agent/debug": {}
   "/api/agent/new": {}
   "/api/agent/running": {}
   "/api/app-update": {}

package/.next/types/validator.ts

@@ -126,6 +126,16 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/agent/debug/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/debug">> = Specific
+  const handler = {} as typeof import("../../app/api/agent/debug/route.js")
+  type __Check = __IsExpected<typeof handler>
+  
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/agent/new/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/agent/new">> = Specific

package/README.md

@@ -81,6 +81,7 @@ For port and hostname, command-line options override the corresponding environme
 | `PI_WEB_PASSWORD` | Enable browser password login; API clients may use Basic Auth with username `pi` | Authentication disabled |
 | `PI_WEB_IDLE_TIMEOUT_MS` | Session idle timeout in milliseconds, up to `2147483647`; `0` disables idle shutdown; invalid or out-of-range values use the default | `600000` (10 min) |
 | `PI_WEB_SHUTDOWN_DEADLINE_MS` | How long extensions get to handle `session_shutdown` before a closing session is disposed anyway, in milliseconds up to `2147483647`; `0`, invalid or out-of-range values use the default | `5000` (5 s) |
+| `PI_CODEMODE_MAX_WORKERS` | pi's limit on codemode scripts running at once, shared by every session and subagent in the server; pi's own default is `2`, and pi-web sets `8` when the variable is unset or empty. Each script may use up to 256 MB | `8` |
 
 Set `PI_WEB_APP_NAME` before starting the server (for example, `PI_WEB_APP_NAME='Work Pi' pi-web`). After changing it, restart the server to serve the new manifest; no rebuild is required. Updates to the name of an already installed PWA are managed by the browser and are not guaranteed to appear immediately. This does not change the page title or icons.
 
@@ -128,7 +129,7 @@ npx @tasselx/pi-web@latest
 - **Agent data**: Pi Web reads pi data from `~/.pi/agent` by default, including session files under `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Set `PI_CODING_AGENT_DIR` to use another pi agent directory.
 - **Filesystem access**: Pi Web must be able to read the agent data directory and the working directories recorded by its sessions. Run Pi Web in the same filesystem environment as pi when sharing existing sessions.
 - **Shared configuration**: the Models panel uses pi's model, settings, and credential storage, so changes are visible to both interfaces. An open session applies a saved edit of its model when you select the model again.
-- **Code mode workers**: pi runs Code mode scripts in at most two sandbox workers at a time, shared by every session and in-process subagent of the Pi Web server. A further script waits up to 60 seconds for a free worker. If several sessions run scripts at once, set `PI_CODEMODE_MAX_WORKERS` to a larger whole number before starting Pi Web; each worker's script may use up to 256 MB.
+- **Code mode workers**: pi's own limit is two sandbox workers at a time; Pi Web raises it to eight unless `PI_CODEMODE_MAX_WORKERS` is set. The workers are shared by every session and in-process subagent of the Pi Web server, and a further script waits up to 60 seconds for a free worker. To change the limit, set `PI_CODEMODE_MAX_WORKERS` to a whole number before starting Pi Web; each worker's script may use up to 256 MB.
 - **File access boundary**: the file browser is limited to working directories selected in Pi Web and project or session roots it already knows about; it is not a general filesystem browser.
 - **Git worktrees**: see [Worktrees in Pi Web](./docs/worktrees.md) for switcher visibility, worktree creation, and removal behavior.
 

package/bin/browser-opener.js

@@ -2,6 +2,16 @@
 
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const { spawn } = require("child_process");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { getOpenUrl } = require("./run-records");
+
+// Next.js prints "Ready" before it has loaded its request handlers, and the
+// first request then also waits out the pi SDK import that instrumentation
+// starts (#964): half a second on macOS, seconds on a slow disk, and a first
+// navigation that outlasts the service worker's 8 s timeout shows
+// offline.html (#1358). Past this limit the browser opens anyway.
+const FIRST_PAGE_TIMEOUT_MS = 30_000;
+const FIRST_PAGE_RETRY_MS = 250;
 
 function openInBrowser(url, platform = process.platform) {
   // Avoid `shell: true` to suppress Node.js DEP0190 deprecation
@@ -31,4 +41,37 @@ function openInBrowser(url, platform = process.platform) {
   opener.unref();
 }
 
-module.exports = { openInBrowser };
+// Resolves true once url has answered a GET with any HTTP status and the whole
+// body has arrived, or false when nothing answered within timeoutMs. Never
+// rejects. Redirects are followed: with PI_WEB_PASSWORD, / redirects to /login,
+// the page the browser lands on, and the proxy sends that redirect while the
+// pi SDK import is still running.
+async function waitForFirstPage(url, {
+  fetchImpl = fetch,
+  timeoutMs = FIRST_PAGE_TIMEOUT_MS,
+  retryMs = FIRST_PAGE_RETRY_MS,
+} = {}) {
+  const deadline = AbortSignal.timeout(timeoutMs);
+  while (!deadline.aborted) {
+    try {
+      const response = await fetchImpl(url, { signal: deadline });
+      // The page has rendered once its body has arrived, not its headers.
+      await response.arrayBuffer();
+      return true;
+    } catch {
+      if (!deadline.aborted) await new Promise((resolve) => setTimeout(resolve, retryMs));
+    }
+  }
+  return false;
+}
+
+// Opens the browser once the server has served its first page, so the
+// browser's own first navigation finds the page route loaded. A wildcard bind
+// is asked on loopback. Port 0 leaves the real port unknown, so that browser
+// opens at once. The launcher exits with Next.js, which ends the wait too.
+function openWhenServing({ hostname, port, url, open = openInBrowser, wait = waitForFirstPage }) {
+  const served = port === "0" ? Promise.resolve() : wait(`${getOpenUrl(hostname, port)}/`);
+  return served.then(() => open(url));
+}
+
+module.exports = { openInBrowser, openWhenServing, waitForFirstPage };

package/bin/network-addresses.js

@@ -0,0 +1,62 @@
+"use strict";
+
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const os = require("os");
+
+const WILDCARD_HOSTNAMES = new Set(["0.0.0.0", "::", "[::]"]);
+
+function isWildcardHostname(hostname) {
+  return WILDCARD_HOSTNAMES.has(hostname);
+}
+
+// An IPv6 wildcard listens dual-stack (Node's default, and Next passes no
+// ipv6Only), so it answers on every IPv4 address too.
+function addressFamilies(hostname) {
+  return hostname.includes(":") ? ["IPv4", "IPv6"] : ["IPv4"];
+}
+
+// Addresses another machine can open when the server binds a wildcard address:
+// the wildcard itself routes nowhere, so list this host's interfaces instead.
+function getReachableAddresses(hostname, { interfaces = os.networkInterfaces() } = {}) {
+  if (!isWildcardHostname(hostname)) return [];
+  const addresses = [];
+  for (const family of addressFamilies(hostname)) {
+    for (const [name, entries] of Object.entries(interfaces)) {
+      for (const entry of entries ?? []) {
+        // `internal` covers loopback; a scoped IPv6 address (fe80::/10) needs a
+        // zone id, so it cannot be pasted into another machine's browser.
+        if (entry.family !== family || entry.internal || entry.scopeid) continue;
+        addresses.push({ name, address: entry.address });
+      }
+    }
+  }
+  return addresses;
+}
+
+function formatUrl(address, port) {
+  const host = address.includes(":") ? `[${address}]` : address;
+  return `http://${host}:${port}`;
+}
+
+// The startup block that names each interface and the URL it serves. Empty when
+// there is nothing to add: a concrete bind address, port 0 (the OS picks one we
+// never learn), or no address of the bound family.
+function formatReachableAddresses(hostname, port, options) {
+  if (String(port) === "0") return "";
+  const addresses = getReachableAddresses(hostname, options);
+  if (addresses.length === 0) return "";
+  const width = Math.max(...addresses.map(({ name }) => name.length));
+  return [
+    "Reachable at:",
+    ...addresses.map(
+      ({ name, address }) => `  ${name.padEnd(width)}  ${formatUrl(address, port)}`,
+    ),
+  ].join("\n");
+}
+
+module.exports = {
+  formatReachableAddresses,
+  formatUrl,
+  getReachableAddresses,
+  isWildcardHostname,
+};

package/bin/pi-web.js

@@ -24,11 +24,13 @@ const { wireChildProcessLifecycle } = require("./process-lifecycle");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const { rotatePreviewSecrets, getRotationWarning } = require("./rotate-preview-secrets");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const { openInBrowser } = require("./browser-opener");
+const { openWhenServing } = require("./browser-opener");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const { createRunRecordTracker, getOpenUrl, getRunDir } = require("./run-records");
 // eslint-disable-next-line @typescript-eslint/no-require-imports
 const { getPackageVersion, runCommand } = require("./pi-web-commands");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { formatReachableAddresses } = require("./network-addresses");
 
 let launchOptions;
 try {
@@ -144,14 +146,20 @@ function startServer({ port, hostname, openBrowser }) {
 
   let serverReady = false;
   const url = `http://${hostname}:${port}`;
+  // Next.js repeats the `-H` value in its own "Network:" line, which a wildcard
+  // bind makes unusable; name the interfaces and their addresses instead.
+  const reachable = formatReachableAddresses(hostname, port);
 
   child.stdout.on("data", (chunk) => {
     const text = chunk.toString();
     process.stdout.write(text);
     if (!serverReady && text.includes("Ready")) {
       serverReady = true;
+      if (reachable) process.stdout.write(`${reachable}\n`);
+      // The record needs no wait: status, stop and open list a record only
+      // once its URL answers. The browser waits for the first page.
       if (port !== "0") runRecord.markReady();
-      if (openBrowser) openInBrowser(url);
+      if (openBrowser) openWhenServing({ hostname, port, url });
     }
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tasselx/pi-web",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Web UI for the pi coding agent",
   "homepage": "https://github.com/tasselx/pi-web#readme",
   "repository": {

package/.next/server/chunks/5924.js

@@ -1 +0,0 @@
-"use strict";exports.id=5924,exports.ids=[5924],exports.modules={45924:(a,b,c)=>{c.d(b,{registerNodeInstrumentation:()=>t});var d=c(78474),e=c(48161),f=c(76760),g=c(73136),h=c(9956),i=c(73024);let j=i.constants.O_RDONLY|(i.constants.O_NONBLOCK||0),k=globalThis,l=globalThis.fetch,m=()=>{};function n(a){if("string"==typeof a){let b=a.trim();if("disabled"===b.toLowerCase())return 0;if(0===b.length)return;return n(Number(b))}if("number"==typeof a&&Number.isFinite(a)&&!(a<0))return Math.floor(a)}function o(a){return a instanceof d.EventEmitter&&d.EventEmitter.prototype.on.call(a,"error",m),a}function p(a,b){return o(new h.Client(a,b))}function q(a,b){return 1===b.connections?p(a,b):o(new h.Pool(a,{...b,factory:p}))}let r=Symbol.for("pi-web.agentEventStreamClosers"),s=globalThis[r]??=new Set;function t(){!function(a=3e5){if(k.__piWebHttpDispatcherConfigured)return;let b=n(a);if(void 0===b)throw Error(`Invalid HTTP idle timeout: ${String(a)}`);let c=o(new h.EnvHttpProxyAgent({allowH2:!1,proxyTunnel:!0,bodyTimeout:b,connect:{autoSelectFamilyAttemptTimeout:2e3},headersTimeout:b,clientFactory:p,factory:q}));h.setGlobalDispatcher(c),globalThis.fetch===l&&h.install?.(),k.__piWebHttpDispatcherConfigured=!0}(function(a=function(){let a=process.env.PI_CODING_AGENT_DIR;return a?("win32"===process.platform&&(a=function(a){if(!a.startsWith("/")||a.startsWith("//")||a.includes("\\"))return a;let b=a.match(/^\/(?:mnt\/|cygdrive\/)?([a-z])(?:\/(.*))?$/i);return b?`${b[1].toUpperCase()}:\\${b[2]?.replaceAll("/","\\")??""}`:a}(a)),"~"===a)?(0,e.homedir)():a.startsWith("~/")||"win32"===process.platform&&a.startsWith("~\\")?(0,f.join)((0,e.homedir)(),a.slice(2)):/^file:\/\//.test(a)?(0,g.fileURLToPath)(a):a:(0,f.join)((0,e.homedir)(),".pi","agent")}()){let b,c;try{b=function(a){let b;try{b=(0,i.openSync)(a,j)}catch(b){let a;if("ENOENT"===(a=b?.code)||"ENOTDIR"===a)return;throw b}try{if(!(0,i.fstatSync)(b).isFile())throw Error(`${a} is not a regular file`);return(0,i.readFileSync)(b,"utf8")}finally{(0,i.closeSync)(b)}}((0,f.join)(a,"settings.json"))}catch{return}if(void 0!==b){try{c=JSON.parse(65279===b.charCodeAt(0)?b.slice(1):b)}catch{return}if("object"==typeof c&&null!==c)return n(c.httpIdleTimeoutMs)}}());let a=()=>(function(){for(let a of[...s])try{a("error")}catch{}})();process.on("SIGINT",a),process.on("SIGTERM",a),Promise.resolve().then(c.bind(c,75430)).catch(()=>{})}}};