@gmickel/gno 0.17.0 → 0.19.0

package/src/serve/routes/api.ts

@@ -66,6 +66,8 @@ export interface SearchRequestBody {
   limit?: number;
   minScore?: number;
   collection?: string;
+  intent?: string;
+  exclude?: string;
   since?: string;
   until?: string;
   /** Comma-separated category filters */
@@ -83,6 +85,9 @@ export interface QueryRequestBody {
   minScore?: number;
   collection?: string;
   lang?: string;
+  intent?: string;
+  candidateLimit?: number;
+  exclude?: string;
   since?: string;
   until?: string;
   /** Comma-separated category filters */
@@ -102,6 +107,10 @@ export interface AskRequestBody {
   limit?: number;
   collection?: string;
   lang?: string;
+  intent?: string;
+  candidateLimit?: number;
+  exclude?: string;
+  queryModes?: QueryModeInput[];
   since?: string;
   until?: string;
   /** Comma-separated category filters */
@@ -169,6 +178,73 @@ function parseCommaSeparatedValues(input: string): string[] {
   );
 }
 
+function parseQueryModesInput(value: unknown): {
+  queryModes?: QueryModeInput[];
+  error?: Response;
+} {
+  if (value === undefined) {
+    return {};
+  }
+
+  if (!Array.isArray(value)) {
+    return {
+      error: errorResponse(
+        "VALIDATION",
+        "queryModes must be an array of { mode, text } objects"
+      ),
+    };
+  }
+
+  const queryModes: QueryModeInput[] = [];
+  let hydeCount = 0;
+
+  for (const [index, entry] of value.entries()) {
+    if (!entry || typeof entry !== "object") {
+      return {
+        error: errorResponse(
+          "VALIDATION",
+          `queryModes[${index}] must be an object`
+        ),
+      };
+    }
+
+    const mode = (entry as { mode?: unknown }).mode;
+    const text = (entry as { text?: unknown }).text;
+    if (mode !== "term" && mode !== "intent" && mode !== "hyde") {
+      return {
+        error: errorResponse(
+          "VALIDATION",
+          `queryModes[${index}].mode must be one of: term, intent, hyde`
+        ),
+      };
+    }
+    if (typeof text !== "string" || !text.trim()) {
+      return {
+        error: errorResponse(
+          "VALIDATION",
+          `queryModes[${index}].text must be a non-empty string`
+        ),
+      };
+    }
+
+    if (mode === "hyde") {
+      hydeCount += 1;
+      if (hydeCount > 1) {
+        return {
+          error: errorResponse(
+            "VALIDATION",
+            "Only one hyde mode is allowed in queryModes"
+          ),
+        };
+      }
+    }
+
+    queryModes.push({ mode, text: text.trim() });
+  }
+
+  return { queryModes };
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Route Handlers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -1093,6 +1169,15 @@ export async function handleSearch(
   if (body.until !== undefined && typeof body.until !== "string") {
     return errorResponse("VALIDATION", "until must be a string");
   }
+  if (body.intent !== undefined && typeof body.intent !== "string") {
+    return errorResponse("VALIDATION", "intent must be a string");
+  }
+  if (body.exclude !== undefined && typeof body.exclude !== "string") {
+    return errorResponse(
+      "VALIDATION",
+      "exclude must be a comma-separated string"
+    );
+  }
   if (body.category !== undefined && typeof body.category !== "string") {
     return errorResponse(
       "VALIDATION",
@@ -1132,6 +1217,9 @@ export async function handleSearch(
   const categories = body.category
     ? parseCommaSeparatedValues(body.category)
     : undefined;
+  const exclude = body.exclude
+    ? parseCommaSeparatedValues(body.exclude)
+    : undefined;
   const author = body.author?.trim() || undefined;
 
   // Only BM25 supported in web UI (vector/hybrid require LLM ports)
@@ -1139,6 +1227,8 @@ export async function handleSearch(
     limit: Math.min(body.limit || 10, 50),
     minScore: body.minScore,
     collection: body.collection,
+    intent: body.intent?.trim() || undefined,
+    exclude,
     tagsAll,
     tagsAny,
     since: body.since,
@@ -1208,6 +1298,24 @@ export async function handleQuery(
   if (body.until !== undefined && typeof body.until !== "string") {
     return errorResponse("VALIDATION", "until must be a string");
   }
+  if (body.intent !== undefined && typeof body.intent !== "string") {
+    return errorResponse("VALIDATION", "intent must be a string");
+  }
+  if (body.exclude !== undefined && typeof body.exclude !== "string") {
+    return errorResponse(
+      "VALIDATION",
+      "exclude must be a comma-separated string"
+    );
+  }
+  if (
+    body.candidateLimit !== undefined &&
+    (typeof body.candidateLimit !== "number" || body.candidateLimit < 1)
+  ) {
+    return errorResponse(
+      "VALIDATION",
+      "candidateLimit must be a positive integer"
+    );
+  }
   if (body.category !== undefined && typeof body.category !== "string") {
     return errorResponse(
       "VALIDATION",
@@ -1218,54 +1326,11 @@ export async function handleQuery(
     return errorResponse("VALIDATION", "author must be a string");
   }
 
-  // Validate queryModes
-  let queryModes: QueryModeInput[] | undefined;
-  if (body.queryModes !== undefined) {
-    if (!Array.isArray(body.queryModes)) {
-      return errorResponse(
-        "VALIDATION",
-        "queryModes must be an array of { mode, text } objects"
-      );
-    }
-
-    queryModes = [];
-    let hydeCount = 0;
-
-    for (const [index, entry] of body.queryModes.entries()) {
-      if (!entry || typeof entry !== "object") {
-        return errorResponse(
-          "VALIDATION",
-          `queryModes[${index}] must be an object`
-        );
-      }
-
-      const mode = (entry as { mode?: unknown }).mode;
-      const text = (entry as { text?: unknown }).text;
-      if (mode !== "term" && mode !== "intent" && mode !== "hyde") {
-        return errorResponse(
-          "VALIDATION",
-          `queryModes[${index}].mode must be one of: term, intent, hyde`
-        );
-      }
-      if (typeof text !== "string" || !text.trim()) {
-        return errorResponse(
-          "VALIDATION",
-          `queryModes[${index}].text must be a non-empty string`
-        );
-      }
-
-      if (mode === "hyde") {
-        hydeCount += 1;
-        if (hydeCount > 1) {
-          return errorResponse(
-            "VALIDATION",
-            "Only one hyde mode is allowed in queryModes"
-          );
-        }
-      }
-
-      queryModes.push({ mode, text: text.trim() });
-    }
+  const { queryModes, error: queryModesError } = parseQueryModesInput(
+    body.queryModes
+  );
+  if (queryModesError) {
+    return queryModesError;
   }
 
   // Parse tag filters
@@ -1297,6 +1362,9 @@ export async function handleQuery(
   const categories = body.category
     ? parseCommaSeparatedValues(body.category)
     : undefined;
+  const exclude = body.exclude
+    ? parseCommaSeparatedValues(body.exclude)
+    : undefined;
   const author = body.author?.trim() || undefined;
 
   const result = await searchHybrid(
@@ -1314,6 +1382,12 @@ export async function handleQuery(
       minScore: body.minScore,
       collection: body.collection,
       lang: body.lang,
+      intent: body.intent?.trim() || undefined,
+      candidateLimit:
+        body.candidateLimit !== undefined
+          ? Math.min(body.candidateLimit, 100)
+          : undefined,
+      exclude,
       queryModes,
       noExpand: body.noExpand,
       noRerank: body.noRerank,
@@ -1377,6 +1451,24 @@ export async function handleAsk(
   if (body.until !== undefined && typeof body.until !== "string") {
     return errorResponse("VALIDATION", "until must be a string");
   }
+  if (body.intent !== undefined && typeof body.intent !== "string") {
+    return errorResponse("VALIDATION", "intent must be a string");
+  }
+  if (body.exclude !== undefined && typeof body.exclude !== "string") {
+    return errorResponse(
+      "VALIDATION",
+      "exclude must be a comma-separated string"
+    );
+  }
+  if (
+    body.candidateLimit !== undefined &&
+    (typeof body.candidateLimit !== "number" || body.candidateLimit < 1)
+  ) {
+    return errorResponse(
+      "VALIDATION",
+      "candidateLimit must be a positive integer"
+    );
+  }
   if (body.category !== undefined && typeof body.category !== "string") {
     return errorResponse(
       "VALIDATION",
@@ -1387,6 +1479,13 @@ export async function handleAsk(
     return errorResponse("VALIDATION", "author must be a string");
   }
 
+  const { queryModes, error: queryModesError } = parseQueryModesInput(
+    body.queryModes
+  );
+  if (queryModesError) {
+    return queryModesError;
+  }
+
   if (body.tagsAll) {
     try {
       tagsAll = parseAndValidateTagFilter(body.tagsAll);
@@ -1412,6 +1511,9 @@ export async function handleAsk(
   const categories = body.category
     ? parseCommaSeparatedValues(body.category)
     : undefined;
+  const exclude = body.exclude
+    ? parseCommaSeparatedValues(body.exclude)
+    : undefined;
   const author = body.author?.trim() || undefined;
 
   const limit = Math.min(body.limit ?? 5, 20);
@@ -1431,8 +1533,15 @@ export async function handleAsk(
       limit,
       collection: body.collection,
       lang: body.lang,
+      intent: body.intent?.trim() || undefined,
       noExpand: body.noExpand,
       noRerank: body.noRerank,
+      candidateLimit:
+        body.candidateLimit !== undefined
+          ? Math.min(body.candidateLimit, 100)
+          : undefined,
+      exclude,
+      queryModes,
       tagsAll,
       tagsAny,
       since: body.since,
@@ -1483,6 +1592,10 @@ export async function handleAsk(
       expanded: searchResult.value.meta.expanded ?? false,
       reranked: searchResult.value.meta.reranked ?? false,
       vectorsUsed: searchResult.value.meta.vectorsUsed ?? false,
+      intent: searchResult.value.meta.intent,
+      candidateLimit: searchResult.value.meta.candidateLimit,
+      exclude: searchResult.value.meta.exclude,
+      queryModes: searchResult.value.meta.queryModes,
       answerGenerated,
       totalResults: results.length,
       answerContext,