@iseoane/agent-depot 0.4.1 → 0.5.0

package/dist/src/tui/catalog-state.js

@@ -1,8 +1,12 @@
 import { useCallback, useEffect, useReducer, useRef, useState } from "react";
+import { packageSelectionFor } from "../package-model.js";
+import { projectSourceOf } from "../sources.js";
 import { filterReducer, initialFilter } from "./catalog-filter.js";
 import { loadInstalledSkills, NO_INSTALLED } from "./catalog-installs.js";
-/** Discovers the Skills of one Source, or of all of them, and again whenever those inputs change. */
-export function useCatalogSkills(operations, sourceId, all) {
+import { sourceLabel } from "./catalog-tree.js";
+import { packageOperationsOf } from "./environment.js";
+/** Discovers the Skills of one Source, or of all of them, and again whenever those inputs or `reloadKey` change. */
+export function useCatalogSkills(operations, sourceId, all, env, reloadKey = 0) {
     const [state, setState] = useState({ status: "loading" });
     useEffect(() => {
         let cancelled = false;
@@ -13,12 +17,59 @@ export function useCatalogSkills(operations, sourceId, all) {
         setState({ status: "loading" });
         void (async () => {
             try {
+                const sources = await operations.listSources();
                 const ids = all || sourceId === undefined
-                    ? (await operations.listSources()).map((source) => source.id)
+                    ? sources.map((source) => source.id)
                     : [sourceId];
-                const skills = await operations.discoverSkills(ids);
+                const labels = new Map(sources.map((source) => [source.id, sourceLabel(source)]));
+                const skills = [];
+                const bundles = [];
+                const discovered = [];
+                const warnings = [];
+                try {
+                    skills.push(...await operations.discoverSkills(ids));
+                }
+                catch {
+                    // Discovery is read-only: isolate failures without silently refreshing Sources.
+                    for (const id of ids) {
+                        try {
+                            skills.push(...await operations.discoverSkills([id]));
+                        }
+                        catch (error) {
+                            const detail = error instanceof Error ? error.message : String(error);
+                            warnings.push(`Source ${labels.get(id) ?? id} unavailable: ${detail}. Go to Sources (1) and refresh it with r.`);
+                        }
+                    }
+                }
+                // Bundles read the same snapshots and group under their Source; one failure never hides the Skills.
+                const packages = packageOperationsOf(env);
+                for (const id of ids) {
+                    const source = sources.find((candidate) => candidate.id === id);
+                    if (source === undefined)
+                        continue;
+                    try {
+                        const projectSource = projectSourceOf(source);
+                        for (const descriptor of await packages.discover([id])) {
+                            bundles.push({ sourceId: id, selection: packageSelectionFor(descriptor, projectSource), descriptor });
+                            discovered.push({ source: projectSource, descriptor });
+                        }
+                    }
+                    catch (error) {
+                        const detail = error instanceof Error ? error.message : String(error);
+                        warnings.push(`Source ${labels.get(id) ?? id} Packages unavailable: ${detail}`);
+                    }
+                }
+                // Ownership is selection- or host-gated, so a loose Skill stays normal until its Package is active.
+                let activeBundles = [];
+                try {
+                    activeBundles = (await packages.activeBundles(discovered)).map(bundle => bundle.descriptor);
+                }
+                catch (error) {
+                    const detail = error instanceof Error ? error.message : String(error);
+                    warnings.push(`Package ownership unavailable: ${detail}`);
+                }
                 if (!cancelled)
-                    setState({ status: "ready", skills });
+                    setState({ status: "ready", skills, bundles, activeBundles, warnings, sources });
             }
             catch (error) {
                 if (!cancelled)
@@ -28,7 +79,7 @@ export function useCatalogSkills(operations, sourceId, all) {
         return () => {
             cancelled = true;
         };
-    }, [operations, sourceId, all]);
+    }, [operations, sourceId, all, env, reloadKey]);
     return state;
 }
 /** The Skills already installed, loaded on mount and on demand. */

package/dist/src/tui/catalog-tree.js

@@ -1,32 +1,74 @@
+import { githubTreeLocation } from "../git-source.js";
+import { bundleRoot } from "../package-model.js";
+import { packageOwnedSkillMatcher } from "../package-owned-skills.js";
+import { packageVersionLabel } from "./package-rows.js";
 import { defaultExpanded } from "./tree.js";
 const DESCRIPTION_LIMIT = 60;
 export const UNMANAGED_MARKER = "on disk, unmanaged · adopt it from Installations";
 export const skillKey = (skill) => `skill:${skill.sourceId}:${skill.path}`;
+export const bundleKey = (entry) => `bundle:${entry.sourceId}:${entry.descriptor.host}:${bundleRoot(entry.descriptor.coordinates)}`;
 function truncate(text) {
     return text.length > DESCRIPTION_LIMIT ? `${text.slice(0, DESCRIPTION_LIMIT - 3)}...` : text;
 }
-/** Skills grouped by Source in first-seen order; a Source with no Skills never appears. */
-export function buildTree(skills) {
+/** A repository name, with directory and ref for scoped GitHub Sources. */
+export function sourceLabel(source) {
+    if (source.kind === "builtin")
+        return source.id;
+    const location = githubTreeLocation(source.url);
+    if (location !== undefined) {
+        return `${location.repository}${location.directory === undefined ? "" : ` · ${location.directory}`} @ ${location.ref}`;
+    }
+    const url = new URL(source.url);
+    const repository = url.pathname.replace(/^\/+|\/+$/gu, "").replace(/\.git$/u, "");
+    return url.hostname === "github.com" ? repository : `${url.host}/${repository}`;
+}
+/** Skills and their Source's Packages, in first-seen order; a Source with neither never appears. */
+export function buildTree(skills, sources = [], bundles = [], activeDescriptors = []) {
+    const labels = new Map(sources.map((source) => [source.id, sourceLabel(source)]));
+    const active = new Set(activeDescriptors);
     const bySource = new Map();
     for (const skill of skills)
         bySource.set(skill.sourceId, [...(bySource.get(skill.sourceId) ?? []), skill]);
-    return [...bySource].map(([sourceId, members]) => ({
-        id: `source:${sourceId}`,
-        data: { kind: "source", sourceId, count: members.length },
-        children: members.map((skill) => ({ id: skillKey(skill), data: { kind: "skill", skill } })),
-    }));
+    const bundlesBySource = new Map();
+    for (const bundle of bundles)
+        bundlesBySource.set(bundle.sourceId, [...(bundlesBySource.get(bundle.sourceId) ?? []), bundle]);
+    return [...new Set([...bySource.keys(), ...bundlesBySource.keys()])].map((sourceId) => {
+        const members = bySource.get(sourceId) ?? [];
+        const sourceBundles = bundlesBySource.get(sourceId) ?? [];
+        const owned = packageOwnedSkillMatcher(sourceBundles.map((entry) => entry.descriptor).filter((descriptor) => active.has(descriptor)));
+        return {
+            id: `source:${sourceId}`,
+            data: { kind: "source", sourceId, label: labels.get(sourceId) ?? sourceId, count: members.length },
+            children: [
+                ...(sourceBundles.length === 0 ? [] : [{
+                        id: `packages:${sourceId}`,
+                        data: { kind: "group", label: `Packages (${sourceBundles.length})` },
+                        children: sourceBundles.map((entry) => ({ id: bundleKey(entry), data: { kind: "bundle", entry } })),
+                    }]),
+                ...members.map((skill) => {
+                    const ownedBy = owned(skill.path);
+                    return { id: skillKey(skill), data: { kind: "skill", skill, ...(ownedBy === undefined ? {} : { ownedBy }) } };
+                }),
+            ],
+        };
+    });
 }
 function allSourceIds(roots) {
     return new Set(roots.filter((root) => (root.children?.length ?? 0) > 0).map((root) => root.id));
 }
-/** While a filter is set every matching source is open so the matches show; otherwise only the first. */
+/** Filtering opens matching Sources; otherwise all groups start collapsed. */
 export function openByDefault(nodes, query) {
-    return query === "" ? defaultExpanded(nodes) : allSourceIds(nodes);
+    return query === "" ? defaultExpanded() : allSourceIds(nodes);
 }
 export function describeRow(row) {
     const { data } = row.node;
     if (data.kind === "source")
-        return `${row.expanded ? "▾" : "▸"} ${data.sourceId} (${data.count})`;
+        return `${row.expanded ? "▾" : "▸"} ${data.label} (${data.count})`;
+    if (data.kind === "group")
+        return `${row.expanded ? "▾" : "▸"} ${data.label}`;
+    if (data.kind === "bundle") {
+        return `Package ${data.entry.descriptor.name} (${data.entry.descriptor.host})  ${packageVersionLabel(data.entry.descriptor.version)}`;
+    }
     return `${data.skill.name}  ${truncate(data.skill.description)}`;
 }
 /** The Skills under the tree's Sources, in display order. */

package/dist/src/tui/catalog-view.js

@@ -7,6 +7,8 @@ import { filterSkills } from "./catalog-filter.js";
 import { handleCatalogActionKey } from "./catalog-flow.js";
 import { isInstalled } from "./catalog-installs.js";
 import { ActionPanel, CatalogHeader, CatalogRowLine } from "./catalog-panel.js";
+import { packageOperationsOf } from "./environment.js";
+import { handlePackageKey, isPackageMode, startPackageAction } from "./package-actions.js";
 import { ListFooter } from "./panel-parts.js";
 import { useCatalogFilter, useCatalogSkills, useInstalledSkills } from "./catalog-state.js";
 import { buildTree, leavesOf, openByDefault, skillKey } from "./catalog-tree.js";
@@ -24,10 +26,13 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
     const marks = useMarks();
     const [message, setMessage] = useState();
     const [action, setActionState] = useState(BROWSE);
+    // Bumped after a Package action so discovery re-reads the refreshed Source.
+    const [reloadKey, setReloadKey] = useState(0);
     // Mirrors the action mode synchronously, like the filter, so later keystrokes and the shell never see stale state.
     const actionRef = useRef(BROWSE);
     const filter = useCatalogFilter(actionRef, onCapturingChange);
-    const state = useCatalogSkills(operations, sourceId, all);
+    const state = useCatalogSkills(operations, sourceId, all, env, reloadKey);
+    const packages = useMemo(() => packageOperationsOf(env), [env]);
     const { installed, installedReady, reloadInstalled } = useInstalledSkills(operations, env, mounted);
     const setAction = (next) => {
         actionRef.current = next;
@@ -37,7 +42,7 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
     const skills = state.status === "ready" ? state.skills : [];
     const installable = useMemo(() => skills.filter((skill) => !isInstalled(skill, installed)), [state, installed]);
     const visible = useMemo(() => filterSkills(installable, filter.filter.query), [installable, filter.filter.query]);
-    const roots = useMemo(() => buildTree(visible), [visible]);
+    const roots = useMemo(() => buildTree(visible, state.status === "ready" ? state.sources : [], state.status === "ready" ? state.bundles : [], state.status === "ready" ? state.activeBundles : []), [visible, state]);
     const navigation = useTreeNavigation(roots, (nodes) => openByDefault(nodes, filter.queryRef.current));
     // Discovering again starts the list over.
     const { restart } = navigation;
@@ -58,6 +63,21 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
             setAction(BROWSE);
         },
     };
+    const packageHost = {
+        setMode: setAction,
+        browse: () => setAction(BROWSE),
+        setMessage,
+        isMounted: () => mounted.current,
+        finish: async (result) => {
+            await reloadInstalled();
+            if (!mounted.current)
+                return;
+            setReloadKey((value) => value + 1);
+            setMessage(result);
+            setAction(BROWSE);
+        },
+    };
+    const packageContext = { packages, manage: packageHost };
     const browse = {
         navigation,
         height,
@@ -66,12 +86,15 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
         canWiden: sourceId !== undefined,
         ready: state.status === "ready",
         toggleAll: () => setAll((value) => !value),
+        startPackage: (target) => void startPackageAction(packageContext, target, "i"),
         setMessage,
         setAction,
     };
     useKeys((input, key) => {
         const mode = actionRef.current;
-        if (mode.kind !== "browse")
+        if (isPackageMode(mode))
+            handlePackageKey(packageContext, mode, input, key);
+        else if (mode.kind !== "browse")
             handleCatalogActionKey(flow, mode, input, key);
         else if (filter.filterRef.current.editing)
             filter.handleEditKey(input, key, navigation.restart);
@@ -85,5 +108,5 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
         return _jsxs(Text, { color: theme.error, children: ["Error: ", state.message] });
     const window = computeWindow(rows.length, index, height);
     const selectedCount = leavesOf(roots).filter((skill) => marks.marked.has(skillKey(skill))).length;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(CatalogHeader, { scope: scope, listed: visible.length, installable: installable.length, total: skills.length, filter: filter.filter }), rows.slice(window.start, window.end).map((row, offset) => (_jsx(CatalogRowLine, { row: row, selected: window.start + offset === index, marked: marks.marked.has(row.node.id), installed: installed }, row.node.id))), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), _jsx(ActionPanel, { mode: action })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [state.warnings.map((warning) => _jsx(Text, { color: theme.warning, children: warning }, warning)), _jsx(CatalogHeader, { scope: scope, listed: visible.length, installable: installable.length, total: skills.length, filter: filter.filter }), rows.slice(window.start, window.end).map((row, offset) => (_jsx(CatalogRowLine, { row: row, selected: window.start + offset === index, marked: marks.marked.has(row.node.id), installed: installed }, row.node.id))), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), _jsx(ActionPanel, { mode: action })] }));
 }

