@fungi.computer/tourtois 0.0.1 → 0.1.0

package/dist/AppPane.js

@@ -13,6 +13,33 @@ import { useWindowMotion } from "./use-window-motion.js";
 import { backHint } from "./shell-commands.js";
 import { createAppWindowManager, } from "./app-windows.js";
 import { launchComputerId } from "./app-launch.js";
+/**
+ * The App's own path, commands and state, when it publishes them; an App
+ * that publishes none keeps the title and subtitle in its header.
+ */
+function headerContent(navigation, popover, activate) {
+    if (navigation?.crumbs === undefined || navigation.crumbs.length === 0)
+        return {};
+    let content = {
+        crumbs: navigation.crumbs,
+        popover,
+        onCrumb: (crumbId, siblingId) => {
+            activate(siblingId === undefined
+                ? { kind: "crumb", crumbId }
+                : { kind: "crumb", crumbId, siblingId });
+        },
+        onAction: (actionId) => {
+            activate({ kind: "action", actionId });
+        },
+    };
+    if (navigation.primary !== undefined)
+        content = { ...content, primary: navigation.primary };
+    if (navigation.menu !== undefined)
+        content = { ...content, menu: navigation.menu };
+    if (navigation.status !== undefined)
+        content = { ...content, status: navigation.status };
+    return content;
+}
 const windowStatusLabel = (projection) => {
     if (projection.status === "error")
         return `${projection.launch.title} unavailable`;
@@ -28,6 +55,7 @@ export function FocusedWindowControls({ app, onOpenSettings, onOpenPermissions,
 }
 export function AppPane({ projection, icon, manager, onError, index, focusWindow, afterHide, onBack, onSelectComputer, }) {
     const containerRef = useRef(null);
+    const popover = useLayer("popover");
     const [computerPickerOpen, setComputerPickerOpen] = useState(false);
     useEffect(() => {
         if (projection.launch.computers === undefined)
@@ -101,7 +129,14 @@ export function AppPane({ projection, icon, manager, onError, index, focusWindow
             onBack(projection.windowId);
         }, style: binding.stackingStyle, children: [_jsx(WindowHeader, { title: projection.launch.title, ...(projection.navigation?.title === undefined
                     ? {}
-                    : { subtitle: projection.navigation.title }), density: layout.mode === "tiled" ? "compact" : "regular", icon: _jsx(AppIcon, { roles: projection.launch.roles, icon: icon }), ...(projection.navigation?.canGoBack === true
+                    : { subtitle: projection.navigation.title }), ...headerContent(projection.navigation, popover, (activation) => {
+                    void manager
+                        .activateNavigation(projection.windowId, activation)
+                        .catch((cause) => {
+                        console.error("App workbench operation failed", cause);
+                        onError("App could not handle that action.");
+                    });
+                }), density: layout.mode === "tiled" ? "compact" : "regular", icon: _jsx(AppIcon, { roles: projection.launch.roles, icon: icon }), ...(projection.navigation?.canGoBack === true
                     ? {
                         back: {
                             label: `Back in ${projection.launch.title}`,

package/dist/SettingsHome.js

@@ -18,19 +18,19 @@ function AvatarOverview({ onNavigate, }) {
 export function SettingsHome({ team, summary, sections, desktopOnly = false, onNavigate, }) {
     const offers = (category) => sections.includes(category);
     const close = team?.close;
-    return (_jsxs("section", { className: "tourtois-settings-content", "aria-label": "Settings home", children: [_jsxs(DataList, { density: "compact", "aria-label": "Settings overview", children: [offers("channels") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Website assistant", label: "Website assistant", description: "Set up chat on your WordPress site.", icon: _jsx(Sigil, { name: "connected" }), onClick: () => {
+    return (_jsxs("section", { className: "tourtois-settings-content", "aria-label": "Settings home", children: [_jsxs(DataList, { density: "compact", "aria-label": "Settings overview", children: [offers("channels") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Website assistant", label: "Website assistant", description: "Set up chat on your WordPress site.", icon: _jsx(Sigil, { name: "internet" }), onClick: () => {
                                 onNavigate({ category: "channels" });
-                            } }) })) : null, offers("selling") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Selling", label: "Selling", description: "Sell Apps on the Bazaar.", icon: _jsx(Sigil, { name: "installApps" }), onClick: () => {
+                            } }) })) : null, offers("selling") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Selling", label: "Selling", description: "Sell Apps on the Bazaar.", icon: _jsx(Sigil, { name: "sell" }), onClick: () => {
                                 onNavigate({ category: "selling", appId: null });
                             } }) })) : null, offers("avatar") ? _jsx(AvatarOverview, { onNavigate: onNavigate }) : null, offers("defaults") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Default apps", icon: _jsx(Sigil, { name: "installApps" }), label: "Default apps", description: "Apps for everyday tasks.", trailing: summary.defaultAppCount === null ? null : (_jsx(OverviewValue, { children: String(summary.defaultAppCount) +
                                     (summary.defaultAppCount === 1 ? " role" : " roles") })), onClick: () => {
                                 onNavigate({ category: "defaults" });
-                            } }) })) : null, team !== undefined ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Members and invites", icon: _jsx(Sigil, { name: "listAgents" }), label: "Members and invites", description: "People and invitations.", onClick: team.openMembers }) })) : null, offers("connectors") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Connectors", icon: _jsx(Sigil, { name: "read" }), label: "Connectors", description: "What Agents can reach.", onClick: () => {
+                            } }) })) : null, team !== undefined ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Members and invites", icon: _jsx(Sigil, { name: "members" }), label: "Members and invites", description: "People and invitations.", onClick: team.openMembers }) })) : null, offers("connectors") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Connectors", icon: _jsx(Sigil, { name: "read" }), label: "Connectors", description: "What Agents can reach.", onClick: () => {
                                 onNavigate({
                                     category: "connectors",
                                     target: { kind: "list" },
                                 });
-                            } }) })) : null, offers("computers") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Internet access", icon: _jsx(Sigil, { name: "connected" }), label: "Internet access", description: "Each Computer\u2019s outside access.", trailing: summary.computerCount === null ? null : (_jsx(OverviewValue, { children: String(summary.computerCount) +
+                            } }) })) : null, offers("computers") ? (_jsx(DataRow, { className: "p-0", children: _jsx(ActionRow, { "aria-label": "Internet access", icon: _jsx(Sigil, { name: "internet" }), label: "Internet access", description: "Each Computer\u2019s outside access.", trailing: summary.computerCount === null ? null : (_jsx(OverviewValue, { children: String(summary.computerCount) +
                                     (summary.computerCount === 1
                                         ? " Computer"
                                         : " Computers") })), onClick: () => {

package/dist/app-authority.d.ts

@@ -1,7 +1,7 @@
 import * as z from "zod";
 import { type AppAddress } from "@fungi.computer/oyster/shell/app-directory";
 export declare const appPermissionChangesSchema: z.ZodObject<{
-    computer: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    computer: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodLazy<z.ZodObject<{
         kind: z.ZodLiteral<"selected-computers">;
         computers: z.ZodArray<z.ZodObject<{
             computerId: z.ZodString;
@@ -12,7 +12,7 @@ export declare const appPermissionChangesSchema: z.ZodObject<{
                 "computer.execute": "computer.execute";
             }>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
         kind: z.ZodLiteral<"all-team-computers">;
         operations: z.ZodArray<z.ZodEnum<{
             "computer.list": "computer.list";
@@ -20,7 +20,7 @@ export declare const appPermissionChangesSchema: z.ZodObject<{
             "computer.writeFile": "computer.writeFile";
             "computer.execute": "computer.execute";
         }>>;
-    }, z.core.$strict>], "kind">>;
+    }, z.core.$strict>>], "kind">>;
     agents: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"all-team-agents">;
         directoryOperations: z.ZodArray<z.ZodEnum<{
@@ -58,7 +58,7 @@ export declare const appPermissionChangesSchema: z.ZodObject<{
 export type AppPermissionChanges = z.output<typeof appPermissionChangesSchema>;
 export declare const appPermissionReceiptSchema: z.ZodObject<{
     authorityVersion: z.ZodNumber;
-    computerPermission: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    computerPermission: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodLazy<z.ZodObject<{
         kind: z.ZodLiteral<"selected-computers">;
         computers: z.ZodArray<z.ZodObject<{
             computerId: z.ZodString;
@@ -69,7 +69,7 @@ export declare const appPermissionReceiptSchema: z.ZodObject<{
                 "computer.execute": "computer.execute";
             }>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>>, z.ZodLazy<z.ZodObject<{
         kind: z.ZodLiteral<"all-team-computers">;
         operations: z.ZodArray<z.ZodEnum<{
             "computer.list": "computer.list";
@@ -77,7 +77,7 @@ export declare const appPermissionReceiptSchema: z.ZodObject<{
             "computer.writeFile": "computer.writeFile";
             "computer.execute": "computer.execute";
         }>>;
-    }, z.core.$strict>], "kind">>;
+    }, z.core.$strict>>], "kind">>;
     agentPermission: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"all-team-agents">;
         directoryOperations: z.ZodArray<z.ZodEnum<{
@@ -129,15 +129,15 @@ export type AppMutationRequest = ReturnType<typeof appPermissionsMutationRequest
 export declare const appMutationResponseSchema: z.ZodObject<{
     kind: z.ZodLiteral<"accepted">;
     receipt: z.ZodUnknown;
-    enforcement: z.ZodNullable<z.ZodObject<{
+    enforcement: z.ZodNullable<z.ZodLazy<z.ZodObject<{
         requestId: z.ZodString;
-        address: z.ZodUnion<readonly [z.ZodObject<{
+        address: z.ZodLazy<z.ZodUnion<readonly [z.ZodObject<{
             kind: z.ZodLiteral<"default">;
             appId: z.ZodString;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"installation">;
             installationId: z.ZodString;
-        }, z.core.$strict>]>;
+        }, z.core.$strict>]>>;
         authorityVersion: z.ZodNumber;
         state: z.ZodEnum<{
             unaffected: "unaffected";
@@ -146,5 +146,5 @@ export declare const appMutationResponseSchema: z.ZodObject<{
             expired: "expired";
         }>;
         outstanding: z.ZodNumber;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;

package/dist/app-windows.d.ts

@@ -99,6 +99,33 @@ export declare const hasVisibleAppWindows: (projection: Readonly<{
         navigation: Readonly<{
             canGoBack: boolean;
             title?: string;
+            crumbs?: readonly Readonly<{
+                id: string;
+                label: string;
+                siblings?: readonly Readonly<{
+                    id: string;
+                    label: string;
+                }>[];
+            }>[];
+            primary?: readonly Readonly<{
+                id: string;
+                label: string;
+                variant?: "primary" | "outline" | "ghost";
+                tone?: "destructive";
+                disabled?: boolean;
+            }>[];
+            menu?: readonly Readonly<{
+                id: string;
+                label: string;
+                variant?: "primary" | "outline" | "ghost";
+                tone?: "destructive";
+                disabled?: boolean;
+            }>[];
+            status?: readonly Readonly<{
+                id: string;
+                label: string;
+                tone?: "neutral" | "info" | "warning" | "success" | "error";
+            }>[];
         }> | null;
         statusItems: readonly import("@fungi.computer/agar").AppStatusItem[];
     }>[];

package/dist/desktop/launcher-gill.js

@@ -35,7 +35,7 @@ export function LauncherGill({ items, size = "M", onAllApps, loading = false, un
                             {
                                 id: "all-apps",
                                 label: "All Apps ›",
-                                icon: _jsx(Sigil, { name: "installApps" }),
+                                icon: _jsx(Sigil, { name: "allApps" }),
                                 onSelect: onAllApps,
                             },
                         ], size: "lg" }), editing ? (_jsx(DataList, { "aria-label": "Launcher preferences", children: items.map((item) => (_jsx(DataRow, { children: _jsxs("div", { className: "tourtois-launcher-preference", children: [_jsx("span", { "aria-hidden": "true", className: "grid size-6 place-items-center [&_svg]:size-full", children: item.icon ?? _jsx(Sigil, { name: "installApps" }) }), _jsx("div", { className: "tourtois-launcher-preference-identity", children: _jsx("span", { children: item.label }) }), _jsxs(Select, { "aria-label": `Launcher state for ${item.label}`, value: stateFor(item.id), onChange: (event) => {

package/dist/shell-host.js

@@ -1,4 +1,4 @@
-import { APP_NAVIGATION_TITLE_MAX, parseAppStatusItems, } from "@fungi.computer/agar";
+import { APP_NAVIGATION_TITLE_MAX, parseAppStatusItems, APP_NAVIGATION_CRUMBS_MAX, APP_NAVIGATION_LABEL_MAX, APP_NAVIGATION_MENU_MAX, APP_NAVIGATION_PRIMARY_MAX, APP_NAVIGATION_SIBLINGS_MAX, APP_NAVIGATION_STATUS_MAX, } from "@fungi.computer/agar";
 import { teamComputerDirectorySchema, teamComputerSchema, } from "@fungi.computer/oyster/shell/workbench";
 import { createAppSurfaceCommandHost } from "@fungi.computer/oyster/shell/command-host";
 import * as Schema from "effect/Schema";
@@ -23,10 +23,44 @@ const platformDestinationsSchema = z
     label: z.string().min(1).max(80),
 }))
     .max(8);
+const relayId = z.string().min(1).max(64);
+const relayLabel = z.string().min(1).max(APP_NAVIGATION_LABEL_MAX);
+const relayCommands = (maximum) => z
+    .array(z.strictObject({
+    id: relayId,
+    label: relayLabel,
+    variant: z.enum(["primary", "outline", "ghost"]).optional(),
+    tone: z.literal("destructive").optional(),
+    disabled: z.boolean().optional(),
+}))
+    .max(maximum);
 const navigationRelaySchema = z
     .strictObject({
     canGoBack: z.boolean(),
     title: z.string().trim().min(1).max(APP_NAVIGATION_TITLE_MAX).optional(),
+    crumbs: z
+        .array(z.strictObject({
+        id: relayId,
+        label: relayLabel,
+        siblings: z
+            .array(z.strictObject({ id: relayId, label: relayLabel }))
+            .max(APP_NAVIGATION_SIBLINGS_MAX)
+            .optional(),
+    }))
+        .max(APP_NAVIGATION_CRUMBS_MAX)
+        .optional(),
+    primary: relayCommands(APP_NAVIGATION_PRIMARY_MAX).optional(),
+    menu: relayCommands(APP_NAVIGATION_MENU_MAX).optional(),
+    status: z
+        .array(z.strictObject({
+        id: relayId,
+        label: relayLabel,
+        tone: z
+            .enum(["neutral", "info", "warning", "success", "error"])
+            .optional(),
+    }))
+        .max(APP_NAVIGATION_STATUS_MAX)
+        .optional(),
 })
     .nullable();
 /** A child's navigation state as relayed by the host, re-checked here. */
@@ -34,9 +68,38 @@ function parseNavigationRelay(value) {
     const state = navigationRelaySchema.parse(value);
     if (state === null)
         return null;
-    return state.title === undefined
-        ? { canGoBack: state.canGoBack }
-        : { canGoBack: state.canGoBack, title: state.title };
+    let parsed = { canGoBack: state.canGoBack };
+    if (state.title !== undefined)
+        parsed = { ...parsed, title: state.title };
+    if (state.crumbs !== undefined)
+        parsed = {
+            ...parsed,
+            crumbs: state.crumbs.map((crumb) => {
+                const { siblings, ...rest } = crumb;
+                return siblings === undefined ? rest : { ...rest, siblings };
+            }),
+        };
+    if (state.primary !== undefined)
+        parsed = { ...parsed, primary: state.primary.map(commandOf) };
+    if (state.menu !== undefined)
+        parsed = { ...parsed, menu: state.menu.map(commandOf) };
+    if (state.status !== undefined)
+        parsed = { ...parsed, status: state.status.map(statusOf) };
+    return parsed;
+}
+function commandOf(command) {
+    let copy = { id: command.id, label: command.label };
+    if (command.variant !== undefined)
+        copy = { ...copy, variant: command.variant };
+    if (command.tone !== undefined)
+        copy = { ...copy, tone: command.tone };
+    if (command.disabled !== undefined)
+        copy = { ...copy, disabled: command.disabled };
+    return copy;
+}
+function statusOf(item) {
+    const copy = { id: item.id, label: item.label };
+    return item.tone === undefined ? copy : { ...copy, tone: item.tone };
 }
 function childLaunch(launch) {
     return {
@@ -143,6 +206,7 @@ export function createTourtoisShell(workbench) {
             reconfigure: (nextLaunch) => handle.reconfigure(childLaunch(nextLaunch)),
             requestClose: () => handle.requestClose(),
             requestBack: () => handle.requestBack(),
+            activateNavigation: (activation) => handle.activateNavigation(activation),
             activateStatus: (action) => handle.activateStatus(action),
             dispose: close,
         };

package/dist/useAppWindowManager.d.ts

@@ -253,6 +253,7 @@ export declare function useAppWindowManager(host: TourtoisAppSurfaceHost | null,
         }>[];
     }>) => Promise<void>;
     back: (windowId: string) => Promise<boolean>;
+    activateNavigation: (windowId: string, activation: import("@fungi.computer/agar").AppNavigationActivation) => Promise<boolean>;
     activateStatus: (windowId: string, action: import("@fungi.computer/agar").AppStatusAction) => Promise<boolean>;
     registerComputerChoice: (windowId: string, handler: () => void) => () => void;
     dispose: () => Promise<void>;
@@ -315,6 +316,33 @@ export declare function useAppWindowManager(host: TourtoisAppSurfaceHost | null,
             navigation: Readonly<{
                 canGoBack: boolean;
                 title?: string;
+                crumbs?: readonly Readonly<{
+                    id: string;
+                    label: string;
+                    siblings?: readonly Readonly<{
+                        id: string;
+                        label: string;
+                    }>[];
+                }>[];
+                primary?: readonly Readonly<{
+                    id: string;
+                    label: string;
+                    variant?: "primary" | "outline" | "ghost";
+                    tone?: "destructive";
+                    disabled?: boolean;
+                }>[];
+                menu?: readonly Readonly<{
+                    id: string;
+                    label: string;
+                    variant?: "primary" | "outline" | "ghost";
+                    tone?: "destructive";
+                    disabled?: boolean;
+                }>[];
+                status?: readonly Readonly<{
+                    id: string;
+                    label: string;
+                    tone?: "neutral" | "info" | "warning" | "success" | "error";
+                }>[];
             }> | null;
             statusItems: readonly import("@fungi.computer/agar").AppStatusItem[];
         }>[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/tourtois",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Tourtois: the trusted desktop shell for Oyster and Fungi, with host-supplied Settings sections",
   "type": "module",
@@ -69,19 +69,19 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@fungi.computer/agar": "0.1.0",
+    "@fungi.computer/agar": "0.2.0",
     "@fungi.computer/cairn": "0.0.1",
-    "@fungi.computer/caps": "0.0.2",
-    "@fungi.computer/gills": "0.0.1",
+    "@fungi.computer/caps": "0.1.0",
+    "@fungi.computer/gills": "0.1.0",
     "@fungi.computer/maosaico": "0.0.1",
-    "@fungi.computer/oyster": "0.1.0",
-    "@fungi.computer/parakeet": "0.0.1",
-    "@fungi.computer/puffball": "0.0.2",
-    "@fungi.computer/shiitake": "0.1.0",
-    "@fungi.computer/sigils": "0.0.1",
-    "@fungi.computer/sprite": "0.0.1",
-    "@fungi.computer/sprite-zdog": "0.0.1",
-    "@fungi.computer/whistle": "0.0.1",
+    "@fungi.computer/oyster": "0.2.0",
+    "@fungi.computer/parakeet": "0.1.0",
+    "@fungi.computer/puffball": "0.1.0",
+    "@fungi.computer/shiitake": "0.2.0",
+    "@fungi.computer/sigils": "0.1.0",
+    "@fungi.computer/sprite": "0.1.0",
+    "@fungi.computer/sprite-zdog": "0.1.0",
+    "@fungi.computer/whistle": "0.0.2",
     "@tanstack/history": "1.162.1",
     "@tanstack/react-form": "1.33.2",
     "@tanstack/react-query": "5.102.8",
@@ -98,8 +98,8 @@
   },
   "devDependencies": {
     "@cloudflare/workers-types": "5.20260828.1",
-    "@fungi.computer/forage": "0.0.2",
-    "@fungi.computer/mycelium": "0.0.2",
+    "@fungi.computer/forage": "0.1.0",
+    "@fungi.computer/mycelium": "0.1.0",
     "@ladle/react": "5.1.1",
     "@types/react": "18.3.3",
     "@vitejs/plugin-react": "6.1.1",
@@ -119,7 +119,7 @@
   "fungi": {
     "app": {
       "displayName": "Tourtois",
-      "icon": "installApps",
+      "icon": "tourtois",
       "capabilities": [
         "team.workbenchHost",
         "app.storage"