@fungi.computer/tourtois 0.0.0-stage → 0.0.1

package/dist/session-registry.js

@@ -0,0 +1,69 @@
+import { latestSession } from "./session-selection.js";
+import { requestIds } from "./team-directory.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Own one Team's client/session generation from effect setup through cleanup.
+ * The render waits for setup so React StrictMode can rehearse and replace the
+ * generation without handing a child a client that cleanup already closed.
+ */
+export function useSessionRegistry(teamId, createClient) {
+    const registryRef = useRef();
+    const [, rerenderAfterSetup] = useState(0);
+    useEffect(() => {
+        const registry = {
+            teamId,
+            clients: new Map(),
+            sessions: new Map(),
+            pendingCreates: new Map(),
+        };
+        registryRef.current = registry;
+        rerenderAfterSetup((version) => version + 1);
+        return () => {
+            void Promise.allSettled([...registry.clients.values()].map((client) => client.close()));
+            if (registryRef.current === registry)
+                registryRef.current = undefined;
+        };
+    }, [createClient, teamId]);
+    const clientFor = useCallback((agentId) => {
+        const registry = registryRef.current;
+        if (registry?.teamId !== teamId)
+            throw new Error("Tourtois Team client registry is unavailable");
+        let client = registry.clients.get(agentId);
+        if (!client) {
+            client = createClient(agentId);
+            registry.clients.set(agentId, client);
+        }
+        return { client, registry };
+    }, [createClient, teamId]);
+    const sessionFor = useCallback((agentId, sessionId) => {
+        const { client, registry } = clientFor(agentId);
+        const key = `${agentId}\u0000${sessionId}`;
+        const existing = registry.sessions.get(key);
+        if (existing)
+            return existing;
+        const session = client.session(sessionId);
+        registry.sessions.set(key, session);
+        return session;
+    }, [clientFor]);
+    const selectSession = useCallback(async (agentId) => {
+        const { client, registry } = clientFor(agentId);
+        const latest = await latestSession(client);
+        if (registryRef.current !== registry)
+            throw new Error("Chat selection changed");
+        let sessionId = latest;
+        if (sessionId === null) {
+            const requestId = registry.pendingCreates.get(agentId) ?? requestIds.request.generate();
+            registry.pendingCreates.set(agentId, requestId);
+            sessionId = await client.createSession(requestId);
+        }
+        if (registryRef.current !== registry)
+            throw new Error("Chat selection changed");
+        registry.pendingCreates.delete(agentId);
+        return sessionId;
+    }, [clientFor]);
+    return {
+        ready: registryRef.current?.teamId === teamId,
+        sessionFor,
+        selectSession,
+    };
+}

package/dist/session-selection.d.ts

@@ -0,0 +1,6 @@
+import type { ShiitakeAgent } from "@fungi.computer/shiitake/client";
+/**
+ * Retained inbox startup: latest update wins; merely opening never touches
+ * recency. An unreadable Session carries no recency and is never selected.
+ */
+export declare function latestSession(client: Pick<ShiitakeAgent, "listSessions">): Promise<string | null>;

package/dist/session-selection.js

@@ -0,0 +1,22 @@
+/**
+ * Retained inbox startup: latest update wins; merely opening never touches
+ * recency. An unreadable Session carries no recency and is never selected.
+ */
+export async function latestSession(client) {
+    let latest;
+    let after;
+    do {
+        const page = await client.listSessions(after);
+        for (const session of page.sessions) {
+            if (session.state === "unavailable")
+                continue;
+            if (!latest ||
+                session.lastActivityAt > latest.lastActivityAt ||
+                (session.lastActivityAt === latest.lastActivityAt &&
+                    session.sessionId < latest.sessionId))
+                latest = session;
+        }
+        after = page.next;
+    } while (after !== undefined);
+    return latest?.sessionId ?? null;
+}

package/dist/settings-leave-guard.d.ts

@@ -0,0 +1,5 @@
+export type SettingsLeaveState = "clean" | "dirty" | "pending" | "uncertain";
+export type SettingsLeaveGuard = () => SettingsLeaveState;
+/** Registers readers, not copies of form or request state. */
+export declare const SettingsLeaveContext: import("react").Context<(guard: SettingsLeaveGuard) => () => void>;
+export declare function useSettingsLeaveGuard(read: SettingsLeaveGuard): void;

