@leuria/docusaurus 0.1.0 → 0.1.2

package/dist/client/index.js

@@ -26,15 +26,15 @@ var leuria = new Promise((resolve) => {
   started = resolve;
 });
 async function start(settings) {
-  const [{ bridge, browserAI, createLeuria, server }, { setDefaultAppearance, setDefaultClient }, { createDocs, setupDocs }] = await Promise.all([
+  const [{ bridge, promptAPI, createAI, server }, { setDefaultAppearance, setDefaultClient }, { createDocs, setupDocs }] = await Promise.all([
     import("@leuria/client"),
     import("@leuria/connect"),
     import("@leuria/docs")
   ]);
-  const providers = [bridge({ app: settings.app, needs: settings.needs }), browserAI()];
+  const providers = [bridge({ app: settings.app, needs: settings.needs, skills: settings.skills }), promptAPI()];
   if (loadEmbedder) providers.push(await loadEmbedder());
-  if (settings.server) providers.push(server({ url: settings.server.url }));
-  const ai = createLeuria({ providers, fallback: settings.fallback });
+  if (settings.server) providers.push(server({ ...settings.server }));
+  const ai = createAI({ providers, fallback: settings.fallback });
   setDefaultClient(ai);
   followTheme(setDefaultAppearance);
   const docs = createDocs(ai, {

package/dist/index.d.ts

@@ -13,6 +13,24 @@ import { LoadContext, Plugin } from '@docusaurus/types';
  * without a search can add Leuria's (`search: true`), by words and by meaning.
  */
 
+/**
+ * Your own Chat Completions endpoint, as the last resort. Everything here
+ * reaches the page: put no API key in it, add the key on the server.
+ */
+interface ServerOptions {
+    /** Chat Completions URL, e.g. `/api/ai/chat/completions`. */
+    url: string;
+    /** Sent as `model`. Needed by endpoints that don't pick one (LiteLLM, OpenRouter…). */
+    model?: string;
+    /** The endpoint supports `response_format: { type: "json_schema" }`. Default false. */
+    jsonSchema?: boolean;
+    /** The endpoint supports tool calls. Default true. */
+    tools?: boolean;
+    /** The endpoint accepts images. Default false. */
+    images?: boolean;
+    /** The name readers see when they pick it, e.g. "This site's AI". */
+    label?: string;
+}
 interface Options {
     /** The name Leuria shows when the reader connects the site. Default: the site's title. */
     app?: string;
@@ -57,10 +75,17 @@ interface Options {
         effort?: "light" | "standard" | "deep";
         context?: number;
     };
+    /**
+     * Skills that guide the reader's AI on your site, in the `npx skills`
+     * syntax: `"/"` for your site's own `static/.well-known/agent-skills/`,
+     * `owner/repo`, `owner/repo@skill`, or `owner/repo/path#commit` pinned to
+     * a commit. Leuria fetches them, shows them to the reader when they
+     * connect, and gives them to their AI on your site only. Readers without
+     * the Leuria app don't get them.
+     */
+    skills?: string[];
     /** Your server as the last resort, for readers with no AI of their own. */
-    server?: {
-        url: string;
-    };
+    server?: ServerOptions;
     /**
      * Readers without Leuria: `ask` (default) proposes Leuria first, and this
      * browser's AI or your server answer only once the reader picks one (for
@@ -78,9 +103,8 @@ interface ClientConfig {
     system?: string;
     askButton: "navbar" | "floating" | "none";
     webmcp: boolean;
-    server?: {
-        url: string;
-    };
+    server?: ServerOptions;
+    skills?: string[];
     fallback: "ask" | "auto";
     needs: {
         tools?: boolean;
@@ -98,4 +122,4 @@ declare function validateOptions({ options }: {
     id: string;
 };
 
-export { type ClientConfig, type Options, leuriaDocusaurus as default, validateOptions };
+export { type ClientConfig, type Options, type ServerOptions, leuriaDocusaurus as default, validateOptions };

package/dist/index.js

@@ -60,6 +60,7 @@ function leuriaDocusaurus(context, options = {}) {
     askButton,
     webmcp: options.webmcp ?? true,
     server: options.server,
+    skills: options.skills,
     fallback: options.fallback ?? "ask",
     needs: options.needs ?? { tools: true, effort: "light" }
   };
@@ -118,6 +119,10 @@ function validateOptions({ options }) {
   }
   if (value.suggestions && !Array.isArray(value.suggestions)) throw new Error(`${NAME}: suggestions must be a list of questions.`);
   if (value.server && typeof value.server.url !== "string") throw new Error(`${NAME}: server needs a url.`);
+  if (value.server?.model !== void 0 && typeof value.server.model !== "string") throw new Error(`${NAME}: server.model must be a string.`);
+  if (value.skills && (!Array.isArray(value.skills) || value.skills.some((ref) => typeof ref !== "string" || !ref))) {
+    throw new Error(`${NAME}: skills must be a list of skill refs, e.g. ["/"] or ["owner/repo/path#commit"].`);
+  }
   if (value.fallback && !["ask", "auto"].includes(value.fallback)) throw new Error(`${NAME}: fallback must be "ask" or "auto".`);
   return { ...value, id: value.id ?? "default" };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leuria/docusaurus",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Ask AI for any Docusaurus site, on the reader's own AI: no API keys, nothing to pay per question. Plus the Connect button and WebMCP tools for the browser's agents.",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/leur-ia/leuria.git",
     "directory": "packages/docusaurus"
   },
-  "homepage": "https://leuria.dev",
+  "homepage": "https://leuria.dev/docs/developers/docusaurus",
   "keywords": [
     "docusaurus",
     "docusaurus-plugin",
@@ -34,13 +34,13 @@
     "dist"
   ],
   "dependencies": {
-    "@leuria/client": "^0.1.0",
-    "@leuria/connect": "^0.1.0",
+    "@leuria/client": "^0.1.4",
+    "@leuria/connect": "^0.1.4",
     "@leuria/docs": "^0.1.0"
   },
   "peerDependencies": {
     "@docusaurus/core": "^3.6.0",
-    "@leuria/web-embed": "^0.1.0"
+    "@leuria/web-embed": "^0.1.1"
   },
   "peerDependenciesMeta": {
     "@leuria/web-embed": {