@peers-app/peers-ui 0.26.3 → 0.26.5

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

@@ -10,9 +10,12 @@ const loading_indicator_1 = require("../../components/loading-indicator");
 const tooltip_1 = require("../../components/tooltip");
 const globals_1 = require("../../globals");
 const hooks_1 = require("../../hooks");
+const host_shell_consumer_1 = require("../../host-shell/host-shell-consumer");
 const ui_loader_1 = require("../../ui-router/ui-loader");
 const local_folder_grants_panel_1 = require("./local-folder-grants-panel");
 const package_helpers_1 = require("./package-helpers");
+const package_runtime_status_1 = require("./package-runtime-status");
+const packages_ipc_1 = require("./packages-ipc");
 function tagBadgeClass(tag) {
     if (tag === "dev")
         return "text-bg-danger";
@@ -31,6 +34,18 @@ const PackageRow = ({ pkg, onUpdated }) => {
     const [updating, setUpdating] = (0, react_1.useState)(false);
     const [devicePrefs] = (0, hooks_1.useObservable)((0, peers_sdk_1.packagePrefsVar)(pkg.packageId));
     const effective = (0, peers_sdk_1.getEffectivePackagePrefs)(pkg, devicePrefs);
+    // A dev reload rewrites the selected version row in place (same id, new version), so the
+    // ids below do not change; recompute when this package's version rows change.
+    const [versionsRevision, setVersionsRevision] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        const sub = (0, peers_sdk_1.PackageVersions)().dataChanged.subscribe((evt) => {
+            if (evt.dataObject?.packageId === pkg.packageId)
+                setVersionsRevision((value) => value + 1);
+        });
+        return () => {
+            sub.unsubscribe();
+        };
+    }, [pkg.packageId]);
     const status = (0, hooks_1.usePromise)(async () => {
         if (!effective.activePackageVersionId)
             return null;
@@ -65,6 +80,7 @@ const PackageRow = ({ pkg, onUpdated }) => {
         pkg.packageId,
         effective.followTags,
         pkg.activePackageVersionId,
+        versionsRevision,
     ]);
     const isOnDev = status?.activePv.versionTag === "dev";
     const hasGroupRelease = !!status?.groupReleasePv;
@@ -91,7 +107,10 @@ const PackageRow = ({ pkg, onUpdated }) => {
     async function handleUseRelease() {
         setUpdating(true);
         try {
-            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, { activePackageVersionId: undefined });
+            await (await (0, packages_ipc_1.packagesTools)()).activatePackageVersion({
+                packageId: pkg.packageId,
+                scope: "device",
+            });
             onUpdated();
         }
         catch (err) {
@@ -106,8 +125,10 @@ const PackageRow = ({ pkg, onUpdated }) => {
             return;
         setUpdating(true);
         try {
-            await (0, peers_sdk_1.updatePackagePrefs)(pkg.packageId, {
-                activePackageVersionId: status.latestDevPv.packageVersionId,
+            await (await (0, packages_ipc_1.packagesTools)()).activatePackageVersion({
+                packageId: pkg.packageId,
+                packageVersionId: status.latestDevPv.packageVersionId,
+                scope: "device",
             });
             onUpdated();
         }
@@ -118,10 +139,12 @@ const PackageRow = ({ pkg, onUpdated }) => {
             setUpdating(false);
         }
     }
-    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid pb-4 d-flex align-items-center", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex-grow-1", style: { minWidth: 0 }, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-fill" }), "\u00A0\u00A0", (0, jsx_runtime_1.jsx)("a", { href: `#packages/${pkg.packageId}`, children: pkg.name }), isDeviceOverridden && ((0, jsx_runtime_1.jsx)("span", { className: "text-warning ms-1", title: "This device is using a different version than the group", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-pc-display" }) })), status && ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", status.activePv.version] }), status.activePv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${tagBadgeClass(status.activePv.versionTag)}`, style: { fontSize: "0.65em" }, children: status.activePv.versionTag })), hasUpdate ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 ${updateBadgeClass(status.newerLevel)}`, style: { fontSize: "0.65em" }, children: ["v", status.newestPv?.version, " available"] })) : isOnDev && hasGroupRelease ? ((0, jsx_runtime_1.jsxs)("span", { className: "badge ms-1 text-bg-secondary", style: { fontSize: "0.65em" }, children: ["release: v", status.groupReleasePv?.version] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] })), (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: pkg.description, positions: ["bottom", "top", "right", "left"] })] }), hasUpdate && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary ms-2 text-nowrap", disabled: updating, onClick: handleUpdate, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-arrow-up-circle me-1" })), "Update"] })), isOnDev && hasGroupRelease && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary ms-2 text-nowrap", disabled: updating, onClick: handleUseRelease, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-arrow-in-right me-1" })), "Use Release"] })), hasDevVersion && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-danger ms-2 text-nowrap", disabled: updating, onClick: handleUseDev, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-tools me-1" })), "Use Dev"] }))] }));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid pb-4 d-flex align-items-center", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex-grow-1", style: { minWidth: 0 }, children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-fill" }), "\u00A0\u00A0", (0, jsx_runtime_1.jsx)("a", { href: `#packages/${pkg.packageId}`, children: pkg.name }), (0, jsx_runtime_1.jsx)("span", { className: "ms-2", children: (0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeBadge, { packageId: pkg.packageId }) }), isDeviceOverridden && ((0, jsx_runtime_1.jsx)("span", { className: "text-warning ms-1", title: "This device is using a different version than the group", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-pc-display" }) })), status && ((0, jsx_runtime_1.jsxs)("span", { className: "ms-2", children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["v", status.activePv.version] }), status.activePv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ms-1 ${tagBadgeClass(status.activePv.versionTag)}`, style: { fontSize: "0.65em" }, children: status.activePv.versionTag })), hasUpdate ? ((0, jsx_runtime_1.jsxs)("span", { className: `badge ms-1 ${updateBadgeClass(status.newerLevel)}`, style: { fontSize: "0.65em" }, children: ["v", status.newestPv?.version, " available"] })) : isOnDev && hasGroupRelease ? ((0, jsx_runtime_1.jsxs)("span", { className: "badge ms-1 text-bg-secondary", style: { fontSize: "0.65em" }, children: ["release: v", status.groupReleasePv?.version] })) : ((0, jsx_runtime_1.jsx)("span", { className: "badge ms-1 text-bg-success", style: { fontSize: "0.65em" }, children: "up to date" }))] })), (0, jsx_runtime_1.jsx)(tooltip_1.Tooltip, { markdownContent: pkg.description, positions: ["bottom", "top", "right", "left"] })] }), hasUpdate && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary ms-2 text-nowrap", disabled: updating, onClick: handleUpdate, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-arrow-up-circle me-1" })), "Update"] })), isOnDev && hasGroupRelease && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary ms-2 text-nowrap", disabled: updating, onClick: handleUseRelease, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-arrow-in-right me-1" })), "Use Release"] })), hasDevVersion && ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-danger ms-2 text-nowrap", disabled: updating, onClick: handleUseDev, children: [updating ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-tools me-1" })), "Use Dev"] }))] }));
 };
-/** 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.
+ */
 const PackageList = () => {
     const [searchTextObs] = (0, react_1.useState)(() => (0, peers_sdk_1.observable)(""));
     const [searchText] = (0, hooks_1.useObservable)(searchTextObs);
@@ -201,12 +224,12 @@ const PackageList = () => {
         const name = searchText.trim();
         if (!name)
             return;
-        if (name.startsWith("http") || name.endsWith(".git")) {
+        if ((0, peers_sdk_1.isPackageRepositoryUrl)(name)) {
             if (!confirm(`Add remote package: ${name}`))
                 return;
             try {
                 addingPackage(true);
-                const { packageId } = (0, peers_sdk_1.unwrapAddOrUpdatePackageResult)(await peers_sdk_1.rpcServerCalls.addOrUpdatePackage(name));
+                const { packageId } = await (await (0, packages_ipc_1.packagesTools)()).clonePackage({ url: name });
                 const pkg = await (0, peers_sdk_1.Packages)().get(packageId);
                 if (pkg) {
                     (0, globals_1.mainContentPath)(`packages/${packageId}`);
@@ -222,11 +245,28 @@ const PackageList = () => {
             }
             return;
         }
+        // A package id re-enables that package, or copies it here from another of your contexts.
+        if ((0, peers_sdk_1.isid)(name)) {
+            if (!confirm(`Install package ${name} into this context`))
+                return;
+            try {
+                addingPackage(true);
+                const { packageId } = await (await (0, packages_ipc_1.packagesTools)()).installPackage({ packageId: name });
+                (0, globals_1.mainContentPath)(`packages/${packageId}`);
+            }
+            catch (err) {
+                confirm(`Error installing package: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            finally {
+                addingPackage(false);
+            }
+            return;
+        }
         if (!confirm(`Create or import local package: ${searchText}`))
             return;
         try {
             addingPackage(true);
-            const { packageId, warning } = (0, peers_sdk_1.unwrapAddOrUpdatePackageResult)(await peers_sdk_1.rpcServerCalls.addOrUpdatePackage(name));
+            const { packageId, warning } = await (await (0, packages_ipc_1.packagesTools)()).createPackage({ name });
             const pkg = await (0, peers_sdk_1.Packages)().get(packageId);
             if (pkg) {
                 if (warning) {
@@ -245,7 +285,7 @@ const PackageList = () => {
     if (addingPackage()) {
         return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsxs)("div", { className: "container-fluid d-flex justify-content-center mt-5", children: [(0, jsx_runtime_1.jsx)("i", { className: "bi bi-box-seam" }), "\u00A0 Adding Package"] }), (0, jsx_runtime_1.jsx)("div", { className: "container-fluid d-flex justify-content-center mt-2", children: (0, jsx_runtime_1.jsx)("div", { className: "progress", role: "progressbar", "aria-label": "Animated striped example", "aria-valuenow": 100, "aria-valuemin": 0, "aria-valuemax": 100, children: (0, jsx_runtime_1.jsx)("div", { className: "progress-bar progress-bar-striped progress-bar-animated", style: { width: 150 } }) }) })] }));
     }
-    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid", children: [(0, jsx_runtime_1.jsxs)("div", { className: "input-group mt-3 mb-3", children: [(0, jsx_runtime_1.jsx)(input_1.Input, { value: searchTextObs, className: "form-control", placeholder: "Search, add, or create package", autoFocus: !!(0, globals_1.isDesktop)(), onKeyUp: (evt) => searchSubmit(evt) }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-outline-secondary dropdown-toggle sm", type: "button", "data-bs-toggle": "dropdown", "aria-expanded": "false", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-plus-lg" }) }), (0, jsx_runtime_1.jsxs)("ul", { className: "dropdown-menu dropdown-menu-end", children: [(0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", href: "#packages/newlocal", children: "New Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Remote Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("hr", { className: "dropdown-divider" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", onClick: () => peers_sdk_1.rpcServerCalls.openPath(peers_sdk_1.packagesRootDir), style: { cursor: "pointer" }, children: "Open Packages Directory" }) })] })] }), (0, jsx_runtime_1.jsx)(local_folder_grants_panel_1.LocalFolderGrantsPanel, {}), (0, jsx_runtime_1.jsx)("div", { className: "peers-list-container", children: (0, jsx_runtime_1.jsx)(lazy_list_1.LazyList, { resetTrigger: `${searchText}_${refreshKey()}`, loadMore: loadMore, scrollThreshold: 0.6, renderItems: (packages) => {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "container-fluid", children: [(0, jsx_runtime_1.jsxs)("div", { className: "input-group mt-3 mb-3", children: [(0, jsx_runtime_1.jsx)(input_1.Input, { value: searchTextObs, className: "form-control", placeholder: "Search, add, or create package", autoFocus: !!(0, globals_1.isDesktop)(), onKeyUp: (evt) => searchSubmit(evt) }), (0, jsx_runtime_1.jsx)("button", { className: "btn btn-outline-secondary dropdown-toggle sm", type: "button", "data-bs-toggle": "dropdown", "aria-expanded": "false", children: (0, jsx_runtime_1.jsx)("i", { className: "bi bi-plus-lg" }) }), (0, jsx_runtime_1.jsxs)("ul", { className: "dropdown-menu dropdown-menu-end", children: [(0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", href: "#packages/newlocal", children: "New Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Local Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item disabled", href: "#", children: "Add Remote Package" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("hr", { className: "dropdown-divider" }) }), (0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)("a", { className: "dropdown-item", onClick: () => void (0, host_shell_consumer_1.openOnHost)(peers_sdk_1.packagesRootDir), style: { cursor: "pointer" }, children: "Open Packages Directory" }) })] })] }), (0, jsx_runtime_1.jsx)(local_folder_grants_panel_1.LocalFolderGrantsPanel, {}), (0, jsx_runtime_1.jsx)("div", { className: "peers-list-container", children: (0, jsx_runtime_1.jsx)(lazy_list_1.LazyList, { resetTrigger: `${searchText}_${refreshKey()}`, loadMore: loadMore, scrollThreshold: 0.6, renderItems: (packages) => {
                         return packages.map((pkg) => ((0, jsx_runtime_1.jsx)(PackageRow, { pkg: pkg, onUpdated: () => refreshKey(refreshKey() + 1) }, pkg.packageId)));
                     }, loadingIndicator: (0, jsx_runtime_1.jsx)("div", { className: "d-flex justify-content-center", style: { height: 200 }, children: (0, jsx_runtime_1.jsx)(loading_indicator_1.LoadingIndicator, {}) }), endOfList: (0, jsx_runtime_1.jsx)("div", { className: "d-flex justify-content-center", style: { height: 200 } }) }) })] }));
 };

package/dist/screens/packages/package-new-local.js

@@ -38,6 +38,8 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = __importStar(require("react"));
 const globals_1 = require("../../globals");
+const host_shell_consumer_1 = require("../../host-shell/host-shell-consumer");
+const packages_ipc_1 = require("./packages-ipc");
 /** Form for scaffolding a new local package from the template into `~/peers/packages`. */
 const PackageNewLocal = () => {
     const defaultName = "New Package";
@@ -59,16 +61,17 @@ const PackageNewLocal = () => {
     };
     const createLocalPackage = async () => {
         try {
-            const { packageId, warning } = (0, peers_sdk_1.unwrapAddOrUpdatePackageResult)(await peers_sdk_1.rpcServerCalls.addOrUpdatePackage(packageName, {
-                packageLocation: packageLocation || packageLocationDefault,
-            }));
+            const { packageId, warning } = await (await (0, packages_ipc_1.packagesTools)()).createPackage({
+                name: packageName,
+                location: packageLocation || packageLocationDefault,
+            });
             const pkg = await (0, peers_sdk_1.Packages)().get(packageId);
             if (pkg) {
                 if (warning) {
                     confirm(warning);
                 }
                 (0, globals_1.mainContentPath)(`packages/${packageId}`);
-                peers_sdk_1.rpcServerCalls.openPackage(packageLocation || packageLocationDefault);
+                void (0, host_shell_consumer_1.openInEditorOnHost)(packageLocation || packageLocationDefault);
             }
         }
         catch (err) {

package/dist/screens/packages/package-runtime-status.d.ts

@@ -0,0 +1,12 @@
+interface IPackageRuntimeProps {
+    /** Package to show. */
+    packageId: string;
+}
+/** Small badge with a package's runtime status on this device; renders nothing until known. */
+export declare const PackageRuntimeBadge: ({ packageId }: IPackageRuntimeProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Runtime status on this device: badge, running version, and the last load or worker
+ * failure.
+ */
+export declare const PackageRuntimeStatus: ({ packageId }: IPackageRuntimeProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/screens/packages/package-runtime-status.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageRuntimeStatus = exports.PackageRuntimeBadge = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const packages_ipc_1 = require("./packages-ipc");
+/** Small badge with a package's runtime status on this device; renders nothing until known. */
+const PackageRuntimeBadge = ({ packageId }) => {
+    const states = (0, packages_ipc_1.usePackageRuntimeStates)();
+    return (0, jsx_runtime_1.jsx)(RuntimeBadge, { state: states?.[packageId] });
+};
+exports.PackageRuntimeBadge = PackageRuntimeBadge;
+/**
+ * Runtime status on this device: badge, running version, and the last load or worker
+ * failure.
+ */
+const PackageRuntimeStatus = ({ packageId }) => {
+    const state = (0, packages_ipc_1.usePackageRuntimeStates)()?.[packageId];
+    if (!state)
+        return null;
+    const running = state.running;
+    const workerError = state.worker?.lastWorkerError;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "mb-3", "data-testid": "package-runtime-status", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center gap-2", children: [(0, jsx_runtime_1.jsx)(RuntimeBadge, { state: state }), running?.version ? ((0, jsx_runtime_1.jsxs)("span", { className: "text-muted small", children: ["Running v", running.version, running.versionTag ? ` (${running.versionTag})` : "", " on this device"] })) : state.reason ? ((0, jsx_runtime_1.jsx)("span", { className: "text-muted small", children: state.reason })) : null] }), state.status === "failed" && state.lastError ? ((0, jsx_runtime_1.jsx)(RuntimeError, { title: state.lastError.version
+                    ? `Loading v${state.lastError.version} failed`
+                    : "Loading this package failed", message: state.lastError.message })) : null, workerError ? ((0, jsx_runtime_1.jsx)(RuntimeError, { title: "The package worker failed", message: workerError.message })) : null] }));
+};
+exports.PackageRuntimeStatus = PackageRuntimeStatus;
+const RuntimeBadge = ({ state }) => {
+    const badge = (0, packages_ipc_1.packageStatusBadge)(state);
+    if (!badge)
+        return null;
+    return ((0, jsx_runtime_1.jsx)("span", { className: `badge text-bg-${badge.color}`, title: state?.lastError?.message, children: badge.label }));
+};
+const RuntimeError = ({ title, message }) => ((0, jsx_runtime_1.jsxs)("div", { className: "alert alert-danger py-2 px-3 mt-2 mb-0 small", role: "alert", children: [(0, jsx_runtime_1.jsxs)("strong", { children: [title, ":"] }), " ", (0, jsx_runtime_1.jsx)("span", { className: "font-monospace", children: message })] }));

package/dist/screens/packages/package-runtime-status.test.d.ts

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

package/dist/screens/packages/package-runtime-status.test.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@testing-library/react");
+const package_runtime_status_1 = require("./package-runtime-status");
+let mockStates;
+jest.mock("./packages-ipc", () => ({
+    ...jest.requireActual("./packages-ipc"),
+    usePackageRuntimeStates: () => mockStates,
+}));
+const packageId = "pkg";
+describe("PackageRuntimeStatus", () => {
+    it("renders nothing until the host reports state", () => {
+        mockStates = undefined;
+        expect((0, react_1.render)((0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeStatus, { packageId: packageId })).container).toBeEmptyDOMElement();
+    });
+    it("shows the running version and a failed replacement's error", () => {
+        mockStates = {
+            [packageId]: {
+                packageId,
+                status: "failed",
+                running: { kind: "isolated", version: "1.0.0", versionTag: "dev" },
+                lastError: { phase: "load", message: "manifest has unknown key", version: "1.0.1", at: 1 },
+                updatedAt: 1,
+            },
+        };
+        const view = (0, react_1.render)((0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeStatus, { packageId: packageId }));
+        expect(view.container).toHaveTextContent("Update failed");
+        expect(view.container).toHaveTextContent("Running v1.0.0 (dev) on this device");
+        expect(view.getByRole("alert")).toHaveTextContent("Loading v1.0.1 failed: manifest has unknown key");
+    });
+    it("shows a worker failure and a reason when nothing is running", () => {
+        mockStates = {
+            [packageId]: {
+                packageId,
+                status: "unavailable",
+                reason: "The selected version's bundle file is not on this device yet",
+                worker: { workerRunning: false, lastWorkerError: { message: "boom", at: 1 } },
+                updatedAt: 1,
+            },
+        };
+        const view = (0, react_1.render)((0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeStatus, { packageId: packageId }));
+        expect(view.container).toHaveTextContent("not on this device yet");
+        expect(view.getByRole("alert")).toHaveTextContent("The package worker failed: boom");
+    });
+    it("renders a running badge", () => {
+        mockStates = { [packageId]: { packageId, status: "running", updatedAt: 1 } };
+        expect((0, react_1.render)((0, jsx_runtime_1.jsx)(package_runtime_status_1.PackageRuntimeBadge, { packageId: packageId })).container).toHaveTextContent("Running");
+    });
+});

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

@@ -6,6 +6,7 @@ const peers_sdk_1 = require("@peers-app/peers-sdk");
 const react_1 = require("react");
 const hooks_1 = require("../../hooks");
 const package_helpers_1 = require("./package-helpers");
+const packages_ipc_1 = require("./packages-ipc");
 function formatDate(iso) {
     try {
         const d = new Date(iso);
@@ -107,50 +108,16 @@ const PackageVersionsList = (props) => {
     }
     async function promoteVersion(pv, newTag) {
         try {
-            const me = await (0, peers_sdk_1.getMe)();
-            const history = [...(pv.history ?? [])];
-            history.push({
-                action: `promoted:${newTag}`,
-                by: me.userId,
-                at: new Date().toISOString(),
-                signature: "",
-            });
-            const pvHash = (0, peers_sdk_1.computePackageVersionHash)(pv.version, newTag, pv.packageBundleFileHash, pv.routesBundleFileHash, pv.uiBundleFileHash);
-            // Auto-sign with package author key if available (server/PWA host — key never
-            // exposed to UI). Soft-fail when the key is missing so group admins can still
-            // promote, but never keep a signature that was computed for the old tag.
-            const authorSig = await peers_sdk_1.rpcServerCalls.signPackageAuthorVersion({
-                packageId: pv.packageId,
+            // The host re-tags, re-signs, records history, and activates the version when this
+            // device was running it and the group follows the new tag.
+            const result = await (await (0, packages_ipc_1.packagesTools)()).promotePackageVersion({
                 packageVersionId: pv.packageVersionId,
-                version: pv.version,
-                versionTag: newTag,
-                packageBundleFileHash: pv.packageBundleFileHash,
-                routesBundleFileHash: pv.routesBundleFileHash,
-                uiBundleFileHash: pv.uiBundleFileHash,
-                appNavs: pv.appNavs,
-                createdBy: pv.createdBy,
-                createdAt: pv.createdAt,
-            });
-            const updated = {
-                ...pv,
                 versionTag: newTag,
-                packageVersionHash: pvHash,
-                history,
-                packageAuthorSignature: authorSig,
-            };
-            await (0, peers_sdk_1.PackageVersions)().signAndSave(updated, { saveAsSnapshot: true });
-            // Promoting the version this device is already running should advance the
-            // group active version when the new tag matches group follow policy
-            // (e.g. promote active → stable with default follow settings).
-            const pkgJs = pkg.toJS();
-            const activated = await (0, package_helpers_1.maybeActivateAfterPromote)(pkg.packageId, updated, {
-                wasEffectiveActive: pv.packageVersionId === effectiveActiveVersionId,
-                groupFollowTags: pkgJs.followVersionTags,
-                groupPinned: pkgJs.versionFollowRange === "pinned",
             });
-            if (activated) {
+            if (result.warning)
+                alert(result.warning);
+            if (result.activated)
                 await pkg.load();
-            }
             refreshKey(refreshKey() + 1);
         }
         catch (err) {
@@ -190,24 +157,10 @@ const PackageVersionsList = (props) => {
     return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: [sorted.length, " version", sorted.length !== 1 ? "s" : ""] }), (0, jsx_runtime_1.jsx)("div", { className: "list-group mt-2", children: sorted.map((pv) => ((0, jsx_runtime_1.jsx)(VersionRow, { pv: pv, isActive: pv.packageVersionId === effectiveActiveVersionId, isPinned: isPinned, pinning: pinning, activating: activating, deleting: deleting, userMap: userMap, onActivate: activateVersion, onDelete: deleteVersion, onPin: pinVersion, onPromote: promoteVersion }, pv.packageVersionId))) })] }));
 };
 exports.PackageVersionsList = PackageVersionsList;
-/**
- * Valid promotion targets for each version tag. Promotion only moves forward:
- * dev -> beta -> stable. No demotions allowed.
- */
-function getPromoteTargets(currentTag) {
-    switch (currentTag) {
-        case "dev":
-            return ["beta", "stable"];
-        case "beta":
-            return ["stable"];
-        default:
-            return [];
-    }
-}
 function VersionRow(props) {
     const { pv, isActive, isPinned, pinning, activating, deleting, userMap } = props;
     const creatorName = userMap.get(pv.createdBy);
     const currentTag = pv.versionTag || "dev";
-    const promoteTargets = getPromoteTargets(currentTag);
+    const promoteTargets = (0, peers_sdk_1.packageVersionPromotionTargets)(currentTag);
     return ((0, jsx_runtime_1.jsx)("div", { className: `list-group-item ${isActive ? "list-group-item-success" : ""}`, children: (0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center justify-content-between", children: [(0, jsx_runtime_1.jsxs)("div", { className: "d-flex align-items-center flex-wrap", children: [(0, jsx_runtime_1.jsxs)("strong", { className: "me-2", children: ["v", pv.version] }), pv.versionTag && ((0, jsx_runtime_1.jsx)("span", { className: `badge ${tagBadgeClass(pv.versionTag)} me-2`, children: pv.versionTag })), (0, jsx_runtime_1.jsx)("code", { className: "text-muted small me-2", children: pv.packageVersionHash?.substring(0, 8) }), (0, jsx_runtime_1.jsx)("small", { className: "text-muted me-2", children: formatDate(pv.createdAt) }), creatorName && (0, jsx_runtime_1.jsxs)("small", { className: "text-muted", children: ["by ", creatorName] })] }), (0, jsx_runtime_1.jsxs)("div", { className: "d-flex gap-1 align-items-center", children: [promoteTargets.length > 0 && ((0, jsx_runtime_1.jsxs)("div", { className: "dropdown", children: [(0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-info dropdown-toggle", "data-bs-toggle": "dropdown", "data-bs-popper-config": '{"strategy":"fixed"}', title: "Change version tag", children: "Promote" }), (0, jsx_runtime_1.jsx)("ul", { className: "dropdown-menu dropdown-menu-end", children: promoteTargets.map((tag) => ((0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsxs)("button", { className: "dropdown-item", onClick: () => props.onPromote(pv, tag), children: [currentTag, " \u2192 ", tag] }) }, tag))) })] })), isActive ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-secondary", disabled: isPinned || pinning, onClick: () => props.onPin(), title: isPinned ? "Already pinned" : "Pin to this version (disable auto-updates)", children: [pinning ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-pin-fill" })), isPinned ? " Pinned" : " Pin"] }), (0, jsx_runtime_1.jsx)("span", { className: "badge text-bg-info align-self-center", children: "active" })] })) : ((0, jsx_runtime_1.jsxs)("button", { className: "btn btn-sm btn-outline-primary", disabled: activating === pv.packageVersionId, onClick: () => props.onActivate(pv), children: [activating === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm me-1" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-check2-circle me-1" })), "Activate"] })), !isActive && ((0, jsx_runtime_1.jsx)("button", { className: "btn btn-sm btn-outline-danger", disabled: deleting === pv.packageVersionId, onClick: () => props.onDelete(pv), children: deleting === pv.packageVersionId ? ((0, jsx_runtime_1.jsx)("span", { className: "spinner-border spinner-border-sm" })) : ((0, jsx_runtime_1.jsx)("i", { className: "bi bi-trash" })) }))] })] }) }));
 }

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

@@ -0,0 +1,41 @@
+import { type IHostContractConsumer, type IPackageObservedRuntime, type IPackagesConsumer, type PackageRuntimeStates } from "@peers-app/peers-sdk";
+/**
+ * Shared System Packages handle for one data context; stable for `useHostContract`.
+ *
+ * @param dataContextId - Personal context (user id) or group id.
+ */
+export declare function packagesContractFor(dataContextId: string): IHostContractConsumer<IPackagesConsumer>;
+/**
+ * Resolve the System Packages consumer for a data context.
+ *
+ * @param dataContextId - Context to bind; defaults to the active group, the same context
+ *   `Packages()` reads.
+ */
+export declare function getPackagesConsumer(dataContextId?: string): Promise<IPackagesConsumer>;
+/**
+ * System Packages tools bound to a data context.
+ *
+ * @param dataContextId - Context to bind; defaults to the active group.
+ */
+export declare function packagesTools(dataContextId?: string): Promise<IPackagesConsumer["tools"]>;
+/**
+ * Live runtime state of a context's packages on this device.
+ *
+ * @param dataContextId - Context to watch; defaults to the active group.
+ * @returns States keyed by package id, or `undefined` until the host answers.
+ */
+export declare function usePackageRuntimeStates(dataContextId?: string): PackageRuntimeStates | undefined;
+/** Display label and Bootstrap badge color for an observed package status. */
+export interface IPackageStatusBadge {
+    /** Short status label. */
+    label: string;
+    /** Bootstrap text-bg color suffix (`success`, `danger`, ...). */
+    color: "success" | "danger" | "warning" | "secondary";
+}
+/**
+ * Describe a package's observed runtime status for a badge.
+ *
+ * @param runtime - Observed runtime state, or `undefined` before the host reports one.
+ * @returns The badge, or `undefined` when there is nothing to show.
+ */
+export declare function packageStatusBadge(runtime: Pick<IPackageObservedRuntime, "status" | "running" | "worker"> | undefined): IPackageStatusBadge | undefined;

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

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packagesContractFor = packagesContractFor;
+exports.getPackagesConsumer = getPackagesConsumer;
+exports.packagesTools = packagesTools;
+exports.usePackageRuntimeStates = usePackageRuntimeStates;
+exports.packageStatusBadge = packageStatusBadge;
+const peers_sdk_1 = require("@peers-app/peers-sdk");
+const react_1 = require("react");
+const hooks_1 = require("../../hooks");
+const use_host_contract_1 = require("../../hooks/use-host-contract");
+const handles = new Map();
+/**
+ * Shared System Packages handle for one data context; stable for `useHostContract`.
+ *
+ * @param dataContextId - Personal context (user id) or group id.
+ */
+function packagesContractFor(dataContextId) {
+    let handle = handles.get(dataContextId);
+    if (!handle) {
+        handle = (0, peers_sdk_1.hostContractConsumer)((0, peers_sdk_1.getPackagesContractDefinition)(), {
+            dataContextId: async () => dataContextId,
+        });
+        handles.set(dataContextId, handle);
+    }
+    return handle;
+}
+/**
+ * Resolve the System Packages consumer for a data context.
+ *
+ * @param dataContextId - Context to bind; defaults to the active group, the same context
+ *   `Packages()` reads.
+ */
+async function getPackagesConsumer(dataContextId) {
+    const id = dataContextId ?? (await (0, peers_sdk_1.getDefaultDataContext)()).dataContextId;
+    return packagesContractFor(id).get();
+}
+/**
+ * System Packages tools bound to a data context.
+ *
+ * @param dataContextId - Context to bind; defaults to the active group.
+ */
+async function packagesTools(dataContextId) {
+    return (await getPackagesConsumer(dataContextId)).tools;
+}
+/** A handle that never connects, used until the data context id is known. */
+const pendingHandle = {
+    get: () => new Promise(() => undefined),
+    dispose: () => undefined,
+};
+/**
+ * Live runtime state of a context's packages on this device.
+ *
+ * @param dataContextId - Context to watch; defaults to the active group.
+ * @returns States keyed by package id, or `undefined` until the host answers.
+ */
+function usePackageRuntimeStates(dataContextId) {
+    const [handle, setHandle] = (0, react_1.useState)();
+    (0, react_1.useEffect)(() => {
+        let cancelled = false;
+        (dataContextId
+            ? Promise.resolve(dataContextId)
+            : (0, peers_sdk_1.getDefaultDataContext)().then((dc) => dc.dataContextId)).then((id) => {
+            if (!cancelled)
+                setHandle(packagesContractFor(id));
+        }, () => undefined);
+        return () => {
+            cancelled = true;
+        };
+    }, [dataContextId]);
+    const { consumer } = (0, use_host_contract_1.useHostContract)(handle ?? pendingHandle);
+    const [states] = (0, hooks_1.useObservable)(consumer?.observables.runtimeStates);
+    return states;
+}
+/**
+ * Describe a package's observed runtime status for a badge.
+ *
+ * @param runtime - Observed runtime state, or `undefined` before the host reports one.
+ * @returns The badge, or `undefined` when there is nothing to show.
+ */
+function packageStatusBadge(runtime) {
+    if (!runtime)
+        return undefined;
+    if (runtime.worker?.lastWorkerError)
+        return { label: "Worker failed", color: "danger" };
+    switch (runtime.status) {
+        case "running":
+            return { label: "Running", color: "success" };
+        case "failed":
+            return runtime.running
+                ? { label: "Update failed", color: "warning" }
+                : { label: "Failed", color: "danger" };
+        case "unavailable":
+            return { label: "Waiting for files", color: "warning" };
+        case "unsupported":
+            return { label: "Unsupported here", color: "secondary" };
+        case "disabled":
+            return { label: "Disabled", color: "secondary" };
+        default:
+            return undefined;
+    }
+}

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

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

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const hostContractConsumer = jest.fn((_definition, options) => ({
+    get: async () => ({ tools: { boundTo: await options.dataContextId() } }),
+    dispose: jest.fn(),
+}));
+jest.mock("@peers-app/peers-sdk", () => ({
+    getDefaultDataContext: async () => ({ dataContextId: "active-group" }),
+    getPackagesContractDefinition: () => ({ name: "System Packages" }),
+    hostContractConsumer: (definition, options) => hostContractConsumer(definition, options),
+    subscribeHostContractTransport: () => () => undefined,
+}));
+const packages_ipc_1 = require("./packages-ipc");
+test("caches one host consumer per data context and defaults to the active group", async () => {
+    expect((0, packages_ipc_1.packagesContractFor)("group-a")).toBe((0, packages_ipc_1.packagesContractFor)("group-a"));
+    expect((0, packages_ipc_1.packagesContractFor)("group-b")).not.toBe((0, packages_ipc_1.packagesContractFor)("group-a"));
+    expect(await (0, packages_ipc_1.packagesTools)("group-b")).toEqual({ boundTo: "group-b" });
+    expect(await (0, packages_ipc_1.packagesTools)()).toEqual({ boundTo: "active-group" });
+    expect(hostContractConsumer).toHaveBeenCalledTimes(3);
+});
+test.each([
+    [undefined, undefined],
+    [{ status: "running" }, { label: "Running", color: "success" }],
+    [{ status: "failed" }, { label: "Failed", color: "danger" }],
+    [
+        { status: "failed", running: { kind: "isolated", version: "1.0.0" } },
+        { label: "Update failed", color: "warning" },
+    ],
+    [
+        {
+            status: "running",
+            worker: { workerRunning: false, lastWorkerError: { message: "x", at: 1 } },
+        },
+        { label: "Worker failed", color: "danger" },
+    ],
+    [{ status: "unavailable" }, { label: "Waiting for files", color: "warning" }],
+    [{ status: "unsupported" }, { label: "Unsupported here", color: "secondary" }],
+    [{ status: "disabled" }, { label: "Disabled", color: "secondary" }],
+    [{ status: "inactive" }, undefined],
+    [{ status: "notLoaded" }, undefined],
+])("badge for %p", (runtime, expected) => {
+    expect((0, packages_ipc_1.packageStatusBadge)(runtime)).toEqual(expected);
+});

package/dist/screens/tools/tool-catalog-ipc.test.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const list = jest.fn();
 const get = jest.fn();
 const rows = jest.fn();
+const mainContentPath = jest.fn();
+jest.mock("../../globals", () => ({ mainContentPath }));
 let transport = true;
 jest.mock("@peers-app/peers-sdk", () => ({
     getDefaultDataContext: async () => ({ dataContextId: "group" }),
@@ -32,6 +34,10 @@ test("tool mentions include only workflow-invocable catalog tools", async () =>
         name: "historical",
     });
 });
+test("type mentions navigate directly through the UI route observable", () => {
+    mention_configs_1.valueTypeMentionConfig.onClick?.({ kind: "valueType", id: "type-id", name: "Type" });
+    expect(mainContentPath).toHaveBeenCalledWith("peer-types/type-id");
+});
 test("browser fallback omits quarantined rows and preserves historical detail", async () => {
     transport = false;
     rows.mockResolvedValue([

package/dist/screens/variables/variable-details.d.ts

@@ -1,5 +1,6 @@
 interface IProps {
     persistentVarId: string;
 }
+/** Details screen for one persistent variable: name, value (copyable), and settings. */
 export declare const VariableDetails: (props: IProps) => import("react/jsx-runtime").JSX.Element;
 export {};