package/dist/settings-leave-guard.js

@@ -0,0 +1,9 @@
+import { createContext, useContext, useEffect, useRef } from "react";
+/** Registers readers, not copies of form or request state. */
+export const SettingsLeaveContext = createContext(() => () => undefined);
+export function useSettingsLeaveGuard(read) {
+    const register = useContext(SettingsLeaveContext);
+    const latest = useRef(read);
+    latest.current = read;
+    useEffect(() => register(() => latest.current()), [register]);
+}

package/dist/settings-navigation.css

@@ -0,0 +1,129 @@
+.tourtois-settings-nav-group {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-xs);
+}
+
+.tourtois-settings-mobile-select {
+  display: none;
+}
+
+@media (max-width: 480px) {
+  .tourtois-system-settings .tourtois-settings-layout {
+    display: flex;
+    flex-direction: column;
+  }
+
+  /* These scoped rules outrank shell.css's desktop defaults even when the
+     bundler places this imported sheet before those defaults. */
+  .tourtois-settings-layout .tourtois-settings-nav {
+    display: none;
+  }
+
+  .tourtois-settings-mobile-select {
+    display: block;
+    min-width: 0;
+    padding: var(--spacing-sm);
+    border-bottom: var(--border) solid var(--stipe-hairline);
+  }
+
+  .tourtois-settings-mobile-select .select {
+    min-width: 0;
+    max-width: 100%;
+  }
+
+  .tourtois-settings-layout .tourtois-settings-content {
+    flex: 1;
+    min-height: 0;
+    padding: var(--spacing-sm);
+  }
+}
+
+.tourtois-connectors {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+}
+
+@media (max-width: 640px) {
+  .tourtois-github-connection-row {
+    grid-template-columns: auto minmax(0, 1fr);
+  }
+
+  .tourtois-github-connection-controls {
+    grid-column: 2;
+    grid-row: 2;
+  }
+}
+
+.tourtois-connector-panel {
+  display: flex;
+  flex-direction: column;
+  gap: var(--spacing-sm);
+}
+.tourtois-connector-row {
+  grid-column: 1 / -1;
+  min-width: 0;
+  width: 100%;
+}
+.tourtois-connector-row-controls {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: var(--spacing-xs);
+  width: 10rem;
+  max-width: 100%;
+  min-width: 0;
+}
+.tourtois-connector-row[data-computer="true"] .tourtois-connector-row-controls {
+  width: 20rem;
+}
+.tourtois-connector-select-slot {
+  flex: 1;
+  min-width: 0;
+}
+.tourtois-connector-row-details {
+  grid-column: 1 / -1;
+  min-width: 0;
+}
+.tourtois-connector-row[data-stacked="true"] .tourtois-connector-row-controls {
+  width: 100%;
+}
+
+/* Websites: each saved site is a summary line that opens into a short,
+   readable install guide. The guide is Caps Prose; the code is a Caps
+   CopyField block, so this file only lays the pieces out. */
+.tourtois-website-summary {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--spacing-sm);
+  min-width: 0;
+}
+.tourtois-website-hosts {
+  color: var(--stipe-fg-muted);
+  overflow-wrap: anywhere;
+}
+.tourtois-website-guide {
+  display: grid;
+  gap: var(--spacing-md);
+  min-width: 0;
+  border-top: var(--border) solid var(--stipe-hairline);
+  padding-top: var(--spacing-md);
+}
+.tourtois-website-doc {
+  max-width: 44rem;
+  min-width: 0;
+}
+.tourtois-website-doc > :first-child {
+  margin-top: 0;
+}
+.tourtois-website-note {
+  color: var(--stipe-fg-muted);
+}
+
+/* The Settings panel owns scrolling; its GitHub contents retain their natural
+   height rather than shrinking the form and feedback inside the flex column. */
+.tourtois-github-settings > * {
+  flex-shrink: 0;
+}

package/dist/settings-routes.d.ts

