kennel 0.2.11 → 0.2.13

package/kernel/packages/api/src/server/folder-metadata-plugin.ts

@@ -18,11 +18,9 @@ import { markdownMetadata } from "@raggle-ai/markdown";
 import { readFolder } from "@raggle-ai/markdown/node";
 import { execFile } from "node:child_process";
 import { sameOrigin } from "kennel-plugins/endpoint";
-import { parse as parseYaml } from "yaml";
 
 import type { FolderPluginServer } from "kennel-plugins/server";
 import type { LocalMarkdownFileSummary, LocalProject } from "@raggle-ai/local";
-import type { FolderSkill } from "@raggle-ai/ui/lib/folder-activity";
 import { runApiRoute } from "kennel-plugins/endpoint";
 import { FolderPluginFailure } from "kennel-plugins/server";
 import { folderWorkspace } from "@raggle-ai/schemas/workspace";
@@ -74,26 +72,6 @@ const {
   sortProjectList,
 } = local;
 
-type SkillSchema = {
-  description?: unknown;
-};
-
-function skillDescription(content: string) {
-  if (!content.startsWith("---\n")) return undefined;
-  const end = content.indexOf("\n---", 4);
-  if (end < 0) return undefined;
-  const schema = parseYaml(content.slice(4, end)) as SkillSchema;
-  return typeof schema.description === "string"
-    ? schema.description
-    : undefined;
-}
-
-function skillSource(folder: string, root: string): FolderSkill["source"] {
-  if (root === folder) return "local";
-  if (root.startsWith(resolve(folder, ".gtl") + sep)) return "local";
-  return "global";
-}
-
 type IconAsset = {
   mediaType: "image/jpeg" | "image/png";
   source: "local" | "favicon";
@@ -135,8 +113,6 @@ export type FolderMetadataPluginOptions = {
   restrictToRoot?: boolean;
   root: string;
   sessionFinding?: SessionFinding;
-  /** Override the home directory used for Agent global files. Intended for tests. */
-  agentsHomeDir?: string;
   /** Override isolated linked-project discovery, for tests. */
   linkedFolderLoader?: LinkedFolderLoader;
   /**
@@ -355,105 +331,6 @@ function unique(values: string[]) {
   return [...new Set(values)];
 }
 
-async function existingDirectory(path: string) {
-  const details = await stat(path).catch(() => undefined);
-  return details?.isDirectory() ? path : undefined;
-}
-
-function metadataPaths(metadata: {
-  files?: { items: Array<{ path?: string; relativePath?: string }> };
-}) {
-  return (metadata.files?.items ?? [])
-    .flatMap((file) => [file.path, file.relativePath])
-    .filter((path): path is string => Boolean(path));
-}
-
-function ancestorFolders(folder: string) {
-  const folders = [];
-  for (
-    let current = folder;
-    dirname(current) !== current;
-    current = dirname(current)
-  ) {
-    folders.push(current);
-  }
-  return folders;
-}
-
-async function linkedSkillRoots(
-  folder: string,
-  metadata: {
-    files?: { items: Array<{ path?: string; relativePath?: string }> };
-  },
-) {
-  const gtlNames = metadataPaths(metadata)
-    .map((path) => path.split(/[\\/]\.gtl[\\/]/)[1])
-    .filter((path): path is string => Boolean(path))
-    .map((path) => path.split(/[\\/]/)[0])
-    .filter((name): name is string => Boolean(name));
-  const gtlRoots = gtlNames.flatMap((name) => [
-    resolve(folder, ".gtl", name),
-    ...ancestorFolders(folder).map((ancestor) => resolve(ancestor, name)),
-  ]);
-
-  const name = folder
-    .replace(/[\\/]+$/, "")
-    .split(/[\\/]/)
-    .at(-1);
-  const siblingIndex = name
-    ? [
-        resolve(dirname(folder), `${name}-index`),
-        resolve(dirname(dirname(folder)), `${name}-index`),
-      ]
-    : [];
-  const roots = await Promise.all(
-    unique([...gtlRoots, ...siblingIndex]).map(existingDirectory),
-  );
-  return roots.filter((path): path is string => Boolean(path));
-}
-
-async function listFolderSkills(
-  folder: string,
-  metadata: {
-    files?: { items: Array<{ path?: string; relativePath?: string }> };
-  },
-) {
-  const roots = unique([folder, ...(await linkedSkillRoots(folder, metadata))]);
-  const skills = await Promise.all(
-    roots.map(async (root) => {
-      const skillsFolder = resolve(root, ".agents", "skills");
-      const entries = await readdir(skillsFolder, {
-        withFileTypes: true,
-      }).catch(() => []);
-      return (
-        await Promise.all(
-          entries
-            .filter(
-              (entry) => entry.isDirectory() && !entry.name.startsWith("."),
-            )
-            .map(async (entry) => {
-              const path = resolve(skillsFolder, entry.name);
-              const skillPath = resolve(path, "SKILL.md");
-              const details = await stat(skillPath).catch(() => undefined);
-              if (!details?.isFile()) return undefined;
-              const content = await readFile(skillPath, "utf8").catch(() => "");
-              return {
-                description: skillDescription(content),
-                name: label(entry.name),
-                openHref: openPathHref(path),
-                relativePath: relative(root, path),
-                source: skillSource(folder, root),
-              };
-            }),
-        )
-      ).filter((skill) => skill);
-    }),
-  );
-  return unique(skills.flat().map((skill) => JSON.stringify(skill)))
-    .map((skill) => JSON.parse(skill) as FolderSkill)
-    .sort((left, right) => left.name.localeCompare(right.name));
-}
-
 function isMachineRoot(folder: string) {
   return folder === homedir() || dirname(folder) === folder;
 }
@@ -506,7 +383,6 @@ async function shallowMetadata(folder: string) {
     projects: { items: projects },
     schemaVersion: 3 as const,
     sessions: { items: [] },
-    skills: { items: [] },
   };
 }
 
@@ -773,6 +649,7 @@ async function pluginAvailability(
   const items: Array<{
     count?: number;
     error?: string;
+    icon?: { paths: string[] };
     id: string;
     label: string;
   }> = [];
@@ -785,6 +662,7 @@ async function pluginAvailability(
       if (detection.status === "available") {
         items.push({
           count: detection.count,
+          icon: plugin.icon,
           id: plugin.id,
           label: plugin.label,
         });
@@ -794,6 +672,7 @@ async function pluginAvailability(
         // shell can surface it instead of treating it as absent content.
         items.push({
           error: detection.error,
+          icon: plugin.icon,
           id: plugin.id,
           label: plugin.label,
         });
@@ -811,7 +690,6 @@ export function createFolderApi({
   restrictToRoot = false,
   root,
   sessionFinding,
-  agentsHomeDir,
   linkedFolderLoader,
   remoteAccess = false,
   lockedFile,
@@ -822,9 +700,7 @@ export function createFolderApi({
     listFolderSessions,
     readSessionTranscript,
   };
-  const basePlugins = folderServerRegistryAsync({
-    agentsHomeDir,
-  });
+  const basePlugins = folderServerRegistryAsync();
   const baseExternalApiHandlers = externalApiHandlers();
   const assetFiles = new Map<
     string,
@@ -1374,14 +1250,11 @@ export function createFolderApi({
               request.headers["x-kennel-retry-linked"] === "1"
             )
               linkedDiscovery.retry(folder);
-            const discovery =
-              pluginId === "agents" || pluginId === "tasks"
-                ? linkedState(folder)
-                : undefined;
+            const discovery = linkedState(folder);
             const result = await plugin.handle(
               {
                 folder,
-                linkedFolders: discovery?.folders ?? [],
+                linkedFolders: discovery.folders,
               },
               subpath,
             );
@@ -1395,7 +1268,7 @@ export function createFolderApi({
                   folder,
                   plugin: pluginId,
                   status: "unavailable",
-                  ...(discovery ? { linkedStatus: discovery.status } : {}),
+                  linkedStatus: discovery.status,
                 }),
               );
               return;
@@ -1410,7 +1283,7 @@ export function createFolderApi({
                 folder,
                 plugin: pluginId,
                 ...data,
-                ...(discovery ? { linkedStatus: discovery.status } : {}),
+                linkedStatus: discovery.status,
               }),
             );
           } catch (error) {
@@ -1498,7 +1371,6 @@ export function createFolderApi({
                 folder,
                 projects: { items: [] },
                 sessions: { items: [] },
-                skills: { items: [] },
                 workspace: await readWorkspace(folder),
               },
               { "Cache-Control": "private, max-age=0, must-revalidate" },
@@ -1697,26 +1569,12 @@ export function createFolderApi({
             ? await shallowMetadata(folder)
             : await loadFolderData(folder);
 
-          if (part === "skills") {
-            respond({
-              folder: metadata.folder,
-              skills: {
-                items: await listFolderSkills(metadata.folder, metadata),
-              },
-            });
-            return;
-          }
-
-          const [assets, skills] = await Promise.all([
-            hydrateAssets(metadata, assetFiles),
-            listFolderSkills(metadata.folder, metadata),
-          ]);
+          const assets = await hydrateAssets(metadata, assetFiles);
           const body = {
             ...metadata,
             ...assets,
             sessions: { items: [] },
             files: await notesFiles(metadata.folder, metadata.files.items),
-            skills: { items: skills },
           };
           respond(body);
         } catch (error) {

package/kernel/packages/api/src/server/plugins.ts

@@ -4,17 +4,11 @@ import { pathToFileURL } from "node:url";
 import { existsSync } from "node:fs";
 import { mkdir, stat, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve, sep } from "node:path";
-import { createAgentsPlugin } from "@raggle-ai/agents/server";
 import { FolderPluginFailure } from "kennel-plugins/server";
 import { createNotesPlugin } from "@raggle-ai/notes/server";
 
 export { FolderPluginFailure };
 
-export type FolderServerRegistryOptions = {
-  /** Override the home directory used for Agent global files. Intended for tests. */
-  agentsHomeDir?: string;
-};
-
 export type FolderPluginRegistryConfig = {
   plugins: {
     disable: string[];
@@ -44,22 +38,13 @@ export function configuredFolderServerRegistry(
 }
 
 /** Core server plugins. Installed plugins are loaded separately. */
-export function createFolderServerPlugins(
-  options: FolderServerRegistryOptions = {},
-): FolderPluginServer[] {
-  return [
-    createAgentsPlugin({
-      homeDir: options.agentsHomeDir,
-    }),
-    createNotesPlugin(),
-  ];
+export function createFolderServerPlugins(): FolderPluginServer[] {
+  return [createNotesPlugin()];
 }
 
-export function folderServerRegistry(
-  options: FolderServerRegistryOptions = {},
-): Map<string, FolderPluginServer> {
+export function folderServerRegistry(): Map<string, FolderPluginServer> {
   return new Map(
-    createFolderServerPlugins(options).map((plugin) => [plugin.id, plugin]),
+    createFolderServerPlugins().map((plugin) => [plugin.id, plugin]),
   );
 }
 
@@ -107,17 +92,17 @@ function externalServerEntries(): ExternalServerEntry[] {
   });
 }
 
-export async function folderServerRegistryAsync(
-  options: FolderServerRegistryOptions = {},
-): Promise<Map<string, FolderPluginServer>> {
-  const registry = folderServerRegistry(options);
+export async function folderServerRegistryAsync(): Promise<
+  Map<string, FolderPluginServer>
+> {
+  const registry = folderServerRegistry();
   for (const entry of externalServerEntries()) {
     if (registry.has(entry.id))
       throw new Error(`External plugin id collides with core plugin: ${entry.id}`);
     const imported = await import(pathToFileURL(entry.module).href);
     const value = imported[entry.symbol];
     const plugin =
-      typeof value === "function" ? value(options) : value;
+      typeof value === "function" ? value() : value;
     if (!plugin || typeof plugin !== "object")
       throw new Error(`External plugin ${entry.id} did not export ${entry.symbol}`);
     const server = plugin as FolderPluginServer;
@@ -198,10 +183,10 @@ export type FolderPluginScaffoldResult = {
  */
 export async function scaffoldFolderPlugins(
   folder: string,
-  options: FolderServerRegistryOptions & { force?: boolean; write?: boolean } = {},
+  options: { force?: boolean; write?: boolean } = {},
 ): Promise<FolderPluginScaffoldResult> {
   const root = resolve(folder);
-  const registry = folderServerRegistry(options);
+  const registry = folderServerRegistry();
   const created: FolderPluginScaffoldFile[] = [];
   const skipped: FolderPluginScaffoldFile[] = [];
   const supported: FolderPluginScaffoldResult["supported"] = [];

package/kernel/packages/api/src/shared/viewer-route.ts

@@ -1,6 +1,6 @@
 import type { FolderTab } from "@raggle-ai/ui/lib/folder-activity";
 
-export type ViewerSection = "notes" | "projects" | "sessions" | "skills";
+export type ViewerSection = "notes" | "projects" | "sessions";
 
 export type ViewerPluginView = {
   pluginId: string;
@@ -30,7 +30,6 @@ const sectionTabs: Record<ViewerSection, FolderTab> = {
   notes: "files",
   projects: "projects",
   sessions: "sessions",
-  skills: "skills",
 };
 
 import { folderPathId as encodeBase64Url } from "kennel-plugins/client";
@@ -51,7 +50,7 @@ function url(value: string) {
 
 function tabSection(tab: string | null): ViewerSection | undefined {
   if (tab === "files") return "notes";
-  if (tab === "projects" || tab === "sessions" || tab === "skills") return tab;
+  if (tab === "projects" || tab === "sessions") return tab;
   return undefined;
 }
 
@@ -156,8 +155,7 @@ export function parseViewerRoute(value: string): ViewerRoute {
   if (
     section === "notes" ||
     section === "projects" ||
-    section === "sessions" ||
-    section === "skills"
+    section === "sessions"
   ) {
     return { ...route, section };
   }

package/kernel/packages/api-client/src/generated.d.ts

@@ -303,7 +303,7 @@ export interface operations {
         parameters: {
             query?: {
                 path?: string;
-                part?: "notes" | "identity" | "discovery" | "workspace" | "collections" | "plugins" | "skills" | "sessions" | "calendar" | "schema";
+                part?: "notes" | "identity" | "discovery" | "workspace" | "collections" | "plugins" | "sessions" | "calendar" | "schema";
                 notesScope?: "local" | "linked" | "all";
                 id?: string;
                 sort?: "alpha" | "recent";
@@ -348,6 +348,9 @@ export interface operations {
                             items: {
                                 count?: number;
                                 error?: string;
+                                icon?: {
+                                    paths: string[];
+                                };
                                 id: string;
                                 label: string;
                             }[];
@@ -373,16 +376,6 @@ export interface operations {
                                 title: string;
                             }[];
                         };
-                        skills?: {
-                            items: {
-                                description?: string;
-                                name: string;
-                                openHref?: string;
-                                relativePath: string;
-                                /** @enum {string} */
-                                source: "global" | "local";
-                            }[];
-                        };
                         workspace?: {
                             breadcrumbs: {
                                 icon?: {
@@ -608,22 +601,13 @@ export interface operations {
                             items: {
                                 count?: number;
                                 error?: string;
+                                icon?: {
+                                    paths: string[];
+                                };
                                 id: string;
                                 label: string;
                             }[];
                         };
-                    } | {
-                        folder: string;
-                        skills: {
-                            items: {
-                                description?: string;
-                                name: string;
-                                openHref?: string;
-                                relativePath: string;
-                                /** @enum {string} */
-                                source: "global" | "local";
-                            }[];
-                        };
                     } | {
                         folder: string;
                         assets: {
@@ -651,6 +635,9 @@ export interface operations {
                             items: {
                                 count?: number;
                                 error?: string;
+                                icon?: {
+                                    paths: string[];
+                                };
                                 id: string;
                                 label: string;
                             }[];
@@ -676,16 +663,6 @@ export interface operations {
                                 title: string;
                             }[];
                         };
-                        skills?: {
-                            items: {
-                                description?: string;
-                                name: string;
-                                openHref?: string;
-                                relativePath: string;
-                                /** @enum {string} */
-                                source: "global" | "local";
-                            }[];
-                        };
                         workspace?: {
                             breadcrumbs: {
                                 icon?: {
@@ -750,6 +727,9 @@ export interface operations {
                             items: {
                                 count?: number;
                                 error?: string;
+                                icon?: {
+                                    paths: string[];
+                                };
                                 id: string;
                                 label: string;
                             }[];
@@ -775,16 +755,6 @@ export interface operations {
                                 title: string;
                             }[];
                         };
-                        skills?: {
-                            items: {
-                                description?: string;
-                                name: string;
-                                openHref?: string;
-                                relativePath: string;
-                                /** @enum {string} */
-                                source: "global" | "local";
-                            }[];
-                        };
                         workspace?: {
                             breadcrumbs: {
                                 icon?: {
@@ -849,6 +819,9 @@ export interface operations {
                             items: {
                                 count?: number;
                                 error?: string;
+                                icon?: {
+                                    paths: string[];
+                                };
                                 id: string;
                                 label: string;
                             }[];
@@ -874,16 +847,6 @@ export interface operations {
                                 title: string;
                             }[];
                         };
-                        skills?: {
-                            items: {
-                                description?: string;
-                                name: string;
-                                openHref?: string;
-                                relativePath: string;
-                                /** @enum {string} */
-                                source: "global" | "local";
-                            }[];
-                        };
                         workspace?: {
                             breadcrumbs: {
                                 icon?: {

package/kernel/packages/markdown/README.md

@@ -1,8 +1,8 @@
 # @raggle-ai/markdown
 
 Internal BarackDown re-export consumed by every Kennel package that renders
-Markdown (`packages/ui`, `packages/agents`, `packages/api`, `packages/dist`,
-`packages/core-components`, external plugins, `cli`, and `apps/web`). The
+Markdown (`packages/ui`, `packages/api`, external plugins, `cli`, and
+`apps/web`). The
 purpose of this tiny package is to be the single place where Kennel decides
 which BarkDown implementation it uses.
 

package/kernel/packages/notes/package.json

@@ -21,6 +21,7 @@
   "exports": {
     ".": "./src/index.ts",
     "./client": "./src/client.tsx",
+    "./data/use-folder-notes": "./src/data/use-folder-notes.ts",
     "./manifest": "./src/manifest.ts",
     "./parse": "./src/data/parse.ts",
     "./pages/single-note-page": "./src/pages/single-note-page.tsx",

package/kernel/packages/notes/src/client.tsx

@@ -4,7 +4,6 @@ import { notesManifest } from "./manifest.ts"
 import { NotesPage } from "./pages/notes-page.tsx"
 
 export { NotesPage } from "./pages/notes-page.tsx"
-export { useFolderNotes } from "./data/use-folder-notes.ts"
 
 export const notesClient = {
   ...notesManifest,

package/kernel/packages/notes/src/manifest.ts

@@ -2,5 +2,12 @@ import type { FolderPluginManifest } from "kennel-plugins"
 
 export const notesManifest = {
   id: "notes",
+  icon: {
+    paths: [
+      "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8Z",
+      "M14 2v6h6",
+      "M8 13h8M8 17h6",
+    ],
+  },
   label: "Notes",
 } satisfies FolderPluginManifest

package/kernel/packages/notes/src/pages/notes-page.tsx

@@ -50,7 +50,7 @@ export function NotesPage(): ReactElement {
   return (
     <>
       <FolderNotesList
-        key={folderId}
+        key={`${folderId}:${filter.effectiveSelected}`}
         action={
           aiInput ? (
             <AiComposerAction

package/kernel/packages/notes/src/ui/folder-notes-list.tsx

@@ -1,7 +1,13 @@
 import type { ReactNode } from "react"
+import { useMemo, useState } from "react"
 
 import type { FolderFile } from "@raggle-ai/ui/lib/folder-activity"
+import { Input } from "@raggle-ai/ui/components/input"
 import { NoteCard } from "@raggle-ai/ui/components/note-card"
+import { OffsetPagination } from "@raggle-ai/ui/components/pagination"
+
+const pageSize = 25
+const emptyFiles: FolderFile[] = []
 
 /**
  * Note rows for the main Notes tab, backed by the shared NoteCard so linked
@@ -11,7 +17,7 @@ export function FolderNotesList({
   action,
   documentHref,
   error,
-  files = [],
+  files = emptyFiles,
   filter,
   folder,
   folderHref,
@@ -26,13 +32,33 @@ export function FolderNotesList({
   folderHref: (folder: string) => string
   loading: boolean
 }) {
-  const visible = [...files].sort(
-    (left, right) =>
-      right.activityAt - left.activityAt ||
-      `${left.folder ?? ""}/${left.relativePath}`.localeCompare(
-        `${right.folder ?? ""}/${right.relativePath}`,
+  const [offset, setOffset] = useState(0)
+  const [search, setSearch] = useState("")
+  const sorted = useMemo(
+    () =>
+      [...files].sort(
+        (left, right) =>
+          right.activityAt - left.activityAt ||
+          `${left.folder ?? ""}/${left.relativePath}`.localeCompare(
+            `${right.folder ?? ""}/${right.relativePath}`,
+          ),
       ),
+    [files],
+  )
+  const matching = useMemo(() => {
+    const query = search.trim().toLowerCase()
+    if (!query) return sorted
+    return sorted.filter((file) =>
+      `${file.name}\n${file.folder ?? ""}/${file.relativePath}`
+        .toLowerCase()
+        .includes(query),
+    )
+  }, [sorted, search])
+  const effectiveOffset = Math.min(
+    offset,
+    Math.max(0, Math.ceil(matching.length / pageSize) - 1) * pageSize,
   )
+  const visible = matching.slice(effectiveOffset, effectiveOffset + pageSize)
 
   return (
     <div className="mx-auto grid w-full max-w-3xl gap-4 px-4 py-5">
@@ -40,12 +66,22 @@ export function FolderNotesList({
         <h1 className="m-0 text-2xl font-semibold text-[#233025]">Notes</h1>
         {action}
       </div>
+      <Input
+        type="search"
+        aria-label="Search notes by name or path"
+        placeholder="Search notes by name or path…"
+        value={search}
+        onChange={(event) => {
+          setSearch(event.target.value)
+          setOffset(0)
+        }}
+      />
       {filter}
       {loading ? <p className="m-0 text-sm text-[#6c7a6d]">Loading…</p> : null}
       {error ? <p className="m-0 text-sm text-[#9c3a3a]">{error}</p> : null}
       {!loading && !error && !visible.length ? (
         <p className="m-0 text-sm text-[#6c7a6d]">
-          {files.length ? "No notes match this filter." : "No notes found."}
+          {search.trim() ? "No notes match this search." : "No notes found."}
         </p>
       ) : null}
       {visible.length ? (
@@ -71,6 +107,15 @@ export function FolderNotesList({
           ))}
         </ol>
       ) : null}
+      {matching.length ? (
+        <OffsetPagination
+          label="Notes"
+          total={matching.length}
+          offset={effectiveOffset}
+          pageSize={pageSize}
+          onOffsetChange={setOffset}
+        />
+      ) : null}
     </div>
   )
 }