npm - @gmickel/gno - Versions diffs - 0.3.5 → 0.5.0 - Mend

@gmickel/gno 0.3.5 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/README.md +74 -7
package/package.json +30 -1
package/src/cli/commands/ask.ts +12 -187
package/src/cli/commands/embed.ts +10 -4
package/src/cli/commands/models/pull.ts +9 -4
package/src/cli/commands/serve.ts +19 -0
package/src/cli/commands/vsearch.ts +5 -2
package/src/cli/program.ts +28 -0
package/src/config/types.ts +11 -6
package/src/llm/registry.ts +3 -1
package/src/mcp/tools/vsearch.ts +5 -2
package/src/pipeline/answer.ts +224 -0
package/src/pipeline/contextual.ts +57 -0
package/src/pipeline/expansion.ts +49 -31
package/src/pipeline/explain.ts +11 -3
package/src/pipeline/fusion.ts +20 -9
package/src/pipeline/hybrid.ts +57 -40
package/src/pipeline/index.ts +7 -0
package/src/pipeline/rerank.ts +55 -27
package/src/pipeline/types.ts +0 -3
package/src/pipeline/vsearch.ts +3 -2
package/src/serve/CLAUDE.md +91 -0
package/src/serve/bunfig.toml +2 -0
package/src/serve/context.ts +181 -0
package/src/serve/index.ts +7 -0
package/src/serve/public/app.tsx +56 -0
package/src/serve/public/components/ai-elements/code-block.tsx +176 -0
package/src/serve/public/components/ai-elements/conversation.tsx +98 -0
package/src/serve/public/components/ai-elements/inline-citation.tsx +285 -0
package/src/serve/public/components/ai-elements/loader.tsx +96 -0
package/src/serve/public/components/ai-elements/message.tsx +443 -0
package/src/serve/public/components/ai-elements/prompt-input.tsx +1421 -0
package/src/serve/public/components/ai-elements/sources.tsx +75 -0
package/src/serve/public/components/ai-elements/suggestion.tsx +51 -0
package/src/serve/public/components/preset-selector.tsx +403 -0
package/src/serve/public/components/ui/badge.tsx +46 -0
package/src/serve/public/components/ui/button-group.tsx +82 -0
package/src/serve/public/components/ui/button.tsx +62 -0
package/src/serve/public/components/ui/card.tsx +92 -0
package/src/serve/public/components/ui/carousel.tsx +244 -0
package/src/serve/public/components/ui/collapsible.tsx +31 -0
package/src/serve/public/components/ui/command.tsx +181 -0
package/src/serve/public/components/ui/dialog.tsx +141 -0
package/src/serve/public/components/ui/dropdown-menu.tsx +255 -0
package/src/serve/public/components/ui/hover-card.tsx +42 -0
package/src/serve/public/components/ui/input-group.tsx +167 -0
package/src/serve/public/components/ui/input.tsx +21 -0
package/src/serve/public/components/ui/progress.tsx +28 -0
package/src/serve/public/components/ui/scroll-area.tsx +56 -0
package/src/serve/public/components/ui/select.tsx +188 -0
package/src/serve/public/components/ui/separator.tsx +26 -0
package/src/serve/public/components/ui/table.tsx +114 -0
package/src/serve/public/components/ui/textarea.tsx +18 -0
package/src/serve/public/components/ui/tooltip.tsx +59 -0
package/src/serve/public/globals.css +226 -0
package/src/serve/public/hooks/use-api.ts +112 -0
package/src/serve/public/index.html +13 -0
package/src/serve/public/pages/Ask.tsx +442 -0
package/src/serve/public/pages/Browse.tsx +270 -0
package/src/serve/public/pages/Dashboard.tsx +202 -0
package/src/serve/public/pages/DocView.tsx +302 -0
package/src/serve/public/pages/Search.tsx +335 -0
package/src/serve/routes/api.ts +763 -0
package/src/serve/server.ts +249 -0
package/src/store/migrations/002-documents-fts.ts +40 -0
package/src/store/migrations/index.ts +2 -1
package/src/store/sqlite/adapter.ts +216 -33
package/src/store/sqlite/fts5-snowball.ts +144 -0
package/src/store/types.ts +33 -3
package/src/store/vector/stats.ts +3 -0
package/src/store/vector/types.ts +1 -0

