@peers-app/peers-ui 0.26.4 → 0.26.6

package/dist/components/group-switcher.d.ts

@@ -1,6 +1,12 @@
 interface GroupSwitcherProps {
+    /** Current theme (`light` or `dark`). */
     colorMode: string;
+    /** Use the compact mobile layout. */
     isMobile?: boolean;
 }
+/**
+ * Header dropdown for switching the active group (or the personal context) and creating a
+ * new group, which also installs the default packages into it.
+ */
 export declare function GroupSwitcher({ colorMode, isMobile }: GroupSwitcherProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/group-switcher.js

@@ -38,6 +38,11 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = __importStar(require("react"));
 const hooks_1 = require("../hooks");
+const packages_ipc_1 = require("../screens/packages/packages-ipc");
+/**
+ * Header dropdown for switching the active group (or the personal context) and creating a
+ * new group, which also installs the default packages into it.
+ */
 function GroupSwitcher({ colorMode, isMobile = false }) {
     const [showDropdown, setShowDropdown] = (0, react_1.useState)(false);
     const [showCreateModal, setShowCreateModal] = (0, react_1.useState)(false);
@@ -183,7 +188,9 @@ function CreateGroupModal({ colorMode, userContext, onClose, onGroupCreated, })
             await (0, peers_sdk_1.Groups)(groupDataContext).signAndSave(newGroup);
             // Auto-install peers-core for the new group (copy from another context that
             // already has it, else fall back to the remote updateUrl / bundle).
-            await peers_sdk_1.rpcServerCalls.seedBundledPeersCore(groupId).catch((err) => {
+            await (0, packages_ipc_1.packagesTools)(groupId)
+                .then((tools) => tools.installDefaultPackages())
+                .catch((err) => {
                 console.error("Error auto-installing peers-core for group:", err);
             });
             // Notify parent

package/dist/components/markdown-with-mentions.d.ts

@@ -1,4 +1,8 @@
 import React from "react";
+/**
+ * Render markdown (GitHub-flavored) with `@mentions` turned into links. Web links open in
+ * the system browser through System Host Shell instead of navigating the app window.
+ */
 export declare const MarkdownWithMentions: React.FC<{
     content: string;
 }>;

package/dist/components/markdown-with-mentions.js

@@ -10,6 +10,7 @@ const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = __importDefault(require("react"));
 const react_markdown_1 = __importDefault(require("react-markdown"));
 const remark_gfm_1 = __importDefault(require("remark-gfm"));
+const host_shell_consumer_1 = require("../host-shell/host-shell-consumer");
 const mention_configs_1 = require("../mention-configs");
 // Custom Link Renderer
 const LinkRenderer = (props) => {
@@ -17,7 +18,7 @@ const LinkRenderer = (props) => {
     return ((0, jsx_runtime_1.jsx)("a", { href: href, onClick: (e) => {
             if (href?.startsWith("http")) {
                 e.preventDefault();
-                peers_sdk_1.rpcServerCalls.openLinkInBrowser(href);
+                void (0, host_shell_consumer_1.openOnHost)(href);
             }
         }, children: props.children }));
 };
@@ -114,6 +115,10 @@ const createElementWithMentions = (Element) => {
             }) }));
     };
 };
