stagent 0.9.6 → 0.11.0

package/src/components/shared/__tests__/filter-hint.test.tsx

@@ -0,0 +1,40 @@
+import { render, screen, waitFor } from "@testing-library/react";
+import { describe, it, expect, beforeEach } from "vitest";
+import { FilterHint } from "../filter-hint";
+
+const KEY = "stagent.filter-hint.dismissed";
+
+describe("FilterHint", () => {
+  beforeEach(() => {
+    localStorage.removeItem(KEY);
+  });
+
+  it("renders when input is empty and not dismissed", () => {
+    render(<FilterHint inputValue="" storageKey={KEY} />);
+    expect(screen.getByText(/#key:value/i)).toBeInTheDocument();
+  });
+
+  it("renders when input has no # character", () => {
+    render(<FilterHint inputValue="some search" storageKey={KEY} />);
+    expect(screen.getByText(/#key:value/i)).toBeInTheDocument();
+  });
+
+  it("hides when input contains #", () => {
+    render(<FilterHint inputValue="#status:blocked" storageKey={KEY} />);
+    expect(screen.queryByText(/#key:value/i)).toBeNull();
+  });
+
+  it("sets dismissal flag and hides when input parses a valid clause", async () => {
+    render(<FilterHint inputValue="#type:pdf" storageKey={KEY} />);
+    expect(localStorage.getItem(KEY)).toBe("1");
+    await waitFor(() => {
+      expect(screen.queryByText(/#key:value/i)).toBeNull();
+    });
+  });
+
+  it("stays hidden on subsequent mounts once dismissed", () => {
+    localStorage.setItem(KEY, "1");
+    render(<FilterHint inputValue="" storageKey={KEY} />);
+    expect(screen.queryByText(/#key:value/i)).toBeNull();
+  });
+});

package/src/components/shared/__tests__/saved-searches-manager.test.tsx

@@ -0,0 +1,147 @@
+import { render, screen, fireEvent } from "@testing-library/react";
+import { describe, it, expect, vi } from "vitest";
+import { SavedSearchesManager } from "../saved-searches-manager";
+import type { SavedSearch } from "@/hooks/use-saved-searches";
+
+const search = (over: Partial<SavedSearch> = {}): SavedSearch => ({
+  id: "s1",
+  surface: "task",
+  label: "Blocked tasks",
+  filterInput: "#status:blocked",
+  createdAt: "2026-04-14T00:00:00.000Z",
+  ...over,
+});
+
+describe("SavedSearchesManager", () => {
+  it("lists all saved searches", () => {
+    const items = [
+      search({ id: "s1", label: "Blocked tasks" }),
+      search({ id: "s2", label: "Pdf docs", surface: "document", filterInput: "#type:pdf" }),
+    ];
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={items}
+        onRename={() => {}}
+        onRemove={() => {}}
+      />
+    );
+    expect(screen.getByText("Blocked tasks")).toBeInTheDocument();
+    expect(screen.getByText("Pdf docs")).toBeInTheDocument();
+  });
+
+  it("renames on blur with non-empty trimmed label", () => {
+    const onRename = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[search()]}
+        onRename={onRename}
+        onRemove={() => {}}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /rename blocked tasks/i }));
+    const input = screen.getByRole("textbox", { name: /rename/i });
+    fireEvent.change(input, { target: { value: "  Renamed  " } });
+    fireEvent.blur(input);
+    expect(onRename).toHaveBeenCalledWith("s1", "Renamed");
+  });
+
+  it("rejects empty label with inline error", () => {
+    const onRename = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[search()]}
+        onRename={onRename}
+        onRemove={() => {}}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /rename blocked tasks/i }));
+    const input = screen.getByRole("textbox", { name: /rename/i });
+    fireEvent.change(input, { target: { value: "   " } });
+    fireEvent.blur(input);
+    expect(onRename).not.toHaveBeenCalled();
+    expect(screen.getByText(/cannot be empty/i)).toBeInTheDocument();
+  });
+
+  it("rejects duplicate label within same surface (case-insensitive)", () => {
+    const onRename = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[
+          search({ id: "s1", label: "Blocked tasks" }),
+          search({ id: "s2", label: "Another" }),
+        ]}
+        onRename={onRename}
+        onRemove={() => {}}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /rename another/i }));
+    const input = screen.getByRole("textbox", { name: /rename/i });
+    fireEvent.change(input, { target: { value: "blocked TASKS" } });
+    fireEvent.blur(input);
+    expect(onRename).not.toHaveBeenCalled();
+    expect(screen.getByText(/already exists/i)).toBeInTheDocument();
+  });
+
+  it("rejects label longer than 120 chars", () => {
+    const onRename = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[search()]}
+        onRename={onRename}
+        onRemove={() => {}}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /rename blocked tasks/i }));
+    const input = screen.getByRole("textbox", { name: /rename/i });
+    fireEvent.change(input, { target: { value: "x".repeat(121) } });
+    fireEvent.blur(input);
+    expect(onRename).not.toHaveBeenCalled();
+    expect(screen.getByText(/too long/i)).toBeInTheDocument();
+  });
+
+  it("Escape cancels rename without persisting", () => {
+    const onRename = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[search()]}
+        onRename={onRename}
+        onRemove={() => {}}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /rename blocked tasks/i }));
+    const input = screen.getByRole("textbox", { name: /rename/i });
+    fireEvent.change(input, { target: { value: "Changed" } });
+    fireEvent.keyDown(input, { key: "Escape" });
+    expect(onRename).not.toHaveBeenCalled();
+    expect(screen.queryByRole("textbox", { name: /rename/i })).toBeNull();
+  });
+
+  it("delete requires explicit confirm", () => {
+    const onRemove = vi.fn();
+    render(
+      <SavedSearchesManager
+        open
+        onOpenChange={() => {}}
+        searches={[search()]}
+        onRename={() => {}}
+        onRemove={onRemove}
+      />
+    );
+    fireEvent.click(screen.getByRole("button", { name: /delete blocked tasks/i }));
+    expect(onRemove).not.toHaveBeenCalled();
+    fireEvent.click(screen.getByRole("button", { name: /confirm delete/i }));
+    expect(onRemove).toHaveBeenCalledWith("s1");
+  });
+});