package/src/serve/public/hooks/use-api.ts ADDED Viewed

@@ -0,0 +1,112 @@
+import { useCallback, useState } from 'react';
+interface ApiState<T> {
+  data: T | null;
+  loading: boolean;
+  error: string | null;
+}
+/**
+ * Safely parse JSON response, checking Content-Type first.
+ */
+async function parseJsonSafe(
+  res: Response
+): Promise<{ json: unknown; parseError: string | null }> {
+  const ct = res.headers.get('content-type') ?? '';
+  const isJson = ct.includes('application/json');
+  if (!isJson) {
+    // Non-JSON response - return text as error context
+    const text = await res.text();
+    return {
+      json: null,
+      parseError: text.slice(0, 200) || `Non-JSON response: ${res.status}`,
+    };
+  }
+  try {
+    const json = await res.json();
+    return { json, parseError: null };
+  } catch {
+    return { json: null, parseError: 'Invalid JSON response' };
+  }
+}
+export function useApi<T>() {
+  const [state, setState] = useState<ApiState<T>>({
+    data: null,
+    loading: false,
+    error: null,
+  });
+  const request = useCallback(
+    async (endpoint: string, options?: RequestInit): Promise<T | null> => {
+      setState({ data: null, loading: true, error: null });
+      try {
+        const res = await fetch(endpoint, {
+          headers: { 'Content-Type': 'application/json' },
+          ...options,
+        });
+        const { json, parseError } = await parseJsonSafe(res);
+        if (parseError) {
+          setState({ data: null, loading: false, error: parseError });
+          return null;
+        }
+        if (!res.ok) {
+          const apiError = json as { error?: { message?: string } };
+          const msg =
+            apiError.error?.message || `Request failed: ${res.status}`;
+          setState({ data: null, loading: false, error: msg });
+          return null;
+        }
+        setState({ data: json as T, loading: false, error: null });
+        return json as T;
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : 'Network error';
+        setState({ data: null, loading: false, error: msg });
+        return null;
+      }
+    },
+    []
+  );
+  return { ...state, request };
+}
+export async function apiFetch<T>(
+  endpoint: string,
+  options?: RequestInit
+): Promise<{ data: T | null; error: string | null }> {
+  try {
+    const res = await fetch(endpoint, {
+      headers: { 'Content-Type': 'application/json' },
+      ...options,
+    });
+    const { json, parseError } = await parseJsonSafe(res);
+    if (parseError) {
+      return { data: null, error: parseError };
+    }
+    if (!res.ok) {
+      const apiError = json as { error?: { message?: string } };
+      return {
+        data: null,
+        error: apiError.error?.message || `Request failed: ${res.status}`,
+      };
+    }
+    return { data: json as T, error: null };
+  } catch (err) {
+    return {
+      data: null,
+      error: err instanceof Error ? err.message : 'Network error',
+    };
+  }
+}

package/src/serve/public/index.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>GNO - Local Knowledge Index</title>
+    <link rel="stylesheet" href="./globals.css">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="./app.tsx"></script>
+  </body>
+</html>

package/src/serve/public/pages/Ask.tsx ADDED Viewed