+/**
+ * Render markdown (GitHub-flavored) with `@mentions` turned into links. Web links open in
+ * the system browser through System Host Shell instead of navigating the app window.
+ */
 const MarkdownWithMentions = ({ content }) => {
     const components = {
         p: createElementWithMentions("p"),

package/dist/components/save-button.d.ts

@@ -1,14 +1,29 @@
 import type { IDoc } from "@peers-app/peers-sdk";
 import type React from "react";
+/** Props for {@link SaveButton}. */
 export interface ISaveButtonProps {
     /** Used with many concrete table row shapes; IDoc stays generic at call sites. */
     doc: IDoc<any>;
+    /** Save handler; defaults to `doc.save`. */
     onClick?: () => void | Promise<void>;
+    /** Extra dropdown actions: buttons, or arbitrary nodes such as dividers. */
     addActions?: ({
         label: string;
         onClick: () => void;
         className?: string;
     } | React.ReactNode)[];
+    /** Hide the built-in Discard Changes and Delete actions. */
     noBuiltInActions?: boolean;
+    /** Label for the built-in delete action. Default: `Delete`. */
+    deleteLabel?: string;
+    /**
+     * Replace the built-in delete (`doc.delete()`), for records whose removal must go through
+     * a Runtime contract. Runs after the user confirms; the screen then navigates up.
+     */
+    onDelete?: () => void | Promise<void>;
 }
+/**
+ * Save button with a dropdown of extra actions plus built-in Discard Changes and Delete.
+ * Enabled only while the document has unsaved changes.
+ */
 export declare const SaveButton: (props: ISaveButtonProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/save-button.js

@@ -4,6 +4,10 @@ exports.SaveButton = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const globals_1 = require("../globals");
 const hooks_1 = require("../hooks");
+/**
+ * Save button with a dropdown of extra actions plus built-in Discard Changes and Delete.
+ * Enabled only while the document has unsaved changes.
+ */
 const SaveButton = (props) => {
     let { doc, addActions } = props;
     (0, hooks_1.useObservable)(doc.q);
@@ -29,12 +33,19 @@ const SaveButton = (props) => {
         if (allActions.length) {
             allActions.push((0, jsx_runtime_1.jsx)("hr", { className: "dropdown-divider mt-3" }));
         }
+        const deleteLabel = props.deleteLabel ?? "Delete";
         allActions.push({
-            label: "Delete",
+            label: deleteLabel,
             className: `text-bg-danger`,
             onClick: async () => {
-                if (confirm("Are you sure you want to delete this?")) {
-                    await doc.delete();
+                if (confirm(`Are you sure you want to ${deleteLabel.toLowerCase()} this?`)) {
+                    try {
+                        await (props.onDelete ? props.onDelete() : doc.delete());
+                    }
+                    catch (err) {
+                        alert(`${deleteLabel} failed: ${err instanceof Error ? err.message : String(err)}`);
+                        return;
+                    }
                     const pathParts = (0, globals_1.mainContentPath)().split("/");
                     pathParts.pop();
                     const path = pathParts.join("/") ?? "";

package/dist/globals.js

@@ -8,6 +8,7 @@ exports.initializeHashNavigation = initializeHashNavigation;
 exports.loadGlobals = loadGlobals;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const identity_routes_1 = require("./screens/identity/identity-routes");
+const packages_ipc_1 = require("./screens/packages/packages-ipc");
 const tabs_state_1 = require("./tabs-layout/tabs-state");
 const utils_1 = require("./utils");
 /** Counter incremented when installed package UI should reload. */
@@ -90,13 +91,11 @@ async function openThreadInTab(thread) {
         iconClassName: "bi-chat-dots",
     });
 }
-peers_sdk_1.rpcClientCalls.setClientPath = async (url) => {
-    (0, exports.mainContentPath)((url && String(url).trim()) || "");
-};
-peers_sdk_1.rpcClientCalls.openThread = async (threadId) => {
-    console.warn("Opening thread:", threadId);
-    openThread(threadId);
-};
+// A notification clicked in the desktop app's main process opens its thread here.
+(0, peers_sdk_1.subscribe)("ui:openThread", (event) => {
+    if (event.data?.threadId)
+        void openThread(event.data.threadId);
+});
 /** Signed profile for the active user after {@link loadGlobals}. */
 exports.me = null;
 /** Current browser viewport width. */
@@ -153,6 +152,33 @@ function initializeHashNavigation() {
         updateWindowHash();
     }
 }
+/** Longest page startup waits for package folders to be re-read. */
+const PACKAGE_FOLDER_RELOAD_WAIT_MS = 30_000;
+/**
+ * Re-read this device's package folders so rebuilt dev bundles load before the UI does.
+ * Skipped on hosts without package folders; failures are logged, and the wait is bounded so
+ * a slow host cannot stall startup.
+ */
+async function reloadPackageFolders() {
+    const reload = (async () => {
+        const tools = await (0, packages_ipc_1.packagesTools)();
+        const { capabilities } = await tools.getCapabilities();
+        if (!capabilities.fileSystem)
+            return;
+        const { skipped, results } = await tools.reloadAllPackages();
+        if (skipped)
+            console.warn(skipped);
+        for (const result of results) {
+            if (!result.ok)
+                console.warn(`[packages] Reloading ${result.name} failed: ${result.error}`);
+            if (result.warning)
+                console.warn(`[packages] ${result.name}: ${result.warning}`);
+        }
+    })().catch((err) => {
+        console.warn("[packages] Reloading package folders failed:", err);
+    });
+    await Promise.race([reload, (0, peers_sdk_1.sleep)(PACKAGE_FOLDER_RELOAD_WAIT_MS)]);
+}
 /** Load global user state required before the root layout renders. */
 async function loadGlobals() {
     if (globalsLoaded)
@@ -161,7 +187,7 @@ async function loadGlobals() {
     exports.me = await (0, peers_sdk_1.getMe)();
     await peers_sdk_1.reloadPackagesOnPageRefresh.loadingPromise;
     if ((0, peers_sdk_1.reloadPackagesOnPageRefresh)()) {
-        await peers_sdk_1.rpcServerCalls.addOrUpdatePackage("updateAll");
+        await reloadPackageFolders();
     }
     await Promise.all([
         (0, peers_sdk_1.Groups)()

package/dist/host-shell/host-shell-consumer.d.ts

@@ -0,0 +1,21 @@
+import { type IHostShellConsumer } from "@peers-app/peers-sdk";
+/**
+ * Shared handle for System Host Shell on the local host. Calls name no data context, so the
+ * host runs them in the personal context, where the signed-in user has Self access.
+ */
+export declare const hostShellContract: import("@peers-app/peers-sdk").IHostContractConsumer<IHostShellConsumer>;
+/** Return the System Host Shell tools of the local host. */
+export declare function hostShellTools(): Promise<IHostShellConsumer["tools"]>;
+/**
+ * Open a web link in the browser, or a local file or folder with the OS. Failures (an
+ * unsupported host, a refused link scheme, a missing folder) are logged and shown.
+ *
+ * @param target - Link or local path (`~` allowed).
+ */
+export declare function openOnHost(target: string): Promise<void>;
+/**
+ * Open a folder in a code editor (VS Code when installed), else with the OS.
+ *
+ * @param path - Folder or file (`~` allowed).
+ */
+export declare function openInEditorOnHost(path: string): Promise<void>;

package/dist/host-shell/host-shell-consumer.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostShellContract = void 0;
+exports.hostShellTools = hostShellTools;
+exports.openOnHost = openOnHost;
+exports.openInEditorOnHost = openInEditorOnHost;
+const peers_sdk_1 = require("@peers-app/peers-sdk");
+/**
+ * Shared handle for System Host Shell on the local host. Calls name no data context, so the
+ * host runs them in the personal context, where the signed-in user has Self access.
+ */
+exports.hostShellContract = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getHostShellContractDefinition)());
+/** Return the System Host Shell tools of the local host. */
+async function hostShellTools() {
+    return (await exports.hostShellContract.get()).tools;
+}
+/**
+ * Open a web link in the browser, or a local file or folder with the OS. Failures (an
+ * unsupported host, a refused link scheme, a missing folder) are logged and shown.
+ *
+ * @param target - Link or local path (`~` allowed).
+ */
+async function openOnHost(target) {
+    try {
+        await (await hostShellTools()).open({ target });
+    }
+    catch (error) {
+        reportHostShellError(`Could not open ${target}`, error);
+    }
+}
+/**
+ * Open a folder in a code editor (VS Code when installed), else with the OS.
+ *
+ * @param path - Folder or file (`~` allowed).
+ */
+async function openInEditorOnHost(path) {
+    try {
+        await (await hostShellTools()).openInEditor({ path });
+    }
+    catch (error) {
+        reportHostShellError(`Could not open ${path}`, error);
+    }
+}
+function reportHostShellError(what, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`${what}:`, error);
+    if (typeof window !== "undefined" && typeof window.alert === "function") {
+        window.alert(`${what}: ${message}`);
+    }
+}

package/dist/host-shell/host-shell-consumer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/host-shell/host-shell-consumer.test.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mockTools = { open: jest.fn(), openInEditor: jest.fn() };
+jest.mock("@peers-app/peers-sdk", () => ({
+    getHostShellContractDefinition: () => ({ contractId: "host-shell" }),
+    hostContractConsumer: () => ({ get: async () => ({ tools: mockTools }), dispose: () => { } }),
+}));
+const host_shell_consumer_1 = require("./host-shell-consumer");
+const alert = jest.fn();
+beforeEach(() => {
+    Object.assign(window, { alert });
+    jest.spyOn(console, "error").mockImplementation(() => { });
+    mockTools.open.mockReset();
+    mockTools.openInEditor.mockReset();
+    alert.mockReset();
+});
+it("opens links and folders on the host", async () => {
+    await (0, host_shell_consumer_1.openOnHost)("https://peers.app");
+    expect(mockTools.open).toHaveBeenCalledWith({ target: "https://peers.app" });
+    await (0, host_shell_consumer_1.openInEditorOnHost)("~/peers/packages/desk");
+    expect(mockTools.openInEditor).toHaveBeenCalledWith({ path: "~/peers/packages/desk" });
+    expect(alert).not.toHaveBeenCalled();
+});
+it("shows why the host could not open something", async () => {
+    mockTools.open.mockRejectedValueOnce(new Error("open refuses git: links"));
+    await (0, host_shell_consumer_1.openOnHost)("git@github.com:me/pkg.git");
+    expect(alert).toHaveBeenCalledWith("Could not open git@github.com:me/pkg.git: open refuses git: links");
+});

package/dist/mention-configs.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mentionConfigs = exports.valueTypeMentionConfig = exports.workflowMentionConfig = exports.assistantMentionConfig = exports.userMentionConfig = exports.toolMentionConfig = void 0;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
+const globals_1 = require("./globals");
 const tool_catalog_ipc_1 = require("./screens/tools/tool-catalog-ipc");
 const MENTIONS_MAX_RESULTS = 10;
 /** Discover workflow-invocable tools while keeping historical mention IDs readable. */
@@ -111,7 +112,7 @@ exports.valueTypeMentionConfig = {
         name: item.name,
     }),
     onClick(data) {
-        peers_sdk_1.rpcClientCalls.setClientPath(`peer-types/${data.id}`);
+        (0, globals_1.mainContentPath)(`peer-types/${data.id}`);
     },
 };
 // Tasks().list({ title: { $matchWords: mentionString }, completeDT: { $exists: searchCompletedTasks } }, { pageSize: MAX_RESULTS })

package/dist/screens/groups/group-list.js

@@ -10,6 +10,7 @@ const globals_1 = require("../../globals");
 const hooks_1 = require("../../hooks");
 const identity_routes_1 = require("../identity/identity-routes");
 const activity_view_1 = require("../invites/activity-view");
+const packages_ipc_1 = require("../packages/packages-ipc");
 /** Search, summarize, and create groups owned by the signed-in user. */
 function GroupList(props = {}) {
     const userContext = (0, hooks_1.usePromise)(peers_sdk_1.getUserContext);
@@ -122,7 +123,9 @@ function GroupList(props = {}) {
         });
         await (0, peers_sdk_1.Groups)(groupDataContext).signAndSave(group);
         // Auto-install peers-core for the new group
-        await peers_sdk_1.rpcServerCalls.seedBundledPeersCore(groupId).catch((err) => {
+        await (0, packages_ipc_1.packagesTools)(groupId)
+            .then((tools) => tools.installDefaultPackages())
+            .catch((err) => {
             console.error("Error auto-installing peers-core for group:", err);
         });
         (0, globals_1.mainContentPath)(`${identity_routes_1.IDENTITY_GROUPS_PATH}/${group.groupId}`);

package/dist/screens/packages/package-details.d.ts

@@ -1,4 +1,5 @@
 interface IProps {
+    /** Package to show. */
     packageId: string;
 }
 /** Detail screen for a single package with Info, Versions, Components, and Dependencies tabs. */

package/dist/screens/packages/package-details.js

@@ -11,7 +11,9 @@ const hooks_1 = require("../../hooks");
 const tabs_state_1 = require("../../tabs-layout/tabs-state");
 const local_folder_grants_panel_1 = require("./local-folder-grants-panel");
 const package_info_1 = require("./package-info");
+const package_runtime_status_1 = require("./package-runtime-status");
 const package_versions_1 = require("./package-versions");
+const packages_ipc_1 = require("./packages-ipc");
 /** Detail screen for a single package with Info, Versions, Components, and Dependencies tabs. */
 const PackageDetails = (props) => {
     const refresh = (0, hooks_1.useObservableState)(Date.now());
@@ -30,7 +32,17 @@ const PackageDetails = (props) => {
         {
             label: "Reload Package",
             onClick: async () => {
-                await peers_sdk_1.rpcServerCalls.addOrUpdatePackage(pkg.packageId, { update: true });
+                try {
+                    const { warning } = await (await (0, packages_ipc_1.packagesTools)()).reloadPackage({
+                        packageId: pkg.packageId,
+                    });
+                    if (warning)
+                        alert(warning);
+                }
+                catch (err) {
+                    alert(`Reload failed: ${err instanceof Error ? err.message : String(err)}`);
+                    return;
+                }
                 await pkg.load();
                 window.location.reload();
             },
@@ -42,16 +54,21 @@ const PackageDetails = (props) => {
             // className: 'text-bg-warning',
             onClick: async () => {
                 if (confirm(`Create a remote repository from this local one: ${pkg.name}`)) {
+                    const tools = await (0, packages_ipc_1.packagesTools)();
+                    try {
+                        await tools.linkRemoteRepo({ packageId: pkg.packageId });
+                    }
+                    catch (err) {
+                        alert(`Error linking remote repo: ${err instanceof Error ? err.message : err}`);
+                        return;
+                    }
                     try {
-                        await peers_sdk_1.rpcServerCalls.addOrUpdatePackage(pkg.packageId, {
-                            linkRemote: true,
-                            update: true,
-                        });
-                        refresh(Date.now());
+                        await tools.reloadPackage({ packageId: pkg.packageId });
                     }
                     catch (err) {
-                        alert(`Error linking remote repo: ${err}`);
+                        alert(`Linked the remote repo, but reloading failed: ${err instanceof Error ? err.message : err}`);
                     }
+                    refresh(Date.now());
                 }
             },
         });
@@ -59,7 +76,9 @@ const PackageDetails = (props) => {
     return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid p-3", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex", children: [(0, jsx_runtime_1.jsx)("div", { children: (0, jsx_runtime_1.jsx)("h4", { children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-fill me-2" }) }) }), (0, jsx_runtime_1.jsx)("div", { className: "flex-grow-1", children: (0, jsx_runtime_1.jsx)("h4", { children: (0, jsx_runtime_1.jsx)(input_1.Input, { className: "border border-0", style: { width: "100%", outline: "none", backgroundColor: "transparent" }, value: pkg.qs.name }, pkg.packageId) }) }), (0, jsx_runtime_1.jsx)("div", { children: (0, jsx_runtime_1.jsx)(save_button_1.SaveButton, { doc: pkg, onClick: async () => {
                                 await (0, peers_sdk_1.Packages)().signAndSave(pkg.toJS());
                                 pkg.q(0);
-                            }, addActions: [...addActions] }, pkg.packageId) })] }), (0, jsx_runtime_1.jsx)(tabs_1.Tabs, { tabs: [
+                            }, addActions: [...addActions], deleteLabel: "Uninstall", onDelete: async () => {
+                                await (await (0, packages_ipc_1.packagesTools)()).uninstallPackage({ packageId: pkg.packageId });
+                            } }, pkg.packageId) })] }), (0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeStatus, { packageId: pkg.packageId }), (0, jsx_runtime_1.jsx)(tabs_1.Tabs, { tabs: [
                     {
                         name: "Info",
                         content: ((0, jsx_runtime_1.jsx)(tabs_1.ScreenTabBody, { children: (0, jsx_runtime_1.jsx)(package_info_1.PackageInfo, { pkg: pkg }) })),

package/dist/screens/packages/package-helpers.d.ts

@@ -22,33 +22,13 @@ export declare function isGroupAdmin(): Promise<boolean>;
 /**
  * Activate a specific package version, handling group-level vs device-local
  * activation. When the device has no follow override and the user is a group
- * admin, the group's `activePackageVersionId` is advanced so all devices
- * stay in sync. Otherwise only the device-local prefs are updated.
+ * admin, a release advances the group's `activePackageVersionId` so all devices
+ * stay in sync. Dev versions (including legacy missing or empty tags) and other
+ * selections only update the device-local prefs.
  *
  * @param packageId - The package to activate a version for.
  * @param pv - The package version to activate.
  */
 export declare function activatePackageVersion(packageId: string, pv: IPackageVersion): Promise<void>;
-/**
- * After promoting a version that is currently effective-active on this device,
- * activate it when the new tag matches the group's auto-activate / follow rules.
- *
- * This closes the gotcha where a device is already running a `dev` build, promotes
- * it to `beta`/`stable`, and expects the group active version to advance without a
- * separate Activate click — but only when the group would accept that channel
- * (e.g. default follow is `stable`; `beta` only when the group follows beta).
- *
- * @param packageId - Package that was promoted
- * @param promotedPv - PV after the tag change (must include the new `versionTag`)
- * @param opts.wasEffectiveActive - True when this PV was this device's effective active before promote
- * @param opts.groupFollowTags - Group `IPackage.followVersionTags` (not device override)
- * @param opts.groupPinned - True when group `versionFollowRange` is `pinned`
- * @returns Whether activation was attempted
- */
-export declare function maybeActivateAfterPromote(packageId: string, promotedPv: IPackageVersion, opts: {
-    wasEffectiveActive: boolean;
-    groupFollowTags: string | undefined;
-    groupPinned: boolean;
-}): Promise<boolean>;
 /** Numeric rank for sorting packages by update urgency. */
 export declare const updateLevelRank: Record<string, number>;

package/dist/screens/packages/package-helpers.js

@@ -4,8 +4,8 @@ exports.updateLevelRank = void 0;
 exports.checkVersionStatus = checkVersionStatus;
 exports.isGroupAdmin = isGroupAdmin;
 exports.activatePackageVersion = activatePackageVersion;
-exports.maybeActivateAfterPromote = maybeActivateAfterPromote;
 const peers_sdk_1 = require("@peers-app/peers-sdk");
+const packages_ipc_1 = require("./packages-ipc");
 /**
  * Check a package's version status: what's currently active, whether a newer
  * version exists within the follow policy, and which version is the best
@@ -84,8 +84,9 @@ async function isGroupAdmin() {
 /**
  * Activate a specific package version, handling group-level vs device-local
  * activation. When the device has no follow override and the user is a group
- * admin, the group's `activePackageVersionId` is advanced so all devices
- * stay in sync. Otherwise only the device-local prefs are updated.
+ * admin, a release advances the group's `activePackageVersionId` so all devices
+ * stay in sync. Dev versions (including legacy missing or empty tags) and other
+ * selections only update the device-local prefs.
  *
  * @param packageId - The package to activate a version for.
  * @param pv - The package version to activate.
@@ -94,49 +95,14 @@ async function activatePackageVersion(packageId, pv) {
     const prefsVar = (0, peers_sdk_1.packagePrefsVar)(packageId);
     await prefsVar.loadingPromise;
     const devicePrefs = prefsVar();
-    const activatesGroup = pv.versionTag !== "dev" && !(0, peers_sdk_1.hasDeviceFollowOverride)(devicePrefs) && (await isGroupAdmin());
-    if (activatesGroup) {
-        const current = await (0, peers_sdk_1.Packages)().get(packageId);
-        if (current) {
-            current.activePackageVersionId = pv.packageVersionId;
-            await (0, peers_sdk_1.Packages)().signAndSave(current);
-        }
-        await (0, peers_sdk_1.updatePackagePrefs)(packageId, { activePackageVersionId: undefined });
-    }
-    else {
-        await (0, peers_sdk_1.updatePackagePrefs)(packageId, { activePackageVersionId: pv.packageVersionId });
-    }
-}
-/**
- * After promoting a version that is currently effective-active on this device,
- * activate it when the new tag matches the group's auto-activate / follow rules.
- *
- * This closes the gotcha where a device is already running a `dev` build, promotes
- * it to `beta`/`stable`, and expects the group active version to advance without a
- * separate Activate click — but only when the group would accept that channel
- * (e.g. default follow is `stable`; `beta` only when the group follows beta).
- *
- * @param packageId - Package that was promoted
- * @param promotedPv - PV after the tag change (must include the new `versionTag`)
- * @param opts.wasEffectiveActive - True when this PV was this device's effective active before promote
- * @param opts.groupFollowTags - Group `IPackage.followVersionTags` (not device override)
- * @param opts.groupPinned - True when group `versionFollowRange` is `pinned`
- * @returns Whether activation was attempted
- */
-async function maybeActivateAfterPromote(packageId, promotedPv, opts) {
-    if (!opts.wasEffectiveActive)
-        return false;
-    if (opts.groupPinned)
-        return false;
-    if (!promotedPv.versionTag || promotedPv.versionTag === "dev")
-        return false;
-    // Docs default: groups follow `stable` when followVersionTags is unset.
-    const followTags = opts.groupFollowTags ?? "stable";
-    if (!(0, peers_sdk_1.doesTagMatch)(undefined, promotedPv.versionTag, followTags, undefined)) {
-        return false;
-    }
-    await activatePackageVersion(packageId, promotedPv);
-    return true;
+    const activatesGroup = (pv.versionTag || "dev") !== "dev" &&
+        !(0, peers_sdk_1.hasDeviceFollowOverride)(devicePrefs) &&
+        (await isGroupAdmin());
+    await (await (0, packages_ipc_1.packagesTools)()).activatePackageVersion({
+        packageId,
+        packageVersionId: pv.packageVersionId,
+        scope: activatesGroup ? "group" : "device",
+    });
 }
 /** Numeric rank for sorting packages by update urgency. */
 exports.updateLevelRank = { major: 3, minor: 2, patch: 1 };

package/dist/screens/packages/package-helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/screens/packages/package-helpers.test.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const peers_sdk_1 = require("@peers-app/peers-sdk");
+const package_helpers_1 = require("./package-helpers");
+const mockActivate = jest.fn(async () => ({}));
+const mockRole = jest.fn();
+const mockPrefs = jest.fn();
+jest.mock("./packages-ipc", () => ({
+    packagesTools: async () => ({ activatePackageVersion: mockActivate }),
+}));
+jest.mock("@peers-app/peers-sdk", () => {
+    const actual = jest.requireActual("@peers-app/peers-sdk");
+    return {
+        ...actual,
+        getUserContext: async () => ({
+            userId: "user",
+            defaultDataContext: () => ({ dataContextId: "group" }),
+        }),
+        getUserRole: () => mockRole(),
+        packagePrefsVar: () => Object.assign(mockPrefs, { loadingPromise: Promise.resolve() }),
+    };
+});
+beforeEach(() => {
+    jest.clearAllMocks();
+    mockRole.mockResolvedValue(peers_sdk_1.GroupMemberRole.Admin);
+    mockPrefs.mockReturnValue({});
+});
+test.each([
+    "dev",
+    "",
+    undefined,
+])("activates dev tag %p only on this device", async (versionTag) => {
+    const packageId = (0, peers_sdk_1.newid)();
+    const packageVersionId = (0, peers_sdk_1.newid)();
+    await (0, package_helpers_1.activatePackageVersion)(packageId, { packageVersionId, versionTag });
+    expect(mockActivate).toHaveBeenCalledWith({ packageId, packageVersionId, scope: "device" });
+});
+test.each(["beta", "stable"])("an admin activates %s for the group", async (versionTag) => {
+    const packageId = (0, peers_sdk_1.newid)();
+    const packageVersionId = (0, peers_sdk_1.newid)();
+    await (0, package_helpers_1.activatePackageVersion)(packageId, { packageVersionId, versionTag });
+    expect(mockActivate).toHaveBeenCalledWith({ packageId, packageVersionId, scope: "group" });
+});
+test("a device follow override keeps release activation local", async () => {
+    mockPrefs.mockReturnValue({ followTags: "stable,beta" });
+    const packageId = (0, peers_sdk_1.newid)();
+    const packageVersionId = (0, peers_sdk_1.newid)();
+    await (0, package_helpers_1.activatePackageVersion)(packageId, {
+        packageVersionId,
+        versionTag: "stable",
+    });
+    expect(mockActivate).toHaveBeenCalledWith({ packageId, packageVersionId, scope: "device" });
+});

package/dist/screens/packages/package-info.js

@@ -7,6 +7,7 @@ const input_1 = require("../../components/input");
 const markdown_with_mentions_1 = require("../../components/markdown-with-mentions");
 const tooltip_1 = require("../../components/tooltip");
 const hooks_1 = require("../../hooks");
+const host_shell_consumer_1 = require("../../host-shell/host-shell-consumer");
 const package_network_panel_1 = require("./package-network-panel");
 /** Info tab for the package details screen. */
 const PackageInfo = (props) => {
@@ -70,9 +71,9 @@ const PackageInfo = (props) => {
     }, undefined, [activeVersionId, pkg.packageId, effectiveFollowTags]);
     const remoteRepoUrl = pkg.remoteRepo;
     return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("small", { children: "Name:" }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.name, className: "form-control mb-3 p-0 ps-2", placeholder: "Package name", title: "Package name", disabled: true }), (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Local Path:", (0, jsx_runtime_1.jsxs)("small", { children: [(0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: `The local path to the directory containing the package.  This will open in VS Code if it's installed otherwise this will open in your native file system` }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-link", onClick: () => {
-                                            peers_sdk_1.rpcServerCalls.openPackage(localPath || peers_sdk_1.packagesRootDir);
+                                            void (0, host_shell_consumer_1.openInEditorOnHost)(localPath || peers_sdk_1.packagesRootDir);
                                         }, children: "Open Local" })] })] }), (0, jsx_runtime_1.jsx)("input", { type: "text", className: "form-control mb-3 p-0 ps-2", placeholder: "~/peers/packages/my-package", value: localPath || "", onChange: (e) => setLocalPath(e.target.value) })] }), remoteRepoUrl ? ((0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Source URL:", (0, jsx_runtime_1.jsxs)("small", { children: [(0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: `The remote source of this package.  Often a github repository URL or a link to the Peers page for the package.` }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-link", onClick: () => {
-                                            peers_sdk_1.rpcServerCalls.openLinkInBrowser(remoteRepoUrl);
+                                            void (0, host_shell_consumer_1.openOnHost)(remoteRepoUrl);
                                         }, children: "Open Remote" })] })] }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.remoteRepo, className: "form-control mb-3 p-0 ps-2", disabled: true })] })) : null, (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Update URL:", (0, jsx_runtime_1.jsx)("small", { children: (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: `Base URL for remote package updates. Admin devices poll **<updateUrl>/latest-<tag>.json** on startup (for example **latest-stable.json**). Signed artifacts must be published to this host separately — for example via the publish-package tool or the peers-core full-release pipeline.` }) })] }), (0, jsx_runtime_1.jsx)(input_1.Input, { value: pkg.qs.updateUrl, className: "form-control mb-3 p-0 ps-2", placeholder: "https://example.com/my-package", title: "Update URL" })] }), (0, jsx_runtime_1.jsxs)("div", { className: "mt-2", children: [(0, jsx_runtime_1.jsx)("hr", {}), (0, jsx_runtime_1.jsxs)("small", { children: ["Version:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "The currently active version of this package. Manage versions in the Versions tab." })] }), activeVersion ? ((0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center mt-1 mb-3", children: [(0, jsx_runtime_1.jsxs)("strong", { className: "me-2", children: ["v", activeVersion.version] }), activeVersion.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${activeVersion.versionTag === "dev" ? "text-bg-danger" : activeVersion.versionTag.startsWith("beta") ? "text-bg-warning" : "text-bg-success"} me-2`, children: activeVersion.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: activeVersion.packageVersionHash?.substring(0, 8) }), newerLevel === "uptodate" ? ((0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-success", children: "Up to date" })) : newerLevel ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge text-bg-${newerLevel === "major" ? "danger" : newerLevel === "minor" ? "warning" : "info"}`, children: ["Newer ", newerLevel, " version available"] })) : null] })) : ((0, jsx_runtime_1.jsx)("div", { className: "text-muted small mt-1 mb-3", children: "No active version" })), (0, jsx_runtime_1.jsxs)("div", { className: "mb-3", children: [(0, jsx_runtime_1.jsxs)("small", { children: ["Auto-Update Range:", (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: "Controls which new versions are auto-activated for the group. When an admin device auto-upgrades, the group's active version advances for everyone. **Pinned** = never auto-update. **Patch** = same major.minor (e.g. 1.2.x). **Minor** = same major (e.g. 1.x.x). **Latest** = always auto-update to newest." })] }), (0, jsx_runtime_1.jsxs)("select", { className: "form-select form-select-sm", value: groupRange, onChange: async (e) => {
                                     const val = e.target.value;
                                     const current = await (0, peers_sdk_1.Packages)().get(pkg.packageId);

package/dist/screens/packages/package-list.d.ts

@@ -1,3 +1,5 @@
-/** Searchable list of installed packages, plus create/import from the search box. */
-/** Packages screen: search, local folder grants, and the installed package list. */
+/**
+ * Packages screen: search, create/import/install from the search box, local folder grants,
+ * and the installed package list.
+ */
 export declare const PackageList: () => import("react/jsx-runtime").JSX.Element;