@iseoane/agent-depot 0.5.0 → 0.5.2

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

@@ -1,9 +1,10 @@
 import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { describeSkills, HOST_CHOICES, SCOPE_CHOICES } from "./catalog-actions.js";
+import { packageOwnedSkillNotice, packageOwnerBadge } from "./catalog-ownership.js";
 import { skillKey } from "./catalog-tree.js";
 import { hasUnmanagedCopy } from "./catalog-installs.js";
-import { describeRow, UNMANAGED_MARKER } from "./catalog-tree.js";
+import { describeRow, truncateDescription, UNMANAGED_MARKER } from "./catalog-tree.js";
 import { isPackageMode, PackagePanel } from "./package-actions.js";
 import { HostChecklist, PreviewLines } from "./panel-parts.js";
 import { rowStyle } from "./theme.js";
@@ -17,10 +18,17 @@ export function CatalogRowLine({ row, selected, marked, installed }) {
     const { data } = row.node;
     const isGroup = data.kind === "source" || data.kind === "group";
     const ownedBy = data.kind === "skill" ? data.ownedBy : undefined;
-    return (_jsxs(Text, { ...rowStyle(selected), color: isGroup ? theme.group : ownedBy === undefined ? undefined : theme.inactive, children: [selected ? "> " : "  ", "  ".repeat(row.depth), data.kind === "skill" ? marked ? "[x] " : "[ ] " : "", describeRow(row), ownedBy === undefined ? null : _jsxs(Text, { color: theme.inactive, children: ["  ", "provided by the ", ownedBy.host, " Package ", ownedBy.name] }), data.kind === "skill" && hasUnmanagedCopy(data.skill, installed)
+    return (_jsxs(Text, { ...rowStyle(selected), color: isGroup ? theme.group : undefined, wrap: "truncate-end", children: [selected ? "> " : "  ", "  ".repeat(row.depth), data.kind === "skill" ? marked ? "[x] " : "[ ] " : "", data.kind === "skill" && ownedBy !== undefined
+                ? _jsxs(_Fragment, { children: [data.skill.name, _jsxs(Text, { color: theme.marker, children: ["  ", "[", packageOwnerBadge(ownedBy), "]"] }), "  ", truncateDescription(data.skill.description)] })
+                : describeRow(row), data.kind === "skill" && hasUnmanagedCopy(data.skill, installed)
                 ? _jsxs(Text, { color: theme.marker, children: ["  ", UNMANAGED_MARKER] })
                 : null] }));
 }
+/** Full Package ownership reason for the highlighted Skill, outside the one-line row. */
+export function CatalogSelectionHelp({ row, height }) {
+    const owner = row?.node.data.kind === "skill" ? row.node.data.ownedBy : undefined;
+    return (_jsx(Box, { flexDirection: "column", minHeight: height, children: owner === undefined ? null : _jsx(Text, { color: theme.marker, children: packageOwnedSkillNotice(owner) }) }));
+}
 /** The prompt of the install flow; browsing shows nothing. */
 export function ActionPanel({ mode }) {
     if (isPackageMode(mode))

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

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useReducer, useRef, useState } from "react";
-import { packageSelectionFor } from "../package-model.js";
+import { packageSelectionFor, selectionKey } from "../package-model.js";
 import { projectSourceOf } from "../sources.js";
 import { filterReducer, initialFilter } from "./catalog-filter.js";
 import { loadInstalledSkills, NO_INSTALLED } from "./catalog-installs.js";
@@ -23,7 +23,7 @@ export function useCatalogSkills(operations, sourceId, all, env, reloadKey = 0)
                     : [sourceId];
                 const labels = new Map(sources.map((source) => [source.id, sourceLabel(source)]));
                 const skills = [];
-                const bundles = [];
+                let bundles = [];
                 const discovered = [];
                 const warnings = [];
                 try {
@@ -62,7 +62,12 @@ export function useCatalogSkills(operations, sourceId, all, env, reloadKey = 0)
                 // 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);
+                    const active = await packages.activeBundles(discovered);
+                    const installedKeys = new Set(active
+                        .filter(bundle => bundle.reason === "installed" || bundle.reason === "selected-and-installed")
+                        .map(bundle => selectionKey(bundle.selection)));
+                    bundles = bundles.filter(entry => !installedKeys.has(selectionKey(entry.selection)));
+                    activeBundles = active.map(bundle => bundle.descriptor);
                 }
                 catch (error) {
                     const detail = error instanceof Error ? error.message : String(error);

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

@@ -7,7 +7,7 @@ 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) {
+export function truncateDescription(text) {
     return text.length > DESCRIPTION_LIMIT ? `${text.slice(0, DESCRIPTION_LIMIT - 3)}...` : text;
 }
 /** A repository name, with directory and ref for scoped GitHub Sources. */
@@ -69,9 +69,13 @@ export function describeRow(row) {
     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)}`;
+    return `${data.skill.name}  ${truncateDescription(data.skill.description)}`;
 }
 /** The Skills under the tree's Sources, in display order. */
 export function leavesOf(roots) {
     return roots.flatMap((root) => (root.children ?? []).flatMap((child) => child.data.kind === "skill" ? [child.data.skill] : []));
 }
+/** Skills that can still be installed as loose Skills, excluding active Package-owned rows. */
+export function looseLeavesOf(roots) {
+    return roots.flatMap((root) => (root.children ?? []).flatMap((child) => child.data.kind === "skill" && child.data.ownedBy === undefined ? [child.data.skill] : []));
+}

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

@@ -1,12 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from "ink";
+import { Box, Text, useWindowSize } from "ink";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { BROWSE } from "./catalog-actions.js";
 import { handleCatalogBrowseKey } from "./catalog-browse.js";
 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 { ActionPanel, CatalogHeader, CatalogRowLine, CatalogSelectionHelp } from "./catalog-panel.js";
+import { packageOwnedSkillNotice } from "./catalog-ownership.js";
 import { packageOperationsOf } from "./environment.js";
 import { handlePackageKey, isPackageMode, startPackageAction } from "./package-actions.js";
 import { ListFooter } from "./panel-parts.js";
@@ -18,8 +19,26 @@ import { useMarks, useMounted } from "./view-state.js";
 import { computeWindow, useListHeight } from "./window.js";
 import { useKeys } from "./keys.js";
 const NO_ENVIRONMENT = {};
+function wrappedLineCount(text, columns) {
+    let lines = 1;
+    let used = 0;
+    for (const word of text.split(" ")) {
+        const width = [...word].reduce((total, character) => total + ((character.codePointAt(0) ?? 0) > 0xff ? 2 : 1), 0);
+        if (used > 0 && used + 1 + width <= columns) {
+            used += 1 + width;
+            continue;
+        }
+        if (used > 0) {
+            lines += 1;
+            used = 0;
+        }
+        lines += Math.floor((width - 1) / columns);
+        used = ((width - 1) % columns) + 1;
+    }
+    return lines;
+}
 export function CatalogView({ operations, sourceId, onCapturingChange, environment, listHeight }) {
-    const height = useListHeight(listHeight, 6);
+    const { columns } = useWindowSize();
     const env = environment ?? NO_ENVIRONMENT;
     const [all, setAll] = useState(sourceId === undefined);
     const mounted = useMounted();
@@ -48,6 +67,10 @@ export function CatalogView({ operations, sourceId, onCapturingChange, environme
     const { restart } = navigation;
     useEffect(restart, [operations, sourceId, all, restart]);
     const { rows, index } = navigation;
+    const helpLines = state.status === "ready"
+        ? Math.max(1, ...state.activeBundles.map((owner) => wrappedLineCount(packageOwnedSkillNotice(owner), Math.max(columns, 1))))
+        : 1;
+    const height = useListHeight(listHeight, 6 + helpLines);
     const flow = {
         operations,
         env,
@@ -108,5 +131,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: [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 })] }));
+    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(CatalogSelectionHelp, { row: rows[index], height: helpLines }), _jsx(ListFooter, { indicator: window.indicator, selectedCount: selectedCount, message: message }), _jsx(ActionPanel, { mode: action })] }));
 }

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

@@ -10,8 +10,14 @@ export function packageVersionLabel(evidence) {
 export function installedEvidenceLabel(evidence) {
     switch (evidence.kind) {
         case "installed": {
-            if (evidence.version !== undefined)
-                return `installed ${evidence.version}`;
+            if (evidence.version !== undefined) {
+                const qualifier = evidence.reason === undefined ? "" : " (HEAD; local changes)";
+                return `installed ${evidence.version}${qualifier}`;
+            }
+            if (evidence.reason !== undefined) {
+                const reason = evidence.reason.includes("local modifications") ? "local changes" : evidence.reason;
+                return `installed (version unavailable: ${reason})`;
+            }
             if (evidence.commit !== undefined)
                 return `installed at ${evidence.commit.slice(0, 7)}`;
             return "installed with no version evidence";
@@ -46,7 +52,7 @@ export function packageRow(record, inspection) {
         name: inspection.descriptor?.name ?? describeCoordinates(record.selection),
         installed: installedEvidenceLabel(inspection.installed),
         available: packageVersionLabel(inspection.available),
-        status: classifyUpdate(inspection.installed, inspection.available),
+        status: classifyUpdate(inspection.installed, inspection.available, inspection.availableCommit, inspection.installedCommitIsAncestor),
         ...(inspection.drift === undefined ? {} : { drift: inspection.drift }),
     };
 }

package/dist/src/tui/render.js

@@ -3,6 +3,6 @@ import { render } from "ink";
 import { App } from "./app.js";
 /** Renders the TUI and resolves once the user exits it. */
 export async function renderTui(operations, environment) {
-    const instance = render(_jsx(App, { operations: operations, environment: environment }));
+    const instance = render(_jsx(App, { operations: operations, environment: environment }), { alternateScreen: true });
     await instance.waitUntilExit();
 }

package/dist/src/tui/window.js

@@ -1,4 +1,4 @@
-import { useStdout } from "ink";
+import { useWindowSize } from "ink";
 /** Rows assumed when the terminal size is unknown (for example under test renderers). */
 export const FALLBACK_TERMINAL_ROWS = 24;
 /** Lines the shell itself uses: title, tab bar, separator and footer hint. */
@@ -23,9 +23,8 @@ export function pageStep(height) {
  * view's own `reserved` lines. `override` fixes the height for tests.
  */
 export function useListHeight(override, reserved) {
-    const { stdout } = useStdout();
+    const { rows } = useWindowSize();
     if (override !== undefined)
         return Math.max(override, 1);
-    const rows = stdout.rows ?? FALLBACK_TERMINAL_ROWS;
-    return Math.max(rows - APP_CHROME_ROWS - reserved, MINIMUM_ROWS);
+    return Math.max((rows || FALLBACK_TERMINAL_ROWS) - APP_CHROME_ROWS - reserved, MINIMUM_ROWS);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iseoane/agent-depot",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "A cross-platform catalog for reusable coding-agent skills.",
   "license": "MIT",
   "author": "iseoane",
@@ -26,6 +26,7 @@
   "files": [
     "dist/src",
     "!dist/src/**/*.map",
+    "resources/pi",
     "skills",
     "!skills/**/test_*.py",
     "!skills/**/testdata",
@@ -41,10 +42,39 @@
   "engines": {
     "node": ">=24"
   },
+  "peerDependencies": {
+    "@earendil-works/pi-tui": "^1.0.3",
+    "typebox": "^1.3.27"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-tui": "1.0.3",
+    "@eslint/js": "^9.39.2",
+    "@homebridge/node-pty-prebuilt-multiarch": "^0.14.1",
+    "@types/node": "^24.19.0",
+    "@types/react": "^19.3.0",
+    "eslint": "^9.39.2",
+    "ink-testing-library": "^4.0.0",
+    "typebox": "1.3.27",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.70.1"
+  },
+  "pi": {
+    "extensions": [
+      "./resources/pi/agents-panel/index.ts"
+    ]
+  },
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint \"src/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\"",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" \"resources/pi/**/*.{ts,tsx}\" \"tests/**/*.{ts,tsx}\"",
     "test": "pnpm build && node --test --import ./dist/tests/isolated-env.js \"dist/tests/*.test.js\"",
     "test:single": "pnpm build && node -e \"const { spawnSync } = require('node:child_process'); const input = process.argv[1] || 'tests/version.test.ts'; const file = input.replace(/^tests[\\\\/]/, 'dist/tests/').replace(/\\\\.ts$/i, '.js'); process.exit(spawnSync(process.execPath, ['--import', './dist/tests/isolated-env.js', '--test', file], { stdio: 'inherit' }).status ?? 1);\"",
     "test:coverage": "node -e \"require('node:fs').rmSync('coverage',{recursive:true,force:true})\" && tsc -p tsconfig.coverage.json && node -e \"const { spawnSync } = require('node:child_process'); process.exit(spawnSync(process.execPath, ['--enable-source-maps','--import','./dist/tests/isolated-env.js','--test','--test-reporter=dot','dist/tests/*.test.js'], { stdio: 'inherit', env: { ...process.env, NODE_V8_COVERAGE: 'coverage/v8' } }).status ?? 1);\"",
@@ -56,16 +86,6 @@
     "prepublishOnly": "pnpm build && pnpm test",
     "test:pack": "pnpm build && node scripts/pack-smoke.mjs"
   },
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@homebridge/node-pty-prebuilt-multiarch": "^0.14.1",
-    "@types/node": "^24.19.0",
-    "@types/react": "^19.3.0",
-    "eslint": "^9.39.2",
-    "ink-testing-library": "^4.0.0",
-    "typescript": "^5.7.2",
-    "typescript-eslint": "^8.70.1"
-  },
   "dependencies": {
     "ink": "^7.1.1",
     "react": "^19.3.0"

package/resources/pi/agents-panel/contract.ts

@@ -0,0 +1,62 @@
+import { Type, type Static } from "typebox";
+import { Value } from "typebox/value";
+
+const agentActivitySchema = Type.Object({
+  label: Type.String(),
+  at: Type.Number(),
+});
+
+const agentUsageSchema = Type.Object({
+  input: Type.Optional(Type.Number()),
+  output: Type.Optional(Type.Number()),
+  cacheRead: Type.Optional(Type.Number()),
+  cacheWrite: Type.Optional(Type.Number()),
+  totalTokens: Type.Optional(Type.Number()),
+  cost: Type.Optional(Type.Number()),
+});
+
+const agentSchema = Type.Object({
+  id: Type.String(),
+  description: Type.String(),
+  subagentType: Type.String(),
+  model: Type.String(),
+  thinking: Type.Optional(Type.String()),
+  readonly: Type.Boolean(),
+  status: Type.Union([
+    Type.Literal("running"),
+    Type.Literal("completed"),
+    Type.Literal("failed"),
+    Type.Literal("stopped"),
+  ]),
+  kind: Type.Union([Type.Literal("local"), Type.Literal("remote"), Type.Literal("ended")]),
+  pid: Type.Optional(Type.Number()),
+  startedAt: Type.String(),
+  endedAt: Type.Optional(Type.String()),
+  elapsedMs: Type.Number(),
+  observed: Type.Boolean(),
+  activity: Type.Optional(agentActivitySchema),
+  usage: Type.Optional(agentUsageSchema),
+  worktree: Type.Optional(Type.String()),
+});
+
+export const agentSnapshotRequestSchema = Type.Object({
+  version: Type.Literal(1),
+  requestId: Type.String(),
+});
+
+export const agentSnapshotResponseSchema = Type.Object({
+  version: Type.Literal(1),
+  requestId: Type.String(),
+  agents: Type.Array(agentSchema),
+});
+
+export type AgentSnapshot = Static<typeof agentSchema>;
+export type AgentSnapshotRequest = Static<typeof agentSnapshotRequestSchema>;
+export type AgentSnapshotResponse = Static<typeof agentSnapshotResponseSchema>;
+
+export const AGENT_SNAPSHOT_REQUEST_EVENT = "agent-depot:agents:v1:request";
+export const AGENT_SNAPSHOT_RESPONSE_EVENT = "agent-depot:agents:v1:snapshot";
+
+export function parseAgentSnapshotResponse(value: unknown): AgentSnapshotResponse | undefined {
+  return Value.Check(agentSnapshotResponseSchema, value) ? value : undefined;
+}