overmux 0.0.10 → 0.0.12

package/dist/docs/400-reference/200-configuration.md

@@ -161,7 +161,7 @@ export default defineOvermuxConfig({
 
 See [`overmux serve`](/docs/reference/cli/serve) for development mode.
 
-### `debug`
+### `logLevel`
 
 ```ts
 import { defineOvermuxConfig } from "overmux";
@@ -169,12 +169,27 @@ import { defineOvermuxConfig } from "overmux";
 export default defineOvermuxConfig({
   // ...other config
 
-  // Default: true.
-  // Enable debug logging.
-  debug: true,
+  // Default: "info", in development and production.
+  // Options: "debug", "info", "warn", "error".
+  logLevel: "info",
 });
 ```
 
+`logLevel` sets the minimum severity for runtime and [structured handler logs](./500-server/500-api.md#logging):
+
+| Level | Written events |
+| --- | --- |
+| `"debug"` | debug, info, warn, error |
+| `"info"` (default) | info, warn, error |
+| `"warn"` | warn, error |
+| `"error"` | error |
+
+Server startup/shutdown are info events; routine HTTP requests, WebSocket connections, and operation start/completion are debug events. Lifecycle events do not bypass the threshold. Logs go to the server JSONL file and stderr; existing stdout/stderr journal capture is unchanged.
+
+Browser console forwarding is enabled only at `"debug"`, not at the other levels, even for browser console errors. Treat this as diagnostic capture that may contain application data.
+
+This replaces the removed `debug` boolean. Use `logLevel: "debug"` for investigation, or omit the option for normal `"info"` logging. Configuration using `debug` is rejected.
+
 See [Storage locations](/docs/reference/storage-locations) for the server log location.
 
 ### `aiContextSnippets`
@@ -255,3 +270,38 @@ export default defineOvermuxDesktopConfig({
   macosTrafficLights: "hidden",
 });
 ```
+
+### `onBeforeInputEvent`
+
+The optional `onBeforeInputEvent` callback exposes Electron's [`before-input-event`](https://www.electronjs.org/docs/latest/api/web-contents#event-before-input-event), receiving the actual Electron `Event`, `Input`, and receiving [`WebContents`](https://www.electronjs.org/docs/latest/api/web-contents).
+
+You can use this callback to intercept Electron key presses.
+
+
+```ts
+import { defineOvermuxDesktopConfig } from "@overmux/desktop";
+
+export default defineOvermuxDesktopConfig({
+  onBeforeInputEvent: ({ event, input, webContents }) => {
+    const key = input.key.toLowerCase();
+    if (
+      process.platform !== "linux" ||
+      input.type !== "keyDown" ||
+      !input.meta ||
+      input.control ||
+      input.alt ||
+      input.shift ||
+      (key !== "c" && key !== "v")
+    ) {
+      return;
+    }
+
+    event.preventDefault();
+    if (key === "c") {
+      webContents.copy();
+    } else {
+      webContents.paste();
+    }
+  },
+});
+```

package/dist/docs/400-reference/500-server/000-index.md

@@ -11,3 +11,7 @@ Overmux's server architecture provides three primitives that package authors can
 - [Streams](./300-streams.md): Provide low-latency, bidirectional data flow between your UI and server, such as terminal input/output or live AI agent output.
 
 See [Notifications](./400-notifications.md) for sending notifications and [Server API](./500-api.md) for definition helpers and handler context.
+
+## Execution model
+
+Overmux uses workers, which are separate JavaScript threads. Resources and operations share one worker, while each named stream has its own. This keeps resource and operation work from blocking streams, helping streams stay responsive.

package/dist/docs/400-reference/500-server/100-resources.md

@@ -96,6 +96,8 @@ subscribe: async (_input, invalidate, context) => {
 
 `context.signal` is an `AbortSignal` that Overmux aborts when the client unsubscribes, disconnects, or the server shuts down. Cancellation does not automatically stop an async function: pass the signal to APIs that support it and check it after awaiting setup. Here, `realpath` does not accept a signal, so `throwIfAborted()` prevents starting a watcher if cancellation happened during that work.
 
+Both `read` and `subscribe` receive `context.logger` for [structured logging](./500-api.md#logging), including during cleanup.
+
 Overmux calls the returned cleanup function once, even if setup finishes after cancellation. Cleanup may also be asynchronous. In this example, the signal can close the watcher before Overmux calls cleanup; `watcher.close()` is safe to call again. If setup throws before returning cleanup, your handler must release any resources it already acquired.
 
 ## Derived
@@ -105,6 +107,9 @@ Derived resources compute a value from other resources.
 For example, count the entries returned by the `ls` resource above. Add `entryCount` alongside `ls` in your `resources` object:
 
 ```ts
+import { defineOvermuxServer, defineResourceContract, noInputSchema } from "overmux";
+import { z } from "zod";
+
 defineOvermuxServer({
   resources: {
     ls: {

package/dist/docs/400-reference/500-server/200-operations.md

@@ -43,6 +43,7 @@ handle: async (input, context) => {
 
 - **`invalidate(resourceId, input?)`**: tells clients to read an affected resource again after you change server-side data. See [Invalidating resources](./100-resources.md#invalidating-resources).
 - **[`notifications.send(...)`](./400-notifications.md)**: sends a notification through Overmux.
+- **[`logger`](./500-api.md#logging)**: writes structured logs with `debug`, `info`, `warn`, and `error`.
 
 See [Server API](./500-api.md#handler-context) for the full handler context.
 

package/dist/docs/400-reference/500-server/300-streams.md

@@ -129,12 +129,18 @@ Overmux calls `dispose` once when the session closes. Use it to stop timers, rem
 
 `useStream` closes its session when the component unmounts. You can also close it explicitly with `close()`.
 
-The handler context provides an abort `signal` for cancelling background work and `fail(cause)` for failing and closing the session. See [Server API: Stream handlers](./500-api.md#stream-handlers).
+The stream context provides an abort `signal` for cancelling background work and `fail(cause)` for failing and closing the session. See [Server API: Stream handlers](./500-api.md#stream-handlers).
+
+Use `context.logger` for [structured logging](./500-api.md#logging) in the handler and its message and cleanup callbacks.
 
 ## How streams work
 
 Streams communicate over a persistent WebSocket connection between your browser and server.
 
+Each named stream runs in its own worker. Resources, including derived resources, and operations share a separate application worker; module-local state is not shared with streams. See [Configuration](../200-configuration.md#server).
+
+Streams cannot invalidate resources. To mutate data and invalidate affected resources, have the client call an [operation](./200-operations.md). To refresh resources when an external source changes, use a [subscription resource watcher](./100-resources.md#subscription). A stream does not automatically invoke an operation.
+
 Overmux validates the opening input and messages against the stream contract. Client messages are passed to `onMessage` in order; calls to `emit` send messages to that session's client.
 
 A restored stream after a WebSocket reconnect creates a new server session. Do not assume that state held by the previous session survives.

package/dist/docs/400-reference/500-server/400-notifications.md

@@ -30,3 +30,7 @@ export const serverConfig = defineOvermuxServer({
 - `open.link`: optional destination to open when the notification is activated. Use an app-relative path starting with `/` or an HTTP(S) URL without credentials.
 
 Each text field and link has a maximum length of 4,096 characters. `send()` returns `Promise<void>`.
+
+## PWA background notifications
+
+Open `/_overmux/settings` on your Overmux server, and enable browser notifications. This requires HTTPS, or localhost for development. See [Hosted pages](../../500-hosted-pages.md) for adding a settings link to your application.

package/dist/docs/400-reference/500-server/500-api.md

@@ -40,6 +40,8 @@ export const serverConfig = defineOvermuxServer({
 
 Object keys are the IDs used by clients. See [Resources](./100-resources.md), [Operations](./200-operations.md), and [Streams](./300-streams.md) for usage guides.
 
+See [Configuration](../200-configuration.md#server) for worker ownership and shared-state constraints.
+
 ## Resource handlers
 
 A resource definition has a `contract` created with `defineResourceContract({ input, output })`. Overmux parses handler input with `input` and validates every result with `output`.
@@ -71,7 +73,7 @@ const resources = {
 
 `subscribe` returns a cleanup function, directly or asynchronously. Overmux aborts `context.signal` when the subscription ends, including during setup, on client disconnect, or on server shutdown. Overmux calls the returned cleanup function once, even if setup returns it after cancellation. The cleanup function itself may also be asynchronous. If setup throws before returning cleanup, the handler must release any resources it already acquired. See [Asynchronous setup](./100-resources.md#asynchronous-setup) for an example.
 
-A derived resource reads the resources named by `dependencies`; invalidating a dependency also invalidates its dependants. See [Resources](./100-resources.md) for contracts, derived dependencies, and invalidation.
+A derived resource reads the resources named by `dependencies`; invalidating a dependency also invalidates its dependants. See [Resources](./100-resources.md#derived) for contracts, derived dependencies, and invalidation.
 
 ## Stream handlers
 
@@ -88,10 +90,14 @@ const terminal = defineStreamHandler(contract, (input, context) => ({
 }));
 ```
 
-`open(input, context)` may return the session object or a promise for it. Its context extends the [handler context](#handler-context) with:
+`open(input, context)` may return the session object or a promise for it. Streams receive their own context, without `invalidate`:
 
 | API | Purpose |
 | --- | --- |
+| `signal` | An `AbortSignal` that aborts when the session or server runtime closes. |
+| `instance.getInstanceId()` | Get this server instance's ID. |
+| `instance.getDeepLinkPrefix()` | Get this instance's Overmux deep-link prefix. |
+| `logger` | Write [structured handler logs](#logging), including from `onMessage` and `dispose` closures. |
 | `emit(message)` | Validate and send a server message to this session. Calls after closure are ignored. |
 | `fail(cause)` | Fail and close this session. A later call has no effect. |
 
@@ -106,15 +112,30 @@ The stream `signal` aborts when its session or the runtime closes. Stop backgrou
 
 ## Handler context
 
-Inline resource, operation, and stream handlers infer valid resource IDs and inputs.
+Inline resource and operation handlers infer valid resource IDs and inputs.
 
-Resource and stream handlers receive a context with:
+Resource handlers receive a context with:
 
 | API | Purpose |
 | --- | --- |
 | `invalidate(resourceId, input?)` | Ask clients to [read a resource again](./100-resources.md#invalidating-resources). Pass the resource's key in `resources`. Omit `input` to invalidate all inputs; otherwise it is validated and only matching inputs are invalidated. Unknown IDs throw. |
-| `signal` | An `AbortSignal` that aborts when the request or session, or the server runtime, closes. |
+| `logger` | Write [structured handler logs](#logging). |
+| `signal` | An `AbortSignal` that aborts when the request or subscription, or the server runtime, closes. |
 | `instance.getInstanceId()` | Get this server instance's ID. |
 | `instance.getDeepLinkPrefix()` | Get this instance's Overmux deep-link prefix. |
 
 Operation handlers receive the same context plus `notifications.send(notification)`, which returns `Promise<void>`. See [Notifications](./400-notifications.md).
+
+### Logging
+
+Resource, stream, and operation handlers receive `context.logger`, with synchronous `debug`, `info`, `warn`, and `error` methods:
+
+```ts
+logger.info("read-complete", { count: 42 });
+```
+
+Each method accepts an event name and optional `Record<string, unknown>` details, returning `void`. The public type is `HandlerLogger` from `overmux`.
+
+Overmux automatically adds capability and request/session identity, including in message and cleanup closures. Logs go to the [server log file](/docs/reference/storage-locations) and stderr, filtered by [`logLevel`](../200-configuration.md#loglevel), which defaults to `"info"`.
+
+Logging remains usable after cancellation, and logging failures never fail handlers or cleanup. Delivery is best effort: oversized entries and logs that exceed a worker's bounded queue are dropped rather than delaying application work. Inputs, results, and stream contents are not logged automatically. Avoid secrets or sensitive payloads in your events and details.

package/dist/exports/client.d.ts

@@ -1,4 +1,4 @@
-import { B as InstanceIdentity, w as ContractInputArguments } from "./index-Dk11nKIv.js";
+import { H as InstanceIdentity, T as ContractInputArguments } from "./index-C-8Kzrnc.js";
 import { z } from "zod";
 import { UseMutationResult } from "@tanstack/react-query";
 import { CSSProperties, ComponentType, ReactNode, RefObject } from "react";

package/dist/exports/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/internal/client/background-notifications.ts","../../src/internal/client/native-web-view.tsx","../../src/internal/client/host/desktop-host.ts","../../src/internal/client/clipboard.ts","../../src/internal/client/browser-api.ts","../../src/internal/client/theme-scope.tsx","../../src/internal/client/client-definition.ts","../../src/internal/client/commands.tsx","../../src/internal/client/overmux-react.ts","../../src/internal/client/host/overmux-host.tsx","../../src/internal/client/shortcuts.tsx"],"mappings":"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"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/internal/client/background-notifications.ts","../../src/internal/client/native-web-view.tsx","../../src/internal/client/host/desktop-host.ts","../../src/internal/client/clipboard.ts","../../src/internal/client/browser-api.ts","../../src/internal/client/theme-scope.tsx","../../src/internal/client/client-definition.ts","../../src/internal/client/commands.tsx","../../src/internal/client/overmux-react.ts","../../src/internal/client/host/overmux-host.tsx","../../src/internal/client/shortcuts.tsx"],"mappings":";;;;;;cA2Ja,qCAA6B;cAkB7B,sCAA8B;;;KCvK/B;EACV;EACA;EACA;;KAEU;EACV;EACA;EACA,QAAQ;EACR,WAAW;EACX,eAAe,OAAO;EACtB;EACA,+BAA+B;;cA2DpB,kBAAiB,KAAA,WAAA,OAAA,UAAA,aAAA,oBAAA,uBAQ3B,uCAAkB,IAAA;;;KChFT;EACV;EACA,UACE;IACM;IAA4B;;IAE5B;IACA;IACA;IACA;IACA,8BAA8B;QAEjC;EACL,YACE,YACA;IAAU;IAAW;IAAW;IAAe;;EAEjD,cACE,WAAW;IAAS;IAAY,OAAO;;;KAItC;EACH;EACA;EACA,gBAAgB;EAChB;IAAa,SAAS;MAAY;;IAA+B;;EACjE;IAAc,YAAY;IAAuB;;EACjD;IAAkB,OAAO;IAAgC;;;QAGnD;YACI;IACR,cAAc;;;;;cCnCL,yBAA8B;cAQ9B,qBAA4B,iBAAe;;;KCFnD,aAAW,WAAW;EAAkB,mBAAmB;IAC5D,YAAY;KAEX,UAAQ,KAAK;EAAY,aAAa,eAAe,EAAE;IACxD;KAEC,WAAS,KAAK;EAAY,cAAc,gBAAgB,EAAE;IAC3D,EAAE,OAAO;KAER,YAAY,WAAW,cAAc,aAAW;KAChD,eAAe,SAAS,YAAY,YAAY,YAAY,UAC/D,aAAW,SAAS;KAEjB,gBAAgB,SAAS,YAAY,YAAY,YAAY,WAChE,aAAW,SAAS;KAEjB,mBAAmB,eAAe,EAAE,eACpC,uBAAuB,SAC1B,SAAS;KAGN;EACH;EACA;;KAGU,iBAAiB,iBAAiB;EAC5C,mBAAmB,YAAY,YAAY,gBACzC,IAAI,QACD,MAAM,mBAAmB,eAAe,eAAe,UACvD,QAAQ,gBAAgB,eAAe;;;;KC3BlC;KACA;cAEC;KAoBD,4BAA4B;KAE5B,eAAe,gBACzB,QAAQ,OAAO;KAEL;EACV,WAAW;EACX;;KAGU;EACV,UAAU;EACV,WAAW;;KAGD;EACV,UAAU;EACV;EACA,WAAW;EACX,SAAS;EACT,QAAQ;;cAoBG,kBAAiB,UAAA,YAAwB,uCAAkB;cAK3D,sBAAqB,UAAA,WAAA,UAAA,QAAA,SAM/B,2CAAsB,IAAA;;;KClEb;EACV,SAAS;EACT;IAAQ;;;KAEE,iBAAiB,oBAAkB;KACnC;EACV,SAAS;EACT;;KAeG,qBAAmB;KACnB,WAAW,eAAe,YAAY;EACzC,kBAAkB,iBAAiB;EACnC,QAAQ;MACJ;KACD;EACH,2BAA2B;EAC3B,SAAS,EAAE;EACX;EACA;;KAEG,eAAa,YAAY;EAC5B,cAAc,gBAAgB,EAAE;IAE9B;KAEC,aAAa,YAChB,eAAa,kBAAkB,EAAE,UAC7B,EAAE,OAAO,eAAa;KAEvB,eAAe,eAAe,iBAAiB,8BACjD,cAAc,WAAW,qBACtB,WAAW,eAAe,aAAa,aACvC,SAAS;EAEb,2BAA2B;EAC3B,SAAS,EAAE;EACX;;KAEG,gBACH,eACA,kBAAkB,eAAe,+BAEhC,aAAa,YAAY,eAAe,eAAe,UAAU;KAGxD,cAAc;EACxB,2BAA2B;EAC3B,IAAI;EACJ,SAAS,EAAE;EACX;EACA;;KAGG,gBACH,eACA,kBAAkB,eAAe,wCAEvB,aAAa,YAAY,eACjC,eACA,UAAU;WACG,IAAI,QAAQ;;cAMhB,wBACV,2BACM,kBAAkB,eAAe,0BACtC,UAAU,gBAAgB,eAAe,eACxC,gBAAgB,eAAe;KAQxB,kBAAkB,SAAS,eAAe;KAE1C;EACV,WAAW;EACX,SAAS;;KAGC,oBACV,kBAAkB,kBAAkB;EAEpC,aAAa;EACb,yBAAyB;EACzB,UAAU;EACV,WAAW;EAGX,YAAY;EACZ,oBAAoB,QAClB,OAAO,cAAc,6BAA6B;;cAIzC,4BAA6B,kBAAkB,iBAC1D,YAAY,oBAAoB,eAC/B,oBAAoB;;;KClHlB,mBAAmB;KACnB,wBAAwB;KACxB,aAAa,YAAY;EAC5B,cAAc,gBAAgB,EAAE;IAE9B;KAEC,mBAAmB,YACtB,aAAa,kBAAkB,EAAE;EAC3B,QAAQ,EAAE,MAAM,aAAa;;EAC7B;;KACH,gBAAgB,YAAY;EAC/B,SAAS;;EAEL,MAAM;;EACN,KAAK;;KACN,oBAAoB,YAAY,mBAAmB,YACtD,gBAAgB;EACd,UAAU,UAAU;EACpB;;KAEC,uBAAuB,YAC1B,aAAa,kBAAkB,EAAE,UAC7B,oBAAoB,YAAY,YAChC,oBAAoB;cAEb;KACD,mBAAmB;cAmFlB,aAAc,iBAAiB,eAC1C,SAAS,UACT,cAAc,uBAAuB;KAqF3B;EACV,mBAAmB;EACnB;EACA;EACA,eAAe;EACf;EACA;;cAmCW,4BAAW;;;KC7OnB,UAAU,WAAW;EAAkB,kBAAkB;IAC1D,YAAY;KAEX,WAAW,WAAW;EAAkB,mBAAmB;IAC5D,YAAY;KAEX,QAAQ,WAAW;EAAkB,gBAAgB;IACtD,YAAY;KAEX,WAAW,KAAK;EAAY,gBAAgB;IAC7C;KAEC,QAAQ,KAAK;EAAY,aAAa,eAAe,EAAE;IACxD;KAEC,SAAS,KAAK;EAAY,cAAc,gBAAgB,EAAE;IAC3D,EAAE,OAAO;KAER,gBAAgB,KACnB,WAAW;EACT,qBAAqB,iBAAiB,EAAE;IAEtC,EAAE,MAAM;KAET,gBAAgB,KACnB,WAAW;EACT,qBAAqB,iBAAiB,EAAE;IAEtC,EAAE,OAAO;KAEV,cAAc,eAAe,EAAE,6BAChB,EAAE,MAAM;EACpB,QAAQ,QAAQ,EAAE,MAAM;;EACxB,OAAO,EAAE,MAAM;;KAClB,iBAAiB,oBAAoB,eAAe,EAAE;EACzD,IAAI;IACF,cAAc;KACb,YAAY;GACd,YAAY,cAAc,UAAU,yBACnC,SAAS,iBACP,KACA,QAAQ,WAAW,UAAU,eAAe,UAE7C,eAAe,SAAS,WAAW,UAAU,eAAe;GAC9D,YAAY,cAAc,UAAU,yBAAyB;IAC5D,IAAI;IACJ,OAAO;;GAER,YAAY,cAAc,UAAU,yBAAyB;IAC5D,IAAI;IACJ,OACI,EAAE,MAAM,QAAQ,WAAW,UAAU,eAAe,UACpD;MAEF,eAAe,SAAS,WAAW,UAAU,eAAe;;KAItD,eAAe;EAErB;EACA;EACA;EACA;;EAGA,OAAO;EACP,OAAO;EACP;EACA;;EAGA,MAAM;EACN;EACA;EACA;;KAGM,aAAa,gBAAgB;EAIvC;EACA;EACA,QAAQ;EACR,OAAO,SAAS;EAChB;EACA,YAAY,WAAW,SAAS;;KAG7B,gBAAgB,qBAAqB,EAAE,SAAS,WAAW,KAC9D,kBAAkB,SAAS,OAAO,EAAE,MAAM;EAG1C,YAAY,MAAM,uBAAuB;EACzC,iBACK,MAAM,uBAAuB,kBAC7B,QAAQ;;cA2RF,qBAAsB;EATX,mBAAA;EAWP,eAAA,YAAY,cAAc,WAAW,2BAAuB,IAAA;IAIzE,IAAI;IACJ,SAAS;QACV,gBAAA,QAAA,WAAA,eAAA,OAAA,SAAA,WAAA,eAAA;EAUO,aAAA,YAAY;EACR,YAAA,YAAY,cAAc,QAAQ,2BAAuB,IAAA,SAGlE,iBAAiB,KAAK,QAAQ,WAAW,QAAQ,eAAe,YAAO,aAAA,gBAAA,QAAA,eAAA,OAAA,gBAAA,QAAA,eAAA;;;;cClO/D,gBAAe;EAG1B,YAAY;sBACb,IAAA;;;KCpFW;EACV,WAAW,UAAU;EACrB,OAAO,UAAU;;cAQN,yBAA0B,QAAQ"}

package/dist/exports/client.js

@@ -1,5 +1,5 @@
 import "./style.css";
-import { a as notificationSchema, c as parseDeepLink, l as resolveOvermuxReturnTo, o as overmuxLogoutPath, r as instanceIdSchema, t as createInstanceIdentity } from "./notifications-BFAD3QQl.js";
+import { i as logLevelSchema, l as parseDeepLink, o as notificationSchema, r as instanceIdSchema, s as overmuxLogoutPath, t as createInstanceIdentity, u as resolveOvermuxReturnTo } from "./notifications-BBKvKZgI.js";
 import { z } from "zod";
 import { QueryClient, QueryClientProvider, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { Component, createContext, createElement, useCallback, useContext, useEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
@@ -26,9 +26,9 @@ const webSocketCloseCode = {
 	authenticationUnavailable: 4002
 };
 const runtimeManifestSchema = z.object({
-	debug: z.boolean(),
+	logLevel: logLevelSchema,
 	operations: z.array(z.string().min(1)),
-	protocolVersion: z.literal(10),
+	protocolVersion: z.literal(11),
 	resources: z.array(z.string().min(1)),
 	streams: z.array(z.string().min(1))
 });
@@ -192,6 +192,42 @@ const decodeProtocolFrame = (frame) => {
 	return decodeBinaryValue(header, bytes.subarray(8 + headerLength));
 };
 //#endregion
+//#region src/internal/client/register-push-worker.ts
+const registerPushWorker = () => new Promise((resolve, reject) => {
+	let watched = null;
+	let settled = false;
+	const finish = (error, registration) => {
+		if (settled) return;
+		settled = true;
+		clearTimeout(timeout);
+		watched?.removeEventListener("statechange", onStateChange);
+		if (error) reject(error);
+		else resolve(registration);
+	};
+	let registered;
+	const onStateChange = () => {
+		if (watched?.state === "activated") finish(void 0, registered);
+		else if (watched?.state === "redundant") finish(/* @__PURE__ */ new Error("The background notification worker failed to activate"));
+	};
+	const timeout = setTimeout(() => {
+		finish(/* @__PURE__ */ new Error("Timed out starting the background notification worker"));
+	}, 1e4);
+	navigator.serviceWorker.register("/sw.js", {
+		scope: "/",
+		updateViaCache: "none"
+	}).then((registration) => {
+		if (settled) return;
+		registered = registration;
+		watched = registration.active ?? registration.installing ?? registration.waiting;
+		if (!watched) {
+			finish(/* @__PURE__ */ new Error("No background notification worker was installed"));
+			return;
+		}
+		watched.addEventListener("statechange", onStateChange);
+		onStateChange();
+	}, (error) => finish(error instanceof Error ? error : new Error(String(error))));
+});
+//#endregion
 //#region src/internal/client/background-notifications.ts
 const enabledStorageKey = "overmux.backgroundNotificationsEnabled";
 const isIos = () => /iPad|iPhone|iPod/u.test(navigator.userAgent) || navigator.platform === "MacIntel" && navigator.maxTouchPoints > 1;
@@ -257,7 +293,7 @@ const removeCurrentSubscription = async () => {
 	if (!await subscription.unsubscribe()) throw new Error("The background subscription could not be removed");
 };
 const reconcileBackgroundNotifications = async () => {
-	const registration = await navigator.serviceWorker.ready;
+	const registration = await registerPushWorker();
 	const publicKey = await getPublicKey();
 	let subscription = await registration.pushManager.getSubscription();
 	const subscriptionKey = subscription ? encodeApplicationServerKey(subscription.options.applicationServerKey) : void 0;
@@ -1510,13 +1546,17 @@ const statusMessage = (status) => {
 };
 const BrowserNotificationSettings = () => {
 	const [status, setStatus] = useState("checking");
+	const [error, setError] = useState();
 	useEffect(() => {
 		let active = true;
 		const reconcile = () => {
 			reconciledStatus().then((next) => {
 				if (active) setStatus(next);
-			}).catch(() => {
-				if (active) setStatus("error");
+			}).catch((cause) => {
+				if (active) {
+					setError(cause instanceof Error ? cause.message : void 0);
+					setStatus("error");
+				}
 			});
 		};
 		const onVisibilityChange = () => {
@@ -1536,7 +1576,8 @@ const BrowserNotificationSettings = () => {
 			setStatus("checking");
 			const enabled = await enableBackgroundNotifications();
 			setStatus(enabled ? "enabled" : Notification.permission === "denied" ? "denied" : "disabled");
-		} catch {
+		} catch (cause) {
+			setError(cause instanceof Error ? cause.message : void 0);
 			setStatus("error");
 		}
 	}, []);
@@ -1545,7 +1586,8 @@ const BrowserNotificationSettings = () => {
 			setStatus("checking");
 			await disableBackgroundNotifications();
 			setStatus("disabled");
-		} catch {
+		} catch (cause) {
+			setError(cause instanceof Error ? cause.message : void 0);
 			setStatus("error");
 		}
 	}, []);
@@ -1555,10 +1597,10 @@ const BrowserNotificationSettings = () => {
 		"data-om-browser-notifications": "",
 		children: [
 			/* @__PURE__ */ jsx("h3", { children: "Browser notifications" }),
-			/* @__PURE__ */ jsx("p", {
+			/* @__PURE__ */ jsxs("p", {
 				"aria-live": "polite",
 				"data-om-background-notifications-status": "",
-				children: statusMessage(status)
+				children: [statusMessage(status), status === "error" && error ? ` ${error}` : null]
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				"data-om-hosted-actions": "",
@@ -1820,7 +1862,6 @@ const OvermuxRuntime = ({ definition }) => {
 	const safeMode = new URLSearchParams(location.search).get("safe") === "1";
 	const transport = useMemo(createClientTransport, []);
 	const queryClient = useMemo(() => new QueryClient(), []);
-	const logForwardingDisposer = useRef(void 0);
 	const [manifest, setManifest] = useState();
 	const [error, setError] = useState();
 	useEffect(() => {
@@ -1843,13 +1884,13 @@ const OvermuxRuntime = ({ definition }) => {
 	const registrations = useMemo(() => /* @__PURE__ */ new Set(), []);
 	const [registrationRevision, setRegistrationRevision] = useState(0);
 	useEffect(() => {
-		if (manifest?.debug && !logForwardingDisposer.current) logForwardingDisposer.current = installBrowserLogForwarding(transport.reportDiagnostic);
-	}, [manifest?.debug, transport]);
+		if (manifest?.logLevel !== "debug") return;
+		return installBrowserLogForwarding(transport.reportDiagnostic);
+	}, [manifest?.logLevel, transport]);
 	useEffect(() => transport.subscribeStatus((status) => {
 		if (status === "authentication-required") redirectToLogin();
 	}), [transport]);
 	useEffect(() => () => {
-		logForwardingDisposer.current?.();
 		transport.dispose();
 	}, [transport]);
 	useEffect(() => installNotificationForwarding(transport), [transport]);