@alexgorbatchev/pi-skill-library 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # @alexgorbatchev/pi-skill-library
 
-[pi](https://pi.dev) extension that discovers `skills-library` roots and exposes their skills through `/library:<skill-name>` commands. This extension solves the problem of too many skills. There are skills that you need only occasionally and maybe don't even need them discoverable. 
+[pi](https://pi.dev) extension that discovers `skills-library` roots and exposes their skills through `/library:<skill-name>` commands. This extension solves the problem of too many skills. There are skills that you need only occasionally and maybe don't even need them discoverable.
 
 ## Install
 
@@ -39,10 +39,7 @@ Use a namespaced block in Pi settings:
 ```json
 {
   "@alexgorbatchev/pi-skills-library": {
-    "paths": [
-      "./skills-library",
-      "~/shared/pi-skills-library"
-    ]
+    "paths": ["./skills-library", "~/shared/pi-skills-library"]
   }
 }
 ```
@@ -78,11 +75,10 @@ Invoke a library skill directly:
 
 Discovered library skills are registered as real extension slash commands at startup and reload, so they show up in slash-command autocomplete like other commands.
 
-On startup, the extension prints a library-discovery message into the transcript listing each discovered library root and its skills. Home-directory paths are rendered with the `~/` convention.
+On startup, the extension prints a library-discovery message into the transcript listing each discovered library root and its skills.
 
 Use the package info command to print the same report again:
 
 ```text
 /pi-skill-library
 ```
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexgorbatchev/pi-skill-library",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Pi extension that exposes skills-library roots through /library:<skill-name> commands.",
   "type": "module",
   "author": "Alex Gorbatchev",
@@ -13,7 +13,6 @@
     "type": "git",
     "url": "git+https://github.com/alexgorbatchev/pi-skill-library.git"
   },
-  "packageManager": "bun@1.3.10",
   "keywords": [
     "pi-package",
     "pi-extension",
@@ -38,20 +37,17 @@
     "@mariozechner/pi-coding-agent": "*"
   },
   "devDependencies": {
-    "@mariozechner/pi-coding-agent": "0.64.0",
-    "@types/node": "24.7.2",
-    "@typescript/native-preview": "7.0.0-dev.20260330.1",
-    "dprint": "0.53.0",
-    "oxlint": "1.56.0",
+    "@alexgorbatchev/typescript-ai-policy": "^1.0.5",
+    "@mariozechner/pi-coding-agent": "0.65.2",
+    "@types/node": "25.5.2",
+    "@typescript/native-preview": "7.0.0-dev.20260407.1",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
     "typescript": "6.0.2"
   },
   "scripts": {
-    "dev": "bun x pi -e ./src/index.ts",
-    "check": "bun run typecheck && bun run lint && bun run format:check && bun run verify:pi-load",
-    "typecheck": "tsgo --noEmit -p tsconfig.json",
-    "lint": "oxlint --config oxlintrc.json .",
-    "format": "dprint fmt",
-    "format:check": "dprint check",
-    "verify:pi-load": "PI_OFFLINE=1 bun x pi --no-extensions -e ./src/index.ts --list-models > /dev/null 2>&1"
+    "check": "bun --bun oxfmt --write . && bun --bun oxlint . && tsgo --noEmit",
+    "test": "PI_OFFLINE=1 bun x pi --no-extensions -e ./src/index.ts --list-models > /dev/null 2>&1",
+    "test:local": "bun x pi -e ./src/index.ts"
   }
 }

package/src/createLibraryReport.ts

@@ -1,19 +1,12 @@
-import { groupLibrarySummariesByScope } from './groupLibrarySummariesByScope.js';
-import { replaceHomeDirectoryWithTilde } from './replaceHomeDirectoryWithTilde.js';
-import type { ILibraryReportDetails, ILibrarySkillDiscovery, ILibrarySummary } from './types.js';
+import { groupLibrarySummariesByScope } from "./groupLibrarySummariesByScope.js";
+import { replaceHomeDirectoryWithTilde } from "./replaceHomeDirectoryWithTilde.js";
+import type { ILibraryReportDetails, ILibrarySummary } from "./types.js";
 
