overmux 0.0.4 → 0.0.6

package/dist/docs/400-reference/700-cli/600-docs.md

@@ -0,0 +1,128 @@
+---
+title: "`overmux docs`"
+---
+
+Overmux documentation and AI context commands
+
+## `overmux docs path`
+
+`overmux docs path` prints the installed Overmux CLI’s absolute documentation path.
+
+```console
+$ overmux docs path
+/path/to/somewhere/node_modules/overmux/docs
+```
+
+## `overmux docs ai-context`
+
+`overmux docs ai-context` prints `CLAUDE.md`/`AGENTS.md` guidance for coding agents.
+
+### Usage
+
+```text
+overmux docs ai-context
+```
+
+Prints the selected snippets shown in [available snippets](#available-snippets).
+
+### Set up your coding agent
+
+Tell your agent how to load Overmux guidance using `overmux docs ai-context`.
+
+<CodeBlockTabs defaultValue="agents">
+  <CodeBlockTabsList>
+    <CodeBlockTabsTrigger value="agents">AGENTS.md</CodeBlockTabsTrigger>
+    <CodeBlockTabsTrigger value="claude">CLAUDE.md</CodeBlockTabsTrigger>
+  </CodeBlockTabsList>
+  <CodeBlockTab value="agents">
+
+```bash
+echo 'Run `overmux docs ai-context` for help configuring Overmux.' >> AGENTS.md
+```
+
+  </CodeBlockTab>
+  <CodeBlockTab value="claude">
+
+```bash
+echo 'Run `overmux docs ai-context` for help configuring Overmux.' >> CLAUDE.md
+```
+
+  </CodeBlockTab>
+</CodeBlockTabs>
+
+### Configure context snippets
+
+Use `aiContextSnippets` in `overmux.config.ts` to select which snippets `overmux docs ai-context` prints.
+
+```ts
+import {
+  coreAiContextSnippets,
+  defineOvermuxConfig,
+} from "overmux";
+
+export default defineOvermuxConfig({
+  aiContextSnippets: coreAiContextSnippets,
+  // ...
+});
+```
+
+When `aiContextSnippets` is omitted, Overmux uses `defaultAiContextSnippets`. Set it to an empty array to emit no context.
+
+You can compose an explicit selection from the individual exports:
+
+```ts
+import {
+  defineOvermuxConfig,
+  packageSourceSnippet,
+  techStackRecommendationsSnippet,
+} from "overmux";
+
+export default defineOvermuxConfig({
+  aiContextSnippets: [
+    packageSourceSnippet,
+    techStackRecommendationsSnippet,
+  ],
+  // ...
+});
+```
+
+### Options
+
+| Flag | Description | Default |
+| --- | --- | --- |
+| `--config <path>, -c <path>` | Configuration file | `$XDG_CONFIG_HOME/overmux/overmux.config.ts` |
+
+### Snippet presets
+
+[//]: # (BEGIN GENERATED AI CONTEXT PRESETS)
+
+| Export | Included snippets |
+| --- | --- |
+| `defaultAiContextSnippets` | `package-source`, `tech-stack-recommendations` |
+| `coreAiContextSnippets` | `package-source` |
+
+[//]: # (END GENERATED AI CONTEXT PRESETS)
+
+### Available snippets
+
+[//]: # (BEGIN GENERATED AI CONTEXT)
+
+#### `package-source`
+
+```text
+Overmux ships with documentation and TypeScript source.
+
+Run `overmux docs path` to find the installed documentation directory for the Overmux CLI. This prints a documentation directory, not source paths.
+
+Inspect TypeScript source in installed packages, e.g. `node_modules/overmux/src` and `node_modules/@overmux/xterm/src`.
+
+Inspect these files so guidance matches the versions used by the application.
+```
+
+#### `tech-stack-recommendations`
+
+```text
+Prefer pnpm as the package manager, TanStack Router for routing, shadcn/ui for UI components, and Zod for schemas and runtime validation. Follow the application's established stack when it already differs.
+```
+
+[//]: # (END GENERATED AI CONTEXT)

package/dist/docs/400-reference/{400-cli → 700-cli}/700-desktop.md

@@ -1,9 +1,7 @@
 ---
-title: "overmux desktop"
+title: "`overmux desktop`"
 ---
 
-# `overmux desktop`
-
 Install or upgrade the experimental macOS desktop preview. The desktop version is independent from the `overmux` npm package version.
 
 ## Install

package/dist/docs/500-hosted-pages.md

@@ -1,6 +1,5 @@
 ---
 title: Hosted pages
-description: Link to Overmux-owned settings and logout pages.
 ---
 
 # Hosted pages

package/dist/exports/client.d.ts

@@ -1,8 +1,8 @@
-import { R as InstanceIdentity, w as ContractInputArguments } from "./index-DS70rKzo.js";
+import { B as InstanceIdentity, w as ContractInputArguments } from "./index-Cz3xkCa4.js";
 import { z } from "zod";
 import { UseMutationResult } from "@tanstack/react-query";
 import { CSSProperties, ComponentType, ReactNode, RefObject } from "react";
-import { KeyBinding, KeyBinding as KeyBinding$1, formatKeyBinding, keyBindingSchema, matchesKeyBinding } from "@overmux/keybindings";
+import { KeyBinding, KeyBinding as KeyBinding$1 } from "@overmux/keybindings";
 declare const enableBackgroundNotifications: () => Promise<boolean>;
 declare const disableBackgroundNotifications: () => Promise<void>;
 type DesktopHost = {
@@ -85,17 +85,6 @@ type ChordPrefix = {
   binding: KeyBinding$1;
   unmatched: "replay-to-focused-input";
 };
-declare const shortcutBindingSchema: z.ZodUnion<readonly [z.ZodCustom<KeyBinding$1, KeyBinding$1>, z.ZodArray<z.ZodCustom<KeyBinding$1, KeyBinding$1>>]>;
-declare const commandBindingSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodCustom<KeyBinding$1, KeyBinding$1>, z.ZodArray<z.ZodCustom<KeyBinding$1, KeyBinding$1>>]>, z.ZodObject<{
-  binding: z.ZodUnion<readonly [z.ZodCustom<KeyBinding$1, KeyBinding$1>, z.ZodArray<z.ZodCustom<KeyBinding$1, KeyBinding$1>>]>;
-  when: z.ZodObject<{
-    media: z.ZodString;
-  }, z.core.$strip>;
-}, z.core.$strip>]>;
-declare const chordPrefixSchema: z.ZodObject<{
-  binding: z.ZodCustom<KeyBinding$1, KeyBinding$1>;
-  unmatched: z.ZodLiteral<"replay-to-focused-input">;
-}, z.core.$strip>;
 declare const formatShortcutBinding: (binding: ShortcutBinding) => string;
 type CommandRunResult$1 = Promise<unknown> | unknown;
 type CommandRun<TServerConfig, TParams> = (input: {
@@ -139,6 +128,7 @@ type ClientAppDefinition<TCommands extends CommandRegistry = CommandRegistry> =
   chordPrefixes?: readonly ChordPrefix[];
   commands: TCommands;
   component: ComponentType;
+  navigate?: (route: string) => unknown;
   shortcutOverrides?: Partial<Record<Extract<keyof TCommands, string>, readonly CommandBinding[]>>;
 };
 declare const defineOvermuxClient: <const TCommands extends CommandRegistry>(definition: ClientAppDefinition<TCommands>) => ClientAppDefinition<TCommands>;
@@ -236,6 +226,7 @@ type ResourceResult<T> = {
   status: "success";
 };
 type StreamResult<TClientMessage, TServerMessage> = {
+  connectionId: symbol | undefined;
   close: () => void;
   error?: Error;
   send: (message: TClientMessage) => boolean;
@@ -263,5 +254,5 @@ type ShortcutInputTarget = {
   input: RefObject<HTMLElement | null>;
 };
 declare const useShortcutInputTarget: (target: ShortcutInputTarget) => void;
-export { type ChordPrefix, type CommandBinding, type CommandEntry, type CommandHandle, type ConditionalShortcutBinding, type InstanceIdentity, type KeyBinding, type KeySequence, type OvermuxClientAppearance, type OvermuxContrast, type OvermuxExternalPortalContainer, OvermuxHost, OvermuxPortal, type OvermuxPortalProps, type OvermuxScheme, type OvermuxServerApi, type OvermuxStyle, OvermuxThemeScope, type OvermuxThemeScopeProps, type OvermuxThemeToken, type ResourceResult, type ShortcutBinding, type ShortcutInputTarget, type SkipToken, type StreamResult, chordPrefixSchema, commandBindingSchema, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatKeyBinding, formatShortcutBinding, keyBindingSchema, matchesKeyBinding, readClipboardText, shortcutBindingSchema, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
+export { type ChordPrefix, type CommandBinding, type CommandEntry, type CommandHandle, type ConditionalShortcutBinding, type InstanceIdentity, type KeyBinding, type KeySequence, type OvermuxClientAppearance, type OvermuxContrast, type OvermuxExternalPortalContainer, OvermuxHost, OvermuxPortal, type OvermuxPortalProps, type OvermuxScheme, type OvermuxServerApi, type OvermuxStyle, OvermuxThemeScope, type OvermuxThemeScopeProps, type OvermuxThemeToken, type ResourceResult, type ShortcutBinding, type ShortcutInputTarget, type SkipToken, type StreamResult, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
 //# sourceMappingURL=client.d.ts.map

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/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/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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"}

package/dist/exports/client.js

@@ -1,9 +1,9 @@
 import "./style.css";
-import { a as notificationSchema, l as resolveOvermuxReturnTo, o as overmuxLogoutPath, r as instanceIdSchema, t as createInstanceIdentity } from "./notifications-av0FK0yZ.js";
+import { a as notificationSchema, c as parseDeepLink, l as resolveOvermuxReturnTo, o as overmuxLogoutPath, r as instanceIdSchema, t as createInstanceIdentity } from "./notifications-BFAD3QQl.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";
-import { formatKeyBinding, formatKeyBinding as formatKeyBinding$1, keyBindingSchema, keyBindingSchema as keyBindingSchema$1, matchesKeyBinding, matchesKeyBinding as matchesKeyBinding$1, platformBinding } from "@overmux/keybindings";
+import { formatKeyBinding, keyBindingSchema, matchesKeyBinding, platformBinding } from "@overmux/keybindings";
 import { createPortal } from "react-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/internal/shared/background-notifications.ts
@@ -320,16 +320,16 @@ const writeClipboardText = async (text) => {
 };
 //#endregion
 //#region src/internal/client/client-definition.ts
-const shortcutBindingSchema = z.union([keyBindingSchema$1, z.array(keyBindingSchema$1).min(2)]);
+const shortcutBindingSchema = z.union([keyBindingSchema, z.array(keyBindingSchema).min(2)]);
 const commandBindingSchema = z.union([shortcutBindingSchema, z.object({
 	binding: shortcutBindingSchema,
 	when: z.object({ media: z.string().trim().min(1) })
 })]);
 const chordPrefixSchema = z.object({
-	binding: keyBindingSchema$1,
+	binding: keyBindingSchema,
 	unmatched: z.literal("replay-to-focused-input")
 });
-const formatShortcutBinding = (binding) => typeof binding === "string" ? formatKeyBinding$1(binding) : binding.map(formatKeyBinding$1).join(" ");
+const formatShortcutBinding = (binding) => typeof binding === "string" ? formatKeyBinding(binding) : binding.map(formatKeyBinding).join(" ");
 const validateBindings = (bindings) => bindings?.forEach((binding) => commandBindingSchema.parse(binding));
 const defineCommandRegistry = () => (commands) => Object.fromEntries(Object.entries(commands).map(([id, command]) => {
 	validateBindings(command.defaultBindings);
@@ -519,57 +519,98 @@ const useOperationById = (id, signal) => {
 const useStreamById = (id, input) => {
 	const { manifest, overmuxServerApi } = useRuntime();
 	const streamAvailable = manifest.streams.includes(id);
-	const [state, setState] = useState({ status: "opening" });
-	const listeners = useMemo(() => /* @__PURE__ */ new Set(), []);
 	const canonicalInput = useCanonicalInput(input);
+	const scope = useMemo(() => ({
+		canonicalInput,
+		id,
+		overmuxServerApi,
+		streamAvailable
+	}), [
+		canonicalInput,
+		id,
+		overmuxServerApi,
+		streamAvailable
+	]);
+	const [state, setState] = useState({
+		scope,
+		status: "opening"
+	});
+	const [listeners] = useState(() => /* @__PURE__ */ new Set());
 	const streamRef = useRef(void 0);
 	useEffect(() => {
 		streamRef.current?.close();
 		streamRef.current = void 0;
-		if (!streamAvailable) {
-			setState({ status: "closed" });
+		if (!scope.streamAvailable) {
+			setState({
+				scope,
+				status: "closed"
+			});
 			return;
 		}
-		setState({ status: "opening" });
-		const stream = overmuxServerApi.openStream({
-			id,
-			input: canonicalInput,
-			onClose: () => setState({ status: "closed" }),
-			onError: (error) => setState({
+		setState({
+			scope,
+			status: "opening"
+		});
+		let active = true;
+		const stream = scope.overmuxServerApi.openStream({
+			id: scope.id,
+			input: scope.canonicalInput,
+			onClose: () => active && setState({
+				scope,
+				status: "closed"
+			}),
+			onError: (error) => active && setState({
+				scope,
 				error,
 				status: "closed"
 			}),
-			onOpen: () => setState({ status: "open" }),
-			onMessage: (message) => listeners.forEach((listener) => listener(message))
+			onOpen: () => active && setState({
+				scope,
+				connectionId: Symbol(scope.id),
+				status: "open"
+			}),
+			onMessage: (message) => active && listeners.forEach((listener) => listener(message))
 		});
-		streamRef.current = stream;
-		return () => {
-			stream.close();
-			if (streamRef.current === stream) streamRef.current = void 0;
+		const connection = {
+			close: () => {
+				if (!active) return;
+				active = false;
+				if (streamRef.current === connection) streamRef.current = void 0;
+				setState({
+					scope,
+					status: "closed"
+				});
+				stream.close();
+			},
+			send: stream.send
 		};
-	}, [
-		canonicalInput,
-		id,
-		listeners,
-		overmuxServerApi,
-		streamAvailable
-	]);
-	const close = useCallback(() => {
-		streamRef.current?.close();
-		streamRef.current = void 0;
-		setState({ status: "closed" });
-	}, []);
-	const send = useCallback((message) => streamRef.current?.send(message) ?? false, []);
-	const subscribe = useCallback((listener) => {
-		listeners.add(listener);
-		return () => listeners.delete(listener);
-	}, [listeners]);
+		streamRef.current = connection;
+		return connection.close;
+	}, [listeners, scope]);
+	const [methods] = useState(() => ({
+		close: () => streamRef.current?.close(),
+		send: (message) => streamRef.current?.send(message) ?? false,
+		subscribe: (listener) => {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	}));
+	if (!streamAvailable) return {
+		...methods,
+		connectionId: void 0,
+		error: /* @__PURE__ */ new Error(`Stream is not available: ${id}`),
+		status: "closed"
+	};
+	if (state.scope !== scope) return {
+		...methods,
+		connectionId: void 0,
+		status: "opening"
+	};
 	return {
-		close,
-		error: streamAvailable ? state.error : /* @__PURE__ */ new Error(`Stream is not available: ${id}`),
-		send,
-		status: streamAvailable ? state.status : "closed",
-		subscribe
+		...methods,
+		connectionId: state.connectionId,
+		error: state.error,
+		status: state.status
 	};
 };
 const undiscoveredInstance = () => void 0;
@@ -763,12 +804,62 @@ const installInstanceForwarding = (transport) => {
 	return unsubscribe;
 };
 //#endregion
+//#region src/internal/client/host/deep-link-navigation.ts
+const defaultNavigate = (route) => window.location.assign(route);
+/**
+* Intercepts overmux:// anchor activation inside the running app, including the
+* temporary anchors created by xterm's default link handler. Without this,
+* browser/PWA clicks dispatch the custom protocol to the OS, which fails in
+* Android PWAs where it is not possible to install an Overmux protocol handler.
+*
+* Validates the original URL and compares its instance ID with authenticated
+* runtime discovery. For same-instance links, preventDefault stops OS dispatch
+* and navigate receives only the local path, query, and fragment. By default,
+* this loads that route on the current origin; a supplied router callback avoids
+* a document reload. Instance IDs are never treated as network hostnames.
+*
+* Valid cross-instance links remain Desktop's responsibility. Browsers/PWAs
+* block unknown or different instances; all hosts block invalid links. Ordinary
+* links and clicks already cancelled by application code are left untouched.
+* Returns cleanup for the document listeners when the runtime unmounts.
+*/
+const installDeepLinkNavigation = ({ getInstance, navigate = defaultNavigate }) => {
+	const onClick = (event) => {
+		if (event.defaultPrevented || event.button > 1) return;
+		const anchor = event.composedPath().find((target) => target instanceof HTMLAnchorElement);
+		if (anchor?.protocol !== "overmux:") return;
+		let link;
+		try {
+			link = parseDeepLink(anchor.getAttribute("href") ?? "");
+		} catch {
+			event.preventDefault();
+			console.warn("Cannot open an invalid Overmux deep link.");
+			return;
+		}
+		if (link.instanceId !== getInstance()?.instanceId) {
+			if (window.overmuxHost?.version !== 1) {
+				event.preventDefault();
+				console.warn("Cannot open an Overmux link to an unknown or different instance in this browser.");
+			}
+			return;
+		}
+		event.preventDefault();
+		navigate(link.route);
+	};
+	document.addEventListener("click", onClick);
+	document.addEventListener("auxclick", onClick);
+	return () => {
+		document.removeEventListener("click", onClick);
+		document.removeEventListener("auxclick", onClick);
+	};
+};
+//#endregion
 //#region src/internal/client/shortcuts.tsx
 const bindingSequence = (binding) => typeof binding === "string" ? [binding] : [...binding];
 const normalizedBinding = (binding) => bindingSequence(binding).map((key) => platformBinding(key));
 const sequenceMatches = (binding, pending, event) => {
 	const sequence = normalizedBinding(binding);
-	return sequence.length > pending.length && pending.every((key, index) => sequence[index] === key) && matchesKeyBinding$1(sequence[pending.length], event);
+	return sequence.length > pending.length && pending.every((key, index) => sequence[index] === key) && matchesKeyBinding(sequence[pending.length], event);
 };
 const isTextInput = (element) => element instanceof HTMLInputElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement || element instanceof HTMLElement && (element.isContentEditable || element.getAttribute("role") === "textbox");
 const acceptsTextInput = (bindings) => {
@@ -924,7 +1015,7 @@ const ShortcutHost = ({ children, definition, registrations, registrationRevisio
 				if (runShortcut(complete.shortcut, event, registrations)) event.stopPropagation();
 				return;
 			}
-			if (!pending.length) pendingTarget = definition.chordPrefixes?.some((prefix) => matchesKeyBinding$1(prefix.binding, event)) ? selectShortcutInputTarget(inputTargets, document.activeElement) : void 0;
+			if (!pending.length) pendingTarget = definition.chordPrefixes?.some((prefix) => matchesKeyBinding(prefix.binding, event)) ? selectShortcutInputTarget(inputTargets, document.activeElement) : void 0;
 			pending = [...pending, normalizedBinding(matches[0].binding)[pending.length]];
 			pendingEvents = [...pendingEvents, event];
 			event.preventDefault();
@@ -1703,6 +1794,10 @@ const OvermuxRuntime = ({ definition }) => {
 	}, [transport]);
 	useEffect(() => installNotificationForwarding(transport), [transport]);
 	useEffect(() => installInstanceForwarding(transport), [transport]);
+	useEffect(() => installDeepLinkNavigation({
+		getInstance: transport.getInstance,
+		navigate: definition.navigate
+	}), [transport, definition.navigate]);
 	const refreshCommands = useCallback(() => setRegistrationRevision((revision) => revision + 1), []);
 	const registerCommand = useCallback((registration) => {
 		registrations.add(registration);
@@ -1747,6 +1842,6 @@ const OvermuxHost = ({ definition }) => /* @__PURE__ */ jsx(OvermuxThemeScope, {
 	children: location.pathname === "/_overmux/settings" ? /* @__PURE__ */ jsx(HostedSettingsPage, {}) : location.pathname === "/_overmux/logout" ? /* @__PURE__ */ jsx(HostedLogoutPage, {}) : /* @__PURE__ */ jsx(OvermuxRuntime, { definition })
 });
 //#endregion
-export { OvermuxHost, OvermuxPortal, OvermuxThemeScope, chordPrefixSchema, commandBindingSchema, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatKeyBinding, formatShortcutBinding, keyBindingSchema, matchesKeyBinding, readClipboardText, shortcutBindingSchema, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
+export { OvermuxHost, OvermuxPortal, OvermuxThemeScope, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
 
 //# sourceMappingURL=client.js.map