@@ -0,0 +1,442 @@
+import {
+  ArrowLeft,
+  BookOpen,
+  CornerDownLeft,
+  FileText,
+  Sparkles,
+} from 'lucide-react';
+import { useEffect, useRef, useState } from 'react';
+import { Loader } from '../components/ai-elements/loader';
+import {
+  Source,
+  Sources,
+  SourcesContent,
+  SourcesTrigger,
+} from '../components/ai-elements/sources';
+import { Badge } from '../components/ui/badge';
+import { Button } from '../components/ui/button';
+import { Card, CardContent } from '../components/ui/card';
+import { Textarea } from '../components/ui/textarea';
+import { apiFetch } from '../hooks/use-api';
+interface PageProps {
+  navigate: (to: string | number) => void;
+}
+interface Citation {
+  docid: string;
+  uri: string;
+  startLine?: number;
+  endLine?: number;
+}
+interface SearchResult {
+  docid: string;
+  uri: string;
+  title?: string;
+  snippet: string;
+  score: number;
+  snippetRange?: {
+    startLine: number;
+    endLine: number;
+  };
+}
+interface AskResponse {
+  query: string;
+  mode: string;
+  queryLanguage: string;
+  answer?: string;
+  citations?: Citation[];
+  results: SearchResult[];
+  meta: {
+    expanded: boolean;
+    reranked: boolean;
+    vectorsUsed: boolean;
+    answerGenerated: boolean;
+    totalResults: number;
+  };
+}
+interface Capabilities {
+  bm25: boolean;
+  vector: boolean;
+  hybrid: boolean;
+  answer: boolean;
+}
+interface ConversationEntry {
+  id: string;
+  query: string;
+  response: AskResponse | null;
+  loading: boolean;
+  error?: string;
+}
+/**
+ * Render answer text with clickable citation badges.
+ * Citations like [1] become clickable to navigate to source.
+ */
+function renderAnswer(
+  answer: string,
+  citations: Citation[],
+  navigate: (to: string) => void
+): React.ReactNode {
+  const parts: React.ReactNode[] = [];
+  let key = 0;
+  const citationRegex = /\[(\d+)\]/g;
+  let lastIndex = 0;
+  let match: RegExpExecArray | null;
+  // biome-ignore lint/suspicious/noAssignInExpressions: Standard regex match pattern
+  while ((match = citationRegex.exec(answer)) !== null) {
+    // Add text before citation
+    if (match.index > lastIndex) {
+      parts.push(answer.slice(lastIndex, match.index));
+    }
+    const citationNum = Number(match[1]);
+    const citation = citations[citationNum - 1];
+    if (citation) {
+      parts.push(
+        <button
+          className="mx-0.5 inline-flex items-center rounded bg-primary/20 px-1.5 py-0.5 font-mono text-primary text-xs transition-colors hover:bg-primary/30"
+          key={key++}
+          onClick={() =>
+            navigate(`/doc?uri=${encodeURIComponent(citation.uri)}`)
+          }
+          type="button"
+        >
+          {citationNum}
+        </button>
+      );
+    } else {
+      parts.push(match[0]);
+    }
+    lastIndex = match.index + match[0].length;
+  }
+  // Add remaining text
+  if (lastIndex < answer.length) {
+    parts.push(answer.slice(lastIndex));
+  }
+  return parts;
+}
+export default function Ask({ navigate }: PageProps) {
+  const [query, setQuery] = useState('');
+  const [conversation, setConversation] = useState<ConversationEntry[]>([]);
+  const [capabilities, setCapabilities] = useState<Capabilities | null>(null);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+  const textareaRef = useRef<HTMLTextAreaElement>(null);
+  // Fetch capabilities on mount
+  useEffect(() => {
+    async function fetchCapabilities() {
+      const { data } = await apiFetch<Capabilities>('/api/capabilities');
+      if (data) {
+        setCapabilities(data);
+      }
+    }
+    fetchCapabilities();
+  }, []);
+  // Scroll to bottom when conversation updates
+  useEffect(() => {
+    messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  }, []);
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!query.trim()) {
+      return;
+    }
+    const entryId = crypto.randomUUID();
+    const currentQuery = query.trim();
+    // Add entry to conversation
+    setConversation((prev) => [
+      ...prev,
+      { id: entryId, query: currentQuery, response: null, loading: true },
+    ]);
+    setQuery('');
+    // Make API call
+    const { data, error } = await apiFetch<AskResponse>('/api/ask', {
+      method: 'POST',
+      body: JSON.stringify({ query: currentQuery, limit: 5 }),
+    });
+    // Update conversation with response
+    setConversation((prev) =>
+      prev.map((entry) =>
+        entry.id === entryId
+          ? {
+              ...entry,
+              response: data ?? null,
+              loading: false,
+              error: error ?? undefined,
+            }
+          : entry
+      )
+    );
+  };
+  const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      handleSubmit(e);
+    }
+  };
+  const answerAvailable = capabilities?.answer ?? false;
+  return (
+    <div className="flex min-h-screen flex-col">
+      {/* Header */}
+      <header className="glass sticky top-0 z-10 border-border/50 border-b">
+        <div className="flex items-center gap-4 px-8 py-4">
+          <Button
+            className="gap-2"
+            onClick={() => navigate(-1)}
+            size="sm"
+            variant="ghost"
+          >
+            <ArrowLeft className="size-4" />
+            Back
+          </Button>
+          <h1 className="font-semibold text-xl">Ask</h1>
+          {capabilities && (
+            <div className="ml-auto flex items-center gap-2">
+              {capabilities.vector && (
+                <Badge className="font-mono text-[10px]" variant="secondary">
+                  vectors
+                </Badge>
+              )}
+              {capabilities.answer && (
+                <Badge className="font-mono text-[10px]" variant="secondary">
+                  AI
+                </Badge>
+              )}
+            </div>
+          )}
+        </div>
+      </header>
+      {/* Conversation area */}
+      <main className="flex-1 overflow-y-auto p-8">
+        <div className="mx-auto max-w-3xl space-y-8">
+          {/* Empty state */}
+          {conversation.length === 0 && (
+            <div className="py-20 text-center">
+              <Sparkles className="mx-auto mb-4 size-12 text-primary/60" />
+              <h2 className="mb-2 font-medium text-lg">Ask anything</h2>
+              <p className="text-muted-foreground">
+                {answerAvailable
+                  ? 'Get AI-powered answers with citations from your documents'
+                  : 'AI answers not available. Install a generation model to enable.'}
+              </p>
+            </div>
+          )}
+          {/* Conversation entries */}
+          {conversation.map((entry) => (
+            <div className="space-y-4" key={entry.id}>
+              {/* User query */}
+              <div className="flex justify-end">
+                <div className="max-w-[80%] rounded-lg bg-secondary px-4 py-3">
+                  <p className="text-foreground">{entry.query}</p>
+                </div>
+              </div>
+              {/* AI response */}
+              <div className="space-y-3">
+                {entry.loading && (
+                  <div className="flex items-center gap-3">
+                    <Loader className="text-primary" size={20} />
+                    <span className="text-muted-foreground text-sm">
+                      Thinking...
+                    </span>
+                  </div>
+                )}
+                {entry.error && (
+                  <Card className="border-destructive bg-destructive/10">
+                    <CardContent className="py-4 text-destructive">
+                      {entry.error}
+                    </CardContent>
+                  </Card>
+                )}
+                {entry.response && (
+                  <>
+                    {/* Answer */}
+                    {entry.response.answer && (
+                      <div className="prose prose-sm prose-invert max-w-none rounded-lg bg-card/50 p-4">
+                        <p className="whitespace-pre-wrap leading-relaxed">
+                          {renderAnswer(
+                            entry.response.answer,
+                            entry.response.citations ?? [],
+                            navigate
+                          )}
+                        </p>
+                      </div>
+                    )}
+                    {/* Citations */}
+                    {entry.response.citations &&
+                      entry.response.citations.length > 0 && (
+                        <Sources defaultOpen>
+                          <SourcesTrigger
+                            count={entry.response.citations.length}
+                          />
+                          <SourcesContent>
+                            {entry.response.citations.map((c, i) => (
+                              <Source
+                                href="#"
+                                key={`${c.docid}-${i}`}
+                                onClick={(e) => {
+                                  e.preventDefault();
+                                  navigate(
+                                    `/doc?uri=${encodeURIComponent(c.uri)}`
+                                  );
+                                }}
+                                title={`[${i + 1}] ${c.uri.split('/').pop()}`}
+                              >
+                                <BookOpen className="size-4 shrink-0" />
+                                <span className="truncate">
+                                  [{i + 1}] {c.uri.split('/').pop()}
+                                </span>
+                                {c.startLine && (
+                                  <span className="ml-1 font-mono text-[10px] text-muted-foreground/60">
+                                    L{c.startLine}
+                                    {c.endLine && `-${c.endLine}`}
+                                  </span>
+                                )}
+                              </Source>
+                            ))}
+                          </SourcesContent>
+                        </Sources>
+                      )}
+                    {/* Meta info */}
+                    <div className="flex items-center gap-2 text-muted-foreground/60 text-xs">
+                      <span>{entry.response.results.length} results</span>
+                      {entry.response.meta.vectorsUsed && (
+                        <Badge
+                          className="font-mono text-[9px]"
+                          variant="outline"
+                        >
+                          hybrid
+                        </Badge>
+                      )}
+                      {entry.response.meta.expanded && (
+                        <Badge
+                          className="font-mono text-[9px]"
+                          variant="outline"
+                        >
+                          expanded
+                        </Badge>
+                      )}
+                    </div>
+                    {/* Show retrieved sources if no answer */}
+                    {!entry.response.answer &&
+                      entry.response.results.length > 0 && (
+                        <div className="space-y-2">
+                          <p className="font-medium text-muted-foreground text-sm">
+                            Search results:
+                          </p>
+                          {entry.response.results.map((r, i) => (
+                            <Card
+                              className="cursor-pointer transition-colors hover:border-primary/50"
+                              key={`${r.docid}-${i}`}
+                              onClick={() =>
+                                navigate(
+                                  `/doc?uri=${encodeURIComponent(r.uri)}`
+                                )
+                              }
+                            >
+                              <CardContent className="py-3">
+                                <div className="flex items-start justify-between gap-2">
+                                  <div className="min-w-0">
+                                    <p className="font-medium text-primary text-sm">
+                                      {r.title || r.uri.split('/').pop()}
+                                    </p>
+                                    <p className="line-clamp-2 text-muted-foreground text-xs">
+                                      {r.snippet.slice(0, 200)}...
+                                    </p>
+                                  </div>
+                                  <Badge
+                                    className="shrink-0 font-mono text-[10px]"
+                                    variant="secondary"
+                                  >
+                                    {(r.score * 100).toFixed(0)}%
+                                  </Badge>
+                                </div>
+                              </CardContent>
+                            </Card>
+                          ))}
+                        </div>
+                      )}
+                    {/* No results */}
+                    {!entry.response.answer &&
+                      entry.response.results.length === 0 && (
+                        <div className="flex items-center gap-2 text-muted-foreground">
+                          <FileText className="size-4" />
+                          <span className="text-sm">
+                            No relevant results found
+                          </span>
+                        </div>
+                      )}
+                  </>
+                )}
+              </div>
+            </div>
+          ))}
+          <div ref={messagesEndRef} />
+        </div>
+      </main>
+      {/* Input area */}
+      <footer className="glass sticky bottom-0 border-border/50 border-t">
+        <form
+          className="mx-auto flex max-w-3xl items-end gap-3 p-4"
+          onSubmit={handleSubmit}
+        >
+          <div className="relative flex-1">
+            <Textarea
+              className="min-h-[60px] resize-none pr-12"
+              disabled={!answerAvailable}
+              onChange={(e) => setQuery(e.target.value)}
+              onKeyDown={handleKeyDown}
+              placeholder={
+                answerAvailable
+                  ? 'Ask a question about your documents...'
+                  : 'AI answers not available'
+              }
+              ref={textareaRef}
+              rows={1}
+              value={query}
+            />
+            <Button
+              className="absolute right-2 bottom-2"
+              disabled={!(query.trim() && answerAvailable)}
+              size="icon-sm"
+              type="submit"
+            >
+              <CornerDownLeft className="size-4" />
+            </Button>
+          </div>
+        </form>
+      </footer>
+    </div>
+  );
+}