@@ -0,0 +1,118 @@
+import type { RouterCore } from "@tanstack/router-core";
+import * as z from "zod";
+import type { WhistleJsonValue } from "@fungi.computer/whistle";
+/** Host requests name a settings destination, never a browser URL. */
+export declare const settingsLocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    category: z.ZodLiteral<"home">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"apps">;
+    appKey: z.ZodNullable<z.ZodString>;
+    section: z.ZodEnum<{
+        desktop: "desktop";
+        permissions: "permissions";
+        advanced: "advanced";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"avatar">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"connectors">;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"list">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"new">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"connector">;
+        connectorId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"agent">;
+        agentId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"computers">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"keys">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"defaults">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"channels">;
+}, z.core.$strict>, z.ZodObject<{
+    category: z.ZodLiteral<"selling">;
+    appId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>], "category">;
+export type SettingsLocation = z.output<typeof settingsLocationSchema>;
+export declare const parseSettingsLocation: (value: WhistleJsonValue) => SettingsLocation;
+/** One host's dialog history; settings never replace the Team's browser URL. */
+export declare function createSettingsRouter(): RouterCore<import("@tanstack/router-core").Route<import("@tanstack/react-router").Register, any, "/", "/", string, "__root__", undefined, {}, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, readonly [import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/selling", "/selling", string, "/selling", undefined, import("@tanstack/react-router").ResolveParams<"/selling">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "selling";
+    appId: null;
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/selling/apps/$appId", "/selling/apps/$appId", string, "/selling/apps/$appId", undefined, {
+    appId: string;
+}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, ({ params }: import("@tanstack/react-router").LoaderFnContext<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/selling/apps/$appId", {
+    appId: string;
+}, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, unknown, undefined>) => {
+    category: "selling";
+    appId: string;
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/closed", "/closed", string, "/closed", undefined, import("@tanstack/react-router").ResolveParams<"/closed">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => null, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/", "/", string, "/", undefined, import("@tanstack/react-router").ResolveParams<"/">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "home";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/apps", "/apps", string, "/apps", undefined, import("@tanstack/react-router").ResolveParams<"/apps">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "apps";
+    appKey: null;
+    section: "permissions";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/apps/$appKey/$section", "/apps/$appKey/$section", string, "/apps/$appKey/$section", undefined, {
+    appKey: string;
+    section: "desktop" | "permissions" | "advanced";
+}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, ({ params }: import("@tanstack/react-router").LoaderFnContext<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/apps/$appKey/$section", {
+    appKey: string;
+    section: "desktop" | "permissions" | "advanced";
+}, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, unknown, undefined>) => {
+    appKey: string;
+    section: "desktop" | "permissions" | "advanced";
+    category: "apps";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/avatar", "/avatar", string, "/avatar", undefined, import("@tanstack/react-router").ResolveParams<"/avatar">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "avatar";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/defaults", "/defaults", string, "/defaults", undefined, import("@tanstack/react-router").ResolveParams<"/defaults">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "defaults";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors", "/connectors", string, "/connectors", undefined, import("@tanstack/react-router").ResolveParams<"/connectors">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "connectors";
+    target: {
+        kind: "list";
+    };
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/new", "/connectors/new", string, "/connectors/new", undefined, import("@tanstack/react-router").ResolveParams<"/connectors/new">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "connectors";
+    target: {
+        kind: "new";
+    };
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/$connectorId", "/connectors/$connectorId", string, "/connectors/$connectorId", undefined, {
+    connectorId: string;
+}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, ({ params }: import("@tanstack/react-router").LoaderFnContext<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/$connectorId", {
+    connectorId: string;
+}, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, unknown, undefined>) => {
+    category: "connectors";
+    target: {
+        kind: "connector";
+        connectorId: string;
+    };
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/agents", "/connectors/agents", string, "/connectors/agents", undefined, import("@tanstack/react-router").ResolveParams<"/connectors/agents">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "connectors";
+    target: {
+        kind: "agent";
+        agentId: null;
+    };
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/agents/$agentId", "/connectors/agents/$agentId", string, "/connectors/agents/$agentId", undefined, {
+    agentId: string;
+}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, ({ params }: import("@tanstack/react-router").LoaderFnContext<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/connectors/agents/$agentId", {
+    agentId: string;
+}, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, unknown, undefined>) => {
+    category: "connectors";
+    target: {
+        kind: "agent";
+        agentId: string;
+    };
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/computers", "/computers", string, "/computers", undefined, import("@tanstack/react-router").ResolveParams<"/computers">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "computers";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/keys", "/keys", string, "/keys", undefined, import("@tanstack/react-router").ResolveParams<"/keys">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "keys";
+}, unknown, unknown, unknown, unknown, undefined>, import("@tanstack/react-router").Route<unknown, import("@tanstack/react-router").RootRoute<import("@tanstack/react-router").Register, undefined, {}, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, undefined, unknown, unknown, unknown, unknown, undefined>, "/channels", "/channels", string, "/channels", undefined, import("@tanstack/react-router").ResolveParams<"/channels">, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, import("@tanstack/react-router").AnyContext, {}, () => {
+    category: "channels";
+}, unknown, unknown, unknown, unknown, undefined>], unknown, unknown, unknown, undefined>, "never", false, import("@tanstack/history").RouterHistory, Record<string, any>>;
+export declare function navigateSettings(router: ReturnType<typeof createSettingsRouter>, location: SettingsLocation | null): Promise<void>;