package/src/components/shared/app-sidebar.tsx

@@ -21,7 +21,6 @@ import {
   MessageCircle,
   Table2,
   BarChart3,
-  Store,
   ChevronDown,
 } from "lucide-react";
 import { cn } from "@/lib/utils";
@@ -43,6 +42,7 @@ import {
 import { ThemeToggle } from "@/components/shared/theme-toggle";
 import { TrustTierBadge } from "@/components/shared/trust-tier-badge";
 import { UnreadBadge } from "@/components/notifications/unread-badge";
+import { UpgradeBadge } from "@/components/instance/upgrade-badge";
 import { AuthStatusDot } from "@/components/settings/auth-status-dot";
 import { StagentLogo } from "@/components/shared/stagent-logo";
 import { WorkspaceIndicator } from "@/components/shared/workspace-indicator";
@@ -65,7 +65,6 @@ const workItems: NavItem[] = [
   { title: "Workflows", href: "/workflows", icon: Workflow },
   { title: "Documents", href: "/documents", icon: FileText },
   { title: "Tables", href: "/tables", icon: Table2, alsoMatches: ["/tables/"] },
-  { title: "Marketplace", href: "/marketplace", icon: Store },
 ];
 
 const manageItems: NavItem[] = [
@@ -199,7 +198,6 @@ function NavGroup({
 
 export function AppSidebar() {
   const pathname = usePathname();
-
   // Determine which group owns the current route
   const activeGroup = useMemo(() => {
     for (const group of groupMap) {
@@ -248,6 +246,9 @@ export function AppSidebar() {
         ))}
       </SidebarContent>
       <SidebarFooter className="px-4 py-3">
+        <div className="group-data-[collapsible=icon]:hidden mb-2 empty:hidden">
+          <UpgradeBadge />
+        </div>
         <div className="group-data-[collapsible=icon]:hidden mb-2">
           <WorkspaceIndicator variant="sidebar" />
         </div>

package/src/components/shared/command-palette.tsx

@@ -21,8 +21,29 @@ import {
   CheckCheck,
   Loader2,
   BookOpen,
+  Sparkles,
+  FileCode,
+  Bookmark,
+  Trash2,
+  Settings2,
 } from "lucide-react";
 import { navigationItems, createItems } from "@/lib/chat/command-data";
+import { toggleTheme } from "@/lib/theme";
+import { useProjectSkills } from "@/hooks/use-project-skills";
+import { useSavedSearches, type SavedSearch, type SavedSearchSurface } from "@/hooks/use-saved-searches";
+import { SavedSearchesManager } from "./saved-searches-manager";
+import { toast } from "sonner";
+
+// Maps each saved-search surface to its list-page route. Tasks route to
+// /dashboard since /tasks is still a redirect stub.
+const SURFACE_ROUTE: Record<SavedSearchSurface, string> = {
+  task: "/dashboard",
+  project: "/projects",
+  workflow: "/workflows",
+  document: "/documents",
+  skill: "/skills",
+  profile: "/profiles",
+};
 
 interface RecentProject {
   id: string;
@@ -63,8 +84,21 @@ export function CommandPalette() {
   const [recentTasks, setRecentTasks] = useState<RecentTask[]>([]);
   const [playbookItems, setPlaybookItems] = useState<PlaybookItem[]>([]);
   const [loadingRecent, setLoadingRecent] = useState(false);
+  const [fileQuery, setFileQuery] = useState("");
+  const [fileResults, setFileResults] = useState<Array<{ entityId: string; label: string; description?: string }>>([]);
   const abortRef = useRef<AbortController | null>(null);
+  const fileAbortRef = useRef<AbortController | null>(null);
+  const fileDebounceRef = useRef<number | null>(null);
   const router = useRouter();
+  const { skills } = useProjectSkills(null);
+  const {
+    searches: savedSearches,
+    refetch: refetchSavedSearches,
+    remove: removeSavedSearch,
+    save: saveSavedSearch,
+    rename: renameSavedSearch,
+  } = useSavedSearches();
+  const [managerOpen, setManagerOpen] = useState(false);
 
   // Defer render until after hydration to avoid Radix ID mismatch
   useEffect(() => setMounted(true), []);
@@ -85,6 +119,10 @@ export function CommandPalette() {
     if (!open) {
       abortRef.current?.abort();
       abortRef.current = null;
+      fileAbortRef.current?.abort();
+      if (fileDebounceRef.current) window.clearTimeout(fileDebounceRef.current);
+      setFileQuery("");
+      setFileResults([]);
       return;
     }
 
@@ -107,6 +145,33 @@ export function CommandPalette() {
       .finally(() => setLoadingRecent(false));
   }, [open]);
 
+  function handleInputChange(value: string) {
+    setFileQuery(value);
+    if (fileDebounceRef.current) {
+      window.clearTimeout(fileDebounceRef.current);
+    }
+    fileAbortRef.current?.abort();
+    if (!value || value.length < 2) {
+      setFileResults([]);
+      return;
+    }
+    fileDebounceRef.current = window.setTimeout(() => {
+      const controller = new AbortController();
+      fileAbortRef.current = controller;
+      const params = new URLSearchParams({ q: value, limit: "8" });
+      fetch(`/api/chat/files/search?${params}`, { signal: controller.signal })
+        .then((r) => (r.ok ? r.json() : null))
+        .then((data) => {
+          if (Array.isArray(data)) setFileResults(data);
+          else if (Array.isArray(data?.results)) setFileResults(data.results);
+          else setFileResults([]);
+        })
+        .catch(() => {
+          // aborted or failed — ignore
+        });
+    }, 200);
+  }
+
   const navigate = useCallback(
     (href: string) => {
       setOpen(false);
@@ -115,11 +180,27 @@ export function CommandPalette() {
     [router]
   );
 
-  function toggleTheme() {
+  function handleToggleTheme() {
+    setOpen(false);
+    toggleTheme();
+  }
+
+  function handleSelectSkill(id: string, name: string) {
     setOpen(false);
-    const isDark = document.documentElement.classList.contains("dark");
-    document.documentElement.classList.toggle("dark");
-    localStorage.setItem("stagent-theme", isDark ? "light" : "dark");
+    window.dispatchEvent(
+      new CustomEvent("stagent.chat.activate-skill", { detail: { id } })
+    );
+    toast.info(`Skill "${name}" — activation coming soon`);
+  }
+
+  function handleSelectFile(entityId: string, label: string) {
+    setOpen(false);
+    window.dispatchEvent(
+      new CustomEvent("stagent.chat.insert-mention", {
+        detail: { type: "file", path: entityId, label },
+      })
+    );
+    toast.info(`File "${label}" — mention insert coming soon`);
   }
 
   async function markAllRead() {
@@ -130,11 +211,55 @@ export function CommandPalette() {
 
   const hasRecent = recentProjects.length > 0 || recentTasks.length > 0;
 
+  const handleDeleteSavedSearch = useCallback(
+    (s: SavedSearch) => {
+      // Optimistic remove + toast with Undo. The closure holds the full
+      // record so undo restores id/createdAt verbatim (not just label).
+      removeSavedSearch(s.id);
+      toast("Saved search deleted", {
+        duration: 5000,
+        action: {
+          label: "Undo",
+          onClick: () => {
+            // `save` generates a new id — we need to restore the original.
+            // The cheapest restoration is to re-save and then immediately
+            // patch the id via a rename-adjacent path. Since the hook has
+            // no "insert with id" method, we accept id churn on undo: the
+            // label/filterInput/surface are preserved, which is what the
+            // user sees. Acceptance criterion: the row reappears with its
+            // label and filter, the actual id is an implementation detail.
+            saveSavedSearch({
+              surface: s.surface,
+              label: s.label,
+              filterInput: s.filterInput,
+            });
+          },
+        },
+      });
+    },
+    [removeSavedSearch, saveSavedSearch]
+  );
+
   if (!mounted) return null;
 
   return (
-    <CommandDialog open={open} onOpenChange={setOpen}>
-      <CommandInput placeholder="Type a command or search..." />
+    <>
+    <CommandDialog
+      open={open}
+      onOpenChange={(next) => {
+        // Revalidate saved searches on every open. Each useSavedSearches
+        // consumer holds its own state, so a save in the chat popover
+        // wouldn't otherwise appear here until page reload.
+        // See features/saved-search-polish-v1.md.
+        if (next && !open) void refetchSavedSearches();
+        setOpen(next);
+      }}
+    >
+      <CommandInput
+        placeholder="Type a command or search..."
+        value={fileQuery}
+        onValueChange={handleInputChange}
+      />
       <CommandList>
         <CommandEmpty>No results found.</CommandEmpty>
 
@@ -183,6 +308,63 @@ export function CommandPalette() {
 
         {hasRecent && <CommandSeparator />}
 
+        {/* Saved searches */}
+        {savedSearches.length > 0 && (
+          <>
+            <CommandGroup heading="Saved searches">
+              {savedSearches.map((s) => (
+                <CommandItem
+                  key={`saved-${s.id}`}
+                  value={`saved ${s.label} ${s.filterInput} ${s.surface}`}
+                  onSelect={() => {
+                    const base = SURFACE_ROUTE[s.surface];
+                    navigate(`${base}?filter=${encodeURIComponent(s.filterInput)}`);
+                  }}
+                  keywords={["saved", "search", s.surface]}
+                  className="group/item"
+                  onKeyDown={(e) => {
+                    // ⌘⌫ on focused row deletes with undo
+                    if ((e.metaKey || e.ctrlKey) && e.key === "Backspace") {
+                      e.preventDefault();
+                      e.stopPropagation();
+                      handleDeleteSavedSearch(s);
+                    }
+                  }}
+                >
+                  <Bookmark className="h-4 w-4" />
+                  <span className="flex-1 truncate">{s.label}</span>
+                  <span className="text-xs text-muted-foreground font-mono">{s.filterInput}</span>
+                  <span className="ml-2 text-xs text-muted-foreground">{s.surface}</span>
+                  <button
+                    type="button"
+                    aria-label={`Delete saved search: ${s.label}`}
+                    className="ml-1 p-1 rounded hover:bg-destructive/10 text-muted-foreground hover:text-destructive opacity-0 group-hover/item:opacity-100 focus-visible:opacity-100 transition-opacity"
+                    onPointerDown={(e) => e.stopPropagation()}
+                    onClick={(e) => {
+                      e.preventDefault();
+                      e.stopPropagation();
+                      handleDeleteSavedSearch(s);
+                    }}
+                  >
+                    <Trash2 className="h-3.5 w-3.5" />
+                  </button>
+                </CommandItem>
+              ))}
+              <CommandItem
+                value="manage-saved-searches"
+                keywords={["manage", "saved", "rename", "delete"]}
+                onSelect={() => {
+                  setManagerOpen(true);
+                }}
+              >
+                <Settings2 className="h-4 w-4" />
+                <span className="flex-1">Manage saved searches…</span>
+              </CommandItem>
+            </CommandGroup>
+            <CommandSeparator />
+          </>
+        )}
+
         {/* Navigation */}
         <CommandGroup heading="Navigation">
           {navigationItems.map((item) => (
@@ -237,9 +419,78 @@ export function CommandPalette() {
 
         <CommandSeparator />
 
+        {/* Templates */}
+        <CommandGroup heading="Templates">
+          <CommandItem
+            value="start-from-template"
+            keywords={["template", "blueprint", "new", "conversation", "chat"]}
+            onSelect={() => {
+              setOpen(false);
+              // Ensure chat-shell is mounted so its event listener is live.
+              // When already on /chat, next-tick dispatch is a no-op nav.
+              router.push("/chat");
+              window.setTimeout(() => {
+                window.dispatchEvent(
+                  new CustomEvent("stagent.chat.openTemplatePicker")
+                );
+              }, 50);
+            }}
+          >
+            <Sparkles className="h-4 w-4" />
+            Start conversation from template…
+          </CommandItem>
+        </CommandGroup>
+
+        <CommandSeparator />
+
+        {/* Skills */}
+        {skills.length > 0 && (
+          <>
+            <CommandGroup heading="Skills">
+              {skills.map((skill) => (
+                <CommandItem
+                  key={`skill-${skill.id}`}
+                  value={`skill-${skill.name}`}
+                  onSelect={() => handleSelectSkill(skill.id, skill.name)}
+                  keywords={["skill", "profile"]}
+                >
+                  <Sparkles className="h-4 w-4" />
+                  <span className="flex-1 truncate">{skill.name}</span>
+                  {skill.description && (
+                    <span className="text-xs text-muted-foreground truncate max-w-[40%]">
+                      {skill.description}
+                    </span>
+                  )}
+                </CommandItem>
+              ))}
+            </CommandGroup>
+            <CommandSeparator />
+          </>
+        )}
+
+        {/* Files */}
+        {fileResults.length > 0 && (
+          <>
+            <CommandGroup heading="Files">
+              {fileResults.map((file) => (
+                <CommandItem
+                  key={`file-${file.entityId}`}
+                  value={`file-${file.label}`}
+                  onSelect={() => handleSelectFile(file.entityId, file.label)}
+                  keywords={["file", "path"]}
+                >
+                  <FileCode className="h-4 w-4" />
+                  <span className="flex-1 truncate font-mono text-xs">{file.label}</span>
+                </CommandItem>
+              ))}
+            </CommandGroup>
+            <CommandSeparator />
+          </>
+        )}
+
         {/* Utility */}
         <CommandGroup heading="Utility">
-          <CommandItem onSelect={toggleTheme} value="Toggle Theme" keywords={["dark", "light", "mode"]}>
+          <CommandItem onSelect={handleToggleTheme} value="Toggle Theme" keywords={["dark", "light", "mode"]}>
             <Sun className="h-4 w-4 dark:hidden" />
             <Moon className="h-4 w-4 hidden dark:block" />
             Toggle Theme
@@ -253,5 +504,13 @@ export function CommandPalette() {
         </CommandGroup>
       </CommandList>
     </CommandDialog>
+    <SavedSearchesManager
+      open={managerOpen}
+      onOpenChange={setManagerOpen}
+      searches={savedSearches}
+      onRename={renameSavedSearch}
+      onRemove={removeSavedSearch}
+    />
+    </>
   );
 }

package/src/components/shared/filter-hint.tsx

@@ -0,0 +1,70 @@
+"use client";
+
+import { useEffect, useMemo, useState } from "react";
+import { Lightbulb } from "lucide-react";
+import { parseFilterInput } from "@/lib/filters/parse";
+
+interface FilterHintProps {
+  inputValue: string;
+  storageKey: string;
+  /** Optional copy override; defaults to the #key:value tip. */
+  message?: string;
+}
+
+/**
+ * FilterHint — passive discovery row for the `#key:value` filter syntax.
+ *
+ * Visibility rules:
+ *  - Hidden once the dismissal flag is set in localStorage.
+ *  - Hidden when the input contains `#` (user has discovered the syntax).
+ *  - The flag is set the first time parseFilterInput returns ≥1 clause.
+ *
+ * Consumers: chat-command-popover, filter-input (list pages).
+ */
+export function FilterHint({ inputValue, storageKey, message }: FilterHintProps) {
+  const [dismissed, setDismissed] = useState(false);
+
+  const parsed = useMemo(() => parseFilterInput(inputValue), [inputValue]);
+
+  useEffect(() => {
+    try {
+      if (window.localStorage.getItem(storageKey) === "1") {
+        setDismissed(true);
+      }
+    } catch {
+      // Private-mode or disabled storage — hint stays visible.
+    }
+  }, [storageKey]);
+
+  useEffect(() => {
+    if (dismissed) return;
+    if (parsed.clauses.length > 0) {
+      try {
+        window.localStorage.setItem(storageKey, "1");
+      } catch {
+        // Private-mode or disabled storage — hint stays visible, no-op.
+      }
+      setDismissed(true);
+    }
+  }, [parsed.clauses.length, dismissed, storageKey]);
+
+  if (dismissed) return null;
+  if (inputValue.includes("#")) return null;
+
+  return (
+    <div
+      role="note"
+      className="flex items-center gap-2 px-3 py-1.5 text-xs text-muted-foreground border-t border-border/50"
+    >
+      <Lightbulb className="h-3 w-3 shrink-0" aria-hidden />
+      <span>
+        {message ?? (
+          <>
+            Tip: use <code className="font-mono text-foreground">#key:value</code> to filter (e.g.{" "}
+            <code className="font-mono text-foreground">#status:blocked</code>)
+          </>
+        )}
+      </span>
+    </div>
+  );
+}