@krak-stack/registry 0.1.11 → 0.1.14

package/dist/lib/docs-core.js

@@ -3,7 +3,7 @@ import { icons as lucideIcons } from "@iconify-json/lucide";
 import { Icon, addCollection } from "@iconify/react";
 import { code } from "@streamdown/code";
 import { Link as Link3, useNavigate } from "@tanstack/react-router";
-import { Schema as Schema2 } from "effect";
+import { Schema as Schema3 } from "effect";
 import {
   Children,
   forwardRef,
@@ -16,17 +16,17 @@ import { parse } from "yaml";
 // ../../src/components/ui/app-brand.tsx
 import { Link } from "@tanstack/react-router";
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
-function AppBrand({
-  className,
-  label,
-  subtitle,
-  icon: Icon,
-  imageSrc,
-  href,
-  to,
-  variant = "default",
-  ...props
-}) {
+var isStaticBrand = (props) => props.to === null;
+var isAnchorBrand = (props) => props.href !== undefined;
+function AppBrand(brandProps) {
+  const {
+    className,
+    label,
+    subtitle,
+    icon: Icon,
+    imageSrc,
+    variant = "default"
+  } = brandProps;
   const iconClassName = variant === "sidebar" ? "bg-sidebar-primary" : "bg-primary";
   const iconColor = variant === "sidebar" ? "var(--sidebar-primary-foreground)" : "var(--primary-foreground)";
   const contentClassName = variant === "sidebar" ? "group-data-[collapsible=icon]:hidden" : undefined;
@@ -66,21 +66,54 @@ function AppBrand({
     variant === "sidebar" ? "p-2 group-data-[collapsible=icon]:justify-center group-data-[collapsible=icon]:p-0" : "",
     className
   ].filter(Boolean).join(" ");
-  if (to === null) {
+  if (isStaticBrand(brandProps)) {
+    const {
+      className: _className2,
+      label: _label2,
+      subtitle: _subtitle2,
+      icon: _icon2,
+      imageSrc: _imageSrc2,
+      variant: _variant2,
+      to: _to,
+      href: _href2,
+      ...props2
+    } = brandProps;
     return /* @__PURE__ */ jsx("div", {
       className: brandClassName,
-      ...props,
+      ...props2,
       children: content
     });
   }
-  if (href) {
+  if (isAnchorBrand(brandProps)) {
+    const {
+      className: _className2,
+      label: _label2,
+      subtitle: _subtitle2,
+      icon: _icon2,
+      imageSrc: _imageSrc2,
+      variant: _variant2,
+      to: _to,
+      href,
+      ...props2
+    } = brandProps;
     return /* @__PURE__ */ jsx("a", {
       className: brandClassName,
       href,
-      ...props,
+      ...props2,
       children: content
     });
   }
+  const {
+    className: _className,
+    label: _label,
+    subtitle: _subtitle,
+    icon: _icon,
+    imageSrc: _imageSrc,
+    variant: _variant,
+    href: _href,
+    to,
+    ...props
+  } = brandProps;
   return /* @__PURE__ */ jsx(Link, {
     to: to ?? "/",
     className: brandClassName,
@@ -960,7 +993,7 @@ function SearchMenu({
 import { useAtom } from "@effect/atom-react";
 import { BrowserKeyValueStore } from "@effect/platform-browser";
 import { Link as Link2, Outlet, useRouterState } from "@tanstack/react-router";
-import { Schema } from "effect";
+import { Schema as Schema2 } from "effect";
 import { Atom } from "effect/unstable/reactivity";
 
 // ../../src/components/ui/badge.tsx
@@ -1170,6 +1203,7 @@ function TooltipContent({
 
 // ../../src/components/ui/sidebar.tsx
 import { PanelLeftIcon } from "lucide-react";
+import { Schema } from "effect";
 import { jsx as jsx12, jsxs as jsxs7 } from "react/jsx-runtime";
 var SIDEBAR_COOKIE_NAME = "sidebar_state";
 var SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
@@ -1198,18 +1232,17 @@ function SidebarProvider({
   const [openMobile, setOpenMobile] = React2.useState(false);
   const [_open, _setOpen] = React2.useState(defaultOpen);
   const open = openProp ?? _open;
-  const setOpen = React2.useCallback((value) => {
-    const openState = typeof value === "function" ? value(open) : value;
+  const setOpen = React2.useCallback((openState) => {
     if (setOpenProp) {
       setOpenProp(openState);
     } else {
       _setOpen(openState);
     }
     document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`;
-  }, [setOpenProp, open]);
+  }, [setOpenProp]);
   const toggleSidebar = React2.useCallback(() => {
-    return isMobile ? setOpenMobile((open2) => !open2) : setOpen((open2) => !open2);
-  }, [isMobile, setOpen, setOpenMobile]);
+    return isMobile ? setOpenMobile((open2) => !open2) : setOpen(!open);
+  }, [isMobile, open, setOpen, setOpenMobile]);
   React2.useEffect(() => {
     const handleKeyDown = (event) => {
       if (event.key === SIDEBAR_KEYBOARD_SHORTCUT && (event.metaKey || event.ctrlKey)) {
@@ -1230,15 +1263,16 @@ function SidebarProvider({
     setOpenMobile,
     toggleSidebar
   }), [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar]);
+  const wrapperStyle = {
+    "--sidebar-width": SIDEBAR_WIDTH,
+    "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,
+    ...style
+  };
   return /* @__PURE__ */ jsx12(SidebarContext.Provider, {
     value: contextValue,
     children: /* @__PURE__ */ jsx12("div", {
       "data-slot": "sidebar-wrapper",
-      style: {
-        "--sidebar-width": SIDEBAR_WIDTH,
-        "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,
-        ...style
-      },
+      style: wrapperStyle,
       className: cn("group/sidebar-wrapper flex min-h-svh w-full has-data-[variant=inset]:bg-sidebar", className),
       ...props,
       children
@@ -1264,6 +1298,9 @@ function Sidebar({
     });
   }
   if (isMobile) {
+    const mobileStyle = {
+      "--sidebar-width": SIDEBAR_WIDTH_MOBILE
+    };
     return /* @__PURE__ */ jsx12(Sheet, {
       open: openMobile,
       onOpenChange: setOpenMobile,
@@ -1274,9 +1311,7 @@ function Sidebar({
         "data-slot": "sidebar",
         "data-mobile": "true",
         className: "bg-sidebar text-sidebar-foreground w-(--sidebar-width) p-0 [&>button]:hidden",
-        style: {
-          "--sidebar-width": SIDEBAR_WIDTH_MOBILE
-        },
+        style: mobileStyle,
         side,
         children: [
           /* @__PURE__ */ jsxs7(SheetHeader, {
@@ -1492,11 +1527,7 @@ function SidebarMenuButton({
   if (!tooltip) {
     return comp;
   }
-  if (typeof tooltip === "string") {
-    tooltip = {
-      children: tooltip
-    };
-  }
+  const tooltipProps = Schema.is(Schema.String)(tooltip) ? { children: tooltip } : tooltip;
   return /* @__PURE__ */ jsxs7(Tooltip, {
     children: [
       comp,
@@ -1504,7 +1535,7 @@ function SidebarMenuButton({
         side: "right",
         align: "center",
         hidden: state !== "collapsed" || isMobile,
-        ...tooltip
+        ...tooltipProps
       })
     ]
   });
@@ -1516,7 +1547,7 @@ var sidebarStorageRuntime = Atom.runtime(BrowserKeyValueStore.layerLocalStorage)
 var sidebarOpenAtom = Atom.kvs({
   runtime: sidebarStorageRuntime,
   key: "sidebar:open",
-  schema: Schema.Boolean,
+  schema: Schema2.Boolean,
   defaultValue: () => true
 });
 function AppSidebar({ footer, groups, header }) {
@@ -1692,24 +1723,36 @@ var seo = ({
   const siteUrl = origin?.replace(/\/$/, "") ?? canonical;
   const publisher = {
     "@type": "Organization",
-    name: siteName,
-    ...siteUrl ? { url: siteUrl } : {},
-    ...sameAs?.length ? { sameAs } : {}
-  };
-  const structuredData = type === "article" ? {
-    "@type": "Article",
-    headline: title,
-    description,
-    ...canonical ? { url: canonical } : {},
-    ...locale ? { inLanguage: locale } : {},
-    ...image ? { image } : {},
-    publisher
-  } : {
-    "@type": "WebSite",
-    name: siteName,
-    ...siteUrl ? { url: siteUrl } : {},
-    publisher
+    name: siteName
   };
+  if (siteUrl)
+    publisher.url = siteUrl;
+  if (sameAs?.length)
+    publisher.sameAs = sameAs;
+  const structuredData = type === "article" ? (() => {
+    const article = {
+      "@type": "Article",
+      headline: title,
+      description,
+      publisher
+    };
+    if (canonical)
+      article.url = canonical;
+    if (locale)
+      article.inLanguage = locale;
+    if (image)
+      article.image = image;
+    return article;
+  })() : (() => {
+    const website = {
+      "@type": "WebSite",
+      name: siteName,
+      publisher
+    };
+    if (siteUrl)
+      website.url = siteUrl;
+    return website;
+  })();
   const scripts = [
     {
       type: "application/ld+json",
@@ -1729,17 +1772,17 @@ var createSeo = (defaults) => (options) => seo({
 // ../../src/lib/docs-core.tsx
 import { jsx as jsx14, jsxs as jsxs9, Fragment as Fragment3 } from "react/jsx-runtime";
 addCollection(lucideIcons);
-var DocsSection = Schema2.String.annotate({
+var DocsSection = Schema3.String.annotate({
   identifier: "DocsSection"
 });
-var DocsPageType = Schema2.Literals([
+var DocsPageType = Schema3.Literals([
   "concept",
   "tutorial",
   "how-to",
   "reference",
   "runbook"
 ]).annotate({ identifier: "DocsPageType" });
-var DocsDate = Schema2.String.pipe(Schema2.check(Schema2.makeFilter((date) => Number.isNaN(new Date(date).getTime()) ? "Expected a valid date" : undefined)));
+var DocsDate = Schema3.String.pipe(Schema3.check(Schema3.makeFilter((date) => Number.isNaN(new Date(date).getTime()) ? "Expected a valid date" : undefined)));
 var NEW_DOCS_PAGE_DAYS = 14;
 var isDocsPageNew = (createdAt, now = new Date) => {
   if (!createdAt)
@@ -1747,31 +1790,31 @@ var isDocsPageNew = (createdAt, now = new Date) => {
   const age = now.getTime() - new Date(createdAt).getTime();
   return age >= 0 && age < NEW_DOCS_PAGE_DAYS * 24 * 60 * 60 * 1000;
 };
-var DocsFrontmatter = Schema2.Struct({
-  slug: Schema2.String,
-  path: Schema2.String,
-  title: Schema2.String,
-  description: Schema2.String,
-  icon: Schema2.optional(Schema2.String),
-  order: Schema2.Number,
-  locale: Schema2.String,
+var DocsFrontmatter = Schema3.Struct({
+  slug: Schema3.String,
+  path: Schema3.String,
+  title: Schema3.String,
+  description: Schema3.String,
+  icon: Schema3.optional(Schema3.String),
+  order: Schema3.Number,
+  locale: Schema3.String,
   section: DocsSection,
   type: DocsPageType,
-  createdAt: Schema2.optional(DocsDate),
-  updatedAt: Schema2.optional(DocsDate),
-  legacySlugs: Schema2.optional(Schema2.Array(Schema2.String))
+  createdAt: Schema3.optional(DocsDate),
+  updatedAt: Schema3.optional(DocsDate),
+  legacySlugs: Schema3.optional(Schema3.Array(Schema3.String))
 }).annotate({ identifier: "DocsFrontmatter" });
-var DocsHeadingSchema = Schema2.Struct({
-  depth: Schema2.Literals([2, 3]),
-  id: Schema2.String,
-  title: Schema2.String
+var DocsHeadingSchema = Schema3.Struct({
+  depth: Schema3.Literals([2, 3]),
+  id: Schema3.String,
+  title: Schema3.String
 }).annotate({ identifier: "DocsHeading" });
-var DocsPageSchema = Schema2.Struct({
+var DocsPageSchema = Schema3.Struct({
   ...DocsFrontmatter.fields,
-  headings: Schema2.Array(DocsHeadingSchema),
-  searchText: Schema2.String,
-  sourceFile: Schema2.String,
-  source: Schema2.String
+  headings: Schema3.Array(DocsHeadingSchema),
+  searchText: Schema3.String,
+  sourceFile: Schema3.String,
+  source: Schema3.String
 }).annotate({ identifier: "DocsPage" });
 var slugifyDocsHeading = (value) => value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[`*_~]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 var stripMarkdown = (source) => source.replace(/```[\s\S]*?```/g, " ").replace(/!?(?:\[([^\]]+)\])\([^)]*\)/g, "$1").replace(/<[^>]+>/g, " ").replace(/[`*_>#|~-]/g, " ").replace(/\s+/g, " ").trim();
@@ -1814,14 +1857,14 @@ var parseDocsSource = (file, source) => {
   const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(source);
   if (!match)
     throw new Error(`Missing frontmatter in ${file}`);
-  const frontmatter = Schema2.decodeUnknownSync(DocsFrontmatter)(parse(match[1] ?? ""));
+  const frontmatter = Schema3.decodeUnknownSync(DocsFrontmatter)(parse(match[1] ?? ""));
   const bodySource = match[2] ?? "";
   const title = /^#\s+(.+?)\s*$/m.exec(bodySource)?.[1];
   if (!title || stripMarkdown(title) !== stripMarkdown(frontmatter.title)) {
     throw new Error(`Body title does not match frontmatter in ${file}`);
   }
   const body = stripBodyTitle(bodySource);
-  return Schema2.decodeUnknownSync(DocsPageSchema)({
+  return Schema3.decodeUnknownSync(DocsPageSchema)({
     ...frontmatter,
     headings: parseHeadings(body, file),
     searchText: stripMarkdown(body),
@@ -1900,7 +1943,7 @@ var createDocsSource = (config) => {
   if (new Set(config.locales).size !== config.locales.length) {
     throw new Error("Documentation source locales must be unique");
   }
-  const pages = validateDocsPages(config.pages.map((page) => Schema2.decodeUnknownSync(DocsPageSchema)(page)), config);
+  const pages = validateDocsPages(config.pages.map((page) => Schema3.decodeUnknownSync(DocsPageSchema)(page)), config);
   const getPage = (slug, locale) => pages.find((page) => page.slug === slug && page.locale === locale);
   const resolvePage = (slug, locale) => pages.find((page) => page.locale === locale && (page.slug === slug || page.legacySlugs?.includes(slug)));
   const getPages = (locale) => pages.filter((page) => page.locale === locale).sort((left, right) => left.order - right.order);
@@ -1937,12 +1980,14 @@ var makeDocs = (config) => {
     icon: "lucide:book-open",
     href: "/"
   };
-  const docsSeo = createSeo({
+  const seoDefaults = {
     origin,
     locales: source.locales,
-    ...config.defaultLocale ? { defaultLocale: config.defaultLocale } : {},
     siteName: config.siteName
-  });
+  };
+  if (config.defaultLocale)
+    seoDefaults.defaultLocale = config.defaultLocale;
+  const docsSeo = createSeo(seoDefaults);
   const getMessages = (locale) => getDocsMessages(locale, config.messages?.(locale));
   const normalizeSearchText = (value) => value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
   const searchIndex = source.pages.flatMap((page) => {
@@ -2021,10 +2066,12 @@ var makeDocs = (config) => {
       if (entry.title.includes(normalizedQuery))
         score += 20;
       return [{ entry, score }];
-    }).sort((left, right) => right.score - left.score || left.entry.page.order - right.entry.page.order).slice(0, limit).map(({ entry }) => ({
-      page: entry.page,
-      ..."heading" in entry ? { heading: entry.heading } : {}
-    }));
+    }).sort((left, right) => right.score - left.score || left.entry.page.order - right.entry.page.order).slice(0, limit).map(({ entry }) => {
+      const result = { page: entry.page };
+      if ("heading" in entry)
+        result.heading = entry.heading;
+      return result;
+    });
   };
   const url = (page, locale) => `${origin}/${locale}${page.path}`;
   const editUrl = (page) => githubUrl && (config.editable?.(page) ?? true) ? `${githubUrl}/edit/${config.github?.branch ?? "main"}/${page.sourceFile}` : undefined;
@@ -2100,7 +2147,7 @@ var docsPageTypeMessages = {
     runbook: "Procédure d’exploitation"
   }
 };
-var defaultSectionLabel = (locale, section) => docsSectionMessages[locale][section] ?? humanizeDocsValue(section);
+var defaultSectionLabel = (locale, section) => Object.entries(docsSectionMessages[locale]).find(([key]) => key === section)?.[1] ?? humanizeDocsValue(section);
 var messages2 = {
   en: {
     title: "Documentation",
@@ -2173,15 +2220,16 @@ var iconFor = (name) => {
     icon: name,
     ref,
     ssr: true,
-    ...className ? { className } : {},
-    ...color ? { color } : {},
-    ...size === undefined ? {} : { height: size, width: size }
+    className,
+    color,
+    height: size,
+    width: size
   }));
   DocsIcon.displayName = `DocsIcon(${name})`;
   iconComponents.set(name, DocsIcon);
   return DocsIcon;
 };
-var headingText = (children) => Children.toArray(children).filter((child) => ["string", "number"].includes(typeof child)).join("");
+var headingText = (children) => Children.toArray(children).filter((child) => Schema3.is(Schema3.Union([Schema3.String, Schema3.Number]))(child)).join("");
 var makeDocsHeading = (level, copyLink) => {
   const Heading = ({
     children,
@@ -2385,19 +2433,22 @@ var DocsSearch = ({
           ssr: true
         }),
         onSelect: () => navigate({ to: page.path, hash: heading.id })
-      } : {
-        id: page.path,
-        label: page.title,
-        description: page.description,
-        ...page.icon ? {
-          icon: /* @__PURE__ */ jsx14(Icon, {
+      } : (() => {
+        const item = {
+          id: page.path,
+          label: page.title,
+          description: page.description,
+          onSelect: () => navigate({ to: page.path })
+        };
+        if (page.icon) {
+          item.icon = /* @__PURE__ */ jsx14(Icon, {
             className: "size-4",
             icon: page.icon,
             ssr: true
-          })
-        } : {},
-        onSelect: () => navigate({ to: page.path })
-      })
+          });
+        }
+        return item;
+      })())
     };
   });
   return /* @__PURE__ */ jsx14(SearchMenu, {
@@ -2424,12 +2475,17 @@ var DocsLayout = ({
   const resolvedMessages = docs.getMessages(locale);
   const groups = docs.sections(locale).map((section) => ({
     label: () => resolvedMessages.sectionLabel(section.id),
-    items: section.pages.map((item) => ({
-      label: () => item.title,
-      href: item.path,
-      icon: item.icon ? iconFor(item.icon) : EmptyIcon,
-      ...isDocsPageNew(item.createdAt) ? { badge: () => resolvedMessages.newLabel } : {}
-    }))
+    items: section.pages.map((item) => {
+      const navItem = {
+        label: () => item.title,
+        href: item.path,
+        icon: item.icon ? iconFor(item.icon) : EmptyIcon
+      };
+      if (isDocsPageNew(item.createdAt)) {
+        navItem.badge = () => resolvedMessages.newLabel;
+      }
+      return navItem;
+    })
   }));
   if (resources) {
     groups.push({
@@ -2439,7 +2495,7 @@ var DocsLayout = ({
           label: item.label,
           href: item.href,
           icon: iconFor(item.icon),
-          ...item.external === undefined ? {} : { external: item.external }
+          external: item.external
         })),
         ...docs.githubUrl ? [
           {

package/dist/lib/documentation-toolkit.d.ts

@@ -0,0 +1,140 @@
+import { Effect, Schema } from "effect";
+import { Tool, Toolkit } from "effect/unstable/ai";
+import { type DocsCatalog, type DocsLocale } from "./docs-core.js";
+export declare const DocumentationToolkit: Toolkit.Toolkit<{
+    readonly readDocumentation: Tool.Tool<"readDocumentation", {
+        readonly parameters: Schema.Struct<{
+            readonly paths: Schema.$Array<Schema.String>;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly pages: Schema.$Array<Schema.Struct<{
+                readonly slug: Schema.String;
+                readonly path: Schema.String;
+                readonly title: Schema.String;
+                readonly description: Schema.String;
+                readonly icon: Schema.optional<Schema.String>;
+                readonly order: Schema.Number;
+                readonly locale: Schema.String;
+                readonly section: Schema.String;
+                readonly type: Schema.Literals<readonly ["concept", "tutorial", "how-to", "reference", "runbook"]>;
+                readonly createdAt: Schema.optional<Schema.String>;
+                readonly updatedAt: Schema.optional<Schema.String>;
+                readonly legacySlugs: Schema.optional<Schema.$Array<Schema.String>>;
+                readonly headings: Schema.$Array<Schema.Struct<{
+                    readonly depth: Schema.Literals<readonly [2, 3]>;
+                    readonly id: Schema.String;
+                    readonly title: Schema.String;
+                }>>;
+                readonly searchText: Schema.String;
+                readonly sourceFile: Schema.String;
+                readonly source: Schema.String;
+            }>>;
+            readonly missingPaths: Schema.$Array<Schema.String>;
+        }>;
+        readonly failure: Schema.Never;
+        readonly failureMode: "error";
+    }, never>;
+    readonly searchDocumentation: Tool.Tool<"searchDocumentation", {
+        readonly parameters: Schema.Struct<{
+            readonly query: Schema.String;
+        }>;
+        readonly success: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.String;
+            readonly title: Schema.String;
+            readonly description: Schema.String;
+            readonly heading: Schema.optional<Schema.String>;
+        }>>;
+        readonly failure: Schema.Never;
+        readonly failureMode: "error";
+    }, never>;
+}>;
+export declare const searchDocumentation: (args_0: {
+    readonly docs: DocsCatalog;
+    readonly locale: DocsLocale;
+    readonly query: string;
+}) => Effect.Effect<{
+    path: string;
+    title: string;
+    description: string;
+    heading: string | undefined;
+}[], never, never>;
+export declare const readDocumentation: (args_0: {
+    readonly locale: DocsLocale;
+    readonly paths: ReadonlyArray<string>;
+    readonly docs: DocsCatalog;
+}) => Effect.Effect<{
+    pages: {
+        readonly slug: string;
+        readonly path: string;
+        readonly title: string;
+        readonly description: string;
+        readonly icon?: string | undefined;
+        readonly order: number;
+        readonly locale: string;
+        readonly section: string;
+        readonly type: "concept" | "how-to" | "reference" | "runbook" | "tutorial";
+        readonly createdAt?: string | undefined;
+        readonly updatedAt?: string | undefined;
+        readonly legacySlugs?: readonly string[] | undefined;
+        readonly headings: readonly Schema.Struct.ReadonlySide<{
+            readonly depth: Schema.Literals<readonly [2, 3]>;
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+        }, "Type">[];
+        readonly searchText: string;
+        readonly sourceFile: string;
+        readonly source: string;
+    }[];
+    missingPaths: string[];
+}, never, never>;
+export type DocumentationToolkitOptions = {
+    readonly locale: DocsLocale;
+    readonly docs: DocsCatalog;
+};
+export declare const DocumentationToolkitLayer: ({ docs, locale, }: DocumentationToolkitOptions) => import("effect/Layer").Layer<Tool.HandlersFor<{
+    readonly readDocumentation: Tool.Tool<"readDocumentation", {
+        readonly parameters: Schema.Struct<{
+            readonly paths: Schema.$Array<Schema.String>;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly pages: Schema.$Array<Schema.Struct<{
+                readonly slug: Schema.String;
+                readonly path: Schema.String;
+                readonly title: Schema.String;
+                readonly description: Schema.String;
+                readonly icon: Schema.optional<Schema.String>;
+                readonly order: Schema.Number;
+                readonly locale: Schema.String;
+                readonly section: Schema.String;
+                readonly type: Schema.Literals<readonly ["concept", "tutorial", "how-to", "reference", "runbook"]>;
+                readonly createdAt: Schema.optional<Schema.String>;
+                readonly updatedAt: Schema.optional<Schema.String>;
+                readonly legacySlugs: Schema.optional<Schema.$Array<Schema.String>>;
+                readonly headings: Schema.$Array<Schema.Struct<{
+                    readonly depth: Schema.Literals<readonly [2, 3]>;
+                    readonly id: Schema.String;
+                    readonly title: Schema.String;
+                }>>;
+                readonly searchText: Schema.String;
+                readonly sourceFile: Schema.String;
+                readonly source: Schema.String;
+            }>>;
+            readonly missingPaths: Schema.$Array<Schema.String>;
+        }>;
+        readonly failure: Schema.Never;
+        readonly failureMode: "error";
+    }, never>;
+    readonly searchDocumentation: Tool.Tool<"searchDocumentation", {
+        readonly parameters: Schema.Struct<{
+            readonly query: Schema.String;
+        }>;
+        readonly success: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.String;
+            readonly title: Schema.String;
+            readonly description: Schema.String;
+            readonly heading: Schema.optional<Schema.String>;
+        }>>;
+        readonly failure: Schema.Never;
+        readonly failureMode: "error";
+    }, never>;
+}>, never, never>;