-export function createLibraryReport(librarySkillDiscovery: ILibrarySkillDiscovery): string {
-  return createLibraryReportFromDetails({
-    diagnostics: librarySkillDiscovery.diagnostics,
-    librarySummaries: librarySkillDiscovery.librarySummaries,
-  });
-}
-
-export function createLibraryReportFromDetails(details: ILibraryReportDetails): string {
-  const lines = ['[Skills Library]'];
+export function createLibraryReport(details: ILibraryReportDetails): string {
+  const lines = ["[@alexgorbatchev/pi-skill-library]"];
   if (details.librarySummaries.length === 0) {
-    lines.push('  No library skills were discovered.');
-    return lines.join('\n');
+    lines.push("  No library skills were discovered.");
+    return lines.join("\n");
   }
 
   const librarySummariesByScope = groupLibrarySummariesByScope(details.librarySummaries);
@@ -25,13 +18,13 @@ export function createLibraryReportFromDetails(details: ILibraryReportDetails):
   }
 
   if (details.diagnostics.length > 0) {
-    lines.push('  diagnostics');
+    lines.push("  diagnostics");
     for (const diagnostic of details.diagnostics) {
       lines.push(`    ${replaceHomeDirectoryWithTilde(diagnostic)}`);
     }
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function appendLibrarySummary(lines: string[], librarySummary: ILibrarySummary): void {

package/src/discoverLibrarySkills.ts

@@ -5,20 +5,20 @@ import {
   type ResourceDiagnostic,
   SettingsManager,
   type Skill,
-} from '@mariozechner/pi-coding-agent';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import path from 'node:path';
-import type { ILibrarySkillDiscovery, ILibrarySummary } from './types.js';
+} from "@mariozechner/pi-coding-agent";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import type { ILibrarySkillDiscovery, ILibrarySummary } from "./types.js";
 
-const SETTINGS_KEY = '@alexgorbatchev/pi-skills-library';
-const LIBRARY_DIRECTORY_NAME = 'skills-library';
+const SETTINGS_KEY = "@alexgorbatchev/pi-skills-library";
+const LIBRARY_DIRECTORY_NAME = "skills-library";
 
 interface IConfiguredLibrarySettings {
   paths: string[];
 }
 
-type LibraryPathScope = 'project' | 'user' | 'temporary';
+type LibraryPathScope = "project" | "user" | "temporary";
 
 interface ILibraryPathCandidate {
   path: string;
@@ -32,37 +32,37 @@ export async function discoverLibrarySkills(
   const settingsManager = SettingsManager.create(cwd);
   const projectSettings = settingsManager.getProjectSettings();
   const userSettings = settingsManager.getGlobalSettings();
-  const projectSettingsBaseDir = path.join(cwd, '.pi');
+  const projectSettingsBaseDir = path.join(cwd, ".pi");
   const userSettingsBaseDir = getAgentDir();
 
-  const projectConfiguredPaths = getConfiguredLibraryPaths(projectSettings, projectSettingsBaseDir, 'project');
-  const userConfiguredPaths = getConfiguredLibraryPaths(userSettings, userSettingsBaseDir, 'user');
+  const projectConfiguredPaths = getConfiguredLibraryPaths(projectSettings, projectSettingsBaseDir, "project");
+  const userConfiguredPaths = getConfiguredLibraryPaths(userSettings, userSettingsBaseDir, "user");
   const projectConfiguredSkillSiblingPaths = getConfiguredSkillSiblingLibraryPaths(
     projectSettings,
     projectSettingsBaseDir,
-    'project',
+    "project",
   );
   const userConfiguredSkillSiblingPaths = getConfiguredSkillSiblingLibraryPaths(
     userSettings,
     userSettingsBaseDir,
-    'user',
+    "user",
   );
 
   const conventionalPaths = getConventionalLibraryPaths(cwd);
   const derivedPaths = await getDerivedLibraryPaths(cwd, extensionPackageRoot);
 
   const orderedPaths = dedupeLibraryPaths([
-    ...filterPathsByScope(projectConfiguredPaths, 'project'),
-    ...filterPathsByScope(projectConfiguredSkillSiblingPaths, 'project'),
-    ...filterPathsByScope(conventionalPaths, 'project'),
-    ...filterPathsByScope(derivedPaths, 'project'),
-    ...filterPathsByScope(projectConfiguredPaths, 'temporary'),
-    ...filterPathsByScope(conventionalPaths, 'temporary'),
-    ...filterPathsByScope(derivedPaths, 'temporary'),
-    ...filterPathsByScope(userConfiguredPaths, 'user'),
-    ...filterPathsByScope(userConfiguredSkillSiblingPaths, 'user'),
-    ...filterPathsByScope(conventionalPaths, 'user'),
-    ...filterPathsByScope(derivedPaths, 'user'),
+    ...filterPathsByScope(projectConfiguredPaths, "project"),
+    ...filterPathsByScope(projectConfiguredSkillSiblingPaths, "project"),
+    ...filterPathsByScope(conventionalPaths, "project"),
+    ...filterPathsByScope(derivedPaths, "project"),
+    ...filterPathsByScope(projectConfiguredPaths, "temporary"),
+    ...filterPathsByScope(conventionalPaths, "temporary"),
+    ...filterPathsByScope(derivedPaths, "temporary"),
+    ...filterPathsByScope(userConfiguredPaths, "user"),
+    ...filterPathsByScope(userConfiguredSkillSiblingPaths, "user"),
+    ...filterPathsByScope(conventionalPaths, "user"),
+    ...filterPathsByScope(derivedPaths, "user"),
   ]);
 
   const existingPaths = orderedPaths.filter((candidate) => existsSync(candidate.path));
@@ -101,7 +101,7 @@ function getConfiguredSkillSiblingLibraryPaths(
   baseDir: string,
   scope: LibraryPathScope,
 ): ILibraryPathCandidate[] {
-  return readStringArray(Reflect.get(settings, 'skills'))
+  return readStringArray(Reflect.get(settings, "skills"))
     .map((configuredSkillPath) => resolveSettingsPath(configuredSkillPath, baseDir))
     .map((resolvedSkillPath) => toLibraryPathFromSkillPath(resolvedSkillPath))
     .filter((libraryPath): libraryPath is string => libraryPath !== null)
@@ -123,21 +123,17 @@ function getConventionalLibraryPaths(cwd: string): ILibraryPathCandidate[] {
   const ancestorDirectories = getAncestorDirectories(cwd);
 
   const projectPaths = [
-    path.join(cwd, '.pi', LIBRARY_DIRECTORY_NAME),
-    ...ancestorDirectories.map((directoryPath) => path.join(directoryPath, '.agents', LIBRARY_DIRECTORY_NAME)),
+    path.join(cwd, ".pi", LIBRARY_DIRECTORY_NAME),
+    ...ancestorDirectories.map((directoryPath) => path.join(directoryPath, ".agents", LIBRARY_DIRECTORY_NAME)),
   ];
   const userPaths = [
     path.join(agentDir, LIBRARY_DIRECTORY_NAME),
-    path.join(homedir(), '.agents', LIBRARY_DIRECTORY_NAME),
+    path.join(homedir(), ".agents", LIBRARY_DIRECTORY_NAME),
   ];
 
   return [
-    ...projectPaths.map(
-      (libraryPath): ILibraryPathCandidate => ({ path: libraryPath, scope: 'project' }),
-    ),
-    ...userPaths.map(
-      (libraryPath): ILibraryPathCandidate => ({ path: libraryPath, scope: 'user' }),
-    ),
+    ...projectPaths.map((libraryPath): ILibraryPathCandidate => ({ path: libraryPath, scope: "project" })),
+    ...userPaths.map((libraryPath): ILibraryPathCandidate => ({ path: libraryPath, scope: "user" })),
   ];
 }
 
@@ -183,15 +179,16 @@ async function getDerivedLibraryPaths(cwd: string, extensionPackageRoot: string)
 function classifyExtensionScope(extensionPackageRoot: string, cwd: string): LibraryPathScope {
   const normalizedPackageRoot = path.resolve(extensionPackageRoot);
   const normalizedProjectRoot = path.resolve(cwd);
-  const projectPiRoot = path.resolve(cwd, '.pi');
+  const projectPiRoot = path.resolve(cwd, ".pi");
 
   if (
-    isPathInside(normalizedPackageRoot, normalizedProjectRoot) || isPathInside(normalizedPackageRoot, projectPiRoot)
+    isPathInside(normalizedPackageRoot, normalizedProjectRoot) ||
+    isPathInside(normalizedPackageRoot, projectPiRoot)
   ) {
-    return 'project';
+    return "project";
   }
 
-  return 'user';
+  return "user";
 }
 
 function getSiblingLibraryPath(skill: Skill): string | null {
@@ -199,7 +196,7 @@ function getSiblingLibraryPath(skill: Skill): string | null {
 }
 
 function getPackageLibraryPath(skill: Skill): string | null {
-  if (skill.sourceInfo.origin !== 'package' || skill.sourceInfo.baseDir === undefined) {
+  if (skill.sourceInfo.origin !== "package" || skill.sourceInfo.baseDir === undefined) {
     return null;
   }
 
@@ -238,7 +235,7 @@ function getAncestorDirectories(cwd: string): string[] {
   for (;;) {
     ancestorDirectories.push(currentDirectory);
 
-    if (existsSync(path.join(currentDirectory, '.git'))) {
+    if (existsSync(path.join(currentDirectory, ".git"))) {
       return ancestorDirectories;
     }
 
@@ -291,7 +288,7 @@ function createSkillMap(skills: Skill[]): Map<string, Skill> {
 }
 
 function formatDiagnostic(diagnostic: ResourceDiagnostic): string {
-  const location = diagnostic.path ? ` (${diagnostic.path})` : '';
+  const location = diagnostic.path ? ` (${diagnostic.path})` : "";
   return `${diagnostic.type}: ${diagnostic.message}${location}`;
 }
 
@@ -306,11 +303,11 @@ function resolveSettingsPath(configuredPath: string, baseDir: string): string {
 }
 
 function expandHomeDirectory(configuredPath: string): string {
-  if (configuredPath === '~') {
+  if (configuredPath === "~") {
     return homedir();
   }
 
-  if (configuredPath.startsWith('~/')) {
+  if (configuredPath.startsWith("~/")) {
     return path.join(homedir(), configuredPath.slice(2));
   }
 
@@ -320,7 +317,7 @@ function expandHomeDirectory(configuredPath: string): string {
 function toLibraryPathFromSkillPath(resolvedSkillPath: string): string | null {
   const normalizedSkillPath = path.normalize(resolvedSkillPath);
   const pathSegments = normalizedSkillPath.split(path.sep).filter((segment) => segment.length > 0);
-  const skillsSegmentIndex = pathSegments.lastIndexOf('skills');
+  const skillsSegmentIndex = pathSegments.lastIndexOf("skills");
   if (skillsSegmentIndex === -1) {
     return null;
   }
@@ -335,11 +332,11 @@ function toLibraryPathFromSkillPath(resolvedSkillPath: string): string | null {
 
 function isPathInside(candidatePath: string, containerPath: string): boolean {
   const relativePath = path.relative(containerPath, candidatePath);
-  return relativePath === '' || (!relativePath.startsWith('..') && !path.isAbsolute(relativePath));
+  return relativePath === "" || (!relativePath.startsWith("..") && !path.isAbsolute(relativePath));
 }
 
 function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null;
+  return typeof value === "object" && value !== null;
 }
 
 function readStringArray(value: unknown): string[] {
@@ -349,7 +346,7 @@ function readStringArray(value: unknown): string[] {
 
   const stringValues: string[] = [];
   for (const entry of value) {
-    if (typeof entry !== 'string') {
+    if (typeof entry !== "string") {
       continue;
     }
 

package/src/expandLibrarySkill.ts

@@ -1,10 +1,9 @@
-import { type Skill, stripFrontmatter } from '@mariozechner/pi-coding-agent';
-import { readFile } from 'node:fs/promises';
+import { type Skill, stripFrontmatter } from "@mariozechner/pi-coding-agent";
+import { readFile } from "node:fs/promises";
 
 export async function expandLibrarySkill(skill: Skill, args: string): Promise<string> {
-  const content = await readFile(skill.filePath, 'utf8');
+  const content = await readFile(skill.filePath, "utf8");
   const body = stripFrontmatter(content).trim();
-  const skillBlock =
-    `<skill name="${skill.name}" location="${skill.filePath}">\nReferences are relative to ${skill.baseDir}.\n\n${body}\n</skill>`;
+  const skillBlock = `<skill name="${skill.name}" location="${skill.filePath}">\nReferences are relative to ${skill.baseDir}.\n\n${body}\n</skill>`;
   return args.length > 0 ? `${skillBlock}\n\n${args}` : skillBlock;
 }

package/src/groupLibrarySummariesByScope.ts

@@ -1,4 +1,4 @@
-import type { ILibrarySummary } from './types.js';
+import type { ILibrarySummary } from "./types.js";
 
 export function groupLibrarySummariesByScope(librarySummaries: ILibrarySummary[]): Map<string, ILibrarySummary[]> {
   const librarySummariesByScope = new Map<string, ILibrarySummary[]>();
@@ -9,7 +9,7 @@ export function groupLibrarySummariesByScope(librarySummaries: ILibrarySummary[]
     librarySummariesByScope.set(displayScope, existingSummaries);
   }
 
-  const orderedScopes = ['project', 'user', 'path'];
+  const orderedScopes = ["project settings", "global settings", "path"];
   const orderedLibrarySummariesByScope = new Map<string, ILibrarySummary[]>();
   for (const orderedScope of orderedScopes) {
     const scopedSummaries = librarySummariesByScope.get(orderedScope);
@@ -20,7 +20,7 @@ export function groupLibrarySummariesByScope(librarySummaries: ILibrarySummary[]
     orderedLibrarySummariesByScope.set(
       orderedScope,
       [...scopedSummaries].sort((leftSummary, rightSummary) =>
-        leftSummary.libraryPath.localeCompare(rightSummary.libraryPath)
+        leftSummary.libraryPath.localeCompare(rightSummary.libraryPath),
       ),
     );
   }
@@ -28,10 +28,13 @@ export function groupLibrarySummariesByScope(librarySummaries: ILibrarySummary[]
   return orderedLibrarySummariesByScope;
 }
 
-function toDisplayScope(scope: ILibrarySummary['scope']): string {
-  if (scope === 'temporary') {
-    return 'path';
+function toDisplayScope(scope: ILibrarySummary["scope"]): string {
+  switch (scope) {
+    case "project":
+      return "project settings";
+    case "user":
+      return "global settings";
+    case "temporary":
+      return "path";
   }
-
-  return scope;
 }

package/src/index.ts

@@ -1 +1 @@
-export { default } from './piSkillLibraryExtension.js';
+export { default } from "./piSkillLibraryExtension.js";

package/src/parseLibraryCommand.ts

@@ -1,6 +1,6 @@
-import type { ILibraryCommand } from './types.js';
+import type { ILibraryCommand } from "./types.js";
 
-const LIBRARY_COMMAND_PREFIX = '/library:';
+const LIBRARY_COMMAND_PREFIX = "/library:";
 
 export function parseLibraryCommand(text: string): ILibraryCommand | null {
   if (!text.startsWith(LIBRARY_COMMAND_PREFIX)) {
@@ -8,13 +8,13 @@ export function parseLibraryCommand(text: string): ILibraryCommand | null {
   }
 
   const commandBody = text.slice(LIBRARY_COMMAND_PREFIX.length);
-  const spaceIndex = commandBody.indexOf(' ');
+  const spaceIndex = commandBody.indexOf(" ");
   const skillName = spaceIndex === -1 ? commandBody.trim() : commandBody.slice(0, spaceIndex).trim();
   if (skillName.length === 0) {
     return null;
   }
 
-  const args = spaceIndex === -1 ? '' : commandBody.slice(spaceIndex + 1).trim();
+  const args = spaceIndex === -1 ? "" : commandBody.slice(spaceIndex + 1).trim();
   return {
     skillName,
     args,

package/src/piSkillLibraryExtension.ts

@@ -1,22 +1,59 @@
-import type { ExtensionAPI, ExtensionContext, InputEventResult } from '@mariozechner/pi-coding-agent';
-import { Box, Text } from '@mariozechner/pi-tui';
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createLibraryReport } from './createLibraryReport.js';
-import { discoverLibrarySkills } from './discoverLibrarySkills.js';
-import { expandLibrarySkill } from './expandLibrarySkill.js';
-import { parseLibraryCommand } from './parseLibraryCommand.js';
-import { renderLibraryReport } from './renderLibraryReport.js';
-import type { ILibraryReportDetails, ILibrarySkillDiscovery } from './types.js';
-
-const INFO_COMMAND_NAME = 'pi-skill-library';
-const STARTUP_REPORT_MESSAGE_TYPE = 'pi-skill-library.startup-report';
+import type { ImageContent, TextContent } from "@mariozechner/pi-ai";
+import type { ExtensionAPI, ExtensionContext, InputEventResult, Theme } from "@mariozechner/pi-coding-agent";
+import { Box, Text } from "@mariozechner/pi-tui";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createLibraryReport } from "./createLibraryReport.js";
+import { discoverLibrarySkills } from "./discoverLibrarySkills.js";
+import { expandLibrarySkill } from "./expandLibrarySkill.js";
+import { parseLibraryCommand } from "./parseLibraryCommand.js";
+import { renderLibraryReport } from "./renderLibraryReport.js";
+import type { ILibraryReportDetails, ILibrarySkillDiscovery } from "./types.js";
+
+const INFO_COMMAND_NAME = "pi-skill-library";
+const LIBRARY_MESSAGE_TYPE = "pi-skill-library.message";
 const extensionPackageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-const handledInputEventResult: InputEventResult = { action: 'handled' };
+const handledInputEventResult: InputEventResult = { action: "handled" };
+
+type LibraryMessageContent = string | (TextContent | ImageContent)[];
+type LibraryMessageLevel = "info" | "error";
+
+interface ILibraryMessageDetails {
+  level: LibraryMessageLevel;
+  reportDetails?: ILibraryReportDetails;
+}
 
 export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
   let cachedLibrarySkillDiscovery: ILibrarySkillDiscovery | null = null;
-  let cachedCwd = '';
+  let cachedCwd = "";
+
+  pi.registerMessageRenderer<ILibraryMessageDetails>(LIBRARY_MESSAGE_TYPE, (message, _options, theme) => {
+    const details = message.details;
+    const content = getMessageTextContent(message.content);
+    const text =
+      details?.reportDetails === undefined
+        ? renderLibraryMessage(theme, content, details?.level ?? "info")
+        : renderLibraryReport(theme, details.reportDetails);
+    const box = new Box(0, 0);
+    box.addChild(new Text(text, 0, 0));
+    return box;
+  });
+
+  const sendLibraryMessage = (content: string, details: ILibraryMessageDetails): void => {
+    pi.sendMessage<ILibraryMessageDetails>({
+      customType: LIBRARY_MESSAGE_TYPE,
+      content,
+      display: true,
+      details,
+    });
+  };
+
+  const sendLibraryReport = (reportDetails: ILibraryReportDetails): void => {
+    sendLibraryMessage(createLibraryReport(reportDetails), {
+      level: "info",
+      reportDetails,
+    });
+  };
 
   const ensureLibrarySkillCommandsRegistered = (librarySkillDiscovery: ILibrarySkillDiscovery): void => {
     for (const librarySkill of librarySkillDiscovery.skills) {
@@ -28,9 +65,9 @@ export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
           const requestedSkill = refreshedLibrarySkillDiscovery.skillByName.get(librarySkill.name);
           if (requestedSkill === undefined) {
             if (ctx.hasUI) {
-              ctx.ui.notify(
+              sendLibraryMessage(
                 `Library skill is no longer available: ${librarySkill.name}. Run /reload if discovery changed.`,
-                'error',
+                { level: "error" },
               );
             }
             return;
@@ -42,7 +79,7 @@ export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
             return;
           }
 
-          pi.sendUserMessage(expandedText, { deliverAs: 'followUp' });
+          pi.sendUserMessage(expandedText, { deliverAs: "followUp" });
         },
       });
     }
@@ -61,7 +98,7 @@ export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
 
   const invalidateLibrarySkillDiscovery = (): void => {
     cachedLibrarySkillDiscovery = null;
-    cachedCwd = '';
+    cachedCwd = "";
   };
 
   const onSessionChanged = async (_event: unknown, ctx: ExtensionContext): Promise<void> => {
@@ -69,53 +106,29 @@ export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
     await refreshLibrarySkillDiscovery(ctx.cwd);
   };
 
-  pi.registerMessageRenderer(STARTUP_REPORT_MESSAGE_TYPE, (message, _options, theme) => {
-    const reportDetails = readLibraryReportDetails(message.details);
-    const reportText = reportDetails === null
-      ? getMessageTextContent(message.content)
-      : renderLibraryReport(theme, reportDetails);
-    const box = new Box(0, 0);
-    box.addChild(new Text(reportText, 0, 0));
-    return box;
-  });
-
-  pi.on('session_start', async (_event, ctx) => {
+  pi.on("session_start", async (_event, ctx) => {
     invalidateLibrarySkillDiscovery();
     const librarySkillDiscovery = await refreshLibrarySkillDiscovery(ctx.cwd);
-    pi.sendMessage({
-      customType: STARTUP_REPORT_MESSAGE_TYPE,
-      content: createLibraryReport(librarySkillDiscovery),
-      display: true,
-      details: createLibraryReportDetails(librarySkillDiscovery),
-    });
+
+    if (ctx.hasUI) {
+      sendLibraryReport(createLibraryReportDetails(librarySkillDiscovery));
+    }
   });
-  pi.on('session_switch', onSessionChanged);
-  pi.on('session_fork', onSessionChanged);
-  pi.on('session_tree', onSessionChanged);
+  pi.on("session_before_switch", onSessionChanged);
+  pi.on("session_before_fork", onSessionChanged);
+  pi.on("session_before_tree", onSessionChanged);
 
   pi.registerCommand(INFO_COMMAND_NAME, {
-    description: 'Print the discovered skills-library roots and skills',
+    description: "Print the discovered skills-library roots and skills",
     handler: async (_args, ctx) => {
       const librarySkillDiscovery = await refreshLibrarySkillDiscovery(ctx.cwd);
-      pi.sendMessage({
-        customType: STARTUP_REPORT_MESSAGE_TYPE,
-        content: createLibraryReport(librarySkillDiscovery),
-        display: true,
-        details: createLibraryReportDetails(librarySkillDiscovery),
-      });
+      if (ctx.hasUI) {
+        sendLibraryReport(createLibraryReportDetails(librarySkillDiscovery));
+      }
     },
   });
 
-  pi.on('context', async (event) => {
-    return {
-      messages: event.messages.filter((message) => {
-        const messageCustomType = 'customType' in message ? message.customType : undefined;
-        return messageCustomType !== STARTUP_REPORT_MESSAGE_TYPE;
-      }),
-    };
-  });
-
-  pi.on('input', async (event, ctx): Promise<InputEventResult | undefined> => {
+  pi.on("input", async (event, ctx): Promise<InputEventResult | undefined> => {
     const libraryCommand = parseLibraryCommand(event.text);
     if (libraryCommand === null) {
       return undefined;
@@ -125,12 +138,15 @@ export default function piSkillLibraryExtension(pi: ExtensionAPI): void {
     const skill = librarySkillDiscovery.skillByName.get(libraryCommand.skillName);
     if (skill === undefined) {
       const availableSkillNames = librarySkillDiscovery.skills.map((librarySkill) => librarySkill.name).sort();
-      const availableSkillSummary = availableSkillNames.length === 0
-        ? 'No library skills are currently available.'
-        : `Available library skills: ${availableSkillNames.join(', ')}`;
+      const availableSkillSummary =
+        availableSkillNames.length === 0
+          ? "No library skills are currently available."
+          : `Available library skills: ${availableSkillNames.join(", ")}`;
 
       if (ctx.hasUI) {
-        ctx.ui.notify(`Unknown library skill: ${libraryCommand.skillName}. ${availableSkillSummary}`, 'error');
+        sendLibraryMessage(`Unknown library skill: ${libraryCommand.skillName}. ${availableSkillSummary}`, {
+          level: "error",
+        });
       }
 
       return handledInputEventResult;
@@ -148,53 +164,22 @@ function createLibraryReportDetails(librarySkillDiscovery: ILibrarySkillDiscover
   };
 }
 
-function readLibraryReportDetails(details: unknown): ILibraryReportDetails | null {
-  if (!isLibraryReportDetails(details)) {
-    return null;
-  }
-
-  return details;
-}
-
-function isLibraryReportDetails(value: unknown): value is ILibraryReportDetails {
-  if (typeof value !== 'object' || value === null) {
-    return false;
+function renderLibraryMessage(theme: Theme, content: string, level: LibraryMessageLevel): string {
+  if (level === "error") {
+    return theme.fg("error", content);
   }
 
-  const diagnostics = Reflect.get(value, 'diagnostics');
-  const librarySummaries = Reflect.get(value, 'librarySummaries');
-  return Array.isArray(diagnostics)
-    && diagnostics.every((diagnostic) => typeof diagnostic === 'string')
-    && Array.isArray(librarySummaries)
-    && librarySummaries.every(isLibrarySummary);
-}
-
-function isLibrarySummary(value: unknown): value is ILibraryReportDetails['librarySummaries'][number] {
-  if (typeof value !== 'object' || value === null) {
-    return false;
-  }
-
-  const libraryPath = Reflect.get(value, 'libraryPath');
-  const scope = Reflect.get(value, 'scope');
-  const skillNames = Reflect.get(value, 'skillNames');
-  return typeof libraryPath === 'string'
-    && isLibrarySummaryScope(scope)
-    && Array.isArray(skillNames)
-    && skillNames.every((skillName) => typeof skillName === 'string');
-}
-
-function isLibrarySummaryScope(value: unknown): value is ILibraryReportDetails['librarySummaries'][number]['scope'] {
-  return value === 'project' || value === 'user' || value === 'temporary';
+  return content;
 }
 
-function getMessageTextContent(content: string | Array<{ type: string; text?: string; }>): string {
-  if (typeof content === 'string') {
+function getMessageTextContent(content: LibraryMessageContent): string {
+  if (typeof content === "string") {
     return content;
   }
 
   return content
-    .map((part) => ('text' in part && typeof part.text === 'string' ? part.text : '[non-text content omitted]'))
-    .join('\n');
+    .map((part) => ("text" in part && typeof part.text === "string" ? part.text : "[non-text content omitted]"))
+    .join("\n");
 }
 
 function createLibraryCommandName(skillName: string): string {
@@ -203,7 +188,7 @@ function createLibraryCommandName(skillName: string): string {
 
 function createTransformInputEventResult(text: string): InputEventResult {
   return {
-    action: 'transform',
+    action: "transform",
     text,
   };
 }

package/src/renderLibraryReport.ts

@@ -1,32 +1,32 @@
-import type { Theme } from '@mariozechner/pi-coding-agent';
-import { groupLibrarySummariesByScope } from './groupLibrarySummariesByScope.js';
-import { replaceHomeDirectoryWithTilde } from './replaceHomeDirectoryWithTilde.js';
-import type { ILibraryReportDetails } from './types.js';
+import type { Theme } from "@mariozechner/pi-coding-agent";
+import { groupLibrarySummariesByScope } from "./groupLibrarySummariesByScope.js";
+import { replaceHomeDirectoryWithTilde } from "./replaceHomeDirectoryWithTilde.js";
+import type { ILibraryReportDetails } from "./types.js";
 
 export function renderLibraryReport(theme: Theme, details: ILibraryReportDetails): string {
-  const lines: string[] = [theme.fg('mdHeading', '[Skills Library]')];
+  const lines: string[] = [theme.fg("mdHeading", "[@alexgorbatchev/pi-skill-library]")];
   if (details.librarySummaries.length === 0) {
-    lines.push(theme.fg('dim', '  No library skills were discovered.'));
-    return lines.join('\n');
+    lines.push(theme.fg("dim", "  No library skills were discovered."));
+    return lines.join("\n");
   }
 
   const groupedSummaries = groupLibrarySummariesByScope(details.librarySummaries);
   for (const [scope, librarySummaries] of groupedSummaries) {
-    lines.push(`  ${theme.fg('accent', scope)}`);
+    lines.push(`  ${theme.fg("accent", scope)}`);
     for (const librarySummary of librarySummaries) {
-      lines.push(theme.fg('dim', `    ${replaceHomeDirectoryWithTilde(librarySummary.libraryPath)}`));
+      lines.push(theme.fg("dim", `    ${replaceHomeDirectoryWithTilde(librarySummary.libraryPath)}`));
       for (const skillName of librarySummary.skillNames) {
-        lines.push(theme.fg('dim', `      /library:${skillName}`));
+        lines.push(theme.fg("dim", `      /library:${skillName}`));
       }
     }
   }
 
   if (details.diagnostics.length > 0) {
-    lines.push(`  ${theme.fg('warning', 'diagnostics')}`);
+    lines.push(`  ${theme.fg("warning", "diagnostics")}`);
     for (const diagnostic of details.diagnostics) {
-      lines.push(theme.fg('warning', `    ${replaceHomeDirectoryWithTilde(diagnostic)}`));
+      lines.push(theme.fg("warning", `    ${replaceHomeDirectoryWithTilde(diagnostic)}`));
     }
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }

package/src/replaceHomeDirectoryWithTilde.ts

@@ -1,5 +1,5 @@
-import { homedir } from 'node:os';
-import path from 'node:path';
+import { homedir } from "node:os";
+import path from "node:path";
 
 export function replaceHomeDirectoryWithTilde(value: string): string {
   const homeDirectoryPath = homedir();
@@ -7,7 +7,7 @@ export function replaceHomeDirectoryWithTilde(value: string): string {
   const normalizedValue = path.normalize(value);
 
   if (normalizedValue === normalizedHomeDirectoryPath) {
-    return '~';
+    return "~";
   }
 
   const homeDirectoryPrefix = `${normalizedHomeDirectoryPath}${path.sep}`;

package/src/types.ts

@@ -1,4 +1,4 @@
-import type { Skill } from '@mariozechner/pi-coding-agent';
+import type { Skill } from "@mariozechner/pi-coding-agent";
 
 export interface ILibraryCommand {
   skillName: string;
@@ -7,7 +7,7 @@ export interface ILibraryCommand {
 
 export interface ILibrarySummary {
   libraryPath: string;
-  scope: 'project' | 'user' | 'temporary';
+  scope: "project" | "user" | "temporary";
   skillNames: string[];
 }