package/dist/settings-routes.js

@@ -0,0 +1,216 @@
+import { createRootRoute, createRoute, createRouter, } from "@tanstack/react-router";
+import { createMemoryHistory } from "@tanstack/history";
+import * as z from "zod";
+const appKey = z.string().min(1).max(256);
+const connectorId = z.string().min(1).max(260);
+const section = z.enum(["permissions", "desktop", "advanced"]);
+/** Host requests name a settings destination, never a browser URL. */
+export const settingsLocationSchema = z.discriminatedUnion("category", [
+    z.strictObject({ category: z.literal("home") }),
+    z.strictObject({
+        category: z.literal("apps"),
+        appKey: appKey.nullable(),
+        section,
+    }),
+    z.strictObject({ category: z.literal("avatar") }),
+    z.strictObject({
+        category: z.literal("connectors"),
+        target: z.discriminatedUnion("kind", [
+            z.strictObject({ kind: z.literal("list") }),
+            z.strictObject({ kind: z.literal("new") }),
+            z.strictObject({ kind: z.literal("connector"), connectorId }),
+            z.strictObject({ kind: z.literal("agent"), agentId: appKey.nullable() }),
+        ]),
+    }),
+    z.strictObject({ category: z.literal("computers") }),
+    z.strictObject({ category: z.literal("keys") }),
+    z.strictObject({ category: z.literal("defaults") }),
+    z.strictObject({ category: z.literal("channels") }),
+    z.strictObject({ category: z.literal("selling"), appId: appKey.nullable() }),
+]);
+export const parseSettingsLocation = (value) => settingsLocationSchema.parse(value);
+/** One host's dialog history; settings never replace the Team's browser URL. */
+export function createSettingsRouter() {
+    // The dialog retains its editors while the router selects their destination.
+    const root = createRootRoute({ component: () => null });
+    const closed = createRoute({
+        getParentRoute: () => root,
+        path: "/closed",
+        loader: () => null,
+    });
+    const home = createRoute({
+        getParentRoute: () => root,
+        path: "/",
+        loader: () => ({ category: "home" }),
+    });
+    const apps = createRoute({
+        getParentRoute: () => root,
+        path: "/apps",
+        loader: () => ({
+            category: "apps",
+            appKey: null,
+            section: "permissions",
+        }),
+    });
+    const app = createRoute({
+        getParentRoute: () => root,
+        path: "/apps/$appKey/$section",
+        params: { parse: (params) => z.object({ appKey, section }).parse(params) },
+        loader: ({ params }) => ({ category: "apps", ...params }),
+    });
+    const avatar = createRoute({
+        getParentRoute: () => root,
+        path: "/avatar",
+        loader: () => ({ category: "avatar" }),
+    });
+    const defaults = createRoute({
+        getParentRoute: () => root,
+        path: "/defaults",
+        loader: () => ({ category: "defaults" }),
+    });
+    const connectors = createRoute({
+        getParentRoute: () => root,
+        path: "/connectors",
+        loader: () => ({
+            category: "connectors",
+            target: { kind: "list" },
+        }),
+    });
+    const connectorNew = createRoute({
+        getParentRoute: () => root,
+        path: "/connectors/new",
+        loader: () => ({
+            category: "connectors",
+            target: { kind: "new" },
+        }),
+    });
+    const connector = createRoute({
+        getParentRoute: () => root,
+        path: "/connectors/$connectorId",
+        params: {
+            parse: (params) => z.object({ connectorId }).parse(params),
+        },
+        loader: ({ params }) => ({
+            category: "connectors",
+            target: { kind: "connector", connectorId: params.connectorId },
+        }),
+    });
+    const connectorAgents = createRoute({
+        getParentRoute: () => root,
+        path: "/connectors/agents",
+        loader: () => ({
+            category: "connectors",
+            target: { kind: "agent", agentId: null },
+        }),
+    });
+    const connectorAgent = createRoute({
+        getParentRoute: () => root,
+        path: "/connectors/agents/$agentId",
+        params: { parse: (params) => z.object({ agentId: appKey }).parse(params) },
+        loader: ({ params }) => ({
+            category: "connectors",
+            target: { kind: "agent", agentId: params.agentId },
+        }),
+    });
+    const computers = createRoute({
+        getParentRoute: () => root,
+        path: "/computers",
+        loader: () => ({ category: "computers" }),
+    });
+    const keys = createRoute({
+        getParentRoute: () => root,
+        path: "/keys",
+        loader: () => ({ category: "keys" }),
+    });
+    const channels = createRoute({
+        getParentRoute: () => root,
+        path: "/channels",
+        loader: () => ({ category: "channels" }),
+    });
+    const selling = createRoute({
+        getParentRoute: () => root,
+        path: "/selling",
+        loader: () => ({ category: "selling", appId: null }),
+    });
+    const sellApp = createRoute({
+        getParentRoute: () => root,
+        path: "/selling/apps/$appId",
+        params: { parse: (params) => z.object({ appId: appKey }).parse(params) },
+        loader: ({ params }) => ({ category: "selling", appId: params.appId }),
+    });
+    const routeTree = root.addChildren([
+        selling,
+        sellApp,
+        closed,
+        home,
+        apps,
+        app,
+        avatar,
+        defaults,
+        connectors,
+        connectorNew,
+        connector,
+        connectorAgents,
+        connectorAgent,
+        computers,
+        keys,
+        channels,
+    ]);
+    const router = createRouter({
+        routeTree,
+        history: createMemoryHistory({ initialEntries: ["/closed"] }),
+        defaultPendingMs: 0,
+        defaultPendingMinMs: 0,
+    });
+    return router;
+}
+export function navigateSettings(router, location) {
+    if (location === null)
+        return router.navigate({ to: "/closed" });
+    switch (location.category) {
+        case "selling":
+            return location.appId === null
+                ? router.navigate({ to: "/selling" })
+                : router.navigate({
+                    to: "/selling/apps/$appId",
+                    params: { appId: location.appId },
+                });
+        case "home":
+            return router.navigate({ to: "/" });
+        case "avatar":
+            return router.navigate({ to: "/avatar" });
+        case "defaults":
+            return router.navigate({ to: "/defaults" });
+        case "channels":
+            return router.navigate({ to: "/channels" });
+        case "connectors": {
+            const target = location.target;
+            if (target.kind === "list")
+                return router.navigate({ to: "/connectors" });
+            if (target.kind === "new")
+                return router.navigate({ to: "/connectors/new" });
+            if (target.kind === "connector")
+                return router.navigate({
+                    to: "/connectors/$connectorId",
+                    params: { connectorId: target.connectorId },
+                });
+            return target.agentId === null
+                ? router.navigate({ to: "/connectors/agents" })
+                : router.navigate({
+                    to: "/connectors/agents/$agentId",
+                    params: { agentId: target.agentId },
+                });
+        }
+        case "computers":
+            return router.navigate({ to: "/computers" });
+        case "keys":
+            return router.navigate({ to: "/keys" });
+        case "apps":
+            return location.appKey === null
+                ? router.navigate({ to: "/apps" })
+                : router.navigate({
+                    to: "/apps/$appKey/$section",
+                    params: { appKey: location.appKey, section: location.section },
+                });
+    }
+}