@farming-labs/svelte 0.1.72 → 0.1.73

package/dist/server.js

@@ -30,7 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsSkillDocument, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsSkillDocument, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -548,20 +548,6 @@ export function createDocsServer(config = {}) {
         searchIndexByEntry.set(key, index);
         return index;
     }
-    function searchByQuery(query, ctx) {
-        const index = getSearchIndex(ctx);
-        return index
-            .map((page) => {
-            const titleMatch = page.title.toLowerCase().includes(query) ? 10 : 0;
-            const words = query.split(/\s+/);
-            const contentMatch = words.reduce((score, word) => {
-                return score + (page.content.toLowerCase().includes(word) ? 1 : 0);
-            }, 0);
-            return { ...page, score: titleMatch + contentMatch };
-        })
-            .filter((r) => r.score > 0)
-            .sort((a, b) => b.score - a.score);
-    }
     // ─── llms.txt content builder ────────────────────────────────
     const llmsSiteTitle = typeof config.nav === "object" &&
         typeof config.nav?.title === "string"
@@ -748,12 +734,16 @@ export function createDocsServer(config = {}) {
     function buildDefaultSystemPrompt() {
         const lines = [
             `You are a helpful documentation assistant${projectName ? ` for ${projectName}` : ""}.`,
-            "Answer questions based on the provided documentation context.",
+            "Answer only from the provided documentation context.",
+            "Prefer exact code/config snippets from the context when the question asks how to implement something.",
+            "Cite the relevant documentation URL when you use a source.",
+            "Use only URLs exactly as they appear in the context; do not invent placeholder domains.",
+            'Never use placeholder package names or imports such as "your-auth-library", "your-package", "your-sdk", "replace-me", or "example-library". If the exact package or import is not in the context, do not include an import snippet.',
             "Be concise and accurate. If the answer is not in the context, say so honestly.",
             "Use markdown formatting for code examples and links.",
         ];
         if (packageName) {
-            lines.push(`When showing import examples, always use "${packageName}" as the package name.`);
+            lines.push(`When showing import examples, use "${packageName}" as the package name and prefer exact imports copied from the documentation context.`);
         }
         if (docsUrl) {
             lines.push(`When linking to documentation pages, use "${docsUrl}" as the base URL (e.g. ${docsUrl}/docs/get-started).`);
@@ -935,7 +925,17 @@ export function createDocsServer(config = {}) {
                 maxResults,
             },
         });
-        const scored = searchByQuery(lastUserMessage.content.toLowerCase(), ctx).slice(0, maxResults);
+        const retrieval = await buildDocsAskAIContext({
+            pages: getSearchIndex(ctx),
+            query: lastUserMessage.content,
+            search: resolveSearchRequestConfig(config.search, event.request.url),
+            locale: ctx.locale,
+            pathname: requestUrl.searchParams.get("pathname") ?? undefined,
+            siteTitle: llmsTitle,
+            baseUrl: requestUrl.origin,
+            limit: maxResults,
+        });
+        const scored = retrieval.results;
         await emitTrace({
             type: "retrieval.result",
             name: "docs-index",
@@ -954,14 +954,15 @@ export function createDocsServer(config = {}) {
         const promptStartedAt = Date.now();
         const promptStartedAtIso = new Date().toISOString();
         const promptSpanId = createDocsAgentTraceId("span");
-        const contextParts = scored.map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`);
-        const context = contextParts.join("\n\n---\n\n");
+        const context = retrieval.context;
         const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+        const packageHintsPrompt = formatDocsAskAIPackageHints(retrieval.packageHints, packageName);
+        const fullSystemPrompt = [systemPrompt, packageHintsPrompt].filter(Boolean).join("\n\n");
         const systemMessage = {
             role: "system",
             content: context
-                ? `${systemPrompt}\n\n---\n\nDocumentation context:\n\n${context}`
-                : systemPrompt,
+                ? `${fullSystemPrompt}\n\n---\n\nDocumentation context:\n\n${context}`
+                : fullSystemPrompt,
         };
         const llmMessages = [
             systemMessage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.1.72",
+  "version": "0.1.73",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
   "keywords": [
     "docs",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.1.72"
+    "@farming-labs/docs": "0.1.73"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"