package/dist/src/tui/environment.js

@@ -1 +1,8 @@
-export {};
+import { createPackageOperations } from "../package-flow.js";
+/** The Package operations a view uses: the injected fake, or the real flow over this environment. */
+export function packageOperationsOf(environment) {
+    return environment.packages ?? createPackageOperations({
+        ...(environment.homeDirectory === undefined ? {} : { homeDirectory: environment.homeDirectory }),
+        ...environment.packagesEnvironment,
+    });
+}

package/dist/src/tui/installations-browse.js

@@ -1,4 +1,5 @@
 import { appName } from "./app-actions.js";
+import { startPackageAction } from "./package-actions.js";
 import { startBulkHostAddition, startBulkUninstall } from "./bulk-actions.js";
 import { skillOf, sourceIdOf } from "./installations.js";
 import { leavesOf, targetOf } from "./installations-tree.js";
@@ -26,13 +27,17 @@ function markRow(context, row) {
         context.setMessage({ kind: "error", text: "Mark skills, not group rows" });
         return;
     }
+    if (row.node.data.kind === "package") {
+        context.setMessage({ kind: "error", text: "Packages act from their own row; marking is not supported" });
+        return;
+    }
     context.setMessage(undefined);
     context.marks.setMarked(toggledMark(context.marks.markedRef.current, row.node.id));
 }
 /** `a`: marks every listed leaf, or unmarks them when they are all marked already. */
 function markAllListed(context, visible) {
     const { markedRef, setMarked } = context.marks;
-    const leaves = visible.filter((candidate) => candidate.node.data.kind !== "group").map((candidate) => candidate.node.id);
+    const leaves = visible.filter((candidate) => candidate.node.data.kind !== "group" && candidate.node.data.kind !== "package").map((candidate) => candidate.node.id);
     if (leaves.length === 0) {
         context.setMessage({ kind: "error", text: "There are no skills to select" });
         return;
@@ -71,6 +76,16 @@ function actOnInstallation(context, data, item, input, key) {
     else
         startHostAddition(context.manage, skill);
 }
+/** The per-row Package keys; Enter approves the install declaration. */
+const PACKAGE_ACTION_MESSAGE = "Packages use i install, U update, u uninstall, f forget and Enter approve";
+function actOnPackage(context, item, input, key) {
+    const action = key.return ? "approve" : input;
+    if (action === "i" || action === "U" || action === "u" || action === "f" || action === "approve") {
+        void startPackageAction({ packages: context.packages, manage: context.manage }, { selection: item.row.selection, name: item.row.name }, action);
+        return;
+    }
+    context.setMessage({ kind: "error", text: PACKAGE_ACTION_MESSAGE });
+}
 /** `A`, Enter, `u`, `h` and `i` on the highlighted row. */
 function actOnRow(context, snapshot, row, input, key) {
     const { data } = context;
@@ -87,6 +102,8 @@ function actOnRow(context, snapshot, row, input, key) {
     context.setMessage(undefined);
     if (item.kind === "unmanaged")
         actOnUnmanaged(context, item.group, input, key);
+    else if (item.kind === "package")
+        actOnPackage(context, item, input, key);
     else if (item.kind === "app") {
         if (input === "A")
             context.setMessage({ kind: "error", text: "Adoption applies to unmanaged Skills, not Apps" });
@@ -110,7 +127,8 @@ export function handleBrowseKey(context, input, key) {
     if (navigateTree(context.navigation, snapshot, context.height, input, key))
         return;
     const row = snapshot.visible[snapshot.at];
-    const rowAction = input === "A" || key.return || input === "u" || input === "h" || input === "i";
+    const rowAction = input === "A" || key.return || input === "u" || input === "h" || input === "i"
+        || (row?.node.data.kind === "package" && (input === "U" || input === "f"));
     const appMarks = leavesOf(context.navigation.latestRoots()).filter(node => context.marks.markedRef.current.has(node.id) && node.data.kind === "app");
     if ((input === "u" || input === "h" || input === "i") && appMarks.length) {
         if (markedTargets(context).length)

package/dist/src/tui/installations-rows.js

@@ -1,11 +1,12 @@
 import { jsxs as _jsxs } from "react/jsx-runtime";
 import { Text } from "ink";
 import { describeDetails, describeLinks, describeNode, markersOf } from "./installations-tree.js";
+import { describePackageRow } from "./package-rows.js";
 import { rowStyle, theme } from "./theme.js";
 /** One line of the Installations tree: cursor, indent, mark box, label and the leaf's details. */
 export function TreeRowLine({ row, selected, marked }) {
     const item = row.node.data;
     const leaf = !row.expandable && item.kind !== "group";
     const prefix = `${selected ? "> " : "  "}${"  ".repeat(row.depth)}${leaf ? (marked ? "[x] " : "[ ] ") : ""}`;
-    return (_jsxs(Text, { ...rowStyle(selected), color: item.kind === "group" ? theme.group : undefined, children: [prefix, describeNode(row), item.kind === "installation" ? (_jsxs(Text, { color: theme.marker, children: ["  ", describeDetails(item.row), markersOf(item.row) === "" ? "" : `  ${markersOf(item.row)}`] })) : null, item.kind === "unmanaged" && describeLinks(item.group) !== "" ? (_jsxs(Text, { color: theme.marker, children: ["  ", describeLinks(item.group)] })) : null] }));
+    return (_jsxs(Text, { ...rowStyle(selected), color: item.kind === "group" ? theme.group : undefined, children: [prefix, describeNode(row), item.kind === "installation" ? (_jsxs(Text, { color: theme.marker, children: ["  ", describeDetails(item.row), markersOf(item.row) === "" ? "" : `  ${markersOf(item.row)}`] })) : null, item.kind === "package" ? (_jsxs(Text, { color: theme.marker, children: ["  ", describePackageRow(item.row)] })) : null, item.kind === "unmanaged" && describeLinks(item.group) !== "" ? (_jsxs(Text, { color: theme.marker, children: ["  ", describeLinks(item.group)] })) : null] }));
 }

package/dist/src/tui/installations-tree.js

@@ -1,3 +1,4 @@
+import { selectionKey } from "../package-model.js";
 /** Managed installations of one scope, grouped by Source in first-seen order. */
 function sourceNodes(scope, rows) {
     const bySource = new Map();
@@ -40,6 +41,12 @@ export function buildTree(data) {
             id: "scope:apps", data: { kind: "group", label: `Apps (user-global) (${data.apps?.length ?? 0})${data.appsError ? ` — ${data.appsError}` : ""}` },
             children: (data.apps ?? []).map(row => ({ id: `app:${row.entry.file}`, data: { kind: "app", row } })),
         });
+    if (data.packages?.length || data.packagesError)
+        roots.push({
+            id: "scope:packages",
+            data: { kind: "group", label: `Packages (user-global) (${data.packages?.length ?? 0})${data.packagesError ? ` — ${data.packagesError}` : ""}` },
+            children: (data.packages ?? []).map(row => ({ id: `package:${selectionKey(row.selection)}`, data: { kind: "package", row } })),
+        });
     return roots;
 }
 /** Version, policy and hosts of a leaf; `adopted` / `modified` only when true (the legend explains them). */
@@ -67,9 +74,15 @@ export function describeNode(row) {
         return `${row.expandable ? (row.expanded ? "▾" : "▸") : " "} ${data.label}`;
     if (data.kind === "installation")
         return data.row.selection.path;
+    if (data.kind === "package")
+        return data.row.name;
     if (data.kind === "app") {
         const { entry, inspection } = data.row;
-        return `${entry.recipe?.name ?? entry.file}  ${inspection.status === "invalid" ? `invalid recipe: ${inspection.reason}` : inspection.installedVersion ?? inspection.status}`;
+        const name = entry.recipe?.name ?? entry.file;
+        if (inspection.status === "invalid")
+            return `${name}  invalid recipe: ${inspection.reason}`;
+        const version = inspection.installedVersion ?? inspection.status;
+        return `${name}  ${version}${inspection.evidence === "recorded" ? " (recorded)" : ""}`;
     }
     return `${data.group.name} [${data.group.hosts.join(", ")}]`;
 }

package/dist/src/tui/installations-view.js

@@ -3,6 +3,8 @@ import { Box, Text } from "ink";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createAppOperations } from "../app-flow.js";
 import { handleAppKey, isAppMode, startAppAction } from "./app-actions.js";
+import { handlePackageKey, isPackageMode } from "./package-actions.js";
+import { packageOperationsOf } from "./environment.js";
 import { loadInstallations } from "./installations.js";
 import { BROWSE } from "./installations-mode.js";
 import { errorText } from "./batch.js";
@@ -25,6 +27,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     const height = useListHeight(listHeight, 7);
     const env = environment ?? NO_ENVIRONMENT;
     const apps = useMemo(() => createAppOperations({ homeDirectory: env.homeDirectory, ...env.appEnvironment }), [env]);
+    const packages = useMemo(() => packageOperationsOf(env), [env]);
     const [state, setState] = useState({ status: "loading" });
     const [mode, setModeState] = useState(BROWSE);
     // Mirrors the mode synchronously so later keystrokes and the shell never see stale state.
@@ -41,7 +44,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
     const reload = useCallback(async () => {
         const generation = ++loadGeneration.current;
         try {
-            const data = await loadInstallations(operations, env, apps);
+            const data = await loadInstallations(operations, env, apps, packages);
             if (mounted.current && generation === loadGeneration.current)
                 setState({ status: "ready", data });
         }
@@ -49,7 +52,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
             if (mounted.current && generation === loadGeneration.current)
                 setState({ status: "error", message: errorText(error) });
         }
-    }, [operations, env, apps, mounted]);
+    }, [operations, env, apps, packages, mounted]);
     useEffect(() => {
         void reload();
     }, [reload]);
@@ -125,6 +128,7 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         marks,
         data,
         manage,
+        packages,
         startAdoption: (group) => void startAdoption(adoption, group),
         setMessage,
         startApps: (entries, input) => void startAppAction({ apps, manage }, entries, input),
@@ -133,6 +137,8 @@ export function InstallationsView({ operations, environment, onCapturingChange,
         const current = modeRef.current;
         if (current.kind === "browse")
             handleBrowseKey(browse, input, key);
+        else if (isPackageMode(current))
+            handlePackageKey({ packages, manage }, current, input, key);
         else if (isAppMode(current))
             handleAppKey({ apps, manage }, current, input, key);
         else if (!handleManageKey(manage, current, input, key))

package/dist/src/tui/installations.js

@@ -7,6 +7,8 @@ import { inspectSkillRemovals, userGlobalRemovalOptions } from "../skill-removal
 import { scanUserGlobalSkillInventory, } from "../user-global-skill-inventory.js";
 import { errorText } from "./batch.js";
 import { prepareInstall } from "./catalog-installs.js";
+import { packageOperationsOf } from "./environment.js";
+import { packageRow } from "./package-rows.js";
 /** Hosts in display order; the Claude root serves Claude Code, the shared root serves the others. */
 const HOST_DISPLAY_ORDER = ["claude", "pi", "codex", "opencode"];
 const ROOT_HOSTS = {
@@ -71,7 +73,7 @@ async function toRow(scope, selection, inspectionOptions) {
     };
 }
 /** Loads both scopes and the unmanaged user-global inventory the CLI's `update check` uses. */
-export async function loadInstallations(operations, environment, appOperations = createAppOperations({ homeDirectory: homeOf(environment), ...environment.appEnvironment })) {
+export async function loadInstallations(operations, environment, appOperations = createAppOperations({ homeDirectory: homeOf(environment), ...environment.appEnvironment }), packageOperations = packageOperationsOf(environment)) {
     const home = homeOf(environment);
     let apps = [];
     let appsError;
@@ -88,6 +90,14 @@ export async function loadInstallations(operations, environment, appOperations =
     catch (error) {
         appsError = errorText(error);
     }
+    let packages = [];
+    let packagesError;
+    try {
+        packages = await Promise.all((await packageOperations.list()).map(async (record) => packageRow(record, await packageOperations.inspect(record.selection))));
+    }
+    catch (error) {
+        packagesError = errorText(error);
+    }
     const globalRecords = operations.listUserGlobalInstallations
         ? await operations.listUserGlobalInstallations()
         : undefined;
@@ -121,7 +131,7 @@ export async function loadInstallations(operations, environment, appOperations =
         }))
         : [];
     const sources = await operations.listSources().catch(() => []);
-    return { unmanagedWarnings, global, project, ...(projectError === undefined ? {} : { projectError }), unmanaged, sources, apps, ...(appsError === undefined ? {} : { appsError }) };
+    return { unmanagedWarnings, global, project, ...(projectError === undefined ? {} : { projectError }), unmanaged, sources, apps, ...(appsError === undefined ? {} : { appsError }), packages, ...(packagesError === undefined ? {} : { packagesError }) };
 }
 /** Source id of an installation's Source, when that Source is still registered. */
 export function sourceIdOf(selection, sources) {

package/dist/src/tui/manage-actions.js

@@ -1,4 +1,5 @@
 import { APP_KINDS } from "./app-actions.js";
+import { PACKAGE_KINDS } from "./package-actions.js";
 import { globalRecord, missingHosts, prepareHostAddition, prepareHostRemoval, prepareUninstall, runHostAddition, runHostRemoval, runUninstall, UNINSTALL_REFUSALS, } from "./catalog-installs.js";
 import { errorText } from "./batch.js";
 import { BULK_KINDS, handleBulkKey } from "./bulk-actions.js";
@@ -13,6 +14,7 @@ const MANAGE_KINDS = new Set([
     "confirm-host-remove",
     "confirm-uninstall",
     ...APP_KINDS,
+    ...PACKAGE_KINDS,
     ...UNMANAGED_KINDS,
     ...BULK_KINDS,
     "busy",

package/dist/src/tui/manage-panel.js

@@ -1,6 +1,7 @@
 import { jsxs as _jsxs, Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { AppPanel } from "./app-actions.js";
+import { PackagePanel } from "./package-actions.js";
 import { ChecklistLines, HostChecklist, PreviewConfirm, PreviewLines } from "./panel-parts.js";
 import { theme } from "./theme.js";
 const plural = (n) => `${n} ${n === 1 ? "item" : "items"}`;
@@ -32,6 +33,10 @@ export function ManagePanel({ mode }) {
         case "app-confirm":
         case "app-manual":
             return _jsx(AppPanel, { mode: mode });
+        case "package-approve":
+        case "package-confirm":
+        case "package-forget":
+            return _jsx(PackagePanel, { mode: mode });
         case "remove-scope":
             return _jsxs(Text, { children: ["Uninstall ", mode.skill.name, " (hosts: ", mode.hosts.join(", "), "): 1 all hosts  2 choose hosts  (Esc cancel)"] });
         case "hosts-add":